Echuu 官网
从 echuu-ai/nextjs-vtuber-mocap 的官网首页 v2 与当前本地改动中提取的独立 Vite / React / TypeScript 项目。包含四语首页、3D 开场、纸飞机交互、gallery / creators / journal / feedback / doodle / moodboard。
启动
需要 Node.js 22.12+（本次使用 24.4.1）。
npm ci
npm run dev
打开 http://localhost:5180/website/zh 。访问根路径自动进入官网。保留 /website/{zh,en,ja,ko} 深链接，避免原有官网链接失效。
npm run check:assets
npm test
npm run build
npm run preview
独立性与依赖
- 不需要父目录、原产品仓库、后端、S3 凭据或 Git 子模块。
public/ 包含官网模型、开场动作、HDR、纸飞机、图片、字体与条款；完整清单及 SHA-256 在 docs/dependency-assets.json。src/website/ 是官网内容；其余 src/ 是官网需要的共享运行时代码快照。HDR 天空已从大型直播间组件独立提取为 src/components/three/WebsiteHdrSky.tsx，保留原渲染逻辑。- 3D 开场相机、灯光、景深、表情仍读取
src/website/home/heroScene.json。
- YouTube 视频嵌入、Google Fonts 样式与社交/Notion 链接仍是外部服务，需要网络。它们不是原仓库依赖，也不宣称离线可用。
- 报名/反馈接口未配置时保持邮件或本地降级。可选配置见
.env.example；未迁移任何 .env、密钥或本机账号。
docs/website/ 保存历史设计、素材和发布待办，里面提及“并入产品仓库”的内容是迁移前记录；当前结构以本 README 与 docs/MIGRATION.md 为准。
协作与部署
日常协作分支为 dev。提交/推送前整合其远端更新，不强制推送。
生产构建输出 dist/，静态托管需将不存在的页面路径回退到 index.html；资源文件按真实路径服务。本仓库带 vercel.json 作为静态 SPA 配置，但本次未部署。
公开发布仍需处理 docs/website/OPEN_ITEMS.md 已记录的素材/字体与产品范围待确认项。创建组织私有仓库不表示公开发布已批准。
GitHub Pages 临时预览
源码仓库保持私有；组织套餐不支持私有仓库 Pages，因此临时预览使用公开的 echuu-ai/echuu-website-preview，仅发布构建产物。
npm run build -- --base=/echuu-website-preview/
node scripts/prepare-pages.mjs
npm run build 已生成四语页面的独立正文与元数据（含 blog / team 与每篇文章）；prepare-pages.mjs 只验证入口，不会覆盖正文。支持刷新和深链接。将 dist/ 内容发布到预览仓库 main 根目录（推送前先同步该仓库远端）。本地开发仍使用 /website/zh；预览路径为 /echuu-website-preview/website/zh/。
同步 dist/ 时不要删除预览仓库里的 .github/（Pages 部署工作流）、.preview-parts/（app-build 大文件的分片与 manifest）、app-build/ 与 README.md。用 rsync 的话：
rsync -a --delete --exclude .git --exclude .github --exclude .preview-parts --exclude app-build --exclude README.md dist/ ../echuu-website-preview/
2026-09-30 起官网自身的大资源（VRM、HDR、字体）以完整文件提交到预览仓库，不再分片；manifest 只剩 app-build 一项。
博客、团队与语言切换（2026-09-30）
- 博客：
src/website/data/blog.ts 维护四语文章（中文为源文，日/英/韩为执行初稿）；列表 /website/{locale}/blog，文章 /website/{locale}/blog/{slug}，首页新增「创作日志」区块（最近三篇）。路由第三段 slug 只对 blog 开放。
- 团队：
src/website/data/team.ts 与 Notion 媒体资料包「团队」段落对齐（最后更新 2026.8.28），另加技术顾问张佳鹏（zjp / shadow，前 Vast 算法工程师）；页面 /website/{locale}/team。他的 GitHub 地址待补。
- 语言：首屏页头新增一行「中 · 日 · EN · 한」切换（
LangInline），保留当前子页与文章；子页面继续用 LangSwitch。四语路由本身未变。
- 原「创作日志」子页改称「短记录」（journal），避免与博客重名。
邀请码与内测申请（2026-09-29）
首页登录/内测入口使用居中玻璃弹窗。服务端尚未提供，默认展示准备状态与邮件申请入口，不收集账号或密码。待确认部署契约后配置 VITE_INVITE_REDEEM_ENDPOINT 与 VITE_BETA_ACCOUNT_ENDPOINT；不要将邀请码或发信密钥放进前端。VITE_PRODUCT_ORIGIN 未设置时，开发默认 http://localhost:5173，生产默认 https://echuu.live（2026-10-03 Cory 确认；官网正式地址 https://www.echuu.ai）。契约与状态见 docs/reviews/2026-09-29-invitation-access.md；可定制中文邀请函在 emails/beta-invitation.zh.html。
搜索与交互音效（2026-10-03）
正式地址为 https://www.echuu.ai（2026-10-04 已绑到 Vercel；裸域 echuu.ai 308 永久跳到 www）。默认 VITE_SITE_INDEXABLE=0，所有构建页面携带 noindex，sitemap 无条目。仅在发布闸门通过后的生产构建设置 VITE_SITE_ORIGIN=https://www.echuu.ai、VITE_SITE_INDEXABLE=1，才输出 canonical、四语 hreflang 与正式 sitemap。发布之前确认实际托管返回对应路由 HTML。生产产物不要复用到预览域名；浏览器端 origin 校验不能代替静态 HTML 的索引配置。
src/website/seo/siteSeo.ts 是运行时与构建的共同元数据来源；scripts/static-pages.tsx 输出可直接读取的正文，问答共用 src/website/data/answers.ts。没有设置虚构作者、发布日期、评价或 FAQ 富结果承诺。未知路径仍需托管层正确返回 404（当前 SPA 回退只提供前端 noindex）。
背景配乐已按用户要求移除（2026-10-03）。声音开关控制恢复的蝉鸣、偶发风铃以及交互音效：纸飞机起飞、画笔、挂坠拨动、礼物与开场拍点；默认静音。短音限频、标签页隐藏时不触发，共用 0.2 主音量。
开场新增直接唤醒、可见跳过、同一会话回访跳过开场并进入 3D hero（不切静态图）。减少动态效果及加载失败时直接显示静态首屏。
开场统一时钟以 1.3 倍速播放（约20.2秒 → 15.5秒，不含加载与画画），角色动作、运镜与开场拍点共用时钟，hero 后恢复原速。跳过/唤醒控件可见高度28px，透明触控范围44px。
2026-10-03 补充：恢复原有蝉鸣/风铃合成参数；不恢复旧和弦铺底或新钢琴配乐。环境声开启后渐入，静音、隐藏标签和离开首页时清理节点及定时器。
2026-10-03：按用户要求移除底栏「重播开场」按钮及对应刷新处理。
2026-10-03 修正：回访/跳过只改变开场时间线，保留真实3D；加载期间点击跳过会在模型就绪后直达最终姿态。静态图仅用于减少动态效果、无WebGL或加载失败/超时。
