Knowledge Wiki

本项目是一个本地优先的 Obsidian 个人知识库。它的核心用途是：在和 LLM 交谈时，如果出现值得长期保留的知识、方法、判断、例子或排错模式，就调用 co-build-learning-note，把内容整理成可填空的 Markdown note。

这些 note 不是聊天归档，而是个人知识库中的原子知识单元。默认通过 MOC、Obsidian 双链和 underline-fill 填空来帮助主动输出。

包含内容

• vault/：可直接用 Obsidian 打开的知识库。
• skills/co-build-learning-note/：记录笔记的 skill。
• obsidian-plugins/underline-fill/：实时渲染下划线填空内容的 Obsidian 插件。
• mcp-server.js：笔记类 MCP server，提供 note 检索、模板读取、MOC 列表、note 生成和写入工具。

Vault 结构

路径	用途
vault/00_System/templates/	note 模板。
vault/00_System/indexes/Home.md	知识库首页。
vault/01_Notes/inbox/	默认新 note 收件箱。
vault/01_Notes/concepts/	概念类原子 note。
vault/01_Notes/methods/	方法、流程、判断抓手。
vault/01_Notes/prompts/	可复用提示词和交互策略。
vault/01_Notes/decisions/	决策理由和取舍记录。
vault/01_Notes/troubleshooting/	排错模式、症状、修复路径。
vault/01_Notes/references/	来源摘要和可引用材料。
vault/02_MOCs/	Maps of Content，用来组织双链网络。
vault/03_Sources/	外部来源原文、论文、博客摘录。
vault/04_Attachments/	图片、PDF、附件。
vault/04_Knowledge/	兼容已有长期知识笔记。
vault/08_Imports/	导入材料暂存。

Note 约定

每篇 note 聚焦一个可复用知识单元，并尽量包含：

• type、status、tags、aliases
• up:: [[MOC - ...]]
• related::、contrast::、source::
• 核心判断
• 适用信号
• 失效边界
• 例子或对照
• 至少一个 underline-fill 主动输出题
• 与 blank 分离的 Answer Key

Underline Fill

新笔记只使用 underline-fill。

块形式：

```underline-fill
latex: \text{核心判断：} {{core_blank_1}}
```

行内形式：

`underline-fill latex: \text{迁移前先检查：} {{transfer_blank_1}}`

每个 {{field_name}} 应在 frontmatter 中有同名字段，默认值为空字符串。

验证

pnpm install
pnpm test
pnpm check
pnpm mcp