README.md

August 26, 2026 · View on GitHub

dsh-synapse

DeepSeek Harness 的可视化对话工作台

npm version Main branch tests MIT license Node.js version

中文指南 · English guide · npm · 开发与发布

把同一工作区中的会话、追问和分支组织成一张可浏览、可拖拽、可缩放的地图,同时保留 DSH 原生会话作为唯一事实来源。

Synapse 会话地图:链条、分支和右侧详情

快速安装

需要支持 profile 插件机制的 DeepSeek Harness、Node.js >= 22.19.0,以及 web profile。

corepack pnpm dsh plugin --profile web add dsh-synapse
corepack pnpm dsh web

启动后,在 DSH 顶部切换到 会话地图。Synapse 复用现有的 DSH Web Server,不会启动第二个应用或代理系统。

它解决什么问题

能力说明
对话地图把连续追问、分支和不同会话放到同一张可操作的画布上。
保留真实分支按 DSH 原生 fork 关系连接卡片,不制造另一套会话历史。
追问更顺手选中回答中的文字可直接带入新的追问;常用补充词可编辑。
双向同步在地图或 DSH 原生对话中切换会话,当前上下文保持一致。

从原生对话进入

在 DSH 原生对话中,通过顶部的 会话地图 进入 Synapse;返回 对话 后,仍是同一个 DSH 会话。

DSH 原生对话与会话地图入口

文档

文档内容
中文指南安装、启动、配置、使用、卸载和限制。
English guideInstallation, configuration, usage, cleanup, and limitations.
开发与发布本地验证、GitHub Actions、版本标签和 npm 发布。
架构与边界会话归属、投影、数据存储和模型影响。

与 DSH 的边界

  • DSH session log 保存真实会话内容;Synapse 只投影已提交的事件。
  • Synapse 的画布布局数据保存在 $DSH_HOME/synapse/,删除它不会删除 DSH 会话。
  • 插件不修改 prompt、模型请求、工具 schema、provider 路由或可复用 KV-cache 前缀。
  • 内置 patch 仅支持 DSH 的 web profile。

开发

corepack pnpm install --frozen-lockfile
corepack pnpm run build
corepack pnpm test

完整的贡献、CI/CD 和发布流程见开发与发布指南

许可证

MIT