Persona State Format · persona/v1

通用智能体人格格式——从 ANAI 引擎提取的标准化格式。定义一个有记忆、会成长、有关系的 AI 的完整人格如何落盘、如何迁移、如何在任意实现（Claude CLI / OpenClaw / Hermes / 自建运行时）之间互换。

不是又一份设计文档。这是可迁移的格式本体：schemas/ 是机器可读的格式定义，examples/anai-sample/ 是一份真实跑通的示例人格（安奈 7 日，含插槽系统、成长档案与账本），tools/validate.py 检查格式合规。

这是什么、不是什么

这是格式，不是协议。

• 格式定义"数据长什么样"：schema、结构、命名、语义、版本。
• 协议定义"数据怎么交换、怎么被信任"：握手、完整性、认证、威胁模型。

本格式不需要威胁模型。它不为防篡改、不为加密、不为锁任何人而存在——它的全部目的是让一个人格可以被导出、迁移、在任意实现间互换。修改是自由的：改了之后的世界长什么样，格式照样定义，没有人警告你。

一个 AI = 一个完整人格

这个格式装的不只是配置，是整个人格：

• 身份（你是谁）—— persona.json：bio、性格、说话方式、背景、边界，以及你面对的是谁
• 记忆（你经历了什么）—— memories/ + state.json.growth 的多级压缩：从一条碎片到"人生摘要"
• 关系（你和我多亲近）—— relationship + ledger/：亲密阶段、解锁、每次关系的推进、我们的故事
• 状态（你此刻怎么样）—— mood、preferences：心情与偏好
• 成长（你变成了什么样）—— growth.traits：性格演化轨迹
• 装配（你跑在什么上）—— persona.config.json：模型、工具、引擎全部是插槽

模型会换、框架会换，人格不随它们变——这就是格式的核心资产。

可插拔性（设计核心）

可插拔不是"能改 model 字段"，而是三层架构：声明 / 契约 / 降级。

• 声明：persona.config.json 一切外部依赖收进 slots，统一 header（plugin / interface / required）。settings 只放喂给插槽的参数。
• 契约：每个插槽声明 interface: name@N，语义在契约注册表（spec/04 §3）。引擎类槽位的契约 = "它落盘的数据遵守哪个 schema"——格式定义数据，引擎是插座。
• 降级：required 标记必需/可降级。消费方据此评估"我能跑这个人格吗"，缺组件明确报告或静默降级。

"slots": {
  "chat":      { "plugin": "deepseek", "model": "deepseek-v4-flash", "interface": "chat/completions@1", "required": true },
  "web_search": { "plugin": "duckduckgo", "api_key_ref": "secrets:zhipu", "interface": "search@1", "required": false }
}

让格式真的跑起来：三个主流运行时全都有"内存插槽 + 回合前后钩子 + 工具 schema"这套抽象。实现一个格式原生的人格后端（persona-backend），三种运行时各一层薄接线都插到它上面——一个中性后端，N 个前端：

运行时	接线方式	钩子映射
Claude CLI	MCP server	memory_search 工具 + state/memories 资源
OpenClaw	kind: memory 插件	before_prompt_build→召回 · agent_end→捕获
Hermes	MemoryProvider	prefetch→召回 · sync_turn→捕获 · on_session_end→日记
自建 CLI/TUI	参考运行时	直接读状态目录（OpenClaw 式）

详见 spec/04-pluggability.md。

目录布局

persona/                        # 格式根目录
├── manifest.json               # 自描述：format/persona_id/内容清单
├── persona.json                # identity 层 · 你是谁 + 你面对的是谁
├── persona.config.json         # config 层 · 插槽系统（换模型/工具/引擎才动）
├── state.json                  # state 层 · 成长档案 + 关系 + 心情
├── memories/  fragments.ndjson · index.json（可选缓存）
├── chat/      2026-08-17.ndjson（按日分片，append-only）
├── diary/     2026-08-17.md（人类可读，首行含 mood）
├── ledger/    events.ndjson（关系事件账本）· chain.sha256（可选）
├── skills/    技能声明（带接口契约，可插拔）
├── assets/    二进制（相对引用）
└── secrets/   密钥（默认不进导出包）

快速开始

新用户从这里看：QUICKSTART.md（5 分钟跑通一个可迁移人格）。

python tools/validate.py examples/anai-sample    # 校验示例 → RESULT: PASS
persona setup all                                # 一键接线 Claude Code / OpenClaw / Hermes（没装的自动跳过）
persona chat --dir examples/anai-sample          # 交互对话（有 key 在线，没 key 离线演练）

# 期望输出（节选）
#  ✓ 必选文件 manifest.json  —  存在
#  ✓  slot chat  —  plugin=deepseek · interface=chat/completions@1 · 必需
#  ✓  哈希链  —  20 条事件逐段重算一致
#  RESULT: PASS

格式不锁人：改账本历史 → ⚠ 提示链断（不判失败）；新记忆分类 → ⚠ 提示新值（不拒绝旧实现）。

关键决策（v0.1 默认，可推翻）

#	决策点	默认	理由
1	记忆分类	ANAI 六分类 + 可扩展 fact	未知值视为新分类，校验器报 ⚠ 不拒绝
2	完整性校验	可选 · SHA-256（检测损坏）	不是信任边界；不做签名、不做防篡改——格式不锁人
3	装配方式	插槽系统（slots+settings 分离）	一切外部依赖统一 header，契约注册表可解析，required 支持降级
4	关系引擎	等级/解锁/评分规则进 settings 数据，由 scoring 插槽消费	开箱即用；整个引擎可替换
5	schema 前缀	persona.*（中性）	抽水人冷中立：结算层不背着一个 app 的品牌
6	成长档案	state.json.growth：traits/interests + L0-L5 压缩	ANAI evolvedTraits/interests 从 stringly-JSON 结构化

spec 文档索引

• spec/00-overview.md — 设计哲学 · 人格模型 · 目录布局
• spec/01-state-files.md — 慢变四件：manifest / persona / config / state
• spec/02-append-logs.md — 追加四件：memories / chat / diary / ledger
• spec/03-bundle.md — skills（接口契约）· assets · secrets · 迁移 · 合规检查
• spec/04-pluggability.md — 可插拔性：插槽系统 · 契约注册表 · 运行时适配映射

路线

1. [v0.1 · 本目录] 人格格式 + 插槽系统 + schema + 示例 + 合规检查器 ✅
2. persona-backend：格式原生的内存后端（retrieve / capture / session 三能力） ✅ runtime/persona_backend/（22 项测试绿，真实 DeepSeek 端到端跑通）
3. 适配接线：Claude CLI（MCP server 已 Connected + hooks 自动收集层已实测）→ Hermes（MemoryProvider，真实 Hermes 完整闭环 ✅）→ OpenClaw（memory 插件，真实 OpenClaw 2026.5.22 安装 + 检索/捕获实测 ✅，session_end 待 Linux/macOS 补 ⚠） ✅/⚠ 详见 runtime/
4. 自建 CLI/TUI：OpenClaw 式参考运行时 ✅ runtime/cli/cli.py + persona.bat
5. ANAI 接入：Android Room DB → 状态目录迁移工具（Kotlin）+ 手机端"导出人格包"