## 2026-09-11 · Wrangler 7003：改推 site 分支给 Cloudflare 接 Git

> 密钥已生效（Token 53、Account ID 32、日志为 `***`），但 `wrangler pages deploy` 报 7003。Account ID 长度正确时，这通常是 Token 没有 Pages 权限或 Token 与账号不是一对。

### Changed
- Actions 把 `_site/` 推到 **`site` 分支**（用 GITHUB_TOKEN，不需要 Cloudflare Token）。
- Wrangler 直传改为可选、失败不挡发布；上传前先探测 Cloudflare API 错误码。
- `线上访问.md`：Cloudflare Connect to Git，生产分支 `site`，构建命令留空。

---

## 2026-09-11 · Deploy 仍失败：Actions 读不到 Cloudflare 密钥

> 站点能打出来；Deploy Cloudflare Pages 立刻红。日志里两项密钥都是空的。

### Changed
- 工作流同时读 **Secrets** 和 **Variables**（两项常被加错页）。
- 失败时打印直达链接 `…/settings/secrets/actions`，以及 Secrets 是否存在（不打印值）。
- `线上访问.md`：必须用仓库 Settings，不是头像底下的 Settings。

---

## 2026-09-11 · 修复 Deploy site：0 秒失败、没有 job

> 用户合入 Cloudflare 发布 PR 后，Actions 三次都是红叉、耗时 0 秒、点进去没有步骤日志。

### Changed
- 删掉 `.github/workflows/pages.yml`（这个文件名会被 GitHub 当成 Pages 发布流；私有免费仓经常启动即拒）。
- 换成 `.github/workflows/deploy-site.yml`：只用 GitHub 官方 Action + `npx wrangler@4` 直传 Cloudflare；PR 上只构建、合入 `main` 才上传。
- 不再推 `gh-pages`（私有仓 github.io 本来也打不开）。

### Catalog
- `线上访问.md` 同步上述步骤。

---

## 2026-09-08 · DeepSeek 招聘页按谷歌方案整体升级

> 用户诉求：按已写的谷歌 Web 优化方案，整体升级招聘阅读器。

### Changed
- **身份：** 去掉奶油纸 / Newsreader / 陶土；白底 `#fff`、字 `#202124`、主色一枚蓝 `#1a73e8`；Roboto + Noto Sans SC
- **列表：** 分类与地点改为横滑 Chip；行高 56dp；选中蓝 50；页面不再 `overflow: hidden`
- **JD：** 技能上提最多 6 Chip；多方向一次只展开一个；「高亮技能」默认关，打开后 `span.hl-term` 铺蓝底，不加【】、不标文化词
- **技能笔记：** 5 张短卡片 + 前 8 技能条；热力图不加回；点条回到筛选
- **a11y：** 搜索/CTA 48dp、跳过链接、`:focus-visible`、减少动效

### Catalog
- 总目录 / html-hub 卡片改为「10 类赛道 · Chip」，不再写「10 色」

---

> 用户诉求：以谷歌 Web 设计师视角，针对当前招聘页的设计与呈现提出优化方案。

### Added
- **`调查报告/DeepSeek招聘页-谷歌设计优化方案.html`**（及 `.md`）：C+ 评审；身份/密度/关键词/a11y；token 与 P0–P2。结论：不要穿 Claude 的衣服，用 Google 的系统穿 DeepSeek 该穿的衣服。

---

## 2026-09-08 · DeepSeek 招聘页改为 Claude Academy 阅读风

> 用户诉求：整页太 technical；改成类似 Claude Academy 的风格，信息密度不要太高。

### Changed
- 暖纸底、Newsreader 衬线标题、陶土强调；职位列表与 JD 加大留白
- 筛选默认收起；技能标签折进「技能标记」；观察页改成一篇笔记（去掉热力图与语言药丸墙）

---


## 2026-09-08 · DeepSeek 招聘页：字体体系 + 分栏阅读 + 关键词标记

> 用户诉求：先做一套好看、好读、少滚轮的字体与版式；再把整个招聘页优化；原文里用粗体 / 斜体 / 【】标出关键词，方便抓住重点。

### Changed
- **`assets/ds-talent.css`**：IBM Plex Sans + 中文系统字体；14px / 1.58；用满屏宽分栏
- **`调查报告/DeepSeek招聘职位技能分析.html`**：JD 拆成使命 / 方向卡 / 职责·要求·加分三栏；分析页收成一屏仪表盘
- 正文关键词：**粗体**硬技能、*斜体*文化协作、【主题词】（CSS 括号）

---

## 2026-09-08 · DeepSeek 招聘站 34 岗完整 JD + 技能量化图谱

> 用户诉求：把 https://talent.deepseek.com/ 全部职位要求摘到一份 HTML；按前端 / 后端 / 大模型训练等框架归类；量化哪些技能出现最多；保留每个岗位完整详情；Tab 切换；一类岗位一种颜色；技能做成可筛选标签。

### Added
- **`调查报告/DeepSeek招聘职位技能分析.html`**：交互阅读器。左侧职位名称（按分类着色分组），点击后右侧显示完整 JD；分类/地点用下拉，技能按需添加。顶栏可切到量化分析。
- **`调查报告/DeepSeek招聘职位技能分析.md`**：文字版对照结论与排名表
- **`调查报告/deepseek-talent-jobs.json`**：从官网 JS 包抽出的 34 岗原文（打包时间 2026-09-07）
- **`scripts/build-deepseek-talent-html.py`** + **`scripts/deepseek-talent-template.html`**：打分类、抽技能、生成 HTML

### Catalog
- `总目录.html` / `总目录.md` / `html-hub.html` 增加入口

---

## 2026-09-10 · 阶段 42：整站一份静态页，Cloudflare Pages / GitHub Pages 合入即上线

> 用户诉求：把整个学习站发到网上，之后每次提交直接上线，方便不同设备打开学习。仓库是私有的，走 **Cloudflare Pages**（`*.pages.dev`）；GitHub Pages 作备用。轻量服务器可镜像同一份 `_site/`，但不能接管 `github.io`。

### Added
- **`scripts/build-site.py`**：把根目录讲义 HTML/MD、`assets/`、`项目分析/`、`调查报告/` 与 Vite 学习站打进 `_site/`。Vite 输出到 `learn/claude-v1` · `learn/claude-v2` · `learn/manus` · `learn/agent-guide`（DeepSeek Harness 站若在仓库里则进 `learn/dsh`）。构建时把 `127.0.0.1:7200|7300|7301|7380|7397|7400` 改成相对路径（源码总目录仍保留本地端口）。
- **`.github/workflows/deploy-site.yml`**：推 `main` 后重建 `_site`，`npx wrangler@4 pages deploy` 到 Cloudflare Pages（已不再使用 `pages.yml` / `gh-pages`）。
- **`wrangler.toml`** + **`scripts/deploy-cloudflare.sh`**：项目名 `kaiyuan-xiangmu-jiexi-zixi`，直传 `_site/`。
- **`线上访问.md`**：Cloudflare 为推荐（私有仓库可公开看）；GitHub Pages / 轻量服务器为备选。
- **`netlify.toml`**：输出 `_site`，Node 22。

### Changed
- `start-html-previews.sh`：默认组装 `_site/`，`:7400` 提供与线上同一份站点。`UNIFIED=0` 可跳过。
- 总目录 / html-hub / AGENTS：线上入口与本机端口对照。

### Note
- `_site/` 不进 git。预期线上地址：`https://kaiyuan-xiangmu-jiexi-zixi.pages.dev/`（Cloudflare）；备用 `https://mikayiyang.github.io/kaiyuan-xiangmu-jiexi-zixi/`
- 仓库目前是私有的：Cloudflare Pages 不要求仓库 Public。需要 GitHub Secrets：`CLOUDFLARE_API_TOKEN`、`CLOUDFLARE_ACCOUNT_ID`。

---

## 2026-09-10 · 阶段 41：Easel 源码分析 + 从零构建教程（社媒内容宿主 · OpenClaw 垂直焊法）

> 用户诉求：深度解析 [ZJU-REAL/Easel](https://github.com/ZJU-REAL/Easel)，拆成 HTML，加入学习站。

### Added
- 稀疏克隆 `参考项目/Easel` @ `765f5a6`（Apache-2.0，v0.1.0，733★，2026-08-28 创建；跳过 `assets/` 宣传视频）
- **`项目分析/Easel-源码分析.md`**（20 章）：OpenClaw 垂直宿主——768 行 Python 整合层 + 2509 行 FastAPI + 112 个可执行 SKILL。核心发现：
  1. **不写主循环**——和 Open Design 同属宿主，但只接 1 个引擎，差异化全在社媒 SOP 与真发
  2. **画像消息内联**，否掉全局 USER.md（并发互踩）与全局 MEMORY.md（跨画像污染）
  3. **对话是控制面、`outputs/<主题>/` 是数据面**；manifest 只当薄索引
  4. **content_guard fail-closed exit 7** vs **persona_gate 永不阻断**——不可逆事故硬拦，人设只提醒
  5. **SSE 断线不杀** + 跨进程 flock + uuid5 钉死 transcript + thinking 自愈——把上游 OpenClaw 的伤口焊进产品表面
- **`从零构建Easel-开发全流程教程.md`**（15 步）：跟着「做一条小红书并发出去」装配 minieasel；附录 15 条验收断言 + 12 个翻车点
- **`Easel-解析.html`**：4 个可交互实验台（提示词四层栈 / Skill 路由 / outputs 门禁 / 出站闸门 BLOCK·WARN）
- `build-html.py` 收录分析 + 教程；总目录 / html-hub 正式卡片

### Verified
- 引用冻在 `765f5a6`；Skill 分层计数 discover 9 / plan 16 / produce 50 / publish 20 / attribute 11 / general 6 = 112
- `build-html.py` 生成分析 HTML（81KB / 20 章 / 6 图）与教程 HTML（36KB / 15 步 / 1 图）；标签配平
- HTTP 200：`Easel-解析.html` · `项目分析/Easel-源码分析.html` · `从零构建Easel-开发全流程教程.html` · 总目录 · html-hub
- 总目录 / html-hub 正式卡片 + AUTO-CATALOG 仅出现 Easel 新增（已重播种 mtime，避免快照机洪水）

---

## 2026-08-13 · 阶段 40：梁文锋技术阶梯行业调研（投行体例 · 可追溯出处）

> 用户诉求：根据梁文锋交流会里「语言模型 → CoT → Agent → 持续学习 → 他称为奇点、随即改口为渐变的自我迭代 → 具身智能」这条技术判断，深度研究他为何这样认知，对照最前沿技术与研究，按顶级投行研究方法论写行业调研分析报告；全部资料有出处；严谨度高；HTML。

### Added
- **`调查报告/梁文锋技术阶梯-行业调研.md`**（544 行）+ 同路径 HTML（讲义风格，约 85KB）
- 与观点提炼稿交叉链接：摘录稿只收原话；本报告只做行业证据、加框推断、证伪条件
- 投行方法落地：one-pager、P1–P5 证据分级、成熟度仪表盘、对照系、Base/Bull/Bear 用「哪一级被解锁」定义、三条证伪条件（F1 世界模型单独抬上限 / F2 不改权重覆盖两月岗位 / F3 先具身反超）
- 六级 SOTA 对照：V3/R1、o1、ReAct、METR 时间视野、EWC/Titans/Nested Learning/SEAL、AlphaEvolve、π₀/OXE/Gemini Robotics/Sora/LeCun JEPA
- 附录完整参考文献表（编号、venue、URL/DOI、证据级、支撑哪条判断）；核不到的不引

### Catalog
- `总目录.md` / `html-hub.html` 增加行业调研入口；观点提炼页导航增加「技术阶梯调研」

---

## 2026-08-13 · 阶段 39：梁文锋投资者交流会观点提炼（中英双语研究报告）

> 用户诉求：根据《梁文锋投资者交流会》录音文字稿，提炼全部主要观点与判断依据，呈现思维链路，贴近原文、不过度解读；讲义风格 HTML；中英两个版本。

### Added
- **`调查报告/梁文锋投资者交流会-观点提炼.md`**（514 行 / 15 章）+ 同路径 HTML（讲义风格）
- **`调查报告/Liang-Wenfeng-Investor-Meeting-Views.md`**（512 行，同结构英文）+ 同路径 HTML
- 主因果链：愿景组织人 → AI 市场过大无法独占 → 必须克制（开源 / 十个月设备回本 ≈ 六倍利润 / 不抢相邻生意）→ 提高做成 AGI 的概率。C 端 / B 端 / API 为副产物。唯一不可退让的核心利益是团队稳定。
- 数字与专有名词按文字稿照录，单列 ASR 风险（DDCP、GCV4、OCE、卡量等）
- `build-html.py`：支持 `lang` / `chips_html` / `toc_eyebrow` / `toc_meta`；子目录 HTML 的 `css_prefix` 按路径计算（不再只认 `项目分析/`）

### Catalog
- `总目录.md` / `总目录.html` / `html-hub.html` 增加中英入口与「我想……」卡片

---

## 2026-08-13 · 阶段 38：DeepSeek Harness 源码分析 + 从零构建教程（一切皆插件 · 241 包名册）

> 用户诉求：按 Claude Code / Open Design 的解析深度与颗粒度分析 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness)，着重工程思维、创新性、技术闪光点，多种思维导图，宏观—微观技术栈；出一份源码分析 HTML + 一份从零构建教程 HTML，风格用全站最新讲义风格。追加要求：**150+ 个插件逐个介绍解读 + 它们如何互相配合**，最后统一验收核查两份 HTML 并并入主站。

### Added
- 浅克隆 `参考项目/deepseek-harness` @ `47f9438`（`v0.1.0-rc.5`，MIT，PR #2519 合入当日）
- **`项目分析/DeepSeek-Harness-源码分析.md`**（**2 692 行 / 33 章 / 8 大 Part / 11 图 / 82 表**）。核心发现：
  1. **没有特权内核**——模型适配器、工具注册表、会话日志、**乃至 agent 循环本身**都是插件（`docs/architecture.md:11,13`）；改循环的门槛被抬到"要改架构文档"
  2. **Cordis 五观念**：插件即 Service / context 是服务仓库 / `inject` 表达加载顺序（**替掉手工启动顺序表**）/ Typed Events 四种 dispatch / 注册是可逆 effect
  3. **capability seam 三角色**（Definition / Provider / Consumer，缺一不成缝）；`fs` + `subprocess` 是原语，**换两个 provider 就把 bash/PTY/LSP/搜索/code-runtime 一起搬到远程**（`packages/e2b` 是实证）
  4. **turn/step 两级边界** + `agent/turn-stopping` 的「公告—异议」模式：不改循环让循环继续；`max-tokens` sticky；零 step 的 turn 也进日志
  5. **工具流水线三道 waterfall + 单调守卫 + 冻结结果**：守卫返回类型里**没有 `allow`**，数学上无法被后续插件提权；`tools/result` 是 `emit` + `Readonly` + `Object.freeze` + 运行时不变量
  6. **模型可见 ⟺ 已记录**：不变量做成**逐包所有权的注册服务**，**`dsh-invariants` 被 218/241 个包依赖（90%）**，且规定"不许写假装在检查的断言"，没得可查时必须导出以 `No runtime invariant:` 开头解释的空 installer
  7. **工程制度**：逐文件 100% 覆盖率（**把未覆盖行当死代码信号**）· 28 个 `verify-*` 门禁（含强制每包 README 写"局限"与"模型体验"）· 124 个 scripts（门禁自己也有 `.spec.ts`）· 8 177 行生成文档 · **686 篇双轴分类 Agent Notes**（连"不要加索引"都有一篇）
  8. **Part VI 全名册**：241 个包逐个列出角色 / `ctx` 键 / 注入 / 工具 / 行数 / **源码 `@module` JSDoc 原文职责**，按六大功能域组织 + 依赖入度分层图 + **一次 turn 的 19 个插件接入时刻表** + 三条典型装配链路
- **`从零构建插件化AgentHarness-DeepSeekHarness系-开发全流程教程.md`**（**2 369 行 / 20 步 / 8 图 / 59 代码块**）：造一个 ~700 行 `minidsh`，每步「为什么 → 最小实现 → 怎么验收 → 真实 dsh 在哪儿」，每步都先问一句"写在 `main()` 里会怎样"；附验收断言表、14 个翻车点、源码对照索引
- 两份 HTML（讲义风格）：`项目分析/DeepSeek-Harness-源码分析.html`（290KB）、`从零构建插件化AgentHarness-DeepSeekHarness系-开发全流程教程.html`（155KB）
- **可复现的分析工具链**（`scripts/`）：
  - `dsh-plugin-census.py`——241 包全量普查（包名/角色/`ctx` 键/`inject`/工具/行数/`@module` JSDoc/包间依赖），输出 JSON
  - `dsh-roster-gen.py` / `dsh-roster-insert.py`——名册 Markdown 生成与幂等插入（52 组按六域重排）
  - `verify-citations.py`——**通用引用验证器**：解析文档里所有 `文件:行号`，检查文件存在、行号在范围内、且**该行非空**（空行几乎总意味着引用漂移）

### Fixed（验收阶段发现并修正）
- **行号漂移 40 处**：首版部分 `docs/*.md` 行号是按阅读顺序推断的而非逐行 grep。用 `verify-citations.py` 全量核查后逐条修正（如 `architecture.md:107`→`:100`、`cordis-primer.md:12`→`:10`、`testing.md:25`→`:29`），修正过程记录在 `scripts/dsh-fix-citations.py`。**最终 82 处引用全部验证通过**
- **正文 h1 无样式**：`lecture-site.css` 只定义了 `.hero h1`，两份文档正文里的 14 个 Part 标题会退化成浏览器默认样式 → 给全站设计系统新增可复用的 **`.part-band` 分区带**（靛蓝/teal 渐变 + 等宽眉题），并让 `structure_into_parts()` 把它输出在 `.part` 卡片**之间**而非卡片内部
- **名册表格横向溢出**：7 列布局把最有价值的"它做什么"列挤出视口 → 重排为 5 列（包 / 角色 / **它做什么** / 接线 / 行数），角色用 `Def`/`Prov`/`Tool` 缩写、`ctx`+注入+工具合并进"接线"列。实测 `scrollWidth == clientWidth`，不再溢出
- `build-html.py`：附录解析正则放宽为 `附录 [A-Z]`（此前只认 A/B/C）

### Verified
- **浏览器实测**（127.0.0.1:7500）：分析页 11 图全部渲染、教程页 8 图全部渲染、**mermaid 错误 0**；8 + 6 个分区带文本正确；82 表格 585 行；0 个溢出表格；侧栏 37 条锚点与 `ch1`–`ch33` 一一对应
- **名册完整性**：52 组声明包数 241 = 实际数据行 241，零不匹配
- **引用完整性**：`verify-citations.py` 对两份文档 82 处引用全绿

### Fixed（四路源码勘探回核，对照 `47f9438`）
1. **`inject` 投递口**：不是 next-turn，是 **next-step 且不 wake**（`agent.ts:130-132`）；inbox 先 `agent/inbox/spliced` 再改投影
2. **goal 续跑**：不是 `agent/turn-stopping`；`goal-round-driver` 在 idle + armed 时 `followup`。`turn-stopping` 只服务同 turn 内 `steer`
3. **沙箱**：Linux **bwrap→Landlock**；darwin **Seatbelt**；win32 **windows-acl**。Landlock 是 **C11** 启动器，不是 N-API addon
4. **无 `packages/self-modification/`**：能力在 `packages/extensions/{tool-cordis,cordis-host-runner,…}`；`AGENTS.md` 与 vitest exclude 仍列旧路径
5. **`llm/stream` 不变量**：冻结请求后 `deriveMessages()` 必须等于 `options.messages`
6. **`packages/guard`**：只有 `repeat-tool-reminder` 与 `timeout-policy` 两个子包

---

## 2026-08-12 · 阶段 37：DeepTutor 源码分析（港大 HKUDS · 终身辅导运行时）

> 用户诉求：按同样思路与框架分析 [HKUDS/DeepTutor](https://github.com/HKUDS/DeepTutor)，输出 HTML，并汇总到总目录。

### Added
- 浅克隆 `参考项目/DeepTutor` @ `456f9c2`（tag `v1.5.11`）
- **`项目分析/DeepTutor-源码分析.md`**（701 行 / 18 章 + 附录 A/B/C）：动机 → 约束 → 被否方案 → 选择 → 代价 五段式；核心发现：
  1. **切换目标不换引擎** — `ChatOrchestrator` + 7 Capability + LoopCapability/KnowledgeCapability
  2. **双轨主循环** — Chat `AgentLoop`（无工具即收工）× `run_agentic_loop`（Label 协议）
  3. **L1/L2/L3 可审计记忆** + footnote 溯源；Partners 16 IM；Subagent 把编程 CLI 当会诊 KB
- **`项目分析/DeepTutor-源码分析.html`**（Claude blog 版式，~53KB）
- `build-html.py`：新增 DeepTutor CONFIG；`CLAUDE_BLOG_THEME` 支持可配置 `chips`；`ROOT` 改为相对脚本目录（修复跨机器硬编码路径）
- `总目录.md` / `总目录.html` / `html-hub.html`：intent 卡、静态 HTML 卡、项目分析卡、Hub 卡四处入库

### Verified
- 对照 `参考项目/DeepTutor @ 456f9c2`：`orchestrator.py` / `agent_loop.py` / `loop.py` / `tool_composition.py` / `memory/paths.py` / `subagent/registry.py` / `partners/channels/registry.py` 等关键路径行号

## 2026-08-13 · 阶段 37b：DeepTutor 分析第二轮回核（换模型审核验收）

> 用户诉求：换一个模型审核验收上一轮成果，不准确的直接优化，漏掉或解析不完整的一并补齐。

### Fixed（事实纠错）
1. **`preferences.md` 写入语义**：上一版称「模型不能改写」→ 更正为「不进自动综合（`store.py:153-154` 显式 `raise`），但 `write_memory` 经 `write_preference` 幂等窄门可写（`store.py:194-250`，含 issue #647 的重复防护）」
2. **插件层数**：上一版沿用 `AGENTS.md` 的「两层插件」→ 更正为**三层**，补齐 `LOOP_CAPABILITIES` 5 个成员（mastery / solve / obsidian / subagent / explore_context），并说明 mastery/solve 的 **L2+L3 双身份**
3. **行号校正**：`README_CN.md:58-67`→`60-62`；`AGENTS.md:28-29`→`27-28`（StreamBus）与 `28-30`（settings 真源）；`orchestrator.py:36-86`→`36-114`

### Added（补齐承重墙，18 章 → 24 章）
- **第 10 章 deferred tools**：`load_tools` 渐进披露；MCP 工具默认 deferred；源码自称"可测量地改善弱模型工具选择"（`runtime/registry/deferred_tools.py:1-16`）
- **第 11 章 Provider 兼容层**：36 个 `ProviderSpec`（11 网关）的**能力位**表 · `request_compat` 错误分类器驱动优雅降级 · **DSML 文本工具回退**（DeepSeek 不宣告 function calling 时把工具调用写进 content，不解析就会当答案流给用户，issue #666）
- **第 14 章 确定性骨架 vs 模型判断**：Mastery 5 / Solve 3 / Obsidian 9 工具组注释里的同一句哲学——「chat loop IS the tutor/solver」，算术与门禁沉进工具，教学法与推理留给模型
- **第 15 章 ExploreContext**：两条 bug 级动机（附件是别的 AI 对话记录时模型会**串味成那个 agent 的第一人称**；弱模型**根本不调用 `read_source`**）→ 独立客观只读前置 pass + 从答案循环移除该工具
- **第 18 章 工具生态四条腿**：MCP 每服务器专用连接任务（anyio cancel scope 任务绑定）· 101 个 CLI Apps 钉在已审 commit `bc536c9`、无 pin 则拒绝安装 · **沙箱三后端两级隔离**（SYSTEM 全员 / APPLICATION 仅管理员）+ 逐用户配额 · Codex OAuth 用 ChatGPT 订阅
- **第 19 章 可重放 turn 协议 + 多用户授权矩阵**：单 `/api/v1/ws` 的 11 种消息（`after_seq` 重放 / `resume_from` / `regenerate` + overrides / 陈旧 running 自愈）· `multi_user/` 14 模块逐资源 grants v2
- 精确计数入库：7 用户可开关 + 15 情境自动挂载工具、36(11) provider、5 RAG 引擎、16 IM 频道、7 subagent 后端、101 CLI apps、33 REST router、**四种记忆综合模式**（`merge` 不用 LLM）
- 补充细节：Chat 循环截断续写与空 finish 轻推、Label 协议 `final`⊥`terminal`、标签解析容错、整数脚注 + `<!--m_xxx-->` 锚点、`context_budget` 只报"真实发出那次请求"的占用
- 新增**附录 C 回核修订清单**（12 条）与附录 D 范围声明；附录 A 指纹表扩为可逐条复核的数字表，24.2 节给出复核命令

### Changed
- `项目分析/DeepTutor-源码分析.md`：701 行 / 18 章 → **1 144 行 / 24 章 + 附录 A–D**
- `项目分析/DeepTutor-源码分析.html`：~53KB → **110KB**（24 章锚点 + 4 附录 + 6 图，侧栏分区 3/3/14/4）
- `build-html.py`：附录解析正则 `附录 [ABC]` → `附录 [A-Z]`（支持附录 D）；DeepTutor CONFIG 的 stats/chips/dek 同步更新
- `总目录.md` / `总目录.html`：卡片描述与规模标签同步为「1144 行 · 24 章（已回核）」

---

## 2026-07-23 · 阶段 1：Claude Code 源码科普起步

### Added
- **《Claude-Code-工作原理科普.md》**（v1 初版）：基于 `claude-code/` 源码的三路并行调查（启动与输入处理 / 核心 agent 循环 / 工具与权限系统），面向计算机小白的 10 章科普，含 10 张 Mermaid 图，关键结论均标注 `文件:行号`
- 深入解答"输入分拣台如何工作"：证实为纯字符串规则匹配（首字符 `!`/`/`、退出词名单 `.includes()`、命令表精确匹配），零 AI 参与，并补入文档 4.4 节
- 深入解答"CLAUDE.md 与上下文组装规则"：5 来源收集顺序（Managed→User→项目逐级向上→--add-dir→自动记忆）、`@导入` 递归安全闸门、`<system-reminder>` 伪装首条用户消息等，补入文档 5.1/5.2 节

## 2026-07-23 · 阶段 2：深入版重写与网站 v1

### Added
- **《Claude-Code-工作原理科普-深入版.md》**：全文按"4.4/5.1/5.2"颗粒度标杆重写，约 9200 字正文、20 张 Mermaid（流程图/时序图/状态图混用），多情形例子（7 种输入命运、4 种命令权限判决、"找 TODO"三圈循环轨迹）
- **`claude-code-learn/`（网站 v1，苹果官网风）**：React+TS+Vite+Tailwind+shadcn。10 章节 + 3 个核心交互（LAB 01 Prompt 旅程模拟器 / LAB 02 Agent 主循环可视化 / LAB 03 权限闸门演示），`npm run build` 通过

## 2026-07-23 · 阶段 3：网站 v2（蓝皮书版）

### Added
- **`claude-code-learn-v2/`（网站 v2）**：参考 workbuddy.homes 提取的设计系统——纸面 `#f5f7f0` + 酸性黄绿 `#d8f238` + Silkscreen 像素字体 + 1px 墨框硬偏移阴影；教程蓝皮书结构（Hero 统计行 / READING PATH 四段路径 / 问题入口卡 / CH. 章节编号 / MasteryPath 进阶路径），内容与 v1 对齐，v1 保留并存

## 2026-07-24 · 阶段 4：四大板块全面扩充

### Added（三路源码调查后同步到全部三份成果）
- **调查报告/**：`01-工具盘点.md`（43 工具逐一）、`02-核心功能组件盘点.md`（插件/技能/MCP/认证/effort 等）、`03-斜杠命令盘点.md`（60+ 命令+12 深度剖析）
- **深入版 MD 扩至 14 章、36 张 Mermaid**（净增约 4.9 万字符）：新增第八章工具图鉴 / 第九章斜杠命令图鉴 / 第十章生态组件 / 第十一章功能特性拆解；原章节顺延，目录/交叉引用/附录索引/结语学习路线同步
- **v1、v2 网站**：同步新增 ToolAtlas（43 工具可筛选画廊）、CommandAtlas（可搜索命令表+8 深度剖析卡+自定义命令教程）、EcosystemSection（插件/技能/MCP 对比）、FeaturesSection（effort/认证/fallback/权限六档/outputStyles/记忆）

## 2026-07-24 · 阶段 5：五大开源 Agent 源码分析

### Added
- **`参考项目/`**：浅克隆 opencode（62e4641）、hermes-agent（d9165d7）、Raven（85c7a5b）、CodeWhale（88a158e）、goose（d17d65f）
- **`项目分析/` 五份单项目分析**（同一 12 章框架、各 8000-15000 字、12-19 张 Mermaid、全部标注 commit 与 `文件:行号`）：
  - `opencode-源码分析.md` — "服务器即本体"、Effect 全栈、可教导拒绝
  - `hermes-agent-源码分析.md` — 前缀缓存神圣、闭环学习五件套、74 工具极端插件化
  - `Raven-源码分析.md` — Spine 调度脊骨、Curator 无损上下文、EverOS 双轨记忆
  - `CodeWhale-源码分析.md` — Rust 单二进制、safe by construction、provenance 降级
  - `goose-源码分析.md` — 一切皆 MCP 扩展、引擎即服务器（ACP）、动静分离上下文
- **`项目分析/横向对比与总结评价.md`**：约 1.2 万字、11 张对比表、10 张 Mermaid——速览总表（6 列含 Claude Code 基准列）+ 10 维度逐项对比 + 五场"思路对决"（权限路线/上下文哲学/生态开放度/架构形态/模型策略，各含利弊与"适合谁"）+ 初学者选型建议

## 2026-07-24 · 阶段 6：交接与两站整合

### Added
- **`handoff.md`**：零上下文交接文档（工作区地图/已完成清单/两站设计系统规格/剩余任务执行说明/验证流程/交付格式）
- **两站新增「开源 Agent 大观园」大区**（由外部 agent 按 handoff 完成，本次验收通过）：
  - 区首 + 5 个项目章节（opencode/hermes-agent/Raven/CodeWhale/goose 各一章：定位、架构、主循环、工具、权限、压缩记忆、生态、3 个最独特设计点）
  - ComparisonSection 横向对比（速览总表 + 10 维度逐项对比）
  - VerdictSection 总结评价（五场思路对决 + 选型建议 + 决策图）
  - TechDeepSection 技术深潜（额外新增）
  - v1 导航同步；v2 升级为 **18 CHAPTERS / 6 PARTS**（PART 06 · CH.15—18 + 对比/深潜/评价），Hero 统计、READING PATH、MasteryPath 同步

### Verified（2026-07-24 验收）
- v1/v2 `npm run build` 均成功（仅 chunk 体积提示，无错误）
- 构建产物关键事实词条核验通过：opencode/hermes-agent/Raven/CodeWhale/goose、服务器即本体、前缀缓存、Spine、Curator、constitution、一切皆 MCP、可教导拒绝、provenance、GooseMode、思路对决等 16 组词条全部命中
- v2 编号核验：Hero `18 CHAPTERS · 6 PARTS`、PART 06 分隔带与导航一致
- 两站临时 dev server 冒烟测试 HTTP 200、标题正确，验证后端口 7395/7396 均已释放，无残留进程

## 2026-07-24 · 阶段 7：nanobot 源码分析与整合

### Added
- **`项目分析/nanobot-源码分析.md`**：港大 HKUDS Xubin Ren，MIT 开源，Raven 上游底本。同一 12 章框架，约 12000 字、13 张 Mermaid。核心要点：显式状态机 `_TRANSITIONS`（AgentLoop/AgentRunner/COMMAND 三路状态表）、MessageBus 双队列解耦门市与后厂、Dream 夜间受限 agent 反思（SOUL/USER/MEMORY）、~40 家自研 provider 注册表（直连 openai/anthropic SDK、无 LiteLLM）、ClawHub 技能市场、bwrap 沙箱
- **两站（v1/v2）** 新增 nanobot 项目章节：`projects.ts` 加 nanobot 条目（index '06'）；`comparison.ts` COMPARE_PROJECTS 加第7列（7→7 列），所有 OVERVIEW_ROWS 和 COMPARE_DIMENSIONS 10 个维度均加 nanobot 行；`verdict.ts` ONE_THING_EACH 加第7条，沙箱派阵营加 nanobot，PERSONA_ADVICE/DECISION_BRANCHES 同步更新
- **`项目分析/横向对比与总结评价.md`** 扩至七大项目（含 nanobot）

### Verified
- v1/v2 `npm run build` 均通过

---

## 2026-07-24 · 阶段 8：grok-build 源码分析与全面整合

### Added
- **`项目分析/grok-build-源码分析.md`**：xAI 官方 CLI（马斯克），Apache-2.0，Rust 60+ crate monorepo，22.2k Stars。同一 12 章框架，13 张 Mermaid，全部标注 `文件:行号`。核心要点：
  - **Goal Mode 五件套**：GoalTracker（3 GoalPhase / 8 GoalStatus）、GoalPlanner（fail-closed，必须写非空 plan.md 并返回字面 "Done"）、GoalWorker（执行）、GoalClassifier（验证）、GoalStrategist（fail-open，PlanGuard RAII 保护）；GoalStopDetector 9 类正则匹配最后段落防过早退出；UpdateGoalTool 是完成信号
  - **ACP 协议**（xai-acp-lib 独立 crate，Zed 编辑器集成）
  - **DotSlash 工具链锁定**；Tokio 异步；Ratatui TUI；MiniJinja 模板引擎
  - **权限系统**：六档 PermissionMode + LLM 分类器（PermissionClassifier，Auto 模式 3 次连续/20 次总量上限后强制弹窗）；tree-sitter bash AST 解析（permission/manager.rs 8759 行）
  - **CompactionPolicy**：85% 阈值，两轮压缩（Pass1 推测性后台 + Pass2 正式），wall_clock_budget_secs=300
  - **WorkflowManager**：最多 4 并发 workflow
  - **MCP Dispatcher**：50ms 滚动窗口 + last-write-wins + auto-restart
  - **AgentDefinition**：30+ 字段 YAML frontmatter + Markdown body；AgentBuilder 10 步构建
  - **独有工具**：ImageGenTool / ImageEditTool / ImageToVideoTool / ReferenceToVideoTool（多媒体）、SchedulerCreateTool / SchedulerDeleteTool / SchedulerListTool（定时任务）
  - **Plugin Marketplace**：Git/GitHub/本地来源，allowlist + InstallRegistry commit hash 防篡改
  - **JJ (Jujutsu) VCS 支持**（extensions/jj.rs，xAI 内部工具链）

- **两站 v1/v2 全面整合 grok-build**：
  - `projects.ts`：加 grokbuild 条目（index '07'），含 architecture.dirs / mainLoop.refs / tools.specials / permission.points / ecosystem / uniques 完整数据
  - `comparison.ts`：COMPARE_PROJECTS 加第8列；OverviewRow.cells 扩至 8-tuple；所有 7 个 OVERVIEW_ROWS 和 10 个 COMPARE_DIMENSIONS 全加 grokbuild 行；OVERVIEW_TAKEAWAYS 更新为"八家"，说明两家"锁定做深"
  - `verdict.ts`：权限对决新增"LLM 分类器派"阵营（grok-build）；模型策略"锁定做深"扩为 CC + grok-build；ONE_THING_EACH 加第8条（Goal Mode 五件套显式状态机）；PERSONA_ADVICE 加 Grok 用户路线；DECISION_BRANCHES 加 grok-build 日常使用与学习路线；注释"七家"→"八家"
  - `ProjectDiagrams.tsx`（v1/v2）：新增 GrokbuildDiagram 组件（可视化五件套架构）并注册到 PROJECT_DIAGRAMS

- **`项目分析/横向对比与总结评价.md`** 升级为八大 Agent：
  - 标题、引言、速览总表（新增第8列 grok-build）、"三件事"关键点全部更新
  - 象限图新增 grok-build 节点（[0.10, 0.25]，锁定厂商 + 终端程序象限）
  - 2.1–2.10 十个维度表各加 grok-build 行（架构/主循环/工具/权限/压缩/记忆/子agent/生态/模型认证/缓存）
  - 权限路线流程图新增 ⑤ LLM 分类器派
  - 对决一（权限）更新解决方式比对 + 利弊 + 评价，加入 LLM 分类器派
  - 对决五（模型策略）更新为"两家锁定做深"（CC + grok-build），prosCons 和 verdict 同步
  - 第六章选型建议：读源码路线加 grok-build Goal Mode；日常使用加 Grok 用户推荐；二次开发加 Goal Mode 研究方向；本地模型说明 grok-build 不适合
  - 决策图、mindmap 均更新（"七家" → "八家"，mindmap 加第8条）
  - 写作说明更新为八份分析

- **`从零构建AI编程助手-开发全流程教程.md`** 新增第9章：
  - **第9章「如果最终目标是客户端——还需要哪些模块」**（10个小节，约3000字）：
    - 9.1 界面层（终端/网页/桌面三路选型表）
    - 9.2 流式展示（SSE/WebSocket 打字机效果实现难点）
    - 9.3 代码高亮与 Diff 视图（Shiki / Monaco Editor）
    - 9.4 动画与过渡效果（Framer Motion / GSAP）
    - 9.5 状态管理（useState → Zustand → 薄客户端）
    - 9.6 多面板布局与快捷键（react-resizable-panels / hotkeys-js / 命令面板）
    - 9.7 主题系统（CSS 变量 + Tailwind dark:）
    - 9.8 终端模拟器（xterm.js + ANSI 转义）
    - 9.9 桌面打包（Electron vs Tauri vs PWA 对比表）
    - 9.10 小结（额外工作量估算：2–4 倍，分项工期表）
  - 原第9章（术语总表）→ 第10章；第10章（知识树）→ 第11章；第11章（结语）→ 第12章
  - 第0章使用说明同步更新目录描述

- **`build-an-agent-guide/src/content/chapters.ts`** 新增 client 章节：
  - id='client'，no='08'，title='如果目标是客户端：还需要哪些模块'
  - 含 p / h3 / table（×2）/ ul（×3）/ callout（×2）等 10 个 block
  - outro 的 no 从 '08' 改为 '09'

### Verified
- v1/v2/build-an-agent-guide 三个网站 `npm run build` 全部通过，无 TypeScript 错误，无运行时错误

---

## 2026-07-24 · 阶段 9：OpenManus × Kortix/Suna（Manus 系）双线精读

### Added
- **`参考项目/OpenManus`**：浅克隆 FoundationAgents/OpenManus（分析基线 commit `52a13f2a`）
- **`参考项目/suna`**：完整检出 kortix-ai/suna（~257MB；分析基线 `5862e956` / VERSION `0.10.14`），含 Web / desktop / mobile / packages
- **`项目分析/OpenManus-源码分析.md`**（加深版 ~1546 行 / ~84KB）：同一 12 章框架；厚写第 5–7、9 章；揭开 `state_context` finally 回滚陷阱、browser_use 调研闭环、`terminate` 一等退出、PlanningFlow 全路径（unstable）
- **`项目分析/Suna-源码分析.md`**（完整检出加深版 ~1142 行 / ~64KB）：平台 lifecycle ≠ OpenCode ReAct；`session_id == sandbox_id == branch`；Web `useSession(..., { chatEngine:false })`；Executor 守秘；CR 全路径；manifest-schema；OpenCode pin `1.17.11`
- **`项目分析/OpenManus-vs-Suna-横向对比.md`**：产品轴心对齐、主循环位置分野、许可（MIT vs Elastic 2.0）、选型与组合思想
- **`openmanus-suna-learn/`**（学习站 v1，苹果官网风，预览端口 **7200**）：Hero → 概念 → 双项目导读 → 项目章节 → 对比 → 选型 → 从零构建 → 收束；内容数据 `src/content/projects.ts` / `comparison.ts` / `verdict.ts`
- **`从零构建通用任务Agent-Manus系-开发全流程教程.md`** + 根目录 / `openmanus-suna-learn/public/build-guide.html`：组合两者思想的从零构建路线（第一关 OpenManus 式心脏 → 第二关 Kortix 式工位/治理）

### Changed（同日细化）
- **学习站内容加厚**：
  - 新增 `TechDeepSection` + `src/content/techdeep.ts`（10 张硬货卡 + 建议阅读顺序）；导航增加「深潜」
  - `BuildSection` 改为两关路线图（`src/content/build.ts`：阶段 / 黄金题 / 反模式）并链到 HTML 教程
  - 概念区、Hero CTA、对比总表（增「易踩坑」行）、选型文案、收束入口按加深版分析同步
- **从零构建教程加厚**：MD 约 172 → **379 行**（目录骨架、伪代码、十二周 checklist、工具生长、状态机、痛点升级表、双轨对照阅读）；HTML 两份同步再生

### Verified
- `openmanus-suna-learn`：`npm run build` 通过；`learn/manus/` 与 `/build-guide.html` 冒烟 HTTP 200

### Changed（同日 · 从零构建深挖）
- **`从零构建通用任务Agent-Manus系-开发全流程教程.md`** 重写为**积木 A–O 深挖版**（约 380→650+ 行）：每积木含接口契约、对照 `文件:行号`、实现要点、翻车点、机检断言；周计划降为编排层
- **学习站 `BuildSection`**：积木索引网格 + 两关文案对齐 A–O；`build.ts` 同步；`build-guide.html` 再生

---

## 2026-07-24 · 阶段 10：Manus 系材料全面优化（可读性 + 配图 + 逻辑对齐标杆）

> 用户反馈：OpenManus/Suna 分析与从零构建教程"可读性差、逻辑不清晰、缺配图"。以《Claude-Code 深入版》为标杆，回读两项目源码重核事实后统一优化。核心决策：弃用"积木 A–O"字母块结构，改为"跟着一个真实任务从头走到尾"的叙事主线；配图按知识点重要性放，非机械凑数。

### Changed（从零构建教程 · 推倒重写）
- **`从零构建通用任务Agent-Manus系-开发全流程教程.md`**：积木 A–O 深挖版 → **跟着一个任务走**（用户说"帮我总结这个网址"，从白纸开始每撞一堵墙补一个零件）。854 → **1037 行**；**0 → 12 张 Mermaid**（全景装配图、"模型点单 vs harness 动手"概念图、主循环、调研闭环、剧本 α 完整回放时序图、第二关四件等）；保留深度：23 条可跑验收断言、33 处 `文件:行号`
- 结构：先看终点（全景图）→ 第 0–10 步跟任务 → 完整回放 → 第二关（痛点触发）→ 附录（排期/黄金题/翻车/索引）

### Changed（三份分析 · 针对性增强，保留原有准确内容与图）
- **`OpenManus-源码分析.md`**（9 → 11 图）：第 6 章新增"调研京都→产出 HTML"四圈完整演示（轨迹表 + 时序图，含 Manus 浏览器**动态换页**机制）；第 7 章新增**权限闸门对照图**（OpenManus 近乎直通 vs 编程 Agent 有闸门）；补 5 条"🧠 一句话"金句 + 第 6 章"🔍 源码指路"索引
- **`Suna-源码分析.md`**（6 → 8 图）：第 6 章新增"一句 Slack 消息 → 待审 CR"**三循环接力**演示（表 + 流程图）；第 7 章新增 **Executor 密钥边界图**（沙箱只有 scoped token，真凭证锁在 API 进程）；补 5 条金句 + 第 6 章源码指路
- **`OpenManus-vs-Suna-横向对比.md`**（1 → 2 图）：新增**"我该选哪个"决策流程图**（选型建议可视化）+ 金句；**修正过期事实**——架构表 Kortix 前端"分析站稀疏未检" → "Web Command Center 完整检出"

### Fixed（验证时发现的既有缺陷）
- **修复两张一直渲染失败的 Mermaid 图**：OpenManus 第 3 章启动时序图、以及重写初稿的回放时序图——均因参与者命名撞上 mermaid 保留字 `Loop`（`loop...end` 块）导致解析崩溃。"渲染不出的图 ≈ 没有图"，正是"缺配图"反馈的一部分。全库复查保留字（Loop/End/Note/Alt/Rect）归零
- **清除教程 HTML 生成器的调试残留**：正式版网页标题不再被写成 `HTML_OK_12`，恢复正常标题

### Changed（教程网页版 · 重新生成）
- **`从零构建通用任务Agent-Manus系-开发全流程教程.html`** + **`openmanus-suna-learn/public/build-guide.html`**：旧积木 A–O 版（40KB，零图）→ 新叙事全文（76KB），**12 张 Mermaid 预渲染为内联 SVG**（marked + mermaid，离线/任意浏览器可看），保留苹果风样式

### Changed（学习站 · 从零构建区同步）
- **`openmanus-suna-learn/src/content/build.ts`**：积木 A–O → 跟任务走的 10 零件 + 第二关 4 件（`BUILD_BLOCKS` → `BUILD_PARTS`，附 `gate2` 分色标记）；`BUILD_PHASES`/`BUILD_ANTI`/`BUILD_GOLDEN` 同步改写
- **`src/sections/BuildSection.tsx`**：清除全部"积木"字样（眉题/标题/索引/CTA 5 处）；零件卡按"第 N 步"编号、第二关卡蓝色高亮；CTA 改"打开完整教程（含 12 张机制图）"

### Verified
- **四份 MD 全部 Mermaid 逐张用真实引擎渲染**：教程 12 / OpenManus 11 / Suna 8 / 横向对比 2，合计 **33 图 0 失败**（含新增/修复 7 图）；关键图（harness 概念图、主循环、调研闭环、回放时序、密钥边界、决策流程）单独放大目检
- **教程 HTML**：渲染报告 `{ok:12, fail:0}`，标题正常
- **`openmanus-suna-learn`**：`npm run build` 通过（tsc 无错）；dev（:7397）冒烟 HTTP 200、`/build-guide.html` HTTP 200 且 `{ok:12,fail:0}`；从零构建区分段截图目检（零件卡绿/蓝分色、两关分步、黄金题/反模式、CTA 全渲染正确）；端口 7397/9222 释放，未触碰 Kimi 的 7100/7101；dist 产物一致

---

## 2026-07-28 · 阶段 11：Open Design 专线（第十个样本 · 宿主型 Agent）

> 本阶段的分析对象是一个**新物种**：`nexu-io/open-design`（commit `c893b60`，Apache-2.0，2026-04-28 创建，**三个月 82.0k star / 9.5k fork**）。它是 **Claude Design 的开源替身**，但工程上最反直觉的一点是——**它一行 Agent 主循环都没写**，而是把 `claude` / `codex` / `cursor-agent` / `opencode` / `hermes` 等 **25 个本地 CLI 当成自己的执行引擎**。也就是说，它不是这个系列里的第十个竞争者，而是**这张桌子本身**。

### Added（源码分析）
- **`项目分析/open-design-源码分析.md`**（**1858 行 / 13 图 / 126KB**，本系列最大的单项目分析，超过原纪录 OpenManus 89KB 达 41%）：因为分析对象是「宿主」而非 Agent，把统一的 12 章框架**扩展到 18 章 / 5 个部分**——
  - **一 它是什么**（1 不写主循环的产品 · 2 四进程/四类内容/一条 SSE · 3 三种形态与「数据根契约」）
  - **二 适配器层**（4 `RuntimeAgentDef` 是数据规格不是类 · 5 探测与能力协商 · 6 四种流格式 · 7 两档执行画像）
  - **三 上下文工程**（8 六个创建面 × 七种 mode · 9 `composeSystemPrompt` 二十层与缓存分区 · 10 三条硬规则 · 11 记忆与双环）
  - **四 内容与闸门**（12 内容四平面 · 13 程序化反 AI 味 linter · 14 五陪审评审剧场 · 15 插件与原子）
  - **五 边界与总结**（16 安全边界 · 17 功能特性拾遗 · 18 三个独特设计与三处取舍）
  - 附录 A 源码导览索引（22 条）+ 附录 B 关键文档索引（10 份，含对 upstream 文档质量的评点）
  - 统计数字（11 745 文件 / 321.9 MB / 26 条运行时定义 / 151 个设计系统包 / 164 个技能 / 277 个官方插件）由 **GitHub Git Tree API 全量遍历计算**，非估算

### Added（从零构建教程 · 路线 D）
- **`从零构建AI设计Agent-OpenDesign系-开发全流程教程.md`**（**1964 行 / 13 图 / 105KB**，本仓库最大的构建教程，是原纪录 Manus 系 52KB 的两倍）：叙事主线「跟着**一句话**——"帮我们做一个 SaaS 落地页，用我们公司的品牌"——从白纸走到成品」，**17 步**分五个部分（A 决定不写 Agent → B 接住引擎 → C 给它剧本 → D 装闸门 → E 装成产品），每步一个可验收的零件
- 附录：**30 条验收断言**（做完每步怎么验，含"把 `claude` 移出 PATH 只有它变灰""紫渐变+🚀+lorem ipsum 应报 3 条 P0""`letter-spacing: var(--tracking)` 且 `--tracking: 0.08em` 不应误报"等可执行判据）+ **十二个最容易翻的车**（每条含症状/根因/修法）+ 源码对照索引（37 条）

### Added（交互学习站 · 两个新站，苹果 UI 交互 + Claude blog 页面组织）
- **`open-design-解析.html`**（100KB，18 章 / 12 图）+ **`从零构建AI设计Agent-OpenDesign系-开发全流程教程.html`**（89KB，17 步 / 12 图）
- **共享设计系统 `assets/od-site.css`**：交互与质感取自 Apple 官网（毛玻璃吸顶导航、`clamp()` 大标题 + `-.034em` 字距、极轻描边、`cubic-bezier(.22,1,.36,1)` 缓动、IntersectionObserver 滚动淡入、segmented control、iOS 风开关）；页面组织取自 Claude blog（眉题 + 长标题 + 摘要 dek + 元信息 chip 行 + 左侧粘性目录 + 720px 单栏正文 + 图注 + 黏土色拉引）；黏土强调色 `#c96442` 只用于眉题/编号/引文边框
- **四个可交互实验台**（`assets/od-site.js`，全部是真实逻辑而非截图）：
  - **LAB 01 适配器解剖台**：切 5 条 CLI（claude / codex / cursor-agent / deepseek / devin）× 4 个运行时开关，实时生成 argv，灰色斜体标出被能力门挡下的部分
  - **LAB 02 提示词分层装配器**：3 种会话模式 × 9 个条件开关，21 层实时装配/门控，按**变化频率**四色分带，底部算出「可缓存前缀」占比——拨开 deck 信号可直接看到占比从 100% 掉到 92%
  - **LAB 03 反 AI 味 linter 实验台**：`lint-artifact.ts` 十六条规则的**可运行复刻**，含 CSS 变量递归求值（深度 4）、按同规则 `font-size` 折算字距、HTML/CSS 注释剥离；4 个样本（典型 AI 味 / 合规产物 / 假阳性陷阱 / 幻灯节奏），可直接改 HTML 实时看发现
  - **LAB 04 五陪审评分器**：拖动五位陪审员分数看加权合成，直观证明「Designer 拉到 10 分 composite 纹丝不动」（权重 0）
- **教程站专属组件**（`assets/od-build.js`）：17 步**装配进度**与 **30 条验收断言**双清单（localStorage 持久化、完成度进度条）、12 个翻车点手风琴（症状/根因/修法三段式）

### Changed（横评升级为十大 Agent）
- **`项目分析/横向对比与总结评价.md`**（692 行 / 14 图 → **852 行 / 15 图**）：标题与首段升级为十大；新增 **第七章「第十个样本：Open Design——当『宿主』坐上桌子」**，含
  - 7.2 **坐标差对照表**（主循环/工具/权限/上下文/质量/扩展/交付物 七维，并指出本系列分析过的 CodeWhale、hermes-agent、opencode、grok-build **全部出现在 OD 的 `runtimes/defs/` 里**，各自只是一个几百字节的对象字面量）
  - 7.3 三个前九家都没有的设计（适配器即数据 O(N)→O(1) · 审美质量程序化闸门 · 缓存分区排序把 hermes 的「前缀神圣」再推一步）
  - 7.4 三处更重的取舍（**本系列唯一没有执行层权限闸门**的项目 · 两份提示词组装器逐字节同步 · 内容库体量即维护负担）
  - 7.5 更新后的十项定位象限（Open Design 独占最右上「宿主」区）
  - 7.6 **第六场思路对决：「造引擎」还是「造插座」**（含"判断这两条路谁对，看一个数字就够了"的量化论证）
  - 7.7 补充选型建议（含"你在做编程 Agent，想知道怎么让别人集成你——去读 OD 的 `defs/` 看看别人是怎么描述你的"）

### Changed（索引与入口全线同步）
- **`总目录.md`**：九大 → 十大；新增路线 D 条目、Open Design 解析站/教程站两行、两条新的「我想…」快速入口（审美质量程序化执法 / 提示词缓存排序）
- **`总目录.html`**：新增 4 张卡（解析站 / 教程站 / 路线 D / Open Design 分析），全部带黏土色边框与检索关键词；横评卡更新为 852 行 15 图并标注第七章
- **`html-hub.html`**：新增「Open Design 专线」分区（两张高亮卡）

### Fixed
- **`总目录.html` 的嵌套 `<a>` 结构性 bug**：新加的两张卡里把「→ 交互站」链接写在了 `<a class="card">` 内部——嵌套锚点是非法 HTML，浏览器的 adoption agency 算法会把外层 `<a>` 提前闭合，导致这两张卡的 `.t` 标题被拆到卡片之外（浏览器实测：36 张卡里 2 张查不到标题）。改为纯文本提示后复验 0 异常
- **LAB 03 说明文案与实现不符**：初稿把「假阳性陷阱」样本描述成「`@media` 里的规则也不该误报」，但实测该规则（`font-size:48px` + `letter-spacing:1px` = 0.021em）**本就应该被抓住**——它正是把正则从 `[^}]*` 改成 `[^{}]*`（只匹配最内层规则）换来的真阳性。改写文案，把该样本讲成「同时演示该放过的和该抓住的」

### Verified（浏览器实测，非静态检查）
- **两个新站结构校验**：标签配平（section/figure/div/table/main/aside/pre/blockquote 全部 open==close）、**内部锚点零断链**（解析站 hrefs ⊆ ids，教程站同）
- **Mermaid 实渲染**：解析站 **12/12**、教程站 **12/12**，无一失败
- **四个实验台逐个实测**：
  - LAB 01 切到 deepseek 正确产出 argv 且标出「进 argv！三重守卫在 spawn 前拦截超长」
  - LAB 02 Design 模式 65.3KB/100% 可缓存 → 打开 deck 信号变 70.7KB/92%（证明回合可变带的代价）；Ask 模式门控掉 12 层，降到 48.3KB
  - LAB 03 「典型 AI 味」样本报 **10 条**（7×P0 + 2×P1 + 1×P2）；「合规产物」**0 条**；「假阳性陷阱」只报 `@media` 那条真阳性（注释示例与三层 `var()` 解析的 `.eyebrow` 均正确放过）；「幻灯节奏」报 `slide-theme-missing` + `slide-rhythm`
  - LAB 04 Designer 拉到 10 → composite **7.10 不变**；Critic 拉到 10 → **8.50** 达标（权重表实测正确）
- **教程站交互**：2 个清单共 47 项、12 个手风琴；勾选写入 localStorage 并复读成功（验证后已清空测试状态）
- **`总目录.html` 搜索**：输入 "open design" 正确命中全部 4 个新条目 + 横评；36 张卡 0 张标题缺失

### 产物规模对比（本阶段 vs 原纪录）
| 类型 | 原纪录 | 本阶段 | 增幅 |
|---|---|---|---|
| 单项目源码分析 | OpenManus 1617 行 / 89.6KB | **open-design 1858 行 / 126.3KB** | +41% 体积 |
| 从零构建教程 | Manus 系 1037 行 / 52.4KB | **Open Design 系 1964 行 / 105.7KB** | +102% 体积 |
| 横向对比 | 692 行 / 121KB / 14 图 | **852 行 / 135KB / 15 图** | +12% 体积 |
| 交互实验台 | 学习站 v1 的 3 个 | **解析站 4 个 + 教程站 2 个清单 + 12 手风琴** | — |

---

## 2026-07-28 · 阶段 12：MiMo Code 专线（第十一个样本 · fork 型 Agent · 接手重做）

> **接手背景**：上一个代理已经开始分析 `XiaomiMiMo/MiMo-Code` 但中途暂停。检查发现它的克隆**被网络中断**（`.git/objects/pack/` 里残留三个 `tmp_pack_*` 垃圾文件），最终退化成 **sparse checkout（`core.sparseCheckout=true`，`/*` + `!/*/`）——本地只有 20 个手挑的 TS 文件**。因此那份 518 行 / 23 KB 的分析是建立在很局部的视野上的（例如把 `tool/gpt.ts` 当成 GPT 工具实现，实际它只有 13 行、是个判定函数；真正的 GPT 提示词在 `session/prompt/gpt.txt`，25 KB）。本阶段按阶段 11 验证过的可靠路径重做。

### Changed（源码获取方式 · 复用阶段 11 的经验）
- **不再尝试整仓克隆**。改用 `GET /repos/XiaomiMiMo/MiMo-Code/git/trees/076b790?recursive=1` 拿全树（**5 222 条 blob，`truncated: false`**），据此计算全部统计数字；再用 `raw.githubusercontent.com` **逐文件并发抓取**（12 路），共取回 **145 个文件**
- 处理了两个抓取坑：① `docs/harness/` 下 4 份关键设计文档**文件名带空格**，第一批 `xargs` 漏掉，改用 Python + `urllib.parse.quote` 补抓；② `cron/index.ts` 与 `skill/builtin.ts` 返回 404（实际文件名不同），`memory/index.ts` 只是 36 字节的 re-export——**逐个核对了"可疑的小文件"而不是当成抓取成功**

### Changed（源码分析 · 从 23KB 重写到 83KB）
- **`项目分析/MiMo-Code-源码分析.md`**（518 行 / 23 KB / 7 图 → **1384 行 / 83 KB / 7 图**，体积 **3.6 倍**）：因为分析对象是 **opencode 的深度 fork**（核心包至今叫 `packages/opencode`、根 `package.json` 的 `name` 仍是 `"opencode"`、`LICENSE` 两行版权并列），把 12 章框架**扩展到 19 章 / 5 个部分**，并把全文组织成**"读差分"**——
  - **一 它是什么**（1 一个 fork 焊了什么 · 2 Effect 服务层 + TUI · 3 **与上游的 15 条增量清单**，这张表是全文的地图）
  - **二 别让 Agent 骗自己**（4 Goal 与独立裁判 · 5 四道死循环闸门 · 6 **Agent 模式与子 Agent** · 7 Try-Best 与产物验证）
  - **三 上下文工程**（8 一模型一提示词 · 9 Checkpoint 重建 · 10 FTS5 + BM25 地板 · 11 压缩点可调）
  - **四 工具与权限**（12 GPT 微内核 · 13 exec 与 QuickJS · 14 FORCED_ASK）
  - **五 编排与生态**（15 确定性 Workflow · 16 Orchestrator · 17 Dream/Distill/Evolve · 18 Token Efficient · 19 总结）
  - 附录 A 源码导览索引（**32 条**）+ 附录 B 关键文档索引（9 份）
- **补上了上一版没有的核心内容**：Goal 独立裁判的完整机制与四道逃生口、四道死循环闸门的判定逻辑与阈值理由、20 份分家族提示词的路由规则、Checkpoint 重建 vs 压缩的区别、BM25 相对地板、GPT 4 件工具 ABI、`exec` 微内核的三道防线、FORCED_ASK、四个内置 Workflow、Orchestrator 的后台审批路由三分法、Token Efficient 五层管线
- **保留并核对了上一版正确的事实**：npm 包 `@mimo-ai/cli` v0.1.9 / 二进制 `mimo`（核对 `packages/opencode/package.json:3-4,24-26`）、MIT + `USE_RESTRICTIONS.md` 双许可（并**补上了那条与本文主题呼应的限制**——"不许在缺乏人类监督的情况下自主执行高风险动作"）

### Added（MiMo Code 解析站）
- **`MiMo-Code-解析.html`**（79 KB，19 章 / 7 图）+ **`assets/mimo-site.js`**：复用阶段 11 建立的 `assets/od-site.css` 设计系统（苹果 UI 交互 + Claude blog 页面组织），**零新增 CSS**
- **四个可交互实验台**（全部是真实逻辑的可运行复刻，不是截图）：
  - **LAB 01 Goal 裁判沙盘**：拨动裁判结论 / 再入次数 / fail-open 开关，走一遍 `goalGate` 的四道逃生口
  - **LAB 02 四道闸门实验台**：`empty-step-detection.ts` 的 `isEmptyStep` + `prompt.ts` 的 `stepSignature`（含 `stableStringify` 排序键）+ `normalizeForLoopDetection`（含剥开场白）的复刻，5 个场景
  - **LAB 03 提示词路由器**：`session/system.ts:24-40` 那 17 行 `if` 与 `tool/gpt.ts:11-13` 的双重复刻，输入模型 ID 看判定轨迹
  - **LAB 04 BM25 相对地板**：拖动 `floorRatio` 看常见词噪音怎么被裁掉、第一名怎么被永远保留

### Changed（横评升级为十一大 Agent）
- **`项目分析/横向对比与总结评价.md`**（852 行 / 15 图 → **1029 行 / 17 图**）：新增 **第八章「第十一个样本：MiMo Code——同一副骨架，小米焊了什么」**，含
  - 8.1 身世：读 fork 要读差分（**和 Raven 之于 nanobot 同一个模式**）
  - 8.2 **四层七道防自欺装置**，并与其余十家的防护层数对比（多数只有 1–2 层）
  - 8.3 三个前十家都没有的设计（Goal 独立裁判 / 一模型一形 / `exec` 微内核）
  - 8.4 **十一条可复用的工程细节**（空步检测刻意不抓空终端、`stableStringify` 排序键、签名排除叙述文本、剥开场白、日期锚会话创建时间、BM25 相对地板、代理对修复、去抖对齐 checkpoint 边界、never-worse 守门、`Object.create(null)`、FORCED_ASK）
  - 8.5 更新后的十一项定位象限
  - 8.6 **第七场思路对决：「通用 harness」还是「一模型一形」**
  - 8.8 **生态里没有绝对的宿主和客体**（OD 把 mimo 当引擎；mimo 又能把 claude-code/codex/grok-build 当工具调；mimo 的记忆索引还能读 `~/.claude/projects`）
- 一处跨章对照被明确写出：**Goal 独立裁判与 Open Design 的 Design Jury 方向相反**——OD 五陪审员是同一会话五个回合（共享上下文保一致），MiMo 是独立调用（故意不共享，要的就是"冷"）。**同一个问题，两个方向相反的正确答案。**

### Changed（索引与入口同步）
- **`总目录.md`**：十大 → 十一大；新增 MiMo 解析站行、分析条目、两条「我想…」入口（防止 Agent 骗自己 / 提示词路由）
- **`总目录.html`**：新增 2 张卡（解析站 + 源码分析），横评卡更新为 1029 行 17 图并标注第八章
- **`html-hub.html`**：新增「MiMo Code 专线」分区
- **`start-html-previews.sh`**：打印 MiMo 解析站地址

### Verified（浏览器实测）
- **结构校验**：标签配平（section/figure/div/table/tbody/thead/tr/pre/blockquote 全部 open==close）、**内部锚点零断链**、**无嵌套 `<a>`**（阶段 11 踩过的坑，这次预先检查）
- **Mermaid 实渲染**：解析站 **7/7**
- **四个实验台逐个实测**：
  - LAB 01：`ok=true`→正常结束 · `impossible`→正常结束 · `ok=false` react=1→**拒绝停止再入** · react=13→**触顶** · 裁判失败→**fail-open** · 非 main agent→**逃生口**（六条路径全对）
  - LAB 02：空参数场景只有闸门一拦下 · 同动作换键序**闸门二+三**拦下（证明 `stableStringify` 键序归一化生效）· 安静的正常结束**三道全放行**（证明"空终端不是死循环"这条边界）· 有实质文本的坏调用**三道全放行**
  - LAB 03：`gpt-5.6`→gpt.txt/ABI=true · `gpt-5-codex`→codex.txt/true · `gpt-4o`→**beast.txt/false** · `claude-opus-4-5`→anthropic.txt/false · `mimo-v2.5`→**default.txt 兜底** · **`gpt-oss-120b`→gpt.txt 但 ABI=false**（成功复现文档自承的"两套字符串规则尚未统一"）
  - LAB 04：`floorRatio=0`→保留 7/7（噪音全进）· `0.15`→**3/7** · `0.5`→2/7
- **HTTP**：解析站与 `assets/mimo-site.js` 均 200

### 产物规模对比
| 类型 | 接手时 | 本阶段 | 增幅 |
|---|---|---|---|
| MiMo 源码分析 | 518 行 / 23.1 KB / 12 章 | **1384 行 / 82.8 KB / 19 章** | **+259% 体积** |
| 横向对比 | 852 行 / 135 KB / 15 图 | **1029 行 / 148 KB / 17 图** | +9% |
| MiMo 交互站 | 无（只有一个从别站复制的空脚手架 `mimo-code-learn/`） | **79 KB / 4 个实验台** | — |
| 本地源码 | 20 个文件（sparse checkout 残留） | **145 个文件**（targeted fetch） | +625% |

---

## 2026-07-28 · 阶段 13：MiMo vs OpenCode 逐层差分（含三处归属更正）

> **起因**：用户指出 MiMo Code 既然是 OpenCode 的 fork，就该单开一章讲清楚**两者的区别、MiMo 做了什么优化、为什么这么优化**。做这件事时用本地已有的 `参考项目/opencode`（commit `62e4641`，**完整检出 6 252 文件**）与 MiMo（`076b790`，Tree API 全量 5 222 blob）做**真实文件级对比**——结果发现阶段 12 的分析有**三处把上游的东西记成了 MiMo 首创**。

### Fixed（三处归属误判 · 重要）

| 我原先写的 | 实际情况 | 证据 |
|---|---|---|
| 「20 份分家族提示词」是 MiMo 首创 | ❌ **路由模式来自上游**。OpenCode 已有 **8 份**提示词 + 结构完全相同的 `if` 链（`session/system.ts:27-42`），连 `gpt-4/o1/o3 → BEAST` 的判定顺序都一样 | 其中 **5 份 MiMo 字节级未改**：`gemini.txt` 15372=15372 · `kimi.txt` 8695=8695 · `codex.txt` 7390=7390 · `trinity` 差 1B · `copilot-gpt-5` 差 2B |
| 「GPT 工具门控」是 MiMo 首创 | ❌ **判定表达式在上游一字不差**：`registry.ts:292-296` 的 `includes("gpt-") && !includes("oss") && !includes("gpt-4")` | 上游只用它做 `apply_patch` ↔ `edit`/`write` 二选一 |
| 「`exec` QuickJS 微内核」是 MiMo 首创 | ❌ **想法来自上游** `tool/code-mode.ts`（工具名 `execute`，包 `@opencode-ai/codemode`） | 上游用 **acorn + 3 465 行手写 AST 解释器**、只暴露 MCP 工具 |

**MiMo 的实质贡献被重新表述为**（而不是取消）：
- 提示词：加 5 个家族、**重写命中率最高的 3 份**（gpt 9284→25447 · default 8528→20800 · anthropic 8212→14281）、加**双 ID 兜底**（上游只用 `model.api.id`）
- 工具门控：抽成命名函数 `usesGPTToolset()`（因为要在三处用），作用域从"换一把螺丝刀"扩成"**换一整个工具箱**"
- 沙箱：**换引擎**（acorn 手写解释器 → QuickJS-emscripten WASM）+ **换暴露面**（MCP 工具 → 宿主工具），并因此倒逼出 late-bound registry / 控制流工具排除 / 两层边界这一整套配套设计

修正落在四处：`项目分析/MiMo-Code-源码分析.md`（第 1.2 节加归属澄清 + 第 3 章差分表 3 条改写 + 第 8/12/13 章各加一段「归属先说清楚」+ 第 19.1 节两个"最独特设计"重写）、`MiMo-Code-解析.html`、`项目分析/横向对比与总结评价.md` 第 8.3 节、`assets/mimo-site.js`。

### Added（第 20 章 · 逐层差分）
- **`项目分析/MiMo-Code-源码分析.md` 新增第 20 章**（1384 行 / 83 KB → **1724 行 / 105 KB**，19 章 → **20 章**，7 图 → **9 图**）：
  - **20.1 总量**：`src/` 全部 TS/TSX 从 **2 610 KB → 4 572 KB（1.75x）**，但增长完全不均匀——**15 个全新子系统** / skill 2→414 文件（207x）/ provider 5→34 / cli 87→230 / server **72→43（收缩）** / acp **12→4（收缩）**
  - **20.2 主循环**：`prompt.ts` 64 925→207 962 B（**3.2x**），同时**删掉上游整个 `session/llm/` 子目录（33 KB）和 `session/tools.ts`（23 KB）**——判定为一次**「反重构」**（上游在拆，MiMo 在合），并分析了 fork 场景下这个选择的合理性与代价
  - **20.3 提示词**：8→20 份的逐份对照表（含 5 份字节级未改的证据）+ 「为什么只重写那 3 份」+ 「双 ID 兜底为什么重要」
  - **20.4 GPT 门控**：两边代码并排 + 「为什么要抽成命名函数」（因为要在三处用，内联变量不够）
  - **20.5 沙箱**：八维对照表 + **「为什么值得换」三条理由**（手写 JS 解释器是无底洞 / 风险从「语义正确性」转成「资源管理」，后者有确定检查清单 / 暴露面扩张倒逼配套设计）
  - **20.6 Shell**：37 KB → 87 KB，`shell.ts`+`shell/prompt.ts` 删除，换成 bash 五件套；**连工具描述文本都分了 `bash.txt` / `bash.gpt.txt` 两份**
  - **20.7 权限**：`index.ts` 7 861→26 415 B（**3.4x**），`arity.ts` **字节级未改**；**因果链**：加 Orchestrator → 后台会话权限询问被直接拒绝 → 需要转发 → `permission-forward-ref.ts` + `decideAskRouting`
  - **20.9 收缩也有信息量**：`server/` 砍四成 + `cli/` 涨 2.6 倍 = **"不做平台，做终端产品"**
  - **20.10** 把 15 个新子系统按动机归类（长时间干活 / 多线程干活 / 无人值守 / 基础设施），指出 A+B+C 共 12 个子系统是 README 里 `long-horizon` 那句话的注脚
  - **20.11 归属总表**：**13 项首创 · 3 项继承后改造 · 大量基础设施直接继承**
  - **20.12 给同类项目的三条经验**：骨架可以借产品判断不能借 / 改造重心暴露产品定位 / 集中改一个文件是合理战术但要记账

### Added（LAB 05 归属核对台）
- **`MiMo-Code-解析.html` 新增 Part VI + 第 20 章**（79 KB → **98 KB**，7 图 → 9 图，4 实验台 → **5 个**）
- **LAB 05 归属核对台**：15 条能力逐条可展开，三色分类（🟢 首创 10 / 🟡 继承扩张 3 / 🔵 上游已有 2），每条**并排显示两边的真实文件与字节数** + 「判定依据 / 为什么这么改」。可按类别筛选，顶部有比例条。
  - 明确写出：「**把"分家族提示词"和"沙箱脚本"当成 MiMo 首创是最常见的误读**——它们的雏形都在上游。」

### Changed（横评第八章同步）
- `项目分析/横向对比与总结评价.md`（1029 → **1053 行**）：8.3 节两个"独特设计"改写为带上下游对照表的版本；8.5 象限补上**位移的硬证据**（server 72→43、acp 12→4、cli 87→230）；8.7 取舍表新增一条「一次反重构」；第七场对决补一段——**这场对决的双方其实是"上游 vs 下游"**，同一个仓库血脉，两个团队在同一问题上的投入差了一个量级

### Verified
- **新章引用的每个数字都对着本地两个仓库核实**：opencode `prompt.ts` 64925 · `permission/index.ts` 7861 · `arity.ts` 6376（与 MiMo 相同）· `code-mode.ts` 11808 · `interpreter/runtime.ts` **3465 行** · `shell.ts` 20439 · `skill/` **2 文件** · `server/` **72** · `acp/` **12**
- **站点**：mermaid **9/9** 实渲染；标签配平；锚点零断链；LAB 05 实测（全部 15 / 首创 10 / 扩张 3 / 上游 2，展开项内容正确）
- **文档**：20 章锚点零断链

---

## 2026-07-28 · 阶段 14：MiroFish 专线（第十二个样本 · **非编程 Agent** · 群体智能仿真）

> **为什么这一份和前十一份不是同类**：前十一个项目都在回答「怎么让 AI 替我干活」。MiroFish 回答的是「**怎么让一群 AI 替我把事情预演一遍**」。技术栈、评价标准、创新点全在另一个坐标系里，所以没有沿用 12 章框架，而是另起了一套 17 章结构。

### Added（源码分析 MD）
- **`项目分析/MiroFish-源码分析.md`**（**1889 行 / 91 KB / 13 图 / 17 章 5 部分**），基于 `666ghj/MiroFish` commit `60757b3`
  - **一、它是什么**：8 个月 6.9 万星的反差数字（**每千行代码 1550 星，本系列断崖第一**）· 技术栈全解（**只有 12 个依赖**，把最难的两件事外包给 OASIS 和 Zep Cloud）· 五步流水线
  - **二、世界怎么建**：本体的 **8 具体 + 2 兜底**层次设计（被 Zep 的 10 类上限逼出来的）· 三层防御性归一化 · **个人 vs 机构人设分野** · 把社会学常识编码成配置
  - **三、世界怎么跑**：世界 1 / 世界 2 双平台（**参数取值不同**）· 文件系统 IPC · **跑完不关门** · **闭环回写**
  - **四、结果怎么取**：四件检索兵器（InsightForge / Panorama / Quick / **Interview**）· ReportAgent 三道防伪
  - **五、评价**：五个真正新的东西 · 亮点与七条硬伤 · **十二条对做新产品的启发** · 象限图定位

### Added（解析站，零新增 CSS）
- **`MiroFish-解析.html`**（**17 章 / 11 图 / 5 个可交互实验台**）+ **`assets/mf-site.js`**（约 620 行）
  - 复用 `assets/od-site.css`，**一行新 CSS 都没写**——这是该设计系统第三次被复用
  - **LAB 01 本体归一化流水线**：`utils/ontology.py` 全文 + `ontology_generator.py:22-45,500-544` + `graph_builder.py:324-328` 的**可运行移植**。四个样例，实时显示每一处改动及其源码位置
  - **LAB 02 人设分野判定台**：走一遍 `_is_group_entity()`，看落到哪条提示词分支
  - **LAB 03 中国作息活跃度曲线**：24 小时柱状图 + 峰谷比 + 高峰贡献占比，参数取自 `CHINA_TIMEZONE_CONFIG`
  - **LAB 04 双世界参数对照台**：同一条帖子在两套平台参数下的推荐分与破圈判定，**互动数 10–14 之间会看到两个世界分叉**
  - **LAB 05 伪造工具结果剥离器**：`report_agent.py:1144-1174` 的**逐行移植**，含深度计数扫描轨迹；四个样例覆盖普通伪造 / 嵌套 / 畸形开标签 / 老实的模型

### Found（实验台跑出来的一个真实缺陷）
- **`_to_pascal_case` / `_to_upper_snake_case` 会静默破坏非 ASCII 类型名。**两者核心都是 `[^a-zA-Z0-9]`，只认 ASCII：
  - `在校学生` / `媒体机构` / `武汉大学` → **全部坍塌成 `Unknown`**；`批评` / `就读于` → 全部 `UNKNOWN`
  - 而 `graph_builder.py:331` 建的是按名字索引的字典，`:354` 写入 → **三个中文类型互相覆盖，最后只剩一个，全程不抛异常、不打日志**
  - 这解释了 `ontology_generator.py:228` 那句 `IMPORTANT: MUST be in English PascalCase` 为什么是**承重墙而非风格要求**——而它就拼在 `get_language_instruction()`（可能正是「请使用中文回答」）的正后面
  - 已写进 MD §4.4 与第 15 章硬伤 ⑤、站点第 4 章与第 15 章，LAB 01 的「中文类型名 ⚠️」样例可现场复现
- 结论落成一条通用纪律：**兜底值应该用在「缺失」上，不该用在「损坏」上**——`return 'Unknown'` 应该是 `raise`

### Verified
- **行号逐条回验**：`config.py` 全部引用（41/45/49/52/59-61/71-72）· `app/__init__.py`（8-10/25-27/33/47/67-69）· `ontology_generator.py`（22/35/42/48/70/113-136/147/228/287/465/500-544/585）· `utils/ontology.py`（6-8/9-17/19-23/26/52/64/73）· `oasis_profile_generator.py`（90/111/123/127/151/238/324/536/700-714/721/732/746-754/762-768/770/781/783/814）· `simulation_config_generator.py`（30-50/85-112/115-127/131-145/174-175/192-193/334/342-360）· `zep_tools.py`（133/457/542/943/992/1090/1143/1213/1235/1270/1483/1503/1549/1632）· `zep_graph_memory_updater.py`（207/213-241/281-287/335/344/371-373）· `report_agent.py`（3/36/307/871/882-888/1120/1144/1176/1260/1495/1576/1810/1931/2052/2114/2318/2348）· `simulation_ipc.py`（1-9/25/41/67/95/288）· `simulation_runner.py`（40/52/57/84/110/204/1554）· `locale.py`（8/24/29-33/35/66）· `graph_builder.py`（52/324-328/331/354）· `run_parallel_simulation.py`（1-27/29-47）
- **统计数字**：GitHub Git Tree API 全量遍历（**128 条 blob / 9.05 MB，`truncated: false`**）；社区数据经 GitHub REST API 于 2026-07-28 取得（69 573★ / 10 868 fork / 430 watch / 105 issue）；代码行数经本地 `wc -l` 复核（backend 业务 40 文件 24 428 行、Vue 16 文件 20 461 行、测试 21 文件 4 719 行、i18n 631 键 ×2）
- **站点浏览器实测**：mermaid **11/11 实渲染**（含 `xychart-beta` 与 `quadrantChart`）· 锚点**零断链** · 页面**无横向溢出** · 5 个实验台全部产出正确结果并逐个核对
  - LAB 01：四个样例的 findings 逐条对照源码语义确认；`REL_3_RD_PARTY_MENTION` 与 Python 实测输出**逐字符一致**
  - LAB 05：嵌套样例 depth 轨迹 `0→1→2→1→0` 正确；畸形样例 depth 停在 1、尾部整段不追加，与源码 `if depth == 0` 守卫一致
  - LAB 03：柱高实测 `[4×6, 35×3, 61×10, 127×4, 43]`，与 `activity_multipliers` 比例一致
  - LAB 04：互动数 12 时 Twitter 破圈 / Reddit 未破圈，「两个世界分叉了」判定正确

### Fixed（自测中发现并修掉的）
- LAB 03 柱状图高度塌陷：外层 `align-items:flex-end` 使列不撑满 130px，子元素百分比高度失效 → 改 `stretch`
- 实验台 `.grid2` 子项默认 `min-width:auto`，长代码块在窄屏撑破容器 → 六处加 `min-width:0`
- LAB 05「畸形开标签」样例误报「模型很老实」（因为标签正则一个都没匹配到）→ 改成专门说明「这正是兜底正则存在的理由」
- LAB 01 `UPPER-SNAKE` 的说明文字写死为「标识符不能以数字开头」→ 按是否加了 `REL_` 前缀分支
- 一处自我更正：起初把 i18n 只有中英两种语言判成硬伤，读了 `frontend/src/i18n/index.js` 才发现是**注册表 ∩ 实际翻译文件**的插件式设计，不会出现「选了没用」——改列为亮点，并追加了 `locale.py` 前后端共用同一目录、`llmInstruction` 驱动 LLM 输出语言、7 个注入点各带一条「枚举值必须英文」例外的完整分析

### Changed（索引同步）
- `总目录.md`：十一大 → **十二大**；新增 3 条「我想…」入口、学习站表格 1 行、独立 HTML 表格 1 行、分析卡 1 行；谱系说明改写为四类（编程 Agent / 通用任务同事 / 宿主 / **仿真**）
- `总目录.html`：intent card、站点卡、分析卡各新增 MiroFish 条目（带完整搜索关键词），标题改十二大
- `html-hub.html`：新增「MiroFish 专线」区块，页脚更新

---

## 2026-07-29 · 阶段 15：OpenAI Codex 专线审计与重做（第十三个样本 · 官方开源 · Rust）

> **背景**：这一批产物（`openai-codex-源码分析.md` / `Claude-Code-vs-OpenCode-vs-Codex-深度对比.md` / `openai-codex-解析.html` / `assets/codex-site.js`）由另一个代理先写成，本阶段是**对着 `参考项目/codex` 完整树（5 798 文件 / 91 MB / commit `bb1af23`）做的逐点核对 + 补深 + 站点重做**。

### Verified（先说结论：底稿准确度很高）
- **基线数字全对**：`codex-rs` 下 **2 783** 个 `.rs` · workspace **126** members · `session/turn.rs` **2 741** 行 · `session/mod.rs` **4 154** 行 · `tools/orchestrator.rs` **533** 行 · `handlers/apply_patch.rs` **666** 行 —— 逐条 `wc -l` 复核一致
- **核心链路的断言逐条成立**：`run_turn` @153 · `run_pre_sampling_compact` @983 · `run_sampling_request` @1308 · `run_auto_compact` @1149 · `built_tools` @1459 · `AskForApproval` @908（四变体）· `ExecApprovalRequirement` @156（三态）· `with_cached_approval` @71 · `APPLY_PATCH_ARG0` @20 / `MISSPELLED` @21 · `get_platform_sandbox` 逻辑
- **连细节都对**：`turn.rs:430` 那句「相信压缩能拉回窗口所以不怕死循环」的注释确实存在且位置精确；`handlers/shell.rs:122-138` 抬权守卫的拒绝文案确实写着 *"you should not ask for escalated permissions if the approval policy is …"*
- 36 处显式行号引用**无一越界**

### Fixed（找到并修掉的真实问题）
1. **`codex-site.js` LAB04 分隔符讲错了**——原文说「从根到 cwd 串联，分隔符 `--- project-doc ---`」。实际 `legacy_text()`（`agents_md.rs:330-343`）只在**用户/内部指令 → 项目指令的那一次交界**用这个标记，链上相邻项目文档之间用的是普通 `\n\n`。**注释里写得很直白**：*"only needed on the transition from user or internal instructions to project instructions"*。（MD 的 17.1 反而是对的，是 JS 和 MD 自相矛盾）
2. **`ModeKind` 把 serde 别名和真实变体混为一谈**——原文写「`Plan` / `Default`（别名 code、execute…）」。实际枚举有 **4 个变体**：`Plan` · `Default` · `PairProgramming` · `Execute`，后两个是 `#[doc(hidden)]` + `skip_serializing/skip_deserializing`（**配置到不了**）；而 `code`/`pair_programming`/`execute`/`custom` 是**挂在 `Default` 上的别名**。「只有两个模式」是由 `TUI_VISIBLE_COLLABORATION_MODES` 常量钉死的。已补真值表 + 渐进废弃手法的解释
3. **`default_exec_approval_requirement` 的描述不够精确**——原文「Granular 若关掉 sandbox_approval → Forbidden」读起来像无条件。实际 `Forbidden` **挂在 `needs_approval` 为真的前提下**：Granular + ASA=false + FS **不是** Restricted 时结果是 **Skip 不是 Forbidden**。已补完整真值表并标出那一格
4. **子命令清单漏了 `Debug(DebugCommand)`**
5. **歧义文件名引用**——`turn.rs` / `shell.rs` / `protocol.rs` / `config_types.rs` / `agents_md.rs` 在本仓库各有 **3–6 个同名文件**，原文只写文件名。`shell.rs:63` 尤其危险：三个候选里正确的是 `core/src/tools/handlers/shell.rs`，不是最直觉的那个。**全部补全 crate 路径**
6. **`run_turn` 内部行段有 1–2 行系统性漂移**（216–219→215–218 · 221–231→220–230 · 256–270 的赋值其实在 236 · loop 起点 272→270 · `name()` @56-64→56-66），逐条按 `grep -n` 校准

### Added（补深到 Open Design 颗粒度的技术点）
- **17.3 AGENTS.md 字节预算 = 一条先到先得、会饿死后来者的链**（全文最有实战价值的一段）
  - 默认 **32 KiB**（`DEFAULT_PROJECT_DOC_MAX_BYTES`，`config_toml.rs:68`），**整条链共享**而不是每文件上限
  - `remaining` 沿 **root → cwd** 递减；跨过额度的文件被 **`truncate` 拦腰截断**而不是跳过；额度耗尽后直接 `break`，后面的文件**根本不读**
  - 扣减写在 `if !text.trim().is_empty()` 里 → **空白文件不消耗额度**
  - **实战陷阱**：根 30 KB + `apps/api` 5 KB → 后者只进 2 KB，静默丢 3 KB，日志只有一条 warn。「越具体越该赢」的规则恰好在**最容易被截断的链尾**
- **17.3b `candidate_filenames`**：`AGENTS.override.md` › `AGENTS.md` › 配置后备名，**每目录只取第一个命中**。所以 override 是「同目录内替换」不是「合并」，且不影响其它层——与 Claude Code 的多来源叠加心智不同
- **17.3c `text()` 有两套出口**：多环境时走 `environment_labeled_text()`，单环境才走 `legacy_text()`
- **13.2 `intercept_apply_patch` 有两个调用点**：`handlers/shell.rs:142` 与 `handlers/unified_exec/exec_command.rs:314`——**恰好是模型能执行命令的两条路**。只堵一条等于没堵，这才是「结构化补丁必须走结构化闸门」的完整论证
- **18.3 MCP 工具名归一化**：`mcp__` 是 **LEGACY** 前缀且由 `prefix_mcp_tool_names()` 门控（含按 server 豁免名单）；模型可见名 **≤64 字节**；撞名走**两轮检测 + SHA-1 内容哈希后缀**，末尾还显式 `sort_by(raw_tool_identity)`。**为什么不用 `_1`/`_2` 序号**：序号依赖遍历顺序 → 工具名在会话间漂移 → 同时打掉 prompt cache 和模型的工具记忆。**可直接搬走的原则：对模型稳定暴露的标识符，去重后缀必须由内容决定**
- **`sanitize_responses_api_tool_name` 比想象中粗暴**（`mcp/mod.rs:450-465`）：保留集只有 `[A-Za-z0-9_]`，**连字符 `-` 也保不住**；中文**每个字各变一个 `_`**，于是 `仓库管理` 和 `部署运维` sanitize 后都是 `____` → 撞名 → 各挂哈希 → `mcp_______f61079/____`，**完全丧失可读性**
- **5.4 外层 loop 的三个细节**：`.take()` 让预热连接**只给第一圈**（第二圈已在对话中，没有首字延迟可掩盖）· `child_token()` 每圈派生子令牌 · 第二圈起 `next_input = Vec::new()`（插话已在 `input_queue` 里，不能从外面再塞一遍）

### Changed（解析站从「预览稿」重做为正式站）
- **`openai-codex-解析.html`**：26 KB → **47 KB**；17 章 → **21 章 7 部分**；**3 图 → 10 图**；新增 **Part VII 场景推演**（`rm -rf build` 全链 / mid-turn 压缩 / stop hook 续跑 / CI 里的 Never）；去掉「预览稿未入总目录」横幅
- **`assets/codex-site.js`**：182 行 → **约 620 行**。原来的 4 个 LAB **全是硬编码查表**（点一下显示一段预写文本，零逻辑），违背本系列由 `od-site.js` / `mimo-site.js` / `mf-site.js` 建立的标准。**全部重写为真实源码逻辑的移植**：
  - **LAB 01 审批×沙箱正交表**——`default_exec_approval_requirement` + `sandbox_override_for_first_attempt` + `unsandboxed_execution_allowed` 的忠实移植，**10 格真值表与 Rust 实现逐格比对通过**，包括反直觉的 `granular/workspace/ASA=false → Skip`
  - **LAB 02 AGENTS.md 预算模拟器**——`remaining` 账本逐行移植，可改每层大小/override/空白，实测 32 KiB 下 4 层只进 2 层（TRUNCATED + BREAK），64 KiB 全进，0 则整个禁用
  - **LAB 03 run_turn 停机协议**——`:357-512` 状态机移植，7 个开关组合出 continue/break 的全部理由
  - **LAB 04 MCP 名字归一化**——sanitize → 前缀 → 两轮撞名 → 内容哈希 → 排序 → 64 字节，四个样例（撞名/中文/超长/干净）
  - **LAB 05 平台沙箱选择**——`get_platform_sandbox` 移植，Windows 关开关时返回 `None` 是三平台里唯一的裸奔分支

### Verified（浏览器实测）
- mermaid **10/10 实渲染** · 锚点**零断链** · 页面**无横向溢出** · 无 JS 报错
- **LAB 01 真值表 10 格**逐格核对与 Rust 源码一致；denied-read 压制 escalated → `NoOverride` 正确
- **LAB 02** 三档预算（32/64/0）行为正确
- **LAB 03** 7 种组合的 continue/break 判定全部正确
- **LAB 04** 四个样例正确，中文样例复现出 `mcp_______f61079/____` 的可读性坍塌
- **LAB 05** 五个平台分支正确
- JS 经 deno 解析校验通过

### Changed（索引同步）
- `总目录.md`：十二大 → **十三大**；新增 3 条「我想…」入口 + 学习站表格 1 行 + 独立 HTML 1 行 + 分析卡 1 行；新增 `#c3` 三方对比小节；参考树补 `codex`
- `总目录.html`：intent card 改十三大；新增**站点卡**与**两张分析卡**（Codex 加深版 + 三方对比），带完整搜索关键词
- `html-hub.html`：新增「OpenAI Codex 专线」区块
- `start-html-previews.sh`：补 Codex 解析站地址
- 三份产物里的「预览稿 / 未入总目录」标记**全部清除**，换成可核对的出处说明

---

## 2026-07-29 · 阶段 16：架构图库模块（跨项目横向视角 + 三轮图审方法论）

> **来源**：架构图由外部图库 Agent 生成，本阶段是**三轮审阅 + 建站集成**。共闭环 **19 处**问题。

### Added
- **`架构图库.html`**（657 行 / 7 项目 / **9 张图** / 6 种图型）+ **`assets/gallery-site.js`**
  - 覆盖 Hermes · Claude Code · Open Design · OpenCode · OpenWorker · grok-build · OpenManus
  - 每张图先写清「**回答什么问题**」与「**承重墙论点**」，再给图；图型徽标标注属于六类中的哪一类
  - **点图全屏放大**（mermaid 异步渲染，用轮询等 svg 就绪再挂事件，比猜 setTimeout 可靠）
  - 图**冲破 720px 正文列**（两侧各借 130px），窄屏自动回落
- **方法论三件套**：`架构图绘制规范-给图库Agent.md`（562 行）· `架构图-第二轮审阅与勘误`（381 行）· `架构图-第三轮审阅`（318 行）

### Fixed（共享设计系统的既存 bug）
- **`assets/od-site.css`：所有 mermaid 图都坐在 `#1d1d1f` 黑底上**——`pre.mermaid` 继承了全局 `pre` 的深色代码块样式。**五个站同时受影响**（open-design / MiMo / MiroFish / codex / 新图库）。补 `pre.mermaid{background:transparent;padding:0;…}` 一次修好

### Verified
- 图库 **9/9 mermaid 渲染通过**（零 error svg）· 锚点零断链 · 无横向溢出 · 放大开关实测（开→有 svg + body 锁滚动；关→清空 + 恢复）
- 总目录 45 张卡片、31 个本地链接全通、无嵌套 `<a>`、搜索命中正常
- open-design 站插图后 **13/13 渲染**

### Changed
- **`open-design-解析.html` ch4 末尾插入「扩展点图」**——该章论证「适配器是数据不是类」，而这张图给出**可验证后果**（接第 26 个 CLI = 改 1 个数据文件，对照「若是类则需 ≈4 处」）
- **7 份项目分析 MD 头部加图库互链**（hermes / open-design / opencode / openworker / grok-build / OpenManus / Claude Code 深入版）
- `总目录.md`：新增 2 条「我想…」入口 + 学习站表格 1 行 + 独立 HTML 1 行 + 元文档 3 行
- `总目录.html`：新增 intent card + 站点卡 + 方法论卡
- `html-hub.html`：新增「架构图库」区块置顶；`start-html-previews.sh` 补地址

### Found（三轮审阅的代表性发现）
| 轮次 | 代表性问题 |
|---|---|
| 一 | 六张图共享同一个「目录树式伪分层」形状——**遮住文字后互相可替换**，说明没承载项目特有信息 |
| 二 | **一张图语法错误完全不渲染**（`</div>` 写成了 `end` 的位置），而 mermaid 只会安静地画个炸弹图标 → 定为「规则零：交付前必须真渲染」 |
| 二 | 一个**编造的 `>90%` 缓存命中率**（上游文档与本仓库解析均无此数）；四个源码里查不到的标识符 |
| 二 | 配色语义**未生效**：`class` 作用于 subgraph 不继承给组内节点，5 个节点漏色，含最核心的主循环 |
| 三 | **一条边把 `spawn` 动作归给数据结构**，与该图自己的承重墙论点「适配器是数据不是类」自相矛盾 → 定为「规则十四：问箭头尾巴有没有能力做这件事」 |
| 三 | **更正我自己第二轮的一处误判**：四组对照实验证伪了「圆柱 classDef 失效」，真因只有 class 列表漏写。教训：一次只改一个变量，否则「改完就好」不能证明诊断正确 |

### Note（未采纳的部分）
- 图库另有图像模型生成的**海报版 jpg**，经逐张检查**未采用为技术插图**：文字有生成式乱码（`the performant unction` / `Shore context` / `continatiue` / `marhedulms`）；版本滞后，已修正的错误仍烤在图里（`>90%`、`6 Sandboxes`、`3-Process`、`26 Defs spawning 25 CLIs`）；七张里四张仍是第一版层叠设计。**本模块以 Mermaid 为准**，海报重制后可作章首视觉补入。

---

## 2026-07-31 · 阶段 17：工程模式提炼 + 阅读体系 + 评测分析 + 项目推荐

### Added
- **`Agent工程模式目录.md`** + `.html`（**15 章**）：从十三大项目中提取反复出现的工程手法，每个模式并排展示不同项目的解法与利弊。覆盖：Prompt Cache 工程 / Agent 停止判定 / 权限闸门派别（六派）/ 上下文压缩（两派）/ 记忆体系（四种模式）/ 工具系统设计（四类节流）/ 沙箱与执行隔离（五层防线）/ 子 Agent 模式（三代进化）/ 错误处理 / 流式管线 / 并发与取消 / 持久化与崩溃恢复 / 扩展生态策略 / 架构形态 / 模型策略。全文标注 `文件:行号`，从已有的十三份单项目分析 + 横向对比中提取事实
- **`按水平分级的阅读路线.md`** + `.html`：将 60+ 份文档和 30+ 个实验台按四个能力阶段（入门认知→打开视野→动手构建→专线深潜）组织成推荐阅读顺序。含零基础前置补充指南 + 有基础者快速定位表
- **`Agent评测与基准测试.md`** + `.html`：四层评测体系完整分析（HumanEval/MBPP → Aider Polyglot → SWE-bench Verified → GAIA/WebArena/OSWorld），每层含设计原理、判分机制、已知局限、参考分数。另含业界评测的五个系统性问题（指标扭曲/成本忽略/基础设施不可靠/不可复现/数据污染）+ 你分析过的项目各自的评测态度 + 关键论文索引。所有数据和引用基于 2025–2026 年公开的论文与排行榜
- **`后续待剖析的开源项目推荐列表.md`** + `.html`：12 个精选项目，按学习价值排优先级（最高：Aider / SWE-agent / LangGraph；高：Cline / browser-use / Computer Use；中：AutoGen / CrewAI / Dify / Google A2A / E2B）。每个项目说明为什么值得看、与你已分析项目的关系
- **`build-html.py`**：MD→HTML 转换脚本，使用 Python markdown 库 + od-site.css 模板

### Changed
- **`总目录.md`**：新增 4 条「我想…」入口（查工程模式 / 拿阅读路线 / 搞懂评测 / 看推荐列表）；新增 4 个独立章节（六至九）+ 4 条独立 HTML 条目；更新扫描日期至 2026-07-31
- **`html-hub.html`**：新增「Agent 工程模式与学习指南」分区（4 张卡）；更新页脚日期
- **`总目录.html`**：同步更新（intent cards + 站点卡 + 分析卡）
- **`文档与站点索引.md`**：新增 4 份文档的行记录
- **`CHANGELOG.md`**：本阶段条目

### Verified
- 四份 HTML 结构校验（div/section/table 全部 open==close，零标签配平错误）
- 四份 HTML 的 `<a href>` 内部链接全部指向本仓库内已有资源（`./总目录.html`、`./html-hub.html`）
- 工程模式目录的 15 个章节标题与内容一致
- 评测文档中引用的数据均来源于 2025–2026 年公开论文与排行榜

---

## 2026-07-31 · 阶段 18：四份文档深度重写（面向初级开发者的颗粒度）

### Changed（推倒重写）
- **`Agent工程模式目录.md`**：从 15 章概述级 → **15 章深度实现级**（约 5x 篇幅）。每章统一按 8 节框架展开：问题场景→本质分析→朴素方案为什么不行→各家的解法（含代码级描述）→关键实现细节→边界条件与失败模式→如何验证你做对了→从简单到生产的演进路径。前 7 章（缓存/停机/权限/压缩/记忆/工具/错误处理）完整展开，后 8 章（沙箱/子Agent/流式/并发/持久化/扩展/架构/模型策略）次第深入。新增第〇章"如何读这份目录"
- **`按水平分级的阅读路线.md`**：从 4 阶段简单列表 → 含快速自测/五阶段（含阶段〇零基础）/每阶段前置知识清单/具体验收检查项/学习目标/概念关系图/常见误区的完整学习指南
- **`Agent评测与基准测试.md`**：从概述级 → 含每层基准的题目构造过程详解/评分函数描述/已知局限的实证数据引用/项目评测态度对照/四层自测策略/关键论文索引。新增古德哈特定律分析、"AI Agents That Matter"详细论证、SWE-bench Verified 筛选题目的 93 人标注过程描述
- **`后续待剖析的开源项目推荐列表.md`**：从简单列表 → 最高优先级 3 个项目含架构预览/具体代码阅读入口（文件路径+函数名）/与已分析项目的技术决策对照表/按学习路径的交叉推荐

### Verified
- 四份 HTML 重新生成，结构全部通过 div/section/table 配平校验
- 工程模式目录从 27KB → 75KB（2.8x），HTML 从 28KB → 75KB
- 所有加深内容的事实均基于已有的十三份单项目分析 + 横向对比，零处编造

---

## 2026-07-31 · 阶段 19：四份核心报告源码核对修正 + HTML 统一 open-design 风格

> **起因**：用户要求结合全部项目源码，对《Agent工程模式目录》《按水平分级的阅读路线》《Agent评测与基准测试》《后续待剖析的开源项目推荐列表》四份报告做针对性完善与优化，重点排查错误、阐释技术架构亮点，并把四份 HTML 统一成 open-design 解析站风格。

### Fixed（源码核对发现并修正的 8 处技术错误）
用两个并行 Explore agent 对照 `参考项目/` 源码逐条核验行号引用，发现并修正：
1. **opencode doom_loop** 报告写 `session/prompt.ts:356-380` 的函数 → 实际是 permission 名称，检测在 `processor.ts:373`
2. **MiMo Code「四道闸门」**中「重复 tool_call_id」「坏调用比例」两道无源码依据（杜撰）→ 改为实际存在的四类循环检测（空步 + 重复步 + 文本 n-gram + 文本循环恢复）
3. `tools.ts:262` 连续前缀 → 实际在 354-359（262 是 deny 剔除）
4. `query.ts` 时间信息 → 实际在 `prompts.ts:499`
5. 「38B token」注释 → 补全为 `compact.ts:431-434` 附原文
6. `transform.ts`「两千多行」→ 实际 1813 行
7. OpenWorker「§25 标准规则」→ 实际是 `_command_allowed` 函数（`permissions.py:216`）
8. Raven 错误分类器 `retry` → 实际字段名 `retryable`

### Changed（build-html.py 完全重写 + 新增章节）
- **`build-html.py`**：从简陋 nav+hero+article 模板升级为 open-design 风格生成器——toc 侧边栏（h2 分组 + h3 链接 + scroll-spy）、hero stats 网格（4 统计）、part/chapter 结构（h2→`div.part.rv`、h3→`section.ch.rv`）、表格 `tw` 容器、blockquote 黏土色边框、滚动淡入、回到顶部、内联交互 JS（进度条 + scroll-spy + 淡入）
- **`Agent工程模式目录.md`** 新增 **第十六章「架构组织：从模式到可迁移的方法论」**（附录前）：把 15 个模式提炼为六条可迁移架构原则（变化频率第一切分轴 / 安全靠不可为 / 刹车油门分人 / 协议即边界 / 怀疑模型自我报告 / 错题本比架构值钱）

### Verified
- 四份 HTML 重新生成：Agent工程模式目录 → 17 part / 85 chapter / 20 tw 表格，nav 锚点与正文 id 全部匹配
- 本地 HTTP 服务器（127.0.0.1:7400）四份页面全部 200

---

## 2026-07-31 · 阶段 20：全量审查 22 份文档（不修改源文件）

> **起因**：用户要求把所有解析报告对照源码全部审查一遍，单独汇总错误供审阅，不更改源文件。

### Added
- **`全量审查汇总报告.md`**：覆盖全部 22 份文档（17 份单项目源码分析 + 3 份横向对比 + Claude Code 科普 + Agent工程模式目录 + 评测基准 + 推荐列表 + 阅读路线）。共发现 **约 73 条错误**：3 高危 / 18 中危 / ~52 低危，按严重度分层、按文档分组，含错误类型分类与处理优先级建议

### Found（3 条高危）
1. **openworker**——「建在 aisuite 之上」断言错误：provider 层完全自研（`providers/registry.py` 原生 OpenAI/Anthropic/Gemini），aisuite 仅用于工具层（`ai.tool`/`ai.toolkits`），README 的 "built on aisuite" 是营销话术
2. **goose**——`gooseServe.ts:369` 行号严重偏移 49 行，实际 `startGooseServe` 定义在 320 行，三处引用全错
3. **MiMo-Code**——`isMcpToolSearchEnabled` 误归于 `usesGPTToolset`，实际调用 `isGPTModel`，对 gpt-4 系行为完全不同

### Verified
- **0 错误报告**：openai-codex（30+ 条抽样全命中）、CodeWhale（仅 1 低危）、Claude-Code-vs-OpenCode-vs-Codex、OpenManus-vs-Suna、Agent评测与基准测试（SWE-bench Verified 数据经 WebSearch 核对全部准确：93 开发者/68.3% 被筛掉/500 题）
- MiroFish：全部行号引用准确，数据偏差归因于 commit 版本差异（报告基于 `60757b3`）

---

## 2026-07-31 · 阶段 21：CodePilot 专线（第十四个样本 · 桌面 Agent 客户端）

> **分析对象**：`op7418/CodePilot` v0.62.0（Electron 40 + Next.js 16 + SQLite + Claude Agent SDK + Native Runtime + Codex Runtime，1448 个 TS/TSX 文件）。

### Added
- **`参考项目/codepilot`**：克隆 v0.62.0 完整源码
- **`项目分析/codepilot-源码分析.md`**（819 行 / 13 章 + 横向对比）：三条可替换 Runtime 架构——Claude SDK（事件泵外包子进程，`claude-client.ts:2239`）/ Native（自研 while 循环，`agent-loop.ts:373`）/ Codex（app-server 子进程，`codex/app-server-manager.ts:603`）。三个独特设计：Runtime 可替换、Harness 能力契约（`harness/context-compiler.ts` 纯函数编译层）、Bridge 权限转发（`permission-broker.ts` 把权限请求转成 IM 内联按钮）
- **`从零构建CodePilot-开发全流程教程.md`**（1718 行 / 26 章）：从 PRD 开始，22 个功能模块按开发顺序罗列（目的/实现形式/技术栈/功能定义取舍/优劣分析/互相配合），第 25 章详解「用户输入提示词 → React → API 路由 → 会话锁 → 上下文组装 → Runtime 分流 → Agent 引擎 → SSE → 渲染 → SQLite」完整工作流
- 两份 HTML 均为 open-design 风格（build-html.py 生成）

---

## 2026-07-31 · 阶段 22：Pi 专线（第十五个样本 · 协议驱动可组合 Agent 基础设施）

> **分析对象**：`earendil-works/pi`（main 分支，8 包 npm monorepo，1034 个 TS/TSX 文件）。

### Added
- **`参考项目/pi`**：克隆源码
- **`项目分析/pi-源码分析.md`**（638 行 / 11 章 + 横向对比）：三个最独特设计——**自扩展 Extensions**（jiti 动态加载 TS，30+ 事件钩子 + registerTool/registerCommand/registerShortcut/registerFlag，Agent 运行时改自己能力面）、**协议驱动进程分离**（pi-protocol 用 CBOR + 长度帧 + TypeBox 校验 + token 鉴权，多客户端 attach 同一 session）、**差分渲染 TUI**（pi-tui 无 React 无 VDOM，`render(width): string[]` 逐行字符串 diff，`\x1b[?2026h/l` synchronized output）。另：双层 while 主循环（`agent-loop.ts:155-275`）、39 Provider（lazyStream 按需加载）、SQLite 事件溯源、不内建权限（容器化方案下沉 OS 级）

### Changed（HTML 升级为手写精修版）
- **`项目分析/pi-源码分析.html`**：自动生成简洁版（54KB）→ 手写精修版，与 `MiMo-Code-解析.html` / `open-design-解析.html` 同源（苹果 UI + Claude blog 设计语言）：6 part / 15 chapter / 12 tw 表格 / 10 note 框 / 5 grid 卡片 / 6 src 徽章 / 3 个 mermaid 架构图 / 分组 toc / 顶部 nav + 底部 footer。原自动版备份为 `pi-源码分析.html.auto-generated.bak`

---

## 2026-08-03 · 阶段 23：OpenWorker 企业级开发方案

> **起因**：用户问「传统大厂里的项目团队开发 openworker 这个项目的流程是怎样的（技术部分、如何搭建、时间表）」。基于 openworker（commit `db93d75`）真实架构，从大厂视角推演落地。

### Added
- **`OpenWorker-企业级开发方案.md`** + `.html`（9 章）：定位与业务价值、组织团队（20~28 人 / 11 角色，峰值 22–28）、技术选型（80% 复用开源底座 + 20% 换企业内部中间件：模型网关/SSO/多租户 DB/审计）、四层架构与 15 个可交付模块、**6 阶段 / 10~12 个月时间表（甘特式）**、6 个关键技术专题（事件流契约 / TurnEngine 并发中断持久恢复 / 权限引擎 / 收件箱幂等 / 调度器防卡死 / Provider 抽象+模型网关）、测试安全合规、风险对策、里程碑清单
- 核心论点：核心引擎（TurnEngine/收件箱/调度器/权限）**原样移植**，只把基础设施层换成企业内部中间件——既快又稳，可随时回退开源基线
- 技术锚点：`engine.py:52,120,156,250,268,388,437` / `permissions.py:37,62,216` / `inbox.py:61,133,295` / `automation/scheduler.py:23,76` / `providers/*`

---

## 2026-08-04 · 阶段 24：Cline 专线（第十八份项目分析 · 可嵌入 Agent 引擎）

> **分析对象**：`cline/cline` main 分支 2026-08 检出（Apache-2.0）。仓库无统一版本号：CLI v3.0.49 / VS Code 扩展（claude-dev）4.1.3 / sdk 各包 0.0.69。**源码获取教训**：git clone 与 tarball 均被网络中断（early EOF / curl 92），最终改用 **git sparse-checkout + blob:none 过滤克隆**（16 秒完成，27MB / 1749 个 `.ts` + 67 个 `.tsx`，覆盖 sdk/packages/* + apps/cli + apps/vscode/src）——大仓库源码获取的可靠方案。

### Added
- **`项目分析/cline-源码分析.md`**（15 章 + 横向对比）+ `.html`（16 part / 31 chapter / 8 tw 表格），6 个并行 Explore agent 深度分析。核心发现：
  - **五层 monorepo**：`shared(20K) ← llms(118K) ← agents(4.6K) ← core(140K) ← apps(CLI 71K / vscode 127K)`，bun workspaces + Biome + vitest
  - **无状态主循环**：`@cline/agents/agent-runtime.ts` 显式 while loop（`execute()` L641），会话层每条用户消息 `new AgentRuntime()` + 全量转录播种 + `run("")` 反复重入——与 Claude Code 长驻 loop 的本质区别；事件链三段翻译（AgentRuntimeEvent 14 → legacy AgentEvent 9 → CoreSessionEvent）
  - **28 个工具**（9 默认 + spawn_agent + 18 team_*）；editor vs apply_patch 双编辑工具（互斥启用）；审批 = 桌面 IPC 文件轮询 200ms + 5min 超时；preset default/yolo
  - **安全护栏**：loop-detection（排序键签名，soft 3 / hard 5）+ mistake-tracker + subprocess-sandbox（SIGTERM→SIGKILL）
  - **MessageBuilder**：增量 reindex + outdated 批量重写(64KB) + 6MB 兜底——全为保 provider 前缀缓存
  - **压缩**：90% 阈值触发；basic（不调 LLM 确定性折叠）/ agentic（LLM 摘要，preserveRecent 20K）；侧车前缀哈希 sha256 防重复压缩
  - **checkpoint**：git commit/stash 快照（三父提交捕获 untracked），回滚先 stash 再动可整体 rollback（`refs/cline/restore-transactions`）
  - **Provider**：Vercel AI SDK（ai@7）+ 内置枚举约 50 ∪ models.dev 生成 163 = **179 个唯一 ID**（并非 200+）；catalog.generated.ts 87K 行 / 4118 模型
  - 三宿主（Local / Hub WebSocket / Remote）、AgentTeamsRuntime 多 agent 协调器、cron SQLite 租约防重、6 IM connectors、WorkOS Device Flow
- **`从零构建Cline-开发全流程教程.md`**（22 章 / 17 个功能模块）+ `.html`（24 part / 126 chapter / 22 tw 表格）：从 PRD（FR/NFR/非目标/验收口径）开始，17 个功能模块按开发顺序罗列（monorepo 脚手架 → shared → Provider → 主循环 → MessageBuilder → 工具审批 → 安全护栏 → 会话存储 → host → CLI → VS Code → 压缩 → checkpoint → 团队 → cron/connectors → 插件/hub → 规则技能），每个模块含目的/实现形式/技术栈/功能定义取舍/优劣分析/如何互相配合 + 验收标准。**第 20 章**「用户输入提示词之后」完整工作流：WebView → 扩展宿主 → ClineCore → LocalRuntimeHost → SessionRuntime → AgentRuntime 主循环 → 模型流式调用 → 事件三段翻译上屏 → 工具执行审批 → 反复运转 → 结果持久化渲染，附完整 mermaid 时序图 + 「打包/发送/接收」精确答疑（本地引擎无服务器上传，只有模型端点网络 IO）

### Verified
- 两份 HTML 结构验证（part/chapter/tw 配平），HTTP 200
- 全部 `文件:行号` 引用来自 6 个分析 agent 对实际检出源码的核对

---

## 2026-08-04 · 阶段 25：最近四项目源码交叉核验与文档纠错

> **起因**：按 CHANGELOG 阶段 21–24 提示，对 **CodePilot / Pi / OpenWorker / Cline** 四份分析（及关联教程/企业方案/HTML）对照 `参考项目/` 源码做交叉核验，并修正高危与中危问题。

### Fixed（P0）
- **CodePilot**：聊天入口 `/api/chat/messages` → 真正触发 Agent 的 `POST /api/chat`；标明 messages 路由仅持久化。同步 `从零构建CodePilot-开发全流程教程.md`。附录区分「符号行号 / 文件总行数」；许可证 BSL→**BUSL-1.1**；API「52」→约 170+ handlers；`permission-checker.ts` 路径纠错。
- **Pi**：默认持久化叙事改为 **CLI = JSONL SessionManager**，SQLite 为 harness 可选 SessionStore；官方 **No MCP** / `proxy.ts` = LLM `streamProxy`；Provider **38**、核心包 **9**。同步 `Pi-解析.html` 对比表与 ch12 说明。

### Fixed（P1）
- **Cline**：Provider「200+」→约 **179** 唯一 ID（枚举≈50 ∪ generated 163）；`AgentRuntimeEvent` **14**（含 `run-failed`）；`composeSystemPrompt` 归属改为 `session-runtime-orchestrator.ts`；宿主路径 `runtime/host/host.ts`。
- **OpenWorker 企业方案**：`_inject_steering` / inbox `:295` / `IntegrationTool`→`ConnectorDescriptor` / persona 同意闸门行号；团队角色口径 9→11、人数区间对齐。分析指路表与 aisuite 文件数（约 21）同步。
- **全量审查汇总报告**：标注 openworker 高危/中危正文已闭环，热力图降级「最需关注」。

### Verified（抽检仍成立的主线）
- CodePilot：`claude-client.ts:2239` / `agent-loop.ts:373` / `app-server-manager.ts:603` / context-compiler 纯编译 / permission-broker
- Pi：双层 while `155-275`、jiti Extensions、CBOR+帧+TypeBox+token、差分 TUI
- OpenWorker：engine/permissions/inbox/scheduler 阶段 23 锚点；Provider 自研边界
- Cline：`execute@:641`、soft3/hard5、MessageBuilder 64KB/6MB、压缩 0.9、git checkpoint、catalog 4118

### Note（未在本阶段改的薄区）
- CodePilot 相对 OD/MiMo 仍缺 `streamClaude` 路由矩阵与跨 Runtime 权限差的硬拆（建议后续加深，非本次纠错范围）
- goose / MiMo 高危（gooseServe 行号、`isMcpToolSearchEnabled`）仍待专轮修正

---

## 2026-08-04 · 阶段 26：Kanban 专线（第十九份项目分析 · 多 Agent 编排看板）

> **对象**：`github.com/cline/kanban`（Apache-2.0），**v0.1.70**（2026-07-12，npm 包名 kanban）。Cline 团队自己的"IDE 替代品"——每张卡片 = 一个独立 git worktree + 一个独立终端会话，让 7 种编码 Agent 并行干活。本阶段完整复刻了阶段 24（Cline 专线）的分析方式。

### Added
- **`项目分析/kanban-源码分析.md`**（15 章 + 横向对比）+ 同名 HTML（16 part / 60 chapter / 9 表格，80KB）
- **`从零构建Kanban-开发全流程教程.md`**（25 章 / 20 功能模块 + 完整工作流）+ 同名 HTML（26 part / 169 chapter / 4 表格，110KB）
- 源码完整克隆至 `参考项目/kanban/`（浅克隆 561 文件 / 9.1MB——规模小，无需 sparse-checkout）

### 关键发现（7 个并行 Explore agent，逐文件核对）
- **架构三理念**（docs/architecture.md）：浏览器只是控制面；本地 runtime 是唯一数据源；两条 Agent 执行路径（PTY 子进程 vs Cline native SDK）
- **一卡一 worktree**：`git worktree add --detach`（不建分支，Commit/PR 时才建）+ gitignored 路径 symlink 回主仓库省 npm install + `.git/info/exclude` 管理 + Turbopack 检测例外；trash 时 patch 存档可 resume
- **hooks 反向注入**：Agent 干活时主动调 `kanban hooks notify`（stdin JSON → tRPC hooks.ingest）实时上报状态；7 种 Agent 各自适配器（agent-session-adapters.ts 1451 行）；Codex 走 wrapper + rollout jsonl 轮询
- **双 WS 终端**：node-pty + io（原始字节）/control（JSON 快照恢复）双通道 + 服务端 headless xterm 镜像 + 背压（100KB 高水位）+ 协议过滤（OSC 10/11 代答）
- **Cline SDK 集成**：@clinebot/core 0.0.38 暴露**有状态多会话宿主 ClineCore**（sessions Map + subscribe 事件流），与 main 分支无状态 AgentRuntime 完全不同——npm 发布版 API 仍在快速演进（0.0.36 兼容分支佐证）
- **乐观并发**：revision + 120ms 防抖 save + CONFLICT currentRevision 回传；**安全四层**：loopback 默认 + Host 白名单 + CORS 精确 Origin + 远程 passcode（8 位码/IP 限流/24h cookie）
- **桌面端**：Electron 纯进程包装器（零根包 import），spawn CLI + HTTP 健康探测 + OAuth 深链 relay
- **dogfood**：仓库自带 .claude/.cline/.codex/.factory 配置，同一仓库被 4 个 Agent 当真实场景用；`npm run dogfood` 用生产构建跑自己

### Verified
- 两份 HTML 结构验证（part/chapter/tw 配平），HTTP 200
- 全部 `文件:行号` 引用来自 7 个分析 agent 对实际检出源码的核对
- 与阶段 24（Cline 分析）交叉印证：kanban 依赖的 ClineCore 与 main 分支 AgentRuntime 是不同 API 模型，已如实标注

---

## 2026-08-04 · 阶段 27：CodexMonitor 专线（第二十份项目分析 · Codex 桌面指挥台）

> **对象**：`github.com/Dimillian/CodexMonitor`（MIT，main 2026-03-26，PR #584）。作者 Dimillian（SwiftUI 名手）。Tauri 2 桌面应用，用官方 `codex app-server` 协议（stdio JSON-RPC）编排多个 Codex agent。本阶段首次引入**与 codex 官方源码的交叉印证**（复用 `参考项目/codex/` 已有检出）。

### Added
- **`项目分析/codexmonitor-源码分析.md`**（15 章，含第 4 章协议交叉印证 + 第 14 章开发思路与品味专章）+ 同名 HTML（16 part / 59 chapter / 9 表格，79KB）
- 源码完整克隆至 `参考项目/codexmonitor/`（浅克隆 860 文件 / 28MB——因仓库含截图资源较慢，6 分钟）

### 关键发现（7 个并行 Explore agent，含 1 个 codex 交叉印证 agent）
- **集成路线**：app-server 官方协议直连（LSP 式握手：initialize + experimentalApi + initialized），**每工作区一个 codex 进程 + 独立 CODEX_HOME**；对比 kanban 的 PTY+hooks 黑盒方案，这是"官方插座 vs 屏幕抓取"的分野
- **协议覆盖**：codex_core.rs 调用约 22 个方法（阶段 29 回核修正，原“约 24”为约数）**全部官方协议方法**（无私有/实验）；与 `参考项目/codex/codex-rs/app-server-protocol` 逐项吻合（握手参数、config.toml 5 字段键名、auth.json JWT 解析、prefix_rule 语法四组交叉印证）
- **shared-core 双进程复用**：领域逻辑收进 `shared/*`（31 文件 11,197 行纯逻辑层，闭包注入副作用），app 与远程 daemon 用 `#[path] include` 共用同一批 `*_core`——为 iOS 远程模式做的架构投资
- **iOS 远程 daemon**：TCP + 行分隔 JSON-RPC（JSONL），daemonctl 用端口反查 PID + 版本比对 + 强杀安全闸门；Tailscale 探测生成建议 host
- **前端**：feature-sliced 25 feature / 103K 行，**零状态库**（无 redux/zustand）+ 无 Tailwind/Radix（19 条运行时依赖，UI 库只有 6 类），纯 useReducer + ref 镜像 + 事件驱动状态机（流式 delta 渲染）
- **git 混合策略**：读用 libgit2（快/类型安全），写用 git CLI（行为保真），GitHub 全走 gh CLI
- **worktree 一等对象**：`WorkspaceEntry{kind: Worktree}` 可增删改查/改名带回滚/改上游——对比 kanban 的"卡片影子"
- **开发思路与品味十选**（第 14 章）：官方协议尊重、shared-core 闭包注入、libgit2+CLI 混合、worktree 一等对象、前端零状态库、依赖极简主义（能自己写就自己写）、macOS 优先不止 macOS、iOS daemon 架构投资、agent 优先开发（AGENTS.md 契约 + codexmap）、防御性编程 + 交互打磨

### Verified
- HTML 结构验证（16 part / 59 chapter / 9 表格），HTTP 200
- 全部 `文件:行号` 引用来自 7 个分析 agent 对实际检出源码的核对
- codex 交叉印证基于 `参考项目/codex/` 真实检出（common.rs / app-server/src/request_processors/initialize_processor.rs / config_toml.rs / rollout protocol.rs / execpolicy parser.rs 等）

---

## 2026-08-04 · 阶段 28：OpenAI4S 分析核查 + Codex 顺带纠错

> **对象**：`项目分析/OpenAI4S-源码分析.md`（基线 `85e9fa0`）+ 顺带 `项目分析/openai-codex-源码分析.md`（基线 `bb1af23`）。用户口述 "openai4s" 初判为 openai-codex，核对仓库后发现真目标为 **PKU-YuanGroup/OpenAI4S**（科研 Agent），已转向。

### Added
- **`项目分析/OpenAI4S-源码分析-核查报告.md`**：含总体评分（行号精度/数字可信度/机制描述/推论纪律/完整性五维）、1 处 WRONG + 关键 PARTIAL 清单、评价优点、四类优化建议、附录批量 PARTIAL 表、Codex 顺带核查附录
- **HTML 交付闭环补全**：生成 `OpenAI4S-解析.html`（26 part / 71 chapter / 23 tw / 82KB）+ `项目分析/openai-codex-源码分析.html`（35 part / 122 chapter / 38 tw / 99KB）——两份分析的 HTML 此前从未生成

### Changed（就地修正 OpenAI4S 分析）
- 🔴 **WRONG**：18.1 权限层路径 `security/permissions.py` → 顶层 `openai4s/permissions.py`（审批 broker），同名 `security/permissions.py` 仅管文件权限位；23.1 第 13 行同步纠正
- 🟡 PARTIAL：13.2 事件类型表（`cell`/`artifacts`/`permissions` 非 WS type，真实为 `artifact_created`/`permission_resolved` 等）；19.3 fd3/fd4（Python worker 无此常量，是 R 通道专有）；17.1 ssh 非 shim 例证；2.2 `CLAUDE.md:11`→`:90`；18.3 标注 `egress.py` docstring 已过期；选择七 漏 `sdk/host.py`；14.1/23.1 路径统一为 `openai4s/server/webui/app.js` 与顶层 `egress.py`

### Changed（就地修正 Codex 分析，误判目标的 bonus）
- 🔴 **WRONG×4**：9.3 previous-model compact 机制张冠李戴（1032-1040 是回退上下文捕获，非压缩开关）；15.4/15.7 Landlock/bwrap 框架倒置（Landlock FS 已 unused，bwrap 才是 Linux FS 主实现）；3.2 exec-server 非隐藏；22.1C `debug_input` 虚构标识符
- 🟡 PARTIAL×5：16.2 with_cached_approval 71-117；11.2 built_tools 补路径；11.3 CodeMode 目录归属；20.3 rollout 路径前缀；22.3 turn.rs 补 crate 路径
- 为 `build-html.py` 新增 `项目分析/openai-codex-源码分析.md` 条目

### Verified
- OpenAI4S 6 个并行 Explore agent 核查：数字断言（255/114k/286/34/70/0）全精确、行号抽查 10 处 0 漂移、品味章节已自标推论
- 所有 WRONG/PARTIAL 修正均回 `参考项目/OpenAI4S`（85e9fa0）与 `参考项目/codex`（bb1af23）源码逐一核对
- 根目录 `OpenAI4S-源码分析.md` 与 `项目分析/` 副本已同步

---

## 2026-08-05 · 阶段 29：阶段 23–27 全量回核（近三日产出对照源码逐条纠错）

> **起因**：用户要求「根据 CHANGELOG 对这三天所有更新的内容结合源码核查有没有错误、能如何优化」。范围 = 阶段 23（OpenWorker 企业方案）/ 24（Cline 专线）/ 25（四项目交叉核验）/ 26（Kanban 专线）/ 27（CodexMonitor 专线），共 9 份 MD + 8 份 HTML。方法：`.workbuddy/verify_citations.py`、`verify_linecounts.py`、`verify_names.py` 三支脚本跑全量，再对每条告警回源码手核（跨仓文档对两个仓各跑一次）。
>
> ✅ **本阶段已收尾（2026-08-05）**：交接文档 [`阶段29-回核交接.md`](./阶段29-回核交接.md) 中的 R1–R3 全部落地并验证，R4 中两项已实施，剩余为可选建议。

### Fixed（阶段 29 收尾 · 交接文档 R1–R3 + 额外核出）
- **Pi 8 包 → 9 核心包**：`项目分析/pi-源码分析.md` L15/L562、`Pi-解析.html` 9 处、`总目录.md` L66/L206、`总目录.html` 4 处、`项目分析/cline-源码分析.md` L341 对比表、`build-html.py` Pi CONFIG 全部改为 9（源码依据：`packages/` 9 个目录，`packages/storage/sqlite-node/` 才是包）
- **Pi 39 Provider → 38**：`Pi-解析.html` stat/对比表、`总目录.md`、`总目录.html`、`build-html.py` Pi CONFIG 全部改为 38（源码依据：`packages/ai/src/providers/all.ts` 的 `builtinProviders()` 实为 38 项）
- **`总目录.html` 对齐 `总目录.md`**：标题「十五大」→「十八大」、intent card 同步、补 cline/kanban/codexmonitor 三张项目卡、补「独立静态 HTML」5 个页面、OpenWorker 卡改 40 个连接器描述符、Pi 卡改 9 包/38 Provider
- 🔴 **CodexMonitor 官方协议方法实为 22 个**（原「约 24」）：`codex_core.rs` 的 `send_request_for_workspace` 逐一数出 22 个唯一方法名；已同步 `项目分析/codexmonitor-源码分析.md`、`build-html.py`、`总目录.md/html`、`html-hub.html` 及本 CHANGELOG
- 🔴 **`account/read` fallback 行号修正**：原写 `src-tauri/src/shared/account.rs:636–650`（越界），实际为 `src-tauri/src/shared/codex_core.rs:627–650` 的 `account_read_core`；`account.rs:63–99` 仅 auth.json 解析
- **`25+ 连接器` 全仓精确化**：`项目分析/openworker-源码分析.md` ×5、`项目分析/横向对比与总结评价.md` ×5、`项目分析/codepilot-源码分析.md` ×1、`从零构建AI同事-OpenWorker系-开发全流程教程.md` ×1、`CodePilot-解析.html` ×1 全部改为「40 个连接器」；图例举例按要求保留
- `build-html.py` 体积打印改为 `len(html.encode('utf-8'))`（KB 不再按字符数低估）

### Fixed（Kanban · 口径混用为主）
- `agent-catalog.ts` **89 行 → 95 行**（唯一的纯数字错）
- `web-ui/ 269 文件 / 58,039 行` 是两套口径拼在一起：269 = `web-ui/` 全目录所有文件，58,039 = `web-ui/src` 下 ts/tsx（该口径文件数是 **240**）。四处改成「`web-ui/src` 240 个 ts/tsx 文件 58,039 行（`web-ui/` 全目录 269 文件）」
- `packages/desktop 2,602 行` 对不上任何口径 → **`packages/desktop/src` 11 个 TS 文件 2,327 行**（含 `disconnected.html` 152 行时为 2,479）
- 仓库规模 `560 个文件` → **561**；`test/ 40+ 测试` → **`test/` 59 个，全仓 143 个**
- 教程：Provider `200+` → **179 个 Provider ID**（阶段 25 的修正此前漏传）

### Fixed（Cline · 行号越界 + 版本口径 + 阶段 25 修正漏传）
- 🔴 `pending-prompt-service.ts:386` **越界**（文件共 385 行）→ **`:372-379`**（`insertUpdatedPrompt` 在 372，steer 的 `unshift` 在 378–379）；附录锚点同步为 `:54,207,281,295,372`
- **版本号口径**：`v3.0.49` 只是 `apps/cli`。三处改为「仓库无统一版本号：CLI v3.0.49 / VS Code 扩展（`claude-dev`）4.1.3 / `sdk/packages/*` 同为 0.0.69 / 根 `package.json` 不带 version」
- TS 文件数 `1749` 是 `.ts` 单口径 → **1749 `.ts` + 67 `.tsx` = 1816**
- 阶段 25 已修正的「Provider 179」「AgentRuntimeEvent 14」**从未传到教程**：教程 8 处 `200+` 与 1 处 `13 种事件` 全部补齐
- 路径补全：`main.ts:944` → `apps/cli/src/main.ts:941-946`；两处 `shared/...` 缩写 → `sdk/packages/shared/src/llms/tools.ts:7` 与 `sdk/packages/shared/src/tools/create.ts:81`
- 对比表 OpenWorker「25+ 连接器」→ **40 个连接器描述符**

### Fixed（CodexMonitor · 路径前缀 + 数量 + 枚举完整性）
- 🔴 **Tauri 命令「约 90 个」→ `generate_handler!` 实际注册 125 条**（源码共 138 处 `#[tauri::command]`，差额是 dictation/terminal/menu 按 cfg 分桌面/移动两套实现）。三处正文 + `build-html.py` 的 stats 同步
- 🔴 `src/shared/codex_core.rs` 等 6 处**缺 `src-tauri/` 前缀**（`codex_core.rs` / `local_usage_core.rs` / `account.rs` / `rules.rs` / `bin/codex_monitor_daemon.rs` / `workspaces_core/connect.rs`）
- 🔴 `RolloutItem` 写成 4 个变体，实际 **8 个**（`SessionMeta | ResponseItem | InterAgentCommunication | InterAgentCommunicationMetadata | Compacted | TurnContext | WorldState | EventMsg`，`codex-rs/protocol/src/protocol.rs:3186–3199`）
- 🔴 `Personality` 枚举漏 `None`，实际 **`None | Friendly | Pragmatic`**（`codex-rs/protocol/src/config_types.rs:311–317`）
- **跨仓引用全部补全为仓库相对全路径**（`protocol.rs:3380` / `common.rs:482` / `config_toml.rs:455` / `features/src/lib.rs:656` / `bespoke_event_handling.rs:1872–2018` / `initialize_processor.rs:70–101`）；§4.1 加一句「本节所有 `common.rs:` 行号均指 `codex-rs/app-server-protocol/src/protocol/common.rs`（4072 行）」
- `collab` 拒绝逻辑归属 → `CodexMonitor src-tauri/src/codex/config.rs:50–53`

### Fixed（OpenWorker / Pi / CHANGELOG 自身 / 索引层）
- OpenWorker 企业方案：`25+ 连接器` → **40 个 `ConnectorDescriptor`**（`descriptors.py` 的 `DESCRIPTORS`）；阶段 23 条目里「峰值 22 人 / 9 角色」与阶段 25 已改的「11 角色 / 20–28 人」冲突，已对齐；锚点补回 `engine.py:388`
- Pi：「官方明确 No MCP」引用从仓库根 `README.md` / `docs/usage.md` → **`packages/coding-agent/README.md:495` / `packages/coding-agent/docs/usage.md:301`**（仓库根没有 `docs/`）
- CHANGELOG：份号 第十六 → 第十七 → **第二十** 跳掉了 18/19，统一为 **第十八 / 第十九 / 第二十**；三处 HTML 体积 KB 取自 `build-html.py` 打印的**字符数**而非字节数（中文 3 字节），61→80 / 80→110 / 59→79
- **可发现性**：`总目录.md` 补 cline / kanban / codexmonitor 三行分析条目 + 5 行站点条目、标题「十五大」→「十八大」、参考源码树补三仓；`html-hub.html` 新增三条专线共 5 张卡（29 条链接全部可解析）；`文档与站点索引.md` 已被 `总目录.md` 取代，改标为「存档快照 · 冻结于 2026-07-31」并加提示横幅

### Verified（抽检成立、未改）
- OpenWorker 10/10 引用与技术栈版本；CodePilot 阶段 25 修正全部落地；Pi 27/27 引用 + 9 包 / 38 provider / 1034 TS 文件
- Cline：179 Provider ID（50 ∪ 163）、28 工具、0.9/20K 压缩、64KB/6MB MessageBuilder、soft3/hard5、200ms/5min 审批、catalog 87,274 行 / 4118 模型、`agent-runtime.ts` 1969 行
- Kanban：120ms 防抖、100KB 高水位、:3484、passcode 8 位/5 次/30s/24h、OSC 10/11、base64url checkpoint ref、`src/` 92 文件 30,402 行、`App.tsx` 1199 行、`components/` 89 文件、7 种 Agent（启用 5）
- CodexMonitor：22 个协议方法（codex_core.rs 实调；原“24”为约数）、`shared/` 31 文件 11,197 行、25 feature / 496 文件 / 102,856 行、rust 92 文件 31,171 行、daemon 1966 / daemonctl 1414、`threadReducer/` 6 文件 1179 行、`local_usage_core.rs` 840 行、四组 codex 交叉印证
- 8 份 HTML 重新生成后 div 标签全配平、part/chapter/表格数与 CHANGELOG 一致、`总目录.md`/`总目录.html`/`html-hub.html` 共 163 条链接零断链、8 个页面 HTTP 200

### 优化建议（部分已实施，其余留作后续）
1. **`build-html.py` 的数字是硬编码副本**：`CONFIG` 里 `stats`/`dek`/`description` 的数字改 MD 不会同步（本次 cline 的 179、codexmonitor 的 125/19 都是这么漏的）。建议改成从 MD 正文抽取，或加一支「脚本数字 vs MD 数字」比对检查
2. ✅ **脚本打印字符数当体积**：已改为 `len(html.encode('utf-8'))`
3. **所有文件数/行数必须带口径**：阶段 23–27 一半的错都是「哪个目录 + 哪些后缀」没写清。建议在分析模板里固定写成「`<目录>` N 个 `<后缀>` 文件 / M 行」
4. **`verify_citations.py` 按 basename 解析**，跨仓文档必然误判（`protocol.rs`/`account.rs`/`main.ts` 都撞名）。建议加 `--repo-prefix` 参数要求文档写全路径，把「路径不全」本身报成告警
5. ✅ **模糊下界数字（`25+`/`200+`/`约 90`/`40+`）已全部换成精确数 + 口径**：全仓 `25+ 连接器` 归零（除 CHANGELOG 历史记录与图例举例）
6. **阶段性修正要有传播检查**：阶段 25 改了分析正文，但教程、HTML 生成脚本、`.workbuddy/memory/` 日志都没跟上。建议纠错后跑一次全仓 grep 确认旧数字归零（本次已对 `200+ Provider` / `560 个文件` / `约 90 个 Tauri` 做过）

---

## 2026-08-05 · 阶段 30：总目录固定入口 + 自动更新机制

> 用户诉求：「总目录.html 是什么，能否固定下来随时打开，每次更新内容都自动添加」。本阶段把总目录变成项目的常驻入口，并建立「改了内容 → 自动进总目录」的机制。

### Added
- **`update-catalog.py`**：扫描根目录 `.md`/`.html`、`项目分析/`、`调查报告/`，把新增/修改/删除的文件自动记入 `.workbuddy/catalog-state.json`，并重写 `总目录.html` / `总目录.md` 的「最近更新」区（`AUTO-CATALOG` 标记之间）。首次运行只播种存量文件，不会把老文件误报成新增
- **`打开总目录.command`**：双击即可刷新总目录 → 启动本地预览 → 浏览器打开 `总目录.html`
- **`AGENTS.md`**：项目协作规则，要求每次增删改内容后运行 `python3 update-catalog.py`，禁止手改自动区，提交前重跑生成脚本
- `start-html-previews.sh`：启动前自动刷新总目录，保证打开即最新
- `总目录.html` / `总目录.md`：新增「🆕 最近更新（自动维护）」区（含搜索关键词，可被站内搜索命中）

### Verified
- 首次播种 78 个存量文件、0 误报事件
- 新建测试文件 → 脚本自动生成「新增」卡片与表格行；删除后重置状态无残留
- `bash -n` / `py_compile` 语法检查通过

### Note
- 自动区负责「被发现」；正式分区（学习站/项目分析/文档卡片）仍需按现有格式手动补齐，规则已写进 `AGENTS.md`
- 提交时 `.gitignore` 已排除 `node_modules/`、`dist/`、`参考项目/`、`claude-code/`

---

## 2026-08-05 · 阶段 31：Kanban / CodexMonitor 分析页换用 Hermes 官网风格

> 用户诉求：`kanban` 和 `codexmonitor` 的源码分析 HTML 使用 hermes agent 官网的样式 UI。

### Changed
- `build-html.py` 新增 `HERMES_THEME` 路由与 `build_hermes_html()`：`项目分析/kanban-源码分析.md`、`项目分析/codexmonitor-源码分析.md` 重新生成时自动套用 Hermes 风格
- 风格取自官网实抓（hermes-agent.nousresearch.com）：主色 `#0000f2` 亮蓝、浅色正文 `#f5f5f5`、大号衬线大写标题、等宽字体眉标、白纸正文区 + 蓝色表头/页码脚、`文件:行号` 等宽徽标
- 中文字体微调：标题/品牌/页脚大字用「圆体/楷体」这类更有艺术感但不影响识别的字体（`Yuanti SC` → `Kaiti SC` 回退），正文用苹方保证长文可读，等宽眉标的中文回退苹方
- 两份 HTML 已重新生成：`项目分析/kanban-源码分析.html`（87.7KB）、`项目分析/codexmonitor-源码分析.html`（87.7KB），全部内容（16 part / 章 / 表格 / mermaid）保留
- `总目录.md` / `总目录.html` / `html-hub.html` 的对应条目补注「Hermes 官网风格」

### Verified
- 两份页面 div 标签配平、HTTP 200
- 重新运行 `python3 build-html.py` 两目标文件无报错，后续全量生成不会丢风格

---

## 2026-08-05 · 阶段 32：DeepSeek-Reasonix 分析源码核查 + 动机叙事补强

> 用户诉求：结合源码核查 `DeepSeek-Reasonix-源码分析.md` 有无错误，并优化技术架构阐述逻辑，最大限度还原开发者原始动机与思考。

### Verified（对照 `参考项目/DeepSeek-Reasonix @ 627b051` 逐条核对）
- 代码规模全部命中：1686 个 `.go`、`internal/` 非测试 216,079 行、全仓含测试 553,005 行
- 关键行号引用成立：`README.zh-CN.md:42-43`、`REASONIX.md:11-16/64-71`、`run_loop.go:274-355`、`execute_one.go:65-101`、`compact.go:20-37`、`cache_shape.go:13-48`、`control/input.go:181-183`、`docs/SPEC.md:54-56`
- 结构事实成立：`controller.go` 6560 / `chat_tui.go` 5154 / `agent.go` 4362 行；17 个 Extension hook；BM25 默认 4 facts / 2400 chars；双模型双 session；Windows Bash 沙箱固定 off；MCP stdio 不继承 Bash 沙箱；`move_file` 未实现 Previewer；ACP 无 image/audio、MCP http:true/sse:false；`SivanLiu.reasonix-agent` 扩展

### Fixed
- `agent.go:1381-1387` → **`agent.go:1388-1394`**（`observeMissingToolCallReasoning` 函数体实际起始行）

### Added
- **附录 C · 开发者动机还原**：从「成本焦虑」到「架构宪法」的因果链（README 定位 → REASONIX 宪法 → SPEC 双模型约束/compaction 即 cache-reset → PR 元数据 → turn tail 注释 → Economy 档），并给出「动机 → 约束 → 被否方案 → 选择 → 代价」五段式重写建议
- 根目录与 `项目分析/` 两份副本已同步为同一内容（728 行 / 12 章 + 附录 C）；`总目录.md` 行数同步

---

## 2026-08-05 · 阶段 33：DeepSeek-Reasonix 分析按动机驱动五段式重写 + HTML 版上线

> 用户诉求：按上轮建议重写 `DeepSeek-Reasonix-源码分析.md`，生成 HTML 版，并全部加入总目录。

### Changed
- **全文重写（733 行 / 18 章 + 附录 A/B/C）**：从「是什么→在哪里」改为「**动机 → 约束 → 被否方案 → 选择 → 代价**」主线
  - Part I 起点：痛点与洞察、动机证据表（README / REASONIX / SPEC 原话）
  - Part II 思维导图：从「前缀必须稳定」推出十项设计；双模型为何分 session
  - Part III 实现：runToolLoop / Compose / 压缩三阶梯 / 工具 ABI / 权限沙箱 / Checkpoint+Delivery / Controller / 记忆扩展
  - Part IV 品味边界：十项决策五段式复盘表、横向对比、诚实边界、源码索引
  - 附录 C 浓缩为动机证据对照表
- **根目录与 `项目分析/` 副本同步**
- `build-html.py` 新增 `项目分析/DeepSeek-Reasonix-源码分析.md` CONFIG，生成 **`项目分析/DeepSeek-Reasonix-源码分析.html`**（68.9KB，open-design 系列风格）

### Added（总目录）
- `总目录.md`：独立静态 HTML 表新增 HTML 版行；项目分析行更新 733 行 / 18 章并链到 HTML
- `总目录.html`：intent 卡、项目分析卡、静态 HTML 卡三处新增 DeepSeek-Reasonix
- `html-hub.html`：新增「DeepSeek-Reasonix 专线」区块（HTML + MD 两张卡）

### Verified
- HTML 生成无报错，div 标签配平（102/102）
- 两份 MD 副本 diff 一致

---

## 2026-08-05 · 阶段 34：DeepSeek-Reasonix HTML 换用 Claude blog 版式

> 用户诉求：`项目分析/DeepSeek-Reasonix-源码分析.html` 参考 Claude blog 的 UI 形式。

### Changed
- `build-html.py` 新增 `CLAUDE_BLOG_THEME` 与 `build_claude_blog_html()`，DeepSeek-Reasonix 页面改走 Claude blog 版式（与 open-design / OpenAI4S 手写站同款）：
  - 吸顶毛玻璃导航 + Part 锚点
  - Hero 大标题 + meta chips + stats
  - 左侧粘性 TOC（Part 分组 + Chapter 链接）
  - 正文 Part 分块 + `Chapter NN` 编号 + 黏土色强调
- **修复 Python-Markdown 解析怪癖**：前文 + 后续 fenced code 会把 Part 标题吞成纯文本；生成器先暂存所有代码块、转换完再还原 `<pre>`，Part I–IV 与 18 章 + 附录全部正确渲染

### Verified
- 4 个 Part、18 章 + 3 个附录、4 张 Mermaid、6 个代码块全部渲染
- div 标签配平（78/78）、HTTP 200、无占位符残留

---

## 2026-08-06 · 阶段 35：全站 UI 统一为课程讲义风格 + 字体系统升级

> 用户诉求：参考 `ai.richardxu.com/ml/#/m/transformer` 的模块 UI 与讲义叙述风格全面重构；再升级整套字体系统使其更有设计感。

### Changed
- 新增 `assets/lecture-site.css` 统一设计系统（白底 + 靛蓝/teal 光晕、Inter 大标题、模块卡、统计玻璃卡、章节侧栏、「章 N」编号、关键思想提示条），全部 27 个静态 HTML 统一走该设计系统（替代 od-site / Hermes / Claude blog 三种旧风格）
- 修复 `项目分析/` 下页面 CSS 与返回链接的相对路径错误（`./assets/...` → `../assets/...`）
- 字体系统升级：Google Fonts 引入可变字体 `Inter`（opsz/wght）+ `Inter Tight`（显示字体，标题 900/850 + 紧字距）+ `JetBrains Mono`（等宽）；正文 450 字重、行高 1.78、`text-wrap: pretty`；眉题/标签 800 + 0.2~0.24em 字距；统计数字等宽 + tabular-nums；引用块渐变边条
- `md-view.html`、两个自包含教程页（`build-claude-code.html`、`从零构建通用任务Agent-Manus系-开发全流程教程.html`）同步接入新设计系统
- 四个 Vite 学习站（claude-code-learn / claude-code-learn-v2 / openmanus-suna-learn / build-an-agent-guide）主色对齐靛蓝并重建 dist

### Verified
- `python3 build-html.py` 全部生成成功；`update-catalog.py` 刷新无报错
- 提交 `95148f2`（UI 统一）与 `1823dff`（字体系统）

---

## 2026-08-07 · 阶段 36：全项目零背景交接文档重写（换新电脑用）

> 用户诉求：要换新电脑，为完全无项目背景的 agent 写一份覆盖所有技术细节与功能调用的 `handoff.md`。

### Added
- `handoff.md` 全面重写：目录地图、产物体系、全部脚本/功能调用清单（update-catalog / build-html / 预览脚本 / md-view / html-hub / verify 三件套 / Vite npm 功能 / 手写站 JS）、设计系统规范、新电脑一次性搭建清单、日常工作流、新增项目分析标准流程、质量底线、已知坑与排查表
- 明确记录「新机器首次运行 update-catalog 需先删除 catalog-state.json 重新播种」等换机关键细节

### Changed
- `CHANGELOG.md` 补记阶段 35（UI/字体，此前提交未写日志）

### Verified
- `update-catalog.py` 刷新总目录无报错；git 提交后工作区干净

---

## 产物总览（当前状态）

| 产物 | 路径 | 状态 |
|---|---|---|
| 初版科普（旧） | `Claude-Code-工作原理科普.md` | 保留存档 |
| 深入版主文档（14 章 36 图） | `Claude-Code-工作原理科普-深入版.md` | ✅ 完成 |
| 调查素材（3 份） | `调查报告/` | ✅ 完成 |
| 编程助手系分析（CC 外 + nanobot + grok-build） | `项目分析/`（含横向对比） | ✅ 完成 |
| 横向对比与总结评价（**十一大 Agent**，含第七章 Open Design、第八章 MiMo Code） | `项目分析/横向对比与总结评价.md` | ✅ 完成 |
| **CodePilot 源码分析（13 章 + 横向对比）** 🆕 | `项目分析/codepilot-源码分析.md` · `.html` | ✅ 完成（阶段 21） |
| **CodePilot 从零构建教程（26 章 / 22 功能模块）** 🆕 | `从零构建CodePilot-开发全流程教程.md` · `.html` | ✅ 完成（阶段 21） |
| **Pi 源码分析（11 章 + 横向对比，HTML 手写精修版）** 🆕 | `项目分析/pi-源码分析.md` · `.html` | ✅ 完成（阶段 22） |
| **Cline 源码分析（15 章 + 横向对比）** 🆕 | `项目分析/cline-源码分析.md` · `.html` | ✅ 完成（阶段 24） |
| **Cline 从零构建教程（22 章 / 17 功能模块 + 完整工作流）** 🆕 | `从零构建Cline-开发全流程教程.md` · `.html` | ✅ 完成（阶段 24） |
| **Kanban 源码分析（15 章 + 横向对比）** 🆕 | `项目分析/kanban-源码分析.md` · `.html` | ✅ 完成（阶段 26） |
| **Kanban 从零构建教程（25 章 / 20 功能模块 + 完整工作流）** 🆕 | `从零构建Kanban-开发全流程教程.md` · `.html` | ✅ 完成（阶段 26） |
| **CodexMonitor 源码分析（15 章，含协议交叉印证 + 品味专章）** 🆕 | `项目分析/codexmonitor-源码分析.md` · `.html` | ✅ 完成（阶段 27） |
| **OpenAI4S 源码分析（23 章 7 Part，含品味反推 + 横向对比）** 🆕 | `OpenAI4S-源码分析.md` · `OpenAI4S-解析.html` · `项目分析/OpenAI4S-源码分析.md` | ✅ 完成（今日生成），已核查修正 1 WRONG + 关键 PARTIAL（阶段 28） |
| **从零构建 OpenAI4S 教程（22+ 模块 + 思维链）** 🆕 | `从零构建OpenAI4S-开发全流程教程.md` · `.html` | ✅ 完成 |
| **OpenAI4S 分析核查报告（评价 + 错误清单 + 优化建议）** 🆕 | `项目分析/OpenAI4S-源码分析-核查报告.md` | ✅ 完成（阶段 28） |
| **OpenWorker 企业级开发方案（9 章）** 🆕 | `OpenWorker-企业级开发方案.md` · `.html` | ✅ 完成（阶段 23） |
| **全量审查汇总报告（约 73 条错误：3 高危 / 18 中危 / ~52 低危）** 🆕 | `全量审查汇总报告.md` | ✅ 完成（阶段 20） |
| **Open Design 源码分析（18 章 13 图）** 🆕 | `项目分析/open-design-源码分析.md` | ✅ 完成并通过浏览器验收 |
| **从零构建教程（AI 设计 Agent · 路线 D）** 🆕 | `从零构建AI设计Agent-OpenDesign系-开发全流程教程.md` · `.html` | ✅ 完成并通过浏览器验收 |
| **Open Design 解析站（4 个交互实验台）** | `open-design-解析.html` · `assets/od-site.{css,js}` | ✅ 完成并通过浏览器验收 |
| **MiMo Code 源码分析（20 章 9 图，含第 20 章逐层差分）** 🆕 | `项目分析/MiMo-Code-源码分析.md` | ✅ 重写完成并通过核对 |
| **MiMo Code 解析站（5 个交互实验台，含归属核对台）** | `MiMo-Code-解析.html` · `assets/mimo-site.js` | ✅ 完成并通过浏览器验收 |
| **MiroFish 源码分析（17 章 13 图 · 非编程 Agent）** 🆕 | `项目分析/MiroFish-源码分析.md` | ✅ 完成并逐行号核对 |
| **MiroFish 解析站（5 个交互实验台）** | `MiroFish-解析.html` · `assets/mf-site.js` | ✅ 完成并通过浏览器验收 |
| **OpenAI Codex 源码分析（28 章加深版）** 🆕 | `项目分析/openai-codex-源码分析.md` · `项目分析/openai-codex-源码分析.html` | ✅ 审计 + 补深完成；阶段 28 核查修正 4 WRONG + 5 PARTIAL 并补生成 HTML |
| **Claude Code × OpenCode × Codex 三方对比** 🆕 | `项目分析/Claude-Code-vs-OpenCode-vs-Codex-深度对比.md` | ✅ 完成 |
| **Codex 解析站（5 个交互实验台，全部逐行移植）** | `openai-codex-解析.html` · `assets/codex-site.js` | ✅ 重做完成并通过浏览器验收 |
| **七大 Agent 架构图库（7 项目 9 图 6 图型）** 🆕 | `架构图库.html` · `assets/gallery-site.js` | ✅ 完成并通过浏览器验收 |
| **架构图方法论三件套（规范 + 两轮审阅）** 🆕 | `架构图绘制规范-给图库Agent.md` 等 3 份 | ✅ 完成，19 处勘误已闭环 |
| **Agent 工程模式目录（15 章）** 🆕 | `Agent工程模式目录.md` · `.html` | ✅ 完成，15 章从十三份分析提取 |
| **按水平分级的阅读路线** 🆕 | `按水平分级的阅读路线.md` · `.html` | ✅ 完成，四阶段 + 零基础指南 |
| **Agent 评测与基准测试** 🆕 | `Agent评测与基准测试.md` · `.html` | ✅ 完成，四层评测 + 论文索引 |
| **后续待剖析的开源项目推荐列表** 🆕 | `后续待剖析的开源项目推荐列表.md` · `.html` | ✅ 完成，12 个项目按优先级排 |
| Manus 系分析（OpenManus / Suna / 横向） | `项目分析/OpenManus-*.md` · `Suna-源码分析.md` · `OpenManus-vs-Suna-横向对比.md` | ✅ 完成 |
| 从零构建教程（编程助手，含客户端章） | `从零构建AI编程助手-开发全流程教程.md` | ✅ 完成 |
| 从零构建教程（Manus 系通用任务） | `从零构建通用任务Agent-Manus系-开发全流程教程.md` · `.html` · `openmanus-suna-learn/public/build-guide.html` | ✅ 完成 |
| 网站 v1（苹果官网风，含八大 Agent） | `claude-code-learn/` | ✅ 完成并通过验收 |
| 网站 v2（蓝皮书风，含八大 Agent） | `claude-code-learn-v2/` | ✅ 完成并通过验收 |
| Agent 开发指南网站（含客户端章） | `build-an-agent-guide/` | ✅ 完成并通过验收 |
| Manus 系学习站（OpenManus × Suna） | `openmanus-suna-learn/`（:7200） | ✅ 完成并通过验收 |
| HTML 生成器（open-design 风格） | `build-html.py` | ✅ 完成（阶段 19 完全重写） |
| 参考源码树（含 OpenManus、suna、codex、codepilot、pi、cline、kanban、codexmonitor） | `参考项目/` | ✅ 在用 |
| 交接文档（阶段 36 全面重写 · 零背景可上手） | `handoff.md` | ✅ 完成 |
| **阶段 29 回核交接说明（未竟事项 + 精确行号 + 验收标准）** 🆕 | `阶段29-回核交接.md` | ⚠️ 进行中，接手必读 |