前言¶
在 DeepSeek Harness (DSH) 的使用场景中,针对不同 LLM 提供商调整请求重试策略(如重试模式、最大重试次数)及超时参数(如连接超时、流式空闲超时)是常见需求。若需手动修改配置文件或通过代码调整,流程较为繁琐。dsh-llm-retry-settings 插件提供了可视化的设置页面,直接对接 DSH 的公共设置接口,用于管理这些参数。
插件简介¶
这是一个客户端插件,由 Yiklek 维护。它通过新增的设置页面,允许用户查看和编辑各个 LLM 提供商的请求重试策略和超时字段。
核心功能¶
该插件主要提供以下能力:
- 重试策略配置:支持设置重试模式(
mode:normal或always)以及最大重试次数(maxRetries)。 - 超时字段管理:支持配置超时毫秒数,包括通用请求超时(
timeoutMs)、WebSocket 连接超时(websocketConnectTimeoutMs)以及流式传输空闲超时(streamIdleTimeoutMs)。 - 即时生效:所有写入操作通过
settings.mutate进行,修改后无需重启 DSH 进程,下一次模型请求即可生效。 - 架构设计:纯客户端插件,宿主端逻辑为空;GUI 通过回环 API 网关与系统交互,交互方式与内置的模型设置页面一致。
安装与启用¶
使用官方安装命令即可完成加载,无需手动编辑配置文件:
npx @deepseek-ai/dsh plugin --profile web add github:Yiklek/dsh-llm-retry-settings
安装完成后,插件会自动添加到 dsh.profile.bundles 并加载其补丁层。
典型用法¶
插件利用 llm-retry 执行器,但具体策略与超时配置位于各提供商的设置命名空间中(如 llm-pi-ai、llm-deepseek)。
超时字段会从各命名空间的设置架构中自动发现;对于已知的内置提供商,系统使用已知的回退映射表。
在 DSH 界面中找到对应 LLM 提供商的设置页面,即可查看并修改上述参数。
适用场景与注意¶
- 适用场景:需要在 DSH 界面直接调整 LLM 连接重试与超时行为的开发者。
- 注意事项:此插件为标准 dsh bundle 插件,依赖
package.json中声明的dsh.bundle.patch指向cordis.patch.yml。 - 风险提示:插件基于 MIT 许可证开源,安装前建议检查源码以确保安全。
结语¶
该插件简化了 LLM 连接参数的配置流程。更多细节与源码可参考 GitHub 仓库。