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-10-架构文档三向审计-review.md
zizi 023a2630c3 docs(restructure): agent-specs 深度重构 Phase A——42流水档→7子系统canonical+总账瘦身 
深度重构(创始人批:settled 7域现在做/生成域待协调/FOLD源git rm/_archive只增/无日期主题名/canonical=子系统SoT)。
分析=10主题簇 opus fan-out(1.1M tok);计划经 opus 对抗评审 GO-带必修(prompt活档补回/总账§6取证搬归档不压删/git-status划波)。

7 子系统 canonical(子系统SoT·一域一档·≤150行·砍历史过程·留现行架构+目标+现状+指针):
- agentic编排-SAA / 引擎与运行时 / 开闸验收门-W-G1 / 渠道发行 / studio前端设计体系 / 变现与单位经济 / 战略与合规
- prompt治理体系-execution = KEEP(Prompt第8契约,已是canonical形态)

源档处置(Phase A settled,全committed):
- FOLD 15 + DELETE 1 → git rm(活内容已蒸进canonical,git历史留存)
- ARCHIVE 10 → _archive/(收口报告/取证账本)
- 顶层 dated 档 42→17(剩生成域Phase-B + 治理 + KEEP dossier)

总账(评审M2:不压删):§6波次史42行整段搬 _archive/总账-波次史归档.md(一字不丢)+正文留里程碑摘要+指针。
_index 重构为 canonical 导航;skills+mvp 6档断链→canonical;活档归档引用→_archive。

Phase B(待协调,本次不动):生成主线/固定架构/产品路线图——含他session 06-17在飞WIP,红线不擅动。
留痕:docs/agent-specs/2026-06-17-agent-specs深度重构-plan.md(计划+opus评审)

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

20 KiB
Raw Blame History

架构文档三向审计（商业 × 产品 × 技术）· 评审版

编号 HJ-AUDIT-001 ｜ 2026-06-10 ｜ 审计对象：docs/architecture/ 全部 7 档（结合 docs-design/ 17 档、执行现实、外部核查） 方法：10 路并行子代理（7 路文档深读/分诊 + 历史会话检索 + 外部市场/监管核查）+ 1 路对抗压测（两轮评审纪律）；全部发现带 文件:行号 证据。 委托问题："我不想走错路——这个项目能不能让我赢？" 结论先行。

0. 总判定（一句话）

赛道是真的、你的工程执行力是真的，但"增长红利在渠道生态内、而你的文档把宝押在自有分发位"——方向不算走错，可当前文档体系（尤其对外材料）会把你引向错误的路。需要先拆四颗雷，再按"三线排序"的修正叙事走。

分层判定：

层 健康度 一句话
执行层（MVP进度总账/作战清单/.agents/复盘） 🟢 健康 诚实文化是全项目最值钱的资产，"骨架≠可验收"口径正确
蓝图层（docs/architecture 7 档） 🟡 漂移中 结构好底子好，但 C2/D1/D2/D5 等裁定无一回填，按周失真
对外层（投资人版 + docs-design BP/奇绩） 🔴 危险 含可被尽调证伪的主张与三版互斥口径，先于一切修复

外部事实支撑（2026-06 核查）：2025 小游戏市场 535 亿/+34%（IAA 170 亿，占 32%）→ 赛道真实且增长；极逸 SOON / FunloomAI / SeeleAI 融资确证 → 赛道可融资；TapTap 制造 2026-01 已上线 → 方向不孤独、窗口收窄。但：增长发生在微信/抖音渠道生态内；自有休闲游戏 feed 位早有现任者（摸摸鱼/233乐园/4399）——你的窗口在 AI 供给侧（内容生产成本结构）+ IP 锁风，不在分发形态。

1. 四颗雷（P0 方向性，按急迫排序）

R1 对外材料诚信债（最急——奇绩申报前必须拆）

事实（融资叙事审计 + 外部核查）：

  • 奇绩申报完整资料含可被尽调证伪的主张：奇绩申报:49"打通…穿山甲广告联盟等全域渠道"、:107"完成…全渠道广告自动结算中台搭建"、:113"落地多组创作者变现标杆案例"——现实 M4=桩、零收入、广告资质闸门未启动。面试官要提现流水/广告账户截图即穿帮。
  • 4 份对外稿（BP改造版/生态引擎BP/路演稿/全景材料）未清洗 4 条已裁定红线（垂类微调/四层校验/全域一键/双轨算法，命中行号见审计明细），与仓内"诚实复盘"（2026-06-08）并存=书面双账——重写稿 :13 自己写明"一追问就穿帮"，尽调触达仓库则实锤。
  • 融资口径三版互斥：BP改造版 :701 200-1000万/7-10% ↔ 生态引擎BP :141 3000-5000万/投后2-3亿 ↔ 路演稿 :53 3000万/15%。
  • 团队叙事自相矛盾（申报表内部）：:31"全职5人" ↔ :39/59/69 三创始人均"现任"他司 ↔ :95"集体离职组建"。
  • 竞品数字未经核实即入 BP：极逸 SOON"融资近1亿"（源自竞品分析报告:20）外部核查仅见"超千万"公开口径（投资界 2025-12）；FunloomAI"百度云合作"未找到任何信源。
  • IP 独家口径互斥：BP改造版 :213/:643"独家合作协议" ↔ 已裁定事实=非独家（全景 :215 与复盘一致）。
  • 路演稿残留旧品牌"绘境AI"+绝对化（"行业唯一/100%贴合/绝不OOC"）。

修法（换稿不冻结——奇绩有截止期，错过≈6个月）：

  1. 奇绩申报现版禁投；按"全文批注版+技术段落重写稿"重写，并先刷新两份修正稿自身的过期事实（重写稿 :21 仍写 Dify/通义热切换，现实=模板驱动+new-api/MiniMax；:13"生成链没跑通"已被 M2① 80.0% 推翻——现状其实更好，如实写反而加分）；修复批注版 :77 残留的"打通穿山甲"。
  2. 真实可讲的硬货清单（全部可演示）：发布链+数据回路+真人试玩 e2e 真实、agent 闭环 batch-001 80.0% 全自动验收、单人+AI agents 的研发范式本身（资本效率故事的实证）。
  3. 裁定唯一融资口径与团队口径（建议如实讲"1 全职创始人 + 2 共同创始人兼职 + AI agent 工程体系"——对奇绩这是亮点不是减分项）；BP改造版清洗后晋级唯一主干，生态引擎BP/路演稿/全景材料归档加"禁外发"横幅。

R2 自有 H5 分发 UGC 游戏的合规定性死锁（最重——商业模式级）

事实（合规审计 + 外部核查）：

  • "IAA 免版号"通道只在微信/抖音小游戏备案制内成立；自有 H5 平台不适用（监管灰区）。直接先例：Roblox 中国 2021-12 停服；自营无版号 H5 平台被罚没 111 万案例。
  • 连环死锁：无版号 → 无法接入出版署官方实名/防沉迷系统 → 自有端防沉迷义务无法合规履行（而自营分发时平台是第一责任人，无渠道代管兜底）。
  • 资金二清：平台代收广告费再分账给个人创作者=无支付牌照资金归集风险；合规通行解=持牌分账产品/银行存管/灵活用工代发+个税代扣。全部文档零讨论（合规落地方案:119 仅"依法开票完税"）。
  • 8 项法定产品功能在 Doc A 55 P0 中缺失：C端实名、防沉迷时长/宵禁、未成年充值限制、AIGC 显式标识（《标识办法》2025-09-01 已施行，2025-11 已有集中执法）、青少年模式、关闭个性化推荐、账号注销、提现实名/税务。其中 4 项连合规专项文档也漏。
  • 新增闸门项（原 A1 清单没有）：生成式 AI 服务"大模型登记"+算法备案（自建平台调第三方大模型 API 对公众服务需办理，周期数月）。
  • docs-design/合规落地方案.md 实为王蓝莓 IP 谈判承诺书（兜底赔付/7×24舆情/100%人工复审——对 1 人团队是合同级违约风险），平台自身的合规执行文档不存在。

修法（双层定性 + 三线排序，与 2026-06-08 mvp业务决策"验收=内网灰度"自洽）：

  1. 自有端短期收敛为"邀请制内测/试玩 demo"定性（不公开经营、不接真钱），作为数据资产与产品实验室；公网自有端经营推迟至专项法律意见明确（律所咨询费用千元级，立即启动）。
  2. 变现走渠道：微信/抖音小游戏备案 + IAA（平台代管实名/防沉迷，豁免通道成立）。
  3. A1 闸门看板今天启动（已拖 2 天），并补 3 项：大模型登记、算法备案、分账/灵工方案选型。
  4. ⚠️ 诚实代价：双层定性会让"数据飞轮护城河"短期断粮（渠道数据只回流到对账级）——所以必须配 §3 的替代叙事，否则 R1 重写后没故事可讲。

R3 经济模型：三层分成从未合账 + 全仓无成本侧（变现闭环的算术地基）

事实：

  • 分成口径已有拍板（D3 v2：MVP 统一创作者 80%、全配置化、满 5 元提现）——五处打架（80%/60-80%/50-80%/55-65%/60-65%）属陈旧文档待回填，非未决。
  • 但没人合过总账：渠道分成（微信 IAA 流量主现金分成 60%）× 创作者 80% × IP 方 15-25%（全景:135）三层叠加后平台留存可能为负或近零；唯一一处算账（全景 :189 按 25% 留存）与 80/20 直接矛盾。
  • 全仓零成本侧：单次生成的 LLM+内容审核+存储成本（含 ~20% 失败品摊销）无一字记录；¥4300/月成本表漏 GPU/审核API/WAF高防/短信/通道费（投资人版成本表只算了"跑 demo 的账"）。
  • 连带的用户侧诚信债：种子期创作者广告收益≈0，"满 5 元提现"长期不可达——"能赚钱"承诺可能成为面向用户的下一笔诚信债。
  • 投资人版全文仅 2 个变现数字（80% 分成/满 5 元），无 eCPM/ARPU/CAC/订阅定价；10 万创作者目标无推导；获客通路与预算缺失（玩家侧 0 字）。

修法：不是"现在编一页单位经济"（那是用假设造数，恰是 R1 谴责的行为），而是：① 一页带标注假设的敏感性模型（eCPM 区间 × 渗透率 × 三层分成叠加，明标"假设待测"）；② 把 B2 数据回路扩展为单位经济测量计划（每游戏 LLM 成本/审核成本/广告产值真实埋点）；③ 裁决 80% 创作者分成与 IP 15-25% 的兼容性（两套商业模型不能共用一套账）。

R4 M2 主线正在按被否决的模板集施工（便宜——但今天不修，M-b 后变贵 3 倍）

事实（本审计实锤，全文档无记录）：

  • 创始人 D2 拍板（2026-06-08 v2，定向修订）：MVP 模板=idle/tycoon/merge/clicker（休闲/经营/放置，碎片化时间定位），动作类（躲避/跑酷）明确降 P1；落地指令=contracts/templates/{idle,tycoon,merge,clicker}.schema.json。
  • 实际 contracts/templates/ = clicker/dodge/runner/match（躲避/跑酷/消除——D2 之前的旧集）；C1 spike 52 次实测、C2 闸门判定、M-b 渲染面规划全部基于旧集（spike-summary:10,37"补 dodge/runner/match 模板 runtime"）。
  • 影响：M2 的内容供给正在偏离创始人定的产品定位；且 idle/tycoon 自带留存循环（离线产出/经营回访），dodge/runner 是单次性玩具——留存经济学也站在 D2 一边。
  • 顺带：D1 拍板主 LLM=DeepSeek，现实跑 MiniMax（deepseek key 未激活，作战清单:65）——同属"决策↔执行不对账"。

修法：下一个模板/渲染面波开工前重审 D2：要么按 D2 改建 idle/tycoon/merge runtime（推荐，留存+定位双赢），要么创始人显式修订 D2 认可现集——二选一，但必须留痕回填。（时效注：2026-06-10 M-b 执行器与 clicker 渲染面已上线，dodge/runner/match runtime 仍未建——拍板窗口仍在，且 batch-002 在备，宜先拍后建。）

2. 战略修正案（拆雷后的替代叙事）

对抗评审的关键结论：四颗雷按上述拆法联立执行后，原"数据飞轮"故事短期断粮——审计必须同步交付替代叙事，否则等于让你裸奔进奇绩。

三线排序（修正版叙事，与既有裁定全部自洽）：

线 定位 合规定性 现金/数据产出 对应既有裁定
① B端/IP 营销小游戏线（现金线，提到首位） 王蓝莓等 IP 方/品牌的推广小游戏，按项目收费+分成 推广内容非网络出版物，版号争议最小，回款最早 现金流 + 标杆案例（恰好补 R1 被删的"变现案例"空洞） 王蓝莓=点火燃料裁定；作战清单:53"biz 改轻量 lead form 验 B 端现金流"已有伏笔
② 自有端邀请制线（数据资产线） 内测灰度，养数据回路/quality_score/agent 闭环 试玩 demo 定性，不公开经营 行为数据 + 产品迭代（飞轮的种子，诚实讲"未来式"） 2026-06-08 mvp业务决策"验收=内网灰度"；B2/B2′ 已 e2e
③ 渠道线（规模线） 微信/抖音小游戏备案 + IAA 豁免通道成立，平台代管防沉迷 规模化曝光 + 真实 eCPM 数据（喂 R3 测量计划） 多渠道导出本就在 Doc B/技术决策版蓝图内

窗口重定位：差异化不在"自有 feed"（现任者：摸摸鱼/233乐园/4399/微信小游戏中心），而在 AI 供给侧成本结构（agent 闭环全自动产能+质检）+ IP 锁风保真。对奇绩的故事主轴建议：「单人+AI agents 的资本效率（已实证）→ B端/IP 现金线供血 → 用窗口期把供给侧成本优势滚成内容资产与数据飞轮（未来式，诚实标注）」。

3. docs/architecture 七档逐档判定

文档 判定 最重发现（证据见各节） 处置
系统概要设计-投资人版.md 🔴 对外危险 无风险章、无收入数字层、6 处旧叙事未对齐 06-08 裁定、1/5↔1/20 互斥（:37↔:100）、5人/11周 vs 单人现实 按话术红线回改或显式降级"历史叙事稿"
护城河对外话术-双版本.md 🟡 局部过期 方向正确（诚实纪律），但 C2 后 Dify/OpenGame 段连"诚实 DD 口径"也不再诚实（:68/:86/:100） 小修生成段：模板驱动反而是更强的可控性/成本故事
产品需求清单.md（Doc A） 🟡 需换血 8 项法定 P0 缺失 + ~10 项 P0 非必需（P-PUB-01 多渠道 P0 与现实冲突、BIZ 域记法含混致 55 计数不稳 :217/:219）；登录/注册无 P-id P0 集合按 §5 修订；最小可验证集≈30
需求模块映射.md（Doc C） 🟢 基本健康 抽查 8/10 合理；P-WAL-02 缺实名挂载（:110）、GDPR 应为个保法（:238）、P-GRW-01 弱映射（:158） 小修 3 处
技术架构与模块.md（Doc B） 🟢 意外干净 无 Dify/OpenGame/微服务字样（grep 0 命中）、与模板驱动天然兼容；但双分类学（13模块 ↔ 8核心/19域）无权威声明、4 处具名技术已被 8 决策推翻（RocketMQ:109/Flowable:165/Redis:181/SSE:86）、3 个实存组件无归属（new-api 网关/agent 裁决器/匿名身份）、依赖图"单向"下含 3 对双向环（:30↔:39-49） 头部加三层权威声明 + 最小勘误 + "建设形态"列
系统概要设计-技术决策版.md 🟡 蓝图失真中 生成主线被 C2 推翻未回填（:771/:141-145/:1002）；指标全部"声明无测量"（99.5% 架在单机+MySQL单点上 :460-502/:1151，无拨测/SLI/RUM）；技术风险章缺 new-api 单点（已真实咬人）与 LLM 成本熔断；沙箱同源自废漏洞：allow-scripts allow-same-origin 并存且未规定游戏包独立源部署（:850）——iframe 可触宿主 DOM/移除 sandbox；LLM 输出消毒（模板驱动后配置字符串 XSS 面）无红线；分账/提现链零设计；§9 甘特过期未降级 回填 C2/D1 + 补 SLI 节 + 沙箱红线（独立 usercontent 域）+ §9 加降级注
系统概要设计-开发团队版.md 🔴 有害误导 §1-§3/§6-§9 大面积虚构或过期：docker-compose/CI 不存在、/app/** 应为 /app-api（照写必 404）、-biz 应为 -server（命令必失败）、按 Nacos/RocketMQ 排错=死路 头部废止横幅 + 索引化指向 .agents（权威），AGENTS.md 必读#4 加注；中期重生成（陈旧文档对 agent 是毒训练源）

docs-design 关联判定：合规落地方案=IP 谈判件非平台方案（见 R2）；竞品分析报告=现行权威竞品源但"近1亿"等数字需修（见 R1）；7 份 v1/改名前遗留档（TDD=Next.js+NestJS 旧栈确证、方案大纲、核心差异等）→ 建 docs-design/archive/2026-06-v1-legacy/ 归档加横幅，归档前先蒸馏独有价值（PRD 五项用户指标阈值/TDD 告警阈值与迁移纪律/核心差异的广告计费基准/IP方案商务条款框架——清单见审计工作底稿）；IP 合作通用方案=现行且与裁定一致，保留。

4. "决策 ↔ 执行 ↔ 文档"三层不对账实例集（根因=无回填钩子）

裁定（日期） 执行现实 文档状态 等级
C2 模板驱动生成（06-09） 已按模板驱动跑 batch-001 技术决策版/话术/tech-decisions.md 仍写 Dify+OpenGame P0 已列 R-群
D2 模板集 idle/tycoon/merge/clicker（06-08） contracts+C轨在建 dodge/runner/match 无任何文档记录背离 P0=R4
D1 主 LLM=DeepSeek（06-08） 跑 MiniMax（key 未激活） 决策档未修订 P1
D5 ip=seam 寄宿（06-08） 未独立建 Doc B 仍列独立模块 10 T-id（:257-270） P1
D3 统一 80% 分成（06-08） 未接真钱 五处旧口径未清 P1
06-08 验收=内网灰度 按此执行中 投资人版/exec spec 里程碑未注 P1

最小钩子（不搞三层权威制大工程）：作战清单加一条铁律——"任何裁定类提交，必须附带受影响蓝图/蒸馏档/对外档的 diff 或显式'不回填'声明"；Doc B 头部加一段权威读序（状态=总账 > 实现=8核心方案 > 结构=Doc B）。约 30 行改动。

5. 产品 P0 口径修订方向（Doc A）

  • 出：P-PUB-01 外部多渠道降 P1（自有单渠道保 P0）；BIZ 域保留但改定性——从"B端定制功能"改为"①现金线最小承接：lead form+人工交付"（对抗评审反转：B 端是唯一同时穿过 R2/R3 的现金线，不砍，但 MVP 形态轻量化）；含混记法（P-BIZ-12"P0/P1"、:219"P1/P2"）二选一定死。
  • 进（法定 8 项，对应三线排序分批）：渠道线起步即需=AIGC 显式标识、注销、关闭个性化推荐；自有端公开前需=C端实名、防沉迷、青少年模式、未成年充值限制；真钱开闸前需=提现实名/税务。
  • 升：OPS-01 基础播放数升 P0-lite（创作者发布后盲飞=供给侧留存断点）；P-FED-12"同款创作"升 P0（玩家→创作者转化唯一杠杆）。
  • 两个工作集合：最小可验证集≈30 项（邀请制内测口径）/ 最小可上线集≈40 项（渠道线公开口径）——细目见 Doc A 审计工作底稿。

6. 外部核查关键结论（2026-06-10，带源）

主张 核查结论 置信度
极逸 SOON 融资"近1亿" 公开仅见"超千万"（投资界 2025-12）；"三引擎"无外部证据 打脸（单源）
TapTap 制造 确证，2026-01-31 上线，自然语言生成+TapTap 渠道，免费 确证（最大现实威胁）
FunloomAI 估值 2 亿 确证（Pre-A，清澜家办领投）；"百度云合作"未找到 部分确证
SeeleAI 确证（王诗沐，百度风投领投，海外近百万用户） 确证
OpenGame（CUHK MMLab） 确证存在且活跃（arXiv 2604.18394，2026-04） 确证（已绕开，不影响）
窗口期 6-12 月 局部成立但收窄：TapTap 制造已上；腾讯/字节未正面进入"零门槛文生 H5+独立分发"位；网易 UGC 工具迫近；Roblox Cube 季度级迭代 修正后采信
IAA 免版号 仅微信/抖音备案制内成立；自有 H5 不适用，有处罚先例 确证（R2 依据）
市场 2025 小游戏 535 亿/+34%，IAA 170 亿；微信 IAA 流量主现金分成 60%；eCPM 权威绝对值不公开（从业者区间：激励视频约 20-80 元/千次，低置信） 确证/低置信分列

7. 行动清单

🧑 你（按急迫）：

  1. 【本周】奇绩申报换稿（R1 修法 1-3）；旧版禁投。
  2. 【本周】A1 闸门看板启动（拖 2 天了）+ 补 3 项（大模型登记/算法备案/分账方案）；约一次律所合规咨询（R2 的"UGC 出版定性+防沉迷接入"两问）。
  3. 【下一模板/渲染面波开工前】R4 拍板：模板集按 D2 改建 vs 修订 D2（M-b 执行器与 clicker 渲染面已于 06-10 上线，dodge/runner/match runtime 未建——窗口仍在）。
  4. 【下周】R3 敏感性模型的假设值拍板（eCPM 区间/三层分成叠加规则）。

🤖 我（你点头后分波执行，每波双 spec 铁律）：

  1. 文档回填波：技术决策版 C2/D1 回填 + 沙箱红线 + tech-decisions.md 同步；Doc B 头部权威声明+最小勘误；开发团队版废止横幅；回填钩子入作战清单。
  2. 对外材料清洗波：BP改造版按红线表+现实包重写；归档 v1 遗留档（先蒸馏防丢失清单）。
  3. Doc A 换血波：8 项法定 P0 入册 + 出/升项调整 + Doc C 同步。
  4. R3 测量波：B2 回路扩展单位经济埋点（单游戏 LLM/审核成本与广告产值）。

8. 验证状态与证据边界

  • 已核实：7 档架构文档全文逐行 + docs-design 17 档（10 深读/7 分诊）+ 总账/作战清单/2 份 memorys/4 份 knowledge + mvp业务决策 D1-D4 + contracts/templates 实际清单 + spike-summary；所有行号引用经子代理读取核实；关键否定性结论经 grep 全仓验证（如"实名/防沉迷/标识"在 Doc A 零命中、"拨测/SLI/分账"在技术决策版零命中）。
  • 外部核查：竞品/监管/行情结论来自 WebSearch/WebFetch 带源检索（2026-06-10），单源与未找到项已分级标注；eCPM 绝对值为低置信从业者区间。
  • 推断（未经法务/实测确认）：各法规对本项目的适用性判断（建议律所核验）；99.5% 单机不可达、LLM 单价低估幅度（行业常识级）；"近1亿"夸大倍数依赖单一外部核查。
  • 假设：执行现实包取自总账/作战清单，未逐项复跑 staging 验证；三文档结构一致性沿用 2026-06-07 三独立评审结论未重验。
  • 方法局限：episodic 历史检索个别结论与文档证据冲突时（如"80% 分成已裁定勿改"），以文档实证为准；对抗评审 8 项攻击中 5 项被吸收（总判定精确化/R1 换稿不冻结/R2 替代叙事/R3 降为合账问题+成本侧/S4 现任者证伪），3 项部分采纳。