dsh-wait-guard
Manifest validBounded waiting and no-progress polling breaker for DeepSeek Harness: caps job_output waits, stops status-polling loops, and explains run_code deadlines and parse errors. Puts a budget on "waiting" and "polling."
dsh-wait-guard
给「等待」「轮询」和空调用加预算的 DSH 插件:限制后台任务的 job_output wait,拦截嵌套在 run_code 里的超长前台命令,在 run_code 撞上自己的程序截止时间或 JS 解析错误时说清楚原因,熔断「连续只查状态」和「连续 no-op」的循环;状态探针只拒绝,no-op 循环连续无视拒绝时才强制中止回合并自动要一次文字回答。
安装
dsh plugin --profile <profile> add dsh-wait-guard
# 或直接从 GitHub 安装
dsh plugin --profile <profile> add github:Lion-Li-git/dsh-wait-guard
装完新开一个会话即可生效(bundle 补丁会挂一行 wait-guard)。
它解决什么
七件事,全部走宿主平面的 tools/pre-execute / tools/post-execute,不改任何工具实现。
job_output的wait: true变成有预算的探测:单次 ≤ 20 秒;只允许在任务开始后 2 分钟内;同一个任务累计 ≤ 40 秒。超出的调用立即被拒(1ms 级),并把「结束回合、等完成通知」写进拒绝理由。- 嵌套在
run_code里的前台pwsh:如果它的timeoutMs超过run_code的程序截止时间(默认 120000ms),直接拒绝——那条命令会在截止点被连带中止,等也白等。 run_code的耗时反馈:程序在前台占用超过 45 秒,或撞到execution deadline reached,结果后追加一段说明:那是程序自己的预算(可调),不是任务上限;长活应该run_in_background然后结束回合。- 状态轮询熔断:同一 agent 在 120 秒内连续 4 次「只查状态」就
deny——run_code/ 直接pwsh的命令体只读 job 状态、日志尾巴、进程列表、时钟,且不含写操作;直接的无 waitjob_output也算。拒绝理由要求「用已知状态直接回答、说明 job 仍在跑、结束 turn」,第 2 次拒绝升级为「后续每次探针都会被拒」。任何写操作/工作型命令(git add、npm run、node tools/、write/edit、Start-Process等)把计数清零;超过 120 秒或进入新 turn 自动清零。只拒绝,不 cancel turn。 - no-op run_code 熔断:同一 agent 在 120 秒内连续 3 次「什么也不做」就
deny——run_code的description是No-op、程序是空的/只有return/只有console.log("常数")。拒绝理由要求「不要再调工具,直接把最终回答写进 assistant 文本」。工作调用重置计数;状态探针不重置它,所以「空调用 / 查状态」交替也逃不掉。进入新 turn 清零。 - JS 解析错误提示:
run_code报Expected ',', got 'ident'/Unexpected token/Invalid or unexpected token时,追加「模板字符串反引号」提示,并报出程序里的反引号个数。PowerShell 的`t/`n、Markdown 里的反引号都会提前结束 JS 模板。 - no-op 连续无视拒绝时强制中止 + 自动恢复:no-op 循环第 2 次被拒后,插件会
cancel当前 turn(不是只回一条错误),并followup一条 user 角色的「只输出文字、直接回答」消息,让模型在新 turn 里收尾。每 120 秒最多自动恢复一次;恢复后如果又空转,只中止、不再自动 followup,避免恢复本身变成循环。状态探针不走这条路径。
为什么要这个
在长会话里实测(session b3a09167,4 天):
| 观测 | 数据 |
|---|---|
job_output 带 wait: true | 59 次,累计阻塞 5447 秒(约 91 分钟) |
其中 timeout_ms: 115000 | 52 次——把 120 秒上限当成了预算,贴着上限循环 |
| 单个任务最多连等 | 6 次(任务本身 17 分钟) |
| 单次命令跑满 120 秒被程序截止杀掉 | 现网会话里可复现,且报错读起来像「任务不许超过两分钟」 |
状态轮询是同一类毛病的下一层(session 04e0a3ef,Epirus-Web):
| 观测 | 数据 |
|---|---|
| turn 18:用户问「怎么跑了 50 分钟」 | 第 2 步已得出完整答案;之后 47 步只查日志/进程,0 条文本,reasoning 一路写 Answer now.,2.3 分钟后用户按停止 |
| turn 22:用户问「你现在在干啥」 | 之后 13 步只有工具调用,job_output 反复返回 running,最后被 abort |
同一 turn 的 run_code 解析错误 | 7 次,全部是模板字符串里混进反引号;错误没有行号,模型只能整段重写 |
no-op 循环是第三层(session af4c3351,11-13):
| 观测 | 数据 |
|---|---|
| turn 74(11-13 12:50) | 38 steps / 37 次工具调用 / 0 条文本;最后用户按停止 |
| 空调用 | console.log("done") 这类「No-op」在全 session 出现 26 次;console.log("status") 11 次 |
| 0.2.0 为什么没拦住 | 状态探针计数只看 job/日志/进程;console.log("done") 既不匹配探针也不匹配工作,probe=false 反而把计数清零 |
默认参数就是按这组数据定的。
配置
在 profile 的 cordis.patch.yml 里给这一行加 config(单位毫秒,全部可选):
- id: wait-guard
config:
perCallMaxMs: 20000 # 单次 wait 上限
youngMs: 120000 # 只允许等「年龄小于它」的任务
totalBudgetMs: 40000 # 同一任务累计等待上限
defaultWaitMs: 30000 # 调用方没传 timeout_ms 时按它算
slowProgramMs: 45000 # run_code 超过它就追加慢提示
programDeadlineMs: 120000 # run_code 的默认程序截止时间
probeLimit: 4 # 连续第几次状态探针开始拒绝
probeWindowMs: 120000 # 探针/空调用计数窗口;超过就清零
noopLimit: 3 # 连续第几次 no-op run_code 开始拒绝
行为与副作用
- 失败即放行:查不到 jobs 服务、工具名不匹配、参数畸形,一律
next(),绝不误伤。 - 拒绝会让当前
run_code程序中止(未 catch 的ToolCallError)——这是刻意的停止信号,已经完成的副作用不回滚。 - 状态探针是启发式:用
node -e读日志之类的方式不会被识别;它拦的是最常见的job_output/ 日志 tail / 进程检查。 - no-op 也是启发式:空程序、
description: "No-op"、单条console.log("常数")会被计数;console.log(j.job.status)这类有计算的不算。第一次、第二次空调用放行,第 3 次拒绝。 - 强制中止只用于 no-op 循环:第 2 次 no-op 拒绝会
cancel当前 turn(keepInbox,保留用户中途消息),并followup一条 text-only 消息;120 秒内只自动恢复一次。状态探针只deny,不会 cancel turn,也不会插恢复消息。 - 计数按 turn 重置:新 turn 的第一条状态探针/空调用从 0 开始,不会继承上一 turn 的计数,避免把正常的新任务当成上一轮的循环。
- 只影响模型发起的调用;人手动跑的终端/命令不受影响。
测试
npm test
node --test 覆盖:4 次探针拒绝与升级、工作命令重置、wait: true 不受探针计数影响、直接 job_output / pwsh、嵌套 pwsh 超时、no-op 第 3 次拒绝与升级、状态探针不重置 no-op 计数、no-op 第 2 次拒绝后的 cancel/followup、状态探针不 cancel、新 turn 重置两种计数、解析错误提示只加一次、deadline 提示仍生效。
版本
- 0.3.2(2026-11-15):状态探针不再 cancel turn(只 deny);状态/no-op 计数按 turn 重置,避免上一轮的探针计数误伤新任务。
- 0.3.1(2026-11-13):no-op 第 2 次拒绝后强制
cancel当前 turn,并自动followup一条 text-only 消息;120 秒内最多恢复一次。 - 0.3.0(2026-11-13):新增 no-op
run_code熔断(noopLimit);空调用与状态探针互相不重置,交替也逃不掉。 - 0.2.0(2026-11-11):新增状态轮询熔断(
probeLimit/probeWindowMs)与run_code解析错误提示。 - 0.1.0:
job_output wait预算、嵌套pwsh超时拦截、run_code慢/截止提示。
兼容性
DSH >=0.2.0,cordis >=4,Node >=22.19。无运行时依赖,纯 ESM。
License
MIT
Comments
Loading…
Similar plugins
by john-walks-slow
wait_subagent tool for DeepSeek Harness: block until a background continuable subagent settles and return its stop reason and closing message — event-driven, zero polling.
★ 3
↓ 311/wk
MIT
JavaScript
Oct 26, 2026
dsh plugin --profile web add dsh-wait-subagentby tongsh6
Event-driven wait for DeepSeek Harness: returns on completion, early failure or stall instead of burning a full timeout; blocks sleep-polling.
★ 0
MIT
JavaScript
Nov 9, 2026
dsh plugin --profile web add dsh-tool-wait-untilby Existence001100
🏦 给 DSH (DeepSeek Harness) 的每次任务加一条预算线。支持按金额或 Token 限制消耗、自动拦截/手动放行,防止 Agent 过度消费。 🏦 Draws a budget line across every task in DSH (DeepSeek Harness). Cap consumption by CNY or token count, with auto-interception and burn-rate estimates to prevent runaway costs.
★ 1
MIT
JavaScript
Nov 8, 2026
dsh plugin --profile web add dsh-budget-guard-pluginby bbaz123
Post-task confirmation decision guard for DeepSeek Harness — balance output quality with real user impact.
★ 0
Apache-2.0
JavaScript
Oct 22, 2026
dsh plugin --profile web add dsh-plugin-confirmation-resolutionDeepSeek Harness plugin: on task send, pick a different model for subagents and an independent reviewer that validates each subagent's work before it reaches the main agent
★ 0
MIT
TypeScript
dsh plugin --profile web add dsh-orquestratorby JianGuo396
Pins an always-on-top progress bar while the agent runs a turn — the percentage is estimated from tool calls and filled to 100% when the turn ends — and badges the DeepSeek peak/off-peak pricing windo
★ 0
MIT
JavaScript
Oct 26, 2026
dsh plugin --profile web add dsh-control-bar