前端框架与静态构建

启动和构建

读取 package.json、锁文件和构建配置，使用工程实际脚本，不假定都叫 dev/build。构建到新目录，再用普通 HTTP 独立预览，不沿用开发代理。需要服务端运行的功能与静态页面分开说明。

架构与自测

服务模块集中外部操作，状态存储供组件共享。组件重复挂载和开发模式重复执行不能重复提交、订阅或创建房间；卸载清理副作用。真实 AI 与双端联机按对应 Skill 验收。

检查 base/publicPath、资源相对引用和子目录运行。SPA 使用真实静态页面或明确的路由策略，不假定任意路径都回退首页。构建变量会进入浏览器包，密钥不能用前端环境变量保存。

常见问题

只有开发服务器能运行：排查 /@vite/client、HMR、代理、SSR 和服务端接口依赖。刷新子路由 404：核对路由与静态文件策略。一次点击请求两次：检查开发重复 effect、依赖数组与重复监听。

按打包提交生产输出，源码、构建命令与测试入口另留。