Skip to content

sync(zh): 上游交互图表系统全量同步(133 课 figure + 13 渲染模块)#24

Merged
fancyboi999 merged 1 commit into
mainfrom
sync/upstream-figure-system
Jun 12, 2026
Merged

sync(zh): 上游交互图表系统全量同步(133 课 figure + 13 渲染模块)#24
fancyboi999 merged 1 commit into
mainfrom
sync/upstream-figure-system

Conversation

@fancyboi999

Copy link
Copy Markdown
Owner

概要

同步上游 PR #279(b963cf63..148de366)curriculum-wide interactive figure system —— 134 widgets / 13 modules。

改动

类别 内容
A 类(docs) 133 个课程 docs/zh.md 各插 1 个 ```figure 块,锚点与上游 en.md 严格一致:108 个在「动手构建」前、23 个在「实际使用」前、2 个在「架构」前(capstone 27/28)。figure 名属代码不翻。另随上游把 debugging-neural-networks 的 **类型:** Practice → Build
B 类(照搬) 13 个新 site/figures-*.js(约 5.9k 行)+ lesson-figures.js 升级版(LF 工具集导出 + 新渲染器),与上游 byte 级一致
C 类(保护) lesson.html 仅手动追加 13 个 script 引用、版本号 20260607a → 20260610e;findH2 / Vercel Analytics / 动态 SEO 等 zh 特化未动
跳过 上游 site/data.js 构建产物(本仓 node site/build.js 重建,仅时间戳变化)
基准 .sync-upstream-base 推进至 148de366

验证

  • ✅ 强校验:全 133 文件「上游 en.md 新版 figure 名序列 == zh.md figure 名序列」逐一比对一致
  • ✅ 渲染器覆盖:全仓 docs 中 137 个 figure 名(新 133 + 存量 4)全部能在 figures*.js 注册表中找到渲染器,无「空代码块」风险
  • ✅ 本地冒烟:临时测试页加载全部 14 个 figure JS、渲染 137 个 figure → MOUNTED=137 FAIL=0,widget(滑杆/SVG 动画)真实交互正常
  • node site/build.js --check 通过(503 课 / 20 阶段,全部计数一致)
  • ✅ 线上对照:现网 attention-matrix(存量 figure)正常渲染零报错;新版 lesson-figures.js 的 mount/fallback 逻辑与旧版逐行一致

没验证到的(fail-loud)

  • ⚠️ lesson 页真实链路的新 figure 渲染只能合并后验证(lesson.html 运行时 fetch main 分支 raw zh.md,合并前线上/preview 均看不到新块)。合并后会线上抽查多课。
  • ⚠️ 冒烟页一次性挂 137 个 figure 时 figures.js(本次未改的存量文件)的两个大动画在动画 tick 抛 TypeError;线上单课真实环境实测无此错误,判定为测试页多实例并发的环境差异,非本次回归。
  • ⚠️ 13 个新模块的 widget UI 文案为英文照搬(与现有 lesson-figures.js kv-cache 等先例一致,TRANSLATION.md 未约定 figure 文案翻译)。

上游 PR #279(b963cf63..148de36)curriculum-wide interactive figure system:

- A 类:133 个课程 docs/zh.md 各插入 1 个 ```figure 块,锚点与上游
  en.md 一致(108 个在「动手构建」前、23 个在「实际使用」前、
  2 个在「架构」前);figure 名属代码不翻。
  debugging-neural-networks 类型 Practice→Build 随上游。
- B 类:13 个新 figures-*.js 渲染模块 + lesson-figures.js 升级
  (LF 工具集 svgEl/select/clamp/lerp/raf + 新渲染器)1:1 照搬上游。
- C 类:lesson.html 仅手动加 13 个 script 引用 + 版本号 20260610e,
  zh 特化(findH2/Analytics/SEO)未动。
- 跳过上游 data.js 构建产物,本仓 node site/build.js 重建。
- .sync-upstream-base 推进至 148de36。

验证:figure 名序列 en/zh 全 133 文件一致;137 个 figure 名全部有
渲染器;本地冒烟页 137/137 挂载渲染成功;build --check 503 课通过。
@vercel

vercel Bot commented Jun 12, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ai-engineering-from-scratch-zh Ready Ready Preview, Comment Jun 12, 2026 2:07am

@fancyboi999 fancyboi999 merged commit 8f29083 into main Jun 12, 2026
3 checks passed
@fancyboi999 fancyboi999 deleted the sync/upstream-figure-system branch June 12, 2026 02:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant