企业官网建设流程全解析

dsh-synapse 是 DeepSeek Harness（DSH）的一个 Web 插件，中文名「会话地图」。它把同一工作区里的会话、追问和分支铺成一张可拖拽、可缩放的画布，但不接管你的对话——DSH 原生会话仍是唯一事实来源。这篇文章只讲一件事：怎么从零把它装起来、跑通、再干净地卸掉。当前 npm registry 上的最新版本是 0.4.2，MIT 许可，仓库最近一次提交在 1 天前。

装之前先确认三件事

它的前提条件写得很明确，缺一条都会白装：

• DeepSeek Harness>= 0.1.7-rc.2。本版本含破坏性变更，不再兼容更早版本；插件直接依赖该版本的 Host 会话与 Client 服务接口。

• Node.js>= 22.19.0。

• 使用webprofile；内置 patch 只往 web profile 注册，其他 profile 暂不支持。

DSH 本体还没装的话，先补一句npm install -g @deepseek-ai/dsh。

三条安装渠道，先挑最省事的

同一句 add 命令背后有三条来源，差别在「谁在什么时候构建」。

npm 渠道：预构建产物，不需要构建授权

npm 包分发的是已经构建好的产物，安装过程不跑构建脚本，也因此不需要任何构建授权——最省事的一条路。npm 包dsh-synapse的发布者账号已校验与仓库一致。

GitHub 渠道：会跑 prepare 脚本

走 GitHub 时，安装会执行本包的prepare脚本，并用node --check验证 JavaScript 语法。代价是它会受 pnpm 10 及以上版本的allowBuilds机制影响：若构建被拦截，得按 pnpm 的输出把完整键写进 profile 的pnpm-workspace.yaml，只填裸包名无效，细节以官方中文指南为准。

link: 渠道：本地开发安装

link:直接软链本地 checkout，适合改代码调试。普通运行模式下改完代码，建议重启dsh web并刷新页面。

启动与端口

启动后默认地址是http://127.0.0.1:3080/，点顶部「会话地图」即可进入。如果 3080 被占用，让 DSH 自己挑端口：

上手七步

1. 在 DSH 里选一个工作目录，或打开已有会话。

1. 发至少一条消息，让会话进入工作区历史。

1. 点顶部「会话地图」。

1. 点卡片或侧边栏会话，在地图与原生对话之间同步当前会话。

1. 用「分支」从已完成的回答创建替代路径。

1. 点卡片底部「详情」查看完整会话记录。

1. 用「打开 DSH」或顶部「对话」回到原生界面。

第二步入门时最容易漏：没发过消息的会话不会进入工作区历史，地图里自然看不到它。

画布能做什么

• 拖动画布、缩放视图（最高 4×）。

• 拖动卡片并自动保存位置。

• 展开或折叠后续对话子树。

• 一键定位当前会话。

• 卡片内平滑滚动、渲染 Markdown 表格。

• 按callId把工具调用和结果折叠进对应的助手回答。

配置怎么覆盖

插件通过 profile 的cordis.patch.yml注入，用行 idsynapse就能覆盖默认配置。可覆写的键有dataFile（默认$DSH_HOME/synapse/workspaces.json）、autoProjection（默认true）、projectionWorkspaceTitle（默认DSH 任务）和trustedHosts（默认空数组，localhost与127.0.0.1始终放行）。

要在局域网里访问，就把实际访问的主机名或主机:端口加进trustedHosts。

想一次对照多个 DSH 插件的中文清单与安装形态，可以先收藏 完整插件清单与汉化避坑指南。

卸载与数据清理

remove 只摘掉插件依赖与 profile 激活层，画布数据不会跟着消失；重装后旧数据继续使用并按需迁移。要彻底清理，手动删掉$DSH_HOME/synapse/；pnpm-workspace.yaml里残留的allowBuilds键没有副作用，可以一并删除。

老数据的小差异

如果你手上是 v3 版本留下的数据，迁移时工具卡片是按顺序把每次调用与下一条结果配对的，而实时事件用的是callId。所以历史记录里工具调用与结果的归组可能不如新会话精确——知道这一点，就不至于以为画布算错了。

总结

从装到跑通，dsh-synapse 的路径其实很短：确认 DSH、Node 与 web profile 三个前提，选 npm 渠道 add，dsh web起来点「会话地图」就行；更全的插件清单与汉化避坑经验，可以在 完整插件清单与汉化避坑指南 里一并对照。

适合与不适合

适合：需要频繁分支追问、想在地图上找回某条回答的开发者；刚上手 DSH、想用可视化方式理解会话结构的新用户；愿意按官方指南维护本地配置的人。不适合：DSH 仍低于 0.1.7-rc.2 的人；想在非 web profile 下使用的人；期待跨设备同步画布的人。

标签：dsh-synapse、DeepSeek Harness、插件安装、会话地图

本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。