| name | deploy-public-asset |
| description | Use when adding new public/static files to the site — images, fonts, geojson, textures, WASM modules. Live site is Next.js: assets go in client/public/ (no repo-root copy, no whitelist). Shared fork/stats static lives in tools/ + stats/ served by static.cuberoot.me. Triggers: "new public asset", "404", "public/", "textures/", "加静态资源", "static asset", "public 资源". |
新增 public / 静态资源
线上前端是 Next.js (packages/client);Vite + 根目录 commit + GH Pages 镜像(deploy_mirror)已于 2026-06-14 全部移除。旧的"两处白名单 + 仓库根再放一份"机制已作废。
常规 public 资源(图片 / 字体 / geojson / wasm 等)
直接放进 core/packages/client/public/<file> —— 完事。
- Next 在
/<file> 路径直接 serve(绝对路径如 /fonts/x.woff2、/cubeopt/...)。
- 部署自动带上:
deploy_next.yml(systemd standalone,public/ 打进 tar)+ Vercel(push 自动 build)。
- 不要在仓库根再放一份,不要改 workflow 白名单。
- 本地 dev
http://127.0.0.1:3000/<file> 验证 200。
共享 fork / stats 静态(tools/ + stats/)
仓库根的 tools/(forks: Solver / AlgTrainer / csTimer)和 stats/(WCA stats JSON)由 static.cuberoot.me 服(服务器 /www/wwwroot/toolkit/{tools,stats}/);Vercel/Next 上 app/{tools,stats}/[...slug]/route.ts fallback 反代过去。
- 加到这两个目录要确保上线到 static.cuberoot.me(见 memory
reference_static_toolkit_deploy)。
- 本地 dev 由
app/{tools,stats}/[...slug]/route.ts catch-all 从仓库根 serve。
stats/** 走 CI 日更管道(stats.yml),一般不手动加。
验证
- 本地:
http://127.0.0.1:3000/<path> → 200
- 线上:push 后
https://cuberoot.me/<path> → 200(public 资源走 Next;tools/stats 走 static.cuberoot.me fallback)
