SuperAPI AI 工具集

feishu-troubleshoot

编程与开发

查看项目

更新于 10-16 02:39

技能介绍

用途:面向飞书插件使用中的问题排查,提供常见问题 FAQ 与深度诊断命令,帮助定位权限与配置类故障。

主要能力:FAQ 覆盖典型问题,例如卡片按钮点击无反应,原因是应用未开通「消息卡片回传交互」权限;解决步骤为登录飞书开放平台 https://open.feishu.cn/app,选择应用 → 事件与回调,在回调配置中把订阅方式改为“长链接”并添加回调 card.action.trigger,然后创建应用版本、提交审核并发布。

诊断命令:在飞书聊天会话中直接以用户消息发送 /feishu doctor。该命令用于排查复杂或疑难的权限相关问题,常规权限问题会自动触发授权流程,无需手动诊断。适用情形包括多次授权后仍报错、自动授权流程无法解决、需要查看完整权限配置状态。

诊断内容:先展示诊断摘要,包括总体状态(正常/警告/失败)、发现的问题列表与简要描述;环境信息含插件版本;账号信息含凭证完整性(appId、appSecret 掩码)、账户启用状态、API 连通性测试、Bot 信息(名称与 openId);应用身份权限含已开通必需权限数量、缺失权限列表及自动带上缺失权限参数的一键申请链接;用户身份权限含授权状态统计(有效/需刷新/已过期)、Token 自动刷新状态(是否包含 offline_access)、应用已开通与用户已授权的权限对照表,以及应用权限缺失时的申请指引和用户授权不足时的重新授权操作方法。

限制:资料未提供其他平台支持、收费方式或更多命令参数,暂未提供。