用途:把依赖更新整理成单个可审查的拉取请求。先阅读 CONTRIBUTING.md 中“Keeping dependencies current”,了解 pin 的含义及三个 pin 文件如何保持同步。
主要流程:
- 分支:从最新且干净的 main 创建 deps/update-<YYYY-MM-DD>,新分支上 git status 干净即完成。
- 调查:运行 vp run deps。退出码 0 表示所有 pin 已达目标,报告并停止;否则查看表格,关注 major 升级或已弃用的 pin。
- 更新:运行 vp run deps update,它会移动 pin、刷新 lockfile、goldens 和快照,然后运行 vp run ready。某步失败时,已移动的 pin 会留在工作树中:在拥有该问题的抽象层修复原因(模板、集成或 packages/integrations/src/deps 中的 pin 规则),再重新运行 vp run deps update。打印 Repository checks passed 即完成。CI 会在 PR 上验证 pin 触及的每个技术栈。
- 检查:运行 vp check 和 vp run ready,两者在最终树上都通过即完成。
- 提交:单个提交,信息为 chore(deps): update pinned dependencies,使用配置的 git 用户,不带 Co-authored-by 尾注;若工具自动追加,可用 git commit-tree 绕过。
- 拉取请求:推送分支并针对 main 运行 gh pr create。正文按 name: old → new 列出每个移动的 pin 及其升级类型,并说明处理的每个破坏性变更及位置。PR 的 ci 检查通过即完成,把 URL 交给用户。verify 作业失败会指出技术栈并附日志,按第 3 步修复原因。
限制:资料未提供安装方式、支持平台、收费或价格信息。