DeepSeek Harness（DSH）是一個插件化平臺。在處理視覺識別、翻譯或語音轉寫等特定任務時，通常需要專門的模型和工具，而主 Agent 無法很好地處理這些。dsh-agent-router 是一個 DSH 插件，它允許自定義專業 Agent 並將它們綁定到獨立的模型。該插件支持多模態賬號一鍵登錄、賬號池健康路由與實時用量統計。
核心功能¶
該插件主要解決 DSH 主 Agent 能力單一的問題，通過以下方式擴展能力邊界：
- Agent 預設默認模型：按 DSH 預設粒度配置主 Agent 與 subagent 的默認模型。新會話或切換預設時，對話框模型選擇器會即時跟隨顯示配置的默認模型。
- 專業 Agent 配置：支持五種執行通路——chat 遠端模型、完整子代理、無頭 CLI 子代理、圖片生成、語音轉寫。每個專業 Agent 獨立配置服務商與模型，未配置時自動複用主 Agent 模型。
- ChatGPT 訂閱登錄：支持官方 Codex OAuth 授權登錄。訂閱賬號可直接作爲主模型調用，OAuth token 由插件自動注入刷新。綁定訂閱賬號的 agent 也可用於生圖。
- 多模態任務路由：支持圖片識別（OCR、截圖、圖表）、圖片生成、語音轉寫。當啓用視覺類專業 agent（能力標籤含
image）後，輸入框會出現「添加圖片」按鈕，附件圖片會被注入上下文。 - 無頭 CLI 子代理：支持接入 codex、claude、gemini 等外部 agent 工具。這些工具以無頭模式執行多步任務，圖片與文件按工作區路徑注入。
- 多模態賬號與賬號池：支持任意服務商 API Key 配置式添加。賬號池按健康、用量、輪詢策略自動選號與失敗切換。
- 實時用量統計：提供分級視圖（預設、專業 Agent、賬號級、全局），支持按天持久化（默認保留 90 天）及 CSV 導出。
安裝¶
前置要求：DSH ≥ 0.1.5-rc.2。
使用標準管理命令安裝：
dsh plugin --profile web add github:peterwangze/dsh-agent-router
安裝腳本方式需宿主支持，推薦使用上述 dsh plugin 標準管理。離線安裝時，必須使用 file: 且帶 ./ 前綴，例如：
dsh plugin --profile web add file:./
安裝完成後重啓 DSH。
使用指南¶
安裝並重啓後，在 DSH 的「設置 → Agent 路由」打開配置頁。
- 啓用多模型路由：在頂部總開關啓用功能。關閉後
route_agent拒絕調用、統計暫停。 - 配置預設 Agent：在「預設 Agent」卡片中，按 DSH 預設粒度配置主 Agent 與 subagent 的默認模型。配置後，新會話或切換預設時模型選擇器會立即跟隨顯示。
- 配置專業 Agent：在「專業 Agent」卡片中維護自定義專業 agent，包括選擇執行通路（chat/agent/cli/image/speech）並綁定對應的模型。
- 配置多模態賬號：在「多模態賬號」卡片中添加 API Key 或進行 ChatGPT 訂閱登錄。系統會自動維護賬號池，按策略選號。
- 查看統計信息：在「統計信息」卡片中查看分級用量明細。
注意事項¶
- 版本兼容：本插件在 DSH ≥ 0.1.5-rc.2 環境下受支持與實測。
- 離線安裝：離線安裝時路徑必須帶
./前綴，否則會被當作 registry 包名。 - 統計持久化：用量統計按天持久化，默認保留 90 天。如需關閉，可設置
router.stats.persist=false。
