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 |
dsh plugin --profile desktop add dsh-synapse |
命令行 dsh web / 浏览器访问（如果你也维护了这套） |
web |
dsh plugin --profile web add dsh-synapse |
- 从 App 内的插件页面安装时，App 会自动装进它自己用的那套，不用管 profile。
- 自检口诀：装完顶部看不到「会话地图」开关，就是装到另一套去了，把
--profile换成另一套的名字再装一次即可。 - 桌面 App 装完需要重启 App（Host 侧插件在启动时加载）；命令行装的，重启
dsh web并刷新页面。
dsh 是 DSH 运行时自带的 launcher，位于 App 安装目录的 resources\runtime\cli\bin\dsh.cmd。先确认它能调用：
dsh --version
# 装进桌面 App 那套 profile
dsh plugin --profile desktop add dsh-synapse
# 需要命令行形态时（装完重启 dsh web 并刷新页面）
dsh plugin --profile web add dsh-synapse
dsh web
启动后，在 DSH 顶部切换到 会话地图。Synapse 复用现有的 DSH Web Server，不会启动第二个应用或代理系统。
它解决什么问题
| 能力 | 说明 |
|---|---|
| 对话地图 | 把连续追问、分支和不同会话放到同一张可操作的画布上。 |
| 保留真实分支 | 按 DSH 原生 fork 关系连接卡片，不制造另一套会话历史。 |
| 追问更顺手 | 选中回答中的文字可直接带入新的追问；常用补充词可编辑。 |
| 双向同步 | 在地图或 DSH 原生对话中切换会话，当前上下文保持一致。 |
| 过程不挡路 | 工具调用与结果按 callId 折叠进对应回答，只显示「工具 N」。 |
| 可移动入口 | 顶部「对话 / 会话地图」开关可拖动、记忆位置、双击复位。 |
| 详情侧栏 | 点卡片在右侧展开整轮详情：完整回答、工具过程、追问 / 分支 / 打开 DSH。 |
| 归档一致 | 归档在地图与 DSH 侧栏之间共用同一份集合，不会各记一套。 |
最近更新
0.5.6
- 顶部开关可拖动、记忆位置（按浏览器）、双击复位、方向键微调，并保证不会被拖到屏幕外。
- 交互与渲染一致性修正：切会话会把该会话带入视野；折叠卡片不再移动画布；正文里有选区时侧栏与详情仍能更新；卡片右侧折叠 / 分支按钮不再被相邻卡片遮住。
- 工作区加载竞态修正：切换工作区不再被后台轮询顶掉；画布只在数据真变化时重建（此前每秒重建数次）。
workspaces.json读不出来时改为明确报错并保持只读，不再用旧备份覆盖原文件。
历史版本见提交记录。
从原生对话进入
在 DSH 原生对话中，通过顶部的 会话地图 进入 Synapse；返回 对话 后，仍是同一个 DSH 会话。
这个开关挡着内容时可以挪走：按住左侧六点手柄拖动，位置按浏览器记住；双击手柄复位；手柄聚焦后可用方向键微调。
文档
| 文档 | 内容 |
|---|---|
| 中文指南 | 安装、启动、配置、使用、卸载和限制。 |
| English guide | Installation, configuration, usage, cleanup, and limitations. |
| 开发与发布 | 本地验证、GitHub Actions、版本标签和 npm 发布。 |
| 架构与边界 | 会话归属、投影、数据存储和模型影响。 |
与 DSH 的边界
- DSH session log 保存真实会话内容；Synapse 只投影已提交的事件。
- Synapse 只保存画布布局和每轮对话的短预览，消息正文始终从 DSH 会话记录按需读取；
$DSH_HOME/synapse/删除后不会丢会话，只会丢布局。 - 插件不修改 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 和发布流程见开发与发布指南。