SuperAPI AI 工具集

agent-session-capture-backup

部署与运维

查看项目

更新于 10-15 23:33

技能介绍

用途:当需要确认各机器上的智能体活动是否被捕获、索引或备份时使用本技能,覆盖 Pi、Claude Code、Codex 的会话转录与运行记录,以及 joelclaw 运行捕获和失败投递的 outbox。

主要能力:脚本会验证每台主机可达性、验证其能否访问中央 run-capture 健康端点,可选修复 .zshrc、.zprofile 与 ~/.config/system-bus.env 中的 JOELCLAW_CENTRAL_URL;用 rsync 将转录、运行与 outbox 源同步到 NAS(不删除源文件);向 /api/runs 重放有限数量的 outbox JSON;并写出含源计数、备份计数、最新 mtime、字节总量与 outbox 前后对比的 JSON 回执。

使用方式:在 ~/Code/joelhooks/joelclaw-runtime 下运行 bun scripts/agent-session-audit-backup.ts,可带 --hosts flagg,blaine,panda、--central-url、--backup-root /Volumes/three-body/sessions、--repair-env、--sync=true、--replay-outbox、--replay-limit 250、--replay-max-bytes 10485760 等参数。仅做元数据审计时用 --sync=false 并省略 --repair-env 与 --replay-outbox。也可通过 joelclaw send system/agent-session.capture-backup.requested 手动触发,或依赖每日 cron(TZ=America/Los_Angeles 15 5 * * *)。

适用场景与限制:适用于多机捕获链路巡检、NAS 备份与 outbox 积压修复。注意不要使用已失效的 http://panda:3000,也不要在 Panda 本地 Typesense 鉴权恢复前使用其 /api/runs;备份必须是复制而非轮转,不得删除或移动实时转录文件;outbox 重放属修复操作,应保持有界并留下回执;切勿打印 ~/.joelclaw/auth.json 中的令牌。