前言¶
在 DeepSeek Harness (DSH) 的工作流中，直接詢問智能體“你的看法”通常只能得到單一維度的結論。由於缺乏外部壓力，智能體往往會傾向於尋找支持其初始觀點的論據，導致結論缺乏對抗性。
dsh-debate 通過引入正式的辯論機制來解決這一問題。它將一個問題拆解爲“正方”與“反方”兩個對抗性子智能體，兩者分別進行獨立研究並辯論，最後由主智能體根據辯論記錄進行裁決。
插件定位¶
dsh-debate 是 DeepSeek Harness 的工作流插件。其核心價值在於讓智能體從“自我陳述”轉變爲“對抗性論證”。
- 維護者：shlouai
- 許可證：MIT
- 定位：通過對抗性子智能體解決智能體回答問題的單一視角問題。
核心功能¶
該插件提供三個核心工具來控制辯論流程，並將辯論結果封裝在 Web UI 卡片中展示。
- debate_open：啓動辯論。它固定議題（motion）和輪數（round count），並返回一個
debate_id。 - debate_round：執行一輪辯論。順序執行：先由一個全新的 FOR 子智能體發言，隨後由一個針對前文進行反駁的 AGAINST 子智能體發言。
- debate_verdict：給出裁決。主智能體進行逐輪復盤，給出最終勝負（pro/con/draw）及理由，並關閉辯論。
關鍵特性¶
- 對抗性子智能體：正反雙方是獨立的子智能體，互不可見，專注於贏得辯論。
- 研究能力：默認工具集包含
read、glob、grep、web_search、web_fetch，支持對代碼庫或網絡信息進行覈查。 - 只讀機制：由設計決定，辯論過程中任何工具均無法寫入文件或執行命令。
- 優雅降級：如果部署環境中缺少某些工具（如未配置 Web 搜索憑證），工具會從列表中移除並記錄日誌，而不是導致辯論崩潰。
- 零 footprint：作爲 bundle 安裝，不會修改 DeepSeek Harness 的源碼或安裝目錄。
- Web UI 卡片：支持在 Web UI 中以摺疊卡片形式展示，且刷新頁面後卡片狀態會恢復。
安裝與啓用¶
插件可以通過官方命令直接安裝到 web profile。
dsh plugin --profile web add @shlouai/dsh-debate
前置條件：
* Node.js 版本需爲 ^22.19 或 >=24。
* 安裝 pnpm。
典型用法¶
安裝完成後，啓動 profile 並輸入自然語言指令即可觸發辯論。
dsh --profile web
在交互中輸入：
Debate whether we should replace our REST API with gRPC. Two rounds.
插件會自動拆分爲兩個子智能體進行兩輪辯論，最後由主智能體給出裁決。
設計與限制¶
- 依賴環境：插件依賴 DeepSeek Harness 的源碼 checkout（除非該插件位於 harness 的兄弟目錄中）。
- 工具依賴：辯論工具依賴於
read,glob,grep,web_search,web_fetch等基礎工具。 - UI 限制：卡片僅在 Web UI 中可用，但在 Headless 模式下工具本身仍可正常工作。
參考資料¶
- GitHub 倉庫：https://github.com/shlouai/dsh-debate
- 插件目錄：https://www.skillhub.cn/plugins/shlouai/dsh-debate
