feishu-troubleshoot

Name: feishu-troubleshoot
Author: op7418

2installs665forks

How to install feishu-troubleshoot?

op7418/codepilot/feishu-troubleshoot

$npx -y skills add op7418/CodePilot --skill feishu-troubleshoot

Installs into the current project.

Summary

飞书插件问题排查工具。包含常见问题 FAQ 和深度诊断命令（/feishu_doctor）。常见问题可随时查阅。诊断命令用于排查复杂问题（多次授权仍失败、自动授权无法解决等），会检查账户配置、API 连通性、应用权限、用户授权状态，并生成详细的诊断报告和解决方案。

Files · 1

View on GitHub

SKILL.md

1	# 飞书插件问题排查
2
3	## ❓ 常见问题（FAQ）
4
5	### 卡片按钮点击无反应
6
7	现象：点击卡片按钮后没有任何反应，然后提示报错.
8
9	原因：应用未开通「消息卡片回传交互」权限。
10
11	解决步骤：
12
13	1. 登录飞书开放平台：https://open.feishu.cn/app
14	2. 选择您的应用 → 事件与回调
15	3. 在回调配置中,修改订阅方式为"长链接"并添加回调 "卡片回传交互"(card.action.trigger)
16	4. 创建应用版本 → 提交审核 → 发布
17
18	---
19
20	## 🔍 诊断命令（深度工具）
21
22	注意：诊断命令仅用于排查复杂/疑难的权限相关问题。常规权限问题会自动触发授权流程，无需手动诊断。
23
24	何时使用诊断：
25	- 多次授权后仍然报错
26	- 自动授权流程无法解决的问题
27	- 需要查看完整的权限配置状态
28
29	使用方法：
30
31	在飞书聊天会话中直接输入（作为用户消息发送）：
32
33	/feishu doctor
34
35	诊断命令会检查：
36
37	- 📋 诊断摘要（首先展示）：
38	- 总体状态（✅ 正常 / ⚠️ 警告 / ❌ 失败）
39	- 发现的问题列表和简要描述
40
41	- 环境信息：
42	- 插件版本
43
44	- 账号信息：
45	- 凭证完整性（appId, appSecret 掩码）
46	- 账户启用状态
47	- API 连通性测试
48	- Bot 信息（名称和 openId）
49
50	- 应用身份权限：
51	- 应用已开通的必需权限数量
52	- 缺失的必需权限列表
53	- 一键申请链接（自动带上缺失权限参数）
54
55	- 用户身份权限：
56	- 用户授权状态统计（✓ 有效 / ⟳ 需刷新 / ✗ 已过期）
57	- Token 自动刷新状态（是否包含 offline_access）
58	- 权限对照表（应用已开通 vs 用户已授权，逐项对比）
59	- 应用权限缺失时的申请指引和链接
60	- 用户授权不足时的重新授权操作方法

People who liked this also viewed

6 picks

Type

feishu-troubleshoot

2installs665forks

View on GitHub

How to install feishu-troubleshoot?

op7418/codepilot/feishu-troubleshoot

$npx -y skills add op7418/CodePilot --skill feishu-troubleshoot

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# 飞书插件问题排查
2
3	## ❓ 常见问题（FAQ）
4
5	### 卡片按钮点击无反应
6
7	现象：点击卡片按钮后没有任何反应，然后提示报错.
8
9	原因：应用未开通「消息卡片回传交互」权限。
10
11	解决步骤：
12
13	1. 登录飞书开放平台：https://open.feishu.cn/app
14	2. 选择您的应用 → 事件与回调
15	3. 在回调配置中,修改订阅方式为"长链接"并添加回调 "卡片回传交互"(card.action.trigger)
16	4. 创建应用版本 → 提交审核 → 发布
17
18	---
19
20	## 🔍 诊断命令（深度工具）
21
22	注意：诊断命令仅用于排查复杂/疑难的权限相关问题。常规权限问题会自动触发授权流程，无需手动诊断。
23
24	何时使用诊断：
25	- 多次授权后仍然报错
26	- 自动授权流程无法解决的问题
27	- 需要查看完整的权限配置状态
28
29	使用方法：
30
31	在飞书聊天会话中直接输入（作为用户消息发送）：
32
33	/feishu doctor
34
35	诊断命令会检查：
36
37	- 📋 诊断摘要（首先展示）：
38	- 总体状态（✅ 正常 / ⚠️ 警告 / ❌ 失败）
39	- 发现的问题列表和简要描述
40
41	- 环境信息：
42	- 插件版本
43
44	- 账号信息：
45	- 凭证完整性（appId, appSecret 掩码）
46	- 账户启用状态
47	- API 连通性测试
48	- Bot 信息（名称和 openId）
49
50	- 应用身份权限：
51	- 应用已开通的必需权限数量
52	- 缺失的必需权限列表
53	- 一键申请链接（自动带上缺失权限参数）
54
55	- 用户身份权限：
56	- 用户授权状态统计（✓ 有效 / ⟳ 需刷新 / ✗ 已过期）
57	- Token 自动刷新状态（是否包含 offline_access）
58	- 权限对照表（应用已开通 vs 用户已授权，逐项对比）
59	- 应用权限缺失时的申请指引和链接
60	- 用户授权不足时的重新授权操作方法

People who liked this also viewed

6 picks

Type