name	feishu-troubleshoot
description	When 飞书 plugin errors or auth failures occur → troubleshoot with FAQ and authorization diagnostics.
triggers	{"intent_patterns":["飞书问题\|feishu error\|授权失败\|权限不足","feishu troubleshoot\|飞书排查\|飞书诊断","飞书.报错\|lark.error\|飞书.不好使\|lark.not.working","token.过期\|expired\|刷新.token\|refresh.token","scope.不够\|insufficient.scope\|缺少.权限\|missing.permission","飞书.连不上\|lark.connection\|API.失败\|API.failed","飞书.怎么.了\|what.wrong.lark\|为什么.飞书\|why.feishu"],"context_signals":{"keywords":["troubleshoot","排查","诊断","权限不足","授权失败","报错","error","token","scope","连接","失败"]},"confidence_threshold":0.5}
priority	8
requires_tools	["bash"]
max_tokens	300
cooldown	15

飞书问题排查

常见问题（FAQ）

授权相关

Token 过期

现象：API 调用返回 99991668 或 99991672
解决：重新执行 OAuth 授权流程

权限不足

现象：API 返回 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"}'

Más de este repositorio

mismo repositorio

openbench

cklxx/elephant.ai

When prompt, tool, or agent logic changes need regression testing → run eval benchmarks to detect regressions or improvements.

2026-03-2311

openmax

cklxx/elephant.ai

When a task can be parallelized (bulk code review, multi-module refactor, batch analysis) → split into subtasks running in isolated git worktrees via multiple workers.

2026-03-2311

openseed

cklxx/elephant.ai

When the user wants to research academic papers → search ArXiv, extract PDFs, summarize/review/Q&A, generate experiment code.

2026-03-2311

browser-use

cklxx/elephant.ai

When you need to interact with web pages using the user's logged-in browser → control Chrome via @playwright/cli daemon, reusing cookies/session with persistent tabs.

2026-03-2311

anygen

cklxx/elephant.ai

When user needs AnyGenIO content generation → unified CLI for task execution with progressive disclosure.

2026-03-2311

artifact-management

cklxx/elephant.ai

When you need to persist files (reports, docs, evidence) beyond the session → create/query/delete durable artifacts.

2026-03-2311

飞书问题排查

常见问题（FAQ）

授权相关

Token 过期

现象：API 调用返回 99991668 或 99991672

解决：重新执行 OAuth 授权流程

权限不足

现象：API 返回 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"}'