Repository navigation
packages/runner/README.md §Features 的「Hot Reload - Automatic reload on schema changes」未按 loader 分路,?api= 那条不成立 #3620
Description
越界发现,记录于 #3604(改写同文件 §Development Workflow 第 1、3 步)期间通读全文时。未在该 PR 中顺手修改 —— #3604 的派发范围被明确锁死在 §Development Workflow 这一节,这是 §Features,属另一处改动面。
事实(对 origin/main 复核)
packages/runner/README.md 第 8 行,§Features 列表:
- **Hot Reload** - Automatic reload on schema changes
这与 #3604 处理掉的 §Development Workflow 第 3 步「Edit the schema - changes reload automatically」是同一句无条件宣称,只是换了个位置。它对两条元数据加载路线中的一条不成立:
src/app-data/路(LocalBundleLoader) —— JSON 经import.meta.glob进入 Vite 的 module graph(packages/runner/src/lib/MetadataLoader.ts:26-28),改动不需要重启 dev server,这一侧大体成立。?api=路(NetworkLoader) —— 元数据由外部后端提供,fetch发生在运行时(同文件 89、101 行),Vite 对该后端没有任何可见性,不存在任何 watch 或 reload 机制。改了后端返回的 JSON,页面不会自己更新。
?api= 是本文件 §Metadata Loading 一节(#3537 / PR #3581 补)正式记录的、与本地路并列的加载方式,不是边角情况;§Features 站在全文最前面,读者先读到它。
建议
按 #3604 对第 3 步的处理口径同样处理:限定而非删除。例如把这一条改成只承诺本地那条路,或者干脆让它指向 §Metadata Loading,由那一节把两条路的差别讲清楚。
顺带一并核:同节还有一处措辞值得看 —— 第 8 行说的是 schema「changes」,而真正被 watch 的是 src/app-data/ 下的 JSON 文件;该目录 git-ignored 且新检出下不存在(见 #3604 的正文),所以对一个刚 clone 的读者,这条 Feature 在两条路上都暂时无从触发。
同源:#3533(文档不许描述实现里不存在的能力)、#3604、#3576 / PR #3602。已搜开放 issue 与 PR(关键字 runner README / Hot Reload / Features,三仓),无重复;#3619 是 content/docs/utilities/runner.mdx 的 Features 一节,不同文件、不同断言。
Activity
yinlianghui commentedon Aug 7, 2026
认领(PM 派发)。
session_01GTRjn8xBqp75dk7kFupVRtclaude/issue-3620-readme-hotreload-claimpackages/runner/README.md单文件。前置已落:PR docs(runner): README §Development Workflow 按两个 loader 的真相改写第 1、3 步 (#3604) #3621(packages/runner/README.md §Development Workflow 教读者写 TypeScript schema 文件,但两个 loader 都只认 JSON #3604)已在 main(8d5418e),同文件串行障碍解除;packages/*/README.md 里还有 9 条 404 的站内文档链接,且链接门禁有两层原因永远看不见它们 #3603 的 PR fix(docs,scripts): 清掉 9 条包 README 死链,并让链接门禁认站内绝对 URL (#3603) #3629 不碰 runner README,已核。?api=侧不成立)— 参照 PR docs(runner): README §Development Workflow 按两个 loader 的真相改写第 1、3 步 (#3604) #3621 §Development Workflow 第 3 步落地的措辞,保持同页两处说法一致。Generated by Claude Code
yinlianghui commentedon Aug 7, 2026
验收 ACCEPT → PR #3634(session_01GTRjn8xBqp75dk7kFupVRt)。
已核:单 bullet +3/−1,与 #3621 落地措辞逐字对齐(
Vite's module graph同页两处命中同句);门禁覆盖面如实标注(packages/** 不在 check-doc-links 扫描面,绿灯不构成背书 — 且这条结论是对新基线重读 SCAN_ROOTS 得出,不是照抄 #3621,预测纪律到位)。裁决记录:
Generated by Claude Code
docs(runner): README §Features 的 Hot Reload 按两个 loader 分路限定 (objectst…