jilian-dsh/dsh-rules-manager

dsh-rules-manager

license
version
node
topic

规则、命令与技能管理插件 for DeepSeek Harness (DSH)：用 /rules 斜杠命令或设置页「规则、命令与技能」面板，可视化地管理你的用户全局规则（AGENTS.md）、查看全部斜杠命令、创建你自己的自定义命令（支持禁用/启用）、管理技能（查看/禁用/启用/删除进回收站）、备份与一键恢复。

功能一览

| 能力 | 入口 | 说明 |
|---|---|---|
| 规则管理 | /rules 命令 或 设置→规则、命令与技能 | 列出 / 查看 / 新增 / 修改 / 删除 / 禁用 / 恢复用户全局规则（AGENTS.md），保存即生效，每次修改自动备份 |
| 规则体检 | /rules health | 只读检查：条数/分区/自由区域/缺等级/空正文/长正文/重复标题 |
| 命令清单 | 设置→规则、命令与技能 →「命令」 | 只读展示所有可用斜杠命令 |
| 自定义命令 | 设置→规则、命令与技能 →「自定义命令」 | 定义你自己的快捷指令：聊天框输入 /名字，把预设内容发送给 AI 执行；支持带参数：预设里写 {input} 会被替换成你输入的内容，没写则参数自动追加到末尾；支持禁用/启用（禁用后斜杠命令停用、内容保留） |
| 技能管理 | 设置→规则、命令与技能 →「技能」 | 查看已安装技能（名称+简介+全文）、禁用（移出技能目录，内容原样保留）、启用（原样搬回）、删除（移入回收站 ~/.dsh/.backups/trash-/，随时可恢复）；禁用/删除需重启 DSH 后完全生效 |
| 备份与恢复 | 设置→规则、命令与技能 →「备份与恢复」 | 查看所有自动备份（时间 / 规则条数 / 大小），一键恢复到任意备份时刻 |

仓库结构

dsh-rules-manager/             host 插件（纯 Node，无需构建）
├── index.js                   /rules 斜杠命令
├── service.js                 Remote 服务（支撑设置面板）
├── rules-core.js              共享核心：AGENTS.md 解析 / 备份 / 增删改
├── skills-core.js             共享核心：技能目录搬移（禁用/启用/删除进回收站）
└── README.md                  完整使用文档（中文）/ README.en.md（英文）
dsh-rules-manager-client/      client 插件（浏览器 bundle）
├── client.js                  设置页「规则、命令与技能」面板（手写 __ModuleLoader__ bundle）
└── README.md                  面板说明
docs/                          踩坑与反馈记录（DSH message.id 校验不对称 bug：修复 + 官方反馈存档）

快速开始

方式一：bundle 一键安装（推荐）

dsh-rules-manager 是标准 DSH bundle 包（声明 dsh.bundle，自带 cordis.patch.yml），官方插件命令一行安装：

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

重启 DSH → 设置页出现「规则、命令与技能」，聊天框可用 /rules。

方式二：源码拷贝

1. 把 dsh-rules-manager/ 拷贝到 $DSH_HOME/profiles/web/，把 dsh-rules-manager-client/ 拷贝到 $DSH_HOME/profiles/node_modules/；
2. 在 $DSH_HOME/profiles/web/cordis.patch.yml 追加装配（见 dsh-rules-manager/README.md）；
3. 重启 DSH → 设置页出现「规则、命令与技能」，聊天框可用 /rules。

安全

- 每次写入 AGENTS.md 前自动备份到 $DSH_HOME/.backups/（时间戳含毫秒不互相覆盖）；自动保留最近 5 份——超出部分移入回收站（trash-/，可恢复，不永久删除）；打开「备份与恢复」页时也会自动执行一次超额清理；
- 一键恢复双保险：恢复前先把当前文件再自动备份一份，恢复错了也能退回；
- 自定义命令与系统命令同名会被拒绝；命令名限小写字母/数字/连字符/下划线；
- 自定义命令支持参数：预设内容里的 {input} 占位符会被命令后输入的内容替换（可多处使用）；没写 {input} 时参数自动追加到预设末尾（换行分隔）；含 {input} 的命令不带参数会提示用法（不发送残缺内容），不含 {input} 的命令不带参数则只发预设内容（兼容旧行为）。
- 技能管理防乱序设计：技能以目录名为唯一标识，无编号无分区——禁用=整目录移走、启用=原样搬回、删除=整目录进回收站，不存在"插回排序"逻辑，天然不会乱序；同名冲突（启用时目标已存在）会被拒绝，绝不覆盖；技能名仅限字母/数字/连字符/下划线（防路径穿越）。
- 命令禁用防乱序设计：禁用/启用只改 commands.json 条目上的 disabled 字段，不搬移、不改列表顺序。

开发

node dsh-rules-manager/test-service.js   # 服务层断言（隔离环境，含技能/命令禁用）
node dsh-rules-manager/test-local.js     # /rules 命令断言（隔离环境）

许可证
MIT

社区插件，与 DeepSeek Harness 官方仓库相互独立。发现方式：GitHub 话题 dsh-plugin。