dsh-rules
DSH 规则插件：通过 glob 匹配代理读取或编辑的文件，激活规则提示词 / Markdown 文档（Claude Code rules.md 风格）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-rules@0.1.3Rules 以 dsh-rules 发布，当前版本为 0.1.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Glob-activated rule prompts for DeepSeek Harness (DSH) — a Claude Code rules.md / # Path:-style mechanism. Each rule declares glob patterns; when the agent reads or edits a matching file, the rule activates and its content (any prompt or markdown document) is injected into the conversation as a superseding <rules> snapshot.
Works in every DSH deployment: desktop / web / tui / headless / custom profiles — nothing about this plugin is desktop-specific.
**, *, ?, {a,b}, [abc], and ! negation (picomatch)..dsh/rules/*.md) and # Path: sections inside CLAUDE.md / AGENTS.md.dsh-rules · Active rules: typescript, docs — expanding to the full rules text. Each snapshot supersedes earlier ones, so the model always sees the current set.path:) are always active.workspace
.dsh/rules/*.md ← rule definitions (frontmatter declares globs)
~/.dsh/rules/*.md ← user-level rules (optional)
CLAUDE.md ← optional: # Path: sections (Claude Code compatible)
agent reads/edits a file (fs/observed) → record per-session touched path
↓ every step (agent/pre-step)
match touched paths against globs → collect active rules → render a <rules> snapshot into the conversation
agent/pre-step waterfall listener appends a <rules>-framed user message; a new message is only appended when the snapshot text changes.fs.stat().version, or mtimeMs:size on the Node fallback) — edits to rule files take effect on the next step.fs service (containment-aware); fall back to Node's filesystem when no fs service is mounted.Published on the npm registry — dsh plugin installs and activates the plugin in one step:
# Adjust the profile name: desktop / web / tui / headless
dsh plugin --profile desktop add dsh-rules
The package declares dsh.bundle.patch, so the reconcile pass of dsh plugin add appends dsh-rules to the profile's dsh.profile.bundles layer list automatically — no manual cordis.patch.yml edits are needed. Restart DSH (restart the desktop app; restart the web/headless process) and the plugin loads with the next Cordis composition.
Updates: dsh plugin --profile desktop update dsh-rules (or remove + add).
Installing from a local checkout (development):
# From the repo root — activates the bundle automatically, same as the registry install
dsh plugin --profile desktop add .
⚠️ pnpm splits
addarguments on spaces, so a repository path containing spaces must be installed through a no-space junction (see below).
# 1. Clone this repository, then from the repo root:
node scripts\install-desktop.mjs
# 2. Restart DSH Desktop — the plugin loads with the next Cordis composition
The script creates a no-space junction to the repo and runs the desktop app's own dsh plugin add through it (pnpm splits add arguments on spaces, so a repository path containing spaces must go through the junction):
# 0) Create a no-space junction to the repository (needed when the path contains spaces)
mklink /J "C:\code_repos\dsh-rules" "C:\code_repos\dsh rules plugin"
# 1) Install via the desktop's own dsh command (through the junction path)
& "C:\Program Files\DSH Desktop\DSH Desktop.exe" --expose-internals `
"C:\Program Files\DSH Desktop\resources\app.asar.unpacked\lib\desktop-cli.js" `
plugin --profile desktop add "C:\code_repos\dsh-rules"
Per-profile configuration (optional): the plugin loads with its code defaults; to customize, override the entry's config in <profile>/cordis.patch.yml:
- id: dsh-rules
name: dsh-rules
config:
includeClaudeSections: true
projectRootMarkers: [".git", ".dsh"]
Uninstall: node scripts\install-desktop.mjs --uninstall (or dsh plugin --profile desktop remove dsh-rules), then restart the app. Installing/uninstalling never touches the DSH installation directory (resources\app.asar.unpacked) — only profile configuration, fully reversible.
.dsh/rules/*.md and ~/.dsh/rules/*.md)---
path:
- "src/**/*.ts"
- "!src/**/*.test.ts"
---
Rule body (markdown, injected verbatim when active — any prompt content works)
| Frontmatter field | Description |
|---|---|
path | String or list of globs, relative to the project root, / separators; ! prefixes mark exclusion patterns. Absent or empty = always-active global rule (active for any session in the workspace). |
name | Optional; rule identity (used for same-name deduplication). Defaults to the file name without .md. |
# Path: sections (requires includeClaudeSections: true)Parses # Path: <globs…> headings out of AGENTS.md / CLAUDE.md (including .local.md variants and ~/.dsh/AGENTS.md):
# Project notes (content before the first heading is handled by the built-in agent-instructions baseline, not by this plugin)
# Path: src/**/*.ts, scripts/**
This section activates only when a file under src/**/*.ts or scripts/ is touched
# Path: heading starts a rule that runs until the next heading (or end of file).# Path: heading is intentionally not injected by this plugin — DSH's built-in agent-instructions already injects the full AGENTS.md/CLAUDE.md baseline.Project rules (rank 100) > user rules (rank 200) > # Path: sections (rank 300). Same-name rules keep the highest-priority entry; rendering order is (rank, name) — deterministic across steps.
| Option | Default | Description |
|---|---|---|
dshHome | $DSH_HOME / ~/.dsh | Root for user rules and ~/.dsh/AGENTS.md |
projectRootMarkers | [".git"] | Marker files/dirs used to find the project root by walking up |
ruleDirNames | [".dsh/rules"] | Rule directories inside the project (relative to the project root, multiple allowed) |
includeUserRules | true | Enable ~/.dsh/rules/*.md |
includeClaudeSections | false | Parse # Path: sections |
instructionFileCandidates | ["AGENTS.md", "CLAUDE.md"] | Candidate file names for # Path: sections |
localInstructionFileCandidates | ["AGENTS.local.md", "CLAUDE.local.md"] | Per-directory candidate file names |
maxBytes | 32768 | Per-injection render budget (UTF-8 bytes); <= 0 disables the plugin |
maxSourceBytes | 1048576 | Per-rule source size cap; larger files are skipped |
maxTouchedPaths | 512 | Touched-path cap per session (FIFO eviction) |
This plugin is discoverable through the GitHub dsh-plugin topic — the channel recommended by the DeepSeek Harness README ("Community and support": Add the dsh-plugin topic to your plugin repository for discoverability). Community plugin lists and marketplaces (e.g. awesome-dsh-plugin, dsh-plugin-marketplace) scan that topic to pick up new plugins; the tag can be viewed/edited in the repository's About section.
../ false positives).includeRuntimeContext: false are unaffected — this plugin injects its own message and does not depend on the runtime-context snapshot.pnpm install
pnpm test # node --test: parsing / glob matching / precedence / budget / determinism / fs fallback
Layout:
lib/index.js — plugin entry (name / Config / apply): fs/observed touch tracking, agent/pre-step injection, agent/disposed cleanup.lib/rules.js — pure logic: frontmatter and # Path: parsing, glob compilation/matching, precedence merging, budget rendering.lib/fs.js — versioned discovery/reads: harness fs service first, Node fallback.test/rules.test.mjs — unit tests.examples/.dsh/rules/ — sample rules (copy into your project to get started).fixtures/demo-project/ — a ready-made project for trying the plugin out.