人格格式 directwire/culmen

人格状态格式 · 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 — 存在 ✓ 插槽聊天 — 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）+ 手机端“导出人格包”