Chu-m/dsh-chat-continue

DSH Chat Continue

英文 | 中文

一个 DSH 插件，用于拦截第三方 API 请求错误（429 Too Many Requests、503 Service Unavailable 等）并自动重试请求——防止外部 API 出现问题时导致 agent 会话停滞。

英文

问题

使用 DSH 调用第三方模型 API（例如自定义提供商、外部 AI 服务）时，这些平台通常会实施速率限制或其他访问限制。当超出限制时，API 会返回错误（例如 429 Too Many Requests、rate_limit、quota_exceeded）。

DSH 为 DeepSeek API 内置了重试逻辑（dsh-llm-retry），但它可能无法覆盖所有第三方错误码。当内置重试耗尽后，agent 会话会在对话中途停滞，需要用户手动输入“continue”才能恢复——体验很差。

解决方案

本插件作为 DSH 内置重试之后的第二道防线。它会：

1. 在内置重试失败后拦截 agent/request-error 事件
2. 将错误与你配置的状态码和错误码进行匹配
3. 自动重试或显示通知以供手动确认
4. 无缝恢复对话——无需手动输入“continue”

工作原理

第三方 API 返回错误（429、rate_limit 等）
↓
DSH 内置重试（dsh-llm-retry）先处理
↓（如果内置重试耗尽）
本插件拦截 agent/request-error
↓
根据你配置的可重试状态码和错误码进行检查
↓
自动模式 → 等待配置的间隔 → 自动重试
手动模式 → 显示通知 → 你点击“重试”或“跳过”
↓
重试成功 → 对话不中断地继续

功能特性

- 自动重试模式——在请求出错时自动等待并重试，无需手动干预
- 手动确认模式——在右下角显示通知浮层，点击“重试”或“跳过”
- 可配置错误码——设置要拦截的 HTTP 状态码（例如 429, 503）和错误码（例如 rate_limit, service_unavailable）
- 可配置重试间隔——重试之间等待 1–60 秒
- 可配置最大重试次数——放弃前最多重试 1–100 次
- 设置页面——设置 → Chat Continue

安装

前置条件

- 已安装 DSH（dsh 命令可用）

通过 npm 安装

dsh plugin --profile web add @wuxjs/dsh-chat-continue

然后重启 DSH。插件会自动加载。

使用方法

1. 安装后重启 DSH
2. 打开设置（侧边栏齿轮图标）
3. 找到 Chat Continue 标签页
4. 配置你的设置：

| 设置 | 说明 | 默认值 |
|---------|-------------|---------|
| 重试模式 | Auto = 自动重试，Manual = 通知弹窗 | Auto |
| 重试间隔 | 重试之间等待的秒数（1–60） | 5s |
| 最大重试次数 | 最大重试尝试次数（1–100） | 10 |
| 重试 HTTP 状态码 | 逗号分隔，例如 429, 503 | 429 |
| 重试错误码 | 逗号分隔，例如 rate_limit, service_unavailable | rate_limit |

配置示例

示例 1：OpenAI 兼容 API 返回 429

Retry HTTP Status Codes: 429
Retry Error Codes: rate_limit

示例 2：自定义 API 返回 503 + service_unavailable

Retry HTTP Status Codes: 429, 503
Retry Error Codes: rate_limit, service_unavailable

示例 3：配额超限时的严格限速

Retry HTTP Status Codes: 429
Retry Error Codes: rate_limit, quota_exceeded, insufficient_quota

手动安装（备用方案）

如果自动加载不起作用：

1. 切换到 Cordis 预设（创意模式）
2. 使用 cordis_define：
- kind：new
- idPrefix：rtry
- name：Chat Continue
- purpose：Auto-retry on API request errors, supports auto/manual mode, configurable interval
3. 将 lib/host.js 内容粘贴到 Host 代码中
4. 将 lib/client.js 内容粘贴到 Client 代码中
5. 运行 cordis_run 启动

卸载

dsh plugin --profile web remove @wuxjs/dsh-chat-continue

然后重启 DSH。

文件结构

@wuxjs/dsh-chat-continue/
├── package.json           # npm package config (with dsh.bundle declaration)
├── cordis.patch.yml       # registers auto-loader into host layer
├── .gitignore
├── .npmrc                 # npm auth token (excluded from git)
├── lib/
│   ├── auto.js            # auto-loader (static plugin, registers dynamically)
│   ├── host.js            # host-side code (for manual installation)
│   └── client.js          # client-side code (for manual installation)
├── README.md
└── skills/

链接

- GitHub：https://github.com/Chu-m/dsh-chat-continue
- npm：https://www.npmjs.com/package/@wuxjs/dsh-chat-continue

许可证

MIT

中文

问题

使用 DSH 接入第三方平台的模型 API 时，这些平台通常会对调用进行限速或其他限制。当超出速率或触发其他限制时，API 会返回错误（如 429 Too Many Requests、rate_limit、quota_exceeded 等）。

DSH 官方内置了针对 DeepSeek API 的重试机制（dsh-llm-retry），但并不能覆盖所有第三方平台的错误码。当内置重试耗尽后，Agent 会话会卡住中断，需要用户手动输入“继续”才能恢复对话，体验非常差。

解决思路

本插件作为 DSH 内置重试的第二道防线：

1. 拦截 DSH 内置重试耗尽后的 agent/request-error 事件
2. 匹配你配置的状态码和错误码，判断是否是可重试的错误
3. 自动重试或弹窗通知让你手动确认
4. 无缝恢复对话 — 不再需要手动输入“继续”

工作原理

第三方 API 返回错误（429, rate_limit 等）
↓
DSH 内置重试 (dsh-llm-retry) 先处理
↓（内置重试耗尽后）
本插件拦截 agent/request-error 事件
↓
检查你配置的可重试状态码 & 错误码
↓
自动模式 → 等待指定秒数 → 自动重试
手动模式 → 右下角弹窗 → 点击「重试」或「放弃」
↓
重试成功 → 对话继续，无需手动输入

功能

- 自动重试模式：遇到 API 请求错误时自动等待指定秒数后重试，无需人工干预
- 手动确认模式：遇到错误时右下角弹出通知，点击「重试」或「放弃」
- 可配置错误码：自定义要拦截的 HTTP 状态码（如 429, 503）和错误码（如 rate_limit, service_unavailable）
- 可配置重试间隔：1–60 秒
- 可配置最大重试次数：1–100 次
- 设置页面：Settings → 对话继续

安装

前提条件

- 已安装 DSH（dsh 命令可用）

通过 npm 安装

bash
dsh plugin --profile web add @wuxjs/dsh-chat-continue

安装后重启 DSH，插件会自动加载。

使用说明

1. 安装并重启 DSH
2. 打开 Settings（侧边栏齿轮图标）
3. 找到 对话继续 选项卡
4. 配置参数：

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 重试模式 | 自动 = 自动重试，手动 = 弹窗通知 | 自动 |
| 重试间隔 | 每次重试之间的等待时间（1–60 秒） | 5 秒 |
| 最大重试次数 | 超过此次数后停止重试（1–100 次） | 10 次 |
| 重试 HTTP 状态码 | 逗号分隔，如 429, 503 | 429 |
| 重试错误码 | 逗号分隔，如 rate_limit, service_unavailable | rate_limit |

配置示例

示例 1：OpenAI 兼容接口返回 429

重试 HTTP 状态码: 429
重试错误码: rate_limit

示例 2：自定义 API 返回 503 + service_unavailable

重试 HTTP 状态码: 429, 503
重试错误码: rate_limit, service_unavailable

示例 3：严格限流 + quota_exceeded

重试 HTTP 状态码: 429
重试错误码: rate_limit, quota_exceeded, insufficient_quota

手动安装（备用方案）

如果自动加载未生效：

1. 切换到 Cordis preset（创造模式）
2. 使用 cordis_define：
- kind: new
- idPrefix: rtry
- name: Chat Continue
- purpose: 自动重试 API 请求错误，支持手动/自动模式，可配置重试间隔
3. 将 lib/host.js 内容粘贴到 Host 代码
4. 将 lib/client.js 内容粘贴到 Client 代码
5. 使用 cordis_run 启动

卸载
bash
dsh plugin --profile web remove @wuxjs/dsh-chat-continue

然后重启 DSH。

文件结构

@wuxjs/dsh-chat-continue/
├── package.json           # npm 包配置（含 dsh.bundle 声明）
├── cordis.patch.yml       # 注册自动加载器到 host 层
├── .gitignore
├── .npmrc                 # npm 认证 token（已排除在 git 外）
├── lib/
│   ├── auto.js            # 自动加载器（静态插件，启动时自动注册）
│   ├── host.js            # Host 端代码（用于手动安装）
│   └── client.js          # Client 端代码（用于手动安装）
├── README.md
└── skills/

链接

- GitHub: https://github.com/Chu-m/dsh-chat-continue
- npm: https://www.npmjs.com/package/@wuxjs/dsh-chat-continue

许可证

MIT