dsh-task-guard

配置

所有字段都可省略；非法值会在插件加载时直接报错，不会静默降级。

字段	默认值	说明
enabled	true	总开关。
locale	zh	模型可见文本的语言：zh / en。
staleAfterCalls	5	成功调用多少次非 todo_write 工具后发第一条停滞 notice。
repeatEveryCalls	4	之后每隔多少次再提醒；0 表示只提醒一次。
blockAfterCalls	0	超过多少次仍未更新就硬拦截下一次工具调用；0 关闭。开启时必须大于 staleAfterCalls。
rejectMissingActive	false	为 true 时，拒绝“还有 pending、但没有 in_progress”的 todo_write；默认只发 notice。
sourceKind	auto	notice source kind：auto 按 session.header.version 选 v3/v4；也可强制 v3 / v4。
include	[]	只统计这些工具名（支持 * 通配）；空表示全部。
exclude	todo_write, ask_user_question	不统计的工具名。
maxListItems	6	notice 中最多列出多少个剩余任务。

示例：

- id: task-guard
  name: dsh-task-guard
  config:
    enabled: true
    locale: zh
    staleAfterCalls: 5
    repeatEveryCalls: 4
    blockAfterCalls: 0
    rejectMissingActive: false
    sourceKind: auto
    maxListItems: 6

推荐档位

• 保守（默认）：阶段边界即时 notice + 每 4 次调用一次的停滞 notice，不拦截任何工具。
• 强约束：blockAfterCalls: 12。模型连续 12 次成功调用都没有更新 todo 时，下一次工具调用会被拒绝，并收到“先调 todo_write”的明确错误；更新后自动恢复。
• 严格校验：rejectMissingActive: true。任何“还有 pending、但没有 in_progress”的 todo_write 都会被拒绝；这可能打断模型原有的计划写入，所以默认关闭。
• 只想提醒一次：repeatEveryCalls: 0。