🔄 卡若AI 同步 2026-02-25 10:26 | 更新：水桥平台对接、水溪整理归档 | 排除 >20MB: 13 个

2026-02-25 10:26:00 +08:00
parent c298961477
commit daefbec5f1
2 changed files with 122 additions and 15 deletions
--- a/02_卡人（水）/水桥_平台对接/飞书管理/SKILL.md
+++ b/02_卡人（水）/水桥_平台对接/飞书管理/SKILL.md
@@ -4,8 +4,8 @@ description: 飞书日志/文档自动写入与知识库管理
 triggers: 飞书日志、写入飞书、飞书知识库、飞书运营报表、派对效果数据、104场写入、运营报表填写、派对截图填表发群、Excel写飞书、批量写飞书表格、表格日报
 owner: 水桥
 group: 水
-version: "1.1"
-updated: "2026-02-20"
+version: "1.2"
+updated: "2026-02-25"
 ---

 # 飞书日志写入 Skill
@@ -23,14 +23,45 @@ updated: "2026-02-20"
 ## 一键使用（推荐）

 ```bash
-python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/飞书管理/scripts/auto_log.py
+python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/脚本/auto_log.py
 ```

 **自动完成**：
 1. ✅ **静默Token刷新** → 优先使用refresh_token自动刷新（无需授权）
 2. ✅ **检查服务** → 自动启动后端服务
-3. ✅ **写入日志** → 倒序插入（新日期在上）
-4. ✅ **打开结果** → **写入完成后自动打开飞书日志页面**（浏览器/飞书客户端）
+3. ✅ **月份路由** → 根据 `X月X日` 自动写入对应月份文档（避免串月）
+4. ✅ **写入日志** → 倒序插入（新日期在上）
+5. ✅ **打开结果** → 写入后自动打开对应月份文档（浏览器/飞书客户端）
+
+---
+
+## 月份路由与防错（强制）
+
+> 2026-02-25 实战修复：曾出现 `2月25日` 被写入 `1月文档` 的错误。此后写飞书日志必须按本节执行。
+
+### 1) 写入前：先判定目标月份文档（强制）
+
+- 输入日期必须是 `X月X日`（示例：`2月25日`）。
+- 根据日期提取月份，路由到对应 `wiki_token`。
+- 调 `wiki/v2/spaces/get_node` 校验文档标题包含对应月份（如 `2月`），不匹配立即中止写入。
+
+### 2) 写入中：只允许命中当月 token（强制）
+
+- 禁止固定一个 `WIKI_TOKEN` 写全年日志。
+- 使用 `MONTH_WIKI_TOKENS` 维护月份映射（`1月 -> token`，`2月 -> token`...）。
+
+### 3) 写入后：双文档校验（强制）
+
+- 目标月份文档：`X月X日` 必须存在。
+- 邻近月份文档：同日期必须不存在（防误写）。
+
+### 4) 若误写：回滚 SOP（强制）
+
+1. 定位误写块范围：从该日期 `heading4` 到下一日期 `heading4`。
+2. 使用根节点索引删除：  
+   `DELETE /docx/v1/documents/{doc}/blocks/{doc}/children/batch_delete`  
+   参数必须用 `start_index` + `end_index`。
+3. 重新写入正确月份文档并复检。

 ---

@@ -146,13 +177,13 @@ def get_today_tasks():

 ```bash
 # 从飞书链接处理
-python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/飞书管理/scripts/feishu_video_clip.py \
+python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/脚本/feishu_video_clip.py \
  --url "https://cunkebao.feishu.cn/minutes/obcnjnsx2mz7vj5q843172p8" \
  --webhook "https://open.feishu.cn/open-apis/bot/v2/hook/xxx" \
  --clips 5

 # 处理本地视频
-python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/飞书管理/scripts/feishu_video_clip.py \
+python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/脚本/feishu_video_clip.py \
  --video "/path/to/video.mp4" \
  --webhook "https://open.feishu.cn/open-apis/bot/v2/hook/xxx" \
  --clips 5
@@ -326,14 +357,15 @@ JSON 格式：与 `团队入职流程与新人登记表_feishu_blocks.json` 相
 当需要写入飞书日志时，直接执行：

 ```bash
-python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/飞书管理/scripts/auto_log.py
+python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/脚本/auto_log.py
 ```

 **脚本会自动**：
 - ✅ 静默刷新Token（优先）
 - ✅ 检查并启动服务
+- ✅ 根据 `X月X日` 路由到对应月份文档
 - ✅ 写入日志（倒序）
- ✅ **写入完成后自动打开飞书日志界面**（上述网址）
+- ✅ 写入完成后自动打开对应月份文档界面

 **无需任何手动操作**，全程静默完成。

@@ -343,13 +375,13 @@ python3 /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/飞书管理/s

 | 项目 | 值 |
 |:---|:---|
-| 脚本位置 | `scripts/auto_log.py`、`scripts/write_today_custom.py`（自定义内容） |
-| Token文件 | `scripts/.feishu_tokens.json` |
-| **飞书日志页面** | **https://cunkebao.feishu.cn/wiki/JZiiwxEjHiRxouk8hSPcqBn6nrd**（写入完成后会自动打开） |
-| 目标文档 | [卡若日志](https://cunkebao.feishu.cn/wiki/JZiiwxEjHiRxouk8hSPcqBn6nrd) |
+| 脚本位置 | `脚本/auto_log.py`、`脚本/write_today_custom.py`（自定义内容） |
+| Token文件 | `脚本/.feishu_tokens.json` |
+| 月份映射（已配置） | `1月: JZiiwxEjHiRxouk8hSPcqBn6nrd`、`2月: Jn2EwXP2OiTujNkAbNCcDcM7nRA` |
+| 打开页面 | 自动按日期月份打开对应文档 |
 | 服务端口 | 5050 |

 ---

-**版本**: v3.3 | **更新**: 2026-02-20  
-**特性**: 静默授权、倒序插入、TNTWF规范、四象限分类、**写入完成后自动打开飞书日志页面**、**运营报表子技能（截图→填表→发群竖状格式、会议纪要图片上传、月度统计）**
+**版本**: v3.4 | **更新**: 2026-02-25  
+**特性**: 静默授权、倒序插入、TNTWF规范、四象限分类、**按月份自动路由写入（防串月）**、**写前标题校验+写后双文档校验**、**运营报表子技能（截图→填表→发群竖状格式、会议纪要图片上传、月度统计）**
--- a/02_卡人（水）/水溪_整理归档/经验库/待沉淀/2026-02-25_飞书日志串月误写修复与防错SOP.md
+++ b/02_卡人（水）/水溪_整理归档/经验库/待沉淀/2026-02-25_飞书日志串月误写修复与防错SOP.md
@@ -0,0 +1,75 @@
+# 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/自检脚本加入「串月检测」断言，避免回归。