Feishu Public Table Monitor

用于监控公开可访问的飞书 Wiki/文档页面中的目标价格表或模型表。

适用场景

当用户提出这些需求时使用本 skill：

• 监控公开飞书页面中的价格表变化
• 监控模型列表、倍率表、资费表、商品表变化
• 需要把变动内容整理成 Markdown 通知
• 需要为该监控生成可定时执行的脚本或 cron job

限制

• 仅适用于无需登录即可访问的飞书页面
• 依赖 Python 3.10+ 和 requests，缺少依赖时说明原因，不自动安装
• 只接受 feishu.cn / larksuite.com 及其子域的 HTTPS 链接；逐跳检查重定向及 DNS 公网地址，拒绝内嵌凭据与非 443 端口；不使用 .netrc 或环境代理凭据
• 会在指定章节附近优先定位包含“模型名称 / 倍率 / Tokens 价格”等字段的表格，避免误抓说明表
• 支持飞书公开文档大表分页补齐；如果页面结构大改，可能仍需要调整脚本
• 单元格未完整加载、重复模型 ID、游标循环或分页超过 20 页会退出失败，保留旧基线，不生成新增/下架通知
• 状态文件使用原子替换；同一监控任务不要重叠执行。脚本没有通知发送确认机制，应由调度器负责通知失败重试，不能把快照写入等同于消息已送达

快速用法

脚本路径：

• scripts/monitor_feishu_price_table.py

先抓取一次基线：

python3 scripts/monitor_feishu_price_table.py \
  'https://example.feishu.cn/wiki/XXXX' \
  --section-title '一、模型价格表（全部模型）' \
  --state-dir './data/feishu-monitors'

如果只想看当前解析结果：

python3 scripts/monitor_feishu_price_table.py \
  'https://example.feishu.cn/wiki/XXXX' \
  --section-title '一、模型价格表（全部模型）' \
  --state-dir './data/feishu-monitors' \
  --print-snapshot

兼容说明：

• 支持旧版 clientVars: Object({...}) HTML 内嵌数据
• 支持 Object(JSON.parse("..."))、Object(decodeURIComponent("...")) 等包装格式
• 支持飞书公开文档 client_vars 分页接口，能补齐初始 HTML 未预加载的大表单元格
• 如果飞书返回 Object() 空壳或关闭公开访问，脚本会给出清楚错误，不再抛误导性的 JSONDecodeError: Expecting value
• 支持模型 ID 与介绍分离、中文 Jev 显示名中的括号 ID，以及带“每”/“输入”的价格表头；只改介绍或排序不会误报新增/下架
• 读取旧版基线时重新解析模型 ID 与价格，无需删除原状态文件

常用参数

• --section-title：要监控的章节标题，默认 一、模型价格表（全部模型）；旧文档需显式传原章节标题
• --title：通知标题，默认 模型价格表更新
• --state-dir：状态目录，用于存放基线快照
• --print-snapshot：打印当前解析出来的表格快照

推荐工作流

1. 先用 --print-snapshot 确认表格抓对了
2. 再正常跑一次初始化基线
3. 用户明确要求定时监控时才配置调度，不因安装/测试授权自行创建 cron 或发送消息
4. 若输出是 NO_REPLY 就表示没变化
5. 若输出是 Markdown 文本，就直接发送给用户
6. 退出码非 0 时报告失败，不将其作为价格变动通知发送；错误在 stderr，无正常通知输出。根据真实错误重试，不换身份或绕过公开访问限制

与 OpenClaw cron 搭配

如果用户要“有变化就推送给我”：

• 用本脚本生成差异输出
• 在 cron 的 agentTurn 里执行脚本
• 规则写成：
  • 输出 NO_REPLY 或 INIT_ONLY 时只回复 NO_REPLY
  • 仅退出码为 0 的其他输出原样发送；失败则报告运行错误

自定义建议

如果用户希望排版更像公告：

• 用 --title 自定义标题
• 保持 Markdown 样式输出
• 倍率/金额变化、模型新增/下架、上下文/图片支持变化分别输出具体差异