必须打通飞书连接器，否则workbuddy仅为本地助手；需满足版本≥4.6.4、有智能体应用权限、网络可访问open.feishu.cn；支持扫码授权或手动填参两种配置方式；测试连接需通过四步验证；启用反向操作需在飞书开放平台添加最小集权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在WorkBuddy工作台里让AI真正进入你的团队协作现场，必须打通飞书连接器——没有这一步，WorkBuddy就只是你电脑里的一个本地助手，读不到飞书消息、发不了群通知、写不了文档、管不了日程，所有团队级自动化都无从谈起。
确认前提条件
打开WorkBuddy前，请先确认三件事：【WorkBuddy客户端版本不低于4.6.4】；你的飞书账号有创建智能体应用的权限（普通成员即可，无需管理员）；电脑网络能正常访问 open.feishu.cn。
如果版本过旧，启动后会弹出升级提示，必须完成升级才能看到「连接器」入口。
一键开启飞书连接器
方法一：快捷扫码授权（推荐给首次配置用户）
打开WorkBuddy → 点击左下角「+」→ 选择「连接器」→ 找到「飞书」图标 → 点击「连接」→ 页面自动跳转至飞书授权页 → 用飞书App扫码确认 → 授权完成后，状态显示为「已连接」。
方法二：手动填参模式（适用于需指定权限范围或企业策略管控场景）
在「飞书连接器」配置页 → 选择「高级配置」→ 点击「前往飞书开放平台创建应用」→ 新建「飞书智能体应用」→ 填写名称（如“WorkBuddy办公助手”）和图标 → 创建成功后复制 App ID 和 App Secret → 回到WorkBuddy粘贴 → 选择「WebSocket长连接」模式 → 点击「注册」。
飞书语音消息发送器。基于 Edge TTS，一键将文字转为语音发送到飞书。 使用场景： - 发送语音通知/提醒到飞书 - 文字转语音自动播报 触发词：飞书语音、语音发送、tts、文字转语音
【App Secret一旦生成不可重置，务必复制后立即保存，切勿截图外传】
验证连接是否生效
第一步：点击配置页右上角「测试连接」按钮。
第二步：系统自动在飞书内打开机器人私聊窗口，发送一条含时间戳的测试消息。
第三步：观察WorkBuddy侧日志面板是否出现绿色「✅ 收到飞书回调」记录。
第四步：手动在飞书机器人对话框输入“同步我的今日日程”，若3秒内返回格式化日程列表，说明双向通道已通。
如果测试失败，优先检查飞书端是否已完成「im:message:send_as_bot」和「im:chat:read」两项权限勾选——这是发送与接收消息的最小必要权限。
启用飞书反向操作能力
连接成功后，默认只开通基础读消息权限。要让WorkBuddy主动写飞书内容（比如自动生成日报推送到群、修改文档、创建任务），必须额外开通对应权限：
→ 进入飞书开放平台 → 找到刚创建的智能体应用 → 进入「权限管理」→ 批量粘贴以下最小集权限代码：{"scopes":{"tenant":["im:message:send_as_bot","docx:document:write","task:task:create","calendar:calendar:write"]}}
→ 点击「保存并发布」→ 返回WorkBuddy刷新连接器状态。
这一步不做，WorkBuddy永远只能“听”不能“动”，所有自动化产出物都无法落地到飞书真实工作流中。
