dsh-synapse
DeepSeek Harness 的可视化对话工作台
中文指南 · English guide · npm · 开发与发布
把同一工作区中的会话、追问和分支组织成一张可浏览、可拖拽、可缩放的地图，同时保留 DSH 原生会话作为唯一事实来源。
快速安装
需要 DeepSeek Harness >= 0.1.7-rc.2（本插件依赖该版本的 Host 会话与 Client 服务接口）和 Node.js >= 22.19.0。
兼容性提示： 本版本包含破坏性变更，仅支持 DeepSeek Harness >= 0.1.7-rc.2，不再兼容更早版本。
先确认插件要装进哪一套 profile。DSH 按 profile 分套安装插件，桌面 App 和命令行各用一套，互不影响：
| 你平时怎么用 DSH | 要装的 profile | 安装命令 |
|---|---|---|
| 桌面 App（DeepSeek Harness 客户端） | desktop | corepack pnpm dsh plugin --profile desktop add dsh-synapse |
| 命令行 dsh web / 浏览器访问 | web | corepack pnpm dsh plugin --profile web add dsh-synapse |
| 两种都用 | 两套各装一次 | 两条命令都执行 |
- 从 App 内的插件页面安装时，App 会自动装进它自己用的那套，不用管 profile。
- 自检口诀：装完顶部看不到「会话地图」开关，就是装到另一套去了，换成另一条命令再装一次即可。
- 桌面 App 装完需要重启 App（Host 侧插件在启动时加载）；命令行装的，重启
dsh web并刷新页面。
# 命令行方式：装好后启动
corepack pnpm dsh plugin --profile web add dsh-synapse
corepack pnpm dsh web启动后，在 DSH 顶部切换到 会话地图。Synapse 复用现有的 DSH Web Server，不会启动第二个应用或代理系统。
它解决什么问题
| 能力 | 说明 | |---|---| | 对话地图 | 把连续追问、分支和不同会话放到同一张可操作的画布上。 | | 保留真实分支 | 按 DSH 原生 fork 关系连接卡片，不制造另一套会话历史。 | | 追问更顺手 | 选中回答中的文字可直接带入新的追问；常用补充词可编辑。 | | 双向同步 | 在地图或 DSH 原生对话中切换会话，当前上下文保持一致。 |
从原生对话进入
在 DSH 原生对话中，通过顶部的 会话地图 进入 Synapse；返回 对话 后，仍是同一个 DSH 会话。
文档
| 文档 | 内容 | |---|---| | 中文指南 | 安装、启动、配置、使用、卸载和限制。 | | English guide | Installation, configuration, usage, cleanup, and limitations. | | 开发与发布 | 本地验证、GitHub Actions、版本标签和 npm 发布。 | | 架构与边界 | 会话归属、投影、数据存储和模型影响。 |
与 DSH 的边界
- DSH session log 保存真实会话内容；Synapse 只投影已提交的事件。
- Synapse 的画布布局数据保存在
$DSH_HOME/synapse/，删除它不会删除 DSH 会话。 - 插件不修改 prompt、模型请求、工具 schema、provider 路由或可复用 KV-cache 前缀。
- 内置 patch 由 profile 的 bundle 列表引入，桌面 App（
desktop）与命令行（web）都适用。
开发
corepack pnpm install --frozen-lockfile
corepack pnpm run build
corepack pnpm test完整的贡献、CI/CD 和发布流程见开发与发布指南。