前言¶
DeepSeek Harness（DSH）在智能体开发中，往往需要在提示词里写一堆「建议」：先检查后执行、先验证后收口、记录关键步骤。这些规则最终落点在 LLM 的推理里，很容易被绕过或忽略。shisan-xinuo-dsh-plugin 的目标，是把「工程纪律」从提示词里的建议，变成宿主这一层跑不掉的强制。它在 DSH 之上加了一套运行时治理与提示词管理后台，让危险动作可拦截、工作过程可审计、任务完成可证明。
插件定位¶
shisan-xinuo-dsh-plugin 是 DeepSeek Harness（DSH）的运行时治理插件，由维护者 zxc663 在 GitHub 上开源。它不是安全沙箱，而是通过 L3 拦截、真值收口、规则 Config 化与提示词管理后台，把工程纪律下沉为宿主上的运行时强制。当前版本为 0.1.0-mvp，采用 MIT 许可证。
解决的问题¶
在使用 DSH 开发或调试智能体时，常见几类问题：
- 危险操作不打招呼就执行；
- 口头说「验证通过」，其实没跑、或跑的不是那条命令；
- 该做的分级、清单、留档不做，出了事无法复盘；
- 说「任务完成」但没有一条可复核的证据。
本插件在宿主这一层把这些「靠自觉」的事改成「靠机制」，不是把纪律写得更多，而是让纪律变成运行时强制。
核心功能¶
1. 提示词层（常驻 + 按需）¶
- content/discipline.md：常驻核心纪律，包括状态行、开工协议、证据分级（K0–K6）、承载留档、红线与收口格式。
- content/layered/：按需加载的流程细则与固定模板，用完即走，不占上下文。
- 全部提示词允许用户修改；改坏自动回退内置默认。
- 插件自包含，不依赖外部 Skill 才能运行，外部 Skill 仅可作为可选参考。
2. 挂载的工具包¶
| 工具 | 作用 |
|---|---|
| discipline_gate | 收口时宿主真实执行你声明的验证命令，与声称的退出码比对；谎报退出码＝不通过 |
| discipline_task | 开工登记任务清单与验收断言；回合收尾自动复核，未过＝打回 |
| discipline_tools | 只读列出当前真正下发的工具面（线缆真值），不做裁剪 |
3. 运行时自动强制¶
- 判级自动检测：宿主按「工具名 + 命令」独立推风险等级，与自报等级比对，低报也逃不掉。
- 调用工具检测：按客观副作用（写／删除／执行）判是否需要收口，只读回合自动豁免。
- L3 危险命令拦截：命中危险域先拦下、要你确认，未授权不执行。
- 回合收尾复核：已登记断言由宿主在收尾自动复核，未过即打回，不认「自己说完成了」。
- 遥测对账：执行日志 + 统计对账 + 密钥脱敏，全程留痕可审计。
4. 强权限管理¶
- L3 危险域可配置（content/rules.json），域命中即拦；配置损坏自动回退内置默认，不静默解除防护。
- 只读豁免规则区分「查看」与「改动」。
- 工作区边界守卫：越界写动作全程记录在案。
5. 提示词管理后台（DSH 自定义）¶
内置一套网页管理后台，挂在 DSH 设置区，包含 6 个页签：
- 会话管理：只读查看每个会话实际装配的提示词。
- 系统提示词管理：编辑常驻核心／我的提示词／渐进分节，整段接管或恢复官方原文。
- 快照与恢复：一键备份、时间线回滚、JSON 导入导出。
- 统计数据：护栏拦截、快照、会话改动等审计流水。
- 治理开关：L3 总闸＋各危险域逐域开关＋误拦白名单，写 governance.json 热生效。
- 关于：版本、反馈入口、卸载与还原指引。
安装与启用¶
安装前请检查源码与许可证。发行态使用 cordis.patch.yml（指向预编译产物 lib/）进行挂载。开发态挂载示例见 cordis.yml。运行测试：
npm test # 全套单测（Node ≥22.18）
node scripts/tally.mjs --report --freeze
典型用法¶
在 DSH 中挂载插件后，规则与提示词由 discipline.md 与 layered 目录提供。宿主会按工具名和命令自动判级，若命中 L3 危险域则先拦下等待确认；收口时 discipline_gate 会真实执行验证命令并与声称的退出码比对；discipline_task 会在回合收尾自动复核已登记断言。用户可通过提示词管理后台查看会话装配、编辑提示词、做快照与恢复，并在治理开关页签控制 L3 总闸与各危险域的开关与误拦白名单。
适用场景与注意¶
适合需要在宿主层强制执行工程纪律的 DSH 使用者，特别是对危险操作、验证与收口有较高要求的工作流。本插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。它不保证模型更聪明，也不构成安全边界——拦截面是枚举覆盖，验证面是真退出码。收口验证是一条新的执行通道，不是安全沙箱；清单覆盖之外不拦，退出码比对只抓「谎报」，与目标无关的命令仍会通过。
短结尾¶
shisan-xinuo-dsh-plugin 通过 L3 拦截、真值收口与提示词管理后台，把工程纪律从提示词的建议变成宿主上的强制。更多详情与源码，可访问插件目录页与 GitHub 仓库。
