L3 技术视角

理解原理

架构 · Tools · Subagent · MCP · 记忆 · 权限

13 个主题

Agent 架构

QueryEngine

调度层
submitMessage()

query()

循环层
while(true)

Task

任务层
长期并发

AsyncGenerator 作为 API 契约，CLI 和 SDK 共用同一逻辑

📖 01-Agent架构.md

内置 Tools 系统

三层加载

getAllBaseTools() 注册
getTools() 过滤
assembleToolPool() 合并

关键设计

isDeferred 延迟加载
Tool 接口 40+ 字段

📖 02-Tools系统.md

Subagent 机制

两种创建

进程外 — tmux/Mailbox
进程内 — spawnInProcess

递归防护

depth 无硬限制
Budget 是真正屏障

📖 03-Subagent机制.md

Harness 工程分类

src/ 目录全景

query/ 运行时核心
tools/ 工具实现
cli/ CLI 基础设施
services/mcp/ MCP 扩展
memdir/ 记忆与上下文

📖 04-Harness目录.md

记忆系统

CLAUDE.md

5级加载体系

AutoMemory

两步写入可审计

AutoCompact

167K 触发

📖 05-记忆系统.md

MCP 扩展机制

适配器模式

MCPTool 将 MCP 工具适配为统一 Tool 接口
isMcp = true 始终延迟加载

Computer Use 分析

揭示 Anthropic 独占商业策略

📖 06-MCP扩展.md

多模型支持

四种 Provider

firstParty Anthropic
bedrock AWS
vertex Google
foundry Azure

能力覆盖

getAPIProvider()
独占功能通过 !== 'firstParty' 检查

📖 07-多模型支持.md

权限系统

三元决策链路

PermissionMode 总开关
alwaysAllowRules 白名单
checkPermissions() 自定义策略

deny > ask > allow

📖 08-权限系统.md

省 Token 设计

AutoCompact

167K tokens 提前触发
压缩 = 选择性保留 + 摘要

选择性保留

最近 5 文件（各 5K）
Skills（25K 总预算）

📖 09-省Token.md

提示词预处理

预处理管道

processUserInput() — slash 解析
processUserInputBase() — 消息构建
fetchSystemPromptParts() — system prompt

📖 10-提示词预处理.md

KAIROS 通俗解释

让 Claude 变成"永不掉线的 AI 助手"

"做梦"机制：每晚整合分散日志

四阶段

Orient → Gather → Consolidate → Prune

📖 11-KAIROS.md

内部员工特权 ANT

USER_TYPE === 'ant'

构建时常量（--define 注入）
外部构建中 ANT 分支被消除

ANT 专属工具

ConfigTool 修改 settings.json
TungstenTool 内部工作流
REPLTool REPL 交互

📖 12-ANT特权.md

AI Agent 面试指南

8 大核心主题

while(true) + 状态替换 vs 函数递归
isDeferred 延迟加载
allow/deny/ask 三元拦截
选择性保留压缩
Provider 多模型抽象

三层次：知道是什么 → 为什么 → 替代方案代价

📖 13-面试指南.md

L3 总结

已理解核心原理

✅ Agent 架构
✅ Tools 系统
✅ Subagent / MCP
✅ 记忆 / 权限

继续学习 L4