前言¶

在 DSH 這類智能體工作流裏，規則如果只寫在文檔中，執行往往依賴模型自覺。dsh-rule-engine 是 DSH 規則執行引擎 v3 的插件實現，它把 ~/.dsh/AGENTS.md 當作唯一真相源，自動解析規則並執行。下面介紹它的定位、可用命令和安裝方式。

這是什麼¶

dsh-rule-engine 由 jilian-dsh 維護，許可證爲 MIT。它不內置一套與用戶無關的安全清單，而是以 ~/.dsh/AGENTS.md 爲唯一真相源解析規則，並通過工具守衛、文本檢測、時序檢查與審計臺賬執行規則。

該插件的核心思路是：規則寫在 AGENTS.md 裏，插件負責讓這些規則在運行態被檢查、執行和記錄；規則動態解析後，規則增刪改不需要重寫插件。

下面是已列出的主要能力：

當環境裏沒有 AGENTS.md 時，資料說明引擎爲零錯加載、零規則、零誤攔。

資料給出的安裝命令是：

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

這條命令使用了 --profile web；資料沒有說明該命令是否適用於所有 profile。

另一種方式是手動將 dsh-rule-engine 加入目標 profile 的 dsh.profile.bundles 數組。

該插件按 bundle 規範打包，包內的 cordis.patch.yml 會自動掛載插件行，示例如下：

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

規則正文可以通過註釋綁定執行器：

<!-- handler: xxx -->

也可以在插件配置中使用 handlerOverrides 顯式綁定執行器。

安裝並啓用後，可以用 /guard 命令查看引擎狀態、規則清單和審計日誌：

/guard status
/guard rules
/guard log [N]

如果插件自身配置或理解產物需要被寫入，資料說明直接 edit/write 會被守衛拒絕，需要先使用 /guard unlock。

任務契約與反過度工程模式默認關閉。開啓後默認是觀察模式，只有切到 armed 才真正攔截。彈窗詢問默認關閉；askEnabled 開啓後，對依賴/hash 等動作走官方 approval 詢問。

需要注意：修改插件 lib 代碼後必須重啓 DSH 才生效。資料還提到，bundle 裝配下 dev_reload_package 熱重載不可靠。

這個插件適合有 ~/.dsh/AGENTS.md 規則集、希望規則執行不只依賴模型自覺的使用者。如果你只是臨時使用 DSH，並不維護一份需要機器執行的規則文件，它帶來的收益會有限。

使用前建議注意以下幾點：

項目資料自述可能存在大量不完備、誤判或邊界問題，仍處於可運行但需要持續打磨階段。
插件自身配置/理解產物對模型只讀，直接 edit/write 會被守衛拒絕，需 /guard unlock。
修改插件 lib 代碼後必須重啓 DSH 生效；bundle 裝配下 dev_reload_package 熱重載不可靠。
運行要求 node >=22。
dshCompat 範圍爲 min 0.1.0-rc.3 max 0.2.0。
插件會以當前 DSH 進程權限運行，安裝前應檢查源碼、配置項和許可證。許可證標註爲 MIT，但資料中未完整展示 LICENSE 文件內容，建議以倉庫實際文件爲準。

dsh-rule-engine 的價值，是把 AGENTS.md 中的規則從“文檔約定”變成插件層可檢查、可審計、可執行的對象。它對有明確規則管理需求、並且願意維護 AGENTS.md 的 DSH 使用者比較合適。

目錄頁：https://www.skillhub.cn/plugins/jilian-dsh/dsh-rule-engine

GitHub：https://github.com/jilian-dsh/dsh-rule-engine