第二大脑 AI 知识库

要解决什么问题

如果你用本地 Markdown 当「第二大脑」，Agent 往往要么只能只读扫文件，要么写入时缺少路径约束和署名，容易把 vault 弄乱或无法追溯是谁追加了什么。Second Brain AI 把操作收束到单一 vault 目录，并在写入与追加层面试图把边界写清楚。

技能如何工作

运行前必须显式设置环境变量 SECOND_BRAIN_VAULT，技能只在该路径内读写。可选支持 YAML frontmatter 与 [[WikiLinks]] 式链接。

核心工具大致分三类：

• 库结构：init_vault 在 allow_write: true 时初始化标准文件夹结构；capture_note 创建新笔记。
• 受控追加：append_note 向已有笔记追加内容，且 appended_by 必填，用于标明追加者；追加块会带上时间戳与署名格式。
• 检索与上下文：search_notes 按关键词搜索；find_related、get_backlinks 做关联与反向链接；build_context_pack 按主题打包供 Agent 消费；suggest_links 给出链接建议。

写入类操作普遍依赖 allow_write: true，与「只在 vault 内操作」一起构成安全边界。

适用边界与注意点

当前为 Repair Build v2.0：未实现 SQLite 索引，rebuild_index 会返回 skip；检索依赖基于文件的扫描，无语义/向量搜索，也不做自动插链、冲突检测，且仅支持单个 vault。适合需要可控写入与基础链接图谱、而非全文语义库的场景。