karuo-ai/02_卡人（水）/水桥_平台对接/飞书管理/参考资料/卡若的飞书日志_说明手册.md

卡若的飞书日志 · 说明手册

版本：v1.0
更新时间：2026-02-25
适用对象：卡若本人（日记记录 + 运营报表登记）

---

1. 这是什么

卡若的飞书日志 是一个专用子技能，用来把每天的工作日志与运营报表摘要，快速写入飞书，并自动按月份路由到正确文档。

核心价值：

• 任意目录可执行，一条命令写日志
• 自动防串月（2月不会写到1月）
• 支持“完成度 + 卡点 + 下一步”结构化记录
• 同日可覆盖更新，便于迭代当天进展

---

2. 一键入口

python3 "/Users/karuo/Documents/个人/卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/脚本/karuo_feishu_log.py"

---

3. 工作流图

flowchart LR
    A[1 触发入口<br/>karuo_feishu_log.py<br/>任意目录可执行]
    B[2 收集输入<br/>日期 进度 卡点<br/>下一步 清晰度]
    C[3 月份路由<br/>解析X月X日<br/>映射MONTH_WIKI_TOKENS]
    D[4 写前校验<br/>wiki标题包含当月<br/>不匹配拒绝]
    E[5 组装日志内容<br/>TNTWF结构]
    F[6 写入飞书<br/>同日覆盖写入<br/>打开结果页]
    G[7 校验与回滚<br/>目标月存在<br/>非目标月不存在]

    A --> B --> C --> D --> E --> F --> G

若你仍需要“图片版流程图”，建议使用仓库内相对路径图片文件，不要引用 .cursor/assets 绝对路径。

---

4. 常用命令

4.1 快速记录今天（默认）

python3 "/Users/karuo/Documents/个人/卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/脚本/karuo_feishu_log.py"

4.2 指定日期并写进度

python3 "/Users/karuo/Documents/个人/卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/脚本/karuo_feishu_log.py" \
  --date "2月25日" \
  --progress 55 \
  --bottleneck "服务器导致接口化部署不稳定" \
  --next "优先修复部署链路，再推进接口与网站" \
  --clarity "功能层与解决方案仍需继续梳理"

4.3 交互输入模式

python3 "/Users/karuo/Documents/个人/卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/脚本/karuo_feishu_log.py" --interactive

---

5. 参数说明

• --date：日志日期，格式 X月X日，例如 2月25日
• --progress：完成度，0-100
• --bottleneck：当前卡点
• --next：下一步动作
• --clarity：对“功能层与方案层”清晰度说明
• --interactive：启动交互输入，便于临时记录

---

6. 写入规则（必须知道）

1. 系统先解析 --date 的月份，再路由到对应月份文档 token。
2. 写入前先校验标题月份，不匹配则拒绝写入。
3. 同日期二次写入时，会覆盖更新当日记录（用于修正进度/卡点）。
4. 写入成功后自动打开对应月份文档。

---

7. 推荐填写模板

• 今日主题：卡若AI / 接口 / 网站 / 运营报表
• 完成度：例如 55%
• 卡点：一句话说清楚“阻塞原因”
• 下一步：一句话说清楚“下一动作”
• 清晰度：功能层与解决方案是否一一对应

---

8. 故障排查

• 提示 Token 失败：先重新执行一次，触发静默刷新
• 写入失败（字段校验）：缩短单条文本长度后重试
• 写错月份：按日期修正后重写，同日会覆盖

---

9. 关联文件

• 子技能：02_卡人（水）/水桥_平台对接/飞书管理/卡若的飞书日志_SKILL.md
• 主技能：02_卡人（水）/水桥_平台对接/飞书管理/SKILL.md
• 脚本：02_卡人（水）/水桥_平台对接/飞书管理/脚本/karuo_feishu_log.py