用途:面向飞书插件使用中的故障排查,提供常见问题 FAQ 与深度诊断命令,帮助定位权限、授权和配置类问题。
主要能力:FAQ 覆盖典型问题,例如卡片按钮点击无反应,原因是应用未开通「消息卡片回传交互」权限;解决步骤为登录飞书开放平台 https://open.feishu.cn/app,选择应用 → 事件与回调,在回调配置中把订阅方式改为“长链接”并添加回调“卡片回传交互”(card.action.trigger),然后创建应用版本、提交审核、发布。
诊断命令:在飞书聊天会话中直接输入并作为用户消息发送 /feishu doctor。它适用于多次授权后仍报错、自动授权流程无法解决、需要查看完整权限配置状态等复杂场景;常规权限问题会自动触发授权流程,无需手动诊断。
诊断内容:先展示诊断摘要(总体状态 ✅ 正常 / ⚠️ 警告 / ❌ 失败、问题列表与简要描述);环境信息包括插件版本;账号信息包括凭证完整性(appId、appSecret 掩码)、账户启用状态、API 连通性测试、Bot 信息(名称和 openId);应用身份权限包括已开通必需权限数量、缺失必需权限列表及一键申请链接;用户身份权限包括授权状态统计(✓ 有效 / ⟳ 需刷新 / ✗ 已过期)、Token 自动刷新状态(是否包含 offline_access)、应用已开通与用户已授权的权限对照表,以及应用权限缺失时的申请指引和用户授权不足时的重新授权操作方法。
限制:资料未提供安装方式、收费、支持平台及其他未提及功能,暂未提供。