前言¶
在 DeepSeek Harness（DSH）裏用智能體做長任務時，主會話往往已經堆了上下文：當前任務、剛改的文件、剛出現的報錯。此時若臨時想問一句「這個錯誤什麼意思」「這個函數是幹什麼的」，常見做法只有兩種：新開一個會話（要重新講一遍背景），或在主線程裏直接問（問答會寫進即將交接的 transcript，還容易把 agent 帶偏）。
dsh-assist-chat 提供第三種方式：在右側 dock 打開一條與當前主會話 fork 出來的旁支對話，旁支繼承打開瞬間的全部上下文，且與主線程 transcript 完全隔離。思路與 ZCode 的 side chat 類似——右側標籤頁、真實並行會話，而不是模態框，也不佔用主區域。
這是什麼¶
dsh-assist-chat 是 DSH 的客戶端插件（僅 client API，無 host 側代碼、不 patch DSH 本體文件），由維護者 sleep123937 發佈，源碼與說明見 GitHub 倉庫，社區目錄頁：skillhub.cn/plugins/sleep123937/dsh-assist-chat。插件在會話標題欄提供 Side chat 入口，在右側 dock 掛載產品自帶的 Conversation 界面（流式輸出、Markdown、工具卡片、審批、Stop、輸入框等與主會話一致），而不是自繪一套聊天 UI。
核心功能¶
下面介紹 README 中已說明、且與實現一致的能力。
分支而非空白會話¶
每次打開 Side chat，都會對當前屏幕上的主會話做一次 fork（sessions.fork），旁支裏已有 fork 之前的全部消息，無需從零複述任務背景。
與主線程隔離¶
旁支是獨立的 Session、獨立的 agent、獨立的 transcript；你在旁支裏的提問與回答不會寫入主會話。主線程在字節級別上保持不變。fork 是快照：旁支不會自動同步你之後在主線程裏新發的內容；若需要更新後的上下文，應關閉標籤頁後重新打開 Side chat。
原生對話表面¶
面板通過 renderFactorySlot("conversation.content", …) 掛載 DSH 內置對話組件（variant: "embedded"），行爲與主區域一致。
與會話綁定的生命週期¶
- 每個主會話對應自己的旁支：在看會話 A 時，不會出現會話 B 的 Side chat。
- 標籤頁打開期間旁支保持（切換標籤或摺疊 dock 仍存活）；關閉標籤頁後釋放並歸檔旁支。
- 旁支在左側會話列表中故意隱藏（仍是有寫權限的真實 Session）；關閉標籤後歸檔。FAQ 說明：若旁支已被歸檔但標籤仍開着，DSH 可能靜默拒絕 model step，此時可重新打開標籤。
多標籤¶
右側 dock 支持多標籤與分屏；每個旁支與其 fork 來源的主會話綁定。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議瀏覽倉庫源碼與 MIT 許可證。兼容 DeepSeek Harness >= 0.2.0（package.json 中 engines.dsh）；README 寫明在 0.2.1-rc.3、desktop profile 上測試過。Node 需 >= 20（開發/校驗腳本用，普通用戶按 DSH 文檔使用即可）。
官方安裝方式如下（三選一）：
# from npm (recommended)
dsh plugin --profile desktop add dsh-assist-chat
# or straight from the repository
dsh plugin --profile desktop add github:sleep123937/dsh-assist-chat
# or point at a local checkout
dsh plugin --profile desktop add link:/absolute/path/to/dsh-assist-chat
若使用瀏覽器構建，將 --profile desktop 換成 --profile web。安裝後需重啓 DeepSeek Harness，Side chat 按鈕纔會出現在會話標題欄。
當前 npm 包版本爲 0.1.1（以 package.json 爲準）。
典型用法¶
- 在主會話中照常與 agent 協作，積累任務與上下文。
- 點擊會話標題欄中的 Side chat 按鈕。
- 右側 dock 打開 Side chat 標籤，其中已是當前主會話的 fork 副本。
- 在旁支中提問（例如解釋報錯、評估某思路是否可行）；回答基於 fork 時刻的完整上下文。
- 用完後關閉該標籤；主會話 transcript 不受影響。
適用場景與注意¶
適合：長任務中需要臨時追問、又不想污染主 transcript 或打斷主 agent 流程的 DSH 用戶；習慣 ZCode 式右側輔助對話的開發者。
注意：
- 旁支不會跟蹤主線程後續消息；需要新上下文時請關閉後重新打開 Side chat。
- 左側列表裏找不到旁支 Session 是設計行爲，不是安裝失敗。
- 社區目錄（skillhub.cn）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；插件亦非 DSH 官方內置功能，屬社區「一切皆插件」生態中的客戶端擴展。
問題反饋可通過 GitHub Issues（含 bug / feature 模板），或郵件 zousleep@163.com。
結尾¶
dsh-assist-chat 把「有上下文、又不弄髒主線程」的追問收進右側 dock：fork 當前會話、獨立 Session、原生聊天界面。若你在 DSH desktop 或 web 上需要 Side chat，可按上文命令安裝並重啓客戶端。
