前言¶
在使用 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 許可證,安裝前可檢查源碼與許可證內容。