karuo-ai/02_卡人（水）/水溪_整理归档/经验库/待沉淀/2026-02-25_飞书日志串月误写修复与防错SOP.md

2026-02-25 飞书日志串月误写修复与防错SOP

1. 问题现象

• 目标：写入 2月25日 日志。
• 实际：被写入 2026年1月 运营团队启动 文档（串月）。
• 用户反馈：应写入 2026年2月（突破执行）。

2. 根因分析

1. auto_log.py 早期采用固定 WIKI_TOKEN，没有按日期月份路由。
2. 写入前缺少「标题月份校验」。
3. 写入后缺少「跨文档复检」（只看写入成功码，不看位置正确性）。
4. 打开页面使用固定链接，容易误导为写入正确文档。

3. 已落地修复

3.1 代码修复（已完成）

• 文件：02_卡人（水）/水桥_平台对接/飞书管理/脚本/auto_log.py
• 修复点：
  • 新增 MONTH_WIKI_TOKENS 月份映射。
  • 新增 parse_month_from_date_str() 和 resolve_wiki_token_for_date()。
  • write_log() 增加 wiki_token 参数，并在写入前强制校验文档标题月份。
  • open_result() 改为按月份 token 打开正确文档，不再固定 1 月链接。

3.2 数据修复（已完成）

• 已将 2月25日 正确写入 2026年2月（突破执行）。
• 已从 2026年1月 运营团队启动 删除误写的 2月25日 段落。

4. 关键 API 经验（高价值）

4.1 写入目标校验

先调用：

• GET /open-apis/wiki/v2/spaces/get_node?token={wiki_token}

检查返回 title 是否包含对应月份（如 2月），不包含则禁止写入。

4.2 误写回滚删除

删除误写段落时，必须使用：

• DELETE /open-apis/docx/v1/documents/{doc}/blocks/{doc}/children/batch_delete

参数必须使用：

• start_index
• end_index

注意：此接口在本场景不能用 block_id_list，否则会返回 field validation failed，提示 start_index/end_index is required。

5. 标准执行清单（后续每次必走）

1. 根据 X月X日 解析月份。
2. 路由到月份 token（MONTH_WIKI_TOKENS）。
3. 写入前检查目标文档标题月份。
4. 写入日志。
5. 写入后双检：
   • 目标月文档：日期存在。
   • 邻近月文档：同日期不存在。
6. 打开目标月文档链接给用户确认。

6. 月份映射（当前）

• 1月：JZiiwxEjHiRxouk8hSPcqBn6nrd（2026年1月 运营团队启动）
• 2月：Jn2EwXP2OiTujNkAbNCcDcM7nRA（2026年2月 （突破执行））

7. 后续优化建议

1. 每月新增日志文档时，同步更新 MONTH_WIKI_TOKENS。
2. 增加命令：python3 auto_log.py --date 2月25日 --verify-cross-month（可选）。
3. 在 CI/自检脚本加入「串月检测」断言，避免回归。