dsh-harmony

Runtime Patch coordination for DeepSeek Harness plugins.
A library for patching, replacing and decorating DeepSeek Harness plugins during runtime.

Get started · Documentation · Report an issue

[简体中文](README.zh-CN.md) / [English](README.md)

## 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. The goal is to extend the expressive power of DeepSeek Harness through creativity, composition, and **modification**. **Respect** Inspired by [Harmony](https://harmony.pardeike.net/), 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`](https://github.com/CH4ACKO3/dsh-harmony/blob/main/.agents/skills/use-dsh-harmony/SKILL.md) 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`. ```sh 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](https://ch4acko3.github.io/dsh-harmony/guide/installation). ## Documentation | Topic | Guide | | --- | --- | | Runtime architecture | [What is Harmony?](https://ch4acko3.github.io/dsh-harmony/guide/introduction) | | Installation and profiles | [Installation](https://ch4acko3.github.io/dsh-harmony/guide/installation) | | Writing source, semantic, and loader Patches | [Patch authoring](https://ch4acko3.github.io/dsh-harmony/patches/authoring) | | Order, status, inspection, and reload | [Operations](https://ch4acko3.github.io/dsh-harmony/guide/operations) | | React-aware patches with `dsh-harmony-react` | [React integration](https://ch4acko3.github.io/dsh-harmony/integrations/react) | | Studio previews | [Studio integration](https://ch4acko3.github.io/dsh-harmony/integrations/studio) | | Commands, limitations, and failures | [CLI](https://ch4acko3.github.io/dsh-harmony/reference/cli) · [Limitations](https://ch4acko3.github.io/dsh-harmony/reference/limitations) · [Troubleshooting](https://ch4acko3.github.io/dsh-harmony/help/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`](https://github.com/CH4ACKO3/dsh-harmony/tree/docs) branch. ```sh npm test ``` ## License [MIT](LICENSE)