From 7bd9cd05e65be96c2ab6eb3576f9d5e75cb08f48 Mon Sep 17 00:00:00 2001 From: lili Date: Sat, 20 Jun 2026 20:48:38 -0700 Subject: [PATCH] =?UTF-8?q?docs(governance):=20Phase7=20=E6=94=B6=E5=8F=A3?= =?UTF-8?q?=E2=80=94=E2=80=94=E6=B2=BB=E7=90=86=E9=97=A8=E5=8F=8D=E8=BD=AC?= =?UTF-8?q?=20+=20=E6=BA=90=E6=A1=A3=E5=BD=92=E6=A1=A3=20+=20=E5=85=A5?= =?UTF-8?q?=E5=8F=A3=E5=AF=B9=E8=B4=A6=20+=20=E6=AD=BB=E9=93=BE=E9=97=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 设计文档域化重构总收口: - §10 治理门反转(engineering-conventions §10.5/10.6/10.7):canonical 根从 agent-specs 改为 docs/architecture 6 域树;品牌门白名单加 architecture/_archive。 - 归档 11 settled 源档(7 根 architecture + 4 非生成 agent-specs canonical)→ 各自 _archive(git mv 保 history + tombstone redirect)。生成域设计链过渡期保留(架构演进中)。 - rewire 17 个活层文件(.agents/knowledge|rules|skills + docs/mvp + AGENTS.md + 新树)指向新树路径;活层零残留旧 canonical 路径。 - AGENTS.md §4 必读表/§3.2 目录树/§3.3-3.4 指针 → 新树;_index.md 瘦身为 trace/spike + 生成域演进链 + 修 line22↔40 自相矛盾。 - 新增死链门 .agents/tools/check-deadlinks.sh(§10.7 死链项的可执行脚本)。 - 全门齐跑:死链 0 / 新树无旧品牌 / 无超 2000 行 / 活层无残留。 Co-Authored-By: Claude Opus 4.8 (1M context) --- .agents/knowledge/mvp-scope-and-milestones.md | 2 +- .agents/knowledge/product-and-architecture.md | 4 +- .agents/knowledge/tech-decisions.md | 2 +- .agents/rules/engineering-conventions.md | 14 ++++--- .agents/rules/security-and-reliability.md | 2 +- .agents/skills/add-business-module.md | 2 +- .agents/skills/ai-generation-pipeline.md | 2 +- .agents/skills/contract-first-development.md | 2 +- .agents/skills/runtime-and-multichannel.md | 2 +- .agents/tools/check-deadlinks.sh | 39 +++++++++++++++++++ AGENTS.md | 21 +++++----- .../{ => _archive}/studio前端设计体系.md | 2 + .../{ => _archive}/变现与单位经济.md | 2 + docs/agent-specs/{ => _archive}/战略与合规.md | 2 + docs/agent-specs/{ => _archive}/渠道发行.md | 2 + docs/agent-specs/_index.md | 26 +++++++------ .../{ => _archive}/产品需求清单.md | 2 + .../{ => _archive}/技术架构与模块.md | 2 + .../{ => _archive}/护城河对外话术-双版本.md | 2 + .../{ => _archive}/系统概要设计-开发团队版.md | 2 + .../{ => _archive}/系统概要设计-技术决策版.md | 2 + .../{ => _archive}/系统概要设计-投资人版.md | 2 + .../{ => _archive}/需求模块映射.md | 2 + docs/architecture/前端/README.md | 4 +- docs/architecture/架构/README.md | 2 +- docs/architecture/运营/README.md | 14 +++---- docs/architecture/运营/变现与单位经济.md | 6 +-- docs/architecture/运营/合规闸门.md | 2 +- docs/mvp/MVP作战清单.md | 2 +- docs/mvp/全成本收益测算模型-v2.md | 4 +- docs/mvp/可行性方案16周-波次映射.md | 2 +- 31 files changed, 120 insertions(+), 56 deletions(-) create mode 100755 .agents/tools/check-deadlinks.sh rename docs/agent-specs/{ => _archive}/studio前端设计体系.md (97%) rename docs/agent-specs/{ => _archive}/变现与单位经济.md (97%) rename docs/agent-specs/{ => _archive}/战略与合规.md (96%) rename docs/agent-specs/{ => _archive}/渠道发行.md (97%) rename docs/architecture/{ => _archive}/产品需求清单.md (98%) rename docs/architecture/{ => _archive}/技术架构与模块.md (99%) rename docs/architecture/{ => _archive}/护城河对外话术-双版本.md (97%) rename docs/architecture/{ => _archive}/系统概要设计-开发团队版.md (99%) rename docs/architecture/{ => _archive}/系统概要设计-技术决策版.md (99%) rename docs/architecture/{ => _archive}/系统概要设计-投资人版.md (98%) rename docs/architecture/{ => _archive}/需求模块映射.md (98%) diff --git a/.agents/knowledge/mvp-scope-and-milestones.md b/.agents/knowledge/mvp-scope-and-milestones.md index 7d8ae637..054d3b2c 100644 --- a/.agents/knowledge/mvp-scope-and-milestones.md +++ b/.agents/knowledge/mvp-scope-and-milestones.md @@ -1,6 +1,6 @@ # MVP 范围与里程碑事实蒸馏 -> 蒸馏来源：`docs/superpowers/specs/mvp-execution-spec-design.md`（HJ-MVP-SPEC-001，执行权威）、`docs/architecture/产品需求清单.md`（Doc A 产品功能）、`docs/architecture/需求模块映射.md`（Doc C 需求↔模块 RTM）、`docs/architecture/系统概要设计-技术决策版.md`（§1.2 指标、§9 路线）。 +> 蒸馏来源：`docs/superpowers/specs/mvp-execution-spec-design.md`（HJ-MVP-SPEC-001，执行权威）、`docs/architecture/产品/需求清单.md`（Doc A 产品功能）、`docs/architecture/产品/需求模块映射.md`（Doc C 需求↔模块 RTM）、`docs/architecture/架构/README.md`（§1.2 指标、§9 路线）。 > 目的：让后续 Agent 一篇掌握 MVP 端到端闭环、量化验收线、范围口径、5 工位分工、M0-M5 里程碑、契约先行要点。 > 相关：架构模块见 [`product-and-architecture.md`](./product-and-architecture.md)；选型与"范围张力"见 [`tech-decisions.md`](./tech-decisions.md)；术语见 [`glossary.md`](./glossary.md)。契约先行 playbook 见 [`../skills/contract-first-development.md`](../skills/contract-first-development.md)。 diff --git a/.agents/knowledge/product-and-architecture.md b/.agents/knowledge/product-and-architecture.md index 35f64d3a..5bc44fa7 100644 --- a/.agents/knowledge/product-and-architecture.md +++ b/.agents/knowledge/product-and-architecture.md @@ -1,6 +1,6 @@ # 产品与架构事实蒸馏 -> 蒸馏来源：`docs/architecture/系统概要设计-投资人版.md`、`docs/architecture/产品需求清单.md`、`docs/architecture/技术架构与模块.md`、`docs/architecture/需求模块映射.md`、`docs/architecture/系统概要设计-技术决策版.md`、`docs/architecture/系统概要设计-开发团队版.md` +> 蒸馏来源：`docs/architecture/产品/商业定位.md`、`docs/architecture/产品/需求清单.md`、`docs/architecture/架构/13模块.md`、`docs/architecture/产品/需求模块映射.md`、`docs/architecture/架构/README.md`、`docs/architecture/架构/README.md` > 目的：让后续 Agent 读本篇即掌握产品定位、用户角色、分层架构、三仓库、13 模块与依赖、Huijing 复用边界、SDK 定位，不必重读原始长文档。 > 相关：决策见 [`tech-decisions.md`](./tech-decisions.md)；MVP 范围见 [`mvp-scope-and-milestones.md`](./mvp-scope-and-milestones.md)；术语见 [`glossary.md`](./glossary.md)。 > **子系统现行设计+现状（深一层 SoT）**：见 `docs/agent-specs/` 子系统 canonical 活档——`引擎与运行时` / `agentic编排-SAA` / `开闸验收门-W-G1` / `渠道发行` / `studio前端设计体系` / `变现与单位经济` / `战略与合规` / `prompt治理体系-execution`；生成域=固定架构设计链；导航见 [`../../docs/agent-specs/_index.md`](../../docs/agent-specs/_index.md)。本篇=速查蒸馏，重叠处以 canonical 为 SoT（见 engineering-conventions §10.5）。 @@ -82,7 +82,7 @@ AI 引擎层 ~~Dify（DAG 编排/多模型） + OpenGame（Python 代码生成 ## 5. 13 个业务模块速查表 -> **13 模块**：含 **studio**（创作编排/编辑器域），**aigc 为无状态生成原子**；能力清单按产品功能/技术功能/映射三文档分离（见 `docs/architecture/产品需求清单.md`、`…-技术架构与模块.md`、`…-需求模块映射.md`）。 +> **13 模块**：含 **studio**（创作编排/编辑器域），**aigc 为无状态生成原子**；能力清单按产品功能/技术功能/映射三文档分离（见 `docs/architecture/产品/需求清单.md`、`…-技术架构与模块.md`、`…-需求模块映射.md`）。 | 模块 ID | 一句话职责 | 面向端 | 被依赖 | |---|---|---|---| diff --git a/.agents/knowledge/tech-decisions.md b/.agents/knowledge/tech-decisions.md index 167b27f2..796cd332 100644 --- a/.agents/knowledge/tech-decisions.md +++ b/.agents/knowledge/tech-decisions.md @@ -1,6 +1,6 @@ # 技术决策事实蒸馏（ADR 风格） -> 蒸馏来源：`docs/architecture/系统概要设计-技术决策版.md`（§6 决策记录、§6.6/6.7/6.8 工具链，最权威）、`docs/architecture/技术架构与模块.md`（各模块技术栈/边界）、`docs/architecture/系统概要设计-开发团队版.md`、`docs/superpowers/specs/mvp-execution-spec-design.md`（执行约束）。 +> 蒸馏来源：`docs/architecture/架构/README.md`（§6 决策记录、§6.6/6.7/6.8 工具链，最权威）、`docs/architecture/架构/13模块.md`（各模块技术栈/边界）、`docs/architecture/架构/README.md`、`docs/superpowers/specs/mvp-execution-spec-design.md`（执行约束）。 > 目的：让后续 Agent 一篇掌握"为什么这么选、放弃了什么、风险在哪、哪些还没拍板、哪些源档互相打架"。 > 相关：架构与模块见 [`product-and-architecture.md`](./product-and-architecture.md)；范围里程碑见 [`mvp-scope-and-milestones.md`](./mvp-scope-and-milestones.md)；术语见 [`glossary.md`](./glossary.md)；红线约束见 [`../rules/security-and-reliability.md`](../rules/security-and-reliability.md)、[`../rules/engineering-conventions.md`](../rules/engineering-conventions.md)。 diff --git a/.agents/rules/engineering-conventions.md b/.agents/rules/engineering-conventions.md index e4343645..939426cb 100644 --- a/.agents/rules/engineering-conventions.md +++ b/.agents/rules/engineering-conventions.md @@ -1,7 +1,7 @@ # 工程编码与协作硬规范 > 本文是绘境AI 全栈工程师 / 前端 / AI 工程师 / QA 必须遵守的**硬规则**。违反即不通过 review。 -> 蒸馏来源：`docs/architecture/系统概要设计-开发团队版.md`（§4 编码 / §5 Git / §6 联调 / §7 测试 / §11 Checklist）、`docs/architecture/系统概要设计-技术决策版.md`（§7.6-7.8 工程治理）、`docs/superpowers/specs/mvp-execution-spec-design.md`（§8 技术约束）。 +> 蒸馏来源：`docs/architecture/架构/README.md`（§4 编码 / §5 Git / §6 联调 / §7 测试 / §11 Checklist）、`docs/architecture/架构/README.md`（§7.6-7.8 工程治理）、`docs/superpowers/specs/mvp-execution-spec-design.md`（§8 技术约束）。 > 配套：可靠性/安全红线见 [`security-and-reliability.md`](security-and-reliability.md)；元流程见 [`../workflows/ai-development-protocol.md`](../workflows/ai-development-protocol.md)；事实蓝图见 [`../knowledge/product-and-architecture.md`](../knowledge/product-and-architecture.md)；模块落地手册见 [`../skills/add-business-module.md`](../skills/add-business-module.md)。 --- @@ -274,22 +274,24 @@ subject: 动词开头，简明描述（中英文均可） - **同一提交内删/归档被取代者**（强化 §10.2）：commit 设计档前**自检**——「本次提交/工作树里有无被本档取代的旧档？」有则同提交 `git rm`（过期且错）或 `git mv` 到 `_archive/`（过期但留参考）+ tombstone 横幅；**绝不把过期档单独连推上去**。 - 收口按 wave-close 第 8 步把本任务设计档**收敛成最小自洽集**（典型 1 review + 1 execution）。 -### 10.5 canonical 活档（子系统 SoT · 无日期主题名 · 2026-06-17 深度重构立） +### 10.5 canonical 活档（子系统 SoT · 2026-06-17 立 · **2026-06-20 域化重构改根**） + +> **⚠️ 2026-06-20 更新(设计文档域化重构)**:策展层设计文档的 canonical 根**已从 `docs/agent-specs/` 迁到 `docs/architecture/` 单根 6 域 4 级树**(产品/架构/后端/前端/运营/运维,人读散文·多图·单档 ≤2000 行,总索引 `docs/architecture/README.md`)。下文「无日期主题名·≤150 行·住 agent-specs」是**旧形态**,现**仅生成域设计链过渡期保留**(架构演进中);其余子系统 canonical 已迁入域树、源档归 `_archive`。判层序见下方已更新条。 > 由来：2026-06-17 创始人要求 agent-specs 从「按时间堆 review/execution/verdict 流水」改为「**每子系统一份 canonical 活档**」——dated spec 是某波次过程产物，子系统的「现行架构+目标+现状」应收敛成一份持续更新的活档。本节是 §10.4「一题一活档」在**子系统粒度**的落地。是 §10.1 dated 命名词表之外**另立的一类活档形态**（不违反 §10.1，互补）。 - **形态**：`<主题>.md`（**无日期前缀、无 type 后缀**，如 `引擎与运行时.md`/`agentic编排-SAA.md`/`战略与合规.md`）；顶部第一行标 `# <主题> · canonical（子系统 SoT）`，随附 `类型=canonical 活档 · 更新 YYYY-MM-DD / 取代=N 份历史 spec / 读法`。一子系统一份，**≤150 行**。 - **装什么**：一页结论 → 目标/非目标 → 现行架构(含必要 Mermaid) → 现状(done/在飞/待办) → 关键指针(commit/skill/契约)。**砍掉**：演进流水/逐轮评审 transcript/逐 commit 过程/取证日志/已 supersede 旧方案（留 git + `_archive/`）。 - **与 dated spec 的关系**：dated `review/execution/report`（§10.1）= 某波次工作期过程档；**波次收口时把活内容折进对应子系统 canonical**（wave-close 第 8 步），dated 源档随即 `git rm`（已折入）或 `git mv _archive/`（账本/取证类留参考 + tombstone）。canonical 之外不再久留同主题 dated 流水。 -- **分层（不双写）**：canonical（子系统 SoT·深）＞ `.agents/knowledge/*`（AI 速查一句话·浅）＞ `docs/architecture/` Doc A/B/C + 技术决策版（基线 WHAT/HOW）＞ `docs/mvp/MVP进度总账.md`（跨线状态）。重叠处 canonical 是 SoT，其余留速查 + 指针。 -- **导航**：`docs/agent-specs/_index.md` 列全部 canonical（一域一档）+ 生成域设计链 + KEEP + 归档指针。维护见记忆 `agent-specs-canonical-structure`。 +- **分层（不双写 · 2026-06-20 改根后）**：canonical ＝ `docs/architecture/` 6 域 4 级树（策展层设计 SoT·人读散文·深）＞ `.agents/knowledge/*`（AI 速查一句话·浅）＞ `docs/mvp/MVP进度总账.md`（跨线状态）。`docs/agent-specs/` 降为留痕 + spike + **生成域演进设计链(过渡期活档)**。重叠处 architecture 域树是 SoT，其余留速查 + 指针。 +- **导航**：设计文档总入口 ＝ `docs/architecture/README.md`（L1 总索引,6 域树）。`docs/agent-specs/_index.md` 降为 trace/spike 索引 + 生成域演进设计链(过渡期) + 指向新树。维护见记忆 `agent-specs-canonical-structure`。 ### 10.6 两层阅读心法 + 留痕 frontmatter + 蒸馏门（2026-06-17 文档体系重构立） > 由来：2026-06-17 文档体系重构（留痕喂料 `docs/brainstorms/2026-06-17-文档体系重构-requirements.md`，决策记忆 `docs-system-hybrid-two-layer`）。把全部文档归两层**阅读心法**（非新目录/标签，映射 §10.5 canonical + §10.1 dated 流水 + CE 的 brainstorms/plans），并补判层规则、留痕最低 frontmatter、机器可检蒸馏门。配套全局 `~/.claude/CLAUDE.md` 已退役「每任务必产 dated 双档」重量级约定。 - **两层（映射现有结构，不新建目录）**： - - **策展层（少而准·人读即现行真相）**＝canonical 活档（§10.5）+ `AGENTS.md` §1–2 前门/目标锚 + `docs/architecture/` Doc A/B/C + `docs/mvp/MVP进度总账`（模块进度**唯一 SoT＝其 §2 矩阵**）+ `.agents/`。每个概念在策展层**只有一个 SoT**。 + - **策展层（少而准·人读即现行真相）**＝`docs/architecture/` 6 域 4 级设计文档树（§10.5 canonical · 2026-06-20 改根后的设计 SoT 根）+ `AGENTS.md` §1–2 前门/目标锚 + `docs/mvp/MVP进度总账`（模块进度**唯一 SoT＝其 §2 矩阵**）+ `.agents/`。每个概念在策展层**只有一个 SoT**。 - **留痕/笔记层（放开累积·检索而非通读）**＝`docs/agent-specs/` dated `review/execution/report`（§10.1）+ `docs/brainstorms/`（WHAT 喂料）+ `docs/plans/`（HOW 喂料）+ 收口报告 + `_archive/`。允许累积、不强删，靠 git + frontmatter 检索。 - **判层规则（物理信号，零上下文 agent 据此归层）**：`_index` 标 canonical 的 + `AGENTS`/`docs/architecture`/`docs/mvp` ＝策展；`docs/{brainstorms,plans}` + agent-specs dated `` + `_archive/` ＝留痕。**「孤儿」只针对策展层**（策展 SoT 必须前门一跳可达）；留痕前门不可达＝设计如此，不算孤儿。 - **蒸馏门（治「更新不及时」的机制，非口号）**：收口若产生留痕（新 brainstorm/plan/report/dated spec），**必须产出「蒸馏 diff」（把可复用洞见提升进策展层 canonical/`.agents`）或显式声明「无可蒸馏＋理由」**（对齐 §10.2 SHIPPED 横幅与回填检查的「不回填＋理由」模式）。落 wave-close 第 5 步。 @@ -302,7 +304,7 @@ subject: 动词开头，简明描述（中英文均可） **四道门(查什么 → 红线 → 白名单):** -- **① 品牌不变量门** — 现行层(`AGENTS.md` / `.agents/` / `docs/architecture/` / `docs/mvp/` / agent-specs canonical)对退役名 `rg "造梦AI"` 必须为 0。**红线**:现行层命中即挡提交。**白名单**(允许保留旧名):`docs/ip/`(软著/专利申报材料,须与提交+源码一致)、`docs/agent-specs/_archive/`、文件名以日期开头的 dated 留痕档(反映当时认知,改了破坏 git 演进真相)。 +- **① 品牌不变量门** — 现行层(`AGENTS.md` / `.agents/` / `docs/architecture/` / `docs/mvp/` / agent-specs canonical)对退役名 `rg "造梦AI"` 必须为 0。**红线**:现行层命中即挡提交。**白名单**(允许保留旧名):`docs/ip/`(软著/专利申报材料,须与提交+源码一致)、`docs/agent-specs/_archive/`、`docs/architecture/_archive/`、文件名以日期开头的 dated 留痕档(反映当时认知,改了破坏 git 演进真相)。 - **② canonical 唯一性门** — 扫全仓 frontmatter,同一 `topic` 标 canonical / §10.5 无日期 SoT 的文档**至多一份**。**红线**:同 topic 出现第二份即挡(防 doc sprawl / 影子 SoT)。配 §10.4(被取代者同提交退役)。 - **③ doc↔code 兑现门** — keystone 设计声明的关键产物约束,必须有**机器可验断言**且收口真跑,断言「代码兑现了设计声明的 X」,而不是只在文档里写了 X。**首批断言**:生成产物 = `src/` 多文件工程(玩法逻辑落真实源码文件;**禁**「逻辑只以 JSON 字符串存在 / 运行时 `new Function` 跑内嵌串」——见 `docs/agent-specs/生成主线架构演进路线.md` ★ 终态定调)。**红线**:断言失败即「实现未兑现设计」,挡收口。这是机制上此前**完全空白**的一类门(`.agents/` grep 命中为零),也是「设计写了 src/、实现做成 JSON 串」那个根因的正解,**最高优先补**。 - **④ 入口卫生门** — `AGENTS.md` 只放项目事实。`rg` 扫禁:`git clone` / 全局工具安装命令 / 个人绝对路径(`~/.claude` 等)/ 硬编码端口。**红线**:命中即挡(这些属个人环境或会过期的细节,应由指针指向会跟着更新的活档或全局配置)。 diff --git a/.agents/rules/security-and-reliability.md b/.agents/rules/security-and-reliability.md index c23e204d..69d9c0e8 100644 --- a/.agents/rules/security-and-reliability.md +++ b/.agents/rules/security-and-reliability.md @@ -1,7 +1,7 @@ # 安全、合规、可靠性与一致性硬底线 > 本文是绘境AI 不可逾越的**红线**。涉及安全、合规、幂等、一致性、可靠性、可观测性与 SDK 降级。任何设计/实现违反即驳回。 -> 蒸馏来源：`docs/architecture/系统概要设计-技术决策版.md`（§3.4 SDK 降级 / §7.1-7.5 非功能 / §8 风险）、`docs/architecture/系统概要设计-开发团队版.md`（§4.2 / §10.5 内容安全）、`docs/architecture/技术架构与模块.md`（compliance 模块 T-CMP-* 技术功能，含锁风门 Gate）。 +> 蒸馏来源：`docs/architecture/架构/README.md`（§3.4 SDK 降级 / §7.1-7.5 非功能 / §8 风险）、`docs/architecture/架构/README.md`（§4.2 / §10.5 内容安全）、`docs/architecture/架构/13模块.md`（compliance 模块 T-CMP-* 技术功能，含锁风门 Gate）。 > 配套：编码/契约规范见 [`engineering-conventions.md`](engineering-conventions.md)；元流程见 [`../workflows/ai-development-protocol.md`](../workflows/ai-development-protocol.md)；事实蓝图见 [`../knowledge/product-and-architecture.md`](../knowledge/product-and-architecture.md)；运行时/沙箱手册见 [`../skills/runtime-and-multichannel.md`](../skills/runtime-and-multichannel.md)。 --- diff --git a/.agents/skills/add-business-module.md b/.agents/skills/add-business-module.md index ce35b8a0..ea62d1fa 100644 --- a/.agents/skills/add-business-module.md +++ b/.agents/skills/add-business-module.md @@ -1,6 +1,6 @@ # 新增业务模块操作手册（add-business-module） -> 蒸馏来源：`docs/architecture/系统概要设计-开发团队版.md`（§2 后端模块地图 / §4.1 编码规范 / §11 模块开发 Checklist）、`docs/architecture/系统概要设计-技术决策版.md`（§7.10 扩展性 / SPI）。 +> 蒸馏来源：`docs/architecture/架构/README.md`（§2 后端模块地图 / §4.1 编码规范 / §11 模块开发 Checklist）、`docs/architecture/架构/README.md`（§7.10 扩展性 / SPI）。 > 适用：在 `game-cloud` 后端新增一个 `game-module-{name}` 业务模块（如 pay / trade / community / ip / biz / ad，或后续新模块）。 > 配套：工程规范见 [`../rules/engineering-conventions.md`](../rules/engineering-conventions.md)；可靠性/数据隔离红线见 [`../rules/security-and-reliability.md`](../rules/security-and-reliability.md)；模块全景见 [`../knowledge/product-and-architecture.md`](../knowledge/product-and-architecture.md)；契约先行见 [`./contract-first-development.md`](./contract-first-development.md)；任务协议见 [`../workflows/ai-development-protocol.md`](../workflows/ai-development-protocol.md)。 diff --git a/.agents/skills/ai-generation-pipeline.md b/.agents/skills/ai-generation-pipeline.md index 614e8dcd..5375e70c 100644 --- a/.agents/skills/ai-generation-pipeline.md +++ b/.agents/skills/ai-generation-pipeline.md @@ -10,7 +10,7 @@ > > --- > -> 蒸馏来源：`docs/architecture/系统概要设计-技术决策版.md`（§4.1 AI 生成链路 / §6.2 §6.7 选型 / §7.10 产物缓存 / §8 风险）、`docs/architecture/技术架构与模块.md`（aigc/studio 模块 T-AGC-*/T-STU-* 技术功能）、`docs/architecture/系统概要设计-开发团队版.md`（§10 外部工具层开发指南 / §6.2 联调）。 +> 蒸馏来源：`docs/architecture/架构/README.md`（§4.1 AI 生成链路 / §6.2 §6.7 选型 / §7.10 产物缓存 / §8 风险）、`docs/architecture/架构/13模块.md`（aigc/studio 模块 T-AGC-*/T-STU-* 技术功能）、`docs/architecture/架构/README.md`（§10 外部工具层开发指南 / §6.2 联调）。 > 适用：开发/调试 aigc 模块（~~及其外部 AI 引擎 Dify / OpenGame / ComfyUI~~ 已降级远期，见顶部横幅）。 > 配套：降级/可靠性红线见 [`../rules/security-and-reliability.md`](../rules/security-and-reliability.md)；选型背景见 [`../knowledge/tech-decisions.md`](../knowledge/tech-decisions.md)；模块全景见 [`../knowledge/product-and-architecture.md`](../knowledge/product-and-architecture.md)；新模块流程见 [`./add-business-module.md`](./add-business-module.md)；契约见 [`./contract-first-development.md`](./contract-first-development.md)。 diff --git a/.agents/skills/contract-first-development.md b/.agents/skills/contract-first-development.md index f26fda1d..97f4da8e 100644 --- a/.agents/skills/contract-first-development.md +++ b/.agents/skills/contract-first-development.md @@ -1,6 +1,6 @@ # 契约先行与并行解耦联调手册（contract-first-development） -> 蒸馏来源：`docs/superpowers/specs/mvp-execution-spec-design.md`（§3 契约先行 / §6 并行解耦与 Mock / §8.3 联调规则）、`docs/architecture/系统概要设计-开发团队版.md`（§6 联调协议）、`docs/architecture/系统概要设计-技术决策版.md`（§7.7 API 契约与版本）。 +> 蒸馏来源：`docs/superpowers/specs/mvp-execution-spec-design.md`（§3 契约先行 / §6 并行解耦与 Mock / §8.3 联调规则）、`docs/architecture/架构/README.md`（§6 联调协议）、`docs/architecture/架构/README.md`（§7.7 API 契约与版本）。 > 适用：多工位（前端/后端/SDK/AI/数据）并行开发同一交付时，先锁契约、再各自 mock 解耦、最后集中联调。 > 配套：工程规范（错误码/API 路径/`-api` 包）见 [`../rules/engineering-conventions.md`](../rules/engineering-conventions.md)；新模块契约落地见 [`./add-business-module.md`](./add-business-module.md)；生成链路契约见 [`./ai-generation-pipeline.md`](./ai-generation-pipeline.md)；SDK 契约见 [`./runtime-and-multichannel.md`](./runtime-and-multichannel.md)；任务协议见 [`../workflows/ai-development-protocol.md`](../workflows/ai-development-protocol.md)。 diff --git a/.agents/skills/runtime-and-multichannel.md b/.agents/skills/runtime-and-multichannel.md index 82069026..24a791c6 100644 --- a/.agents/skills/runtime-and-multichannel.md +++ b/.agents/skills/runtime-and-multichannel.md @@ -1,6 +1,6 @@ # 运行时、Game SDK 与多渠道导出手册（runtime-and-multichannel） -> 蒸馏来源：`docs/architecture/系统概要设计-技术决策版.md`（§3.4 Game SDK / §4.2 运行时三容器 / §6.6 运行时与导出选型）、`docs/architecture/技术架构与模块.md`（runtime 模块 T-RT-* 技术功能）、`docs/architecture/系统概要设计-开发团队版.md`（§2 模块地图 / §10.4 LayaAir CLI）。 +> 蒸馏来源：`docs/architecture/架构/README.md`（§3.4 Game SDK / §4.2 运行时三容器 / §6.6 运行时与导出选型）、`docs/architecture/架构/13模块.md`（runtime 模块 T-RT-* 技术功能）、`docs/architecture/架构/README.md`（§2 模块地图 / §10.4 LayaAir CLI）。 > 适用：开发/调试 runtime 模块、WanxiangGameSDK、多渠道（微信/抖音/快手）小游戏导出。 > 配套：SDK 降级铁律与沙箱安全红线见 [`../rules/security-and-reliability.md`](../rules/security-and-reliability.md)；工程规范见 [`../rules/engineering-conventions.md`](../rules/engineering-conventions.md)；架构全景见 [`../knowledge/product-and-architecture.md`](../knowledge/product-and-architecture.md)；上游生成见 [`./ai-generation-pipeline.md`](./ai-generation-pipeline.md)；契约见 [`./contract-first-development.md`](./contract-first-development.md)。 > **⚠️ 状态升级（2026-06-12 终裁，取代 2026-06-11 待 spike 表述）**：本手册「自研 Canvas Runtime(<15KB)」相关段落=**1.x 历史口径，渲染层已改判**。现行裁决： diff --git a/.agents/tools/check-deadlinks.sh b/.agents/tools/check-deadlinks.sh new file mode 100755 index 00000000..6548faf6 --- /dev/null +++ b/.agents/tools/check-deadlinks.sh @@ -0,0 +1,39 @@ +#!/usr/bin/env bash +# 死链门(engineering-conventions §10.7 死链项的可执行脚本 · 2026-06-20 域化重构补) +# 扫 docs/ + .agents/ 下 md 的仓内相对链接,报指向不存在文件的死链。 +# 排除:_archive/(留痕,允许指旧路径)、外链(http/mailto)、纯锚点(#...)。 +# 用法:bash .agents/tools/check-deadlinks.sh —— 退出码 = 死链数(0=干净)。 +set -uo pipefail +ROOT="$(cd "$(dirname "$0")/../.." && pwd)" +python3 - "$ROOT" <<'PY' +import os, re, sys +root = sys.argv[1] +link = re.compile(r'\[[^\]]*\]\(([^)]+)\)') +bad = 0 +exclude = ('/_archive/', '/node_modules/', '/target/', '模型评估矩阵', 'generation-spike', 'channel-spike', 'tier1-engine-spike', 'agent-loop-v1') +for base in ('docs', '.agents'): + for dp, _, fs in os.walk(os.path.join(root, base)): + if any(x in dp + '/' for x in exclude): + continue + for fn in fs: + if not fn.endswith('.md'): + continue + fp = os.path.join(dp, fn) + try: + txt = open(fp, encoding='utf-8', errors='ignore').read() + except Exception: + continue + for m in link.finditer(txt): + t = m.group(1).strip() + if t.startswith(('http://', 'https://', '#', 'mailto:', '<', '@')) or ',' in t: + continue + t = t.split('#')[0].split(' ')[0].strip() + if not t: + continue + tgt = os.path.normpath(os.path.join(dp, t)) + if not os.path.exists(tgt): + print(f'DEADLINK {os.path.relpath(fp, root)} -> {m.group(1)}') + bad += 1 +print(f'--- 死链数: {bad} ---') +sys.exit(1 if bad else 0) +PY diff --git a/AGENTS.md b/AGENTS.md index dc76b4db..e7c43e59 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -39,7 +39,7 @@ MVP 目标:交付一条 **种子用户可试用的全链路闭环** —— creat > - **MVP execution spec(HJ-MVP-SPEC-001):** **10 人 × 3 周(15 个工作日)**,强调 contract-first + 五工位并行。验收 = Doc A 中的 **55 个 P0 产品功能**;工作量 **≈ 137 个技术项**。 > - 生成成功率:**采用 execution spec 的 ≥80%**(投资人版未给直接数字)。引用指标时要对应到相应文档。 > -> **日常默认 = MVP execution-spec 版**(10 人 × 3 周 / 55 P0 / ≈137 技术项);投资人版仅用于对外 / 资本效率叙述,不作为日常执行基线。**本 §1–2 即是顶层目标锚点的 single source of truth**(当前 MVP 目标 = 上面那一行全链路闭环)。明细归宿 —— `docs/mvp/goals.md`(章程)、`.agents/knowledge/mvp-scope-and-milestones.md`(55 P0 明细)、`docs/agent-specs/战略与合规.md`(护城河 / 合规)—— 从这里通过指针展开;不要另立一份平行的目标文档。 +> **日常默认 = MVP execution-spec 版**(10 人 × 3 周 / 55 P0 / ≈137 技术项);投资人版仅用于对外 / 资本效率叙述,不作为日常执行基线。**本 §1–2 即是顶层目标锚点的 single source of truth**(当前 MVP 目标 = 上面那一行全链路闭环)。明细归宿 —— `docs/mvp/goals.md`(章程)、`.agents/knowledge/mvp-scope-and-milestones.md`(55 P0 明细)、`docs/architecture/运营/合规闸门.md`(护城河 / 合规)—— 从这里通过指针展开;不要另立一份平行的目标文档。 --- @@ -69,7 +69,7 @@ games-development-ai/ ├── game-studio/ # 产品前端(创作者 + 玩家;见 game-studio/.agent) ├── deploy/ # 部署与 smoke-gate 脚本(smoke-test.sh) ├── docs/ -│ ├── architecture/ # 6 份架构文档(投资人 / 技术决策 / 开发团队版 + Three-Doc Suite:产品需求 · 技术架构与模块 · 需求模块映射) +│ ├── architecture/ # 设计文档 SoT 根(2026-06-20 域化重构):README 总索引 + 6 域(产品/架构含生成引擎🚧/后端/前端/运营/运维)4 级人读散文树;旧长档归 _archive │ ├── agent-specs/ # review/execution specs + close-out reports + _index.md(活地图·先读,辨活/死/被谁推翻)+ agent-loop orchestrator 与 runs(见 orchestrator/.agent) │ ├── superpowers/specs/ # execution 级 specs,如 MVP execution spec │ ├── mvp/ # 活账本:进度总账 / 作战清单(+历史归档)/ 闸门看板 / 单位经济模型 @@ -84,9 +84,9 @@ games-development-ai/ - **策展层(少而准 · 读它 = 当前真相)** —— 每个概念一份 SoT: - 顶层目标 / 定位 → 本文件 §1–2(MVP 目标锚点) - - 产品 WHAT / 技术 HOW / 映射 → Doc A/B/C(§4 表) + - 产品 WHAT / 技术 HOW / 映射 / 各子系统现行架构 → `docs/architecture/` 6 域设计树(2026-06-20 改根;§4 表,总索引 README) - 横切进度 + 13 模块完成度 → `docs/mvp/MVP进度总账.md`(**模块进度单一 SoT = 其 §2 矩阵**) - - 各子系统的当前架构 → `docs/agent-specs/` 下的 canonical 活档(无日期主题名;见 `_index.md`) + - 各子系统的当前架构 → `docs/architecture/` 对应域(2026-06-20 改根;生成引擎子树 🚧 架构演进中);`docs/agent-specs/` 降为留痕 + 生成域演进设计链 - 可复用能力 / 规则 / playbook → `.agents/` - **留痕层(放开累积 · 检索,不要线性通读)** —— 前门给出单一检索入口,而非逐文件链接: - 设计 / 任务喂料:`docs/brainstorms/`(WHAT)、`docs/plans/`(HOW),以及 `docs/agent-specs/` 下带日期的 `review/execution/report` @@ -101,23 +101,20 @@ games-development-ai/ - **§5 = 13 个后端业务模块速查**:studio · project · aigc · runtime · feed · telemetry · pay · trade · community · ip · compliance · biz · ad; - 配 **§3 分层架构** · **§4 三仓与模块归属** · **§6 模块依赖图** · **§8 Game SDK 分层**。 -- **更深一层**的子系统现行架构(生成主线 SAA 16 节点图 / 引擎与运行时 / 渠道发行 / studio 前端设计体系 / 变现与单位经济 等)→ `docs/agent-specs/` 下的 canonical 活档,导航见 [`docs/agent-specs/_index.md`](docs/agent-specs/_index.md)。 +- **更深一层**的子系统现行架构(生成主线 / 引擎与运行时 / 渠道发行 / studio 前端 / 变现与单位经济 等)→ `docs/architecture/` 6 域树(2026-06-20 改根),导航见 [`docs/architecture/README.md`](docs/architecture/README.md);生成引擎子树 🚧 演进中。 --- ## 4. 任何任务开工前的必读顺序 -下面 5 份文档构成项目的完整图景。**首次 onboarding 或架构级任务时,按顺序通读**;日常开发则 **优先读 [`.agents/knowledge/`](.agents/knowledge/) 下的蒸馏版**,只有在需要细节时才回溯到原始长文档。 +**设计文档已于 2026-06-20 域化重构**:策展层设计 SoT 根 = [`docs/architecture/README.md`](docs/architecture/README.md)(总索引,6 域 4 级人读散文树)。首次 onboarding 或架构级任务从它进;日常开发优先读 [`.agents/knowledge/`](.agents/knowledge/) 蒸馏版。 | 顺序 | 文档 | 角色 | |---|---|---| -| 1 | `docs/architecture/系统概要设计-投资人版.md` | 业务定位、资本效率、护城河与窗口期 | -| 2 | Three-Doc Suite: `docs/architecture/产品需求清单.md`(Doc A · 产品 WHAT)/ `docs/architecture/技术架构与模块.md`(Doc B · 技术 HOW · 13 模块)/ `docs/architecture/需求模块映射.md`(Doc C · RTM) | 产品需求 / 技术模块 / M:N 映射(取代旧的"业务能力总览") | -| 3 | `docs/architecture/系统概要设计-技术决策版.md` | 完整的技术决策图景(架构基线) | -| 4 | `docs/architecture/系统概要设计-开发团队版.md` | 日常开发手册（⚠️ target-state 设计:环境 / 命令与现实有出入 —— 改以 `.agents/rules` + `docs/mvp/MVP进度总账.md` 为准;见文档内的状态横幅,2026-06-10 审计） | -| 5 | `docs/superpowers/specs/mvp-execution-spec-design.md` | MVP execution spec:10 人 × 3 周,contract-first(验收 = 55 个 P0 产品功能 / 工作量 ≈ 137 个技术项,正文已同步) | +| 1 | **[`docs/architecture/README.md`](docs/architecture/README.md)(设计文档总索引 · 唯一入口)** | 6 域设计树:产品(定位/需求/护城河)· 架构(分层/技术决策/13 模块 / **生成引擎 🚧 演进中**)· 前端 · 运营(变现/渠道/合规)· 后端 · 运维。**取代旧的系统概要设计×3 + Three-Doc Suite**(原档已归 `docs/architecture/_archive/`,决策史留档) | +| 2 | `docs/superpowers/specs/mvp-execution-spec-design.md` | MVP execution spec:10 人 × 3 周,contract-first(验收 = 55 个 P0 产品功能 / 工作量 ≈ 137 个技术项) | -> 提示:原始文档很长;通篇读完会拖慢任务。**蒸馏版位于 `.agents/knowledge/`,是日常默认入口。** +> 提示:**蒸馏版位于 `.agents/knowledge/`,是日常默认入口**;设计细节进 6 域树按需下钻。 --- diff --git a/docs/agent-specs/studio前端设计体系.md b/docs/agent-specs/_archive/studio前端设计体系.md similarity index 97% rename from docs/agent-specs/studio前端设计体系.md rename to docs/agent-specs/_archive/studio前端设计体系.md index 3330785d..1df02202 100644 --- a/docs/agent-specs/studio前端设计体系.md +++ b/docs/agent-specs/_archive/studio前端设计体系.md @@ -1,3 +1,5 @@ +> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `docs/architecture/前端/README.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。 + # studio 前端设计体系 · canonical（子系统 SoT） > 类型=canonical 活档（子系统单一事实源）· 更新 2026-06-17 diff --git a/docs/agent-specs/变现与单位经济.md b/docs/agent-specs/_archive/变现与单位经济.md similarity index 97% rename from docs/agent-specs/变现与单位经济.md rename to docs/agent-specs/_archive/变现与单位经济.md index 7dc1862e..9aa4b6c7 100644 --- a/docs/agent-specs/变现与单位经济.md +++ b/docs/agent-specs/_archive/变现与单位经济.md @@ -1,3 +1,5 @@ +> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `docs/architecture/运营/变现与单位经济.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。 + # 变现与单位经济 · canonical(子系统 SoT) > 类型=canonical 活档(子系统单一事实源)· 更新 2026-06-17 diff --git a/docs/agent-specs/战略与合规.md b/docs/agent-specs/_archive/战略与合规.md similarity index 96% rename from docs/agent-specs/战略与合规.md rename to docs/agent-specs/_archive/战略与合规.md index 476b8bf8..c4f882e5 100644 --- a/docs/agent-specs/战略与合规.md +++ b/docs/agent-specs/_archive/战略与合规.md @@ -1,3 +1,5 @@ +> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `docs/architecture/运营/合规闸门.md + docs/architecture/产品/商业定位.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。 + # 战略与合规 · canonical（子系统 SoT） > 类型=canonical 活档（子系统单一事实源）· 更新 2026-06-17 diff --git a/docs/agent-specs/渠道发行.md b/docs/agent-specs/_archive/渠道发行.md similarity index 97% rename from docs/agent-specs/渠道发行.md rename to docs/agent-specs/_archive/渠道发行.md index ee773bdb..77ce53a5 100644 --- a/docs/agent-specs/渠道发行.md +++ b/docs/agent-specs/_archive/渠道发行.md @@ -1,3 +1,5 @@ +> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `docs/architecture/运营/渠道发行.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。 + # 渠道发行 · canonical(子系统 SoT) > 类型=canonical 活档(子系统单一事实源)· 更新 2026-06-17 diff --git a/docs/agent-specs/_index.md b/docs/agent-specs/_index.md index 7ce1a513..ec5a61d5 100644 --- a/docs/agent-specs/_index.md +++ b/docs/agent-specs/_index.md @@ -1,25 +1,29 @@ # agent-specs 活地图（_index） -> **用途**：本目录单一导航。**settled 子系统 = canonical 活档**(一域一档·无日期·SoT,读它即知现行)；**生成域 = 设计链**(固定架构+SAA studio，他 session 收敛中)；历史/决策史见 `_archive/` + git。 +> **⚠️ 2026-06-20 设计文档域化重构**:settled 子系统 canonical **已迁入 `docs/architecture/` 6 域树**(读那里即知现行,总索引 [`../architecture/README.md`](../architecture/README.md));本 _index 降为 **trace/spike 索引 + 生成域演进设计链(🚧 过渡期保留)**。历史/决策史见 `_archive/` + git。 > **维护**：波次收口按 [`.agents/skills/wave-close-checklist.md`](../../.agents/skills/wave-close-checklist.md) 第 8 步；命名/分层见 [`.agents/rules/engineering-conventions.md`](../../.agents/rules/engineering-conventions.md) §10。 > **2026-06-17 双线重构**：settled 7 域→canonical（Phase A·本 session，[`2026-06-17-agent-specs深度重构-plan.md`](2026-06-17-agent-specs深度重构-plan.md)）；生成域设计链收敛（他 session：固定架构 + 一题一活档规则）。两线已合入 dev/2.0.0。 --- -## 1. canonical 活档（settled 子系统 SoT · 一域一档 · 读它即知现行） +## 1. 子系统 canonical（settled 域已迁入 `docs/architecture/` 域树) -- [`agentic编排-SAA.md`](agentic编排-SAA.md) — HJ-AGI-002 SAA 裸图 StateGraph 编排基建（架构/六不变量/split-brain 铁律/orchestrator 边界） -- [`开闸验收门-W-G1.md`](开闸验收门-W-G1.md) — 一句话生成对外开闸 6 门（组A 控制平面+GP9 / 组B 落库 / 组C 首局门 / G0G1 前置） -- [`引擎与运行时.md`](引擎与运行时.md) — LittleJS 增强发行版（55KB gz，06-12 终裁）+ Runner v2 两层装载契约 + engineBundle 内嵌；含★模板术语纠偏 -- [`渠道发行.md`](渠道发行.md) — HJ-CH-001（一壳多游 L1 / L2 不上渠道 / 合规闸门 / 引擎竞标 C-A vs C-B） -- [`studio前端设计体系.md`](studio前端设计体系.md) — HJ-FE-DS-001（token 两层 / i18n 双语 / 三主题 / 创始人 5 决议） -- [`变现与单位经济.md`](变现与单位经济.md) — 收益闭环④ + new-api 成本源 + 单位经济模型 + 资金一致性红线 -- [`战略与合规.md`](战略与合规.md) — 四雷 R1-R4 / 三线变现 / 合规闸门（指 A1 看板）/ demo 定位纠偏（HJ-DEMO-AUDIT-001） -- [`prompt治理体系-execution.md`](prompt治理体系-execution.md) — Prompt 第 8 契约（Registry / load-inject / 门禁 / HITL） +> 以下 settled 子系统的 canonical 内容已重写并迁入 6 域树,**读新树**;原 agent-specs 档已归 `_archive`。 + +- 渠道发行 → [`../architecture/运营/渠道发行.md`](../architecture/运营/渠道发行.md) +- studio 前端设计体系 → [`../architecture/前端/README.md`](../architecture/前端/README.md) +- 变现与单位经济 → [`../architecture/运营/变现与单位经济.md`](../architecture/运营/变现与单位经济.md) +- 战略与合规 → 战略入 [`../architecture/产品/商业定位.md`](../architecture/产品/商业定位.md) · 合规入 [`../architecture/运营/合规闸门.md`](../architecture/运营/合规闸门.md) + +**生成域 canonical（🚧 过渡期保留为活档;新树对应子档亦在演进):** +- [`agentic编排-SAA.md`](agentic编排-SAA.md) → 新树 [`架构/生成引擎/SAA编排.md`](../architecture/架构/生成引擎/SAA编排.md) +- [`开闸验收门-W-G1.md`](开闸验收门-W-G1.md) → [`架构/生成引擎/验收门-W-G1.md`](../architecture/架构/生成引擎/验收门-W-G1.md) +- [`引擎与运行时.md`](引擎与运行时.md) → [`架构/生成引擎/引擎与运行时.md`](../architecture/架构/生成引擎/引擎与运行时.md) +- [`prompt治理体系-execution.md`](prompt治理体系-execution.md) → [`架构/生成引擎/prompt治理.md`](../architecture/架构/生成引擎/prompt治理.md) --- -## 2. 生成域（HJ-GEN-001 设计链 · 他 session 收敛中） +## 2. 生成域（HJ-GEN-001 设计链 · 🚧 架构演进中 · 本 session 维护,在飞红线已解除 `1101d016`） ### ★ 协作总账（三 session 分权 · 派活/接手先读） - `2026-06-17-多session分工与任务总账.md` — 三阶段/两开发线/增量集成 + 角色分权（Mac 实现 / 6c6g 独立评审+真机验 / studio 前端）；取代 `生成引擎-并行编排`(模块切分版) diff --git a/docs/architecture/产品需求清单.md b/docs/architecture/_archive/产品需求清单.md similarity index 98% rename from docs/architecture/产品需求清单.md rename to docs/architecture/_archive/产品需求清单.md index 3fcb4576..3d6bb872 100644 --- a/docs/architecture/产品需求清单.md +++ b/docs/architecture/_archive/产品需求清单.md @@ -1,3 +1,5 @@ +> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `产品/需求清单.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。 + # 绘境AI — 产品需求清单（Doc A） > 文档类型：**Doc A｜产品需求清单**（面向用户/产品，回答 WHAT） diff --git a/docs/architecture/技术架构与模块.md b/docs/architecture/_archive/技术架构与模块.md similarity index 99% rename from docs/architecture/技术架构与模块.md rename to docs/architecture/_archive/技术架构与模块.md index 4587516b..7b6cdc46 100644 --- a/docs/architecture/技术架构与模块.md +++ b/docs/architecture/_archive/技术架构与模块.md @@ -1,3 +1,5 @@ +> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `架构/13模块.md + 后端/README.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。 + # 绘境AI — 技术架构与模块（Doc B） > 文档类型：**Doc B｜技术架构与模块**（面向工程/领域，回答 HOW + 对象边界） diff --git a/docs/architecture/护城河对外话术-双版本.md b/docs/architecture/_archive/护城河对外话术-双版本.md similarity index 97% rename from docs/architecture/护城河对外话术-双版本.md rename to docs/architecture/_archive/护城河对外话术-双版本.md index 40118c5c..a52d6d22 100644 --- a/docs/architecture/护城河对外话术-双版本.md +++ b/docs/architecture/_archive/护城河对外话术-双版本.md @@ -1,3 +1,5 @@ +> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `产品/护城河话术.md + 产品/商业定位.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。 + # 绘境AI 护城河对外话术（双版本） > **用途**：融资沟通的口径基准。**版本 A 投资人面**（定位/电梯/三段式/钉子问题）；**版本 B 技术 DD 面**（诚实技术口径 + 红线 + 自研边界 + 工程亮点）。 diff --git a/docs/architecture/系统概要设计-开发团队版.md b/docs/architecture/_archive/系统概要设计-开发团队版.md similarity index 99% rename from docs/architecture/系统概要设计-开发团队版.md rename to docs/architecture/_archive/系统概要设计-开发团队版.md index defe7be2..3ee74901 100644 --- a/docs/architecture/系统概要设计-开发团队版.md +++ b/docs/architecture/_archive/系统概要设计-开发团队版.md @@ -1,3 +1,5 @@ +> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `架构/README.md + 运维/README.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。 + # 绘境AI游戏生态平台 — 系统概要设计（开发团队版） > **文档编号**：HJ-ARCH-003 diff --git a/docs/architecture/系统概要设计-技术决策版.md b/docs/architecture/_archive/系统概要设计-技术决策版.md similarity index 99% rename from docs/architecture/系统概要设计-技术决策版.md rename to docs/architecture/_archive/系统概要设计-技术决策版.md index 6e5e0271..f9063861 100644 --- a/docs/architecture/系统概要设计-技术决策版.md +++ b/docs/architecture/_archive/系统概要设计-技术决策版.md @@ -1,3 +1,5 @@ +> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `架构/README.md + 架构/13模块.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。 + # 绘境AI游戏生态平台 — 系统概要设计（技术决策版） > **文档编号**：HJ-ARCH-001 diff --git a/docs/architecture/系统概要设计-投资人版.md b/docs/architecture/_archive/系统概要设计-投资人版.md similarity index 98% rename from docs/architecture/系统概要设计-投资人版.md rename to docs/architecture/_archive/系统概要设计-投资人版.md index 32073479..fb44d77d 100644 --- a/docs/architecture/系统概要设计-投资人版.md +++ b/docs/architecture/_archive/系统概要设计-投资人版.md @@ -1,3 +1,5 @@ +> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `产品/商业定位.md + 运营/变现与单位经济.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。 + # 绘境AI游戏生态平台 — 系统概要设计（投资人版） > **文档编号**：HJ-ARCH-002 diff --git a/docs/architecture/需求模块映射.md b/docs/architecture/_archive/需求模块映射.md similarity index 98% rename from docs/architecture/需求模块映射.md rename to docs/architecture/_archive/需求模块映射.md index ff033c1c..2196dc44 100644 --- a/docs/architecture/需求模块映射.md +++ b/docs/architecture/_archive/需求模块映射.md @@ -1,3 +1,5 @@ +> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `产品/需求模块映射.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。 + # 绘境AI — 需求↔模块 映射（Doc C） > 文档类型：**Doc C｜产品功能 ↔ 技术功能 追溯映射**（唯一承载 M:N 关系的文档） diff --git a/docs/architecture/前端/README.md b/docs/architecture/前端/README.md index 986e5388..dbc4356f 100644 --- a/docs/architecture/前端/README.md +++ b/docs/architecture/前端/README.md @@ -3,7 +3,7 @@ > **这是什么**:绘境AI 前端域的设计主文档,回答"**两个前端长什么样、靠什么撑起一致的体验**"。它聚焦设计体系(design system)这一层——即把颜色、间距、字体、组件、主题、多语言这些"视觉与交互的共同语言"统一沉淀下来,让所有界面看起来像同一个产品。 > **给谁看**:前端工程师、设计师、产品经理、新加入的同事、外部技术尽调。 > **怎么读**:先读本页建立全局认知——我们有哪两个前端、它们各服务谁、设计体系分几层、为什么这么分、创始人定下了哪些不可动摇的硬约束;需要某条具体令牌(token)的取值或某个组件的签名时,再回到代码里的权威源文件(文末有指针)。 -> **读这一页 = 前端设计体系的当前真相**。它从子系统活档 `docs/agent-specs/studio前端设计体系.md` 蒸馏而来,只取其架构骨架与关键决策的"为什么";逐令牌清单、逐组件实现、构建与走查的具体命令不在这里(分别交给代码里的 `tokens.css` 与 `.agents/skills/` 下的操作手册)。 +> **读这一页 = 前端设计体系的当前真相**。它从子系统活档 `docs/architecture/前端/README.md` 蒸馏而来,只取其架构骨架与关键决策的"为什么";逐令牌清单、逐组件实现、构建与走查的具体命令不在这里(分别交给代码里的 `tokens.css` 与 `.agents/skills/` 下的操作手册)。 --- @@ -215,7 +215,7 @@ token 还承担一个长期使命:**做跨端的单一事实源**(single source | 你想找 | 去哪里 | |---|---| | 逐令牌的权威取值 | `game-studio/src/styles/tokens.css`(token 单一事实源) | -| 子系统活档(本档的来源) | `docs/agent-specs/studio前端设计体系.md` | +| 子系统活档(本档的来源) | `docs/architecture/前端/README.md` | | 可直接打开的设计稿(含实时中英 + 三主题切换,真 Chrome 验过) | `docs-design/studio-redesign-mockup.html` | | 设计基准原型(只取设计语言,不取布局) | `docs-design/huijing-ai-demo.html` | | 构建门与真机走查的操作配方 | `.agents/skills/staging-ops.md`(构建真门 = `npm run build` / `vue-tsc -b && vite build`;注意 `vue-tsc --noEmit` 是假门不算数)、`.agents/skills/ui-walkthrough-cdp.md`(CDP 三主题 × 双语走查) | diff --git a/docs/architecture/架构/README.md b/docs/architecture/架构/README.md index b918707e..d99d4207 100644 --- a/docs/architecture/架构/README.md +++ b/docs/architecture/架构/README.md @@ -198,7 +198,7 @@ flowchart TB - **专区 Zone**:运营用的双轨分区(授权 IP 区 / UGC 用户原创区),owner 是 project;feed 据它分区推荐,ip 据它双轨归类。UGC = User Generated Content,用户生成内容。 - **锁风门 Gate**(T-CMP-12):一道"风格-版权一致性"门,owner 是 compliance。它聚合 aigc 的风格检测原子(T-AGC-19)和 ip 的 IP 风格校验原子(T-IP-04),裁决 pass / review / block,挂在 project 的发布前检查(T-PRJ-05)上。"锁风"= 锁定风格、防侵权。 -> 各模块卡片(职责 IN/OUT 边界、技术功能 T-id 清单)与重划状态详见 `docs/architecture/技术架构与模块.md`;真/桩/未建的实时状态以 `docs/mvp/MVP进度总账.md` 为准。**冲突时口径:状态 > 实现 > 结构**。 +> 各模块卡片(职责 IN/OUT 边界、技术功能 T-id 清单)与重划状态详见 `docs/architecture/架构/13模块.md`;真/桩/未建的实时状态以 `docs/mvp/MVP进度总账.md` 为准。**冲突时口径:状态 > 实现 > 结构**。 --- diff --git a/docs/architecture/运营/README.md b/docs/architecture/运营/README.md index f8ee6d2b..65a648d8 100644 --- a/docs/architecture/运营/README.md +++ b/docs/architecture/运营/README.md @@ -41,7 +41,7 @@ flowchart LR G -. 合规定性约束 .-> 变现 ``` -> 这里有一个**反直觉但关键的战略判定**:绘境AI 的差异化护城河 **不在"自有 feed 形态"本身**(那块早有现任者——摸摸鱼 / 233 / 4399 占着),**而在 AI 供给侧的成本结构**(用 agent 闭环把游戏的生成与质检全自动化,产能成本远低于人工)+ **IP 锁风保真**(下文 §2.3 解释)。运营域的所有安排都服务于把这个成本优势,在监管窗口期内滚成内容资产与数据飞轮。这一判定的来由与四颗"雷"的收口结论,见[战略与合规](../../agent-specs/战略与合规.md)。 +> 这里有一个**反直觉但关键的战略判定**:绘境AI 的差异化护城河 **不在"自有 feed 形态"本身**(那块早有现任者——摸摸鱼 / 233 / 4399 占着),**而在 AI 供给侧的成本结构**(用 agent 闭环把游戏的生成与质检全自动化,产能成本远低于人工)+ **IP 锁风保真**(下文 §2.3 解释)。运营域的所有安排都服务于把这个成本优势,在监管窗口期内滚成内容资产与数据飞轮。这一判定的来由与四颗"雷"的收口结论,见[战略与合规](../../architecture/运营/合规闸门.md)。 --- @@ -108,7 +108,7 @@ flowchart LR N -->|带 IP| P2["平台恒留 0.2N"] ``` -> **诚信红线**:对创作者宣传"能赚钱",必须用"头部款"口径(eCPM 30 时,单款约需每日 12 次激励视频观看才能达到 5 元提现门槛——头部款可达,长尾款达不到),**绝不做普遍性承诺**。分账的工程实现(7 个资金动作各自的幂等键、打款异步化、资金一致性红线)与完整敏感性模型,见[变现与单位经济](../../agent-specs/变现与单位经济.md)。 +> **诚信红线**:对创作者宣传"能赚钱",必须用"头部款"口径(eCPM 30 时,单款约需每日 12 次激励视频观看才能达到 5 元提现门槛——头部款可达,长尾款达不到),**绝不做普遍性承诺**。分账的工程实现(7 个资金动作各自的幂等键、打款异步化、资金一致性红线)与完整敏感性模型,见[变现与单位经济](../../architecture/运营/变现与单位经济.md)。 ### 2.3 发行:自有 H5 流 + 双渠道精选,两条腿走路 @@ -133,7 +133,7 @@ flowchart TB - **GameConfig 合规红线(渠道生死线)**:配置里禁止任何可执行 / 可被解释为代码的字符串(例如 `condition: "score>10"` 这种把逻辑写进数据的写法一律禁),剧情 / 关卡只能用有限状态机的枚举来表达,所有 `templateId / actionType / assetId` 都走枚举白名单,schema 关闭额外属性、限死数值与长度。这条红线转正后会成为契约里的第 9c 条。 - **备案锁是比版号更紧的决定性闸门**:官方规定"备案完成后不支持改游戏内容 / icon / 代码,实质变更须重新备案",这让"一壳多游"从"灰区可行"降级为"高风险待裁"。因此"当日热发新游进渠道"这个叙事被收回了——热发只限既有游戏的非实质参数微调,实质变更要走"重新备案 + 整包提审"的月级节奏(具体边界待律所裁定)。注意:这条锁只约束渠道,**不影响自有 H5 流**(H5 无备案锁)。 -至于渠道线该用哪个引擎打包(LittleJS 自研适配 vs Cocos 原生导出)、双端各出一包的工程细节、真机取证的七道验证门,见[渠道发行](../../agent-specs/渠道发行.md)。 +至于渠道线该用哪个引擎打包(LittleJS 自研适配 vs Cocos 原生导出)、双端各出一包的工程细节、真机取证的七道验证门,见[渠道发行](../../architecture/运营/渠道发行.md)。 --- @@ -187,7 +187,7 @@ flowchart TB ## 4. 还没拍板的事(活 · 阻塞 · 不可擅改) -运营域里有几件事**还压在创始人手上**,agent 不可擅自改动,登记在此以防失踪(明细见[战略与合规](../../agent-specs/战略与合规.md) §6): +运营域里有几件事**还压在创始人手上**,agent 不可擅自改动,登记在此以防失踪(明细见[战略与合规](../../architecture/运营/合规闸门.md) §6): - **合规死锁的最后一公里**:Doc A(产品需求清单)里那 8 项法定 P0 的换血,要等律所就两个核心问题(UGC 的出版物定性 / 防沉迷接入方式)给出意见后才能定。这是当前最大的外部阻塞。 - **示例模板 / 创作起步面的去留**:早期 demo 里的"模板浏览 / 玩法模板中心"等入口要删除、降级还是重定义为"示例 Prompt 库 / 灵感画廊",会直接增删 55 项 P0 的验收集。 @@ -203,9 +203,9 @@ flowchart TB | 文档 | 回答什么 | |---|---| -| [变现与单位经济](../../agent-specs/变现与单位经济.md) | 两平面 / 两钱包的架构边界、广告分账→钱包→提现的收益闭环、7 个资金动作的幂等键、分账公式与 eCPM 敏感性、资金一致性红线 | -| [渠道发行](../../agent-specs/渠道发行.md) | 自有 H5 流与微信 / 抖音渠道的分工根因、L1 一壳多游模式、GameConfig 合规红线(契约 9c)、渠道引擎竞标(LittleJS vs Cocos)、真机取证七门 | -| [战略与合规](../../agent-specs/战略与合规.md) | 战略总判定(四颗雷收口)、三线变现排序、合规死锁与双层定性、单位经济地基、demo↔产品定位纠偏、待创始人拍板项 | +| [变现与单位经济](../../architecture/运营/变现与单位经济.md) | 两平面 / 两钱包的架构边界、广告分账→钱包→提现的收益闭环、7 个资金动作的幂等键、分账公式与 eCPM 敏感性、资金一致性红线 | +| [渠道发行](../../architecture/运营/渠道发行.md) | 自有 H5 流与微信 / 抖音渠道的分工根因、L1 一壳多游模式、GameConfig 合规红线(契约 9c)、渠道引擎竞标(LittleJS vs Cocos)、真机取证七门 | +| [战略与合规](../../architecture/运营/合规闸门.md) | 战略总判定(四颗雷收口)、三线变现排序、合规死锁与双层定性、单位经济地基、demo↔产品定位纠偏、待创始人拍板项 | 跨域的两个跟踪 / 计算面(状态会变,以它们为准): diff --git a/docs/architecture/运营/变现与单位经济.md b/docs/architecture/运营/变现与单位经济.md index 6c64e4fa..3f6f5254 100644 --- a/docs/architecture/运营/变现与单位经济.md +++ b/docs/architecture/运营/变现与单位经济.md @@ -90,7 +90,7 @@ flowchart LR ## 3. 成本侧:new-api 是唯一的权威成本源 -绘境AI 的整套技术哲学是**用开源生态组合而非烧钱自研**(详见[投资人版概要设计](../系统概要设计-投资人版.md)),把钱省下来花在竞品做不了的事上——游戏流分发和变现闭环。这一节回答"那生成一款游戏到底花多少钱"。 +绘境AI 的整套技术哲学是**用开源生态组合而非烧钱自研**(详见[投资人版概要设计](../_archive/系统概要设计-投资人版.md)),把钱省下来花在竞品做不了的事上——游戏流分发和变现闭环。这一节回答"那生成一款游戏到底花多少钱"。 结论先行:**文本生成根本不是成本瓶颈。** ¥0.031 是**旧填参路径(LLM 填参)的文本 token 下界**实测值(merge-prod-20 这一批 20 个创意、57 次调用、19 个被采纳的实测口径,单次 LLM 调用约 ¥0.0103)。注意 2026-06-12 创始人拍板「模板=引擎能力插件、每款游戏=agent 写码、填参主线作废」后,当前主线单款成本改按分档工程预算 **L1-agentic P75≤¥0.15/款【假设·待 W-G1 实测】**(约旧值 4.8 倍),不要把 ¥0.031 误读为当前主线现价。即便按 ¥0.15 的新口径,单款也远不到 1 元。真正可能咬人的成本是图片/音乐这类素材生成的 GPU 开销(目前 ComfyUI 未部署,零数据)和人工审核兜底,这两项列为后续单位经济埋点(内部代号 **W4**,即按游戏粒度的成本/收益数据回路)的测量项。 @@ -168,7 +168,7 @@ eCPM 取三档做敏感性扫描:**悲观 15 / 基准 30 / 乐观 60 元/千次* ## 7. 资本效率视角:成本、团队、Runway -这一节从投资人尽调的角度收口——把上面的单位经济放进整体资本效率的叙事里。源头是[投资人版概要设计](../系统概要设计-投资人版.md)(文档编号 HJ-ARCH-002)。 +这一节从投资人尽调的角度收口——把上面的单位经济放进整体资本效率的叙事里。源头是[投资人版概要设计](../_archive/系统概要设计-投资人版.md)(文档编号 HJ-ARCH-002)。 ### 7.1 一句话:技术资本效率 @@ -222,6 +222,6 @@ flowchart LR | 契约与数据库迁移 | `contracts/api-schemas/{ad,trade}.yaml`;迁移 V6(ad)/ V7(trade)/ V14(M4 的 `transfer_ref`)/ V21(订阅与赋余额三表);**Flyway 现行最高 = V25,新增 ALTER(如给 `game_trade_income.game_id` 加列)须用 V26**——版本号易过时,落地前以迁移目录 `game-cloud/huijing-server/src/main/resources/db/migration/` 实时核对为准 | | 成本台账工具 | `docs/agent-specs/2026-06-09-agent-loop-v1/orchestrator/{newapi_cost.py, report.py}` | | 商业定位与竞争战略 | [商业定位](../产品/商业定位.md) | -| 完整技术资本效率叙事 | [投资人版概要设计](../系统概要设计-投资人版.md) | +| 完整技术资本效率叙事 | [投资人版概要设计](../_archive/系统概要设计-投资人版.md) | > **加列纪律(给后端):** 给已有表加列必须 `NOT NULL DEFAULT 0`(不进唯一键、兼容存量行);全仓零外键,数据归属隔离靠 Mapper 的 `WHERE` 条件加 `getLoginUserId()`,不靠 `@DataPermission`。同一列在多个副本间必须字节一致,禁止出现第三个副本(V7 残留三副本是反面教材)。 diff --git a/docs/architecture/运营/合规闸门.md b/docs/architecture/运营/合规闸门.md index 367e723c..642595c1 100644 --- a/docs/architecture/运营/合规闸门.md +++ b/docs/architecture/运营/合规闸门.md @@ -232,6 +232,6 @@ sequenceDiagram | 律所会前材料与四问全文 | [`律所合规咨询brief.md`](../../mvp/律所合规咨询brief.md) | | 分账 / eCPM 等**经济模型明细与测算** | [单位经济敏感性模型](../../mvp/单位经济敏感性模型.md) | | **战略叙事**(三线变现排序、护城河、对外口径) | [产品域 · 商业定位](../产品/商业定位.md) | -| 决策史与逐档证据 | git 历史 + [`战略与合规`](../../agent-specs/战略与合规.md)(canonical 活档)+ `_archive/` 审计报告 | +| 决策史与逐档证据 | git 历史 + [`战略与合规`](../../architecture/运营/合规闸门.md)(canonical 活档)+ `_archive/` 审计报告 | > **纪律**:本页只写"合规闸门的设计逻辑与不变量"。任何会随日历推进而变化的状态——某项是否已提交、卡在哪一步、谁负责——一律只记在 [A1 闸门看板](../../mvp/A1闸门看板.md);本页不得复制这些状态,否则就会出现两份冲突的真相。仍然阻塞全局的最大未决项是:**Doc A(产品需求清单)里的法定 8 项换血,待律所对两核心问给出书面意见后才能定稿。** diff --git a/docs/mvp/MVP作战清单.md b/docs/mvp/MVP作战清单.md index 3cf03021..8b355138 100644 --- a/docs/mvp/MVP作战清单.md +++ b/docs/mvp/MVP作战清单.md @@ -27,7 +27,7 @@ 4. **brief/蒸馏**：每任务 brief 归执行方、**禁同名撞车**(tap-targets brief 已撞);蒸馏各写各 skill 段(L1 写 cheap-model/game-e2e,L0 写 ai-generation-pipeline/contracts)。 ## 队列〔🤖 我〕 -- [ ] **W-CH 渠道波（抖音+微信小游戏,✅ 范围已定稿）**：判定=[`渠道适配判定 HJ-CH-001`](../agent-specs/渠道发行.md)——小游戏=精选整包 L1 分发面(一壳多游·主题合集口径)/H5=UGC+L2 主场；W-CH-α 对比 spike(双 spec 齐,Codex 16 条全采纳;LayaAir 尽调出局)→**P0 段 ✅ 完成(2026-06-12 ultracode,验证门 6/6 PASS:adapter 21 测绿〔逮修 1 真 bug〕/合规 schema 30 用例/probe 八锚点哈希链/SIZES 实测 C-A 主包 gz 37.5KB=4MB 闸门 0.92%·每模板边际 gz2.9KB vs C-B Cocos 文献 1.94MB/双 RUNBOOK+证据校验器)**;**P1 只待你三件套**;C1-C2 ✅ 已拍(C1=自研流即时发布+双渠道精选发行/C2=合规为准绳,详归档⑫) +- [ ] **W-CH 渠道波（抖音+微信小游戏,✅ 范围已定稿）**：判定=[`渠道适配判定 HJ-CH-001`](../architecture/运营/渠道发行.md)——小游戏=精选整包 L1 分发面(一壳多游·主题合集口径)/H5=UGC+L2 主场；W-CH-α 对比 spike(双 spec 齐,Codex 16 条全采纳;LayaAir 尽调出局)→**P0 段 ✅ 完成(2026-06-12 ultracode,验证门 6/6 PASS:adapter 21 测绿〔逮修 1 真 bug〕/合规 schema 30 用例/probe 八锚点哈希链/SIZES 实测 C-A 主包 gz 37.5KB=4MB 闸门 0.92%·每模板边际 gz2.9KB vs C-B Cocos 文献 1.94MB/双 RUNBOOK+证据校验器)**;**P1 只待你三件套**;C1-C2 ✅ 已拍(C1=自研流即时发布+双渠道精选发行/C2=合规为准绳,详归档⑫) - [ ] **W-G0 生成工厂契约波（▶ 现行,α 主门已过）**：第 9 契约组——把参考件实证形状升格为正式契约(取证导出 __refForensics/__refChecklist/__refHost+evidence 四件套+LOOP 协议)+黄金评估集 v0(首件=暖阳小卖部)+9g 预算分档字段;**agentic 基建 ✅ 终裁(2026-06-12):全平台单一框架化基建=AgentScope 2.x 主力**(评审版 HJ-AGI-001;五资产契约边界+L1 裸通路定案;换轨触发写死,W-G1 即 spike 门,验不过切 LangGraph 开源核心；⚠️ **2026-06-15 HJ-AGI-002 覆盖**：现行改 SAA(Spring AI Alibaba v1.1.2.2)裸图编排，AgentScope 降 long-term premium 独立轨);**附带**:TPL 产品命名选项给创始人(产品文档 A/C「玩法模板」是否改名,属产品改名非清毒) - [ ] **W-G1 模型竞标 bake-off（创始人 2026-06-12 裁定:Fable 只造引擎,生产生成=便宜模型）**：同 brief 同 harness,M2.7/M3/DS-V4-Pro/Flash 比 过门率/重试数/¥每过门款,对照 ¥0.15 L1 门;品类=现有 8 插件可承载(经营/回合 RPG/弹幕/氛围);**20 游戏能力矩阵=覆盖目标与插件缺口定义**(矩阵入 W-G1 spec);**spec 增列 agent-loop-v1 处置**(冻结只修 P0/资产〔judge 决策表·ledger 幂等·预算闸〕契约化迁 AgentScope/退役时点——审计②#2);✅ **前置 DS key 你已解**(DeepSeek+MiniMax 可用)→**现可推【L1】**。本会话生成成熟度已推进(待收进 W-G1 验收):scale-20 14 款 / 宿主键盘桥 fix `d754b71` / saolei 翻绿 / **3b-B 派发面 plumbing+HMAC+视觉终局〔via 兜底〕** `238ec2d`;**dispatch 面 tap-targets 自产**(`roles.py:32`,闭合「一句话现生成」)= L1 next(brief §十) - [x] **T1b-β ✅ 实质收口(2026-06-15,收口报告 `docs/agent-specs/_archive/2026-06-15-T1b-β收口报告.md`)**：评审版两轮过+裁决②扩裁(`2026-06-12-...review.md`),**执行版 HJ-T1B-B-EXEC-001(`2026-06-13-...execution.md`)经 R3 对抗复审逮 5P0(初稿§7预烤『引擎有X→包装』未核真签名=同NIH病)全整改→R4 二轮复审『可冻结』(1P1+3P2补净)→✅冻结**;待确认 A 默认采纳=Runner URL 降级 DB-manifest 带版本(不接 OSS,可逆,创始人可后切);**Phase 0 ✅ 完成(`204eaed`):littlejsengine@1.18.19 装入+ENGINE-CAPABILITIES.md 50+ 能力真签名+§7 验签填定——§1.5 延迟裁定获验证(4 条初判『包装』翻『缺件补层』:collision MTV/RayHit·palette postProcess·physics 抛体;collision 整件/palette postProcess/physics 核心实为引擎缺件,自研合规但归因改逐函数验签)**;**Phase A 解锁**(地基 A0=engineInit 五回调接管);**P2 三契约 ✅冻结**(`28a57b8`+`75243fe`:受控面 getEngine 透传/packageUrl 复用/StoragePlugin 上提);**A0 引擎掌帧接管 ✅码落+本机门全绿(`11c8eaf`)**:8-agent workflow(源码取证→设计→对抗复审→实现)3/3 concerns·0 fatal·17 mustFix(P0×1/P1×9/P2×7)全采纳(P0=real像素门 overshoot→stub通道独占逐像素;P1源码级纠偏 debug水印/clearColor alpha=0/P75取timeReal),主会话亲验 155单测绿/受控面零改/Q4 import边界(仅host.js+entry.js)/真接线门①(littlejsengine 真入产物 163691B·box2d惰性);**A0 ✅完成线达成**:门0 **G0-1~G0-8 全过**(mini-desktop 实测 `11c8eaf` gate0_rc=0,`game-runtime/evidence/gate0/`)——引擎真掌帧(frame Δ30/500ms∈[20,45])·真渲2D mainContext(粒子 coloredHits=7·水印 whiteTextHits=0)·双时钟隔离·受控面零改回归 uncaught=[]·回滚桩活(noEngine=true);**A1-A6 可在此地基接线**。范围:①**裁决①+②落地(Q4 剃刀:自研=引擎外的层)**:〔裁决①〕粒子/物理/后处理三件改引擎能力包装层+〔**裁决② 2026-06-13 Opus 复查〕audio-music(re-vendor ZzFX/ZzFXM→改调引擎 Sound)+受控面 random/time(为取证砌墙→透传引擎 RandomGenerator/time)+juice hitStop·屏震(→引擎 timeScale/engineAddPlugin)+collision·gamefeel·physics-lite 逐函数三分(引擎有→包装/引擎无→缺件补层,废"维持自研"一刀切)**;**前置 P0=littlejsengine 真装入 game-runtime(现 0 字节)**+P1 引擎能力索引+P2 三契约冻结;R6 真接线门三件套(metafile+运行时调用 ID+负向扫);SIZES 重锚;render.js 切引擎 draw API;②Runner v2(防 demo 兜底假阳性);③1.x 退役(srcdoc→URL 四项兼容矩阵+CDP 走查门);④参考件经后端发布主链入 feed(解封③⑤);⑤P7/P8 固定清单(无命中默认 v2)+SDK storage 根契约收敛三套形状+probe 时钟拆分+outcome 注记(Q3 默认采纳);⑥R6 补录三件(weapp-adapter 仅 why-not 归 W-CH)+R3 血统回填五条。**【✅ 实质收口裁定·2026-06-15】**完成线=引擎真接线(Phase A=A0 掌帧+A1-A4 能力包装+A6 mini-desktop real 引擎门 6/6,`3e5cab4`)+ Runner v2(经全弧 P1/P2/P3,engineBundle 内嵌机制取代 packageUrl 外链)**实质收口**,已支撑 feed 真玩(3b-B 井字棋 gameId=9306 `238ec2d` 真渲入 feed／P2 真机 6 门 `5d3f7a8`／B1 主链 9001-9002 e2e),**零灰度闭环缺口、零 split-brain**。**三处 spec↔代码漂移=有意改判已回填澄清**:①〔Runner v2〕母 spec §5 packageUrl 外链→**engineBundle 字段(契约#4 additive)随 manifest JSON 内嵌+`window.__GameBundle`+bootGameHost**取代(不接 OSS 省一基建线)=**absorbed-by-arc 无 split-brain**;②〔1.x 退役〕「srcdoc→URL+四项兼容矩阵」被 **P2 O2(b)(创始人 06-13 追认)supersede**(落档 `2026-06-13-P2-...execution.md` §2.1),全 studio 单宿主 GamePlayer.vue、`inject.ts:240 'pkg.engineBundle?'` 同段 srcdoc 互斥分叉非双轨=**moot**;③〔受控面〕random/time/input §1.5 延迟裁定翻盘(random 仍 mulberry32 护粒子种子/time 仍 host 帧钟、probe 改读引擎 timeReal/input 仍 α 事件桥)=工程正确但 spec 冻结行未回写=**血统债**(连带门12 子断言现码不可满足、已 moot)。**剩余=推迟清单(engine-line backlog,不在完成线关键路径,推迟到日历闸门后或 L1 空档;创始人可点名某项转 required)**:**gold-plating**=render.js 切引擎 draw API/屏震切相机 cameraPos(`render.js:915`)/门3 逐像素 WebGL 回归(A0 有意降级)/immutable 强缓存头补端点实现(接 OSS 时,`game-package.schema.json:71` 现孤儿零消费)/参考件经主链入 feed/runtime-probe 改独立墙钟;**audit-debt**=A5 SIZES 并表(`size.mjs:150`)/门1③负扫沉淀 harness/`outcome:'win'|'lose'` additive(`events.schema.json:61`)/P7-P8 裁定落档/R6 三件尽调补录/R3 血统五条/矩阵① sandboxAttr 消费/门5 /preview 走查。详见 `game-runtime/.agent` + 总账 §5「T1b-β 推迟清单」。 diff --git a/docs/mvp/全成本收益测算模型-v2.md b/docs/mvp/全成本收益测算模型-v2.md index c735017e..cb47cb98 100644 --- a/docs/mvp/全成本收益测算模型-v2.md +++ b/docs/mvp/全成本收益测算模型-v2.md @@ -6,7 +6,7 @@ > **v2 修正版**。上游 = 原版《绘境 AI 的MVP 项目 全成本 & 收益测算模型.md》（`docs-design/`）+ 2026-06-12 主会话审计结论。**原版 4 处 P0 缺陷已在本版全部修正**（P0-1 回本记账错 / P0-2 存量·流量混淆 / P0-3 激励视频单点假设 / P0-4 渠道分成旧政），另修正 5 处 P1。 > 性质声明：本页是**带标注假设的财务测算模型，不是收入承诺**。每条前提标【已验证 / 推断 / 假设】三分。与 `docs/mvp/单位经济敏感性模型.md` 互链、口径一致、不冲突（分账口径、eCPM 档位均沿用其拍板资产）。 > 维护：财务建模 ｜ 内部决策用，**不进对外材料**（对外收益叙事须经创始人/律所口径）。 -> 渠道分成现行数据来源 = `docs/agent-specs/渠道发行.md` §1（HJ-CH-001，官方文档优先）。 +> 渠道分成现行数据来源 = `docs/architecture/运营/渠道发行.md` §1（HJ-CH-001，官方文档优先）。 --- @@ -322,4 +322,4 @@ --- -> **互链**：分账公式与 eCPM 档位资产 → `docs/mvp/单位经济敏感性模型.md`；渠道现行分成 → `docs/agent-specs/渠道发行.md` §1；成本实测 → HJ-NEWAPI-BILL-001 薄片①（`orchestrator/newapi_cost.py`）。所有数字保留 2 位小数，公式给中间步骤，可逐行验算（验算脚本口径见本文 §3~§6 公式）。 +> **互链**：分账公式与 eCPM 档位资产 → `docs/mvp/单位经济敏感性模型.md`；渠道现行分成 → `docs/architecture/运营/渠道发行.md` §1；成本实测 → HJ-NEWAPI-BILL-001 薄片①（`orchestrator/newapi_cost.py`）。所有数字保留 2 位小数，公式给中间步骤，可逐行验算（验算脚本口径见本文 §3~§6 公式）。 diff --git a/docs/mvp/可行性方案16周-波次映射.md b/docs/mvp/可行性方案16周-波次映射.md index 614a62e4..04c7247c 100644 --- a/docs/mvp/可行性方案16周-波次映射.md +++ b/docs/mvp/可行性方案16周-波次映射.md @@ -12,7 +12,7 @@ | AI 模型+四层锁风(IP 专属 LoRA) | W-T1b 美术管线(ComfyUI+LoRA)+ 工厂 D9 同质化/D11 版权维 | 王蓝莓线 ≥90% 为窄域口径(1 IP×2 玩法);工厂宽域门仍 ≥80%,对外口径统一前双指标声明 | | 极简编辑器+自研游戏流 | ✅ 大头已建成(game-studio 双区,链路①③ e2e)+遗留=链路③⑤走查闭合 | 方案此项实际进度领先 | | ~~15KB 轻量运行时~~ | **已废除→Runner v2(LittleJS,运行时 <30KB gz)**,W-T1b-β | 方案原文 15KB 为滞留旧引用,待创始人点头更词 | -| 三渠道分发中台(抖音/微信) | **W-CH 渠道波**(✅ 范围已定稿:[`渠道适配判定 HJ-CH-001`](../agent-specs/渠道发行.md)) | 渠道分工=小游戏精选整包 L1/H5=UGC+L2 主场;对外话术建议改「自研流即时发布+双渠道精选发行」;W-CH-α 已升级渠道引擎对比 spike(LittleJS+adapter vs Cocos;LayaAir 尽调出局;feed 终裁不动) | +| 三渠道分发中台(抖音/微信) | **W-CH 渠道波**(✅ 范围已定稿:[`渠道适配判定 HJ-CH-001`](../architecture/运营/渠道发行.md)) | 渠道分工=小游戏精选整包 L1/H5=UGC+L2 主场;对外话术建议改「自研流即时发布+双渠道精选发行」;W-CH-α 已升级渠道引擎对比 spike(LittleJS+adapter vs Cocos;LayaAir 尽调出局;feed 终裁不动) | | 资质/软著 8 项/ICP | 🧑 A1 线下四件+软著申报 | 日历闸门(不可压缩) | | Token 账户/扣减/统计底层 | M4(变现真实化)子项 + 9b/9g 契约(W-G0) | 方案给了完整规则(1T=¥0.1/免费额度/超额购),M4 有现成 spec | | **阶段二(5-8 周)** | | |