aiti-backup

❝ config 有安全网，state 也该有。 ❞

state 层大数据（会话归档 .pwarc、git-trace ops、~/.pi/agent/sessions）的快照备份—— 与 aiti-configs 互补：configs 管「小配置 git 版本化」，本扩展管「大数据快照」。

机制

• 快照语义：每次备份 = <dest>/<sourceId>/snapshots/<UTC时间戳>/ 完整时间点 + manifest.json（完成标记）；
• 硬链接增量：与上一快照同 path 且 size+mtime 一致 → fs.link 零拷贝；目标盘不支持（exFAT 等）自动整轮降级复制；
• 源严格只读：备份从不写/删源；symlink 不跟随；运行态噪音名默认排除；
• 执行隔离：扫描/复制在独立子进程，进度走 stdout JSONL → event-bus aiti-omp-agent:rebind 同族 topic aiti-backup:progress|done|error（无轮询）；
• 中断安全：任意时刻 kill 只可能留 .tmp-* 半成品（下次自动清理）；同源运行锁防并发；
• 保留轮转：keepCount（默认 7）删最旧，仅限 snapshots/ 内时间戳命名目录。

快速上手（API 形态，UI 面板 = M5）

base=/dev/api/extensions/aiti-backup            # prod 实例去掉 /dev
curl -s localhost:30142$base/status                                   # 源清单（state 自动发现 + pi-sessions）
curl -s -X POST localhost:30142$base/config -H content-type:application/json \
  -d '{"dest":"/mnt/your-backup-disk"}'                               # 设目的地（与源互斥校验）
curl -s -X POST localhost:30142$base/backup -H content-type:application/json -d '{"all":true}'
curl -s localhost:30142$base/runs                                     # 运行历史

• 源开关：POST config {"sourceOverrides":{"pi-sessions":{"enabled":false}}}；自定义源：custom:[{id,path}]。
• 目的地由用户自选（外接盘/NAS），备份内容未加密——会话内容含隐私，请放在自己控制的盘上。