dsh-plugin-reloader
English | 中文
让已安装的 DeepSeek Harness 插件无需重启 dsh web 即可热更新。升级插件（如 dsh plugin add github:...）后，新代码就地生效；只有依赖树变化才需要重启进程（配合外部 supervisor 脚本自动拉起）。
它复用了 dsh 内置 HMR 为用户代码提供的同一套重载流水线——清模块缓存、重新导入插件入口、销毁旧 fiber、挂载新 fiber、失败自动回滚——只是去掉了「排除 node_modules」的限制（正是这个限制让内置 HMR 不碰已安装插件）。dsh 的 vendored loader 默认就暴露内部模块缓存，无需任何特殊 flag。
功能
- 自动热重载 — 按
pollIntervalMs（默认 2 秒）轮询已安装插件的入口文件和package.json，代码变化时就地热重载该插件。轮询（statmtime+size）取代文件监听库：chokidar 的 fs-watch 在常驻的 dsh web 进程（Windows）里永远无法 ready，且轮询天然免疫 pnpm 的整目录替换（下一次轮询直接看到新文件）。插件升级是低频操作，每 2 秒 stat 几个文件开销可忽略。 /reload <插件>命令 — 手动热重载一个已安装插件；不带参数时列出已加载插件，并标记不可重载者（[official]、[service]、[self]）。/watch-status命令 — 打印实时监听诊断：监听的 scope、事件计数、最近一次变化、重载计数、被跳过的重载、启动错误。升级插件后敲它，可确认自动重载已触发（events与reloads递增）。- 依赖变化自动重启 — 若某插件的
package.json改变了dependencies/peerDependencies，进程以退出码42（可配置）退出，由 supervisor 重新拉起。 - 可重载性守卫 — 官方
@deepseek-ai插件与「提供其他插件依赖的服务」的插件默认不热重载：尝试会被跳过、记入日志并在/watch-status中计数。重载服务提供者会让所有注入该服务的插件连锁重启；重载官方插件则相当于在会话中途给 dsh 本体打补丁。可用allowOfficial/allowServiceProviders分别放开。 - 失败回滚 — 重新导入或挂载失败时恢复模块缓存和旧插件，会话继续运行。
安装
dsh plugin --profile web add github:deepforce/dsh-plugin-reloader先重启一次 dsh web 让插件加载。要让「依赖变化自动重启」生效，请用 supervisor 启动 dsh，而不是直接启动：
# Windows (cmd)
scripts\dsh-restart.cmd web
# Windows (PowerShell)
powershell -File scripts\dsh-restart.ps1 web用法
升级已安装插件后：
dsh plugin --profile web add github:deepforce/dsh-balance # 升级监听器发现 lib/ 文件变化后会自动热重载——无需重启。想手动触发就在会话里敲 /reload @deepforce/dsh-balance；不带参数敲 /reload 列出候选插件。
如果升级还改变了插件的依赖树，进程会以 42 退出，supervisor 自动重新拉起 dsh web（注意：直接用 dsh web 启动时进程只是退出，不会自动重启，必须用 supervisor）。
配置
| 字段 | 默认值 | 含义 |
|---|---|---|
watchEnabled | true | 是否监听已加载插件并在代码变化时热重载 |
watchRoots | ["@deepseek-ai", "@deepforce"] | profile 的 node_modules 下要考虑的 scope 目录 |
debounceMs | 400 | 触发重载前的变化合并窗口（毫秒） |
pollIntervalMs | 2000 | 变化检测的轮询间隔（毫秒） |
restartExitCode | 42 | 依赖树变化时的退出码（supervisor 据此重启） |
allowOfficial | false | 是否也热重载官方 @deepseek-ai 插件（不建议） |
allowServiceProviders | false | 是否也热重载提供其他插件所依赖服务的插件（不建议） |
覆盖示例：
# reloader.cordis.yml
- patch:
- id: plugin-reloader
config:
debounceMs: 600
restartExitCode: 50兼容性
已在 DeepSeek Harness 0.1.0-rc.6（web profile，Windows 11，Node 24）上验证。它依赖 loader 的内部模块缓存（loader.internal），vendored loader 默认暴露；若未来 dsh 移除该接口，插件会降级为 /reload 报告「loader internal is unavailable」。
安全
- 监听器只读文件，自身不执行任何东西。
- 重载失败会回滚，不会留下半挂载的插件。
- 依赖变化退出是有意为之，退出前会在日志中说明。
本地构建
pnpm install # 依赖 pnpm-workspace.yaml 的 overrides 以绕过上游 npm 缺失包
pnpm run build # tsc 输出 lib/index.js许可证
MIT