obsidian-conversation-backup

🗃️ 零成本智能对话归档管家

🥥18总安装量 4评分人数 5
100% 的用户推荐

Clawdbot 官方社区贡献的本地对话备份工具,通过纯 Shell 脚本实现零成本增量归档,将 JSONL 会话转为美观的 Obsidian Markdown 格式,彻底解决 /new 重置导致的数据丢失问题。

B

存在边界风险,建议在隔离环境中验证

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 无用户输入直接执行或动态代码构建,代码注入风险为 NONE
  • ✅ 所有文件操作限定于用户配置的 VAULT_DIR 与 SESSION_DIR,无越界删除或修改原始数据
  • ✅ 网络通信仅限可选 Telegram 通知,使用 HTTPS 且不传输敏感内容
  • ⚠️ 默认配置使用 /root 路径,建议用户自定义为非特权目录以降低权限风险
  • ⚠️ 状态跟踪文件(.last_snapshot_timestamp 等)若被误删将导致增量逻辑失效

使用说明

核心用法

Obsidian Conversation Backup 是一套面向 Clawdbot 用户的本地自动化备份解决方案。其核心工作流围绕三个脚本展开::monitor_and_save.sh 作为守护进程,通过 cron 每小时检测会话文件变化,仅保存新增消息生成增量快照;save_full_snapshot.sh 供用户手动触发完整对话归档,支持自定义主题命名;create_hourly_snapshots.sh 则用于日终整理,将对话按整点时段切分为独立文件便于回顾。所有输出均采用 Obsidian 引用框语法,用户消息以蓝色 [!quote]] 呈现,助手回复以绿色 [!check]] 区分,并附带精确到分钟的时间戳与多段落支持。

显著优点

该技能的最大优势在于零运营成本——纯 Bash 与 jq 实现,不调用任何 LLM API。增量备份机制智能高效,通过行数比对避免内容重复,配合隐藏状态文件实现精准断点续传。格式化层面,jq 模板将原始 JSONL 转为视觉清晰的聊天样式,支持自定义 emoji 与配色方案,完美融入 Obsidian 知识库生态。此外,集成的令牌监控可在对话接近 800k/900k 阈值时通过 Telegram 推送预警,辅助用户决策是否执行 /new 重置。

潜在缺点与局限性

首先,环境依赖较重:需预装 jq、配置 cron 服务,且默认路径假设为 /root 目录,对非 root 用户或 macOS/Windows 环境不够友好。其次,功能边界明确——仅处理本地会话文件,无法备份云端历史或跨设备同步;Telegram 通知为可选功能,若未配置则失去令牌预警能力。增量备份的"最大 1 小时丢失窗口"虽可接受,但对极高频重要对话仍需配合手动快照弥补。最后,格式化模板基于 jq,复杂嵌套消息或特殊字符可能存在解析边界情况。

适合的目标群体

核心受众为重度 Obsidian 用户Clawdbot 长期对话维护者:包括需将 AI 对话纳入个人知识库的研究人员、依赖历史上下文追溯决策过程的产品经理、以及希望建立可检索对话档案的开发者。同时适合对数据主权敏感、拒绝第三方云备份方案的用户群体。由于需要基本的命令行与 cron 配置能力,技术门槛将非技术用户排除在外。

使用风险

性能层面:小时级 cron 任务对系统资源消耗极低,但高频调整(如每 5 分钟)可能因频繁磁盘 IO 产生轻微负载。依赖项风险:jq 版本差异可能导致格式化异常;cron 服务未运行或时区配置错误将中断备份链。数据一致性:若手动删除 .last_snapshot_timestamp 等状态文件,将触发内容重复备份;会话文件路径变更后未同步更新脚本将产生静默失败。权限风险:默认 root 路径配置若未修改,可能引发非特权用户执行时的权限拒绝。

obsidian-conversation-backup 内容

文件夹图标scripts文件夹
手动下载zip · 10.5 kB
create_hourly_snapshots.shtext/x-shellscript
请选择文件