@stackstackstack/dsh-client-modules

English | 中文

客户端模块系统：Node 内部 ESM loader 的浏览器端对等实现，以惰性 CJS 表实现。web 外壳挂载 vendored cordis Loader 来治理配置项（fiber 生命周期、inject 等待、update/refresh），并通过其 internal 约定注入该包的 ClientModuleLoader；vendored 一侧唯一的消费点是 EntryTree.import，因此替换 internal 恰好只会替换「插件代码如何到达」，不会改变其他内容。

惰性 CJS 模型（web2）：执行插件 bundle 只会注册其 factory（window.__ModuleLoader__.load({id, factory})）；每个模块主体的副作用（包括 CSS 注入）都位于 factory 闭包中，在物化时运行（factory(require) → 导出表层，并在 loadCache 中记忆化），不会在脚本执行时运行。如果 factory 依赖另一个已注册但尚未物化的模块，系统会递归物化它，因此加载顺序无需外部编排；require 循环会抛出异常（factory 形式的 CJS 无法提供部分导出）。<id>/client 与裸 id 指向同一表层（一个插件 bundle 就是其包的客户端侧）。

解析分支顺序（import(specifier)）：平台种子词 → 外壳实例；记忆化记录 → 表层；外壳自身的静态注册表（registerStatic，app-shell）→ 模块；已注册 factory → 物化；模块图记录（window.__DSH_BOOT__）→ 加载外部 classic script + 物化；其他情况一律抛出异常。这是构建时 bundle 纯度门禁的运行时镜像。交给 factory 的同步 require 采用相同顺序，但不含异步加载分支，并把观察到的边记录到模块记录中。prefetch 是第一阶段到达钩子（只加载脚本并注册 factory；并发调用共享一个进行中的任务）；invalidate 会丢弃 factory 与物化记录，使下一次 prefetch/import 重新加载脚本；它是 HMR（热模块替换）钩子。

Node 侧会扫描已启用的 Loader 配置项以发现 web dsh.client 包，解析每个 exports["./client"]，把构建后的 bundle 哈希写入启动图，并通过 /plugins 提供该文件及其 sourcemap。源码启动会把宿主侧导入映射到 TypeScript 源码，但仍消费这一构建后的客户端导出；缺失文件共享一条构建说明，随后以包／路径列表列出各项，而无关的文件系统错误仍是独立故障。

模型体验

无。模块 loader 属于浏览器侧内核机制；这里没有任何内容进入模型请求。

KV Cache 影响

无；该包既不组装也不发送提供方请求。

已知限制与暂缓事项

• 有意采用扁平模块图：每个 bundle 是一个模块节点，其边只指向表中的叶节点；接口（loadCache/edges/invalidate）已经支持通用模块图，因此可以改变 externalization 粒度而不更改接口。
• 自身不维护卸载记录：样式移除与 fiber 拆卸顺序属于 HMR 驱动器（@stackstackstack/dsh-client-hmr）；loader 只在每条记录中登记其拥有的样式标签 id。