SuperAPI AI 工具集

python-scripting

编程与开发

查看项目

更新于 10-15 08:33

技能介绍

用途

Python Scripting 技能用于创建自包含的 Python 脚本,基于 uv 和 PEP 723 内联脚本元数据(inline script metadata)实现依赖的自动管理。它面向需要独立运行、无需预先配置虚拟环境或手动安装依赖的脚本场景。

主要能力

  • 创建独立的 Python 脚本
  • 使用 PEP 723 内联依赖声明
  • 设置参数解析
  • 处理输入与输出
  • 配置可复现的构建

使用方式

脚本采用 PEP 723 格式声明元数据,示例格式如下:

#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.12"
# dependencies = [
#   "requests",
#   "rich",
# ]
# ///

运行脚本:

uv run script.py [args]

依赖会在首次运行时自动安装。

技能包含参考文件:references/UV_SCRIPT.template.py,即带有 PEP 723 元数据的 Python 脚本模板。

适用场景

  • 独立实用脚本
  • 一次性自动化任务
  • 快速数据处理
  • CLI 工具
  • 需要依赖的脚本

最佳实践

  • 使用 exclude-newer 以保证可复现性
  • 在 docstring 中包含用法示例
  • 使用 argparse 处理 CLI 参数
  • 返回退出码(0 表示成功,非零表示错误)
  • 保持脚本聚焦于单一任务

限制

资料未提供关于平台兼容性、uv 版本要求、性能表现或收费情况的具体说明,暂未提供。