dsh-synapse 是什么？DeepSeek Harness 的 DSH plugin 能力解析

dsh-synapse 是 DeepSeek Harness 的可视化会话地图 DSH plugin：它把同一工作区的会话、追问与分支组织成一块可拖拽缩放的画布，并保留原生会话为唯一事实来源（来源）。 这篇只解析这一个插件，按三个方向讲：它解决什么需求、怎么装与启用、以及使用时的依赖、权限与同类取舍。

概览：一句话定位 dsh-synapse 这个 DSH plugin

它解决的是「会话一多就迷路」——把线性的会话列表升级成可导航的地图。 你问过什么、从哪一条岔出追问、哪个分支还没收尾，都能在图上直接看到。它是界面（UI）类插件，不改模型能力，也不碰工作区文件。

它解决什么需求：把 DeepSeek Harness 的线性对话变成可导航的地图

痛点很具体：一个工作区里会话越攒越多、追问越岔越深，列表式界面只能按时间滚动，看不到结构。 dsh-synapse 用四个能力对应：

1. 对话地图画布 — 把会话、追问与分支摆到同一块画布上，可拖拽、可缩放。预期：一眼看清整体脉络，而不必逐个点开。
2. 保留真实分支 — 追问产生的分支在图上是真实结构，不是视觉上的装饰。预期：分支关系与实际会话一致。
3. 追问更顺手 — 在图上直接接着某个节点继续追问。预期：追问的归属清楚，不会串到别的会话。
4. 双向同步 — 画布与原生会话保持一致。预期：图上改动落到原生会话，原生会话变化也反映到图上。

关键点在于「原生会话是唯一事实来源」——dsh-synapse 不另存一份，所以不用担心出现两套数据各说各话。以工作区为单位组织，意味着换工作区就换一张地图。

怎么装与启用这个 DSH plugin：市场与命令行、profile 归属

安装走标准插件通道，两条路二选一：

1. 图形化安装 — 打开插件市场搜 dsh-synapse，点安装。界面类插件都在这里按分类找，入口是 DSH Plugin Hub。预期：已安装列表出现 dsh-synapse。
2. 命令行安装 — 一条命令装完：

dsh plugin --profile web add dsh-synapse

预期：重启 dsh web 后画布入口出现。

profile 归属要留意：插件按 profile 安装与生效，--profile 必须指向你正在运行的那个环境；网页版是 web profile，桌面端独占自己的 profile，装错地方界面上不会出现。从源码装则用 dsh plugin --profile web add github:liangmianya/dsh-synapse。

使用注意与边界：DeepSeek Harness 依赖、权限、与同类插件的取舍

它是界面类插件，权限面相对窄，但依赖与来源仍要看清。

1. 依赖与授权 — 从 npm 安装最省事；从 GitHub 直装可能触发构建依赖，需要 allowBuilds 授权，未审过源码不要放行。
2. 权限边界 — 界面类插件主要用于展示与导航，本身不直接读写工作区文件；对可控性敏感的场景，这一点比工具类插件更友好。
3. 与同类插件的取舍 — 想要轻量的会话侧栏切换，侧栏类插件更合适，见《dsh-better-sidebar 是什么》；需要分支与追问的全局视图，才用 dsh-synapse 的画布。
4. 先小范围试 — 会话很多时画布的信息密度上升，先用真实工作区试一轮，确认可读性再做日常主力。

使用 dsh-synapse 这个 DSH plugin 的注意事项

1. 它不生成会话：dsh-synapse 是视图层，会话本身仍由 DeepSeek Harness 原生机制产生与保存。
2. profile 别装错：装到非运行中的 profile，界面不会出现入口。
3. 来源要认准：优先市场与官方 npm 包名 dsh-synapse，不要从不明来源拉包。
4. 画布不是备份：它可视化原生会话，不做数据备份，清理会话前仍要按会话管理流程确认。
5. 与同类分工：侧栏类管快速切换，地图类管全局结构，按需求选一个主用即可。

来源：liangmianya/dsh-synapse、dsh CLI README、dshplugin/dsh-plugin-hub