飞书周报合并一体化流程

v1.0.0

飞书多维表格周报权限检查与合并一体化工具。用户输入一个飞书多维表格 URL,自动完成:提取「链接地址」列 → 批量检查飞书文档阅读权限 → 将有权限的文档按章节合并为新文档。输出有权限列表、无权限列表,以及合并后的新飞书文档链接。触发词:多维表格周报合并、批量合并周报、多维表格文档合并。

0· 79· 1 versions· 0 current· 0 all-time· Updated 14h ago· MIT-0

Install

openclaw skills install feishu-bitable-weekly-report-merge

Feishu Bitable Weekly Report Merge

输入多维表格 URL,一键完成权限检查 + 文档合并全流程。

工作流程

Step 1:解析多维表格 URL

支持格式:

  • 完整 URL:https://asiainfo.feishu.cn/base/FDo4bVmnVaYRJlslJttcPwgwnfh?table=tblRjin7OM9XvEDL&view=vew3qPDrS3
  • 仅 app_token:需同时提供 table_id

从 URL 提取:

  • app_token:第一个路径段
  • table_idtable= 参数值

Step 2:查找「链接地址」列字段 ID

调用 feishu_bitable_app_table_field 获取表结构,找到字段名「链接地址」的 field_id

Step 3:提取所有记录

调用 feishu_bitable_app_table_record,返回 员工姓名 + 链接地址 两列。

Step 4:批量检查文档权限

对每个链接调用 feishu_fetch_doc

  • 成功 → 有权限
  • forBidden → 无权限
  • frequency limit → 等 3 秒重试,再失败视为无权限

Step 5:输出结果

向用户汇报:

  • ✅ 有权限文档(数量 + 列表)
  • ❌ 无权限文档(数量 + 列表)

Step 6:合并有权限文档

注意:需先向用户确认是否继续合并操作,避免自动合并大量文档产生不预期结果。

合并规则(详见 references/merge_rules.md):

  • 按文档提供顺序拼接
  • 每位员工前加 ## 【姓名】 子标题
  • Part1~Part5 依次排列
  • 原文不修改不总结,lark-table 等格式保留

调用 feishu_create_doc 创建合并文档,标题: [AIO]-[姓名1/姓名2/...]-周报合并-YYYY-MM

关键约束

  1. 确认后再合并:权限检查完成后,输出有/无权限列表后,先问用户"是否将以上有权限的文档合并?",用户确认后再执行合并
  2. 权限隔离:只向 owner 报告结果
  3. 限流处理:每个文档最多重试 2 次,每次间隔 3 秒
  4. 空表处理:如果所有文档均无权限,告知用户并结束

工具依赖链

feishu_bitable_app_table_field  → 查字段
feishu_bitable_app_table_record → 读记录
feishu_fetch_doc                → 验权限
feishu_create_doc               → 建合并文档

详细权限判断逻辑见 references/permission_rules.md

Version tags

latestvk9797jbwj46accpze6grffrtt9851y1x