dsh-rules-manager
DeepSeek Harness (dsh) 规则、命令和技能管理器：/rules 斜杠命令、支持可视化编辑规则的设置面板、命令列表、用户自定义命令（支持 {input} 参数、禁用/启用）、技能管理（查看/禁用/启用/删除）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-rules-manager@1.6.0Rules Manager 以 dsh-rules-manager 发布，当前版本为 1.6.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness（DSH）的规则、命令与技能管理插件：/rules 斜杠命令 + 设置页**「规则、命令与技能」面板**（可视化编辑规则、查看命令清单、自定义你自己的命令（支持禁用/启用）、管理技能（查看/禁用/启用/删除进回收站）、备份与一键恢复）。
⚡ 规则保存在
$DSH_HOME/AGENTS.md，任何修改实时生效（DSH 自动热加载），每次修改前自动备份，可随时一键恢复到任意备份时刻。当前版本 1.6.0（技能列表过滤无
SKILL.md的目录；技能卡片新增「用过 N 次／未使用」徽章与「⚠️ 核心」保护标记及开/关按钮；修正 CRLF 格式技能描述解析）。
| 能力 | 入口 | 说明 |
|---|---|---|
| 列出 / 查看 / 新增 / 修改 / 删除 / 禁用 / 恢复规则 | /rules 命令 或 设置→规则、命令与技能 | 规则 = 用户全局规则（AGENTS.md），按分区组织，全文可视化编辑 |
| 命令清单 | 设置→规则、命令与技能 →「命令」 | 只读展示所有可用斜杠命令（名称/说明/用法） |
| 自定义命令 | 设置→规则、命令与技能 →「自定义命令」 | 你自己定义快捷指令：在聊天框输入 /名字，把预设内容发送给 AI 执行；支持带参数（见下）；支持禁用/启用（禁用后斜杠命令停用、内容保留、随时恢复）；预设内容较长时默认收起，点「详情」展开 |
| 技能管理 | 设置→规则、命令与技能 →「技能」 | 查看已安装技能（名称+简介+全文）、禁用（移出技能目录，内容原样保留）、启用（原样搬回）、删除（移入回收站 ~/.dsh/.backups/trash-<时间戳>/，随时可恢复）；禁用/删除需重启 DSH 后完全生效 |
| 备份与恢复 | 设置→规则、命令与技能 →「备份与恢复」 | 查看所有自动备份（时间 / 规则条数 / 大小），一键恢复到某个备份时刻；打开本页时自动把超出的旧备份移入回收站（保留最近 5 份） |
/rules 列出全部规则
/rules show 2 查看规则 2 全文
/rules add 我的规则｜这是正文 新增规则（｜ 分隔标题和正文，全角半角均可）
/rules edit 2 新正文 修改规则 2 正文
/rules delete 3 删除规则 3（编号不复用）
/rules health 规则体检：统计条数/分区/自由区域，检查缺等级/空正文/长正文/重复标题
自定义命令：设置页定义 hello = "请热情地欢迎我"，聊天框输入 /hello 即可触发。
每条规则的标题末尾写着执行等级，例如 ### [规则 9] PS 编码与命令执行（执行等级：A+D）。它决定规则被机器强制执行的程度：
| 等级 | 含义 | 机器行为 |
|---|---|---|
| A | 硬拦 | 违反规则的工具调用被直接拒绝（模型无法自行绕过） |
| B | 纠察 | 检测到违规文本时审计留痕 + 注入提醒 |
| C | 时序 | 按事件顺序判定，违规拒绝（如先授权后操作） |
| D | 自证 | 需要你（或 AI）自证说明，不硬拦 |
| M | 元规则 | 管规则本身的规则 |
A+D = 硬拦 + 自证）。（执行等级：D） 并提示——D 级只是自证提示、不会硬拦。想要硬拦效果，请在标题里写 （执行等级：A）（可带其他等级组合）。命令名后面可以跟参数，参数会拼进预设内容再发给 AI。规则 3 条：
{input} → 参数整体替换到每个 {input} 位置（可多处使用）；该命令不带参数时会提示用法，不发送残缺内容；{input} 且有参数 → 参数自动追加到预设内容末尾（换行分隔）；{input} 且不带参数 → 只发预设内容本身（和之前行为完全一致，老命令不受影响）。预设：请用一句话总结：{input}
输入：/summarize 本周工作进展
发送：请用一句话总结：本周工作进展
预设：请生成周报
输入：/weekly-report 本月收入 5 万
发送：请生成周报
本月收入 5 万 ← 参数自动追加到末尾
预设：请热情地欢迎我
输入：/hello ← 不带参数
发送：请热情地欢迎我
AGENTS.md 支持一个自由区域：被 <!-- free-zone:start --> / <!-- free-zone:end --> 注释标记框住的区段。模型可读、正常生效，但规则引擎（dsh-rule-engine）不解析、不强制（不硬拦、不审计、不进 /guard rules）——适合放"想生效但不想被机器强制"的软约束、第三方守则（如法律工作守则）等。
### [规则 F<n>]（F = Free 前缀，如 F1、F2），禁止使用主编号 ### [规则 N]；/rules list 与设置页「规则」中以独立「自由区域」分组展示，可编辑 / 禁用 / 删除（与普通规则操作一致）；/rules add 自动插入到 free-zone:start 之前，不会掉进自由区；free-zone:start/end 标记内写 ### [规则 F2] 格式；/rules show F1、/rules edit F1 新正文、/rules delete F1（1.4.3 起支持字母编号）。/rules add 不能把规则加进自由区域（这是刻意设计，防止普通规则掉进"引擎不强制"的区域）。请按下面三步操作：
若装有 dsh-rule-engine：先在聊天框输入 /guard unlock（AGENTS.md 受写保护，unlock 默认放行 10 分钟，钥匙只在用户手里）；
用记事本打开 $DSH_HOME/AGENTS.md（$DSH_HOME 即本机 DSH 数据目录，Windows 默认 %USERPROFILE%\.dsh），拉到文件末尾，找到 <!-- free-zone:start --> 和 <!-- free-zone:end --> 两行标记，在两行之间按下面格式粘贴（编号从 F2 开始顺延，F1 已被示例占用，不能与已有编号重复）：
### [规则 F2] 你的守则标题
守则正文内容（想写多行就多写几行）。
保存文件——立即生效，无需重启。也可以直接让 AI 助手帮你写（同样先 /guard unlock）。
注意：不要把内容写在 free-zone 标记之外，否则会被规则引擎按普通规则解析（不带执行等级则不会硬拦，但会进 /guard rules 清单）。
$DSH_HOME/.backups/AGENTS.md-<时间戳>.bak，时间戳含毫秒，同一秒内连续操作也不会互相覆盖；.backups/trash-<时间戳>/，可恢复，不永久删除）。打开「备份与恢复」页时也会自动执行一次超额清理；/^[a-z][a-z0-9_-]*$/）；{input} 占位符会被命令后输入的内容替换（可多处使用）；没写 {input} 时参数自动追加到预设末尾（换行分隔）；含 {input} 的命令不带参数会提示用法（不发送残缺内容），不含 {input} 的命令不带参数则只发预设内容（兼容旧行为）。commands.json 条目上的 disabled 字段，不搬移、不改列表顺序。面向插件商城（DSH STORE）自动审核与安装者；普通用户可跳过。 声明原则：只陈述实际能力，不因申请自动上架而省略或弱化。
$DSH_HOME/AGENTS.md（规则文件）与 $DSH_HOME/commands.json、$DSH_HOME/disabled-rules.json（自定义命令与禁用状态）；技能管理对 $DSH_HOME/skills/ 下的技能目录做重命名/移动（禁用=移出、启用=移回、删除=移入 .backups/trash-<时间戳>/，可恢复）；规则修改前自动备份到 $DSH_HOME/.backups/AGENTS.md-<时间戳>.bak。与规则引擎联动展示时只读 rule-engine-tools.json / rule-engine.log.jsonl（服务面板）。/rules）数据操作。dsh-rules-manager-client（配套设置面板 UI，与主包同仓库、同发布）；peer 依赖 @deepseek-ai/cordis、@deepseek-ai/dsh-home-paths、@deepseek-ai/dsh-typert-protocol（DSH 官方运行时接口）。package.json 无安装期生命周期脚本（无 preinstall/install/postinstall/prepare）。id（严重，已修复）：早期版本自定义命令投递给 AI 的用户消息缺 id 字段，会写坏 DSH 会话日志、锁死整个会话历史（history unavailable … lacks an identified message）。修复：消息补 id: randomUUID()，测试已加 id 断言。agent.followup→inbox.splice、session.append）对消息 id 零校验，加载路径（Session.fromRestore → assertMessageEventShape）严格校验——不对称导致坏数据落盘后整会话拒载。已反馈官方：https://github.com/deepseek-ai/deepseek-harness/discussions/1121docs/dsh-session-message-id-bug.md。dsh-rules-manager 是符合官方规范的 bundle 包（package.json 声明 dsh.bundle，包内自带 cordis.patch.yml），可通过官方插件命令一键安装：
dsh plugin --profile web add dsh-rules-manager
dsh 会自动：安装本包及其依赖（含配套面板 dsh-rules-manager-client）、把本包追加进该 profile 的 dsh.profile.bundles、加载包内 cordis.patch.yml 挂载三个插件行（host 命令 / Remote 服务 / client 面板）。重启 DSH 后设置页出现「规则、命令与技能」，聊天框可用 /rules。
卸载：
dsh plugin --profile web remove dsh-rules-manager
本 bundle 同时满足插件市场（如 DSH Creative Workshop 类目录）的
dsh.bundle.patch结构验证收录条件。
本插件发布在 npm，包名 dsh-rules-manager（配套面板 dsh-rules-manager-client）：
# 在 $DSH_HOME/profiles/web 目录下安装（或你配置的插件目录）
npm install dsh-rules-manager dsh-rules-manager-client
然后在 $DSH_HOME/profiles/web/cordis.patch.yml 装配（见下方「DSH 插件装配三步」第 2 步，host 引用改成 npm 包名），重启 DSH 即可。
注：npm 包与下方「拷贝」方式内容一致，二选一即可；DSH 依赖（
@deepseek-ai/*）会自动按 peerDependencies 解析。
本仓库包含两个包，都需要装配：
拷贝：把 dsh-rules-manager/ 放到 $DSH_HOME/profiles/web/ 下；把 dsh-rules-manager-client/ 放到 $DSH_HOME/profiles/node_modules/ 下；
装配：在 $DSH_HOME/profiles/web/cordis.patch.yml 追加：
- insert:
- id: rules-manager
name: './rules-manager/index.js'
- id: rules-manager-service
name: './rules-manager/service.js'
- id: rules-manager-client
name: 'dsh-rules-manager-client'
重启 DSH（Electron 窗口 ✕ → 重新打开）。设置页出现「规则、命令与技能」，聊天框可用 /rules。
说明：client 包必须放在
profiles/node_modules/（DSH 的 client 插件发现机制按 npm 包名解析）；依赖通过profiles/node_modules的 junction 森林解析 DSH 自带包。
dsh-rules-manager/ host 插件（纯 Node，无需构建）
├── index.js /rules 斜杠命令（聊天框管理规则）
├── service.js Remote 服务（TypertRemoteService，供设置面板调用）
├── rules-core.js 共享核心：AGENTS.md 解析 / 备份 / 增删改
dsh-rules-manager-client/ client 插件（浏览器 bundle）
├── index.js host 面占位入口
└── client.js 设置页「规则、命令与技能」面板（手写 __ModuleLoader__ bundle）
@deepseek-ai/dsh-home-paths 的 resolveDshHome()；ctx.remote.$mount({package, descriptors}) + ctx.get("remote.rulesManager")；invocation.agent.followup(message) 把预设内容投递给 AI（官方投递通道）。node test-service.js # 101 项断言：Remote 标记 + 规则 CRUD + 用户命令（含参数）+ 备份恢复（隔离环境）
node test-local.js # 33 项断言：/rules 命令全场景（含规则体检，隔离环境）
两个测试都用临时 DSH_HOME + AGENTS.md 副本，不触碰真实文件。
| 版本 | 日期 | 要点 |
|---|---|---|
| 1.6.0 | 2026-09-14 | 技能列表过滤无 SKILL.md 的目录；新增技能使用次数统计（记分板口径，dsh-skill-scoreboard）与核心资产保护机制——是否保护由技能自声明（其 SKILL.md frontmatter 写 protected: true），面板可标记/取消；修复 CRLF 换行技能描述解析（影响 9 个技能） |
| 1.5.4 | 2026-09-07 | 规则 / 命令 / 技能三面板稳定版；技能管理支持查看、禁用/启用、删除进回收站 |
更早版本见 git 提交历史。
77cca8d（git checkout 77cca8d + 发布 bump 可复现 npm dsh-rules-manager@1.6.0 与 GitHub Release v1.6.0 同源代码）。注：release 提交号由发布脚本自动回填。1.5.4 固定于 main 分支的发布提交（
git checkout <hash>可复现 npmdsh-rules-manager@1.5.4与 GitHub Release v1.5.4 同源代码）。发布 commit 由发布脚本在三通道完成后自动回填。
MIT。版权 (c) 2026 dsh-rules-manager contributors。
本项目为社区插件，与 DeepSeek Harness 官方仓库相互独立。发现方式：GitHub 话题 dsh-plugin。