前言¶

在 DSH（DeepSeek Harness）开发中，当模型请求失败且上游错误码未被默认策略覆盖时，往往会导致请求直接中断。特别是当提供方将无法识别的上游错误归类为 PI_AI_ERROR 时，现有的重试机制可能无法发挥作用。此时需要一种独立于内置策略的兜底机制来处理这类特定错误。

是什么¶

lim12137/dsh-llm-extra-retry 是一个 DSH 插件，旨在为模型请求失败瀑布追加一条独立恢复策略。它由 lim12137 维护，解决了当上游返回 PI_AI_ERROR 错误码时无法自动重试的问题。

核心功能¶

该插件提供以下能力：
* 针对 PI_AI_ERROR 错误，等待 20 秒后自动重试一次。
* 其他错误码保留 @deepseek-ai/dsh-llm-retry 的默认策略（5 次有界指数退避）。
* 使用独立的 policyKey 记账，与内置策略互不干扰。

安装与启用¶

按照以下步骤将插件接入 DSH 环境：
1. 本目录以 link: 依赖挂入 profiles/web/package.json；
2. 在配置中找到 dsh.profile.bundles，增加 "dsh-llm-extra-retry"；
3. 确保 node_modules/dsh-llm-extra-retry 为指向本目录的目录联接；
4. 重启 DSH 使配置生效。

典型用法¶

插件默认行为为：检测到 PI_AI_ERROR 时等待 20 秒重试一次。若需调整等待时长或重试次数，可修改插件根目录下的 lib/index.js 文件，修改顶部的 DELAY_MS 或 MAX_RETRIES 常量。

适用场景与注意¶

此插件适用于需要对特定错误码进行兜底重试的场景。使用前请检查源码与许可证（MIT）。注意：请求取消或插件卸载会立刻中止等待中的退避。

结尾¶

通过引入此插件，可以为 DSH 的模型请求失败增加一层针对 PI_AI_ERROR 的独立恢复策略。更多详情请参考 GitHub 仓库。