前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在對接阿里雲百鍊時，內置的 pi-ai 適配器無法正確識別 dashscope.aliyuncs.com 端點，導致方言配置錯誤、推理能力配置缺失，且無法獲取上下文窗口等元數據。dsh-bailian-models 插件旨在解決這一問題，爲 DSH 提供一套開箱即用的百鍊模型目錄及自動適配機制。
插件定位¶
該插件由開發者 CroissanTTs 維護，是一個針對 DeepSeek Harness 的模型推理插件。它主要包含兩部分功能：一是提供包含 36 個主流文本模型的預設路由；二是提供自動適配器，用於檢測並補全現有的百鍊路由配置。
核心功能¶
1. 模型目錄預設¶
插件內置了 36 個主要文本模型的目錄。每個模型條目包含以下元數據：
* 上下文窗口大小
* 最大輸出令牌數
* 推理努力控制參數（如 enable_thinking、reasoning_effort、thinking_budget）
2. 自動適配器¶
插件會監控 llm-pi-ai 配置段。如果檢測到現有路由的 baseURL 指向百鍊端點（如 dashscope.aliyuncs.com、dashscope-intl 等），適配器會自動補全以下缺失字段：
* 方言兼容性（如 thinkingFormat: qwen，supportsStore 等）
* 上下文窗口與最大輸出限制
* 推理努力級別（reasoningEfforts）
* 路由級別的推理預算映射（thinkingBudgets）
注意：自動適配器僅填充缺失值，用戶手動編寫的值不會被覆蓋。所有自動填充的字段寫入用戶層配置，卸載插件後依然保留。
3. 四種推理模式支持¶
插件支持百鍊模型的四種推理模式分類：
* Effort levels (A類)：通過 reasoning_effort 控制。
* Budgets (B類)：通過 thinking_budget 控制。
* Toggle (C類)：僅通過 enable_thinking 開關控制。
* Always-thinking (D類)：模型始終處於思考狀態，不提供級別選擇。
4. 修復 pi-ai 適配器問題¶
該插件修復了內置 pi-ai 適配器在處理 dashscope.aliyuncs.com 端點時出現的兼容性問題。
安裝與啓用¶
安裝命令¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add dsh-bailian-models
配置環境變量¶
安裝後，插件會引用環境變量名，但不會存儲密鑰。請確保設置以下環境變量：
export DASHSCOPE_API_KEY=sk-...
使用模型¶
安裝完成後，百鍊模型會出現在 DSH 的模型選擇器中，且推理努力級別可以正常工作。
高級配置¶
用戶可以在 DSH 的設置頁面（Models 頁面）中手動編輯 bailian 路由，以使用不同的環境變量名或區域端點。
注意事項¶
- 密鑰安全：插件從不存儲 API 密鑰，僅引用環境變量名。
- 配置覆蓋：自動適配器僅在配置缺失時填充，手動配置優先。
- D類模型限制：對於 Type D（Always-thinking）模型，插件不提供級別選擇。如果在未選擇級別的情況下發送切換指令，可能會收到 400 錯誤。
- 源碼審查：建議在使用前檢查插件源碼與許可證（MIT）。
總結¶
dsh-bailian-models 爲使用阿里雲百鍊的 DSH 用戶提供了完整的模型目錄與自動配置能力，解決了原生適配器在 DashScope 端點上的兼容性痛點。更多細節可參考項目主頁或技能中心目錄。
