{event.title}
{event.text}{view.identity.name}说过的话 · 演示
{memory.title}
{memory.text}{memory.group === '她的成长' &&
diff --git a/README.md b/README.md index 1016971..47f95fa 100644 --- a/README.md +++ b/README.md @@ -306,3 +306,7 @@ pytest -k degradation -v # 降级机制 ## 许可 私有项目,未授权。 + +## S1 前端演示 + +独立的 React / TypeScript 前端位于 `web/`,运行 `cd web && npm ci && npm run dev` 后从普通入口进入明确标识的本机演示。真实后台、语音、视觉和备份尚未接通;不自动连接模型或现有服务。安装、构建和测试命令见 [web/README.md](web/README.md),实现与后续接线见 [docs/frontend/IMPLEMENTATION.md](docs/frontend/IMPLEMENTATION.md)。 diff --git a/docs/frontend/.gitignore b/docs/frontend/.gitignore new file mode 100644 index 0000000..750e145 --- /dev/null +++ b/docs/frontend/.gitignore @@ -0,0 +1 @@ +screenshots/ diff --git a/docs/frontend/IMPLEMENTATION.md b/docs/frontend/IMPLEMENTATION.md new file mode 100644 index 0000000..d195260 --- /dev/null +++ b/docs/frontend/IMPLEMENTATION.md @@ -0,0 +1,48 @@ +HEL-748 · S1 实现与接线说明 + +本轮范围是可构建的完整前端及离线演示,不部署,不实现 B1–B3。基于正式仓库 main 的 `1e9b08aed81b4ebf163721232a8d65707b1c3183` 新建任务分支;检出时工作区干净,无仓库内额外 AGENTS,无平台关联 PR。未改 Python 核心、既有测试、服务配置、SSH 信任、端口、GPU 或模型。 + +依据为本卡《整套设计验收与施工裁定-v1》、HEL-746 R2、HEL-738 结构与接口边界和需求 v1.6。名字、关系不预选、未分享即隐藏三项裁定覆盖旧原型。首建底色明确为示例,真实排盘待接已有 Python 编译器,不在浏览器重写八字规则。 + +主要目录与职责: + +- `web/src/app/`:入口、首建守卫、导航、全局 UI 偏好、返回/主动/断线演示。 +- `web/src/manage/`:四步首建;只读身份;关系/城市/服务/显示草稿;保存取消失败;外观标识;演示导出与同身份恢复。 +- `web/src/chat/`:文字草稿、IME 与快捷键、字幕/记录、取消重试、模拟语音/观察授权及结束。 +- `web/src/life/`:生活与四类回忆、双向关联、原位保留、手机详情推入、分页和深链守卫。 +- `web/src/domain/`:模型、首建校验、公开视图。所有可见事件、回忆、消息、摘要统一经过 `publicView`,未知关联默认拒绝;详情也从公开视图查找。 +- `web/src/adapters/`:独立可替换聊天适配器、turn_id/epoch 门槛、AbortController、本地持久化、严格 JSON 重建校验。 +- `web/src/demo/`:固定场景数据,与页面和传输分离。 +- `web/src/stage/`:背景空间与 `FallbackPresenter`。Presenter 只消费 SceneDesc,不写生活;参考图片失效也有文字降级,不黑屏。 +- `web/src/shared/`:复用按钮、图标、字段、状态和带焦点边界的确认弹层。 +- `web/src/styles/`:R2 单一 Token 和组件样式来源;没有第三方 UI 皮肤或叠加覆盖样式表。 + +两主题使用相同 DOM 和布局;人物拱窗、交谈展开、阅读面板与手机断点沿用获批样式。静帧仅呈现参考人物/房间,不渲染整页图片。语音/观察不访问 `getUserMedia`、不调用 ASR/TTS、不发外部请求。演示天气固定并标注模拟;当前视觉标签来自演示记录公开视图。 + +F1–F9 走法: + +| 流程 | 入口与边界 | +|---|---| +| F1 | 无本机档案 → 四步创建 → 名字/成年生日/关系/勾选校验 → 本机持久化 → 首晚空生活 | +| F2 | 普通入口说明未接服务 → 明确演示入口;重开直接回到同一位她 | +| F3 | 演示场景 → 模拟两天后返回;只从已分享数据生成摘要,不生成后台生活 | +| F4 | 演示场景 → 主动消息;来源是已分享事件,回她定位聊天并保留来源区域 | +| F5 | 交流麦克风 → 模拟授权 → 倾听界面;文字发送推进思考/说话,可打断/结束;无真实收音 | +| F6 | 演示断线 → 暂停发送,保留草稿,结束模拟语音、取消旧轮;恢复失败可重试,不自动重发 | +| F7 | 设置城市 → 搜索/选择 → 保存成功/失败/重试;不调用天气 API | +| F8 | 本地演示素材 JSON → 结构检查/模拟对比/确认;只更新外观标识,真实媒体导入待后续 | +| F9 | 本地演示 JSON 下载/同身份校验/输入确认/先导出再恢复;服务器备份明确未接通 | + +取消与错误:新轮、手动取消、切离交流会 abort 当前模拟回复;事件还需同时匹配 turn_id 与 epoch,非协作适配器的迟到消息同样被门槛拒绝。断线 resync 提升 epoch;恢复不自动续接旧轮。管理保存切区/关区会 abort;草稿保留,取消恢复上次提交值;存储损坏不进入新的首建覆盖。导入只执行 JSON.parse 后按固定 schema 重建;不执行脚本、不作为 HTML、不加载媒体/服务 URL。 + +后续接线清单(当前均未提供): + +1. B1 同源 API 与 WS:hello/sync、游标和持久 epoch、能力声明、HTTP AbortSignal。真实模式不得直接替换成未经审定的 LLM URL。 +2. 服务端授权与隐私:必须在响应前裁剪未分享记录、未知引用、回忆和消息及摘要;本轮前端过滤不构成服务器权限控制。 +3. 接已有 Python 生辰预览/只读档案、真实关系更新;身份 ID、底色指纹由服务端负责。 +4. B2/B3 后台生活、主动性、记忆与增长层;前端只订阅 LifeScene/事件,不从素材反编生活。 +5. S2 流式文字;S3 ASR/TTS 二进制协议、session_id/seq 隔离、权限与实际中断;当前没有真实音频流,因此不声称达到延迟指标。 +6. S4 生活/回忆服务分页;S5 城市/天气、素材包校验和完整服务器备份/自动备份;演示 JSON 的 MIME 和结构不是媒体真伪校验。 +7. S6 视觉摘要时效与 HTTPS、真实权限;Presenter 的视频/音频/口型驱动器可注入,当前只交静帧降级。 + +测试部署由总工审核后执行。建议在独立目录安装构建,将 `web/dist/` 作为静态站点挂到总工选定的未占用测试端口;正常路径 `/`,演示 `/?demo=1`。本轮未占用固定服务端口,也未更改 8010/18080/18081 或现网。部署若换 origin,浏览器本地演示资料不会自动迁移,可通过同身份演示 JSON 手动恢复。 diff --git a/docs/frontend/PR.md b/docs/frontend/PR.md new file mode 100644 index 0000000..07b3ad1 --- /dev/null +++ b/docs/frontend/PR.md @@ -0,0 +1,11 @@ +HEL-748: S1 完整前端与本机演示(不含后端或部署) + +原仓库只有 Python 核心,没有产品前端。新增独立 `web/` React/TypeScript/Vite 工程,将获批 HEL-746 R2 的两主题、相处/交流/日子/管理和 F1–F9 演示落地为可构建组件。 + +创建必须输入名字并亲自选关系,刷新保留同一位档案;未分享生活及未知引用统一隐藏,包括详情、回忆、聊天和离开摘要。普通入口说明服务未接通,只有显式 `?demo=1` 进入本机演示;导入只解析校验 JSON,不执行 HTML/脚本、不请求外部媒体或服务。轮次/epoch/AbortSignal 隔离旧回复,管理草稿按分区保存或取消,恢复需同身份、输入确认并先导出。 + +验证:TypeScript、ESLint、Vite 生产构建、11 项领域测试、原有 Python 78 项测试;实际 Chromium 在 1440×900、1280×800、390×844 走查两主题及关键失败/恢复路径。浏览器记录与接线清单见 `docs/frontend/`。真实手机/Safari、真实服务和性能指标未测。 + +本轮仅 S1。没有更改 Python 核心、现网配置或服务端口,没有部署/合并,没有接入 LLM/ASR/TTS/视觉/后台循环/真实备份。Presenter 使用标识清楚的参考静帧。审查通过后由总工负责独立测试部署。 + +目标 base: main (`1e9b08aed81b4ebf163721232a8d65707b1c3183`) diff --git a/docs/frontend/TEST-RECORD.md b/docs/frontend/TEST-RECORD.md new file mode 100644 index 0000000..c8a2ba3 --- /dev/null +++ b/docs/frontend/TEST-RECORD.md @@ -0,0 +1,33 @@ +HEL-748 S1 · 实际验证记录 · 2026-10-22(北京时间) + +环境:Ubuntu 22.04;Node 24.16.0 / npm 11.13.0;Chromium 151.0.7922.34(Python Playwright、无头真实浏览器);Python 3.11.16 独立 `.venv`。浏览器直接加载 Vite 生产产物,测试脚本启动随机 loopback HTTP 端口并在结束时关闭。 + +| 检查 | 实际结果 | +|---|---| +| `npm run typecheck` | 通过 | +| `npm run lint` | 通过,无调试输出残留 | +| `npm test` | 11 项通过:隐私公开视图/未知引用、首建拦截、持久化失败与损坏、恢复身份/结构/脚本边界、turn/epoch/Abort 隔离、HTTP 标识兼容 | +| `npm run build` | 通过,41 个模块;JS 197.50KB / gzip 64.67KB,CSS 61.20KB / gzip 13.05KB | +| Python 既有测试 | `.venv/bin/python -m pytest -q`:78 项通过(Python 3.11.16);默认 Python 3.10.12 亦通过 78 项 | +| 运行时依赖检查 | `npm audit --omit=dev --registry=https://registry.npmjs.org` 返回 0 漏洞;只检查生产依赖 | +| 三尺寸主走查 | 1440×900、1280×800、390×844,两套主题;16 组结果通过,88 次本机请求,无未捕获浏览器错误、无外部服务请求 | +| 末次手机复测 | 390×844 两主题重跑,包含保存错误说明进入可见区域的断言;结果另存 `browser-results-390.json` | +| 导入与草稿专项 | 7 组通过,见 `import-results.json` | + +主走查是本轮新增的真实操作脚本,未引用原型自检数字: + +- 普通入口有未接服务说明,不能直接进入伪在线状态;正常入口没有演示控制台。 +- 首建空名字、未成年生日、未选关系、未勾选均拦截;关系无预选;创建模拟失败资料保留,可重试;创建后刷新不再首建,名字统一使用。 +- 两套主题下首页、交流、生活详情、回忆关联返回、管理表单、保存取消与关系二次确认;主题刷新仍保留。 +- 未分享列表项、详情深链、回忆、聊天引用、离开摘要不可见;未知引用默认隐藏。原始本机演示数据仍含专门的隐私测试条目,展示使用过滤后的公开视图,不能把这一点当作服务端授权。 +- 手动取消回复、退出交流后的旧回复不复活;发送失败重试;中文输入法 Enter 不误发,Shift+Enter 换行,Enter 发送;用户/导入的 HTML 字符串只显示文本。 +- 模拟语音的结束控件在手机视口内,文字输入常驻;观察为无采集模拟;断线暂停发送、草稿保留、失败重试;城市保存失败保留修改、重试同步顶栏。 +- 离开摘要经过隐私过滤;主动消息有已分享事件来源,回她定位记录。 + +专项覆盖:同一位档案恢复、异人阻断、输入“恢复”与恢复前下载;非法素材清单拒绝;素材 URL/服务测试不发网络请求;换外观标识不改身份;切换分区取消尚未完成的保存;保存城市不提交服务草稿;长列表 18+12 分页、聊天返回精确保留滚动位置;坏存储不自动覆盖;模拟 `randomUUID` 缺失时创建与聊天仍能完成。 + +本轮实际发现并修正:表单下拉框可访问标签混入选项文字;SVG 图标视口/命名空间;手机固定操作区域与内容关系;管理分区误带其他草稿提交的风险;保存反馈在手机滚动区内不够可见;局域网 HTTP 的标识生成兼容性。手机列表/详情推入需要先按返回才能操作列表,这是获批的布局行为,测试脚本已按实际用户路径操作。 + +截图为本轮 DOM 实际捕获,共 45 张 PNG;`screenshots/` 不进入前端构建或 Git,随任务评论附件打包交付。包含三尺寸的两主题首页/交流记录/生活详情/管理,以及首建、创建失败、发送失败、语音、断线失败、保存失败、离开返回。截图不代表动效性能实测。 + +未测:真实手机硬件、Safari、触屏键盘/安全区、真实麦克风/摄像头/ASR/TTS/天气/服务器记忆与备份、真实媒体/口型、后台常驻生活、FPS/延迟/长时稳定性。上述能力当前均未接线,不声称完成。 diff --git a/docs/frontend/browser-results-390.json b/docs/frontend/browser-results-390.json new file mode 100644 index 0000000..aa792df --- /dev/null +++ b/docs/frontend/browser-results-390.json @@ -0,0 +1,12 @@ +{ + "checks": [ + "390: ordinary entry, creation validation/failure/retry and reopen", + "390: both themes, home/talk/days/memory return, relation confirm/cancel/save", + "390: private deep-link guard, cancel/exit isolation, IME/Shift+Enter and XSS text", + "390: failed send/retry, voice end reachable, no-camera simulation, reconnect failure/retry, save failure/retry", + "390: privacy-filtered away summary and proactive message", + "No uncaught browser errors, external requests, microphone or camera requests" + ], + "errors": [], + "requests": 36 +} \ No newline at end of file diff --git a/docs/frontend/browser-results.json b/docs/frontend/browser-results.json new file mode 100644 index 0000000..e710469 --- /dev/null +++ b/docs/frontend/browser-results.json @@ -0,0 +1,22 @@ +{ + "checks": [ + "1440: ordinary entry, creation validation/failure/retry and reopen", + "1440: both themes, home/talk/days/memory return, relation confirm/cancel/save", + "1440: private deep-link guard, cancel/exit isolation, IME/Shift+Enter and XSS text", + "1440: failed send/retry, voice end reachable, no-camera simulation, reconnect failure/retry, save failure/retry", + "1440: privacy-filtered away summary and proactive message", + "1280: ordinary entry, creation validation/failure/retry and reopen", + "1280: both themes, home/talk/days/memory return, relation confirm/cancel/save", + "1280: private deep-link guard, cancel/exit isolation, IME/Shift+Enter and XSS text", + "1280: failed send/retry, voice end reachable, no-camera simulation, reconnect failure/retry, save failure/retry", + "1280: privacy-filtered away summary and proactive message", + "390: ordinary entry, creation validation/failure/retry and reopen", + "390: both themes, home/talk/days/memory return, relation confirm/cancel/save", + "390: private deep-link guard, cancel/exit isolation, IME/Shift+Enter and XSS text", + "390: failed send/retry, voice end reachable, no-camera simulation, reconnect failure/retry, save failure/retry", + "390: privacy-filtered away summary and proactive message", + "No uncaught browser errors, external requests, microphone or camera requests" + ], + "errors": [], + "requests": 88 +} \ No newline at end of file diff --git a/docs/frontend/import-results.json b/docs/frontend/import-results.json new file mode 100644 index 0000000..0c8e12c --- /dev/null +++ b/docs/frontend/import-results.json @@ -0,0 +1,9 @@ +[ + "Reject foreign identity; same-identity restore requires typed confirmation and pre-restore export", + "Invalid manifests rejected; external media never loaded; appearance confirm/cancel preserves identity; service test has no network", + "Changing section aborts outstanding save; saving city does not commit an unsaved service draft", + "Imported model text rendered as text, never as HTML", + "Long timeline paginates 18 then 12 and retains exact scroll position after chat return", + "Corrupt persistence never falls back to overwriting first creation", + "Creation and chat work when secure-context randomUUID is unavailable" +] \ No newline at end of file diff --git a/web/.gitignore b/web/.gitignore new file mode 100644 index 0000000..3ff38cc --- /dev/null +++ b/web/.gitignore @@ -0,0 +1,3 @@ +node_modules/ +dist/ +.vite/ diff --git a/web/README.md b/web/README.md new file mode 100644 index 0000000..484f123 --- /dev/null +++ b/web/README.md @@ -0,0 +1,35 @@ +CyberGril S1 前端(HEL-748) + +独立 React / TypeScript / Vite 工程。Python 核心保持原样;不是新的后端。视觉基于获批 HEL-746 R2 的 Token、组件样式和两张参考静帧,页面由真实 React 组件实现,没有嵌入原型 HTML。 + +```bash +cd web +npm ci +npm run dev # 仅本机,终端给出 URL +# 普通入口 / 说明真实服务未接通;点入口或访问 /?demo=1 +npm run typecheck +npm run lint +npm test +npm run build +npm run preview # 仅本机预览生产构建 +``` + +Node 22+ 推荐(本轮 Node 24.16.0 / npm 11.13.0 验证),锁文件已提交。不需要 API Key、模型或 GPU。没有运行时 CDN 请求。 + +首次进入演示需填写名字、生辰、关系并确认。创建保存在浏览器 `cybergril.demo.v1`;刷新保留同一位档案。没有切换或清空重建入口。`cg.theme` 保留主题,`sessionStorage` 的 `cg.draft` 保留交流草稿。资料只在当前浏览器/站点 origin;它不代表服务器已创建、记忆已入库或后台仍在生活。保存不可用时会报错,不伪装成功。损坏资料会显示恢复说明,不自动覆盖。 + +演示场景入口可载入固定的三天/长记录、模拟离开返回、主动消息、断线和操作失败。只有明确 `?demo=1` 才有该入口,不能切换隐私规则。首建后生活默认空白;固定样例须主动载入,不自行编造离线生活。 + +本地演示 JSON 可导出、恢复同一位档案;恢复需输入“恢复”,先下载恢复前数据。它不含真实数据库和媒体文件,不能称为后台完整备份。素材导入只校验演示 JSON 的结构与标识,媒体格式/时长/人物一致性均未检测,清单中的 URL 不会加载。可用示例在 `public/demo-material.json`。 + +浏览器测试:先构建,再在已安装 Python Playwright 和 Chromium 及其依赖的环境执行: + +```bash +python3 web/tests/browser_check.py # 在仓库根目录 +python3 web/tests/import_check.py +python3 -m pytest -q # 现有 Python 核心,仓库根目录 +``` + +脚本在随机 loopback 端口同步测试静态产物,结束关闭浏览器和服务;截图写入 `docs/frontend/screenshots/`(不进入前端产物)。没有持续预览服务或部署。真实手机、Safari、真实麦克风/摄像头、ASR/TTS、后台生活和口型均未测试。 + +接线边界、交付与测试记录见 `docs/frontend/IMPLEMENTATION.md`。 diff --git a/web/eslint.config.js b/web/eslint.config.js new file mode 100644 index 0000000..1ebd4bc --- /dev/null +++ b/web/eslint.config.js @@ -0,0 +1,5 @@ +import js from '@eslint/js'; +import ts from 'typescript-eslint'; +import hooks from 'eslint-plugin-react-hooks'; +import globals from 'globals'; +export default ts.config(js.configs.recommended, ...ts.configs.recommended, {files:['src/**/*.{ts,tsx}'],languageOptions:{globals:globals.browser},plugins:{'react-hooks':hooks},rules:{...hooks.configs.recommended.rules}}); diff --git a/web/index.html b/web/index.html new file mode 100644 index 0000000..42794e0 --- /dev/null +++ b/web/index.html @@ -0,0 +1 @@ +
请先检查浏览器存储权限,或备份浏览器中的原始资料后再处理。不会自动清空或覆盖。
{state.identity.name}今晚刚住进来。这里还没有共同的日子。
本机演示 · 没有真实后台生活
固定演示摘要 · 只展示已分享记录
演示中网页关闭不会产生新的生活,服务器后台尚未接通。
失败开关控制创建、发送、保存和重连。关闭后可重试。没有切换隐私规则或清空重建入口。
{event.text}{view.identity.name}说过的话 · 演示
{memory.text}{memory.group === '她的成长' &&
这是本机演示。你的选择只保存在这个浏览器,没有创建服务器上的真实伴侣。
名字由你起,生辰也可以在确认前修改。
底色是倾向,会留下诠释和成长的空间。
没有预选答案。以后可以在设置中确认修改,记忆会保留。
刚开始,还没有共同的日子。聊着聊着就会有了。
{section === 'her' ? '她还是她。外观和关系的变化,都不会改写最初的底色。' : '所有修改仅用于本机演示。未接通的服务会明确说明。'}
+ {section === 'her' && <>首版只有一位,不提供新建、切换或清空。底色只读。
>} + {section === 'relation' && <>改关系需要再次确认,已有记忆与信任都保留,底色不变。
>} + {section === 'city' && <>暂时没找到这个城市,演示清单只包含上面的六座。
}城市保存后顶栏同步;天气与作息为固定演示,不请求天气服务。
>} + {section === 'appearance' && <>

只演示检查、预览与确认。媒体真实性未校验,不声称完成素材导入。
>} + {section === 'backup' && <>服务器每日备份、数据库和素材完整备份均未提供。本地文件不包含真实后台资料。
包括本机档案、设置、文字、演示日子和回忆;不包含素材文件。
真实麦克风和摄像头未启用。视觉窗只允许模拟状态,观察过期不当作眼前。
>} + {section === 'display' && <>也会自动尊重系统的减少动效设置。切到其他网页时暂停背景动画。
>} +这些是演示倾向,不是固定台词。真实排盘待接 Python 八字编译器,不以示例代替计算。