全局UV环境管理

技能简介

该技能在~/.uv-global目录下创建并维护一个全局uv项目环境，为临时Python脚本提供统一的依赖安装和运行空间，避免污染系统Python解释器。

能做什么

• 一键安装uv工具（若未安装）
• 创建预置常用包的全局虚拟环境
• 为任意位置的脚本快速添加依赖并执行
• 生成实用shim命令便于直接调用

使用说明

第一步：执行安装脚本

bash ${baseDir}/install.sh

脚本会自动检测并安装uv（优先使用brew，备选curl官方安装器），随后初始化全局项目结构。

第二步：（可选）配置PATH

export PATH=~/.uv-global/.venv/bin:$PATH

将虚拟环境bin目录加入PATH后，可直接使用python命令及各类shim工具。

第三步：安装依赖并运行脚本

# 向全局环境添加所需包
uv --project ~/.uv-global add requests pandas

# 编写并执行脚本
uv --project ~/.uv-global run myscript.py

查看已装包列表：uv --project ~/.uv-global pip list

输入与输出

见下方输入与输出表格。

风险提示

• 全局环境可能被多个脚本共享，版本冲突风险高于项目隔离环境
• 长期运行的正式项目建议迁移至独立venv
• 修改PATH后可能影响系统默认python行为

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/guoqiao/uv-global/SKILL.md
来源类型：GitHub仓库