这次我们来看一个办公自动化方向的开源资源：workbuddy。从标题和相关资料看，它的定位是“能连接飞书和企业微信的 AI 办公助手”，作者把 10 节原本付费级的课程全部开源，同时附带了完整文档，学习路径面向零基础用户。
先说清楚它能解决什么。常见的办公场景里，消息、待办、周报、群通知这些信息散落在飞书和企业微信里，人工整理成本很高。workbuddy 的思路是把飞书/企业微信的机器人、消息推送、事件回调这些能力，接到一套统一的 AI 工作流里。用户不需要写复杂的后端代码，而是通过配置和 skill 技能，让助手完成消息发送、任务提醒、周报汇总、批量通知等操作。
这篇文章不会把 10 节课的内容原样重复一遍，而是把与部署、验证、排错相关的技术信息整理成一份可直接照做的笔记。全文会覆盖：课程结构是什么、环境要准备什么、怎么创建飞书应用、怎么创建企业微信应用、怎么验证消息收发、批量任务怎么做、资源和性能怎么看、遇到问题怎么排查。如果你正在找 workbuddy 的使用教程，这篇文章可以直接当作安装和调试阶段的补充资料。
1. workbuddy 核心能力速览
在开始安装之前，先把核心信息列成一张表，方便你判断这个项目值不值得花时间。
| 项目类型 | 办公 AI 助手 / 办公自动化工作流 |
|---|---|
| 主要能力 | 连接飞书、企业微信，完成消息收发、任务待办、周报总结、skill 技能扩展、AI 指令式交互 |
| 课程形态 | 10 节付费级课程 + 完整文档，已开源 |
| 学习门槛 | 零基础可学，不需要先掌握复杂编程 |
| 运行环境 | 本地开发机或服务器，Windows / Linux / macOS 均可，具体以项目文档为准 |
| 部署方式 | Git 克隆 + Python 虚拟环境 + 启动服务，可选择 Web UI 或服务端运行 |
| 接口能力 | 通过飞书/企业微信开放平台接口实现消息、事件、待办等能力 |
| 批量任务 | 支持消息推送式的批量任务，也可以配合外部表格数据做批量触发 |
| 典型用户 | 个人开发者、小团队、需要办公消息自动化的职场人 |
| 数据边界 | 生产环境使用前必须确认数据流向和授权范围 |
这张表里的信息并不代表每个细节都可以直接照搬，例如“运行环境”和“启动脚本”会因为仓库版本不同而变化。建议在动手前先打开对应的 GitHub 仓库，把 README 和文档里的环境要求核一遍，再决定用哪套安装流程。
2. 这套开源课程适合什么人
2.1 适合的人群
第一类是零基础用户。如果你没有写过完整的后端服务，但希望在自己的团队里做一个能自动发通知、汇总待办的机器人，这个课程的学习路径比较友好。它不会一上来就丢给你复杂的微服务概念，而是先带你跑通一个最小可用的例子。
第二类是已经在使用飞书或企业微信的职场人。公司内部可能有大量消息提醒和重复操作，比如每天把新建任务推送到群里、每周生成周报草稿、定时提醒项目截止日期。这些场景都可以落到 workbuddy 的工作流里。
第三类是内部工具开发者和效率爱好者。即使你不直接使用 workbuddy，也可以从课程里学到飞书/企业微信开放平台的应用创建流程、token 获取方式、事件回调配置方法，这些知识在开发任何办公机器人时都通用。
2.2 不适合的场景
如果只是想在网页里做一个聊天 UI，不接入飞书或企业微信，这套课程不是最优选择。如果需要企业级的多租户权限体系、严格审批流、审计日志，需要自己在 workbuddy 外层再做权限控制。另外，如果公司有严格的数据合规要求，不允许办公数据流向外部 AI 服务，必须先评估数据流向，不能直接上线。
3. 10 节课到底学什么：学习路径拆解
标题明确写了“10 节课程”，但每一节的完整正文没有在当前材料里逐字给出。下面按照 workbuddy 的功能模块和常见学习路径，把 10 节课整理成一条从入门到精通的路线。实际学习时，请以开源仓库中的课程文档为准。
3.1 主线学习路径
| 阶段 | 学习内容 | 学习目标 |
|---|---|---|
| 入门 | workbuddy 是什么、整体架构、核心概念 | 理解它能做什么，不能做什么 |
| 准备 | 飞书开放平台、企业微信管理后台的账号与权限 | 准备好所有前置条件 |
| 部署 | 本地安装、依赖管理、启动服务 | 让 workbuddy 在本地跑起来 |
| 飞书接入 | 创建自建应用、配置机器人、消息收发 | 打通飞书消息通道 |
| 企业微信接入 | 创建自建应用、配置回调、应用消息推送 | 打通企业微信通道 |
| 技能扩展 | skill 机制、自定义技能 | 把常用操作封装成技能 |
| 指令设计 | 提示词、任务指令、参数解析 | 让 AI 准确理解用户意图 |
| 场景落地 | 待办、周报、定时提醒 | 把能力用到实际工作流 |
| 调试 | 日志、token、回调地址、错误码 | 快速排查问题 |
| 进阶 | 批量任务、团队使用、运维 | 从个人工具变成团队能力 |
3.2 自学建议
第一遍学习时，不要追求把所有代码都读懂，先按课程步骤把“飞书能发消息、企业微信能收到消息”这两个目标跑通。跑通之后，再回来看 skill 和提示词设计。这样从能用到理解，是最稳的路径。如果某一节内容卡住超过半小时，不要硬耗，先跳到下一节，很多问题在后续章节里会解释。
4. 环境准备与前置条件
4.1 需要准备的账号
要连接飞书，需要进入飞书开放平台，创建一个企业自建应用。即使你个人使用，也需要注册一个飞书企业或团队才能创建应用。要连接企业微信，需要进入企业微信管理后台，创建自建应用。这里有一个常见误区：个人微信和企业微信不是同一个平台，workbuddy 连接的是企业微信的管理后台能力。
4.2 本地环境要求
推荐配置是一台 2 核 4G 以上的 Linux 服务器或本地开发机。Windows 和 macOS 也能运行，但安装依赖的步骤会有差异。workbuddy 本身如果只做消息通道，CPU 和内存占用不会很高；如果后续接入本地 AI 模型，资源要求会明显上升。
依赖层面，至少需要 Python 3.9 和 Git，部分版本可能需要 Node.js。安装前先检查：
python3 --version git --version node -v如果 node 命令不存在，不影响 Python 版本的情况下可以跳过，具体看仓库 README。
4.3 网络和回调地址
飞书和企业微信的开放接口在国内网络环境可以直接访问，不需要额外代理。需要注意的一点是：事件订阅和回调需要公网地址可访问。如果你在本地开发，服务端口不能被外网直接访问，需要把服务部署到有公网 IP 的服务器，或者使用合法的内网穿透方案。生产环境不建议长期使用穿透方案，因为安全性和稳定性都不可控。
5. 安装部署与启动方式
这里给出一套通用的本地部署流程。由于不同仓库的目录结构不同，下面命令中的仓库地址和启动脚本需要按实际 README 替换。
git clone https://github.com/your-account/workbuddy.git cd workbuddy python -m venv .venv source .venv/bin/activate pip install -r requirements.txt cp .env.example .env python app.py --host 127.0.0.1 --port 8080在 Windows PowerShell 或 CMD 中，虚拟环境激活命令是：
.venv\Scripts\activate启动成功后，打开浏览器访问http://127.0.0.1:8080，如果项目自带 Web UI，应该能看到一个配置页面或健康检查接口。如果端口被占用，可以换成其他端口，例如：
python app.py --host 127.0.0.1 --port 8081如果项目提供 Docker 镜像，也可以用 Docker 启动：
docker run -d --name workbuddy -p 8080:8080 your-image-name启动后要重点看两件事：第一，日志里是否出现listening on 0.0.0.0:8080之类的输出；第二，Web UI 是否可以正常加载。如果这两个都通过，说明部署骨架已经完成，接下来可以接入飞书和企业微信。
6. 连接飞书实操：从创建应用到消息收发
飞书的开放能力比较完整，workbuddy 连接飞书通常会走两种方式：一种是自定义机器人 Webhook，适合快速发消息；另一种是自建应用 + 事件订阅，适合接收消息和交互。下面把两种方式都过一遍。
6.1 创建飞书自建应用
登录飞书开放平台后，进入“开发者后台”，选择“创建企业自建应用”。应用创建成功后，先做三件事：
- 在“凭证与基础信息”页面复制 App ID 和 App Secret；
- 在“应用功能”中添加“机器人”能力；
- 在“权限管理”中给应用添加发送消息、读取消息等必要权限。
权限要遵循最小授权原则，不要一次性把全部权限都勾上。常见的消息权限包括im:message、im:chat等，具体按实际功能申请。
权限配置完成后，进入“版本管理与发布”，创建版本并提交审核。飞书自建应用发布后才会真正生效，这一步经常被忽略，很多“机器人收不到消息”的问题就是因为应用没有发布。
6.2 获取 tenant_access_token
要用 API 主动发消息，先通过 App ID 和 App Secret 获取租户访问凭证：
import requests app_id = "your_app_id" app_secret = "your_app_secret" res = requests.post( "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal", json={"app_id": app_id, "app_secret": app_secret} ) print(res.json())正常情况下，返回结果里会有code: 0和tenant_access_token。如果返回app_id或app_secret错误，优先检查是不是复制成了别的字段。
6.3 用 Webhook 机器人快速验证
如果你只是想先验证飞书通道是否打通，最快的方法是在飞书群里添加自定义机器人，得到 Webhook 地址，然后直接发送一条消息：
curl -X POST https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook \ -H "Content-Type: application/json" \ -d '{"msg_type":"text","content":{"text":"workbuddy test"}}'如果群里收到“workbuddy test”，说明消息通道正常。这种方式适合先排除网络、token 之外的干扰。
6.4 配置事件订阅
如果需要 workbuddy 接收用户发来的消息，也就是“对话式交互”，必须配置事件订阅。流程是：
- 在飞书开放平台的应用配置中进入“事件与回调”；
- 添加
im.message.receive_v1事件； - 填入回调地址，通常是
http://your-server:8080/feishu/webhook； - 飞书会发送一条 URL 验证请求，workbuddy 需要返回正确的加密验证数据；
- 验证通过后，每次用户在群里 @ 机器人发消息，飞书都会把事件推送到这个地址。
事件订阅验证失败是常见问题。回调地址必须公网可达，并且 workbuddy 的 webhook 端点路径要和配置完全一致。如果配置后一直无法验证，先检查服务器防火墙、端口是否开放、日志里有没有收到请求。
6.5 判断成功与否的标准
- token 接口返回
code: 0； - Webhook 测试时群里能收到消息；
- 事件订阅验证时，飞书后台显示“验证通过”；
- 实际对话后，workbuddy 日志中能看到对应的事件记录。
连飞书时最容易踩的坑有三个：应用没发布、权限没开通、回调地址不可达。只要按 6.1 到 6.4 的顺序走完，绝大多数问题都能定位。
7. 连接企业微信实操：应用消息与任务待办
企业微信的连接方式和飞书类似，但接口域名、token 获取方式不同。workbuddy 连接企业微信后，最常见的能力是让员工在会话里触发任务待办、让系统把任务消息推送给指定成员。
7.1 创建企业微信自建应用
登录企业微信管理后台，进入“应用管理”，选择“自建”，创建应用。创建后需要拿到三样信息：
- 企业 ID（Corp ID）；
- AgentId；
- Secret。
配置接收消息时，还需要设置 Token 和 EncodingAESKey。这些值会用于回调 URL 的签名校验。
7.2 获取 access_token 并发送应用消息
企业微信的消息接口通过 access_token 调用。先获取 token：
import requests corp_id = "your_corp_id" secret = "your_secret" token_res = requests.get( "https://qyapi.weixin.qq.com/cgi-bin/gettoken", params={"corpid": corp_id, "corpsecret": secret} ) print(token_res.json())然后发送文本应用消息：
access_token = token_res.json().get("access_token") msg_res = requests.post( f"https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={access_token}",
