jilian-dsh/dsh-rule-engine

dsh-rule-engine

项目背景

这个项目来自一个非常具体的个人需求：

• 作者是零编程基础用户，但极其重视规则的制定、执行、遵守与复盘。
• 作者发现：规则如果只写在文本里、靠模型“自觉”执行，会反复失效（例如时间词写错、内联命令违规、交付前漏验证等）。
• 因此核心思路是：规则的执行不能只靠自觉，要尽量靠插件在机制层强制。
• 本插件所有规则均从 AGENTS.md 动态解析，规则增删改后无需重写插件。

当前实现基于已有的 AGENTS.md 规则体系拓展，社区暂无类似插件供参考（大概率为该等约束可能限制开发自由性，不适用于专业编程人员），可能存在大量不完备、误判或边界问题。欢迎任何使用者提出调整建议、提交 issue 或 PR。项目仍处于“可运行但需要持续打磨”的阶段。

这是什么

DSH 规则执行引擎 v3 的插件实现。它把 ~/.dsh/AGENTS.md 当作唯一真相源，自动解析规则四要素与执行等级，再通过「工具守卫 + 文本检测 + 时序检查 + 审计台账」执行你的规则——不是内置一套与用户无关的安全清单。

四层骨架：

1. 容器：解析 AGENTS.md 的全部规则（可生成理解产物）；
2. 匹配机 ＋ 工具守卫 ＋ 文本检测：判断某次动作落在哪条规则上；
3. 时序检查 ＋ 授权询问：把“什么时候做的”纳入判定，必要时弹窗询问；
4. 自证调度 ＋ 命令面：对语义类规则做自证提示，并提供 /guard 命令。

规则全部从 AGENTS.md 实时解析，规则增删改后无需重写插件。语义类判定按「词表只产嫌疑 → 模型裁决确认」两段走：只有裁决确认为违规才提醒；无真实用户消息的回合不检测、不投递。

当前版本

0.6.6（以 package.json 的 version 为准）。

使用指引

安装

本插件已按官方 bundle 规范打包，包内自带 cordis.patch.yml。推荐：

dsh plugin --profile web add dsh-rule-engine

或手动把 dsh-rule-engine 加入 profile 的 dsh.profile.bundles 数组，包内 cordis.patch.yml 会自动挂载插件行：

- insert:
    - id: dsh-rule-engine
      name: 'dsh-rule-engine'

从源码手动调试时也可以沿用 insert 方式挂载；正式安装建议走 bundle。

最低准备

• 一份规则文件：~/.dsh/AGENTS.md（或你的 DSH_HOME 下的同名文件）。没有它也能用——引擎零错加载、零规则、零误拦。
• Node.js >=22（见 package.json 的 engines）。
• 无运行时依赖；两个 peer 依赖由 DSH 侧提供。

何时需要配置

默认零配置即可用。 只有下面两类需求才需要写 ~/.dsh/rule-engine.json：

• 想让引擎懂你的语言习惯（例如把中文词当作许可词、动作词）；
• 想启用本机专属集成（统一入口脚本保护、手册/技能豁免、记忆沉淀链、追加受保护文件）。

配置在插件启动时读取；改完保存后重载插件（或重启 DSH）生效。命令面见下一章。

配置

两轨：通用层与个人层

一句话：代码里只有机制；中文与本机专属设置都写在 rule-engine.json。

键的取值语义

• 键缺省（不写）→ 用内置默认（通用最小集）；
• 键存在 → 按键完全替换（不做合并，配置即真相）；
• 写 {} 或删键 → 回退内置默认。

个人层能配什么（示例一律占位名）

{
  "lexicons": {
    "approval": "确认|同意|可以",
    "action_words": "执行|落盘|部署"
  },
  "patterns": {
    "time_words": "今天|昨天|刚才",
    "self_cert_hints": { "example": "占位词一|占位词二" }
  },
  "criticismPersonal": ["示例词一", "示例词二"],
  "localIntegrations": {
    "entryScript": "your-entry-script.mjs",
    "protectedFiles": ["skills/your-manual/SKILL.md"],
    "m8": { "enabled": true, "entryMarker": "your-entry-script.mjs" },
    "manualExempt": {
      "skills": ["your-manual", "your-planner"],
      "paths": ["your-manual/SKILL.md"]
    }
  },
  "qualityLedger": { "enabled": true, "window": 5 }
}