dsh-harmony

<div align="center"> <a href="https://ch4acko3.github.io/dsh-harmony/"> <img width="132" alt="Harmony" src="assets/harmony-icon.png"> </a>

<h1>dsh-harmony</h1>

<p> <strong>Runtime Patch coordination for DeepSeek Harness plugins.</strong> <br /> A library for patching, replacing and decorating DeepSeek Harness plugins during runtime. </p>

<p> <a href="https://ch4acko3.github.io/dsh-harmony/guide/installation"><strong>Get started</strong></a> · <a href="https://ch4acko3.github.io/dsh-harmony/">Documentation</a> · <a href="https://github.com/CH4ACKO3/dsh-harmony/issues">Report an issue</a> </p>

<p> <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-0b63f6.svg"></a> <a href="package.json"><img alt="Node.js" src="https://img.shields.io/badge/node-^22.22.3 || >%3D24.11.1-2f6f3e.svg"></a> <a href="https://www.npmjs.com/package/dsh-harmony"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-harmony.svg?style=flat&amp;color=0b63f6"></a> <a href="https://github.com/CH4ACKO3/dsh-harmony/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/CH4ACKO3/dsh-harmony?style=flat&amp;color=0b63f6"></a> <a href="https://awesome-dsh-plugin.com"><img alt="Awesome DSH Plugin" src="https://awesome-dsh-plugin.com/badge.svg"></a> </p>

简体中文 / English </div>

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, the project of the same name created by Andreas Pardeike and other contributors for C#.

<!-- AGENTS: Before installing, authoring, reviewing, or debugging Harmony Patches, read the main-branch skill at https://github.com/CH4ACKO3/dsh-harmony/blob/main/.agents/skills/use-dsh-harmony/SKILL.md. --> <details> <summary><strong>AI agents: use the repository skill</strong></summary>

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

</details>

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