uv-centralized-envs
Installation
SKILL.md
UV 集中项目环境迁移
把每个项目的真实虚拟环境放在调用者指定的宿主机位置,同时让
${workspaceFolder}/.venv 保持为项目的唯一入口。每个项目仍独立,绝不共享同一个环境。
原生管理约定
- 使用 UV 原生
centralized-project-envs,由 UV 创建真实环境及项目入口;仅调用uv venv <自选路径>后手工建链,不算完成本流程的原生集中迁移。 - 集中环境属于 UV 缓存布局,缓存与环境分属不同子目录,但
uv cache prune会清理原生集中环境。若用户还要求二者位于互不包含的物理根目录,先核实当前版本能力并说明限制,不能默默改为另一种环境管理方案。 - 对既有手工外置链接,按下述审计、备份、锁文件恢复与验收流程处理;不因链接存在就声称已受 UV 原生管理,也不直接全局开启预览触发批量重建。
输入
开始前确认以下信息;不要把示例盘符或物理路径写进项目文件。
central_cache_root:必填,当前主机上 UV 缓存与集中环境的绝对根目录。project_roots:要迁移的一个或多个项目根目录。backup_root:可选;迁移期间旧环境的临时备份位置。未给出时,先询问或在central_cache_root的同盘安全位置创建带日期的备份目录。parity_required:旧环境是否必须逐包保持完全一致;基准、生产或没有依赖清单的项目默认设为true。