jilian-dsh/dsh-rules-manager ↗★ 2
dsh-rules-manager
DeepSeek Harness (dsh) rules, commands & skills manager: /rules slash command, settings panel with visual rule editing, command list, user-defined custom commands (with {input} argument support, disable/enable), skill management (view/disable/enable/delete-to-trash), and backup restore. Installable as an official dsh bundle (single package: host + web client).
설치
npx -p @deepseek-ai/dsh dsh plugin --profile web add dsh-rules-manager使用示例
/rules 列出全部规则
/rules show 2 查看规则 2 全文
/rules add 我的规则|这是正文 新增规则(| 分隔标题和正文,全角半角均可)
/rules edit 2 新正文 修改规则 2 正文
/rules delete 3 删除规则 3(编号不复用)
/rules health 规则体检:统计条数/分区/自由区域,检查缺等级/空正文/长正文/重复标题
自定义命令:设置页定义 hello = "请热情地欢迎我",聊天框输入 /hello 即可触发。
技能使用统计与上下文注入
- 数据:本插件自行采集并存储各技能的使用统计(能力学习自
dsh-skill-scoreboard,MIT)。 - 两种计数:
count=按会话去重(同一会话同一技能只计 1 次);loads=每次成功加载都计。 - 采集方式:
skill工具调用、或read直接读取技能文件,均计一次;同一次调用按callId去重。 - 注入开关:
injectEnabled,默认开。 - 条数上限:
injectTopN,默认 25。 - 字符上限:
injectMaxChars,默认 4000;超限逐行截断,末行提示「(其余 N 个 skill 已省略)」。 - 频次与空数据:注入挂在
agent/pre-step,每个 agent 仅注入一次;无数据时不注入。 - 接口:
GET /api/rules-manager/skill-usage返回{ ok, skills: [{ name, count, loads, lastUsedAt }], total, totalLoads }。
在 $DSH_HOME/profiles/web 目录下安装(或你配置的插件目录)
npm install dsh-rules-manager
然后在 `$DSH_HOME/profiles/web/cordis.patch.yml` 装配(见下方「DSH 插件装配三步」第 2 步,host 引用改成 npm 包名),重启 DSH 即可。
> 注:npm 包与下方「拷贝」方式内容一致,二选一即可;DSH 依赖(`@deepseek-ai/*`)会自动按 peerDependencies 解析。
### 方式三:源码拷贝(DSH 插件装配三步)
本仓库包含两个包,都需要装配:
1. **拷贝**:把 `dsh-rules-manager/` 放到 `$DSH_HOME/profiles/web/` 下;
2. **装配**:在 `$DSH_HOME/profiles/web/cordis.patch.yml` 追加:
```yaml
- insert:
- id: rules-manager
name: './rules-manager/index.js'
- id: rules-manager-service
name: './rules-manager/service.js'
- id: 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 解析 / 备份 / 增删改
├── index.js host 面占位入口
└── client.js 设置页「规则、命令与技能」面板(手写 __ModuleLoader__ bundle)
- host 端定位 home 用
@deepseek-ai/dsh-home-paths的resolveDshHome(); - client→host 通过 Typert Remote:
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.7.0 | 2026-11-07 | 单包双面合并:设置面板 client 并入本包(dsh.client+exports["./client"]);装本包即含设置页,旧 dsh-rules-manager-client 废弃;本包从 projects\oss monorepo 拆为独立仓 |
| 1.6.1 | 2026-11-06 | 0.2.2 适配:服务端无设置页/导航引用,未改码;本版仅版本号变更 |
| 1.6.0 | 2026-09-14 | 技能列表过滤无 SKILL.md 的目录;新增技能使用次数统计(记分板口径,dsh-skill-scoreboard)与核心资产保护机制——是否保护由技能自声明(其 SKILL.md frontmatter 写 protected: true),面板可标记/取消;修复 CRLF 换行技能描述解析(影响 9 个技能) |
| 1.5.4 | 2026-09-07 | 规则 / 命令 / 技能三面板稳定版;技能管理支持查看、禁用/启用、删除进回收站 |
另:合并上游 PR #1/#2(2026-10-06)带来两处行为修复——typert codec 改用
create()写法、AGENTS.md缺失时启动兜底。 更早版本见 git 提交历史。
发行固定源
- 1.6.0 固定于 main Commit
1a8ff53(git checkout 1a8ff53可复现 npmdsh-rules-manager@1.6.0与 GitHub Release v1.6.0 同源代码)。
1.5.4 固定于 main 分支的发布提交(
git checkout可复现 npmdsh-rules-manager@1.5.4与 GitHub Release v1.5.4 同源代码)。发布 commit 由发布脚本在三通道完成后自动回填。
🙏 致谢
- 技能使用统计能力学习自 dsh-skill-scoreboard:作者 EIGHTfs,MIT 许可。
- 感谢 FoolishWiser 对规则与命令管理的贡献(PR #1、PR #2,2026-10-06 合入)。
📄 许可证
MIT。版权 (c) 2026 dsh-rules-manager contributors。
本项目为社区插件,与 DeepSeek Harness 官方仓库相互独立。发现方式:GitHub 话题 dsh-plugin。
🔁 从旧版迁移(1.7.0 起单包)
若你此前装过 dsh-rules-manager-client,按三步迁移:
- 删旧依赖:从 profile 依赖里移除
dsh-rules-manager-client; - 装新包:
dsh plugin --profile add dsh-rules-manager(1.7.0 已含设置面板,无需另装 client); - 重启 DSH:设置页「规则、命令与技能」随主包加载。