用途：这是一份面向编码代理的 uv 快速入门指南，规定使用 uv 管理 Python 项目、脚本与依赖的标准操作流程。
核心规则：绝不使用裸 python 命令，几乎不要直接运行 python file.py 或 python -c，而要用 uv run 确保在受管环境中执行。若忘记语法，使用 uv --help 或 uv <command> --help。
项目管理（永久）：优先用 uv 内置项目管理代替传统 pip 流程。uv init 创建新项目；uv add <package> 添加依赖；uv remove <package> 移除依赖；uv sync 重新同步依赖，用于清理环境或在手动修改 pyproject.toml 后使用。
临时脚本与调试：避免污染全局环境或项目永久文件。uv run --with pack1,pack2 file.py 带临时依赖运行脚本；uv run python -c "print('hello')" 运行快速命令；可结合 --with 临时依赖执行。
独立脚本（用户长期使用）：当单文件脚本需跨机器可靠运行时，将依赖元数据嵌入脚本。uv add --script myscript.py pack1,pack2 添加内联依赖；之后直接 uv run myscript.py，uv 会自动读取文件、创建隔离环境并临时包含这些依赖。
Python 执行与版本：向 uv run 传 --python 指定版本，如 uv run --python 3.14 file.py；用 uv run 运行项目环境中已安装的二进制，如 uv run uvicorn main:app。
全局工具与 CLI：用 uv 工具管理独立于当前虚拟环境的 CLI。uvx <tool-name> 一次性运行交互式 CLI；uv tool install <tool-name> 永久安装；uv tool upgrade <tool-name> 或 uv tool upgrade --all 升级。
临时测试：uv add 仅用于永久项目管理，uv pip install 适合临时试验。在 uv 项目内运行 uv pip install <package> 会把包装入当前环境而不写入 pyproject.toml；因为未永久添加，之后运行 uv sync 即可移除实验包、恢复环境。如确需原始虚拟环境，可用 uv venv 手动创建。
限制：资料未提供 uv 的版本要求、支持平台、许可与性能数据；以上命令与规则以原文为准，未提及收费信息。