任务守护 Max-Null/dsh-guardian

@max-null/dsh-guardian

本插件属于 @max-null/ 插件系列——这一系列共同构成 SSID（思灵 · Seek Soul in Darkness） 桌面体验。SSID 是整合它们的盒：dsh-capture · dsh-chat-rail · dsh-chinese-thinking · dsh-draft-polish · dsh-guardian · dsh-habit · dsh-memory · dsh-node-appearance · dsh-plugin-center · dsh-quick-toolbar · dsh-skill-mcp-center · dsh-ssid-panels · dsh-ssid-zh-ui · dsh-achievements。

本插件属于 @max-null/ 插件系列——这一系列共同构成 SSID（思灵 · Seek Soul in Darkness） 桌面体验。

DeepSeek Harness 的守护状态引擎——三条触发线监控会话事件，支持实时提醒注入，并提供 UI 快照服务。

SSiD（思灵）的 M2，移植自 fractal 的 guardian：断言计数、编辑审查队列、无反馈环监测。

监控内容

| 触发线 | 规则 |
| 断言计数 | 扫描助手消息中的未经验证断言（不支持/做不到/只有 N 种/不存在/无法 X/远低于/过于 X）。按会话计数，每 3 个干净回合衰减 1 点，按阈值切分为等级 [1,3]+。 |
| 编辑审查队列 | 成功的 write/edit 工具调用入队 {filePath, sessionId, turn}。FIFO 上限 20，按文件+会话去重。每次组装提示词时，审查提醒会重新列出这些条目。 |
| 无反馈环 | 每回合：只编辑、不跑 bash/pwsh 就累加计数器；任何 exec 都会重置它。连续 3 个只编辑回合，注入「先搭反馈环」警告。 |

截图

本插件是会话行为监控类：不新增任何按钮、面板或设置项。它在会话过程中维护断言计数、编辑审查队列与「无反馈环」监测，效果体现在模型行为的约束上。

按《SSiD 开发手册》§9 截图规范：截图须回答「装完会多出/变成什么」的入口与面板。
本插件无界面元素（no UI surface），故不适用该项要求，改以上述行为效果说明代替。

Compose

cordis.yml (or via the bundle patch):
- id: guardian
name: '@max-null/dsh-guardian'

宿主组合中需要 storage、system-prompt（dsh-base 两者都自带）。以 bundle 方式安装：dsh plugin --profile <name> add @max-null/dsh-guardian。

服务

- ctx.guardian —— 引擎：
- snapshot() → { session, reviewQueue }，供 UI 面板使用
- sessionState(sessionId) → 按会话返回状态
- 三条动态 systemPrompt.context 提醒（guardian:assertion、 guardian:no-feedback、guardian:review），每次组装时从最近活跃的会话求值。

配置

| 字段 | 默认值 | 含义 |
| decayTurns | 3 | 衰减 1 个断言点前所需的干净回合数 |
| assertionThresholds | [1, 3] | 递增阈值，用于切分等级 1-3 |
| noFeedbackThreshold | 3 | 触发警告前连续只编辑回合数 |
| reviewQueueMax | 20 | 审查队列 FIFO 上限 |
| globalRoot | $DSH_HOME/storages/guardian | JSON 存储根目录 |

存储

$DSH_HOME/storages/guardian 下有一个 JSON 单元（guardian，版本 1）：sessions 表（按会话状态）+ 全局槽位（审查队列）。
运行期间，内存中的数据是权威来源；会话状态在回合结束时刷写，审核队列在每次编辑被接受时刷写。

刷写失败会记入 stderr 并丢弃：序列化写入链仍然可用，事件入口和写入链都不会让失败逃逸到宿主进程。状态只是参考性质，可以重建，所以丢掉一次更新就是预期的爆炸半径——被拒绝的写入绝不能把内核搞挂。

开发

npm install --legacy-peer-deps # @deepseek-ai/* types come from these devDependencies
npm test # vitest: 31 tests (incl. write-failure resilience)
npm run typecheck # tsc against the installed @deepseek-ai/* types
npm run build # emit dist/

开发工具从 devDependencies 安装到 node_modules 的那份副本里解析 @deepseek-ai/* 类型。tsconfig.json 里的 paths 条目指向相邻的 deepseek-harness 检出目录，而 max-null-plugins/ 旁边并没有这个目录，所以 TypeScript 对每一个条目都回退到 node_modules。运行时对等依赖的解析不受影响——宿主组合会提供真实的包。

SSID 系列