前言¶
在使用 DeepSeek Harness (DSH) 进行智能体开发时,对接中转站代理通常涉及繁琐的模型列表维护、推理参数配置以及速度策略控制。dsh-relay-fast 是由 Rock-ql 开发的一款插件,旨在解决中转站配置中的模型同步缺失、参数自动补全以及灵活控制模型调用优先级(Fast/Standard)的问题。
核心功能¶
该插件提供以下三项核心能力:
- 思考等级自动补全:为
llm-pi-ai新创建的模型自动补全reasoningEfforts参数。插件兼容openai-completions与anthropic-messages协议,且不会覆盖模型已有的声明。 - 模型同步:支持在 DSH 的设置页直接从中转站的
/models接口同步缺失的模型列表。 - 动态 Fast 开关:提供可视化的开关控制。该开关仅在端点明确声明 Fast 能力,或用户通过配置显式启用时显示。开启后,请求中会携带
service_tier: priority。
安装与启用¶
在终端执行以下命令进行安装:
dsh plugin --profile desktop add github:Rock-ql/dsh-relay-fast
安装完成后,需要重启 DSH Desktop 才能使插件生效。若在 Web 环境中使用,请将命令中的 desktop 替换为对应的 profile 名称。
配置说明¶
插件的具体行为可以通过覆盖 profile 下的 cordis.patch.yml 配置文件来调整。以下是一个示例配置,启用了自动补全、指定 Fast 策略并定义了默认速度:
- id: relay-fast
config:
autofill: true
fastTier: priority
fastModels:
- gpt-5* # 适用于所有中转渠道的 GPT-5 模型
defaultSpeed: fast # 新会话默认使用 Fast 模式
如果不配置 fastModels,插件将只相信中转站 /models 返回的明确 Fast 能力元数据,不会按模型名称进行猜测。
注意事项¶
- 中转站兼容性:开启 Fast 开关能保证发送
service_tier: priority字段,但中转站可能会忽略该字段。真实的加速能力取决于上游服务的实现。 - 生效时机:修改配置后必须重启 DSH Desktop。
- 许可证:本插件采用 MIT 许可证,安装前可检查源码与许可证内容。