前言¶
在 DeepSeek Harness（DSH）里做带上下文的对话或 Agent，常见做法是手写检索脚本、临时拷贝笔记片段，或把整个目录丢进通用文件工具。Obsidian 库往往体量大、路径分散，整库上传既不现实，也难保证引用可追溯。dsh-obsidian-bridge（界面名 Obsidian Vault Studio）由 spark-ai-boy 维护，在 DSH 侧边栏提供本地索引、检索与「先提案、后写入」的笔记操作，索引与向量留在本机。下文按安装、首次运行与对话用法说明可复现步骤。
这是什么¶
dsh-obsidian-bridge 是 DSH 第三方插件，npm 包名与仓库同名，当前资料中的版本为 0.1.18，许可证 MIT。它解析本地 Obsidian 库的 Markdown（含 frontmatter、标签、标题、修改时间），在机器上建立索引与可选向量，不将整库上传；模型通过一组 obsidian_* Agent 工具检索、阅读并在你批准后追加或新建笔记。DSH 社区目录将其归类为「记忆」，与官方应用商店无从属关系，安装来源以 SkillHub 目录页 与 GitHub 仓库 为准。
核心功能¶
下面能力均来自项目 README，按使用路径归纳。
本地索引与检索¶
插件在本地解析笔记结构，不上传完整库。默认 Keyword 检索，支持英文前缀匹配与输入时即时结果；若在设置中配置 OpenAI 兼容或 Ollama 的 embedding 端点、模型与维度，经「Test connection」并 Rebuild index 后可使用语义或混合模式。检索可按文件夹、标签过滤，并将段落加入 Context 托盘，复制带来源标注的上下文包，或交由 Agent 通过工具搜索。
数据大盘¶
侧边栏 Obsidian Vault Studio 首页展示笔记数、字数、标签数、分块数、7 日更新等统计；365 日热力图、14 日活动曲线、Agent 调用计数、最近笔记与标签分布亦在同一面板，便于对照库活跃度与工具使用情况。
对话接入开关¶
Allow vault context in conversations 默认关闭。关闭时，所有 obsidian_* Agent 工具在执行前被拒绝；插件内的搜索与浏览仍可用。开启后，模型才能通过工具访问库内容；用毕建议关闭，后续工具调用将被拒绝。README 另说明：该开关仅约束 obsidian_*；若需硬边界，还需结合 DSH 工作区/沙箱权限，避免通用 read、grep、bash 触及库路径。
安全写入¶
模型不能删除、移动、重命名或直接覆盖笔记。写入路径为：模型提出新建或追加 → 界面展示目标路径与 diff → 你批准后执行；写入有备份，会话内可撤销。对应工具为 obsidian_propose_write 与 obsidian_apply_write，撤销用 obsidian_undo_write。
Agent 工具一览¶
| 工具 | 作用 |
|---|---|
obsidian_search |
按模式、文件夹或标签搜索段落 |
obsidian_read_note |
读取整篇笔记 |
obsidian_list_notes |
列出或筛选笔记 |
obsidian_stats |
读取索引、统计与工作区状态 |
obsidian_propose_write |
创建追加/新建提案（不写盘） |
obsidian_apply_write |
在你批准后应用提案 |
obsidian_undo_write |
撤销本会话内的一次写入 |
obsidian_index_status |
查看索引与 embedding 进度 |
对话中只有实际检索或读入的段落进入上下文，不会自动注入整库。系统提示要求模型在 Obsidian 工具失败时如实上报，且不得借通用文件工具绕过 Vault Studio 与接入开关。
隐私¶
索引、向量、设置与使用计数均本地保存；插件无遥测、不上传库。索引与向量数据路径由你在设置中指定的 vault 与插件本地存储决定，运行权限等同于当前 DSH 桌面进程，安装前宜浏览源码与 MIT 许可证。
安装与启用¶
环境要求¶
- DeepSeek Harness 0.2.x 桌面版，并已允许安装第三方插件（
package.json中engines.dsh为>=0.2.1-rc.5） - 本机已有的 Obsidian 库目录
安装源¶
DSH 可从下列任一来源安装，勿自行拼接未在文档出现的 CLI 命令：
- GitHub 仓库：
https://github.com/spark-ai-boy/dsh-obsidian-bridge - npm 包名：
dsh-obsidian-bridge
步骤¶
- 在 DSH 侧边栏打开 Plugins。
- 选择 Add plugin → Install third-party plugin。
- 填入上述 GitHub 仓库 URL 或 npm 包名，安装完成后点击 Enable。
- 在侧边栏打开 Obsidian Vault Studio。
首次运行¶
- 打开 Settings，选择 vault 路径，点击 Save。
- 点击 Rebuild index；首次索引完成后大盘与搜索可用。
- 检索模式默认为 Keyword，无需额外配置。
- 若需语义或混合检索：在 Settings 填写 OpenAI 兼容或 Ollama 的 embedding 端点、模型、维度，Test connection，保存后再次 Rebuild index。
- 大盘上的 Allow vault context in conversations 默认关；需要 Agent 读库时再打开。
典型用法¶
在界面中搜索与组上下文¶
在 Search 页输入关键词或前缀，结果随输入更新；可按文件夹、标签筛选，将段落加入 Context，复制带引用的上下文包，或在关闭/开启接入开关的前提下自行浏览 Notes 页。
在对话中使用库¶
- 在大盘打开 Allow vault context in conversations。
- 向模型提出与库相关的任务，例如 README 中的表述：
- “Find my notes about RAG and cite the sources.”
- “Append today’s meeting notes to the project note.” - 确认仅检索到的内容进入对话；不用时关闭接入开关。
模型改笔记¶
流程与 Notes 页一致：提案 → 查看路径与 diff → 批准 → 必要时 Undo。自动删除、移动、重命名、覆盖均不提供。
适用场景与注意¶
适合已经在 Obsidian 中沉淀笔记、希望在 DSH Agent 对话里做可引用检索、并控制写盘风险的开发者或个人用户。keyword 模式开箱即用；语义/混合检索依赖你可用的 embedding 服务与本机重建索引的时间。
插件以 DSH 进程权限访问你配置的 vault 路径；第三方插件应从可信来源安装，并结合 DSH 沙箱限制通用文件工具。社区目录上的 star 数等元数据会变动，以页面与 GitHub 实时显示为准。
结尾¶
dsh-obsidian-bridge 把 Obsidian 库的索引、混合检索、大盘统计与带审批的写入收进 DSH 侧边栏，在默认关闭 Agent 接入的前提下尽量把数据留在本机。进一步了解功能与截图见仓库 README；安装与分类信息见 SkillHub 目录，源码与 issue 见 GitHub。
