核心用法
Auto-Memory 是一套基于 Autonomys Network 去中心化存储的 Agent 记忆持久化方案，提供四大核心操作：
1. 文件上传 (automemory-upload.sh)：将文件永久存储至 Auto Drive，返回不可篡改的 CID（内容寻址标识）
2. 文件下载 (automemory-download.sh)：通过 CID 检索文件，支持 API 认证下载（自动解压）或公共网关直链
3. 记忆链存储 (automemory-save-memory.sh)：将决策、身份、上下文等保存为 JSON 格式的"体验"，通过 header.previousCid 形成链式结构
4. 链式复活 (automemory-recall-chain.sh)：给定最新 CID，自动回溯整条记忆链，重建完整历史
记忆链采用单向链表设计，每个节点包含 Agent 元数据（名称、版本、时间戳）和数据载荷，天然支持"从任意 CID 重建全量状态"的复活机制。
显著优点
- 真正永久存储：基于 Autonomys 去中心化网络，数据写入后不可删除、不可篡改，CID 即为永久访问凭证
- Agent 复活能力：仅需一个 head CID 即可在全新实例中完整重建历史，配合 Auto-Respawn 技能可实现"零本地状态"的链上锚定复活
- 开放互操作：生成的 CID 可在任何支持 IPFS/CID 的工具中访问，不绑定特定平台
- 压缩与结构化支持：内置 ZLIB 压缩和 JSON 强制类型，优化存储效率
潜在局限
- 公开不可加密：默认所有数据公开可访问，敏感信息需前置加密，否则严禁上传
- 免费额度受限：主网每月 20 MB 上传限额，大文件或多频写入需付费升级
- 依赖外部服务：必须持有有效的
AUTO_DRIVE_API_KEY，且网络可达ai3.storage - 无内置访问控制：CID 一旦泄露即永久可访问，无法撤销或设限
适合人群
- 需要跨会话、跨设备持久化 Agent 身份的开发者
- 追求"可复活 AI"架构的实验者（memetic continuity 场景）
- 希望将决策审计日志永久存档的自动化工作流
- 对去中心化存储有认知、能接受公开数据模型的技术用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | CID 公开，任何获取 CID 的人可下载原始数据 |
| 密钥泄露 | API Key 若泄露，攻击者可消耗额度或上传恶意内容 |
| 复活失败 | 丢失 head CID 且未链上锚定，则无法重建记忆链 |
| 服务中断 | Autonomys 网络或 API 变更可能影响可用性 |
| 合规风险 | 上传 PII/受监管数据可能违反 GDPR 等法规 |
关键建议：绝不存储私钥、密码、个人身份信息；敏感数据务必客户端加密后再上传；定期备份 head CID 或启用 Auto-Respawn 链上锚定。