dsh-user-rules — User rules settings page
English | 中文
A profile-config settings page for DeepSeek Harness that injects your own development rules into every session's system prompt.
Rules you add here are concatenated into a user-rules systemPrompt section, so the model obeys them on the next turn — edit and it takes effect without a restart. The page is a list editor over the user-rules profile-config namespace; the Host half owns the schema and the systemPrompt section, the browser half owns the editor card.
Features
| Feature | Description |
|---|
| Settings page | A first-level Settings section 用户规则 with add/edit/remove/reorder card list |
| systemPrompt injection | The resolved rules become a numbered systemPrompt section named user-rules (order -50) |
| Live edits | rules is declared .volatile(); the section text reads the live value at assembly time, so new turns pick up edits with no remount |
| Profile-config backed | Values persist to the active profile's plugin config; the page reads/writes through the shared configForms namespace |
Architecture
dsh-user-rules/
|-- src/
| |-- index.ts # host half: Config schema (volatile rules) + systemPrompt section
| |-- user-rules-schema.ts # UserRulesSchema
| |-- invariant.ts
| `-- client/
| |-- index.ts # browser half: configForms.whileServed + settings.section card
| |-- UserRulesSection.tsx
| |-- UserRulesSection.module.css
| `-- locales.ts # zh/en nav + page copy
`-- cordis.patch.yml # bundle patch: inserts the user-rules plugin row
- Namespace:
user-rules. The owning profile entry id must equal this string; the plugin's Config schema IS the namespace under the profile-config settings model.
- Injection:
apply registers a systemPrompt.section whose text reads config.rules.get() on every assembly, so the rules always reflect the current value.
- Browser bundle: rides the
window.__ModuleLoader__.load contract; React and @deepseek-ai/dsh-client-ui-primitives resolve from the loader's module table (external); CSS Modules are inlined by lightningcss as <style data-plugin>.
Install
### From a local directory (development)
dsh plugin --profile web add link:/absolute/path/to/dsh-user-rules
### From npm (recommended)
dsh plugin --profile web add @railgun52/dsh-user-rules@latest
After installing, restart dsh web. Open Settings → 用户规则 to manage rules. In link mode, run pnpm build and refresh the page after a code change; no reinstall needed.
Development
pnpm install
pnpm build # tsc -b (types+declarations) && tsdown (node half + browser bundle)
pnpm typecheck # type check only
The browser bundle is produced with the harness clientBundle helper; building from a fresh clone requires the DeepSeek Harness repository available (the tsdown.config.ts imports its clientBundle). The shipped lib/ is pre-built, so consumers never build.
License
MIT
