---
name: creator-static-framework
description: 检查 React/Vue/Vite 等前端工程的实际启动、静态构建、部署路径和生命周期，验证独立运行产物。
---

# 前端框架与静态构建

## 启动和构建

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

## 架构与自测

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

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

## 常见问题

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

按[打包](../../packaging/SKILL.md)提交生产输出，源码、构建命令与测试入口另留。