前言¶
在 DeepSeek Harness（DSH）里并行开多个会话时，侧边栏列表很快会变成「找上次聊到哪儿」的负担：状态分散、分叉对话的上下文要靠记忆串起来。常见做法是切标签或翻历史，但空间关系不会留在脑子里。
dsh-talk-map 是 DSH 的客户端插件，把每个会话画成无限白板上的卡片，用位置和连线代替纯列表记忆。下面介绍它做什么、怎么装、日常怎么操作，以及数据落盘与兼容范围。
这是什么¶
dsh-talk-map（Talk Map）由维护者 Da0Mine 发布，分类为客户端插件。仓库说明其源自 Tasihi89/dsh-talk-map（MIT），本仓库为大幅改写的 fork：槽位布局、可缩放工作区、溢出抽屉与路由连线等在此新增或重写。
一句话定位：DSH Desktop 上的可视化对话地图——工作区文件夹、会话卡片、带摘要注入的分叉边（digest push edges）。
核心功能¶
空间记忆，而非靠工作记忆排列表¶
卡片可自由放置并 16px 网格吸附，插件不会自动重排；你记住「那次对话在左下」，它就一直在左下。README 写明面向 ADHD 用户设计，对需要同时盯多路对话的人也适用。
工作区与溢出抽屉¶
工作区是一层可自动展开或折叠的框；放不下的会话收进栈格，点开抽屉查看列表。置顶卡片始终保持在前面。
双击开聊、拖线分叉¶
- 双击空白画布：在该位置创建新会话并进入；卡片就生在点击处。
- 双击卡片：打开对应会话。
- 从卡片把手拖到空白处：预览（并可编辑）要注入的上下文摘要，确认后 fork 出新会话，新会话「知道」旧对话。
卡片正面 = 续聊入口¶
标题、你最后一句、相对时间、状态灯（running / finished / unread / waiting / interrupted）。一眼判断下一步该点哪张卡。
连线的语义¶
上下文仍是最新的连线会消失；落后的上下文保留为虚线箭头。分叉谱系始终画出。
自动摘要（digest）¶
按需通过部署的默认模型生成三字段摘要（summary / key findings / next step）；点卡片上的 ⟳ 可重新生成。除 DSH 本地 LLM 通道外，README 说明无其他外网请求。
双语界面¶
地图内文案支持中文或英文。页眉语言 pill 循环 Auto → 中文 → English；Auto 跟随 DSH 语言，选择会跨重启记住。
状态轨（Status rail）¶
左侧可折叠条只列出带灯状态的卡片（running / waiting / unread / interrupted）。状态变化时卡片跳到顶部，顺序可拖；稳定后移出列表。展开/收起状态会记住。
安装与启用¶
推荐用 npm 注册名安装；也可直接从 GitHub 添加（仓库已提交构建产物，无需本地 build）：
# npm (recommended)
dsh plugin add dsh-talk-map
# or straight from GitHub — built artifacts are committed, so there is no build step
dsh plugin add github:Da0Mine/dsh-talk-map
安装后重启 dsh web；侧边栏底部会出现地图按钮。
插件以当前 DSH 进程权限运行。安装前请自行查看源码与 MIT 许可证，确认符合你的环境与合规要求。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。
典型用法¶
| 操作 | 效果 |
|---|---|
| 侧边栏地图按钮 / Esc | 开关地图 |
| 拖动卡片 | 放置（16px 网格吸附，持久化） |
| 双击空白 | 在该处创建会话并进入 |
| 双击卡片 | 打开该会话 |
| 从卡片把手拖到空白 | 预览注入 → fork 新会话 |
| 点击栈格 | 打开抽屉，列出折叠的会话 |
| 卡片上 ⟳ | 重新生成 digest |
| 右键卡片 / 连线 / 文件夹 | 置顶、重命名、标未读、归档、删除、推送开关、删连线等 |
| 地图页眉语言 pill | 循环 Auto → 中文 → English |
数据存放与兼容¶
- 画布数据（位置、边、digest）：经 DSH 官方 storage-domain 原子写入
$DSH_HOME/storages/talk_map.json。 - 会话本体仍完全由 DSH 管理；插件只读取，fork 时通过官方 API 创建新会话。
README 写明在 DeepSeek Harness 0.2.1-rc.3 上构建并测试；升级 DSH 时可从仓库 src/client/dsh.ts 与 src/host/dsh-host.ts 中的结构契约入手对照。
路线图（尚未实现，仅作方向参考）：多板 shelf、整板归档、时间线视图、别名卡片、多父合并 UI、选区级注入、卡片快捷提问等。
适用场景与注意¶
适合：同时在 DSH 里维护多条会话、需要分叉带上下文、希望用空间布局而不是纯列表找对话的开发者或重度用户。
注意：
- digest 依赖你配置的 DSH 默认模型与本地 LLM 通道。
- 插件不替代 DSH 的会话存储；卸载或清数据前请备份
$DSH_HOME/storages/talk_map.json若你依赖布局与连线。 - 与 DSH 版本绑较紧，大版本升级后若异常，应对照上述契约文件与插件 Issue。
结尾¶
dsh-talk-map 把 DSH 的多会话管理从「列表 + 记忆」换成「白板 + 卡片 + 有意义的连线」，安装命令简单，启用后从侧边栏地图按钮进入即可。细节与截图见 GitHub README；安装入口见 SkillHub 目录页与仓库：
