前言¶
用 DeepSeek Harness(命令名 dsh)跑長任務時,主會話裏很快會堆出大段代碼、報錯和解釋。真正卡住的往往只是其中一小段:某次工具輸出、某段實現說明、某一行假設。如果直接在主輸入框追問,新問題會混進當前任務的上下文;另開一個會話,又丟掉剛纔那一輪的前綴。
DeepSeek Harness 的官方倉庫把這件事寫得很直接:Everything is a Plugin(一切皆插件)。模型、工具、會話、界面都可以換成社區插件。dsh-side-chat 做的就是其中一塊會話交互:在網頁客戶端裏選中已完成消息中的文字,到右側獨立側欄追問,主對話繼續留在原處。
需要先說清來源。DeepSeek Harness 由 DeepSeek AI 開源,倉庫是 deepseek-ai/deepseek-harness,目前仍是 developer preview,接口還會變。下面介紹的插件目錄 deepseek-harness-plugin.com 是社區站點,和 DeepSeek / 幻方沒有官方從屬關係,不能當成官方應用商店。本文按該目錄詳情頁、插件 GitHub 倉庫(含中英文 README、package.json、CHANGELOG)交叉覈對後整理。
這是什麼¶
dsh-side-chat 是一款面向 DeepSeek Harness Web 客戶端的會話與消息插件,由 GitHub 用戶 AHGGG 維護,許可證 MIT,主要語言 TypeScript。npm 包名是 @ahggg/dsh-side-chat,當前倉庫版本爲 0.6.1(CHANGELOG 日期 2026-08-17)。截至 2026 年 8 月 18 日,GitHub 倉庫顯示 12 星。
它解決的問題可以收成一句話:在不離開、也不改寫當前主會話的前提下,針對選中的文本開一條聚焦的側邊對話。
目錄頁和倉庫 README 都寫明:當前發佈精確對應 @deepseek-ai/dsh@0.1.0-rc.6。package.json 裏的 peerDependencies 同樣釘在 0.1.0-rc.6,客戶端 platform 爲 web。換到別的 dsh 版本前,先看倉庫是否已經跟進。
核心功能¶
選中文字,三種入口¶
主會話至少完成一輪之後,在同一條已完成的用戶或助手消息內選中文字,會出現三個動作(倉庫中英文 README 用的是英文按鈕文案):
Add to chat:先寫一條可選批註,再把選中段落掛到主會話輸入框。已有草稿會保留;多段帶序號的文本和各自批註可以收進同一個 annotation 膠囊。More details:立刻發出一條解釋請求。Ask in side chat:自己寫聚焦問題,在右側側欄裏繼續聊。
自己輸入時,Enter 發送,Shift+Enter 換行。完成後按 Esc 或點 × 關閉。回覆生成期間,發送圖標會變成停止按鈕。助手回覆走 DSH 自帶的 Markdown 渲染。
側欄模型與主會話分開¶
發送按鈕旁有模型控件,用來選 provider / model 以及可用的推理等級。這項選擇只屬於 Side Chat,不會改主會話的模型;保存後會作爲下一次打開 Side Chat 的全局默認值。CHANGELOG 0.6.0 起加入了模型與推理控件,並會記住上次選擇。
主會話會一直留在頁面上,不會被切到 child Session。
第一次發送會 fork 一條真實會話¶
第一次在側欄發送時,插件會在所選消息處創建一個真實的 DSH Session fork。child 繼承完整事件前綴、preset 和 workspace。初始模型優先用最近一次被接受的 Side Chat 選擇;沒有已保存選擇時,才快照主會話配置。之後改模型或推理等級,只作用於 child 的後續 step。
README 說明:保持前綴不變有利於供應商的 prompt cache 複用,但不保證命中緩存。
關閉側欄時,插件會停掉正在跑的任務、歸檔 child Session,並釋放對應 Agent。磁盤上的 child 歷史不會刪除,因此 child 和複製出來的完整前綴會佔用正常的 DSH Session 存儲。
批註可以送回主輸入框¶
Add to chat 這條路徑和側欄追問是分開的。保存批註後,選區會出現在主會話 composer 裏;發送前可以懸停膠囊點 × 去掉,發送後同一個膠囊會出現在用戶消息上方。懸停 N annotations 能預覽每一段選中文本和對應批註。
安裝與啓用¶
社區目錄給出的安裝命令如下,在 DeepSeek Harness 終端裏運行即可:
dsh plugin add github:AHGGG/dsh-side-chat
目錄頁同時提示:如需可復現安裝,應固定 commit 哈希。截至 2026 年 8 月 18 日,倉庫 master 對應 0.6.1 發佈提交爲 81d62a07c35d6a301eeeaa27b793c868a6572fe6:
dsh plugin add github:AHGGG/dsh-side-chat#81d62a07c35d6a301eeeaa27b793c868a6572fe6
倉庫 README 寫的是裝到 web profile、並從 npm 拉 @ahggg/dsh-side-chat。添加前只刷新這個包的 registry 元數據,避免 pnpm 剛發版後仍復用舊的 latest:
npm install --global @deepseek-ai/dsh@0.1.0-rc.6
pnpm cache delete "@ahggg/dsh-side-chat"
dsh plugin --profile web add @ahggg/dsh-side-chat@latest
然後進入希望 Agent 操作的真實工程目錄,啓動 Web 界面:
cd /path/to/your-project
dsh web --port 3080
打開 dsh 打印出來的地址,插件會自動加載到 Web 客戶端。package.json 要求 Node.js 爲 ^22.19.0 或 >=24.0.0。
升級和卸載(同樣來自倉庫 README):
pnpm cache delete "@ahggg/dsh-side-chat"
dsh plugin --profile web update @ahggg/dsh-side-chat --latest
dsh plugin --profile web remove @ahggg/dsh-side-chat
插件以當前 dsh 進程的權限運行,安裝時可能執行代碼。裝之前請覈對源代碼倉庫和許可證;不要只憑插件名搜索,確認倉庫是 AHGGG/dsh-side-chat、包名是 @ahggg/dsh-side-chat。
典型用法¶
下面按倉庫 README 的步驟走一遍,不額外編造界面截圖或效果數據。
- 確認本機是
dsh 0.1.0-rc.6,並已按上一節把插件裝進 web profile。 - 在目標工程目錄執行
dsh web --port 3080,用瀏覽器打開輸出的本地地址。 - 在主會話裏先完成至少一輪對話,讓頁面上出現已完成的用戶或助手消息。
- 在同一條消息內拖選一段文字,例如某次命令輸出、某段函數說明。
- 若只是想把這段話帶回主輸入框並加一句自己的備註,點
Add to chat,Enter或Save保存;點批註框外部或Cancel則放棄。 - 若希望馬上得到解釋,點
More details。 - 若要圍繞這段文字多問幾輪、又不想打亂主任務,點
Ask in side chat,在右側輸入問題後按Enter。需要換模型或推理等級時,用發送按鈕旁的控件,改的是側欄,不是主會話。 - 問完後按
Esc或點×。主會話還在,側欄這條 child 會被歸檔。
倉庫 docs/assets/side-chat-demo.gif 是官方演示動畫,安裝前可以先看一遍交互。
適用場景與注意事項¶
比較適合這些情況:
- 主任務還在跑,只想對某一段輸出做局部追問。
- 希望側欄用另一套模型或推理等級,主會話保持原配置。
- 需要把多段原文連同批註一起送回主輸入框,而不是把整段歷史複製粘貼一遍。
使用前要看清邊界,這些都來自倉庫 README,不是推測:
- 選區必須落在同一條已完成消息內,不能跨消息、也不能選正在生成的內容。
- 暫不支持附件,也沒有
/side命令。 - 關閉後不能從面板重新打開原來的 Side Chat;沒有自動清理歷史,也沒有「保留爲普通會話」的操作。
- 已歸檔的 child 可能短暫出現在普通會話列表裏。
- 父會話和 child 共用同一個 workspace。 側欄裏產生的文件修改、命令執行和其他工具副作用都是真實的,關掉面板不會撤銷。
- child 歷史留在磁盤上,會佔用正常的 Session 存儲。
另外,DSH 仍在快速迭代,插件又釘死 0.1.0-rc.6。升級 dsh 之後如果側欄不出現或報錯,先回到倉庫覈對兼容性,而不是假設新版本一定能用。
小結¶
dsh-side-chat 把 Codex 風格的側邊追問接到了 DeepSeek Harness 的網頁會話上:選中一段已完成消息,在右側獨立會話裏把細節問完,主對話不被帶跑。它是 AHGGG 維護的 MIT 開源插件,當前版本 0.6.1,只適配 dsh 0.1.0-rc.6 的 Web 客戶端。
安裝前讀源碼、看許可證,並記住側欄和主會話共享工作區——側欄裏改過的文件不會在關面板時自動還原。目錄頁和倉庫地址如下:
- 目錄頁:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-side-chat/
- GitHub:https://github.com/AHGGG/dsh-side-chat
- DeepSeek Harness 官方倉庫:https://github.com/deepseek-ai/deepseek-harness