liangmianya/dsh-synapse

dsh-synapse

中文指南 · 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 和发布流程见开发与发布指南。

许可证