ClawSkills logoClawSkills

UV Global

提供并重用全局 uv 环境以运行临时 Python 脚本。

介绍

# UV Global

在 `~/.uv-global` 创建并复用一个全局 `uv` 环境,以便为快速、临时的脚本安装 Python 依赖,而不会污染系统解释器。

闪电般的设置,保持一个共享的虚拟环境随时准备处理临时任务。

当用户需要未预安装的 Python 包(数据处理、爬虫等),而创建完整的项目专用环境又显得大材小用时,请使用此技能。如果用户明确需要系统 Python 或项目本地 venv,则跳过此步骤。

## 要求

`uv` 可用。如果缺失,则需要 `brew` (macOS/Linux) 或 `curl` 来进行安装。

## 安装

```bash bash ${baseDir}/install.sh ```

该脚本将:

- 如果 `uv` 不存在,则通过 `brew` (macOS/Linux) 或官方 `curl` 安装程序安装 `uv` - 在 `~/.uv-global` 创建一个全局 uv 项目 - 在 `~/.uv-global/.venv` 创建一个包含常用包的虚拟环境 - 在 `~/.uv-global/.venv/bin` 中创建一些有用的 shims(垫片)

[可选] 将 venv 的 bin 目录添加到你的 `PATH` 前置,以便 `python` 默认使用全局环境并使 shims 可用:

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

## 用法

对于任何需要额外依赖的快速 Python 脚本:

```bash # install required packages into the global env uv --project ~/.uv-global add <pkg0> <pkg1> ...

# write your code touch script.py

# run your script using the global env uv --project ~/.uv-global run script.py ```

提示: - 脚本可以放在任何位置;`--project ~/.uv-global` 标志确保它们使用全局环境运行。 - 使用 `uv --project ~/.uv-global pip list` 检查已安装的包。 - 如果任务发展成为一个真正的项目,请改用项目本地的 venv,而不是此全局环境。

更多产品