前言¶
在 DeepSeek Harness (DSH) 的使用中，配置模型提供方的重试策略（retryPolicy）通常需要直接编辑 settings.yaml 文件。这种方式缺乏可视化反馈，调整参数（如重试模式、次数、退避策略）时容易出错。dsh-retry-policy-settings 插件旨在解决这一问题，提供一个可视化的编辑界面。
插件介绍¶
这是一个 DeepSeek Harness (DSH) 插件，由 guanosine-diphosphate 维护。它允许在 DSH Web UI 中直接编辑模型提供方的 retryPolicy 配置，包括模式、重试次数、可重试错误码以及指数退避参数，并即时写入配置文件。
核心功能¶
- 自动发现：自动读取所有已注册的模型提供方（如自定义 OpenAI 兼容 API、DeepSeek 官方等）。
- 全字段编辑：编辑提供方
retryPolicy的全部可选字段（mode,maxRetries,retryableCodes,backoff参数等）。即使文件中有默认值的字段也会显示。 - 一键恢复：支持一键移除配置并恢复默认。
- 环境适配：中文/English 自动跟随 DSH 全局语言切换，深色/浅色主题自适应。
安装¶
通过 GitHub 安装到你的 DSH profile：
dsh plugin --profile web add "github:guanosine-diphosphate/dsh-retry-policy-settings#main"
安装后，将 dsh-retry-policy-settings 加入 profile 的 dsh.profile.bundles（<profile>/package.json），重启 Web UI 即可使用。
使用方法¶
- 打开 DSH Web UI。
- 进入左下角的 设置。
- 点击 模型重试策略（英文界面显示 Model Retry Policy）。
- 选择具体的提供方，调整模式与参数，点击 保存。
配置写入位置¶
插件修改后的配置会写入到 settings.yaml，具体路径取决于模型提供方所属的适配器：
| 提供方类型 | settings.yaml 路径 |
|---|---|
自定义 / pi-ai 提供方（如 scnet） |
llm-pi-ai.providers.<id>.retryPolicy |
DeepSeek 官方（deepseek-official） |
llm-deepseek.retryPolicy |
依赖与注意事项¶
- 依赖：依赖官方插件
@deepseek-ai/dsh-llm-retry（DSH 默认已启用）。 - 模式限制：在
always模式下，maxRetries和retryableCodes字段会被禁用（由底层 Schema 限制）。
结语¶
该插件为 DSH 用户提供了管理模型重试策略的便捷入口，适合需要在 Web UI 中频繁调整重试逻辑的开发者。
