主控制器是 Agent 的"大脑"——它决定何时思考、何时行动、何时停止。理解主控制器的设计，就理解了 Agent 的运作范式。
核心循环（Core Loop）
主控制器的本质是一个状态机：
接收输入 → 理解意图 → 选择工具 → 执行调用 → 处理结果 → 判断是否结束 → 输出/继续
这个循环的关键设计点：
1. 意图识别
不是简单的关键词匹配，而是结合上下文、历史、用户状态的综合判断。同一个"搜索一下"，在项目初期是搜技术方案，在部署阶段是搜报错日志。
2. 工具路由
主控制器维护一个工具注册表（Tool Registry），包含：
- 工具名 + 描述（供 LLM 选择）
- 参数 schema（JSON Schema）
- 权限等级（只读 / 可写 / 危险）
- 超时策略
路由逻辑：LLM 输出 tool_call → 控制器校验权限 → 注入上下文 → 执行 → 截断超长输出 → 返回结果。
3. 终止条件
这是最容易被忽略的环节。Agent 必须知道"够了"：
- 显式终止：用户说"停"或任务完成标记
- 隐式终止：连续 3 次工具调用返回相同/空结果
- 预算终止：token 消耗超过阈值，强制总结当前进展
生命周期管理
会话级生命周期
创建 → 活跃 → 空闲 → 重置 → 销毁
- 创建：加载用户上下文、历史摘要、可用工具列表
- 活跃：正常处理请求，维护对话历史
- 空闲：N 分钟无请求后，压缩历史为摘要
- 重置：用户显式
/new，清空当前会话但保留记忆 - 销毁：服务重启或长时间无活动
任务级生命周期
一个复杂任务可能跨多轮：
规划 → 执行 → 验证 → 回溯（失败时）→ 完成
关键：每一步都要记录中间状态，以便在上下文被压缩或会话重置后恢复。
状态压缩策略
当对话历史逼近上下文窗口上限时，主控制器必须压缩：
- 摘要压缩：将前 N 轮对话压缩为一段结构化摘要
- 关键信息提取：保留工具调用结果、用户决策、错误日志
- 丢弃冗余：去掉重复的确认、寒暄、中间调试输出
主控制器的质量，决定了 Agent 是"智能助手"还是"高级搜索框"。