dsh-rules-manager

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-rules-manager

![license](https://img.shields.io/github/license/jilian-dsh/dsh-rules-manager)
![version](https://img.shields.io/badge/version-1.4.2-blue)
![node](https://img.shields.io/badge/node-%3E%3D22-green)
![topic](https://img.shields.io/badge/topic-dsh--plugin-blue)

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

[English](dsh-rules-manager/README.en.md) | 中文

## 功能一览

| 能力 | 入口 | 说明 |
|---|---|---|
| 规则管理 | `/rules` 命令 或 设置→规则、命令与技能 | 列出 / 查看 / 新增 / 修改 / 删除 / **禁用 / 恢复**用户全局规则（AGENTS.md），**保存即生效**，每次修改**自动备份** |
| 命令清单 | 设置→规则、命令与技能 →「命令」 | 只读展示所有可用斜杠命令 |
| 自定义命令 | 设置→规则、命令与技能 →「自定义命令」 | 定义你自己的快捷指令：聊天框输入 `/名字`，把预设内容发送给 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`），官方插件命令一行安装：

```sh
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` 字段，不搬移、不改列表顺序。

## 开发

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

## 许可证

[MIT](dsh-rules-manager/LICENSE)

---

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