Obsidian Vault Studio
把本地 Obsidian 知识库接入 DeepSeek Harness。模型经你授权后可以检索笔记、读取片段、组装上下文，并以“先提案、后写入”的方式创建或追加笔记。索引、向量和统计都留在本机。
English
能做什么
- 本地索引：解析 Markdown、frontmatter、标签、标题与修改时间，不把整个 Vault 上传到远端。
- 可用的检索：默认关键词检索，支持英文前缀和输入时自动更新结果；可选 OpenAI 兼容或 Ollama Embedding，启用混合/语义检索。
- 会话访问开关：默认禁止模型访问 Vault。关闭时所有
obsidian_*Agent 工具都会被拒绝，你自己的检索和笔记浏览不受影响。 - 安全写入：模型只能提出新建或追加提案；你确认后才落盘。每次写入有备份，可撤销；不提供删除、移动、重命名或覆盖工具。
- 数据大盘：笔记/字数/标签/片段统计、每日热度、活动曲线、Agent 调用次数、最近编辑和标签分布。
- 完全本地：索引、向量、设置和调用统计都保存在本机。
安装
要求
- DeepSeek Harness 0.2.x 桌面版，支持安装第三方插件
- 一个本地 Obsidian Vault
安装方式
DeepSeek Harness 支持从 GitHub 仓库或 npm 包安装，二选一：
- GitHub 仓库：
https://github.com/spark-ai-boy/dsh-obsidian-bridge - npm 包：
dsh-obsidian-bridge
步骤
- 在 DeepSeek Harness 左侧栏打开 插件。
- 点击 添加插件 → 安装第三方插件。
- 在输入框中填写上面的 GitHub 仓库地址 或 npm 包名，然后点击安装；安装完成后点击启用。
- 在左侧栏打开 Obsidian 知识库。
首次配置
- 在 设置 里选择 Vault 路径，点击 保存。
- 点击 重建索引。第一次索引完成后，概览和检索就可以用了。
- 检索模式默认是 关键词，不需要额外配置。
- 如果要使用语义或混合检索，在设置里填写 OpenAI 兼容或 Ollama 的 Embedding 地址、模型和维度，先点 测试连接，保存后再重建索引。
- 首页右侧的 允许 Obsidian 内容参与会话 默认关闭。需要 Agent 使用 Vault 时再打开；关闭后所有
obsidian_*工具调用会被直接拒绝。
使用
概览
首页集中展示知识库状态：笔记数量、字数、标签、近 7 天更新、片段数、每日热度、14 天活动曲线、Agent 调用次数和最近编辑。
检索
在 检索 页输入关键词或前缀，结果会随输入自动更新。可以按文件夹、标签筛选，把需要的片段加入右侧 上下文，再复制为带来源的上下文包，或直接让 Agent 通过工具检索。
笔记
在 笔记 页浏览和阅读笔记。模型写入走提案流程：
- 模型提出新建或追加内容。
- 页面展示目标路径和 diff。
- 你确认后才会写入。
- 写入后可以撤销，插件会保留备份。
在会话中使用
- 打开首页右侧的 允许 Obsidian 内容参与会话。
- 在 DeepSeek Harness 会话里让模型检索你的笔记，例如：
- “从我的 Obsidian 里找 RAG 相关的笔记，并给出处。”
- “把今天的会议记录追加到项目笔记里。” - 只有实际检索到或读取的片段会进入会话，不会自动把整个 Vault 塞进 prompt。
- 不需要时关闭访问开关，后续工具调用会被拒绝。
Agent 工具
| 工具 | 用途 |
|---|---|
obsidian_search |
检索笔记片段，支持模式、文件夹、标签筛选 |
obsidian_read_note |
读取某篇笔记的完整内容 |
obsidian_list_notes |
列出笔记或按条件筛选 |
obsidian_stats |
读取索引、统计和工作区状态 |
obsidian_propose_write |
生成新建/追加提案，不直接写入 |
obsidian_apply_write |
在你确认后应用提案 |
obsidian_undo_write |
撤销本次会话中的写入 |
obsidian_index_status |
查看索引和向量化进度 |
插件不提供删除、移动、重命名或覆盖笔记的工具。
隐私与安全
- 索引、向量、设置、调用统计都在本机。插件不包含遥测，也不会上传 Vault。
- 允许 Obsidian 内容参与会话关闭时，所有
obsidian_*Agent 工具在执行前被拒绝；Vault Studio 自己的检索和浏览仍然可用。 - 系统提示要求模型在 Obsidian 工具失败时报告错误，不得通过通用文件工具绕过 Vault Studio 或访问开关。
- 访问开关只限制
obsidian_*工具；如果你需要更严格的隔离，请同时检查 DeepSeek Harness 的 workspace/sandbox 权限，避免通用read、grep、bash直接访问 Vault 路径。 - 写入操作需要确认，带备份，可撤销；插件不会自动删除或覆盖笔记。
License
MIT
