diff --git a/02_卡人(水)/水桥_平台对接/飞书管理/SKILL.md b/02_卡人(水)/水桥_平台对接/飞书管理/SKILL.md index b06ae1e1..f7f965da 100755 --- 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规范、四象限分类、**按月份自动路由写入(防串月)**、**写前标题校验+写后双文档校验**、**运营报表子技能(截图→填表→发群竖状格式、会议纪要图片上传、月度统计)** diff --git a/02_卡人(水)/水溪_整理归档/经验库/待沉淀/2026-02-25_飞书日志串月误写修复与防错SOP.md b/02_卡人(水)/水溪_整理归档/经验库/待沉淀/2026-02-25_飞书日志串月误写修复与防错SOP.md new file mode 100644 index 00000000..df831677 --- /dev/null +++ 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/自检脚本加入「串月检测」断言,避免回归。