用途:在干净的工作树上批量或指定升级 Python 依赖,同步锁定文件,重新生成带哈希的 requirements.txt,并确保 lint、类型检查、单元测试与集成测试全部通过;若因 API 变化导致失败,则修改调用代码适配新 API,而非回退版本。
主要能力:基于 uv 的依赖升级与锁定;通过 make 目标完成格式化、验证与多级测试;区分测试因 API 变化失败与真实回归;生成变更报告;提交并创建 PR。
使用方式:先 git fetch upstream、git checkout upstream/main、git checkout -b chore/deps-update;确认工作树干净并运行 uv lock --check 与 uv run python --version。指定包时执行 uv lock --upgrade-package {package} 与 uv sync --group dev --extra evaluation,否则执行 uv lock --upgrade 与 uv sync --group dev --extra evaluation,再运行 make requirements.txt。随后依次运行 make format、make verify、make test-unit、make test-integration,失败时定位问题包并修复代码后重跑。最后检查 git diff --name-only,若仅依赖文件变更则 git add pyproject.toml uv.lock requirements.txt、git commit -m "chore: bump dependencies to latest" 并创建 PR;若有源码或测试改动,需等用户确认后再提交。
适用场景:需要定期或指定更新 Python 依赖并确保质量门禁通过的项目维护流程。
限制与约束:必须干净工作树;不得跳过四项验证;优先修复代码而非回退版本,仅在确认上游回归时回退并重新执行 uv lock 与 uv sync;不修改无关代码;不得手动编辑 requirements.txt,必须通过 make requirements.txt 生成;测试失败若与升级无关需如实说明。具体平台支持、收费与更多说明暂未提供。