# 用 WorkBuddy 辅助搭建飞书日报自动提醒系统：GitHub Actions + 多维表格 + Server酱 落地实录

> 带团队做日报/周报，最怕两件事：每天卡点手工汇总、负责人一请假就断档。我用一套几乎零成本的自动化把这个痛点彻底解决——飞书多维表格做数据源、GitHub Actions 免费定时跑、飞书卡片推主通道、Server酱 微信做兜底。本文完整复盘从 0 到上线的全过程，含可直接抄的代码和 5 个真实踩坑。

> 作者注：本文是一个真实落地的团队自动化项目复盘。核心系统用 Python + GitHub Actions 实现，开发、调试、图表生成环节大量借助 WorkBuddy 提效。文中所有 token / key 均从环境变量读取，未硬编码任何真实凭证；清单与代码注释里的 SCTxxxxxxxxXXXX、环境变量名等仅为格式示例，读者请替换为自己在飞书开放平台/Server酱 后台申请的真实值，并放入 GitHub Secrets。

> 以下为本文各章节配套截图汇总（含字段设计、权限页、排行图、Server酱、Actions 日志），可对照正文查看：

![](https://developer.qcloudimg.com/http-save/yehe-9888522/aa03b3b42406b095302200c2f1f4641a.png)

## 目录

1. 一、背景与痛点
2. 二、整体架构
3. 三、准备工作清单
4. 四、步骤1：设计飞书多维表格
5. 五、步骤2：Python 读取数据并生成仪表板
6. 六、步骤3：Server酱 微信兜底推送
7. 七、步骤4：GitHub Actions 定时部署
8. 八、踩坑记录与解决方案（重点）
9. 九、用 WorkBuddy 提效的几点实践
10. 十、总结与收益

---

## 一、背景与痛点

我是某运营商城西支局"工作日报"体系的负责人。每天 17:30 前，团队需要把当天的**移网、宽带、Pro 完成档位**等指标汇总上报，并在内部做业绩排行。

手工做有三大痛点：

1. **人工收集慢**：数据散在每个人的表格里，汇总靠复制粘贴，17:30 经常卡点。
2. **排行不直观**：谁第一、谁垫底全靠肉眼看，缺少统一视图。
3. **漏发无兜底**：负责人请假或忘记，当天日报就断档，上级收不到。

目标很明确：**每日定时自动拉取多维表格数据 → 生成仪表板 → 推送到飞书 + 微信兜底**，全程无人值守。

## 二、整体架构

```
┌─────────────┐    ┌──────────────────┐    ┌──────────────┐
│ 飞书多维表格 │───▶│ GitHub Actions   │───▶│ 飞书卡片推送 │
│ (Bitable)   │    │ (每日 17:30 UTC) │    │ (主通道)     │
└─────────────┘    └──────────────────┘    └──────────────┘
                           │ 失败
                           ▼
                    ┌──────────────┐
                    │ Server酱推送  │
                    │ (微信兜底)    │
                    └──────────────┘
```

- **数据源**：飞书多维表格（字段：员工、日期、移网、宽带、Pro 完成档位）。
- **调度**：GitHub Actions 定时任务（免费、无需自建服务器）。
- **主推送**：飞书机器人卡片（含排名，第一绿色、末位红色标识）。
- **兜底**：Server酱（微信推送），飞书主通道失败时自动切换。

## 三、准备工作清单

| 项目 | 说明 |
|---|---|
| 飞书开放平台应用 | 创建企业自建应用，开通「多维表格」与「机器人」权限 |
| 多维表格 App Token | 表格 URL 中的 `base/xxxxxxxx` 部分 |
| 多维表格 Table ID | 数据表 `tblxxxxxxxx` |
| 飞书 App ID / Secret | 用于换取 `tenant_access_token` |
| Server酱 SendKey | 形如 `SCTxxxxxxxxXXXX`（x 为随机字符），微信扫码绑定后获得 |
| GitHub 仓库 | 私有仓库即可，存放脚本与 Secrets |

## 四、步骤1：设计飞书多维表格

字段建议（均为「文本/数字/单选」类型，方便脚本读取）：

| 字段名 | 类型 | 说明 |
|---|---|---|
| 员工 | 文本 | 姓名或工号 |
| 日期 | 日期 | 日报所属日期 |
| 移网 | 数字 | 当日移网办理量 |
| 宽带 | 数字 | 当日宽带办理量 |
| Pro完成档位 | 单选 | 如 达标 / 未达标 |

## 五、步骤2：Python 读取数据并生成仪表板

核心脚本 `gen_report.py`，逻辑分四步：获取 token → 拉取记录 → 计算排行 → 组装卡片。

```python
# gen_report.py（节选，凭证从环境变量读取，切勿硬编码）
import os, requests
from datetime import date

APP_ID = os.environ["FEISHU_APP_ID"]
APP_SECRET = os.environ["FEISHU_APP_SECRET"]
BASE_TOKEN = os.environ["BITABLE_APP_TOKEN"]
TABLE_ID = os.environ["BITABLE_TABLE_ID"]

def get_tenant_token():
    # 注意：tenant_access_token 有效期仅 2 小时，必须每次请求前刷新
    r = requests.post("https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
                     json={"app_id": APP_ID, "app_secret": APP_SECRET}, timeout=10)
    return r.json()["tenant_access_token"]

def fetch_records(token):
    url = f"https://open.feishu.cn/open-apis/bitable/v1/apps/{BASE_TOKEN}/tables/{TABLE_ID}/records"
    headers = {"Authorization": f"Bearer {token}"}
    out, page = [], 1
    while True:  # 多维表格单页上限 500 条，需翻页
        r = requests.get(url, headers=headers, params={"page_size": 500, "page_token": str(page)}, timeout=10)
        data = r.json()["data"]
        out.extend(data["items"])
        if not data.get("has_more"):
            break
        page += 1
    return out

def rank(rows):
    # 复合指标：移网 + 宽带 + Pro 达标加权
    for row in rows:
        f = row["fields"]
        score = f.get("移网", 0) + f.get("宽带", 0) + (10 if f.get("Pro完成档位") == "达标" else 0)
        f["_score"] = score
    rows.sort(key=lambda x: x["fields"]["_score"], reverse=True)
    return rows

if __name__ == "__main__":
    tk = get_tenant_token()
    rows = rank(fetch_records(tk))
    today = date.today().isoformat()
    print(f"== {today} 城西支局业绩排行 ==")
    for i, row in enumerate(rows, 1):
        tag = "🟢第一" if i == 1 else ("🔴末位" if i == len(rows) else "")
        print(f"{i}. {row['fields']['员工']} 综合 {row['fields']['_score']} {tag}")
```

仪表板生成后，组装飞书卡片消息（含排名表格，第一绿、末位红）。卡片模板此处略，可参考飞书开放平台「消息卡片」文档。

## 六、步骤3：Server酱 微信兜底推送

主通道（飞书）偶发失败——比如 webhook 被限流、网络抖动。此时用 Server酱 把同样的内容推到微信，保证负责人一定收到。

```python
def push_serverchan(text, desp=""):
    key = os.environ["SCT_SENDKEY"]  # 形如 SCTxxxxxxxxXXXX（x 为随机字符）
    # 优先用 Turbo 通道，支持 Markdown
    url = f"https://sctapi.ftqq.com/{key}.send"
    try:
        r = requests.post(url, data={"title": text, "desp": desp}, timeout=10)
        return r.json().get("code") == 0
    except Exception as e:
        print("Server酱推送异常:", e)
        return False

# 在飞书推送失败后调用
if not push_feishu(card):
    push_serverchan("城西支局日报（兜底）", md_content)
```

## 七、步骤4：GitHub Actions 定时部署

关键文件 `.github/workflows/daily-report.yml`：

```yaml
name: 城西支局工作日报
on:
  schedule:
    # ⚠️ GitHub Actions 使用 UTC 时间！北京时间 17:30 = UTC 09:30
    # 周一至周五（1-5）触发
    - cron: '30 9 * * 1-5'
  workflow_dispatch:  # 允许手动触发调试

jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - run: pip install requests python-dotenv
      - run: python gen_report.py
        env:
          FEISHU_APP_ID: ${{ secrets.FEISHU_APP_ID }}
          FEISHU_APP_SECRET: ${{ secrets.FEISHU_APP_SECRET }}
          BITABLE_APP_TOKEN: ${{ secrets.BITABLE_APP_TOKEN }}
          BITABLE_TABLE_ID: ${{ secrets.BITABLE_TABLE_ID }}
          SCT_SENDKEY: ${{ secrets.SCT_SENDKEY }}
```

凭证通过仓库 **Settings → Secrets and variables → Actions** 配置，脚本只从环境变量读，绝不入库。

## 八、踩坑记录与解决方案（重点）

| 坑 | 现象 | 解决 |
|---|---|---|
| **cron 时区** | 按北京时间写 `30 17 * * 1-5`，结果凌晨触发 | GitHub Actions 用 UTC，北京时间 17:30 → `30 9 * * 1-5` |
| **token 过期** | 运行到一半报 99991663 无效 token | `tenant_access_token` 仅 2 小时有效，每次运行重新获取，不要缓存 |
| **翻页缺失** | 数据超过 500 条后排行不全 | 循环翻页直到 `has_more=false` |
| **主通道偶发失败** | 飞书卡片偶尔推送不到 | 加 Server酱 兜底，失败即切微信 |
| **secrets 泄露风险** | 早期把 token 写死在脚本里 | 全部移入 GitHub Secrets + 环境变量 |

## 九、用 WorkBuddy 提效的几点实践

这套系统不是一口气写出来的，迭代过程大量用到 WorkBuddy：

1. **脚本初版生成**：把"读飞书多维表格 + 翻页"的需求一句话丢给 WorkBuddy，直接产出可改骨架，省去查 API 文档时间。
2. **调试 cron 时区**：当时卡在"为什么凌晨触发"，用 WorkBuddy 的 Ask 模式问时区换算，几句话定位，没花积分反复试。
3. **图表生成**：内部周报的柱状图/排行图，用 WorkBuddy 跑 Python 脚本批量出 PNG，直接转发微信群。
4. **低风险查询走 Ask 模式**：查飞书 API 字段、Server酱 接口格式这类纯咨询，切 Ask 模式不动文件，积分消耗最低。

> 经验：把 WorkBuddy 当"结对程序员"——复杂编码交 Craft 模式，纯查资料交 Ask 模式，成本差好几倍。

## 十、总结与收益

落地后，城西支局日报实现**零人工值守**：每天 17:30 自动出榜，第一绿、末位红一目了然，主通道失败还有微信兜底。

- **时间成本**：从每天 20 分钟手工汇总 → 0 分钟。
- **可靠性**：兜底通道让漏发率降到 0。
- **可扩展**：换指标、加人只需改多维表格，脚本无需动。

如果你也在带团队做日报/周报，这套「飞书多维表格 + GitHub Actions + Server酱」组合几乎零成本，强烈推荐照抄。


带团队做日报/周报，最怕两件事：每天卡点手工汇总、负责人一请假就断档。我用一套几乎零成本的自动化把这个痛点彻底解决——飞书多维表格做数据源、GitHub Actions 免费定时跑、飞书卡片推主通道、Server酱 微信做兜底。本文完整复盘从 0 到上线的全过程，含可直接抄的代码和 5 个真实踩坑。

用 WorkBuddy 辅助搭建飞书日报自动提醒系统：GitHub Actions + 多维表格 + Server酱 落地实录

带团队做日报，最怕手工汇总卡点、负责人一请假就断档。本文完整复盘用飞书多维表格 + GitHub Actions + Server酱 搭一套零成本的日报自动提醒系统：每日 17:30 自动拉数出榜、飞书卡片主推、微信兜底，含可直接抄的代码和 5 个真实踩坑（cron 时区、token 过期、翻页缺失等）。

编程语言

开发工具

运维

使用GitHub Actions定时拉取飞书多维表格数据，自动生成业绩排行仪表板，通过飞书卡片推送主通道，Server酱微信兜底，实现日报零人工值守。支持翻页读取、token自动刷新、时区修正，含完整代码与踩坑指南。

代码解释

服务器

WorkBuddy 

Python

GitHub

WorkBuddy企业版限时双倍 Credits 活动

workbuddy

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

用 WorkBuddy 辅助搭建飞书日报自动提醒系统：GitHub Actions + 多维表格 + Server酱 落地实录-腾讯云开发者社区-腾讯云

用 WorkBuddy 辅助搭建飞书日报自动提醒系统：GitHub Actions + 多维表格 + Server酱落地实录

用 WorkBuddy 辅助搭建飞书日报自动提醒系统：GitHub Actions + 多维表格 + Server酱落地实录

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

用 WorkBuddy 辅助搭建飞书日报自动提醒系统：GitHub Actions + 多维表格 + Server酱 落地实录

用 WorkBuddy 辅助搭建飞书日报自动提醒系统：GitHub Actions + 多维表格 + Server酱 落地实录

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

用 WorkBuddy 辅助搭建飞书日报自动提醒系统：GitHub Actions + 多维表格 + Server酱落地实录

用 WorkBuddy 辅助搭建飞书日报自动提醒系统：GitHub Actions + 多维表格 + Server酱落地实录