用途:校验并修正 Python 文件的 shebang 及 PEP 723 内联脚本元数据,确保 shebang 与脚本依赖情况一致。
主要能力:按四条规则判断应使用哪种 shebang。规则1,仅用标准库的可执行脚本,用 #!/usr/bin/env python3;规则2,已安装包内的可执行文件(由 setup.py 或 pyproject.toml 管理依赖),用 #!/usr/bin/env python3;规则3,带外部依赖的独立可执行脚本,用 #!/usr/bin/env -S uv run --quiet --script,并配 PEP 723 元数据;规则4,库模块、被导入且不直接执行的文件,不加 shebang。还会检查执行位,无执行位时 shebang 被内核忽略,需 chmod +x filename。
使用方式:传入文件路径参数,逐个读取文件,检查 shebang 是否存在及正确、核对依赖、检查执行位,并按固定验证格式报告:当前 shebang、PEP 723 依赖、外部包数量、导入分析(标准库/外部)、各规则条件是否满足、适用规则及理由、执行位、结论(CORRECT/INCORRECT,错误则编辑修正)。未提供参数时询问需处理的文件或目录。
限制与要求:必须拒绝任何位置含 --active 的 shebang,因其破坏 PEP 723 隔离;PEP 723 元数据文件缺少 --script 也须拒绝。typer>=0.12.0 自带 rich 和 shellingham,PEP 723 依赖块中不得单独添加 rich 或 shellingham。规范写法为 uv run --quiet --script,--quiet 为全局选项,两种顺序运行时等价。
以上事实依据所给资料,未提供的信息暂未说明。