Repository navigation
content/docs/utilities/runner.mdx §vite.config.ts 展示的配置在实现里不存在(server.port/open 全无),真实配置的 resolve.alias 表与 build.modulePreload 反被隐去 #3643
Description
越界发现，记录于 #3618(§Add Custom Routes)实现期间通读全页时。未在该 PR 中顺手修改 —— 该单锁死在 ### Add Custom Routes 单节上，这是同页另一处同类断言。
事实(对 origin/main 复核，切点 fa3ba5bf1)
## Configuration → ### vite.config.ts(:161)给出：
export default defineConfig({
plugins: [react()],
server: {
port: 5173,
open: true,
},
})
对照 packages/runner/vite.config.ts 实际内容：
- 整个
server块不存在。 真实文件里没有server键，因此port: 5173不是被配置出来的(那是 Vite 的默认端口)，open: true更是无中生有 —— 真实配置不会自动打开浏览器。同页### Port Already in Use一节也建立在「5173 是默认值、被占会顺延」的语义上。 - 真实配置里唯一重要的两块被完全隐去。 该文件主体是一张
resolve.alias表(把@object-ui/*映射到各包src)，文件内注释写明这张表就是 runner 能不经pnpm -w build直接从源码启动的机制，且带一条「必须是传递闭包」的不变量(objectui#3575：漏了fields/plugin-detail导致 dev server 对整条 import 链返回 HTTP 500)；以及build.modulePreload: false(packages/runner 按 runner.mdx 的「From Source」步骤起不来:vite 别名表漏了 5 个源码实际 import 的工作区包 #3575 实测：补全别名后产物从 10 个 asset 变 1776 个图标微 chunk，默认 modulePreload 会给每个都发 preload，index.html 从 546 B 涨到 145 KB)。
所以这一节不是「过时」，而是把一个不存在的配置当成 runner 的 vite.config.ts 展示，同时把真正需要读者知道的、且带硬不变量的部分留在文档之外。照抄这段去替换真实文件会直接触发 #3575 的故障形态。
建议
按 #3533 家族口径(文档不许描述不存在的能力)处理，二选一由实现者定：
- 删除该代码块，改为一句说明 runner 的 vite 配置实际做了什么(别名到 src + 关闭 modulePreload)，并指向文件本身；
- 或把代码块换成真实文件的节选(别名表首尾 +
modulePreload: false)，并保留那条闭包不变量的提示。
⛔ 不建议反向操作(为了让文档成真而往 vite.config.ts 里加 server 块)—— 那是产品决定，不归 docs 卡。
去重
- packages/runner/vite.config.ts 的 @object-ui/data-objectql 别名指向不存在的包目录（全仓唯一引用） #3593 覆盖的是真实
vite.config.ts里data-objectql别名指向不存在目录，属代码侧，另一件事，不重叠。 - content/docs/utilities/runner.mdx Features 写「All official plugins included」,实际只预装 kanban + charts 两个,与同页下方清单打架 #3619(Features 插件清单)、content/docs/utilities/runner.mdx §Best Practices 的 Error Boundaries 从 @object-ui/components 导入 ErrorBoundary,但该符号在 app-shell,且 runner 不依赖 app-shell #3635(Error Boundaries 导入)、packages/runner/README.md 的插件清单两处写成开放集合(§Features 的「etc.」、§Pre-installed Plugins 的非插件条目),实际只预装 kanban + charts 两个 #3632(README 插件清单)均为同页/同包其他小节，不覆盖本节。
Generated by Claude Code
Activity
yinlianghui commentedon Aug 7, 2026
认领(PM 派发)。
session_01GTRjn8xBqp75dk7kFupVRtclaude/issue-3643-runner-mdx-vite-configcontent/docs/utilities/runner.mdx单文件。前置已落:PR docs(runner): §Add Custom Routes 改写为指向 Add Custom Schemas 的元数据路由说明 (#3618) #3646(content/docs/utilities/runner.mdx §Add Custom Routes 教读者用 react-router-dom 改写 App.tsx,但 runner 不依赖它,路由是手写的 history.pushState #3618)已在 main(54dd7ec),同文件串行障碍解除。Generated by Claude Code
yinlianghui commentedon Aug 7, 2026
验收 ACCEPT → PR #3651(session_01GTRjn8xBqp75dk7kFupVRt)。
已核:单文件,CI 5 检查全绿 mergeable clean;修前 2 命中(port/open)→ 修后 0,正向锚点(alias 闭包 + modulePreload)齐备。
裁决记录:
Generated by Claude Code
docs(runner): §vite.config.ts 改写为指路真实文件 + 点名两个承重不变量 (objectstack-ai#3643