猫度飞书
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_110580e2/mdfeishu。
技能介绍
要解决什么问题
工作区管理员要在猫度里把飞书企业自建应用接进来:事件能打到后端、群里 @ 机器人能走到 Home Agent,而不是卡在 URL 校验、challenge 或穿透端口上。本技能不承接选题、选品、口播等业务,那些应走 maodu 或 maodu-selection 等主技能;这里只谈飞书绑定、Webhook 与机器人行为。
技能如何工作
助手经 MCP(call_api 等)对工作区设置做读写,对用户用自然中文说明,不贴原始 JSON 或工具名。典型路径:
- 绑定管理:列出 / 创建 / 更新 / 删除
/api/workspace-settings/feishu-apps下的飞书应用绑定 - 元数据:读取
…/feishu-apps/meta,弄清共享 Webhook 路径及可选智能体、成员列表 - 架构说明:多飞书 App 共用
POST /api/webhooks/feishu/event,靠 Verification Token 或 Encrypt Key 识别是哪条绑定 - 运行时:私聊或群内 @ 机器人 → Home Agent
排查时会对照:challenge 是否非 JSON、穿透是否未指向 backend:3000(本地开发不是 MCP 3100)、绑定是否未启用、算力是否不足、群聊是否未 @ 机器人。
边界与注意点
- 权限:仅工作区 owner/admin 可改绑定;
health_check/workspace_me免扣算力,业务call_api每次扣 1 点 - 硬性安全:App Secret、Token 等只引导去猫度「设置 → 飞书机器人」填写;即使用 MCP 写入,也不在对话里回显完整密钥
- 开放平台侧需自建应用、订阅
im.message.receive_v1、事件地址为{PUBLIC_BASE_URL}/api/webhooks/feishu/event,并在猫度侧启用对应绑定
使用场景
- 新建飞书自建应用后,要在猫度工作区创建绑定并核对事件订阅地址是否指向 `/api/webhooks/feishu/event`
- 飞书控制台 URL 校验或 challenge 失败,需要对照穿透是否打到 Nest 3000 与请求体是否为合法 JSON
- 群聊里机器人无响应,需确认是否 @ 机器人、绑定已启用且工作区算力未耗尽
- 多个飞书 App 共用同一 Webhook 时,要搞清靠 Verification Token 或 Encrypt Key 区分哪条绑定
适合人员
- 猫度工作区 owner/admin,要首次对接飞书机器人并开通 im.message.receive_v1
- 负责内网穿透或本地联调的工程师,需把公网回调指到 backend:3000 而非 MCP 3100
- 运维排查「飞书收不到消息」时,要按绑定列表、meta 与 Home Agent 链路逐步定位
- 只配置凭证、不愿在聊天里暴露 App Secret 的管理员,需要按设置页填写而非让助手回显密钥