Files
CyberGril/web

雨夜相处演示

独立前端,对应 HEL-700,基准 1e9b08a。不连接 Python 性格、记忆、生活、排盘或语音引擎。

cd web
npm ci
npm run dev
npm run typecheck
npm run build
npm run preview

开发与 preview 均提供同源 /v1 代理。生产由总工按 nginx.conf.example 合入已有站点配置,禁止把 Vite 开发服务作为生产服务。模板不选择端口、不修改服务器。模型配置集中在 src/net/llm.ts 的请求和探测中。

目录边界:app/ 真实 DOM 与视觉 token;scene/ 只读取独立场景时间与氛围;engine/audio.ts 管理用户主动开启的程序雨声;net/llm.ts 管理探测、SSE、超时与取消;demo/ 是演示台词与片刻的唯一来源;state/contracts.ts 镜像 Python State、Utterance 字段并定义前端消息类型。没有共享场景/输入状态。

降级:全特效首先创建 Pixi WebGL,创建失败或上下文丢失切到独立 Canvas2D;Canvas 创建失败切 CSS 雨幕;连续 4 秒采样低于 30 FPS 逐级降低,CSS 仍低帧率则静态。轻量直接用 Canvas2D,静态或系统减少动效关闭环境与波形动画。用户手动选择档位可重新尝试。body[data-renderer] 标出实际渲染器,#effects[data-running] 标出运行状态,供审核检查。素材始终静态,只有雨幕与光膜位移。手机不读设备传感器。

2 秒模型探测失败进入明确标注的演示模式。实时请求首个内容片段 8 秒超时,整包 40 秒超时。错误、截断、取消保留已有内容,不自动重试;只有用户点击重试才重置该失败回复。已产生后续消息时要求重新发送,防止重试混入过期上下文。模型内容始终 textContent 渲染。演示消息不会进入实时模型上下文。不会把模型错误转换为角色台词。

雨声每次打开页面保持关闭;用户开启后,页面隐藏会暂停,返回按当次选择恢复。音量保存在 localStorage(存储不可用不影响使用)。设置中的预设仅修改场景灯光和雨密度,界面暖色 token 不变。

手机默认抽屉 30dvh,展开 55dvh;横屏、矮屏或软键盘压缩可视区时切成上下可滚动布局。手柄支持点击/键盘与上下拖动。语音和附件只显示说明,不触发设备授权。

浏览器回归用本机已有的 Python Playwright(不增加 npm 依赖):

python3 web/tests/browser_check.py

其余网络故障、生命周期与生产脚本见 QA.md,上述测试命令从仓库根执行。脚本启动并最终关闭本地 Vite 服务,输出到执行时指定的 CYBERGRIL_ARTIFACT_DIR(默认 web/qa-artifacts)。截图、采样和实际覆盖情况见任务卡交付附件。

Pixi API 按官方 Application / Graphics 文档实现:https://pixijs.com/8.x/guides/components/application ,https://pixijs.com/8.x/guides/components/scene-objects/graphics 。