前言¶
DeepSeek Harness (DSH) 强调“一切皆插件”的扩展理念。在多项目协作中，开发者常需要在每个对话中重复粘贴相同的“项目规范”、“代码风格”或“注意事项”作为系统提示词。mycodesite/dsh-rules（RuleBase）插件通过文件驱动的方式，将这些规矩固化，实现“一处编写，处处生效”。
这是什么¶
mycodesite/dsh-rules 是一个工作流插件。它支持全局和项目两级 Markdown 规则文件，在每次对话开始或系统提示词组装时自动注入给 AI。规则文件以 .md 格式持久化，通过文件监听机制实现即时生效，无需重启 DSH。插件在 DSH 设置面板提供了可视化的规则管理界面。
核心功能¶
- 全局 + 项目两级注入：全局规则（默认路径
~/.dsh/rules）管理所有项目共用的规范；项目规则（<cwd>/.dsh/rules）跟随当前工作目录（cwd），切换项目时自动应用对应规则。 - 文件监听，即时生效：规则文件保存后立即被捕获，下一次模型请求自动采用，无需重启。
- 可视化规则管理：在 DSH 设置面板的“规则”区可直接增删改查规则、一键刷新，操作结果即时可见。
- 运行时零依赖：插件仅对宿主依赖使用编译期类型依赖（
import type），转译后擦除。运行时不需要node_modules，任意新环境均可直接运行。
安装与启用¶
本插件需要 DeepSeek Harness >= 0.1.5-rc.1 以及 Node.js >= 22.5。
# 通过 GitHub 源安装
dsh plugin add github:mycodesite/dsh-rules
# 指定版本
dsh plugin add github:mycodesite/dsh-rules#v0.1.7
典型用法¶
- 编写规则文件：在项目根目录创建
.dsh/rules目录，或在全局~/.dsh/rules下创建.md文件（文件名作为规则 ID）。 - 配置规则：在 DSH 设置面板的“规则”区查看已识别的文件。如果未选中项目，请先开启一个项目对话。
- 应用规则：切换到指定项目的对话中，全局规则与项目规则会自动组装并注入到系统提示词中。
适用场景与注意¶
- 注意同名风险：不要在插件市场更新本插件。npm 上存在同名项目，安装该包会导致 DeepSeek Harness 无法启动。请始终通过下文 GitHub 源或本地 tarball 安装。
- 全局路径：默认全局规则路径为
~/.dsh/rules。若设置了环境变量DSH_HOME，则规则跟随该变量。 - 版本兼容：本插件适配了 DSH >= 0.1.5-rc.1 的
rpc.handle两参化与鉴权机制。
结语¶
RuleBase 让 AI 助手成为“懂你项目规矩的协作者”。通过文件驱动的规则注入，它消除了重复的口头交代，将项目规范固化为可管理的配置。详细文档与源码请参考 GitHub 仓库。
