본문으로 건너뛰기
cccskills
무료GitHub에 공개

feishu-troubleshoot

Troubleshoot Feishu plugin authorization and permission problems using an FAQ and a diagnostic command. Check account configuration, API connectivity, app permissions, and user authorization, then review a report with issues and suggested fixes.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

원문원문 설명 보기

飞书插件问题排查工具。包含常见问题 FAQ 和深度诊断命令(/feishu_doctor)。常见问题可随时查阅。

诊断命令用于排查复杂问题(多次授权仍失败、自动授权无法解决等), 会检查账户配置、API 连通性、应用权限、用户授权状态,并生成详细的诊断报告和解决方案。

설치 방법 보기

이럴 때 유용합니다

  • Investigate errors that persist after repeated authorization
  • Review app permissions and user authorization together
  • Check account configuration and API connectivity
  • Troubleshoot unresponsive message card buttons

포함된 파일(1)

  • SKILL.md2.2 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

飞书插件问题排查

❓ 常见问题(FAQ)

卡片按钮点击无反应

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

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

解决步骤:

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

🔍 诊断命令(深度工具)

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

何时使用诊断:

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

使用方法:

在飞书聊天会话中直接输入(作为用户消息发送):

/feishu doctor

诊断命令会检查:

  • 📋 诊断摘要(首先展示):

    • 总体状态(✅ 正常 / ⚠️ 警告 / ❌ 失败)
    • 发现的问题列表和简要描述
  • 环境信息:

    • 插件版本
  • 账号信息:

    • 凭证完整性(appId, appSecret 掩码)
    • 账户启用状态
    • API 连通性测试
    • Bot 信息(名称和 openId)
  • 应用身份权限:

    • 应用已开通的必需权限数量
    • 缺失的必需权限列表
    • 一键申请链接(自动带上缺失权限参数)
  • 用户身份权限:

    • 用户授权状态统计(✓ 有效 / ⟳ 需刷新 / ✗ 已过期)
    • Token 自动刷新状态(是否包含 offline_access)
    • 权限对照表(应用已开通 vs 用户已授权,逐项对比)
    • 应用权限缺失时的申请指引和链接
    • 用户授权不足时的重新授权操作方法

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Create and manage tables in Feishu Bitable, including searching, adding, updating, and deleting rows. The skill covers 27 column types, advanced filters, batch operations, and views that provide different ways to display table data.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Importing customer records in batches
  • Finding records by status and deadline
  • Updating multiple records at once
op7418/CodePilot6.5천2026년 9월 22일 업데이트

Manage meetings in Feishu calendars by creating events, finding schedules, changing times, and responding to invitations. The skill also handles attendees, checks availability across multiple people, and checks whether meeting room bookings were accepted.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Creating meetings and inviting attendees
  • Checking availability across multiple people
  • Finding and rescheduling meetings
op7418/CodePilot6.5천2026년 9월 22일 업데이트

Keep agent replies in Lark/Feishu short, natural, and focused on the point. This skill guides conversational wording, favors plain sentences for brief answers, and references Lark-specific Markdown guidance when formatting is unclear.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Keeping Lark replies short and conversational
  • Using plain sentences for brief answers
  • Checking Lark-specific Markdown formatting
op7418/CodePilot6.5천2026년 9월 22일 업데이트

Create new Feishu cloud documents from Markdown, a text format for structured content. Choose a folder or knowledge library location, and include tables, images, and diagrams in meeting notes or project plans.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Create meeting notes in a specified folder
  • Write project plans with tables and diagrams
  • Add technical documents under a knowledge library page
op7418/CodePilot6.5천2026년 9월 22일 업데이트

Retrieve 飞书 cloud documents as Markdown using a document URL or token. Handle embedded images, files, and whiteboards through a separate download tool, and identify the underlying content type before reading wiki links.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Read a cloud document from its URL
  • Retrieve document text as Markdown
  • Download embedded images and attachments
op7418/CodePilot6.5천2026년 9월 22일 업데이트

Read Feishu group and direct chat history, including replies within discussion threads. Search across conversations by keyword, sender, or date, and download images, files, audio, or video attached to messages you can access.

한국어 요약은 준비 중입니다. 영어 요약을 표시하고 있습니다.

  • Review group chat messages from a specified period
  • Read all replies in a discussion thread
  • Find messages across chats by keyword or sender
op7418/CodePilot6.5천2026년 9월 22일 업데이트

op7418의 스킬 모두 보기

이 스킬의 문제 신고