docs(governance): Phase7 收口——治理门反转 + 源档归档 + 入口对账 + 死链门

设计文档域化重构总收口:
- §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) <noreply@anthropic.com>
This commit is contained in:
lili 2026-06-20 20:48:38 -07:00
parent ec7fda2cee
commit 7bd9cd05e6
31 changed files with 120 additions and 56 deletions

View File

@ -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)。

View File

@ -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 引擎层 ~~DifyDAG 编排/多模型) + OpenGamePython 代码生成
## 5. 13 个业务模块速查表
> **13 模块**:含 **studio**(创作编排/编辑器域),**aigc 为无状态生成原子**;能力清单按产品功能/技术功能/映射三文档分离(见 `docs/architecture/产品需求清单.md`、`…-技术架构与模块.md``…-需求模块映射.md`)。
> **13 模块**:含 **studio**(创作编排/编辑器域),**aigc 为无状态生成原子**;能力清单按产品功能/技术功能/映射三文档分离(见 `docs/architecture/产品/需求清单.md`、`…-技术架构与模块.md``…-需求模块映射.md`)。
| 模块 ID | 一句话职责 | 面向端 | 被依赖 |
|---|---|---|---|

View File

@ -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)。

View File

@ -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.2commit 设计档前**自检**——「本次提交/工作树里有无被本档取代的旧档?」有则同提交 `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` §12 前门/目标锚 + `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` §12 前门/目标锚 + `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 `<type>` + `_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` 等)/ 硬编码端口。**红线**:命中即挡(这些属个人环境或会过期的细节,应由指针指向会跟着更新的活档或全局配置)。

View File

@ -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)。
---

View File

@ -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)。

View File

@ -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)。

View File

@ -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)。

View File

@ -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 历史口径渲染层已改判**。现行裁决

View File

@ -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

View File

@ -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 技术项);投资人版仅用于对外 / 资本效率叙述,不作为日常执行基线。**本 §12 即是顶层目标锚点的 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 技术项);投资人版仅用于对外 / 资本效率叙述,不作为日常执行基线。**本 §12 即是顶层目标锚点的 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:
- 顶层目标 / 定位 → 本文件 §12(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 域树按需下钻。
---

View File

@ -1,3 +1,5 @@
> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `docs/architecture/前端/README.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。
# studio 前端设计体系 · canonical子系统 SoT
> 类型=canonical 活档(子系统单一事实源)· 更新 2026-06-17

View File

@ -1,3 +1,5 @@
> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `docs/architecture/运营/变现与单位经济.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。
# 变现与单位经济 · canonical(子系统 SoT)
> 类型=canonical 活档(子系统单一事实源)· 更新 2026-06-17

View File

@ -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

View File

@ -1,3 +1,5 @@
> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `docs/architecture/运营/渠道发行.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。
# 渠道发行 · canonical(子系统 SoT)
> 类型=canonical 活档(子系统单一事实源)· 更新 2026-06-17

View File

@ -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 域→canonicalPhase 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. 子系统 canonicalsettled 域已迁入 `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 gz06-12 终裁)+ Runner v2 两层装载契约 + engineBundle 内嵌;含★模板术语纠偏
- [`渠道发行.md`](渠道发行.md) — HJ-CH-001一壳多游 L1 / L2 不上渠道 / 合规闸门 / 引擎竞标 C-A vs C-B
- [`studio前端设计体系.md`](studio前端设计体系.md) — HJ-FE-DS-001token 两层 / 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 前端);取代 `生成引擎-并行编排`(模块切分版)

View File

@ -1,3 +1,5 @@
> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `产品/需求清单.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。
# 绘境AI — 产品需求清单Doc A
> 文档类型:**Doc A产品需求清单**(面向用户/产品,回答 WHAT

View File

@ -1,3 +1,5 @@
> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `架构/13模块.md + 后端/README.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。
# 绘境AI — 技术架构与模块Doc B
> 文档类型:**Doc B技术架构与模块**(面向工程/领域,回答 HOW + 对象边界)

View File

@ -1,3 +1,5 @@
> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `产品/护城河话术.md + 产品/商业定位.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。
# 绘境AI 护城河对外话术(双版本)
> **用途**:融资沟通的口径基准。**版本 A 投资人面**(定位/电梯/三段式/钉子问题);**版本 B 技术 DD 面**(诚实技术口径 + 红线 + 自研边界 + 工程亮点)。

View File

@ -1,3 +1,5 @@
> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `架构/README.md + 运维/README.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。
# 绘境AI游戏生态平台 — 系统概要设计(开发团队版)
> **文档编号**HJ-ARCH-003

View File

@ -1,3 +1,5 @@
> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `架构/README.md + 架构/13模块.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。
# 绘境AI游戏生态平台 — 系统概要设计(技术决策版)
> **文档编号**HJ-ARCH-001

View File

@ -1,3 +1,5 @@
> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `产品/商业定位.md + 运营/变现与单位经济.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。
# 绘境AI游戏生态平台 — 系统概要设计(投资人版)
> **文档编号**HJ-ARCH-002

View File

@ -1,3 +1,5 @@
> 🗄️ **已归档(2026-06-20 设计文档域化重构)** —— 内容已重写并迁入 `产品/需求模块映射.md`。本档为决策史留档,**非现行 SoT**;现行真相见 6 域树(总索引 `docs/architecture/README.md`)。
# 绘境AI — 需求↔模块 映射Doc C
> 文档类型:**Doc C产品功能 ↔ 技术功能 追溯映射**(唯一承载 M:N 关系的文档)

View File

@ -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 三主题 × 双语走查) |

View File

@ -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` 为准。**冲突时口径:状态 > 实现 > 结构**。
---

View File

@ -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↔产品定位纠偏、待创始人拍板项 |
跨域的两个跟踪 / 计算面(状态会变,以它们为准):

View File

@ -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 残留三副本是反面教材)。

View File

@ -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 项换血,待律所对两核心问给出书面意见后才能定稿。**

View File

@ -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` 真渲入 feedP2 真机 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-β 推迟清单」。

View File

@ -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` §1HJ-CH-001官方文档优先
> 渠道分成现行数据来源 = `docs/architecture/运营/渠道发行.md` §1HJ-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 公式)。

View File

@ -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 周)** | | |