dsh-personal-system-rules 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 更新日志
 
+## 0.6.0 — 2026-11-04
+
+- 新增任务状态守卫：本轮的 todo 列表里还有 `in_progress` 项、且连续 `maxStaleTodoSteps` 步没有重写列表时，经 `agent/pre-step` 注入一条提醒；之后每再累积同样步数提醒一次。默认 6 步，`0` 关闭。
+- 本轮没有 todo 列表（短任务可以主动跳过）或列表已全部 `completed` 时都不触发，避免把有意不写列表的任务也当成「没更新」。
+- 设置页「守卫」卡片新增「任务状态」分组，阈值与文案都可在弹窗编辑，文案支持 `{count}`（未更新步数）与 `{inProgress}`（进行中项数）。
+- 检测逻辑新增纯函数 `staleTodoSteps()`，`test/loop-guard.test.js` 与 `test/guards.test.js` 各有覆盖。
+
 ## 0.5.1 — 2026-11-04
 
 - 声明并验证对 DeepSeek Harness 0.2.2 预发布版的支持：`settings.section` 与 `plugins.bundle.config` 的注册契约、`describe/mutate` 设置读写、locale 的 `register(ns, {zh, en})` 形式、`loader/volatile-update` 热更新路径在 0.2.2 均未变。`engines.dsh` 已覆盖该版本。

package/README.md

@@ -2,18 +2,19 @@
 
 [![CI](https://github.com/NingYuanLee/dsh-personal-system-rules/actions/workflows/ci.yml/badge.svg)](https://github.com/NingYuanLee/dsh-personal-system-rules/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/dsh-personal-system-rules.svg)](https://www.npmjs.com/package/dsh-personal-system-rules) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
-把个性化规则文件注入 DeepSeek Harness（dsh）的**系统提示**，并提供**静默提醒**与**重复操作循环检测**；规则正文与守卫参数都能在设置弹窗「个性化规则」里编辑。
+把个性化规则文件注入 DeepSeek Harness（dsh）的**系统提示**，并提供**静默提醒**、**重复操作循环检测**与**任务状态守卫**；规则正文与守卫参数都能在设置弹窗「个性化规则」里编辑。
 
-A dsh plugin that injects a personal rules file as a system-prompt section and adds silent-step / repeated-action loop guards. The rules body and guard options are editable from the dsh settings dialog.
+A dsh plugin that injects a personal rules file as a system-prompt section and adds silent-step / repeated-action loop guards and a stale-todo guard. The rules body and guard options are editable from the dsh settings dialog.
 
 ## 功能
 
 1. **系统提示段**：把 `~/.dsh/PERSONAL-SYSTEM-RULES.md`（或 `config.file` 指定文件）注册成段 `user:agents-md`，order 默认 10150，原样注入；`watchFile` 1 秒轮询，改完下一次模型请求生效，不用重启。
 2. **静默提醒**：连续 `maxSilentSteps`（默认 2）步没有可见文本时，注入一条提醒要求模型说明进展；同一条链只提醒一次，`0` 关闭。
 3. **循环检测**：连续 `repeatLimit` 步执行**完全相同**的工具调用（工具名 + 归一化参数）时触发，`repeatAction` 可选 `remind`（提醒）或 `stop`（像用户点停止一样中止本轮并保留排队输入）；默认 0 关闭。
-4. **设置弹窗页面**：`设置 → 个性化规则` 与插件详情页是同一个页面，含「规则正文」和「守卫」两块；保存经官方 `settings` 机制写回 profile patch 并热更新。
+4. **任务状态守卫**：本轮的 todo 列表里还有 `in_progress` 项、且连续 `maxStaleTodoSteps`（默认 6）步没有重写列表时提醒一次，之后再每隔同样步数提醒；本轮没建列表（短任务）时不打扰，全部完成时也不触发。`0` 关闭。
+5. **设置弹窗页面**：`设置 → 个性化规则` 与插件详情页是同一个页面，含「规则正文」和「守卫」两块；保存经官方 `settings` 机制写回 profile patch 并热更新。
 
-静默提醒与循环检测共用同一个 `agent/pre-step` 钩子；检测逻辑是纯函数，独立测试。
+三个守卫共用同一个 `agent/pre-step` 钩子；检测逻辑是纯函数，独立测试。
 
 ## 安装
 
@@ -27,13 +28,13 @@ dsh plugin --profile my-profile add dsh-personal-system-rules
 **从 git（固定 tag）：**
 
 ```powershell
-dsh plugin --profile my-profile add "git+https://github.com/NingYuanLee/dsh-personal-system-rules.git#v0.5.0"
+dsh plugin --profile my-profile add "git+https://github.com/NingYuanLee/dsh-personal-system-rules.git#v0.6.0"
 ```
 
 **从 GitHub Release tarball：**
 
 ```powershell
-dsh plugin --profile my-profile add "https://github.com/NingYuanLee/dsh-personal-system-rules/releases/download/v0.5.0/dsh-personal-system-rules-0.5.0.tgz"
+dsh plugin --profile my-profile add "https://github.com/NingYuanLee/dsh-personal-system-rules/releases/download/v0.6.0/dsh-personal-system-rules-0.6.0.tgz"
 ```
 
 包没有 `prepare` / `postinstall` 脚本，安装不执行构建代码。
@@ -53,11 +54,14 @@ dsh plugin --profile my-profile add "https://github.com/NingYuanLee/dsh-personal
     repeatLimit: 0
     repeatAction: remind
     repeatReminder: ''
+    maxStaleTodoSteps: 6
+    staleTodoReminder: ''
 ```
 
-- `maxSilentSteps`、`silentReminder`、`repeatLimit`、`repeatAction`、`repeatReminder` 是 `volatile()` 字段，可在设置弹窗编辑并热更新。
+- `maxSilentSteps`、`silentReminder`、`repeatLimit`、`repeatAction`、`repeatReminder`、`maxStaleTodoSteps`、`staleTodoReminder` 是 `volatile()` 字段，可在设置弹窗编辑并热更新。
 - `file`、`header`、`order` 是普通配置，只在 `cordis.patch.yml` 里改；改 `file` 后需要重载插件。
 - `repeatLimit: 0` 关闭循环检测；文本回复或新用户轮次会重置重复计数。
+- `maxStaleTodoSteps: 0` 关闭任务状态守卫；提醒文案可含 `{count}`（未更新的步数）与 `{inProgress}`（进行中的项数）。
 - 设置弹窗保存会写回 profile 的 `cordis.patch.yml`。
 
 ## 兼容性

package/client.js

@@ -10,6 +10,7 @@ const READ = "systemAgentsMd/read";
 const WRITE = "systemAgentsMd/write";
 const DEFAULT_REMINDER = "\u4F60\u5DF2\u7ECF\u8FDE\u7EED {count} \u6B65\u6CA1\u6709\u5411\u7528\u6237\u8BF4\u660E\u8FDB\u5C55\u3002\u8BF7\u5728\u672C\u6B65\u5F00\u5934\u7528\u4E00\u53E5\u8BDD\u8BF4\u660E\u6B63\u5728\u505A\u4EC0\u4E48\u3001\u4E3A\u4EC0\u4E48\uFF0C\u518D\u7EE7\u7EED\u8C03\u7528\u5DE5\u5177\u3002";
 const DEFAULT_REPEAT_REMINDER = "\u4F60\u5DF2\u7ECF\u8FDE\u7EED {count} \u6B65\u6267\u884C\u5B8C\u5168\u76F8\u540C\u7684\u64CD\u4F5C\u3002\u8BF7\u505C\u6B62\u91CD\u590D\uFF1A\u5148\u8BF4\u660E\u5F53\u524D\u963B\u585E\u548C\u5DF2\u5B8C\u6210\u7684\u90E8\u5206\uFF0C\u518D\u6362\u4E00\u79CD\u505A\u6CD5\uFF1B\u5982\u679C\u786E\u5B9E\u9700\u8981\u7EE7\u7EED\u540C\u4E00\u64CD\u4F5C\uFF0C\u8BF7\u5148\u5411\u7528\u6237\u8BF4\u660E\u539F\u56E0\u3002";
+const DEFAULT_STALE_TODO_REMINDER = "\u4EFB\u52A1\u5217\u8868\u91CC\u6709 {inProgress} \u9879\u4ECD\u6807\u7740\u8FDB\u884C\u4E2D\uFF0C\u4F46\u5DF2\u8FDE\u7EED {count} \u6B65\u6CA1\u6709\u66F4\u65B0\u3002\u8BF7\u91CD\u5199 todo \u5217\u8868\uFF1A\u628A\u5DF2\u5B8C\u6210\u7684\u9879\u6807\u6210 completed\uFF0C\u53EA\u7559\u4E0B\u771F\u6B63\u5728\u505A\u7684\u4E00\u9879\uFF0C\u518D\u7EE7\u7EED\u3002";
 const zh = {
   nav: "\u4E2A\u6027\u5316\u89C4\u5219",
   title: "\u4E2A\u6027\u5316\u89C4\u5219",
@@ -31,6 +32,11 @@ const zh = {
   loopActionStop: "\u76F4\u63A5\u53EB\u505C\u672C\u8F6E",
   loopReminderLabel: "\u63D0\u9192\u6587\u6848",
   loopReminderHint: "\u53EF\u7528 {count} \u8868\u793A\u5DF2\u91CD\u590D\u7684\u6B65\u6570\uFF1B\u7559\u7A7A\u4F7F\u7528\u9ED8\u8BA4\u6587\u6848\u3002",
+  staleTitle: "\u4EFB\u52A1\u72B6\u6001",
+  staleStepsLabel: "\u4EFB\u52A1\u5217\u8868\u672A\u66F4\u65B0\u7684\u6B65\u6570\u9608\u503C",
+  staleStepsHint: "\u5217\u8868\u91CC\u8FD8\u6709\u300C\u8FDB\u884C\u4E2D\u300D\u7684\u9879\u3001\u4E14\u8FDE\u7EED\u8FD9\u4E48\u591A\u6B65\u6CA1\u6709\u91CD\u5199 todo \u65F6\u63D0\u9192\uFF1B0 \u8868\u793A\u5173\u95ED\u3002\u9ED8\u8BA4 6\u3002",
+  staleReminderLabel: "\u63D0\u9192\u6587\u6848",
+  staleReminderHint: "\u53EF\u7528 {count} \u8868\u793A\u672A\u66F4\u65B0\u7684\u6B65\u6570\u3001{inProgress} \u8868\u793A\u8FDB\u884C\u4E2D\u7684\u9879\u6570\uFF1B\u7559\u7A7A\u4F7F\u7528\u9ED8\u8BA4\u6587\u6848\u3002",
   invalidLimit: "\u91CD\u590D\u6B21\u6570\u5FC5\u987B\u662F\u4E0D\u5C0F\u4E8E 0 \u7684\u6574\u6570\u3002",
   saveGuard: "\u4FDD\u5B58\u5B88\u536B",
   savingGuard: "\u4FDD\u5B58\u4E2D",
@@ -78,6 +84,11 @@ const en = {
   loopActionStop: "Stop this turn",
   loopReminderLabel: "Reminder text",
   loopReminderHint: "Use {count} for the repeated step count; leave blank for the default.",
+  staleTitle: "Task status",
+  staleStepsLabel: "Steps without a todo update",
+  staleStepsHint: "Triggers while the list still has items in progress and it has not been rewritten for this many steps; 0 disables it. Default 6.",
+  staleReminderLabel: "Reminder text",
+  staleReminderHint: "Use {count} for the stale step count and {inProgress} for the in-progress items; leave blank for the default.",
   invalidLimit: "The repeat limit must be an integer of 0 or more.",
   saveGuard: "Save guards",
   savingGuard: "Saving",
@@ -191,6 +202,7 @@ function RulesSection(props) {
   const area = useRef(null);
   const reminderArea = useRef(null);
   const loopArea = useRef(null);
+  const staleArea = useRef(null);
   const request = useRef(0);
   const [configPhase, setConfigPhase] = useState("loading");
   const [configNs, setConfigNs] = useState(SETTINGS_NS);
@@ -202,6 +214,8 @@ function RulesSection(props) {
   const [repeatLimitDraft, setRepeatLimitDraft] = useState("");
   const [repeatActionDraft, setRepeatActionDraft] = useState("remind");
   const [loopReminderDraft, setLoopReminderDraft] = useState("");
+  const [staleStepsDraft, setStaleStepsDraft] = useState("");
+  const [staleReminderDraft, setStaleReminderDraft] = useState("");
   function applyLoaded(value) {
     setPath(value.path || "");
     setDraft(value.text || "");
@@ -273,6 +287,8 @@ function RulesSection(props) {
       setRepeatLimitDraft(Number.isFinite(value.repeatLimit) && value.repeatLimit > 0 ? String(value.repeatLimit) : "");
       setRepeatActionDraft(value.repeatAction === "stop" ? "stop" : "remind");
       setLoopReminderDraft(typeof value.repeatReminder === "string" ? value.repeatReminder : "");
+      setStaleStepsDraft(Number.isFinite(value.maxStaleTodoSteps) && value.maxStaleTodoSteps > 0 ? String(value.maxStaleTodoSteps) : "");
+      setStaleReminderDraft(typeof value.staleTodoReminder === "string" ? value.staleTodoReminder : "");
       setRevision(Number.isFinite(row.revision) ? row.revision : 0);
       setConfigPhase("ready");
     } catch (error) {
@@ -374,13 +390,25 @@ function RulesSection(props) {
     }
     const reminder = reminderDraft.trim() === "" ? "" : reminderDraft;
     const loopReminder = loopReminderDraft.trim() === "" ? "" : loopReminderDraft;
+    const staleText = staleStepsDraft.trim();
+    let staleSteps = 0;
+    if (staleText !== "") {
+      staleSteps = Number(staleText);
+      if (!Number.isInteger(staleSteps) || staleSteps < 0) {
+        setConfigNote({ tone: "error", text: tr("invalidSteps") });
+        return;
+      }
+    }
+    const staleReminder = staleReminderDraft.trim() === "" ? "" : staleReminderDraft;
     const action = repeatActionDraft === "stop" ? "stop" : "remind";
     const ops = [
       stepsText === "" ? { op: "unset", path: ["maxSilentSteps"] } : { op: "set", path: ["maxSilentSteps"], value: steps },
       reminder === "" ? { op: "unset", path: ["silentReminder"] } : { op: "set", path: ["silentReminder"], value: reminder },
       limitText === "" ? { op: "unset", path: ["repeatLimit"] } : { op: "set", path: ["repeatLimit"], value: limit },
       action === "remind" ? { op: "unset", path: ["repeatAction"] } : { op: "set", path: ["repeatAction"], value: action },
-      loopReminder === "" ? { op: "unset", path: ["repeatReminder"] } : { op: "set", path: ["repeatReminder"], value: loopReminder }
+      loopReminder === "" ? { op: "unset", path: ["repeatReminder"] } : { op: "set", path: ["repeatReminder"], value: loopReminder },
+      staleText === "" ? { op: "unset", path: ["maxStaleTodoSteps"] } : { op: "set", path: ["maxStaleTodoSteps"], value: staleSteps },
+      staleReminder === "" ? { op: "unset", path: ["staleTodoReminder"] } : { op: "set", path: ["staleTodoReminder"], value: staleReminder }
     ];
     setOptionsBusy(true);
     setConfigNote(null);
@@ -398,6 +426,8 @@ function RulesSection(props) {
         setRepeatLimitDraft(Number.isFinite(view.value.repeatLimit) && view.value.repeatLimit > 0 ? String(view.value.repeatLimit) : "");
         setRepeatActionDraft(view.value.repeatAction === "stop" ? "stop" : "remind");
         setLoopReminderDraft(typeof view.value.repeatReminder === "string" ? view.value.repeatReminder : "");
+        setStaleStepsDraft(Number.isFinite(view.value.maxStaleTodoSteps) && view.value.maxStaleTodoSteps > 0 ? String(view.value.maxStaleTodoSteps) : "");
+        setStaleReminderDraft(typeof view.value.staleTodoReminder === "string" ? view.value.staleTodoReminder : "");
       }
       setConfigNote({ tone: "ok", text: tr("guardSaved") });
     } catch (error) {
@@ -586,6 +616,44 @@ function RulesSection(props) {
       })
     ),
     h("p", { className: "dsh-agents-md-hint" }, tr("loopReminderHint")),
+    h("p", { className: "dsh-agents-md-group" }, tr("staleTitle")),
+    h(
+      "label",
+      { className: "dsh-agents-md-label" },
+      tr("staleStepsLabel"),
+      h("input", {
+        className: "dsh-agents-md-field",
+        type: "number",
+        min: "0",
+        step: "1",
+        value: staleStepsDraft,
+        disabled: optionsBusy || configPhase !== "ready",
+        onChange: (event) => {
+          setStaleStepsDraft(event.target.value);
+          setConfigNote(null);
+        }
+      })
+    ),
+    h("p", { className: "dsh-agents-md-hint" }, tr("staleStepsHint")),
+    h(
+      "label",
+      { className: "dsh-agents-md-label" },
+      tr("staleReminderLabel"),
+      h("textarea", {
+        ref: staleArea,
+        className: "dsh-agents-md-field dsh-agents-md-field-area",
+        rows: 3,
+        value: staleReminderDraft,
+        spellCheck: false,
+        disabled: optionsBusy || configPhase !== "ready",
+        placeholder: DEFAULT_STALE_TODO_REMINDER,
+        onChange: (event) => {
+          setStaleReminderDraft(event.target.value);
+          setConfigNote(null);
+        }
+      })
+    ),
+    h("p", { className: "dsh-agents-md-hint" }, tr("staleReminderHint")),
     configNote ? h("p", {
       className: configNote.tone === "ok" ? "dsh-agents-md-ok" : "dsh-agents-md-error",
       role: configNote.tone === "ok" ? "status" : "alert"

package/index.js

@@ -4,7 +4,7 @@ import { homedir } from 'node:os'
 import { join } from 'node:path'
 import { pathToFileURL } from 'node:url'
 import { MAX_BYTES, readAgentsFile, writeAgentsFile } from './file.js'
-import { countRepeatSteps } from './loop-guard.js'
+import { countRepeatSteps, staleTodoSteps } from './loop-guard.js'
 
 /** Cordis plugin name. */
 export const name = 'system-agents-md'
@@ -15,6 +15,7 @@ export const inject = ['systemPrompt']
 const SECTION_NAME = 'user:agents-md'
 const DEFAULT_ORDER = 10150
 const DEFAULT_MAX_SILENT_STEPS = 2
+const DEFAULT_MAX_STALE_TODO_STEPS = 6
 const DEFAULT_RULES_FILE = 'PERSONAL-SYSTEM-RULES.md'
 const DEFAULT_HEADER = [
   '# 用户全局系统层规则',
@@ -28,6 +29,9 @@ const DEFAULT_SILENT_REMINDER = '你已经连续 {count} 步没有向用户说
 /** Default reminder used when the same tool call repeats beyond the limit. */
 const DEFAULT_REPEAT_REMINDER = '你已经连续 {count} 步执行完全相同的操作。请停止重复：先说明当前阻塞和已完成的部分，再换一种做法；如果确实需要继续同一操作，请先向用户说明原因。'
 
+/** Default reminder used when the task list stops moving while items stay in progress. */
+const DEFAULT_STALE_TODO_REMINDER = '任务列表里有 {inProgress} 项仍标着进行中，但已连续 {count} 步没有更新。请重写 todo 列表：把已完成的项标成 completed，只留下真正在做的一项，再继续。'
+
 /** Wire namespace for the detail-page editor and the settings dialog. */
 export const FILE_SERVICE = 'systemAgentsMd'
 
@@ -71,6 +75,8 @@ async function loadConfigSchema() {
     repeatLimit: z.number().min(0).default(0).volatile(),
     repeatAction: z.union([z.const('remind'), z.const('stop')]).default('remind').volatile(),
     repeatReminder: z.string().default('').volatile(),
+    maxStaleTodoSteps: z.number().min(0).default(DEFAULT_MAX_STALE_TODO_STEPS).volatile(),
+    staleTodoReminder: z.string().default('').volatile(),
   })
 }
 
@@ -139,7 +145,22 @@ function resolveSettings(config = {}) {
   const repeatAction = unwrapVolatile(config.repeatAction) === 'stop' ? 'stop' : 'remind'
   const repeatReminderValue = unwrapVolatile(config.repeatReminder)
   const repeatTemplate = typeof repeatReminderValue === 'string' && repeatReminderValue.trim() ? repeatReminderValue : DEFAULT_REPEAT_REMINDER
-  return { file, order, header, maxSilentSteps, silentTemplate, repeatLimit, repeatAction, repeatTemplate }
+  const staleStepsValue = Number(unwrapVolatile(config.maxStaleTodoSteps))
+  const maxStaleTodoSteps = Number.isFinite(staleStepsValue) ? Math.max(0, Math.floor(staleStepsValue)) : DEFAULT_MAX_STALE_TODO_STEPS
+  const staleReminderValue = unwrapVolatile(config.staleTodoReminder)
+  const staleTemplate = typeof staleReminderValue === 'string' && staleReminderValue.trim() ? staleReminderValue : DEFAULT_STALE_TODO_REMINDER
+  return {
+    file,
+    order,
+    header,
+    maxSilentSteps,
+    silentTemplate,
+    repeatLimit,
+    repeatAction,
+    repeatTemplate,
+    maxStaleTodoSteps,
+    staleTemplate,
+  }
 }
 
 /**
@@ -345,14 +366,17 @@ export function apply(ctx, config = {}) {
     }
   }, 'system-agents-md.section')
 
-  // One pre-step hook drives both guards:
+  // One pre-step hook drives three guards:
   // - silent guard: consecutive steps without visible text;
   // - loop guard: consecutive identical tool-call steps (remind, or stop the
-  //   turn the way the user's own stop does, keeping queued input).
+  //   turn the way the user's own stop does, keeping queued input);
+  // - stale-todo guard: a task list left with `in_progress` items that the
+  //   model has not rewritten for several steps.
   // Settings edits are volatile, so `current` is read on every step. A guard
   // disabled with 0 resets its own per-agent state.
   const silentRemindedAt = new WeakMap()
   const repeatState = new WeakMap()
+  const staleRemindedAt = new WeakMap()
   ctx.effect(() => ctx.on('agent/pre-step', async (payload, next) => {
     const decision = await next()
     if (decision.kind === 'reject') return decision
@@ -402,6 +426,30 @@ export function apply(ctx, config = {}) {
       }
     }
 
+    const staleLimit = current.maxStaleTodoSteps
+    if (staleLimit <= 0) {
+      staleRemindedAt.delete(agent)
+    } else {
+      const stale = staleTodoSteps(agent)
+      if (!stale.hasList || stale.inProgress === 0 || stale.steps < staleLimit) {
+        staleRemindedAt.delete(agent)
+      } else if (stale.steps >= (staleRemindedAt.get(agent) ?? 0) + staleLimit) {
+        // One reminder per staleLimit further steps: the counter cannot drop
+        // until the model rewrites the list, so a plain `> last` would nag on
+        // every following step.
+        staleRemindedAt.set(agent, stale.steps)
+        additions.push(createUserMessage({
+          content: [{
+            type: 'text',
+            text: current.staleTemplate
+              .replaceAll('{count}', String(stale.steps))
+              .replaceAll('{inProgress}', String(stale.inProgress)),
+          }],
+          source: { kind: 'system-agents-md', form: 'notice', summary: stale.steps + ' steps since the last todo update' },
+        }))
+      }
+    }
+
     return additions.length === 0 ? decision : { ...decision, messages: additions }
   }), 'system-agents-md.guards')
 

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Personalized rules",
-    "description": "Inject a user-chosen rules file as a system-prompt section, and configure its body plus silent-step and repeated-action guards from the DSH settings dialog or the plugin detail page. Inactive in the minimal preset; nothing is injected when the plugin is disabled or fails to load."
+    "description": "Inject a user-chosen rules file as a system-prompt section, and configure its body plus silent-step, repeated-action and stale-todo guards from the DSH settings dialog or the plugin detail page. Inactive in the minimal preset; nothing is injected when the plugin is disabled or fails to load."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "个性化规则",
-    "description": "把用户指定的规则文件注入为系统提示段，并在 DSH 设置弹窗或插件详情页配置规则正文、静默提醒与循环检测守卫。极简模式下不生效；插件停用或加载失败时不注入任何内容。"
+    "description": "把用户指定的规则文件注入为系统提示段，并在 DSH 设置弹窗或插件详情页配置规则正文、静默提醒、循环检测与任务状态守卫。极简模式下不生效；插件停用或加载失败时不注入任何内容。"
   }
 }

package/loop-guard.js

@@ -88,3 +88,39 @@ export function repeatStreak(steps) {
 export function countRepeatSteps(agent) {
   return repeatStreak(recentToolSteps(agent))
 }
+
+/**
+ * Steps taken since the newest `todo/write` in the current turn, plus how many
+ * items that list left `in_progress`.
+ *
+ * The todo projection is reset by `turn/start`, so a list that is still
+ * non-empty was necessarily written in this turn. `hasList` is false when the
+ * turn wrote no list yet: the model may be skipping todos on purpose (short
+ * tasks), so callers must not nag in that case.
+ * @param {object} agent live agent (session surface + eventAt)
+ * @returns {{ steps: number, inProgress: number, hasList: boolean }}
+ */
+export function staleTodoSteps(agent) {
+  const nodes = agent?.session?.surface?.nodes
+  if (!Array.isArray(nodes)) return { steps: 0, inProgress: 0, hasList: false }
+  let steps = 0
+  for (let index = nodes.length - 1; index >= 0; index -= 1) {
+    const event = agent.session.eventAt(nodes[index])
+    if (event === undefined) continue
+    if (event.type === 'todo/write') {
+      const todos = Array.isArray(event.data?.todos) ? event.data.todos : []
+      return {
+        steps,
+        inProgress: todos.filter((todo) => todo?.status === 'in_progress').length,
+        hasList: true,
+      }
+    }
+    if (event.type === 'assistant/message') {
+      steps += 1
+      continue
+    }
+    if (event.type === 'turn/start') break
+    if (event.type === 'user/message' && event.data?.source?.kind === 'user') break
+  }
+  return { steps, inProgress: 0, hasList: false }
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-personal-system-rules",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "displayName": "个性化规则",
-  "description": "Inject a user-chosen rules file as a system-prompt section, and configure its body plus silent-step and repeated-action guards from the DSH settings dialog or the plugin detail page. Inactive in the minimal preset; nothing is injected when the plugin is disabled or fails to load.",
+  "description": "Inject a user-chosen rules file as a system-prompt section, and configure its body plus silent-step, repeated-action and stale-todo guards from the DSH settings dialog or the plugin detail page. Inactive in the minimal preset; nothing is injected when the plugin is disabled or fails to load.",
   "license": "MIT",
   "author": "NingYuanLee",
   "type": "module",