架构

Agent 保存会话状态、Tool pool、MCP 连接与 hook；QueryEngine 为每次请求执行 Agent loop；Provider 把统一消息转换为模型 API；ToolExecutor 校验并执行模型请求的能力。

关键内部组件

组件	说明
Provider 层	屏蔽 Anthropic / OpenAI API 差异
QueryEngine	核心 Agent loop，内置自动压缩、重试与 Tool 编排
Skill 系统	可复用的提示词模板，从文件系统加载或程序化注册
Hook 系统	集成进 engine 的 24 个生命周期事件
Auto-compact	上下文窗口填满时总结对话
Micro-compact	截断超大 Tool result
重试	针对限流与瞬时错误的指数退避
Token 估算	粗略 token 计数，附带 Claude、GPT、DeepSeek 模型的定价
文件缓存	文件读取的 LRU 缓存（100 条，25 MB）
Session 存储	在磁盘上持久化 / 恢复 / 分叉 Session
上下文注入	Git 状态与 AGENTS.md 自动注入系统提示词

这个分层使 Runtime 可以复用 SDK 的 Agent loop，同时把 HTTP、认证和断连语义留在服务层。自定义集成应优先扩展 Provider、Tool 与 hook，而不是复制 QueryEngine。逐组件的 API 见 API Reference。