名称: uv-global
描述: 为临时 Python 脚本配置并复用全局 uv 环境。
元数据: {"openclaw":{"always":true,"emoji":"🦞","homepage":"https://github.com/guoqiao/skills/blob/main/uv-global/uv-global/SKILL.md","os":["darwin","linux"],"tags":["python","uv","global","venv"],"requires":{"anyBins":["brew","uv"]}}}
在 ~/.uv-global 目录下创建并复用全局 uv 环境,以便为快速、临时的 Python 脚本安装依赖,而无需污染系统解释器。
提供闪电般的设置,维护一个共享的虚拟环境,随时为临时任务做好准备。
当用户需要安装未预装的 Python 包(如数据处理、网络爬虫等),且为每个项目单独创建环境显得过于繁琐时,可使用此技能。如果用户明确希望使用系统 Python 或项目本地虚拟环境,则请跳过。
确保 uv 可用。如果未安装,则需要通过 brew(macOS/Linux)或 curl 进行安装。
bash ${baseDir}/install.sh
该脚本将执行以下操作:
uv 未安装,则通过 brew(macOS/Linux)或官方 curl 安装程序进行安装~/.uv-global 目录下创建全局 uv 项目~/.uv-global/.venv 中创建包含常用包的虚拟环境~/.uv-global/.venv/bin 目录下创建一些实用的快捷脚本[可选] 将虚拟环境的 bin 目录添加到 PATH 环境变量开头,使 python 命令默认使用全局环境,并启用快捷脚本:
export PATH=~/.uv-global/.venv/bin:$PATH
对于任何需要额外依赖的快速 Python 脚本:
# 将所需包安装到全局环境
uv --project ~/.uv-global add <pkg0> <pkg1> ...
# 编写你的代码
touch script.py
# 使用全局环境运行脚本
uv --project ~/.uv-global run script.py
使用提示:
- 脚本可存放在任意位置;--project ~/.uv-global 参数确保它们使用全局环境运行。
- 使用 uv --project ~/.uv-global pip list 查看已安装的包。
- 如果任务演变为正式项目,建议切换到项目本地虚拟环境,而非继续使用此全局环境。