用途：在 Windmill 中编写 MySQL 查询脚本。参数使用 ? 占位符，可在语句前用注释命名参数，例如 -- ? name1 (text)、-- ? name2 (int) = 0，再在 SQL 中以 ? 引用。
主要能力：支持将脚本参数声明为 (s3object)，Windmill 会渲染 S3 文件选择器、下载文件并绑定为 JSON 文本，Parquet/CSV 会在服务端解码为记录数组，JSON/JSONL 直接透传，可用 JSON_TABLE 消费；支持在脚本顶部添加 -- s3 指令流式输出结果集到 S3，键包括 prefix、storage、format（json 默认、parquet、csv），均可不填，返回 S3Object，适合大结果集。
使用方式：编辑后运行 wmill generate-metadata 重新生成 .script.yaml 与 .lock 并刷新哈希；仅需刷新哈希时用 wmill generate-metadata rehash；可用 --dry-run 列出过期项。本地迭代用 wmill script preview <script_path>（不部署），运行已部署版本用 wmill script run <path>，部署需用户明确要求，通过 git push 或 wmill sync push。可用 wmill resource-type list --schema 查看资源类型。
限制：preview 不部署但仍会执行代码并可能产生副作用；generate-metadata 只写本地文件但会重新解析依赖，可能提升未固定版本，建议固定版本；仅当用户明确要求部署时才推送，不要为测试而推送。