飞书新建具有云文档权限的应用，作用是让AI读取云文档

① 创建应用

打开 https://open.feishu.cn/app（是 .cn。.com 是国际版 Lark，两者账号和文档完全不通）

→ 「创建企业自建应用」→ 填名称/描述/图标

应用名称会出现在文档的协作方列表里，同事看得到。银行场景起个正规名字，比如 SSC文档助手。

② 拿凭证

左侧「凭证与基础信息」：

• App ID：cli_a1b2c3d4e5f6g7h8（公开的）
• App Secret：一长串（密钥）

你不用把 Secret 发给我。 你自己写进 .env，我只跑脚本读文件。

③ 开权限

左侧「权限管理」，按中文名搜索勾选。最小值（只读）：

搜这个	scope	作用
查看新版文档	docx:document:readonly	读正文 ← 最关键
查看知识库	wiki:wiki:readonly	解析 wiki 链接
查看、评论和下载云文档所有文件	drive:drive:readonly	云空间访问

scope 名称我是从飞书 API 权限列表里核对过的，不是凭印象写的。

先别开 docx:document（创建及编辑新版文档）——它让应用能改你的文档，权限大得多。跑通只读再说。

④ 发布版本 ⚠️ 坑一

左侧「版本管理与发布」→「创建版本」→ 版本号 1.0.0 → 保存 → 「申请发布」 → 等管理员审批。

为什么坑：飞书的权限是跟着已发布版本走的。你在权限管理里勾了权限，但只要没发版（或者发版后又改了权限没重新发），调 API 就返回 99991672 permission denied —— 而你去权限管理看，权限明明勾上了。这个现象非常迷惑人。

你是管理员的话，审批在「管理后台」→「应用管理」→ 待审批里自己点通过。

⑤ 授权应用访问文档 ⚠️ 坑二

发布 ≠ 有权看你的文档。 还要显式授权，分两种情况：

A. 云空间文档（URL 是 /docx/） 打开文档 → 右上角「分享」→ 搜索你的应用名 → 加为 「可阅读」

B. 知识库文档（URL 是 /wiki/）← 你第一篇就是这个 打开知识库首页 → 右上角「...」→ 「知识库设置」 → 「成员管理」 → 添加成员 → 搜索应用名 → 「可阅读」

为什么坑：知识库文档光加单篇文档的协作者常常不够，得加到知识空间这一层。加在知识库层，整个库都能读；加在单篇上，只有那篇。