前言¶
在 DSH 会话中处理任务时，往往需要频繁引用本地材料：参考图、剪辑片段、设计稿、研究笔记。这些内容如果只存在当前会话的临时上下文里，关闭会话后就丢失。DSH 的默认能力是处理当前工作区文件，跨会话持久化则需要外部工具。
Sourcebook Desktop 是一款本地知识库工具，把链接、文件和笔记整理成 Book，跨项目复用。这个插件让 DSH 的内置 MCP 客户端直接连上 Sourcebook Desktop 的 sourcebook-mcp 助手，无需额外适配服务，也不需要复制凭证。DSH 的内置侧边栏浏览器可以打开 Sourcebook 的 HTTP(S) 链接，从而在会话内浏览和检索本地库。
是什么¶
这是一个社区插件，把 DSH 与本地 Sourcebook Desktop 的 MCP 服务连接起来。它是一个独立打包，与 DeepSeek 无官方从属关系。使用前需在本地安装并运行 Sourcebook Desktop，且仅支持 macOS（默认路径针对标准安装位置）。插件通过 patch 机制注入 MCP 客户端配置，无需手动配置。
核心能力¶
- 从 Sourcebook 检索并导入到 DSH：在 Sourcebook 中打开本地服务，选定 Book，搜索相关条目，把选中的文件源作为临时上下文文件传给 DSH；DSH 通过常规 workspace 工具读取这些文件。
- 打开 HTTP(S) 链接：DSH 返回 Sourcebook 的本地 HTTP(S) 地址后，点击即可在 DSH 的内置侧边栏浏览器中打开，用于浏览链接类条目。
- 把工作成果交回 Sourcebook：让 DSH 提议新增文本、导入本地文件、或更新 Book 中的源元数据。DSH 发出建议后，在 Sourcebook 中确认或拒绝，只有接受后库才会变更。
- 为下一会话保留上下文：新增文本和文件可以附带来源或用途说明，方便后续会话快速定位。
安装与启用¶
系统要求¶
- DSH，需内置 @deepseek-ai/dsh-mcp-client。
- Sourcebook Desktop，安装在运行 DSH 的同一台电脑上，并保持运行。
- 仅支持 macOS；默认路径指向标准安装位置。
安装 Sourcebook Desktop¶
下载并安装 macOS（Apple silicon）DMG：
macOS (Apple silicon) DMG — click to download
DSH Desktop 安装¶
- 打开 DSH Desktop。
- 进入 Settings → Plugins → Add plugin。
- 输入仓库地址：https://github.com/Yanze-He/dsh-sourcebook。
- 完成添加流程。
- 重启 DSH。启动新对话，让 DSH 打开 Sourcebook 并列出你的 Books。DSH 会启动 Sourcebook Desktop 并返回本地 HTTP(S) 链接，点击即可在侧边栏浏览器中打开。
DSH Web profile 安装¶
在终端运行：
dsh plugin --profile web add github:Yanze-He/dsh-sourcebook
为了使 Sourcebook 返回的 HTTP(S) 链接在侧边栏浏览器中打开，需将 DSH 的 Link opening method 设置为 In-app sidebar。支持的协议为 public 和 loopback HTTP(S)，浏览器会拒绝 file:、data:、blob: 以及 DSH 自己的 origin。
若 Sourcebook 安装在其他位置¶
默认 patch 使用标准 macOS 路径：
command: /Applications/Sourcebook Desktop.app/Contents/Resources/agent-plugin/.agents/plugins/sourcebook/bin/sourcebook-mcp
如果你的安装位置不同，需修改 cordis.patch.yml 中的 command 值为实际 helper 路径，然后以本地检出安装到 DSH profile：
dsh plugin --profile web add /path/to/dsh-sourcebook-plugin
典型用法¶
- “打开 Sourcebook，在 Launch Book 里找到这个项目的参考。”
- “用选中的源起草一个 brief，然后把最终文本和笔记提交到 Launch Book，并附上用途说明。”
- “把这个本地文件导入到 Launch Book，然后打开 Sourcebook 以便审核提交结果。”
适用场景与注意¶
- 适合视频与视觉创作者、设计师、写作者、研究人员，需要跨项目复用材料与笔记。
- 适合在多个 DSH 会话或智能体之间流转有用材料，并在本地库中保持有序。
- 注意：插件以当前 DSH 进程的权限运行，安装前建议查看源码与许可证。
总结¶
这个插件把 DSH 的处理能力与 Sourcebook Desktop 的本地知识库连接起来，让材料检索与工作成果回流更方便。目录页与源码仓库：
- 目录页：https://www.skillhub.cn/plugins/Yanze-He/dsh-sourcebook
- GitHub：https://github.com/Yanze-He/dsh-sourcebook
