@deepseek-ai/dsh-rule-manager

DeepSeek Harness (DSH) 规则管理插件 — 用 UI 管理全局和项目规则，自动注入模型指令。

本插件在 DSH 设置页提供带 UI 的规则管理界面，支持全局和项目两个作用域，每条规则一个 .md 文件，保存后自动聚合到 AGENTS.md，由 DSH 原生 agent-instructions 机制自动注入模型 prompt。

✨ 功能特性

功能	说明
📁 每条规则一个文件	rules/*.md，易于维护，可版本控制
🌐 全局规则	存放在 {DSH_HOME}/rules/，对当前 DSH 实例的所有会话生效
📂 项目规则	存放在各工作区的 rules/，只对该工作区的会话生效
🔄 自动聚合	增删改规则后，自动重新聚合到对应的 AGENTS.md
⚡ DSH 原生注入	AGENTS.md 由 DSH 内置机制自动加载，实时生效
🎨 主题适配	支持亮色/暗色主题，使用系统主题 token
🎯 自定义弹窗	新增/删除使用自定义样式弹窗，不依赖浏览器默认样式

🚀 快速开始

安装

# 从 GitHub 安装（推荐）
dsh plugin --profile web add github:lnyanhongyan/dsh-rule-manager

# 从本地 tarball 安装
dsh plugin --profile web add ./deepseek-ai-dsh-rule-manager-0.1.0.tgz

# 从本地目录安装（开发用）
dsh plugin --profile web add ./dsh-rule-manager

重启 DSH

dsh web --port 3081

使用

1. 打开浏览器，进入 DSH Web 界面
2. 点击左侧边栏底部的 设置 图标
3. 在设置面板中找到 规则管理 页面
4. 切换 全局 / 项目 标签
5. 点击 + 新增规则，输入规则名（自动补全 .md）
6. 编辑规则内容，点击 保存
7. 保存后自动聚合到 AGENTS.md，DSH 会自动注入模型指令

📐 文件结构

# 全局规则（对当前 DSH 实例的所有会话生效）
{DSH_HOME}/rules/
  ├── code-style.md       # 代码风格规则
  ├── security.md         # 安全规则
  └── ...

# 项目规则（只对该工作区的会话生效）
{项目目录}/rules/
  ├── code-style.md
  └── ...

# 自动生成的 AGENTS.md（由插件聚合，不要手动编辑）
{DSH_HOME}/AGENTS.md
{项目目录}/AGENTS.md

📝 规则内容格式

每条规则是一个 Markdown 文件，建议以 # 规则名 开头：

# 代码风格

- 使用 2 空格缩进
- 变量命名使用 camelCase
- 使用单引号

如果规则文件不以 # 开头，插件会自动添加 # 文件名 作为标题。

🔧 工作原理

┌─────────────────────────────────────────────────────────┐
│  UI（设置页）                                             │
│  新增/编辑/删除规则                                        │
└─────────────────┬───────────────────────────────────────┘
                  │ HTTP /rules/* 路由
                  ▼
┌─────────────────────────────────────────────────────────┐
│  Host 端                                                  │
│  1. 写入 rules/<name>.md（每条规则一个文件）                 │
│  2. 聚合 rules/*.md → AGENTS.md（按文件名排序）              │
└─────────────────┬───────────────────────────────────────┘
                  │ DSH 原生 agent-instructions 机制
                  ▼
┌─────────────────────────────────────────────────────────┐
│  模型指令注入                                              │
│  - 全局 AGENTS.md → 所有会话                                │
│  - 项目 AGENTS.md → 该项目工作区的会话（按 cwd 区分）          │
└─────────────────────────────────────────────────────────┘

📦 项目结构

dsh-rule-manager/
├── src/
│   ├── index.ts              # Host 端：HTTP 路由 + 聚合逻辑
│   └── client/
│       └── index.ts          # Client 端：设置页 UI
├── lib/
│   ├── index.mjs             # Host ESM 产物
│   ├── index.d.mts           # Host 类型声明
│   └── client.js             # Client __ModuleLoader__ 包
├── cordis.patch.yml          # DSH 安装配置
├── package.json
├── tsconfig.json
├── tsdown.config.ts          # 双端构建配置
├── README.md                 # 本文档
└── DEVELOPMENT.md            # 开发流程总结

🛠️ 开发

# 安装依赖
pnpm install

# 类型检查
pnpm typecheck

# 构建
pnpm build

# 打包（产出 .tgz）
pnpm pack

📋 依赖

包名	版本	用途
@deepseek-ai/cordis	^4.0.1	Cordis 框架
@deepseek-ai/dsh-host-webserver	^0.1.0-rc.7	Host 端 HTTP 路由
@deepseek-ai/dsh-client-runtime	^0.1.0-rc.7	Client 端 slots
@deepseek-ai/dsh-client-ui-slots	^0.1.0-rc.7	Client 端 slot 系统
@deepseek-ai/dsh-client-ui-settings	^0.1.0-rc.7	Client 端设置页
@deepseek-ai/dsh-client-locale	^0.1.0-rc.7	Client 端国际化
react	^18.2.0	React 运行时

❓ 常见问题

Q: 安装后看不到"规则管理"页面？

A: 安装后需要重启 DSH。检查 cordis.patch.yml 是否正确配置。

Q: 项目标签下没有显示我的项目？

A: 确保项目工作区已在 DSH 中注册（通过 dsh web 启动时自动注册）。

Q: 规则修改后没有生效？

A: 检查 AGENTS.md 是否已正确聚合。DSH 原生机制会自动检测变更并注入。

Q: 删除功能不工作？

A: 在某些 Windows 环境下，如果 bash 不在 PATH，删除功能可能受限。插件使用 Node.js unlink 作为备选方案。

Q: 如何卸载？

dsh plugin --profile web remove @deepseek-ai/dsh-rule-manager
# 重启 DSH

📄 许可证

MIT

🤝 贡献

欢迎提交 Issue 和 Pull Request！

# Fork 后克隆
git clone github:你的用户名/dsh-rule-manager

# 创建功能分支
git checkout -b feature/your-feature

# 提交
git commit -m "feat: add new feature"

# 推送
git push origin feature/your-feature

# 创建 Pull Request

🔗 相关资源

• DeepSeek Harness 文档
• DSH 插件开发流程
• GitHub 仓库