零成本增量备份 Clawdbot 对话到 Obsidian，支持小时级快照、彩色对话样式与 Telegram 预警，防止 /new 重置导致数据丢失。
说明：
## 核心用法
**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 加密 |
