dsh-agent-rules
Verifieddsh-agent-rules · v0.1.1 · MIT · Web UI
DeepSeek Harness 全局规则面板:在设置页统一管理长期生效的预设规则,渲染进 ~/.dsh/AGENTS.md,由 DSH 内置指令加载器在每个新会话注入。
Install
dsh plugin add dsh-agent-rules Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-agent-rules
DeepSeek Harness 插件:在设置里加一页 规则与记忆,把长期生效的预设规则收在一个列表里统一管理。
规则渲染进 ~/.dsh/AGENTS.md 的托管块。宿主自带的 @deepseek-ai/dsh-agent-instructions 会在每个会话的首次请求读取该文件作为工作区指令,因此规则全局生效,且不占用 system 段。
行为
- 一处存储,一份落地。 面板把规则写进
~/.dsh/agent-rules.json,并重新渲染~/.dsh/AGENTS.md的托管块。 - 手写内容不被覆盖。
<!-- dsh-agent-rules:start -->与<!-- dsh-agent-rules:end -->之外的内容原样保留;检测到手写内容时,面板给出导入入口。 - 停用不等于删除。 停用的规则从
AGENTS.md里消失,但文本与 id 仍留在 JSON 中。 - 不改写系统提示词。 插件不挂 prompt 组装,只写官方指令加载器本来就会读的那个文件。
- 已开的对话也能跟上。 会话启动时拿到完整规则;之后规则有变,该会话的下一轮会带一条只含新增/修改规则的提醒,删除或停用合并成一行说明。比对锚点取自该会话自身基线消息里解析出的规则,所以同一批变更不会重复补发。
安装
从 npm 安装——官方源与国内镜像提供同一份 tarball:
dsh plugin --profile <profile> add dsh-agent-rules
走插件市场安装,先添加下面的索引源,再到「发现」页选条目:
https://cdn.jsdelivr.net/gh/MOS-ink/dsh-agent-rules@main/market/index.json
GitHub raw 提供同一份文档,不带 CDN 缓存:
https://raw.githubusercontent.com/MOS-ink/dsh-agent-rules/main/market/index.json
从本地目录安装:
dsh plugin --profile <profile> add link:<本目录绝对路径>
随后把 dsh-agent-rules 加进 profile package.json 的 dsh.profile.bundles,重启应用。Client 半侧由宿主下发,刷新页面不会装载它。
使用
设置 → 规则与记忆。
| 操作 | 效果 |
|---|---|
| 添加规则 | 在列表顶部展开编辑器;保存时同时写两个文件 |
| 点击规则文本 / 齿轮 | 就地编辑 |
| 圆点开关 | 停用而不删除;该条不再写入 AGENTS.md |
| 垃圾桶 | 从存储与 AGENTS.md 中删除 |
| 从 AGENTS.md 导入 | 托管块之外存在手写内容时出现 |
存储
~/.dsh/agent-rules.json
{
"version": 1,
"rules": [
{ "id": "r1", "text": "回答先给结论。", "enabled": true }
]
}
~/.dsh/AGENTS.md 中的渲染结果:
<!-- dsh-agent-rules:start -->
- 回答先给结论。
<!-- dsh-agent-rules:end -->
多行规则以续行缩进的形式挂在同一个列表项下。
面板展示的上下文来源
| 来源 | 加载方 |
|---|---|
~/.dsh/AGENTS.md |
dsh-agent-instructions,用户全局作用域 |
~/.agents/AGENTS.md |
共享 agents 根,内容完全相同时折叠 |
各项目目录下的 CLAUDE.md |
仅项目作用域;用户全局作用域没有 CLAUDE.md |
市场索引
market/index.json 遵循插件市场索引格式 1,发布前用 @deepseek-ai/dsh-plugin-market-index 校验:
node scripts/validate-index.mjs market/index.json https://raw.githubusercontent.com/MOS-ink/dsh-agent-rules/main/market/index.json
开发
node --test
node --check index.js
node --check client.js
Host 半侧注册一个前缀路由 /dsh-agent-rules,经 connection.requestRejection 做信任栅栏。Client 半侧注册 settings.section 条目,id 为 agent-rules。
| 文件 | 职责 |
|---|---|
rules.js |
数据模型、markdown 渲染、块合并、导入解析(无 IO) |
index.js |
Host 插件:路由、存储、文件渲染 |
client.js |
设置页面(window.__ModuleLoader__ bundle) |
许可
MIT