前言¶

在 DeepSeek Harness（DSH）裏做智能體開發，全局規則寫在 AGENTS.md，斜槓命令來自各插件，技能裝在 skills/ 目錄。分散編輯時容易漏改、難備份，自定義快捷指令也往往要手改 JSON。dsh-rules-manager 把規則維護、/rules 操作入口、設置頁裏的可視化面板、用戶自定義命令和技能啓停刪收攏到一處；規則改動會先備份再寫入，並與 DSH 熱加載銜接。下面按定位、能力、安裝與用法說明。

這是什麼¶

dsh-rules-manager 是維護者 jilian-dsh 發佈的 DSH 工作流類插件（當前版本 1.7.0，MIT 許可）。它面向「規則 + 命令 + 技能」三件套的本地管理：提供聊天框 /rules 斜槓命令，以及在 DSH 設置中的 「規則、命令與技能」 面板（1.7.0 起設置頁 client 已併入本包，不再需要單獨的 dsh-rules-manager-client）。

規則正文保存在 $DSH_HOME/AGENTS.md（Windows 下 $DSH_HOME 一般爲 %USERPROFILE%\.dsh）。README 說明任何經本插件或 /rules 的修改會實時生效（DSH 自動熱加載），且在每次修改前會自動備份，並支持一鍵恢復到歷史備份時刻。

核心功能¶

規則（AGENTS.md）¶

規則按分區組織，可在面板中全文可視化編輯。刪除後編號不復用，避免引用錯亂。

執行等級¶

每條規則標題可帶執行等級（如 （執行等級：A+D）），決定規則引擎對工具調用的強制程度：A 硬攔違規調用，B 審計與提醒，C 按事件順序拒絕，D 自證說明，M 元規則；可組合。新增規則時若標題未寫等級，會自動補 （執行等級：D）（僅自證、不硬攔）；需要硬攔應在標題中寫明含 A 的等級。與 dsh-rule-engine 聯動時，僅標題帶等級且含 A/C/M 的規則會在工具層硬攔。

自由區域（Free Zone）¶

AGENTS.md 中由 <!-- free-zone:start --> / <!-- free-zone:end --> 框住的區段：模型可讀、正常生效，但規則引擎不解析、不強制。區內條目格式爲 ### [規則 F<n>]。/rules add 會自動插入到 free-zone 標記之前，不會把普通規則加進自由區；新增自由區條目需手動編輯文件（若裝有 rule-engine，需先 /guard unlock）。

命令清單與自定義命令¶

• 命令：只讀展示當前環境可用斜槓命令（名稱 / 說明 / 用法）。
• 自定義命令：在設置頁定義名字與預設內容；聊天框輸入 /名字 即將預設發給 AI。支持禁用 / 啓用（禁用後斜槓不可用、內容保留）。命令名須匹配 /^[a-z][a-z0-9_-]*$/，且不能與系統命令同名。

帶參數時三條規則（README 迭代③）：

1. 預設含 {input} → 參數替換每一處 {input}；無參數時提示用法、不發送殘缺內容。
2. 無 {input} 且有參數 → 參數追加到預設末尾（換行分隔）。
3. 無 {input} 且無參數 → 只發預設本身。

示例：預設 請用一句話總結：{input}，輸入 /summarize 本週工作進展，則發送「請用一句話總結：本週工作進展」。

技能管理¶

在「技能」中查看已安裝技能（名稱、簡介、全文），可禁用（移出技能目錄、內容保留）、啓用（搬回）、刪除（移入 ~/.dsh/.backups/trash-<時間戳>/，可恢復）。README 註明禁用 / 刪除後需重啓 DSH 才能完全生效。

備份與恢復¶

每次修改 AGENTS.md 前備份到 $DSH_HOME/.backups/AGENTS.md-<時間戳>.bak；默認保留最近 5 份，超額備份在打開「備份與恢復」頁時移入回收站。恢復前會再備份當前文件（雙保險）。

技能使用統計與上下文注入¶

插件記錄各技能使用次數（能力參考社區插件 dsh-skill-scoreboard，MIT）。設置頁技能卡片顯示「用過 N 次」；count 爲按會話去重，loads 爲每次成功加載計數。可通過配置 injectEnabled（默認開）、injectTopN（默認 25）、injectMaxChars（默認 4000）控制對話開始前向 agent 注入「技能名 → 路徑」摘要（每 agent 僅注入一次）。只讀接口：GET /api/rules-manager/skill-usage。

安裝與啓用¶

運行環境：Node >= 22；package.json 聲明 dsh 兼容 >=0.1.0-rc.3 <0.3.0-0。

推薦方式爲一鍵 bundle 安裝（web profile）：

dsh plugin --profile web add dsh-rules-manager

安裝後 DSH 會加載包內 cordis.patch.yml，掛載 host 命令與 Remote 服務；重啓 DSH 後設置頁出現「規則、命令與技能」，聊天框可用 /rules。

卸載：

dsh plugin --profile web remove dsh-rules-manager

也可在 $DSH_HOME/profiles/web 下 npm install dsh-rules-manager 並手動改 cordis.patch.yml，或按倉庫 README 拷貝源碼裝配；與 bundle 方式二選一即可。

典型用法¶

聊天框維護規則（| 或全角 ｜ 分隔標題與正文）：

/rules                    列出全部規則
/rules show 2             查看規則 2 全文
/rules add 我的規則｜這是正文  新增規則
/rules edit 2 新正文       修改規則 2 正文
/rules delete 3           刪除規則 3
/rules health             規則體檢（條數、分區、重複標題等）

自由區規則示例：/rules show F1、/rules edit F1 新正文、/rules delete F1（1.4.3 起支持字母編號）。

自定義命令：在設置頁定義 hello = 請熱情地歡迎我，聊天框 /hello 即可觸發。

適用場景與注意¶

適合誰：需要長期維護 DSH 全局規則、想用 GUI 管理禁用項、希望自定義帶 {input} 的快捷指令，或要在不刪文件的前提下禁用 / 回收技能目錄的開發者。

權限與邊界（README 披露）：本插件會讀寫 $DSH_HOME/AGENTS.md、commands.json、disabled-rules.json，並可能移動 $DSH_HOME/skills/ 下目錄；不發起網絡請求、不執行系統子進程、不讀取 API Key 等憑據。自評權限等級爲高，安裝前建議閱讀倉庫「安全設計」並自行審查源碼與 MIT 許可證。插件在當前 DSH 進程權限下運行，與社區目錄 SkillHub 插件頁 一樣，屬於社區生態收錄，並非 DeepSeek / 幻方官方應用商店條目。

已知限制：技能使用統計僅從本插件開始採集後累積；換設備或清空數據目錄會重頭計數；上下文注入每個 agent 只在首次裝載時執行一次。

結尾¶

dsh-rules-manager 把 AGENTS.md 規則、命令清單、自定義斜槓指令和技能目錄操作集中到 /rules 與設置面板，並配上自動備份與恢復，適合作爲 DSH 日常運維規則與工作流的第一站插件。

• 社區目錄：https://www.skillhub.cn/plugins/jilian-dsh/dsh-rules-manager
• 源碼與文檔：https://github.com/jilian-dsh/dsh-rules-manager