Nexus 解构
系统拆解腾讯 Nexus Agent 框架。上篇是实践者指南——十分钟跑通任务、接入新 benchmark、产出训练数据；下篇深入架构原理——注册系统、Runtime 沙箱注入、Tracing 体系。基于 v1.1.3 源码，1047 个文件逐层解剖。
双轨阅读
上篇面向"赶时间"的实践者——快速跑通任务、接 benchmark、产数据；下篇面向想搞明白的架构研究者
源码级解剖
基于 v1.1.3 完整源码——1047 个文件、16 种 Agent、28 个 Task、34 个 Tool，逐层拆解
研究场景导向
Nexus 专为 RL 训练、SFT 数据生成、评测设计——本书重点讲清楚这些场景的最佳实践
目录
第一部分：快速上手
Nexus 是什么
一句话定位、核心概念五件套、与同类框架的差异、执行流全景图
十分钟跑通第一个任务
从零开始：安装 Nexus、理解 YAML 配置、选择 Runtime、跑通 echo 示例任务
接入新的 Benchmark
Task 的完整生命周期、以 SWE-bench 和 WebArena 为例走一遍、批量执行、数据集管理
使用和切换 Agent
16 种内置 Agent 全景图、Agent 配置详解、同一 Task 切换不同 Agent 的方法
产出训练数据
HyTuner RL 集成、从评测轨迹到 SFT/DPO 数据、Trace 体系、Cache 体系、Reward 工具
模块管理与扩展开发
nexus modules CLI、TUI、写自定义 Task/Agent/Tool 的完整流程、pyproject.toml 元数据规范
第二部分：架构原理
注册系统：一切的基石
Registry 泛型设计、装饰器 vs 懒加载、元数据驱动的零导入发现、Processor 管道、自动依赖安装
ExecutionContext：依赖注入的核心
ContextVar 传播、async with 生命周期、多 Runtime 懒加载、Worker Venv 自动创建、MCP 动态加载
Task/Agent/Tool 协议与 Agent 范式对比
三层协议设计、ToolExecutor 机制、MCP 集成、以及 16 种 Agent 的架构范式深度对比
Runtime 系统：沙箱的一切
三层抽象、Provider 家族、Runtime 家族、invoke 统一 RPC、Executor 体系、Client/Server 分离
Runtime Injection：Nix 自包含的秘密
为什么需要自包含服务、Nix 构建方案、与 OpenHands/SWE-ReX 的对比、Checkpoint 加速
Runtime Server 深度解剖
FastAPI + Socket.IO 双通道、invoke 端点、Blob sideband、Worker Venv、LLM Proxy、RPCReplayGuard
Runner 与批量执行
Single Runner 7 步编排、run_agent 工厂、Batch Runner 的 SQLite 后端、并发控制、Resume/Retry
Tracing 与可观测性
自研 Span 体系、@observe 装饰器、SpanController、Processor 插件、远程 Trace 传播、Phase 系统
上下文管理与 Compaction
为什么需要 Compaction、三层架构、内置策略、训练一致性、自定义策略开发
LLM Client 体系
OpenAICompatibleClient 抽象、8 种内置 Client、Cache 与确定性重放、ExtendedChatCompletion
main_agent 源码精读
通用 tool-calling 循环的完整实现、迭代控制、并行工具调用、Compaction 集成、Span 指标
Installed Agent 模式
在沙箱内运行第三方 Agent、LLM Proxy 转发机制、四种 Installed Agent 的实现对比
第三部分：完整案例
完整 Case Study：从工具定义到 Agent 执行的端到端流程
用一个具体的「智能代码审查」场景，走完 Tool 定义、MCP 接入、Agent 配置、Task 编排、LLM 消息流的完整生命周期
Case Walkthrough：water_emergency 端到端全记录
用生产环境的真实 Task（water_emergency）完整走一遍 Nexus 框架：从 YAML 配置、Mock 数据注入、wide-agent 推理轨迹，到 rubric 验证与 RL 训练数据导出