配置（全部可选，默认值见 `cordis.patch.yml` / `lib/core.js`）

键	默认	含义
`enabled`	`true`	`false` 直接禁用
`intervalMs`	`60000`	单一 timer 的检查点间隔（每个目标每 tick 一次聚合取证）
`probeSleepMs`	`1000`	单条探针内部两次采样的窗口（决定 CPU/日志增量的时间口径）
`stalledWindowsRequired`	`2`	连续候选窗口数门槛；内部强制 ≥2，配置写 1 也会被夹回 2
`cpuIdleDeltaMax`	`0.05`	CPU 增量 ≤ 此值（秒/窗口）判「≈0 空闲」
`cpuSaturatedDeltaMin`	`0.8`	CPU 增量 ≥ 此值（秒/窗口）判「打满」
`tailLines`	`20`	取证报告里的日志尾行数
`logDir` / `jsonlPath` / `statusPath`	`$DSH_HOME/stall-sentinel/…`	事件 JSONL 与状态快照落盘位置
`minJobDurationMs`	`1000`	短于此的 background job 不做存活跟踪
`minProbeAgeMs`	`10000`	自动接线的 spawn 目标存活满此毫秒才开始采样（短命令 0 探针开销）
`jsonlMaxBytes`	`1048576`	`events.jsonl` 超过此大小轮转到 `events.jsonl.old`（SGF-03）

使用方式：注册要看的子进程

插件通过 ctx.provide('stall-sentinel', api) 暴露 loopback 服务，任何宿主内插件/诊断代码都能：

const guard = ctx.get('stall-sentinel');
const { taskId } = guard.watch({
  taskId: 'my-build',            // 可选；缺省自动分配 watch-N
  label: 'pnpm install',
  pid: child.pid,                // 必须有正整数 pid
  logPath: 'C:\\agent\\install.log', // 进度信号源（大小/mtime 增量）
  marker: 'added',               // 可选阶段哨兵，命中即视为有进展
});
guard.getStatus();               // 返回整个监控快照
guard.list();                    // 当前 watch 集（按 taskId 隔离）
guard.unwatch(taskId);

⚠️ 没有 logPath 的目标会永久 unknown（继续等，绝不告警）——没有进度信号就无法区分慢与卡死。这也正是 skill 的「先声明进度信号」协议。

dsh-stall-sentinel

安装

说明文档

配置（全部可选，默认值见 `cordis.patch.yml` / `lib/core.js`）

使用方式：注册要看的子进程

安装

说明文档

配置（全部可选，默认值见 cordis.patch.yml / lib/core.js）

使用方式：注册要看的子进程

配置（全部可选，默认值见 `cordis.patch.yml` / `lib/core.js`）