SuperAPI AI 工具集

write-script-java

编程与开发

查看项目

更新于 10-16 14:37

技能介绍

用途:当需要编写 Windmill 环境中的 Java 脚本时使用本技能,指导脚本结构、依赖声明以及本地预览、运行和元数据同步的正确命令选择。

Java 脚本约定:脚本须包含名为 Main 的 public 类,其中定义 public static Object main(...) 方法,返回 Object 或 void;参数即脚本输入,凭据与配置通过资源类型参数传入,不得硬编码或从环境读取。

依赖声明:在文件顶部用注释声明 Maven 依赖,例如: //requirements: //com.google.code.gson:gson:2.10.1 //org.apache.httpcomponents:httpclient:4.5.14 库会自动安装,无需给出安装步骤。

常用命令:迭代本地脚本默认用 wmill script preview <script_path>,不部署直接运行本地文件;wmill script run <path> 仅用于运行工作区中已部署版本;部署需用户明确要求,通过 git push 或 wmill sync push 完成。

元数据同步:修改脚本内容(增删 import、改变 main 参数等)后,运行 wmill generate-metadata 重新生成 .script.yaml、.lock 并刷新 wmill-lock.yaml 哈希;无路径时仅重算哈希漂移项,可用 --dry-run 查看受影响项,用 wmill generate-metadata rehash 在无后端往返情况下仅重记哈希。生成后对比 .lock 变化并告知依赖版本变更;用 wmill resource-type list 或 --schema 查看可用资源类型。

限制:preview 不部署但会执行代码并可能产生副作用;部署是唯一改动远端状态的操作,仅在用户明确要求时进行;未同步 Hub 资源类型时相应类型可能缺失。