games-development-ai/docs/architecture/技术架构与模块.md
zizi 9735142518 docs: 文档治理——单一事实源去冲突 + 版本历史清理 + 文件名去日期
- 删除 4 个已过时文档(v2 架构选型审阅版 / v2 模块架构与MVP覆盖度 / 2 份已归档 review),
  架构文档收敛为 6 份、agent-specs 收敛为 1 份
- 消除冲突与陈旧值:基础设施成本 ¥3,800→¥4,300;生成成功率 85% 消歧为
  "远期蓝图 / MVP 验收 80%";技术决策版架构图补 studio(12→13 模块);
  契约口径全仓统一为 8 类(7 个 Day-0 contracts/ 文件 + Prompt Registry 第 8 类)
- 清理各文档内部历史/迁移/changelog 段落与失效引用(已删"业务能力全景"章节号引用、
  LayaAir 导出快手等事实错误)
- 8 个保留文档文件名去日期,全仓 markdown 链接与蒸馏来源引用联动更新;
  AGENTS.md 必读清单(7→5 份)与 CLAUDE.md 目录结构同步
- docs/memorys/ 按全局约定豁免(保留带日期归档),docs-design/ 不在本次范围

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

22 KiB
Raw Blame History

绘境AI — 技术架构与模块Doc B

文档类型:Doc B技术架构与模块(面向工程/领域,回答 HOW + 对象边界) 文档 IDHJ-TECH-002  生成时间2026-06-07 三文档套件:产品需求 = Doc A 产品需求清单.md;需求↔模块映射 = Doc C 需求模块映射.md

本文纪律:纯技术分解,按领域边界组织、高内聚低耦合。不出现任何产品功能/需求条目。每个技术功能以 T-{模块}-{nn} 标识,供 Doc C 引用。 职责边界:产品功能入 Doc A工程内生的技术功能入本文二者经 Doc C 做 M:N 映射。模块按 13 模块重划分组织。


0. 模块总览13 模块)

模块 前缀 一句话职责 重划状态
studio STU 创作编排/编辑器域(会话/资产图/rig/对白树/任务链) ★新增
aigc AGC 无状态生成原子LLM/图/音/剧情/模板/校验/风格指纹) 收敛
runtime RT 编译/沙箱预览/多渠道转换/发布状态机
project PRJ 项目生命周期 + 专区 Zone 实体
feed FED 游戏流推荐/互动/分享 + 按 Zone 分区
telemetry TEL 事件摄取/聚合/质量评分/监控告警
pay PAY 支付收单/订单/退款对账
trade TRD 分账/结算/对账/钱包打款/财税
community CMU 社交关系/互动计数/排行成就/通知投递
ip IP 素材安全/授权链/IP 风格原子/Zone 双轨归类/模型训练对接
compliance CMP 内容安全/审核状态机/锁风门 Gate/RBAC/审计/安全基线
biz BIZ B/G 端报价/BPM 编排/签章/CRM/交付验收
ad AD 广告联盟对接/AI 植入/曝光计费/eCPM/归因

模块依赖(单向、低耦合)

graph LR
  STU[studio] --> AGC[aigc]
  STU --> RT[runtime]
  STU --> IP[ip]
  STU --> PRJ[project]
  STU --> CMP[compliance]
  AGC --> CMP
  AGC --> PRJ
  RT --> PRJ
  RT --> TEL[telemetry]
  FED[feed] --> PRJ
  FED --> TEL
  TEL --> FED
  IP --> CMP
  IP --> TRD[trade]
  CMP --> AGC
  CMP --> IP
  PRJ --> CMP
  TRD --> PAY[pay]
  TRD --> AD[ad]
  AD --> RT
  BIZ[biz] --> PRJ
  BIZ --> AGC
  BIZ --> TRD
  CMU[community] --> PRJ

横切关注点(指定唯一 owner

横切 owner 供原子 / 消费 关键技术功能
锁风门(风格-版权一致性 Gate compliance aigc T-AGC-19、ip T-IP-04 供原子project T-PRJ-05 消费 T-CMP-12
专区 Zone运营双轨 project feed T-FED-15 分区、ip T-IP-10 双轨归类、studio 创作去向 T-PRJ-07

1. 模块卡片

game-module-studio ★新增创作编排 / 编辑器域

  • 职责:把"创作会话"编排成可试玩草稿——调度 aigc 生成原子、装配多资产、管理角色 rig / 对白树 / 任务链,落地为 project 草稿。有状态创作工作台后端。
  • 边界 IN:创作会话、资产图、角色 rig、对白分支树、任务链编排、附件上下文、六资产生成调度、批量/可视化工作流编排。
  • 边界 OUT:不跑 LLM/扩散(委托 aigc不持久化项目版本交 project不编译/沙箱(交 runtime不拥有素材库读 ip不做锁风裁决调 compliance
  • 依赖aigc · runtime · ip · project · compliance。
ID 技术功能
T-STU-01 创作会话状态机与持久化
T-STU-02 资产图模型(多资产组合关系)
T-STU-03 角色骨骼 rig 数据结构与动作编辑
T-STU-04 对白分支树(编辑 + 实时写入预览节点)
T-STU-05 agentic 任务链编排引擎7 步生成链)
T-STU-06 附件上下文装配(生成产物/上传 → 生成上下文)
T-STU-07 SSE 进度推送
T-STU-08 草稿装配与 project 移交契约
T-STU-09 六类资产模块化生成调度(按资产种类编排 aigc 原子)
T-STU-10 用户工作流编排(可视化,创作者自定义流程节点)
T-STU-11 批量游戏生成调度

来源T-STU-01..08 为创作编辑器核心能力T-STU-09 为 aigc 收敛迁出(六资产调度)。T-STU-10/11可视化工作流编排、批量生成调度为远期能力产品出口待 Doc A 定义后再建 Doc C 映射,当前暂未映射。

game-module-aigc 收敛无状态生成原子

  • 职责:单 Prompt/请求 → 单确定性产物(结构化参数/GameConfig/图/音/剧情/封面/校验/风格指纹),无状态、幂等、可重放。
  • 边界 INPrompt 解析/安全、模板匹配/Schema、LLM 编排/熔断、生成任务队列/状态机、Fallback、图/音/剧情/封面生成原子、风格标签、内置素材库、DAG 引擎、质量评估。
  • 边界 OUT:不管会话/编辑/多资产装配与进度链编排(交 studio不持久化项目交 project不编译/沙箱(交 runtime不做锁风裁决供风格原子给 compliance
  • 依赖compliancePrompt 安全)· project写入结果· infra文件
ID 技术功能
T-AGC-01 Prompt 解析与归一化
T-AGC-02 Prompt 安全检测
T-AGC-03 模板分类匹配 / 注册 / 扩展
T-AGC-04 GameConfig 结构化生成 + JSON Schema 校验
T-AGC-05 模板参数校验与兜底
T-AGC-06 LLM 调用编排 / 熔断 / 重试 / 多供应商
T-AGC-07 生成任务异步队列调度RocketMQ
T-AGC-08 生成任务状态机queued/running/succeeded/failed/timed_out/canceled
T-AGC-09 确定性 Fallback 生成
T-AGC-10 生成失败原因分类(结构化错误码)
T-AGC-11 风格标签体系
T-AGC-12 内置素材库管理
T-AGC-13 素材上传校验 + SHA256 去重
T-AGC-14 图像 AI 生成原子
T-AGC-15 音乐 / 音效 AI 生成原子
T-AGC-16 剧情 / 对话 AI 生成原子
T-AGC-17 封面 / 宣传图 AI 生成原子
T-AGC-18 DAG 工作流引擎 + 节点配置参数化
T-AGC-19 生成风格一致性检测原子(供锁风门)
T-AGC-20 Golden Config 回归测试
T-AGC-21 生成结果质量自动评估

game-module-runtime 编译 / 预览 / 渠道发布

  • 职责GameConfig→版本化可运行包沙箱预览多渠道小游戏/试玩包)转换与发布状态机。
  • 边界 IN:编译/Manifest/打包、沙箱与事件桥接、体积与完整性校验、预加载与缓存、渠道转换与提审、发布状态机、运行时质量采集。
  • 边界 OUT:不决定发布放行(交 compliance不做推荐分发交 feed不持久化项目读 project不跑生成消费 aigc 产物)。
  • 依赖project · aigc · telemetry · compliance渠道合规被动
ID 技术功能 ID 技术功能
T-RT-01 GameConfig→可运行 Web 包编译 T-RT-17 帧率 FPS 监控采集
T-RT-02 GameManifest 生成与打包 T-RT-18 素材压缩WebP/AVIF/裁剪)
T-RT-03 资源打包上传 OSS版本化路径 T-RT-19 多尺寸封面裁剪
T-RT-04 iframe 沙箱隔离 + CSP T-RT-20 CDN 缓存刷新
T-RT-05 Game SDK 事件桥接 T-RT-21 小游戏转换-微信
T-RT-06 Canvas/WebGL 渲染容器 T-RT-22 小游戏转换-抖音
T-RT-07 GameConfig 运行时注入 T-RT-23 小游戏转换-快手
T-RT-08 游戏资源体积限制≤10MB/首屏≤2MB T-RT-24 渠道适配规则库
T-RT-09 资源 hash 命名长期缓存 T-RT-25 自动图标/封面/截图生成
T-RT-10 资源版本化路径 T-RT-26 统一工程转译引擎
T-RT-11 预加载与三容器策略 T-RT-27 游戏可玩性自动测试Playwright
T-RT-12 加载超时自动跳过 T-RT-28 运行时链路追踪trace_id
T-RT-13 运行错误捕获与上报 T-RT-29 游戏包体积监控
T-RT-14 postMessage 来源与 schema 校验 T-RT-30 云游戏即时运行容器(远期)
T-RT-15 Manifest 完整性校验 T-RT-31 TapTap 试玩包提审通道(试玩包/APK 路径)
T-RT-16 GameConfig 静态校验 T-RT-32 渠道发布状态机(自有必选/待开通→申请→开通→上线)

game-module-project 项目生命周期 + 专区 Zone

  • 职责:项目/版本/草稿全生命周期与状态流转,编排发布,承载专区 Zone 实体owner
  • 边界 IN:项目/版本 CRUD、状态机、草稿持久化、发布前检查、发布审核 BPM 对接、统一发布编排、Zone 实体/归属/运营位/launchZone。
  • 边界 OUT不生成内容aigc/studio不裁决审核结论compliance本模块只驱动状态不编译/转换runtime不做推荐排序feed
  • 依赖compliance · runtime · feed · bpm · infra。
ID 技术功能
T-PRJ-01 项目 CRUD元数据持久化 + 字段约束校验)
T-PRJ-02 游戏状态机draft…published/rejected/unpublished/deleted + 下架/封禁迁移)
T-PRJ-03 版本管理(自增/覆盖/历史/current_version_id 切换)
T-PRJ-04 草稿保存与恢复机制
T-PRJ-05 发布前检查清单(聚合锁风门 + 性能 + 版权)
T-PRJ-06 发布审核 BPM 对接Flowable回写状态
T-PRJ-07 专区 Zone 实体 + 游戏归属 + 运营位(精选/新游/全部)+ launchZone
T-PRJ-08 统一发布编排compliance→runtime→feed失败回滚
T-PRJ-09 游戏工程包导出(+ 多渠道审核元数据预留)
T-PRJ-10 版本回退

game-module-feed 游戏流 + 专区分区

  • 职责:已发布游戏按规则推荐排序成竖屏游戏流,回收互动信号,分享外链,按 Zone 分区。
  • 边界 IN:推荐打分/候选集、保底/降权/冷启动、cursor 分页/去重、互动信号写入、分享页/OG、按 Zone 分区、A/B 框架。
  • 边界 OUT:不存游戏本体/Zone 实体(读 project不算质量分消费 telemetry不裁决举报转 compliance
  • 依赖project · telemetry · compliance。
ID 技术功能 ID 技术功能
T-FED-01 规则推荐打分 T-FED-09 分享落地页渲染 + OG 元数据
T-FED-02 候选集缓存Redis TTL 60s T-FED-10 渠道参数解析utm/channel
T-FED-03 新人保底曝光 T-FED-11 行为信号加权排序
T-FED-04 低质内容降权 T-FED-12 推荐策略 A/B 实验框架
T-FED-05 冷启动策略 T-FED-13 个性化推荐算法(增长期)
T-FED-06 cursor 分页 T-FED-14 精选池管理接口
T-FED-07 Feed 去重 T-FED-15 按 Zone 分区推荐授权IP/UGC 双区独立候选)
T-FED-08 互动信号写入(赞/藏/享/举报→权重)

game-module-telemetry 遥测与数据底座

  • 职责:统一摄取全链路事件,治理 Schema、增量聚合、算 quality_score产出监控告警与数据质量信号。
  • 边界 IN:事件摄取/SDK 上报、Schema 治理、聚合、质量/漏斗/留存/归因计算、埋点采集、健康监控、告警、数据质量、重复检测原子。
  • 边界 OUT:不渲染看板/建议/导出 UI供数据交 Doc A 产品域)|不做推荐决策(产信号给 feed不生成迭代内容建议交 studio/aigc
  • 依赖feed · project · compliance。
ID 技术功能 ID 技术功能
T-TEL-01 事件批量摄取(/events/batch T-TEL-12 运行时 FPS 采集
T-TEL-02 事件 Schema 治理 T-TEL-13 实时监控-服务健康
T-TEL-03 埋点批量上报通道sendBeacon 兜底) T-TEL-14 实时监控-生成任务健康
T-TEL-04 quality_score 计算 T-TEL-15 实时监控-Runtime 健康
T-TEL-05 增量聚合GameDailyStats T-TEL-16 异常检测与告警
T-TEL-06 创作漏斗计算 T-TEL-17 生成失败根因聚合
T-TEL-07 游戏流消费漏斗计算 T-TEL-18 渠道归因计算
T-TEL-08 玩家留存计算 T-TEL-19 数据质量监控
T-TEL-09 创作者复创率计算 T-TEL-20 推荐效果监控
T-TEL-10 平台 Product Metrics 计算 T-TEL-21 玩家设备/性能画像计算
T-TEL-11 游戏加载时间埋点 T-TEL-22 重复内容检测原子

game-module-pay 支付收单 / 订单 / 退款对账

  • 职责:把各类付费统一收单为可追溯、可对账、可幂等的支付订单,对上层屏蔽渠道差异。
  • 边界 IN:支付渠道抽象、订单状态机、退款、对账、幂等。
  • 边界 OUT:不定义会员/积分/内购产品形态与定价(产品域配置)|不做分账/钱包/提现(交 trade
  • 依赖yudao-system · trade · 微信/支付宝/Apple IAP · Redis。
ID 技术功能
T-PAY-01 支付网关抽象(微信/支付宝/Apple IAP
T-PAY-02 支付订单状态机
T-PAY-03 退款处理
T-PAY-04 支付对账
T-PAY-05 支付幂等Redis 防重复扣款/回调)

game-module-trade 分账 / 结算 / 对账域

  • 职责:把多源收入按规则分账、归集、结算、对账并出财税报表,无感资金清算后端。
  • 边界 IN分账规则、收入归集与台账、T+1/月结、对账、佣金、税务、营收聚合、应收账款、提现门槛与打款、奖金/补贴发放执行。
  • 边界 OUT:不做支付收单(交 pay不产广告收益原始数据读 ad不撮合素材交易读 ip不提供看板/钱包 UI供数据给 studio
  • 依赖pay · ad · ip · telemetry。
ID 技术功能 ID 技术功能
T-TRD-01 广告分成分账引擎80%/75%/70% T-TRD-07 平台营收报表聚合
T-TRD-02 多渠道广告收入归集 T-TRD-08 渠道分发收入统一台账
T-TRD-03 T+1/月结结算周期调度 T-TRD-09 B 端应收账款管理
T-TRD-04 对账引擎 T-TRD-10 财务合规(增值税/发票/个税)
T-TRD-05 素材交易佣金计算(抽 30% T-TRD-11 提现门槛校验与自动打款执行
T-TRD-06 税务代扣与凭证生成 T-TRD-12 奖金/补贴发放执行引擎

game-module-community 社交 / 互动 / 通知底座

  • 职责:承载社交关系、互动计数、排行/成就计算与全渠道通知投递,不定义可感知社交玩法形态。
  • 边界 IN:社交关系图谱、互动计数、排行计算、成就引擎、动态扇出、站内信、推送/邮件/短信通道、通知编排、等级自动升降计算。
  • 边界 OUT:不渲染社区前端/不定义玩法(产品侧)|不裁决内容安全(调 compliance不算质量分读 telemetry不结算奖金分成交 trade
  • 依赖project · telemetry · compliance · yudao-system · yudao-infra · trade。
ID 技术功能 ID 技术功能
T-CMU-01 社交关系图谱存储(关注/粉丝/好友) T-CMU-07 推送通道适配APNs/FCM/厂商)
T-CMU-02 互动数据存储与计数(评论/赞/弹幕) T-CMU-08 邮件投递通道
T-CMU-03 多维排行榜计算与缓存 T-CMU-09 短信投递通道
T-CMU-04 成就规则引擎与进度计数 T-CMU-10 事件驱动通知编排(路由/模板/去重)
T-CMU-05 创作者动态扇出 / timeline T-CMU-11 创作者等级自动升降计算引擎
T-CMU-06 站内信投递与已读

game-module-ip 素材安全 / 授权 / IP 风格原子

  • 职责:为素材/IP 资产提供安全可信、授权可溯、风格可校的底座原子,并按 Zone 双轨归类。
  • 边界 IN:素材安全扫描、授权链追溯、授权/分成数据、IP 风格校验原子、冻结、盗用监测、模型训练对接、Zone 双轨归类。
  • 边界 OUT:不做最终锁风裁决(供原子给 compliance不做资金结算交 trade不跑生成aigc不承载素材/模板市场交互(供料 Doc A
  • 依赖compliance · trade · project · aigc · infra/OSS。
ID 技术功能 ID 技术功能
T-IP-01 素材安全扫描(涉黄/暴/政) T-IP-06 IP 盗用监测
T-IP-02 商用授权链建模与追溯 T-IP-07 IP 风格模型训练对接
T-IP-03 授权/分成范围数据与计费口径 T-IP-08 音色克隆训练对接(远期)
T-IP-04 IP 风格一致性校验原子(供锁风门) T-IP-09 模板授权分成原子
T-IP-05 高风险素材冻结 T-IP-10 素材按 Zone 双轨归类授权IP/UGC

game-module-compliance 内容安全 / 审核 / 锁风门

  • 职责:内容安全与审核中枢——安全检测、审核状态机与人工复核、聚合风格原子做锁风裁决,并承载 RBAC/审计/加密/安全基线/防沉迷。
  • 边界 IN:文本/图片/AI 产物安全检测、违禁词、审核状态机/分层/人工复核、举报降权、锁风门聚合裁决、RBAC、审计、安全基线、防沉迷接入、分级判定、渠道合规、封禁、备份。
  • 边界 OUT不自产风格检测原子aigc/ip 供给)|不拥有项目实体(读 project不做推荐产降权信号给 feed不展示隐私/申诉 UI产品功能交 studio
  • 依赖aigcT-AGC-19· ipT-IP-04· project · feed · yudao-system/bpm · 内容安全 API · Vault。
ID 技术功能 ID 技术功能
T-CMP-01 文本内容安全检测 T-CMP-20 审计日志长期保存≥180 天)
T-CMP-02 图片内容安全检测 T-CMP-21 安全日志与告警
T-CMP-03 AI 生成内容风控 T-CMP-22 上传文件安全校验
T-CMP-04 违禁词库管理 T-CMP-23 OWASP Top 10 安全基线
T-CMP-05 Prompt 注入防护 T-CMP-24 SSRF 防护
T-CMP-06 审核决策与状态机 T-CMP-25 CORS 与 CSP 配置
T-CMP-07 风险等级分层策略 T-CMP-26 游戏沙箱隔离安全策略(供 runtime 落地)
T-CMP-08 自动审核(机审通过) T-CMP-27 Secrets 管理Vault
T-CMP-09 人工审核队列 T-CMP-28 敏感数据加密存储
T-CMP-10 举报受理与处理 T-CMP-29 数据传输加密(全站 HTTPS
T-CMP-11 举报阈值自动降权 T-CMP-30 日志脱敏
T-CMP-12 锁风门 Gate(聚合 T-AGC-19+T-IP-04→pass/review/block + 标准/严格/人工复核;挂 T-PRJ-05 T-CMP-31 登录安全与限频
T-CMP-13 分级标签判定 T-CMP-32 依赖漏洞扫描
T-CMP-14 渠道审核规则库(微信/抖音/快手/TapTap T-CMP-33 用户数据最小化采集
T-CMP-15 多渠道合规自动检测 T-CMP-34 用户数据删除权
T-CMP-16 RBAC 权限控制 T-CMP-35 GDPR/个保法预留
T-CMP-17 匿名用户权限约束 T-CMP-36 未成年人防沉迷接入
T-CMP-18 用户封禁与限制发布 T-CMP-37 实名认证接入
T-CMP-19 管理员操作审计日志 T-CMP-38 数据备份与恢复

game-module-biz B/G 端定制工程底座

  • 职责:为 B/G 端定制提供报价、BPM 编排、签章、CRM、交付验收状态机与效果报告聚合。
  • 边界 IN报价计算、BPM 实例编排、电子签章对接、CRM 对接、交付验收状态机、效果数据聚合、代办工单跟踪。
  • 边界 OUT不生成游戏aigc不持久化项目project不收款结算trade不裁决合规compliance不承载 B 端 UI 语义Doc A
  • 依赖project · aigc · trade · compliance · bpm · 电子签章 · CRM。
ID 技术功能
T-BIZ-01 B 端项目报价引擎
T-BIZ-02 BPM 定制项目编排(需求→报价→签约→交付)
T-BIZ-03 电子签章服务对接
T-BIZ-04 CRM 客户/合同数据对接
T-BIZ-05 交付验收状态机
T-BIZ-06 B 端效果数据聚合
T-BIZ-07 代办流程外部工单与状态跟踪(软著/渠道/资质)
T-BIZ-08 收费与变更管理(预付/尾款/变更单)

game-module-ad 广告引擎植入→展示→计费→优化

  • 职责:把联盟接入、广告位 AI 植入、曝光计费、eCPM 优化与归因做成游戏内广告后端原子。
  • 边界 IN:联盟 SDK 对接、AI 植入、曝光上报与计费、eCPM 优化、合规植入校验、效果归因。
  • 边界 OUT:不渲染广告 UIruntime SDK 在游戏内呈现不做结算提现trade不产看板视图telemetry/biz 消费归因信号)。
  • 依赖runtime · trade · telemetry。
ID 技术功能 ID 技术功能
T-AD-01 广告位 AI 自动植入 T-AD-06 展示上报与有效曝光计费
T-AD-02 联盟对接·穿山甲 T-AD-07 eCPM 优化与精准匹配
T-AD-03 联盟对接·优量汇 T-AD-08 广告合规植入校验
T-AD-04 联盟对接·快手 T-AD-09 广告位效果归因
T-AD-05 联盟对接·百青藤

2. 技术功能计数

模块 T-features 模块 T-features
studio 11 trade 12
aigc 21 community 11
runtime 32 ip 10
project 10 compliance 38
feed 15 biz 8
telemetry 22 ad 9
pay 5 合计 204

技术功能共 204 项入本文,产品功能 155 项入 Doc A约 60 项能力同时有产品面与工程面,两侧各计一次。两者的 M:N 映射见 Doc C。