SuperAPI AI 工具集

uv

编程与开发

查看项目

更新于 10-15 22:40

技能介绍

用途:这是一个关于 uv 的策略型技能,优先级高于 astral:uv(若已安装)和 docs.astral.sh 的实时文档。官方文档仍可用于查询命令语法、迁移表和通用用法,本技能不重复这些内容。

主要要求:遵循 python-engineering:standards-for-python-development 中关于架构、类型、测试与 CLI 的共享规则。所有 Python 工作统一使用 uv add、uv sync、uv run,不使用 uv pip install、uv venv,也不执行 source .venv/bin/activate。对于由 uv.lock 管理、含 PEP 723 脚本的项目,无需使用 Astral 文档所述与 pip 兼容的路径。

脚本用法:可移植的 PEP 723 脚本 shebang 为 #!/usr/bin/env -S uv run --quiet --script。除非脚本确实要绑定调用方已激活的虚拟环境,否则省略 --active。

限制与注意:使用 tomlkit 时采用文本模式('r'/'w'),不要用二进制模式('rb'/'wb'),因为二进制模式返回 bytes,tomlkit 无法解析或写入。未安装 astral:uv 时可参考外部资源中的 uv 文档、GitHub 仓库、概念说明和迁移指南。其余平台、收费等信息暂未提供。