dsh-global-rules
English | 中文
Edit your user-global rules file $DSH_HOME/AGENTS.md (default ~/.dsh/AGENTS.md) from the DeepSeek Harness web settings panel.
Global rules settings page
Features
- A new Global rules settings tab (labelled 「全局规则」): opening it loads the current content of the global rules file and shows the path it resolved to
- Path resolution matches the harness: a non-blank
$DSH_HOME wins, otherwise ~/.dsh (the same rule the built-in dsh-agent-instructions follows, so you always edit the file that is actually in effect)
- Edit and save with immediate effect: new sessions use the new rules on their first step; the current session picks them up after its next file operation (handled by DSH's built-in
dsh-agent-instructions change detection)
- Saving creates the file when it does not exist yet
- Zero build: the client half is a hand-written
__ModuleLoader__ bundle, the host half is plain Node ESM
Requirements
- DeepSeek Harness (
dsh) with the web profile
- No extra runtime dependency: the plugin ships only
lib/, cordis.patch.yml, icon.svg, and
locale/*.json
Install
dsh plugin --profile web add dsh-global-rules
Installing from the GitHub source (alternative):
dsh plugin --profile web add github:badai147/dsh-global-rules
Restart dsh web, then open Settings → Global rules.
Usage
- Open Settings → Global rules
- Edit the rules (Markdown, the same syntax as
AGENTS.md)
- Click Save
After saving:
- New sessions read the new content on their first step, so it applies immediately
- The current session: after the next filesystem tool call, DSH detects the change and injects
"Updated instructions from: ~/.dsh/AGENTS.md", and the model follows the new rules
How it works
- Host (
lib/index.js): registers the exact Fetch route GET/POST /api/global-rules through ctx.connection.fetch.register (read the file / write the file, 256 KiB limit). It rides Connection's /api channel, so it lands inside the Host/Origin fence and browser authentication with no hand-rolled same-origin check
- Client (
lib/client.js): a hand-written window.__ModuleLoader__.load bundle that registers the Global rules page under settings.section
- Effect mechanism: DSH's built-in
dsh-agent-instructions plugin covers dynamic detection for the user-global scope, so this plugin needs no hot-reload of its own
Project structure
dsh-global-rules/
├── cordis.patch.yml # bundle patch: inserts the global-rules layer
├── icon.svg # plugin icon shown on the Plugins page
├── lib/
│ ├── index.js # Host: exact /api Fetch route (Node ESM)
│ └── client.js # Client: settings panel UI (__ModuleLoader__ bundle)
├── locale/
│ ├── en.json # plugin title and description (English)
│ └── zh.json # plugin title and description (Chinese)
├── .github/workflows/
│ └── publish.yml # npm publish on version tags
└── package.json
Changelog
Release notes live in CHANGELOG.md (中文).
Contributing
Bug reports, feature requests, and pull requests are welcome — see CONTRIBUTING.md
(中文) for the development setup, project conventions, and commit rules.
License
MIT
