dsh-super-injector

项目详情摘要

dsh-super-injector — 超级模组注入器 ## 🎉 v0.3.0 重大声明（2026-08-14） **从经验补丁到源码契约——注入器完成规范重构。** 本版本按 docs/SPEC.md（基于 DSH 0.1.0-rc.6 源码语义推导的 设计契约）重构自重载为**官方 REPLACE 结构**：工具只排程、绝不亲自自杀； reboot 走 `entry._dispose`（官方 `_disposing` 豁免）+ 失败自动 rollback。 从此注入器的一切行为都有源码依据，不再依赖经验补丁。 **里程碑回顾**： - 三轮零上下文 subagent 评测：9/10 → 9.5/10 → **10/10** - 作死压力测试：连环自杀/坏语法/悬空 junction/循环注入卸载——**零崩溃零残留** - **云源自举**：下载 release 副本 → 装配 → 注入器从云端副本运行（自检 8/8） - **免杀进程恢复**：失败 → touch patch（include.refresh 进程内重装配）→ 6 秒复活 - **DSH 正式版兼容**：0.1.0-rc.6 一行不改直接运行（peerDeps 范围声明实证） 哲学不变：**一切皆插件**——注入器是 DSH 生态的运行时注入标准层， 让"插件想长成什么样就长成什么样"。 DSH 生态的 **BepInEx 式模组注入入口**：运行时把任意本地插件包注入运行中的 web， 不碰 patch / package.json / bundles 列表、不重启进程。**注入即完整生效（host 工具 + client UI）。** 灵感：官方装配机制（profile bundle / repository-plugin）是唯一的"官方入口"，就像游戏 只有启动器能装模组。本插件打破这一点——引导器走官方入口装一次，之后**万物皆可运行时注入**。 安装（三选一） 方式 A：Release 包（推荐，免构建） 从 Releases 下载 `dsh-external-dsh-super-injector-0.0.1.tgz`，解压得到插件目录（含 `lib/` 与 `cordis.patch.yml`），然后： 方式 B：git 装配 git 依赖拉取的是源码仓库（不含 `lib/`）；包内 `prepare` 钩子会在安装时自动 用 tsdown 构建自包含 `lib/`（首次需要网络拉取 tsdown，之后走本地缓存）。 若构建失败，请改用方式 A 的 Release tgz（预构建产物）。 方式 C：引导装配（源码方式，只需一次） ⚠️ 仅限未走 bundles 装配时使用：注入器自带 bundle 层会自注册 `dsh-super-injector`，与下方手动 `insert` 撞同一个 loader entry id，会报 `duplicate loader entry id`。走方式 A/B 装配后请勿再加这一条。 在 `~/.dsh/profiles/web/cordis.patch.yml` 添加： 引导器常驻后，任意超级模组随取随用，无需再碰官方配置。 兼容性 **不硬编码 DSH 版本**：peerDependencies 全部为范围声明 （`@deepseek-ai/dsh-tools: >=0.0.1-rc =4.0.0-rc .mjs`）热挂载 | **手术台**：注入开发者预构建的**完整插件包**（package.json + lib/） | 适用 | agent 随对话长出小工具（记账/天气/周报） | 装/换成品模组、自主开发闭环（写 → build → 注入 → 热重载） | 联动 | evolve 长出的源码可升级为完整包，再走注入器上膛 | 注入后可被 `dev_reload_package` 热重载 | 生态定位：官方之下的运行时标准层 官方对插件体系的方向（2026-07 agent notes）： 1. **否决安装命令 + 安装数据库 + marketplace**——持久化插件只有一种状态：**配置**（cordis.patch.yml / profile bundles / repositories），事