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

packages/twenty-docs/l/zh/user-guide/calendar-emails/capabilities/calendar.mdx

@@ -0,0 +1,43 @@
+---
+title: 日历
+description: 了解 Twenty 中的日历集成功能。
+---
+
+**注意**：要连接您的日历并配置同步设置，请访问[电子邮件和日历设置](/l/zh/user-guide/calendar-emails/overview)。
+
+## 日历集成如何运作
+
+Twenty 会自动同步您的日历事件，并将其链接到相关的 CRM 记录，让您全面了解与联系人和公司的会议历史。
+
+## 日历选项卡
+
+在记录的“邮件”选项卡旁，您将看到一个`日历`选项卡，其中包含与该记录安排的会议历史。
+
+### 适用于
+
+* **联系人**：查看与特定联系人安排的所有会议
+* **公司**：查看与公司及其员工有关的所有会议
+* **机会**：访问与该机会所关联公司的会议历史
+
+### 查看会议历史
+
+1. **导航至某一记录**：前往任何联系人、公司或机会记录
+2. **选择日历选项卡**：点击`日历`选项卡，位于邮件选项卡旁边
+3. **浏览会议历史**：查看所有安排的会议及其详细信息
+4. **访问会议上下文**：查看会议参与者、时间和相关信息
+
+## 可见性设置
+
+日历数据遵循与电子邮件相同的可见性设置，确保在这两种通信渠道中保持一致的隐私控制。
+
+## 同步内容
+
+* **外部会议**：与组织外部联系人的所有会议
+* **自动链接**：根据与会者的电子邮件地址，将会议链接到现有的联系人和公司记录
+* **会议详细信息**：主题、时间、时长和参与者
+* **更新**：新的日历事件会自动同步
+
+## 不同步的内容
+
+* **内部会议**：仅与同事（同一域）进行的会议保持私密
+* **私密事件**：在您的日历中标记为私密的事件

packages/twenty-docs/l/zh/user-guide/calendar-emails/capabilities/mailbox.mdx

@@ -0,0 +1,102 @@
+---
+title: 邮箱
+description: 了解 Twenty 中的电子邮件集成功能。
+---
+
+**注意**：要连接您的电子邮件账户并配置同步设置，请访问[电子邮件和日历设置](/l/zh/user-guide/calendar-emails/overview)。
+
+## 电子邮件集成如何运作
+
+Twenty自动将来自您已连接邮箱的电子邮件链接到相关的CRM记录，将所有通信历史保存在一个位置。
+
+### 包含电子邮件的对象
+
+电子邮件会话出现在三个主要对象中：
+
+* **联系人**：查看与特定联系人的所有电子邮件
+* **公司**：查看与公司及其员工有关的所有电子邮件
+* **Opportunities**: 访问与企业关联的电子邮件线程。 来自参与该商机的个人的电子邮件会话尚未显示。
+
+### 查看电子邮件线程
+
+1. **导航至某一记录**：前往任何联系人、公司或机会记录
+2. **选择邮件选项卡**：单击`邮件`选项卡以查看同步的电子邮件
+3. **打开电子邮件线程**：点击任意电子邮件以打开并阅读完整的对话
+4. **浏览历史记录**：滚动查看该联系人的完整电子邮件历史
+
+<img src="/images/user-guide/emails/show-inbox.png" style={{width:'100%'}} />
+
+## 您将会看到什么
+
+### 电子邮件线程视图
+
+打开电子邮件线程时，您可以：
+
+* **阅读完整对话**：查看完整的电子邮件交流
+* **查看参与者**：查看电子邮件线程中所有参与者
+* **检查时间戳**：准确了解每封电子邮件的发送时间
+* **访问上下文**：了解完整的通讯历史
+
+### 电子邮件可见性
+
+根据您的邮箱设置，您可能会看到：
+
+* **完整内容**：完整的电子邮件文本和详细信息
+* **主题+元数据**：主题行、发件人、收件人和时间戳
+* **仅元数据**：没有电子邮件内容的基本信息
+
+## 电子邮件同步行为
+
+### 同步速率
+
+Twenty 导入邮件的速度约为**每分钟 400 封**。 该速率目前受 Gmail API 速率限制（其他提供商也有类似限制）。
+
+供参考：
+
+* 1,000 封邮件 → ~2.5 分钟
+* 10,000 封邮件 → ~25 分钟
+* 50,000 封邮件 → ~2 小时
+
+### 同步内容
+
+* **外部电子邮件**：与组织外部联系人的所有电子邮件
+* **自动链接**：将电子邮件连接到现有的联系人和公司记录
+* **多地址**：任何地址发来的电子邮件都链接到同一联系人记录
+* **更新**：新电子邮件会立即显示
+
+### 不同步的内容
+
+* **内部电子邮件**：默认情况下，同事之间（同一域名）的电子邮件将保持私密（可在 设置 → 通用 → 安全 中配置）
+* **群发邮件**：分发列表和群发邮件被排除
+* **排除文件夹**：您选择不进行同步的文件夹（配置于 设置 → 帐户 → 电子邮件）
+
+### 内部电子邮件
+
+选择是否在 Twenty 中同步内部电子邮件：
+
+1. 转到 **设置 → 通用 → 安全**
+2. 将 **同步内部电子邮件** 开关开启/关闭
+
+### 选择性文件夹同步
+
+控制哪些电子邮件文件夹与Twenty同步：
+
+1. 前往**设置 → 账户**并选择您已连接的电子邮件账户
+2. 在电子邮件部分配置文件夹
+3. 选择特定文件夹进行包含或排除（收件箱、已发送、归档、自定义文件夹）
+
+## 电子邮件同步故障排除
+
+### 常见同步问题
+
+* **同步延迟**：电子邮件会立即显示，但初始导入需要更长时间
+* **丢失的电子邮件**：检查以下几项：
+  * 在您消息文件夹设置中排除的文件夹
+  * 自动创建联系人被禁用（电子邮件需要现有的Twenty记录）
+  * 电子邮件来自同事（同一域）或群发列表
+  * 邮箱仍在完成初次同步
+
+### 电子邮件限制
+
+* **系统文件夹**：某些电子邮件文件夹可能无法同步
+* **别名**：只能连接真实邮箱（而不是电子邮件别名）

packages/twenty-docs/l/zh/user-guide/calendar-emails/how-tos/can-i-book-meetings-from-twenty.mdx

@@ -0,0 +1,25 @@
+---
+title: 我可以从 Twenty 预订会议吗？
+description: 关于直接从 Twenty 预订会议的信息。
+---
+
+## 当前状态
+
+Twenty 的日历集成旨在**同步并显示**你现有的日历事件。
+
+## 通过工作流安排会议
+
+虽然无法手动安排会议，但你可以在 Twenty 中使用工作流来安排会议。
+
+1. 创建新的工作流
+2. 根据你的需求选择任意触发器
+3. 添加 **创建日历事件** 节点
+4. 配置所有必要的数据
+5. 激活工作流
+
+## 你可以做什么
+
+* **在“人员”、“公司”和“机会”记录中查看会议历史**
+* **在你的 CRM 中查看与联系人的即将举行的会议**
+* **跟踪会议上下文**，与电子邮件沟通一并查看
+* **从会议参与者中自动创建联系人**

packages/twenty-docs/l/zh/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx

@@ -0,0 +1,53 @@
+---
+title: 我可以从 Twenty 发送电子邮件吗？
+description: 关于直接从 Twenty 发送电子邮件的信息。
+---
+
+## 当前状态
+
+Twenty 的电子邮件集成旨在**同步并显示**你的电子邮件历史记录，并用于撰写和发送电子邮件。
+
+当你在记录页面查看电子邮件会话并点击**回复**时，你可以直接撰写并发送电子邮件。
+
+## 如何从 Twenty 发送消息
+
+前提条件：已连接具有发送电子邮件功能的邮件账户
+
+1. 使用 **Ctrl+K** 或 **Cmd+K** 快捷键打开 Command 菜单
+2. 点击 "Compose email" 选项
+3. 选择收件人，并为电子邮件添加主题、正文和附件
+4. 点击 "Send" 按钮发送电子邮件
+
+## 你现在可以做什么
+
+* **在“人员”、“公司”和“机会”记录中查看电子邮件历史**
+* **在你的 CRM 中阅读与联系人的完整电子邮件会话**
+* **与日历事件一并跟踪沟通上下文**
+* **从电子邮件互动中自动创建联系人**
+* **通过重定向进行回复** — 点击“回复”跳转到你的邮箱
+
+## 通过工作流发送电子邮件
+
+你**可以使用工作流自动发送电子邮件**。 这在以下场景中很有用：
+
+* 自动跟进
+* 向联系人发送通知
+* 基于记录更改触发的沟通
+
+通过工作流发送的电子邮件将通过你已连接的邮箱账户发送。
+
+→ 了解[“发送电子邮件”操作](/l/zh/user-guide/workflows/capabilities/workflow-actions#send-email)
+
+## 电子邮件序列和新闻通讯
+
+对于电子邮件序列和新闻通讯，我们建议使用工作流将 Twenty 连接到专用的电子邮件营销工具。
+
+<Warning>
+为保护你的域名信誉，不应直接从你的邮箱发送群发邮件。 请使用专用工具进行批量沟通。
+</Warning>
+
+→ 请参阅[如何通过工作流发送电子邮件](/l/zh/user-guide/workflows/capabilities/send-emails-from-workflows)以获取设置说明
+
+## 未来计划
+
+在 Twenty 内原生撰写电子邮件已在我们的路线图上。 加入我们的[GitHub 讨论](https://github.com/twentyhq/twenty/discussions)，分享你的用例并帮助我们为此功能确定优先级。

packages/twenty-docs/l/zh/user-guide/calendar-emails/how-tos/can-i-track-email-activity-on-all-objects.mdx

@@ -0,0 +1,35 @@
+---
+title: 我可以在所有对象上跟踪电子邮件活动吗？
+description: 了解跨不同对象的电子邮件活动跟踪。
+---
+
+## 受支持的对象
+
+电子邮件活动目前适用于**三个标准对象**：
+
+| 对象     | 您将会看到什么                    |
+| ------ | -------------------------- |
+| **人员** | 与该特定联系人往来的所有电子邮件           |
+| **公司** | 与该公司任何人之间的所有电子邮件（基于电子邮件域名） |
+| **机会** | 与该商机关联的公司相关的电子邮件           |
+
+## 为什么只有这些对象？
+
+人员、公司和商机是核心关系对象，电子邮件上下文在其中最能发挥价值。 电子邮件会话将根据以下内容自动关联：
+
+* **电子邮件地址** → 匹配到人员记录
+* **电子邮件域名** → 匹配到公司记录
+* **公司关系** → 关联到商机
+
+## 自定义对象
+
+**自定义对象不支持电子邮件跟踪**（目前）。
+
+如果您需要在自定义对象上使用电子邮件上下文，请考虑：
+
+* 使用关系字段将您的自定义对象链接到人员或公司
+* 在关联的人员/公司记录上查看电子邮件历史
+
+## 未来计划
+
+我们正在考虑将电子邮件可见性扩展到自定义对象。 在我们的[GitHub 讨论](https://github.com/twentyhq/twenty/discussions)中分享您的用例，以帮助确定该功能的优先级。

packages/twenty-docs/l/zh/user-guide/calendar-emails/how-tos/connect-several-mailboxes-per-user.mdx

@@ -0,0 +1,42 @@
+---
+title: 每位用户可连接多个邮箱
+description: 为单个用户连接多个电子邮件账户。
+---
+
+## 概览
+
+Twenty 支持**每个用户拥有无限多个电子邮件账户**。 如果你需要管理多个收件箱，这将非常有用，例如：
+
+* 个人工作邮箱 + 团队共享收件箱
+* 多个面向客户的电子邮件地址
+* 针对不同角色使用不同的电子邮件账户
+
+## 如何添加多个邮箱
+
+1. 前往**设置→账户**
+2. 点击**添加账户**
+3. 连接一个额外的 Google 或 Microsoft 帐号，或任何其他支持 IMAP/SMTP 协议的邮件服务提供商
+4. 配置此邮箱的同步设置
+5. 对每个你想连接的邮箱重复上述步骤
+
+## 管理多个账户
+
+每个已连接的邮箱都有各自的设置：
+
+* **电子邮件可见性**：选择团队成员可以看到的内容
+* **联系人自动创建**：可按邮箱启用/禁用
+* **文件夹选择**：选择要同步的文件夹
+
+## 电子邮件如何显示
+
+来自所有已连接邮箱的电子邮件会同步到 Twenty，并显示在：
+
+* **联系人记录**：基于联系人的电子邮件地址
+* **公司记录**：基于电子邮件域名
+* **商机**：基于关联公司
+
+<Note>每封电子邮件都会显示其是从哪个邮箱发送或在哪个邮箱中接收的，因此你可以跟踪每次沟通使用的是哪个账户。</Note>
+
+## 重要说明
+
+<Warning>只能连接真实的邮箱。 将邮件转发到其他邮箱的电子邮件别名无法单独连接——它们会通过主邮箱进行同步。</Warning>

packages/twenty-docs/l/zh/user-guide/calendar-emails/how-tos/i-dont-see-emails-on-records.mdx

@@ -0,0 +1,53 @@
+---
+title: 我在记录中看不到邮件
+description: 排查记录中缺失的邮件。
+---
+
+## 常见原因
+
+### 1. 初始同步仍在进行中
+
+邮件同步需要时间，尤其是邮箱较大时。 Twenty 导入邮件的速度约为**每分钟 400 封**（受 Gmail API 速率限制）。
+
+* **日历同步**：几分钟内完成
+* **邮件同步**：取决于邮箱大小（例如，10,000 封邮件 ≈ 25 分钟，50,000 封邮件 ≈ 2 小时）
+
+**解决方案**：等待初始导入完成。 你可以根据邮箱大小预估所需时间。
+
+### 2. Twenty 中不存在该联系人
+
+邮件只会显示在已存在的联系人记录上。 如果尚未创建联系人：
+
+* 在邮箱设置中启用**联系人自动创建**
+* 或先手动创建联系人记录
+
+**解决方案**：前往 **Settings → Accounts**，选择你的邮箱并启用联系人自动创建。
+
+### 3. 内部邮件不参与同步
+
+为维护隐私，同事之间的邮件（相同邮件域名）绝不会同步。
+
+**解决方案**：这是预期行为。 仅同步外部邮件。
+
+### 4. 邮件来自群组或通讯组
+
+群组邮件和通讯组不参与同步。
+
+**解决方案**：这是预期行为。
+
+### 5. 未选择用于同步的文件夹
+
+如果你正在使用消息文件夹功能，某些文件夹可能被排除。
+
+**解决方案**：前往 **Settings → Accounts**，选择你的邮箱并检查文件夹同步设置。
+
+### 6. 记录中的邮箱地址错误
+
+联系人记录中的邮箱地址可能与邮件中使用的不一致。
+
+**解决方案**：将正确的邮箱地址添加到联系人记录。
+
+## 仍然无法正常工作？
+
+1. 尝试断开并重新连接你的邮箱
+2. 如果问题仍然存在，请联系支持

packages/twenty-docs/l/zh/user-guide/calendar-emails/how-tos/limit-emails-imported.mdx

@@ -0,0 +1,58 @@
+---
+title: 限制导入的电子邮件
+description: 控制哪些电子邮件被导入Twenty。
+---
+
+## 概览
+
+默认情况下，Twenty 会从您已连接的邮箱同步所有外部电子邮件。 您可以使用**文件夹选择**和**可见性设置**来限制导入的内容。
+
+## 方法一：文件夹选择（推荐）
+
+控制哪些电子邮件文件夹与Twenty同步：
+
+1. 进入 **设置 → 账户**
+2. 选择您已连接的电子邮件账户
+3. 选择要同步的文件夹：
+
+| 文件夹        | 描述          |
+| ---------- | ----------- |
+| **收件箱**    | 主要的收件电子邮件   |
+| **已发送**    | 您发送的外发电子邮件  |
+| **存档**     | 已存档的电子邮件    |
+| **自定义文件夹** | 您想要的任何特定文件夹 |
+
+4. 排除您不希望同步的文件夹（垃圾邮件、回收站、个人文件夹）
+
+<Note>这使您可以精确控制哪些电子邮件显示在您的CRM中，而无需同步所有内容。</Note>
+
+## 方法二：联系人自动创建设置
+
+控制何时从电子邮件创建联系人：
+
+1. 前往**设置→账户**
+2. 选择您已连接的邮箱
+3. 选择一个选项：
+   * **已停用**：不会创建联系人，但电子邮件仍会同步到现有联系人。
+   * **已发送和已接收**：从所有外部电子邮件创建联系人
+   * **仅限已发送**：仅根据您发送的电子邮件创建联系人
+
+## 内部电子邮件
+
+同事之间（同一域名）的邮件可以在 Twenty 中同步：
+
+1. 转到 **设置 → 通用 → 安全**
+2. 将 **同步内部电子邮件** 开关开启/关闭
+
+<Note>默认情况下，此选项处于关闭状态。</Note>
+
+## 始终排除的内容
+
+无论设置如何，这些电子邮件都不会被同步：
+
+* **群组邮件**：分发列表和群组消息
+* **垃圾邮件/回收站**：系统文件夹通常会被排除
+
+## 重要提示
+
+<Note>我们暂时尚未提供用于选择性同步的 CC 电子邮件地址。 请使用上面的文件夹选择功能来实现同等程度的控制。</Note>

packages/twenty-docs/l/zh/user-guide/calendar-emails/overview.mdx

@@ -0,0 +1,144 @@
+---
+title: 日历与电子邮件
+description: 将您的电子邮件和日历账户连接到 Twenty。
+---
+
+## 连接选项
+
+### Google账号（Gmail和Google日历）
+
+1. 转到 **设置 → 账户**
+2. 点击**添加账户**
+3. 选择**继续使用Google**
+4. 授权 Twenty 访问您的 Gmail 和 Google 日历
+5. 配置电子邮件同步设置（可见性、自动创建）→ 点击 **下一步**
+6. 配置日历同步设置（可见性、自动创建）→ 点击 **添加账户**
+7. 您的电子邮件和日历事件将自动开始同步
+
+### Microsoft 账户（Outlook 和 Microsoft 日历）
+
+1. 转到 **设置 → 账户**
+2. 点击**添加账户**
+3. 选择**继续使用Microsoft**
+4. 授权 Twenty 访问您的 Outlook 和 Microsoft 日历
+5. 配置电子邮件同步设置（可见性、自动创建）→ 点击 **下一步**
+6. 配置日历同步设置（可见性、自动创建）→ 点击 **添加账户**
+7. 您的电子邮件和日历事件将自动开始同步
+
+### IMAP/SMTP/CalDAV设置（其他提供商）
+
+对于其他电子邮件和日历提供商：
+
+1. 前往**设置→账户**
+2. 配置 IMAP 设置以同步接收邮件，并配置 SMTP 设置以发送邮件
+3. 配置日历的CalDAV设置
+4. 测试连接
+
+<Note>
+**在物理隔离或内部网络中自托管**：默认情况下，Twenty 会拒绝到私有/内部 IP 地址的出站连接（SSRF 保护）。 如果你的邮件或日历服务器运行在本地/私有 IP 上（例如局域网中的本地部署服务器），与其的连接将会被阻止。 要允许这些连接，请在服务器上设置以下环境变量：
+
+```
+OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
+```
+
+这会为**所有**出站请求（HTTP 工作流操作、Webhook，以及 IMAP/SMTP/CalDAV 连接）禁用安全模式，因此只应在无需 SSRF 保护的受信任、隔离网络中进行此设置。
+</Note>
+
+### 多个邮箱
+
+* **无限账户**：每用户可连接多个电子邮件账户
+* **账户管理**：在不同邮箱之间切换
+* **同步设置**：为各邮箱配置不同设置
+
+<Warning>
+只能连接真正的邮箱（如：support@domain.com及其独立收件箱）。 电子邮件别名转发到其他邮箱不能连接到Twenty。
+</Warning>
+
+## 电子邮件配置
+
+### 邮件可见性
+
+为您的电子邮件选择不同的可见性级别：
+
+* **仅元数据**：仅分享基本信息（发件人、收件人、日期、时间）
+* **主题和元数据**：分享主题行以及元数据
+* **所有电子邮件内容**：分享全部电子邮件内容，包括附件
+
+### 联系人自动创建
+
+* **已停用**：无自动联系人创建
+* **发送和接收消息**：为所有外部电子邮件交互创建联系人
+* **仅用于发送的消息**：仅为您发送的电子邮件创建联系人
+* **注意**：默认情况下，内部电子邮件（所有参与者都使用你的域名）不会被同步，以保护隐私
+
+<Note>启用后，联系人会根据其电子邮件域名自动关联到其公司记录。 如果该公司尚不存在，Twenty 会为您创建该公司。</Note>
+
+<Note>
+**同步内部电子邮件**："未同步内部电子邮件" 的行为是默认设置，但可以关闭。 该切换位于高级设置中：
+1. 打开 **设置**，并在设置页面底部启用 **高级** 切换开关
+2. 转到 **常规 → 安全**
+3. 启用 **同步内部电子邮件** 切换开关，以包含所有参与者共享同一域名的电子邮件
+
+这是一个针对整个工作区的设置（对大学或共享域组织非常有用）。
+</Note>
+
+### 通过消息文件夹选择控制哪些电子邮件同步
+
+控制哪些电子邮件文件夹与Twenty同步：
+
+1. 前往**设置 → 账户**并选择您已连接的电子邮件账户
+2. 选择要同步的文件夹：
+   * **收件箱**：主要的收入电子邮件
+   * **已发件箱**：您发送的外发电子邮件
+   * **自定义文件夹**：您希望包含的任意特定文件夹
+   * **排除文件夹**：跳过像垃圾邮件、垃圾桶或个人文件夹这样的文件夹
+
+这样您无需同步所有内容，即可精确控制哪些电子邮件会出现在您的客户关系管理系统中。
+
+**同步内容**：
+
+* **外部电子邮件**：所有具有外部联系人的电子邮件来自选择的文件夹
+* **内部电子邮件**：默认不进行同步（同域邮件保留隐私）。 在 **设置** 底部启用 **高级** 切换开关，然后在 **常规 → 安全** 下打开 **同步内部电子邮件**，即可在整个工作区内将其包含在内。
+* **附件**：2026年H1推出
+
+**注意**：我们不提供选择性同步的CC电子邮件地址。 相反，使用上述消息文件夹功能来实现同样水平的电子邮件同步控制。
+
+## 日历配置
+
+### 事件可见性
+
+选择其他用户在您的工作区中可见的内容：
+
+* **Everything**：整个事件的详细信息将与您的团队分享
+* **Metadata**：只有日期和参与者将共享给您的团队
+
+### 会议的联系人自动创建
+
+* **是**：自动为非CRM中的会议参与者创建联系人
+* **否**：仅将会议链接到现有联系人
+
+<Note>启用后，联系人会根据其电子邮件域名自动关联到其公司记录。 如果该公司尚不存在，Twenty 会为您创建该公司。</Note>
+
+### 控制哪些事件被同步
+
+* **会议导入**：自动导入日历事件
+* **联系人链接**：将会议链接到人员和公司记录
+
+**同步内容**：
+
+* **会议**：包含外部参与者的日历事件
+* **联系人链接**：事件自动链接到CRM记录
+* **团队事件**：共享日历可见性
+
+## 同步频率
+
+**每5分钟更新**：电子邮件和日历数据在首次导入后每5分钟自动同步。
+
+<Note>
+**初始同步耗时**: 日历同步完成很快 (通常在几分钟内)，而对于大型邮箱，邮件同步耗时更长。 Twenty 以约**每分钟 400 封**的速度导入邮件 (受 Gmail API 速率限制)，因此包含 10,000 封邮件的邮箱大约需要 25 分钟。 如果您看到来自日历事件的联系人早于电子邮件联系人出现，请不必担心；这是正常行为。
+</Note>
+
+## 下一步
+
+* [邮箱功能](/l/zh/user-guide/calendar-emails/capabilities/mailbox)
+* [排查缺失的电子邮件](/l/zh/user-guide/calendar-emails/how-tos/i-dont-see-emails-on-records)