前言¶
DeepSeek Harness（DSH）支持通过 ~/.dsh/AGENTS.md 配置全局规则，让每次会话都继承同一套指令。这条路径对熟悉终端的开发者不难，但在 Web 端使用时，改规则往往要切回编辑器或终端，打断当前工作流。
dsh-global-rules 把这件事收进 DSH Web 的「设置」面板：打开标签页即可读取、编辑并保存 AGENTS.md，不必离开浏览器。下面介绍它的定位、能力与安装用法。
这是什么¶
dsh-global-rules 是 DSH 社区插件，由 badai147 维护，分类为客户端插件。它在 DeepSeek Harness Web 设置面板中新增「全局规则」页面，直接读写 ~/.dsh/AGENTS.md。
插件本身不实现规则热重载逻辑，而是依赖 DSH 内置的 dsh-agent-instructions 插件对 user-global scope 做动态检测。保存后，新会话立即按新内容执行；当前会话在下次文件系统工具调用后感知变更。
核心功能¶
根据 GitHub README 与 package.json，已核实的能力如下：
- 设置页新增「全局规则」标签：打开即加载
~/.dsh/AGENTS.md当前内容 - 编辑并保存，实时生效：新会话首次步骤直接读取新内容；当前会话在下次文件操作后，DSH 注入
Updated instructions from: ~/.dsh/AGENTS.md，模型按新规则执行 - 文件不存在时自动创建：首次保存会创建
~/.dsh/AGENTS.md - 零构建：Client 端为手写
__ModuleLoader__bundle，Host 端为纯 Node ESM
工作原理¶
插件分 Host 与 Client 两层：
- Host（
lib/index.js）：注册GET /global-rules（读文件）与POST /global-rules（写文件，含同源校验与 256 KiB 上限）两个 HTTP 路由 - Client（
lib/client.js）：通过window.__ModuleLoader__.loadbundle，在settings.section注册「全局规则」页面 - 生效机制：由 DSH 内置
dsh-agent-instructions覆盖user-globalscope 的动态检测，插件无需自行热重载
目录结构：
dsh-global-rules/
├── cordis.patch.yml # bundle patch：插入 global-rules 层
├── lib/
│ ├── index.js # Host：HTTP 路由（Node ESM）
│ └── client.js # Client：设置页 UI（__ModuleLoader__ bundle）
└── package.json
安装与启用¶
先做插件安装，再重启 Web 服务。
从 DSH 插件目录安装：
dsh plugin --profile web add dsh-global-rules
从 GitHub 源安装（备选）：
dsh plugin --profile web add github:badai147/dsh-global-rules
安装完成后重启 dsh web，在界面中打开 设置 → 全局规则 即可使用。
典型用法¶
- 打开 设置 → 全局规则
- 编辑规则内容（Markdown 格式，与
AGENTS.md语法一致） - 点击「保存」
保存后的生效方式：
- 新会话：首次步骤直接读取新内容，立即生效
- 当前会话：下一次文件系统工具调用后，DSH 检测到文件变化并注入更新提示，模型按新规则执行
适用场景与注意¶
适合谁
- 主要用 DSH Web 界面、希望集中管理全局指令的开发者
- 需要为所有会话统一编码风格、回复语言或项目约束，且不想频繁切终端编辑
AGENTS.md的用户
使用前注意
- 插件以当前
dsh进程权限读写~/.dsh/AGENTS.md；安装前建议查看 源码 与 MIT 许可证 - 写入有 256 KiB 上限；规则内容应保持精简
- 本插件来自 DSH 社区目录 SkillHub，与 DeepSeek / 幻方无官方从属关系
结尾¶
dsh-global-rules 把全局规则编辑收进 Web 设置面板，配合 DSH 内置的动态检测，让 AGENTS.md 的维护与 Web 工作流对齐。若你已在用 DSH Web，可按上文命令安装，在设置里直接管理全局规则。
