dsh-anyrouter：DeepSeek Harness 專用的 Any Router 集成

前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」，通過擴展來支持不同的模型推理服務。Any Router 是一個提供多模型路由能力的中間件。當你需要在 DSH 中使用 Any Router 時，直接集成通常面臨協議不兼容（如需要 Claude Code 專用的 transport 或 Codex 專用的 Responses API）以及配置複雜的問題。dsh-anyrouter 作爲一個專用的 provider bundle，旨在解決這些集成細節，讓 DSH 能夠通過標準的插件流程接入 Any Router。

這是什麼¶

dsh-anyrouter 是一個由用戶 shaomingbo 維護的 DeepSeek Harness 專用 provider bundle。它將 Any Router 作爲後端模型源，通過 Claude Code 兼容的 transport 代理 Claude 模型，並通過 Responses API 代理 GPT/Codex 模型。該插件採用 MIT 許可證，旨在簡化 DSH 用戶通過 Any Router 訪問 Claude 和 GPT 模型的流程。

核心功能¶

1. 基於 Key 的路由控制
   插件會檢查憑證服務中是否存在 ANYROUTER_API_KEY。只有當 API Key 存在時，anyrouter provider 路由纔會註冊，模型選擇器纔會顯示相關模型組。一旦 Key 被移除或失效，模型組會自動隱藏，無需手動重啓 DSH；重新添加 Key 後自動恢復。

2. 完整的模型配置而非裸 ID
   同步模型時會保留推理參數（如努力程度、自適應思考標誌）以及上下文和輸出限制。這意味着模型選擇器和推理選擇器能夠正常工作，且所有參數均可通過界面編輯，不僅僅是簡單的模型 ID 替換。

3. 模型白名單選擇
   同步模型列表以複選框形式呈現，允許用戶選擇包含哪些 Claude 或 GPT 模型。對於不支持或被路由端拒絕的模型（如 gpt-5-codex），默認處於未選中狀態，以避免調用失敗。

4. 專用的協議適配
   * Claude 模型：使用 Claude Code 2.1.239 兼容的 Anthropic Messages transport，包含特定的請求頭、身份塊和會話元數據。
   * GPT/Codex 模型：使用 POST /v1/responses 端點，採用 Codex CLI 的請求形狀（如 store: false、include reasoning.encrypted_content）。

5. 推理流通過標準選擇器
   推理努力（reasoning efforts）通過 DSH 原生的推理選擇器進行控制，而非硬編碼在插件內部。

安裝與啓用¶

安裝過程通過 npx 執行，它會修改當前 profile 的 package.json（添加依賴和 bundles 配置），並在該目錄下運行 pnpm install --ignore-scripts。安裝過程中不會停止 DSH 進程，但安裝完成後需要手動重啓 DSH 並刷新 Web 頁面。

執行以下命令進行安裝：

npx --yes github:shaomingbo/dsh-anyrouter#v0.3.3

典型用法¶

安裝完成後，可以通過以下命令管理插件狀態或切換配置文件：

# 檢查插件是否已安裝
npx --yes github:shaomingbo/dsh-anyrouter#v0.3.3 status

# 卸載插件（冪等操作）
npx --yes github:shaomingbo/dsh-anyrouter#v0.3.3 uninstall

# 使用 headless 配置文件安裝
npx --yes github:shaomingbo/dsh-anyrouter#v0.3.3 --profile headless

# 使用本地源碼進行開發
DSH_ANYROUTER_SOURCE=link:/absolute/path/to/checkout npx --yes github:shaomingbo/dsh-anyrouter#v0.3.3

適用場景與注意¶

• 環境要求：該插件依賴於 DeepSeek Harness 0.1.1-rc.2 和 pi-ai 0.82.1。如果使用舊版本的 DSH（如 0.1.1-rc.2 之前），客戶端會因缺少必要的 remote.credentials 或 remote.llm 引用而啓動失敗。
• 錯誤處理：同步模型列表是諮詢性質的，不會主動進行付費探測。當 Relay 服務端處於容量限制或無健康上游時，模型調用可能會返回 429 或 500 錯誤。
• 配置說明：API Key 必須存儲在憑證服務中，或通過啓動環境變量提供，切勿寫入配置文件的 llm-anyrouter 節點。如果配置文件中缺少 reasoning 塊，系統會回退到基於 pi-ai 目錄生成的構建時配置。

總結¶

dsh-anyrouter 爲 DeepSeek Harness 提供了與 Any Router 的標準化接入方案。它通過 Key-gating、完整的模型配置以及專用的協議適配，解決了多模型路由在 DSH 中的集成難點。對於需要在本地或 Web 端通過 DSH 管理多模型路由的開發者來說，這是一個功能完備的解決方案。

• GitHub 倉庫
• 社區目錄頁