dsh-harmony

Introduction

Harmony provides an elegant way to modify the behavior of other plugins written for DeepSeek Harness. It runs as an external framework, applies Patches to target plugins at runtime, and starts DeepSeek Harness with the transformed plugin set.

Source Patches use TSQuery to precisely match target nodes in a TypeScript AST, then use MagicString to rewrite the corresponding ranges of the current in-memory source. Patches run in their configured order, and each Patch receives the output of the previous one, giving multiple changes to the same target a chance to coexist. Installed plugin files are never modified.

Providers can declare coarse before and after relationships, while an individual Patch can override that provider-wide rule. Profiles keep both a provider order and a fully interleavable Patch order. Composite Patches group several ordinary Patches into one ordered, toggleable, cross-file transaction: if one member fails, none of the group is applied.

In the browser, Harmony also reorders provider-owned <style data-plugin> tags from the final enabled Patch order. Because one provider owns one style group even when its Patches are interleaved, the provider's last enabled Patch position determines its CSS cascade position; style order updates again after Patch reloads.

The goal is to extend the expressive power of DeepSeek Harness through creativity, composition, and modification.

Respect

Inspired by Harmony, the project of the same name created by Andreas Pardeike and other contributors for C#.

AI agents: use the repository skill

Load use-dsh-harmony for installation, Patch selection and authoring, runtime operations, and troubleshooting.

Install

Requires Node.js ^22.22.3 or >=24.11.1 and @deepseek-ai/dsh@0.1.0-rc.6.

npm install -g @deepseek-ai/dsh@0.1.0-rc.6
npm install -g dsh-harmony
dsh web

Open Settings → Harmony after starting the WebUI. For profiles, Desktop integration, updates, and removal, see the installation guide.

Documentation

Topic	Guide
Runtime architecture	What is Harmony?
Installation and profiles	Installation
Writing source, semantic, and loader Patches	Patch authoring
Order, status, inspection, and reload	Operations
React-aware patches with dsh-harmony-react	React integration
Studio previews	Studio integration
Commands, limitations, and failures	CLI · Limitations · Troubleshooting

Development

All maintained implementation code uses TypeScript. Build artifacts are generated for packaging and are not tracked by Git.

Documentation sources and local preview tooling live on the docs branch.

npm test

License

MIT