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。
Installs
2
First Seen
Jul 27, 2026