# 飞书和 Figma 访问需要统一预检 - 候选 id：`provider-access-preflight` - 类型：`diagnostic-tool` ## Diagnostic Flow Example\n\n### 场景\n用户给出一个飞书 docx 链接，要求总结正文，同时要求后续可能把结论同步到 Figma。\n\n### 入口\n```bash\npython3 ~/.codex/night-gym/tools/provider_access_preflight.py \\\n --provider lark --provider figma \\\n --url 'https://bytedance.larkoffice.com/wiki/...' \\\n --mode summarize --cwd /Users/bytedance/Documents/job-bu\n```\n\n### 输入来源\n| 来源 | 用途 |\n| --- | --- |\n| 用户消息 URL | 判断是飞书 wiki/docx 还是 Figma 文件 |\n| 当前 cwd | 判断是否需要读取 job-bu 的 AGENTS.md 和本地资料源规则 |\n| `lark-cli config show` | 确认真实配置路径、当前 identity、避免旧路径空转 |\n| Figma connector 最小探针 | 确认当前 connector 是否需要重新认证 |\n\n### 检查步骤\n1. 对飞书 URL 先解析 token；如果是 `/wiki/`，执行 `wiki spaces get_node`，拿到 `obj_type` 和真实 `obj_token`。\n2. 如果 `obj_type=docx`，执行 `docs +fetch --as user --doc <url> --format json`，检查 `data.title` 与 `data.markdown` 是否非空。\n3. 对 Figma 执行最小 connector 探针；当前返回 `401/ReauthenticationRequired` 时直接判 blocked，不再尝试正式复制或写入。\n4. 在 `job-bu` cwd 下读取 `AGENTS.md`，确认 iCloud 术语解释目录只是术语源，分析取数仍优先 `data-analysis-workspace`。\n\n### 输出样例\n```json\n{\n "status": "blocked",\n "exit_code": 2,\n "checks": [\n {"provider": "lark", "status": "ready", "identity": "user", "resource_type": "docx", "title": "..."},\n {"provider": "figma", "status": "blocked", "reason": "ReauthenticationRequired"}\n ],\n "recommended_next_step": "先让用户完成 Figma connector reauth；飞书总结可继续执行，但不要承诺同步到 Figma。"\n}\n```\n\n### 成功信号\n预检在 30 秒内明确告诉 agent：飞书正文可读、Figma 写入不可用、资料源优先级已确认。正式任务因此不会在复制/写入阶段才失败。