docs(audit)+docs(mvp): 三向审计修复全链入库——报告+W1回填+创始人拍板波+W2清洗+三件产出
- 审计报告 HJ-AUDIT-001 入库 + W1 文档回填波(技术决策版/Doc B/开发团队版废止横幅/AGENTS.md/两规则档/tech-decisions) - 创始人拍板波(2026-06-10 晚,回填铁律逐项执行): · R4=维持 D2 按 D2 改建(M-c 建 merge→idle→tycoon,动作类降 P1 留契约)→ D2 复审注+tech-decisions #6 · 鉴权七项全拍(§9.1:C 验证码+邀请码旁路/受限激活/开放注册/创作限白名单/一键登录/实名提现前/纯客户端 anonId)→ glossary+events.schema.json 同步 · A1 闸门看板建账(12+1 项含短信报备+大模型登记/算法备案/分账选型,主体已确认)+ 律所合规咨询 brief · 奇绩 ★1/2/3 定稿 + 品牌造梦→绘境清扫(4 档正文+文件名、demo 改名 huijing-ai-demo.html、禁投/禁外发横幅、内部引用 5 处) · M-c 四细节(两批 merge 先行/idle 纯前端+storage/10 校准+20 正式/拖拽为主) · R3 收口(叠加规则=IP 从创作者份额出·净额基数·平台恒 20%,eCPM 档 15/30/60)→ D3 复审注+glossary+BP:299 勘误 - W2 对外清洗收口:BP 改造版红线清洗(20 处锁风系红线词清零/独家→非独家/绝对化清零/06-10 实证+三线排序入文,留 3★ 待创始人) - 三件产出:鉴权 execution 版(V11/system 内扩展/14 @PermitAll 端点/NOT NULL 硬边界)+ Mc 模板波 review 版(已拍)+ 单位经济敏感性模型(基准 324 元/月/千DAU,覆盖基建需 1.33 万 DAU→实证 B 端现金线优先) - 两本账同步:作战清单(五件拍板项清零)+ 进度总账(三行执行记录) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
parent
dcb680e95f
commit
8a59a35133
@ -37,10 +37,10 @@
|
||||
| **资产图**(Asset Graph) | studio 的多资产组合关系模型(T-STU-02):描述图元/角色/特效/场景/界面/音乐六类资产如何组装成一款游戏;区别于"资产空间"(创作者素材仓库)。 |
|
||||
| **三种创作模式** | 覆盖小白到专业:模式 A 一句话生成(Prompt→成品,AI 主导)、模式 B 资产驱动创作(先攒资产再组装,AI 辅助单项)、模式 C 工作流编排(专业创作者在 Dify 可视化自定义节点)。 |
|
||||
| **资产空间**(Asset Workspace) | 每个创作者独立、归其所有的素材空间,含视觉/音频/设计/商业化四类资产;每类资产支持 AI 生成、手动上传、市场获取三种产出方式。 |
|
||||
| **DataPermission 之外的隔离** | 匿名玩家通过 framework 层扩展的"匿名 Token"机制接入,只能浏览试玩、不能发布/收藏/进后台。 |
|
||||
| **DataPermission 之外的隔离** | 匿名玩家=**免登读路径**(读端点 `@PermitAll` + 前端 anonId 透传),只能浏览试玩、不能发布/收藏/进后台。⚠️ 2026-06-10 显式变更(鉴权拍板 §9-7=B):**不再走 framework 层"匿名 Token"机制**——anonId 为纯客户端生成、身份不可信,防伪造/刷量由 telemetry 聚合侧按 anonId/IP 异常剔除兜底(见 `docs/agent-specs/2026-06-10-真实鉴权与匿名玩家-review.md` §5A/§9.1)。 |
|
||||
| **eCPM** | 每千次广告展示收益,是广告变现核心指标;平台用游戏内容标签 + 玩家画像优化 eCPM。 |
|
||||
| **T+1(结算周期)** | 自有渠道广告分成次日(T+1)自动入账创作者钱包,外部渠道按月结算;满 5 元即可提现。 |
|
||||
| **分成比例** | 广告收益按创作者层级分成:小白 80% / 进阶 75% / 专业 70%(投资人叙事统一口径"创作者拿 80%")。 |
|
||||
| **分成比例** | 广告收益按创作者层级分成:小白 80% / 进阶 75% / 专业 70%(投资人叙事统一口径"创作者拿 80%";D3 拍板 MVP 统一 80%)。**R3 叠加规则(2026-06-10 拍板)**:基数=平台从渠道实收**净额**(微信 IAA 渠道先扣 40%);使用 IP 素材时 IP 授权分成 15-25% **从创作者份额内扣**(创作者实得 55-65%);平台恒留净额 20%。模型见 `docs/mvp/单位经济敏感性模型.md`。 |
|
||||
| **SLO / Error Budget** | 服务可用性目标与可消耗的不可用预算:游戏流 API 99.5%(月 3.6h)、AI 生成 99%(月 7.2h)、支付 99.9%(月 43min)。 |
|
||||
| **最终一致性 + 补偿** | 跨模块写操作尽量不用分布式事务,改"本地事务 + MQ 事件 + 失败补偿",定时任务扫描超 5 分钟"中间态"记录重试或告警。 |
|
||||
| **Golden Config 回归** | 用模板标准配置样例做比对回归,确保模型/模板迭代后生成质量不退化。 |
|
||||
|
||||
@ -10,6 +10,8 @@
|
||||
|
||||
## 1. 关键决策表(ADR)
|
||||
|
||||
> **⚠️ 回填(2026-06-10,HJ-AUDIT-001)**:下表「AI 生成引擎」行已被 **C2 裁定(2026-06-09)部分取代——MVP 现行生成主线 = 模板驱动**(LLM 直出 GameConfig 参数 + 固定模板 runtime,经 new-api 网关直连 LLM;Dify/OpenGame 均未部署,降级为远期增强)。§1.1 Tier1 行的「OpenGame 文生代码」同此。证据:`docs/agent-specs/2026-06-09-generation-spike/spike-summary.md`(52/52 结构层 100%)。
|
||||
|
||||
| 决策点 | 选择 | 理由 | 放弃的备选(why-not) | 风险 |
|
||||
|---|---|---|---|---|
|
||||
| **后端框架** | Yudao Cloud(Java 17 + Spring Cloud Alibaba),fork 二开 | 60%+ 后台能力开箱即用(RBAC/OAuth2/BPM/文件/通知/审计/代码生成/多租户);社区活跃(60k+ star);单体启动可平滑拆微服务 | **NestJS(Node)**:v1 验证可行但缺企业级基础设施,微服务生态弱,后台/工作流要从零建;**Go(Kratos/go-zero)**:性能好但 RBAC/BPM/代码生成无现成方案 | 绑定 Yudao 升级节奏;须守"不改 framework 层"才可升级 |
|
||||
@ -32,7 +34,7 @@
|
||||
|
||||
| 层 | 定位 | 选型 | 生成路径 | 状态 |
|
||||
|---|---|---|---|---|
|
||||
| **Tier1 极轻量H5/2D** | 游戏流即点即玩,首屏 P75<3s | **自研轻量 Canvas Runtime(<15KB)** + iframe 沙箱 + SDK 注入 | **OpenGame** 文生代码 | ✅ 锁定。直出 plain Canvas/JS,自研壳=护城河,**MVP 唯一交付层** |
|
||||
| **Tier1 极轻量H5/2D** | 游戏流即点即玩,首屏 P75<3s | **自研轻量 Canvas Runtime(<15KB)** + iframe 沙箱 + SDK 注入 | ~~OpenGame 文生代码~~ → **模板驱动(C2 裁定 2026-06-10 回填)**:LLM 填参 + 固定模板 runtime | ✅ 锁定。自研壳=护城河,**MVP 唯一交付层**;OpenGame 代码生成降级远期增强 |
|
||||
| **Tier2 复杂2D+3D** | 中重度含 3D,渠道分发 | **Cocos Creator 3.8.8 + MCP**(备选 PlayCanvas) | **Cocos-MCP** agentic 工具编排(studio 编排) | ✅ 锁定。MCP 158 工具可 AI 驱动;MVP 至多 1 个探针 demo |
|
||||
| **Tier3 独立App** | 打包为原生应用 | **Cocos 原生导出**(同 Tier2 引擎) | 同 Tier2 + 打包 | ✅ 锁定引擎。否决 Unity(AI 适配差、启动重);MVP 后投入 |
|
||||
|
||||
@ -56,11 +58,12 @@
|
||||
|
||||
| # | 待确认项 | 候选 | 出处 |
|
||||
|---|---|---|---|
|
||||
| 1 | MVP 首选 LLM | 通义千问 / DeepSeek / OpenAI 兼容接口(Dify 支持热切换,可后置) | 选型审阅版 §11.1 |
|
||||
| 1 | ~~MVP 首选 LLM~~ → **已拍板**(D1,2026-06-08):主 DeepSeek + 备 Qwen,不接 OpenAI;**现行实际 = MiniMax-M2.7 经 new-api 网关**(DeepSeek key 未激活;激活后切换或修订 D1) | — | `2026-06-08-mvp业务决策.md` D1 |
|
||||
| 2 | v1 运行时资产移植方式 | Canvas2D 渲染 + 小游戏转换逻辑:移植为 Java 服务,还是保留 Node 微服务 | 选型审阅版 §11.2 |
|
||||
| 3 | 产品端域名方案 | game-studio 与 game-admin 同域不同路径,还是不同子域名 | 选型审阅版 §11.3 |
|
||||
| 4 | MVP 登录方式 | 手机号验证码 / 邮箱+密码 / 微信扫码(均经 Yudao OAuth2/SMS 支持) | 选型审阅版 §11.4 |
|
||||
| 4 | ~~MVP 登录方式~~ → **已拍板**(2026-06-10 七项全拍,见 `2026-06-10-真实鉴权与匿名玩家-review.md` §9.1):**C 验证码为主+邀请码旁路**、玩家开放注册(受限期凭邀请码)、创作/发布限 A2 白名单、互动即弹一键登录、实名提现前收、匿名=纯客户端 anonId+聚合侧剔除(glossary/contracts 已同步修订);待出 execution 版排建设(建议 M-b 后) | — | 鉴权评审版 §9.1 |
|
||||
| 5 | Tier3 独立App 运行时引擎 | **Cocos Creator 3.8.8 + MCP 统一 Tier2/3(见 §1.1)** | 运行时选型研究 |
|
||||
| 6 | ~~MVP 模板集不一致(R4)~~ → **已拍板**(2026-06-10 创始人复审):**维持 D2 集合,按 D2 改建**——M-c 建 idle/tycoon/merge runtime(clicker 保留,顺序建议 merge→idle→tycoon);dodge/runner/match schema 降 P1 保留契约不删。回填见 `2026-06-08-mvp业务决策.md` D2 复审注 | — | HJ-AUDIT-001 R4 + mvp业务决策 D2 |
|
||||
|
||||
---
|
||||
|
||||
@ -75,6 +78,7 @@
|
||||
| **时间线** | 双路线并存:投资人版 5 人/11 周、执行 spec 10 人/3 周;执行排期以 mvp-execution-spec 为准(含逐日计划与里程碑) |
|
||||
| **MVP 范围/口径** | MVP 验收以 Doc A 的 **55 项 P0 产品功能**为准;技术实现范围经 Doc C 反查 Doc B(工作量 ≈137 技术项)。详见 [`mvp-scope-and-milestones.md`](./mvp-scope-and-milestones.md) §3 |
|
||||
| **模块划分** | **13 模块**(含 game-module-studio 创作编排域,aigc 为无状态生成原子);能力清单拆为产品功能(Doc A)/技术功能(Doc B)/映射(Doc C) 三文档分离 |
|
||||
| **生成主线** | **MVP=模板驱动**(LLM 直出 GameConfig + 固定模板 runtime,经 new-api 网关);Dify/OpenGame=远期增强(C2 裁定 2026-06-09,M-b 已按此上线) |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@ -69,7 +69,7 @@
|
||||
| 类型 | 严格 TypeScript,**禁止 `any`**(必须用时注释说明充分理由) |
|
||||
| 请求 | 统一使用封装的 `request` 实例,自动处理 Token 注入 / Refresh 刷新 / 错误提示;禁止裸 `fetch`/`axios` |
|
||||
|
||||
> admin 二开:新页面放 `views/game/`、API 放 `api/game/`,复用 Yudao CRUD 组件(`XTable`/`XForm`/`Dialog`),不改 Yudao 原生 views。
|
||||
> admin 二开:新页面放 `views/wanxiang/`、API 放 `api/wanxiang/`(仓内实际目录,2026-06-10 审计校正;旧档所写 `views/game/` 已废),复用 Yudao CRUD 组件(`XTable`/`XForm`/`Dialog`),不改 Yudao 原生 views。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@ -25,9 +25,10 @@
|
||||
|
||||
### 1.1 游戏沙箱具体配置(runtime / compliance 共守)
|
||||
|
||||
- `iframe sandbox="allow-scripts allow-same-origin"`。
|
||||
- CSP:`script-src 'self'; connect-src 'none'`(**游戏内禁止任何网络请求**)。
|
||||
- `iframe sandbox="allow-scripts allow-same-origin"`。**红线(2026-06-10 审计补,HJ-AUDIT-001)**:`allow-same-origin` 仅当游戏包托管于**独立源**(usercontent 子域,与宿主不同源)时方可使用——同源下 iframe 可触宿主 DOM/存储、甚至自移除 sandbox;独立源就绪前**禁用 `allow-same-origin`**。
|
||||
- CSP:`script-src 'self'; connect-src 'none'`(**游戏内禁止任何网络请求**);CSP 经游戏包托管侧 **HTTP 响应头**下发,不以 meta 标签为唯一依赖。
|
||||
- postMessage:校验来源 origin 在白名单 + 消息 schema 校验,防伪造。
|
||||
- **LLM 产物消毒**:GameConfig 文案字段(title/label/theme 等)入库前白名单字符集+长度校验,渲染侧一律转义后绘制,**禁止 innerHTML/eval**(模板驱动后 LLM 注入面=配置字符串)。
|
||||
- 资源总大小 ≤ 10MB,首屏 ≤ 2MB;创作者通过**配置(非代码)**驱动游戏,平台对运行时代码有完全控制权。
|
||||
|
||||
### 1.2 内容安全分层(自部署快检 + 商用兜底)
|
||||
|
||||
@ -103,7 +103,7 @@ The 5 documents below form a complete picture of the project. **On first onboard
|
||||
| 1 | `docs/architecture/系统概要设计-投资人版.md` | Business positioning, capital efficiency, moat & window of opportunity |
|
||||
| 2 | Three-Doc Suite: `docs/architecture/产品需求清单.md` (Doc A · product WHAT) / `docs/architecture/技术架构与模块.md` (Doc B · technical HOW · 13 modules) / `docs/architecture/需求模块映射.md` (Doc C · RTM) | Product requirements / technical modules / M:N mapping (replaces the old "business capability overview") |
|
||||
| 3 | `docs/architecture/系统概要设计-技术决策版.md` | Full technical-decision picture (architecture baseline) |
|
||||
| 4 | `docs/architecture/系统概要设计-开发团队版.md` | Day-to-day dev handbook: environment / directory / conventions / integration / commits |
|
||||
| 4 | `docs/architecture/系统概要设计-开发团队版.md` | Day-to-day dev handbook(⚠️ target-state design: env/commands diverge from reality — follow `.agents/rules` + `docs/mvp/MVP进度总账.md` instead; see the in-doc status banner, 2026-06-10 audit) |
|
||||
| 5 | `docs/superpowers/specs/mvp-execution-spec-design.md` | MVP execution spec: 10 people × 3 weeks, contract-first (acceptance = 55 P0 product features / workload ≈ 137 technical items, already synced in the body) |
|
||||
|
||||
> Tip: the original docs are long; reading them in full slows tasks down. **The distilled versions live in `.agents/knowledge/` and are the default day-to-day entry point.**
|
||||
|
||||
@ -25,7 +25,7 @@
|
||||
"additionalProperties": false,
|
||||
"properties": {
|
||||
"userId": { "type": "string" },
|
||||
"anonId": { "description": "匿名 token 派生的稳定匿名 ID", "type": "string" }
|
||||
"anonId": { "description": "纯客户端生成的稳定匿名 ID(localStorage 持久化;身份不可信,防伪造/刷量由聚合侧按 anonId/IP 异常剔除兜底——2026-06-10 鉴权拍板 §9-7=B,取代旧'匿名 token 派生'机制)", "type": "string" }
|
||||
}
|
||||
},
|
||||
"context": {
|
||||
|
||||
@ -3,7 +3,7 @@
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>造梦 AI - 产品交互 Demo</title>
|
||||
<title>绘境 AI - 产品交互 Demo</title>
|
||||
<style>
|
||||
:root {
|
||||
--bg: #070911;
|
||||
@ -2176,7 +2176,7 @@
|
||||
<div class="shell">
|
||||
<aside class="sidebar">
|
||||
<div class="brand">
|
||||
<svg class="brand-icon" viewBox="0 0 128 128" role="img" aria-label="造梦AI 图标">
|
||||
<svg class="brand-icon" viewBox="0 0 128 128" role="img" aria-label="绘境AI 图标">
|
||||
<rect width="128" height="128" rx="18" fill="#f7f7f2"></rect>
|
||||
<g fill="none" stroke="#151513" stroke-width="12.5" stroke-linecap="round" stroke-linejoin="round">
|
||||
<path d="M21 97c-9 0-13-9-12-28l.5-10C11 31 34 11 65 11h19c26 0 43 18 43 47v12c0 27-19 45-46 45h-7c-7 0-11-5-11-12V91c0-7 5-12 12-12h7c12 0 22-9 22-21 0-10-7-18-18-22"></path>
|
||||
@ -2186,8 +2186,8 @@
|
||||
</g>
|
||||
<rect x="96" y="39" width="10.5" height="10.5" rx="1.2" fill="#151513" transform="rotate(45 101.25 44.25)"></rect>
|
||||
</svg>
|
||||
<svg class="brand-wordmark" viewBox="0 0 172 64" role="img" aria-label="造梦AI 用指令开启万象世界">
|
||||
<text x="0" y="31" fill="#ffffff" font-size="29" font-weight="900" font-family="PingFang SC, Microsoft YaHei, Arial, sans-serif">造梦AI</text>
|
||||
<svg class="brand-wordmark" viewBox="0 0 172 64" role="img" aria-label="绘境AI 用指令开启万象世界">
|
||||
<text x="0" y="31" fill="#ffffff" font-size="29" font-weight="900" font-family="PingFang SC, Microsoft YaHei, Arial, sans-serif">绘境AI</text>
|
||||
<rect x="76" y="22" width="8" height="8" rx="1.5" fill="#ffd21f"></rect>
|
||||
<text x="2" y="54" fill="#ffffff" font-size="10.5" font-weight="700" letter-spacing="2" font-family="PingFang SC, Microsoft YaHei, Arial, sans-serif">用指令开启万象世界</text>
|
||||
</svg>
|
||||
@ -2233,7 +2233,7 @@
|
||||
<span class="chip">独立素材中心</span>
|
||||
<span class="chip">独立模板中心</span>
|
||||
</div>
|
||||
<h1 style="margin:16px 0 12px;">造梦 AI:从素材货架到游戏工作台的完整生产平台</h1>
|
||||
<h1 style="margin:16px 0 12px;">绘境 AI:从素材货架到游戏工作台的完整生产平台</h1>
|
||||
<p style="max-width:720px;">新版结构将“看游戏”“选素材”“选玩法”“做游戏”“看数据”拆成清晰页面。创作者可以先在素材中心采购/选用素材,也可以在工作坊直接用 AI 生成图元、角色、特效、场景、界面和音乐。</p>
|
||||
<div class="chips" style="margin-top:22px;">
|
||||
<button class="btn" data-view-jump="workshop">创建游戏</button>
|
||||
@ -2500,14 +2500,14 @@
|
||||
<p>AP1 框架游戏 / 自定义创作</p>
|
||||
</div>
|
||||
<div class="agent-tabs">
|
||||
<button class="active">造梦引擎</button>
|
||||
<button class="active">绘境引擎</button>
|
||||
<button>所有素材</button>
|
||||
<button>代码目录</button>
|
||||
</div>
|
||||
</div>
|
||||
<div class="agent-stream" id="agentStream">
|
||||
<div class="agent-message">
|
||||
<strong>造梦智能体</strong>
|
||||
<strong>绘境智能体</strong>
|
||||
<p>把左侧生成好的角色拖到下方输入框,或直接描述游戏需求。我会识别附件角色的画风、骨骼方向和适配玩法,再生成游戏。</p>
|
||||
</div>
|
||||
<div class="agent-message user">
|
||||
@ -2840,7 +2840,7 @@
|
||||
<div class="panel pad">
|
||||
<h2>账号信息</h2>
|
||||
<div class="grid" style="margin-top:12px;">
|
||||
<div class="stat-card"><span class="mini">当前账号</span><b>造梦创作者 1811</b><span class="ok">专业版试用中</span></div>
|
||||
<div class="stat-card"><span class="mini">当前账号</span><b>绘境创作者 1811</b><span class="ok">专业版试用中</span></div>
|
||||
<div class="stat-card"><span class="mini">消息通知</span><b>12</b><span class="warn">3 条待处理</span></div>
|
||||
</div>
|
||||
</div>
|
||||
@ -3137,7 +3137,7 @@
|
||||
creator: "创作者中心",
|
||||
b2b: "B端定制中心",
|
||||
profile: "个人中心"
|
||||
}[view] || "造梦 AI";
|
||||
}[view] || "绘境 AI";
|
||||
$$(".top-tabs button").forEach(btn => btn.classList.toggle("active", btn.dataset.topJump === view));
|
||||
window.scrollTo({ top: 0, behavior: "smooth" });
|
||||
}
|
||||
@ -8,7 +8,7 @@
|
||||
|
||||
- ICP 增值电信业务许可证:自研私域 H5、一键分发中台必备资质,满足全网信息服务合规,抖音 / 微信 / 快手渠道入驻硬性要求;
|
||||
|
||||
- 平台软件著作权:造梦 AI 创作平台、一键分发系统、IP 锁风风控系统 3 项软著,全渠道小游戏提审必备材料;
|
||||
- 平台软件著作权:绘境 AI 创作平台、一键分发系统、IP 锁风风控系统 3 项软著,全渠道小游戏提审必备材料;
|
||||
|
||||
- 工信部小程序 / 网站备案:自研私域域名、H5 页面全备案,无备案无法上线自有游戏流;
|
||||
|
||||
@ -38,7 +38,7 @@
|
||||
|
||||
### 2\.AI 内容强制标识落地(全 UGC 小游戏合规标配)
|
||||
|
||||
- 显性标识:所有 AI 生成小游戏启动页标注「本内容由造梦 AI 生成」;
|
||||
- 显性标识:所有 AI 生成小游戏启动页标注「本内容由绘境 AI 生成」;
|
||||
|
||||
- 隐性元数据:文件底层嵌入隐式水印 \+ 平台编码、生成编号,不可篡改删除,满足网信标识监管要求中国政府网;
|
||||
|
||||
|
||||
@ -1,3 +1,5 @@
|
||||
> ⚠️ **【禁投 · 2026-06-10 审计 HJ-AUDIT-001 R1】本版含可被尽调证伪的主张,禁止投递/外发。投递版以《奇绩申报-终稿候选-审改版.md》为准。**
|
||||
|
||||
# 奇绩创坛申报项目填报完整资料
|
||||
|
||||
## 项目信息
|
||||
|
||||
@ -18,7 +18,7 @@
|
||||
|
||||
【替换文案】
|
||||
|
||||
我们的技术判断是:**生成模型本身不构成壁垒(会被大模型快速追平),壁垒在"把通用模型不可控的输出,工程化成可上线、合规、可变现的资产"这条链路上的控制点。** 所以我们不自研大模型,而是在通用 LLM(经 Dify 编排,通义千问 / DeepSeek 等可热切换)之上,自研四个控制点:
|
||||
我们的技术判断是:**生成模型本身不构成壁垒(会被大模型快速追平),壁垒在"把通用模型不可控的输出,工程化成可上线、合规、可变现的资产"这条链路上的控制点。** 所以我们不自研大模型,而是在通用 LLM(经自建模型网关接入,MiniMax / DeepSeek / 通义等可切换;**2026-06-10 更新:勿写"经 Dify 编排"——Dify 未部署,现行为网关直连+模板驱动,DD 要求演示即穿帮**)之上,自研四个控制点:
|
||||
|
||||
1. **轻量游戏运行时**:自研 <15KB 量级 Canvas Runtime,构建期设硬性体积门禁,支撑"免下载、滑动即玩、首屏秒开";复杂玩法分层走 Cocos,按需降级。这是游戏流体验的地基,也是我们当前已有可演示产物的真实代码资产。
|
||||
|
||||
@ -63,6 +63,30 @@
|
||||
|
||||
---
|
||||
|
||||
## 四B、填报 ▸「未来两个月的技术进展」(2026-06-10 基线,至 8 月中旬)
|
||||
|
||||
> **2026-06-11 更新**:本段主体已并入《奇绩申报-终稿候选-审改版.md》进展题的"现状简述+两个月可达成"双段式结构(创始人指示:评审两个月后才审阅,按届时可核验口径写)。以终稿候选为准,本节留作底稿。
|
||||
|
||||
【替换文案 · 主推版】
|
||||
|
||||
未来两个月,在"创作→生成→发布→试玩→数据回路"全链路已真实跑通的基础上(当前实测:真实用户一句话生成 18-27 秒产出可玩游戏;首批 20 个创意全自动批产、机器验收通过率 80%),技术进展集中在三件事:
|
||||
|
||||
① **生成供给侧规模化**:玩法模板从 1 类扩至 4 类(碎片化休闲方向),每类配固定运行时 + 提示词版本化回归集 + 对抗评审守卫;内容池从 18 款扩至 200+ 款全自动产出入库;生成验收通过率在跨批次、多模板口径下稳定 ≥80%(当前为首批实测值),并完成单款游戏的全口径生成成本实测(模型调用+内容审核+存储)。
|
||||
|
||||
② **真实用户与数据回路**:完成 ICP 备案后开放邀请制内测(目标 50+ 种子创作者、数百名玩家),上线短信登录与匿名试玩转化链路;用真实玩家行为校准"质量分→推荐重排"闭环,产出首批可信的完玩率、次日留存、玩家→创作者转化数据。
|
||||
|
||||
③ **变现与渠道技术就绪**(受外部审核节奏约束,如实标注):广告 SDK 宿主侧接入与分账结算链路在测试模式下端到端跑通,真实放量取决于广告联盟资质审核(同步申请中);1 款游戏完成微信小游戏格式导出与真机运行验证;首个签约 IP 完成画风一致性门禁最小版(风格 LoRA + 嵌入相似度阈值门 + 人工兜底),支撑 IP 营销小游戏交付样板。
|
||||
|
||||
以上工程量由"小团队 + AI agent 工程体系"支撑(全链路契约化 + 自动化验收闸门,本月已实证从契约锁定到生成链路收口仅用数日);每项都有可核验完成线——批次报告、备案回执、内测数据看板、真机录屏。
|
||||
|
||||
【浓缩版(字数受限时用)】
|
||||
|
||||
玩法模板 1→4 类、内容池 18→200+ 款全自动产出(首批机器验收 80% 实测,目标跨批稳定);完成 ICP 备案并开放邀请制内测,获取首批真实完玩率/次留/玩家→创作者转化数据;广告接入与分账链路测试模式跑通(放量待联盟审核)、1 款游戏微信小游戏导出真机验证、首个 IP 画风一致性门禁最小版上线。
|
||||
|
||||
【红线自检(本段已过 §五 红线表)】不含"锁风引擎/四层/垂类模型/全域一键/双轨算法";80% 标注"首批实测"、稳定性标注"目标";广告/ICP 显式标注外部闸门;防沉迷等公开运营义务以"邀请制内测"边界规避(公开前补齐,勿在表中承诺公网上线日期)。
|
||||
|
||||
---
|
||||
|
||||
## 五、措辞红线表(全表通用,防止重新注水)
|
||||
|
||||
逐条来自团队自己的复盘结论,用于排查申报表**所有段落**(尤其"项目描述""特别之处""近三个月进展"里散落的同类表述)。
|
||||
@ -83,9 +107,10 @@
|
||||
|
||||
对外统一这样讲,既不注水也不示弱——**"我们刻意先搭契约与控制点、再接生成"**:
|
||||
|
||||
- **已是真实代码**:5 个后端骨架模块(编译 + 46 单测通过)、8 类契约、前端双闭环本地 mock 跑通、<15KB 运行时跑通 1 个 demo 玩法;
|
||||
- **当前冲刺(里程碑 M2)**:把真实 LLM 生成链路接通(目前是 mock);
|
||||
- **所有性能/质量数字**(生成成功率 ≥80%、首屏 P75<3s、可用性 ≥99.5%)**都是设计目标 / 验收标准,不是实测**——引用时必须标注"目标值",否则又是一处会被追问穿帮的点。
|
||||
> **⚠️ 2026-06-10 口径刷新(现状比下文老口径好,照旧写反而自贬)**:
|
||||
> - **已实证(可演示/有档可查)**:创作→生成→发布→审核→游戏流→真人试玩→遥测→质量分→feed 重排 **全链路真实 e2e**(staging);**真实用户一句话生成 18-27 秒产出可玩游戏**(部署实证 5 样本);**首批 20 创意全自动批产验收通过率 80.0%(实测,批次报告在库)**——验收口径=结构合法∧浏览器真玩通关∧对抗评审无 P0/P1∧批内查重;feed 内容池 18 款(全走真实发布链);Prompt 版本化注册表+Golden 回归已制度化(并已实证逮住一次模型回归)。
|
||||
> - **仍是目标值(必须标注)**:跨批次稳定 ≥80%(第二批遇网关模型回归 45%,质检体系自动逮住,补产在途——被问到如实讲,这是质检体系起作用的正面案例)、首屏 P75<3s、可用性 ≥99.5%。
|
||||
> - **仍是桩/未做**:真实广告联盟与支付(资质闸门未过)、公网上线(ICP 备案未启动)、防沉迷/实名(内测期邀请制规避,公开前必补)。
|
||||
|
||||
---
|
||||
|
||||
|
||||
151
docs-design/奇绩申报-终稿候选-审改版.md
Normal file
151
docs-design/奇绩申报-终稿候选-审改版.md
Normal file
@ -0,0 +1,151 @@
|
||||
# 奇绩申报 · 终稿候选(审改版)
|
||||
|
||||
> 基于创始人 2026-06-10 最新稿审改。改动原则:① 进度口径升级到 06-10 工程实证(旧稿自贬);② 清掉最后的红线残留与词语硬伤;③ 全部主张可被尽调复核。
|
||||
> 【★拍板】= 只有你能定的事实,投递前必须替换。
|
||||
> 改动处以「◆改」标注理由(誊抄时删除标注行)。
|
||||
|
||||
---
|
||||
|
||||
## 项目信息
|
||||
|
||||
**一、项目名称:**
|
||||
|
||||
绘境 AI(全称:绘境 AI・IP 小游戏创作与变现平台)
|
||||
|
||||
> ◆已拍板【★拍板1·品牌名=绘境 AI】(创始人定,2026-06-10 复确认)。注意:拼写为"绘**境**"(非"绘镜"),全表统一。✅ **对外材料品牌统一清扫已于 2026-06-10 执行**:BP 改造版/路演稿/生态引擎 BP/全景材料正文与文件名、合规落地方案、demo 文件(huijing-ai-demo.html)均已造梦→绘境;路演稿/生态引擎 BP/全景材料已加「归档·禁外发」横幅,旧申报资料已加「禁投」横幅。代码内部命名 wanxiang 不外显、未改。
|
||||
|
||||
**二、一句话概括(≤15 字)**
|
||||
|
||||
IP 小游戏创作与全域变现平台
|
||||
|
||||
**三、项目介绍(≤500 字)**
|
||||
|
||||
1.绘境 AI 平台支持零基础用户用文字/图片等指令快速制作可上线、可变现的 IP 小游戏。我们基于通用大模型,结合预制模板与签约 IP 专属画风生成完整游戏;自研短视频式游戏流,玩家滑动即点即玩;支持一次创作、多渠道适配(抖音、微信、TapTap 等,平台统一对接审核上架)。目前"创作→生成→发布→试玩→数据回流推荐"全链路已真实跑通,真实用户一句话生成 18-27 秒产出可玩游戏。广告收益按规则透明结算,创作者与 IP 方 T+1 提现。
|
||||
|
||||
2.项目主要服务两大核心群体:一是想依托小游戏做副业的普通创作者,解决其缺技术、正版素材与分发渠道的难题;二是 IP 版权方,帮助其实现粉丝游戏化变现,同时通过技术手段规避 AI 篡改角色人设的风险。此外,我们面向文旅、品牌、短剧等客户提供定制服务,该业务具备较高毛利。
|
||||
|
||||
3.我们不投入自研通用大模型,而是聚焦工程化能力搭建。依托 IP 画风一致性校验体系、15KB 轻量化游戏运行时、契约化生成分发中台,将 AI 不确定的生成内容,转化为合规可落地、可持续变现的商业资产,构筑核心竞争力。
|
||||
|
||||
> ◆改:①"一键分发"→"一次创作、多渠道适配,平台统一对接审核上架"(红线表第 4 条:快手等需格式转换+真机验证,"一键"会被追问穿帮);②补一句已实证锚(全链路真实跑通+18-27 秒),这是全表最硬的差异化证据;③删"视频指令"(当前未支持视频输入,勿留可证伪点)。
|
||||
|
||||
**四、办公及总部地址**
|
||||
|
||||
现阶段办公地:浙江省杭州市;长期公司总部:杭州市。
|
||||
|
||||
**五、核心创始人目前所处的职业阶段是?**
|
||||
|
||||
全职创业
|
||||
|
||||
**六、你们有多少名员工?其中全职有多少?兼职有多少?**
|
||||
|
||||
项目运营主体为杭州言启万象人工智能科技有限公司,现有全职 5 人、兼职 2 人。核心三位创始人均有大型 AI 项目落地经验,分工明确、配合默契。
|
||||
丁漠涵(创始人):深耕政企解决方案与商务拓展,曾优化保险核保流程,落地政务应急系统,负责 IP 签约、投融资与生态布局。
|
||||
吴玉民(联合创始人):拥有 10 年互联网产品、全域运营经验,主导过运营商大模型 C 端落地,统筹产品、创作者生态与商业化。
|
||||
张航(联合创始人):专注 AI 大模型、游戏引擎研发,完成多款企业级 AI 平台搭建,负责核心技术研发与成本管控。
|
||||
团队兼具 AI 技术、产品运营、政企服务能力,已完成产品全链路真实闭环搭建,正对接头部 IP 资源与分发渠道。
|
||||
|
||||
> ◆改:末句"已完成产品原型搭建,对接头部 IP 与全域流量渠道"→升级+收敛:"原型"自贬(已是真实闭环),"全域流量渠道"残留旧夸大语感("对接渠道"即可)。注意:本题已删旧稿"现任华通互惠"表述,与"全职创业/集体离职"自洽——前提是与事实一致(社保/劳动关系尽调可核),请最终确认。
|
||||
|
||||
**七、核心团队如何认识的?**
|
||||
|
||||
三位核心创始人此前在同一家企业共事,联合落地过运营商 AI 大模型、智能合规系统、政企数字化解决方案等多个商业化项目。大家分别擅长 AI 底层研发、产品全域运营、大客户商务拓展,能力互补。基于对 IP 数字化、全民 AIGC 创作赛道的市场机遇达成共识,并已锁定一个头部 IP 的合作意向,团队集体离职组建创业团队,正式启动本项目。
|
||||
|
||||
**八、你们在这个项目上已投入了多长时间?**
|
||||
|
||||
2个月
|
||||
|
||||
---
|
||||
|
||||
## 项目进展
|
||||
|
||||
**一、请具体描述一下你们项目近三个月的进展(技术、产品、用户获取等)**
|
||||
|
||||
**【当前现状 · 截至 2026 年 6 月中旬(投入 2 个月,以下均可演示、有档可查)】**
|
||||
|
||||
技术与产品:「创作→AI 生成→发布审核→游戏流→玩家试玩→数据回流→推荐重排」**全链路已真实跑通**——真实用户一句话生成 **18-27 秒**产出可玩小游戏;首批 20 个创意全自动批量生产,机器验收通过率 **80%**(实测;验收=结构合法∧浏览器真玩通关∧自动对抗评审∧批内查重);游戏流内容池 18 款;自研 15KB 运行时支撑真实试玩;9/13 后端模块建成、8 类接口契约定稿,提示词全部版本化并配自动回归(已实证拦截一次上游模型质量回退)。广告、支付为契约+骨架设计,真实接入待资质。业务侧:已与头部现象级 IP 签订合作框架协议,对接十余家国漫、文旅腰部正版 IP,接洽文旅、短剧、快消定制需求;种子创作者招募中。首屏速度、可用性等性能指标为设计目标尚未实测。
|
||||
|
||||
**【未来两个月可达成 · 至 8 月中旬(各项均设可核验完成线,贵方审阅本表时可直接对照检验)】**
|
||||
|
||||
1. **生成供给规模化**:玩法模板从 1 类扩至 4 类(碎片化休闲方向),内容池 18→200+ 款全自动产出入库,验收通过率在跨批次、多模板口径下稳定 ≥80%,并完成单款游戏全口径生成成本实测(模型+审核+存储)。
|
||||
2. **真实用户与数据回路**:完成 ICP 备案后开放邀请制内测(50+ 种子创作者、数百名玩家),上线短信登录与匿名试玩转化链路,产出首批真实完玩率、次日留存、玩家→创作者转化数据,用真实行为校准"质量分→推荐重排"闭环。
|
||||
3. **变现与渠道就绪**(受外部审核节奏约束,如实标注):广告 SDK 接入与分账结算链路测试模式端到端跑通(真实放量取决于广告联盟资质审核,同步申请中);1 款游戏完成微信小游戏格式导出与真机验证;首个签约 IP 画风一致性门禁最小版(画风 LoRA + 相似度阈值门 + 人工兜底)上线,交付首个 IP 营销小游戏样板。
|
||||
4. **资质推进**:ICP 备案完成、三类软著提交、生成式 AI 服务备案/算法备案材料就绪。
|
||||
|
||||
完成线证据形式:批次验收报告、备案回执、内测数据看板、真机录屏。
|
||||
|
||||
> ◆改(本题最大改动,按创始人 06-11 指示重构):评审约两个月后才审阅本表,故改为"现状简述 + 两个月可达成"双段式——现状只留最硬实证(18-27 秒/首批 80%/18 款/全链路 e2e),两个月段写成带完成线的承诺并**主动邀请评审届时对照核验**(把审阅时间差转化为可信度)。原稿问题同步修复:①"正在对接生成链路/暂未实测"已过时自贬;②删"完成广告结算中台"(仍是骨架);③"文网文"→"生成式 AI 备案/算法备案"(游戏类文网文已取消);④"多余家"→"十余家"。**注意:两个月段即为承诺,写入前确认 A1 闸门(ICP/广告/软著/AI 备案)本周真启动,否则第 2、4 条会在面试时落空。**
|
||||
|
||||
**二、你们正在研发或使用什么样的技术?**
|
||||
|
||||
我们认为通用大模型难以形成长期壁垒,核心竞争力在于将模型输出工程化,打造可上线、合规、可变现的完整链路。项目基于通用 LLM 搭建能力底座(经自建模型网关接入,MiniMax、DeepSeek、通义千问等可灵活切换),采用**模板驱动生成**——大模型产出结构化游戏配置,由固定模板运行时渲染成完整游戏,规避直接生成代码的不可控性。在此之上自研四大核心工程模块:
|
||||
|
||||
一是**轻量化游戏运行时**:自研 15KB Canvas 运行环境,严格控制包体大小,实现小游戏免下载、滑动即玩、首屏秒开,复杂玩法搭配 Cocos 引擎分层处理;已支撑 18 款游戏的真实游戏流与浏览器实测试玩。
|
||||
二是**IP 画风管控体系**(建设中):基于 Flux/SDXL 为签约 IP 训练专属画风 LoRA,搭配风格相似度校验、分级审核与人工复核,从源头避免角色人设、画风被篡改,打消 IP 方合作顾虑。
|
||||
三是**多层内容风控体系**:融合自部署内容安全、云厂商风控与生成规则校验,辅以人工复核,全方位把控内容合规性。
|
||||
四是**契约化生成分发中台**:统一规范生成、审核、分发、数据监测等全链路接口;提示词全部进 Git 注册表做版本化管理并配自动回归闸门(已实证拦截一次上游模型质量回退),实现多模型、多渠道灵活切换与灰度迭代。
|
||||
|
||||
整套方案重点解决通用 AI 篡改 IP 人设、小游戏多渠道上架运维成本高两大行业难题,也是我们对接正版 IP、降低定制服务成本的核心支撑。
|
||||
|
||||
> ◆改:①删"借助 DSL编排Agentic"(语病+架构表述不实:现行为自建网关直连+模板驱动,无编排引擎;技术面被要求演示即穿帮);②模型列表与现实一致(MiniMax 在用、DeepSeek/通义为已配置通道);③运行时"已有可演示 Demo"→"18 款真实游戏流+浏览器实测"(升级到实证);④IP LoRA 标注"建设中"(尚未训练,诚实);⑤提示词治理补"已实证拦截模型回归"——这是技术面最加分的真故事。
|
||||
|
||||
---
|
||||
|
||||
## 想法
|
||||
|
||||
**一、你的用户是谁?典型用户场景是什么?你为用户解决什么问题?**
|
||||
|
||||
1. **UGC 创作者**:包含游戏爱好者、副业人群、自由职业者等群体,普遍受技术、正版素材、分发渠道、广告开户四大门槛制约。平台提供专属 IP 模板,支持 AI 一键生成作品,依托 IP 原生粉丝流量解决冷启动难题,零代码创作、作品多渠道分发、收益自动结算,助力大众低成本创作、稳定增收。
|
||||
2. **IP 版权方**:坐拥海量粉丝,希望通过游戏衍生开辟第二增长曲线,但自研小游戏成本高、周期久,通用 AI 易篡改角色人设。依托自研工程化体系,我们零成本批量制作合规衍生游戏,平台全权负责风控,让 IP 方持续获取广告、商业合作收益,有效拓宽 IP 变现渠道。
|
||||
3. **政企及品牌客户**:目前市场主流营销以硬广、软文、短视频贴片为主,单向传播体验差、营销效果薄弱;传统内容外包定价高、交付周期长。我们打造 AI+IP 互动游戏新范式,以趣味小游戏实现沉浸式品牌种草,一站式技术方案优化交付成本,平台流量加持放大营销价值。
|
||||
4. **休闲玩家**:作为平台流量底盘,短视频式游戏流实现免下载、即刷即玩,适配碎片化娱乐需求。玩家产生的收益反哺生态,同时助力品牌方与 IP 内容传播,形成良性循环。
|
||||
|
||||
> ◆改:①"OPC创业者"(无此词)→"副业人群、自由职业者";②"全域分发"→"多渠道分发"(与红线口径统一);③"抖音式"→"短视频式"(对外材料避免直接借用竞对品牌做自我定义,也规避"抖音式"被平台方反感的小风险,下同保留一处场景描述无妨)。
|
||||
|
||||
**二、这个项目的想法是从哪来的?为什么选择现在这个时间点来做?**
|
||||
|
||||
(保留原文,无修改)项目源于行业四大痛点:IP 方游戏化变现难、政企品牌定制游戏成本高、普通创业者做小游戏门槛高、短视频用户转向互动娱乐,市场缺少一体化解决方案。
|
||||
当前是合适的入局节点:一方面 AIGC 算力、模型成本持续下降,AI 批量制作小游戏具备成本优势;另一方面短视频流量见顶,用户从纯观看转向互动,而传统人工做游戏的产能跟不上这个增量。
|
||||
|
||||
**三、你的项目有什么特别的地方?**
|
||||
|
||||
1. 项目核心特色聚焦落地工程化能力,而非单纯比拼生成效果。针对 IP 合作痛点,我们打造画风一致性管控方案,用模型训练 + 多层校验守住内容标准,打消 IP 方授权顾虑。
|
||||
2. 依托自研 15KB 轻量化运行时,打造短视频式游戏流体验,降低用户游玩门槛;同时配套流量扶持规则,解决创作者冷启动问题,依托 IP 自然粉丝实现流量自增长,激活平台内容生态。**目前"一句话→可玩游戏→上架游戏流→玩家试玩→数据回流推荐"全链路已真实运行,单款生成 18-27 秒、全自动批产验收通过率 80%(首批实测)。**
|
||||
3. 此外,我们搭建契约化全链路中台,统一规范各业务环节,实现大模型、分发渠道可灵活替换、灰度更新,让多渠道分发模式低成本落地。
|
||||
三大能力环环相扣,既筑牢 IP 合作根基、优化用户与创作者体验,也持续降低运营成本,构建可持续的商业壁垒。
|
||||
|
||||
> ◆改:第 2 条补实证句——"特别之处"这题奇绩最看"你做出来了什么别人没做出来的",全链路真实闭环正是 TapTap 制造等工具型竞品给不出的差异化证据(它们没有"分发+数据回路")。"全域"→"多渠道"。
|
||||
|
||||
**四、现在用户在使用什么替代方案或者竞品?**
|
||||
|
||||
目前市场存在几类替代方案:独立 AI 游戏创作工具如极逸 SOON、FunloomAI、海外 Astrocade 等,多聚焦生成环节,缺失 IP 风控、分发与政企定制服务;平台方创作工具如 TapTap 制造、腾讯轻游梦工坊及抖音、微信内置工具,背靠自有渠道但生态封闭、仅限站内分发,创作者变现渠道单一;政企、品牌及 IP 方常用的传统游戏外包,成本高、交付周期久、产能有限;通用 AIGC 平台难以管控 IP 画风与人设,版权和内容风险高;GDevelop AI 等开源引擎缺少流量、运营与合规配套,个人创作者难以落地。
|
||||
现有方案大多只覆盖内容生成单一环节,普遍欠缺 IP 风控、多渠道分发、商业化变现与合规配套。我们打通的是从内容创作、流量触达到商业变现的全流程。
|
||||
|
||||
> ◆改:TapTap 制造归类修正——它不是"单一开发工具"(自带 TapTap 渠道,2026-01 已上线),原写法会被熟悉行业的面试官当场纠正;归入"平台方工具:有渠道但封闭"既准确又保住我们"跨渠道+变现闭环"的差异化位。
|
||||
|
||||
**五、在你的行业里,有什么大多数人都不同意的但你认为是对的观点?**
|
||||
|
||||
(保留原文两段,无修改——观点一"卡点是信任不是画质"、观点二"创作者是供给不是盈利主体,营收靠 B 端定制与 IP 资产",与内部战略裁定一致,且是全表写得最好的部分。)
|
||||
|
||||
**六、知识产权/专利**
|
||||
|
||||
(保留原文,无修改——"暂无已下证、规划三类软著、壁垒在综合优势非单一专利"的口径诚实且与复盘一致。)
|
||||
|
||||
---
|
||||
|
||||
## 其他
|
||||
|
||||
**一、如果你还有其他的创新想法,也请一并告诉我们。**
|
||||
|
||||
(保留原文,无修改——UGC 爆款→签约→IP 资产运营的长线思路,与"远期复利-IP 资产"内部规划一致。)
|
||||
|
||||
---
|
||||
|
||||
## 投递前最终自检清单
|
||||
|
||||
- [x] 【★拍板1】品牌名 = **绘境 AI**(拼写"绘境"非"绘镜")。✅ 2026-06-10 清扫完成:BP 改造版/全景/路演稿/生态引擎 BP/合规落地方案/demo 文件名全套已统一为绘境(详见上方 ◆已拍板注)。
|
||||
- [x] 【★拍板2】IP 合作进度 = **已签合作框架协议**(创始人 2026-06-10 确认线下事实)。⚠️ 仓内仅见谈判承诺书草案,未见已签文本——**面试前务必把可出示的协议文件备在手边**,被追问即出示;若文件尚未实际签署,此口径必须改回"口头合作意向"。
|
||||
- [x] 【★拍板3】种子创作者 = **招募中**(如实口径,与作战清单 A2 未勾一致,2026-06-10 定)。
|
||||
- [ ] 红线词全表扫一遍:锁风引擎❌ 四层❌ 垂类模型❌ 全域一键❌ 双轨算法❌(本稿已清)。
|
||||
- [ ] 数字标注:80%=首批实测;首屏/可用性=目标值;18-27 秒=部署实测。
|
||||
- [ ] 与面试问答对齐:若被问"最近一批通过率",如实讲第二批因上游模型回归降到 45%、被自动回归闸门拦截、已定位修复补产中——这是质检体系起作用的正面案例,主动讲反而加分。
|
||||
- [ ] 合规事项与 A1 闸门看板动作对齐(材料里写了"筹备启动",请确保本周真的启动,面试时会被问进度)。
|
||||
@ -747,7 +747,7 @@
|
||||
<div class="play-btn">▶</div>
|
||||
<div class="game-hook">
|
||||
<div class="game-name">布鲁伊亲子小镇经营</div>
|
||||
<div class="game-desc">温馨亲子风|打造梦幻小镇</div>
|
||||
<div class="game-desc">温馨亲子风|打绘境幻小镇</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
@ -1,10 +1,12 @@
|
||||
# 造梦 AI・全民游戏创作与变现生态引擎 投资人BP
|
||||
> 📁 **【归档 · 禁外发 · 2026-06-10 审计 HJ-AUDIT-001 R1】对外口径以清洗后的 BP 改造版为唯一主干;本档融资/估值/竞品数字未经清洗,禁止外发。**
|
||||
|
||||
# 绘境 AI・全民游戏创作与变现生态引擎 投资人BP
|
||||
|
||||
|
||||
|
||||
# 第1页:封面
|
||||
|
||||
**项目名称:**造梦 AI・全民游戏创作与变现生态引擎
|
||||
**项目名称:**绘境 AI・全民游戏创作与变现生态引擎
|
||||
|
||||
**Slogan:**人人一键做游戏,创作即流量,流量即收益
|
||||
|
||||
@ -1,12 +1,14 @@
|
||||
# 造梦 AI|3 分钟路演稿(投资人版)
|
||||
> 📁 **【归档 · 禁外发 · 2026-06-10 审计 HJ-AUDIT-001 R1】对外口径以清洗后的 BP 改造版为唯一主干;本档融资/估值/竞品数字未经清洗,禁止外发。**
|
||||
|
||||
# 绘境 AI|3 分钟路演稿(投资人版)
|
||||
|
||||
#
|
||||
|
||||
各位投资人、老师好:
|
||||
|
||||
我是造梦 AI 创始人,今天用 3 分钟,向大家介绍国内首个 IP 专属\+全链路 AI 游戏创作与变现生态平台 —— 造梦 AI。
|
||||
我是绘境 AI 创始人,今天用 3 分钟,向大家介绍国内首个 IP 专属\+全链路 AI 游戏创作与变现生态平台 —— 绘境 AI。
|
||||
|
||||
我们正站在AIGC \+ 互动内容替代短视频两大确定性拐点,造梦 AI 要做的,不是一款工具,而是AI 时代数字娱乐基础设施。
|
||||
我们正站在AIGC \+ 互动内容替代短视频两大确定性拐点,绘境 AI 要做的,不是一款工具,而是AI 时代数字娱乐基础设施。
|
||||
|
||||
|
||||
|
||||
@ -48,11 +50,11 @@
|
||||
|
||||
|
||||
|
||||
同样踩中技术拐点、同样做基础设施、同样数据变现,**造梦 AI **是国内唯一全链路游戏创作生态平台。
|
||||
同样踩中技术拐点、同样做基础设施、同样数据变现,**绘境 AI **是国内唯一全链路游戏创作生态平台。
|
||||
|
||||
我们需要3000 万种子轮,出让 15%,用于技术研发、流量冷启动、创作者运营、IP 孵化与合规建设。
|
||||
|
||||
造梦 AI,踩中时代拐点、打造唯一壁垒、构建闭环生态、成就长期价值。
|
||||
绘境 AI,踩中时代拐点、打造唯一壁垒、构建闭环生态、成就长期价值。
|
||||
|
||||
谢谢各位!
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
# 造梦 AI|商业计划书(BP 终稿・投资人版)改造版
|
||||
# 绘境 AI|商业计划书(BP 终稿・投资人版)改造版
|
||||
|
||||
项目主体:杭州言启万象人工智能科技有限公司
|
||||
|
||||
@ -8,15 +8,15 @@
|
||||
|
||||
## 1、项目摘要(Executive Summary)
|
||||
|
||||
造梦 AI(项目全称:**造梦 AI・数字化全链路 AIGC 互动内容产业生态平台**)是国内稀缺的IP 垂类 AIGC \+ 全民 UGC 小游戏全链路商业化平台,深度锚定国家十四五文化数字化、十五五 AI 文创产业扶持政策导向。平台依托公司自研锁风 AIGC 垂类游戏生成引擎\+ 自研抖音沉浸式游戏流产品形态,打通【IP 授权 \- AI 一键生成小游戏 \- 全渠道智能分发 \- 多链路商业化变现 \- UGC 内容资产反哺 IP】完整产业闭环,落地 “火爆现象级IP、全民创作者、政企 B 端、平台四方共赢” 商业模式,践行 “人人都是游戏策划” 发展理念;构建共生共赢的数字娱乐生态。
|
||||
绘境 AI(项目全称:**绘境 AI・数字化全链路 AIGC 互动内容产业生态平台**)是国内稀缺的IP 垂类 AIGC \+ 全民 UGC 小游戏全链路商业化平台,深度锚定国家十四五文化数字化、十五五 AI 文创产业扶持政策导向。平台依托自研 AI 游戏生成工程化体系(通用大模型 \+ 模板驱动生成 \+ IP 画风一致性管控)与短视频式沉浸游戏流产品形态,构建【IP 授权 \- AI 生成小游戏 \- 多渠道分发 \- 多链路商业化变现 \- UGC 内容资产反哺 IP】完整产业闭环(其中「创作→AI 生成→发布审核→游戏流→玩家试玩→数据回流→推荐重排」核心链路已真实跑通,真实用户一句话 18\-27 秒产出可玩游戏,部署实测),落地 “火爆现象级IP、全民创作者、政企 B 端、平台四方共赢” 商业模式,践行 “人人都是游戏策划” 发展理念;构建共生共赢的数字娱乐生态。
|
||||
|
||||
### 1\.1 核心价值
|
||||
|
||||
- IP 持有方:零研发、零风控投入,依托平台 AI 批量产出合规衍生小游戏,依靠广告、品牌联名稳定获取 15%\-25% 长效分成,低成本完成 IP 游戏化第二增长曲线落地,彻底解决通用 AIGC 篡改人设、角色 OOC 崩坏痛点。
|
||||
- IP 持有方:零研发、零风控投入,依托平台 AI 批量产出合规衍生小游戏,依靠广告、品牌联名稳定获取 15%\-25% 长效分成,低成本完成 IP 游戏化第二增长曲线落地,针对性管控通用 AIGC 篡改人设、角色 OOC 崩坏风险。
|
||||
|
||||
- C 端创作者:大学生、自媒体、网文作者、副业人群零代码、零 IP 资源门槛,一句话调用正版 IP 模板生成可上线小游戏,全渠道自动分发、收益 T\+1 提现,实现碎片化创作即时变现。
|
||||
- C 端创作者:大学生、自媒体、网文作者、副业人群零代码、零 IP 资源门槛,一句话调用正版 IP 模板生成可上线小游戏,多渠道统一分发、收益 T\+1 提现,实现碎片化创作即时变现。
|
||||
|
||||
- B 端政企 / 品牌:文旅、政务、快消、短剧厂商低成本定制互动营销小游戏,一站式搞定开发、上架、运维、流量投放,压缩 90% 定制成本与项目周期。
|
||||
- B 端政企 / 品牌:文旅、政务、快消、短剧厂商低成本定制互动营销小游戏,一站式搞定开发、上架、运维、流量投放,大幅压缩定制成本与项目周期。
|
||||
|
||||
- 产业端:重构休闲游戏生产逻辑,把传统重资产工业化游戏制作转型为全民 UGC 普惠创作模式,补齐国内正版 IP 低成本 UGC 衍生的市场空白。
|
||||
|
||||
@ -24,13 +24,13 @@
|
||||
|
||||
- 政策红利精准落地:紧扣国家数字文创顶层规划,适配 AI \+ 传统文化数字化扶持细则,首期以火爆现象级 IP 为核心落地粉丝生态运营,助力国漫、非遗、地方文旅 IP 数字化落地。
|
||||
|
||||
- 独家技术壁垒:自研 IP 专属锁风 AIGC 垂类生成引擎、四层画风锁风校验算法、新人保底 \+ 精准推荐双算法,从底层锁定 IP 画风人设,区别市面通用大模型,成为头部 IP 愿意免费开放素材的核心壁垒。
|
||||
- 工程化技术壁垒(已实证):基于通用大模型的模板驱动生成链路——「创作→AI 生成→发布审核→游戏流→玩家试玩→数据回流→推荐重排」全链路真实跑通,真实用户一句话 18\-27 秒产出可玩游戏(部署实测);首批 20 个创意全自动批量生产,机器验收通过率 80\.0%(验收=结构合法∧浏览器真玩通关∧自动对抗评审∧批内查重),经一次上游模型质量回退事件后综合通过率 95%(19/20)——质检体系实证拦截回退并全自动修复补产;配套 IP 画风一致性管控方案(画风 LoRA \+ 风格相似度校验 \+ 人工复核,建设中)与自研 15KB 轻量运行时,针对性管控 IP 画风人设被篡改的风险。
|
||||
|
||||
- 全链路闭环生态:行业少有集齐【AI 创作工具 \+ 自有游戏流流量池 \+ 全域分发 \+ 多维度变现 \+ IP 资产管理】全链条平台,C 端内容供给反哺 B 端商单,B 端营收反哺平台生态与创作者激励。
|
||||
- 全链路闭环生态:行业少有集齐【AI 创作工具 \+ 自有游戏流流量池 \+ 多渠道分发 \+ 多维度变现 \+ IP 资产管理】全链条平台,C 端内容供给反哺 B 端商单,B 端营收反哺平台生态与创作者激励。
|
||||
|
||||
- 多赛道市场共振:休闲广告小游戏、政企数字化营销、全民 AIGC 副业三大千亿赛道同步爆发,2026 年三大赛道合计市场规模突破近 6400 亿,行业商业化进入落地黄金拐点。
|
||||
|
||||
- 四层多元营收:打破同行单一会员付费盈利模式,布局 C 端广告分成 \+ 素材交易 \+ B 端定制服务 \+ IP 模型 / 素材授权四大收益板块,现金流稳健、盈利结构多元化。
|
||||
- 多元营收结构:打破同行单一会员付费盈利模式,布局 C 端广告分成 \+ 素材交易 \+ B 端定制服务 \+ IP 模型 / 素材授权四大收益板块,现金流稳健、盈利结构多元化。
|
||||
|
||||
## 2、政策背景与行业风口
|
||||
|
||||
@ -42,7 +42,7 @@
|
||||
|
||||
- “十五五”(2026\-2030)产业导向:持续加码 AI 文创、数字内容产业化扶持,鼓励正版 IP 多元化衍生、全民 UGC 内容规范化发展。
|
||||
|
||||
- 合规前置布局:平台按监管要求搭建 AI 初审 \+ 人工复核双重风控体系,同步筹备 ICP、文网文、软件著作权等全资质申报,全链路兜底版权与内容合规风险。
|
||||
- 合规前置布局:平台按监管要求设计 AI 初审 \+ 人工复核双层风控体系(审核门禁已接入发布链路,机审 / 人审全量能力分阶段建设),同步筹备 ICP 备案、生成式 AI 服务备案、算法备案、软件著作权等资质申报,全链路兜底版权与内容合规风险。
|
||||
|
||||
### 2\.2 行业趋势三大拐点
|
||||
|
||||
@ -70,7 +70,7 @@
|
||||
|
||||
现有产品多为单一 AI 创作工具,无自有流量池,新人作品冷启动零曝光;盈利模式单一依赖会员订阅,缺少全链路变现与 IP 长效资产沉淀能力。
|
||||
|
||||
> 造梦 AI 依托锁风 AI 技术 \+ 自有游戏流生态,一站式解决全产业链痛点。
|
||||
> 绘境 AI 依托 AI 生成工程化 \+ IP 画风一致性管控 \+ 自有游戏流生态,系统性解决全产业链痛点。
|
||||
>
|
||||
>
|
||||
|
||||
@ -92,7 +92,7 @@
|
||||
|
||||
### 2\.5 赛道未来发展趋势
|
||||
|
||||
- 大模型垂类化:通用大模型难以适配细分 IP 场景,游戏专属微调垂类小模型成为行业主流,内容可控性、生成成本优势显著。
|
||||
- 生成工程化:通用大模型能力快速增强但输出不可控,行业竞争焦点转向工程化控制层——模板驱动生成、IP 画风一致性管控(画风 LoRA 等轻量定制)、自动化质检与回归,内容可控性与生成成本优势来自工程体系而非自训大模型。
|
||||
|
||||
- 创作全民化:零代码 AI 工具普及,个人创作者逐步替代中小外包工作室,成为休闲小游戏主力产出方。
|
||||
|
||||
@ -120,7 +120,7 @@
|
||||
|
||||
聚焦古风、叙事、RPG 等小众文化圈层,主打文字剧情类 AI 游戏创作,依托小众社群传播。
|
||||
|
||||
核心短板:以非官方同人内容为主,无正规商用 IP 授权,天然存在版权风险;游戏玩法品类单一,难以支撑多元化创作与 B 端定制需求;仅局限于小众圈层,用户与市场体量存在明显天花板;变现模式仅依赖作品买断、基础内购,缺少广告分成、全域分发、政企合作等多元收益。
|
||||
核心短板:以非官方同人内容为主,无正规商用 IP 授权,天然存在版权风险;游戏玩法品类单一,难以支撑多元化创作与 B 端定制需求;仅局限于小众圈层,用户与市场体量存在明显天花板;变现模式仅依赖作品买断、基础内购,缺少广告分成、多渠道分发、政企合作等多元收益。
|
||||
|
||||
- **TapTap 制造**(心动旗下)
|
||||
|
||||
@ -152,11 +152,11 @@
|
||||
|
||||
综合全赛道竞品,当前市场普遍存在六大短板,也是我方核心切入机会:
|
||||
|
||||
- **技术短板:**以通用大模型为主,缺少IP 专属垂类引擎 \+ 画风人设锁风校验技术,无法解决 IP 魔改、OOC 问题,正版 IP 合作难以落地;
|
||||
- **技术短板:**以通用大模型直出为主,缺少 IP 画风人设一致性管控与生成质检工程体系,难以管控 IP 魔改、OOC 问题,正版 IP 合作难以落地;
|
||||
|
||||
- **流量短板:**多数为纯工具或单一渠道分发,无抖音式沉浸式游戏流形态,且普遍缺失新人保底曝光算法,新创作者冷启动难、流量被头部垄断;
|
||||
|
||||
- **生态短板:**产业链条割裂,仅覆盖 “创作” 单一环节,未打通【IP 授权 \- AI 创作 \- 全域分发 \- 多元变现 \- IP 孵化】全链路;
|
||||
- **生态短板:**产业链条割裂,仅覆盖 “创作” 单一环节,未打通【IP 授权 \- AI 创作 \- 多渠道分发 \- 多元变现 \- IP 孵化】全链路;
|
||||
|
||||
- **业务短板:**要么只做 C 端个人创作,要么只服务专业团队 / 出海业务,极少实现C 端流量 \+ B 端高毛利定制双向赋能;
|
||||
|
||||
@ -174,17 +174,17 @@
|
||||
|
||||
结合技术、产品、流量、生态、商业、服务六大维度,我方形成多层级、难以复制的综合壁垒:
|
||||
|
||||
- **独家技术壁垒:**IP 锁风 AIGC 引擎,打通正版 IP 合作壁垒
|
||||
- **核心技术壁垒:**AI 生成工程化 \+ IP 画风一致性管控,支撑正版 IP 合作
|
||||
|
||||
自研锁风 IP 专属垂类 AIGC 引擎 \+ 四层画风校验算法,针对签约 IP 定向微调模型,从底层锁定角色人设与画风,彻底杜绝角色魔改、OOC 等行业通病。这也是头部现象级 IP 愿意无偿开放素材授权的核心门槛,目前同行暂无同类落地技术方案。同时自研轻量化云游戏运行容器,实现小游戏零加载、高稳定运行,支撑游戏流核心体验。
|
||||
基于通用大模型自研工程化控制层:模板驱动生成——大模型产出结构化游戏配置,由固定模板运行时渲染成完整游戏,规避直接生成代码的不可控性(全链路已真实跑通,一句话 18\-27 秒产出可玩游戏,首批 20 创意全自动批产机器验收通过率 80\.0%,经上游模型回退事件后综合通过率 95%〔19/20〕);IP 画风一致性管控方案——为签约 IP 训练专属画风 LoRA \+ 风格相似度校验 \+ 人工复核(建设中),从流程上管控角色人设与画风被篡改的风险,降低 IP 方授权顾虑。同时自研 15KB 轻量化 Canvas 运行时,支撑小游戏免下载、滑动即玩(已支撑游戏流内容池 30 款真实试玩);提示词全部版本化管理并配自动回归闸门,已实证拦截一次上游模型质量回退并全自动修复。
|
||||
|
||||
- **产品 \& 流量壁垒:**首创沉浸式游戏流 \+ 公平流量算法
|
||||
- **产品 \& 流量壁垒:**短视频式沉浸游戏流 \+ 公平流量规则
|
||||
|
||||
跳出行业传统货架、列表分发模式,打造抖音式全屏滑动、免下载即时即玩的游戏流社区,贴合短视频用户使用习惯,大幅降低试玩与传播门槛,构建独立自有流量池。搭配新人保底曝光 \+ 兴趣精准推荐双算法,打破头部流量垄断,充分激活全民 UGC 创作活力,解决创作者冷启动行业痛点。
|
||||
跳出行业传统货架、列表分发模式,打造短视频式全屏滑动、免下载即时即玩的游戏流社区,贴合短视频用户使用习惯,大幅降低试玩与传播门槛,构建独立自有流量池(当前以邀请制内测形态运行,沉淀质量分与推荐数据)。搭配新人保底曝光 \+ 兴趣推荐的规则化推荐机制(数据积累后演进至个性化模型),打破头部流量垄断,充分激活全民 UGC 创作活力,解决创作者冷启动行业痛点。
|
||||
|
||||
- **全域分发壁垒:**一次创作、全渠道自动适配
|
||||
- **多渠道分发壁垒:**一次创作、多渠道适配
|
||||
|
||||
实现 “一次制作,同步上架抖音、快手、微信小程序、TapTap、主流应用商店” 等全平台,平台统一承接渠道审核、上架、运维工作。区别于大厂封闭生态、海外平台渠道单一的缺陷,最大化放大作品曝光与收益,降低创作者多渠道运营成本。
|
||||
实现 “一次制作,适配上架抖音、微信小程序、TapTap 等多渠道”(部分渠道需格式转换与真机验证),平台统一承接渠道审核、上架、运维工作。区别于大厂封闭生态、海外平台渠道单一的缺陷,最大化放大作品曝光与收益,降低创作者多渠道运营成本。
|
||||
|
||||
- **商业生态壁垒:**C\+B 双向闭环,多元营收结构
|
||||
|
||||
@ -192,11 +192,11 @@
|
||||
|
||||
- **IP 全链路运营壁垒:**从 UGC 内容到长效 IP 资产
|
||||
|
||||
依托游戏流数据自动筛选潜力爆款小游戏,提供独家签约、运营、IP 衍生、跨界授权、周边开发全链路服务,将普通 UGC 作品转化为长效数字资产,拉长商业价值链条,区别于竞品 “只做工具、只做分发” 的短链路模式。
|
||||
依托游戏流数据自动筛选潜力爆款小游戏,提供深度签约、运营、IP 衍生、跨界授权、周边开发全链路服务,将普通 UGC 作品转化为长效数字资产,拉长商业价值链条,区别于竞品 “只做工具、只做分发” 的短链路模式。
|
||||
|
||||
- **合规 \& 服务壁垒:**全流程兜底 \+ 全周期创作者运营
|
||||
|
||||
搭建AI 初审 \+ 人工复核 \+ 版权溯源三重风控体系,同步提供软著、ICP、文网文等资质代办、违规整改、版本代运维一站式服务,全权承担版权与内容合规风险。同时为不同层级创作者提供创作指导、玩法优化、变现辅导,并新增 AI 赛道市场洞察能力,降低创作试错成本,构建强信任壁垒。
|
||||
构建AI 初审 \+ 人工复核 \+ 版权溯源三重风控体系(审核门禁已接入发布链路,全量能力分阶段建设),同步提供软著登记、备案申报等资质代办、违规整改、版本代运维一站式服务,承担版权与内容合规管理责任。同时为不同层级创作者提供创作指导、玩法优化、变现辅导,并新增 AI 赛道市场洞察能力,降低创作试错成本,构建强信任壁垒。
|
||||
|
||||
- **本土化壁垒:**深度匹配国内政策与市场
|
||||
|
||||
@ -208,9 +208,9 @@
|
||||
|
||||
#### 3\.5\.1 防御策略(应对大厂入局、竞品抄袭、用户挖角)
|
||||
|
||||
1. 技术与知识产权保护:持续迭代锁风算法、游戏流容器、推荐算法,每季度完成版本优化;及时申请软件著作权、算法相关知识产权,用法律防护核心技术与产品形态。
|
||||
1. 技术与知识产权保护:持续迭代画风一致性校验、游戏运行时、推荐策略与生成质检体系,每季度完成版本优化;及时申请软件著作权、算法相关知识产权,用法律防护核心技术与产品形态。
|
||||
|
||||
2. 独家资源绑定:与头部现象级 IP 签订中长期独家合作协议,锁定 UGC 游戏衍生权限;与国内主流渠道争取优先审核、流量扶持、分成优惠,构筑渠道壁垒。
|
||||
2. 核心资源绑定:已与头部现象级 IP 签订合作框架协议(非独家),争取中长期续约与优先合作条款,深化 UGC 游戏衍生授权;与国内主流渠道争取优先审核、流量扶持、分成优惠,构筑渠道壁垒。
|
||||
|
||||
3. 深度绑定用户:搭建分层创作者社群、IP 粉丝社群,通过流量倾斜、专属补贴、IP 孵化、合规服务锁定核心创作者;依托游戏流社交关系、作品资产沉淀,提升用户迁移成本。
|
||||
|
||||
@ -230,7 +230,7 @@
|
||||
|
||||
当前 AI 游戏创作赛道各类参与者均存在明显短板:海外平台本土化不足、大厂产品生态封闭、小众平台体量受限、出海团队脱离国内市场、传统外包模式效率低下。
|
||||
|
||||
我方以自研 IP 锁风技术为核心壁垒、抖音式游戏流为流量底盘、全域分发为渠道优势、C\+B 双向生态为商业支撑、全流程合规服务为信任底座,精准填补市场空白。依托正版 IP 合作、全民 UGC 创作、政企游戏化定制三大赛道共振,构建行业独有的全链路生态,随着 IP 矩阵、创作者规模、B 端客户持续增长,将逐步成为国内 IP 垂类 AIGC 互动内容赛道的标杆平台。
|
||||
我方以 IP 画风一致性管控与 AI 生成工程化为核心壁垒、短视频式游戏流为流量底盘、多渠道分发为渠道优势、C\+B 双向生态为商业支撑、全流程合规服务为信任底座,精准填补市场空白。依托正版 IP 合作、全民 UGC 创作、政企游戏化定制三大赛道共振,构建行业少有的全链路生态,随着 IP 矩阵、创作者规模、B 端客户持续增长,将逐步成为国内 IP 垂类 AIGC 互动内容赛道的标杆平台。
|
||||
|
||||
## 4、产品定位与核心优势
|
||||
|
||||
@ -238,7 +238,7 @@
|
||||
|
||||
#### 4\.1\.1 整体顶层定位
|
||||
|
||||
造梦 AI 是IP 垂类数字化全链路 AIGC 互动内容产业生态平台,依托自研锁风 AIGC 垂类游戏生成引擎与抖音式沉浸式游戏流产品形态,打通【IP 授权 \- AI 一键生成小游戏 \- 全渠道智能分发 \- 多链路商业化变现 \- UGC 内容反哺 IP】完整产业闭环。 平台串联IP 版权方、C 端 UGC 创作者、B 端政企 / 品牌 / 短剧客户、C 端玩家四大核心参与主体,以火爆现象级 IP为冷启动底盘,兼顾全民创作、数字营销、IP 长效变现三大核心需求,既是零门槛 AI 游戏创作工具、自有流量社区,也是 IP 数字资产运营基础设施与政企数字化 SaaS 服务平台,践行 “人人都是游戏策划” 理念,打造四方共赢的数字娱乐生态。
|
||||
绘境 AI 是IP 垂类数字化全链路 AIGC 互动内容产业生态平台,依托自研 AI 游戏生成工程化体系(通用大模型 \+ 模板驱动生成 \+ IP 画风一致性管控)与短视频式沉浸游戏流产品形态,构建【IP 授权 \- AI 生成小游戏 \- 多渠道分发 \- 多链路商业化变现 \- UGC 内容反哺 IP】完整产业闭环。 平台串联IP 版权方、C 端 UGC 创作者、B 端政企 / 品牌 / 短剧客户、C 端玩家四大核心参与主体,以火爆现象级 IP为冷启动底盘,兼顾全民创作、数字营销、IP 长效变现三大核心需求,既是零门槛 AI 游戏创作工具、自有流量社区,也是 IP 数字资产运营基础设施与政企数字化 SaaS 服务平台,践行 “人人都是游戏策划” 理念,打造四方共赢的数字娱乐生态。
|
||||
|
||||
#### 4\.1\.2 三层产品形态
|
||||
|
||||
@ -248,7 +248,7 @@
|
||||
|
||||
- 内容中层(面向全生态参与方) 沉淀海量正版 IP 原画、剧本、音效、玩法模板等商用素材资产库,一方面为创作者提供合规素材,另一方面为 B 端快速定制小游戏提供预制资源,同时持续沉淀 UGC 优质内容,反哺 IP 内容矩阵。
|
||||
|
||||
- 产业底层(面向 IP 方 \+ B 端机构) 对外输出锁风 AIGC 引擎、垂类小模型 API、游戏 SaaS 服务,为文旅、政务、短剧、教育等 B 端机构提供低成本定制能力;同时搭建 IP 全生命周期管理系统,为火爆现象级 IP、国漫、非遗等 IP 方提供游戏化衍生、粉丝运营、长效资产增值服务。
|
||||
- 产业底层(面向 IP 方 \+ B 端机构) 对外输出 AI 生成能力 API、IP 画风管控方案与游戏 SaaS 服务,为文旅、政务、短剧、教育等 B 端机构提供低成本定制能力;同时搭建 IP 全生命周期管理系统,为火爆现象级 IP、国漫、非遗等 IP 方提供游戏化衍生、粉丝运营、长效资产增值服务。
|
||||
|
||||
#### 4\.1\.3 项目起源与入局时机
|
||||
|
||||
@ -266,7 +266,7 @@
|
||||
|
||||
- 当下入局核心时机
|
||||
|
||||
当前是项目落地的黄金窗口期:一方面 AIGC 算力、模型成本持续下行,垂类小模型技术走向成熟,AI 批量生成小游戏的技术可行性与成本优势凸显;另一方面休闲广告小游戏、政企数字营销、全民 AIGC 副业三大千亿赛道同步爆发,传统人工制作模式产能、效率已无法匹配市场增量,平台模式顺势承接行业转型需求。
|
||||
当前是项目落地的黄金窗口期:一方面 AIGC 算力、模型成本持续下行,模板驱动生成等工程化路径走向成熟,AI 批量生成小游戏的技术可行性与成本优势凸显(本项目已实测:单款生成 18\-27 秒、首批全自动批产验收通过率 80\.0%);另一方面休闲广告小游戏、政企数字营销、全民 AIGC 副业三大千亿赛道同步爆发,传统人工制作模式产能、效率已无法匹配市场增量,平台模式顺势承接行业转型需求。
|
||||
|
||||
#### 4\.1\.4 整体商业逻辑
|
||||
|
||||
@ -284,7 +284,7 @@
|
||||
|
||||
- 核心痛点:自研成本高、周期久、合规风险大,传统零散外包收益不稳定,缺少低成本长效游戏化变现路径。
|
||||
|
||||
- 解决方案:IP 方零研发、零风控、零资金投入,平台提供自研锁风 AI 技术、全渠道分发能力,批量产出合规衍生小游戏;平台全权承担内容审核、版权、舆情等所有合规风险。
|
||||
- 解决方案:IP 方零研发、零风控、零资金投入,平台提供 IP 画风一致性管控技术(画风 LoRA \+ 相似度校验 \+ 人工复核,建设中)与多渠道分发能力,批量产出合规衍生小游戏;平台承担内容审核、版权、舆情等合规管理责任。
|
||||
|
||||
- 收益模式:按月获取小游戏广告分成(占比 15%\-25%)\+ IP 联名商单分成,低成本搭建 IP 游戏化第二增长曲线。
|
||||
|
||||
@ -294,9 +294,9 @@
|
||||
|
||||
- 核心痛点:技术、素材、渠道、资质四大门槛阻碍副业落地,创作后变现周期长、结算不透明。
|
||||
|
||||
- 解决方案:零代码操作,一句话即可套用平台正版 IP 模板生成完整小游戏;平台打通抖音、微信、TapTap 等全域渠道,一键自动上架、统一运维;配套素材交易、推广加热、资质代办等增值服务。
|
||||
- 解决方案:零代码操作,一句话即可套用平台正版 IP 模板生成完整小游戏(实测 18\-27 秒产出可玩游戏);平台统一对接抖音、微信、TapTap 等多渠道的审核上架与运维;配套素材交易、推广加热、资质代办等增值服务。
|
||||
|
||||
- 收益模式:小游戏广告分成(创作者占比 60%\-65%);售卖原创素材获得收入(平台仅抽取 10%\-20% 交易佣金);可选购 29\.9 元 / 月高级会员解锁高阶功能,99\-299 元梯度套餐做作品流量加热;软著、渠道代办等增值服务按需付费,所有收益 T\+1 即时提现。
|
||||
- 收益模式:小游戏广告分成(创作者占比最高 80%,使用 IP 素材时 IP 授权分成从中支出、创作者实得 55%\-65%);售卖原创素材获得收入(平台仅抽取 10%\-20% 交易佣金);可选购 29\.9 元 / 月高级会员解锁高阶功能,99\-299 元梯度套餐做作品流量加热;软著、渠道代办等增值服务按需付费,所有收益 T\+1 即时提现。
|
||||
|
||||
#### 3\.2\.3 针对 B 端付费客户(文旅、政务、快消品牌、短剧平台、培训机构)
|
||||
|
||||
@ -322,6 +322,8 @@
|
||||
|
||||
### 5\.1 三层产品架构
|
||||
|
||||
> 以下为平台三层产品架构设计蓝图;其中 AI 生成链路、游戏流与数据回路已真实跑通(实证进展见 7\.3 节),其余能力按 5\.2 分阶段建设。
|
||||
|
||||
- 前端(用户体验层)
|
||||
|
||||
- AI 可视化创作编辑器:小白一句话生成 \+ 可视化拖拽微调,云端自动存档;专业版开放数值、分支剧情、自定义素材导入功能。
|
||||
@ -334,11 +336,11 @@
|
||||
|
||||
- 中台(技术支撑层)
|
||||
|
||||
- 锁风垂类 AIGC 生成引擎:面向火爆现象级IP、TRPG 跑团、非遗、悬疑网文、少儿科普五大垂类自研专属微调小模型,搭配通用模型备选,规避单一模型依赖与内容同质化,全链路自动生成游戏全要素素材。
|
||||
- 模板驱动 AI 生成引擎:通用大模型经自建模型网关接入(多家模型可切换,规避单一模型依赖),产出结构化游戏配置、由固定模板运行时渲染成完整游戏;面向火爆现象级IP、TRPG 跑团、非遗、悬疑网文、少儿科普等垂类沉淀专属模板与提示词资产(提示词全部版本化 \+ 自动回归),并为签约 IP 配套画风 LoRA 一致性管控(建设中)。
|
||||
|
||||
- 双算法推荐引擎:新人保底曝光 \+ 用户兴趣精准推荐,保障新人冷启动流量。
|
||||
- 推荐引擎:新人保底曝光 \+ 用户兴趣推荐(MVP 为规则化推荐,数据积累后演进至个性化模型),保障新人冷启动流量。
|
||||
|
||||
- 全域智能分发中台:多渠道打包适配、自动化提审上架。
|
||||
- 多渠道分发中台:多渠道打包适配、统一对接提审上架。
|
||||
|
||||
- 双重合规风控中台:内容审核 \+ 版权溯源检测,全链路合规管控。
|
||||
|
||||
@ -352,23 +354,23 @@
|
||||
|
||||
- IP 资产管理系统:统一管理签约火爆现象级IP授权、收益分成、衍生品开发规划。
|
||||
|
||||
- 算力 \& 模型智能调度中心:轻量化自研小模型 \+ 第三方模型混合调度,严控算力使用成本。
|
||||
- 算力 \& 模型智能调度中心:自建模型网关统一调度多家第三方模型,按性价比与质量灵活切换,严控算力使用成本。
|
||||
|
||||
### 5\.2 分阶段落地研发 \& 运营规划(前期优先火爆现象级IP粉丝生态搭建)
|
||||
|
||||
- 一期(0\-6 个月|MVP 冷启动・头部 IP 落地期)
|
||||
|
||||
- 产品落地:上线基础 AI 可视化编辑器、核心游戏流模块、抖音 / 微信小程序分发、广告自动结算系统;
|
||||
- 产品落地:上线基础 AI 创作编辑器、核心游戏流模块(自有端先以邀请制内测运行,公开运营以资质完备为前提),推进抖音 / 微信小程序渠道分发与广告结算系统接入(节奏受渠道与广告联盟资质审核约束);
|
||||
|
||||
- IP 运营:落地 1 款火爆现象级 IP 正式签约,搭建 IP 专属粉丝社群,深耕粉丝生态运营,落地 IP 小游戏商业化标杆案例;
|
||||
|
||||
- 用户目标:沉淀 1 万 \+ 种子创作者、10 万 \+ IP 粉丝玩家,落地 3\-5 个政企 B 端定制标杆项目;
|
||||
|
||||
- 资质筹备:完成软著申报、ICP / 文网文前置材料筹备。
|
||||
- 资质筹备:完成软著申报、ICP 备案提交、生成式 AI 服务备案 / 算法备案前置材料筹备。
|
||||
|
||||
- 二期(6\-12 个月|规模化增长期)
|
||||
|
||||
- 产品迭代:完善全模态 CG、AI 配音、素材商城、全渠道一键分发、会员付费体系;拓展非遗、TRPG 两大垂类模板;
|
||||
- 产品迭代:完善全模态 CG、AI 配音、素材商城、多渠道分发、会员付费体系;拓展非遗、TRPG 两大垂类模板;
|
||||
|
||||
- IP 拓展:新增 10 余家国漫、地方文旅腰部 IP 合作,复制头部 IP 粉丝运营打法;
|
||||
|
||||
@ -378,9 +380,9 @@
|
||||
|
||||
- 三期(12\-24 个月|生态成熟期)
|
||||
|
||||
- 技术升级:自研轻量化 H5 游戏引擎落地,启动海外本地化筹备;
|
||||
- 技术升级:自研轻量运行时持续演进(当前 15KB Canvas 运行时已支撑真实试玩),启动海外本地化筹备;
|
||||
|
||||
- IP 布局:新增 3\-5 款头部现象级 IP 签约合作,搭建垂类 IP 小模型共建计划;落地高校创作者孵化项目;
|
||||
- IP 布局:新增 3\-5 款头部现象级 IP 签约合作,搭建 IP 画风模型(LoRA)共建计划;落地高校创作者孵化项目;
|
||||
|
||||
- 规模目标:创作者 50 万 \+、平台玩家 500 万 \+,全年营收破亿,成为国内 IP\+AI 小游戏赛道标杆平台。
|
||||
|
||||
@ -412,7 +414,7 @@
|
||||
|
||||
- **火爆现象级IP联名定制:**火爆现象级IP、头部网文、动漫 IP 游戏化定制开发,项目分成合作。
|
||||
|
||||
- AI 引擎 API 授权:向中小游戏厂商、教育机构开放自研垂类模型调用权限。
|
||||
- AI 能力 API 授权:向中小游戏厂商、教育机构开放平台生成链路与画风管控能力的调用权限。
|
||||
|
||||
### 6\.3 长期复利型收益(远期核心增长点)
|
||||
|
||||
@ -420,9 +422,9 @@
|
||||
|
||||
整合头部 IP \+ 平台 UGC 优质原画、剧本资源,标准化打包为商用素材库,对外供货短剧 MCN、AI 训练企业,新增素材授权长效收入。
|
||||
|
||||
- 拓展 2:垂类 IP 小模型共建变现
|
||||
- 拓展 2:IP 画风模型共建变现
|
||||
|
||||
联合签约 IP 方共建专属微调小模型,平台出算法算力、IP 方出独家素材,知识产权双方共有;面向中小企业开放 API 调用收费,实现模型资产变现。
|
||||
联合签约 IP 方共建专属画风模型(LoRA 等轻量定制,底座为通用大模型),平台出算法算力、IP 方出授权素材,知识产权双方共有;面向中小企业开放 API 调用收费,实现模型资产变现。
|
||||
|
||||
- 拓展 3:校园孵化衍生收益
|
||||
|
||||
@ -430,7 +432,7 @@
|
||||
|
||||
- 拓展 4:平台原生 IP 孵化
|
||||
|
||||
筛选平台爆款 UGC 小游戏,平台独家签约开发手办、桌游、漫改短剧,IP 衍生品授权分成 30%\-50%。
|
||||
筛选平台爆款 UGC 小游戏,平台深度签约开发手办、桌游、漫改短剧,IP 衍生品授权分成 30%\-50%。
|
||||
|
||||
- 拓展 5:海外本地化出海
|
||||
|
||||
@ -440,6 +442,8 @@
|
||||
|
||||
依托头部 IP 粉丝冷启动→C 端创作者量产内容沉淀流量→海量内容降低 B 端定制生产成本→B 端高毛利收入反哺平台研发、IP 签约、创作者扶持→持续吸引 IP 与创作者入驻,生态持续自我增长。
|
||||
|
||||
落地排序(如实口径):① B 端 / IP 营销小游戏为现金线——推广类内容版号争议最小、回款最早,优先落地供血;② 自有端以邀请制内测形态运行,作为数据资产线——沉淀质量分、推荐与用户行为数据(规模化公开运营为未来式目标,以资质与合规定性完备为前提);③ 微信 / 抖音等小游戏渠道为规模线——走备案制 IAA(广告变现)通道。商业闭环的飞轮效应将随三线推进逐步形成。
|
||||
|
||||
### 6\.5 三年财务测算
|
||||
|
||||
#### 6\.5\.1 前置说明
|
||||
@ -504,7 +508,7 @@
|
||||
|
||||
- 固定成本(2800 万):团队扩编至 30 人,人力成本上涨;算力、办公、运维固定投入提升;
|
||||
|
||||
- 可变成本(4675 万):多 IP 签约费用、全域渠道分发成本、创作者大赛 \& 激励、市场宣传费用。
|
||||
- 可变成本(4675 万):多 IP 签约费用、多渠道分发成本、创作者大赛 \& 激励、市场宣传费用。
|
||||
|
||||
- 第二年核心增长驱动因子
|
||||
|
||||
@ -512,7 +516,7 @@
|
||||
|
||||
- B 端 SaaS 标准化落地,从 “项目制” 转向 “标准化服务”,提升复购;
|
||||
|
||||
- 全域分发中台成熟,单作品收益上限提升。
|
||||
- 多渠道分发中台成熟,单作品收益上限提升。
|
||||
|
||||
---
|
||||
|
||||
@ -536,7 +540,7 @@
|
||||
|
||||
- 原生 IP 孵化、海外出海打开增长天花板;
|
||||
|
||||
- 自研游戏引擎 \& 垂类模型形成技术壁垒,溢价能力提升。
|
||||
- 自研轻量运行时 \& IP 画风模型资产形成技术壁垒,溢价能力提升。
|
||||
|
||||
---
|
||||
|
||||
@ -544,7 +548,7 @@
|
||||
|
||||
- 悲观情景(IP 热度下滑、创作者增长不及预期):营收下调 20%,平台可通过收缩流量补贴、暂停非核心 IP 签约,将毛利率维持在 30% 以上,现金流安全;
|
||||
|
||||
- 成本管控:自研轻量化小模型,算力成本较通用大模型降低 40%,规避算力涨价风险;
|
||||
- 成本管控:模板驱动生成压缩单次生成消耗(大模型只产出结构化配置而非整段代码),自建模型网关按性价比调度多家模型,规避单一供应商涨价风险(单位生成成本实测体系建设中);
|
||||
|
||||
- 回款安全:B 端项目预付款模式 \+ 渠道月结,整体回款周期控制在 30 天内,无大额应收账款。
|
||||
|
||||
@ -552,7 +556,7 @@
|
||||
|
||||
## 7、核心团队
|
||||
|
||||
核心成员部分人员曾在前公司共事,联合落地过 AIGC 领域 ToB\+ToC 智能体平台项目,其余成员通过文娱与 AI 产业圈层引荐结识;团队成员分属全栈研发、AI 算法、品牌商务、全域运营四大领域,基于全民 AI 游戏创作赛道的行业共识,合伙立项创业,针对本赛道项目运营主体为《杭州言启万象人工智能科技有限公司》,核心团队为跨界复合型创业团队,成员均拥有 AIGC 大模型落地、互联网产品全链路搭建、政企数字化服务、游戏生态运营实战经验,核心成员曾共同落地运营商、保险等大型 ToB\+ToC AI 项目,团队配合默契、落地能力突出。现阶段全职 5 人、兼职 2 人,轻量化架构决策高效,已完成产品原型、引擎架构、头部 IP 合作意向对接,商业模式初步验证。
|
||||
核心成员部分人员曾在前公司共事,联合落地过 AIGC 领域 ToB\+ToC 智能体平台项目,其余成员通过文娱与 AI 产业圈层引荐结识;团队成员分属全栈研发、AI 算法、品牌商务、全域运营四大领域,基于全民 AI 游戏创作赛道的行业共识,合伙立项创业,针对本赛道项目运营主体为《杭州言启万象人工智能科技有限公司》,核心团队为跨界复合型创业团队,成员均拥有 AIGC 大模型落地、互联网产品全链路搭建、政企数字化服务、游戏生态运营实战经验,核心成员曾共同落地运营商、保险等大型 ToB\+ToC AI 项目,团队配合默契、落地能力突出。现阶段为 1 名全职创始人 \+ 共同创始人兼职投入 \+ AI agent 工程体系【★待创始人确认团队表述】,轻量化架构决策高效,已完成「创作→AI 生成→发布审核→试玩→数据回流」全链路真实跑通与批量生产质检体系建设,已与头部现象级 IP 签订合作框架协议,商业模式进入验证阶段。
|
||||
|
||||
|
||||
|
||||
@ -570,13 +574,13 @@
|
||||
|
||||
- 核心能力:擅长低成本验证商业想法、快速输出 Demo、化解合规与业务冲突,应对客户质疑、合规审核经验丰富。
|
||||
|
||||
- 团队价值:负责公司整体战略、头部 IP 签约、投融资、长期生态布局。目前已敲定 1 款现象级 IP 合作意向,对接十余家腰部国漫、B 端政企、文旅 IP 资源,同时打通抖音、微信、穿山甲广告联盟等全域渠道。
|
||||
- 团队价值:负责公司整体战略、头部 IP 签约、投融资、长期生态布局。目前已与 1 款头部现象级 IP 签订合作框架协议(非独家),对接十余家腰部国漫、B 端政企、文旅 IP 资源;抖音、微信、穿山甲等渠道与广告联盟接入处于筹备阶段(待相应资质审核)。
|
||||
|
||||
|
||||
|
||||
- **COO 吴玉民(联合创始人,全域运营 \& 产品总负责人,核心操盘手)**
|
||||
|
||||
- 个人背景:山东科技大学计算机本科,拥有10 年互联网产品、AIGC 商业化、全域运营、私域生态搭建经验,现任杭州言启万象 COO,全面负责造梦 AI 产品落地、创作者生态、IP 粉丝运营、全链路商业化统筹。
|
||||
- 个人背景:山东科技大学计算机本科,拥有10 年互联网产品、AIGC 商业化、全域运营、私域生态搭建经验,现任杭州言启万象 COO,全面负责绘境 AI 产品落地、创作者生态、IP 粉丝运营、全链路商业化统筹。
|
||||
|
||||
- 核心履历 \& 标杆战绩:
|
||||
|
||||
@ -586,7 +590,7 @@
|
||||
|
||||
- 核心方法论:沉淀出 \*\*“问题拆解 \- 方案落地 \- 标准化体系搭建”\*\* 闭环打法,主导打破行业定制化模式,搭建全配置化产品工厂,将项目研发效率提升 50%,擅长解决规模化、复用性行业痛点。
|
||||
|
||||
- 团队价值:主导平台C 端创作者生态、IP 粉丝运营、全域分发、商业化变现全链路,是项目从产品到用户再到营收的核心操盘手。
|
||||
- 团队价值:主导平台C 端创作者生态、IP 粉丝运营、多渠道分发、商业化变现全链路,是项目从产品到用户再到营收的核心操盘手。
|
||||
|
||||
- **技术负责人 张航(联合创始人,AI 引擎 \& 底层技术负责人)**
|
||||
|
||||
@ -596,11 +600,11 @@
|
||||
|
||||
- 主导中国电信 AI 交互助手从 0 到 1 落地,单人完成初期产品、架构、开发、运维全流程,4 周完成初版上线并落地多省项目,具备极速研发落地能力;
|
||||
|
||||
- 基于 Agentic RAG 架构搭建保险行业智能合规系统,实现 95% 问答准确率,精通垂类 AI 模型微调、内容风控、算法优化,完美匹配项目 “锁风 AIGC 引擎” 研发需求;
|
||||
- 基于 Agentic RAG 架构搭建保险行业智能合规系统,实现 95% 问答准确率,精通 AI 模型定制训练(LoRA 等)、内容风控、算法优化,与项目 IP 画风一致性管控体系的研发需求高度匹配;
|
||||
|
||||
- 主导保险核心系统元数据引擎重构,优化后代码量降低 80%,系统稳定性、可扩展性大幅提升,擅长底层架构优化、算力成本管控。
|
||||
|
||||
- 团队价值:全权负责锁风 IP 专属 AIGC 引擎、四层画风校验算法、推荐算法、风控中台自研,解决项目核心技术壁垒,把控算力、研发成本。
|
||||
- 团队价值:全权负责 AI 生成链路、IP 画风一致性管控体系、推荐策略、风控中台研发,解决项目核心技术壁垒,把控算力、研发成本。
|
||||
|
||||
### 7\.2 团队核心综合竞争力
|
||||
|
||||
@ -608,13 +612,21 @@
|
||||
|
||||
- 大型项目落地经验充足 核心成员均落地过中国电信等国家级 AI 项目,具备大厂级项目管理、风控、规模化运营能力,区别于纯游戏团队或纯 AI 团队,能同时适配 IP 文娱、AI 技术、政企合规三大复杂场景。
|
||||
|
||||
- 资源前置储备,冷启动无忧 提前锁定头部 IP 意向、全域流量渠道、政企客户资源,无需从零拓展资源;轻量化初创团队,决策链条短,迭代速度快,人力成本可控。
|
||||
- 资源前置储备,降低冷启动不确定性 已与头部现象级 IP 签订合作框架协议(非独家),明确主流渠道接入路径,储备政企客户资源;轻量化初创团队,决策链条短,迭代速度快,人力成本可控。
|
||||
|
||||
- 实战方法论匹配项目痛点 团队均有 “打破行业传统模式、降本增效、标准化复用” 的成功案例,与本项目 “替代传统游戏外包、通用 AIGC” 的核心定位高度契合。
|
||||
|
||||
### 7\.3 项目已投入情况
|
||||
|
||||
项目筹备周期 2 个月(5 月启动),已完成锁风 AIGC 引擎架构设计、产品交互原型、IP 合作框架、创作者招募体系、双重风控底层框架搭建,落地多个 C 端变现标杆案例,商业模式、技术路径、运营逻辑均完成初步验证。
|
||||
项目筹备周期 2 个月(5 月启动)。截至 2026 年 6 月中旬,已交付以下实证进展(均可演示、有提交链与验收档案可查):
|
||||
|
||||
- **全链路真实跑通**:「创作→AI 生成→发布审核→游戏流→玩家试玩→数据回流→推荐重排」端到端真实运行,真实用户一句话 18\-27 秒产出可玩游戏(部署实测);
|
||||
- **批量生产与质检体系**:首批 20 个创意全自动批量生产,机器验收通过率 80\.0%(验收=结构合法∧浏览器真玩通关∧自动对抗评审∧批内查重);经一次上游模型质量回退事件后综合通过率 95%(19/20)——质检体系实证拦截上游回退并全自动修复补产,证明质量体系真实起作用;
|
||||
- **工程资产**:游戏流内容池 30 款;自研 15KB Canvas 运行时支撑真实试玩;9/13 后端模块建成、8 类接口契约定稿;提示词全部版本化管理并配自动回归闸门;
|
||||
- **业务侧**:已与头部现象级 IP 签订合作框架协议(非独家);创作者招募体系搭建中;
|
||||
- **如实边界**:广告、支付当前为契约 \+ 骨架设计,真实接入待资质获取;尚无真实变现收入;首屏速度、可用性等性能指标为设计目标、尚未实测。
|
||||
|
||||
以上工程量由 1 名全职创始人 \+ AI agent 工程体系交付【★待创始人确认团队表述】——研发范式本身即为本项目资本效率的直接实证;商业模式、技术路径完成初步验证,运营逻辑进入验证阶段。
|
||||
|
||||
|
||||
|
||||
@ -622,15 +634,15 @@
|
||||
|
||||
### 8\.1 政策合规风险
|
||||
|
||||
- 风险描述:AI 内容违规、版权侵权、ICP / 文网文等资质不全,导致平台下架、处罚;IP 衍生内容触发舆情风险。
|
||||
- 风险描述:AI 内容违规、版权侵权、ICP 备案 / 生成式 AI 服务备案等资质不全,导致平台下架、处罚;IP 衍生内容触发舆情风险。
|
||||
|
||||
- 细化应对方案:
|
||||
|
||||
1. 技术风控:落地AI 初审 \+ 人工复核 \+ 版权溯源三重审核,IP 人设、画风全流程校验,违规内容拦截率目标 99%;
|
||||
|
||||
2. 资质规划:分阶段申报资质,6 个月内完成软著、ICP,12 个月内取得文网文,安排专人对接监管部门;
|
||||
2. 资质规划:分阶段申报资质,6 个月内完成软著申报、ICP 备案,同步推进生成式 AI 服务备案与算法备案(游戏类文网文已取消审批,按现行监管要求执行),安排专人对接监管部门;
|
||||
|
||||
3. 权责划分:平台全权承担版权、舆情、合规风险,与 IP 方、创作者签订标准化合规协议,明确追责边界。
|
||||
3. 权责划分:平台承担版权、舆情、合规管理责任,与 IP 方、创作者签订标准化合规协议,明确追责边界。
|
||||
|
||||
### 8\.2 行业竞争风险
|
||||
|
||||
@ -638,9 +650,9 @@
|
||||
|
||||
- 细化应对方案:
|
||||
|
||||
1. 技术壁垒加固:每季度迭代锁风 AIGC 算法,持续拉大与通用大模型的 IP 管控差距,申请算法相关软著;
|
||||
1. 技术壁垒加固:持续迭代画风一致性校验与生成质检体系,拉大与通用大模型直出方案的 IP 管控差距,申请算法相关软著;
|
||||
|
||||
2. IP 独家绑定:与头部现象级 IP 签订1\-3 年独家合作协议,约定仅限本平台开展 UGC 小游戏衍生;
|
||||
2. IP 深度绑定:已与头部现象级 IP 签订合作框架协议(非独家),争取中长期续约与优先合作条款,深化 UGC 小游戏衍生授权;
|
||||
|
||||
3. 用户心智抢占:依托 IP 粉丝做深度社区运营,建立创作者社群、赛事体系,提升用户迁移成本。
|
||||
|
||||
@ -650,7 +662,7 @@
|
||||
|
||||
- 针对性应对方案(分三层防御):
|
||||
|
||||
1. IP 矩阵分散风险(核心动作) 冷启动期(0\-6 个月):以 1 款头部 IP 为核心;6\-12 个月快速新增 10 \+ 腰部国漫、文旅、非遗 IP,将单 IP 流量占比从 80% 降至 40% 以内;12\-24 个月布局 3\-5 款不同垂类头部 IP,形成 “头部 \+ 腰部 \+ 地域非遗” 多元化 IP 矩阵,杜绝单一 IP 依赖。
|
||||
1. IP 矩阵分散风险(核心动作) 冷启动期(0\-6 个月):以 1 款头部 IP 为核心;6\-12 个月快速新增 10 \+ 腰部国漫、文旅、非遗 IP,将单 IP 流量占比从 80% 降至 40% 以内;12\-24 个月布局 3\-5 款不同垂类头部 IP,形成 “头部 \+ 腰部 \+ 地域非遗” 多元化 IP 矩阵,降低单一 IP 依赖。
|
||||
|
||||
2. IP 生命周期运营延长 为合作 IP 定制月度创作赛事、粉丝互动活动、IP 衍生联动,用 UGC 内容持续激活粉丝,将 IP 商业活跃周期从 1 年延长至 2\-3 年;同步挖掘 IP 冷门支线、怀旧内容,二次唤醒存量用户。
|
||||
|
||||
@ -670,11 +682,11 @@
|
||||
|
||||
- 中层(成熟创作者):开设进阶创作训练营、玩法模板库,提升内容质量,对接中小型商单,提升收入;
|
||||
|
||||
- 顶层(高流水优质创作者):独家签约 \+ 专项扶持,设置阶梯式补贴、流量加权、IP 专属定制权限,锁定核心产能。
|
||||
- 顶层(高流水优质创作者):深度签约 \+ 专项扶持,设置阶梯式补贴、流量加权、IP 专属定制权限,锁定核心产能。
|
||||
|
||||
2. 优质创作者引流 \& 留存动作 1)定向挖掘:联动游戏社区、网文平台、自媒体、高校数字媒体专业,定向签约成熟小游戏制作者、网文编剧,提前储备优质产能; 2)收益倾斜:顶层创作者广告分成比例上浮 5%\-10%,商单优先派单,素材交易免收平台佣金; 3)成长通道:打造 “创作者榜单 \+ 年度大赛”,头部创作者给予 IP 联名、个人 IP 孵化机会,提升归属感。
|
||||
|
||||
3. 内容质量管控,解决同质化 依托锁风引擎区分玩法、剧情模板,AI 自动提醒内容重复;运营人工筛选优质作品置顶,引导创作方向,避免低质内容泛滥。
|
||||
3. 内容质量管控,解决同质化 依托模板体系与生成质检(含批内查重)区分玩法、剧情模板,AI 自动提醒内容重复;运营人工筛选优质作品置顶,引导创作方向,避免低质内容泛滥。
|
||||
|
||||
4. 考核指标:保障月流水万元以上优质创作者月留存率≥85%,作为运营核心 KPI。
|
||||
|
||||
@ -686,7 +698,7 @@
|
||||
|
||||
- 细化应对方案:
|
||||
|
||||
1. 技术降本:优先使用自研轻量化垂类小模型,替代高成本通用大模型,算力成本降低 40% 以上;采用 “自有算力 \+ 云端弹性算力” 混合调度,闲时缩减算力,控制可变成本;
|
||||
1. 技术降本:采用模板驱动生成——大模型只产出结构化游戏配置而非整段代码,单次生成消耗低且可控;自建模型网关按性价比与质量调度多家模型,提示词版本化与自动回归避免无效消耗(单位生成成本实测体系建设中);采用 “自有算力 \+ 云端弹性算力” 混合调度,闲时缩减算力,控制可变成本;
|
||||
|
||||
2. 分阶段投入:产品采用 MVP 迭代模式,不一次性全功能开发;种子轮资金优先投入核心引擎与 IP 落地,非核心功能延后开发;
|
||||
|
||||
@ -698,13 +710,13 @@
|
||||
|
||||
### 9\.1 融资需求
|
||||
|
||||
融资轮次:种子轮;融资金额:200 万 \- 1000 万元;出让股权:7%\-10%
|
||||
融资轮次:种子轮;融资金额:200 万 \- 1000 万元;出让股权:7%\-10%【★唯一融资口径待创始人确认(三版材料曾互斥,其余两版已禁外发)】
|
||||
|
||||
### 9\.2 资金分配用途
|
||||
|
||||
- 产品研发 40%:锁风 AIGC 引擎迭代、游戏流优化、全渠道适配、自研游戏引擎开发;
|
||||
- 产品研发 40%:AI 生成链路与 IP 画风一致性管控迭代、游戏流优化、多渠道适配、轻量运行时演进;
|
||||
|
||||
- 算法迭代 20%:垂类小模型优化、推荐算法升级、数据与结算中台建设;
|
||||
- 算法迭代 20%:IP 画风模型(LoRA)训练与一致性校验优化、推荐策略升级、数据与结算中台建设;
|
||||
|
||||
- 团队扩充 15%:增补技术、运营、商务人才,团队扩编至 15\-20 人;
|
||||
|
||||
@ -720,9 +732,31 @@
|
||||
|
||||
## 10、项目总结
|
||||
|
||||
造梦 AI 立足于政策扶持 \+ AIGC 技术成熟 \+ IP 衍生市场空白三重发展红利,以独家锁风 AI 技术为核心抓手,前期聚焦火爆现象级 IP 粉丝生态精细化运营,快速完成产品冷启动与商业模式验证;依托【正版 IP \+ 全民 UGC 创作 \+ B 端政企定制】全链路生态,补齐国内 IP 低成本游戏化衍生的市场缺口。
|
||||
绘境 AI 立足于政策扶持 \+ AIGC 技术成熟 \+ IP 衍生市场空白三重发展红利,以 AI 生成工程化与 IP 画风一致性管控为核心抓手(核心生成链路已真实跑通、批量生产质检体系已实证),前期聚焦火爆现象级 IP 粉丝生态精细化运营,快速完成产品冷启动与商业模式验证;依托【正版 IP \+ 全民 UGC 创作 \+ B 端政企定制】全链路生态,补齐国内 IP 低成本游戏化衍生的市场缺口。
|
||||
|
||||
项目打破传统游戏创作重资产、高门槛痛点,一边帮助海量正版 IP 盘活粉丝资产、实现稳定增收,一边赋能普通人依托正版 IP 零成本副业变现,同时为文旅、品牌提供轻量化数字营销解决方案。未来公司持续落地 IP 素材商业化、垂类模型共建、高校孵化三大创新业务,从小游戏创作平台逐步升级为国内领先的 IP 数字资产基础设施服务商。
|
||||
项目打破传统游戏创作重资产、高门槛痛点,一边帮助海量正版 IP 盘活粉丝资产、实现稳定增收,一边赋能普通人依托正版 IP 零成本副业变现,同时为文旅、品牌提供轻量化数字营销解决方案。未来公司持续落地 IP 素材商业化、IP 画风模型共建、高校孵化三大创新业务,从小游戏创作平台逐步升级为国内领先的 IP 数字资产基础设施服务商。
|
||||
|
||||
企业愿景:落地 “人人都是游戏策划”,打造国内头部全民 IP 游戏共创生态平台,助力中国本土 IP 数字化、产业化长效发展。
|
||||
|
||||
---
|
||||
|
||||
## 清洗记录(2026-06-10 W2)
|
||||
|
||||
> 依据:架构三向审计 HJ-AUDIT-001 R1(`docs/agent-specs/2026-06-10-架构文档三向审计-review.md` §1/§6);现实口径出处:`docs/mvp/MVP进度总账.md`、`docs/mvp/MVP作战清单.md`(C 轨)。本档清洗后为对外唯一主干 BP(路演稿 / 生态引擎 BP / 全景材料已加禁外发横幅归档)。
|
||||
|
||||
**已清洗类别:**
|
||||
|
||||
1. **四条已裁定技术红线**全文清零:「垂类(大模型)微调 / 垂类小模型」「四层(画风)校验」「全域一键分发 / 一键自动上架」「双轨 / 双算法」——统一改写为真实口径:通用大模型 \+ 模板驱动生成 \+ IP 画风一致性管控(画风 LoRA \+ 相似度校验 \+ 人工复核,标注「建设中」)\+ 规则化推荐 \+ 多渠道适配(统一对接审核上架)。连带清掉营销词「锁风(引擎 / 算法 / 技术)」全部 20 处。
|
||||
2. **IP 口径**:「独家合作协议」(原 :213/:643)→「已签合作框架协议(非独家)」;「已敲定合作意向」「提前锁定意向」等旧口径同步升级为已签框架协议事实;全文「独家」清零(创作者「独家签约」改「深度签约」、「独家素材」改「授权素材」)。
|
||||
3. **竞品数字**:本档经全文检索**不含**「极逸 SOON 融资近 1 亿」「FunloomAI 百度云合作」表述,无需处置(0 命中)。
|
||||
4. **绝对化用语**:「彻底解决 / 彻底杜绝」「同行暂无同类落地技术方案」「首创」「行业独有」「完美匹配」「冷启动无忧」「杜绝单一 IP 依赖」「压缩 90% 成本」等已全部消除或降格为可核实表述。
|
||||
5. **性能 / 规模未实测指标**:「零加载、高稳定运行」等性能话术删除;新增数字均为实测口径并注明(18\-27 秒 / 80\.0% / 95%〔19/20〕/ 30 款 / 15KB / 9/13 模块 / 8 类契约);7\.3 明示「首屏速度、可用性等性能指标为设计目标、尚未实测」;自研小模型「算力成本降 40%」无实测依据,改为模板驱动降耗的真实机制描述。
|
||||
6. **变现现状**:删除「落地多个 C 端变现标杆案例」「打通穿山甲广告联盟等全域渠道」等已被审计实锤证伪的主张;如实改为「广告、支付为契约 \+ 骨架设计,真实接入待资质;尚无真实变现收入」;渠道接入改「筹备中(待资质审核)」。
|
||||
7. **资质口径**:「文网文」(游戏类已取消审批)→「生成式 AI 服务备案 / 算法备案」(共 4 处);「双重风控已搭建」→「设计 \+ 审核门禁已接入发布链路,全量能力分阶段建设」。
|
||||
8. **升级进 06\-10 真实硬货**(替换被删红线留下的空洞):全链路真实跑通 \+ 18\-27 秒实测(1\.1 / 1\.2 / 3\.4 / 4\.1 / 7\.3);批产 80\.0% 与综合 95%(19/20)质检拦截正面叙事(1\.2 / 3\.4 / 7\.3);30 款内容池 / 15KB 运行时 / 9/13 模块 / 8 类契约 / 提示词版本化+自动回归(3\.4 / 7\.3);单人创始人 \+ AI agent 工程体系 = 资本效率实证(7\.3);**三线排序落地叙事**(6\.4:① B 端 / IP 现金线 ② 自有端邀请制内测数据资产线〔未来式诚实标注〕③ 微信 / 抖音渠道规模线);自有端「邀请制内测」合规定性(3\.4 / 5\.2 / 6\.4)。
|
||||
|
||||
**保留的 ★ 待创始人确认项:**
|
||||
|
||||
- 【★待创始人确认团队表述】×2:7 章团队总述(原「全职 5 人、兼职 2 人」→「1 名全职创始人 \+ 共同创始人兼职 \+ AI agent 工程体系」,审计建议口径);7\.3 末段同款表述。注意:三位创始人简历中「现任(北京华通互惠 / 杭州言启万象)」表述未改动,须与最终团队口径一并核对自洽。
|
||||
- 【★唯一融资口径待创始人确认(三版材料曾互斥,其余两版已禁外发)】×1:9\.1 融资金额 200 万 \- 1000 万元 / 出让 7%\-10%(数字原样保留,未代改)。
|
||||
|
||||
@ -1,10 +1,12 @@
|
||||
# 造梦 AI|完整商业布局全景材料
|
||||
> 📁 **【归档 · 禁外发 · 2026-06-10 审计 HJ-AUDIT-001 R1】对外口径以清洗后的 BP 改造版为唯一主干;本档融资/估值/竞品数字未经清洗,禁止外发。**
|
||||
|
||||
# 绘境 AI|完整商业布局全景材料
|
||||
|
||||
#
|
||||
|
||||
## 一、平台整体定位
|
||||
|
||||
定位:造梦 AI = AIGC 互动内容生产引擎 \+ 数字娱乐内容数据入口 \+ 次元生态基础设施
|
||||
定位:绘境 AI = AIGC 互动内容生产引擎 \+ 数字娱乐内容数据入口 \+ 次元生态基础设施
|
||||
|
||||
|
||||
|
||||
@ -68,7 +70,7 @@
|
||||
|
||||
- 自研私域:抖音式游戏流、沉浸式滑动、0 秒加载
|
||||
|
||||
- 五渠道分发:造梦私域、抖音、微信、快手、TapTap
|
||||
- 五渠道分发:绘境私域、抖音、微信、快手、TapTap
|
||||
|
||||
- AI 推荐:IP 标签化、赛马算法、精准匹配
|
||||
|
||||
@ -126,11 +128,11 @@
|
||||
|
||||
---
|
||||
|
||||
## 四、多元变现商业闭环(IP版权方 \+ 造梦AI平台\+UGC 创作者)
|
||||
## 四、多元变现商业闭环(IP版权方 \+ 绘境AI平台\+UGC 创作者)
|
||||
|
||||
### 1)第一阶段:三端基础商业闭环
|
||||
|
||||
IP版权方、UGC 创作者、造梦AI平台享受分成机制,C 端玩家是免费流量载体,不靠玩家直接收费,但支撑广告与 B 端价值。
|
||||
IP版权方、UGC 创作者、绘境AI平台享受分成机制,C 端玩家是免费流量载体,不靠玩家直接收费,但支撑广告与 B 端价值。
|
||||
|
||||
1\.广告收益三方拆分:IP 分 15%\-25%、创作者 55%\-65%,剩余分成平台留存;商单、会员、素材佣金、B 端定制等收入主要由平台享有。
|
||||
|
||||
@ -334,7 +336,7 @@ IP版权方、UGC 创作者、造梦AI平台享受分成机制,C 端玩家是
|
||||
|
||||
- 国内 AI 小游戏平台:无锁风、模板通用、分成低、数据黑盒
|
||||
|
||||
### 造梦 AI 绝对差异化
|
||||
### 绘境 AI 绝对差异化
|
||||
|
||||
1. 唯一 IP 专属 AI 锁风:100% 贴合、绝不毁 IP
|
||||
|
||||
@ -358,7 +360,7 @@ IP 授权 → AI 生成 → 粉丝共创 → 全域流量 → 广告变现 → I
|
||||
|
||||
## 十、最终核心价值总结(对外一句话)
|
||||
|
||||
造梦 AI = 国内唯一【IP 专属 AI 锁风 \+ 工业化量产 \+ 全域流量 \+ 全自动变现 \+ 资产反哺 \+ 风险全兜底】全链路平台
|
||||
绘境 AI = 国内唯一【IP 专属 AI 锁风 \+ 工业化量产 \+ 全域流量 \+ 全自动变现 \+ 资产反哺 \+ 风险全兜底】全链路平台
|
||||
|
||||
为头部 IP 提供:免费内容、免费流量、新增变现、资产沉淀、零风险全兜底。
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
| D1 | LLM 选型 | **主 DeepSeek `deepseek-chat` + 备 通义千问 `qwen-plus`;不接 OpenAI** | 高 | 新决策(解决 tech-decisions §3 待确认#1) |
|
||||
| D2 | 玩法模板组合 | **MVP 4 个:放置挂机(idle/AFK) / 模拟经营(tycoon) / 合成升级(merge) / 点击收集(clicker)**;动作类(躲避/跑酷/射击/解谜)→P1 | 中 | **创始人定向:主打休闲·经营·放置,碎片化时间** |
|
||||
| D3 | 分成 + 积分 | **MVP 广告分成统一 80%(全配置化;分层结构保留、方向待真实数据后定);满 5 元提现;积分默认 1 元=10 积分(产品域可配,打赏用)** | 高(全配置化) | 创始人定 C(详见下);满5元/积分口径采纳 glossary L42 / Doc B L214 |
|
||||
| D4 | 品牌视觉 | **用 `ui-ux-pro-max` 技能做设计,视觉参考 `docs-design/zaomeng-ai-demo.html`** | 高 | 创始人指定 |
|
||||
| D4 | 品牌视觉 | **用 `ui-ux-pro-max` 技能做设计,视觉参考 `docs-design/huijing-ai-demo.html`** | 高 | 创始人指定 |
|
||||
|
||||
## D1 理由(不变)
|
||||
GameConfig 是结构化 JSON/类代码产物 → DeepSeek 结构化/代码生成强且**成本最低**(贴 ¥1000/月)、中文原生、境内合规;备用 Qwen 对齐已选阿里云生态、做可用性兜底;Dify 热切换→主备零成本抗抖动。OpenAI 境外支付/合规成本高,MVP 不接。
|
||||
@ -23,14 +23,18 @@ GameConfig 是结构化 JSON/类代码产物 → DeepSeek 结构化/代码生成
|
||||
四者**全部 config/数值驱动、无物理碰撞 → 生成成功率最高(保 ≥80%)**,Tier1 自研 Canvas 2D 均可承载,且全部碎片化友好。动作/技巧类(躲避/跑酷/射击/解谜)生成复杂度高、非碎片场景 → P1。
|
||||
**落地**:`contracts/templates/{idle,tycoon,merge,clicker}.schema.json` × 4 + 各 3-5 条示例 Prompt(Prompt Registry)。
|
||||
|
||||
> **D2 复审拍板(2026-06-10,对账审计 HJ-AUDIT-001 R4)**:实际建设曾偏离本裁定——`contracts/templates/` 实建 clicker/dodge/runner/match(D2 之前旧集),spike/batch-001/002/渲染面均基于旧集,且无文档记录此背离。创始人复审裁定=**维持 D2 集合,按 D2 改建**:M-c 模板波建 idle/tycoon/merge 三个 runtime(clicker 保留为第 4 个,建议顺序 merge→idle→tycoon,merge 机制最薄);dodge/runner/match schema **降 P1 保留契约不删**。理由:idle/tycoon 自带离线产出/经营回访循环,留存经济学+碎片化定位双赢;三个新 runtime 无论选哪集都要建,工程量同级、切换成本可忽略。
|
||||
|
||||
## D3 理由(核实 + 创始人定 C)
|
||||
**核实**:文档原模型是分层 `小白 80% / 进阶 75% / 专业 70%`(glossary L43,对外口径"80%")。但该方向**反行业惯例**(YouTube/Twitch/Patreon 皆"越大越优惠")——越高阶抽越多 = 惩罚成长、易逼走头部创作者,风险真实。且该分层**对 MVP 不咬人**(MVP 无"专业"创作者,人人小白全拿 80%)。
|
||||
**创始人决策 = C**:**MVP 统一 80%**(不惩罚成长、不预判分层),分层方向(维持文档 80/75/70 vs 翻成累进)等真实数据后再定。全配置化,后期改默认值即可。
|
||||
- **积分**:Doc B L214 明确 trade 不定义积分形态/定价、属**产品域配置** → 单价天生可配;默认 `1 元=10 积分`,用途=打赏创作者(计入其收益、走同一分账口径);会员订阅→P1。
|
||||
**落地**:trade 分账配置 `creator_share=0.80`(MVP 全档统一;`creator_share_tier` 分层结构保留、值后期填)、`withdraw_min=500`(分);pay/产品域 `point_rate=10`。全部走 Nacos/DB 配置,非硬编码。
|
||||
|
||||
> **D3 复审拍板(2026-06-10,审计 HJ-AUDIT-001 R3 修法③)**:三层分成叠加规则裁决=**IP 从创作者份额出(净额基数)**——分成基数=平台从渠道/联盟实收净额(微信 IAA 渠道先扣 40%);创作者 80%;使用 IP 素材时 IP 授权分成 15-25% 从创作者份额内支出(创作者实得 55-65%);**平台恒留净额的 20%**。「创作者 80%」与对外材料「55-65%+IP 15-25%」自此为同一模型的两种表述。eCPM 假设档=15/30/60(仅进内部模型、明标待测)。敏感性模型见 `docs/mvp/单位经济敏感性模型.md`。落地:trade 分账增 `ip_share`(从 creator 份额内扣减项)配置位,账表设计随 M4 真实化。
|
||||
|
||||
## D4 理由(创始人指定)
|
||||
设计走 **`ui-ux-pro-max`** 技能,视觉参考 **`docs-design/zaomeng-ai-demo.html`**(主产品 demo)。
|
||||
设计走 **`ui-ux-pro-max`** 技能,视觉参考 **`docs-design/huijing-ai-demo.html`**(主产品 demo)。
|
||||
**应用时机**:建 game-studio 前端时调用 ui-ux-pro-max、以 demo 为视觉基准产出主题 token 与组件;当前先做后端黄金模板,不阻塞。game-admin 沿用 Element Plus。
|
||||
|
||||
## 下一步(决策落地)
|
||||
|
||||
@ -56,7 +56,7 @@ game-studio/
|
||||
│ ├── store/ 【A1 地基】Pinia: user/feed/project/create/session
|
||||
│ ├── api/ 【A1 地基】axios 封装 + 5 契约 request 函数
|
||||
│ ├── mock/ 【A1 地基】vite-plugin-mock:5 YAML handler
|
||||
│ ├── styles/ 【A1 地基】D4 token(zaomeng demo 提取)+ Vant 主题覆盖
|
||||
│ ├── styles/ 【A1 地基】D4 token(huijing-ai-demo 提取)+ Vant 主题覆盖
|
||||
│ ├── components/ 【A1 地基】通用:TabBar/GameCard/LoadingBar/EmptyState/InteractBar/AppButton
|
||||
│ ├── telemetry/ 【A1 地基】track 封装 + 性能 beacon(横切,各页面调用)
|
||||
│ ├── host/ 【A2 宿主引擎】(全在 src/host 下,A2 独占;默认 tsconfig include,零改配置)
|
||||
@ -125,7 +125,7 @@ game-studio/
|
||||
- `packages/runtime/`:Canvas Runtime **<15KB**(硬约束);最小渲染循环 + 按 `game-package.schema.json` 加载 assets + 1 个 demo 游戏(点击计数类,足以验证链路);通过 `window.WanxiangGameSDK` 发 `game_loaded/start/end`。
|
||||
|
||||
### 3.6 设计 token(src/styles,D4)
|
||||
从 `docs-design/zaomeng-ai-demo.html` 提取 CSS 变量:`--bg:#070911 --panel:#101522 --ink:#eef6ff --muted:#8d9ab6 --cyan:#31e6ff --green:#7cf2a4 --pink:#ff669d --amber:#ffc857 --danger:#ff626f --violet:#9d7cff`;圆角 8px;Vant 主题覆盖(`--van-primary-color`→`--cyan` 等)。
|
||||
从 `docs-design/huijing-ai-demo.html` 提取 CSS 变量:`--bg:#070911 --panel:#101522 --ink:#eef6ff --muted:#8d9ab6 --cyan:#31e6ff --green:#7cf2a4 --pink:#ff669d --amber:#ffc857 --danger:#ff626f --violet:#9d7cff`;圆角 8px;Vant 主题覆盖(`--van-primary-color`→`--cyan` 等)。
|
||||
|
||||
### 3.7 Mock 约定(src/mock)
|
||||
**自写极简 mock 中间件 vite 插件**(弃用 vite-plugin-mock:拖 mockjs high 漏洞、Vite8 兼容存疑、**不支持 preview**)。要点:
|
||||
|
||||
@ -19,7 +19,7 @@
|
||||
| **应用形态** | **单 SPA 双区**(玩家"流"为默认首页 + 创作者"创作"入口) | 「全民」用户身份流动(既玩又创),单 app 切区比双 app 跳转顺滑;省一套地基 |
|
||||
| **技术核心** | 宿主容器 + WanxiangGameSDK + Canvas Runtime **本次一起出骨架** + 1 个 demo 游戏跑通三方链路 | 「试玩/预览」是闭环命门,缺它玩家侧和创作者侧都断链;契约 #3/#4 已锁,可并行 |
|
||||
| **数据来源** | vite mock 据 5 个 API YAML 自动生成,前端**零后端依赖**本地预览全闭环 | 不卡 ICP/支付/广告等日历闸门,前端可独立交付到"可试用" |
|
||||
| **设计** | 套 `zaomeng-ai-demo.html` 现成 CSS token 起骨架,ui-ux-pro-max 后续细化 | D4 已定;骨架阶段不阻塞于精细视觉 |
|
||||
| **设计** | 套 `huijing-ai-demo.html` 现成 CSS token 起骨架,ui-ux-pro-max 后续细化 | D4 已定;骨架阶段不阻塞于精细视觉 |
|
||||
| **编排** | 复用 Wave1 三相并行 Workflow(前端契约→并行建模块→集成+冒烟验证门) | 已实证有效(Wave1 46 单测绿);前端契约已锁 → 模块解耦可 N 路并行 |
|
||||
| **广告/支付** | 本次只做**桩**(SDK ad/pay 插件桩),真实 SDK 切换在闸门后 | 穿山甲/微信支付需进件审核(日历闸门),与前端脊柱解耦 |
|
||||
|
||||
|
||||
@ -83,7 +83,7 @@ flowchart TD
|
||||
**当前相**:✅ **Wave1 后端脊柱全相完成并验证**(Phase A 契约→修复→锁定→Phase B 建设→Phase C 集成全绿)。
|
||||
|
||||
**已定方向(创始人 2026-06-08 选①):下一主线 = 前端 `game-studio` 脊柱骨架**(非继续铺 Wave2/3 后端广度)。理由:闭环优先的下一环是"可试用",前端是种子用户能试的必要环,且不卡外部闸门(用已锁契约 mock 建+本地预览)。**先出 review 版计划 → 评审 → 并行 Workflow 执行**(复用 Wave1 三相方法)。
|
||||
- 前端栈:Vue3 + Vant + 自研 Canvas Runtime(<15KB, Tier1) + WanxiangGameSDK;D4 设计基准 = `ui-ux-pro-max` 技能 + `docs-design/zaomeng-ai-demo.html`。
|
||||
- 前端栈:Vue3 + Vant + 自研 Canvas Runtime(<15KB, Tier1) + WanxiangGameSDK;D4 设计基准 = `ui-ux-pro-max` 技能 + `docs-design/huijing-ai-demo.html`。
|
||||
- 消费契约(mock 依据):`contracts/api-schemas/{project,aigc,runtime,feed,telemetry}.yaml` + `sdk-interface.d.ts`(#3) + `game-package.schema.json`(#4)。
|
||||
- 配套交付(解锁运行时验证,给人执行):staging 拉起手册(docker-compose 中间件 + `game-cloud/sql/mysql/ruoyi-vue-pro.sql` 初始化 yudao 基础表 + Flyway 自动建 game_ 表 + Swagger/端点冒烟);本环境无 docker/内存不足无法代跑。
|
||||
- 并行提醒人侧:长周期日历闸门(经营主体/ICP备案/支付进件/广告审核/LLM实名充值)即刻启动。
|
||||
|
||||
176
docs/agent-specs/2026-06-10-Mc模板波-review.md
Normal file
176
docs/agent-specs/2026-06-10-Mc模板波-review.md
Normal file
@ -0,0 +1,176 @@
|
||||
# M-c 模板波(merge / idle / tycoon)· 评审版
|
||||
|
||||
- **编号**: HJ-MC-TPL-REVIEW-001 | 2026-06-10 | **✅ 已拍板(2026-06-10 创始人四项全拍,见 §7 拍板结果)→ 待出 execution 版**
|
||||
- **上游拍板**: D2 复审(2026-06-10 R4)——维持 D2 集合、按 D2 改建:M-c 建 **merge→idle→tycoon** 三个模板 runtime,clicker 保留为第 4 个;dodge/runner/match **降 P1 保留契约不删**(`docs/agent-specs/2026-06-08-mvp业务决策.md:26`)。
|
||||
- **结论先行**: 推荐**两批走**(批① merge 单模板全链收口出「新模板接入配方」→ 批② idle+tycoon 并行复用配方);idle 离线产出推荐**纯前端时间差 + SDK storage 通道(宿主落 localStorage)**,服务端存档降 P1;merge 拖拽在现有 Canvas Runtime **可行、低风险**(CDP 可确定性派发拖拽序列)。
|
||||
|
||||
---
|
||||
|
||||
## 1. 背景与目标
|
||||
|
||||
agent 化生成 QA 闭环已在 clicker 单模板上整体收口:batch-001 accept 80.0%、M-b 真实用户链 5 样本实证、batch-002b 补产 10/10,feed 现有 30 款 clicker(`docs/mvp/MVP作战清单.md:46-49`)。但 MVP 模板集只有 clicker 一个真 runtime——`contracts/templates/` 下 dodge/runner/match 三份 schema 均自声明「runtime 未实现,不得据此宣称可玩」(`contracts/templates/dodge.schema.json:5`),且该三模板属 R4 已裁定降 P1 的旧集。
|
||||
|
||||
**本波目标**:按 D2 集合新建 **merge(合成升级)/ idle(放置挂机)/ tycoon(模拟经营)** 三个模板的完整纵切——契约 schema → prompt 入册 → Canvas Runtime 玩法 → 后端支持集 → QA 闭环(对抗评审 + Golden 集 + 玩家 agent 真玩)→ 小批量试产入 feed。完成后 MVP 4 模板(D2 拍板口径)全部真实可玩、可批产。
|
||||
|
||||
### 非目标(红线)
|
||||
|
||||
- **dodge / runner / match runtime 不建**:三份 schema 保留在 `contracts/templates/` 不删、不动内容;后端对其保持「正确失败」(见 §5)。
|
||||
- **3D / Tier2-3 不碰**:本波全部在 Tier1 自研 Canvas Runtime(<15KB 红线,`.agents/knowledge/tech-decisions.md:22`)内。
|
||||
- **不动发布链 / 数据回路**:生命周期事件名、`game_end {score, completed, duration_ms}` 契约行(quality 回路命门,`game-studio/src/host/runtime/index.ts:215-217`)、遥测、feed 排序逻辑逐字不动。
|
||||
- **不做服务端玩家存档 / 不动鉴权**:idle 离线产出走纯前端(§2.3),服务端持久化降 P1。
|
||||
- 不动 game-admin;不做资产(图片/音频)生成;demo 兜底包 `target: 5` 不动(玩家 agent 信号锚,`player_cdp.py:93`)。
|
||||
|
||||
---
|
||||
|
||||
## 2. 推荐方案
|
||||
|
||||
### 2.1 分批节奏:两批走(推荐)
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
subgraph 批① merge 先行收口
|
||||
A[merge schema 入册<br>+ prompt 三件套] --> B[runtime 模板分发架构<br>+ merge 玩法]
|
||||
B --> C[玩家 agent 拖拽策略<br>+ 对抗/Golden 扩展]
|
||||
C --> D[试产 10 条<br>校准批]
|
||||
D --> E[沉淀『新模板<br>接入配方』]
|
||||
end
|
||||
subgraph 批② idle + tycoon 并行
|
||||
E --> F[idle 纵切<br>含离线产出]
|
||||
E --> G[tycoon 纵切]
|
||||
F & G --> H[各试产 10 条<br>→ 正式批 → 入 feed]
|
||||
end
|
||||
```
|
||||
|
||||
**推荐:批① merge 单模板收口,批② idle+tycoon 并行复用配方。** 理由:
|
||||
|
||||
1. merge 机制最薄、最接近 clicker 参数化拼装(D2 复审注原话),但它首次引入两件「第一次」——**runtime 模板分发架构**(现 runtime 是单一 clicker 玩法、从不读 `templateId`,见 §3 意外事实)和**玩家 agent 非点击交互**(拖拽取证)。两件新事在单模板上调通,风险面最小。
|
||||
2. 黄金模板先行是项目既定效率原则(AGENTS.md §8-1「perfect one module first, then clone」);clicker 全链就是这么收口的(spike→试点 6/6→batch-001)。
|
||||
3. idle 的离线产出是本波最大架构分叉(§2.3),叠加在「第一次建新模板」上会让 QA 闭环扩展(doctrine/Golden/CDP 策略×3)同时调试,回炉成本高(返工=效率头号杀手,AGENTS.md §8-4)。
|
||||
|
||||
被否选项:**一波全建三模板**——并行省 1 个批次窗口,但三套 prompt 冷启动 + 三套 CDP 策略 + runtime 架构改造同窗联调,任何一处卡壳全波阻塞;clicker 经验表明 prompt 需 1-2 轮升版校准(v1.0→v1.1.1 走了两轮 Golden 回归),三模板并发校准会撞同一个评审/回归资源。节奏差距估计仅 2-4 个工作日,不值得换风险。
|
||||
|
||||
### 2.2 三模板玩法循环与参数面(均为**提案**,参数范围执行版细化)
|
||||
|
||||
设计总纲(提案):全部沿 clicker 范式——**纯数值/config 驱动、无物理碰撞、单局 ≤90s 可通关**(保 LLM 填参成功率 ≥80% 量级 + CDP 确定性取证预算);字段命名沿 clicker schema 风格(`templateId` const 精确等值防串台 + `additionalProperties:false`,`contracts/templates/clicker.schema.json:7-11`)。
|
||||
|
||||
| 模板 | 玩法循环(一句话) | GameConfig 参数面草案(类别级) | 真玩通关判定(一句话) |
|
||||
|---|---|---|---|
|
||||
| **merge** | 拖拽两个同级物件合成更高一级,合成出目标等级物件即通关 | 公共三件(templateId/title/theme)+ 合成链长(3-6 级)+ 目标等级 + 棋盘格数(小棋盘 6-9 格)+ 物件文案 itemLabel | CDP 按可解局面派发确定性「按下-拖动-松开」序列合成至目标等级 → `game_end{completed:true}` |
|
||||
| **idle** | 点击产出资源 + 每秒自动产出,资源攒到目标量即通关;离开再回来补发离线产出 | 公共三件 + 点击产出量 + 每秒自动产出量 + 目标资源量 + 升级档(1-2 档:成本/倍率)+ 资源文案 resourceLabel + 离线产出参数(上限分钟数/效率折扣) | CDP 点击若干次后按 config 速率等待(确定性时长上限内)资源达标 → `game_end{completed:true}` |
|
||||
| **tycoon** | 进货→顾客到来→售出赚差价的经营循环,金币攒到目标量即通关 | 公共三件 + 进货成本/售价(差价对)+ 顾客节奏(间隔档位枚举)+ 目标金币 + 商品/顾客文案 goodsLabel/customerLabel | CDP 按「进货→售出」循环点击至金币达标 → `game_end{completed:true}` |
|
||||
|
||||
三模板「真玩通关」均**不改判定信封**——仍锚定既有五条 AND(loaded ∧ completed ∧ duration>0 ∧ 无错 ∧ 包一致,`orchestrator/player_cdp.py:833-841`),只新增逐模板的**驱动策略**(现仅 clicker:点 target 次,`player_cdp.py:13,669-676`)。
|
||||
|
||||
### 2.3 idle 离线产出:本波最大架构分叉(必拍)
|
||||
|
||||
| 方案 | 做法 | 代价 / 收益 |
|
||||
|---|---|---|
|
||||
| **A. 纯前端时间差(推荐)** | runtime 经 **SDK storage 通道**存「上次离开时间戳+资源量」,宿主侧落 localStorage;再次进入按 config 速率补发离线产出(带上限/折扣防爆数值) | ✅ 零后端改动、零新契约实体、玩家匿名口径自洽(anonId 纯客户端已拍板,鉴权七项);✅ CDP 取证保持确定性。❌ 换设备/清缓存丢进度;❌ 改本地时钟可刷产出——MVP 无排行榜/奖励兑现,无利益面,可接受 |
|
||||
| **B. 服务端持久化** | 新建玩家游戏存档表 + 读写 API + anonId/登录态绑定 | ✅ 跨设备、防作弊。❌ 需要新契约(API+DB)、玩家身份绑定(匿名 anonId 与后续登录合并的迁移问题)、QA 闭环重测被服务端状态污染;工作量约为 A 的 3-5 倍(待执行版核实),且与「真实鉴权波」强耦合 |
|
||||
|
||||
**推荐 A**,服务端存档降 P1(与真实鉴权 execution 波合并考虑)。关键支撑现状:SDK 契约已预留 `storage` 双向键值消息类型(`contracts/sdk-interface.d.ts:77`),宿主侧明确留了挂点未实现(`game-studio/src/host/GamePlayer.vue:251`「social/storage 等骨架阶段不处理(留契约挂点)」)——本波把这个挂点的 storage 分支补上即可,**存储留在宿主受信边界,runtime 内不引入可抛异常路径**(守玩家 agent 五条 AND 之④,同 M-b② 红线,`docs/agent-specs/2026-06-10-Mb渲染面-execution.md` §3.1-4)。
|
||||
|
||||
### 2.4 merge 拖拽交互可行性评估
|
||||
|
||||
**结论:可行,低风险。** 依据:
|
||||
|
||||
- 现 runtime 交互仅 `pointerdown`(`runtime/index.ts:221`);扩 `pointermove/pointerup` 跟踪是纯 Canvas 坐标计算,零 DOM、零新执行面,与 toString() 注入约束(函数体内自包含,`runtime/index.ts:13-14`)兼容。
|
||||
- 玩家 agent 已用 `CDP Input.dispatchMouseEvent` 派发成对 press/release(`player_cdp.py:566-569`);拖拽 = 在中间补 `mouseMoved` 帧,CDP 原生支持,仍是确定性脚本(非 LLM)。
|
||||
- 降级预案(提案):若执行版实测移动端拖拽体验差,同一套合成逻辑可切「点选两格合成」输入模式(仅输入层不同),CDP 策略退化为两次点击,更简单。
|
||||
|
||||
---
|
||||
|
||||
## 3. 波及面
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph 契约 contracts/
|
||||
S[templates/ 新增 3 份 schema] --- P[prompts: registry.yaml 增 3 条<br>04-config ×3 + eval Golden 集 ×3]
|
||||
end
|
||||
subgraph 前端 game-studio
|
||||
R[host/runtime/index.ts<br>新增模板分发 + 3 玩法循环 + 拖拽输入]
|
||||
ST[GamePlayer.vue/bridge<br>storage 通道挂点补实现 —— 仅 idle 需要]
|
||||
end
|
||||
subgraph 后端 game-cloud/aigc
|
||||
W[supportedTemplates 白名单加 3 项]
|
||||
L[PromptResourceLoader 单模板常量<br>→ 模板→资源映射]
|
||||
V[SchemaValidator 多 schema 缓存]
|
||||
T[getTemplateList 硬编码 1 条 → 4 条]
|
||||
end
|
||||
subgraph QA 闭环 orchestrator
|
||||
RB[run_batch 模板参数化]
|
||||
PC[player_cdp 逐模板驱动策略]
|
||||
J[judge 已通用·仅扩 Golden]
|
||||
end
|
||||
S --> R & V & PC
|
||||
P --> L & RB
|
||||
```
|
||||
|
||||
| 层 | 改动点 | 现状出处(实读核验) |
|
||||
|---|---|---|
|
||||
| 契约-模板 | 新增 `contracts/templates/{merge,idle,tycoon}.schema.json`,风格对齐 clicker(const templateId / additionalProperties:false / 数值带边界) | `clicker.schema.json:6-11` |
|
||||
| 契约-Prompt | `registry.yaml` 增 `config.{merge,idle,tycoon}-designer` 三条 + `04-config/` 三份 prompt + `eval/` 三套 Golden 集;现仅 clicker 三件套(designer/adversary/fix) | `contracts/prompts/registry.yaml:14-34` |
|
||||
| 对抗评审 | `quality.adversary-review` 正文措辞已模板中性(「当前模板机制」),但判定细则的 target 措辞与 Golden 集全部 clicker 域——需逐模板扩 Golden 守卫样本(含 kill 守卫),doctrine 是否分模板分段【待执行版核实】 | `06-quality/adversary-review.md:52,56` |
|
||||
| 前端 runtime | `runtime/index.ts` 引入按 `pkg.templateId` 分发(GamePackage 顶层必填字段,`contracts/game-package.schema.json:7,25`)+ 3 个玩法循环;theme 色系派生/生命周期/资源加载基建复用 M-b② 成果(`runtime/index.ts:88-114`);**15KB 体积门重新核算**(§5) | `runtime/index.ts:72-79,221` |
|
||||
| 前端宿主 | 仅 idle 批:storage 消息分支补实现(契约挂点已在 `bridge.ts:63`/`contract.ts:38`) | `GamePlayer.vue:251` |
|
||||
| 后端白名单 | `AigcExecutorProperties.supportedTemplates` 现 `["clicker"]`,逐批加项即开新模板;不在集合 → `failed + no_template_match` | `AigcExecutorProperties.java:86-87`、`AigcGenerateExecutor.java:315-316` |
|
||||
| 后端资源加载 | `PromptResourceLoader` 的 prompt/schema 资源路径是 clicker 单模板常量 → 需改模板→资源映射(保持「注入 LLM 文本与服务端校验同源」设计,`GameConfigSchemaValidator.java:21-22`) | `PromptResourceLoader.java:42-45` |
|
||||
| 后端模板列表 | `getTemplateList()` 硬编码返回 1 条 clicker(Create 页 canSubmit 依赖)→ 扩 4 条;`validateTemplateExists` 现仅非空兜底(TODO 注册表)→ 本波接 supportedTemplates 同源集合 | `AigcTaskServiceImpl.java:50-58,201-208` |
|
||||
| QA 编排器 | `run_batch.py` 顶部 `TEMPLATE_ID="clicker"` / `PROMPT_DESIGNER="config.clicker-designer"` 硬编码 → 参数化;`judge.py` 结构校验已通用(按 templateId 读 schema,`judge.py:159-161`);`player_cdp.py` 新增逐模板驱动策略(§2.2 表) | `run_batch.py:57-60` |
|
||||
| feed/渲染面 | 新模板各自 draw 循环入画(theme 渐变/标题基建复用);feed 卡片走 `meta.title` 链路不变,feed 不感知模板差异 | `runtime/index.ts:149-183` |
|
||||
|
||||
---
|
||||
|
||||
## 4. 关键权衡
|
||||
|
||||
1. **分批:merge 先行 vs 一波全建** → 推荐 merge 先行(§2.1,被否理由在内)。
|
||||
2. **idle 离线产出:纯前端 vs 服务端持久化** → 推荐纯前端 + SDK storage 通道(§2.3,被否理由在内)。
|
||||
3. **runtime 多模板架构:单工厂内部分发 vs 每模板独立工厂注入**:推荐**单 startRuntime 内按 templateId 分发**。理由:toString() 注入约束下最简(一份注入面、一份生命周期/遥测红线代码);theme 色系/资源加载/game_end 契约行只存在一处,杜绝 ×4 漂移;体积预算允许(§5)。被否:每模板独立 chunk/按需加载——注入机制复杂化、红线代码四份拷贝漂移风险,≤4 个模板的体量下属过度设计。
|
||||
|
||||
---
|
||||
|
||||
## 5. 风险与兼容
|
||||
|
||||
- **既有 30 款 clicker 内容池零影响(声明)**:模板分发架构下 clicker 分支保持现行为(沿 M-b②「旧包逐像素零变化」同款向后兼容铁律);生命周期事件名与 `game_end` 契约行逐字不动;验收强制含 clicker 回归(`player_cdp.py --self-test` 五条 AND 不回归,同 Mb 渲染面执行版 §5-6 口径)。
|
||||
- **dodge/runner/match「正确失败」路径保持**:三模板不进 `supportedTemplates` → 生成请求仍走 `no_template_match` 失败桶(M-b 部署 #3.1 已实证 dodge 10s 正确失败,`docs/mvp/MVP作战清单.md:47`);schema 文件原样保留供 P1 启用。
|
||||
- **新模板首批 accept 低于 80% 的预期管理**:clicker 首批 80.0% 的前提是 C1 spike 52 条种子 + 试点 6/6 + prompt 两轮升版的积累;新模板冷启动无此积累,**试产批 accept 可能落在 50-70% 区间(推断,非承诺)**。口径建议:试产批=校准批,**不计入 M2 口径、不设硬门**;M2 ≥80% 已由 clicker 达成收口(总账 §7),不受本波回退影响;每模板经 1-2 轮 prompt 升版后向 80% 量级收敛再开正式批。
|
||||
- **15KB 体积红线**:现 startRuntime(min) raw ≈2.2-2.6KB(M-b② 改后口径,红线 15,360B,`Mb渲染面-execution.md` §4);+3 个玩法循环预估 +4.5~9KB → 总计 7~12KB,红线内但 M-b② 的 4,096B 软门必须本波重设;逐批跑 measure-runtime 体积门禁【预估数待执行版实测核实】。
|
||||
- **玩家 agent 新策略的时序风险**:idle 等待型取证依赖产出速率计时、merge 拖拽依赖坐标命中——执行版须定逐模板确定性预算上限(提案:单局 ≤90s)与失败重试口径,防 infra 误判混入 accept 分母。
|
||||
- **代码注释陈旧(顺手修)**:`GameConfigSchemaValidator.java:22` 与 `AigcExecutorProperties.java:86` 注释仍写「M-c 扩 dodge/runner/match」——R4 拍板前的旧口径,本波改注释为 merge/idle/tycoon(一行注释,无逻辑改动)。
|
||||
- **runtime 对未知模板无防御(现状缺口)**:现 runtime 从不读 `templateId`,任何包都按 clicker 渲染(`runtime/index.ts:72-79` 仅消费 target/theme/scoreLabel)——生成侧被后端白名单挡住,但手工灌包会静默错渲染。本波模板分发落地时顺带补「未知 templateId → game_error」分支,堵住该缺口。
|
||||
|
||||
---
|
||||
|
||||
## 6. 验收标准(逐模板五级线,全过才算该模板 done)
|
||||
|
||||
| 级 | 验收线 | 口径 |
|
||||
|---|---|---|
|
||||
| 1 | **schema 入册** | schema 落 `contracts/templates/` + registry 注册 + 后端同源快照接入(PromptResourceLoader/Validator)+ 静态校验单测绿 |
|
||||
| 2 | **runtime 真玩通关** | staging 真实落包,玩家 agent 逐模板策略驱动,五条 AND 全绿;**clicker 回归同窗五绿不破** |
|
||||
| 3 | **QA 闭环扩展** | 对抗评审 Golden 集扩该模板(kill 守卫立得住=守卫样本全中)+ 批内查重口径覆盖 |
|
||||
| 4 | **小批量试产** | 试产 10 条量级全自动流完零 infra;accept 为校准观测值(不设硬门,见 §5 预期管理) |
|
||||
| 5 | **入 feed** | 金丝雀≤10 直发口径入 feed + 浏览器实玩截图留档(渲染面:theme 入画 + 模板玩法可见) |
|
||||
|
||||
---
|
||||
|
||||
## 7. 待拍板项(每项已带推荐)
|
||||
|
||||
| # | 拍板项 | 推荐 | 备选 |
|
||||
|---|---|---|---|
|
||||
| 1 | **分批节奏** | 两批:merge 先行收口出配方 → idle+tycoon 并行 | 一波全建(省 2-4 天,三个「第一次」叠加风险) |
|
||||
| 2 | **idle 离线产出** | 纯前端时间差 + SDK storage 通道宿主落 localStorage;服务端存档降 P1(并入鉴权波) | 服务端持久化(跨设备/防作弊,工作量 3-5 倍+耦合鉴权) |
|
||||
| 3 | **每模板试产批量与口径** | 试产 10 条=校准批不设硬门;prompt 校准后正式批 20 条按 ≥80% 量级验收 | 直接 20 条上硬门(首批大概率红,浪费批次窗口) |
|
||||
| 4 | **merge 交互模式** | 拖拽为主(CDP 可确定性派发);执行版实测移动端体验差则降级点选合成 | 直接点选合成(更稳但「合成」手感弱) |
|
||||
|
||||
### 7.1 拍板结果(创始人 2026-06-10,四项全拍,均采推荐)
|
||||
|
||||
1. 分批节奏 = **两批:merge 先行**(批① merge 单模板全链收口出「新模板接入配方」→ 批② idle+tycoon 并行复用)。
|
||||
2. idle 离线产出 = **纯前端时间差 + SDK storage 通道**(宿主落 localStorage);服务端存档降 P1 并入鉴权建设波。
|
||||
3. 试产口径 = **10 条校准批(不设硬门)+ 20 条正式批(accept ≥80% 量级)**。
|
||||
4. merge 交互 = **拖拽为主**;执行版实测移动端体验差则降级点选合成(预案已备)。
|
||||
|
||||
---
|
||||
|
||||
## 8. 下一步
|
||||
|
||||
拍板后按双 spec 铁律出 **execution 版**(`docs/agent-specs/2026-06-10-Mc模板波-execution.md`,批①批②可分文件):含逐模板完整 schema 字段定稿、prompt 三件套文案、runtime 分发实现步骤、体积门禁断言数、逐模板 CDP 策略伪码、验证门顺序与回滚路径。批① merge 收口后回填「新模板接入配方」至 `.agents/skills/`(接入步骤可复用,压批②成本)。
|
||||
179
docs/agent-specs/2026-06-10-架构文档三向审计-review.md
Normal file
179
docs/agent-specs/2026-06-10-架构文档三向审计-review.md
Normal file
@ -0,0 +1,179 @@
|
||||
# 架构文档三向审计(商业 × 产品 × 技术)· 评审版
|
||||
|
||||
> 编号 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 项部分采纳。
|
||||
447
docs/agent-specs/2026-06-10-真实鉴权与匿名玩家-execution.md
Normal file
447
docs/agent-specs/2026-06-10-真实鉴权与匿名玩家-execution.md
Normal file
@ -0,0 +1,447 @@
|
||||
# 真实鉴权与匿名玩家身份 · execution 版
|
||||
|
||||
- **文档编号**: HJ-PASSPORT-EXEC-001
|
||||
- **日期**: 2026-06-10
|
||||
- **状态**: 待主 agent 验收(评审版七项拍板已全落,见 §0)
|
||||
- **唯一设计依据**: `docs/agent-specs/2026-06-10-真实鉴权与匿名玩家-review.md`(含 §9.1 创始人七项拍板)。本文不得与其矛盾;执行中发现矛盾,停工上报,以评审版为准修订本文。
|
||||
- **读者**: 实现 agent 分工认领;主 agent 验收
|
||||
- **环境铁律**: 构建/测试一律 mini-desktop(git push→pull 同步,本机严禁 mvn/npm build);staging app 在 mini-desktop `http://100.64.0.7:48080`;批跑依赖 `Bearer test1` 的链路**零中断**(§10 保障措施);密钥只走环境变量;含中文 SQL 必须 `--default-character-set=utf8mb4`;前端验证门=`npm run build`(vue-tsc --noEmit 是假门禁,记忆 `frontend-spine-built`)。
|
||||
|
||||
---
|
||||
|
||||
## 0. 拍板前提(评审版 §9.1,七项全拍,本文全按拍板结果起草)
|
||||
|
||||
| # | 决策 | 拍板结果(本文落点) |
|
||||
|---|---|---|
|
||||
| 1 | 首发登录方式 | **C:验证码为主 + 邀请码旁路**(§5 passport 端点三件套;旁路退役开关 §5.4) |
|
||||
| 2 | 报备前激活玩家漏斗 | **是·受限激活**(邀请码注册实现,§4.2 邀请码表 + §5.2) |
|
||||
| 3 | 玩家注册 | **开放**(受限期凭邀请码;报备后 `invite-register` 退役、验证码全量) |
|
||||
| 4 | 创作/发布 | **限 A2 白名单**(`game_player.creator_flag` + PlayerApi 校验,§6.3) |
|
||||
| 5 | 游客转正 | **互动即弹一键登录**(前端 §9.4;影子账号合并不做) |
|
||||
| 6 | 实名收集 | **提现前**(`game_player` 仅预留加密字段,本件不做收集流程) |
|
||||
| 7 | 匿名身份 | **B:纯客户端 anonId + 聚合侧异常剔除**(剔除桩 §8;glossary/events.schema.json 已修订完毕,亲核 §2.4,不需再改) |
|
||||
|
||||
---
|
||||
|
||||
## 1. 目标与范围边界
|
||||
|
||||
### 1.1 目标
|
||||
|
||||
1. **种子创作者真实登录**:手机号验证码(Debug 渠道后台查码)→ 发 userType=MEMBER 真 OAuth2 token → 创作/发布全链真身份,A2 名单(~5 人)creator_flag 置位即可用。
|
||||
2. **匿名玩家零门槛**:免登刷 feed / 试玩 / 遥测(读端点 `@PermitAll` + anonId 透传),互动才弹一键登录。
|
||||
3. **邀请码旁路**:陌生玩家凭 `手机号+邀请码` 注册(零短信依赖),报备后开关退役。
|
||||
4. **身份衔接**:登录请求携带 anonId 落 `game_player.first_anon_id` + 前端登录后补发 `user_login` 遥测事件(anonId+userId 双带),1001/1 错位消除。
|
||||
5. **staging 批跑零中断**:mock(test1) 与真 token 并存;新增真 token 黄金闭环 e2e。
|
||||
|
||||
### 1.2 明确不做(继承评审版 §3,实现 agent 不得擅自扩界)
|
||||
|
||||
- 三方社交登录(微信/抖音/小程序);多租户开启(维持 `tenant.enable=false`,新表带 `tenant_id=1`);生产短信供应商采购与签名报备(A 轨闸门);防沉迷/适龄展示(v2.0);member 模块复活及其运营包袱(积分/等级/找回密码/换绑/注销)。
|
||||
- **实名收集流程不做**(仅表字段预留);**匿名影子账号+转正合并不做**(拍板 5=A)。
|
||||
- **服务端匿名票据不做**(拍板 7=B);聚合侧剔除只做**最小桩**(§8,阈值可粗暴)。
|
||||
- **生产 profile 不在本件建立**:`yudao-server/src/main/resources/` 现仅 `application-{dev,local,staging}.yaml`(实查 2026-06-10)——"生产关死 mock + test1→401 负路径"挂生产部署轨,本件只在 spec 留验收注记(§11 用例 E10)。
|
||||
- **game-admin 前端零改动**(含邀请码管理页,裁决见 §5.4)。
|
||||
- **不做** anonId 服务端校验/签名(拍板 7=B 的既定代价);不做 P-ACC-02 全功能(隐私政策仅占位文案,评审版 §3 口径声明)。
|
||||
|
||||
---
|
||||
|
||||
## 2. 代码现状亲核账(2026-06-10 逐文件实查;与评审版不符处 ⚠ 标出)
|
||||
|
||||
> 行号以 dev/2.0.0 工作区为准,漂移时以语义定位。
|
||||
|
||||
### 2.1 鉴权框架与配置
|
||||
|
||||
| 文件 | 亲核事实 | 与评审版比对 |
|
||||
|---|---|---|
|
||||
| `game-cloud/yudao-framework/yudao-spring-boot-starter-security/.../filter/TokenAuthenticationFilter.java` | :60-65 先 `buildLoginUserByToken` 查真 token、查不到才 `mockLoginUser`;:92-95 userType 不匹配抛 AccessDenied(ADMIN token 调 app-api 被拒);:110 注释"线上一定要关";:117-129 mock 实现(:118 `mockEnable` 开关、:122 `mockSecret` 前缀、:126 截后缀为 userId) | 一致 |
|
||||
| `.../config/SecurityProperties.java` | :38-40 `mockEnable` 默认 false;:44 `mockSecret` 默认 "test";:45 `permitAllUrls` 配置位 | 一致 |
|
||||
| `.../config/YudaoWebSecurityConfigurerAdapter.java` | :125-141 收集 `@PermitAll` 注解 URL 按 HttpMethod 放行 + :141 合并 `permit-all-urls` 配置——**加注解即免登,无需改安全配置类** | 评审版未展开,机制实证 |
|
||||
| `game-cloud/yudao-server/src/main/resources/application-staging.yaml` | :153 `tenant.enable: false`;:154-155 `captcha.enable: false`;:157 `mock-enable: true`;:158-159 `permit-all-urls: [/actuator/**]` | 一致(评审版引 :152-157) |
|
||||
| `yudao-server/src/main/resources/` | 仅 application-{dev,local,staging}.yaml 三份 profile,**生产 profile 未建立** | 一致 |
|
||||
|
||||
### 2.2 system 基座能力(落点依据)
|
||||
|
||||
| 文件 | 亲核事实 |
|
||||
|---|---|
|
||||
| `yudao-module-system-server/.../service/sms/SmsCodeServiceImpl.java` | :53-67 发码频控仅手机号维度(:56-59 send-frequency、:61-63 当日上限);**:65-66 按 IP 每日/每小时限制是上游 TODO**;:93-110 验码(不存在/过期/已用三态) |
|
||||
| `yudao-module-system-api/.../enums/sms/SmsSceneEnum.java` | :19 `MEMBER_LOGIN(1, "user-sms-login", "会员用户 - 手机号登陆")` 场景已内置 |
|
||||
| `yudao-module-system-server/.../controller/admin/auth/AuthController.java` | :129-135 `POST /sms-login` + :138-139 `POST /send-sms-code` 均 `@PermitAll`、:120-123 `POST /register`——**admin 侧验证码登录范式完整,passport 照此克隆** |
|
||||
| `yudao-module-system-server/.../api/oauth2/OAuth2TokenApiImpl.java` | `@RestController + @Primary`(M1 修法注释"同 PermissionApiImpl 范式");`createAccessToken(userId, userType, clientId, scopes)` user-type 无关,可直发 MEMBER token |
|
||||
| `yudao-module-system-server/.../controller/app/` | 已有 `app/dict`、`app/ip`、`app/tenant` 三个 app 端控制器目录——**system 内建 app 端控制器有既成先例** |
|
||||
| `yudao-module-system-api/.../enums/ErrorCodeConstants.java` | system 段 `1_002_***_***`,现用业务子段最大 **1_002_028**(notify send) |
|
||||
| `yudao-module-system-server/pom.xml` | :100-104 protection starter 依赖**被注释**("TODO 芋艿:暂时去掉") |
|
||||
|
||||
### 2.3 存量 app 端控制器(@PermitAll 改造面)
|
||||
|
||||
- `@PermitAll` 在 game-module-* 全部 server 代码 **0 命中**(grep 实证)——评审版 §1.3"app-api 无一处 @PermitAll"属实。
|
||||
- app 控制器 `getLoginUserId` **28 处 / 7 文件**(grep -c 实证:aigc 5 / feed 3 / project 5 / runtime 4 / studio 4 / telemetry 3 / trade 4),admin 侧 3 处 3 文件——评审版 §1.3 计数口径**完全属实**。
|
||||
- 各端点逐行清单见 §6.1/§6.2。
|
||||
- ⚠ **评审版未提的硬边界**:`contracts/db-schemas/V3.0.0__create_game_runtime.sql:94` `game_runtime_session.player_user_id BIGINT NOT NULL`——匿名开试玩会话(session/start userId=null)会撞 NOT NULL 约束(`RuntimeSessionServiceImpl.java:50 setPlayerUserId(userId)` 直落)。**V11 必须 ALTER**(§4.3),否则"匿名试玩"只是半截。
|
||||
- telemetry 侧匿名已留位:`V5.0.0__create_game_telemetry.sql:23-24` `user_id NULL` + `anon_id NOT NULL DEFAULT ''`,零改动。
|
||||
- `RuntimePackageServiceImpl.java:194-203` 预览归属校验 :198 `userId == null` 即拒——**取包端点放开后 play 场景免登、preview 场景天然兜底**,无需新代码。
|
||||
|
||||
### 2.4 拍板 7=B 的文档同步现状(亲核,不需本件再改)
|
||||
|
||||
| 文件 | 现状 |
|
||||
|---|---|
|
||||
| `.agents/knowledge/glossary.md`("DataPermission 之外的隔离"词条,约 :40) | **已修订**:免登读路径 + 纯客户端 anonId + 聚合侧剔除 + ⚠2026-06-10 显式变更声明 |
|
||||
| `contracts/events.schema.json:28` | **已修订**:"纯客户端生成的稳定匿名 ID(…身份不可信,防伪造/刷量由聚合侧…剔除兜底——2026-06-10 鉴权拍板 §9-7=B…)" |
|
||||
| ⚠ `game-module-telemetry/.../vo/EnvelopeReqVO.java:64` | **未修订**,仍写"匿名 token 派生的稳定匿名 ID"——本件回写(§15.1 给修改稿)。评审版引 :61-66,实为 UserVO :59-66、anonId 在 :64,微差如实记 |
|
||||
|
||||
### 2.5 与评审版不符处汇总(修正声明)
|
||||
|
||||
1. ⚠ **protection starter 引入面**:评审版 §5A 称"仅 yudao-server/system/bpm 引入"——实查 system pom :100-104 与 bpm pom :85 均为**注释状态**,真正生效的只有 `yudao-server/pom.xml:207`(外加 yudao-dependencies :356 的版本管理)。结论不变(game-module-* 均未依赖),但引入面表述修正为"仅 yudao-server 实际引入"。
|
||||
2. ⚠ **免登清单规模**:评审版估"约 7-10 个"——实查放行清单为 **14 个端点**(§6.1:普通读/上报 12 + ad 计费 2),评审版漏列 compliance rating 与 ad slot 拉取、session/end。
|
||||
3. ⚠ **`game_runtime_session.player_user_id NOT NULL`**:评审版未提(见 §2.3),V11 新增 ALTER。
|
||||
4. ⚠ **TelemetryEventConsumer 注释口径过时**:`TelemetryEventConsumer.java:12,:17-18` 仍写幂等键 `uk_dedup(traceId,event,ts)`,但 V10 已切 `uk_event_id` 且同步聚合实际在 `EventIngestServiceImpl`(消费者是骨架占位)。评审版 §5A 引该文件作幂等出处时口径偏旧;幂等真身=eventId(`EnvelopeReqVO.java:23-25`)。不影响结论(对变造刷量无约束依然成立),如实记录。
|
||||
5. 其余抽查(mock 过滤器顺序、staging yaml 行号、28 处/7 文件计数、SmsCodeServiceImpl :65-66、AppFeedController.interact :66 anon_id 预埋注释)**与评审版一致**。
|
||||
|
||||
---
|
||||
|
||||
## 3. 落点定稿:system 内扩展(评审版倾向项,正式采纳)
|
||||
|
||||
**结论:不建新模块 game-module-passport,在 `yudao-module-system-server` 内以独立子包 `passport` 扩展。**
|
||||
|
||||
### 3.1 依据(实证四条)
|
||||
|
||||
1. **零 RPC**:`SmsCodeService`/`SmsSendService`/`OAuth2TokenService` 均为 system-server 内部 bean——只有在 system 内才能直接 `@Resource` 注入;新模块只能走 system-api Feign + @Primary 本地化,重走 M1 装配教训(记忆 `m1-runtime-bringup-state`:CommonApi 4 处 @Primary 补丁)。
|
||||
2. **口径一致**:账号 owner=system 基座是三文档套件既定(`需求模块映射.md:237,258`,评审版已核)。
|
||||
3. **包结构先例**:system-server 已有 `controller/app/{dict,ip,tenant}`(§2.2 实证),app 端控制器落 system 不破坏既有约定。
|
||||
4. **体量不配新模块**:两张表 + 4 个 app 端点 + 3 个 admin 端点,走 game-module 黄金模板全套(三 pom/契约/错误码段/AGENTS 登记)为过度工程。
|
||||
|
||||
### 3.2 包路径(fork 侵入隔离:全部新文件收敛在 `passport` 子包,上游合并冲突面≈0,呼应评审版 R5)
|
||||
|
||||
```
|
||||
yudao-module-system-server/src/main/java/cn/iocoder/yudao/module/system/
|
||||
├── controller/app/passport/ # 新建:AppPassportController + vo/
|
||||
├── service/passport/ # 新建:PassportService(Impl)、InviteCodeService(Impl)
|
||||
├── dal/dataobject/passport/ # 新建:PlayerDO、InviteCodeDO
|
||||
└── dal/mysql/passport/ # 新建:PlayerMapper、InviteCodeMapper
|
||||
yudao-module-system-server/.../controller/admin/passport/ # 新建:邀请码管理 3 端点(§5.4)
|
||||
yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/api/passport/
|
||||
└── PlayerApi + PlayerRespDTO # 新建:跨模块创作者白名单校验(§6.3)
|
||||
```
|
||||
|
||||
### 3.3 错误码段裁决
|
||||
|
||||
落 system 段 `1_002_***_***`(模块归属决定,不占 game 业务 1-1xx 段);为避开上游 yudao 增长区(现最大 1_002_028),**取远段**:
|
||||
|
||||
- `1_002_090_***` = 玩家身份(手机号已注册/未注册/被禁用/非白名单创作被拒…)
|
||||
- `1_002_091_***` = 邀请码(无效/已停用/已过期/已耗尽/旁路已退役…)
|
||||
|
||||
登记处:`yudao-module-system-api/.../enums/ErrorCodeConstants.java` 文件尾追加(带"造梦AI passport 扩展段"中文注释,与上游段隔离)。
|
||||
|
||||
### 3.4 OAuth2 客户端与 refresh 轮换
|
||||
|
||||
- 发 token 用 `OAuth2TokenService.createAccessToken(userId, UserTypeEnum.MEMBER(1), clientId, scopes)`;clientId 取 yudao 默认客户端(推断="default",**执行时核 `system_oauth2_client` 初始数据**)。
|
||||
- refresh 7d/30d 轮换(验收 5)由 client 的 `access-token-validity/refresh-token-validity` 配置承载——**执行时核对该 client 配置并按安全基线调整**(`.agents/rules/security-and-reliability.md:15`)。
|
||||
|
||||
---
|
||||
|
||||
## 4. 数据契约:Flyway **V11.0.0**(定稿)
|
||||
|
||||
### 4.1 版本号定稿与让位关系
|
||||
|
||||
- 实查 `contracts/db-schemas/` 与执行副本 `game-cloud/yudao-server/src/main/resources/db/migration/`:**V1.0.0–V10.0.0 两处一致(diff 实证无差异),V10 已被黄金闭环占用**。
|
||||
- **本件占 V11.0.0**:`V11.0.0__create_passport_player_invite.sql`,双落点同步(契约源 + yudao-server 唯一执行副本;遵守 V10 守门②——跨模块迁移不放单模块 classpath)。
|
||||
- **让位声明**:`docs/mvp/MVP进度总账.md:94` Wave4 community/biz 曾规划 V10/V11——V10 已被 golden loop 占、V11 被本件占,**community/biz 顺延 V12/V13**(总账该行回写,§15.3)。
|
||||
|
||||
### 4.2 DDL(契约级;列注释中文、带 tenant_id=1 兼容、唯一键含 deleted 与既有表同范式)
|
||||
|
||||
```sql
|
||||
-- 玩家/创作者最小身份(拍板 6:实名字段仅预留,提现前才收集;加密=应用层 AES 落密文)
|
||||
CREATE TABLE `game_player` (
|
||||
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '玩家编号(即 OAuth2 token 的 userId,userType=MEMBER)',
|
||||
`mobile` VARCHAR(11) NOT NULL COMMENT '手机号(登录主键;日志/响应必须脱敏,库内 MVP 明文+唯一键)',
|
||||
`nickname` VARCHAR(30) NOT NULL DEFAULT '' COMMENT '昵称(注册默认生成,可改)',
|
||||
`avatar` VARCHAR(512) NOT NULL DEFAULT '' COMMENT '头像 URL',
|
||||
`status` TINYINT NOT NULL DEFAULT 0 COMMENT '状态:0正常 1禁用(CommonStatusEnum)',
|
||||
`creator_flag` TINYINT NOT NULL DEFAULT 0 COMMENT '创作者白名单位:0玩家 1创作者(A2 种子名单,拍板4;置位走 admin 端点)',
|
||||
`real_name` VARCHAR(256) NULL COMMENT '真实姓名(AES 密文预留;提现前收集,拍板6,本件不写入)',
|
||||
`id_card_no` VARCHAR(256) NULL COMMENT '身份证号(AES 密文预留;同上)',
|
||||
`register_channel` VARCHAR(16) NOT NULL DEFAULT 'sms' COMMENT '注册通道:sms验证码 / invite邀请码旁路(漏斗归因)',
|
||||
`register_ip` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '注册 IP(风控/审计)',
|
||||
`invite_code_id` BIGINT NULL COMMENT '核销的邀请码编号(invite 通道必填,关联 game_invite_code.id)',
|
||||
`first_anon_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '注册时携带的客户端 anonId(匿名↔登录归因衔接,评审版目标3)',
|
||||
`login_date` DATETIME NULL COMMENT '最近登录时间',
|
||||
-- 标准审计列(creator/create_time/updater/update_time/deleted/tenant_id,与既有 game_* 表同范式)
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_mobile` (`mobile`, `deleted`, `tenant_id`) COMMENT '手机号唯一(同 V3 uk_version 含 deleted/tenant_id 范式)'
|
||||
) COMMENT '玩家/创作者最小身份(system passport 扩展,方案乙)';
|
||||
|
||||
-- 邀请码(拍板1=C/拍板2 受限激活:生成/核销/限量/有效期/退役全生命周期)
|
||||
CREATE TABLE `game_invite_code` (
|
||||
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '编号',
|
||||
`code` VARCHAR(16) NOT NULL COMMENT '邀请码/口令(生成时随机大写字母数字,避易混淆字符)',
|
||||
`batch_no` VARCHAR(32) NOT NULL DEFAULT '' COMMENT '批次号(运营按渠道发放归因,如 batch-xhs-01)',
|
||||
`max_uses` INT NOT NULL DEFAULT 1 COMMENT '限量:最大核销次数',
|
||||
`used_count` INT NOT NULL DEFAULT 0 COMMENT '已核销次数(条件更新原子累加,见核销语义)',
|
||||
`expire_time` DATETIME NULL COMMENT '有效期(NULL=不过期)',
|
||||
`status` TINYINT NOT NULL DEFAULT 0 COMMENT '状态:0启用 1停用(停用=单码退役;全量退役走配置开关 §5.4)',
|
||||
`remark` VARCHAR(255) NOT NULL DEFAULT '' COMMENT '备注(发放对象/用途)',
|
||||
-- 标准审计列同上
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_code` (`code`, `deleted`, `tenant_id`) COMMENT '码值唯一'
|
||||
) COMMENT '邀请码(报备前玩家受限激活旁路;报备后退役,拍板1C/2)';
|
||||
|
||||
-- 匿名试玩会话兼容(§2.3 ⚠ 硬边界):player_user_id 放空 + 补 anon_id
|
||||
ALTER TABLE `game_runtime_session`
|
||||
MODIFY COLUMN `player_user_id` BIGINT NULL COMMENT '试玩玩家用户 ID(匿名试玩为空,2026-06-10 鉴权件放开;预览场景=创作者本人)',
|
||||
ADD COLUMN `anon_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '客户端 anonId(匿名会话归属;与 telemetry anon_id 同口径)';
|
||||
```
|
||||
|
||||
**核销语义(防并发超发,写明给实现 agent)**:核销与建号同一本地事务;`UPDATE game_invite_code SET used_count = used_count + 1 WHERE id = ? AND status = 0 AND used_count < max_uses AND (expire_time IS NULL OR expire_time > NOW())`,affected=0 即核销失败(耗尽/停用/过期分支由前置查询给精确错误码,条件更新做最终一致兜底)。
|
||||
|
||||
### 4.3 V3 既有数据兼容
|
||||
|
||||
`game_runtime_session` 存量行 player_user_id 均有值(mock 喂 1),MODIFY 放宽 NULL 不破坏存量;anon_id DEFAULT '' 兼容。Flyway 纪律:V11 合入后禁改,回滚写补偿迁移 V11.0.1(§13)。
|
||||
|
||||
---
|
||||
|
||||
## 5. 契约先行:新增 `contracts/api-schemas/passport.yaml`
|
||||
|
||||
> 风格对齐 feed.yaml(openapi 3.0.3 + 头部中文契约注释 + CommonResult 信封 + 错误码段声明 1-002-090/091)。**契约先合入,再动代码**(工作协议 §6)。
|
||||
|
||||
### 5.1 app 端(产品端 game-studio,全部 `@PermitAll` 或登录态,见处置列)
|
||||
|
||||
| 端点 | 方法 | 鉴权 | 请求 → 响应(要点) |
|
||||
|---|---|---|---|
|
||||
| `/app-api/passport/send-sms-code` | POST | `@PermitAll`(R6 安全前置绑定 §7) | `{mobile}` → `Boolean`。场景固定 `SmsSceneEnum.MEMBER_LOGIN(1)`;种子期走 Debug 渠道(码落 `system_sms_code` 表,运营后台查码);**响应不区分手机号是否已注册**(防枚举) |
|
||||
| `/app-api/passport/sms-login` | POST | `@PermitAll` | `{mobile, code, anonId?}` → `{userId, accessToken, refreshToken, expiresTime, nickname, creatorFlag}`。已注册→登录;未注册→**自动注册**(register_channel=sms)+ 登录一体(验证码即占有证明);anonId 落 first_anon_id(仅注册时写一次) |
|
||||
| `/app-api/passport/invite-register` | POST | `@PermitAll`,受退役开关(§5.4) | `{mobile, inviteCode, anonId?, nickname?}` → 同上响应。零短信依赖(拍板 1C);核销语义 §4.2;手机号已注册→提示直接验证码登录(错误码 1-002-090-xxx);开关关闭→旁路已退役错误码 |
|
||||
| `/app-api/passport/me` | GET | 登录态(不加 @PermitAll) | → `{userId, mobile(脱敏 138****0000), nickname, avatar, creatorFlag}`。前端守卫/白名单 UI 依据 |
|
||||
|
||||
**响应安全基线**:日志与响应手机号一律脱敏;token 不落日志(验收 5)。
|
||||
|
||||
### 5.2 admin 端(邀请码管理,RBAC 权限位 `system:passport-invite:*`)
|
||||
|
||||
| 端点 | 方法 | 说明 |
|
||||
|---|---|---|
|
||||
| `/admin-api/passport/invite-code/generate` | POST | `{count≤100, maxUses, expireTime?, batchNo?, remark?}` → 码值列表(随机生成,uk_code 冲突重试) |
|
||||
| `/admin-api/passport/invite-code/page` | GET | 分页查(batchNo/status 过滤;含 used_count 核销进度) |
|
||||
| `/admin-api/passport/invite-code/disable` | PUT | 单码停用(status=1) |
|
||||
| `/admin-api/passport/player/set-creator` | PUT | `{userId, creatorFlag}`——A2 白名单置位入口(拍板 4 的运营动作落点) |
|
||||
|
||||
### 5.3 邀请码管理端裁决:**给 admin-api 端点,不建 game-admin 页面**
|
||||
|
||||
理由:①邀请码是报备前临时旁路(拍板 1C "报备后旁路自然退役"),为退役机制建 Vue 页面(game-admin `views/wanxiang/` 现仅 adSlot/dashboard/featured/review/withdraw 五目录)属一次性投入;②运营动作低频(生成几批、查核销、停用),staging/生产经 Knife4j(`/doc.html`)或脚本调用 admin-api 即可,RBAC 权限位照常管控(信任边界在后端,不依赖前端);③若报备拖期超 1 个月再评是否补页面(显式 backlog,不在本件)。
|
||||
|
||||
### 5.4 旁路退役开关
|
||||
|
||||
`yudao-server` yaml 新增 `wanxiang.passport.invite-register-enabled: true`(staging)——关闭后 `invite-register` 返回"旁路已退役"错误码。退役是一次性事件,配置发布可接受,不做动态配置(最小变更)。生产 profile 建立时默认按报备状态配置(部署轨注记)。
|
||||
|
||||
---
|
||||
|
||||
## 6. 存量后端改动清单
|
||||
|
||||
### 6.1 `@PermitAll` 放行清单(**14 个端点,逐一实读核验**;改法=方法上加 `@jakarta.annotation.security.PermitAll` + 类 javadoc 鉴权口径同步改,每处 1-2 行)
|
||||
|
||||
| # | 端点 | file:line(控制器实读) | 处置与备注 |
|
||||
|---|---|---|---|
|
||||
| 1 | GET `/app-api/feed/stream` | `game-module-feed/.../AppFeedController.java:42-48` | 放行。:46 getLoginUserId 已可空(互动态恒 false),零逻辑改动 |
|
||||
| 2 | GET `/app-api/feed/zones` | 同上 `:50-54` | 放行。无 userId 依赖 |
|
||||
| 3 | GET `/app-api/feed/zone/stream` | 同上 `:56-61` | 放行。同 #1 |
|
||||
| 4 | GET `/app-api/feed/share/{gameId}` | 同上 `:71-77` | 放行。分享落地页 OG(玩家漏斗入口) |
|
||||
| 5 | GET `/app-api/runtime/package/{versionId}` | `game-module-runtime/.../AppRuntimeController.java:57-69` | 放行。play 场景门禁在 Service(status 权威判定);preview 场景 `RuntimePackageServiceImpl.java:198` userId=null 即拒,匿名不可越权预览,零新代码 |
|
||||
| 6 | GET `/app-api/runtime/package/{versionId}/manifest` | 同上 `:71-91` | 放行。与 #5 同源门禁(:82 复用 getPackageManifest) |
|
||||
| 7 | POST `/app-api/runtime/session/start` | 同上 `:93-106` | 放行 + **依赖 V11 ALTER(§4.2)**:`SessionStartReqVO`(现 5 字段 :22-38)增 `anonId` 可选字段;`RuntimeSessionServiceImpl.java:50` 兼容 userId=null 落 anon_id |
|
||||
| 8 | POST `/app-api/runtime/session/end` | 同上 `:108-114` | 放行。幂等收口,匿名会话同链路 |
|
||||
| 9 | POST `/app-api/telemetry/events/batch` | `game-module-telemetry/.../AppTelemetryController.java:39-45` | 放行。:42 注释已declare匿名合法;信封 anonId 已留位(V5:24) |
|
||||
| 10 | POST `/app-api/telemetry/perf/beacon` | 同上 `:47-52` | 放行。sendBeacon 兜底通道 |
|
||||
| 11 | GET `/app-api/compliance/rating/get` | `game-module-compliance/.../ComplianceRatingController.java:37-45` | 放行。只读分级,无 userId(评审版清单未列,补入) |
|
||||
| 12 | GET `/app-api/ad/slot/list-enabled` | `game-module-ad/.../AdController.java:45-51` | 放行。拉配置非计费 |
|
||||
| 13 | POST `/app-api/ad/report/impression` | 同上 `:53-57` | **计费链裁决:放行**(裁决与条件见 §6.2) |
|
||||
| 14 | POST `/app-api/ad/report/reward` | 同上 `:59-63` | **计费链裁决:放行**(同上) |
|
||||
|
||||
**不放行(保持强制登录,零改动)**:feed interact(`AppFeedController.java:63-69`,转化点,拍板 5);studio 全部(`AppStudioController.java:44-79`);aigc 全部(`AppAigcTaskController.java:44-88`);project 全部(`AppProjectController.java:42-81`);trade 全部(`TradeController.java:55-82`)。admin 侧 3 文件(AdminProjectController/ComplianceBanController/TradeAdminController)自 M1 有真实登录,不在面内。
|
||||
|
||||
### 6.2 广告曝光端点裁决(评审版 §5A 留给本执行版的单独评审项)
|
||||
|
||||
**裁决:#13/#14 进免登清单,绑定三个并行条件,缺一不得合入。**
|
||||
|
||||
理由:①匿名玩家是种子期主要流量,曝光端点不免登 = 匿名场景广告曝光全丢 = 变现链路与分成数据在最大流量面上断(与目标 2 冲突);②当前计费为 **mock eCPM**(`AdController.java:54` "mock 算 eCPM 收入落台账"实证),伪造曝光污染的是 mock 台账与 quality 信号,**尚不直接动真金**——真接广告联盟前另有对账闸门;③拍板 7=B 已确认"聚合侧剔除"为既定兜底路径。
|
||||
|
||||
绑定条件:
|
||||
1. **限频**:两端点加 `@RateLimiter`(IP 维度 keyResolver),依赖 §7.2 的 ad pom 补齐;
|
||||
2. **幂等已有**:reportImpression/reward 幂等键=traceId(`AdController.java:54,:60` 注释实证),保持;
|
||||
3. **剔除桩覆盖**:§8 telemetry 最小桩的异常名单输出必须**同时标注 ad 计费事件**(ad 反作弊正式项 owner=compliance,列 `技术架构与模块.md` 技术项 backlog,§15.2——本件只挂桩不建正式反作弊)。
|
||||
|
||||
### 6.3 创作/发布 A2 白名单校验(拍板 4 的可信边界落点)
|
||||
|
||||
前端守卫挡不住直连 API,**必须后端校验**。复用本仓既有跨模块范式(telemetry→FeedApi:`EventIngestServiceImpl.java:86,:195-201` Feign+@Primary 本地化实证):
|
||||
|
||||
- 新增 `system-api` 的 `PlayerApi#validateCreator(userId)`(@FeignClient primary=false + system-server 内 `PlayerApiImpl` @RestController @Primary,照 OAuth2TokenApiImpl 范式)——非 creator_flag=1 抛 `1_002_090_***`"创作功能限内测白名单"。
|
||||
- **校验挂点(5 个创作写入口的 Service 入层)**:studio 建草稿/提交生成(`AppStudioController.java:50,:58` 对应 Service)、aigc 直发生成(`AppAigcTaskController.java:50`)、project 创建/提交发布(`AppProjectController.java:50,:76`)。读自己任务/项目的端点不拦(已有归属过滤)。
|
||||
- pom 改动:game-module-{studio,aigc,project}-server 增 `yudao-module-system-api` 依赖(实查三者现均未依赖 system-api)。
|
||||
- mock 兼容:staging test1→userId=1 无 game_player 行——**白名单校验在 mock 身份下放行**(按"game_player 无此行 + mock-enable=true → 放行"或 staging 配置白名单豁免 userId=1,执行时择一实现并在中文注释写明),保证批跑(生成 QA 闭环走 studio/aigc 链)零中断(§10)。
|
||||
|
||||
### 6.4 anonId 入参原则
|
||||
|
||||
仅"数据归属需要"才加:session/start(§6.1#7 VO 加字段)+ passport 登录注册(§5.1)。feed 流/分享/取包/分级**不加** anonId 入参(服务端无归属诉求,MVP 无个性化),telemetry 信封已带——避免无消费方的橱窗参数(反孤儿设计)。
|
||||
|
||||
---
|
||||
|
||||
## 7. R6 切渠道安全前置(与"切真实短信渠道"绑定排期,不可省)
|
||||
|
||||
### 7.1 现状(亲核)
|
||||
|
||||
- 发码频控仅手机号维度;**按 IP 每日/每小时为上游 TODO**(`SmsCodeServiceImpl.java:65-66`)。
|
||||
- staging `captcha.enable: false`(`application-staging.yaml:154-155`)。
|
||||
- `@RateLimiter` 所在 `yudao-spring-boot-starter-protection`:**仅 `yudao-server/pom.xml:207` 实际引入**;system/bpm 为注释(§2.5 修正);game-module-* 全无。
|
||||
|
||||
### 7.2 交付项
|
||||
|
||||
| 项 | 落点 | 时序 |
|
||||
|---|---|---|
|
||||
| pom 补依赖 | `yudao-module-system-server/pom.xml`(取消 :100-104 注释或重写依赖块;passport 发码端点用)+ `game-module-ad-server/pom.xml`(§6.2 条件 1) | 本件内 |
|
||||
| 发码端点限频 | `/app-api/passport/send-sms-code` 加 `@RateLimiter`(IP keyResolver,阈值建议 10 次/小时/IP,**推断值**,执行时与运营确认);手机号维度频控复用 SmsCodeProperties 既有 | 本件内(种子期 Debug 渠道+白名单下风险≈0,提前落不伤) |
|
||||
| 图形验证码开关 | 确认 `yudao.captcha.enable` 一键启用路径对 passport 发码生效(admin AuthController 已有 captcha 集成范式;app 端发码是否接同一 captcha 校验**执行时核**,不通则在 passport 发码前置 captcha 校验补齐) | 切真实渠道前必须验证可用 |
|
||||
| IP 每日/每小时上限 | 在 passport 发码 Service 入层补(不改上游 SmsCodeServiceImpl,避免 fork 侵入;以 Redis 计数实现,复用既有 redis starter) | 切渠道前 |
|
||||
|
||||
**纪律**:切渠道 = 配置切换 + 上表后两项验证通过,二者绑定,不得只切配置。
|
||||
|
||||
---
|
||||
|
||||
## 8. §5A 聚合侧剔除最小桩(owner=telemetry)
|
||||
|
||||
**边界先立、桩可粗暴**(拍板 7=B 的配套义务):
|
||||
|
||||
- **落点**:`game-module-telemetry-server` 新增 `service/quality/AnomalyFilterService`(名称执行时可调,包归 telemetry),挂在 `EventIngestServiceImpl` 聚合链(:153 ingestOne 的 engagement 闸门处,:183-205 quality 重算前)。
|
||||
- **最小实现边界(本件只做这么多)**:按 `anonId` 与 `register_ip/请求 IP` 维度做**滑动窗口计数**(Redis),单 anonId/单 IP 对同一 gameId 的 engagement 事件超阈值(**粗暴初值:100 次/小时,推断**,可配置)→ 该批事件**照常落库**(原始数据保真)但**不进聚合/不触发 quality 重算**,中文日志记剔除原因(可审计)。
|
||||
- **接口先立**:`AnomalyFilterService#shouldExclude(envelope, ip): boolean` + 剔除计数指标日志——ad 反作弊(owner=compliance)后续接同一判定输出(§6.2 条件 3)。
|
||||
- **不做**:离线回溯重算、设备指纹、模型识别(v2.0;`技术架构与模块.md` 补技术项后排期)。
|
||||
|
||||
---
|
||||
|
||||
## 9. 前端改动(game-studio)
|
||||
|
||||
### 9.1 登录页(新增 `src/views/login/Login.vue`,Vant)
|
||||
|
||||
- 两 Tab:①手机号+验证码(主路径,调 send-sms-code/sms-login);②邀请码注册(mobile+inviteCode,调 invite-register;**受限激活期的陌生玩家入口**,页内文案注明"内测邀请")。
|
||||
- 隐私政策/用户协议**占位文案**勾选(评审版 §3 口径声明:P-ACC-02 占位提前,正式文案挂 A 轨法务)。
|
||||
- 携带 `useUserStore().anonId` 入参(身份衔接);支持 `?redirect=` 回跳。
|
||||
|
||||
### 9.2 store/user.ts(实读挂点确认)
|
||||
|
||||
- `setLogin`(`store/user.ts:44-49` 已预留):登录成功调用,**新增 token/userId 落 localStorage 持久化**(现纯内存,刷新即丢);`logout`(:52-57)同步清。
|
||||
- token 初值优先级改造(:27-28):`localStorage 真 token > VITE_STUDIO_TOKEN(env) > 'mock-studio-token'`——**env=test1 的批跑路径原样保留**(§10)。
|
||||
- 新增 `isRealLogin()`:仅 localStorage 真 token 视为真实登录(现 `isLogin()` :38-41 因 token 永有值恒 true,**不可用作守卫**——实读发现,评审版未提);守卫与互动弹窗一律用 `isRealLogin()`。staging 批跑/agent 不受影响(不走守卫的 UI 路径或 env token 直连 API)。
|
||||
- userId 固定 '1001'(:30):真实登录后由 setLogin 覆盖为登录响应 userId,1001/1 错位在真实路径消除(mock 路径维持现状,评审版 R4)。
|
||||
|
||||
### 9.3 路由守卫(`src/router/index.ts`,现无 beforeEach,:95-102 实证)
|
||||
|
||||
- 新增 route `/login`;
|
||||
- meta 增 `requiresAuth: true`:`/create`、`/create/task/:taskId`、`/create/preview/:versionId`(:46-66)、`/project*` 三条(:68-88);
|
||||
- `router.beforeEach`:requiresAuth 且 `!isRealLogin()` → `/login?redirect=`;**feed/play/share 与 /login 放行**(:17-44 玩家区零门槛)。
|
||||
|
||||
### 9.4 401 统一拦截与互动转正
|
||||
|
||||
- `src/api/request.ts` 响应错误分支(:101-109 现无 401 处理,实证):补 `error.response?.status === 401` 与业务包络 `code === 401` → 清登录态 + Toast + 跳 `/login?redirect=当前路由`。
|
||||
- 互动即弹一键登录(拍板 5):`views/feed/Feed.vue` 互动入口(:139-167 `onInteract/onShare/onReport` → `feedStore.interact`)前置 `isRealLogin()` 判定,未登录弹 Vant Dialog 引导跳登录(不直接发请求吃 401,体验优先;401 拦截作兜底)。
|
||||
- 新增 `src/api/passport.ts`(4 端点封装,复用 request 信封解包)。
|
||||
|
||||
### 9.5 遥测衔接
|
||||
|
||||
登录成功补发 `user_login` 事件(buildEnvelope 双带 userId+anonId,`telemetry/index.ts:137-169` 机制现成)——**前置**:`contracts/events.schema.json` eventRegistry 登记 `user_login`(契约先行;未登记会被入口轻量校验计 rejected——`EnvelopeReqVO.java:27` 实证)。
|
||||
|
||||
---
|
||||
|
||||
## 10. staging/mock 并存与批跑零中断保障
|
||||
|
||||
| 机制 | 出处/措施 |
|
||||
|---|---|
|
||||
| 真 token 优先、mock 兜底 | `TokenAuthenticationFilter.java:60-65`(先查 OAuth2 token,:63-65 查不到才 mock)——**框架原生并存,无需任何开关切换** |
|
||||
| staging 保持 `mock-enable: true` | `application-staging.yaml:157` 不动;`.env.staging:5 VITE_STUDIO_TOKEN=test1` 不动 |
|
||||
| 批跑路径回归 | 黄金闭环 e2e/生成 QA 闭环全依赖 `Bearer test1`(记忆 `golden-loop-b1-done`):①@PermitAll 只放宽不收紧,test1 请求行为不变;②白名单校验 mock 豁免(§6.3);③合入后**先跑一轮既有批跑冒烟再宣并存成立**(验收 §11 E8) |
|
||||
| 新增真 token 黄金闭环 e2e | §11 E1:与 test1 批跑在同一 staging 并行各跑一遍,互不干扰即证并存 |
|
||||
| 生产关死 mock | `mock-enable=false` + `mockSecret` 随机化(`SecurityProperties.java:44` 默认 "test" 必须改)——挂生产部署轨(§1.2),本件在部署清单文档留注记 |
|
||||
|
||||
---
|
||||
|
||||
## 11. e2e 用例与验收(评审版 §8 六条展开;staging=mini-desktop,浏览器用例走既有 CDP 配方)
|
||||
|
||||
| # | 用例 | 步骤要点 | 通过判据 |
|
||||
|---|---|---|---|
|
||||
| E1 | 真 token 创作者全链(验收 1) | A2 名单手机号 → send-sms-code(Debug 渠道,admin 查 `system_sms_code` 取码)→ sms-login 得真 token → 创作 → 发布 → admin 审核 → feed 可见 | 全程请求头无 test1(抓包/日志证据);game_project.creator_user_id=真实 userId |
|
||||
| E2 | 匿名零门槛(验收 2) | 无任何 token:GET feed/stream、zone、share、runtime package+manifest、POST session/start+end、telemetry batch、ad slot/list-enabled、compliance rating | 全部 200;`game_telemetry_event.anon_id` 落库非空;`game_runtime_session` 行 player_user_id=NULL+anon_id 非空 |
|
||||
| E3 | 互动触发登录(验收 2/拍板 5) | 匿名点赞 → 前端弹登录引导;绕前端直 POST feed/interact 无 token | 前端弹窗;直连返回 401(信任边界在后端) |
|
||||
| E4 | 邀请码注册(拍板 1C/2/3) | admin generate 邀请码 → 陌生手机号+码 invite-register → 得 token → 点赞成功 | game_player 行 register_channel=invite、invite_code_id 关联、used_count+1 |
|
||||
| E5 | 负路径·无邀请码陌生玩家 | 未注册手机号直接 sms-login?→ 走验证码自动注册(开放注册,拍板 3);**invite-register 用无效/耗尽/过期/停用码** | 四种码各返回对应 1-002-091 错误码;耗尽并发双发只成功 max_uses 次(§4.2 条件更新) |
|
||||
| E6 | 负路径·非白名单创作被拒(拍板 4) | E4 注册的玩家真 token POST studio 草稿 / aigc generate / project 创建+发布 | 均返回 1-002-090 白名单错误码;A2 创作者(set-creator 置位后)同端点成功 |
|
||||
| E7 | 身份衔接(验收 3) | 同浏览器:匿名刷 feed(anonId=X)→ 登录携带 X → 互动 | game_player.first_anon_id=X;`user_login` 事件 user 双带;互动落库 userId=真实 ID(1001/1 错位消除) |
|
||||
| E8 | mock 并存(验收 4 前半) | 改动合入后原样重跑既有批跑冒烟(test1) | 既有黄金闭环/生成 QA 链零失败 |
|
||||
| E9 | 旁路退役开关 | staging 临时置 `invite-register-enabled=false` 重验 invite-register | 返回"旁路已退役"错误码;验后恢复 true |
|
||||
| E10 | 生产负路径(验收 4 后半) | **挂生产部署轨**:生产 profile `mock-enable=false`+随机 mockSecret 后实测 `Bearer test1` | →401。**生产 profile 未建立(§2.1 实证),本件不验,部署落地后补测**,不阻塞其余验收 |
|
||||
| E11 | 安全基线抽查(验收 5) | 日志 grep 手机号/token;refresh 配置核对;登录页占位协议展示 | 日志脱敏;refresh 7d/30d 生效(§3.4 执行时核);协议占位可见 |
|
||||
| E12 | 运营不回归(验收 6) | game-admin 原生登录 + 审核链冒烟 | 通过(admin 零改动,冒烟即可) |
|
||||
| E13 | 剔除桩冒烟(§8) | 脚本以单 anonId 高频灌 engagement 事件超阈值 | 原始事件照落、聚合不动、quality 不被刷动、剔除日志可见 |
|
||||
|
||||
---
|
||||
|
||||
## 12. 边界失败路径(实现 agent 必须显式处理 + 中文日志)
|
||||
|
||||
| 场景 | 处置 |
|
||||
|---|---|
|
||||
| 短信通道失败(Debug 渠道落库失败 / 将来真实渠道超时) | sendSingleSms 异常 → 发码端点返回明确错误码(不吞);验证码未落库不计发送频次;切真实渠道后通道超时按既有 SmsSendService 异步链路兜底(执行时核对其重试语义,不另造) |
|
||||
| 邀请码耗尽/并发核销 | §4.2 条件更新,affected=0 → 核销失败错误码;建号事务整体回滚(无半成品 game_player 行) |
|
||||
| 转正时 anonId 缺失 | anonId 为可选入参:缺失→first_anon_id 落 '',登录正常完成(归因降级不阻断登录);前端 ensureAnonId 已有 localStorage 不可用退化路径(`store/user.ts:20-23`) |
|
||||
| 同手机号重复注册竞态 | uk_mobile 唯一键兜底:插入冲突 → 转登录语义或返回"已注册"错误码(与 §5.1 防枚举口径协调:sms-login 路径静默转登录;invite-register 路径明确报已注册) |
|
||||
| token 校验链异常 | 框架既有:`buildLoginUserByToken` ServiceException → null(`TokenAuthenticationFilter.java:101-104`),免登端点照常匿名通过、登录端点 401——不改框架 |
|
||||
| 匿名 session 收口失败 | session/end 幂等(`AppRuntimeController.java:109` 注释实证),sendBeacon 兜底不变 |
|
||||
| 剔除桩 Redis 不可用 | 降级放行(聚合照常)+ WARN 日志——桩失效不可阻断遥测主链 |
|
||||
|
||||
---
|
||||
|
||||
## 13. 回滚策略
|
||||
|
||||
- **代码回滚**:passport 全部新文件收敛在独立子包(§3.2),revert 提交即净退;存量改动仅"@PermitAll 注解 + VO 字段 + Service 白名单挂点",逐文件 revert 无连带。
|
||||
- **DB 回滚**:Flyway 纪律 V11 合入后禁改——回滚写补偿迁移 `V11.0.1`(DROP 两新表 + game_runtime_session 还原 NOT NULL 前须确认无 NULL 行;anon_id 列可留存不删,无害)。
|
||||
- **行为回滚(不动代码)**:邀请码旁路=配置开关关(§5.4);mock 并存本身零切换风险(staging 配置未动);@PermitAll 若需紧急收口,可单独 revert 注解提交(前端匿名路径同步降级为弹登录,feed 浏览回到 test1 形态)。
|
||||
- **批跑兜底**:E8 失败 → 立即回滚白名单挂点提交(最可能破坏点),其余改动可保留排查。
|
||||
|
||||
---
|
||||
|
||||
## 14. 完成条件(全部满足才可宣称收口)
|
||||
|
||||
1. `contracts/api-schemas/passport.yaml` + `contracts/db-schemas/V11.0.0__*.sql` + `events.schema.json` 登记 `user_login` 合入(契约先行);
|
||||
2. 后端:passport 4+4 端点上线 staging;14 端点 @PermitAll 生效;白名单校验 5 挂点生效;V11 迁移绿(Flyway 历史无校验失败);
|
||||
3. 前端:登录页/守卫/401 拦截/邀请码入口合入,`npm run build` 绿;
|
||||
4. §11 用例 E1–E9、E11–E13 全过且留证据(E10 留部署轨注记);
|
||||
5. 单测:核销并发/白名单校验/发码频控 三类最小单测绿(mini-desktop `mvn test`);
|
||||
6. 文档回写(§15)完成 + `docs/mvp/MVP进度总账.md` 登记本件收口;
|
||||
7. R6 安全前置中"本件内"两项落地(§7.2),"切渠道前"两项列入 A 轨闸门看板备注。
|
||||
|
||||
---
|
||||
|
||||
## 15. 文档回写清单(收口时执行)
|
||||
|
||||
### 15.1 `EnvelopeReqVO.java:64` anonId javadoc(修改稿,照抄)
|
||||
|
||||
现文案:`@Schema(description = "匿名 token 派生的稳定匿名 ID", example = "anon-xyz")`
|
||||
改为:`@Schema(description = "纯客户端生成的稳定匿名 ID(localStorage 持久化;身份不可信,防伪造/刷量由聚合侧按 anonId/IP 异常剔除兜底——2026-06-10 鉴权拍板 §9-7=B,取代旧'匿名 token 派生'机制)", example = "anon-xyz")`
|
||||
(与 `contracts/events.schema.json:28` 已修订文案逐字对齐,#5 为单一事实源。)
|
||||
|
||||
### 15.2 `docs/architecture/技术架构与模块.md`:补"广告曝光反作弊"技术项(owner=compliance,**只列清单不代改正文设计**)——内容=曝光/激励计费事件的异常剔除与对账闸门,MVP 形态=消费 telemetry 剔除桩判定输出(§6.2/§8),真接广告联盟前升级为正式项。
|
||||
|
||||
### 15.3 `docs/mvp/MVP进度总账.md:94`:Wave4 community/biz Flyway 规划 V10/V11 → **V12/V13**(让位声明 §4.1)。
|
||||
|
||||
### 15.4 `.agents/` distillation:鉴权落点/邀请码机制/mock 并存配方写回 `knowledge/tech-decisions.md` 或新条目(收口时按 §7 协议判重)。
|
||||
|
||||
### 15.5 无需回写(亲核已完成):`glossary.md` 匿名条目、`contracts/events.schema.json` anonId 描述(§2.4)。
|
||||
|
||||
---
|
||||
|
||||
## 16. 推断/待执行时定项(主 agent 知悉)
|
||||
|
||||
| # | 项 | 性质 |
|
||||
|---|---|---|
|
||||
| 1 | OAuth2 clientId="default" 及 refresh 7d/30d 的 client 配置值 | 推断,执行时核 `system_oauth2_client` 初始数据(§3.4) |
|
||||
| 2 | 发码 IP 限频阈值(10 次/小时/IP)与剔除桩阈值(100 次/小时) | 推断初值,可配置,执行时与运营确认(§7.2/§8) |
|
||||
| 3 | `yudao.captcha.enable` 对 app 端 passport 发码是否原生生效 | 待执行时核(admin 端集成已实证,app 端路径未核),不通则补前置校验(§7.2) |
|
||||
| 4 | 白名单校验的 mock 豁免实现形态(无行放行 vs 配置豁免 userId=1) | 执行时择一,铁律=批跑零中断(§6.3) |
|
||||
| 5 | Debug 短信渠道在 staging 的 `system_sms_channel` 配置现状 | 待执行时核 DB(渠道为 DB 配置非 yaml;5 渠道客户端代码已实证存在) |
|
||||
| 6 | SmsSendService 真实渠道超时/重试语义 | 切渠道前核对(§12),本件不动 |
|
||||
| 7 | 体量估算 3-5 个有效工作日 | 沿用评审版推断,以实际排期为准 |
|
||||
|
||||
---
|
||||
|
||||
*所有 file:line 均为 2026-06-10 本仓实读核验;与评审版不符处已在 §2.5 如实修正。下游:实现 agent 按 §4→§5→§6/§7/§8→§9 顺序认领(契约先行),主 agent 按 §11/§14 验收。*
|
||||
@ -1,7 +1,7 @@
|
||||
# 真实鉴权与匿名玩家身份 — 评审版(创始人拍板用)
|
||||
|
||||
> 文档类型:Review(结论先行,供拍板;定稿后另出 execution 版)
|
||||
> 日期:2026-06-10 | 状态:待创始人拍板 | 作者:架构 Agent
|
||||
> 日期:2026-06-10 | 状态:**✅ 已拍板(2026-06-10 创始人七项全拍,结果见 §9.1)→ 待出 execution 版排建设(建议 M-b 之后)** | 作者:架构 Agent
|
||||
> 关联:`docs/agent-specs/2026-06-09-下一阶段路线-plan.md:79`("真实鉴权…建显式 backlog"——本文即该 backlog 落实);A 轨种子名单(A2)到位即卡此件
|
||||
> 修订记录:2026-06-10 双镜头评审(CEO+Eng)11 条意见**全部采纳**落稿——①拆准入拍板项(玩家注册 vs 创作白名单)并在漏斗图标明非白名单去向;②如实摊开"报备前玩家侧注册转化不可用"时序阻塞+短信报备今天进 A 轨闸门看板;③登录方式选项补全 B 权衡并增 C 混合项;④依赖改两级(短信=硬闸门/隐私文案=软前置)+P-ACC-02 口径调整声明;⑤⑨"与 glossary 完全对齐"改为显式变更声明;⑥保留期降为既定假设;⑦新增 §5A 匿名身份安全边界(伪造/刷量/bot 排除三联);⑧新增 R6 发码端点滥用;⑩计数口径修为 app 28 处/7 文件;⑪生产 profile 未建立注记;⑫平迁断言标注推断。意见原文核验:所有代码/文档引用均经本仓复读证实。
|
||||
|
||||
@ -196,6 +196,20 @@ flowchart LR
|
||||
| 6 | **创作者实名收集时点** | A=提现前(**建议**:注册零摩擦,与支付进件闸门对齐);B=注册即收(合规最保守,但伤种子转化) |
|
||||
| 7 | **匿名身份机制**(安全边界,详见 §5A) | A=服务端签发签名匿名设备票据(身份可信、可限频可撤销,贴合 glossary 原意向;+1–2 天);B=纯客户端 anonId+聚合侧异常剔除(**建议种子期**:实现最薄、前端零改动;代价=身份不可信、靠事后剔除兜底,并接受 §5-1 的 glossary 变更声明) |
|
||||
|
||||
### 9.1 拍板结果(创始人 2026-06-10,七项全拍,均采推荐项)
|
||||
|
||||
| # | 决策 | 拍板结果 |
|
||||
|---|---|---|
|
||||
| 1 | 首发登录方式 | **C:验证码为主 + 邀请码旁路**(创作者走验证码 Debug 通道;陌生玩家凭邀请码/口令注册零短信依赖;短信报备完成后旁路自然退役、全量切验证码) |
|
||||
| 2 | 报备前是否激活玩家转化漏斗 | **是·受限激活**(邀请码旁路实现,与审计 R2「自有端=邀请制内测」定性自洽,提前拿「分享→转化」漏斗数据) |
|
||||
| 3 | 玩家注册是否开放 | **开放注册**(受限激活期体现为凭邀请码注册;报备落地后转全开放,漏斗第一跳不断) |
|
||||
| 4 | 创作/发布是否限白名单 | **限 A2 白名单**(内容上架风险收口在 ~5 个已知种子创作者) |
|
||||
| 5 | 游客转正机制 | **互动即弹一键登录**(影子账号+转正合并留 v2.0 再评) |
|
||||
| 6 | 创作者实名收集时点 | **提现前收**(注册只收手机号,与支付进件/LLM 实名闸门节奏对齐) |
|
||||
| 7 | 匿名身份机制 | **B:纯客户端 anonId + 聚合侧异常剔除**(种子期最小桩,owner=telemetry;接受 §5-1 glossary 显式变更声明——glossary/contracts 描述已同步修订;广告曝光是否进免登清单留执行版单独评审) |
|
||||
|
||||
> 执行版待办(出 execution 版时落):邀请码旁路的发码/核销机制与退役开关、`passport.yaml` 契约、Flyway 版本、R6 切渠道安全前置、§5A 聚合侧剔除最小桩 + protection starter 依赖、`EnvelopeReqVO` anonId 注释同步。
|
||||
|
||||
---
|
||||
|
||||
*出处均为本仓实读核验(2026-06-10);体量与"+1–2 天"类估算为推断,以执行版排期为准。下一步:拍板后出 execution 版(含落点定稿/端点清单/Flyway 版本/e2e 用例/§5A 聚合侧剔除最小桩与 protection starter 依赖补齐/R6 切渠道安全前置),并同步回写文档:`glossary.md:40` 匿名条目、`contracts/events.schema.json` 与 `EnvelopeReqVO` 的 anonId 描述(若 §9-7 拍 B)、`技术架构与模块.md` 补广告反作弊技术项。*
|
||||
|
||||
@ -6,6 +6,8 @@
|
||||
>
|
||||
> **本文纪律**:纯技术分解,按领域边界组织、高内聚低耦合。**不出现任何产品功能/需求条目**。每个技术功能以 `T-{模块}-{nn}` 标识,供 Doc C 引用。
|
||||
> **职责边界**:产品功能入 Doc A,工程内生的技术功能入本文,二者经 Doc C 做 M:N 映射。模块按 13 模块重划分组织。
|
||||
> **权威读序(2026-06-10 审计补,HJ-AUDIT-001)**:本档 = **结构权威**(模块边界 / T-id 注册表),**非验收清单、非实现设计**。实现细节以 `docs/agent-specs/2026-06-09-核心功能技术实现方案.md`(8核心/19域)为准;真/桩/未建状态以 `docs/mvp/MVP进度总账.md` 为准。**冲突时:状态 > 实现 > 结构**。T-id 纪律:只增不改号,废弃打墓碑标记。
|
||||
> **建设形态注记(2026-06-10)**:13 模块为逻辑划分,物理上以 jar 聚合进 yudao 单体运行;**ip = seam 寄宿 compliance**(D5 裁定,不独立建模块);**pay = yudao 原生**(当前未接入单体);**community / biz = 未建**(Wave4)。个别 T-id 绑定的具体中间件已被 2026-06-09 实现方案决策取代,正文以「📌」就地标注,原文保留为远期形态。
|
||||
|
||||
---
|
||||
|
||||
@ -83,7 +85,7 @@ graph LR
|
||||
| T-STU-04 | 对白分支树(编辑 + 实时写入预览节点) |
|
||||
| T-STU-05 | agentic 任务链编排引擎(7 步生成链) |
|
||||
| T-STU-06 | 附件上下文装配(生成产物/上传 → 生成上下文) |
|
||||
| T-STU-07 | SSE 进度推送 |
|
||||
| T-STU-07 | SSE 进度推送 📌MVP=同步轮询(实现方案决策#5),SSE 后置 |
|
||||
| T-STU-08 | 草稿装配与 project 移交契约 |
|
||||
| T-STU-09 | 六类资产模块化生成调度(按资产种类编排 aigc 原子) |
|
||||
| T-STU-10 | 用户工作流编排(可视化,创作者自定义流程节点) |
|
||||
@ -106,7 +108,7 @@ graph LR
|
||||
| T-AGC-04 | GameConfig 结构化生成 + JSON Schema 校验 |
|
||||
| T-AGC-05 | 模板参数校验与兜底 |
|
||||
| T-AGC-06 | LLM 调用编排 / 熔断 / 重试 / 多供应商 |
|
||||
| T-AGC-07 | 生成任务异步队列调度(RocketMQ) |
|
||||
| T-AGC-07 | 生成任务异步队列调度 📌MVP 未部署 MQ:M-b 以执行器轮询实现(RocketMQ 为远期形态) |
|
||||
| T-AGC-08 | 生成任务状态机(queued/running/succeeded/failed/timed_out/canceled) |
|
||||
| T-AGC-09 | 确定性 Fallback 生成 |
|
||||
| T-AGC-10 | 生成失败原因分类(结构化错误码) |
|
||||
@ -162,7 +164,7 @@ graph LR
|
||||
| T-PRJ-03 | 版本管理(自增/覆盖/历史/current_version_id 切换) |
|
||||
| T-PRJ-04 | 草稿保存与恢复机制 |
|
||||
| T-PRJ-05 | 发布前检查清单(聚合锁风门 + 性能 + 版权) |
|
||||
| T-PRJ-06 | 发布审核 BPM 对接(Flowable,回写状态) |
|
||||
| T-PRJ-06 | 发布审核 BPM 对接 📌MVP=轻量状态机+admin 审核队列(实现方案决策#7);Flowable 为远期形态 |
|
||||
| T-PRJ-07 | 专区 Zone 实体 + 游戏归属 + 运营位(精选/新游/全部)+ launchZone |
|
||||
| T-PRJ-08 | 统一发布编排(compliance→runtime→feed,失败回滚) |
|
||||
| T-PRJ-09 | 游戏工程包导出(+ 多渠道审核元数据预留) |
|
||||
@ -178,7 +180,7 @@ graph LR
|
||||
| ID | 技术功能 | ID | 技术功能 |
|
||||
|---|---|---|---|
|
||||
| T-FED-01 | 规则推荐打分 | T-FED-09 | 分享落地页渲染 + OG 元数据 |
|
||||
| T-FED-02 | 候选集缓存(Redis TTL 60s) | T-FED-10 | 渠道参数解析(utm/channel) |
|
||||
| T-FED-02 | 候选集缓存 📌MVP 直查 MySQL(实现方案决策#3);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 | 个性化推荐算法(增长期) |
|
||||
@ -346,3 +348,5 @@ graph LR
|
||||
| pay | 5 | **合计** | **204** |
|
||||
|
||||
> 技术功能共 204 项入本文,产品功能 155 项入 Doc A;约 60 项能力同时有产品面与工程面,两侧各计一次。两者的 M:N 映射见 Doc C。
|
||||
|
||||
> **未编目实存组件(2026-06-10 审计登记,待随各自建设波补正式 T-id)**:① **new-api LLM 网关**(生成链现行通道,MiniMax-M2.7)——建议挂 aigc(T-AGC-06 的实现载体);② **agent 生成 QA 闭环裁决器**(agent-loop-v1:批跑/对抗评审/金丝雀/Golden 回归)——建议扩入 T-AGC-20/21 注记;③ **匿名玩家身份**(鉴权评审版方案待拍板)——建议落 compliance T-CMP-17 实现注记。
|
||||
|
||||
@ -11,6 +11,21 @@
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 状态横幅(2026-06-10 审计加注,先读 · HJ-AUDIT-001)
|
||||
|
||||
**本档为 2026-06-07 的「10 人团队 + 微服务三仓」目标态设计,与执行现实已系统性脱节——照本档环境/命令操作会失败。日常开发权威 = `.agents/rules/` + `.agents/knowledge/`;实操与踩坑 = `docs/mvp/MVP进度总账.md` + `docs/memorys/`。** 与现实的 6 条关键差异:
|
||||
|
||||
1. **monorepo**:三仓未拆,代码在当前仓(分支 dev/x.y.z,无 main/develop,远程=阿里云 Gitea);
|
||||
2. **yudao 单体**运行,无 Nacos / RocketMQ / 独立 Gateway——§1.3 中间件启动、§9 按 MQ/Nacos 排错的路径全部失效;
|
||||
3. 后端业务模块后缀为 **`-server`**(非 `-biz`),API 前缀为 **`/app-api`、`/admin-api`**(非 `/app`、`/admin`)——照本档命令/路径必失败;
|
||||
4. **无 docker-compose / 自有 CI**:构建部署 = mini-desktop 手动(git push→pull),见进度总账与 `docs/memorys/`;
|
||||
5. **Dify 暂不部署**:生成链 = 模板驱动 + new-api 直连(C2 裁定 2026-06-09);
|
||||
6. 前端 mock = 自写 vite 中间件(非 vite-plugin-mock);前端验证门 = `npm run build`(`vue-tsc --noEmit` 是假门禁);admin 二开目录 = `views/wanxiang/`(非 `views/game/`)。
|
||||
|
||||
> §4 编码规范、§5.3 commit 规范、§10 工具层蓝图段仍有效;其余章节阅读时按上述差异折算。
|
||||
|
||||
---
|
||||
|
||||
## 1. 快速上手
|
||||
|
||||
### 1.1 仓库结构
|
||||
|
||||
@ -9,6 +9,11 @@
|
||||
> - 竞品分析:`docs-design/竞品分析报告.md`
|
||||
> - 产品需求/技术模块/映射 三文档:`docs/architecture/产品需求清单.md`、`docs/architecture/技术架构与模块.md`、`docs/architecture/需求模块映射.md`
|
||||
|
||||
> **⚠️ 回填状态(2026-06-10,依据 HJ-AUDIT-001 架构三向审计)**:本档为蓝图权威,但以下裁定晚于本档成稿,**以裁定为准**:
|
||||
> 1. **生成主线已转向「模板驱动」**(C2 裁定 2026-06-09,spike 52/52 结构层 100%):LLM 直出 GameConfig 参数 + 固定模板 runtime,经 new-api 网关直连 LLM;**Dify / OpenGame 均未部署**,OpenGame 代码生成降级为远期增强。本档 §2.3 模式A 时序图、§4.1、§6.2 的 Dify+OpenGame 描述保留为蓝图原案。
|
||||
> 2. **执行排期以 `mvp-execution-spec` + `docs/mvp/MVP作战清单.md` 为准**,§9 甘特仅作蓝图参考;2026-06-08 业务决策已将 MVP 验收改为「staging/内网种子灰度走通真闭环」,公网上线=MVP 后并行长周期任务(受日历闸门约束)。
|
||||
> 3. **LLM 接入现状**:D1 拍板主 DeepSeek / 备 Qwen(2026-06-08);当前实际 = MiniMax-M2.7 经 new-api 网关(DeepSeek key 未激活)。网关多通道兜底曾真实失效(二厂系全废),见 §8 风险 #12。
|
||||
|
||||
---
|
||||
|
||||
## 1. 背景与目标
|
||||
@ -770,6 +775,8 @@ runtime-module 编译 GamePackage 时:
|
||||
|
||||
**架构决策**:Dify(DAG 编排)+ OpenGame(代码生成)+ Java 壳(任务调度)
|
||||
|
||||
> ⚠️ **2026-06-10 回填**:MVP 现行主线已按 C2 裁定改为**模板驱动**(LLM 直出 GameConfig + 固定模板 runtime,见文档头部回填状态);本节 Dify+OpenGame 组合保留为远期增强蓝图。
|
||||
|
||||
**为什么选 Dify + OpenGame,不自研**:
|
||||
|
||||
| 维度 | 自研 | Dify + OpenGame |
|
||||
@ -847,8 +854,10 @@ sequenceDiagram
|
||||
|
||||
**安全边界**:
|
||||
- iframe `sandbox="allow-scripts allow-same-origin"`
|
||||
- CSP: `script-src 'self'; connect-src 'none'`(游戏内无网络请求)
|
||||
- **红线(2026-06-10 审计补)**:`allow-same-origin` 仅当游戏包部署于**独立源**(usercontent 子域,与宿主不同源)时方可使用——同源下 iframe 可触宿主 DOM/存储、甚至自移除 sandbox,沙箱铁律失效。独立源就绪前,**禁用 `allow-same-origin`**。
|
||||
- CSP: `script-src 'self'; connect-src 'none'`(游戏内无网络请求);CSP 须经游戏包托管侧 **HTTP 响应头**下发,不以 meta 标签为唯一依赖
|
||||
- postMessage 来源校验 + schema 校验
|
||||
- **LLM 产物消毒(模板驱动后注入面=配置字符串)**:GameConfig 文案字段(title/label/theme 等)入库前做白名单字符集+长度校验,渲染侧一律转义后绘制,禁止 innerHTML/eval
|
||||
- 资源总大小 ≤ 10MB,首屏 ≤ 2MB
|
||||
|
||||
### 4.3 推荐引擎链路
|
||||
@ -1004,6 +1013,8 @@ graph LR
|
||||
| LangGraph | ❌ 放弃 | 无可视化 UI,运营无法参与编排 |
|
||||
| Coze | ❌ 放弃 | 闭源不可控,依赖字节 |
|
||||
|
||||
> **2026-06-10 回填**:C2 spike(4 模板 × 13 创意 = 52/52 结构层 100%)证实「LLM 填参数 + 固定模板 runtime」即可达标——**MVP 不部署 Dify/OpenGame,直连 new-api 网关**;本表选型整体降级为远期增强路径(产能/复杂度上台阶时再启用)。
|
||||
|
||||
### 6.3 前端
|
||||
|
||||
| 候选 | 选择 | 理由 |
|
||||
@ -1138,7 +1149,7 @@ graph TB
|
||||
| API 平均延迟 | P95 < 500ms | P95 < 200ms | Redis 缓存 + 连接池 + 读写分离 |
|
||||
| 生成任务耗时 | P50 < 60s | P50 < 30s | Dify 并行节点 + 模型优化 + 产物缓存 |
|
||||
| 并发玩家 | 1,000 DAU | 100,000 DAU | 水平扩缩 + 推荐缓存 + CDN 卸载 |
|
||||
| 数据库 QPS | — | 单表 < 5000 万行 | 超过则分区/归档,事件表 → ClickHouse |
|
||||
| 数据库容量(行数) | 单表 < 5000 万行 | 同左 | 超过则分区/归档,事件表 → ClickHouse;QPS 目标随首次压测基线另定 |
|
||||
|
||||
**性能测试节奏**:Phase 3 结束后跑首次压测(wrk/k6),上线前必须通过目标值。
|
||||
|
||||
@ -1397,11 +1408,16 @@ main ← 始终可部署,保护分支
|
||||
| 9 | 分布式事务部分失败 | 中 | 高 | 最终一致性 + 补偿机制(§7.3) | 中间态扫描 + 人工介入 |
|
||||
| 10 | CI/CD 流水线瘫痪 | 低 | 中 | 多 runner + 镜像缓存 | 手动部署备案流程 |
|
||||
| 11 | 第三方 SDK 数据泄露 | 低 | 极高 | 广告/支付 SDK 宿主侧隔离 + 最小权限 | 紧急下线第三方 SDK |
|
||||
| 12 | LLM 网关单点(new-api)通道批量失效(**2026-06 已真实发生**:二厂系全废) | 中 | 高 | 多通道健康巡检 + key 激活状态监控 + 同模型降级抽检(R8) | 单通道降级运行 + 批跑冻结阀 |
|
||||
| 13 | LLM 成本失控(免费生成被滥刷 / 推理输出吃光配额) | 中 | 高 | 生成限频限额 + 日预算熔断告警 + 显式 max_tokens | 超额暂停生成入口,仅确定性模板兜底 |
|
||||
| 14 | 监管与上游平台风险(无版号 UGC 定性 / AIGC 标识义务 / 微信抖音下场) | 中 | 极高 | 非纯技术风险,由合规专项与对外材料承载(HJ-AUDIT-001 R2),本表登记防失踪 | 自有端收敛邀请制灰度 + 变现走渠道备案通道 |
|
||||
|
||||
---
|
||||
|
||||
## 9. 演进路线
|
||||
|
||||
> ⚠️ **2026-06-10 回填**:本章甘特为 2026-06-06 蓝图原案,**执行排期以 `mvp-execution-spec` + `MVP作战清单` 为准**;「Dify + OpenGame Docker 部署」一项已随 C2 裁定取消(模板驱动主线);验收口径已改内网种子灰度(2026-06-08 业务决策)。
|
||||
|
||||
```mermaid
|
||||
gantt
|
||||
title v2.0 实施路线
|
||||
@ -1494,7 +1510,10 @@ gantt
|
||||
| 决策 | 文档位置 |
|
||||
|---|---|
|
||||
| 模块划分(13 个业务模块) | `技术架构与模块.md` |
|
||||
| AI 引擎选型(Dify + OpenGame) | 本文 §6.2 |
|
||||
| AI 引擎选型(Dify + OpenGame,**已降级远期增强**) | 本文 §6.2 |
|
||||
| **生成主线 = 模板驱动(MVP 现行)** | C2 裁定:`docs/agent-specs/2026-06-09-generation-spike/spike-summary.md` |
|
||||
| LLM 接入(D1:主 DeepSeek/备 Qwen;现行 MiniMax-M2.7 经 new-api) | `docs/agent-specs/2026-06-08-mvp业务决策.md` |
|
||||
| MVP 模板集(D2:idle/tycoon/merge/clicker —— ⚠️ 与 `contracts/templates/` 现存 clicker/dodge/runner/match 不一致,**下一模板/渲染面波开工前必拍**) | 同上 + HJ-AUDIT-001 R4 |
|
||||
|
||||
### 11.3 后续文档规划
|
||||
|
||||
|
||||
32
docs/mvp/A1闸门看板.md
Normal file
32
docs/mvp/A1闸门看板.md
Normal file
@ -0,0 +1,32 @@
|
||||
# A1 闸门看板(日历临界路径 · 唯一跟踪面)
|
||||
|
||||
> 建板:2026-06-10(作战清单 A1 落地件;审计 HJ-AUDIT-001 R2 修法 3 + 鉴权评审版 R2 行动项一并入列)
|
||||
> 性质:**这些闸门 AI 一秒也压不动**(见记忆 `mvp-binding-constraint-calendar-gates`)——材料准备 🤖 可代劳,**提交/实名/付费动作只有 🧑 你能做**。
|
||||
> done 口径(作战清单 A1 原文):**每项有 owner + 最晚提交日 + 阻塞状态**。每次状态变化直接改本表,不另开文档。
|
||||
> 根前置已解除:**经营主体 = 已有可用公司主体(创始人 2026-06-10 确认)→ 全链可立即并行启动,无多米诺等待。**
|
||||
|
||||
## 看板(按最晚提交日排序)
|
||||
|
||||
| # | 闸门项 | 前置 | 预计周期 | 最晚提交日 | 状态 | 下一步动作(具体到可执行) |
|
||||
|---|---|---|---|---|---|---|
|
||||
| 0 | 经营主体 | — | — | — | ✅ 已具备(06-10 确认) | 无;后续各项均以该主体名义提交 |
|
||||
| 1 | 域名购置+实名 | 主体 | 1-2 天 | **2026-06-12** | ☐ 未启动 | 选定正式域名(品牌已定=绘境 AI,建议域名与品牌一致)→ 企业实名认证 → 立即转入 #2 备案 |
|
||||
| 2 | ICP 备案 | 主体+域名+云服务器 | **7-20 工作日** | **2026-06-14(本周)** | ☐ 未启动 | 在云厂商备案系统提交(主体证件+域名+服务器实例);奇绩稿已承诺"8 月中旬前 ICP 完成+开放邀请制内测",本周不提交即吃掉全部缓冲 |
|
||||
| 3 | **短信签名报备**(鉴权件硬闸门,R2) | 主体资质;**部分供应商要求已备案域名(与 #2 串联——选不强制要求备案域名的供应商先行)** | **1-2 周不可压缩** | **2026-06-14(本周)** | ☐ 未启动 | 选短信供应商(阿里云/腾讯云,yudao 渠道客户端已内置)→ 提交企业签名+模板报备。**报备完成前玩家侧验证码不可用**——鉴权已拍 C 方案(邀请码旁路),漏斗不被它卡死,但全量切换日期由本项决定 |
|
||||
| 4 | LLM 实名充值 | 主体(或个人实名) | 即办 | 2026-06-14 | ◐ 网关可用中 | 确认 new-api 上游各厂 key 的实名/充值主体口径与发票路径;顺带修二厂系通道(deepseek key 未激活、glm/qwen/kimi token 过期——五件④) |
|
||||
| 5 | 支付商户进件(微信支付) | 主体+ICP 回执 | **1-3 周** | **2026-06-21** | ☐ 未启动 | 微信商户平台提交进件材料(执照/法人/结算户);M4 变现真实化的硬前置 |
|
||||
| 6 | 广告联盟资质(穿山甲/优量汇) | 主体+ICP+载体(小游戏/H5) | **1-3 周审核** | **2026-06-21** | ☐ 未启动 | 注册开发者账号+提交企业资质;载体侧与渠道线(微信/抖音小游戏备案)联动 |
|
||||
| 7 | 隐私协议/用户协议 | 律所/法务(软前置,占位文案可过渡) | 1 周 | 2026-06-30 | ☐ 未启动 | 🤖 先出占位文案随鉴权件上线(注册前展示);正式拉新前法务定稿(可并入 #11 律所咨询一次办) |
|
||||
| 8 | 内容合规材料 | 主体 | 持续 | 渠道提审前 | ☐ 未启动 | 内容审核制度文本+审核记录留存机制说明(渠道提审与 ICP 经营性升级都会要) |
|
||||
| 9 | **大模型登记**(审计新增) | 主体+服务上线形态说明 | **数月** | 材料 2026-06-30 就绪 | ☐ 未启动 | 自建平台调第三方大模型 API 对公众服务需办理;先让 #11 律所确认适用性与属地路径,材料 🤖 可代拟(奇绩稿承诺 8 月中旬"材料就绪") |
|
||||
| 10 | **算法备案**(审计新增) | 主体+推荐算法说明 | **数月** | 材料 2026-06-30 就绪 | ☐ 未启动 | feed 推荐(quality_score 重排)属算法推荐服务;与 #9 同窗办理,材料 🤖 可代拟 |
|
||||
| 11 | **律所合规咨询**(审计 R2,千元级) | 无 | 1 次会议 | **2026-06-14(本周约)** | ☐ 未启动 | 用现成 brief 约所:[`律所合规咨询brief.md`](./律所合规咨询brief.md)——两核心问(UGC 出版定性/防沉迷接入)+两附加问(二清分账/大模型登记+算法备案适用性) |
|
||||
| 12 | **分账/灵工方案选型**(审计新增,二清风险) | #11 律所意见 | 1 周决策 | 2026-06-30 | ☐ 未启动 | 律所意见到位后在三通道里选型:持牌分账产品 / 银行存管 / 灵活用工代发+个税代扣;选型前**不接真钱**(现状即如此,无新增风险) |
|
||||
|
||||
## 阻塞关系(一句话版)
|
||||
|
||||
主体✅ → {域名→ICP} ∥ 短信报备 ∥ LLM 实名 ∥ 律所咨询 同时起跑;ICP 回执 → {支付进件 ∥ 广告资质};律所意见 → {分账选型 ∥ 大模型登记/算法备案路径确认}。**本周必须动的四件:域名+ICP 提交、短信报备提交、律所约谈、LLM 实名口径确认。**
|
||||
|
||||
## 变更记录
|
||||
|
||||
- 2026-06-10 建板:枚举 12+1 项(原 A1 七项 + 短信报备[鉴权 R2] + 大模型登记/算法备案/分账选型[审计 R2 新增] + 律所咨询);主体确认已具备;全部其余项状态=未启动(如实——A1 已拖 2 天,今天是把"要启动"变成"已提交/明确缺什么"的最后一天)。
|
||||
@ -20,7 +20,7 @@
|
||||
|
||||
## A 轨〔🧑 你,今天启动 —— 周期最长、只有你能做〕
|
||||
|
||||
- [ ] **A1 闸门看板**:今天就把每项做到「已提交 / 明确还缺什么材料」——ICP 备案 · 域名/主体 · 支付商户进件 · 广告联盟资质 · 隐私协议 · 内容合规 · **LLM 实名充值**。`done=每项有 owner + 最晚提交日 + 阻塞状态`
|
||||
- [~] **A1 闸门看板**:✅ 看板已建(2026-06-10)→ [`A1闸门看板.md`](./A1闸门看板.md)(12+1 项=原七项 + 短信签名报备〔鉴权 R2〕+ 大模型登记/算法备案/分账选型〔审计新增〕+ 律所咨询〔brief 已备:[`律所合规咨询brief.md`](./律所合规咨询brief.md)〕;每项已给 owner+最晚提交日+阻塞状态,`done` 口径达成)。根前置已解除:**经营主体=已有可用公司主体(创始人 06-10 确认)→ 全链可并行启动**。**剩余=你的线下提交动作,本周四件:域名+ICP 提交 · 短信报备提交 · 律所约谈 · LLM 实名口径确认。**
|
||||
- [ ] **A2 种子供给**:锁 ~5 个种子创作者 + 定首批 10 个 demo 题材(喂 B 轨 feed)。`done=名单 + 题材表`
|
||||
- [ ] **A3 冷启动入口**:谈 1 个分发 / IP 冷启动口子。`done=1 个口子有眉目`
|
||||
- [x] **A4 生成盲评 → 已替代**(✅ 2026-06-09 拍板):「可接受层」改由 agent 闭环机器口径裁决(accept = 结构合法∧CDP真玩通关∧对抗评审无P0/P1∧批内查重),你降级为**事后抽看校准(非门禁)**。设计与拍板:`docs/agent-specs/2026-06-09-agent化生成QA闭环-review.md` §7。
|
||||
@ -53,7 +53,7 @@
|
||||
## 后置(登记 backlog,明确不在本轮)
|
||||
|
||||
- community(5 P0) + biz(6 P0) 克隆黄金模板〔biz 若广告/支付卡住,改轻量 lead form 验 B 端现金流〕。
|
||||
- 真实鉴权/匿名玩家身份:**评审版已出**(`2026-06-10-真实鉴权与匿名玩家-review.md`,双镜头 12 条意见全修订;含 ~7 项待创始人拍板:登录方式/漏斗激活时机/准入语义/匿名票据机制等)——拍板后排建设(建议 M-b 之后)。**注意其行动项:短信签名报备需即刻进 A1 闸门看板。**
|
||||
- 真实鉴权/匿名玩家身份:**✅ 七项已全拍**(2026-06-10 创始人,结果见 `2026-06-10-真实鉴权与匿名玩家-review.md` §9.1:C 验证码+邀请码旁路 / 报备前受限激活漏斗 / 开放注册 / 创作限 A2 白名单 / 互动即弹一键登录 / 实名提现前收 / 纯客户端 anonId+聚合侧剔除)——**下一步=出 execution 版排建设(M-b 已收口,可排)**;glossary 匿名条目与 contracts/events.schema.json anonId 描述已按 §9-7=B 同步修订。短信签名报备已入 [`A1闸门看板.md`](./A1闸门看板.md) #3。
|
||||
- M4 变现真实化(真实广告联盟 + pay 接线)、OSS 真实存取、MQ 聚合。
|
||||
|
||||
---
|
||||
@ -64,5 +64,5 @@
|
||||
|
||||
## 下一步(立即)
|
||||
|
||||
- 🧑 **你**(五件,按急迫;①②③来自 2026-06-10 架构三向审计 HJ-AUDIT-001):① **奇绩申报换稿**(现版含可证伪主张**禁投**;按批注版+技术段落重写稿重写并刷新到 06-10 现实——审计 R1);② **A1 闸门看板**(ICP/支付/广告/LLM 实名/短信报备 + **审计新增:大模型登记 · 算法备案 · 分账/灵工方案选型**)——日历临界路径仍未动;并约一次律所合规咨询(无版号 UGC 出版定性 + 防沉迷接入两问——审计 R2);③ **R4 模板集拍板**:D2 的 idle/tycoon/merge/clicker ↔ 实建 clicker/dodge/runner/match——**下一模板/渲染面波开工前**二选一;④ 修 new-api 网关二厂系通道(deepseek key 未激活、glm/qwen/kimi token 过期);⑤ 鉴权评审版拍 7 项 + R3 敏感性模型假设值(eCPM 区间 / 渠道60%×创作者80%×IP15-25% 三层叠加规则)。
|
||||
- 🤖 **我**:①**审计修复 W1·文档回填波** ✅ **2026-06-10 落地**(技术决策版头部回填状态+C2/D1/沙箱独立源红线/风险章+3项/§9 降级注/决策索引;Doc B 权威读序+建设形态+4 处📌勘误+未编目组件;开发团队版废止横幅+AGENTS.md 必读#4 加注;tech-decisions 回填+待拍表更新;规则档沙箱红线+LLM 消毒+views/wanxiang 校正;本清单回填铁律——对照 HJ-AUDIT-001 §7 清单逐项核)→ ②第二批 20 创意(batch-002,冻结已解 v1.1.1)→ ③审计 W2 对外材料清洗(待你①口径拍板)→ ④审计 W3 Doc A 合规换血(待律所意见)→ ⑤审计 W4 单位经济埋点(待⑤假设值)→ ⑥鉴权拍板后建设。
|
||||
- 🧑 **你**(五件 · 2026-06-10 晚拍板侧已收口 ③⑤全拍 + ①②的决策项全拍,**剩线下动作**):① **奇绩申报投递**(✅ 终稿候选已定稿:★1 品牌=绘境/★2 已签框架协议/★3 招募中 三项全拍定;品牌清扫+禁投/禁外发横幅已落——剩=**你投递 + 面试备好可出示的 IP 框架协议文件**〔仓内仅见谈判承诺书草案,★2 口径以你确认的线下已签文件为据;若实未签署须改回口头意向〕);② **A1 闸门线下提交**(✅ 看板已建 [`A1闸门看板.md`](./A1闸门看板.md) + 律所 brief 已备 [`律所合规咨询brief.md`](./律所合规咨询brief.md),主体已确认可用——剩=**本周四件:域名+ICP 提交 · 短信报备提交 · 律所约谈 · LLM 实名口径确认**);③ ~~R4 模板集拍板~~ ✅ **已拍(2026-06-10):维持 D2、按 D2 改建**——M-c 建 merge→idle→tycoon(clicker 保留),dodge/runner/match 降 P1 留契约(回填:mvp业务决策 D2 复审注 + tech-decisions 待拍表#6);④ 修 new-api 网关二厂系通道(deepseek key 未激活、glm/qwen/kimi token 过期)——仍待你;⑤ ~~鉴权评审版拍 7 项 + R3 假设值~~ ✅ **全拍**(鉴权七项=评审版 §9.1;**R3 已收口 2026-06-10**:叠加规则=IP 从创作者份额出·净额基数·平台恒 20%,eCPM 档=15/30/60——敏感性模型一页已落 [`单位经济敏感性模型.md`](./单位经济敏感性模型.md),关键结论=自有端 IAA 是万级 DAU 才回本的规模游戏、近期现金只能靠 B 端现金线;D3 复审注/glossary/BP:299 勘误已回填)。**至此五件中的拍板项全部清零,剩你的线下动作(②本周四件+①投递+BP 3★)。**
|
||||
- 🤖 **我**:①**审计修复 W1·文档回填波** ✅ **2026-06-10 落地**(技术决策版头部回填状态+C2/D1/沙箱独立源红线/风险章+3项/§9 降级注/决策索引;Doc B 权威读序+建设形态+4 处📌勘误+未编目组件;开发团队版废止横幅+AGENTS.md 必读#4 加注;tech-decisions 回填+待拍表更新;规则档沙箱红线+LLM 消毒+views/wanxiang 校正;本清单回填铁律——对照 HJ-AUDIT-001 §7 清单逐项核)→ ②第二批 20 创意 ✅(batch-002+002b 综合 95%)→ ③审计 W2 对外材料清洗 ✅ **2026-06-10 全收口**(★口径拍定+品牌清扫/横幅 + **BP 改造版红线清洗完成**:四红线/独家/绝对化/未实测指标全清、06-10 实证硬货+三线排序叙事入文、grep 自检正文红线词=0;**留 3 处 ★ 待你确认:团队表述×2 + 唯一融资口径**)→ ④审计 W3 Doc A 合规换血(待律所意见)→ ⑤审计 W4 单位经济埋点(**✅ R3 已拍解锁**:按 [`单位经济敏感性模型.md`](./单位经济敏感性模型.md) §7 测量计划扩 B2 回路——LLM token 计费/素材成本/广告产值/创作者应得四类按游戏粒度埋点,待排期)→ ⑥**鉴权 execution 版 ✅ 已出**(`2026-06-10-真实鉴权与匿名玩家-execution.md`:落点=system 内扩展、Flyway=V11(community/biz 顺延 V12/V13)、@PermitAll 清单 14 条带 file:line、邀请码全生命周期、R6 安全前置;**新发现硬边界:game_runtime_session.player_user_id NOT NULL 须 V11 ALTER**——待排建设)→ ⑦**M-c 模板波**:review 版已出+**四项细节已拍**(两批 merge 先行/idle 纯前端+storage/10校准+20正式/拖拽为主,`2026-06-10-Mc模板波-review.md` §7.1)→ 下一步=批① merge execution 版。
|
||||
|
||||
@ -106,7 +106,7 @@
|
||||
- [ ] `deploy/smoke-test.sh` 5 条核心链路自动化
|
||||
|
||||
### 不可压缩日历闸门(人侧并行启动,非工程量;见记忆 mvp-binding-constraint-calendar-gates)
|
||||
- [ ] ICP 备案 | 支付进件 | 广告联盟审核 | LLM 实名充值 — **这些才是 MVP 上线的真正约束**
|
||||
- [~] ICP 备案 | 支付进件 | 广告联盟审核 | LLM 实名充值 | 短信签名报备 | 大模型登记/算法备案/分账选型 — **这些才是 MVP 上线的真正约束**。✅ 2026-06-10 看板已建:[`A1闸门看板.md`](./A1闸门看板.md)(12+1 项含 owner/最晚提交日/阻塞状态;主体已确认可用;律所咨询 brief 已备 [`律所合规咨询brief.md`](./律所合规咨询brief.md))——**剩创始人线下提交动作,本周四件见看板**
|
||||
|
||||
---
|
||||
|
||||
@ -121,6 +121,10 @@
|
||||
| **admin 基线** | game-admin → 稳定 tag v2026.01(vite5) + gitignore 修复 | `fd373db`·`4ba6cbd`·`8901350` | build 绿(mini-desktop) |
|
||||
| **Wave3** | 双 spec→PhaseA 收口→PhaseB(compliance/studio)→PhaseC 接入→staging 真启动→两预存缺陷修复 | `5be2251`→`8565fa2`(10 提交) | project15+compliance8 单测、单体真启动、admin/app-api 200 |
|
||||
| **agent 闭环波(M-a)** | 双 spec(评审版拍板+execution 审定)→D1-D5 五件交付→两次部署窗口→**batch-001 验收 80.0% 过线+双锚**→补救(金丝雀10+R8 抽检冻结告警)→数据回路三修+鉴权评审版 | `9bf3d54`→`8cf5918`(5 提交) | mvn 多轮全绿+59 py 单测+§12.3 八连冒烟+批跑 671s 零 infra+三修部署断言 8/8 |
|
||||
| **架构三向审计 + W1 回填(HJ-AUDIT-001)** | 商业×产品×技术 10 子代理深读 + 对抗压测 + 外部核查 → **四颗雷**(R1 对外材料诚信债 / R2 自有H5合规死锁 / R3 三层分成未合账+零成本侧 / R4 模板集背离 D2)+ 三线排序修正叙事;**W1 文档回填波同日落地**(技术决策版/Doc B/开发团队版/tech-decisions/两规则档/AGENTS.md/本总账+作战清单回填铁律,共 9 档) | 报告 `2026-06-10-架构文档三向审计-review.md` + W1 修订 | 全部发现带 file:line 证据;否定性结论 grep 全仓验证;外部结论带源(2026-06-10 检索);W1 对照报告 §7 清单逐项落 |
|
||||
| **创始人拍板波(R4+鉴权七项+A1+奇绩口径)** | 2026-06-10 晚一次性收口四组拍板:**R4**=维持 D2 按 D2 改建(M-c 建 merge→idle→tycoon,动作类降 P1 留契约);**鉴权七项全拍**(C 验证码+邀请码旁路/受限激活/开放注册/创作限白名单/一键登录/实名提现前/纯客户端 anonId);**A1 闸门看板建账**(12+1 项,主体已确认可用,律所 brief 备好);**奇绩 ★1/2/3 定稿**(品牌绘境清扫落地+禁投/禁外发横幅+★2 已签框架协议〔以创始人线下确认为据〕+★3 招募中) | 回填:mvp业务决策 D2 复审注 / tech-decisions #4#6 / 鉴权评审版 §9.1 / glossary+events.schema.json / 奇绩审改版 / A1闸门看板.md+律所brief(新建)/ 本总账+作战清单 | 回填铁律逐项执行(受影响蓝图/蒸馏/对外档全部同步修订);品牌清扫 grep 验证目标 6 档造梦=0、内部引用 5 处已更 |
|
||||
| **R3 收口(单位经济敏感性模型)** | 2026-06-10 创始人两项拍板:**叠加规则=IP 从创作者份额出**(净额基数:渠道扣 40%→净额 N;创作者 80%;带 IP 实得 55-65%;**平台恒留 0.2N**——D3 80% 与对外 55-65% 自此同一模型)+ **eCPM 档=15/30/60(明标待测)**。敏感性模型一页落 `docs/mvp/单位经济敏感性模型.md`:基准格平台留存 324 元/月/千DAU、覆盖 ¥4300 基建需 **1.33 万 DAU**(实证三线排序:近期现金=B端);满 5 元提现锚=单款 12 次激励展示/日;成本侧文本生成 <1 元/款(推断)、未计 GPU 素材+人审。**W4 埋点解锁** | 回填:mvp业务决策 D3 复审注 / glossary 分成条目 / BP:299 勘误(60-65%→统一口径)/ 作战清单 | 算术主 agent 手核(0.6×0.8 链路三档矩阵);eCPM/展示次数/token 单价均标【假设·待测】,零编数 |
|
||||
| **拍板后产出波(W2 收口 + 鉴权 exec + M-c review)** | 同日三件并行交付(3 子代理+主 agent 抽查验收):① **W2 全收口**=BP 改造版红线清洗(原 20 处「锁风」系红线词全清、独家→非独家、绝对化/未实测指标清零、06-10 实证+三线排序叙事入文,留 3 ★ 待创始人:团队表述×2+融资口径)② **鉴权 execution 版**(V11/system 内扩展/14 @PermitAll 端点带 file:line/邀请码全生命周期/R6;修正评审版 4 处与现实不符,新发现 `game_runtime_session.player_user_id NOT NULL` 硬边界)③ **M-c review 版 + 四项细节拍板**(两批 merge 先行/idle 纯前端+storage 通道/10 校准+20 正式/拖拽为主;新发现 runtime 对未知模板零防御=本波顺带补)| `2026-06-10-真实鉴权与匿名玩家-execution.md` + `2026-06-10-Mc模板波-review.md` + BP 改造版(绘境)清洗记录节 | 主 agent 独立抽查:V3:94 NOT NULL 属实、run_batch clicker 硬编码属实、SDK storage 契约位属实、runtime 仅 clicker 逻辑属实、BP 正文红线词 grep=0、3 ★ 在位 |
|
||||
|
||||
> 各波次详细 spec:`docs/agent-specs/`(review + execution 双 spec)。
|
||||
|
||||
@ -131,3 +135,4 @@
|
||||
- **真正的约束不是工程量,是日历闸门**(ICP/支付/广告/实名),见记忆 `mvp-binding-constraint-calendar-gates`——再快的代码也压不过备案周期,人侧须并行启动。
|
||||
- **生成成功率≥80%**:2026-06-09 起采用**两段式口径**(创始人拍板,Z3)——agent 闭环 v1 代产批跑即可**测量**(①口径达标,"接通前无法测量"成为历史);但 **M2 整体收口另需②真实用户生成链贯通(M-b)**,编排器代产批过线**不得单独宣称 M2 完成**。命门从"无法测量"转为"M-b 贯通"。**→ 2026-06-10 两段均达成,M2 整体收口**(①batch-001 80.0% ②部署 #3.1 真实用户链 5 样本实证;证据互不顶替分别在档)。
|
||||
- **结构骨架 ≠ 产品功能可验收**:勿用"模块编译通过/单体启动"等同于"P0 达成"。本总账第 0、2、3 节即为防此偏差而设。
|
||||
- **架构三向审计四颗雷(2026-06-10,HJ-AUDIT-001)**:详见 `docs/agent-specs/2026-06-10-架构文档三向审计-review.md`——**R1** 对外材料含可证伪主张(奇绩现版禁投,换稿不冻结);**R2** 自有 H5 分发 UGC 合规死锁(IAA 免版号仅渠道内成立;闸门新增 大模型登记/算法备案/分账方案;Doc A 缺 8 项法定 P0);**R3** 渠道60%×创作者80%×IP15-25% 三层分成从未合账 + 全仓零生成成本侧;**R4** 模板集背离 D2 拍板(实建 dodge/runner/match=被降级的动作类)→ **✅ 2026-06-10 已拍:维持 D2、按 D2 改建**(M-c=merge→idle→tycoon,动作类降 P1 留契约)。W1 文档回填已落;W2 对外清洗=★口径全定+品牌清扫/横幅已落(残余 BP 改造版红线内容清洗);W3 待律所意见(brief 已备);W4 待 R3 假设值。
|
||||
|
||||
59
docs/mvp/单位经济敏感性模型.md
Normal file
59
docs/mvp/单位经济敏感性模型.md
Normal file
@ -0,0 +1,59 @@
|
||||
# 单位经济敏感性模型(一页 · 带标注假设)
|
||||
|
||||
> 2026-06-10 建(审计 HJ-AUDIT-001 R3 修法①落地件)| 维护:主 agent | **内部决策用,不进对外材料**
|
||||
> 性质声明:本页是**带标注假设的敏感性模型**,不是收入预测。每个数字标注【确证】【拍板】【假设·待测】之一;W4 单位经济埋点拿到实测后逐项替换。
|
||||
|
||||
## 1. 拍板记录(创始人 2026-06-10,R3 收口)
|
||||
|
||||
- **三层分成叠加规则 = IP 从创作者份额出(净额基数)**:分成基数=平台从渠道/联盟**实收净额 N**;创作者 80%;使用 IP 素材时 IP 授权分成 15-25% **从创作者份额内支出**(创作者实得 55-65%);**平台恒留 20%**。——D3「创作者 80%」与 BP「55-65%+IP 15-25%」自此是同一个模型的两种表述,账永不为负。
|
||||
- **eCPM 假设档位 = 悲观 15 / 基准 30 / 乐观 60 元/千次**(激励视频;敏感性扫描 10-80 全带)【假设·待测——审计外部核查仅有从业者区间 20-80,低置信】。
|
||||
|
||||
## 2. 分账公式(拍板后唯一口径)
|
||||
|
||||
```
|
||||
总广告消耗 G(gross)
|
||||
└─ 渠道分成 40%【确证:微信 IAA 流量主现金分成 60%】
|
||||
└─ 平台实收净额 N = 0.6G
|
||||
├─ 无 IP 素材:创作者 0.8N(=0.48G)| 平台 0.2N(=0.12G)
|
||||
└─ 带 IP 素材:创作者 0.55~0.65N(=0.33~0.39G)| IP 方 0.15~0.25N(=0.09~0.15G)| 平台 0.2N(=0.12G)
|
||||
```
|
||||
|
||||
> 自有端(远期、合规闸门后)走广告联盟时,渠道 40% 替换为联盟实际扣率,公式不变,基数仍为实收净额。
|
||||
|
||||
## 3. 收入侧敏感性矩阵(平台留存,元/千 DAU)
|
||||
|
||||
每 DAU 日 gross = 人均激励展示次数 × eCPM/1000;平台留存 = 0.12 × gross。人均展示档【假设·待测】:低 1 / 中 3 / 高 6 次/日。
|
||||
|
||||
| 平台留存(元/千DAU/**月**) | eCPM 15 | eCPM 30 | eCPM 60 |
|
||||
|---|---|---|---|
|
||||
| 人均 1 次/日 | 54 | 108 | 216 |
|
||||
| 人均 3 次/日 | 162 | **324(基准格)** | 648 |
|
||||
| 人均 6 次/日 | 324 | 648 | 1,296 |
|
||||
|
||||
**覆盖 ¥4,300/月基建【确证:投资人版成本表口径】所需 DAU**:基准格 ≈ **1.33 万 DAU**;悲观角(1次×15)≈ 8 万 DAU;乐观角(6次×60)≈ 3,300 DAU。
|
||||
|
||||
**结论(本模型最重要的一句话)**:自有端 IAA 在现实假设下是**万级 DAU 才回本的规模游戏**,种子期(百级 DAU)月留存只有几十元量级——实证三线排序的正确性:**近期现金只能来自 ①B端/IP 项目制收费(与 DAU 无关)**,IAA 是 ③渠道规模线的远期账。
|
||||
|
||||
## 4. 创作者侧:「满 5 元提现」可达性锚点
|
||||
|
||||
月提 5 元 ⇒ 单款日均激励展示需 ≈ **347/eCPM 次**(无 IP;带 IP 再 ×1.45):eCPM 30 → **12 次/日**;eCPM 15 → 23 次/日;eCPM 60 → 6 次/日。
|
||||
⚠️ 诚信提醒(审计 R3 连带项):种子期头部款可达、长尾款不可达——对创作者宣传「能赚钱」时必须用「头部款」口径,勿做普遍性承诺。
|
||||
|
||||
## 5. 成本侧(单款生成,全部【推断/假设·待测】——W4 第一优先实测项)
|
||||
|
||||
结构:单款成本 = LLM 调用(设计 1 + 对抗 1 + 修复 ≤1 + 裁判 1 ≈ 4±1 次【确证:编排器流水线结构】× 每次 ~3-6K token【推断:max_tokens=4096 上限,实际未计量】)+ 失败摊销 ×1.25【确证:accept 80% 口径】+ 存储(MB 级,可忽略)。
|
||||
- 若单价 2 元/百万 token【假设·待网关账单】→ **≈ 0.03-0.08 元/款**;单价 ×10 也 <1 元/款。
|
||||
- **文本生成不是成本瓶颈**。真正未计入、可能咬人的两项:**素材生成 GPU**(ComfyUI 未部署,零数据)与**人审兜底人力**——列为 W4 测量项,本模型不编数。
|
||||
|
||||
## 6. 口径一致性勘误(随本拍板执行)
|
||||
|
||||
| 文档位置 | 旧口径 | 处置 |
|
||||
|---|---|---|
|
||||
| BP 改造版 :299 | 「创作者占比 60%-65%」 | ✅ 已勘误为统一口径(最高 80%,用 IP 素材实得 55-65%) |
|
||||
| BP 改造版 :393 | 「创作者 55%-65%,IP 方 15~25%,剩余平台留存」 | 与拍板模型兼容,保留 |
|
||||
| glossary 分成比例条目 | 分层 80/75/70 | ✅ 已加 R3 叠加规则注 |
|
||||
| mvp业务决策 D3 | 统一 80%(未定叠加) | ✅ 已加 D3 复审注(叠加规则) |
|
||||
|
||||
## 7. W4 单位经济埋点测量计划(本模型的假设替换路径)
|
||||
|
||||
扩展 B2 数据回路,按游戏粒度落:① LLM token 数与网关计费(生成+对抗+裁判分列)② 素材生成成本(ComfyUI 部署后)③ 广告产值(impression × 实测 eCPM,对账渠道结算单)④ 创作者应得/实付。产出 = 用实测列替换本页 §1/§3/§5 的【假设·待测】标注。**W4 自此解锁(R3 假设值已拍),待排期。**
|
||||
41
docs/mvp/律所合规咨询brief.md
Normal file
41
docs/mvp/律所合规咨询brief.md
Normal file
@ -0,0 +1,41 @@
|
||||
# 律所合规咨询 Brief(单次咨询 · 千元级预算)
|
||||
|
||||
> 2026-06-10 拟(审计 HJ-AUDIT-001 R2 修法落地件)。用途:约一次互联网/游戏合规方向律师咨询,**本文件可直接转发给律所作为会前材料**。
|
||||
> 期望产出:对下列四问的**书面意见要点**(每问给:定性结论 + 风险等级 + 可行通道 + 触发红线的边界条件)。
|
||||
|
||||
## 一、业务事实(如实陈述,供律师定性)
|
||||
|
||||
1. 我方为一家小型公司主体,开发了一个 AI 小游戏创作平台:用户输入一句话,平台调用**第三方大模型 API**(非自研模型)生成轻量 H5 小游戏(无下载、浏览器内即玩),其他用户可在平台内的"游戏流"中浏览试玩。
|
||||
2. **现状**:未公开经营。平台处于内测阶段,计划以**邀请制**(邀请码注册)向约 5 名种子创作者及受邀玩家开放;**不接入真实资金**——无充值、无支付、无提现,广告为契约/骨架设计未真实接入。
|
||||
3. **计划中的变现路径**:(a)将生成的游戏导出到微信/抖音小游戏渠道,走渠道备案 + IAA(广告变现)通道;(b)远期在自有平台接入广告联盟,平台代收广告费后按比例分成给**个人创作者**;(c)为 IP 方/品牌定制营销小游戏(B 端项目制收费)。
|
||||
4. 平台游戏均为 UGC + AI 生成产物,内容上架前有发布审核闸门(机器审核 + 人工复核),种子期创作/发布仅限白名单创作者。
|
||||
5. 平台含推荐算法(按游戏质量分对游戏流重排序)。
|
||||
|
||||
## 二、核心两问(本次咨询必答)
|
||||
|
||||
**问 1 · 无版号 UGC 游戏在自有 H5 平台分发的出版定性**
|
||||
- 上述"邀请制内测、不接真钱、不公开经营"的运营形态,是否构成《网络出版服务管理规定》意义上的网络出版/游戏运营?"试玩 demo / 内测"定性的成立边界在哪(人数规模?是否可分享链接?是否可有任何收入?)?
|
||||
- 若未来自有平台公开经营(开放注册+广告变现),在无版号条件下的合规路径是否存在?(我方已知:微信/抖音小游戏 IAA 备案制豁免通道仅在渠道生态内成立;自营无版号 H5 平台有被罚先例。)
|
||||
|
||||
**问 2 · 防沉迷义务的履行路径**
|
||||
- 无版号则无法接入出版署官方实名/防沉迷系统——自有端(邀请制内测形态)的防沉迷/实名义务如何履行?内测定性下是否有豁免空间或替代性履行方式(自建时长限制、宵禁等)?
|
||||
- 自营分发时平台作为第一责任人的义务边界与渠道分发(渠道代管实名/防沉迷)有何差异?
|
||||
|
||||
## 三、附加两问(时间允许则答)
|
||||
|
||||
**问 3 · 平台代收广告费分账给个人创作者的资金合规**
|
||||
- 平台代收广告联盟结算款、再按比例分账给个人创作者,是否构成"二清"?三个备选通道(持牌分账产品 / 银行存管 / 灵活用工平台代发+个税代扣)各自的适用性与成本量级?
|
||||
|
||||
**问 4 · 生成式 AI 相关备案义务**
|
||||
- 自建平台调用第三方大模型 API 对公众提供生成服务:是否需要办理生成式 AI 服务"大模型登记"及《互联网信息服务算法推荐管理规定》下的**算法备案**(平台另有推荐算法)?邀请制内测阶段是否触发?办理路径与周期?
|
||||
- AIGC 显式标识义务(《人工智能生成合成内容标识办法》2025-09 施行)对平台生成游戏的适用方式。
|
||||
|
||||
## 四、我方期望的决策用途(律师可据此把握分寸)
|
||||
|
||||
- 问 1/2 的结论直接决定:自有端是否长期保持"邀请制内测"定性、公开经营推迟到何条件满足。
|
||||
- 问 3 的结论决定分账方案选型(A1 闸门看板 #12),选型前我方不接真钱。
|
||||
- 问 4 的结论决定两项备案的启动时点与材料准备(A1 闸门看板 #9/#10)。
|
||||
|
||||
## 附:可提供材料
|
||||
|
||||
业务描述(本文件)/ 平台 demo 试玩链接(内网,可会上演示)/ 现有 IP 合作协议文本 / 内容审核闸门机制说明(可后补)。
|
||||
Loading…
x
Reference in New Issue
Block a user