前言¶

在使用 DeepSeek Harness（DSH）進行開發或調試時，經常需要在主線任務運行的同時，向模型詢問細節或排查問題。如果直接在主對話中插入問題，會污染主線的模型上下文；如果 fork 一個新的會話，操作步驟又略顯繁瑣。需要一個既能隨時提問、又不干擾主進程的工具。

是什麼¶

這是一個針對 DeepSeek Harness Web GUI 的客戶端插件，由開發者 zclDragon 維護。它實現了 Codex 風格的 /side 命令，允許在運行中的主對話旁邊打開一個臨時分叉對話。該側邊對話繼承主線已完成的歷史上下文，進行“邊跑邊問”，且不會打斷主任務。

核心功能¶

• /side 命令：通過命令快速開啓或管理側邊對話。
• 浮動側邊面板：在界面右下角提供開關與操作入口，支持新建、切換和關閉。
• 實時問答：側邊對話繼承主線截至最後一個 turn/end 的上下文，支持流式渲染與停止。
• Markdown 渲染：回覆內容支持 Markdown 格式（標題、代碼塊、表格等），流式跟隨滾動。
• 併發不中斷：側聊 agent 與主 agent 同進程併發運行，主任務不會被阻塞。
• 關閉即移除：關閉側邊面板時，agent 會被 dispose 並歸檔，從界面消失。
• 不污染主線：/side 命令僅在主線程日誌中留下一條記錄，不會進入模型上下文。

安裝與啓用¶

1. 執行安裝命令：

    dsh plugin --profile web add @zhuchenglong/dsh-side-chat

2. 重啓 dsh web 或刷新瀏覽器後生效。

典型用法¶

1. 在瀏覽器中打開 GUI（默認 http://127.0.0.1:3080）。
2. 在主對話界面中，點擊右下角的「💬 側聊」按鈕，或直接輸入 /side 命令。
3. 在彈出的側邊面板中，點擊「＋ 新建」創建一個側邊對話。
4. 在輸入框中輸入問題，模型將流式返回結果。

適用場景與注意¶

• 適用場景：適合在主任務運行過程中進行實時交互，比如詢問代碼細節、解釋報錯或進行多輪調試，而不需要建立獨立的對話窗口。
• 已知限制：
  • 進程重啓後，側聊的“分組關係”不會自動恢復（會話本身是持久化的），需手動重新關聯。
  • 側聊的上下文繼承截止於主線上的最後一個 turn/end，正在進行中的 turn 無法繼承。
  • 新建的側聊在面板列表中最長需等待 3 秒輪詢刷新後出現。
• 注意事項：該插件爲社區維護項目，遵循 MIT 許可證。安裝前建議查看源碼與許可證，確保符合您的使用規範。

結尾¶

該插件通過輕量級的側邊交互解決了 DeepSeek Harness 中的上下文污染問題。更多詳情與源碼可訪問 GitHub。