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 接口。如果端点不支持，插件将退回到后备目录。