任务守护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  add @max-null/dsh-guardian。

Services

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

Config

| 字段 | 默认值 | 含义 |
|---|---|---|
| decayTurns | 3 | 衰减一个断言点之前的干净回合数 |
| assertionThresholds | [1, 3] | 划分等级 1-3 的升序阈值 |
| noFeedbackThreshold | 3 | 警告之前的连续仅编辑回合数 |
| reviewQueueMax | 20 | 审查队列 FIFO 上限 |
| globalRoot | $DSH_HOME/storages/guardian | JSON 存储根目录 |

Storage

在 $DSH_HOME/storages/guardian 下的一个 JSON 单元（guardian，版本 1）：
sessions 表（每会话状态）+ 全局槽位（审查队列）。
运行期间以内存为准；状态在回合结束时刷写。

Develop

bash
npm install --legacy-peer-deps   # DSH peer 类型通过 tsconfig paths 解析
npm test                         # vitest：27 个纯函数测试
npm run typecheck                # tsc 针对相邻的 deepseek-harness lib/types 进行检查
npm run build                    # 输出 dist/

npm registry 上的 DSH rc 版本未同步，因此开发工具通过
tsconfig.json 中的 paths 解析 @deepseek-ai/* 类型，这些 paths 指向
相邻的 deepseek-harness 检出目录（../deepseek-harness）。运行时 peer
解析不受影响——宿主组合会提供真实的包。

SSID 系列