前言¶
用 DeepSeek Harness(dsh)跑智能體時,主會話往往已經堆了很長的任務上下文:讀過哪些文件、改過哪段代碼、下一步要提交什麼。這時突然想確認「這個目錄裏哪個文件最大」,或者想單獨分析一段事件流,如果直接把問題丟進主對話,答案會進模型上下文,後續回合很容易被帶偏。
OpenAI Codex 用 /side 開持續性側會話,Claude 用 /btw 做一次性旁問,思路都是:旁路提問,主線程不動。社區插件 dsh-sidechain 把這兩類命令接到了 dsh 上:在當前會話的臨時 fork 裏跑側鏈,主會話歷史保持不變。
DeepSeek Harness 的核心理念是「一切皆插件」。本文介紹的目錄頁來自社區站點 DeepSeek Harness 插件庫,它和 DeepSeek / 幻方沒有官方從屬關係,不是官方應用商店。下文按該目錄詳情頁、GitHub 倉庫 README / package.json / dsh.plugin.json,以及 deepseek-ai/deepseek-harness 交叉覈對,整理這個插件是什麼、怎麼裝、怎麼用。
這是什麼¶
dsh-sidechain 是一款會話與消息類插件,由 GitHub 組織 omdsh-dev 維護,倉庫地址是 omdsh-dev/dsh-sidechain。npm 包名爲 @dsh-external/dsh-sidechain,當前版本 0.6.4,許可證 BSD-3-Clause,主要語言 TypeScript。2026-08-18 打開 GitHub 時顯示 9 顆星;社區目錄頁同期仍顯示 6 顆星,以倉庫頁面爲準。
它要解決的問題很具體:在不中斷、不污染主會話的前提下,再開一條側問或可持續追問的子會話。實現方式是 fork 當前會話,得到獨立子會話。側會話繼承主會話裏已經完成的回合作爲參考上下文,但擁有自己的消息記錄和工具執行過程;提示、思考、工具調用和回答都不會進入主會話的模型上下文。Web UI 裏會在右側打開側鏈面板,主會話界面保持原樣。
dsh.plugin.json 聲明的引擎範圍是公開版 DSH 0.0.1-rc.5 或 ^0.1.0-rc.6。倉庫 README 寫明當前版本按這兩檔適配,開發依賴固定到 0.1.0-rc.6。目錄頁「更多介紹」仍只寫到 rc.5,應以倉庫 dsh.plugin.json 和 README 爲準。
核心功能¶
插件對外暴露三條斜槓命令:
| 命令 | 用途 |
|---|---|
/btw <問題> |
一次性側問,適合快速確認信息 |
/side <問題> |
創建可持續追問的側會話 |
/side list |
列出當前會話的直接子代理 |
/btw 對標 Claude 風格的一次性旁問:命令立刻返回,側鏈面板自動打開,後臺跑完單輪問答。這條線程是隻讀的,不能繼續追問。主會話在它跑的時候仍可繼續用。
/side 對標 Codex 風格的持續性側會話:面板打開新線程後,在線程底部輸入消息並按 Enter,就可以接着聊。/side 和 /btw 都必須帶上問題;README 寫明當前 subagent API 不支持先建空線程、再等第一次輸入。
右側面板是這個插件的主要界面。會話標題欄有側鏈按鈕;快捷鍵是 Ctrl/Cmd+Shift+E。面板可以拖拽調寬、展開、手動刷新。列表裏會顯示當前會話的直接子代理,以及類型、標題、運行狀態和活動摘要。選中一條線程後,時間線裏能看到:
- 用戶消息與模型回答
- 上下文注入與模型思考
- 工具調用、結果和錯誤
- Markdown、代碼塊、表格與公式
子會話歷史會持久化,重啓 DSH 之後仍可查看。面板只讀取子會話日誌,不會切換或激活主會話裏的當前對話。
隔離邊界也寫在 README 裏,需要單獨記住:
- fork 不包含父會話正在進行的那一輪。
- 繼承內容只作參考,boundary 之後的消息纔是側會話的當前任務。
- 側會話的消息、工具活動和回答留在子會話中,不會作爲用戶消息或子代理通知寫回主會話。主會話只保留「創建側會話」這條命令的結果。
- 默認 persona 偏向非破壞性探索:不會主動改文件、請求提權、再創建子代理,或向父會話彙報。用戶如果在側會話裏明確要求修改,實際權限仍由 DSH 的 sandbox 和工具配置決定。
可選配置項如下(均來自倉庫 README):
| 配置項 | 默認值 | 說明 |
|---|---|---|
providerName |
fork |
用來創建子會話的 subagent provider |
persona |
內置側會話 persona | 側會話行爲約束;空字符串表示沿用部署 persona |
readOnlyTools |
未設置 | 可選工具 allow-list,例如 ['read', 'grep', 'glob'] |
安裝與啓用¶
社區目錄頁給出的安裝命令如下,在 DeepSeek Harness 終端裏運行即可:
dsh plugin add github:omdsh-dev/dsh-sidechain
目錄頁同時說明:如需可復現安裝,可固定 commit 哈希。2026-08-18 覈實時,倉庫 master 最新提交是 b56038b22e037c52b189cef37f96702ab307bf3c(提交說明爲支持官方 DSH rc.6):
dsh plugin add github:omdsh-dev/dsh-sidechain#b56038b22e037c52b189cef37f96702ab307bf3c
倉庫 README 有兩點補充,安裝前值得看一眼。
第一,這個插件依賴 DSH 自帶的 dsh-subagent、dsh-subagent-fork 和 dsh-commands。默認 Web profile 已經包含這些依賴。package.json 裏也把客戶端平臺寫成了 web,會向 Web UI 注入側鏈面板。因此裝到網頁界面時,更穩妥的是帶上 --profile web:
dsh plugin --profile web add github:omdsh-dev/dsh-sidechain
README 原文裏的 GitHub 路徑寫成了 github:Buyi-wsgzg/dsh-sidechain。該路徑對應另一份同名倉庫,最近向 omdsh-dev/dsh-sidechain 提交代碼的作者也是 Buyi-wsgzg,兩邊內容接近。本文介紹的是目錄收錄、由 omdsh-dev 維護的這一份,安裝命令以目錄頁的 github:omdsh-dev/dsh-sidechain 爲準。
第二,pnpm 10 及以上首次安裝 Git 依賴時,可能會提示允許執行 prepare。按命令輸出把插件鍵加入 Web profile 的 pnpm-workspace.yaml,再重新執行安裝命令。插件會向 Web profile 寫入類似下面的配置層:
- insert:
- id: dsh-sidechain
name: '@dsh-external/dsh-sidechain'
需要限制側會話只用只讀工具時,可以在同一層加上 config:
- insert:
- id: dsh-sidechain
name: '@dsh-external/dsh-sidechain'
config:
providerName: fork
readOnlyTools:
- read
- grep
- glob
安裝或更新代碼後,重啓 dsh web 並刷新頁面。卸載命令在 README 中是:
dsh plugin --profile web remove @dsh-external/dsh-sidechain
它會同時去掉 profile 依賴和插件配置層,完成後同樣需要重啓 dsh web 並刷新。
目錄頁和 README 都提醒:插件以當前 dsh 進程的權限運行,安裝時可能執行代碼。裝之前應檢查源代碼倉庫和許可證。
典型用法¶
一次性側問,適合那種不想寫進主會話的確認:
/btw 這個目錄下哪個文件最大?
命令會馬上返回。側鏈面板打開後,可以看到執行過程和答案。這條線程不能追問;還要繼續挖,改用 /side。
持續側會話:
/side 分析一下當前插件的事件流
面板會打開新線程。在底部輸入框發後續消息即可。主會話可以繼續原來的任務。
查看當前會話下已經掛上的直接子代理:
/side list
注意:/side list 和側欄列出的是當前會話的全部直接子代理,不限於本插件創建的線程。如果同時裝了其他會 fork 子會話的插件,列表裏也會出現它們。
適用場景與注意事項¶
比較適合這些情況:
- 主會話正在改代碼或寫方案,只想旁路確認一個事實,答案不必進主上下文
- 需要單獨分析事件流、目錄結構或某段實現,並可能追問幾輪
- 使用 DSH Web UI,希望在右側面板裏看側鏈的思考、工具調用和回答,而不是把主對話切走
使用前注意下面幾條,均來自目錄頁或倉庫說明,不是額外發揮:
- 先覈對 DSH 版本。 當前適配
0.0.1-rc.5和0.1.0-rc.6。DSH 仍處於 developer preview,核心插件和 API 還會變,升級前應再看倉庫engines字段。 - 側鏈不是空會話。
/side必須帶首個問題;fork 也不包含父會話正在進行的回合。 /btw只有一輪。 只讀、不能續聊。需要多輪就用/side。- 默認 persona 不等於零權限。 它約束的是側會話「不會主動破壞」;用戶明確要求改文件時,仍走 DSH 的 sandbox 和工具策略。若希望側問儘量只讀,用
readOnlyTools收緊 allow-list。 - 這是社區插件,不是官方應用。 發現渠道是獨立目錄站和 GitHub topic
dsh-plugin。安裝前讀源碼和 BSD-3-Clause 許可證;需要可復現環境時固定 commit,而不是長期追蹤浮動的默認分支。 - Web 界面是一等能力。 側鏈面板、快捷鍵和即時摘要都掛在 Web profile 上。只在純終端環境裏裝,README 描述的右側面板將不可用。
小結¶
dsh-sidechain 把 Codex 的 /side 和 Claude 的 /btw 接到 DeepSeek Harness:用 fork 開獨立子會話,主會話的模型上下文不被側問污染。一次性確認用 /btw,需要追問用 /side,列表和麪板用來查看子代理狀態。對已經在 Web UI 裏跑長任務、又經常需要旁路提問的人,它補的是會話隔離,而不是新的模型能力。
參考地址:
- 社區目錄頁:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-sidechain/
- GitHub 倉庫:https://github.com/omdsh-dev/dsh-sidechain
- DeepSeek Harness:https://github.com/deepseek-ai/deepseek-harness