飞书日记助手

它解决什么问题

很多人的日记输入是碎片化的：白天随手发一条文字或语音，深夜想整理时却已经散落在聊天窗口里，手动复制、排版、归档到飞书知识库既麻烦又容易中断。这个技能把这件事拆成一条不需要意志力的流水线：碎片先暂存，凌晨统一整理，早上推送链接给你复核，记录习惯不再依赖当天是否想起来。

核心工作流

技能由五个相互衔接的部分组成：

• 碎片收集（实时）：通过微信等渠道发来的文字直接暂存；语音消息由平台层自动转文字，技能只负责接收文本。每条碎片带时间戳追加到 ~/.qclaw/diary_fragments/YYYY-MM-DD.md，回复一句简短确认即可，整理被推迟到凌晨。
• 定时提醒（手动触发）：说「设置每日提醒」后，为默认时间点（08:30、12:30、15:00、18:30、23:00）各创建一条 cron 任务，并同时部署三条后台任务。
• 凌晨整理（02:00 自动）：读取前一天的碎片，通过 IP 定位补充天气与地点，按模块化模板渲染成 Markdown，写入飞书知识库并保存链接，最后清理碎片文件。没有碎片则静默结束。
• 次日推送（08:30 自动）：把昨日日记链接通过微信推送，并标记已推送，避免重复发送。
• 开机补归档（每小时 :17）：用 list-pending 对比碎片文件与 _url 标记文件，发现凌晨关机期间漏掉的归档或推送，开机一小时内自动补上。

日记模板要求保留用户提供的所有细节，用 ⚠️📉✅ 等图标标注状态，形成输入→输出→思考的闭环，标题自动总结不超过 15 字。配套脚本包括 scripts/setup.py（配置向导）、scripts/feishu_auth.py（OAuth 授权与 token 管理）、scripts/feishu_api.py（写入知识库）、scripts/fragment_store.py（碎片与链接管理）。

适用边界与注意点

• 依赖 Python 3.9+ 与 requests 库，且需要自备飞书应用凭据并完成 OAuth 授权；凭据与授权按用户隔离，各写各的知识库。
• 语音转文字由微信/QClaw 平台层完成，技能本身不做 ASR；换渠道接入时需确认上游是否已转写。
• 天气和地点基于 IP 定位推断，在 VPN 或移动网络下可能不准。
• 补归档依赖 cron 随 QClaw 启动，机器长期关机则不会触发。
• token 有有效期，建议定期运行 python3 scripts/feishu_auth.py --status 检查。