docs(roadmap+review): 产品开发路线图(产品视角·分阶段) + studio↔demo UI 差距评审

- 产品开发路线图-review.md:已完成(①②③⑤可演示)/待完成分阶段排期(Phase0卖相→Phase1变现→Phase2生成质量→Phase3日历闸门→Phase4生态),日历闸门=关键路径;①创作 W-CLEAN 迁移空窗已诚实更正
- studio↔demo UI差距评审-review.md:29 agent 工作流评审,差距95%有意MVP降级 vs 16真差距,Top5(退出登录孤儿P0/品牌渐变·字体·消息入口P1)+设计系统专章+覆盖矩阵
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
zizi 2026-06-16 06:43:12 +00:00
parent 42342e8c53
commit 5a6607c4d3
2 changed files with 396 additions and 0 deletions

View File

@ -0,0 +1,196 @@
# studio vs demo.html UI 差距评审报告
> 评审对象:`game-studio`(当前 MVP 产品前端)对照 `docs-design/huijing-ai-demo.html`绘境AI 完整产品愿景设计原型)
> 评审目的:厘清「已实现屏的真实 UI/布局/样式差距」(要修)与「有意 MVP 降级」(范围,非缺陷)
> 评审范围:仅采信全部分屏核验中 `verified=true` 的结论;`verified=false` 的两条(字重 P3、Share 返回 P2已剔除
> 评审日期2026-06-16 评审人首席前端
---
## 1. 结论先行
**一句话差距全貌:** studio 与 demo 的差异 95% 是「有意的产品形态与范围取舍」(桌面投资人原型 → 移动端 MVP 闭环;九大生态视图 → create/feed/play/project 主链demo 独占的素材中心/模板中心/工作坊IDE/创作者后台/B端/个人中心六大屏属 MVP 有意降级(非缺陷);**真正"已实现屏内"需要修的差距只有一小撮,集中在「设计系统落地度」(品牌字体/主按钮渐变缺失)与「一处孤儿能力(退出登录无入口)」**。反向看studio 在登录鉴权、真实试玩宿主、分享落地页、发布门禁、错误重试等真实可用性维度**显著超出** demo 演示态。
**Top5 最该修的真差距(产品视角,已排除愿景级 descope**
1. **【P0】退出登录是孤儿能力——用户在产品内无法登出/换号。** `userStore.logout()` 已实现且真清 5 个 localStorage 键,但全 studio 唯一调用方是 401 拦截器,**无任何按钮触发用户主动登出**。共用设备无法切换账号,踩中项目 §7「无孤儿设计」红线。成本极低挂一个入口直连既有 `logout()` 即可闭合。
2. **【P1】主按钮丢失品牌青绿渐变。** demo 最具辨识度的主操作语言是 `cyan→green` 135° 渐变 + 重字重studio 通用 `AppButton.primary` 退化为**纯色 cyan + 常规字重**,全站 CTA 更扁平、更弱。
3. **【P1】品牌字体未加载。** demo 首选 Interstudio 全仓零 webfont系统字体兜底数字/英文/计数/作者名字形与品牌稿不一致。
4. **【P1】消息/通知无一级入口。** demo 底部 5 Tab 含「消息」studio 只有 3 TabW4 community 通知底座已建成却**前端无承接入口**,构成"有能力无入口"风险。
5. **【P2】feed 互动按钮视觉偏离 + 卡片封面单调。** demo 互动按钮是半透明白系悬浮抖音质感studio 是深蓝实底卡片感;且真实生成无缩略图的卡片退化为纯色底纹+标题,与 demo 精心设计的"无图也好看"渐变封面差距明显。
```mermaid
graph LR
A[demo.html<br/>桌面投资人原型<br/>9 大生态视图] -->|MVP 有意收敛| B[studio<br/>移动端 MVP<br/>create→feed→play→project]
A -.六屏 descope.-> C[素材中心/模板中心<br/>工作坊IDE/创作者后台<br/>B端/个人中心]
B -->|反向超出 demo| D[登录鉴权/真实试玩宿主<br/>分享落地页/发布门禁<br/>错误重试]
B -.真差距要修.-> E[设计系统落地度<br/>+退出登录孤儿]
style C fill:#2a3551,color:#eef6ff
style D fill:#1c3a2a,color:#7cf2a4
style E fill:#3a2a1c,color:#ffc857
```
---
## 2. 覆盖矩阵demo 每屏 × studio 状态)
| demo 屏 | studio 状态 | 是否有意降级 | 说明 |
|---|---|---|---|
| 首页总览 (Home) | **missing** | 是P3 | 根路由直跳 /feed无桌面门户门户=投资人路演载体,归 PC 官网远期项 |
| 游戏广场 (Plaza) | **divergent** | 部分 | 橱窗整屏被竖屏信息流取代(范式 descope专区命名/封面视觉=真差距 |
| 素材中心 (Materials) | **missing** | 是P3 | 整屏未建Doc A 明确 P1/v2.0,不在 55 P0落地前须补素材契约+授权/支付模型 |
| 玩法模板中心 (Templates) | **missing** | 是P3 | 整屏未建;且"玩法品类层"已被创始人 2026-06-12 明令废除W-CLEAN |
| AI工作坊 (Workshop) | **partial / divergent** | 部分 | 桌面三栏IDE→移动三页向导形态 descope玩法品类取向/视觉语言=真差距 |
| 游戏信息流 (Feed) | **implemented / divergent** | 部分 | 核心已实现且更真(真互动+鉴权门);互动按钮视觉/顶部入口=真差距 |
| 创作者中心 (Creator) | **missing** | 是P3 | 整屏未建;数据后台属"数据→优化"闭环远期,写侧埋点已采数 |
| B端定制中心 (B2B) | **missing** | 是P1 | 前端整屏未建,**但后端 biz 模块已建成 7 端点指名 studio 消费**→需产品拍板前端归属 |
| 个人中心 (Profile) | **missing** | 是P1 | 整屏未建;退出登录因此成孤儿(见真差距 P0 |
| 一键发布弹窗 (Publish Modal) | **implemented / divergent** | 部分 | 已实现且更强(独立页+服务端门禁);多渠道发布=范围 descope形态=真差距 |
| —studio 独有)登录/注册 | **studio-only** | n/a | demo 无登录概念studio 真实鉴权页(正向) |
| —studio 独有)分享落地页 | **studio-only** | n/a | demo 分享仅 toaststudio 有 OG 元数据+回流(正向) |
**状态分布:** implemented/divergent 3 · partial 1 · missing 6其中 4 屏纯 descope2 屏 missing 但触发产品决策点)· studio-only 2。
---
## 3. 真差距清单verified=true 且 classification≠intentional-mvp-descope
> 按维度归类。reverse-gapstudio 有/demo 无)单列于 §3.6,因其不是"缺陷"而是"勿被误砍"的正向记录。
### 3.1 产品功能
| # | 标题 | demo 怎样 | studio 怎样 | 影响 | 建议 | 证据 |
|---|---|---|---|---|---|---|
| F-1 **(P0)** | 退出登录孤儿 | Profile 第4行 hot 红按钮可主动登出(清本地会话) | `userStore.logout()` 真清 5 个 LS 键,但**唯一调用方是 401 拦截器**,无 UI 触发 | 真实登录用户无法切换/登出账号,共用设备死锁;违反 §7 孤儿红线 | P0 补一个可点入口(挂 /project 页头或极简 /me直连 `logout()`,登出后跳 /feed 或 /login | `user.ts:147-160`logout 实现)/ `request.ts:36`(唯一调用) |
> 说明B 端定制前端整屏缺失虽列 P1但其本质是"后端已建成、前端归属待产品拍板",属决策点而非可直接判定的工程缺陷,故计入 §5 待决清单而非本表必修项。
### 3.2 UI 布局
| # | 标题 | demo 怎样 | studio 怎样 | 影响 | 建议 | 证据 |
|---|---|---|---|---|---|---|
| L-1 **(P1)** | 一级入口 5→3消息无落点 | 底部 5 Tab首页/游玩/创作/消息/我的 | 底部 3 Tab游戏流/创作/我的,无独立"消息" | community 通知底座已建成但前端无一级入口("有能力无入口");宫格浏览与沉浸刷合一改变发现路径 | 确认三 Tab 收敛意图;为通知规划入口(我的页二级/feed 顶部铃铛),避免通知孤儿 | `huijing-ai-demo.html:957-961` / `TabBar.vue:26-30` |
| L-2 **(P3)** | feed 顶部入口语义不同 | section-head 放 上一条/下一条切条按钮 | 顶部=专区 tab 条(推荐+双轨专区),切条降级右下 ▲▼ | 专区置顶更符合移动端内容流导航;属对 demo 的有意改进 | 保留 studio 专区置顶;记录为有意改进而非缺失 | `huijing-ai-demo.html:2685-2688` / `Feed.vue:208-225` |
### 3.3 视觉样式(设计系统差距集中于 §4此处列业务屏内的样式偏离
| # | 标题 | demo 怎样 | studio 怎样 | 影响 | 建议 | 证据 |
|---|---|---|---|---|---|---|
| V-1 **(P2)** | feed 互动按钮视觉偏离 | 44×44 圆,`rgba(255,255,255,.10)` 半透白底+轻投影,抖音式悬浮 | `rgba(16,21,34,.6)` 深蓝实底+边框、无投影,图标用字符 ♥★➦⚑ | 互动栏底色偏深、通透感弱、缺玻璃层次 | 底色改半透白 `rgba(255,255,255,.10)`、酌情加 backdrop-filter注意移动端性能 | `huijing-ai-demo.html:1890-1924` / `InteractBar.vue:65-93` |
| V-2 **(P2)** | 卡片封面单调(限真实生成无缩略图卡) | `.game-cover` 三套主题渐变+聚光+波形装饰,无图也好看 | 真实生成多无缩略图→退"标题底纹兜底"单渐变无装饰mock 卡有 seeded 渐变 | 生成侧前台大量纯色底纹+标题,质感低于 demo 橱窗 | 真缩略图(W-G1)落地前低成本对齐:兜底底纹按 IP/玩法 hash 出多套渐变+轻装饰 | `huijing-ai-demo.html:489-528` / `GameCard.vue:26-35,85-115` |
| V-3 **(P2, uncertain)** | 工作坊视觉语言不同 | 多面板 panel/status 徽章/chips 的桌面控制台风(偏中性) | D4 深色科技风(青紫渐变标题/cyan 发光),偏游戏化霓虹 | 形态从桌面IDE→移动向导视觉系统整体重做合理但两套语言哪套权威需设计拍板 | 向设计确认权威视觉基线demo 控制台风 vs studio D4 霓虹风)后统一口径 | `tokens.css:6-29` / `Create.vue:227-231` |
### 3.4 交互
| # | 标题 | demo 怎样 | studio 怎样 | 影响 | 建议 | 证据 |
|---|---|---|---|---|---|---|
| I-1 **(P2)** | 发布载体形态不同 | 工作坊内居中模态弹窗(不离开创作上下文) | 独立全屏路由页 `/project/:id/publish`(从详情页跳入) | 移动化合理改写;但从"弹窗即时发布"变"跳转独立页",连贯感弱于 demo | 保留全屏页(更契合移动端);确保跳转后顶部有清晰返回弥补割裂 | `huijing-ai-demo.html:2861-2886` / `Publish.vue:188-301` |
> Share.vue 缺统一顶部返回箭头一条:核验已将其由 P2 降为 P3 一致性 nitPlay/Preview/Publish 三页均有返回Share 仍有"去逛逛"兜底回 feed不会卡死。建议为 Share.vue 补一个与其余三页一致的顶部返回控件以统一手势,非阻塞。证据 `Share.vue:85`(仅业务返回,无顶部箭头)。
### 3.5 文案
| # | 标题 | demo 怎样 | studio 怎样 | 影响 | 建议 | 证据 |
|---|---|---|---|---|---|---|
| C-1 **(P2)** | 专区命名与卡面信号 | 主题化"现象级IP专区/UGC孵化IP专区"+三行标签(优秀素材案例/新游推荐/全部)+卡面玩法/IP/完玩率 | 泛化"官方精选/UGC广场",无行标签;卡面仅 标题/作者/播放/点赞 | IP 主题叙事弱化,丢失完玩率/玩法标签等运营信号前台呈现 | 与运营/契约方确认专区命名是否对齐 IP 叙事;**补玩法标签须先在 FeedCard 契约加 `templateName` 字段**(当前契约无),完玩率按数据可得性排期 | `huijing-ai-demo.html:2286-2291` / `feed.ts:124-125`+`types.ts FeedCard` |
| C-2 **(P2)** | 工作坊玩法品类取向差 | composer 固定 5 类玩法预设:剧情互动/经营模拟/解谜闯关/TRPG跑团/非遗科普(偏剧情/科普向) | 后端 `aigc.getTemplates` 动态模板首发偏轻度休闲clicker/merge/idle/tycoon与 LittleJS 能力匹配) | "工作坊能做什么类型"的用户预期与实际产出错位(期待剧情却拿到点击类) | 确认首发玩法品类,使 demo 文案与后端模板库对齐(或更新 demo 玩法清单为实际模板) | `huijing-ai-demo.html:2526-2532` / `Create.vue:147-164`+`aigc.ts:12` |
### 3.6 反向差距studio 有 / demo 无 —— 勿被误判为缺陷而砍掉)
> 这些是 studio 相对 demo 演示态的**正向超出**,多为 MVP 真实可用性必需。记录目的:评审时勿把 demo 的"流畅假流程"当作 studio 应对齐的目标而要求削弱真实能力。
| # | 标题 | studio 有什么 | demo 只是 | 维持理由 |
|---|---|---|---|---|
| R-1 **(P0)** | 真实试玩宿主 | iframe 沙箱+SDK/Runtime 注入+postMessage bridge 双校验+manifest sha256 校验+会话/遥测全链(`GamePlayer.vue`/`bridge.ts`/`inject.ts` | "试玩"=toast+静态 actor diviframe 计数=0 | 护城河命门:'有人玩它'必须真跑游戏;守 P75<3s 与沙箱越权两条红线 |
| R-2 **(P1)** | 登录/注册整屏 | sms-login 登录即注册+invite-register+倒计时+协议门+redirect 回跳+anonId 衔接(`Login.vue`/`passport.ts` | 无登录概念,硬编码账号 | 真实产品须承载私有数据/收益归属/合规实名 |
| R-3 **(P1)** | 分享落地页 | 独立 `/share/:gameId`+OG 元数据+立即玩回流 versionId+utm 渠道归因(`Share.vue`/`feed.ts` | 仅 toast "分享卡已生成" | "流量"环外部裂变靠分享链回流,落地页是拉新关键漏斗 |
| R-4 **(P1)** | 失败/取消/重试闭环 | Task.vue 七枚举失败原因可读映射+取消/重试+进度色Create 示例填入+字数校验+防重锁 | 720ms 模拟整卡 complete无失败态 | studio 真实可用性显著优于 demo勿以 demo 流畅为由弱化错误态 |
| R-5 **(P2)** | 发布门禁 | 7 项客户端预检+服务端权威 `{admitted,gates}`+成功/失败三态(`Publish.vue`/`publish-gates.ts` | 乐观直发,无校验无审核态 | 真实发布须合规/审核门禁与失败可修复路径 |
| R-6 **(P2)** | 鉴权守卫+全链埋点 | vue-router 真守卫(`isRealLogin` 仅真 token+perf/play/session 埋点+白名单转发 | 纯前端 showView 切屏,无后端契约 | "数据"护城河靠真实埋点喂养;写入口须可信边界鉴权 |
---
## 4. 设计系统一致性专章
**总判:设计 token 同源D4 暗色 + cyan/green 色板studio `tokens.css` 自述从 demo 提取),品牌方向正确;但落地度有可感知缺口——品牌字体未加载、主按钮丢渐变、字号阶梯缺失、派生 token 被简化。** 形态层(桌面控制台 vs 移动竖屏)差异属定位非偏差,不计入。
| 维度 | demo | studio | 严重度 | 判定 |
|---|---|---|---|---|
| **字体族** | Inter 首选拉丁 (`:35`) | 系统字体栈,全仓零 webfont/@font-face (`reset.css:31-32`) | **P1** | real-divergence。拉丁字形数字/计数/作者名)与品牌不一致 |
| **主按钮** | `linear-gradient(135deg,cyan,green)`+weight 820+`#061014` (`:219-231`) | `AppButton.primary`=纯色 cyan+weight 600 (`:105-108,71`) | **P1** | real-divergence。核心复用按钮丢最具辨识度的青绿渐变CTA 扁平化 |
| **强调渐变第二色** | 品牌渐变恒 cyan→green十余处 | 仅 2 处标题文字渐变用 cyan→violet (`Create.vue:227`/`Login.vue:276`) | **P2** | real-divergence角色已纠偏是 background-clip:text 标题装饰,非按钮背景)。青绿/青紫两套稀释品牌色语义 |
| **字号阶梯** | 完整 h1(clamp24-40)/h2(19)/h3(15)/p(13)+stat 大数 28 (`:66-69,430`) | body=14px、无 font-size 阶梯、组件硬编码字号、无字号 token (`reset.css:33,16`) | **P2** | real-divergence。缺统一 type scale跨页靠组件硬编码难对齐也不利换肤 |
| **派生 token** | panel-2/3 三级面板+line/line-2 双档描边+shadow 0 22px 60px (`:11-25`) | 仅 panel-2(#161c2e≠demo #151b2b)+单 border+shadow 0 8px 24px (`:20-24`) | **P2** | real-divergence。阴影扩散减半更浅、面板层级被砍、描边三档收敛单档 |
| **feed 图标底色** | `rgba(255,255,255,.10)`+backdrop-blur | `rgba(16,21,34,.6)` 深蓝、blur 仅 GameCard 一处 | **P3** | polish。互动按钮缺玻璃质感精修级 |
| **组件库路径** | 全手写自定义组件 | Vant 4 + `--van-*` 映射 D4 token | **P3** | intentional。架构选型差异建议高频强辨识元素主按钮/胶囊/游戏卡)自研补齐 |
**已纠偏(核验剔除):** "字重整体偏轻、全仓无 ≥800 值"一条核心论据错误(实有 `Create.vue:225` + `Login.vue:274` 两处 font-weight:800已标 verified=false不计入真差距。
**设计系统结论:** 一致token 同源、方向正确),但**需补 3 项品牌落地**才算贴稿——① self-host Inter woff2 + font-display:swap② AppButton.primary 增青绿渐变变体weight~800、文字#061014);③ tokens.css 抽字号阶梯变量(--fs-h1/h2/body/caption消除散落硬编码。派生 token阴影/面板层级)与渐变第二色优先级次之。
---
## 5. 有意 MVP 降级清单(非缺陷,是范围 —— 与真差距分开)
> 以下均为 `verified=true``classification=intentional-mvp-descope`**不构成已实现屏的 UI 走样**,是 demo 完整愿景相对 MVP 子集的有意取舍。列此以正视听:勿在 MVP 阶段当缺陷整改。
**A. 整屏未建6 屏,纯 descope**
- **首页总览门户**P3投资人路演载体归 PC 官网/投资人 demo 远期独立工作项。
- **素材中心**P3Doc A 明确 P-MAT-01~06 全 P1/v2.0,不在 55 P0落地前须补素材契约+授权/分成数据模型+studio 路由/api/store。**采购涉真实支付,必走后端可信边界,不能停留 demo toast mock。**
- **玩法模板中心**P3整屏未建且"玩法品类层=同质化根源"已被创始人 2026-06-12 明令废除(模板重定义为 LittleJS 引擎插件套件,玩法/美术/关卡/UI 改为 agent 生成域legacy 4 模板+存量数据奉令清除 W-CLEAN。若未来恢复模板市场须先评估与废除决策的冲突。
- **创作者数据后台**P3"数据→AI诊断→一键迭代"闭环远期;写侧 telemetry 已采数,回读看板属后续波次。落地须反向定义回读 API+诊断接生成侧(避免孤儿数据/纯静态展示)。
- **B端定制中心前端**P1**触发决策点**):后端 `game-module-biz` 已建成 `/app-api/biz/*` 7 端点(提单/订单/详情/进度/检索/反馈/验收),`AppBizLeadController.java:31` 注释指名"产品端(game-studio)消费",但前端零落地 → **"有 API 无入口"孤儿。需产品拍板B 端前端走 admin 后台/独立门户/线下 BD则属合理 descope在 game-studio/.agent 显式记一行)还是 studio 承接(则按既有 7 端点低成本接通)。**
- **个人中心**P1账号信息/通知/账号设置/帮助/退出登录五项设置入口整屏未建。退出登录因此成孤儿(已升 §3 P0 单列)。
**B. 已实现屏内的功能/形态 descope范围收敛闭环不受损**
- 工作坊:缺"授权IP创作"整模式B端/IP合作长期能力、六类资产生成台+素材拖拽、智能体对话流+任务链可视化、实时预览人偶/动作/拆件/导出——MVP 走"一句话+选模板→整包黑盒生成"。studio 真·可玩运行包预览**优于** demo 假人偶。
- feed互动动作 7→4关注/评论/最喜欢 demo 有 studio 无,举报换掉 demo 没有的合规入口);卡面完玩率/专区两栏未呈现。补评论/关注须先扩 FeedCard.action 枚举与 followed/commentCount 字段。
- 发布弹窗:多渠道发布(抖音/微信/快手/TapTap 勾选+待开通整块未实现studio 仅发布单一专区——与渠道线 HJ-CH-001"feed 终裁不动、渠道另行竞标"口径一致。发布备注/保存配置/上下文自适应文案亦未做(合理简化)。
- 首页5 张资产能力卡/产品路径总览面板/4 张平台规模数据卡——门户叙事用C 端首屏(游戏流)无需,统计归 admin 运营台。
**C. 形态/范式差异(不可比的端差异,非缺陷)**
- 桌面三段式(侧栏+顶 tab+双列 herovs 移动单列+底部 TabBar橱窗 4×3 网格 vs 竖屏整屏吸附;屏间无 URL 切屏 vs vue-router 深链(后者属正向工程化升级);各 missing 屏的桌面双栏布局/霓虹视觉/toast mock 交互——均因整屏未建或端形态差,无可比的"已实现 UI"。
---
## 6. 优先级建议P0P3
### 上线前必修(真差距,已实现屏内或孤儿能力)
| 优先级 | 项 | 动作 | 工作量 |
|---|---|---|---|
| **P0** | 退出登录孤儿 (F-1) | 挂一个可点登出入口直连 `userStore.logout()` | 极小(接线既有能力) |
| **P1** | 主按钮品牌渐变 (V/设计系统) | AppButton.primary 增 cyan→green 渐变变体+weight~800 | 小 |
| **P1** | 品牌字体 (设计系统) | self-host Inter woff2 + font-display:swap中文兜底 | 小 |
| **P1** | 消息一级入口缺失 (L-1) | 确认收敛意图;为 community 通知规划入口(我的页二级/铃铛) | 中(需产品确认) |
| **P2** | 字号阶梯 token (设计系统) | tokens.css 抽 --fs-h1/h2/body/caption组件改引变量 | 中 |
| **P2** | feed 互动按钮视觉 (V-1) | 底色改半透白,酌情加 backdrop-filter | 小 |
| **P2** | 卡片封面兜底渐变 (V-2) | 无缩略图卡按 hash 出多套渐变+轻装饰 | 小 |
| **P2** | 派生 token 对齐 (设计系统) | 对齐/记档 shadow评估补 panel-3/line-2修正 panel-2 | 小 |
| **P2** | 专区命名/卡面信号 (C-1) | 与运营/契约确认 IP 叙事;补玩法标签须先扩 FeedCard 契约 | 中(涉契约) |
| **P2** | 工作坊玩法品类取向 (C-2) | 对齐 demo 文案与后端模板库口径 | 小(文案/产品) |
| **P3** | Share 顶部返回 / feed 图标玻璃感 / 强调渐变第二色 | 一致性精修,非阻塞 | 极小 |
### 需产品拍板(决策点,非纯工程)
- **B 端定制前端归属**admin/独立门户/线下 BD vs studio 承接(后端已就绪)。决策后或在 `game-studio/.agent` 记 descope或按 7 端点接通。
- **工作坊权威视觉基线** (V-3)demo 控制台风 vs studio D4 霓虹风,设计拍板后统一口径。
### 愿景远期(明确不在 MVP勿投入
- 桌面平台门户/投资人 demo首页总览屏
- 素材中心v2.0,须先补素材契约+授权/支付模型)
- 玩法模板市场(须先评估与"品类层废除"决策冲突)
- 创作者数据后台(须反向定义回读 API+诊断接生成侧)
- 工作坊 IDE 化(六类资产台/智能体对话/授权IP模式/编辑态调参)
- 个人中心完整设置页(通知/账号设置/帮助接真实后端后)
- 多渠道发布(抖音/微信/快手/TapTap按 HJ-CH-001 另行竞标)
---
## 附:核验口径说明
- 仅采信 `verified=true` 结论;剔除 2 条 `verified=false`(字重 P3「全仓无≥800」论据错误、Share 返回原 P2「用户卡死」论据错误——Play.vue:136-137 实有 `else router.replace('/feed')` 兜底)。
- 真差距 = `verified=true``classification ∈ {real-divergence, polish, studio-only}` 中需修或需记录者;`intentional-mvp-descope` 全部归 §5不计入必修。
- reverse-gapstudio-only单列 §3.6,不作"缺陷",作"勿误砍"正向记录。
- 本机已二次确认的 load-bearing 事实:`logout()` 真清 5 LS 键且唯一调用方为 401 拦截(`user.ts:147-160`+`request.ts:36`);路由守卫用 `isRealLogin()` 仅真 token`router/index.ts:16-24,133-138`+`user.ts:110`font-weight:800 实存 2 处Play.vue 返回有 /feed 兜底。

View File

@ -0,0 +1,200 @@
# 造梦AI 产品开发路线图(评审版 · 产品功能视角)
> 文档类型:**路线图评审版**(面向创始人决策,结论先行,产品措辞)
> 文档 IDHJ-ROADMAP-001  日期2026-06-16  维护主 agentL0
> 事实源:`docs/mvp/MVP进度总账.md`SoT`docs/architecture/产品需求清单.md`Doc A · 55 P0`.agents/knowledge/mvp-scope-and-milestones.md``docs/mvp/MVP作战清单.md``docs/agent-specs/2026-06-16-studio-vs-demo-UI差距-review.md`
> 口径:**产品功能为主线**(用户能感知的功能),工程模块折叠为"怎么实现"。验收单位 = Doc A 的 **55 项 P0 产品功能**
---
## 1. 结论先行
**一句话现状:** 平台的**核心闭环已经能完整演示**——一句话造出游戏 → 上架审核 → 进信息流刷着玩 → 玩的数据反哺推荐排序,这条"护城河链路"在 staging 上真实跑通、能给种子用户/投资人看。**但离"每个产品功能都真能用"还有距离**:很多功能目前是骨架,真正没补真的大头是**变现(广告→收益→钱包还是桩)**;而**真正决定"能不能公开上线"的,不是工程量,是 ICP 备案/支付进件/广告审核/实名这些日历闸门**——它们周期最长、只有你能推。
**三个关键判断:**
1. **能演示 ≠ 能上线 ≠ 功能都真能用。** 闭环骨架完成度高≈70%),但按"55 P0 全部真实可验收"算,真能用的还是早期。别把"波次跑完"当"产品做完"。
2. **公开上线的关键路径 = 日历闸门(你那条线),不是写代码。** 工程可以并行赶,但备案周期压不动,必须现在就持续推。
3. **MVP 的真正工程大头 = 变现真实化。** 造→玩→数据这三环已真,差"赚钱"这一环从桩变真,护城河"能赚钱"才成立。
```mermaid
graph LR
A["①造游戏<br/>一句话→可玩<br/>🟡W-CLEAN后迁移空窗"] --> B["②上架审核<br/>提交→审核→进流<br/>✅可演示"]
B --> C["③刷+玩+互动+分享<br/>真游戏真渲染<br/>✅可演示"]
C --> D["④变现<br/>广告→收益→钱包<br/>🟡骨架·大头"]
D --> E["⑤数据飞轮<br/>玩→质量分→重排<br/>✅可演示"]
E -.更多曝光.-> C
style A fill:#1c3a2a,color:#7cf2a4
style B fill:#1c3a2a,color:#7cf2a4
style C fill:#1c3a2a,color:#7cf2a4
style D fill:#3a2a1c,color:#ffc857
style E fill:#1c3a2a,color:#7cf2a4
```
---
## 2. 已完成的产品功能(可演示 / 真实)
> 口径:✅真实可用且已 e2e 实证 🟡部分真实(核心真、细节桩)。证据均来自 staging 实测,非推断。
### 2.1 造游戏(创作 → 生成 → 预览)🟡 已演示过 · 当前迁移空窗
> **⚠️ 2026-06-16 复核更正(真机走查暴露):** 创作链路在 2026-06-11 走查时确实跑通4 模板→生成→预览);但 **W-CLEAN06-12下架旧玩法模板层后staging 上创作页"模板列表"返回空数组、且创作页强制必选模板 → 当前无法经 UI 完成创作**"开始生成"恒禁用),处于"旧模板已撤、新版一句话生成W-G1尚未接入 studio"的**迁移空窗**。下表 ✅ 为彼时验证过的能力,**当前真实状态需待 W-G1 接入或创作流改为「免模板」**(详 §3 Phase 1/2 与待拍板)。
| 产品功能 | 状态 | 用户能做到什么 |
|---|---|---|
| 一句话生成可玩游戏P-CRT-01 | ✅ | 输入一句话 → 18-27s 拿到能玩的游戏;成功率 80% |
| 四类玩法可造clicker/merge/idle/tycoon | ✅ | 点击/合成/放置/经营四种品类各能生成、能玩、能进流 |
| 生成进度实时展示 + 超时通知P-CRT-12/13 | ✅ | 进度百分比、失败可读原因、可取消/重试 |
| 生成结果实时预览试玩P-CRT-08 | ✅ | 生成完直接在预览页真玩 |
| 创作引导 + 示例 Prompt 库P-CRT-10/11 | ✅ | 每模板有示例可一键填入、字数校验 |
### 2.2 上架发行(发布 → 审核 → 进信息流)✅ 可演示
| 产品功能 | 状态 | 用户能做到什么 |
|---|---|---|
| 选发布去向专区P-LIC-06 | ✅ | 提交时选双轨专区,落值 |
| 发布前检查 + 锁风门P-PUB-03 / P-LIC-05 | ✅ | 合规门二态拦截,不过不让发 |
| 运营审核台P-OPN-01/02/03 | ✅ | 运营在 admin 点"通过"→游戏进信息流(同事务写排序) |
| 双专区浏览 + 点击即玩P-PLZ-01/03 | ✅ | 玩家按专区浏览、点封面进试玩 |
### 2.3 刷 + 玩 + 互动 + 分享 ✅ 可演示
| 产品功能 | 状态 | 用户能做到什么 |
|---|---|---|
| 竖屏即刷即玩P-FED-01/02 | ✅ | 信息流竖屏刷、点卡进真游戏 |
| 真游戏真渲染(引擎试玩) | ✅ | LittleJS 引擎游戏真渲染进信息流真玩(井字棋已实证),不是假演示 |
| 点赞 / 分享P-FED-03/05 | ✅ | 互动接真遥测;独立分享链接 + 分享落地页P-FED-07/08已建 |
| 加载反馈 + 首屏封面 + 多端操控P-FED-10/11/14 | ✅ | 进度条/封面/触控+键盘 |
### 2.4 数据飞轮(遥测 → 质量分 → 推荐优化)✅ 可演示
| 产品功能 | 状态 | 用户能感知到什么 |
|---|---|---|
| 玩的数据真采集 → 质量分 → 信息流重排P-FED-13 | ✅ | 被玩得好的游戏,在信息流里真的会往前排(已浏览器实证翻转) |
### 2.5 账号 + 社区底座(支撑能力)✅ 真实
| 产品功能 | 状态 | 说明 |
|---|---|---|
| 登录 / 匿名试玩 / 邀请码注册 | ✅ | 手机号+验证码登录、匿名零门槛玩、身份衔接(当前 staging 短信验证已临时旁路,码 8888**公网上线前必须关** |
| 消息通知底座P-NTF-02/03/05 后端) | 🟡 | 通知引擎 e2e 真实(生成完成/审核结果/收益变动可推),**但前端没有"消息"入口承接** → 见待修 |
| B 端 lead formP-BIZ-01/03/04 后端) | 🟡 | 提单→报价→进度状态机 e2e 真实,**但前端无入口** → 见待拍板 |
> **诚实口径:** 上面"✅可演示"指**这条链路能完整真跑给人看**。但底层不少模块仍是"骨架+桩"如真实编译打包、互动持久化、MQ 异步聚合走的是简化实现),离"55 P0 每项都工业级真能用"还有距离——这是收尾阶段要补的。
---
## 3. 待完成功能 + 分阶段排期(核心)
> **三条线并行推进**(互不阻塞、文件边界隔离):**L0=工程闭环 / L1=生成质量 / 你=日历闸门**。
> **公开上线的关键路径 = 你那条日历闸门线**(周期最长、压不动);工程线并行赶在闸门通过前就绪即可。
```mermaid
gantt
title 产品开发路线图(示意节奏;公开上线日由日历闸门周期决定,非工程量)
dateFormat YYYY-MM-DD
axisFormat %m/%d
section 你·日历闸门(关键路径)
ICP/支付/广告/实名/律所(决定上线日) :crit, gate, 2026-06-16, 35d
section L0·工程闭环
P0 闭环卖相收尾(种子可用) :done2, p0, 2026-06-16, 5d
P1 变现真实化(MVP大头) :p1, after p0, 18d
section L1·生成质量
W-G1 便宜模型竞标选型 :g1, 2026-06-16, 7d
品类扩展+渠道发行 :g2, after g1, 18d
section MVP后·生态扩展(v2.0愿景)
六大屏+社区+成长+IP孵化 :v2, after p1, 40d
```
### Phase 0 — 闭环卖相收尾(即刻 · L0 · 让种子用户/投资人流畅体验)
> 目的:现有可演示闭环"看起来像成品、走一遍不卡壳"。全部低成本,**已获你"fix"放行**。
| 项 | 产品价值 | 优先级 | 来源 |
|---|---|---|---|
| 退出登录入口P-ACC-05 | 登录了却无法登出/换号,共用设备死锁;逻辑已写好只差入口 | **P0** | 差距评审 F-1 |
| 主按钮品牌青绿渐变 + 品牌字体 + 字号体系 | 全站 CTA 扁平、字形不一致 → 补回品牌辨识度 | P1 | 差距评审设计系统 |
| 消息通知一级入口P-NTF-01 | 通知能力已建好但前端无出口 → 给"消息"规划入口 | P1 | 差距评审 L-1 |
| 信息流卖相(互动按钮质感 / 卡片封面兜底渐变 / 作者名) | "无图也好看",刷起来像抖音质感 | P2 | 差距评审 V-1/V-2 |
| 链路③⑤ 真 UI 走查闭合 | 把生成的游戏经发布主链灌进信息流 → 信息流有真内容可刷可玩可分享 | P1 | 作战清单 |
### Phase 1 — 变现闭环真实化MVP 真正大头 · L0 + 你支付/广告进件 · 让"能赚钱"从桩变真)
> 目的:广告真展示 → 收益真入账 → 钱包真可见 → 可提现。护城河"能赚钱"这一环。**受"支付进件 + 广告审核"日历闸门制约**Phase 3
| 产品功能 | 现状 | 目标 |
|---|---|---|
| 激励视频广告 + 插屏广告P-ADV-01/02 | 桩 | 接广告联盟(穿山甲/优量汇)真展示、真计收益 |
| 钱包余额 + 收益明细 + 提现P-WAL-01/02/03 | 骨架 | 收益真归集、满 5 元可提现 |
| 积分充值P-PAY-01 | pay 模块未接 | 接入支付,真充值 |
| 三方自动分账 + Token 计费 | 桩 | IP 15-20% / 创作者 55-60% / 平台 20-25% 自动分账 |
| 新人任务奖励P-INC-01 | community reward 桩 | 发 3 作品领流量+现金,真记账 |
| 工程底座补真 | runtime 真实打包 / OSS 真实存取 / 遥测 MQ 聚合 | 把简化实现升到工业级 |
### Phase 2 — 生成质量与品类扩展L1 为主 · 让"造的游戏"更好玩更多样)
> 目的:护城河"生成"这一环——一句话能造出更多品类、更稳、更好玩。**受 DeepSeek/MiniMax key 已解封,现可推。**
| 项 | 产品价值 |
|---|---|
| W-G1 便宜模型竞标选型 | 用便宜模型(非 Fable稳定产游戏把单款成本压到 ¥0.15 级 |
| 生成品类扩展(插件库 v2 | 角色控制器/瓦片关卡/光照/程序生成 → 覆盖 ~19/20 品类矩阵 |
| 现生成 tap 类游戏 driver 自产 | 补齐"一句话现生成"的自动验收 |
| 渠道发行 W-CH抖音+微信小游戏) | 精选整包多渠道分发扩流量入口P0 段已完成,待你三件套) |
### Phase 3 — 上线日历闸门(你 + 律所 · 并行 · ⚠️ 真正关键路径)
> 目的:合法公开上线的前置。**这不是工程量,是备案周期**。看板已建(`docs/mvp/A1闸门看板.md`)。
| 闸门 | 状态 | 说明 |
|---|---|---|
| ICP 备案 + 域名 | 待提交 | 周期最长,越早越好 |
| 支付进件 | 待提交 | 解锁真实充值/提现Phase 1 依赖) |
| 广告联盟审核 | 待提交 | 解锁真实广告变现Phase 1 依赖) |
| LLM 实名充值 | 待确认 | 生成主线的真实算力 |
| 短信签名报备 | 待提交 | 解锁公网真实短信(替掉 8888 旁路) |
| 律所合规意见 | 待约谈 | H5 自研站 IAA 资质口径 / 一壳多游备案 / 灰测红线 |
### Phase 4 — 生态扩展MVP 后 · v2.0 愿景 · 设计稿那六大屏)
> 目的:从"能跑的 MVP"长成"完整生态平台"。**明确不在 MVP勿提前投入。** 均为 Doc A 的 P1/P2。
- **素材中心**(素材货架/授权采购/版权管理P-MAT-*)— 需先补素材契约 + 支付/分成模型
- **玩法模板市场**(浏览/购买商用模板P-TPL-05— 需先评估与"品类层废除"决策的冲突
- **工作坊 IDE 化**(六类资产台/智能体对话/角色编辑/授权 IP 模式P-CRT-02/05/06
- **创作者数据后台**(看板/AI 诊断/一键迭代P-OPS-*)— 写侧埋点已采数,待补回读
- **B 端定制前端**(需求表单/进度看板/验收P-BIZ-*)— 后端已就绪,**待归属拍板**
- **个人中心完整**(账号/通知/设置/帮助P-ACC-01/04
- **社区互动**(评论/关注/粉丝/排行榜P-SOC-*+ **创作者成长激励**P-GRW/INC+ **IP 孵化**P-IPX
---
## 4. 待你拍板的决策点
| # | 决策 | 选项 | 影响 |
|---|---|---|---|
| 1 | **本轮工程完成线重锁** | Phase 0闭环卖相收尾现已放行是否就锁它为本轮完成线 | 决定 L0 主攻方向 |
| 2 | **B 端定制前端归属** | admin 后台 / 独立门户 / 线下 BD则属合理 descopevs studio 承接(后端 7 端点已就绪,低成本接) | 决定 biz 是否进 studio |
| 3 | **工作坊权威视觉基线** | 设计稿桌面控制台风 vs studio 现霓虹科技风 | 设计统一口径 |
| 4 | **生成游戏内购/社交** | (你 2026-06-15 已拍:延后;平台级广告 IAA 变现照旧) | 已决,记录在此 |
---
## 5. 三线分工(谁做什么)
| 线 | 谁 | 现在主攻 | 阻塞解除条件 |
|---|---|---|---|
| **L0 工程闭环** | 我6c6g + mini-desktop | Phase 0 收尾 → Phase 1 变现真实化 | 变现真实化部分依赖你的支付/广告进件 |
| **L1 生成质量** | 员工lili-mac | W-G1 便宜模型竞标 → 品类扩展 | DS/MiniMax key 已解现可推P1 校准需你人测做"人类锚点" |
| **你 日历闸门** | 你(线下) | ICP/支付/广告/实名/短信/律所六闸门 | 周期最长,**决定公开上线日,需持续推** |
> 临界路径一句话:**日历闸门只有你能做且周期最长 → 持续推;工程侧 L0 收尾闭环 + 补真变现、L1 推生成质量,并行赶在闸门通过前就绪。**
---
## 附:本路线图与既有账的关系
- 本文是**面向你的产品决策视图**;工程状态明细以 `docs/mvp/MVP进度总账.md`SoT为准执行排序以 `docs/mvp/MVP作战清单.md` 为准。
- 设计稿差距明细见 `docs/agent-specs/2026-06-16-studio-vs-demo-UI差距-review.md`
- 55 P0 逐项见 `docs/architecture/产品需求清单.md`Doc A