知识库mcp
黑曜石MCP笔记系统，用于知识管理、规划和决策跟踪。
目的
该项目定义了 本地优先，代理人可访问黑曜石金库 专为日常个人知识管理、规划和决策跟踪而设计。\ 核心目标是跳马 结构明确，机器可操作，以便AI代理（通过MCP）能够可靠地创建、更新和推理笔记，而不会产生歧义。
vault针对以下方面进行了优化：
- 人的清晰度和长期可维护性
- 确定性代理行为（无猜测）
- 低摩擦捕获和审查
- 想法、计划、项目和决策之间明确的生命周期界限
______________________________________________________________________
核心设计原则
- 涌现结构之上的显式结构\
每个音符都属于一个定义明确的类别，具有明确的语义作用。
- Agent可读语义\
文件夹结构、文件名和模板对意图进行编码，以便代理可以确定地采取行动。
- 本地优先，工具驱动\
所有操作都通过MCP工具（文件系统、模板、索引）在本地markdown文件上进行。
- 思维阶段的分离
- 捕获（收件箱、每日） - 反思（期刊） - 推理（Scratchpad、Notes） - 承诺（计划、决策） - 执行（项目、TODO） - 评论（Reviews） - 成果（目标）
______________________________________________________________________
保险库结构（规范）
_Templates/
00-Inbox/
01-Daily/yyyy-mm/yyyy-mm-dd.md
02-TODOs/
├─ pending/
└─ done/yyyy-mm/
03-Journal/yyyy-mm/yyyy-mm-dd.md
04-Plans/
/
.md
05-Projects/
/
.md
06-Decisions//.md
07-Learning//.md
08-Resources//.md
09-Tools//.md
10-Ideas//.md
11-Notes//.md
12-Scratchpad/
13-Goals/yyyy/.md
13-Goals/done/yyyy/.md
14-Reviews/
├─ weekly/yyyy-mm-dd.md
├─ monthly/yyyy-mm.md
└─ quarterly/yyyy-Qn.md
15-Archive/
├─ goals/
├─ projects/
├─ plans/
├─ notes/这种结构是 稳定且类似契约。代理不得创建新的顶级文件夹。
______________________________________________________________________
MCP代理集成
代理仅通过MCP公开的工具与vault交互。\ 他们是 不是自由撰稿人；它们是遵循明确规则的约束运算符。
代理能力
可指示代理人：
- 创建新的计划、项目、决策、想法或笔记
- 在现有注释中添加或更新部分
- 链接相关工件（例如，项目→ Plan → Goal)
- 写作前阅读相关笔记中的上下文
- 强制执行模板和frontmatter
代理人必须 从不:
- 直接写入任意位置
- 修改历史决策
- 无限期保留收件箱中的内容
______________________________________________________________________
票据类型和代理人职责
收件箱(00-Inbox/)
目的： 无摩擦捕捉\ 代理人行为：
- 分类不清楚时可能会创建收件箱条目
- 在处理任务期间必须升级收件箱项目
______________________________________________________________________
每日笔记(01-Daily/)
目的： 时态日志与短期思维\ 代理人行为：
- 附加总结、任务或观察结果
- 按照指示将TODO或Ideas提取到适当的文件夹中
______________________________________________________________________
期刊(03-Journal/)
目的： 人性反思与叙事连续性\ 代理人行为：
- 默认情况下为只读
- 只有在明确指示的情况下，才能创建新的日记条目
- 当明确要求时，可以附加逐字用户听写
- 除非明确要求，否则不得提取、重构、总结或分析期刊内容
- 不得自动将期刊内容推广到计划、项目、决策、TODO或想法中
______________________________________________________________________
想法(10-Ideas/)
目的： 原始但有意的概念\ 代理人行为：
- 每条笔记创建一个想法
- 避免过早结构化
- 链接到相关笔记或学习（如果可用）
______________________________________________________________________
计划(04-Plans/)
目的： 实现目标的策略\ 代理人行为：
- 需要一个明确的目标
- 参考一个或多个目标
- 枚举候选项目
______________________________________________________________________
项目(05-Projects/)
目的： 执行单位\ 代理人行为：
- 可以引用一个或多个计划或目标
- 跟踪状态和具体交付成果
- 表面TODO和决策
______________________________________________________________________
决定(06-Decisions/)
目的： 记录不可逆的选择\ 代理人行为：
- 使用严格的模板（上下文、选项、决策、后果）
- 一旦写好，就把决策当作不可改变的
- 链接到受影响的项目或计划
______________________________________________________________________
评论(14-Reviews/)
目的： 定期综合、反思和航向修正\ 代理人行为：
- 可以根据现有笔记准备摘要草稿和增量
- 不得设定优先级或自主决策
- 必须保留人类撰写的结论
______________________________________________________________________
存档(15-Archive/)
目的： 非活动或已完成工件的明确退役\ 代理人行为：
- 只有在明确指示的情况下，才能将笔记移动到存档
- 必须保留原始内容和元数据
- 不得修改已存档的笔记
______________________________________________________________________
模板作为合同
所有代理人书面记录必须来自 _Templates/.
模板定义：
- 所需章节
- 前言架构
- 允许的出站链接
如果缺少必填字段，代理应很快失败。
______________________________________________________________________
审查和维护循环
该系统假设定期进行人工审查：
- 每日：收件箱、每日笔记
- 每周：TODO、活动项目
- 每月：计划、学习、想法
- 季刊：目标、决策
代理人可能会协助审查，但永远不会取代人类的判断。
______________________________________________________________________
非目标
本项目有意避免：
- 全文语义自动组织
- 自动重构vault结构
- 云依赖或SaaS耦合
保险库是一个 工具基板，没有第二个为你思考的大脑。
______________________________________________________________________
结束状态
一个确定性的、可由代理操作的黑曜石金库，其中：
- 人类思维清晰
- 特工行动精准
- 结构确保正确性
- 知识复合多年，而不是几周