用途：当飞书插件出现错误或授权失败时，用FAQ与授权诊断快速定位问题。
主要能力与排查项： 授权相关：Token过期时API返回99991668或99991672，解决方式是重新执行OAuth授权流程；权限不足时返回99991400或99991403，需检查应用是否开通所需API权限；Refresh Token过期导致刷新token报错时，需重新走完整OAuth流程。
权限对照表（功能模块→所需scope）：日历读写calendar:calendar、calendar:calendar:readonly；文档读写docx:document、docx:document:readonly；多维表格bitable:app、bitable:app:readonly；任务管理task:task、task:task:readonly；通讯录contact:user.base:readonly、contact:department.base:readonly；消息读写im:message、im:message:readonly；云盘drive:drive、drive:drive:readonly；Wiki wiki:wiki、wiki:wiki:readonly；邮件mail:mailgroup、mail:mailgroup:readonly。
API调用问题：飞书API有频率限制，通常100次/秒，批量操作建议串行并延迟0.5-1秒；字段值格式错误可参考skills/feishu-bitable/references/record-values.md。
诊断命令： 查看授权状态 python3 skills/feishu-cli/run.py '{"action":"auth","subcommand":"status"}' 查看可用模块 python3 skills/feishu-cli/run.py '{"action":"help","topic":"modules"}'
限制：资料未说明其他错误码、具体重试策略及不同版本差异，上述内容仅为现有FAQ范围。