限流续跑 imlishiyuan/dsh-keep-running

dsh-keep-running

npm version
license

DeepSeek Harness 的 watchdog 插件：遇到 配额/限流（HTTP 429） 时，自动创建一个固定间隔的定时任务，到点持续投递「继续任务」的提示，直到任务成功或你手动接手。

依赖官方定时任务插件。 本插件通过 @deepseek-ai/dsh-schedule 提供的 ctx.schedule 服务增删调度，必须先挂载它，否则 keep-running 缺少必需服务、无法注册（见 依赖）。

功能

- 自动复活：配额耗尽（429）时自动建一个 every 调度，定时重发「继续」提示；
- 断点记录：记录最近一条真实用户消息，恢复时能接续上下文；
- 只在不忙时触发：调度由 schedule 运行时在 agent 空闲时投递，不会打扰你手动干活；
- 成功即停：任一 turn 正常结束（配额恢复）时自动删除调度；
- 两条快捷命令：/keep-running list、/keep-running cancel （见 命令）。

依赖

⚠️ 必须挂载官方定时任务插件 @deepseek-ai/dsh-schedule。

keep-running 声明 inject: ['commands', 'schedule']，通过 ctx.schedule 服务创建、查询与删除调度，而 ctx.schedule 由 @deepseek-ai/dsh-schedule 注册。只挂 keep-running 而不挂它时必需服务缺失，插件无法注册，看门狗不会工作（这是最常见的「没生效」原因）。

DSH 0.1.7 起的变化。 调度不再存放在会话日志的 schedule/change 事件里，改由 Host 存储承载，并且只能经 ctx.schedule 读写；直接 agent.session.append('schedule/change', ...) 已不是受支持的写入路径。

快速开始

1. 安装插件：

A. 官方命令（底层走 pnpm，需先安装 pnpm）
npm i -g pnpm
dsh plugin --profile web add dsh-keep-running

B. 直接用 npm 装进 profile 目录
cd ~/.dsh/profiles/web # Windows: C:\Users\\.dsh\profiles\web
npm install dsh-keep-running --save

并在同一 profile 安装其依赖插件：

cd ~/.dsh/profiles/web
npm install @deepseek-ai/dsh-schedule --save

2. 在 profile 的 cordis.patch.yml 里挂载。 要加载插件必须用 insert:，而不是直接写 - id:（否则报 entry "keep-running" not found 被跳过）。dsh-schedule 要排在 keep-running 之前：

- insert:
- id: dsh-schedule
name: '@deepseek-ai/dsh-schedule'
- id: keep-running
name: 'dsh-keep-running'
config:
intervalSeconds: 1800 # 定时任务间隔（秒），最小 300 continuePrompt: '请继续完成之前未完成的任务：{{task}}'
quotaKeywords: [] # 空 = 只认 HTTP 429；可加厂商关键词扩展

3. 重启 dsh web，新建会话即可。

配置

| 配置项 | 默认值 | 说明 |
| intervalSeconds | 1800 | 定时任务间隔（秒），每次到点重发「继续」提示；最小 300 |
| continuePrompt | 请继续完成之前未完成的任务：{{task}} | 每次投递的提示；{{task}} 会替换成断点记录（最近一条用户消息，截 200 字）|
| quotaKeywords | [] | 配额关键词（小写）。[] 时只认 HTTP 429；要适配其它厂商时填它们的报错关键词 |

quotaKeywords 说明

默认 [] = 只认 HTTP 429（并覆盖 RATE_LIMIT / QUOTA 这类 code 与 message 里的配额信号）。多厂商部署时，把各家报错的关键词填进来做泛化：

config:
quotaKeywords: ['quota exceeded', 'requests limit', '5-hour usage quota']

命令

插件注册了独有的 /keep-running 命令（独立命名空间，不与未来可能的 /schedule 命令冲突）：

- /keep-running list —— 列出当前会话所有活跃的 keep-running 定时任务（id、间隔、断点、下次时间）。
- /keep-running cancel —— 取消指定 id 的定时任务（id 从 list 结果取）。

命令直接查 ctx.schedule 的调度表，不依赖大模型，配额耗尽时也能用。

工作原理

1. 监听 agent/error：DeepSeek/OpenAI 的配额 429 在请求一建立就被拒，走 step()→turn() 的 catch→throwError()，不触发 agent/request-error waterfall（它只在流式 error finish 时触发）。真正 emit 的是全局 agent/error，其 payload.error.failure 才是带 status 的 LlmFailure。
2. isQuotaError 识别配额：HTTP 429、RATE_LIMIT/QUOTA 稳定 code，或 code/message 里的配额信号，再叠加 quotaKeywords。
3. ensureWatchdog 调用 ctx.schedule.create(..., { title: 'keep-running', every_seconds }) 创建调度；active 守卫防重复，并查询调度表做跨进程恢复。
4. 到点投递 continuePrompt；任一 turn 正常关闭（配额恢复）时 turn-stopping → stopWatchdog 停止。

使用场景

- 长任务跑到一半撞上「5 小时使用额度」等配额上限，希望自动续跑；
- 配额回来后不想每次手动重开任务；
- 手动开工时不想被打断（调度只在 agent 空闲时投递）；
- 用 /keep-running list / cancel 随时查看或取消。

开发

构建

npm install
npm run build # 编译 src → lib/index.js

本地挂载

开发期可直接用 file:// URL 挂载编译产物（同样要用 insert: 形式）：

- insert:
- id: dsh-schedule
name: '@deepseek-ai/dsh-schedule'
- id: keep-running
name: 'file:///D:/ui-workspace/dsh-keep-running/lib/index.js'
config:
intervalSeconds: 1800

把 URL 改成你的实际路径。

重启

dsh web

验证

确认两个插件都已挂载：

Windows
dsh web --dump-config | findstr /C:"keep-running" /C:"dsh-schedule"

Linux / macOS
dsh web --dump-config | grep -E "keep-running|dsh-schedule"

看到 keep-running 和 dsh-schedule 行且无 not found 警告，即挂载成功。

协议

Apache-2.0