用 dsh-side-chat 在 DeepSeek Harness 主會話旁開一條側邊追問

前言

用 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.6package.json 裏的 peerDependencies 同樣釘在 0.1.0-rc.6,客戶端 platformweb。換到別的 dsh 版本前,先看倉庫是否已經跟進。

核心功能

選中文字,三種入口

主會話至少完成一輪之後,在同一條已完成的用戶或助手消息內選中文字,會出現三個動作(倉庫中英文 README 用的是英文按鈕文案):

  1. Add to chat:先寫一條可選批註,再把選中段落掛到主會話輸入框。已有草稿會保留;多段帶序號的文本和各自批註可以收進同一個 annotation 膠囊。
  2. More details:立刻發出一條解釋請求。
  3. 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 的步驟走一遍,不額外編造界面截圖或效果數據。

  1. 確認本機是 dsh 0.1.0-rc.6,並已按上一節把插件裝進 web profile。
  2. 在目標工程目錄執行 dsh web --port 3080,用瀏覽器打開輸出的本地地址。
  3. 在主會話裏先完成至少一輪對話,讓頁面上出現已完成的用戶或助手消息。
  4. 同一條消息內拖選一段文字,例如某次命令輸出、某段函數說明。
  5. 若只是想把這段話帶回主輸入框並加一句自己的備註,點 Add to chatEnterSave 保存;點批註框外部或 Cancel 則放棄。
  6. 若希望馬上得到解釋,點 More details
  7. 若要圍繞這段文字多問幾輪、又不想打亂主任務,點 Ask in side chat,在右側輸入問題後按 Enter。需要換模型或推理等級時,用發送按鈕旁的控件,改的是側欄,不是主會話。
  8. 問完後按 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜