zizi 35f13ab7df docs(技术方案): 核心功能技术实现方案 8核心/19域 + 两轮评审修复

新增详细规格(2360行):Tier-D 4差异化核心深设(生成/锁风/游戏流+推荐/数据回路) + Tier-S 4标准件 + Tier-F 7远期 + 总体设计review + 状态仪表盘 + 跨域风险 + 施工前遗留债清单。子代理分域产出、逐条带 文件:行号 实证、诚实标 真实/桩/未建。

两轮对抗评审:Round1(一致性/可行性/完整性/诚实性 4维)→Round2(对抗验证,驳回4/5误报P0)。修复 1 P0(Flyway V10撞号→V11/V12/V13)+ 9 P1(含 H-01发布编排纠偏失真/H-03 ATOM名/C-04 OPS过期口径),诚实度 B+→A。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-09 16:03:06 +00:00

11 KiB

Raw Blame History

造梦AI 核心功能技术实现方案 · 总体设计(评审稿)

面向:CTO 评审。本稿是"高层设计 + 评审门",确认后再 fan-out 产出 19 域详细规格。性质:纯设计,不含代码。状态口径对齐 docs/mvp/MVP进度总账.md("结构骨架 ≠ 真实可验收")。 补的是哪层:介于「概要设计 + 功能分解(Doc B)」与「代码」之间、今天缺失的详细技术实现方案层。

0. 一页结论(给 CTO 先读)

现状缺口:Doc B 是功能目录(WBS),不是实现设计;空泛精准集中在 4 个差异化核心(生成 / 锁风 / 游戏流+推荐 / 数据回路)。设计停在命名 → 代码只能落成桩。
本稿主张:补一层 19 域统一的详细实现方案,但深度分档——差异化核心做到"能攻能建",标准件中等深度,远期件前瞻设计。不重写 Doc B,不推翻选型。
要 CTO 拍的 8 个决策:见 §4,我已给推荐默认值,确认/推翻即可。这 8 项不定,详细规格写不实。
下一步:决策确认后,按 §6 用子代理分波 fan-out 19 域详细规格,主代理验证 + 两轮评审。

1. 目标 / 范围 / 非目标

目标:产出一套 CTO 可评审、工程师可照建、对外可 defend 的技术实现方案,覆盖 8 核心闭环 / 19 产品域;消除今天"待定 / 未指定 / 公式待定"的空泛点。

范围:① 本稿 = 高层设计(架构主干 + 分层策略 + 跨切面契约 + 待定决策);② 下一步 = 19 域详细规格(统一模板)。两者都是纯设计文档。

非目标(本轮明确不做):

不写代码,不做 spike(用户已指定"no specific code")。
不重写 Doc B 功能目录、不重排产品需求清单。
不推翻既有选型(Yudao Cloud / Dify / OpenGame / ComfyUI / 自研 Canvas Runtime / Vue3),除非评审推翻。
不在本稿展开 19 域全部细节(那是下一步 fan-out 的产物)。

2. 主干:架构总览

2.1 seam 架构原则(本项目的真实骨架)

全平台遵循一条规律:控制面自研真接,数据面 / 外部能力留成可替换 seam。

控制面(已真接):Java 状态机、幂等账务、门禁聚合、契约边界。project 发布门禁、trade T+1 结算、ad 计费、compliance 锁风门聚合都已是真实逻辑。
数据面 / 外部能力(仍是 seam):Dify 生成、OpenGame、ComfyUI、广告联盟、RocketMQ、OSS、嵌入锁风、LoRA —— 选型已定,代码是桩 / TODO。

诚实定调(CTO 须知):这套 seam 架构是对的策略(支持波次并行 + 可替换),但它把 4 个差异化核心恰好留在了 seam 一侧。也就是说,作为产品的技术内核,目前还没有一行真实实现。本方案的重点,就是把这 4 个 seam 的"框内设计"补实,让它们从"可替换的空盒"变成"可建的真盒"。

2.2 技术栈全景(已接 vs 仅选型)

层	已接(真实)	仅选型(待接)
后端框架	Yudao Cloud fork(Spring Cloud Alibaba 2025.0.0.0 / Java 17 / Boot 3.5.x)、Gateway、Nacos、MySQL 8 + Flyway V1–V9	—
AI 生成	aigc 任务状态机(壳)	Dify(DAG 编排)、OpenGame(6 阶段代码生成)、ComfyUI(Flux/SDXL + IP LoRA)、通用 LLM
引擎/前端	自研 Canvas Runtime + WanxiangGameSDK Core(TS,注入 iframe)、game-studio(Vue3+Vant)、game-admin(Vue3+Element Plus)	Runtime 真实编译打包、多渠道 adapter、SDK 广告/支付插件
异步/存储	DB 唯一键幂等	RocketMQ(业务流全 TODO)、Redis 候选集、OSS/CDN
风控	锁风门聚合、封禁/分级落库	safe-content-ai、阿里云内容安全、Dify Guardrails、嵌入一致性算法

2.3 闭环数据流

flowchart LR
  A[创作 studio] --> B[生成 aigc<br/>Dify·OpenGame·ComfyUI]
  B --> C[锁风门 compliance<br/>一致性+合规]
  C --> D[发布 project<br/>状态机+门禁]
  D --> E[打包 runtime<br/>构建+多渠道]
  E --> F[游戏流 feed<br/>双专区+排序]
  F --> G[试玩 runtime+SDK<br/><15KB 沙箱]
  G --> H[互动/广告 ad]
  H --> I[收益结算 trade/wallet]
  G --> J[遥测 telemetry]
  J --> K[质量分 quality_score]
  K --> F
  style B fill:#ffe0e0
  style C fill:#ffe0e0
  style F fill:#ffe0e0
  style K fill:#ffe0e0

红色 = 4 个差异化核心(也是当前 seam 最空的地方)。

2.4 跨切面实现契约(每个域的详细规格都必须继承)

把"外部服务 / 异步 / 支付 / 模型调用"的通用要求定义一次,各域规格不再重复,只填差异:

横切关注点	统一约束
幂等	每个写操作有幂等键(生成 `idempotency_key`、广告 `(traceId,eventType)`、结算 `uk_source`、MQ `message_id`);重复请求返回首次结果,不产生重复副作用
超时	外部调用(Dify/OpenGame/ComfyUI/LLM/广告联盟)统一超时 + 熔断;生成 P50<60s / P95<180s / 硬超时 120s→failed
失败/重试	区分可重试与不可重试;重试上限 + 指数退避;生成失败支持用户侧重生成
降级	LLM 降级到备用模型;素材失败→占位资产;广告联盟失败→跳过/ mock;推荐失败→新鲜度兜底排序
补偿	跨模块事务用状态机 + saga 补偿(发布编排失败回滚、结算"先入账后回标"、钱包对账)
可追溯	每个核心动作落 `traceId` + 审计日志;生成/审核/结算全链路可追、可审计、可调试
契约先行	跨模块只经 8 类契约,不直连对方内部;Prompt 即第 8 类契约,进 Git Registry 按 `id@version` 加载

3. 分支:19 域分层与深度策略

3.1 三档分层(决定每域写多深)

档	含义	包含域	详细规格深度
Tier-D 差异化核心	产品本体,框内是真 IP/真难点	生成(CRT/TPL)、锁风(LIC + compliance gate)、游戏流+运行时+推荐(FED/PLZ/feed/runtime)、数据回路(telemetry)	最深:含算法选型、时序、数据模型、失败路径、验收判据,清零所有"待定"
Tier-S 标准件	常识实现,框内是工程标准	发布(PUB/project)、审核运营(OPN/compliance/admin)、变现结算(ADV/WAL/PAY/ad/trade)、消息(NTF)、账号合规(ACC)	中等:复用跨切面契约,重点写状态机 + 幂等 + 对账,不展开算法
Tier-F 远期/未建	本期不建,先锁接口	B 端(BIZ)、社区(SOC)、成长(GRW)、激励(INC)、IP 孵化(IPX)、素材(MAT)、数据经营(OPS)	前瞻:只写"功能边界 + 对外契约 + 寄宿/克隆策略",不写实现

3.2 每域详细规格统一模板(下一步 fan-out 按此产出)

每个域一份,9 项固定结构,保证 19 域一致、可拼装:

功能边界与非目标 2. 实现方案 + 关键时序(Mermaid) 3. 数据模型(表/字段要点) 4. 接口契约(对内/对外) 5. 外部依赖与 seam 边界 6. 失败/降级/补偿路径 7. 待定决策的落地结论(引用 §4) 8. 验收判据(怎么算"真实可验收") 9. 真实状态(已接/桩/未建)

4. 关键待定决策(★需 CTO 拍板,已附推荐默认值)

这 8 项是详细规格的前置依赖,不定则 Tier-D 写不实。 我给了 risk-low 的推荐默认,CTO 确认或推翻:

#	决策项	现状	推荐默认(待 CTO 确认)	阻塞什么
1	锁风嵌入模型	仅命名"风格指纹原子",算法未指定	先用开箱 CLIP(ViT-L/14) 算风格相似度做 MVP 基线,可解释、零训练;后续按 IP 训风格编码器/LoRA 增强	锁风核心算法、整个差异化壁垒
2	quality_score 公式	"公式待定",代码恒 0	初版 = 归一化加权(完成率·平均时长·正向互动率 − 举报率 − 加载失败率),0–100,标"可调"	数据回路、推荐飞轮
3	推荐 MVP 形态	概要设计有公式,代码只 ORDER BY	本期 = 规则线性加权(给定初始 w1..w6)+ 新人保底;Redis 候选集本期不做(直查 MySQL 满足 P75 目标)	游戏流排序
4	LLM 首选	通义/DeepSeek/OpenAI 未拍板	DeepSeek(成本)+ 通义(中文/合规)双备,Dify 热切换;首选按成本压测定	生成成本与可用性
5	生成进度通道	同步轮询(现状)	MVP 用同步轮询够用;M2 真生成后上 SSE;暂不引入 MQ 推送复杂度	生成 UX、aigc 架构
6	多渠道本期范围	adapter 全是设计	本期只做自有游戏流真适配 + 微信小游戏导出;抖音/快手留 seam	runtime adapter 工作量
7	人审引擎	文档写 Flowable,代码是状态机	不引入 Flowable,用轻量状态机 + admin 审核队列;复杂编排需求出现再引入	compliance/project 审核实现
8	OpenGame 依赖策略	外部 Python 单点	fork 自维护 + 抽象 `CodeGenProvider` 接口,可退化到"模板填充 + LLM 补全"兜底,降低单点风险	生成核心的外部依赖风险

5. 权衡与风险

最大风险:又一份不接代码的文档。 你们最不缺文档(进度总账:结构骨架≈70% 但真实 P0 个位数)。缓解:本方案 Tier-D 每项必须带"验收判据 = 怎么算真跑通",把详设直接绑到"打穿生成竖切"这个动作上;详设是施工图,不是收藏品。
广度 vs 深度:19 域全等深 = 重抄标准件、工程量爆炸。缓解:§3.1 三档分层,把力气压在 Tier-D。
选型外部依赖:OpenGame(外部 Python)、Dify 自部署成本、LLM 成本与合规。缓解:决策 #4/#8 的双备 + 兜底接口。
诚实口径风险:详设若又写成"原子/校验"这类命名,等于白做。缓解:§7 验收标准第 1 条作硬门禁。

6. 详细规格产出计划(评审通过后执行)

flowchart TD
  R[本稿评审通过 + 8 决策确认] --> W1[波次1: Tier-D 4 核心]
  W1 --> V1[主代理验证 + 第1轮评审]
  V1 --> W2[波次2: Tier-S 标准件]
  W2 --> V2[第2轮评审]
  V2 --> W3[波次3: Tier-F 远期前瞻]
  W3 --> ASM[拼装为统一《技术实现方案》]

执行方式:每个域一个子代理(Opus),按 §3.2 模板产出,读对应 Doc B 段 + 模块代码 + 契约做依据,带行号佐证、诚实标状态;主代理验证一致性后合并。
两轮评审:对齐 CLAUDE.md 规范(master spec 两轮 review)。
波次顺序:Tier-D 优先(差异化核心),其次 Tier-S,最后 Tier-F。

7. 验收标准(这份方案合格的判据)

无空泛命名:Tier-D 每个核心,算法/时序/数据/失败路径/验收判据齐全,"待定"清零;一个怀疑者照着能攻、一个工程师照着能建。
状态诚实:每域标注已接/桩/未建,与进度总账一致,不把设计当已实现。
决策闭环:§4 的 8 项全部有 CTO 结论并回填进各域 §7。
可施工:生成竖切(Dify/OpenGame→aigc→runtime 打包→试玩)在详设里是一条可照建的完整链路。

8. 请 CTO 回这几条(确认即可开工)

§4 的 8 个决策:逐条确认 / 推翻 / 留我定?
分层(§3.1):Tier-D/S/F 的归档同意吗?有无要升/降档的域?
范围:19 域全覆盖,还是本轮先只交付 Tier-D 4 核心详设、其余挂起?
交付物形态:一份合并大文档,还是按域分文件 + 一份总览?

确认后我即按 §6 启动波次1(Tier-D 4 核心详细规格)。

11 KiB Raw Blame History Unescape Escape