教程：文档生成器 - Twenty Documentation

您将会学到什么

每一章都会增加一项功能。在本教程结束时，您将接触到 SDK 的大部分内容。

章节	功能	参考
1. 数据模型	对象、字段和一个关系	数据
2. 生成文档	一个逻辑函数（AI 工具 + 工作流操作），用于填充 Markdown 模板并附加一份精美的 PDF	逻辑函数
3. HTTP 路由	从路由提供 JSON 和可分享的 HTML 页面	逻辑函数
4. 构建 UI	视图、导航、命令菜单，以及用于预览文档和编辑模板的前端组件	布局
5. 一个 AI 智能体	智能体 + 技能	技能与智能体
6. 发布	把它发布到应用市场	发布

先决条件

您应该已经完成了快速开始：一个在端口 2020 上运行的本地 Twenty 服务器，以及已通过身份验证并连接到它的 CLI。

如果还没有，现在就创建并启动一个：

npx create-twenty-app@latest document-generator
cd document-generator
yarn twenty dev

更想直接阅读完成版代码？完整应用位于 packages/twenty-apps/examples/document-generator。下面的每个代码片段都来自该应用。

应用如何协同运作

您只需在富文本编辑器中编写一次模板，其中包含 {{placeholders}}。选择一个模板和一条 CRM 记录，就会填充占位符，并存储一份精美的文档（带有一个 PDF 文件）。其他所有内容——命令菜单、AI 智能体、工作流步骤、可分享链接——都只是触发同一个生成器的不同方式。

让这个循环持续运行

在整个教程期间，在一个终端中保持运行 yarn twenty dev。每当您在 src/ 下添加或编辑文件时，它都会在几秒钟内重新同步到服务器，这样您就可以在构建的同时，在 UI 中看到每项功能逐步出现。

开始构建 →

第 1 章：为文档和模板建模。