模型重试策略 guanosine-diphosphate/dsh-retry-policy-settings

dsh-retry-policy-settings

DeepSeek Harness (DSH) 插件 · 模型重试策略设置

在 DSH Web 设置面板里可视化编辑每个模型提供方的 API 请求失败重试策略（retryPolicy）——重试模式、重试次数、可重试错误码与指数退避参数。写入 settings.yaml 后，官方 @deepseek-ai/dsh-llm-retry 插件即时生效（热重载，无需重启）。

Keywords: DeepSeek Harness · dsh · dsh-plugin · cordis · plugin · llm · retry · retry-policy · retries · backoff · maxRetries · settings · 模型重试 · 重试策略 · DSH 插件

功能

- 自动读取所有已注册的模型提供方（自定义 OpenAI 兼容 API、DeepSeek 官方等）
- 编辑提供方 retryPolicy 的全部可选字段（文件里没写、但有默认值的字段也会显示，可直接设置）：
- mode：normal（有限重试，默认）/ always（无限重试直到成功/取消）
- maxRetries：失败后最大重试次数（默认 2，仅 normal）
- retryableCodes：可重试错误码（默认 EMPTY_RESPONSE, RATE_LIMIT, SERVER, TIMEOUT, TRANSPORT，仅 normal）
- backoff.initialDelayMs（默认 500）/ backoff.maxDelayMs（默认 10000）/ backoff.jitterRatio（默认 0.1）
- 一键「移除并恢复默认」，回到 dsh-llm-retry 的默认行为
- 中文 / English 自动跟随 DSH 全局语言切换
- 深色 / 浅色主题自适应（使用 DSH 主题 token）

安装

通过 GitHub 安装到你的 DSH profile（推荐，发布即用）：

dsh plugin --profile web add "github:guanosine-diphosphate/dsh-retry-policy-settings#main"

或本地安装（克隆仓库后）：

dsh plugin --profile web add "file:./dsh-retry-policy-settings"

安装后把 dsh-retry-policy-settings 加入 profile 的 dsh.profile.bundles（<profile>/package.json），重启 Web UI 即可在 设置 → 模型重试策略 看到设置页。

使用

1. 打开 DSH Web UI → 左下角 设置
2. 点击 模型重试策略（英文界面显示 Model Retry Policy）
3. 选择提供方，调整模式与参数，点 保存

写入位置（取决于提供方所属适配器）：

| 提供方类型 | settings.yaml 路径 |
| 自定义 / pi-ai 提供方（如 scnet） | llm-pi-ai.providers.<id>.retryPolicy |
| DeepSeek 官方（deepseek-official） | llm-deepseek.retryPolicy |

工作原理

- 通过 DSH 统一 API（connection.api.llm.providers + connection.api.settings）自动发现提供方并读写配置，无需额外 Host 服务
- 与官方 dsh-llm-retry 的 RetryPolicySchema 严格一致：always 模式下 maxRetries/retryableCodes 字段被禁用（schema 不允许）
- 依赖官方插件 @deepseek-ai/dsh-llm-retry（DSH 默认已启用，无需单独安装）

依赖

- DeepSeek Harness ≥ 0.1.0-rc.x（Web profile）
- @deepseek-ai/dsh-llm-retry（官方 bundle 自带）

开发

结构 lib/index.js # host 占位行（插件主体在 client） lib/client.js # 浏览器端（web bundle 格式，纯 JS，无构建步骤） cordis.patch.yml

lib/client.js 为可直接分发的 web-bundle 格式（window.__ModuleLoader__.load），修改后无需构建。

License

MIT © guanosine-diphosphate

相关

- DeepSeek Harness — 官方仓库
- @deepseek-ai/dsh-llm-retry — 重试策略执行插件
- awesome-deepseek-harness — DSH 社区插件列表
- dsh-suite — DSH 插件活目录与商店