用途：用于在 Windmill 中编写 MySQL 查询脚本，并决定用何种 CLI 命令迭代、测试与部署。脚本需放在文件夹内。
主要能力：支持用 ? 占位符传参，并在语句前用注释命名参数与类型，例如 -- ? name1 (text) 或 -- ? name2 (int) = 0。可将参数声明为 (s3object)，Windmill 会渲染 S3 文件选择器、下载文件并以 JSON 文本绑定，Parquet/CSV 在服务端解码为 JSON 记录，配合 JSON_TABLE 使用。可在脚本顶部加 -- s3 指令把结果流式写入 S3，可用键 prefix、storage、format（json 默认、parquet、csv），适合大结果集。
使用方式：本地迭代用 wmill script preview <script_path>，不部署；仅当用户明确要运行已部署版本时用 wmill script run <path>；修改内容或主函数参数后运行 wmill generate-metadata 重新生成本地 .script.yaml 与 .lock 并刷新 wmill-lock.yaml 哈希（仅写本地文件，非部署），无路径时只重生成哈希漂移项，可用 --dry-run 或指定路径收窄范围；wmill generate-metadata rehash 仅按磁盘记录哈希。用户明确要求部署、发布、推送时才用 git push 或 wmill sync push。可用 wmill resource-type list --schema 查看资源类型。
适用场景与限制：凭据与配置须以资源类型参数传入，不得硬编码或读环境变量；库会自动安装，无需展示安装说明。preview 不部署但会执行代码并可能产生副作用，需在用户要求测试时运行。generate-metadata 会重新解析依赖，可能升级未固定版本，应在用户同意后运行并告知版本变化。仅部署步骤会改变远端状态。