📖 系列文章

• （一）准备工作
• （二）Day 1：飞书基础环境搭建
• （三）Day 2：飞书Bot开发配置
• （四）Day 3：Gitee和TRAE集成
• （五）Day 4：多维表格和自动化工作流
• （六）Day 5：完整场景实操验证
• （七）FAQ与附录

---

---

4 Day 3：Gitee和TRAE集成

Day 3的目标是打通代码仓库（Gitee）和自动化工作流（TRAE Work），实现代码变更通知和每日数据同步。

4.1 注册和配置Gitee

4.1.1 注册Gitee账号

步骤1：注册

访问 https://gitee.com，点击右上角"注册"。推荐使用企业邮箱注册，便于后续创建企业组织。

4.1.2 创建组织

步骤2：创建Gitee组织

注册完成后，点击右上角头像 → “+” → “创建组织”：

• 组织名称：使用团队英文名（例如 startech）
• 组织路径：会自动生成（例如 startech）
• 组织描述：简短描述团队信息

4.1.3 创建仓库

步骤3：创建代码仓库

在组织页面中，点击"新建仓库"：

• 仓库名称：main-project（或你的项目名称）
• 仓库介绍：简要描述项目
• 是否开源：选择"私有"（推荐）
• 初始化仓库：选择"初始化仓库（添加README）"

4.1.4 获取Personal Access Token

步骤4：生成Personal Access Token

Personal Access Token 用于通过API访问Gitee（在自动化工作流中会用到）：

1. 点击右上角头像 → “设置”
2. 左侧导航栏 → “私人令牌”
3. 点击"生成新令牌"
4. 令牌描述：TRAE Work Automation
5. 权限范围：勾选 projects（读取项目信息）、pull_requests（读取PR信息）
6. 点击"提交"
7. 立即复制并保存令牌（只显示一次！）

⚠️ 注意：
Gitee的Personal Access Token只在创建时显示一次，关闭页面后将无法再次查看。
请务必在生成后立即复制并保存到安全的地方。

4.2 配置TRAE Work自动化

TRAE Work 是TRAE IDE内置的自动化任务调度系统，可以定时执行任务。我们将用它来配置每日数据同步工作流。

步骤1：打开自动化配置

在TRAE Work的左侧导航栏中，找到并点击"自动化"（Automation）入口。

步骤2：创建定时任务

点击"手动新建"按钮，进入任务创建界面。界面包含以下字段：

字段名	类型	填写内容	说明
任务名称	文本输入	每日数据同步-项目早报	便于识别任务用途
触发时间	下拉选择 + 时间输入	选择"每天"，时间填写 09:00	每天早上9点自动执行
你希望TRAE Work做什么？	文本输入框	粘贴Message模板（见4.3节）	具体的执行指令

💡 提示：
"你希望TRAE Work做什么？"这个文本框是TRAE Work的核心。
你在这里描述的任务会被TRAE Work的AI理解并自动执行。
任务描述越清晰、越具体，执行效果越好。

4.3 TRAE Work 每日数据同步工作流配置

这是本教程中最重要的配置之一。我们需要编写一个 Message模板，让TRAE Work每天早上自动执行以下工作流：

1. 使用 App ID 和 App Secret 获取飞书访问凭证
2. 自动遍历飞书多维表格（从wiki链接获取 app_token，遍历所有table和view）
3. 获取Gitee仓库的PR信息
4. 汇总数据并输出到飞书群聊

Message模板编写思路

Message模板是你与TRAE Work AI沟通的"指令集"。一个好的Message模板需要清晰地告诉AI：

• 要做什么（获取哪些数据）
• 怎么做（调用哪些API，参数是什么）
• 输出什么（汇总报告的格式和发送目的地）

模板核心结构（5步工作流）

第 0 步：参数配置

在模板开头定义所有需要填写的变量，方便后续步骤引用。关键变量包括：

变量名	说明	获取方式
FEISHU_APP_ID	飞书应用ID	飞书开放平台 → 凭证与基础信息
FEISHU_APP_SECRET	飞书应用密钥	飞书开放平台 → 凭证与基础信息
WIKI_URL	多维表格的Wiki链接	打开多维表格，复制浏览器地址栏URL
GITEE_OWNER	Gitee组织/用户名	Gitee组织页面路径
GITEE_REPO	Gitee仓库名	Gitee仓库页面路径
GITEE_ACCESS_TOKEN	Gitee API令牌	Gitee设置 → 私人令牌
FEISHU_CHAT_ID	飞书群聊ID	通过Bot API获取或从群聊设置中查看
WEBHOOK_URL	飞书Webhook地址	群设置 → 群机器人 → 自定义机器人 → Webhook地址

第 1 步：获取飞书访问凭证

调用飞书 tenant_access_token 接口，使用 FEISHU_APP_ID 和 FEISHU_APP_SECRET 获取访问令牌。后续所有飞书API调用都需要携带此token。

第 2 步：飞书多维表格自动遍历

1. 从 WIKI_URL 中解析出 app_token
2. 调用接口获取该多维表格下的所有table列表
3. 对每个table，获取其所有view列表
4. 读取每个view中的数据记录（分页获取）
5. 从记录中提取关键信息：
   • 项目管理表：待处理/处理中/已完成任务数、超期任务、今日到期任务
   • CRM表：潜在客户数、待跟进客户数、本月新增客户数

第 3 步：Gitee PR 获取

调用Gitee API获取仓库的Pull Request列表，提取开放PR的总数及每个PR的标题、创建者、创建时间等信息。

第 4 步：数据汇总与输出

将以上所有数据汇总为一份结构化的 每日项目早报，通过飞书Bot发送到指定群聊。

第 5 步：异常处理

• 如果飞书API返回错误，记录错误并跳过该步骤
• 如果Gitee API返回错误，在日报中标注"Gitee数据获取失败"
• 确保即使部分数据获取失败，Bot仍能发送基础日报

---

完整Message模板

📎 完整版Message模板

本文仅提供模板的编写思路和核心结构。完整的、可直接复制使用的Message模板（包含全部参数配置、API调用细节、异常处理逻辑和格式化输出代码）已作为附件提供。

完整模板的优势：

• 开箱即用，直接粘贴到TRAE Work即可运行
• 包含详细的参数化变量设计，只需修改第0步的配置即可
• 内置完整的异常处理和容错机制
• 可调用Gitee的commit记录
• 输出格式经过优化，美观易读
• 可直接通过BOT机器人直接输出到指定的飞书群

下载链接：完整Message模板。

变量配置检查清单

变量名	说明	获取方式
FEISHU_APP_ID	飞书应用ID	飞书开放平台 → 凭证与基础信息
FEISHU_APP_SECRET	飞书应用密钥	飞书开放平台 → 凭证与基础信息
WIKI_URL	多维表格的Wiki链接	打开多维表格，复制浏览器地址栏URL
GITEE_OWNER	Gitee组织/用户名	Gitee组织页面路径
GITEE_REPO	Gitee仓库名	Gitee仓库页面路径
GITEE_ACCESS_TOKEN	Gitee API令牌	Gitee设置 → 私人令牌
FEISHU_CHAT_ID	飞书群聊ID	通过Bot API获取或从群聊设置中查看

⚠️ 注意：
请将模板中的所有占位符替换为你的真实值。特别注意：

• App ID以 cli_ 开头
• App Secret是纯字符串（不要加引号）
• Gitee Token是字符串（不要加引号）

4.4 Gitee Webhook通知配置

除了定时任务，我们还需要配置Gitee的Webhook，让代码变更事件能够实时推送到飞书。

步骤1：在飞书群聊中添加自定义机器人

打开"[团队名]-代码通知"群聊：

1. 点击群设置（右上角"…"）
2. 选择"群机器人"
3. 点击"添加机器人"
4. 选择"自定义机器人"（通过Webhook接入）
5. 输入机器人名称：Gitee通知
6. 复制生成的Webhook URL

步骤2：在Gitee仓库中配置Webhook

在Gitee仓库页面中：

1. 点击"管理"→"WebHooks"
2. 点击"添加WebHook"
3. URL：粘贴上一步复制的飞书Webhook URL
4. 密码：留空（飞书自定义机器人Webhook不需要密码）
5. 勾选触发事件：
   • Pull Request（PR创建、更新、关闭）
   • Push（代码推送）
   • Issue（问题创建、更新）
6. 点击"提交"

💡 提示：
飞书自定义机器人的Webhook格式与Gitee标准Webhook格式不完全一致。
如果直接使用Webhook URL，Gitee推送的JSON数据可能无法被飞书正确解析。
更可靠的方式是通过TRAE Work或中间服务进行格式转换，将Gitee事件转换为飞书消息格式后发送。

4.5 Day 3 完成清单

• Gitee账号已注册，组织已创建
• 代码仓库已创建（main-project）
• Gitee Personal Access Token已生成并安全保存
• TRAE Work自动化任务已创建（“每日数据同步-项目早报”）
• Message模板中的所有变量已替换为真实值
• Gitee Webhook已配置到飞书代码通知群
• 手动测试过一次数据同步流程