这本书怎样教你
每一部分都从一个读者会问的问题开始。 你会先运行或观察一个具体结果，再认识它对应的术语， 最后进入代码和测试。页面会明确写出：这是通用 Agent 概念、BearAgent 已实现行为、已接受设计， 还是未来计划。
BearAgent 是一个 local-first 的个人 Agent Runtime。Runtime 是模型之外那层真正负责执行的软件：它把 目标交给模型，把模型提出的 Tool 请求变成受限动作，并把发生过的事实保存下来。
目前最适合学习的场景很小：Agent 在指定 workspace 中查找、读取和比较资料，只把完整结果写进
outputs/**。小场景让我们能把模型调用、文件边界、预算、持久化和失败路径逐一看清。
六步，从会用走到会研究
Section titled “六步，从会用走到会研究”- 先亲手跑一次初始化配置，运行一个小任务，再亲自核对文件和记录。
- 看懂 Agent 运行分清 Model、Context、Tool、Runtime、Run、Activity 和 Event。
- 理解安全边界看模型输出为什么不可信，路径、Policy 和原子写入怎样兜底。
- 拼出系统架构把 domain、runtime、application、port、adapter 和 interface 连起来。
- 沿代码继续学习按一条真实执行链读源码，用单元、契约、集成和安全测试验证理解。
- 走向研究与扩展从一次失败提出假设，再比较诊断、干预和恢复策略。
你现在可以直接选择入口
Section titled “你现在可以直接选择入口”我第一次接触 Agent先用一个文件任务分清 Model、Tool 和 Runtime，不要求框架经验。
我想先把项目跑起来从源码安装、准备配置、运行命令，并处理最常见的失败。
我想开始读源码先看目录分工，再沿 interface → application → runtime → port/adapter 阅读。
我想做 Agent 研究从长任务、Context、评测、恢复、权限和隔离找到可研究的问题。
我只想确认当前能力查看已经实现、可以复现的证据，以及明确还不能做的事情。
怎样判断页面在讲什么
Section titled “怎样判断页面在讲什么”每页都带有内容状态：
| 状态 | 含义 |
|---|---|
implemented |
当前代码和测试已经支持，可以按页面给出的入口复现 |
design |
已接受的 BearAgent 设计，但不等于全部实现 |
planned |
Roadmap 中的方向，还不能当作现有能力 |
concept |
通用 Agent 知识，不用于证明 BearAgent 行为 |
mixed |
一页同时讲当前与未来，正文必须逐段说明边界 |
工程事实仍以仓库 docs/、代码和测试为准。学习站负责把这些事实组织成一本能连续读下去的书，
不会复制一套新的项目状态。