核心用法
Auto-Drive Skill 是连接 Autonomys Network 永久去中心化存储的桥梁,提供四大核心能力:
1. 文件上传与检索
通过 autodrive-upload.sh 将文件上传至 Auto-Drive 主网,返回内容标识符 CID(Content Identifier)。支持 JSON 强制类型标记与 ZLIB 压缩。使用 autodrive-download.sh 可通过 CID 下载文件——若配置 API 密钥则走认证通道(自动解压),否则使用公共网关。
2. 链式记忆存储autodrive-save-memory.sh 将每次"记忆"封装为结构化 JSON,包含标准头信息(agentName、timestamp、previousCid)与数据载荷。关键设计在于 previousCid 指针:每个新记忆都指向前一个记忆的 CID,形成不可篡改的链表结构。
3. 复活重建机制autodrive-recall-chain.sh 实现"复活"功能——给定任一 CID(通常是最新的),可遍历整个链表直至创世节点,完整重建代理的历史上下文。这是"版本控制式的意识延续":服务器崩溃后,新实例仅需一个 CID 即可恢复全部记忆。
4. 状态管理与持久化
自动维护本地状态文件(记录 lastCid、chainLength 等),并可选将最新 CID 钉选至 MEMORY.md,便于人工备份与链上锚定(进阶用法)。
显著优点
- 永久性:数据写入 Autonomys Network 后不可删除,适合关键决策日志、审计追踪
- 抗审查性:去中心化存储,无单点故障或第三方撤销风险
- 极简复活:单 CID 即可重建完整历史,大幅降低灾难恢复复杂度
- 标准化格式:采用 Autonomys Agents 规范的 header/data 结构,生态互操作性强
- 渐进式权限:公开网关支持无密钥下载,上传/链式操作需免费 API 密钥(20 MB/月)
潜在局限与风险
| 维度 | 说明 |
|------|------|
| **公开性** | 默认存储为公开可访问,严禁存放私钥、PII 等敏感数据 |
| **容量限制** | 免费层 20 MB/月,单文件实际上限约 20 MB,大文件需压缩或分片 |
| **不可逆性** | CID 一旦生成无法修改或删除,错误上传将永久留存 |
| **依赖外部网络** | 需 Autonomys Network 与网关可用,存在网络层依赖 |
| **密钥管理** | API 密钥泄露可能导致配额被恶意消耗 |
| **链上成本** | 进阶功能(EVM 锚定 CID)涉及 Gas 费用,非免费 |
适合人群
- 构建长期运行、需跨会话保持状态的 AI Agent 开发者
- 追求审计透明、决策可溯源的自动化系统(DAO 工具、治理机器人)
- 需要"数字永生"机制的关键业务日志存储场景
- 对 Web3 基础设施有基础认知、能管理密钥与 CID 的技术用户
常规风险提示
- 数据泄露风险:所有上传内容默认可被任何人通过网关访问,务必预先脱敏
- 配额耗尽风险:20 MB 月度限制易被意外消耗,建议实施上传前大小检查
- CID 丢失风险:若未备份 lastCid 且本地状态文件损坏,链式记忆将断裂无法复活
- 压缩兼容性:公共网关下载不自动解压,需下游处理或确保接收方知晓压缩状态
- 网络波动:主网拥堵或网关故障时,上传/召回操作可能失败,需实现重试与降级策略