用途：指导编写生产可用的自包含 Python 单文件脚本，用 uv 与 PEP 723 内联元数据声明依赖，使依赖随代码存放，无需单独 requirements.txt，执行可复现。
主要能力：提供内联依赖、项目模式、无依赖三种执行模式；给出 shebang 写法（如 #!/usr/bin/env -S uv run --script --quiet）；说明版本约束（>=、~=、==）与 requires-python；提供脚本校验与转换工具（./tools/validate_script.py、./tools/convert_to_uv.py）；覆盖 CLI、API 客户端、数据处理、系统自动化等模式，以及 GitHub Actions、GitLab CI 集成示例。
关键限制：明确禁止使用 [tool.uv.metadata]，它不属于 PEP 723，会触发 TOML 解析错误；元数据应写入 Python docstring。有效 tool.uv 字段如 exclude-newer 可用于可复现性。
适用场景：单文件、单一用途的脚本，如集群健康检查、CEPH 监控、NetBox API 客户端。
不适用：超过 500 行、多模块、复杂配置、需打包分发、共享库、Web 应用或长期运行服务，应改用 uv 项目。
用法要点：脚本首行用 uv run --script，内联块写 requires-python 与 dependencies；生产脚本加 --quiet；错误处理用 try/except 并输出到 stderr；密钥用环境变量或 keyring，不硬编码；简单脚本可用 --test 内联测试。
资料未提供具体收费、价格、平台支持范围与效果数据。