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).

Package
dsh-rules-manager
Compatibility
Unverified
Harness peer range
>=0.1.0-rc.3 <0.3.0-0
Cordis peer range
>=4.0.0 <5.0.0
Version
1.7.0
License
MIT
Last updated
Nov 7, 2026

Install

$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
  1. 重启 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.02026-11-07单包双面合并:设置面板 client 并入本包(dsh.client+exports["./client"]);装本包即含设置页,旧 dsh-rules-manager-client 废弃;本包从 projects\oss monorepo 拆为独立仓
1.6.12026-11-060.2.2 适配:服务端无设置页/导航引用,未改码;本版仅版本号变更
1.6.02026-09-14技能列表过滤无 SKILL.md 的目录;新增技能使用次数统计(记分板口径,dsh-skill-scoreboard)与核心资产保护机制——是否保护由技能自声明(其 SKILL.md frontmatter 写 protected: true),面板可标记/取消;修复 CRLF 换行技能描述解析(影响 9 个技能)
1.5.42026-09-07规则 / 命令 / 技能三面板稳定版;技能管理支持查看、禁用/启用、删除进回收站

另:合并上游 PR #1/#2(2026-10-06)带来两处行为修复——typert codec 改用 create() 写法、AGENTS.md 缺失时启动兜底。 更早版本见 git 提交历史。

发行固定源

  • 1.6.0 固定于 main Commit 1a8ff53(git checkout 1a8ff53 可复现 npm dsh-rules-manager@1.6.0 与 GitHub Release v1.6.0 同源代码)。

1.5.4 固定于 main 分支的发布提交(git checkout 可复现 npm dsh-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,按三步迁移:

  1. 删旧依赖:从 profile 依赖里移除 dsh-rules-manager-client;
  2. 装新包:dsh plugin --profile add dsh-rules-manager(1.7.0 已含设置面板,无需另装 client);
  3. 重启 DSH:设置页「规则、命令与技能」随主包加载。