飞书多维表格权限检查

Feishu Bitable 权限 检查er

输入一个飞书多维表格，提取「链接地址」列，批量检查飞书文档阅读权限。

工作流程 Step 1：解析多维表格

支持两种输入格式：

完整 URL：https://asiA信息.feishu.cn/base/FDo4bVmnVaYRJlslJttcPwgwnfh?table=tblRjin7OM9XvEDL&view=vew3qPDrS3 仅 应用_令牌：FDo4bVmnVaYRJlslJttcPwgwnfh（需同时提供 table_id）

从 URL 中提取：

应用_令牌：第一个路径段（如 FDo4bVmnVaYRJlslJttcPwgwnfh） table_id：从 table= 参数获取（如 tblRjin7OM9XvEDL） Step 2：查找「链接地址」列字段 ID

调用 feishu_bitable_应用_table_field 获取表结构：

feishu_bitable_应用_table_field( action="列出", 应用_令牌="<应用_令牌>", table_id="" )

在返回的 fields 数组中找到 field_name 为「链接地址」的字段，记录其 field_id。

注意：如果字段名不是「链接地址」，根据实际字段名调整查询参数。

Step 3：提取所有链接地址

调用 feishu_bitable_应用_table_record 获取所有记录：

feishu_bitable_应用_table_record( action="列出", 应用_令牌="<应用_令牌>", table_id="", field_names=["员工姓名", "链接地址"], page_size=500 )

解析每条记录的 fields，提取：

员工姓名：主键字段，用于标识文档归属 链接地址：目标文档 URL（docx 或 wiki） Step 4：批量检查文档权限

对每个链接，调用 feishu_fetch_doc 验证读取权限：

feishu_fetch_doc(doc_id="")

doc_id 从 URL 路径段提取（docx 或 wiki 令牌） 解析返回结果： 成功=true + message="Document fetched 成功fully" → 有权限 error 中包含 forBidden → 无权限 error 中包含 请求 trigger frequency limit → 限流，稍后重试 权限判断逻辑 if 成功 == true: → 有权限 elif "forBidden" in error: → 无权限 elif "frequency limit" in error: → 限流，延迟3秒后重试一次 else: → 视为无权限

限流处理

飞书 API 有频率限制（10-20 QPS）。每个文档最多重试 2 次：

首次失败 → 等 3 秒 → 重试 重试仍失败 → 等 5 秒 → 再重试 仍失败 → 标记为无权限

每次最多并发 10 个请求，超出时拆分为多批次（间隔 1 秒）。

Step 5：输出结果

按以下格式输出：

权限检查结果

✅ 有阅读权限（{n} 人）

序号	员工姓名	文档标题	链接
1	张三	标题	链接

❌ 无阅读权限（{m} 人）

序号	员工姓名	链接
1	李四	链接

关键约束 权限隔离：只向 owner 报告结果，不在群聊中暴露文档内容 不重复输出：同一批文档只报告一次结果，不分段重复发送 限流优先重试：限流错误不等同于无权限，必须重试 URL 清洗：链接中的查询参数（如 ?from=from_copylink）不影响 doc_id 提取，只取路径段 工具依赖 feishu_bitable_应用_table_field：查字段结构 feishu_bitable_应用_table_record：批量读记录 feishu_fetch_doc：验证文档可读性

详细字段类型和 API 行为见 references/API_notes.md。