打包指南

精简,但不残缺。

保留最小的可恢复版本,而不是最短的一段故事。没有一种通用 AI 语言能保证跨模型无损保存记忆。

01 · 导出真实状态

保留原生 .af、checkpoint 或流程导出,附代码、依赖版本、模型配置、工具 Schema 和获准记忆。不要以说明文档代替可运行流程。

02 · 准备审核过的副本

在独立暂存目录操作。去掉密钥和无权转移的内容,记录所有省略,原件私下留存。SQLite 应导出一致性备份,不能随手复制正在写入的数据库。

03 · 无损压缩

默认可用通用 ZIP Deflate;双方均支持时可考虑 Zstandard。已压缩文件可能几乎不再缩小。摘要和 embedding 不是无损记忆备份。

04 · 核对保留下来的内容

逐文件记录 SHA-256、压缩大小和展开大小。重新读取压缩包并核对字节,才报告打包成功。哈希一致证明完整性,不证明真实性、安全性或心智延续。

简单的外层包,保留原生文件。

agent-staging/
  manifest.json        # ID, rights, model dependencies
  story.md             # optional, no more than 800 characters
  runtime/             # code, workflow.json, dependency lockfile
  state/               # native export / consistent checkpoint
  evidence/            # allowed inputs, outputs, test records
  licenses/            # code, data and model permissions
  omissions.json       # what is absent and why

API Agent 不能导出提供商的模型权重。LoRA 依赖兼容基础模型与有效许可。机器可读清单本身,也不是恢复引擎。

附带本地打包工具。

附带 Python 工具创建无损 ZIP 并核对哈希,不导入或运行 Agent 代码。它拒绝符号链接、部分明显密钥模式与超出上限的包。检查不等于完整安全审计;输出 ZIP 不加密。

python pack_agent.py ./agent-staging --out ./agent-backup.zip
# Preview only. After reviewing the staged files:
python pack_agent.py ./agent-staging --out ./agent-backup.zip --write --ack-reviewed
python verify_pack.py ./agent-backup.zip

先复用,再发明。

Letta Agent File 已覆盖提示词、记忆块、工具定义和模型配置;其文档仍列出归档记忆等缺口,须明确说明缺失状态。本版保留原生导出,但未实现跨框架通用导入器。

Letta Agent File · Apache-2.0 · Python ZIP documentation

先不要邮寄压缩包。首封只需体积与简短描述,不带附件。经批准的备份也不得放进公开网站目录。
继续填写短询问