用途:把前端或 monorepo 仓库迁移、对齐到官方 VitePlus 工具链,同时不盲目删除仓库自有的发布或运行时逻辑。VitePlus 处于 alpha 阶段,应通过 vp --version 和最新发布说明核对行为,而非依赖记忆中的命令形式。
主要能力与目标形态:CI 使用 voidzero-dev/setup-vp@v1,由该 action 负责 Node 与包管理器引导,再执行 vp install、vp check、vp test、vp build;测试文件使用 vite-plus/test,浏览器模式用 vite-plus/test/browser/context;脚本优先使用 vp test、vp test watch、vp test run --coverage、vp pack、vp build、vp update、vp run <script>(或 vpr <script>),而非直接调用包管理器、原始 Vitest 或 tsdown;hooks 使用 vp config、.vite-hooks、vp staged,替代自定义 Husky 或 lint-staged;配置集中在 vite.config.ts,不再并行保留 vitest.config.ts、.oxlintrc*、.oxfmtrc*、tsdown.config.ts;贡献者文档同步改为新的 vp 命令。
工作流:确认项目已使用 Vite 8+ 与 Vitest 4.1+,VitePlus 会拒绝更旧版本;审计现有脚本、工作流、Vite 配置、测试导入、发布流程、包管理器与打包;参考 bootstrap.md 了解入口(vp create、vp migrate)、本地指引文件发现与验证路径;按独立包选 packages.md,按工作区选 monorepos.md;一起迁移脚本、vite.config.ts、测试导入、hooks 与打包,先用 vp check && vp test 验证;再按 ci-cd.md 更新 CI,按 testing.md 更新测试与覆盖率;改动命令前查 commands.md,遇到异常或升级 VitePlus 时查 known-issues.md;保留 Vite+ 不替代的仓库自有发布、二进制或打包步骤。
升级与验证:采用新 Vite+ 版本时先全局 vp upgrade,再在项目内 vp update vite-plus @voidzero-dev/vite-plus-core @voidzero-dev/vite-plus-test,用 vp outdated 确认。端到端验证:vp env current && vp install && vp check && vp test,再检查 vp build 产物、vp test run --coverage,并在暂存改动上验证 vp staged。
注意事项:优先用 vp create / vp migrate --agent <name> --editor <name>,不要手写 agent 或编辑器配置;不要为显得“官方”而删除发布工作流、二进制打包或发布步骤;若 vp check 未运行类型感知 lint 或类型检查,确认 vite.config.ts 中 lint.options.typeAware 与 lint.options.typeCheck,并检查 tsconfig.json 的 compilerOptions.baseUrl——tsgolint 不支持 baseUrl,存在时 VitePlus 会静默跳过类型感知检查。上游注意事项见 known-issues.md,包括 hook 运行器、单文件 vp check --fix、SSR instanceof 失败、Cloudflare Workers 测试、@vitest/coverage-v8 混版警告。适用场景为前端仓库与 monorepo 的标准化迁移;限制是 VitePlus 仍为 alpha,且不替换仓库自有发布逻辑。