Feishu Troubleshoot

飞书插件问题排查

❓ 常见问题（FAQ）

卡片按钮点击无反应

现象：点击卡片按钮后没有任何反应，然后提示报错.

原因：应用未开通「消息卡片回传交互」权限。

解决步骤：

1. 登录飞书开放平台：https://open.feishu.cn/app
2. 选择您的应用 → 事件与回调
3. 在回调配置中,修改订阅方式为"长链接"并添加回调 "卡片回传交互"(card.action.trigger)
4. 创建应用版本 → 提交审核 → 发布

🔍 诊断命令（深度工具）

注意：诊断命令仅用于排查复杂/疑难的权限相关问题。常规权限问题会自动触发授权流程，无需手动诊断。

何时使用诊断：

• 多次授权后仍然报错
• 自动授权流程无法解决的问题
• 需要查看完整的权限配置状态

使用方法：

在飞书聊天会话中直接输入（作为用户消息发送）：

/feishu doctor

诊断命令会检查：

• 📋 诊断摘要（首先展示）：
  • 总体状态（✅ 正常 / ⚠️ 警告 / ❌ 失败）
  • 发现的问题列表和简要描述