SuperAPI AI 工具集

raw-app

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:本指南介绍如何从终端创建和管理 Windmill Raw Apps——用 React、Svelte 或 Vue 构建自定义前端,连接 Windmill 后端 runnable 与数据表。

创建应用:由 AI 代理自行运行 wmill app new 并传入参数,不要提示用户手动执行交互式向导(非 TTY 环境会挂起)。需先向用户确认三项:summary(简短描述)、path(如 f/folder/my_app 或 u/username/my_app)、framework(react19 推荐、react18、svelte5、vue),缺失项一次性询问,不得猜测或默认。示例:wmill app new --summary "Customer dashboard" --path f/sales/dashboard --framework react19。可选参数:--datatable <name>、--schema <name>、--overwrite(目录已存在且用户同意时)、--no-open-in-desktop。

目录结构:my_app__raw_app/ 含 AGENTS.md、DATATABLES.md、raw_app.yaml、index.tsx、App.tsx、index.css、package.json、wmill.ts(自动生成,勿编辑)、backend/(runnable 代码、可选 yaml、lock 文件)、sql_to_apply/(仅本地开发,不同步)。

后端 runnable:在 backend/ 添加代码文件,文件名即 runnable ID,语言由扩展名决定(.ts、.bun.ts、.deno.ts、.py、.go、.sh、.ps1、.pg.sql、.my.sql、.bq.sql、.sf.sql、.ms.sql、.gql、.php、.rs、.cs、.java)。类型有 inline、script、flow、hubscript。修改后运行 wmill generate-metadata 更新锁文件,并检查依赖版本变化。

数据表:raw_app.yaml 的 data 块配置可查询表,格式为 <datatable>、<datatable>/<table>、<datatable>/<schema>:<table>。仅白名单表可访问,前端不直接查库,须经后端 runnable。

限制:sql_to_apply/ 不同步;wmill app dev、sync push/pull 等命令需用户确认后自行运行;未提供收费、价格等信息。