Part I: 什么是 Agent Harness

建立心智模型：LLM 不等于 Agent，Harness 是让 LLM 变成 Agent 的那层壳。

这个 Part 要解决什么问题

在深入任何一个子系统之前，你需要一张地图。

LLM 能写诗、能推导公式、能生成排序算法——但它不能读你的文件，不能执行命令，不能记住上一轮对话，更不知道什么操作不该做。这些缺陷不是 bug，而是设计边界。要让 LLM 变成有用的 Agent，必须有一层系统来补全这些缺陷。这层系统就是 Harness。

Part I 的任务是建立这个核心心智模型：Agent = LLM + Harness，然后带你鸟瞰一个生产级 Harness 的完整架构——六层模型、数据流向、模块划分。这两章不涉及任何子系统的深入分析，但它们提供的全局视角是理解后续所有章节的基础。

包含章节

Chapter 1: 从 LLM 到 Agent -- Harness 的角色。 LLM 有四个致命缺陷（没有手、没有眼、没有记忆、没有缰绳），Harness 如何逐一补全？工具系统、上下文注入、对话管理和权限守卫分别扮演什么角色？这一章用最直觉的方式建立 Harness 的概念框架。

Chapter 2: 系统全景 -- 一个 Agent 的解剖图。 面对一个拥有 40 多个目录和数百个源文件的代码库，怎么不迷路？六层架构模型（入口层、引擎层、工具层、状态层、服务层、表现层）如何分工？一条消息从用户输入到最终回复经历了怎样的九阶段旅程？

与其他 Part 的关系

• 前置知识：无。这是全书的起点。
• 后续延伸：Part I 建立的心智模型和架构全景，是 Part II（Agent Loop）、Part III（工具系统）和 Part IV（安全与权限）的共同基础。Chapter 2 中描述的「一条消息的旅程」将在 Part II 中被逐步展开为完整的工程实现。