diff --git a/test-article.md b/test-article.md new file mode 100644 index 0000000..4f216b0 --- /dev/null +++ b/test-article.md @@ -0,0 +1,304 @@ +--- +title: 构建可持续的知识系统 +date: 2026-09-28 +tags: + - 思考 + - 知识管理 + - 工作流 +category: 随笔 +aliases: + - 知识系统 + - 数字花园设计 +--- + +# 构建可持续的知识系统 + +> 真正有价值的知识系统,不是收藏最多信息的系统,而是能让想法持续产生关联、自然生长的系统。 + +## 为什么系统总会失效 + +我们总在寻找完美的工具:更强大的分类、更精细的标签、更自动化的流程。但几个月后,那个精心搭建的系统往往变成另一座需要维护的花园。 + +> [!quote] 核心原则 +> 如果一个系统需要持续依赖意志力来维护,那么它本身就是不可持续的。 + +问题不在工具,而在于我们把「整理」当作了目标。知识的价值不在于被妥善存放,而在于它能否在恰当的时刻被重新发现,并与新的想法相遇。 + +### 常见的失败模式 + +| 阶段 | 行为 | 问题 | +|------|------|------| +| 热情期 | 大量收集、精心分类 | 收集速度远超消化速度 | +| 维护期 | 定期整理、补标签 | 整理变成独立于产出的负担 | +| 停滞期 | 系统停止更新 | 已有结构阻碍新想法的自然连接 | +| 放弃期 | 重启或弃用 | 信任断裂,不再依赖系统 | + +## 三个设计原则 + +### 1. 降低阻力 + +捕捉想法应该比忘记它更容易。 + +- 随手记录,不预先分类 +- 快速链接,不强制标签 +- 允许草稿,接受不完整 + +> [!tip] 实践建议 +> 记录时的阻力每增加一步,捕捉率下降约 30%。把入口放在最快触达的位置。 + +### 2. 允许生长 + +让结构从内容中浮现,而非预设。 + +- 使用 **双向链接** 替代目录树 +- 用 `#标签` 做弱分类,不做强约束 +- 允许同一篇笔记归属多个主题 + +#### 双向链接示例 + +在 Obsidian 中,使用 `[[文件名]]` 创建链接: + +- 这与 [[数字花园的四季]] 中的"春季播种"阶段呼应 +- 具体工具选择参考 [[信息与理解之间]] +- 相关的工作流设计见 [[工作流设计]] + +### 3. 主动回流 + +让旧知识自然回到当下视野。 + +- 每日随机回顾一篇旧笔记 +- 标签聚合页作为"主题入口" +- 定期重读并提炼新关联 + +## 数据流设计 + +```mermaid +graph LR + A[捕捉] --> B[连接] + B --> C[回顾] + C -->|发现新关联| B + C -->|提炼| D[输出] + D -->|公开| E[反馈] + E -->|新想法| A +``` + +整个流程是一个**螺旋上升**的过程,而非线性的"收集→整理→使用"。 + +## 技术实现要点 + +### 索引与搜索 + +搜索索引需要覆盖以下维度: + +1. **标题**:精确匹配 + 前缀匹配 +2. **正文**:全文检索(FTS5) +3. **标签**:`#标签` 语法解析 +4. **Frontmatter**:YAML 元数据查询 + +```sql +-- FTS5 全文索引建表示例 +CREATE VIRTUAL TABLE notes_fts USING fts5( + title, + content, + tags, + path UNINDEXED, + repo_id UNINDEXED, + tokenize = 'unicode61 remove_diacritics 2' +); + +-- 前缀搜索 +SELECT title, snippet(notes_fts, 1, '', '', '…', 12) +FROM notes_fts +WHERE notes_fts MATCH '知识系统*' +ORDER BY rank +LIMIT 10; +``` + +### Git 同步策略 + +```swift +// libgit2 单向同步核心逻辑(伪代码) +func syncRepository(_ repoID: String) async throws { + let repo = try openRepository(at: path(for: repoID)) + let remote = try repo.remote(named: "origin") + + // Fetch 远端更新 + try remote.fetch(specs: ["refs/heads/*:refs/heads/*"], + options: fetchOptions()) + + // Checkout 到最新 commit(只读模式) + let head = try repo.headBranch() + try repo.checkout(branch: head, strategy: .Force) + + // 重建增量索引 + let changedFiles = try diffChangedFiles(repo) + try await indexManager.rebuild(changedFiles, in: repoID) +} +``` + +### 性能基准 + +| 指标 | 目标 | 测量方式 | +|------|------|----------| +| 冷启动 | < 800ms | 进程启动到首帧 | +| 全文搜索 | < 50ms | 10k 篇文档关键词查询 | +| 增量同步 | < 2s | 50 文件变更 | +| 内存峰值 | < 150MB | 10k 文档加载后 | + +## 数学公式支持 + +知识系统中常涉及数学表达,Markdown 渲染器需要支持 LaTeX 公式。 + +行内公式:当知识熵 $H(X) = -\sum_{i=1}^{n} p(x_i) \log_2 p(x_i)$ 越高时,信息的不确定性越大。 + +块级公式——信息增益的计算: + +$$ +IG(S, A) = H(S) - \sum_{v \in Values(A)} \frac{|S_v|}{|S|} H(S_v) +$$ + +贝叶斯定理在知识更新中的应用: + +$$ +P(H|E) = \frac{P(E|H) \cdot P(H)}{P(E)} +$$ + +其中 $P(H)$ 是先验概率,$P(E|H)$ 是似然,$P(H|E)$ 是后验概率。 + +## Obsidian 语法覆盖 + +### 标签 + +行内标签:#思考 #知识管理 #工作流 + +嵌套标签:#思考/方法论 #工具/Obsidian + +标签属性块(Frontmatter 中的 tags)已在本文头部定义。 + +### 图片引用 + +Obsidian 支持多种图片引用语法: + +```markdown + + + + +![[knowledge-flow.png]] + +![[knowledge-flow.png|600]] + +![[knowledge-flow.png|600x400]] +``` + +> [!info] 图片处理说明 +> 在 Leaf 阅读器中,图片引用解析为本地路径后,优先使用缩略图加载。缺失图片时显示路径占位符。 + +### 引用块 + +> 普通引用 + +> [!quote] 带标题的引用 +> 内容可以有多行 +> 第二行 + +> [!warning] 警告块 +> 过度结构化是知识系统的头号杀手。 + +> [!example] 示例块 +> 这是一个 Callout 示例,Obsidian 使用 `> [!type]` 语法。 + +> [!note]- 可折叠笔记 +> 这段内容默认折叠,点击展开。 +> 适合放置补充说明。 + +### 任务列表 + +- [x] 完成知识系统设计文档 +- [x] 实现 FTS5 全文索引 +- [ ] 接入 libgit2 同步层 +- [ ] 支持 Mermaid 图表渲染 +- [ ] 实现 Wikilink 双向链接 + +### 脚注 + +知识系统的核心是「连接而非收集」[^1]。这一观点最早由 Niklas Luhmann 的 Zettelkasten 方法验证 [^2]。 + +[^1]: 连接的价值在于产生新的理解,而非增加信息量。 +[^2]: Luhmann 在 40 年间产出了 70+ 本书和近 400 篇论文,全部基于其卡片盒系统。 + +### 表格(GFM 扩展) + +| 对比项 | 传统分类 | 双向链接 | +|--------|----------|----------| +| 预设成本 | 高(需设计完整目录) | 低(随用随建) | +| 维护成本 | 高(重构频繁) | 低(自然生长) | +| 发现性 | 依赖目录浏览 | 依赖链接跳转 | +| 扩展性 | 受限于目录层级 | 无限扩展 | +| 适合场景 | 稳定知识域 | 探索性思考 | + +### 定义列表 + +Obsidian 兼容的 HTML 定义列表: + +