Obsidian 笔记助手

要解决什么问题

很多团队把 Obsidian 当作本地知识库，但大模型对话默认碰不到你磁盘上的 .md 文件。你需要在聊天里查某条笔记、补一段会议记录，或按标题新建页面时，往往要手动复制粘贴，上下文也容易断。

本技能把 Obsidian vault 当作可操作的笔记后端：在 Agent 对话中直接对库内文件做读写与检索，而不是只讨论「该怎么记笔记」。

技能如何工作

技能描述的核心能力可以概括为四类操作：

• 读取：打开 vault 中的既有笔记，把内容纳入当前对话上下文。
• 搜索：在笔记集合里按关键词或语义线索定位相关页面，减少你口述路径的成本。
• 创建：在约定目录下新建 Markdown 笔记（含 front matter 或纯正文，取决于你的库规范）。
• 编辑：对已有文件追加段落、改写片段或更新结构化字段，变更落盘到本地库。

平台标注为 linux、macos、windows，意味着技能面向本机已安装 Obsidian、且 vault 路径可被运行环境访问的场景；Agent 通过技能接口与本地笔记文件交互，而不是替代 Obsidian 的同步或插件生态。

适用边界与注意点

• 技能边界是 vault 内的 Markdown 笔记，不包含 Obsidian 专有插件 API、Canvas、或云端同步冲突的自动仲裁。
• 路径权限、.gitignore 式排除目录、以及是否允许覆盖文件，应由你在使用 Agent 前与库结构对齐，避免批量改写误伤模板或归档区。
• 若 vault 体积很大，搜索与全库扫描的成本取决于实现与索引策略；对话里宜先缩小范围（文件夹、近期笔记）再让 Agent 深读。