dsh-plugin-agents-memory
English | 简体中文
A DeepSeek Harness Web plugin for editing the user-global AGENTS.md directly in Settings. Store frequently used repositories, coding preferences, workflow rules, and other durable instructions that should apply across projects.
Features
- Adds Settings → Global Memory to DeepSeek Harness Web.
- Reads and edits
$DSH_HOME/AGENTS.mdwithout leaving the browser. - Creates a starter document automatically when the file does not exist.
- Saves atomically and keeps file permissions at
0600. - Uses revision checks to prevent one browser tab from silently overwriting another edit.
- Limits content to 256 KiB.
- Never accepts a file path from the browser; the Host endpoint is fixed to
$DSH_HOME/AGENTS.mdand loopback-only.
DeepSeek Harness already loads $DSH_HOME/AGENTS.md through its agent-instructions provider. This plugin only adds a convenient editor for that existing instruction source.
Requirements
- DeepSeek Harness with Web profile and client plugin support
- Node.js 20 or newer
- A local Web session (
127.0.0.1or::1)
Installation
Install the plugin into the DSH Web profile with one command:
dsh plugin --profile web add "github:Cocowwy/dsh-plugin-agents-memory"To pin a specific release:
dsh plugin --profile web add "github:Cocowwy/dsh-plugin-agents-memory#v0.1.2"Restart the running dsh web process, refresh the page, and open Settings → Global Memory. The plugin package supplies its own DSH bundle metadata; no manual package.json or bundle editing is required.
Local Development Installation
Clone the repository, then install the local directory through the same DSH command:
git clone https://github.com/Cocowwy/dsh-plugin-agents-memory.git
dsh plugin --profile web add "/absolute/path/to/dsh-plugin-agents-memory"Restart dsh web after installing.
Usage
Open Settings → Global Memory, edit the Markdown document, and select Save. The content is stored at:
$DSH_HOME/AGENTS.mdWhen DSH_HOME is unset, the path is:
~/.dsh/AGENTS.mdIf the file is missing, opening the page creates this starter structure:
# Personal Development Context
## Repositories
## Coding Preferences
## Workflow RulesDeepSeek Harness detects the saved instruction file. New sessions load the latest content, and a running instruction provider can report subsequent file changes to active sessions.
Do not store passwords, API keys, access tokens, or other secrets in AGENTS.md. The document is model-visible context.
Uninstall
dsh plugin --profile web remove dsh-plugin-agents-memoryRestart dsh web afterward. Uninstalling the plugin does not delete $DSH_HOME/AGENTS.md.
Security Model
The browser API:
- accepts only loopback clients;
- requires a plugin-specific request header;
- supports only
GETandPUT; - has no path parameter;
- always resolves the target on the Host as
$DSH_HOME/AGENTS.md; - performs revision-checked atomic writes;
- rejects documents larger than 256 KiB.
This is a local developer convenience, not a network-facing document service. Do not expose the DSH Web server to untrusted networks.
Development
npm test
npm run checkLicense
[MIT](LICENSE)