前言¶
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 端点上的兼容性痛点。更多细节可参考项目主页或技能中心目录。
