jilian-dsh/dsh-rule-engine

README 摘要

dsh-rule-engine DSH 规则执行引擎 v3 的插件实现。它把 /.dsh/AGENTS.md 当作唯一真相源，自动解析规则四要素与执行等级，再通过「工具守卫 + 文本检测 + 时序检查 + 审计台账」执行用户规则，而不是内置一套与用户无关的安全清单。 项目背景 这个项目来自一个非常具体的个人需求： - 作者是 零编程基础 用户，但极其重视规则的制定、执行、遵守与复盘。 - 作者发现：规则如果只写在文本里、靠模型“自觉”执行，会反复失效（例如时间词写错、内联命令违规、交付前漏验证等）。 - 因此核心思路是： 规则的执行不能只靠自觉，要尽量靠插件在机制层强制 。 - 本插件所有规则均从 AGENTS.md 动态解析，规则增删改后无需重写插件。 当前实现基于已有的 AGENTS.md 规则体系拓展，社区暂无类似插件供参考（大概率为该等约束可能限制开发自由性，不适用于专业编程人员）， 可能存在大量不完备、误判或边界问题 。欢迎任何使用者提出调整建议、提交 issue 或 PR。项目仍处于“可运行但需要持续打磨”的阶段。 功能分层 - 阶段 1 容器：解析 AGENTS.md 全部规则 → 理解产物（ rule-understanding.json 可生成） - 阶段 2 匹配机 + 工具守卫 + 文本检测 - 阶段 3 时序检查 + 授权询问集成 - 阶段 4 D 级自证调度 + /guard 命令完善 当前实现以「模式库兜底」为主，LLM 理解器预留扩展点；所有规则均从 AGENTS.md 实时解析。 任务契约与反过度工程（可选） - 默认 关闭 ；可在规则引擎设置页开启「任务边界与反过度工程」总开关。 - 开启后默认 观察模式 ，只审计提醒；切到 armed 才真正拦截。 - 弹窗询问默认 关闭 ； askEnabled 开启后，对依赖/hash 等动作走官方 approval 询问。 - 支持 /guard mode budget contract label 命令。 命令 命令 作用 /guard status 引擎状态（规则数/置信度/放行/解锁） /guard rules 规则清单 + 理解产物 /guard active 最近激活了哪些规则、为什么 /guard log [N] 最近 N 条审计 /guard unlock [N] 解锁配置写保护 N 分钟（仅用户） /guard bypass [N] 临时整体放行 N 分钟（仅用户） /guard lock 立即恢复全部守卫（取消解锁/放行） /guard revoke 撤销全部授权记录 /guard reload 强制重解析 AGENTS.md /guard mode 设置任务契约模式（review/answer/change/monitor/watch/off） /guard bu…

分类