Skip to content

v0.2.2:适配 DSH 0.2.2 最新版、集群治理看板、方案 A/B 落地与低级错误守卫

Choose a tag to compare

@taxueseek taxueseek released this 29 Oct 12:36
· 2 commits to main since this release

v0.2.2 是一次重要升级:深度适配 DSH 最新版本(0.2.2 系列,含 0.2.2-alpha.2),引入方案 B 本地环境权威锚定与零网络请求、方案 A 三元版本账本与 Release Note 靶向破坏性变更提取,并新增集群多维治理看板与低级错误硬守卫。

相对上一版的改进

• 扫描降噪强化:引入常量词边界正则匹配,消除子串碰撞误伤(如 ABORTED 误伤 FS_ABORTED);Release Note 虚拟指南与官方正式指南自动去重,杜绝重复报警同一符号。
• 停机误报消除:自动化真实宿主冷启动验证(--real-smoke)将退出码 143(SIGTERM)判定为正常优雅停机,不再将测试套件杀进程误判为宿主崩溃。
• 冒烟容错与自动注入:冒烟测试阶段自动解析 Schemastery Config({}) 填充默认配置对象后再调用 apply,防止空配置对象引发 TypeError;针对无本地 node_modules 的单文件插件自动挂载宿主依赖兜底。
• 路径与环境解耦:消除对 Documents 目录与 macOS 的硬编码假设,扩展覆盖 Linux 标准路径(/usr/lib/node_modules)、Termux 移动端($PREFIX)与 npm_config_prefix,支持 DSH_HOST_PATH / DSH_LOCATION 环境变量覆盖并遵循 XDG 规范。

新增能力

• DSH 0.2.2 系列深度兼容:直连官方 upgrade-guide 与 Release Notes,覆盖 0.2.2-alpha.2 等最新版本的破坏性变更锚点。
• 集群批量治理看板(fleet-sweep.mjs):一键扫描整机 Web 插件、APP 桌面端插件、工作区源码与运行中插件,输出五大生命周期矩阵看板。
• 本地环境权威锚定(方案 B):默认以本地已安装宿主版本为唯一权威真源,适配全流程 0 外部网络请求,消除网络抖动与 GitHub 访问频控限制。
• 三元版本账本(方案 A):引入 compat-ledger 账本([插件名, 宿主版本, gitHead]),源码未修改且上次适配通过的插件可直接快速复用结论。
• 未构建 TypeScript 插件硬拦截:检测到存在 tsconfig.json 但缺少 lib/index.js 入口产物时即时阻断并精确指引 pnpm run build,杜绝旧产物冒烟与混淆报错。
• 宿主同名包遮蔽防护(Bundle Resolution Shadow):检测官方同名内置包静默覆盖插件的隐蔽风险。
• 完整实战指南(references/user-guide.md):梳理单兵与集群治理全流程实战 SOP。

默认关闭功能的打开方式

• 联网核对上游最新发布:node scripts/run.mjs <插件目录> --check-upstream(默认收敛到本地宿主版本)
• 集群批量准入修补:node scripts/fleet-sweep.mjs --workspace --target 0.2.2-alpha.2 --apply-compat(默认仅报告不改 package.json)
• 真实宿主冷启动验证:node scripts/run.mjs <插件目录> --real-smoke
• 严格阻断模式:node scripts/run.mjs <插件目录> --strict

相关依赖

• 外部 npm 运行时依赖为 0,仅使用 Node.js 原生 API 与 git/npm CLI
• Node >= 22.13
• 自检 198 项断言,全量离线通过

分发面

• npm:plugin-fast-adapt@0.2.2 已发布
• skills CLI:npx skills add taxueseek/plugin-fast-adapt
• GitHub Release 附件:zip 与 tar.gz 双资产,带 plugin-fast-adapt-0.2.2/ 顶层目录