用途:用 ToolScript/RSX(Retool 的标记语言)构建可导入、可源码控制的 Retool 内部工具应用。每个应用是一个目录,含 RSX 标记、布局 JSON 与元数据,最终打包为可导入的 zip。
主要能力:提供三类工作流。新建(NEW):用 scaffold_app.py 按模板生成,模板包括 minimal、crud、master-detail、search-filter、chat、advanced-crud,以及 Charts Dashboard、API Dashboard 等示例。编辑(EDIT):先用 list_components.py 查看组件树,再用 add_component.py、add_query.py、extract_component.py 做定向修改。改进(IMPROVE):审计应用,如 DELETE 是否带 requireConfirmation、变更后是否刷新数据、表单 loading 状态、事件链是否完整等。
使用方式:先阅读 references/TOOLSCRIPT-CHEATSHEET.md,再按清单执行。典型流程为:scaffold_app.py 生成 → 读取生成文件与示例 → 自定义 SQL、组件、字段 → add_component.py/add_query.py 追加 → fix_positions.py 修正布局 → validate_app.py 校验 → bash scripts/zip_app.sh 打包。原则是优先用脚本而非手改 RSX。
适用场景:Retool 内部工具、管理后台、CRUD 应用、仪表盘及 API 数据看板。
限制:仅据资料整理,未提供收费、价格与平台信息;需遵守 RSX 规则(ID 全局唯一、col+width<=12、SQL 一律放 lib/ 文件、不使用 HTML 注释等)。脚手架应用含模拟数据回退与 Setup Guide 弹窗,接入真实数据库后需移除。