前言¶
在 DeepSeek Harness(DSH)裏開啓實驗性 Auto review 後,審閱模型往往仍跟會話模型綁在一起。主模型偏大、偏慢,或某一供應商出現限流、配額、網絡錯誤時,一次審閱可能直接卡住,拖慢工具執行前的授權流程。社區維護者 pnpwin 發佈的 DSH Auto Review Fallback(@pnpwin/dsh-auto-review-fallback)在官方實驗性 Auto review 之上,通過 DSH 公開的 llm/stream 擴展點增加「獨立審閱路由 + 最多七級有序可用性降級」,並在多種技術失敗時按規則切換下一路由,正常完成(含 deny)則停止鏈路,由上游策略繼續校驗。本文根據倉庫 README 與 package.json 說明其定位、能力與安裝配置要點;該插件並非 DeepSeek 官方產品,Auto review 本身仍爲實驗能力,可在完整主機權限下授權不安全操作。
這是什麼¶
DSH Auto Review Fallback 是一套 DSH 社區插件(GitHub:pnpwin/dsh-auto-review-fallback),當前發行版本 0.1.2,MIT 許可證,維護者爲 pnpwin。它不打包、也不替代上游 @deepseek-ai/dsh-experimental-auto-review 的授權策略、響應解析器或工具執行門控,只擴展審閱調用時的模型選擇與可用性降級邏輯。
引擎約束在 package.json 中寫死爲 DSH 0.2.2-rc.1,並需在該版本中啓用內置實驗性 Auto review。README 註明底層曾在 macOS DSH Desktop 上驗證;其他 DSH 版本、平臺及 CLI host 模塊解析未在公開說明中確認。
核心功能¶
下面介紹插件在資料中明確列出的能力。
獨立審閱模型與有序降級鏈¶
- 可爲審閱單獨指定 provider + 精確 model ID,與會話模型解耦。
- 可配置 一個主審閱路由 和最多 七個按順序排列的 fallback。
- 每條路由可設置單次嘗試超時:1–120 秒,默認 20 秒。
- 可選填該路由支持的 reasoning-effort ID;留空則使用 adapter 默認。若填寫了模型不支持的 effort,視爲配置錯誤,停止審閱,不會靜默改 effort 或換模型。
- Provider 名稱來自 Settings → Models 中已連接的供應商;模型列表使用 DSH 共享目錄,並支持已保存的 model ID / 手動輸入作爲後備。
這是一套 fallback 鏈,不是隨機負載均衡、投票,也不是「換到願意批准的模型」。每次新審閱都從主模型開始。
默認與會話一致(Follow session)¶
默認模式爲 Follow session:使用會話當前模型,沿用與自定義鏈相同的邊界化準備與請求 framing,但沒有 fallback,也不會自動選新 provider。README 說明此模式下仍會應用針對 Codex Unsupported parameter: temperature 的兼容處理,無需另裝兼容插件。
與上游的關係及 Codex 兼容¶
插件基於官方 @deepseek-ai/dsh-experimental-auto-review 擴展。Codex 溫度參數不兼容問題在 DeepSeek Harness Discussion #12495 中討論;具體上游修訂範圍見倉庫內 UPSTREAM.md。
設置界面支持英文或俄文,並使用 DSH 主題 token(package.json 中 client 注入 @deepseek-ai/dsh-client-ui-settings 等)。
降級規則(fail-closed)¶
README 用表格歸納行爲,核心如下:
| 結果 | 行爲 |
|---|---|
| 可識別的限流、配額、超時、網絡/傳輸失敗、部分服務端錯誤,或路由/模型/憑據不可用 | 停止上一路傳輸後,嘗試下一條配置路由 |
正常完成(含 deny) |
停止鏈路,由上游審閱邏輯校驗響應 |
| 畸形 JSON、不支持的顯式選項/effort、max-tokens、策略拒絕或未知錯誤 | 不降級,保留上游失敗/批准行爲 |
| 已在文本層面完成後又出現技術錯誤 | 不降級,不換模型推翻已有答案 |
| 父級取消或插件卸載 | 中止,不啓動下一路由 |
| 無法確認上一傳輸已停止 | fail-closed,不重疊發起 fallback |
| 所有路由均不可用 | 返回 AUTO_REVIEW_ROUTES_EXHAUSTED,不執行工具體 |
失敗嘗試會緩衝,避免部分文本泄漏到 fallback 答案;緩衝上限爲 2 MiB / 20,000 chunks(README 截斷處仍保留此條)。
安裝與啓用¶
資料說明這是 GitHub 源碼包,不是 npm 發佈;無依賴、無安裝腳本、無構建步驟。安裝後 profile 可能鏈接該目錄,安裝期間勿刪除或移動;git pull 後需重啓 DSH 並刷新頁面,以替換緩存的 Host 代碼與 Client 產物。
若曾使用本地原型 @local/dsh-auto-review-router,需先禁用/移除,不要與兩個獨立審閱路由器同時運行。本包使用獨立設置命名空間 pnpwin-auto-review-fallback,不會自動遷移舊鏈配置。
README 給出的步驟:
- 獲取倉庫到本地目錄(README 示例爲
git clone https://github.com/pnpwin/dsh-auto-review-fallback.git後cd dsh-auto-review-fallback)。 - 用 Plugin Manager 或 CLI 將該目錄的絕對路徑安裝到目標 profile:
dsh plugin --profile desktop add "$PWD"
將 desktop 換成實際 profile 名。該 profile 內的 agent 也可通過 plugin_manager 工具、action: install_bundle 與目錄絕對路徑安裝。
- 刷新已打開的 DSH 頁面,進入 Settings → Auto review。
- 在需要使用的會話中啓用 Auto review。
獨立測試需 Node.js 24.9.0 或更新(package.json engines.node)。
典型配置與用法¶
下面介紹 lighter reviewer 的自定義鏈配置,與 README 一致。
- 在 Settings → Auto review 中選擇 Custom model chain(若繼續跟會話模型一致,保持默認 Follow session 即可)。
- 選擇主審閱 provider 與 model,按需添加或調整 fallback 順序(最多七條)。
- Reasoning effort 僅在確認該模型支持對應 ID 時填寫;不支持則會導致配置錯誤並停止審閱。
- 設置單次嘗試超時,點擊 Save。保存走 DSH 自帶設置 API(含 revision/衝突檢查);對新發起的審閱生效,進行中的審閱仍用快照配置。會話模型與權限模式不會被本插件改寫。
若在 Models 中新增或重命名了 provider,重新打開頁面或點擊 Reload catalog。目錄暫時不可用時,已保存或手填的 model ID 不會被清掉。
Kimi Coding 訂閱應使用 kimi-coding 連接及目錄中的 ID(如 kimi-for-coding、k3);moonshotai 連接走 Moonshot API,誤用可能導致 HTTP 401。路由器不會靜默改寫 provider/model 或複製憑據。
適用場景與注意¶
適合誰: 已在 DSH 0.2.2-rc.1 上啓用實驗性 Auto review,希望用更小/更快的模型做審閱,或爲主審閱模型配置有序、可預期的可用性備份鏈的開發者。分類上屬於目錄中的 模型推理 類插件。
安全與隱私:
- README 明確警告:社區插件,非官方產品;Auto review 爲實驗功能,可能授權帶完整主機訪問的不安全操作;更快/更小的審閱模型不等於更安全的審閱模型。
- 插件以當前 DSH 進程權限運行;安裝前應自行查看源碼與 MIT 許可證。
- 每一次嘗試的審閱方都會收到上游審閱輸入(授權策略、保留指令/歷史、待執行工具參數)。fallback 到另一 provider 可能把相同數據發往另一組織,請只選擇信任的端點。插件不記錄審閱 prompt、生成答案、憑據或拒絕原因;路由 ID 與技術狀態碼可能出現在 DSH 日誌中。
能力邊界: 上游嚴格風險/決策解析器仍擁有最終決定;畸形輸出或 deny 不會觸發換模型。 framing 改善的是遵循度,不保證模型風險判斷更可靠。v0.1.2 說明中對 GLM-5.3、Kimi K3 等 reasoning 默認值等 adapter 行爲有專門兼容說明。
結尾¶
DSH Auto Review Fallback 在不動上游審閱策略的前提下,把「用哪個模型審閱」和「主路由掛了怎麼辦」拆成可配置的有序鏈,並在錯誤類型上堅持 fail-closed,避免用 fallback 推翻已完成的審閱結論。若你要在 Harness 裏壓低審閱延遲或應對供應商瞬斷,可按 README 安裝並在 Settings → Auto review 中配置鏈路與超時。