v4.0.1 — Tier 2/3 onboarding + Windows monitor 修补

累积 5 PR 的 Tier 2/3 用户实测踩坑收敛 + Windows 兼容性修复。无功能新增,全 docs / bootstrap / onboarding / Windows compat 改进。

5 PR 主线

• #59(de17b0e)OpenCode 工具映射 + Codex/OpenCode 平台说明
• #60(9656f8e)CLAUDE.md/AGENTS.md 同步 v4 现状(v4.0.0 release 遗漏)
• #61(1f10db8)OpenCode 自动注入 workflow-monitor + injection harness-agnostic
• #62(aa6bf82)stage-extensions onboarding 三件套(preflight check + docs + migration doc)
• #63(42a30b3)monitor record --json-file flag 绕 Windows cmd.exe quoting

关键能力

• forge preflight stage-extensions-check 新子命令 — 扫 forge/config.yaml#stage_extensions 漏 --user-focus / --target-label 等常见漏洞(loose 模式不阻塞)
• forge monitor record --json-file <path> — Windows 用户绕 cmd.exe 引号嵌套,解 100% record_error bug
• docs/migration/setup-stage-extensions.md — 271 行 onboarding checklist(新项目 6-step setup + 已有项目检测 + 5 stage user-focus 文本设计 + FAQ)
• OpenCode workflow-monitor 自动注入 — .opencode/plugins/forge.js 加 monitor inject 逻辑,对齐 Tier 1 SessionStart hook 行为

升级说明

v4.0.0 → v4.0.1 是 patch release,无 BREAKING change:

• npm i -g @accelerator-mzq/forge 或 pnpm i -g @accelerator-mzq/forge
• 或 plugin 路径:/plugin install forge@accelerator-mzq-forge(marketplace 自动拉新版)

Release Gate

本地 7 步全绿:typecheck / lint / format / build / vitest(1082 pass / 1 skipped)/ pack(tarball 0.58 MB / 699 文件)/ dry-install(forge --version 4.0.1)/ brownfield。CI 双平台 ubuntu + windows 同样全绿。

完整改动见 CHANGELOG.md#401---2026-05-21。