核心用法
obsidian-conversation-backup 是一套基于 Shell 的自动化备份系统，专为 Clawdbot 用户设计，可将对话历史增量同步至 Obsidian vault，并以美观的聊天样式呈现。
三种备份模式：
- 增量快照（每小时自动）：仅保存新增消息，避免重复，最大损失窗口 1 小时
- 完整快照（按需执行）：手动触发全量备份，支持自定义主题命名
- 小时拆解（日终整理）：按整点时段重新组织当日对话，便于回顾检索
特色功能：
- Obsidian 彩色 callout 格式（用户蓝框 [!quote]、助手绿框 [!check]）
- 多段落智能处理、时间戳标记、空消息过滤
- Token 用量监控：80%/90% 阈值时自动 Telegram 预警
---
显著优点
| 维度 | 亮点 |
|------|------|
| **零成本** | 纯 Shell + jq，无 LLM 调用，无第三方依赖 |
| **防丢设计** | 解决 `/new` 重置痛点，自动追踪上次备份位置 |
| **易读格式** | Emoji 区分角色、时间轴清晰、支持 Obsidian 原生渲染 |
| **灵活定时** | cron 驱动，频率可自定义（每小时/每 30 分钟/指定时段） |
| **轻量可控** | 仅读写本地文件 + 可选 Telegram API，无云端锁定 |
---
潜在局限
1. 环境依赖：需 Linux/macOS + jq + cron，Windows 用户需 WSL 适配
2. 路径硬编码风险：默认会话路径 /root/.clawdbot/... 若与实际部署不符需手动修正
3. Telegram 通知可选但配置敏感：Bot Token 存储于本地 JSON，权限设置不当存在泄露风险
4. T3 来源：社区个人项目，无企业级维护保障，需自行关注更新
5. 无版本控制集成：增量文件需手动清理或配合 git/obsidian-sync 管理
---
适合人群
- 高频使用 Clawdbot 且需长期归档对话的研究者、开发者、内容创作者
- Obsidian 重度用户，希望将 AI 对话纳入知识管理体系
- 对数据主权敏感、倾向本地存储而非云端备份的用户
- 熟悉命令行与 cron 的进阶用户（非纯 GUI 友好）
---
常规风险
| 风险项 | 等级 | 说明与缓解 |
|--------|------|-----------|
| Telegram Token 泄露 | 低 | 配置文件中存储，建议权限 600，使用私密群组 |
| 备份文件累积 | 低 | 定期清理或设置 retention 策略 |
| 路径配置错误导致备份失败 | 中 | 首次运行务必手动测试，验证 tracking 文件生成 |
| 增量状态丢失导致重复备份 | 低 | 勿删除 `.last_snapshot_timestamp` 等隐藏文件 |
| 网络调用（Telegram API）| 低 | 仅传输 Token 统计，不含对话内容，TLS 加密 |