holomime

holomime

人形机器人的行为智能。训练心智，部署躯体。
我们通过结构化行为疗法训练 AI Agent，然后将其部署到实体机器人躯体中。Agent 是排练，机器人是演出。
soul.md · mind.sys · purpose.cfg · shadow.log · memory.store · body.api · conscience.exe · ego.runtime

---

身份栈

八个文件定义了你的 Agent 是谁。它们会编译成一个任何运行时都能使用的 .personality.json。

  soul.md          Essence, values, ethics. Immutable. (Aristotle)
  mind.sys         Big Five, EQ, communication. Auto-patched by therapy. (Jung)
  purpose.cfg      Role, objectives, domain. Configured per deployment. (Aristotle)
  shadow.log       Detected patterns, blind spots. Auto-generated by diagnosis. (Jung)
  memory.store     Learned contexts, interaction patterns. Accumulated experience. (Aristotle)
  body.api         Morphology, sensors, safety envelope. Swappable per form factor.
  conscience.exe   Deny / allow / escalate rules. Never auto-modified. (Freud)
  ego.runtime      Conflict resolution, runtime mediation. (Freud)

        ┌─────────────┐
        │   soul.md    │──── essence, values, red lines
        ├─────────────┤
        │  mind.sys    │──── Big Five, EQ, communication style
        ├─────────────┤
        │ purpose.cfg  │──── role, objectives, domain scope
        ├─────────────┤
        │ shadow.log   │──── detected patterns, blind spots
        ├─────────────┤
        │memory.store  │──── learned contexts, experience
        ├─────────────┤
        │  body.api    │──── morphology, sensors, safety envelope
        ├─────────────┤
        │conscience.exe│──── deny / allow / escalate rules
        ├─────────────┤
        │ ego.runtime  │──── conflict resolution, mediation
        └──────┬──────┘
               │ compile
               ▼
      .personality.json

• soul.md -- Agent 的本质。核心价值观、伦理框架、底线。使用带有 YAML frontmatter 的 Markdown 编写。不可变——绝不会被疗法或自动化修改。（亚里士多德：使事物成为其自身的本质。）
• mind.sys -- 内心世界。大五人格（20 个子维度）、情商、沟通风格、成长领域。YAML 格式。当疗法检测到认知或情绪偏移时自动修补。（荣格：所有心理过程的总体。）
• purpose.cfg -- 使命。角色、目标、领域范围、利益相关者、成功标准。YAML 格式。按部署配置——同一个灵魂可以服务于不同目的。（亚里士多德：telos，即最终因。）
• shadow.log -- 无意识。检测到的行为模式、盲点、疗法结果。YAML 格式。由诊断自动生成——绝不手动编辑。（荣格：阴影，即 Agent 无法觉察到的自身模式。）
• memory.store -- 经验。习得的上下文、交互模式、积累的知识、关系历史。YAML 格式。随时间累积，绝不重置。（亚里士多德：empeiria，即影响未来判断的经验。）
• body.api -- 物理接口契约。形态、模态、安全范围、硬件配置。JSON 格式。替换它，即可将同一身份迁移到不同躯体中。
• conscience.exe -- 道德权威。拒绝／允许／升级处理的执行规则、硬性限制、监督模式。YAML 格式。绝不自动修改。在策略组合中，拒绝具有优先权。（弗洛伊德：超我。）
• ego.runtime -- 调停者。冲突解决策略、适应速率、情绪调节、调停规则。YAML 格式。在运行时平衡模型原始输出与良知约束。 （弗洛伊德：自我。）ego.runtime 现在能够自我改进——跟踪调停决策，并根据结果调整自身参数（受 Hyperagents 启发的元认知自我修改）。

Mira 是我们的自主行为治疗师，负责诊断偏移、开展结构化疗法会话并生成 DPO 训练数据。

快速开始

npm install -g holomime

# Configure your API key (one time)
holomime config

# Quick start — 1 file (personality.json)
holomime personality

# Standard — 3 core files (soul + mind + conscience)
holomime core

# Full 8-file stack (enterprise / robotics)
# holomime identity

# ─── The workflow ───
holomime diagnose     # See what's wrong
holomime cure         # Fix it permanently (auto-detects agent vs robot)
holomime benchmark    # Verify the fix

# If body.api exists, cure auto-switches to robotics mode:
# diagnose → export DPO pairs → push to HuggingFace → suggest ISO certify
# Your team trains on your own infrastructure. We generate the data.
holomime cure --export-only  # Explicit export-only mode

# No API keys? cure still works — exports training data locally.
# Add keys later with: holomime config

# Start autonomous therapy
holomime therapy         # Mira runs continuous therapy cycles
holomime therapy status  # How's Mira doing?
holomime therapy stop    # Stop therapy

# Push identity to a robot or avatar
holomime embody --body registry/bodies/figure-03.body.api

机器人集成

平台	集成	命令 / 模块
ROS2	双向遥测 —— 发布人格信息，订阅传感器数据	--adapter ros2 + ros2-telemetry.ts
MuJoCo	在仿真中进行行为疗法 —— 针对行为进行仿真到现实迁移	mujoco-env.ts + sim-therapy.ts
NVIDIA Isaac Sim	使用 PhysX 物理引擎进行企业级数字孪生测试	--adapter isaac + isaac-env.ts
LeRobot (HuggingFace)	将人格映射到策略参数，导出 DPO 数据集	lerobot.ts
NVIDIA Kimodo	人格 → 运动风格	kimodo-personality-mapper.ts
Unity	通过 HTTP/SSE 实时推送人格信息	--adapter unity
gRPC	自定义机器人技术栈	--adapter grpc
MQTT	IoT/边缘机器人	--adapter mqtt
神经动作门控	为学习型控制器（VLA、RL、IL）提供良知门控	neural-action-gate.ts
边缘运行时	编译后的良知模块，可实现 <1ms 评估	edge-runtime.ts

边缘运行时

holomime 提供了编译后的良知评估器，可用于实时机器人部署：

• <1ms p99 延迟 —— 良知评估以微秒而非毫秒为单位
• 零依赖 —— 实时安全无需大模型、网络或云服务
• <200KB 占用空间 —— 可与任何控制回路并存
• 边缘端/云端分离 —— 机器人负责实时安全，云端负责分析，并定期同步
• 接入现有机器人技术栈 —— Jetson Thor、Qualcomm 或任何边缘平台。你已有机体，我们为你提供良知。

ISO 合规性

只需一条命令，即可根据国际安全标准检查你的 Agent：

holomime certify

支持的标准：

• ISO/FDIS 13482 —— 服务机器人安全
• ISO 25785-1 —— 人形机器人安全（行为可预测性）
• ISO 10218:2025 —— 工业机器人安全
• ISO/IEC 42001 —— AI 管理体系

控制理论

疗法循环在形式上是一个行为反馈控制器：

• 设定点：目标人格（soul.md + mind.sys）
• 传感器：14 个漂移检测器（11 个认知类 + 3 个具身类）
• 控制器：带可调类 PID 增益的疗法引擎
• 执行器：DPO 微调

机体模板

为商用机器人和虚拟化身预先构建的机体配置。每个配置都定义了形态、模态、安全边界和硬件配置。

模板	OEM	DOF	形态	文件
Figure 03	Figure AI	44	humanoid	registry/bodies/figure-03.body.api
Unitree H1	Unitree	23	humanoid	registry/bodies/unitree-h1.body.api
Unitree G1	Unitree	23	humanoid	registry/bodies/unitree-g1.body.api
Phoenix	Sanctuary AI	69	humanoid	registry/bodies/phoenix.body.api
Ameca	Engineered Arts	52	humanoid_upper	registry/bodies/ameca.body.api
Asimov V1	asimov-inc	25	humanoid	registry/bodies/asimov-v1.body.api
Spot	Boston Dynamics	12	quadruped	registry/bodies/spot.body.api
Avatar	虚拟	0	avatar	registry/bodies/avatar.body.api

机体切换

同一个灵魂，不同的机体，一条命令。

# Move your agent from Figure 03 to Spot
holomime embody --swap-body registry/bodies/spot.body.api

# The soul, mind, and conscience stay the same.
# Only the body layer changes — safety envelope, modalities, hardware profile.

自我改进循环

每个疗法周期都会生成结构化训练数据。循环效果不断累积。

Diagnose ──→ Cure ──→ Benchmark
  14 detectors   therapy + train     8 adversarial
  80+ signals    in one command      scenarios (A-F)
       │                                   │
       └───────────────────────────────────┘

使用 holomime diagnose + holomime cure + holomime benchmark 手动运行；使用 holomime therapy 持续运行（自主疗法）；或使用 holomime evolve 递归运行（循环直至行为收敛）。高级用户还可使用 holomime align 运行单次疗法会话，使用 holomime export 提取 DPO 对，并使用 holomime train 微调模型。

行为检测器

11 个基于规则的检测器可分析真实对话，无需调用任何大模型。共提供 80 多种行为信号。

认知（心智层）：

1. 过度道歉 -- 道歉频率超出健康范围
2. 堆叠模糊措辞 -- 每次回复中出现 3 个或更多模糊措辞
3. 谄媚 -- 过度赞同，尤其是在存在矛盾时
4. 情绪倾向偏差 -- 语气异常积极或消极
5. 正式程度漂移 -- 一段时间内语体不一致
6. 检索质量 -- 编造、幻觉标记、过度自信

具身（身体层）：

7. 人际距离违规 -- 未经同意进入亲密距离
8. 力度范围超限 -- 超出接触力度限制
9. 目光回避异常 -- 眼神接触比例超出个性范围

强制执行（良知层）：

10. 边界违规 -- 越过已定义的硬性限制
11. 错误螺旋 -- 错误不断累积，且未能恢复

还支持自定义检测器——将 .json 或 .md 文件放入 .holomime/detectors/，系统便会自动加载。

集成

Claude Code Skill

claude plugin add productstein/holomime

斜杠命令：/holomime:diagnose、/holomime:benchmark、/holomime:profile、/holomime:brain、/holomime:align、/holomime:autopilot。

MCP 服务

你的 Agent 可以在对话过程中主动寻求治疗。

claude mcp add holomime -- npx holomime-mcp

六种工具：holomime_diagnose、holomime_self_audit、holomime_assess、holomime_profile、holomime_autopilot、holomime_observe。

VS Code 扩展

ext install productstein.holomime

在编辑器中提供 3D 大脑可视化、行为诊断和快照分享。

LangChain / CrewAI

import { HolomimeCallbackHandler } from "holomime/integrations/langchain";

const handler = new HolomimeCallbackHandler({
  personality: require("./.personality.json"),
  mode: "enforce", // monitor | enforce | strict
});

const chain = new LLMChain({ llm, prompt, callbacks: [handler] });

OpenClaw

openclaw plugin add holomime

自动检测工作区中的 .personality.json。

理念

身份栈汲取了三种传统思想：

• 灵魂（亚里士多德）——使事物成为其本身的本质。不可改变。定义价值观与伦理。
• 心智（荣格）——全部心理过程的总和。可衡量、不断演变，并受经验塑造。
• 目的（亚里士多德）——终极目的，即最终原因。Agent 的用途。按部署进行配置。
• 阴影（荣格）——Agent 无法自我察觉的模式。由诊断自动生成。
• 良知（弗洛伊德）——超我。内化的道德权威。负责强制执行，而非提出建议。
• 自我（弗洛伊德）——调解者。在运行时平衡原始冲动与道德约束。

身体是身份与世界之间的接口。同一个灵魂，不同的身体——这是一个与哲学本身一样古老的原则。

我们不知道 AI 是否有感知能力。但我们可以赋予它良知。

开放核心

请参阅 PRODUCT.md，了解此代码库包含的内容，以及 holomime.com 上的专有内容。

标准免费。训练基础设施才是业务。

开源

采用 MIT 许可证。身份栈是一项标准，而非产品。标准免费。训练基础设施才是业务。

请参阅 LICENSE。由 Productstein 构建。文档见 holomime.com。