doitian/dsh-provider-aliyun：DeepSeek Harness 的阿里雲 DashScope 提供商

前言¶

DeepSeek Harness (DSH) 允許通過配置文件或插件擴展模型提供商。對於阿里雲 DashScope（百鍊）的用戶，手動維護 config 中的模型列表和路由配置既繁瑣，又難以在模型更新後自動同步。@doitian/dsh-provider-aliyun 插件通過註冊專有的 aliyun 路由，將模型目錄的管理權交還給端點本身，解決了配置僵化和維護成本高的問題。

這是什麼¶

這是一個爲 DeepSeek Harness 提供的阿里雲 DashScope 模型提供商插件。它註冊了一個名爲 aliyun 的路由，並擁有該路由的端點、憑證引用、協議和模型目錄。插件維護者維護了該包，旨在解決在 DSH 中集成阿里雲模型時，模型列表靜態化導致的更新滯後問題。

核心功能¶

該插件主要包含以下能力：

專有路由註冊：插件註冊 aliyun 路由，而不是依賴 llm-pi-ai 的通用配置，從而避免路由衝突。
動態模型目錄：路由會向配置的端點發送 GET {baseURL}/models 請求，獲取實時的模型列表。這意味着阿里雲新發布的模型無需重新發布插件即可被識別。
後備目錄：爲了防止端點在首次請求時未返回模型列表，插件內置了一個後備目錄，確保在端點未就緒時仍有模型可供選擇。
多區域支持：支持中國、國際和工作區等多種區域配置。
憑證管理：通過 ALIYUN_API_KEY 環境變量或 ~/.credentials.yaml 文件管理 API 密鑰，不將密鑰硬編碼在配置中。

安裝與啓用¶

在安裝前，請確保已滿足依賴要求：DeepSeek Harness 0.2.1-rc.2，以及包含 @deepseek-ai/dsh-base 的 bundle。此外，你的環境需要 Node.js >= 22。

安裝步驟如下：

在非桌面 profile 目錄下執行以下命令安裝插件：

    dsh plugin --profile <name> add @doitian/dsh-provider-aliyun

確保插件被添加到 dsh.profile.bundles 中：

    {
      "dsh": {
        "profile": {
          "bundles": ["@deepseek-ai/dsh-base", "@doitian/dsh-provider-aliyun"]
        }
      }
    }

注意：不要通過 llm-pi-ai 配置 aliyun 路由，因爲兩個適配器不能聲明相同的路由，否則會報錯。

典型用法¶

配置主要包含路由定義、API 密鑰和端點地址。

1. 定義路由與模型¶

在配置文件中指定使用 aliyun 提供商：

provider: aliyun
model: qwen3.8-max

2. 配置 API 密鑰¶

插件默認通過 ALIYUN_API_KEY 環境變量解析憑證。你也可以將其存儲在 $DSH_HOME/.credentials.yaml 中：

refs:
  ALIYUN_API_KEY: sk-…

如果密鑰未解析，選擇模型會立即失敗。

3. 配置端點¶

插件支持多個區域，默認爲公共中國區。如果使用工作區端點，需要顯式指定：

- id: llm-aliyun
  name: '@doitian/dsh-provider-aliyun'
  config:
    baseURL: https://llm-<workspace-id>.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

適用場景與注意¶

該插件適合需要頻繁更新模型列表或使用阿里雲特定工作區端點的 DSH 用戶。

環境要求：必須安裝 DeepSeek Harness 0.2.1-rc.2 及其 @deepseek-ai/dsh-base bundle，且 Node.js 版本需大於等於 22。
權限與安全：插件以當前 DSH 進程的權限運行。在安裝前，建議檢查其源碼和許可證。API 密鑰僅存儲在本地憑證文件中，不會隨配置文件提交。
動態發現：依賴端點支持 GET {baseURL}/models 接口。如果端點不支持，插件將退回到後備目錄。