用途:指导编写 Windmill 的 Bun Native 脚本。此类脚本运行在仅暴露 fetch 与 JavaScript 标准库的轻量 V8 isolate 上,可高度并行;首行必须为 //native,否则同一脚本会落到普通 Bun worker。
主要能力与写法:导出单个 async 函数 main,参数可由 main(...) 声明;credentials 与配置以资源形式传入,使用 RT 命名空间(如 RT.Stripe),可先查看项目根 rt.d.ts 了解可用资源类型。可用 fetch 调用 HTTP;优先用 windmill-client 访问 Windmill(资源、变量、状态、运行脚本/流程及 S3 助手 loadS3File、loadS3FileStream、writeS3File、S3Object)。预处理脚本函数名应为 preprocessor,接收 event。
CLI 用法:本地迭代用 wmill script preview <script_path>;仅当明确要测已部署版本时用 wmill script run <path>;改动后运行 wmill generate-metadata 同步 .script.yaml、.lock 与 wmill-lock.yaml 哈希;仅当用户明确要求部署时才 push(git push 或 wmill sync push)。可用 wmill generate-metadata --dry-run 排查,wmill generate-metadata rehash 仅刷新哈希。可用 wmill resource-type list --schema 查看资源类型。
限制:仅支持 fetch 与标准库,依赖 Node/Bun 运行时 API(node:fs、child_process、Bun API、原生模块)的库不可用,需改用普通 bun 语言。脚本 preview 仍会执行代码并可能产生副作用。其余未提供。