Cell 导出格式
wesgine 的 Cell 导出打包格式与内容清单。
导出格式
Cell 导出为 tar.gz 流，包含该 Cell 的完整可移植快照。
默认包含
| 内容 | 路径 | 说明 |
|---|---|---|
| 元数据库 | meta.db | Cell 元数据 |
| 状态库 | state.db | 运行时状态、Traces |
| 会话库 | sessions.db | 会话与消息历史 |
| 记忆数据 | 内嵌于数据库 | 全部记忆条目 |
| 知识库文件 | knowledge/ | 已导入的文档和索引 |
| 技能包 | skills/ | Tier C 技能文件 |
| 工作区文件 | workspace/ | Actor 产出文件 |
默认排除
| 内容 | 原因 |
|---|---|
.scratch/ | 临时计算域，Run 结束后 GC |
| Provider 凭据 | 安全考虑，不导出明文密钥 |
| 进程锁文件 | .cell.lock 是运行时状态 |
可选控制
CellPortableSpec 控制打包行为：
ExportOpts{
SkipWorkspace: true, // 排除 workspace/ 目录
}
凭据处理
导出时 Provider 凭据不包含在内。
导入后需重新配置：
inline密钥需重新填写env引用需在新环境设置live需重新绑定 getter
导入行为
导入时：
- 解压 tar.gz 到新 Cell 目录
- 恢复三层数据库
- 重建索引（如需要）
- Cell 以 Cool 态就绪
API
GET /admin/cells/{id}/export → tar.gz 流
POST /admin/cells/import → 导入（?overwrite=1）
可移植性保证
导出文件不依赖源 Hypervisor 的任何状态。
可在不同机器、不同操作系统间移植。