刘宇飞
6e0a1fbcbb
Includes scratch-gui, scratch-vm, scratch-blocks, scratch-render, scratch-l10n, and deployment config. Co-authored-by: Cursor <cursoragent@cursor.com>
1.7 KiB
1.7 KiB
001code-html
系灵丌编程（001CODE）前端项目。
scratch-gui 本地开发
- 目录位置：
scratch-gui\ - Node 版本建议：
>= 18，npm >= 9（Windows）
安装依赖
cd scratch-gui
npm ci
启动开发服务器
npm start
生产构建
npm run build
与子包联动（npm link）
scratch-gui 依赖内部包：scratch-vm、scratch-blocks。为在本地联动开发它们的改动，使用 npm link。
提示：每个子包先安装依赖并构建，再
npm link。在scratch-gui中再链接对应包名。
链接 scratch-vm
cd scratch-vm
npm install
npm link
链接 scratch-blocks
cd scratch-blocks
npm install
npm link
scratch-gui 链接 scratch-blocks scratch-vm
cd ..\scratch-gui
npm link scratch-blocks scratch-vm
解除链接（恢复使用包管理器安装的版本）
cd scratch-gui
npm unlink scratch-vm
npm unlink scratch-render
npm unlink scratch-blocks
npm unlink scratch-l10n
npm i
Docker 运行期配置（可选）
- 通过
/env.config.json注入运行时配置（例如API_BASE/DEPLOY_ENV），ENTRYPOINT 启动时替换占位符。 - 开发环境如果未启用 Docker：
env.config.json仍为占位时，前端会自动回退读取process.env.*。
常见问题
- 若容器启动失败提示找不到入口脚本，确认 Dockerfile 已
COPY docker-conf/entrypoint.sh并chmod +x，且无 CRLF 行尾。 - 确保静态服务器对
/env.config.json返回Content-Type: application/json，并避免 SPA 重写。