# 📚 总目录 · 全部课程与文档检索台

> 工作区：`/Users/mikayiyanglin/Documents/Github claude-code/claude code源码分析`
> 最近扫描：2026-07-31（含 **Agent 工程模式目录** · **分级阅读路线** · **评测基准** · **后续项目推荐**）· 覆盖全部 Markdown 教程 / 分析 + 全部交互学习站 + 独立 HTML
> 用法：`Cmd/Ctrl + F` 搜关键词，或先看下面的「我想…」快速入口。
> 已排除 `node_modules` 与 `参考项目/` 里各上游仓库的自带海量文档。

---

## 🎯 我想……（按目的直达）

| 我想…… | 去这里 |
|---|---|
| **搞懂 Claude Code 到底怎么工作**（从按回车到 AI 动手） | [深入版主文档](#a1)（14 章 36 图）或 [学习站 v1/v2](#s-cc) |
| **自己从零造一个 AI 编程助手** | [编程助手构建教程](#b1) + [指南站 :7397](#s-agent) |
| **自己从零造一个通用任务 Agent（Manus 那种）** | [Manus 系构建教程](#b2)（跟一个真实任务走）+ [学习站 :7200](#s-manus) |
| **自己从零造一个 AI 同事（无人值守、接 Slack、动手前先问）** | [OpenWorker 系构建教程](#b3)（跟"发晨报"场景走） |
| **自己从零造一个 AI 设计 Agent（不写主循环，把别人的 CLI 当引擎）** 🆕 | [Open Design 系构建教程](#b4)（17 步 + 4 个实验台）或 [解析站](#s-od) |
| **自己从零造一个社媒内容工作台（不写主循环，把 OpenClaw 当引擎）** 🆕 | [Easel 系构建教程](#b6)（15 步）或 [解析站](#s-easel) |
| **在手机 / 另一台电脑打开学习站** 🆕 | [线上访问](./线上访问.md)（Cloudflare Pages，合入 main 即更新，仓库可私有） |
| **查某个内置工具怎么用**（43 件） | [工具盘点](#r1) / 深入版第八章 / [工具图鉴（站内）](#s-cc) |
| **查某个斜杠命令**（60+ 个） | [斜杠命令盘点](#r3) / 深入版第九章 |
| **看十八大 Agent 各自的绝活**（含吴恩达 OpenWorker、Open Design、小米 MiMo Code、盛大 MiroFish、**OpenAI 官方 Codex**、Cline、Kanban、CodexMonitor） | [项目分析合集](#c1) + [横向对比与总结评价](#c2) |
| **搞懂「人审批」和「OS 沙箱」怎么正交** 🆕 | [Codex 解析站](#s-cx) **LAB 01 真值表**（含一格反直觉的 Granular 结果） |
| **搞懂 AGENTS.md 为什么「写了模型不听」** 🆕 | [Codex 解析站](#s-cx) **LAB 02 预算模拟器**（32 KiB 整条链共享，深层目录会被饿死） |
| **在 Claude Code / OpenCode / Codex 之间选一个** 🆕 | [三方深度对比](#c3) |
| **搞懂「让一群 AI 替你把事情预演一遍」怎么做** 🆕 | [MiroFish 解析站](#s-mf)（群体智能引擎，24 428 行撑起 6.9 万星） |
| **搞懂社会学常识怎么变成产品参数** 🆕 | [MiroFish 解析站](#s-mf) LAB 03/04（中国作息曲线 + 双世界破圈阈值） |
| **搞懂 LLM 生成的结构化数据怎么归一化兜底** 🆕 | [MiroFish 解析站](#s-mf) **LAB 01**（含一个可复现的静默数据破坏缺陷） |
| **搞懂怎么防止 Agent「骗自己」** 🆕 | [MiMo Code 解析站](#s-mimo) LAB 01/02（Goal 裁判沙盘 + 四道死循环闸门） |
| **搞懂一个模型一份提示词怎么路由** 🆕 | [MiMo Code 解析站](#s-mimo) LAB 03（输入模型 ID 看 17 行 if 怎么判） |
| **搞懂一个 fork 到底改了上游什么** 🆕 | [MiMo Code 解析站](#s-mimo) **LAB 05 归属核对台**（15 条能力逐条判：首创 / 继承扩张 / 上游已有，附两边真实字节数） |
| **搞懂「审美质量」怎么被程序化执法** 🆕 | [Open Design 解析站](#s-od) LAB 03（可改 HTML 实时看 16 条规则） |
| **搞懂提示词怎么按缓存友好度排序** 🆕 | [Open Design 解析站](#s-od) LAB 02（拨条件看 21 层装配） |
| **搞懂 DeepSeek 前缀缓存怎么做成产品宪法** 🆕 | [DeepSeek-Reasonix 源码分析](#c1)（Compose turn tail · PrefixShape · `use_capability`） |
| **搞懂终身辅导怎么做成统一学习运行时** 🆕 | [DeepTutor 源码分析](#c1)（切换目标不换引擎 · L1/L2/L3 记忆 · Subagent 会诊编程 CLI） |
| **搞懂社媒 Agent 怎么真发还不把密钥发到公网** 🆕 | [Easel 解析站](#s-easel) **LAB 04**（content_guard：BLOCK exit 7 / WARN 只告警） |
| **搞懂画像为什么不能写成全局 USER.md** 🆕 | [Easel 解析站](#s-easel) **LAB 01**（消息内联前缀 vs 并发互踩） |
| **读梁文锋投资者交流会的观点与思维链路** 🆕 | [观点提炼 · 中文](#liang) / [English](#liang)（愿景 → 克制 → AGI 主线；贴近录音稿，不额外解读） |
| **读梁文锋技术阶梯对照 2026 年最前沿研究** 🆕 | [行业调研](#liang)（语言模型 → CoT → Agent → 持续学习 → 渐变自我迭代 → 具身；投行方法、全部出处可追溯） |
| **看 DeepSeek 现在在招什么、哪些技能出现最多** 🆕 | [招聘 JD 图谱](#ds-talent)（34 份完整 JD · 10 类赛道 · Chip 筛选） |
| **搞懂「一切皆插件」怎么做到连主循环都能换** 🆕 | [DeepSeek Harness 源码分析](#c1)（241 包名册 · 73 服务键 · seam 三角色 · 单调守卫 · 218 包依赖 invariants） |
| **想自己造一个插件化 harness（不写 main 循环）** 🆕 | [从零构建插件化 Agent Harness](#build)（20 步 · ~700 行 minidsh · 每步含验收断言） |
| **对比 OpenManus 和 Suna，选一个** | [OpenManus×Suna 对比](#m3) + [决策站 :7200](#s-manus) |
| **一次看懂七个项目的架构差异** 🆕 | [**架构图库**](#s-gal)：7 项目 9 张图，每张先写「回答什么问题 + 承重墙论点」 |
| **学怎么画一张不像目录树的架构图** 🆕 | [架构图绘制规范](#gal-spec)：六种图型 + 视觉通道纪律 + 事实核对协议 |
| **边看网页边学（交互、可点、有图）** | [全部学习站入口 :7400](#sites) |
| **查 Agent 工程里反复出现的模式（缓存/权限/压缩/沙箱…）** 🆕 | [**Agent 工程模式目录**](#patterns)（15 章，同一问题 × 十三个项目的不同解法） |
| **不知道从哪开始读——想要一份按水平的阅读路线** 🆕 | [**分级阅读路线**](#roadmap)（四个阶段，从零基础到能造 Agent） |
| **搞懂业界怎么评测 Agent（SWE-bench / GAIA / OSWorld…）** 🆕 | [**Agent 评测与基准测试**](#eval)（四层评测体系 + 已知局限 + 关键论文） |
| **看完十三家还想继续学——还有哪些项目值得剖析** 🆕 | [**后续项目推荐列表**](#more)（12 个项目，按学习价值排优先级） |
| **给别人做交接 / 看项目怎么长起来的** | [handoff](#meta) + [CHANGELOG](#meta) |

---

<!-- AUTO-CATALOG:START -->
### 🆕 最近更新（自动维护）

| 日期 | 类型 | 文件 | 位置 |
|---|---|---|---|
| 2026-09-11 | 更新 | `CHANGELOG.md` | 根目录 |
| 2026-09-11 | 更新 | `线上访问.md` | 根目录 |
| 2026-09-11 | 更新 | `CHANGELOG.md` | 根目录 |
| 2026-09-11 | 更新 | `线上访问.md` | 根目录 |
| 2026-09-11 | 更新 | `CHANGELOG.md` | 根目录 |
| 2026-09-11 | 更新 | `线上访问.md` | 根目录 |
| 2026-09-10 | 更新 | `CHANGELOG.md` | 根目录 |
| 2026-09-10 | 新增 | `线上访问.md` | 根目录 |
| 2026-09-10 | 更新 | `调查报告/DeepSeek招聘职位技能分析.md` | 调查报告 |
| 2026-09-10 | 更新 | `调查报告/DeepSeek招聘页-谷歌设计优化方案.md` | 调查报告 |
| 2026-09-10 | 更新 | `CHANGELOG.md` | 根目录 |
| 2026-09-10 | 新增 | `调查报告/DeepSeek招聘职位技能分析.md` | 调查报告 |
| 2026-09-10 | 新增 | `调查报告/DeepSeek招聘页-谷歌设计优化方案.md` | 调查报告 |
| 2026-09-10 | 新增 | `Easel-解析.html` | 根目录 |
| 2026-09-10 | 新增 | `从零构建Easel-开发全流程教程.md` | 根目录 |
| 2026-09-10 | 新增 | `从零构建Easel-开发全流程教程.html` | 根目录 |
| 2026-09-10 | 新增 | `项目分析/Easel-源码分析.md` | 项目分析 |
| 2026-09-10 | 新增 | `项目分析/Easel-源码分析.html` | 项目分析 |
| 2026-09-10 | 更新 | `CHANGELOG.md` | 根目录 |
| 2026-08-13 | 更新 | `Agent工程模式目录.html` | 根目录 |

> 由 `update-catalog.py` 自动维护，请勿手工编辑本区。
<!-- AUTO-CATALOG:END -->

<h2 id="sites">一、交互学习站（浏览器打开）🌐</h2>

> **线上（开通后收藏这个）**：https://kaiyuan-xiangmu-jiexi-zixi.pages.dev/  （Cloudflare Pages，仓库可私有。步骤见 [`线上访问.md`](./线上访问.md)）
> **一键启动全部（本机）**：在仓库根目录执行 `./start-html-previews.sh`
> **总入口（本机）**：html-hub.html
> ⚠️ 本机一律用 **127.0.0.1**（不要用 localhost）；**不要**双击各站的 `index.html`（会白屏）。避开 Kimi 占用的 7100/7101。构建产物 `_site/` 会把下面这些端口改成相对路径，所以线上同一套卡片也能点。

| 学习站 | 打开地址 | 里面有什么 |
|---|---|---|
| <span id="s-cc"></span>**Claude Code 学习站 v1**（苹果官网风） | learn/claude-v1/ | 10 章科普 + 3 个交互实验（Prompt 旅程模拟器 / Agent 主循环 / 权限闸门）+ 工具图鉴 + 命令图鉴 + 生态 + 八大 Agent 大观园 |
| **Claude Code 学习站 v2**（蓝皮书风） | learn/claude-v2/ | 与 v1 同内容，重排为 18 CHAPTERS / 6 PARTS + 阅读路径 + 进阶路径 |
| <span id="s-manus"></span>**OpenManus × Suna 学习站** | learn/manus/ | 概念 → 双项目导读 → 各章 → 横向对比 → 选型决策 → 从零构建 → 技术深潜 |
| **Manus 从零构建教程（站内版）** | learn/manus/build-guide.html | 跟一个任务走的完整构建路线，12 张机制图内联 |
| <span id="s-agent"></span>**从零构建 AI 编程助手 · 指南站** | learn/agent-guide/ | 10 章「知识树」：从想法到软件 → 三种范式 → 构建 MiniClaude → 客户端章 + 术语知识图谱 |
| <span id="s-od"></span>**Open Design 源码解析站** 🆕（苹果 UI + Claude blog 组织） | open-design-解析.html | 18 章 5 部分 + 12 图 + **4 个可交互实验台**：适配器解剖台 / 提示词分层装配器 / 反 AI 味 linter / 五陪审评分器 |
| **从零构建 AI 设计 Agent · 教程站** | 从零构建AI设计Agent-OpenDesign系-开发全流程教程.html | 17 步装配路线 + 12 图 + 可勾选的**装配进度**与**30 条验收断言** + 12 个翻车点手风琴 |
| <span id="s-mimo"></span>**MiMo Code 解析站** 🆕（苹果 UI + Claude blog 组织） | MiMo-Code-解析.html | **20 章 6 部分 + 9 图 + 5 个可交互实验台**：Goal 裁判沙盘 / 四道闸门实验台 / 提示词路由器 / BM25 相对地板 / **归属核对台（vs OpenCode 差分）** |
| <span id="s-gal"></span>**七大 Agent 架构图库** 🆕（苹果 UI + Claude blog 组织） | 架构图库.html | **7 个项目 · 9 张图 · 6 种图型**。每张图先写清「<b>回答什么问题</b>」与「<b>承重墙论点</b>」；进程与信任拓扑 / 一次回合时序 / 控制与数据平面 / 状态归属 / 扩展点与改动半径 / 状态机与失败恢复。<b>点图可全屏放大</b> |
| <span id="s-cx"></span>**OpenAI Codex 解析站** 🆕（苹果 UI + Claude blog 组织） | openai-codex-解析.html | **21 章 7 部分 + 10 图 + 5 个可交互实验台**：审批×沙箱正交表 / AGENTS.md 字节预算模拟器 / run_turn 停机协议 / MCP 名字归一化 / 平台沙箱选择。全部是 Rust 源码逻辑的<b>逐行移植</b> |
| <span id="s-mf"></span>**MiroFish 解析站** 🆕（苹果 UI + Claude blog 组织） | MiroFish-解析.html | **17 章 5 部分 + 11 图 + 5 个可交互实验台**：本体归一化流水线 / 人设分野判定台 / 中国作息活跃度曲线 / **双世界参数对照台** / 伪造工具结果剥离器。全系列<b>唯一一个非编程 Agent</b>——群体智能仿真 |
| <span id="s-easel"></span>**Easel 解析站** 🆕（讲义 + 实验台） | Easel-解析.html | **4 个可交互实验台**：提示词四层栈 / Skill 路由 / outputs 门禁 / 出站闸门 BLOCK·WARN。浙大 REAL 社媒内容宿主——不写循环，焊 OpenClaw |
| **Easel 源码分析（全文）** 🆕 | 项目分析/Easel-源码分析.html | 20 章：画像内联 · 112 SKILL · SSE 断线不杀 · 双锁 · uuid5 会话 |
| **从零构建社媒内容工作台（Easel 系）** 🆕 | 从零构建Easel-开发全流程教程.html | 15 步跟着「做一条小红书并发出去」装配 minieasel |
| <span id="s-cp"></span>**CodePilot 解析站** 🆕（苹果 UI + od-site） | CodePilot-解析.html | Electron 桌面客户端 + **5 个可交互实验台**：Runtime 五级解析 / 会话锁 / Native while / Bridge 格式 / Rewind |
| **从零构建 CodePilot · 教程站** 🆕 | 从零构建CodePilot-开发全流程教程.html | 从 PRD 到三条 Runtime：22 个功能模块开发顺序 |
| <span id="s-pi"></span>**Pi 解析站** 🆕（苹果 UI + Claude blog 组织） | Pi-解析.html | 9 包 monorepo + **5 个可交互实验台**：双层 while / 租约 / lazyStream / TUI diff / compaction retainedTail |
| <span id="s-cl"></span>**Cline 解析站** 🆕（苹果 UI + od-site） | 项目分析/cline-源码分析.html | 16 part / 31 chapter：五层 monorepo · 无状态 AgentRuntime · 28 工具 · 179 Provider ID / 4118 模型 · git checkpoint 事务 |
| **从零构建 Cline · 教程站** 🆕 | 从零构建Cline-开发全流程教程.html | 24 part / 126 chapter：17 个功能模块按开发顺序 + 「用户输入提示词之后」完整工作流 |
| <span id="s-kb"></span>**Kanban 解析站** 🆕（Hermes 官网风格） | 项目分析/kanban-源码分析.html | 16 part / 60 chapter：一卡一 worktree · hooks 反向注入 · 双 WS 终端 · ClineCore 多会话宿主 · 安全四层 |
| **从零构建 Kanban · 教程站** 🆕 | 从零构建Kanban-开发全流程教程.html | 26 part / 169 chapter：20 个功能模块 + 「点下播放按钮之后」完整工作流 |
| <span id="s-cm"></span>**CodexMonitor 解析站** 🆕（Hermes 官网风格） | 项目分析/codexmonitor-源码分析.html | 16 part / 59 chapter：app-server 官方协议 · shared-core 双进程 · worktree 一等对象 · 与 codex 官方源码四组交叉印证 + 品味专章 |
| <span id="s-beyond"></span>**不止于回答 · 上篇** 🆕（Claude blog） | beyond-answers-part1.html | goldengrape 全文（序言 + 第1–6章）+ **8 张理解图解** + 引用资料本地库（PDF/网页镜像） |
| <span id="s-o4s"></span>**OpenAI4S 解析站** 🆕（Claude blog） | OpenAI4S-解析.html | Code-as-Action 科研 Agent：双平面引擎 · Host RPC · Ledger · 34 Skills · **横向对比** |
| **从零构建 OpenAI4S · 教程站** 🆕 | 从零构建OpenAI4S-开发全流程教程.html | PRD → 22 模块开发顺序 · 提示词全链路 · 24 图 |
| <span id="s-dsh"></span>**DeepSeek Harness 解析站** 🆕（讲义风格） | 项目分析/DeepSeek-Harness-源码分析.html | 33 章 / 11 图：一切皆插件（连循环也是）· **241 个包逐个名册 + 协作图谱** · 73 服务键 · seam 三角色 · 单调守卫 · 218 包依赖 invariants · 686 篇 Agent Notes |
| <span id="s-liang"></span>**梁文锋投资者交流会 · 观点提炼** 🆕（讲义风格 · 中英） | 调查报告/梁文锋投资者交流会-观点提炼.html | 录音稿提炼：愿景组织人 → 市场过大无法独占 → 克制（开源 / 十个月回本 / 不抢相邻生意）→ 提高做成 AGI 的概率；唯一核心利益是团队稳定。英文本：[Liang Wenfeng Brief](调查报告/Liang-Wenfeng-Investor-Meeting-Views.html) |
| **梁文锋技术阶梯 · 行业调研** 🆕（讲义风格） | 调查报告/梁文锋技术阶梯-行业调研.html | 把「语言模型 → CoT → Agent → 持续学习 → 渐变自我迭代 → 具身」对照 2026 年最前沿论文与实验室；推断与原文分层；P1–P5 证据分级；三条证伪条件 |
| <span id="s-ds-talent"></span>**DeepSeek 招聘职位 · 技能图谱** 🆕 | 调查报告/DeepSeek招聘职位技能分析.html | 官网 34 岗完整 JD · 10 类赛道 · Chip 筛选 · 高亮技能可关 · 技能笔记 |
| **DeepSeek 招聘页 · 谷歌设计优化方案** 🆕 | 调查报告/DeepSeek招聘页-谷歌设计优化方案.html | 方案已落地到交互页；下文保留 Google Web 质量线诊断与 P0–P2 |
| **从零构建插件化 Agent Harness · 教程站** 🆕 | 从零构建插件化AgentHarness-DeepSeekHarness系-开发全流程教程.html | 20 步造 ~700 行 minidsh：服务仓库 → inject → 可逆 effect → 四种 dispatch → 日志即真相 → turn/step → 工具三 waterfall → seam → 沙箱 → 装配分层；每步含验收断言 + 14 个翻车点 |

### 独立静态 HTML（无需构建，:7400 直接开）

| 页面 | 打开地址 |
|---|---|
| **Manus 系从零构建教程**（全文 + 12 图内联 SVG） | 从零构建通用任务Agent-Manus系-开发全流程教程.html |
| **从零构建 Claude Code · 交互课** | build-claude-code.html |
| **Open Design 源码解析站** | open-design-解析.html |
| **MiMo Code 源码解析站** | MiMo-Code-解析.html |
| **MiroFish 源码解析站** | MiroFish-解析.html |
| **Easel 源码解析站** 🆕 | Easel-解析.html |
| **Easel 源码分析（全文）** 🆕 | 项目分析/Easel-源码分析.html |
| **从零构建社媒内容工作台（Easel 系）** 🆕 | 从零构建Easel-开发全流程教程.html |
| **OpenAI Codex 源码解析站** | openai-codex-解析.html |
| **CodePilot 源码解析站** 🆕 | CodePilot-解析.html |
| **从零构建 CodePilot · 教程站** 🆕 | 从零构建CodePilot-开发全流程教程.html |
| **Pi 源码解析站** 🆕 | Pi-解析.html |
| **DeepSeek-Reasonix 源码解析站** 🆕 | 项目分析/DeepSeek-Reasonix-源码分析.html |
| **DeepTutor 源码解析站** 🆕 | 项目分析/DeepTutor-源码分析.html |
| **DeepSeek Harness 源码解析站** 🆕 | 项目分析/DeepSeek-Harness-源码分析.html |
| <span id="build"></span>**从零构建插件化 Agent Harness · 教程站** 🆕 | 从零构建插件化AgentHarness-DeepSeekHarness系-开发全流程教程.html |
| **不止于回答 · 上篇** 🆕 | beyond-answers-part1.html |
| **OpenAI4S 源码解析站** 🆕 | OpenAI4S-解析.html |
| **从零构建 OpenAI4S · 教程站** 🆕 | 从零构建OpenAI4S-开发全流程教程.html |
| **七大 Agent 架构图库** 🆕 | 架构图库.html |
| **从零构建 AI 设计 Agent · 教程站** 🆕 | 从零构建AI设计Agent-OpenDesign系-开发全流程教程.html |
| **Agent 工程模式目录** 🆕 | Agent工程模式目录.html |
| **按水平分级的阅读路线** 🆕 | 按水平分级的阅读路线.html |
| **Agent 评测与基准测试** 🆕 | Agent评测与基准测试.html |
| **后续待剖析的开源项目推荐列表** 🆕 | 后续待剖析的开源项目推荐列表.html |
| **梁文锋投资者交流会 · 观点提炼** 🆕 | 调查报告/梁文锋投资者交流会-观点提炼.html |
| **Liang Wenfeng Investor Meeting · Views** 🆕 | 调查报告/Liang-Wenfeng-Investor-Meeting-Views.html |
| **梁文锋技术阶梯 · 行业调研** 🆕 | 调查报告/梁文锋技术阶梯-行业调研.html |
| **DeepSeek 招聘职位 · 技能图谱** 🆕 | 调查报告/DeepSeek招聘职位技能分析.html |
| **DeepSeek 招聘页 · 谷歌设计优化方案** 🆕 | 调查报告/DeepSeek招聘页-谷歌设计优化方案.html |
| **学习站总入口 Hub** | html-hub.html |

---

<h2 id="cc-main">二、Claude Code 主线（源码科普）📖</h2>

<h3 id="a1">主文档：《Claude-Code-工作原理科普-深入版.md》</h3>

`Claude-Code-工作原理科普-深入版.md` · **1950 行 / 36 图 / 141KB** · 全项目的旗舰文档

| # | 章节 |
|---|---|
| 一 | 先搞懂概念：什么是 AI Agent |
| 二 | 全景图：五层架构与一次请求的数据流 |
| 三 | 旅程开始：启动时软件做了什么 |
| 四 | 按下回车的那一刻：输入的分流之旅 |
| 五 | 打包行李：发往 AI 的请求怎么拼出来 |
| 六 | **心脏地带：Agent 主循环（最重要一章）** |
| 七 | AI 的「手」：工具系统与权限闸门 |
| 八 | 工具图鉴：40+ 件兵器逐一上手 |
| 九 | 斜杠命令图鉴：60+ 快捷指令原理 |
| 十 | 生态组件：插件、技能、MCP |
| 十一 | 功能特性拆解：effort、登录、模型切换 |
| 十二 | 记忆与遗忘：上下文压缩 |
| 十三 | 分身术与急刹车：子 Agent 与中断 |
| 十四 | 总流程图 + 附录源码导览索引 |

其他：`Claude-Code-工作原理科普.md`（v1 初版，608 行 / 11 图，**已被深入版取代，存档保留**）

<h3 id="reports">三份源码调查报告（素材底稿）</h3>

| 文件 | 内容 | 规模 |
|---|---|---|
| <span id="r1"></span>`调查报告/01-工具盘点.md` | 43 个内置工具逐一 | 189 行 |
| `调查报告/02-核心功能组件盘点.md` | 插件 / 技能 / MCP / 认证 / effort 等 | 218 行 |
| <span id="r3"></span>`调查报告/03-斜杠命令盘点.md` | 60+ 命令 + 12 个深度剖析 | 212 行 |

<h3 id="liang">梁文锋投资者交流会 · 观点提炼 + 技术阶梯行业调研 🆕</h3>

录音文字稿（`deepseek 0520.m4a`，约 3h44min，录音 5 月 20 日，整理 2026-07-16）拆成两层：摘录稿只收梁文锋本人的判断与他给出的依据；行业调研把「语言模型 → CoT → Agent → 持续学习 → 渐变自我迭代 → 具身智能」对照 2026 年可核验的前沿研究。数字按稿照录并单列 ASR 风险。讲义风格 HTML。

| 文件 | 内容 | 规模 |
|---|---|---|
| `调查报告/梁文锋投资者交流会-观点提炼.md` / [HTML](调查报告/梁文锋投资者交流会-观点提炼.html) | 主因果链 + 15 章：愿景、克制、开源与十个月回本、AGI 阶梯、唯一核心利益、算力与国产芯片、组织、持续学习、资本路径 | **514 行** |
| `调查报告/Liang-Wenfeng-Investor-Meeting-Views.md` / [HTML](调查报告/Liang-Wenfeng-Investor-Meeting-Views.html) | Same structure in English; academic terms, no embellishment | **512 行** |
| `调查报告/梁文锋技术阶梯-行业调研.md` / [HTML](调查报告/梁文锋技术阶梯-行业调研.html) | 投行主题深度：一页纸、认知还原、六级 SOTA 仪表盘、路线之争、情景与证伪、产业含义；P1–P5 出处表 | **544 行** |

核心抽取：愿景组织人 → AI 或占人类 GDP 约 10%、无法独占 → 必须克制 → 提高做成 AGI 的概率。C 端 / B 端 / API 是主线上的副产物。唯一不可退让的核心利益是团队稳定。技术主线的行业对照见上表第三行。

<h3 id="ds-talent">DeepSeek 招聘 JD 图谱 🆕</h3>

从 [talent.deepseek.com](https://talent.deepseek.com/) 摘录全部 34 个在招岗位的完整详情页。官网大类太粗（「全栈开发/算法」里同时有前端、服务端、Harness、数据、测试），按工作内容重切成 10 条赛道，并统计技能出现次数。

| 文件 | 内容 |
|---|---|
| [交互 HTML](调查报告/DeepSeek招聘职位技能分析.html) | 白底 Chip 阅读器；技能最多 6 个；多方向一次一个；高亮可关 |
| [`调查报告/DeepSeek招聘职位技能分析.md`](./调查报告/DeepSeek招聘职位技能分析.md) | 文字版对照结论 + 技能排名表 + 全岗位清单 |
| [谷歌设计优化方案](调查报告/DeepSeek招聘页-谷歌设计优化方案.html) | 方案已落到交互页；诊断原文仍在 |

---

<h2 id="build">三、从零构建教程（五条独立路线）🛠️</h2>

<h3 id="b1">路线 A：造一个 AI 编程助手</h3>

`从零构建AI编程助手-开发全流程教程.md` · **587 行 / 39KB**

> 0 使用说明 → 1 看懂终点 → 2 软件诞生全景 → 3 软件工程与流程 → 4 需要哪些角色 → 5 角色协作与处理矛盾 → 6 三种开发范式 → 7 一步步构建 MiniClaude → 8 工程心法 → **9 如果目标是客户端（界面/流式/高亮/打包）** → 10 术语总表 → 11 知识树地图 → 12 结语

对应交互站：[指南站 :7397](#s-agent)

<h3 id="b2">路线 B：造一个通用任务 Agent（Manus 系）</h3>

`从零构建通用任务Agent-Manus系-开发全流程教程.md` · **1037 行 / 12 图 / 51KB** · 叙事主线「跟着一个真实任务从头走到尾」

> 先看终点（全景装配图）→ 第 0 步 任务登场（"帮我总结这个网址"）→ 1 给大脑 → 2 给手 → 3 心跳循环 → 4 教它下班 terminate → 5 给记忆 → 6 给说明书（通用模型变专员）→ 7 让它真会调研（搜→开→抽）→ 8 交付物模板 → 9 装刹车（断网/超预算/卡住）→ 10 复制新专员 → 🎬 完整回放 → **第二关：从"能干活"到"能安全地一起干很多活"** → 附录（排期/黄金题/十大翻车/对照阅读索引）

对应版本：根目录 `.html`（:7400）· 站内 `build-guide.html`（:7200）· [学习站 :7200](#s-manus)

<h3 id="b3">路线 C：造一个 AI 同事（OpenWorker 系）🆕</h3>

`从零构建AI同事-OpenWorker系-开发全流程教程.md` · **458 行 / 9 图** · 叙事主线「跟着"每天发一份晨报到 Slack"这个场景从头走到尾」

> 先看终点（数字同事装配图）→ 第 0 步 晨报场景登场 → 1 provider 无关的大脑 → 2 给手并贴风险标签 → 3 异步主循环（低危并发/高危串行）→ 4 装刹车（中断不留孤儿）→ 5 权限闸门（五档模式 + shell 防注入）→ 6 **人不在怎么办：带外审批 + 收件箱** → 7 **重启不丢：持久恢复** → 8 SQLite 记忆 → 9 persona 与家族 → 10 连接器 + Slack @提及即会话 → 11 定时自动化 + self-wake → 🎬 完整回放 → 装成产品（桌面壳 + 服务侧车）→ 附录（验收断言/十大翻车/源码对照索引）

对应：源码分析 [`openworker-源码分析.md`](#c1) + 已并入[横评](#c2)

<h3 id="b4">路线 D：造一个 AI 设计 Agent（Open Design 系）🆕</h3>

`从零构建AI设计Agent-OpenDesign系-开发全流程教程.md` · **1964 行 / 13 图 / 105KB**（本仓库最大的一份构建教程）· 叙事主线「跟着"帮我们做个 SaaS 落地页，用我们公司的品牌"这一句话从头走到尾」

> **最反直觉的一点：这条路线里你一行 Agent 主循环都不写。** 你要写的是「插座 + 剧本 + 闸门」。
>
> 先看终点（设计引擎宿主装配图）→ 第 0 步 一句话里藏的 15 堵墙 → **A 决定不写 Agent**（1 成本核算与连锁后果 · 2 适配器即数据）→ **B 接住引擎**（3 探测的必踩坑 · 4 stdin 而非 argv · 5 四类解析器 · 6 两档执行画像）→ **C 给它剧本**（7 品牌契约 · 8 工艺第四轴 · 9 三条硬规则 · 10 管住优先级 · 11 缓存分带）→ **D 装闸门**（12 把「一眼假」写成正则 · 13 五陪审员 · 14 三张卡的记忆双环 · 15 原子与封闭 until）→ **E 装成产品**（16 六道边界 · 17 桌面壳/MCP/导出）→ 🎬 完整回放 → 附录（**30 条验收断言** / **十二个翻车点** / 源码对照索引）

对应：源码分析 [`open-design-源码分析.md`](#c1) + [横评第七章](#c2) + 两个交互站（[解析站](#s-od)）

<h3 id="b5">路线 E：造一个多模型桌面 Agent 客户端（CodePilot 系）🆕</h3>

`从零构建CodePilot-开发全流程教程.md` · 从 PRD 到三条 Runtime

> Electron + Next.js 外壳，里面挂 Claude Agent SDK / Native / Codex 三条可替换引擎。22 个功能模块按开发顺序：目的、实现、技术栈、取舍、配合关系。

对应：源码分析 [`codepilot-源码分析.md`](#c1) + [解析站 / 教程站](#s-cp)

<h3 id="b6">路线 F：造一个社媒内容工作台（Easel 系）🆕</h3>

`从零构建Easel-开发全流程教程.md` · 15 步 · 对照 `ZJU-REAL/Easel` @ `765f5a6`

> **最反直觉的一点：这条路线里你一行 Agent 主循环都不写。** 循环外包给 OpenClaw；你要写的是画像前缀、项目目录契约、出站扫描、SSE 与会话锁。
>
> 先看终点 → 第 0 步「做一条小红书并发出去」里的十二堵墙 → 不写循环 → 三入口画像前缀（否掉 USER.md）→ 四层 prompt 栈 → sync 工地 vs 剧本 → SKILL.md 契约 → outputs 门禁 → 薄 manifest → TURN_REMINDER → content_guard exit 7 → persona_gate 永不阻断 → SSE 断线不杀 → 双锁 + uuid5 → session_heal → 真发 → doctor/ping → 完整回放。

对应：源码分析 [`Easel-源码分析.md`](#c1) + [解析站](#s-easel)

---

<h2 id="agents">四、十八大开源 Agent 源码分析 🔬</h2>

> 单项目分析（+ Claude Code 作基准）统一用 **12 章框架**（宿主 / fork / 仿真等专线会扩章）。全部标注 commit 与 `文件:行号`。
>
> **谱系**：前七家是**编程 Agent**；**OpenWorker** 是跨界同事；**Open Design** 是不写主循环的**宿主**；**CodePilot** 是桌面多 Runtime 客户端；**Pi** 是协议驱动 monorepo harness；**Cline** 是可嵌入引擎（SDK 与界面分离）；**Kanban** 是多 Agent 并行编排看板；**CodexMonitor** 是走官方协议的桌面指挥台；**MiroFish** 是唯一一个**不做任务、只做仿真**的；**Easel** 是社媒内容宿主（OpenClaw 垂直焊法）。

<h3 id="c1">单项目分析（每份都点出 3 个最独特设计）</h3>

| 项目 | 一句话绝活 | 规模 |
|---|---|---|
| `项目分析/opencode-源码分析.md` | 「服务器即本体」、Effect 全栈、可教导拒绝 | 693 行 / 12 图 |
| `项目分析/hermes-agent-源码分析.md` | 前缀缓存神圣、闭环学习五件套、74 工具极端插件化 | 878 行 / 13 图 |
| `项目分析/Raven-源码分析.md` | Spine 调度脊骨、Curator 无损上下文、EverOS 双轨记忆 | 867 行 / 12 图 |
| `项目分析/CodeWhale-源码分析.md` | Rust 单二进制、safe by construction、provenance 降级 | 993 行 / 19 图 |
| `项目分析/goose-源码分析.md` | 一切皆 MCP 扩展、引擎即服务器（ACP）、动静分离上下文 | 667 行 / 12 图 |
| `项目分析/nanobot-源码分析.md` | 显式状态机、MessageBus 双队列、Dream 夜间反思、ClawHub、bwrap 沙箱 | 879 行 / 10 图 |
| `项目分析/grok-build-源码分析.md` | xAI 官方 CLI、Goal Mode 五件套、六档权限 + LLM 分类器、多媒体工具 | 791 行 / 12 图 |
| `项目分析/openworker-源码分析.md` | **吴恩达团队**：收件箱 + 持久恢复、带外审批、provider 无关（建在 aisuite）、40 个连接器描述符、定时自动化（**通用任务同事，非编程 Agent**） | 430 行 / 9 图 |
| `项目分析/open-design-源码分析.md` | **82k star / 3 个月**：适配器即数据（26 条定义接住 25 个 CLI）、20 层提示词按缓存频率分带、**程序化反 AI 味 linter**、五陪审评审剧场（**不写主循环的宿主，把前九家当引擎**） | **1858 行 / 13 图 / 126KB**（本系列最大） |
| `项目分析/MiMo-Code-源码分析.md` | **小米，12.5k star / 1.5 个月**：**opencode 的深度 fork**。主题是「不信任模型的自我报告」——Goal 独立裁判 + 四道死循环闸门 + Try-Best + 产物验证（共 7 道防护）。**第 20 章是与上游的逐层差分**（基于真实文件级 diff：15 个新增子系统、1.75x 代码量、`prompt.ts` 3.2x、acorn 手写解释器→QuickJS、**逐条标注哪些是首创哪些是继承**） | **1724 行 / 9 图 / 105KB** |
| `项目分析/openai-codex-源码分析.md` 🆕 | **OpenAI 官方，102k star**，Apache-2.0。**Rust workspace 126 crate**。心脏是 `run_turn`（`turn.rs:153`，单文件 2 741 行）：<b>两层循环</b>（外层管用户插话、内层管工具/压缩/hook）+ <b>三方停机协议</b>。闸门是 <b>AskForApproval × 三平台 OS 沙箱</b>（Seatbelt / Landlock+seccomp / Windows Token）——**两道正交的墙**。`apply_patch` 是一等公民（独立 crate + arg0 第二人格 + 两处拦截）。工程宪法写在仓库自己的 `AGENTS.md` 里 | **1593 行 / 28 章 / 加深版** |
| `项目分析/MiroFish-源码分析.md` | **盛大孵化，69.6k star / 8 个月**，AGPL。**全系列唯一的非编程 Agent**：上传一份材料 → 自动建一个平行数字世界 → 上千个有人格有记忆的 Agent 自由演化 → 预测报告 + **一个能走进去对话的世界**。绝活：图谱↔模拟**双向闭环**、**采访还活着的 Agent**（跑完不关门）、把**社会学常识编码成配置**（中国作息曲线 / 双平台破圈阈值）、个人与机构**人设分野**。**每千行代码 1550 星，本系列第一** | **1889 行 / 13 图 / 91KB** |
| `项目分析/codepilot-源码分析.md` 🆕 | **多模型 AI Agent 桌面客户端**（op7418，BSL-1.1，v0.62.0）。Electron 40 + Next.js 16 + SQLite。绝活：**三条可替换 Runtime**（Claude Agent SDK / Native / Codex）· 17+ Provider · IM Bridge（Telegram/飞书/Discord/QQ/微信） | **819 行** · [解析站](#s-cp) · [从零构建教程](#s-cp) |
| `项目分析/pi-源码分析.md` 🆕 | **earendil-works/pi**，MIT。**协议驱动的可组合 Agent harness**：9 包 monorepo · 38 Provider · 双层 while · 运行时自扩展 Extensions · 差分渲染 TUI · CBOR 线协议 · SQLite 事件溯源 | **638 行** · [解析站](#s-pi) |
| `项目分析/cline-源码分析.md` 🆕 | **cline/cline**，Apache-2.0，main 2026-08 检出（CLI v3.0.49 / VS Code 4.1.3 / SDK 0.0.69）。**从 IDE 插件重构成「引擎与界面分离」的 bun monorepo**：shared←llms←agents←core←apps 五层 · **无状态 AgentRuntime**（每条用户消息 new 一个 + 全量转录播种）· 28 工具 · **179 个 Provider ID / 4118 模型** · git checkpoint 事务回滚 · basic/agentic 双压缩 | **434 行** · [解析站](#s-cl) · [从零构建教程](#s-cl) |
| `项目分析/kanban-源码分析.md` 🆕 | **cline/kanban**，Apache-2.0，v0.1.70。**让成百个编码 Agent 并行干活的看板**：一张卡片 = 一个 `git worktree --detach` + 一个 node-pty 终端 · hooks 反向注入实时状态 · 7 种 CLI Agent 适配（启用 5 种）· 双 WS 通道（字节/JSON）· 安全四层 · Electron 纯进程壳 | **610 行** · [解析站](#s-kb) · [从零构建教程](#s-kb) |
| `项目分析/codexmonitor-源码分析.md` 🆕 | **Dimillian/CodexMonitor**，MIT。**给 Codex 配一个 Tauri 2 指挥台**：每工作区 spawn 一个 `codex app-server` 走**官方 stdio JSON-RPC**（不是 PTY 抓屏）· 22 个官方协议方法 · shared-core `#[path]` 双进程复用（app + iOS 远程 daemon）· worktree 一等对象 · libgit2 读 / git CLI 写 · 前端零状态库。**含与 codex 官方源码的四组交叉印证** | **557 行** · [解析站](#s-cm) |
| `项目分析/DeepSeek-Reasonix-源码分析.md` 🆕 | **esengine/DeepSeek-Reasonix**，MIT，`main-v2` @ `627b051`。**DeepSeek 原生 Go 终端 Agent**：cache-first 宪法（Compose turn tail + PrefixShape miss 诊断 + `use_capability` 隔离 MCP）· 传输无关 `control.Controller`（TUI/HTTP/Wails/ACP）· Delivery 证据签收 · soft→snip→summary 压缩 · 单静态二进制 | **733 行 / 18 章 + 附录** · 根目录同名副本 · [HTML 版](项目分析/DeepSeek-Reasonix-源码分析.html) |
| `项目分析/DeepSeek-Harness-源码分析.md` 🆕 | **deepseek-ai/deepseek-harness**，MIT，`v0.1.0-rc.5` @ `47f9438`。**DeepSeek 官方插件化 agent harness**：一切皆插件、**没有特权内核**（模型适配器/工具注册表/会话日志/**乃至 agent 循环本身**都是插件）· Cordis 五观念（空间可替换×时间可撤销）· **capability seam 三角色**（换两个 provider 搬走整个执行世界）· turn/step 两级边界 + `agent/turn-stopping` 公告 · 工具三道 waterfall + **单调守卫**（类型上无法提权）+ 冻结结果 · 模型可见⟺已记录（**`dsh-invariants` 被 218/241 包依赖**）· Landlock 沙箱 · typert 类型图 RPC · **逐文件 100% 覆盖率**（把未覆盖行当死代码信号）· 28 个 `verify-*` 门禁 · **686 篇 Agent Notes** · 含 **241 个包逐个名册 + 协作图谱** | **2 692 行 / 33 章 + 附录 A–C** · [HTML 版](项目分析/DeepSeek-Harness-源码分析.html) |
| `项目分析/DeepTutor-源码分析.md` 🆕 | **HKUDS/DeepTutor**，Apache-2.0，`v1.5.11` @ `456f9c2`（**已二轮回核**）。**Agent 原生终身个性化辅导工作区**（35k star）：切换目标不换引擎（ChatOrchestrator + 7 Capability + 5 LoopCapability）· **Tools×Capabilities×LoopCapability 三层插件** · Chat「无工具即收工」与 Label 双轨循环 · **ToolMountFlags + deferred tools 两层渐进披露** · 36 provider 能力位 + **DSML 文本工具回退** · L1/L2/L3 可审计记忆（整数脚注 + 四种综合模式）· 五种 RAG 引擎 · **沙箱三档两级隔离** · 101 个钉版 CLI Apps · Codex OAuth · 可重放 turn 协议 + 多用户授权矩阵 · Partners 16 IM · Subagent 会诊编程 CLI | **1 144 行 / 24 章 + 附录 A–D** · [HTML 版](项目分析/DeepTutor-源码分析.html) |
| `项目分析/Easel-源码分析.md` 🆕 | **ZJU-REAL/Easel**，Apache-2.0，`v0.1.0` @ `765f5a6`（浙大 REAL + 北大 OpenDCAI，733★ / 约两周）。**社媒内容工作台 / OpenClaw 垂直宿主**：768 行 Python 整合层 + 2509 行 FastAPI + **112 个可执行 SKILL**。绝活：画像**消息内联**（否掉全局 USER.md）· 四层 prompt 栈 · `outputs/<主题>/` 项目契约 · **content_guard fail-closed exit 7** / persona_gate 永不阻断 · SSE **断线不杀** · 双锁防 takeover · uuid5 钉死 transcript · thinking 自愈。对照 Open Design：都是不写循环的宿主，客体从设计文件换成国内六平台真发 | **20 章** · [解析站](#s-easel) · [HTML 版](项目分析/Easel-源码分析.html) |

<h3 id="c2">横向对比与总评</h3>

`项目分析/横向对比与总结评价.md` · **1233 行 / 19 图**（十二大 Agent）

<span id="c3"></span>**另有一份三方聚焦对比**：`项目分析/Claude-Code-vs-OpenCode-vs-Codex-深度对比.md`（387 行）——只把 **Claude Code × OpenCode × Codex** 这三家同类产品放一张桌子：产品主权 / 权限路线 / 工具 ABI / 说明书加载 / 会话资产，末尾给「我该选哪个」的决策图。

> 一 速览总表（含 Claude Code 基准列 + OpenWorker 跨界列）→ 二 逐项 10 维度横向对比 → 三 六个工程决策的选择困境 → 四 产品逻辑如何决定技术形态 → 五 **五场「思路对决」**（权限路线含"收件箱挂起派" / 上下文哲学 / 生态开放度 / 架构形态 / 模型策略）→ 六 给初学者的选型建议 → **七 第十个样本 Open Design：当「宿主」坐上桌子**（含**第六场对决「造引擎还是造插座」**）→ 🆕 **八 第十一个样本 MiMo Code：同一副骨架，小米焊了什么**（8.2 四层七道防自欺装置 · 8.3 三个前十家都没有的设计 · 8.4 **十一条可复用的工程细节** · 8.6 **第七场对决「通用 harness 还是一模型一形」** · 8.8 生态里没有绝对的宿主和客体）→ 🆕 **九 第十二个样本 MiroFish：当 Agent 不再干活，而是演化**（9.2 三件前十一家都没做过的事 · 9.3 把「外包」做到极致 · 9.4 **第八场对决「一个很能干的 Agent 还是一千个很像人的 Agent」** · 9.5 **换轴象限：右上角只有它一个** · 9.7 值得单独抄走的全栈 i18n）

---

<h2 id="manus">五、Manus 系专线（OpenManus × Kortix/Suna）🐙</h2>

| 文件 | 内容 | 规模 |
|---|---|---|
| `项目分析/OpenManus-源码分析.md` | 12 章加深版：`state_context` 回滚陷阱、browser_use 调研闭环、`terminate` 一等退出、PlanningFlow 全路径 | 1617 行 / 11 图 |
| `项目分析/Suna-源码分析.md` | 平台 lifecycle、`session_id==sandbox_id==branch`、Executor 密钥边界、CR 全路径 | 1214 行 / 8 图 |
| <span id="m3"></span>`项目分析/OpenManus-vs-Suna-横向对比.md` | 产品轴心、主循环位置分野、许可（MIT vs Elastic 2.0）、「我该选哪个」决策图 | 157 行 / 2 图 |

对应：从零构建路线 B（[上面](#b2)）+ [学习站 :7200](#s-manus)

---
 
<h2 id="patterns">六、Agent 工程模式目录 🆕 · 跨项目横向提炼</h2>

`Agent工程模式目录.md` · **15 章** · 从十三大项目中提取反复出现的工程手法

> 每一个模式都是"同样的问题，不同的项目给出了不同的解法"——这里把解法并排，讲清楚利弊和适用场景。全文标注 `文件:行号`。

| # | 章节 |
|---|---|
| 一 | Prompt Cache 工程（五板斧：静态前置 / 易变外移 / 工具稳定 / 压缩慎重 / 遥测可见） |
| 二 | Agent 停止判定（五种刹车：自然停止 / 轮次上限 / 重复检测 / 完成信号 / 三方停机协议） |
| 三 | 权限闸门派别（六派：弹窗询问 / 规则前置 / 结构安全 / 沙箱隔离 / LLM 分类器 / 收件箱挂起） |
| 四 | 上下文压缩（摘要丢弃 vs 无损归档——十二家 vs Raven 的哲学对决） |
| 五 | 记忆体系（纯文件 / SQLite 双层 / 双轨制 / 自动学习闭环——四种模式与通用原则） |
| 六 | 工具系统设计（延迟加载 / 按需搜索 / 合并同类项 / 不给模型看用不了的工具） |
| 七 | 沙箱与执行隔离（五层防线：应用围栏→语法解析→能力降级→OS 沙箱→硬件隔离） |
| 八 | 子 Agent 模式（三代进化：阻塞等待→消息注入→消息总线，含防失控趋同设计） |
| 九 | 错误处理（分类驱动决策 / 回喂模型 / 错题本文化） |
| 十 | 流式管线（三个分岔点：SDK vs 裸流 / 参数累积方式 / thinking 块处理） |
| 十一 | 并发与取消（硬取消 vs 协作取消——Rust Drop 和 Python 协作式的哲学分歧） |
| 十二 | 持久化与崩溃恢复（JSONL 派 / SQLite 派 / 事件投影派 + hermes 的"先落盘再动手"血泪教训） |
| 十三 | 扩展生态策略（统一协议 / 自有市场 / 全插件 / 兼容优先 + 渐进披露共识） |
| 十四 | 架构形态（单体 / 服务器 / 消息总线——三种形态的选择原则） |
| 十五 | 模型策略（锁定做深 vs 无关做宽——第一方红利与 provider 无关税的对账） |

对应 HTML 站：[Agent工程模式目录.html](Agent工程模式目录.html)

---

<h2 id="roadmap">七、按水平分级的阅读路线 🆕</h2>

`按水平分级的阅读路线.md` · 四个能力阶段的完整阅读导航

| 阶段 | 目标 | 核心内容 |
|---|---|---|
| **阶段一** | 建立认知——Agent 到底是什么、怎么工作 | 深入版 MD 前 7 章 + 学习站 v1 + 编程助手构建教程 |
| **阶段二** | 打开视野——同一个问题不同项目怎么解 | 横向对比 1–2 章 + 挑 2–3 个架构差异大的分析 + 工程模式目录 |
| **阶段三** | 动手构建——从零造一个能用的 Agent | 四条构建路线（按编程门槛和兴趣选一条跟着做） |
| **阶段四** | 专线深潜——看懂最前沿的工程实践 | MiMo 逐层差分 + Open Design 宿主 + MiroFish 仿真 + Codex Rust + 架构图方法论 |

含：零基础前置补充指南 + 有基础者的快速定位表。

对应 HTML 站：[按水平分级的阅读路线.html](按水平分级的阅读路线.html)

---

<h2 id="eval">八、Agent 评测与基准测试 🆕</h2>

`Agent评测与基准测试.md` · 四层评测体系 + 已知局限 + 关键论文

| 层次 | 测什么 | 代表 |
|---|---|---|
| L1 模型基础 | 单函数、独立题目 | HumanEval、MBPP |
| L2 代码编辑 | 多文件、有格式要求 | Aider Polyglot |
| L3 真实工程 | 真实 bug 修复 | SWE-bench Verified |
| L4 通用任务 | 多步搜索/浏览/操作 | GAIA、WebArena、OSWorld |

含：你分析过的项目各自怎么看评测 + 如果你想评测自己的 Agent 该怎么做 + 评测体系本身的五个问题（指标扭曲 / 成本忽略 / 基础设施不可靠 / 不可复现 / 数据污染）。

对应 HTML 站：[Agent评测与基准测试.html](Agent评测与基准测试.html)

---

<h2 id="more">九、后续待剖析的开源项目推荐列表 🆕</h2>

`后续待剖析的开源项目推荐列表.md` · 12 个项目，按学习价值排优先级

| 优先级 | 项目 | 看点 |
|---|---|---|
| 最高 | **Aider** | 编程 Agent 里"少即是多"的样本——校准"什么才是必要的" |
| 最高 | **SWE-agent** | CLAUDE.md 的发明者——理解整个生态的文化基因源头 |
| 最高 | **LangGraph** | 用显式状态图代替 while 循环——Agent 编排的另一种范式 |
| 高 | **Cline** | IDE 插件 vs 终端 TUI 的对照样本 |
| 高 | **browser-use** | 浏览器 Agent——非编程 Agent 的另一个大门类 |
| 高 | **Computer Use** | 用截图代替工具调用——挑战"Agent harness"的根本理解 |
| 中 | AutoGen / CrewAI / Dify / Google A2A / E2B | 多 Agent 协作 / 可视化编排 / 互操作协议 / 沙箱基础设施 |

对应 HTML 站：[后续待剖析的开源项目推荐列表.html](后续待剖析的开源项目推荐列表.html)

---

<h2 id="meta">十、元文档 / 交接 / 旧索引 📎</h2>

| 文件 | 说明 |
|---|---|
| `CHANGELOG.md` | 阶段 1–10 完整演进 + 产物总览表（想知道每样东西怎么长出来的看这个） |
| `handoff.md` | 零上下文交接文档（工作区地图 / 设计系统规格 / 验证流程） |
| <span id="gal-spec"></span>`架构图绘制规范-给图库Agent.md` 🆕 | **六种图型分类法** + 视觉通道纪律 + Agent 架构特有的七类承重信息 + 事实核对协议。写给生成架构图的 Agent，但对任何要画架构图的人都适用 |
| `架构图-第二轮审阅与勘误-给图库Agent.md` 🆕 | 实测审阅：一张图语法错误不渲染 · 一个编造的百分比 · 四个查不到的标识符 · 配色语义未生效 |
| `架构图-第三轮审阅-给图库Agent.md` 🆕 | 实测审阅：**一条边把动作归给数据结构，与该图自己的承重墙论点自相矛盾**；并更正了我上一轮的一处错误归因 |
| `文档与站点索引.md` | 上一版索引（本《总目录》是它的升级替代，保留存档） |
| `线上访问.md` 🆕 | Cloudflare Pages（推荐）/ GitHub Pages / 轻量服务器：合入 `main` 即更新 |
| `本文件：总目录.md` | 你正在看的检索台 |

站点脚手架说明（次要）：各站 `README.md` / `template-info.md`；`claude-code/README.md` 是上游源码树说明（分析对象，非本项目产出）。

---

<h2 id="ref">十一、参考源码树（分析对象，非本项目文档）🗂️</h2>

`参考项目/` 下已检出：`OpenManus` · `suna` · `opencode` · `hermes-agent` · `Raven` · `CodeWhale` · `goose` · `nanobot` · `openworker` · `open-design` · `MiMo-Code` · `MiroFish` · `codex` · **`codepilot`**（op7418/CodePilot @ v0.62.0）· **`pi`**（earendil-works/pi）· **`cline`**（cline/cline，sparse-checkout）· **`kanban`**（cline/kanban @ v0.1.70）· **`codexmonitor`**（Dimillian/CodexMonitor）· **`Easel`**（ZJU-REAL/Easel @ `765f5a6`，gitignored）
本机安装状态（OpenManus 的 venv / Suna 的 Kortix CLI / Docker 等）详见 `文档与站点索引.md` 第三节。

---

## 🚀 启动本地站点速查

```bash
cd "/Users/mikayiyanglin/Documents/Github claude-code/claude code源码分析"
./start-html-previews.sh          # 一键起全部站，末尾会打印总入口
# 然后浏览器打开：
#   html-hub.html   （总入口）
```

| 端口 | 站点 |
|---|---|
| 7200 | OpenManus × Suna 学习站（+ /build-guide.html） |
| 7300 | Claude Code 学习站 v1 |
| 7301 | Claude Code 学习站 v2 |
| 7397 | 从零构建 AI 编程助手 · 指南站 |
| 7400 | 静态总入口 + 两份根目录 HTML |

> 若某站打不开：重跑 `./start-html-previews.sh`；它会自动清端口、起 `vite preview`、等 HTTP 200。日志在 `$TMPDIR/claude-code-html-previews/`。

---

*本总目录由全库重新扫描生成，行数/图数为实测值。新增文档后可让我再跑一次刷新。*