dsh-plugin-immune: Self-Evolving Pitfall Memory for DeepSeek Harness

What Does It Do?

It is a DSH plugin for DeepSeek Harness that turns an agent's failed-then-fixed tool calls into reusable antibodies. It solves the problem of repeating the same pitfall across sessions while static documentation goes stale: a failure and the success that follows are paired and distilled into a rule, stored locally and isolated per project. When a later session mentions the same file name or command, the relevant antibodies are injected into the model context before the mistake can repeat.

Core Features

• Failure-to-fix pairing: automatically detects turns where a tool call failed and was then repaired, distilling the lesson into an antibody without any manual write-up.
• Per-project antibody store: antibodies live in a local SQLite database with FTS5 full-text search, so experience from one project does not leak into another.
• Dual retrieval channels: queries of three or more characters use FTS5 trigram, while two-character Chinese terms such as cross-origin, port, permission or deadlock fall back to parameterized LIKE, since trigram cannot index them.
• Antibody lifecycle control: list, export to a skill document, delete a single entry, undo the one just learned, or retire and purge antibodies that never matched.
• Local dashboard: search triggers, symptoms and prescriptions, then retire, restore or delete entries; browsing does not count as a hit, so promotion and pruning statistics stay clean.
• Two host adapters: one shared core serves both DSH and ZCode, and the DSH side also ships a native tab inside the settings page.

How to Use This Plugin?

After enabling it in DSH, just work normally: step on a pitfall, fix it, and the next turn distills an antibody automatically; later prompts mentioning the same file name or command will surface the matching hint in context. Run the self-check command to confirm the plugin is mounted and list all antibodies, adding the all flag to include retired ones. The export command turns validated antibodies into a skill document, while the forget command deletes a specific antibody, supports undoing the last learned entry, retires antibodies older than 14 days that never matched, or purges them permanently. For a visual view, start the local dashboard on port 7788 by default, shifting automatically if the port is taken; it binds only to the loopback address, generates a random token per launch, and requires that token on every API request. On ZCode the commands carry a plugin prefix but behave the same, and a new task must be created after installation.

How to Troubleshoot This Plugin?

If commands do not respond after installation, the host process usually has not been restarted: the bundle is assembled at startup, so a running process will not load it on its own; restart and run the self-check to confirm it reports an empty antibody list. If installing from a git source fails, the package manager is typically blocking dependency build scripts, so allow the listed build entry as the official instructions describe or use the packaged distribution instead. If the immune tab is missing from the settings page, check whether the current profile includes a web service: the tab relies on an optional capability registration, and the plugin still works without it in CLI or desktop profiles, only without that entry point.