文件里装得下什么?
一个 AI 角色散落在许多文件里——一张卡片、一份 Markdown 灵魂、一个虚拟形象、一个记忆包。一张表,列出每种文件承载什么,又在途中丢掉什么。
一个 AI 角色散落在许多文件里——一张卡片、一份 Markdown 灵魂、一个虚拟形象、一个记忆包。一张表,列出每种文件承载什么,又在途中丢掉什么。
这并非谁的选择。角色扮演应用沿用了角色卡;智能体框架用 Markdown 文件;VTuber 用 VRM;记忆项目各有各的包。每种格式在自己的层面上表现出色,却看不见其他层面,于是一个活在多处的角色,就成了几个渐行渐远的文件。COF 是把它们装在一起的容器——一个带清单的 ZIP,开放,并对年龄、权利和同意设有规则。本页将它与它所兼容的各种格式逐项对比,也包括 COF 不具备的功能。
七种格式,以其公开发布的版本为准:Character Card V2(chara PNG 及其 JSON,SillyTavern 及同类应用的事实标准)、Character Card V3 / .charx(其 2024 年的后继者,一个带素材的 ZIP)、智能体 Markdown(OpenClaw 和 Hermes 所读取的 SOUL.md、IDENTITY.md、AGENTS.md)、Letta Agent File .af(一个序列化的有状态智能体)、MacPaw Portable Memory .mem(用户自有的记忆包,2026 年)以及 VRM 1.0(基于 glTF 的人形虚拟形象,带有唯一成熟的权限块)。按列阅读:该格式的文件在脱离生成它的应用时,自身能对一个角色说出什么。
| 功能 | COF1.2 · ZIP + 清单 · 规范 CC BY 4.0,工具 MIT | Character Card V2PNG tEXt / JSON · 2023 · SillyTavern 等 | Character Card V3 / .charxJSON、PNG 或 ZIP · 2024 · MIT | Agent MarkdownSOUL.md、IDENTITY.md、AGENTS.md · OpenClaw、Hermes | Letta Agent File.af JSON · Apache-2.0 | MacPaw Portable Memory.mem 包(JSONL)· 1.1 · MIT | VRM 1.0GLB + VRMC_vrm · 人形虚拟形象 |
|---|---|---|---|---|---|---|---|
| 角色 | |||||||
| 文本性格描述、提示词、场景 | ✓内含一张 Character Card V3,另加自由文本 | ✓ | ✓ | ✓自由 Markdown | ✓persona 块 | ~一个 core / persona 条目,文本 | ✕ |
| 示例对话与问候语 | →在内嵌卡片中 | ✓ | ✓另有群组问候语 | ✕ | ✕ | ✕ | ✕ |
| 世界书 / 世界信息由关键词触发的条目 | →在内嵌卡片或 lorebook.json 中 | ✓ | ✓装饰器、正则表达式 | ~智能体可读取的普通文件 | ~块和来源,无触发器 | ✕ | ✕ |
| 一个文件,多个预设工作 / 全年龄、年龄、语言、风格 | ✓命名组合,各有年龄与一致性报告 | ✕每个版本一个文件 | ✕ | ✕ | ✕ | ✕ | ✕ |
| 一个文件,多个角色一组角色及其关系 | ✓身份;关系只声明一次,反向关系自动计算 | ✕ | ~仅群组问候语 | ✕ | ~智能体群组,无关系 | ✕ | ✕ |
| 性别、昵称、原型、叙事角色 | ✓RFC 0003 | ✕ | ~昵称 | ~自由文本 | ✕ | ✕ | ✕ |
| 语言同一角色的多种语言版本 | ✓卡片、要点和节点均可按语言撰写文本;工具支持六种语言 | ✕ | ~多语言创作者备注 | ✕ | ✕ | ✕ | ✕ |
| 外貌与身体 | |||||||
| COF | Character Card V2 | Character Card V3 / .charx | Agent Markdown | Letta Agent File | MacPaw Portable Memory | VRM 1.0 | |
| 参考图:脸部、身体、角度多个视图、角色设定图 | ✓视图带主体、角度、取景、风格;设定图带区域 | ✕PNG 是唯一的图片 | ~图标、背景、用户图标 | ~一个头像路径或 URL | ✕ | ✕仅引用,无数据 | ~一张 1024² 缩略图 |
| 表情 | ✓表情图片,带标签 | ✕ | ✓情绪立绘,已命名 | ✕ | ✕ | ✕ | ✓18 个预设,含口型 |
| 服装 | ✓服装变体,按预设 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| 3D 模型VRM、GLB、splat、可打印网格 | →作为文件保存并声明贴图,另含打印模型和 splat | ✕ | ~一个 3d/ 文件夹,无模式 | ✕ | ✕ | ✕ | ✓它就是模型 |
| 骨骼绑定与面部变形 | →以随附的 VRM / GLB 所定义的为准 | ✕ | ✕ | ✕ | ✕ | ✕ | ✓人形骨骼、弹簧骨骼 |
| 姿势与动作OpenPose、片段、动作特征 | ✓姿势库、带骨骼和帧率的片段、LMA 姿态 | ✕ | ✕ | ✕ | ✕ | ✕ | ~VRMA 动画是单独的文件 |
| 声音带转写的样本、声音档案 | ✓样本、转写、档案、引擎产物、克隆许可 | ✕ | ~一个 audio/ 文件夹,无模式 | ✕ | ✕ | ✕ | ✕ |
| 身份权重LoRA、参考潜变量,及其基础模型 | ✓仅限 safetensors,必须注明基础模型,保留来源 | ✕ | ~一个 ai/ 文件夹,无模式 | ✕ | ✕ | ✕ | ✕ |
| 记忆与内心生活 | |||||||
| COF | Character Card V2 | Character Card V3 / .charx | Agent Markdown | Letta Agent File | MacPaw Portable Memory | VRM 1.0 | |
| 以带日期事件呈现的记忆何时、何地、与谁、感受如何 | ✓RFC 0002:时刻与时期、年龄或日期、当时与现在的感受、清晰度 | ✕ | ~世界书条目,无日期 | ~一份记录每日笔记的 MEMORY.md | ~有大小限制的文本块;无 passages | ✓episodes:eventTime、参与者、重要性 | ✕ |
| 附加在记忆上的媒体 | ✓图片、声音、短视频,存于文件内 | ✕ | ✕ | ✕ | ✕ | ~一个引用和一个哈希,无数据 | ✕ |
| 记忆之间的链接之前 / 之后、属于、同一事件、因为 | ✓ | ✕ | ✕ | ✕ | ✕ | ✓带权重的类型化链接 | ✕ |
| 心理:价值观、信念、欲望、恐惧各有强度、稳定性、时间跨度 | ✓RFC 0004:节点图 | ✕散文中的形容词 | ✕ | ✕散文 | ✕persona 块中的散文 | ~带有效期的事实,无类型 | ✕ |
| 信念背后的缘由一种恐惧指向造成它的记忆 | ✓从节点指向记忆的“因为”链接 | ✕ | ✕ | ✕ | ✕ | ~事实到其 episodes 的溯源 | ✕ |
| 时间20 岁和 45 岁的角色 | ✓节点上的起止时间、记忆上的时期、每个预设的年龄 | ✕单一快照 | ✕ | ✕ | ✕ | ~事实上的 valid-from / valid-to | ✕ |
| 人物、地点与物品只命名一次,由记忆和心理共享 | ✓RFC 0005 | ✕ | ✕ | ✕ | ✕ | ~实体与边,派生而来 | ✕ |
| 可见性与披露正典与个人;秘密、谨慎 | ✓导出时清除;默认不纳入智能体导出的秘密 | ✕ | ✕ | ✕ | ✕块被整体读取 | ~自由的敏感度字符串;范围 RFC 待定 | ✕ |
| 回写经历宿主向文件添加记忆 | ✓cof memory add,来自 OpenClaw 或 Hermes 笔记,幂等 | ✕ | ✕ | ~智能体写笔记,但没有工具导入 | ✓智能体状态就是文件 | ✓带来源的摄取 | ✕ |
| 智能体技能SKILL.md 及其文件 | ✓文件库,类型为 skill | ✕ | ✕ | ✓skills/ 文件夹 | ✓skills[] | ~流程 | ✕ |
| 权利与安全 | |||||||
| COF | Character Card V2 | Character Card V3 / .charx | Agent Markdown | Letta Agent File | MacPaw Portable Memory | VRM 1.0 | |
| 角色的使用许可商业使用、再分发、训练、声音克隆 | ✓清单中的许可,由工具执行 | ✕创作者和标签 | ~创作者、来源 | ✕ | ✕ | ✕ | ✓meta 块:14 个许可字段 |
| 每个素材的许可证 | ✓每个素材一个 SPDX | ✕ | ✕ | ✕ | ✕ | ✕ | ~模型只有一个许可证 URL |
| 真人同意记录、范围、证明、撤回 | ✓rights/ 文件夹;亲密范围和声音克隆必须具备 | ✕ | ✕ | ✕ | ✕ | ✕ | ~虚拟形象许可:仅作者、明确授权、所有人 |
| 声明年龄与未成年人保护 | ✓每个预设声明年龄;涉及未成年人的裸露或亲密内容 = 无效文件 | ✕ | ✕ | ✕ | ✕ | ✕ | ~性用途开关,无年龄 |
| 内容标签与受众 | ✓tags.content、全年龄导出,亲密内容绝不中性化 | ~标签 | ~标签 | ✕ | ✕ | ~敏感度 | ~暴力 / 性用途标志 |
| 来源创建、修改、来源、AI 生成 | ✓仅追加的 source[]、日期、IPTC 数字来源类型、C2PA 附属文件 | ✕ | ✓source[]、创建和修改日期 | ✕ | ✕ | ✓条目上的类型化来源 | ~作者、版权 |
| 完整性哈希,无可执行内容 | ✓每个素材 sha256,拒绝 pickle,可执行文件须声明或被拒绝,安全路径 | ✕ | ✕允许 code/ 文件夹 | ✕ | ✕ | ✓CHECKSUMS、墓碑记录、审计日志 | ✕ |
| 签名 | ~规范中有可选的清单签名(JWS);尚无工具签名 | ✕ | ✕ | ✕ | ✕ | ✓可选 Ed25519 | ✕ |
| 工具与互通 | |||||||
| COF | Character Card V2 | Character Card V3 / .charx | Agent Markdown | Letta Agent File | MacPaw Portable Memory | VRM 1.0 | |
| 带模式和验证器的开放规范 | ✓规范、每个版本的 JSON Schema、cof validate | ~有规范,无验证器 | ~规范和 TypeScript 类型 | ✕约定 | ~SDK 中的 Pydantic 模型 | ✓规范、模式、mem validate | ✓规范、模式 |
| 未知字段在往返转换中保留 | ✓x- 键和类别由 cof-cli 与 Builder 保留 | ~extensions | ✓extensions,SHOULD 保留 | ✓它就是文本 | ✕无版本字段,迁移待定 | ✓episodes 上的 ext | ✓glTF extras |
| 导入其他格式 | ✓V2 / V3 PNG 和 JSON、Character.AI 导出、OpenClaw 和 Hermes 笔记 | ✕ | ✓V2 | ✕ | ✕ | ✕ | ✕ |
| 导出为其他格式 | ✓ccv3 PNG、卡片 JSON、SOUL.md / IDENTITY.md、智能体工作区、Hermes 配置 | ✕ | ✓PNG、JSON、CHARX | ✕ | ✕ | ✕ | ✕ |
| 自描述文件内含一份说明其内容的笔记 | ✓每个文件都写入 COF.md | ✕ | ✕ | ✕ | ✕ | ~清单 | ✕ |
| 参考工具,离线,在浏览器中运行 | ✓Builder、浏览器、cof-cli、ComfyUI 节点 | ✕应用 | ✕应用 | ✕智能体 | ✕服务器 | ~SDK | ✕浏览器 |
| 装进单张 PNG | ✕可导出一张 | ✓ | ✓PNG 或 APNG | ✕ | ✕ | ✕ | ✕ |
| 运行智能体工具、规则、模型配置、历史 | ✕设计如此:executableContent none | ✕ | ~extensions 中的脚本 | ✕ | ✓ | ✕ | ✕ |
| COF 计划中 | |||||||
| COF | Character Card V2 | Character Card V3 / .charx | Agent Markdown | Letta Agent File | MacPaw Portable Memory | VRM 1.0 | |
| 卡片导出携带心理PNG 和 .charx 导出将心理呈现为文本 | ○1.2.3 · 2026年11月29日 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| .charx 导出与导入 | ○1.2.3(cof-cli)· 1.4(Builder) | ✕ | ✓它就是 .charx | ✕ | ✕ | ✕ | ✕ |
| 记忆与节点的加权选取模型此刻接收的内容,为每个宿主统一规定 | ○1.2.3 | ✕ | ✕ | ✕ | ✕ | ✕回忆由服务负责,而非文件 | ✕ |
| 参考播放器对话、选取、配图,并将经历写回文件 | ○1.2.3 | ✕ | ✕ | ✕ | ✓一个 Letta 服务器 | ✕ | ✕ |
| 辅助与自动创建从几行文字出发,使用用户自己的 API 密钥,或免费的占位媒体入门套件 | ○1.2.3 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| 公开的入门角色画廊CC BY 4.0,仅限成年人和非人类 | ○1.2.4 · 2026年12月 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| 有终点的关系、正典的参考日期、所说语言 | ○1.3 · 2027年1月 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| 职业档案职位说明、知识、签名技能、数据政策、AI 披露 | ○1.3 · 2027年1月 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| 工具中的卡片视图和表格视图 | ○1.4 · 2027年2月 | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| 签名与认证对规范化清单的证明 | ○2027年 | ✕ | ✕ | ✕ | ✕ | ✓可选 Ed25519 | ✕ |
将鼠标悬停在标记上可查看注释。绿色标记表示该格式定义了这一项;某个应用是否使用它则是另一回事——大多数应用只读取任一格式的一小部分,COF 也不例外。
装进单张 PNG
卡片是一张可以随处发布的图片,而且始终是图片。.cof 则是一个压缩包。它可以导出 ccv3 PNG(很快还能导出 .charx),但文件本身需要能打开 ZIP 的工具——而所有工具都能。
运行智能体
Letta 的 .af 携带工具、工具规则、模型配置和消息历史。COF 只携带角色,并声明 executableContent: none。由什么来运行它,是宿主的事——这是有意为之。
定义骨骼绑定
VRM 定义骨骼和表情。COF 将 VRM 或 GLB 作为文件随附,连同其权利和贴图,并在其周围添加姿势、片段和声音。骨骼绑定仍归 VRM。
证明删除
MacPaw 的 .mem 会写入墓碑记录和审计日志,因此可以证明一段被遗忘的记忆已在各处被遗忘。COF 在导出时清除(cof extract),且不留任何痕迹——目前如此。
预设
一个文件,多个即用组合:同一角色的 29 岁和 65 岁、工作版和全年龄版、法语版和日语版。其他格式每个版本都需要一个文件,各版本会逐渐走样。
有过去,有内心生活,还有缘由
带日期的记忆,包含人物、地点、事件和感受;由价值观、信念、欲望和恐惧构成的心理,每一项都关联到它所源自的记忆,并带有强度和时间跨度。智能体格式保存散文;记忆格式保存事件;两者都不保存二者之间的联系。
由验证器强制执行的规则
每个预设都声明年龄;涉及未成年人的裸露或亲密内容会使文件无效,而不只是被打上标签。真人需要同意记录。可执行文件、pickle 和不安全路径一律拒绝。无需任何人信赖作者的善意。
从宿主回写
角色在 OpenClaw、Hermes 或某次聊天中的经历,会作为新的个人记忆回到同一个文件(cof memory add)——并随用户一同离开。一个角色,两个家,一份记忆。
这张表的重点不在于 COF 打了最多的勾,而在于 COF 不要求任何人放弃任何东西:一个 .cof 包含一张有效的 Character Card V3,可导出 ccv3 PNG、卡片 JSON、SOUL.md / IDENTITY.md 以及完整的智能体工作区,并将 VRM 作为普通文件保存。其他各列的格式既是它的输入,也是它的输出。凡是 COF 没有对应物的地方——骨骼绑定、运行时、带签名的删除——正确的做法是随附另一种格式,表中以 → 标示。
灰色行是带日期的承诺,而非现有功能。它们来自公开的路线图;修改格式的 RFC 在发布前开放征求意见。
chara_card_v2 规范(SillyTavern、Risu、Chub)及其 PNG tEXt chara 嵌入方式。SPEC_V3.md(MIT):素材、creator_notes_multilingual、source[]、日期、group_only_greetings、embeded://assets/ 文件夹。SOUL.md / IDENTITY.md、Hermes Agent 配置、AGENTS.md 约定;COF 写入的内容记录在 1.2.2 版本说明中。letta 包中的 AgentFileSchema:agents, groups, blocks, files, sources, tools, mcp_servers, skills;无 passages,无格式版本字段。CHECKSUMS、可选 Ed25519 签名;RFC 0001–0003 面向 1.2。meta 许可块(虚拟形象许可、暴力和性用途、商业使用、再分发、修改、署名)。