前言¶
DeepSeek Harness (DSH) 的开发者在配置智能体行为时,通常需要在全局配置 (~/.dsh/AGENTS.md) 和项目特定规则之间切换。手动维护这些文件容易产生路径错误或内容冲突。dsh-rule-manager 插件将全局规则编辑、项目规则编辑以及 LLM 自动拆分功能整合到了 Web UI 的「规则管理」入口中,提供了一个统一的操作界面,替代了分散的旧版插件。
功能说明¶
该插件包含以下三个核心功能:
-
全局规则编辑
在插件界面中直接编辑~/.dsh/AGENTS.md。修改保存后,新会话会立即生效;当前会话需在下次进行文件操作后感知变更。 -
项目规则编辑
通过界面选择目标工作区,进而编辑该工作区根目录或子目录下的任意AGENTS.md文件。这比直接在文件系统操作更直观,且便于跨项目管理。 -
LLM 自动拆分
将冗长的项目规则粘贴到界面中,LLM 会将其拆分为「精简总纲」以及按需加载的.dsh/skills/<主题>/SKILL.md。支持覆盖或合并两种模式,在确认写入前会自动备份原文件并提供预览。
安装与启用¶
通过 DSH 的插件命令安装此插件:
dsh plugin --profile web add dsh-rule-manager
安装完成后,重启 dsh web 服务。
典型用法¶
- 打开浏览器中的 设置 → 规则管理。
- 根据需求切换三个标签页:
- 全局规则:编写适用于所有项目的通用指令。
- 项目规则:选择当前工作区,调整项目特定的约束条件。
- 自动拆分:粘贴复杂的项目规则,选择模型,预览拆分结果,确认写入。
注意事项¶
- 升级兼容性:本插件合并了旧版
dsh-global-rules和dsh-rule-splitter的功能。若已安装这两个旧插件,需先卸载它们,再安装本插件,以避免出现多个规则入口。 - 内容限制:单次操作规则内容上限为 256 KiB,超时时间为 180 秒。若规则过长,建议先精简再试。
- 生效机制:插件依赖 DSH 内置的
dsh-agent-instructions进行动态检测。保存后,新会话立即加载新规则,当前会话需等待下一次文件操作才会刷新。 - 技术栈:插件采用零构建方案,Host 端为纯 Node ESM,Client 端为手写
__ModuleLoader__bundle。
结语¶
dsh-rule-manager 通过将文件系统操作与 LLM 能力结合,降低了 DSH 规则维护的门槛。若需查看源码或提交问题,可访问其 GitHub 仓库 或 社区目录。