Lark 报告收集器

从飞书报告中收集周报数据，汇总至飞书文档并发送通知。

适用场景

• “收集 Photo/Bloom/H&F 本周/上周的报告”
• “谁还没有提交周报？”
• “将周报内容汇总成一份飞书文档”

硬性规则（经过实战验证）

1. 报告页面是 SPA 应用 — 使用 curl 或 web_fetch 无法获取任何内容。必须使用 browser（配置为 profile=openclaw）
2. 分页顺序相反 — “下一页” = 更早的周，“上一页” = 更近的周
3. 每次翻页后必须截图确认周标题（最常见的错误：收集了错误周的数据）
4. 一页可能包含多个周的数据 — 数据按时间排序，单页可能跨越 2~3 周
5. block_type 映射关系 — 12=项目符号列表，13=有序列表（注意：不是 9/10！它们对应 heading7/heading8）
6. 禁止在子代理中重启网关（会导致自身崩溃）
7. 子代理必须提供精确的 URL 和操作步骤 — 不允许自主探索

完整工作流程

步骤 1：导航至报告页面

browser action=navigate profile=openclaw targetUrl="https://oa.larksuite.com/report/record/entry"

前置条件：openclaw 浏览器需已登录飞书账号。

步骤 2：选择报告模板

截取页面快照，点击左侧边栏中的“我收到的”菜单项，选择目标模板。

步骤 3：定位目标周

页面默认显示最新数据。周标题格式示例："2月2日 ~ 2月8日 已提交：18"

分页逻辑（关键）：

• 下一页 按钮 = 更早的周 ⬅️
• 上一页 按钮 = 更近的周 ➡️
• 页面显示格式：2/25（共 25 页，当前第 2 页），第 1 页为最新

⚠️ 每次翻页后必须截图并确认标题中的日期！

步骤 4：提取已提交成员数据

• 同一页可能包含多个周的数据 — 仅提取属于目标周的行
• 对目标周的所有行进行分页遍历
• 每提取一次就追加写入本地文件（防止数据丢失）

步骤 5：获取未提交名单

“未提交：N” 按钮无可用快照引用。通过 JavaScript 执行点击：

(() => {
  const btns = [...document.querySelectorAll('button')].filter(
    b => /未提交.*\d/.test(b.innerText)
  );
  if(btns.length) { btns[0].click(); return 'clicked'; }
  return 'not found';
})()

弹窗将显示：未提交人数 + 姓名 + 部门信息。

步骤 6：创建飞书文档

通过飞书 Open API 创建文档（认证方式参考 lark-api 技能）。

block_type 参考（已验证）：

❌ 9=标题7，10=标题8。并非列表类型！

步骤 7：发送通知

通过飞书 API 发送消息，附带生成文档的链接。

经验教训（6 次真实尝试）

已知限制

• 国际版飞书报告开放 API 不可用（返回 404）——仅可通过浏览器访问
• 浏览器登录会话可能过期 —— 需重新登录
• 导出按钮（Excel）尚未测试 —— 可作为备选方案