亲手造一个,把模型变成 Agent 的引擎
约 920 字大约 3 分钟...
亲手造一个,把模型变成 Agent 的引擎
面向有 Agent 基础的工程师,目标是达到 harness 开发水平。
不只讲原理,更带你从零构建一个能跑真实编码任务的 harness。四主线并行:概念 · 一条真实任务串联 · 五个开源实现源码精读 · 完整实战建造。
本课概况:4 条并行主线、13 个章节、5 个案例深剖、9 个动手里程碑。
四条主线并行
不是四套割裂的内容,而是贯穿每一章的四个视角。你会同时从原理、真实任务、真实源码、亲手实现四个角度理解每个部件。
- 主线 1 · 概念:每个部件的原理与设计问题——它解决什么、有哪些绕不开的难题。
- 主线 2 · 任务串联:用一条真实任务(给 parseDate 加时区单测)端到端串起整个 harness 处理流程。
- 主线 3 · 源码精读:逐个拆解五个真实 harness 的核心实现——架构、模块职责、数据流。
- 主线 4 · 动手建造:9 个里程碑,从零造出功能完整、可运行的 tinyharness。
六部,十三章
课程结构,共 34 页。
01 · 基础
02–07 · 核心机制(六章)
08–10 · 生产级实现
11–13 · 高级
收尾 · 总装与提炼
五个真实开源 harness
案例深剖,属于主线 4 专区。核心章按主题横切,案例专区按 harness 纵切——每个 harness 端到端讲清架构、请求流程、核心模块。全部 2026-09 一手核实。
| 案例 | 定位 | 核心看点 | 许可 |
|---|---|---|---|
| Claude Code | CLI 标杆 · 生成器循环 | query 循环、42 工具、compact 子系统、hook 权限、swarm 多 agent | 泄露源码,仅作架构学习 |
| OpenHands | 自主平台 · 事件驱动 | EventStream + Runtime 抽象,可回放/接管/分布 | MIT |
| Codex CLI | 双层安全标杆 | sandbox × approval 二维正交,Seatbelt 沙箱 | Apache-2.0 · Rust |
| deepseek-harness | 一切皆插件 · 中文生态 | 无特权核心,连循环都是可换插件;中立核心 + DeepSeek 适配 | MIT · preview |
| multica | 编排层 · harness 之上 | 编排 26 个异构 CLI,execenv 隔离 + issue/review 协调 | source-available（Multica License）· Go |
对照点(相关章节带过):Aider(git 兜底)· Gemini CLI(Policy Engine)· SWE-agent/mini(复杂度辩论)。
调研与核实时间:2026-09 · 各案例状态、源码路径以核实日为准 · 一手来源见附录 A
合规声明:Claude Code 源码来自 source map 泄露、无授权许可,仅作架构学习,不可分发或商业复刻。OpenHands/Codex/deepseek-harness 为标准开源(MIT/Apache-2.0);multica 为 source-available(Multica License,含商用/托管附加限制)。详见附录 C。