snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/zh/getting-started/core-concepts/ai.mdx

@@ -0,0 +1,34 @@
+---
+title: AI
+description: Twenty 如何使用 AI 增强你的 CRM 体验。
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty 将 AI 直接集成到你的 CRM 中——不是噱头，而是一个在你的数据模型和权限系统内运行的实用工具。
+
+## AI 聊天机器人
+
+用自然语言就你的数据提出问题。 AI 聊天机器人可以查询你的 CRM 记录、总结信息，并在无需构建复杂筛选条件的情况下帮助你找到所需内容。
+
+<VimeoEmbed videoId="1185511734" title="AI 聊天机器人" />
+
+## AI 代理
+
+AI 代理不仅限于聊天——它们还能自主执行多步骤任务：
+
+* 使用来自外部来源的数据丰富记录
+* 撰写并发送跟进电子邮件
+* 分析销售管道健康状况并标记存在风险的交易
+* 处理传入数据并将其路由到合适的团队
+
+AI 代理在你现有的工作流中运行，因此你可以将 AI 与人工审批、条件逻辑以及外部 API 调用相结合。
+
+## 权限与安全
+
+Twenty 中的 AI 遵循你的权限模型。 AI 代理只能访问用户（或角色）有权查看的对象和字段。 即使在涉及 AI 时，敏感数据也始终受到保护。
+
+<Card title="完整 AI 指南" icon="arrow-right" href="/l/zh/user-guide/ai/overview">
+  关于聊天机器人、代理和权限控制的详细参考。
+</Card>

packages/twenty-docs/l/zh/getting-started/core-concepts/apps.mdx

@@ -0,0 +1,41 @@
+---
+title: 应用
+icon: cube
+description: 通过代码扩展 Twenty——将自定义对象、服务器端逻辑、UI 组件和 AI 代理全部构建为 TypeScript 软件包。
+---
+
+大多数 CRM 只给你一个配置面板。 Twenty 给你的是一个平台。 应用是开发者将 Twenty 扩展到超出 UI 所提供能力的方式——将数据模型、服务器端逻辑、UI 组件和 AI 能力定义为代码，然后将它们部署到一个或多个工作区。
+
+## 应用存在的原因
+
+工作流涵盖无代码自动化。 但有些事情需要代码：自定义定价引擎、专有的富化管道、在每次记录更新时运行的合规检查、从内部工具中提取数据的自定义 UI 面板。
+
+应用让你将这些构建为一等扩展——不是从外部与 API 通信的脆弱脚本，而是在平台上运行、可完全访问类型系统、权限模型和 UI 的代码。
+
+## 一个应用可以定义什么
+
+一个应用是使用 `twenty-sdk` 声明 **实体** 的 TypeScript 软件包：
+
+| 实体         | 作用                                            |
+| ---------- | --------------------------------------------- |
+| **对象与字段**  | 在现有对象上新增数据表和字段——与内置项同等对待                      |
+| **逻辑函数**   | 由 HTTP 路由、cron 调度或数据库事件触发的服务端 TypeScript      |
+| **前端组件**   | 在 Twenty 的 UI 内渲染的沙盒化 React 组件（侧边面板、小部件、命令菜单） |
+| **技能与智能体** | AI 能力——可复用的指令和自主助手                            |
+| **视图与导航**  | 预配置的列表视图和侧边栏菜单项                               |
+
+所有内容都会在构建时通过 AST 分析自动检测——无需配置文件，也不需要注册样板代码。 在任意 `.ts` 文件中放入一行 `export default defineObject(...)`，SDK 就会自动识别。
+
+## 它们如何运行
+
+* **逻辑函数** 在隔离的 Node.js 进程中执行，并与宿主环境沙盒隔离。 它们通过限定在应用角色权限范围内的类型化 API 客户端来访问数据。
+* **前端组件** 在使用 Remote DOM 的 Web Worker 中运行——与主页面沙盒隔离，但渲染原生 DOM 元素（非 iframe）。
+* **权限** 在 API 层面强制执行。 应用只能看到其角色权限所允许的内容。
+
+## 开发者体验
+
+你在本机上以一个 TypeScript 项目的形式编写你的应用。 CLI 监听你的源码文件，并将它们实时同步到正在运行的 Twenty 服务器——编辑文件后，你可以在一秒内在 UI 中看到变更。 当模式发生变化时，会自动重新生成类型化的 API 客户端。 准备就绪后，使用 `yarn twenty app:publish --private` 推送到生产服务器，或者使用 `yarn twenty app:publish` 将你的应用发布到 npm 和 Twenty 应用市场。
+
+<Card title="构建你的第一个应用" icon="arrow-right" href="/l/zh/developers/extend/apps/getting-started/quick-start">
+  三阶段引导——脚手架搭建、本地服务器运行、同步你的更改。
+</Card>

packages/twenty-docs/l/zh/getting-started/core-concepts/calendar-and-email.mdx

@@ -0,0 +1,46 @@
+---
+title: 日历与电子邮件
+description: 将您的电子邮件和日历与 Twenty 同步。
+icon: envelope
+---
+
+Twenty 连接到您现有的工具，让您的 CRM 在无需手动输入数据的情况下保持最新。
+
+## 电子邮件同步
+
+连接您的 **Google Workspace** 或 **Microsoft 365** 邮箱。 连接后：
+
+* 电子邮件会自动关联到匹配的公司和联系人记录
+* 完整的电子邮件会话在每条记录的时间轴中可见
+* 您可以直接从 Twenty 发送电子邮件
+* 支持每位用户使用多个邮箱
+
+您可以控制要导入的内容——按日期范围或发件人筛选，以避免导入不相关的电子邮件。
+
+## 日历同步
+
+日历事件会从您已连接的账户自动同步。 事件会出现在相关的 CRM 记录上，为您提供与每个联系人或公司的互动全景。
+
+## 集成
+
+除了电子邮件和日历之外，Twenty 还通过以下方式连接到外部工具：
+
+| 方法              | 用例                            |
+| --------------- | ----------------------------- |
+| **API**         | 使用 GraphQL 或 REST API 构建自定义集成 |
+| **Webhooks**    | 当记录发生变更时，将实时通知推送到外部系统         |
+| **Zapier**      | 无需编码即可连接 5,000+ 应用            |
+| **工作流 HTTP 操作** | 在自动化工作流中调用任意外部 API            |
+
+## 自定义应用
+
+开发者可以在 Twenty 之上构建功能完整的应用，添加自定义 UI、服务端逻辑以及深度集成。 应用可以发布给社区，也可以保持私有。
+
+<CardGroup cols={2}>
+  <Card title="日历与电子邮件指南" icon="envelope" href="/l/zh/user-guide/calendar-emails/overview">
+    设置电子邮件同步、日历同步，并排查相关问题。
+  </Card>
+  <Card title="API 与扩展" icon="plug" href="/l/zh/developers/extend/api">
+    使用 Twenty API 构建自定义集成。
+  </Card>
+</CardGroup>

packages/twenty-docs/l/zh/getting-started/core-concepts/dashboards.mdx

@@ -0,0 +1,37 @@
+---
+title: 仪表板
+description: 通过自定义仪表板跟踪绩效并可视化您的 CRM 数据。
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+仪表板为您的业务指标提供实时可见性——销售管道健康状况、团队绩效、收入趋势，以及您希望跟踪的任何其他内容。
+
+<VimeoEmbed videoId="1185511768" title="仪表板" />
+
+## 小部件
+
+每个仪表板都由小部件组成。 小部件是与您的 CRM 数据关联的单个图表或指标。 您可以配置：
+
+* **图表类型** — 条形图、折线图、饼图、数字等
+* **数据源** — 数据模型中的任何对象（标准或自定义）
+* **筛选器** — 细化到特定记录、日期范围或细分
+* **聚合** — 对任何数值字段进行计数、求和、平均值、最小值、最大值
+* **分组** — 按所选字段、日期或关系进行分组
+
+## 可跟踪的内容
+
+* 按阶段划分的销售管道金额
+* 随时间变化的成交交易
+* 按来源划分的平均交易金额
+* 任务完成率
+* 任意对象上的自定义指标
+
+## 共享
+
+仪表板位于工作区级别——您团队中的每个人都可以看到它们。 以网格布局排列小部件并调整其大小，以构建适合您团队的视图。
+
+<Card title="完整仪表板指南" icon="arrow-right" href="/l/zh/user-guide/dashboards/overview">
+  关于创建仪表板、配置小部件及图表设置的详细说明。
+</Card>

packages/twenty-docs/l/zh/getting-started/core-concepts/data-model.mdx

@@ -0,0 +1,47 @@
+---
+title: 数据模型
+description: 了解 Twenty 如何使用对象、字段和关系来构建你的数据。
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty 中的一切都围绕着**对象**和**字段**构建——它们是你的数据模型的基础构件。
+
+## 对象
+
+对象是保存你数据的表。 Twenty 自带标准对象：
+
+* **Companies** — 与你有业务往来的组织
+* **People** — 个人联系人
+* **Opportunities** — 销售流程中的交易
+* **Tasks** — 你的团队需要完成的行动项
+* **Notes** — 关联到记录的自由文本
+
+你也可以为业务所需的任何内容创建**自定义对象**——项目、支持工单、产品、合同等。
+
+## 字段
+
+字段是每个对象上的属性。 Twenty 支持广泛的字段类型：
+
+| 类别     | 类型                             |
+| ------ | ------------------------------ |
+| **基础** | 文本、数字、布尔值、日期、货币、评分、选择          |
+| **复合** | 地址（街道、城市、州/省、邮编）、全名、链接、电话、电子邮件 |
+| **特殊** | 关系、文件附件、JSON、操作者（创建/修改的人）      |
+
+每个对象还会自动获得系统字段：`id`、`createdAt`、`updatedAt`、`createdBy` 和 `position`。
+
+## 关系
+
+对象通过关系相互连接。 一个公司拥有多个联系人，一个商机从属于一个公司，依此类推。 你可以在任意对象之间创建自定义关系，包括多对多关系。
+
+## 强大之处
+
+与传统 CRM 中受限于预定义对象和预定义字段不同，Twenty 允许你按照业务的实际运行方式来建模你的数据。 自定义对象与内置对象享有同等的一流待遇——包括 API 端点、视图、权限和工作流触发器。
+
+<Card title="深入了解数据模型" icon="arrow-right" href="/l/zh/user-guide/data-model/overview">
+  关于对象、字段、关系以及如何配置它们的完整参考。
+</Card>
+
+<VimeoEmbed videoId="1185511827" title="数据模型" />

packages/twenty-docs/l/zh/getting-started/core-concepts/glossary.mdx

@@ -0,0 +1,105 @@
+---
+title: 术语表
+icon: book
+description: 在 Twenty 中使用的关键术语。
+---
+
+## 接口
+
+API（应用程序接口）允许您将 Twenty 与其他软件系统连接并构建自定义集成。
+
+## 应用
+
+应用是以代码构建的自定义扩展，可定义数据模型和逻辑函数。 它使开发者能够创建可复用的自定义内容，并可部署到多个工作区。
+
+## 代码操作
+
+代码操作是工作流步骤，允许您编写自定义 JavaScript 来转换数据、进行计算，或执行内置操作无法实现的复杂逻辑。
+
+## 命令菜单
+
+命令菜单是一个快速访问界面（在 Mac 上用 `Cmd + K` 打开，Windows 上用 `Ctrl + K` 打开），可以让您执行操作、创建记录并高效地导航您的工作区。
+
+## 公司与人员
+
+CRM 有两种基本类型的记录：
+
+* `公司` 表示一个企业或组织。
+* `人员` 代表您的公司当前和潜在的客户。
+
+## 自定义字段
+
+自定义字段是您创建的数据字段，用于捕获特定于您的业务需求和流程的信息。
+
+## 数据模型
+
+数据模型是定义信息在您的 CRM 中如何组织的结构，包括哪些对象存在、它们的属性（字段）以及它们如何相互关联。
+
+## 收藏夹
+
+收藏是您标记用于快速访问的记录，会显示在侧边栏，便于即时导航到重要数据。
+
+## 字段
+
+字段是指为某个实体存储特定数据的特定区域。
+
+## 迭代器
+
+迭代器是一种工作流操作，用于遍历项目数组，并为列表中的每个项目执行后续操作。
+
+## 看板
+
+`看板` 是一种使用卡片和列来跟踪业务流程的可视化方法。 每一列代表您的流程中的一个阶段（例如：新建、进行中、赢得、失去），您可以随着进度将记录在这些阶段中移动。
+
+## 对象
+
+对象是一种数据结构，表示 CRM 中的特定类型的实体（如人员、公司或机会）。 对象可以是标准的（内置）或自定义的（由您创建）。
+
+## 机会
+
+在 Twenty CRM 中，机会是与帐户或联系人潜在的交易或销售。
+
+## 记录
+
+记录表示一个对象的实例，比如特定的帐户或联系人。
+
+## 关系字段
+
+关系字段在不同对象之间创建连接，允许您将记录链接在一起（例如连接一个人到一个公司）。
+
+## 标准字段
+
+标准字段是默认附带对象的预构建数据字段，并在所有工作空间中提供常见功能。
+
+## 任务
+
+在 Twenty CRM 中，任务是与联系人、帐户或机会相关的分配活动。
+
+## 触发器
+
+触发器是工作流的起点——用于启动自动化的事件或条件。 示例包括记录创建、记录更新、Webhook 或预定时间。
+
+## 视图
+
+您可以使用视图自定义记录的显示，为每个视图设置不同的过滤器、布局和排序选项。
+
+## 更新或插入
+
+更新或插入是一种将“更新”和“插入”合并的操作——如果找到匹配项，则更新现有记录；如果没有匹配，则创建新记录。
+
+## Webhooks
+
+Webhook 是在特定事件发生时从 Twenty 发送到其他应用的自动消息，实现实时数据同步。
+
+## 工作流
+
+工作流是基于特定条件触发动作的自动化过程，帮助您自动化重复性任务和业务流程。
+
+## 工作区
+
+一个 `工作区` 通常代表使用 Twenty 的公司。 它保存您和您的团队成员添加到 Twenty 的所有记录和数据。
+它有一个单一的域名，通常是您公司用于员工电子邮件地址的域名。
+
+## 工作区成员
+
+工作区成员是您的团队中有权访问您的工作区的 Twenty 用户。 他们可以被指定为记录的所有者或负责人。

packages/twenty-docs/l/zh/getting-started/core-concepts/layout.mdx

@@ -0,0 +1,74 @@
+---
+title: 布局
+description: 如何在 Twenty 中导航、浏览和查看记录。
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## 主布局
+
+屏幕中央是记录所在——人员、公司、商机、任务、备注、仪表板、工作流，以及任何自定义对象。 您可以在这里查看、编辑和删除记录，并创建新的视图。
+
+<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
+
+## 导航栏
+
+左侧边栏为您提供：
+
+* **工作区切换器**——在不同工作区之间切换或创建新的工作区（顶部下拉菜单）
+* **搜索**——按下 `/` 可立即聚焦，跨所有对象进行搜索
+* **设置**——从左上角进入
+* **收藏夹**——置顶视图，对每个用户独立
+* **对象快捷方式**——快速访问人员、公司、商机等对象
+* **工作流**——创建自动化流程
+
+拖动项目以重新排序，创建文件夹对相关对象进行分组，隐藏不使用的内容。
+
+<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
+
+## 命令菜单
+
+按 `Cmd+K`（Mac）或 `Ctrl+K`（Windows），或单击右上角的三个点。 从这里您可以：
+
+* 创建新记录
+* 通过 CSV 导入和导出数据
+* 创建新视图
+* 访问已删除的记录（Twenty 支持软删除和硬删除）
+* 查看用于在工作区中导航的键盘快捷键
+
+<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
+
+## 搜索
+
+可通过命令菜单、导航栏顶部或按下 `/` 访问。 搜索可跨所有对象使用。
+
+<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
+
+## 侧边栏
+
+点击一条记录，会在右侧打开侧边栏——无需离开当前页面即可快速总览该记录的关键信息。 点击 **Open** 进入完整记录页面。
+
+<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
+
+## 视图
+
+每个对象都支持多个视图——每个对象的视图数量不限。 使用左上角的下拉菜单在不同视图之间切换。
+
+* **表格**——类似电子表格的行和列，支持分组、行内编辑和列自定义
+* **看板**——按选择字段组织的拖放卡片，非常适合用于管道
+* **日历**——根据日期字段绘制记录，用于基于时间的规划
+
+每个视图都会保存其自己的筛选、排序和字段可见性。 可以将视图共享给整个工作区，或将其设为私有。 将视图添加到收藏夹，以便从侧边栏快速访问。
+
+<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
+
+## 记录页面
+
+打开记录时，详情页面由可配置的**选项卡**和**小组件**构成。 在网格上添加、删除、重新排序和调整小组件大小——字段、相关记录、电子邮件、时间线、任务、备注、文件、图表、iframe 等。 每种对象类型都有其自己的布局。
+
+<Card title="完整布局指南" icon="arrow-right" href="/l/zh/user-guide/layout/overview">
+  导航、视图、记录页面——详细参考和操作指南。
+</Card>
+
+<VimeoEmbed videoId="1185511790" title="布局" />

packages/twenty-docs/l/zh/getting-started/core-concepts/workflows.mdx

@@ -0,0 +1,55 @@
+---
+title: 工作流
+description: 使用 Twenty 的可视化工作流构建器自动化您的业务流程。
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+工作流可让您自动化重复性任务，并将 Twenty 连接到外部工具——无需编写代码（当然如果您愿意也可以编写）。
+
+<VimeoEmbed videoId="1185511711" title="工作流" />
+
+## 工作流如何运作
+
+每个工作流由三部分组成：
+
+1. **触发器** — 启动工作流的条件
+2. **步骤** — 接下来发生的事情（一个或多个按顺序执行的操作）
+3. **变量** — 在步骤之间流动的数据
+
+## 触发器
+
+| 触发器         | 触发时机                       |
+| ----------- | -------------------------- |
+| **记录事件**    | 当记录被创建、更新、删除或执行 upsert 操作时 |
+| **手动**      | 当用户点击按钮时（针对单条记录、多条记录或全局）   |
+| **计划**      | 按固定时间间隔（cron 语法）           |
+| **Webhook** | 外部系统发送一个 HTTP POST         |
+
+## 操作
+
+工作流可以以任意组合串联以下内容：
+
+* **记录操作** — 创建、更新、查找、删除或 upsert 记录
+* **发送电子邮件** — 从已连接的账户发送或撰写电子邮件
+* **HTTP 请求** — 调用任意外部 API
+* **代码** — 运行自定义 JavaScript 以处理复杂逻辑
+* **分支** — 使用 if/else 条件拆分工作流路径
+* **迭代器** — 遍历数据数组
+* **AI Agent** — 让 AI 代理自主处理数据
+* **延迟** — 在继续之前等待
+* **表单** — 在工作流中途收集用户输入
+
+## 你可以构建的内容
+
+* 当交易达到某个阶段时发送 Slack 警报
+* 使用外部 API 的数据自动丰富新联系人
+* 检测长期未跟进的机会并通知负责人
+* 在 Twenty 与您的计费系统之间同步数据
+* 从记录数据生成 PDF 或发票
+* 对符合特定条件的入站电子邮件自动回复
+
+<Card title="完整工作流指南" icon="arrow-right" href="/l/zh/user-guide/workflows/overview">
+  关于触发器、操作、变量以及真实世界自动化方案的详细参考。
+</Card>

packages/twenty-docs/l/zh/getting-started/introduction.mdx

@@ -0,0 +1,53 @@
+---
+title: 为什么选择 Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+你一直在两类软件之间做选择：一类是容易上手却无法调整，另一类是高度灵活却需要几个月才能完成配置。 Twenty 是第三种选择：**一款可随时按你需求重塑的、可立即投入生产使用的 CRM。**
+
+## Twenty 有何不同
+
+Twenty 是一个可以在其之上进行构建的平台，而不是一个只能进行配置的产品。
+
+<CardGroup cols={2}>
+  <Card img="/images/user-guide/halftone/ai.png">
+    <CardTitle>为智能体打造</CardTitle>
+    智能体在你的数据模型内部运行，并具备真实的权限控制。 技能、工具、MCP。
+  </Card>
+  <Card img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>安全可扩展性</CardTitle>
+    在安全基础之上的 vibe-coded 工具灵活性。
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>现代技术栈</CardTitle>
+    React，TypeScript。 你的团队已经知道如何扩展 Twenty。 没有专有语言，没有人为设限。
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>无锁定</CardTitle>
+    开源内核，可自托管，随时导出你的数据。
+  </Card>
+</CardGroup>
+
+## Twenty 适合谁
+
+* **正在替换 Salesforce 的大型企业** —— 你的团队花在与工具“对抗”上的时间，比真正使用它的时间还多。
+  你感觉被牢牢锁定，而成本却不断攀升。
+* **由技术型创始人领导的初创公司** —— 你已经不再满足于电子表格和 Notion。 你有远大目标，需要一款能够随你一同扩展的 CRM。
+* **寻求优势的 GTM 团队** —— 你希望构建你自己的潜在客户评分、你自己的数据丰富方案、你自己的外呼工作流。
+* **重视隐私的组织** —— 你需要自托管，并从端到端掌控你的数据。 出于监管、合同，或者纯粹是基于原则。
+* **Salesforce 合作伙伴** ——
+  你的开发人员已经厌倦了不断向客户解释许可证费用上涨。
+  你希望拥有更好的 DX，并以更低的许可证成本，更快地为客户交付项目。
+* **网页开发代理机构** —— 你的团队熟悉 TypeScript、React 和 PostgreSQL。 Twenty 让 CRM 市场向你敞开大门，而无需学习 APEX 或获取专有认证。
+
+## Twenty 不适合谁
+
+* **希望拥有一个完全不用操心的 CRM 的团队。** Twenty 更适合那些愿意贴近自己的工具，并在实践中持续打磨它们的团队。 如果你想要的是完全托管的方案，Pipedrive 或 HubSpot 会非常适合你。
+* **今天就需要数百个预构建集成的公司。** 我们的生态正在快速成长，但目前还没有 Salesforce 或 HubSpot 那么广泛。 如果你愿意动手构建那些目前还缺少的部分，你会非常喜欢它。 如果不愿意，那就再给我们一年时间。
+* **由会议室而不是一线使用者来决定工具的组织。** 我们不搞牛排晚宴和高层简报会。 我们之所以能赢，是因为我们服务的团队拥有选择自己工具的决策权。
+
+<Card title="准备好开始了吗？" icon="rocket" href="/l/zh/getting-started/quickstart">
+  在不到 5 分钟内完成 Twenty 的设置——无论是在云端还是自托管。
+</Card>

packages/twenty-docs/l/zh/getting-started/key-features.mdx

@@ -0,0 +1,70 @@
+---
+title: 关键功能
+description: 了解 Twenty 的全部功能之旅——从自定义数据模型到 AI 驱动的自动化。
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty 是一款功能齐全的 CRM 平台。 以下是您可以用它构建的内容。
+
+<CardGroup cols={2}>
+  <Card href="/l/zh/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
+    <CardTitle>自定义数据模型</CardTitle>
+    定义完全符合您业务需求的数据结构。
+    <br />创建自定义对象，使用 20 多种字段类型添加自定义字段，并在任意对象之间构建关联关系。
+  </Card>
+
+  <Card href="/l/zh/user-guide/views-pipelines/overview" img="/images/user-guide/halftone/layout.png">
+    <CardTitle>视图与管道</CardTitle>
+    在表格视图、看板和日历视图之间切换。
+    <br />使用 AND/OR 逻辑进行筛选，可按多个字段排序，对记录进行分组，并保存自定义视图。
+  </Card>
+
+  <Card href="/l/zh/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
+    <CardTitle>工作流与自动化</CardTitle>
+    无需编写代码即可自动化任何业务流程。
+    <br />在记录变更、计划任务、手动操作或传入 Webhook 时触发工作流。
+  </Card>
+
+  <Card href="/l/zh/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
+    <CardTitle>日历与邮箱同步</CardTitle>
+    连接您的 Google Workspace 或 Microsoft 365 帐号。
+    <br />邮件和日历事件会自动显示在相关 CRM 记录中。
+  </Card>
+
+  <Card href="/l/zh/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
+    <CardTitle>AI</CardTitle>
+    在您的 CRM 中自主运行的 AI 智能体——回答问题、丰富记录，并在您的权限模型内执行多步骤任务。
+  </Card>
+
+  <Card href="/l/zh/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
+    <CardTitle>仪表盘与报表</CardTitle>
+    使用实时小部件构建自定义仪表盘。
+    <br />通过可配置的图表和筛选器跟踪管道指标、团队绩效和业务 KPI。
+  </Card>
+
+  <Card href="/l/zh/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>权限与访问控制</CardTitle>
+    在每个层级实施基于角色的访问控制——对象、字段以及单条记录。
+    <br />使用 SAML 或 OIDC 配置 SSO。 审计日志会记录谁做了什么。
+  </Card>
+
+  <Card href="/l/zh/developers/extend/api" img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>API 与可扩展性</CardTitle>
+    面向开发者优先设计的 API，可适配您的自定义数据模型。
+    <br />同时提供 GraphQL 和 REST 端点，并为每个工作区自动生成文档。
+  </Card>
+
+  <Card href="/l/zh/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
+    <CardTitle>数据导入与导出</CardTitle>
+    通过 CSV 文件或 API 导入数据。
+    <br />内置字段映射、重复检测和错误处理功能。 随时导出您的数据——绝无锁定。
+  </Card>
+
+  <Card href="/l/zh/developers/self-host/self-host" img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>自托管</CardTitle>
+    使用单条 Docker Compose 命令在您的自有基础设施上运行 Twenty。
+    <br />对您的数据拥有完全控制权，并按您的节奏进行更新。
+  </Card>
+</CardGroup>

packages/twenty-docs/l/zh/getting-started/quickstart.mdx

@@ -0,0 +1,73 @@
+---
+title: 快速入门
+description: 在不到 5 分钟内让 Twenty 运行起来——无论是在云端还是自托管。
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## 注册
+
+<Steps>
+  <Step title="创建您的帐户">
+    访问 [app.twenty.com](https://app.twenty.com) 并使用 Google、Microsoft 或电子邮件注册。
+  </Step>
+  <Step title="选择试用">
+    选择 **30 天**（需要信用卡）或 **7 天**（无需信用卡）。 两种选项都包含完整访问权限——不限联系人数量、电子邮件集成、自定义对象和 API。 您可随时更改套餐或计费周期。
+  </Step>
+  <Step title="创建您的工作区">
+    通过 Stripe 完成付款确认后，您将设置工作区名称和用户个人资料。 您可以随时取消。
+  </Step>
+</Steps>
+
+<VimeoEmbed videoId="1185227242" title="创建工作区" />
+
+## 配置您的工作区
+
+进入后，完成以下三个步骤，让 Twenty 真正成为您的工具：
+
+### 1. 连接您的邮箱
+
+前往 **Settings → Accounts** 并连接您的 Google 或 Microsoft 帐户。 Twenty 将导入您的电子邮件和日历事件，并根据交互自动创建联系人。 使用其他服务提供商？ 您可以在同一页面通过 SMTP 添加邮箱，或通过 CalDAV 添加日历。
+
+<Note>从这里开始——连接邮箱可以在您自定义其他内容之前，通过真实数据立即为团队带来价值。</Note>
+
+<VimeoEmbed videoId="1185416821" title="连接您的邮箱" />
+
+### 2. 塑造您的数据模型
+
+前往 **Settings → Data Model** 创建自定义对象和字段。 有几点需要了解：
+
+* 自定义对象和字段在所有套餐中均**不限量**——无额外加价。
+* **人员、公司和机会** 是显示已同步电子邮件和会议的对象。 将它们作为基础使用，并添加字段进行分类（例如，一个 `Person Type` 字段），而不是创建不会包含电子邮件历史记录的单独对象。
+* 两个人不能拥有相同的电子邮件地址。 两家公司不能拥有相同的域名。
+* 您可以停用不需要的标准字段/对象，并在不删除字段的情况下将其从视图中隐藏。
+
+[数据模型参考 →](/l/zh/user-guide/data-model/overview)
+
+<VimeoEmbed videoId="1185416793" title="塑造您的数据模型" />
+
+### 3. 导入您的数据
+
+使用命令菜单 (`Cmd+K` / `Ctrl+K`) 通过 CSV 导入人员、公司、机会或任何自定义对象。 请先下载示例文件，以查看期望的格式。 将文件限制在最多 10,000 条记录，并在导入前去重电子邮件/域名。
+
+[数据迁移指南 →](/l/zh/user-guide/data-migration/overview)
+
+<VimeoEmbed videoId="1185416775" title="导入您的数据" />
+
+## 后续步骤
+
+<CardGroup cols={2}>
+  <Card title="了解布局" icon="table-columns" href="/l/zh/getting-started/core-concepts/layout">
+    导航、视图、命令菜单、侧边面板。
+  </Card>
+  <Card title="构建工作流" icon="bolt" href="/l/zh/user-guide/workflows/overview">
+    自动化您的业务流程。
+  </Card>
+  <Card title="创建视图" icon="table" href="/l/zh/user-guide/layout/overview">
+    表格、看板、日历——筛选并排序您的数据。
+  </Card>
+  <Card title="探索 API" icon="plug" href="/l/zh/developers/extend/api">
+    每个租户独立 Schema 的 REST 和 GraphQL。
+  </Card>
+</CardGroup>