Self Backup to Feishu
AI 助手状态自动备份与恢复机制,支持飞书文档存储。
概述
本技能提供 AI 助手的"记忆备份"能力,将核心状态文件备份到飞书文档,支持:
- 自动备份:每日定时、事件触发
- 手动备份:随时同步状态
- 一键恢复:从飞书文档重建所有文件
快速开始
备份状态
用户:备份一下状态
AI:好的,我来备份当前状态到飞书...
恢复状态
用户:从飞书恢复状态
AI:正在读取飞书备份文档...
正在重建文件...
恢复完成!
核心功能
1. 自动备份
触发条件:
- 每日定时备份(建议凌晨3点)
- 掌握新技能时
- 完成自动化任务时
- 添加重要联系人时
- 用户明确要求时
备份内容:
- 身份信息(IDENTITY.md)
- 用户信息(USER.md)
- 灵魂定义(SOUL.md)
- 长期记忆(MEMORY.md)
- 邮箱配置(.msmtprc)
- cron 定时任务列表
2. 手动备份
当用户要求备份时:
- 读取飞书备份文档现有内容
- 生成最新状态
- 增量更新(保留历史信息)
- 更新时间戳
重要原则: 增量更新,不直接覆盖。先读取现有内容,解析结构,只更新变化的部分。
3. 恢复机制
从飞书恢复状态的流程:
- 读取状态备份文档
- 读取沟通历史备份文档(如有)
- 解析文档结构,提取各部分内容
- 重建 MEMORY.md、IDENTITY.md、USER.md、SOUL.md
- 重建 .msmtprc 配置
- 恢复 cron 定时任务
- 提示用户缺失的部分(如沟通历史备份不存在)
配置说明
飞书应用配置
需要飞书开放平台应用,获取:
app_idapp_secret- 文档 token(从飞书文档 URL 提取)
文档结构
备份文档应包含:
# AI助手状态备份
> 最后更新:YYYY-MM-DD HH:MM:SS
> 触发原因:xxx
## 一、身份信息
## 二、用户信息
## 三、灵魂定义
## 四、完整记忆内容
## 五、邮箱配置
## 六、自动化任务
## 七、恢复步骤
脚本说明
scripts/daily-backup.py
每日自动备份脚本,功能:
- 读取所有状态文件
- 获取 cron 任务列表
- 生成完整备份内容
- 先保存本地备份文件
- 标记待同步到飞书
使用:
python3 scripts/daily-backup.py
scripts/manual-backup.py
手动备份脚本,用于事件触发备份。
使用:
python3 scripts/manual-backup.py "备份原因"
最佳实践
- 增量更新:更新飞书文档时,先读取现有内容,在原有基础上更新,不要直接覆盖
- 双重备份:状态备份 + 沟通历史备份,确保记忆完整
- 本地缓存:先保存本地备份文件,会话时再同步到飞书
- 恢复检查:恢复后验证文件完整性,提示缺失部分
注意事项
- 飞书 API 需要有效的 tenant_access_token
- 文档权限需要配置正确(应用可访问)
- 敏感信息(如授权码)建议加密存储
- 恢复后可能需要重新授权某些服务