dsh-synapse

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 会话记录按需读取；$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 和发布流程见开发与发布指南。

许可证

MIT