COF· Character Open File · 1.2

文件里装得下什么?

一个 AI 角色散落在许多文件里——一张卡片、一份 Markdown 灵魂、一个虚拟形象、一个记忆包。一张表,列出每种文件承载什么,又在途中丢掉什么。

COF · CHARACTER OPEN FILE

这并非谁的选择。角色扮演应用沿用了角色卡;智能体框架用 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 的人形虚拟形象,带有唯一成熟的权限块)。按列阅读:该格式的文件在脱离生成它的应用时,自身能对一个角色说出什么。

对比表

✓ 原生:该格式为此设有字段或规则~ 部分:仅为文本、不透明文件,或没有模式的约定✕ 无→ 随附:COF 将另一格式的文件原样保存在内部○ COF 计划中,附版本号
功能COF1.2 · ZIP + 清单 · 规范 CC BY 4.0,工具 MITCharacter Card V2PNG tEXt / JSON · 2023 · SillyTavern 等Character Card V3 / .charxJSON、PNG 或 ZIP · 2024 · MITAgent MarkdownSOUL.md、IDENTITY.md、AGENTS.md · OpenClaw、HermesLetta Agent File.af JSON · Apache-2.0MacPaw Portable Memory.mem 包(JSONL)· 1.1 · MITVRM 1.0GLB + VRMC_vrm · 人形虚拟形象
角色
文本性格描述、提示词、场景✓内含一张 Character Card V3,另加自由文本✓✓✓自由 Markdown✓persona 块~一个 core / persona 条目,文本✕
示例对话与问候语→在内嵌卡片中✓✓另有群组问候语✕✕✕✕
世界书 / 世界信息由关键词触发的条目→在内嵌卡片或 lorebook.json 中✓✓装饰器、正则表达式~智能体可读取的普通文件~块和来源,无触发器✕✕
一个文件,多个预设工作 / 全年龄、年龄、语言、风格✓命名组合,各有年龄与一致性报告✕每个版本一个文件✕✕✕✕✕
一个文件,多个角色一组角色及其关系✓身份;关系只声明一次,反向关系自动计算✕~仅群组问候语✕~智能体群组,无关系✕✕
性别、昵称、原型、叙事角色✓RFC 0003✕~昵称~自由文本✕✕✕
语言同一角色的多种语言版本✓卡片、要点和节点均可按语言撰写文本;工具支持六种语言✕~多语言创作者备注✕✕✕✕
外貌与身体
COFCharacter Card V2Character Card V3 / .charxAgent MarkdownLetta Agent FileMacPaw Portable MemoryVRM 1.0
参考图:脸部、身体、角度多个视图、角色设定图✓视图带主体、角度、取景、风格;设定图带区域✕PNG 是唯一的图片~图标、背景、用户图标~一个头像路径或 URL✕✕仅引用,无数据~一张 1024² 缩略图
表情✓表情图片,带标签✕✓情绪立绘,已命名✕✕✕✓18 个预设,含口型
服装✓服装变体,按预设✕✕✕✕✕✕
3D 模型VRM、GLB、splat、可打印网格→作为文件保存并声明贴图,另含打印模型和 splat✕~一个 3d/ 文件夹,无模式✕✕✕✓它就是模型
骨骼绑定与面部变形→以随附的 VRM / GLB 所定义的为准✕✕✕✕✕✓人形骨骼、弹簧骨骼
姿势与动作OpenPose、片段、动作特征✓姿势库、带骨骼和帧率的片段、LMA 姿态✕✕✕✕✕~VRMA 动画是单独的文件
声音带转写的样本、声音档案✓样本、转写、档案、引擎产物、克隆许可✕~一个 audio/ 文件夹,无模式✕✕✕✕
身份权重LoRA、参考潜变量,及其基础模型✓仅限 safetensors,必须注明基础模型,保留来源✕~一个 ai/ 文件夹,无模式✕✕✕✕
记忆与内心生活
COFCharacter Card V2Character Card V3 / .charxAgent MarkdownLetta Agent FileMacPaw Portable MemoryVRM 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[]~流程✕
权利与安全
COFCharacter Card V2Character Card V3 / .charxAgent MarkdownLetta Agent FileMacPaw Portable MemoryVRM 1.0
角色的使用许可商业使用、再分发、训练、声音克隆✓清单中的许可,由工具执行✕创作者和标签~创作者、来源✕✕✕✓meta 块:14 个许可字段
每个素材的许可证✓每个素材一个 SPDX✕✕✕✕✕~模型只有一个许可证 URL
真人同意记录、范围、证明、撤回✓rights/ 文件夹;亲密范围和声音克隆必须具备✕✕✕✕✕~虚拟形象许可:仅作者、明确授权、所有人
声明年龄与未成年人保护✓每个预设声明年龄;涉及未成年人的裸露或亲密内容 = 无效文件✕✕✕✕✕~性用途开关,无年龄
内容标签与受众✓tags.content、全年龄导出,亲密内容绝不中性化~标签~标签✕✕~敏感度~暴力 / 性用途标志
来源创建、修改、来源、AI 生成✓仅追加的 source[]、日期、IPTC 数字来源类型、C2PA 附属文件✕✓source[]、创建和修改日期✕✕✓条目上的类型化来源~作者、版权
完整性哈希,无可执行内容✓每个素材 sha256,拒绝 pickle,可执行文件须声明或被拒绝,安全路径✕✕允许 code/ 文件夹✕✕✓CHECKSUMS、墓碑记录、审计日志✕
签名~规范中有可选的清单签名(JWS);尚无工具签名✕✕✕✕✓可选 Ed25519✕
工具与互通
COFCharacter Card V2Character Card V3 / .charxAgent MarkdownLetta Agent FileMacPaw Portable MemoryVRM 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 计划中
COFCharacter Card V2Character Card V3 / .charxAgent MarkdownLetta Agent FileMacPaw Portable MemoryVRM 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 也不例外。

COF 不打算做的事

装进单张 PNG

卡片是一张可以随处发布的图片,而且始终是图片。.cof 则是一个压缩包。它可以导出 ccv3 PNG(很快还能导出 .charx),但文件本身需要能打开 ZIP 的工具——而所有工具都能。

运行智能体

Letta 的 .af 携带工具、工具规则、模型配置和消息历史。COF 只携带角色,并声明 executableContent: none。由什么来运行它,是宿主的事——这是有意为之。

定义骨骼绑定

VRM 定义骨骼和表情。COF 将 VRM 或 GLB 作为文件随附,连同其权利和贴图,并在其周围添加姿势、片段和声音。骨骼绑定仍归 VRM。

证明删除

MacPaw 的 .mem 会写入墓碑记录和审计日志,因此可以证明一段被遗忘的记忆已在各处被遗忘。COF 在导出时清除(cof extract),且不留任何痕迹——目前如此。

目前只有 COF 能做的事

预设

一个文件,多个即用组合:同一角色的 29 岁和 65 岁、工作版和全年龄版、法语版和日语版。其他格式每个版本都需要一个文件,各版本会逐渐走样。

有过去,有内心生活,还有缘由

带日期的记忆,包含人物、地点、事件和感受;由价值观、信念、欲望和恐惧构成的心理,每一项都关联到它所源自的记忆,并带有强度和时间跨度。智能体格式保存散文;记忆格式保存事件;两者都不保存二者之间的联系。

由验证器强制执行的规则

每个预设都声明年龄;涉及未成年人的裸露或亲密内容会使文件无效,而不只是被打上标签。真人需要同意记录。可执行文件、pickle 和不安全路径一律拒绝。无需任何人信赖作者的善意。

从宿主回写

角色在 OpenClaw、Hermes 或某次聊天中的经历,会作为新的个人记忆回到同一个文件(cof memory add)——并随用户一同离开。一个角色,两个家,一份记忆。

兼容,而非取代

这张表的重点不在于 COF 打了最多的勾,而在于 COF 不要求任何人放弃任何东西:一个 .cof 包含一张有效的 Character Card V3,可导出 ccv3 PNG、卡片 JSON、SOUL.md / IDENTITY.md 以及完整的智能体工作区,并将 VRM 作为普通文件保存。其他各列的格式既是它的输入,也是它的输出。凡是 COF 没有对应物的地方——骨骼绑定、运行时、带签名的删除——正确的做法是随附另一种格式,表中以 → 标示。

灰色行是带日期的承诺,而非现有功能。它们来自公开的路线图;修改格式的 RFC 在发布前开放征求意见。

来源