随着 DeepSeek Harness (DSH) 生态的发展，让智能体介入本地知识库管理成为刚需。但在 DSH 环境中直接操作文件系统存在风险，误写或误删可能导致数据丢失。dsh-obsidian-channel 插件旨在解决这一痛点，它为 DSH Agent 提供了一个受控的通道，既能读取和写入本地 Obsidian Vault，又能确保所有写入操作经过用户审批，并提供一键回滚机制。
这是一个由 ShengenWu 维护的 DSH 插件，属于「记忆」分类。它的核心功能是打通 DeepSeek Harness 与本地 Obsidian Vault 的通道，允许 DSH Agent 读取和写入本地笔记，但所有写入操作在执行前需要用户批准，且支持对任何变更进行一键回滚。
核心功能¶
- 安全写入与审批：Agent 对 Vault 的写入操作（创建、更新、追加、删除）均需用户在执行前批准，默认策略为「每次询问」。
- 变更历史与回滚：所有经过 Agent 的变更都会被记录，用户可在设置中查看变更前后内容，并执行一键回滚。回滚本身也是一种 journaled 变更。
- Vault 主页：在侧边栏点击 📓 按钮进入 Vault 主页，提供 Continue（最近笔记）和 Vault changes（变更日志）等组件。
- 智能助手入口：从主页点击笔记或快捷方式（例如「写今日日记」），Agent 会为此条目开启一个新的 Vault 会话，并将文本放入编辑器，等待用户确认发送。
- 路径与配置管理：支持原生文件夹选择器绑定 Vault，每日笔记路径优先读取 Obsidian 的
.obsidian/daily-notes.json配置，支持自定义忽略目录。 - 读写隔离：插件会阻止原生直接写入/编辑 Vault，强制所有变更通过
obsidian_*工具进行，从而保证变更被记录在 Journal 中。 - 数据操作能力：Agent 支持对笔记进行搜索、列表、结构化整理、处理反向链接以及执行 journaled move（重写 Wikilinks）。
安装与启用¶
安装此插件需要满足环境要求：安装并运行 dsh web (版本 0.1.0-rc.6)，以及 Node.js 版本大于等于 20。
在终端中执行以下命令进行安装：
dsh plugin --profile web add github:ShengenWu/dsh-obsidian-channel
安装完成后，重启 dsh web 并访问 http://127.0.0.1:3080 即可使用。
典型用法¶
- 绑定 Vault：首次使用时，点击侧边栏的 📓 按钮，在弹出的界面中粘贴本地 Vault 的绝对路径（如
/Users/you/Notes），点击绑定。 - 开启会话：在 Vault 主页，点击任意笔记或快捷方式（例如「写今日日记」）。Agent 会为此条目开启一个新的 Vault 会话，并将文本放入编辑器，但不会自动发送。
- 确认与执行：在编辑器中检查内容无误后，发送给 Agent。Agent 执行写入前会请求批准。
- 管理变更：在设置页的「Obsidian」选项卡中，可以查看变更历史（Before/After），并点击回滚按钮撤销上一次变更。
- 配置审批策略：在设置中，可以将审批策略切换为「一次任务询问一次」或「从不询问」（不推荐），以平衡安全性与效率。
适用场景与注意¶
- 适用场景：适合需要 DeepSeek Agent 辅助整理、重写或维护本地 Obsidian 知识库的用户。
- 环境要求：Obsidian 应用程序本身无需运行，只需文件系统存在即可。
- 权限风险：此插件以当前 dsh 进程的权限运行。虽然插件拦截了原生写入，但直接使用 Bash 命令仍可能绕过 Journal 机制直接修改文件。建议在处理敏感数据时保持警惕。
- 已知限制：目前插件暂不支持模板、周报回顾以及
[[自动补全功能。
总结¶
该插件通过提供安全的写入通道和回滚机制，解决了智能体操作本地文件的痛点。你可以通过社区目录查看更多插件，或在 GitHub 上查看源码与反馈。
