SuperAPI AI 工具集

create-app

通用与其它

查看项目

更新于 10-15 23:24

技能介绍

用途:当用户想从零开始创建一个全新的 Twenty 应用时使用本技能,典型触发包括“我想构建一个 Twenty 应用”“脚手架一个新的 Twenty 应用”“新建 Twenty 插件/扩展/集成”“为 Twenty 创建 CRM 扩展”“搭建 Twenty 应用项目”等。若应用已存在,应改用 develop-app 添加功能、manage-app 处理同步/部署/排障、publish-app 准备上架,或用 use-twenty-mcp 查询工作区数据。

主要能力:脚手架会创建项目、启用 corepack、安装依赖、初始化 Git、与目标实例认证、执行首次同步,并尽可能打开生成的应用页面。

使用方式:先向用户说明 Twenty 应用不是独立应用,而是扩展运行中 Twenty 实例的包,其对象、视图、前端组件、逻辑函数等实体需同步到实例才能注册、渲染和执行。默认询问用户已有 Twenty 实例的 URL(如 https://app.twenty.com 或自托管地址);若没有,可用 Docker 启动本地实例。已有实例时运行:npx create-twenty-app@latest <app-name> --url <twenty-instance-url>,通过 OAuth 认证并把凭据存为 ~/.twenty/config.json 中的 remote。仅当用户没有实例并想本地试用时运行:npx create-twenty-app@latest <app-name>,省略 --url 并通过 Docker 启动一次性本地 Twenty 服务器(http://localhost:2020),需已安装并运行 Docker Desktop。目录名只能含小写字母、数字和连字符。可传 --name、--display-name、--description、--url、--authentication-method。

脚手架完成后应用已创建、同步并安装,除非用户要求,不要运行 yarn twenty apply、yarn test、yarn lint 等后续验证。脚手架会生成占位页 src/front-components/main-page.tsx 及其布局和导航项,以及健康检查 src/logic-functions/health-check.ts;应用只能声明一个健康检查。Docker 回退失败时,优先请用户提供已有实例 URL 并加 --url 重跑。后续添加对象、字段、逻辑函数等应转 develop-app;修改实体后用 yarn twenty apply 同步。