dsh-kubejs

在 DSH 里直接改已安装插件的源码，往往一更新就丢、改坏了还可能拖垮整个启动，修改也散落各处难以 review。dsh-kubejs 借鉴 Minecraft KubeJS 的思路：插件只负责加载脚本，真正的「修改」放在独立目录里，与目标插件代码完全隔离。插件更新或重装不会带走你的定制，脚本还按目标插件分包声明依赖，未安装或版本不对时整包禁用并报警，避免静默失效。

脚本通过 activate(api) 获得五类原语，全部作用于已有能力：事件钩子、客户端槽位 UI、带账本可摘除的配置覆写、洋葱式服务包装，以及运行时生效的全局 fetch 拦截。事件遵循 waterfall 语义与三条纪律；fetch 支持多种 matcher，并内置长流空闲看门狗，减轻持续吐 token 时被墙钟超时误杀的问题。另有 api.ctx 逃生舱，适合本机信任场景下读状态或钩冷门事件；若要造可分发的新能力，仍应写成独立插件。

适合想让 AI 或自己在不动源码的前提下叠加行为、统一收口修改、并能精确回滚配置覆写的用户；也适合需要拦截或增强已有服务与出站请求的工作流场景。脚本异常时只禁用对应包并通知，其余 DSH 照常运行。