Skip to content
  • Home
  • Plugin manual
  • dsh-harmony

CH4ACKO3/dsh-harmony

80Last commit Aug 15, 2026

dsh-harmony DSH plugin

dsh-harmony is a runtime library for coordinating patches across DeepSeek Harness plugins. It allows you to transform plugin source code (e.g., lib/index.js, WebUI lib/client.js) using TypeScript AST, or apply semantic patches (before/after/around/replace) to named functions and methods. All patches are managed globally with ordering and conflict detection, and changes are applied transactionally with hot-reload support.

developer-tools

How to install the dsh-harmony DSH plugin

dsh plugin --profile web add dsh-harmony

Copying does not run this command. Review the repository and version before installing the dsh-harmony DSH plugin.

dsh-harmony DSH plugin data source

dsh-harmony DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-harmony DSH plugin can do

  • Source patches: precisely transform plugin files using TypeScript AST before the target executes
  • Semantic patches: apply before, after, around, and replace to named functions and class methods without writing a full AST transform
  • Global coordination: all patch providers share a manual order and may declare before/after constraints; automatic sorting minimizes violations
  • Transactional hot updates: patch additions, edits, ordering, and enable/disable changes are preflighted before reloading affected entries; failures keep the previous generation
  • Visible conflicts: match errors, competing replace operations, and targets removed by earlier patches are reported with provider and file names
  • No installed-file mutations: transforms live only in runtime; uninstalling Harmony restores the original plugin state

Where the dsh-harmony DSH plugin fits

  • Modify the WebUI hero banner or any UI element that is not exposed as a Slot
  • Change the behavior of an existing plugin without maintaining a fork or modifying its source files
  • Replace or decorate internal functions of a plugin to add logging, caching, or custom logic
  • Coordinate multiple patch providers that need to apply changes to the same target in a controlled order

Who the dsh-harmony DSH plugin is for

  • DSH plugin developers who need to extend or alter existing plugins without creating a fork
  • Advanced DSH users who require runtime patching, hot-reload, and conflict management for their plugin ecosystem
  • Developers building custom WebUI themes or modifying the client-side interface of DeepSeek Harness

dsh-harmony DSH plugin limitations

  • Patches must follow the target package's compiled structure; version upgrades may require updating patch selectors and transforms
  • Currently only works within DeepSeek Harness environment and requires Node.js ^22.22.3 or >=24.11.1 and DSH 0.1.0-rc.6
  • Global installation replaces the dsh command; uninstallation is needed to restore the original dsh launcher if manually installed

dsh-harmony DSH plugin: from the repository README

Quoted from the CH4ACKO3/dsh-harmony README, the upstream source of the dsh-harmony DSH plugin. Copyright remains with the original authors.

A library for patching, replacing and decorating DeepSeek Harness plugins during runtime. </p> <p> <a href="#install"><strong>Get started</strong></a> · <a href="docs/usage.md">Read the guide</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-%5E22.22.3%20%7C%7C%20%3E%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> [简体中文](README.zh-CN.md) / [English](README.md) </div> ## Positioning **dsh-harmony is the runtime Patch coordination layer for DeepSeek Harness.** The o

Read the full READMERepository license: MIT

dsh-harmony DSH plugin questions

How do I install dsh-harmony?

Install dsh-harmony globally using npm: npm install -g dsh-harmony. Alternatively, you can install it as a plugin inside DSH: dsh plugin --profile web add dsh-harmony. On first boot via the plugin method, you will be prompted to install and restart.

Can I use dsh-harmony to patch any JavaScript file in a plugin?

Yes, dsh-harmony supports source patches that can transform any file in the target package, such as lib/index.js or WebUI client files. You can also use semantic patches to target specific functions and methods without writing full AST transforms.

How do I create a patch with dsh-harmony?

Create a patch provider file (e.g., .patch.cjs) that exports an object with id, target, select, expect, and apply. The apply function receives the node and source file, and you can use the edit helper to overwrite ranges. Then reference the patch in your plugin's harmony.patch.yml and package.json under dsh.harmony.patches.

Does dsh-harmony modify plugin files on disk?

No, all transforms are applied at runtime only. No files are modified on disk. If you uninstall dsh-harmony, the original plugin behavior is restored without any cleanup needed.

How do I resolve patch conflicts?

dsh-harmony provides a Patch status page in the WebUI (Settings → Harmony → Patch status) that shows each patch's binding state, match count, and errors. Competing replace operations and removed targets are reported. You can also reorder patches manually in the Plugin order page to resolve conflicts.