越界发现,记录于 #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 一节,不同文件、不同断言。
越界发现,记录于 #3604(改写同文件 §Development Workflow 第 1、3 步)期间通读全文时。未在该 PR 中顺手修改 —— #3604 的派发范围被明确锁死在 §Development Workflow 这一节,这是 §Features,属另一处改动面。
事实(对
origin/main复核)packages/runner/README.md第 8 行,§Features 列表:这与 #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 一节,不同文件、不同断言。