mirror of
https://github.com/jackyzha0/quartz.git
synced 2026-03-21 21:45:42 -05:00
Update from 583aa9f093
This commit is contained in:
parent
ec00a40aef
commit
0bf2ef5a48
20
content/.github/workflows/sync.yml
vendored
Normal file
20
content/.github/workflows/sync.yml
vendored
Normal file
@ -0,0 +1,20 @@
|
||||
name: Sync to Quartz
|
||||
on:
|
||||
push:
|
||||
branches: [ main ]
|
||||
jobs:
|
||||
repo-sync:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v3
|
||||
- name: Pushing to Quartz Repo
|
||||
uses: cpina/github-action-push-to-another-repository@main
|
||||
env:
|
||||
API_TOKEN_GITHUB: ${{ secrets.QUARTZ_SYNC_TOKEN }}
|
||||
with:
|
||||
source-directory: '.'
|
||||
destination-github-username: 'witty-hamster'
|
||||
destination-repository-name: 'quartz'
|
||||
user-email: cuiguodong_2012@163.com
|
||||
target-directory: 'content'
|
||||
@ -0,0 +1,71 @@
|
||||
---
|
||||
type: tech-note
|
||||
topic: 生产力工具
|
||||
tags:
|
||||
- Methodology
|
||||
- tool
|
||||
- dataview
|
||||
- automation
|
||||
created: 2026-02-10
|
||||
version: "1.0"
|
||||
---
|
||||
# 🚀 技术专题:Dataview:Synapse-Vault 的动态索引引擎
|
||||
|
||||
> **MOC(Map of Content,内容地图) 关联:** [🗺️ Atlas_MOC](🗺️%20Atlas_MOC.md) | [🗺️ Methodology_MOC](🗺️%20Methodology_MOC.md)
|
||||
>
|
||||
> **版本:** 1.0
|
||||
|
||||
## 📖 核心概念 (Definition)
|
||||
|
||||
> Dataview 是 Obsidian 的数据库级查询插件,它通过解析笔记中的 YAML 属性和标签,将静态的 Markdown 文件转化为可动态排序、筛选和聚合的实时数据视图。
|
||||
|
||||
## ⚙️ 核心逻辑/原理 (Logic)
|
||||
|
||||
- **数据抓取(Scanning)**:实时扫描全库中的元数据(YAML Properties)和内联字段。
|
||||
- **动态感应(Live-Update)**:当新笔记满足 `FROM` 和 `WHERE` 条件时,索引页会自动“感知”并展示,无需手动维护链接。
|
||||
- **逻辑解耦**:彻底分离了笔记的“物理存放位置(文件夹)”与“逻辑组织方式(MOC)”。
|
||||
|
||||
## 💻 自动化构建 MOC 实践 (Implementation)
|
||||
|
||||
### 方案 A:基础列表(最常用)
|
||||
|
||||
```dataview
|
||||
LIST
|
||||
FROM #Methodology
|
||||
SORT file.mtime DESC
|
||||
```
|
||||
|
||||
### 方案 B:表格展示(带元数据)
|
||||
|
||||
```dataview
|
||||
TABLE created AS "创建日期", status AS "状态", tags AS "标签"
|
||||
FROM #Methodology
|
||||
SORT created DESC
|
||||
```
|
||||
### 方案 C:按文件夹排除 MOC 本身的索引
|
||||
|
||||
```dataview
|
||||
LIST
|
||||
FROM "10_Atlas/13_Methodology"
|
||||
WHERE !contains(file.name, "MOC")
|
||||
```
|
||||
|
||||
### 方案 D:实现“生产力工具”自动分组预览
|
||||
|
||||
```dataview
|
||||
LIST rows.file.link FROM #Methodology WHERE topic = "生产力工具" GROUP BY topic
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔗 扩展链接 (Connections)
|
||||
|
||||
- **上游知识:** [🗺️ Methodology_MOC](🗺️%20Methodology_MOC.md) (方法论内容地图)
|
||||
|
||||
- **相关资源:** [Dataview 官方文档](https://blacksmithgu.github.io/obsidian-dataview/)
|
||||
|
||||
- **待解决疑问:** 如何结合 `Templater` 在创建笔记时自动生成符合 Dataview 检索要求的 `topic` 字段?
|
||||
|
||||
|
||||
---
|
||||
#tool #Methodology #automation #dataview
|
||||
@ -0,0 +1,69 @@
|
||||
---
|
||||
type: evergreen
|
||||
topic: 生产力工具
|
||||
tags:
|
||||
- "#quartz"
|
||||
- "#github-actions"
|
||||
- "#static-site"
|
||||
- "#automation"
|
||||
created: 2026-02-10 15:37
|
||||
updated: 2026-02-10 15:37
|
||||
version: "1.0"
|
||||
---
|
||||
# 🌲 知识原子:Quartz + GitHub Actions 部署实战
|
||||
|
||||
> [!quote] 核心观点
|
||||
> Quartz + GitHub Actions 的组合是目前 Obsidian 用户实现“数字花园”公网发布的最优免费方案,它实现了“本地创作,全网同步”的无缝闭环。
|
||||
|
||||
## 🔍 详细定义
|
||||
|
||||
- **Quartz 4.0**:一个基于 Node.js 的静态站点生成引擎,原生支持 Obsidian 的双向链接、正文预览和多种复杂语法。
|
||||
- **GitHub Actions**:自动化工作流工具,负责监听代码库变动,自动触发编译并将渲染后的 HTML 推送至 GitHub Pages 托管。
|
||||
|
||||
## 💡 深度见解(Insight)
|
||||
|
||||
- **解耦优势**:通过 GitHub Actions,你可以将“源码库(Private)”与“发布库(Public)”分离。这既保护了你的隐私笔记不被泄露,又享受了公网访问的便利。
|
||||
- **低成本运维**:该方案完全基于 GitHub 基础设施,零服务器成本,且具备极高的抗并发能力和全球访问速度。
|
||||
|
||||
## ⚙️ 工程实践(Step-by-Step)
|
||||
|
||||
### 1. 环境初始化
|
||||
1. Fork [Quartz 官方仓库](https://github.com/jackyzha0/quartz)。
|
||||
2. 本地执行 `npx quartz create`,选择你的 **Synapse-Vault** 作为内容源。
|
||||
|
||||
### 2. 跨仓库自动化同步脚本(Action YAML)
|
||||
|
||||
在你的 **Synapse-Vault** 仓库中创建 `.github/workflows/deploy.yml`:
|
||||
|
||||
```yaml
|
||||
name: Deploy to Quartz
|
||||
on:
|
||||
push:
|
||||
branches: [ main ]
|
||||
jobs:
|
||||
build:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout Vault
|
||||
uses: actions/checkout@v3
|
||||
- name: Push to Quartz Content
|
||||
run: |
|
||||
# 此处编写逻辑:将本地内容拉取并覆盖到 Quartz 仓库的 content 目录
|
||||
# 建议使用 API 或专门的 Sync Action 触发
|
||||
```
|
||||
|
||||
### 3. 私密性过滤(Privacy Filter)
|
||||
|
||||
在 Quartz 配置中排除 `30_Daily` 文件夹,仅开放 `10_Atlas`:
|
||||
|
||||
- 修改 `quartz.config.ts` 中的过滤逻辑。
|
||||
|
||||
- 在笔记 YAML 区加入 `publish: false` 实现个体过滤。
|
||||
|
||||
## ⛓️ 知识网络 (Context)
|
||||
|
||||
- **上层概念**:[Synapse-Vault 搭建全指南:从零构建你的第二大脑](Synapse-Vault%20搭建全指南:从零构建你的第二大脑.md)
|
||||
- **应用场景**:个人技术博客、公开的知识索引库、面试作品集展示。
|
||||
|
||||
---
|
||||
#Knowledge #Structure #automation #quartz
|
||||
100
content/10_Atlas/13_Methodology/Quartz V4 部署实战:从本地到公网的数字花园.md
Normal file
100
content/10_Atlas/13_Methodology/Quartz V4 部署实战:从本地到公网的数字花园.md
Normal file
@ -0,0 +1,100 @@
|
||||
---
|
||||
type: engineering
|
||||
topic: 生产力工具
|
||||
project_status: 进行中
|
||||
tags:
|
||||
- "#project"
|
||||
- "#engineering"
|
||||
- "#demo"
|
||||
created: 2026-02-10 16:35
|
||||
updated: 2026-02-10 16:35
|
||||
version: "1.0"
|
||||
---
|
||||
# 🏗️ 工程实战:Quartz V4 部署实战:从本地到公网的数字花园
|
||||
|
||||
> [!abstract] 项目意图
|
||||
> - **目标**:将 Synapse-Vault 笔记库通过 Quartz v4 渲染成静态网站,并发布至 GitHub Pages。
|
||||
> - **核心工具链**:Node.js (v18.14+), Quartz v4, GitHub Actions.
|
||||
> - **当前版本**:V`=this.version`
|
||||
|
||||
## 🏁 环境准备 (Prerequisites)
|
||||
|
||||
- **运行环境**:(如 Node.js v18.14+, Python 3.10)
|
||||
- **依赖安装**:
|
||||
```bash
|
||||
# 在克隆好的 quartz 目录下执行
|
||||
npm install
|
||||
```
|
||||
|
||||
## 💻 核心实现 (Core Implementation)
|
||||
|
||||
### 1. 初始化链接
|
||||
|
||||
在终端执行初始化向导,将 Quartz 代码仓库与 Obsidian 笔记库物理关联。
|
||||
|
||||
```Bash
|
||||
npx quartz create
|
||||
```
|
||||
|
||||

|
||||
|
||||
#### 🔍 选项深度对比
|
||||
| 选项 | 对应行为 | 适合场景 |
|
||||
| -------------------------- | --------------------------------------------------------------------- | ---------------------------------------------- |
|
||||
| Empty Quartz | 建立一个空的内容目录 | 从零开始在 Quartz 文件夹里写笔记 |
|
||||
| Copy an existing folder | **物理复制**。把你的笔记文件夹里的文件全部拷贝一份到 `quartz/content` | **推荐新手使用**。最稳定,不破坏原笔记库,也不怕路径权限问题 |
|
||||
| Symlink an existing folder | **软链接**。即 `Link an existing Obsidian vault` 的本质。在 macOS 系统层建立一个“快捷方式” | **进阶使用**。实现“实时同步”,你在 Obsidian 改完,网页浏览直接刷新,无需复制 |
|
||||
|
||||
这里选择:`Link an existing Obsidian vault`(即第三个选项) 并输入笔记库绝对路径。
|
||||
|
||||
### 2. 跨仓库自动同步脚本 (GitHub Action)
|
||||
|
||||
在笔记仓库(Synapse-Vault)的 `.github/workflows/sync.yml` 中配置以下逻辑:
|
||||
|
||||
```Yaml
|
||||
name: Sync to Quartz
|
||||
on:
|
||||
push:
|
||||
branches: [ main ]
|
||||
jobs:
|
||||
repo-sync:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout
|
||||
uses: actions/checkout@v3
|
||||
- name: Pushing to Quartz Repo
|
||||
uses: cpina/github-action-push-to-another-repository@main
|
||||
env:
|
||||
API_TOKEN_GITHUB: ${{ secrets.QUARTZ_SYNC_TOKEN }}
|
||||
with:
|
||||
source-directory: '.'
|
||||
destination-github-username: '你的用户名'
|
||||
destination-repository-name: 'quartz'
|
||||
user-email: your-email@example.com
|
||||
target-directory: 'content'
|
||||
```
|
||||
|
||||
## 🚩 关键步骤与坑点 (Key Steps & Pitfalls)
|
||||
|
||||
1. **Node 版本**:Quartz v4 依赖较高版本的 Node,若 `npm i` 报错,请检查 `node -v`。
|
||||
|
||||
2. **符号链接 (Symlink)**:
|
||||
|
||||
- ⚠️ **踩坑提示**:Windows 系统下执行 `npx quartz create` 必须使用 **管理员权限** 运行终端,否则无法建立链接,导致 `content` 文件夹为空。
|
||||
|
||||
|
||||
## 🧪 测试与验收 (Testing)
|
||||
|
||||
- **预期结果**:执行 `npx quartz build --serve` 后,本地 8081 端口可访问美化后的笔记网页。
|
||||
|
||||
- **实际表现**:
|
||||
|
||||
|
||||
## 📓 复盘与迭代 (Review)
|
||||
|
||||
- **优化空间**:默认主题颜色需根据 Synapse-Vault 的风格进行 CSS 微调。
|
||||
|
||||
- **下一步计划**: [[下个迭代笔记名]]
|
||||
|
||||
---
|
||||
#project #engineering
|
||||
@ -0,0 +1,76 @@
|
||||
---
|
||||
type: tech-note
|
||||
topic: 知识管理(PKM)
|
||||
tags:
|
||||
- evergreen
|
||||
- workflow
|
||||
- obsidian
|
||||
created: 2026-02-10
|
||||
version: "1.0"
|
||||
---
|
||||
# 🚀 技术专题:Synapse-Vault 搭建全指南:从零构建你的第二大脑
|
||||
|
||||
> **MOC(Map of Content,内容地图) 关联:** [🗺️ Methodology_MOC](🗺️%20Methodology_MOC.md) | [🗺️ Atlas_MOC](🗺️%20Atlas_MOC.md)
|
||||
>
|
||||
> **版本:** 1.0(底层架构完工版)
|
||||
|
||||
## 🌟 核心概念 (Definition)
|
||||
|
||||
**Synapse-Vault** (神经突触保险库) 是基于”原子化、关联化、自动化“原则构建的数字第二大脑。它不仅是一个存储仓库,更是一个能够自动同步、图床分离、结构严谨的思维化系统。
|
||||
|
||||
---
|
||||
## 🛠️ 技术栈与自动化方案
|
||||
|
||||
### 1. 数据同步:Git 全自动工作流
|
||||
- **工具:** Obsidian Git 插件 + GitHub Private Repo(GitHub 私有仓)。
|
||||
- **实现:** 配置 `Auto commit-and-sync`。
|
||||
- **价值:** 实现了版本控制与多端数据冗余,确保知识资产永不丢失,并具备时间回溯能力。
|
||||

|
||||

|
||||
|
||||
### 2. 视觉记忆:图床分离方案
|
||||
- **工具:** PicList(或 PicGo)+ GitHub 图床 + Image Auto Upload 插件。
|
||||
- **实现:** 粘贴图片时自动触发上传,并在文档中生成 `https://` 链接。
|
||||
- **价值:** 保持本地仓库极度轻量化(仅存 Markdown),确保在任何 Web 环境下图片均可正常预览。
|
||||
|
||||

|
||||
|
||||

|
||||
|
||||
|
||||
---
|
||||
## 🏛️ 文件夹分层架构(PARA 优化版)
|
||||
|
||||
- **`00_Inbox`**:神经入口,存放所有待处理的碎片。
|
||||
- **`10_Atlas`**:知识地图,按领域存放结构化知识(如 CS、AI、方法论等)。
|
||||
- **`20_Projects`**:正在进行的具体任务,有明确的截止日期。
|
||||
- **`30_Daily`**:时间线记录,作为知识点的”胶水“和任务中枢。
|
||||
- **`80_System`**:系统底层,存放模板(`Templates`)、资源(`Assets`)和配置文件。
|
||||
|
||||
---
|
||||
## 📝 核心工作流(Workflow)
|
||||
|
||||
### 第一步:开启每日脉冲(The Trigger)
|
||||
|
||||
每天通过 `Daily Note` 插件生成日期笔记,在 **”核心目标“** 模块通过 `[[ ]]` 双链预设今日要产出的知识点。
|
||||
|
||||
### 第二步:知识录入(The Input)
|
||||
|
||||
使用 `Tech-Note-Template` 快速创建笔记,强调:
|
||||
|
||||
- **双向链接:** 必须链接至对应的 MOC 或项目页面。
|
||||
- **标签:** 使用 `#seed` 或 `#evergreen` 标记笔记成熟度。
|
||||
|
||||
### 第三步:自动同步(The Backup)
|
||||
|
||||
无需人工干预,Obsidian Git 插件会在后台定时将所有更改推送到远程仓库。
|
||||
|
||||
---
|
||||
## 💡维护与演进建议
|
||||
|
||||
1. **定期修剪:** 每周末检查 `00_Inbox` 文件夹下的内容,将碎片化笔记归档到 `10_Atlas` 文件夹中。
|
||||
2. **保持原子性:** 一篇笔记只解决一个问题,复杂的课题通过 MOC 进行组织。
|
||||
3. **以写促学:** 如果没有笔记产出,今天的待办就不算真正完成。
|
||||
|
||||
---
|
||||
#Methodology #SecondBrain #Workflow
|
||||
19
content/10_Atlas/13_Methodology/🗺️ Methodology_MOC.md
Normal file
19
content/10_Atlas/13_Methodology/🗺️ Methodology_MOC.md
Normal file
@ -0,0 +1,19 @@
|
||||
# 🧭 方法论内容地图(Methodology MOC)
|
||||
|
||||
> 归档所有关于学习方法、效率系统和个人增长的笔记。
|
||||
|
||||
## 🧠 知识管理(PKM)
|
||||
|
||||
- [Synapse-Vault 搭建全指南:从零构建你的第二大脑](Synapse-Vault%20搭建全指南:从零构建你的第二大脑.md)
|
||||
|
||||
---
|
||||
## ⚡️ 生产力工具
|
||||
|
||||
- [Dataview:Synapse-Vault 的动态索引引擎](Dataview:Synapse-Vault%20的动态索引引擎.md)
|
||||
- [Quartz + GitHub Actions 部署实战](Quartz%20+%20GitHub%20Actions%20部署实战.md)
|
||||
|
||||
---
|
||||
## 📈 学习算法
|
||||
|
||||
|
||||
---
|
||||
4
content/10_Atlas/🗺️ Atlas_MOC.md
Normal file
4
content/10_Atlas/🗺️ Atlas_MOC.md
Normal file
@ -0,0 +1,4 @@
|
||||
# 🧭 领域知识地图(Atlas MOC)
|
||||
|
||||
> 归档所有领域结构化知识。
|
||||
|
||||
0
content/20_Projects/21_Portfolio_Site.md
Normal file
0
content/20_Projects/21_Portfolio_Site.md
Normal file
55
content/30_Daily/2026-02-10.md
Normal file
55
content/30_Daily/2026-02-10.md
Normal file
@ -0,0 +1,55 @@
|
||||
---
|
||||
type: daily
|
||||
date: "2026-02-10"
|
||||
tags: "#pulse"
|
||||
status: pulse
|
||||
---
|
||||
# 📅 2026-02-10 | Synapse Pulse
|
||||
**Status Check:** 今日神经元活跃度:
|
||||
- [ ] 😔 Low
|
||||
- [ ] 🙂 Mid
|
||||
- [x] 🤩 High
|
||||
|
||||
## 🎯 核心目标 (The Big One)
|
||||
|
||||
> 必须完成的硬核任务,通常涉及深度思考或产出
|
||||
> 建议:每日 1 ~ 2 个
|
||||
|
||||
- [x] 撰写并归档《Synapse-Vault 搭建全指南》[Synapse-Vault 搭建全指南:从零构建你的第二大脑](Synapse-Vault%20搭建全指南:从零构建你的第二大脑.md)
|
||||
- [x] 撰写并归档《Dataview:Synapse-Vault 的动态索引引擎》[Dataview:Synapse-Vault 的动态索引引擎](Dataview:Synapse-Vault%20的动态索引引擎.md)
|
||||
- [ ] 撰写并归档《Quartz V4 部署实战》[Quartz V4 部署实战:从本地到公网的数字花园](Quartz%20V4%20部署实战:从本地到公网的数字花园.md)
|
||||
- [ ] 撰写并归档《系统安全设计方案》[[小牛电动自研信息化系统安全设计方案]]
|
||||
- [ ] 撰写并归档《系统安全设计方案评审记录》[[小牛电动自研信息化系统安全设计方案评审记录]]
|
||||
- [ ] 撰写并归档《系统操作使用手册》[[小牛电动自研信息化系统操作使用手册]]
|
||||
|
||||
## 🪄 辅助目标 (The Small Wins)
|
||||
|
||||
> 相对轻松的任务,如”整理 5 分钟碎片化笔记“ 或 ”复习一个知识点“
|
||||
> 建议:每日 2 ~ 3 个
|
||||
|
||||
- [ ] 整理 witty-hamster.github.com 空间下的笔记
|
||||
- [ ] 实现 Obsidian 笔记的在线访问与发布(Quartz 或 Obsidian-to-Hugo + Github Actions)
|
||||
|
||||
## 📝 任务拆解 (Micro-Tasks)
|
||||
|
||||
- [x] 《Synapse-Vault 搭建全指南》中的版本有什么作用
|
||||
- [x] Tech-Note-Template 模板不够好,能否做一个通用的?另外属性中是否需要加上版本?如果加上版本后,文件内容中的版本是否还有用处,如文件中必须写上版本的话,能否自动获取属性中的版本 version 信息
|
||||
|
||||
## 💡 闪念/记录 (Inter-links)
|
||||
|
||||
- [Synapse-Vault 搭建全指南:从零构建你的第二大脑](Synapse-Vault%20搭建全指南:从零构建你的第二大脑.md)
|
||||
- [Dataview:Synapse-Vault 的动态索引引擎](Dataview:Synapse-Vault%20的动态索引引擎.md)
|
||||
- [Quartz + GitHub Actions 部署实战](Quartz%20+%20GitHub%20Actions%20部署实战.md)
|
||||
|
||||
## 🔋 反思/小成就 (Reflection)
|
||||
|
||||
- 小成就:生成了四类模板
|
||||
- [Synapse-Universal-Master](Synapse-Universal-Master.md):万能基础模板,**适用场景:** 任何不确定分类的新灵感或通用笔记。
|
||||
- [Learning-Pulse-Template](Learning-Pulse-Template.md):学习笔记模版,**适用场景:** 阅读书籍、观看视频课程、参加讲座时的记录,侧重于**输入**。
|
||||
- [Evergreen-Knowledge-Template](Evergreen-Knowledge-Template.md):知识笔记模板,**适用场景:** 经过内化后的“长青”知识点。侧重于**原子化**、**深度**和**永久性**。
|
||||
- [Pitfall-Record-Template](Pitfall-Record-Template.md):避坑/故障记录模板,**适用场景:** 代码报错、配置失败、经验教训。这是最有价值的“错题本”。
|
||||
- Engineering-Practice-Template:工程/Demo 实战笔记模板,**适用场景:** Quartz 部署实战、React 组件开发、Python 自动化脚本等需要“动手做”的任务。
|
||||
|
||||
|
||||
---
|
||||
#daily #progress
|
||||
45
content/80_System/Templates/Daily-Template.md
Normal file
45
content/80_System/Templates/Daily-Template.md
Normal file
@ -0,0 +1,45 @@
|
||||
---
|
||||
type: daily
|
||||
date: "{{date}}"
|
||||
tags: "#pulse"
|
||||
status: pulse
|
||||
---
|
||||
# 📅 {{date}} | Synapse Pulse
|
||||
|
||||
**Status Check:** 今日神经元活跃度:
|
||||
|
||||
- [ ] 😔 Low
|
||||
- [ ] 🙂 Mid
|
||||
- [ ] 🤩 High
|
||||
|
||||
## 🎯 核心目标 (The Big One)
|
||||
|
||||
> 必须完成的硬核任务,通常涉及深度思考或产出
|
||||
>
|
||||
> 建议:每日 1 ~ 2 个
|
||||
|
||||
- [ ]
|
||||
|
||||
## 🪄 辅助目标 (The Small Wins)
|
||||
|
||||
> 相对轻松的任务,如”整理 5 分钟碎片化笔记“ 或 ”复习一个知识点“
|
||||
>
|
||||
> 建议:每日 2 ~ 3 个
|
||||
|
||||
- [ ]
|
||||
- [ ]
|
||||
|
||||
## 📝 任务拆解 (Micro-Tasks)
|
||||
|
||||
- [ ]
|
||||
- [ ]
|
||||
|
||||
## 💡 闪念/记录 (Inter-links)
|
||||
*在此记录今日新产生的关联笔记,使用 `[[ ]]` 连接*
|
||||
-
|
||||
|
||||
## 🔋 反思/小成就 (Reflection)
|
||||
-
|
||||
|
||||
---
|
||||
#daily #progress
|
||||
63
content/80_System/Templates/Engineering-Practice-Template.md
Normal file
63
content/80_System/Templates/Engineering-Practice-Template.md
Normal file
@ -0,0 +1,63 @@
|
||||
---
|
||||
type: engineering
|
||||
topic: '<% tp.system.prompt("工程/Demo主题 (如: Quartz-v4部署)") %>'
|
||||
project_status: <% tp.system.suggester(["进行中", "已完成", "已归档"], ["进行中", "已完成", "已归档"]) %>
|
||||
tags:
|
||||
- "#project"
|
||||
- "#engineering"
|
||||
- "#demo"
|
||||
created: <% tp.date.now("YYYY-MM-DD HH:mm") %>
|
||||
updated: <% tp.date.now("YYYY-MM-DD HH:mm") %>
|
||||
version: "1.0"
|
||||
---
|
||||
# 🏗️ 工程实战:<% tp.file.title %>
|
||||
|
||||
> [!abstract] 项目意图
|
||||
> - **目标**:
|
||||
> - **核心工具链**:
|
||||
> - **当前版本**:V`=this.version`
|
||||
|
||||
## 🏁 环境准备 (Prerequisites)
|
||||
|
||||
- [ ] **运行环境**:(如 Node.js v18.14+, Python 3.10)
|
||||
- [ ] **依赖安装**:
|
||||
```bash
|
||||
# 执行安装指令
|
||||
npm install
|
||||
```
|
||||
|
||||
## 💻 核心实现 (Core Implementation)
|
||||
|
||||
> 记录最关键的配置代码或逻辑实现。
|
||||
|
||||
### 配置细节/代码片段
|
||||
|
||||
```TypeScript
|
||||
// 在此插入核心逻辑或配置文件内容
|
||||
|
||||
```
|
||||
|
||||
## 🚩 关键步骤与坑点 (Key Steps & Pitfalls)
|
||||
|
||||
1. **第一步**:
|
||||
|
||||
2. **第二步**:
|
||||
|
||||
- ⚠️ **踩坑提示**:
|
||||
|
||||
|
||||
## 🧪 测试与验收 (Testing)
|
||||
|
||||
- **预期结果**:
|
||||
|
||||
- **实际表现**:
|
||||
|
||||
|
||||
## 📓 复盘与迭代 (Review)
|
||||
|
||||
- **优化空间**:
|
||||
|
||||
- **下一步计划**: [[下个迭代笔记名]]
|
||||
|
||||
---
|
||||
#project #engineering
|
||||
29
content/80_System/Templates/Evergreen-Knowledge-Template.md
Normal file
29
content/80_System/Templates/Evergreen-Knowledge-Template.md
Normal file
@ -0,0 +1,29 @@
|
||||
---
|
||||
type: evergreen
|
||||
topic: <% tp.file.folder(true).split("/").pop() %>
|
||||
tags:
|
||||
- evergreen
|
||||
created: <% tp.date.now("YYYY-MM-DD HH:mm") %>
|
||||
updated: <% tp.date.now("YYYY-MM-DD HH:mm") %>
|
||||
version: "1.0"
|
||||
---
|
||||
# 🌲 知识原子:<% tp.file.title %>
|
||||
|
||||
> [!quote] 核心观点
|
||||
> 用一句话概括这个知识点的本质。
|
||||
|
||||
## 🔍 详细定义
|
||||
|
||||
-
|
||||
|
||||
## 💡 深度见解(Insight)
|
||||
|
||||
-
|
||||
|
||||
## ⛓️ 知识网络(Context)
|
||||
- **上层概念**:
|
||||
- **对立/相似概念**:
|
||||
- **应用场景**:
|
||||
|
||||
---
|
||||
#Knowledge #Structure
|
||||
35
content/80_System/Templates/Learning-Pulse-Template.md
Normal file
35
content/80_System/Templates/Learning-Pulse-Template.md
Normal file
@ -0,0 +1,35 @@
|
||||
---
|
||||
type: learning-note
|
||||
topic: '<% tp.system.prompt("学习主题 (例如: Java基础)") %>'
|
||||
source: <% tp.system.prompt("来源 (链接、书名、视频等)") %>
|
||||
tags:
|
||||
- "#in-progress"
|
||||
created: <% tp.date.now("YYYY-MM-DD HH:mm") %>
|
||||
updated: <% tp.date.now("YYYY-MM-DD HH:mm") %>
|
||||
version: "1.0"
|
||||
---
|
||||
# 📖 学习笔记:<% tp.file.title %>
|
||||
|
||||
> [!info] 学习元数据
|
||||
> - **来源**:<% tp.file.cursor(1) %>
|
||||
> - **进度**:
|
||||
> - [ ] 已完成初读
|
||||
> - [ ] 已通过费曼自述
|
||||
> - **版本**: V`=this.version`
|
||||
|
||||
## 🧩 知识碎片 (Key Points)
|
||||
|
||||
-
|
||||
|
||||
## 🧠 深度思考 (Feynman Technique)
|
||||
|
||||
> 用最简单的语言描述你今天学到了什么?
|
||||
|
||||
-
|
||||
|
||||
## 🏗️ 练习/Demo
|
||||
|
||||
-
|
||||
|
||||
---
|
||||
#Learning
|
||||
28
content/80_System/Templates/Pitfall-Record-Template.md
Normal file
28
content/80_System/Templates/Pitfall-Record-Template.md
Normal file
@ -0,0 +1,28 @@
|
||||
---
|
||||
type: troubleshoot
|
||||
topic: '<% tp.system.prompt("涉及技术/领域 (如: Git, Npm)") %>'
|
||||
tags:
|
||||
- "#pitfall"
|
||||
- "#bug-fix"
|
||||
created: <% tp.date.now("YYYY-MM-DD HH:mm") %>
|
||||
updated: <% tp.date.now("YYYY-MM-DD HH:mm") %>
|
||||
version: "1.0"
|
||||
---
|
||||
# ⚠️ 避坑记录:<% tp.file.title %>
|
||||
|
||||
> [!warning] 故障现场
|
||||
> - **环境**:
|
||||
> - **症状**:
|
||||
|
||||
## ❌ 错误原因分析
|
||||
|
||||
-
|
||||
|
||||
## ✅ 解决方案 (The Fix)
|
||||
|
||||
```bash
|
||||
# 执行以下操作修复
|
||||
```
|
||||
|
||||
---
|
||||
#pitfall #bug-fix
|
||||
28
content/80_System/Templates/Synapse-Universal-Master.md
Normal file
28
content/80_System/Templates/Synapse-Universal-Master.md
Normal file
@ -0,0 +1,28 @@
|
||||
---
|
||||
type: universal
|
||||
topic: <% tp.system.suggester(["生产力工具", "技术栈", "方法论", "生活"], ["生产力工具", "技术栈", "方法论", "生活"], false, "请选择一个主题") %>
|
||||
tags:
|
||||
- seed
|
||||
created: <% tp.date.now("YYYY-MM-DD HH:mm") %>
|
||||
updated: <% tp.date.now("YYYY-MM-DD HH:mm") %>
|
||||
version: "1.0"
|
||||
status: seedling
|
||||
---
|
||||
# <% tp.file.title %>
|
||||
|
||||
> [!abstract] 节点信息
|
||||
> - **主题**:`$= dv.current().topic`
|
||||
> - **版本**:V`=this.version`
|
||||
> - **建立时间**:`$= dv.current().created`
|
||||
|
||||
## 📝 内容描述
|
||||
|
||||
-
|
||||
|
||||
## 🔗 关联引用
|
||||
|
||||
- **归属 MOC**:[[<% tp.file.folder(true).split("/").pop() %>_MOC]]
|
||||
- **延伸阅读**:
|
||||
|
||||
---
|
||||
#Notes
|
||||
27
content/80_System/Templates/Tech-Note-Template.md
Normal file
27
content/80_System/Templates/Tech-Note-Template.md
Normal file
@ -0,0 +1,27 @@
|
||||
---
|
||||
type: tech-note
|
||||
topic:
|
||||
tags:
|
||||
- seed
|
||||
created: "{{date}}"
|
||||
version: "1.0"
|
||||
---
|
||||
# 🚀 技术专题:{{title}}
|
||||
|
||||
> **MOC(Map of Content,内容地图) 关联:** [🗺️ Atlas_MOC](🗺️%20Atlas_MOC.md) | [🗺️ Methodology_MOC](🗺️%20Methodology_MOC.md)
|
||||
>
|
||||
> **版本:** V`=this.version`
|
||||
|
||||
## 📖 核心概念 (Definition)
|
||||
|
||||
> 用一句话总结该技术的本质。
|
||||
|
||||
## ⚙️ 核心逻辑/原理 (Logic)
|
||||
|
||||
-
|
||||
-
|
||||
|
||||
## 💻 代码片段/工程实践 (Implementation)
|
||||
|
||||
```javascript
|
||||
// 在此插入代码或配置
|
||||
62
content/README.md
Normal file
62
content/README.md
Normal file
@ -0,0 +1,62 @@
|
||||
### 🏛️ Synapse-Vault 核心架构设计
|
||||
|
||||
在根目录下建立以下 5 个核心文件夹,并使用数字前缀(方便排序):
|
||||
|
||||
#### 00_Inbox (神经入口 / 收集箱)
|
||||
|
||||
- **用途:** 快速记录、临时剪藏、未经整理的碎片想法。
|
||||
|
||||
- **逻辑:** 所有的灵感先扔进来,不要在记录时纠结分类,保持心流。
|
||||
|
||||
|
||||
#### 10_Atlas (地图集 / 知识体系)
|
||||
|
||||
这里是你的知识骨干,按领域划分:
|
||||
|
||||
- **11_CS_AI:** 计算机科学、算法、模型研究。
|
||||
|
||||
- **12_Dev_Stack:** 开发技术栈(Java, Python, React, Git 等)。
|
||||
|
||||
- **13_Methodology:** 学习法、项目管理、心理学。
|
||||
|
||||
- **14_Archive_Reference:** 纯参考资料、文档备份。
|
||||
|
||||
|
||||
#### 20_Projects (核心任务 / 突触激活)
|
||||
|
||||
- **用途:** 存放有明确截止日期、有产出目标的任务。
|
||||
|
||||
- **例子:** `21_Portfolio_Site` (个人作品集开发), `22_React_Deep_Dive` (React 深度学习专项)。
|
||||
|
||||
- **逻辑:** 当一个项目结束,文件夹就移入归档。
|
||||
|
||||
|
||||
#### 30_Daily (时间线 / 神经脉冲)
|
||||
|
||||
- **用途:** 日记(Daily Notes)。
|
||||
|
||||
- **作用:** 记录每天的进度、反思、待办。这是连接不同知识点的“胶水”。
|
||||
|
||||
|
||||
#### 80_System (底层协议 / 库配置)
|
||||
|
||||
- **用途:** 存放模板 (Templates)、附件图片 (Assets)、脚本 (Scripts)。
|
||||
|
||||
- **逻辑:** 保持库的整洁,把所有的非笔记文件统一管理。
|
||||
|
||||
### 🧬 进阶技巧:让“突触”真正相连
|
||||
|
||||
有了文件夹只是第一步,要让 **Synapse-Vault** 具有“前沿感”,你需要学会使用 **MOC (Map of Content, 内容地图)**:
|
||||
|
||||
1. **不要过度分类:** 文件夹层级建议不超过 3 层。
|
||||
|
||||
2. **MOC 索引页:** 在 `10_Atlas` 下为每个大领域建一个总笔记。比如建立一个 `React MOC.md`,里面用 `[[ ]]` 链接该领域下所有的子笔记。
|
||||
|
||||
3. **状态标签:** 使用标签来标记笔记的成熟度:
|
||||
|
||||
- `#seed`:刚写下的种子想法。
|
||||
|
||||
- `#seedling`:已经补充了部分内容,正在生长。
|
||||
|
||||
- `#evergreen`:成熟的常青笔记,可以随时输出。
|
||||
|
||||
Loading…
Reference in New Issue
Block a user