用途:当用户想修改已有 Twenty 应用的数据模型、界面、逻辑或工作流时使用,例如新增对象、为对象添加自定义字段、创建记录创建时触发的逻辑函数、为交易页面构建前端组件、添加手动触发工作流、配置角色权限或创建独立页面。不适用于从零搭建新应用(用 create-app)、同步部署排障(用 manage-app)、准备市场素材(用 publish-app)或查询工作区记录(用 use-twenty-mcp)。
使用方式:先确认当前目录是已有 Twenty 应用根目录,检查 package.json 与 src/application-config.ts 是否存在;缺失时不要盲目编辑,应查找应用根目录或改用 create-app。若依赖、远程、认证、同步、构建、部署、日志或 CI/CD 出问题,先切到 manage-app。涉及多个实体的改动,编辑前用 3–6 行说明计划。新增实体优先用 CLI:yarn twenty dev:add,由它生成文件结构、UUID、SDK 导入与样板;仅在修改已有实体或 CLI 不支持时手动创建。所有编辑完成后统一运行一次 yarn twenty dev:typecheck、yarn lint、yarn twenty apply 进行类型检查、lint 与同步。
代码组织:逻辑函数、安装后钩子与前端组件保持精简,将纯辅助函数、类型、外部客户端分别放入 src/utils、src/types、src/<service>-client 等目录,文件名用 kebab-case,每个文件只导出一个函数或类型;为新增或修改的工具函数在 tests/ 下创建对应 *.spec.ts。前端组件触发逻辑函数时,默认使用支持批量的 records: Array<{ id: string; ...fields }> 载荷。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;具体实体字段、导入与配置形状需参考官方文档或本地 SDK 源码。