Feishu TroubleshootSAFE

A multi-model AI agent desktop client — connect any AI provider, extend with MCP & skills, control from your phone. Built with Electron + Next.js.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: feishu-troubleshoot
description: |
  飞书插件问题排查工具。包含常见问题 FAQ 和深度诊断命令(/feishu_doctor)。

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

---

# 飞书插件问题排查

## ❓ 常见问题(FAQ)

### 卡片按钮点击无反应

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

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

**解决步骤**:

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

---

## 🔍 诊断命令(深度工具)

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

**何时使用诊断**:
- 多次授权后仍然报错
- 自动授权流程无法解决的问题
- 需要查看完整的权限配置状态

**使用方法**:

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

/feishu doctor

诊断命令会检查:

- **📋 诊断摘要**(首先展示):
  - 总体状态(✅ 正常 / ⚠️ 警告 / ❌ 失败)
  - 发现的问题列表和简要描述

- **环境信息**:
  - 插件版本

- **账号信息**:
  - 凭证完整性(appId, appSecret 掩码)
  - 账户启用状态
  - API 连通性测试
  - Bot 信息(名称和 openId)

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

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

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.