用途：编写或修复 Raycast Script Command，即放在 Raycast 脚本目录中、带 # @raycast.* 元数据头的单个 .sh 或 .py 文件。不适用于 Raycast Extensions（导入 @raycast/api、使用 ray build、JSX 视图或扩展 package.json 的场景），也不适用于无 Raycast 集成意图的普通脚本。
主要能力：创建新命令、把已有 Python/Shell 脚本转换为 Script Command、增删修元数据块、选择 fullOutput/compact/silent/inline 模式、配置 refreshTime 与 packageName、把类型化参数接到 sys.argv[1..3] 或 $1..$3、排查命令不显示、修正 stdout 形态与失败退出行为、按社区仓库约定加固命令。
必要用法：元数据块须紧贴 shebang 下方，必填 # @raycast.schemaVersion 1、# @raycast.title、# @raycast.mode；inline 模式必须配 # @raycast.refreshTime。参数仅支持 text、password、dropdown，最多 3 个，argument1 实际必填。文件需 chmod +x，父目录须在 Raycast 设置中注册，文件名不得含 .template.。错误路径应非零退出，外部依赖需预检并输出一行安装提示。
验证：可用 scripts/check-raycast-script-metadata.sh 检查元数据，用 scripts/preview-script.sh 预览输出；模板见 assets/templates/ 下的 python-script-command.py 与 bash-script-command.sh。
限制：不得虚构元数据字段，不得使用 select/file/number 等扩展专属参数类型，不得在 compact/silent/inline 下输出多行进度。具体安装与运行细节以官方资料为准，本资料未提供价格等信息。