Obsidian DeepSeek Harness
August 16, 2026 · View on GitHub
把 DeepSeek Harness 的官方客户端嵌入 Obsidian，并让 DSH 会话真正属于原生文件和文件夹。
当前能力
- 左侧仍是 Obsidian 原生文件树，文件和文件夹旁显示其 DSH 会话数量。
- 一个文件或文件夹可以绑定多个 Session，并可从历史 Session 中选择或继续新建。
- 文件夹会绑定到同名 DSH 文件工作区；文件会绑定到其父目录工作区。
- 右侧使用官方 DSH rc.6 对话、轨迹、Session log、子代理、工具详情、设置和模式选择组件。
- 只连接本机
http://127.0.0.1:3080；插件不会启动第二个 DSH 实例。 - Obsidian 中央编辑器及其 Markdown、Canvas、PDF 等原生视图不被替换。
本项目只支持 Obsidian 桌面版。macOS 已完成实机验证；Windows 具备代码与 CI 支持，但仍需要实际交互验收。
运行要求
- Obsidian 1.8.0 或更高版本
- Node.js 20 或更高版本（仅构建和运行 DSH 时需要）
- DeepSeek Harness
0.1.0-rc.6主实例监听本机 3080 端口
先启动唯一的 DSH 主实例：
npx @deepseek-ai/dsh@0.1.0-rc.6 --port 3080
模型和凭证请通过 DSH 官方设置界面配置；不要提交任何凭证文件。
从源码安装
git clone https://github.com/KafukaTree/obsidian-deepseek-harness.git
cd obsidian-deepseek-harness
npm ci
npm run validate
也可以从 GitHub Releases 下载预览版 ZIP，把其中全部内容解压到：
<Vault>/.obsidian/plugins/deepseek-harness/
关闭 Obsidian，然后把构建产物安装到指定 Vault。脚本会备份旧插件、保留 data.json，并启用插件。
macOS/Linux：
node scripts/install-vault.mjs "/absolute/path/to/your/vault"
Windows PowerShell：
node .\scripts\install-vault.mjs "C:\Users\you\Documents\Notes"
也可以手动把 dist/ 中的 main.js、manifest.json、styles.css、versions.json、plugins/、licenses/ 和许可证文件复制到：
<Vault>/.obsidian/plugins/deepseek-harness/
重新打开 Obsidian 后，在“设置 → 第三方插件”中启用 DeepSeek Harness。
Windows 说明
推荐让 Obsidian 和 DSH 都原生运行在 Windows。不要默认采用“Windows Obsidian + WSL DSH”：Obsidian 传递的是 Windows Vault 路径，而 WSL 中对应路径不同，会导致文件工作区无法正确绑定。
若 PowerShell 阻止 npx.ps1，可改用：
npx.cmd @deepseek-ai/dsh@0.1.0-rc.6 --port 3080
开发
npm run check
npm test
npm run build
CI 会在 Ubuntu、macOS 和 Windows 上执行同一套检查。生产构建位于 dist/，其中包含插件主文件和官方 DSH 客户端 bundles。
隐私与边界
- 仓库不包含任何 Vault、笔记、会话记录、API Key 或个人绝对路径。
- Session 绑定只保存在对应 Vault 的插件
data.json中。 - 插件只接受 loopback DSH 服务，不提供远程服务器配置。
- 安装脚本只写入用户明确传入的 Vault
.obsidian目录。
许可证
本项目采用 MIT License。嵌入构建产物的官方 DeepSeek Harness 组件及其他第三方代码仍归各自权利人所有，详见 THIRD_PARTY_NOTICES.md。
DeepSeek、DeepSeek Harness 和 Obsidian 是其各自权利人的名称或商标。本项目是社区集成项目，不代表官方背书。