zizi-al/games-development-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
games-development-ai/docs/agent-specs/_archive/2026-06-17-产品功能与技术模块-完成度与优先级总账.md
zizi c9db9f7d36 docs(agent-specs): 域化重构收尾(保守批)——归档18档+清引用+_index瘦身 
确立 docs/architecture 为设计/现状唯一真源,agent-specs 仅留正在演进的设计。
回灌核对(review §2.4)后将 18 份「已迁入 architecture 或纯留痕」的设计/过程档
git mv 进 _archive(各带 SUPERSEDED tombstone 指新落点);生成域在飞设计链
(架构演进路线/生命周期范式/多session总账/任务普查)+ 3 待定档暂留,待二次收尾。

- 归档 18 档:SAA编排/引擎运行时/验收门/prompt治理(settled 底座,内容在子树)
  + WG1/设计裁决/OpenGame/开闸接线/固定架构review/传承演进/并行编排(已迁子树)
  + 完成度总账(FOLD 进需求模块映射)+ SAA-dossier残留 + 根因复盘/目录治理/
  深度重构plan/文档整理plan/planB-closeout(纯留痕)
- 清 7 处死引用:5 处 .agents/plans 旧 agent-specs 路径→新树 + 2 处 architecture
  树内回链(开闸接线/观测体系→验收门新树路径)
- 修 7 处归档连带死链(指已归档档→新树现行档 或 _archive 留痕)
- _index 补 2026-06-22 收尾 banner + 6 处指针改新树/_archive
- 死链门 check-deadlinks.sh = 0;收尾清单 docs/plans/2026-06-22-域化重构收尾清单.md

待二次收尾(创始人选保守暂留):总体架构-review/固定架构-execution/产品开发路线图
(architecture 仍当其权威源回链,需先补迁详义)+ 对话素材v1(留痕,牵连保留档链接)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 18:18:31 +00:00

14 KiB
Raw Blame History

⚠️ SUPERSEDED · 2026-06-22(设计文档域化重构收尾):本档已归档留痕。155×13 forensic 已 FOLD 进 docs/architecture/产品/需求模块映射.md §完成度快照 + 架构/13模块.md §4。收尾清单 docs/plans/2026-06-22-域化重构收尾清单.md。

绘境AI 产品功能 × 技术模块 — 完成度与优先级总账

出账日:2026-06-17 · 基准分支:origin/dev/2.0.0(当前真相,本地工作树落后 7 提交,已按 origin 核实) 方法:两路 Opus forensic 逐条读码核实(产品 155 功能 / 技术 13 模块),状态以代码/测试/e2e 为准非文档。 口径:✅ implemented-real(真端到端可验收) · 🟡 partial-stub(有壳/半真/部分接线) · 🔴 missing(未建/纯桩)。 关联:多session分工与任务总账 · 生成引擎任务清单普查 · MVP进度总账

0. 两个贯穿全局的事实(决定大量判定)

  1. 前端默认跑 mock:request.ts baseURL 缺省空串 → Vite mock 中间件喂数据;只有注入 VITE_API_BASE 指真服务才走真后端。demo 演示面 = mock + 点击计数兜底。
  2. 真后端发布链是真的、事务原子的,但要人工点审核才闭合(无自动审核 job);真生成出可玩游戏依赖 staging 配齐 worker/SAA + NEWAPI_KEY(部署态,非纯前端可验)。

术语纠正(创始人裁定 6f537ef6):W-CLEAN 下架的是游戏模板(整局填参出整包,旧 4 套 clicker/merge/idle/tycoon);玩法模板(品类/框架引导生成:经营模拟/剧情互动/解谜闯关/TRPG/非遗科普)是有效 P0 待建,不是已废。本账中 P-TPL 域 = 玩法模板。

1. 产品功能清单(155 项 / 19 域)— 已实现 vs 缺失

1.1 按域汇总

域 功能数 ✅ 🟡 🔴 一句话状态
1 素材中心 MAT 6 0 0 6 整域未建(无素材后端/视图)
2 玩法模板 TPL 5 0 1 4 整域未建;templateId 透传 seam 在但列表空(创始人定:有效待建非已废)
3 自定义创作 CRT 15 2 5 8 创作主干半真(一句话生成+实时预览+进度真),资产级能力(六类资产/角色/骨骼/示例库)全缺
4 授权IP创作 LIC 6 0 1 5 仅 launchZone 后端真,其余依赖 MAT/TPL 均未建
5 发布分发 PUB 5 0 2 3 自有发布链真(需人工审核);抖音/微信/快手/TapTap 渠道零代码
6 游戏广场 PLZ 3 1 1 1 点封面即玩真;双专区半真(语义=官方精选/UGC,非授权IP分轨)
7 游戏信息流 FED 16 5 7 4 站内消费闭环真(刷/玩/赞/藏/分享落地页);游标分页桩、端侧体验(弱网/低画质)缺
8 创作者数据经营 OPS 6 0 2 4 看板半真(只看数);AI 诊断/迭代/A-B 全缺
9 钱包收益 WAL 4 0 4 0 余额/提现/明细业务真;打款渠道恒 mock、收入源仅广告一类
10 付费变现 PAY 9 0 0 9 整域几乎全空(PayPlugin 纯桩,pay 模块未接单体)
11 广告变现 ADV 9 0 6 3 计费业务真(mock 可 e2e);真联盟 SDK(穿山甲/优量汇)未写
12 社区互动 SOC 11 0 0 11 整域零后端(评论/关注/粉丝/排行/成就/弹幕全无)
13 创作者成长 GRW 6 0 0 6 整域零实现
14 创作者激励 INC 6 1 1 4 新人现金奖励真端到端;创作者等级仅单级桩、分层权益缺
15 消息通知 NTF 7 4 0 3 通知底座真(系统/生成/审核/收益四类挂点全通);依赖社交/赛事的类型缺
16 IP孵化版权 IPX 13 0 0 13 整域几乎全空(demo 主打的"素材电商+IP 货架"零后端)
17 B端定制 BIZ 14 3 4 7 核心四步真(表单→报价→进度→验收);模板硬编码 4 个、增值服务全缺
18 运营管理 OPN(admin) 9 2 4 3 审核主链真(通过/拒绝/下架/精选);限曝光/导出/经营看板缺
19 账号合规 ACC 5 0 4 1 普遍半真(壳在内容缺:协议死链/分级无 C 端徽标)
合计 155 18 ~42 ~95 真端到端 ✅ 仅 18,且全部是 P0

全 18 项 ✅ 均落在 P0;P1/P2 共 ~100 项无一达 ✅(少数 🟡 半成,绝大多数 🔴 未建)。

1.2 P0 精确口径(55 项 = 18 ✅ / 18 🟡 / 19 🔴)

  • ✅ 18 真端到端:P-CRT-08(实时预览)、P-CRT-12(进度展示)、P-PLZ-03(点封面即玩)、P-FED-02(滑动切换)、P-FED-03(赞)、P-FED-04(藏)、P-FED-08(分享落地页)、P-FED-11(首屏封面)、P-INC-01(新人现金)、P-NTF-01(站内消息中心)、P-NTF-02(生成完成通知)、P-NTF-03(审核结果通知)、P-NTF-05(收益变动通知)、P-BIZ-01(需求表单)、P-BIZ-03(定制进度看板)、P-BIZ-04(交付验收)、P-OPN-02(拒绝反馈重提交)、P-OPN-03(精选池管理)。
  • 🟡 18 部分:P-TPL-03、P-CRT-01(一句话生成,代码真但真出包依赖部署)、P-CRT-04(附件仅落库不透传)、P-CRT-09(重生成,非就地)、P-CRT-13、P-LIC-06(launchZone 后端真前端壳)、P-PUB-03、P-PLZ-01、P-FED-01(竖屏即玩,默认 mock 喂数)、P-FED-05、P-FED-06、P-FED-07、P-FED-10、P-FED-13(推荐池,游标桩)、P-FED-14、P-OPN-01(审核三态,缺限曝光)、P-OPN-04、P-OPN-05。
  • 🔴 19 缺失:P-TPL-01(玩法模板浏览)、P-CRT-02(六类资产模块化生成)、P-CRT-10(创作引导)、P-CRT-11(示例 Prompt 库,仅 mock)、P-LIC-05(锁风强度档)、P-PUB-01(多渠道发布)、P-WAL 渠道字段、P-BIZ-08/11/12 专属流程、P-OPN-08(创作者公开主页)、P-ACC 政策正文页、P-PAY-01(积分充值)等。

1.3 demo 有但 Doc A 无的功能(纯营销面,无后端)

  • home 首页访客平台统计卡(328/24.8k/1286/94.6% 等)= 硬编码,无端点。
  • feed「最喜欢」★星标(独立于赞/藏的第三态)= Doc A 无、代码无。
  • 对话流三标签(绘境引擎/所有素材/代码目录)= demo workshop 独有,无 P-id、无代码。

2. 技术模块清单(13 模块)— 完成 vs 待开发

# 模块 状态 一句话 最大缺口/债
1 project 项目 ✅ completed 全仓最成熟:状态机+唯一真原子跨表发布编排+审核队列真查库 Zone 无独立实体(字段承载,MVP 有意简化)
2 aigc 生成 🟡 partial 执行器主链真(M2 e2e,一句话 18-27s 可玩,80% 成功);但 SAA/控制平面"建成未默认生产" W-G1 worker 未接为 staging 默认产线;玩法模板注册未建;Dify 真生成=桩(墓碑已立)
3 runtime 运行时 🟡 partial 存包/取包/engineBundle 内嵌真,沙箱桥接真 真实编译引擎=桩;渠道转换(微信/抖音/快手/TapTap)未建;OSS 存取桩
4 feed 信息流 🟡 partial 互动信号/getZones/quality 排序真,B2 回灌翻转 e2e 实证 游标分页=桩(永远第一页);候选集纯查 MySQL 无 Redis;举报转 compliance 桩
5 telemetry 遥测 ✅ completed 唯一真端到端数据底座:事件落库+quality 真算分+日聚合 upsert+创作者 stats MQ 异步聚合=桩(有意);adRevenueTotal 占位
6 ad 广告 ✅ completed 计费全链真(合规→幂等→归因→台账)+验签 fail-fast,24 单测 真联盟 SDK(穿山甲/优量汇)=桩,受广告审核闸门 mock-gated
7 trade 资金 ✅ completed 资金状态机真(逐笔入账+冻结 CAS+对账补偿),41 单测;打款 fail-fast 防假钱 真 pay 对接=桩,受支付进件闸门 mock-gated
8 community 社区 ✅ completed 通知底座+等级引擎真,3 上游 notify 挂点全通,22 单测 排行榜/成就引擎=根本没建(MVP 裁剪);多级/多通道未建
9 studio 工作室 🟡 partial 创作编排委托层真(草稿装配+aigc seam+血缘) "7 步生成链"在 studio 不存在(在 aigc SAA 图);六资产/角色 rig/对白树/可视化全桩
10 compliance 合规 🟡 partial 锁风门框架+真注入发布链+RBAC 真 核心检测原子全桩恒 pass(style/ip/内容安全)→ 发布链对违规内容零自动拦截,纯人工兜底
11 biz B端 🟡 partial lead 状态机+报价落库真,13 单测 模板硬编码 4 个(非 32 套);报价引擎/签章/CRM 纯未建
12 ip 版权 ◻ seam 有意不独立建,寄宿 compliance 风格原子桩;素材安全/授权链/盗用监测全未建(远期)
13 pay 支付 ◻ 未接单体 yudao 原生模块,server 显式注释排除出启动器 真实支付收单全未接,受支付进件闸门

合计:✅ 完成 5(project/telemetry/ad/trade/community)· 🟡 部分 6(aigc/runtime/feed/studio/compliance/biz)· ◻ 特殊 2(ip/pay)· 🔴 纯未建 0。

生成主线(贯穿 aigc,护城河关键路径)单独评 🟡:W-G1 worker 已实证 HJ-GEN-001 成立(便宜模型在 LittleJS 插件库写出可真玩轻游戏,7 门 CDP 真机真玩,单款 ¥0.01-0.06 远低 ¥0.15 闸);generic 桥接 7534bdf9 已解创作流 limbo(一句话 P0 不再卡门口)。但 worker 未接为默认产线,玩法模板未建,插件库 4 短板(文本HUD/grid/CCD/drag)。

地基判定:稳。 单体真启、Flyway V1-V17 全绿、契约 12 yaml 锁定、project 真原子跨表发布、telemetry 真闭环、生成主线已被实证成立——脊柱可承重,无 split-brain。

3. 功能优先级(按产品目标排)

产品目标锚:MVP 全闭环种子可试用(创建→生成→预览→发布→审核→feed→玩→互动→广告→收益→遥测→推荐);护城河 = 生成+流量+变现闭环("能造→有人玩→能赚钱")。

Tier 0 — 生死线:让"生成"真正可用且可靠(必须最先,否则无产品)

创始人指令"先把 pipeline 跑通"落在这一层。

  1. W-G1 worker 接为 staging 默认产线 + 生成成功率 ≥80% 稳定(现"已证未上产线")。
  2. 示例 Prompt 库 P-CRT-11(现仅 mock)+ 创作引导 P-CRT-10:种子用户靠这两件才能"会用、用得出可玩游戏",直接决定成功率体感。
  3. 生成超时/失败通知 P-CRT-13(补就地反馈)。

Tier 1 — 闭环骨架补缺口(大半已立住,补关键洞)

  1. 玩法模板浏览/选择 P-TPL-01/03(品类引导生成):提升生成成功率与可控性,高价值但非最高优先级(创始人裁定,排在 Tier 0 生成可靠之后)。
  2. compliance 核心检测硬化(P-PUB-03 / 锁风原子桩→真):放量、接广告、上渠道前的合规死锁。
  3. feed 游标分页 P-FED-13 真化(现永远第一页):真 feed 规模的前提。
  4. 创作者公开主页 P-OPN-08、适龄分级 C 端徽标 P-ACC-03、协议正文页 P-ACC-02 死链修。

Tier 2 — 变现闭环(让"能赚钱"成立,受日历闸门,逻辑可先建)

  1. 广告联盟真 SDK(P-ADV-01/02)、提现真渠道字段+打款(P-WAL-02)、积分充值/会员(PAY 域):业务逻辑 ad/trade 已真,卡在 ICP 备案/支付进件/广告审核等不可压缩日历闸门——先建逻辑,闸门到位即接。
  2. 多渠道发布 P-PUB-01(抖音/微信小游戏):零代码,渠道引擎另行竞标(feed 终裁不动)。

Tier 3 — 护城河增厚(非种子试用生死,post-MVP)

  1. 素材中心 MAT(6)+ 授权IP创作 LIC(6)+ IP孵化 IPX(13):demo 主打的"素材电商+IP 货架"叙事,网络效应/资产护城河层,但不阻塞种子闭环。
  2. 社交 SOC(11)+ 成长 GRW(6)+ 分层激励 INC 大半:社区转起来,二阶段。
  3. 六类资产模块化生成 P-CRT-02、角色骨骼 P-CRT-06、AI 数据诊断 OPS:精细创作能力,引擎线推进后再上。

4. 模块实现优先级(按整体架构排)

架构锚:地基层(被多方依赖,必须最稳)→ 生成主线关键路径 → 消费路 → 叶子层(可后置)。

优先级 模块 为什么 动作
P0 关键路径 aigc 护城河核心,生成主线 W-G1 worker 转正为默认产线 + 控制平面默认开 + SAA 切换裁决 + 玩法模板注册
P0 地基门 compliance 被 project/aigc/feed 消费 + 横切,检测桩=放量死锁 style/ip/内容安全原子 桩→真;接内容安全词库/鉴黄
P1 关键路径 runtime 产物存取/打包,在主链上 真编译引擎 桩→真(或裁定内嵌 manifest 为终态并补 OSS 存取)
P1 消费路 feed 消费闭环,规模化前提 游标分页真化 + Redis 候选集缓存(P75<3s 目标)
P2 受闸门 ad / trade / pay 变现叶子,业务真但卡日历闸门 真联盟/支付渠道 SDK,闸门到位即接;pay 接入单体
后置 新模块(MAT/IPX/SOC/GRW) 护城河增厚,非 MVP 生死 post-MVP 立项
维护即可 project / telemetry / community 已 ✅ 稳 不新投入,随主线小步加固

5. 一句话结论

已立住的真闭环:站内消费主链(真后端创作生成带引擎包的游戏 → 人工审核 APPROVE → 事务入 feed → 竖屏刷到 → 点封面真引擎试玩 → 赞/藏真落库 → 分享回流),外加 B 端 lead 状态机、新人现金激励、站内消息、admin 审核台四条独立真闭环。"能生成一个能玩、能发、能刷到、能互动、能记一笔账"的最小闭环成立。

最大缺口(按优先级):① 生成侧"已证未上产线"+ 玩法模板未建(精细创作能力整体不存在);② compliance 核心检测全桩(合规死锁);③ runtime 真打包 + 渠道转换缺;④ 变现侧真钱受日历闸门;⑤ 素材/IP/社交三大护城河域近乎空白。"生成得精、素材能授权、玩法成体系、钱能真到账、社区能转起来"这五件让护城河成立的事,绝大多数还停在桩或未建。

优先级总纲:先把生成 pipeline 跑稳(Tier 0)→ 补闭环关键洞含玩法模板(Tier 1,玩法模板高价值但非 #1)→ 变现逻辑先建等闸门(Tier 2)→ 护城河增厚(Tier 3)。