安装
在 DeepSeek Harness 里通过 dsh-market 安装
dsh plugin --profile web add dshmarket
或使用命令行
dsh plugin --profile web add github:CH4ACKO3/dsh-harmony
装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络。请先审阅源码，并尽量锁定 commit（github:owner/repo#sha）。
README
简介
当一个 DeepSeek Harness 插件需要修改另一个插件、又不值得为此维护 Fork 时，可以使用 Harmony。它会在目标插件运行前加载 Patch，在内存中修改编译产物，再让 Harness 运行修改后的代码。
Source Patch 使用 TSQuery 查找 TypeScript AST 节点，再用 MagicString 改写对应的源码区间。Patch 逐个执行，后一个会读取前一个留下的结果，因此多个插件可以修改同一目标。安装目录里的文件不会改变。
Provider 可以声明自己的 Patch 应排在另一个 Provider 之前或之后；单个 Patch 也可以改用自己的规则。用户还能把不同 Provider 的 Patch 交错排列。若几处修改必须一起成功，可以把它们放进组合 Patch：它们共用一个位置和开关，任何成员失败时都不应用。
对于浏览器插件，Harmony 还会按 Patch 顺序整理 Provider 所属的 <style data-plugin> 标签。每个 Provider 只有一组样式，它在 CSS 层叠中的位置由最后一个启用的 Patch 决定。Patch 重载后，Harmony 会再整理一次。
Harmony 为 DeepSeek Harness 插件之间的协作补上了修改能力。
为什么使用 Harmony
目标已经暴露所需能力时，普通 DSH 扩展点仍然是首选。Harmony 解决的是公开 API 与维护 Fork 之间的空白：修改目标没有暴露的内部组件、Loader 条目或编译后行为。
| 不使用 Harmony | 使用 Harmony |
|---|---|
| 隐藏或复制内部 UI，并长期同步两套实现 | 在原位置替换选中的组件或编译后调用点 |
修改 node_modules、维护 Fork，或升级后重新应用改动 |
只在内存中变换源码；已安装文件逐字节保持不变 |
| 选择器漂移后由 UI 静默失效暴露问题 | 钉死目标版本和 expect；失配会在 status 中明确失败 |
| 把最终 Bundle 当作黑盒 | 检查原始源码、每一步 Patch 和最终变换结果 |
| 手动清理定制改动 | 禁用或移除 Provider 即恢复原始行为 |
Harmony 不会把编译内部变成稳定的公开 API；它让这项依赖变得明确、有序、可检查且可逆。
Respect
灵感来源于 Andreas Pardeike 和其它开发者创作的同名 C# 项目 Harmony。
安装、选择和编写 Patch、执行运行时操作或排查问题前，请加载 use-dsh-harmony。
安装
需要 Node.js ^22.22.3 或 >=24.11.1，以及 @deepseek-ai/dsh@0.1.0-rc.7。
npm install -g @deepseek-ai/dsh@0.1.0-rc.7
npm install -g dsh-harmony
dsh web
启动 WebUI 后打开 设置 → Harmony。Profile、Desktop 集成、更新和卸载说明参见安装指南。
Patch 模型
Harmony 按一份全局 patchOrder 运行所有 Patch。Provider 级 before / after 负责通常的先后关系；单个 Patch 只要声明其中一项，就改用自己的规则。在 设置 → Harmony 中，用户可以移动整个 Provider，也可以把一个 Patch 插到另一个 Provider 的两个 Patch 之间。保存时，Harmony 会检查列表是否恰好包含每个已注册 Patch 一次。
组合 Patch 让多个 Patch 共用一个排序位置和开关。成员按声明顺序执行，而且只有全部成功才会应用。独立 Patch 失败时，Harmony 会报告并跳过它；后续 Patch 和 Host 仍会运行。
React-aware Patch
修改编译后的 React 目标时，在 Patch Provider 中安装 dsh-harmony-react：
npm install dsh-harmony-react
element() 修改选中的 jsx / jsxs 调用点，component() 修改这些调用共享的组件定义。它们和其它 Source Patch 使用同一份顺序。
| API | 作用范围 |
|---|---|
element() |
一个或多个调用点：替换、包裹、插入、变换 Props 或移除 |
component() |
所有通过已初始化变量或具名函数声明进行的调用：装饰或替换 |
为了让后续 Component Patch 继续修改同一定义，Harmony 会把函数声明改写为已初始化的 const。新绑定不再提升；如果文件在声明前读取组件，请改用核心 Source Patch。React 集成还介绍了选择器、Inspect trace 和 Studio。
文档
| 主题 | 指南 |
|---|---|
| 运行时架构 | Harmony 是什么？ |
| 安装与 profile | 安装 |
| 编写源码、语义、加载器与组合 Patch | Patch 编写指南 |
| Provider/Patch 排序、状态、检查和重载 | 运行操作 |
使用 dsh-harmony-react 编写 React Patch |
React 集成 |
| Studio 预览 | Studio 集成 |
| 命令、限制与故障 | CLI · 限制 · 故障排查 |
开发
所有维护中的实现源码均使用 TypeScript。用于发布的编译产物由构建生成，不纳入 Git 跟踪。
文档源码与本地预览工具位于 docs 分支。
npm test