# Figma 授权失效预检器
候选 ID：`figma-auth-preflight`
## Figma 授权预检流程样例
### 场景
用户要求把商品选择器画进 Figma，但最近切换过 Figma 账号。
### 输入
- Figma 文件 URL：`https://www.figma.com/design/xxx/Product-Selector`
- 期望账号：`
[email protected]`
- 任务类型：写入 Figma 画布
### 预检步骤
1. 解析 URL，提取 file key。
2. 调用 Figma connector 的轻量读取接口，读取文件名或页面列表。
3. 如果返回 `401 ReauthenticationRequired`，立即停止写入任务，标记为 `reauth_required`。
4. 如果读取成功但账号不匹配，标记为 `account_mismatch`。
5. 如果账号正确但没有文件访问权，标记为 `no_file_access`。
6. 只有 `status=ok` 时才继续执行真正的 Figma 写入。
### 失败输出示例
```json
{
"status": "failed",
"reason_code": "reauth_required",
"message": "Codex 侧 Figma connector 需要重新授权。请断开并重新连接 Figma connector，确认使用
[email protected] 后再说“再试”。",
"fallback": "先生成本地 HTML 原型和页面拆解，避免任务完全阻塞。"
}
```
### 成功输出示例
```json
{
"status": "ok",
"can_read": true,
"account": "
[email protected]",
"file_access": true,
"next": "继续执行 Figma 写入。"
}
```