概念

把 Holon 理解为一个运行时（runtime），而不是一个聊天外壳，是最容易的入门方式。 这个运行时围绕四个简单对象构建，它们相互配合：

四个对象的心智模型

Agent（代理） 是行动者。每个 Agent 有持久的 home 目录、自己的指导文件 （AGENTS.md）、本地记忆和工作队列。你通过 ID 寻址一个 Agent，它跨轮次存在—— 可以休眠、唤醒、继续工作而不丢失状态。

Work item（工作项） 是目标。它记录 Agent 想要达成什么，带有持久计划、 todo 清单和完成目标。工作项跨轮次、跨模型调用存活，所以 Agent 几小时或几天后 恢复也不会丢失进度。

Task（任务） 是执行。每条命令、每次子 Agent 委托、每个后台操作都包装在 任务句柄里。你可以检查任务状态、读取输出、发送输入或停止任务——运行时全程跟踪。

Trust boundary（信任边界） 是来源。操作者输入、外部 webhook、子 Agent 输出、 网页来源内容，各自携带来源（origin）和信任级别。Holon 从不把它们压平成一条 无差别的提示流。

Agent（谁）
  └── Work items（在做什么）
        └── Tasks（怎么做）
              └── Trust classification（输入来自哪里）

为什么这很重要

大多数 Agent 工具像聊天会话：提示进去，回答出来，状态消失。Holon 不一样：

• 你可以离开，Agent 继续工作。
• 你不用读完整个对话记录就能检查 Agent 正在做什么。
• 你能看到每个输入来自哪里、可信度多高。
• 你可以把工作委托给子 Agent 并监督它们的进度。

本节的边界与受众

概念部分面向使用和集成 Holon 的用户，阐述稳定、可观察的心智模型与核心语义。 即使底层存储或调度实现重写，这些概念依然成立。

• 具体的逐步操作指南，请查阅 指南。
• 精确的 CLI 选项、配置键与 HTTP 接口定义，请查阅 参考。
• 调度器内部状态机与维护者契约，请参阅 运行时规格。