DeepSeek Harness (DSH) Desktop 在处理模型请求失败时，内置了一套自动重试机制（默认重试 2 次）。但在某些特定场景下，你可能希望调整这个上限，或者完全禁用自动重试。dsh-model-retry-settings 插件解决了这个问题，它允许你通过 DSH Desktop 的设置界面直接配置自动模型请求的最大重试次数，无需修改核心代码。
插件概览¶
- 名称：dsh-model-retry-settings
- 核心价值：通过 DSH Desktop 设置直接配置自动模型请求的重试次数。
- 维护者：y2zyyr
- 分类：模型推理
- 许可证：MIT
- 安装方式：npm 包安装，纯插件实现。
核心功能¶
该插件主要提供以下能力：
- 原生设置集成：在 DSH Desktop 的「设置 → 通用」中新增一个配置项，用于调整重试次数。
- 全局重试限制：配置的数值对所有使用 DSH 标准重试策略的模型提供商生效。
- 支持取值：0、1、2、3、5、10。
- 默认行为：默认值为 2，与 DSH 内置默认值一致（安装插件后不配置，行为不变）。
- 持久化与实时：配置随应用重启保留，修改后无需重启应用，下一个失败请求即可应用新配置。
- 保持原有逻辑：不改变 DSH 内部的可重试错误分类（如
EMPTY_RESPONSE,RATE_LIMIT等）、指数退避、抖动及请求取消机制。
安装与启用¶
使用 DSH CLI 安装该插件到指定的 web 配置文件中：
dsh plugin --profile web add @y2zyyr/dsh-model-retry-settings
安装完成后，插件会自动加载。由于默认值为 2，安装后若不进行修改，DSH 的行为与内置默认完全一致。
典型用法¶
- 打开 DSH Desktop。
- 进入 设置 → 通用。
- 找到 最大模型请求重试次数 配置项。
- 选择需要的数值。
数值语义：
* 0：仅发起初始请求，不进行自动重试。
* 2：在初始请求失败后，最多自动重试 2 次（总共最多 3 次请求）。
注意事项与限制¶
- 重试语义：配置的数值是「初始请求之后」的重试次数，不计入初始请求。
- 错误分类：该插件仅改变最大重试次数，不改变 DSH 对错误的分类。例如，认证错误和凭证错误永远不会被转换为重试。
- 接口依赖：插件依赖 DSH 内部/RC 接口（如
agent/request-error重试策略和设置 seam）。如果 DSH 进行了重大版本更新，这些接口可能发生变化，插件可能失效。 - 安全性：当前 DSH 版本未通过通用设置 API 暴露任意插件设置命名空间。该插件使用受限的本地主机路由，仅暴露重试限制值，并限制在本地/受信任的 DSH 浏览器上下文中访问。
总结¶
dsh-model-retry-settings 为 DSH 用户提供了在不触及核心代码的情况下，精细化控制模型请求重试策略的能力。对于需要严格控制重试上限或强制快速失败的场景，该插件是一个实用的工具。
