前言¶
在 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 目錄頁與倉庫：
