29 Commits

Author	SHA1	Message	Date
suzmii	6aa2f97410	feat(游戏共创): 贡献归集与归因（接口 + 契约 + 文档；反洗稿改判搁置） ... 产品口径：「子代所有的都算父代的」，并要能溯源「多少是子代给的、多少是自己的」。本期**只做计算**， 不含资金/分成结算。 - 递归定义：`inherited(W) = Σ_{c∈直接子代} total(c)`，`total(W) = own(W) + inherited(W)`；每个后代在它的每个 祖先里只计一次。 - 接口：`GET /api/game-distribution/games/{game_id}/contribution`（Bearer + `no-store`）——**仅该作品作者**： 未登录/失效 401（中间件）、非作者 403（复用既有 owner-mismatch → FORBIDDEN，不新增第二套鉴权）、 作品不存在或根自身已软删 404。响应：`{ gameId, own, inherited, total, byGeneration[], directChildren[], nodeCount, truncated, truncatedReason }`；指标结构 `ContributionTotals{playCount}` 可扩展（将来加点赞/收藏/收入）。 - 不变量（测试钉住）：`inherited == Σ byGeneration.total == Σ directChildren.total`、`total == own + inherited`、 `nodeCount == Σ byGeneration.gameCount`；`byGeneration` 只含后代（绝对代际，升序）。 - 上限与截断：节点 500 / 深度 32；超限如实标 `truncated: true` + `truncatedReason ∈ {node_limit, depth_limit}`， 已计入部分仍自洽（与族谱 `truncated` 同约定，不静默给半个数）；遍历只用血缘表既有索引，**不新增表/索引**。 - 契约：shared-contracts 4 个 DTO + TS 镜像 + parity（+4 组 → 66 组）；7 个生成绑定（含 procedure）。 - 文档：技术方案新增 `§3.11 贡献归集与权益归因`（定义/归因分解/接口/上限与截断/鉴权口径与理由）+ §3.4 路由行 + §5.4 实施证据；**任务 B**：反洗稿（相似度校验）从「待拍板」改为「**产品已决定搁置（2026-10-06）**」并从待拍板 清单移除，结算口径统一为「本期只做贡献归集与归因计算」。 - 测试：module-game-distribution **131 passed**（contribution 12 条，含 A→B→C 三层链路不变量）；spacetime-module **304 passed / 1 ignored**（+3 结构断言）；spacetime-client 43 passed；api-server game_distribution **107 passed**（+3）。 门禁：wasm build 0；`cargo check --all-targets` 0；`SPACETIME_SCHEMA_BASE_REF=9f4c7d76 npm run check:spacetime-schema` 0（98 表）；DTO parity 0（66 组 / 17 构建器 / 15 手拼类型）；`check:project-bundle-policy-parity` OK； `check:encoding` 0（5543 files）；`cargo fmt --all --manifest-path server-rs/Cargo.toml -- --check` 0；`git diff --check` 0。 注：本块未提交 `scripts/*.mjs`（`check-game-distribution-lineage-e2e.mjs` / `-theme-e2e.mjs` / `capture-game-lineage-visual.mjs`）——属其它 owner，工作区保留未提交。	2026-10-06 18:05:49 +08:00
suzmii	512bbb7a62	feat(游戏共创): 衍生作品创建时自动继承父作品授权档位（客户端不可另选） ... 对齐需求文档 revision 1554「授权设置区：自动继承父作品授权」（被划掉的那句「可收窄、不可放宽」不做）。 - **口径**：衍生作品创建时 `fork_authorization` **直接取父作品当时的档位**（创建时快照），客户端传值一律 **忽略且不报错**（旧客户端会惯常带默认值）；母版不变（按请求值，缺省 `forbidden`，未知档位仍失败关闭）； 收窄入口不做；**PUT 提升接口语义未改**（见下）。 - **落点**：`resolve_game_distribution_fork_declaration_tx` 原本就在父行上判「存在/未软删/已公开/非禁止/来源版本 等于父当前公开版本」，现在把父档位一并回传（`(root, generation, ForkAuthorization)`）；新增纯函数 `resolve_game_distribution_creation_fork_authorization(parent, requested)`：有父 → 父档位，无父 → 解析请求值 （未知 → `FORK_AUTHORIZATION_UNKNOWN`）；创建事务里把血缘解析挪到授权裁决之前，新行写裁决结果。 - **无 schema / 无契约形状变化**：`GameDistributionCreateGameRequest.forkAuthorization` 保留（非 Option + `serde(default)` 未动 ⇒ 幂等摘要不变）；表列、client record、快照均无字段增删。 - **文档**：技术方案 §2.3（授权模式 + 时序图两条继承边）/§2.4/§3.2.1/§3.4 `POST /games` 行/§3.9 补充/新增 §5.3 实施证据/§7 第 2 条（待拍板 → 已定口径并注明收窄不做）；数据契约 `game_distribution_game` 授权条；共创授权与 血缘里程碑（依赖决策/验收第 1 条/实施记录）；decision-log 新增 2026-10-06 决策条。 - **测试**：spacetime-module +7（继承矩阵：父 full/nonCommercial × 请求 forbid/nonCommercial/full/空串 一律落 父档位；母版按请求值；未知档位失败关闭；以及「血缘解析返回父档位 + 裁决排在解析之后且写库之前」的结构断言）。 Rust 侧原本**没有**断言「衍生默认 forbidden」的用例（已 grep 核对），因此没有为了让测试过而弱化任何断言。 门禁：`SPACETIME_SCHEMA_BASE_REF=9f4c7d76 npm run check:spacetime-schema` 0（98 表）；`cargo check --all-targets` 0； `cargo test -p module-game-distribution` 119 passed；`cargo test -p spacetime-module` **301 passed / 1 ignored**； `cargo test -p api-server game_distribution` 104 passed；DTO parity 0（62 组 / 17 构建器 / 15 手拼类型）； `check:encoding` 0（5535 files）；`cargo fmt --all --manifest-path server-rs/Cargo.toml -- --check` 0；`git diff --check` 0。 **待你拍板（只报不改）**：继承是「创建时快照 + 等值」，而 PUT 只限制方向不限制对象 ⇒ 衍生作品作者仍可把继承来的 档位再往上提，得到比祖先更宽的子作品，「不可放宽」会被绕过。选项：① 保持现状（PUT 对衍生作品也生效）； ② 禁止对衍生作品 PUT 提升（档位只由继承决定；需新增「该 game 无血缘行」判定 + 稳定错误码，并同步文档与前端入口）。 **需其它 owner 同步**（我未改，属其文件）：`scripts/check-game-distribution-lineage-e2e.mjs`（richB1/richC1/richD 从 `forbidden` 提升的前置假设已不成立）、`scripts/capture-game-lineage-visual.mjs`（固定 `expectedForkAuthorization: 'forbidden'` 的造树与断言）。	2026-10-06 17:39:35 +08:00
suzmii	d0176f48b7	feat(游戏共创): 衍生作品发布必填「本次核心改动说明」（版本级存储 + 可达错误码） ... 按需求文档 revision 1554「发布设置页 → 二创信息区（必填项）」：衍生作品（有血缘行）发布新版本时**必须** 提供「本次核心改动说明」；母版（0 代）不需要——提供了也忽略、不校验、不落库。 - **存储**：`game_distribution_version` **表尾追加** `change_summary: Option<String>`（`#[default(None)]`）； 列序属 wire format，`game_distribution_version_type` / `_version_snapshot_type` / `_create_version_input_type` 三个绑定同步重生成（仓外临时 out-dir，只回写受影响文件）。 - **请求**：`GameDistributionCreateVersionRequest.change_summary`（`#[serde(default, skip_serializing_if)]`： 缺省不序列化 `null`，保住旧客户端的幂等摘要）。 - **校验**：纯函数 `game_distribution_change_summary_violation(value, is_derivative)`，trim 后按**字符**计 **20..=500** —— 20 是「能写清改了什么」的下限，500 约 1 KiB 上限，兼顾详情页/族谱展示与存储； 超限或缺失**失败关闭**，错误码 `FORK_CHANGE_SUMMARY_REQUIRED` / `FORK_CHANGE_SUMMARY_INVALID`（均 **400**）， 已登记进 api-server 的 `FORK_` 映射表并纳入「FORK 码由模块真实文案可达」的枚举测试（防上次那种不可达码）。 - **公开投影**：`currentVersion.changeSummary`（衍生为字符串、母版 `null`，发键不发值），版本负载键集合 逐字钉死为 id/version/entryUrl/sha256/publishedAt/controls/changeSummary，不带对象键/素材 id/审核字段。 - **契约与登记**：Rust DTO + TS 镜像 + parity（`version_summary_payload` 加 `mustEmit: ['changeSummary']`）。 - **文档**：技术方案 `§3.4`（请求增量 + 长度口径与理由 + 两个错误码 + 幂等摘要口径 + 公开投影）、数据契约 文档的版本表小节（表尾追加列）。 - **测试**：纯函数 5 条（衍生缺失/超短(ASCII 与汉字)/超长(ASCII 与汉字)/区间内 trim 边界/母版忽略）+ 事务 4 条 + 接口 3 条（含公开负载键集合与母版 null）。 门禁：`SPACETIME_SCHEMA_BASE_REF=9f4c7d76 npm run check:spacetime-schema` 0（98 表）；`cargo check --all-targets` 0； `cargo test -p module-game-distribution` **119 passed**；`cargo test -p api-server game_distribution` **104 passed**； DTO parity 0（62 组 / 17 构建器 / 15 手拼类型）；`check:encoding` 0（5535 files）； `cargo fmt --all --manifest-path server-rs/Cargo.toml -- --check` 0；`git diff --check` 0。 注：本块**未提交** `scripts/check-game-distribution-lineage-e2e.mjs` / `check-game-distribution-theme-e2e.mjs` / `capture-game-lineage-visual.mjs` 的配套改动（属别的 session 的文件，工作区里保留未提交，需其 owner 决定： 衍生作品发布若不传 `changeSummary` 现在会 400，那三个脚本需要同步补字段）。	2026-10-06 17:24:42 +08:00
suzmii	eeb101458a	Merge remote-tracking branch 'origin/master' into feat/game-fork ... # Conflicts: # apps/ai-game-creator-shell/src-tauri/src/game_distribution_publish.rs # apps/ai-game-creator-shell/src/components/game-distribution/GameDistributionPublishPanel.tsx # apps/ai-game-creator-shell/tests/gameDistributionPublishPanel.test.tsx # docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md # package.json # packages/shared/src/contracts/gameDistribution.ts # scripts/check-game-distribution-dto-parity.mjs # server-rs/crates/api-server/src/modules/game_distribution.rs # server-rs/crates/module-game-distribution/src/errors.rs # server-rs/crates/module-game-distribution/src/lib.rs # server-rs/crates/shared-contracts/src/game_distribution.rs # server-rs/crates/spacetime-client/src/active.rs # server-rs/crates/spacetime-client/src/active/mapper.rs # server-rs/crates/spacetime-client/src/active/mapper/game_distribution.rs # server-rs/crates/spacetime-client/src/game_distribution.rs # server-rs/crates/spacetime-client/src/module_bindings.rs # server-rs/crates/spacetime-client/src/module_bindings/game_distribution_game_snapshot_type.rs # server-rs/crates/spacetime-client/src/module_bindings/game_distribution_game_type.rs # server-rs/crates/spacetime-module/src/game_distribution.rs # server-rs/crates/spacetime-module/src/migration.rs # src/components/game-distribution/GameDetailPage.tsx # src/components/game-distribution/GameDistributionPages.test.tsx # src/components/game-distribution/GamePlayPage.tsx # src/components/platform-entry/PlatformEntryActiveFlowShell.tsx # src/services/gameDistributionClient.test.ts # src/services/gameDistributionClient.ts	2026-10-06 16:10:52 +08:00
suzmii	54e05d5e84	lineage viz polish 2: dual-axis fit, readable floor, fixed axis layer, edge contrast	2026-10-06 14:47:51 +08:00
suzmii	0d0166c2d9	feat(游戏共创): 后台读取主题成员名单（含草稿/归档主题与不可见成员 + 可见性列） ... 缺口：后台原先只能借**公开投影** `GET /api/game-distribution/themes/{themeId}` 列成员，而公开投影只服务 `published` 主题 ⇒ **草稿 / 已归档主题在后台看不到成员名单**，运营没法在发布前核对。 新增 `GET /admin/api/game-distribution/themes/{theme_id}/members?limit=&cursor=`： - **鉴权照既有两层**：路由挂既有 admin 支的 `route_layer(require_admin_auth)`，handler 取 `Extension<AuthenticatedAdmin>`（未登录/失效 → 401 `UNAUTHORIZED`、非 admin → 403，同组同码同形）； 模块侧 procedure 先跑 `require_editor_generation_runtime_service_identity`（照 `033e3aa79` 五条写接口）。 - **返回全部成员行，不套公开可见性过滤**，且**不要求主题已发布**（`draft` / `archived` 照常可读； 只有主题真的不存在才 404 `THEME_NOT_FOUND`）。响应： `{ themeId, totalMembers, members: [{ rootGameId, title, sortOrder, createdAt, visible, visibility }], nextCursor }`。 - **两个可见性字段刻意独立**： · `visible` = 「公开侧此刻会不会出现」，**复用** `game_distribution_theme_member_visible`（未删 + 已公开 + 有当前公开版本），不另写第二套判定； · `visibility` = 更细状态（新纯函数）：游戏行不存在 → `missing`（优先于 `deleted`），软删除行 → `deleted`， 否则原样透传游戏行 `visibility`（`published` / `unpublished` / `suspended`）。 因此 `visibility == "published"` 但无当前公开版本时 `visible = false` ——运营能看出「公开了但没公开版本」； 三处钉住这个组合（纯函数单测、api-server payload 单测、事务结构断言）。 - **排序与分页照既有口径**：复用 `sort_theme_members`（`sort_order` 升序 + 成员 id 兜底）+ 新增 `page_admin_theme_members`；`limit` 缺省 20 / 上限 50 / `0` 取默认 / 超界截断（同一归一化）； 游标 `"{sortOrder}:{memberId}"`，解析**只委托** `parse_game_distribution_theme_cursor` ⇒ 非法游标仍是 上一轮刚修好的**可达** `THEME_INVALID_CURSOR`（不另造一个不可达码）；`totalMembers` 是成员**行**总数， 切页前算，不受分页影响。 - **契约与登记**：`packages/shared/src/contracts/gameDistribution.ts` 新增 `GameDistributionAdminThemeMemberRow` / `…ListResponse` / `…MemberVisibility`；parity 登记 `TS_ONLY_TYPES` +3、`RESPONSE_BUILDERS` +2（列表响应与单条成员各一条，条目形状有独立证据）；api-server 用命名构建器（不内联 `json!`）。 - **测试**：module-game-distribution +5 条纯函数（`missing` 优先于 `deleted`、三类不可见各一条并断言 `visible`/`visibility` 组合、`published` 无公开版本 ⇒ `visible=false`、游标委托共享实现、翻页不重不漏、 末页 null、复用共享比较器与同一归一化）；spacetime-module +1 并扩 2（结构断言：走主题索引、不套公开可见性 过滤、不复用「只取可见成员」的助手、不自写排序、不删行、`totalMembers` 在切页前取）；spacetime-client +1 mapper（行总数与游标透传、两个可见性字段不互相推导、空名单是正常结果）；api-server 例（401/403、草稿主题 可读、含不可见成员仍返回、`totalMembers` 不受分页影响、limit 缺省与截断、非法游标 → 400 `THEME_INVALID_CURSOR`、 主题不存在 → 404）。 - **文档**：技术方案 `§3.10.8`（新行 + `visible`/`visibility` 语义 + 「草稿也能读」的理由）与 `§3.4` 后台接口表； 里程碑（后台路由清单、实施清单、验收与测试清单，原「只能借公开投影」的留白项标记为已落地）。 - **生成绑定**：新增 4 个 `admin_theme_member_list*` / `list_admin_…_procedure` 生成文件 + `module_bindings.rs` 入口；wire format 有新增（新 procedure/结果类型）⇒ 部署需重新 publish 模块。 门禁：wasm build 0；`cargo check --all-targets` 0；`cargo test -p api-server game_distribution` **89 passed**； `cargo test -p module-game-distribution` **106 passed**；`cargo test -p spacetime-module` **287 passed** / 1 ignored； `cargo test -p spacetime-client` 39 passed；DTO parity 0（58 组 / **17** 构建器 / **15** 手拼类型）； `check:spacetime-schema` 0（96 tables）；`check:encoding` 0（5424 files）；`cargo fmt --all -- --check` 0； `git diff --check` 0。 不在本提交内（属另一个 session 的文件，工作区里由我的子代理顺带做了**纯新增性**改动，未提交）： `apps/admin-web/src/api/adminGameThemeTypes.ts` 增加了三个指向共享契约新类型的别名 + 一段注释 —— 与该 session 「登记好之后改回引用共享契约」的计划一致，交由其 review / 提交（或直接删掉其本地重复定义）。	2026-10-06 04:28:39 +08:00
suzmii	ce614d59c1	feat(游戏共创): 主题详情 rootsTruncated 信号（memberCount 报真实可见成员数） ... 裁定（与族谱 `truncated` 同约定）：`memberCount` = **真实可见成员数**（不受展示上限污染），新增布尔 `rootsTruncated`，**仅当 `roots` 被 50 上限截断时为 true**。此前两个数被同一个 50 上限截断 ⇒ 可见成员 > 50 时静默截断，客户端既看不到全部树、也拿不到任何信号。 - 纯函数：`game_distribution_theme_roots_truncated(visible_member_count, returned_root_count)` （相等 / 回传更多 ⇒ false；后者是防御性口径：两组数字不同源时不得凭空报「还有更多」）。 - 契约：`GameDistributionThemeDetail` 加 `roots_truncated`（serde camelCase ⇒ `rootsTruncated`）， TS 镜像同步；parity `public_theme_detail_payload.mustEmit` 6 键 → **7 键**。 - 事务：`member_count` 走可见成员清单的 `len()`（**不再**经 `page_theme_members` 与上限），`roots` 仍是 同一清单排序后取前 50，`rootsTruncated` 由纯函数算出（不写死「>50 就 true」——阈值与上限是两个 独立事实）；列表入口共用同一计数函数 ⇒ 同一主题在列表与详情里不会报出两个 `memberCount`。 - api-server：`public_theme_detail_payload` 增加 `rootsTruncated`；形状单测 6 → 7 键，并加 `memberCount=120 / roots=1 / rootsTruncated=true` 用例，证明两个键口径独立。 - 结构断言同步修正：列表侧原「成员数与 roots 共用同一上限」改为「成员数数的是全部可见成员（断言 源码里不含切页函数与上限常量）」；详情侧改为「必须调用共享纯函数 + 不得再恒等 `roots.len()` + 该字段必须进入返回值」。 - 生成绑定：`module_bindings/game_distribution_theme_detail_result_type.rs` 手改后用临时 out-dir 重跑 `spacetime generate --lang rust` 逐字节校对一致。**wire format 变更 ⇒ 部署需重新 publish 模块** （客户端绑定已同步）。 - 文档：技术方案 §3.4 / §3.10.6 / §3.10.9（原「已知限制·三个备选待拍板」→ 已定口径）、里程碑 （依赖、接口表、验收标准、纯函数表、测试清单、待确认项）、以及数据契约文档里那句「主题详情的 roots 与列表的 memberCount 永远一致」（本改动已使其为假）。 门禁：wasm build 0；`cargo check --all-targets` 0；`cargo test -p api-server game_distribution` 86 passed； `cargo test -p module-game-distribution` **101 passed**；`cargo test -p spacetime-module` 286 passed / 1 ignored；DTO parity 0（58 组 / **15** 构建器 / 12 手拼类型）；`check:spacetime-schema` 0（96 tables）； `check:encoding` 0（5420 files）；`cargo fmt --all -- --check` 0；`git diff --check` 0。 遗留（不在本仓可改范围，需前端 session 跟进）：`src/services/gameDistributionClient.ts` 有自己一份主题 详情本地类型与 normalize，会丢弃 `rootsTruncated`（约 3 行小改），因此网页主题页暂时拿不到截断信号； admin-web 走共享契约类型，后台侧即时生效。	2026-10-06 04:09:45 +08:00
suzmii	4a33397822	chore(游戏共创): 主题注释失真修正 + 后台主题 payload 纳入契约门禁 ... 1) 注释失真（独立复核 §B8）：`module-game-distribution/src/theme.rs` 与 `spacetime-module/src/game_distribution.rs` 原先声称「api-server 与事务都调 `game_distribution_theme_text_violation`」，但全仓只有写入事务一处调用（HTTP 层没有预校验）。 选择**改注释**（单一判据来源就是事务），不给 HTTP 层再叠一层同名校验——否则「HTTP 挡住的」 与「落库挡住的」会重新长出两套判据。两处注释都改成明确写「只有事务调用 + api-server 不做预校验」。 2) 后台主题 payload 的契约门禁：`admin_theme_payload` / `admin_themes_payload` / `admin_theme_mutation_payload` / `admin_theme_member_payload` 原先既无 TS 类型也未登记 parity， 形状只有 api-server 单测钉着 → 后台 UI 落地时容易与实现漂移。 - `packages/shared/src/contracts/gameDistribution.ts` 新增 5 个 TS 类型 （`GameDistributionAdminTheme`、`…ListResponse`、`…MutationResponse`、`…MemberResponse`、 `…MemberRemovalResponse`），注释里写清两处刻意差异：后台主题条目比公开摘要多出 `sortOrder`/`status`/时间戳，且 `memberCount` 是**成员行总数**（含当前不可见成员）， 公开投影里同名键是**当前可见**成员数；后台列表**没有** `nextCursor`。 - `api-server`：把 handler 里内联的成员移除响应抽成命名构建器 `admin_theme_member_removal_payload`——内联 `json!` 不在 parity 的证据范围内，抽出来这条 形状的漂移才会被门禁抓住。 - parity 登记：`TS_ONLY_TYPES` +5（这些形状服务端同样是逐字段手拼 JSON，没有 Rust 结构体可对， 要收口得先把响应改成结构化类型），`RESPONSE_BUILDERS` +5（响应键与 TS 字段逐键比对）。 门禁：`cargo test -p api-server game_distribution` 86 passed；`cargo test -p spacetime-module` 286 passed / 1 ignored；DTO parity 0（58 组类型 / **15** 个构建器 / **12** 个手拼类型）； `check:encoding` 0（5420 files）；`cargo fmt --all -- --check` 0；`git diff --check` 0。	2026-10-06 03:53:15 +08:00
suzmii	b4bf37671d	前端：修复买断制付费评审问题（flaky 用例、草稿恢复定价、契约口径、守卫与测试质量） ... - GameDistributionPages.test.tsx：作者补查断言包进 waitFor，消除并发下的 0 调用 flaky - GameDistributionPages.test.tsx：购买确认改为双击只发一次请求，按格式断言幂等键而非仅非空 - GameDistributionPages.test.tsx：新增 409「价格已变化」UI 分支与「旧响应缺价格且无入口」可操作说明用例 - GameDetailPage.tsx：禁用「立即玩」且无入口时补原因说明并用 aria-describedby 关联按钮 - GamePublishPage.tsx：草稿恢复按版本冻结价预填付费模式与价格，恢复提示写明「本次将沿用版本冻结价 N 泥点 / 免费」 - GamePublishPage.test.tsx：删除与共享组件重复的定价纯函数用例，改为草稿恢复定价（游戏行 999 / 版本冻结 240）网页独有用例 - gameDistributionGuards.ts：播放会话 token 段收窄为 [A-Za-z0-9-]，拒绝 `..` 逃逸 - gameDistributionGuards.test.ts：补 UUID 令牌、`..`、超长 URL、控制字符与字母表外字符用例 - gameDistributionClient.test.ts：补 purchaseGame / createGamePlaySession 路径、幂等键、expectedPriceMudPoints 序列化与 401/403/409/余额不足错误码映射 - PlatformGamePricingField.tsx：错误行加 id，价格输入补 aria-invalid / aria-describedby - PlatformGamePricingField.test.tsx：禁用态改用「买断制 + 禁用」以覆盖价格输入；新增错误关联 a11y 用例 - packages/shared 契约与 admin-web DTO：priceMudPoints / purchased 改为可选，与 Rust #[serde(default)] 口径对齐 - AdminGameDistributionReviewPage.tsx：详情价格按「版本冻结价优先、游戏行价兜底」取值（与服务端 version_detail_payload 同口径） - AdminGameDistributionReviewPage.test.tsx：详情价格改发散值（game=999 / frozen=30，断言 30）；价格列按列名定位、去掉全局 NaN 弱断言 - adminGameDistributionReview.css：价格列 96px nowrap 放宽为 120px 并允许换行，避免最大价被硬裁 - AGC 发布面板与发布服务：深相对路径改走 @genarrative/shared/components alias - AGC 壳 game_distribution_publish.rs：修正预填价注释为「最近版本冻结价优先，可能仍待审/被拒」	2026-10-06 02:18:21 +08:00
suzmii	2fa201e0dc	feat(游戏共创): 共创主题（一）数据模型与领域纯函数 ... 按 `docs/【技术方案】游戏共创与作品Fork-2026-10-03.md §3.10` 与里程碑《共创主题与作品树-2026-10-06》的清单 A/B/F 落地（本块**不含** procedure / 路由）。 - **表**：`game_distribution_theme`（`theme_id` 主键、`name`/`summary`/`badge`/`sort_order`/`status ∈ draft|published|archived`/`created_by_user_id`/`created_at`/`updated_at`）＋ `game_distribution_theme_member`（确定性主键 `member_id = "{theme_id}:{root_game_id}"`，`theme_id`、`root_game_id` 各具名 btree 索引，`sort_order`、`created_at`）；归档 / 下架只改公开投影，不删成员行。`migration.rs` 白名单登记两张表（随迁移导出/导入）。 - **生成绑定**：4 个 `game_distribution_theme*` 生成文件 + `module_bindings.rs` 入口（纯追加）。生成时**不覆盖工作树**（本仓共享工作树禁止 git 写命令）：先 `spacetime generate --lang rust --out-dir <仓外临时目录>`，rustfmt 后只拷回本次相关文件，避免上一轮踩过的「rustfmt 漂移把别人文件一起改」。 - **领域纯函数**（`module-game-distribution/src/theme.rs`，风格照同目录 `collection.rs`）：状态合法/公开可见判定、`game_distribution_theme_member_id`、成员可见性（**委托** `collection.rs` 的判定，不复制第二套）、`game_distribution_theme_root_acceptable(has_lineage_row)`、页大小（缺省 20 / 上限 50 / 0 取默认 / 超界截断）、游标编解码（`"{createdAtMicros}:{themeId}"`，Err 文案「主题列表游标格式无效」，已核对不含 404/409 关键词）、`sort_public_themes`（`created_at` 倒序 + `theme_id` 兜底）、`page_public_themes`（排序 → retain 游标之后 → 多取一条判 has_more；**先过滤再切页**的顺序语义写进文档注释）、`sort_theme_members`（`sort_order` 升序 + `member_id` 兜底）与 `page_theme_members`。 - **契约**：`shared-contracts` 新增 `GameDistributionThemeStatus` / `GameDistributionThemeReference` / `GameDistributionThemeSummary` / `GameDistributionThemeListResponse` / `GameDistributionThemeDetail` / `GameDistributionCreateThemeRequest` / `GameDistributionUpdateThemeRequest` / `GameDistributionUpsertThemeMemberRequest`，`GameDistributionGameSummary` 追加可选 `themes`（按 `collected` 先例只在详情路径下发）；TS 镜像同步；parity 登记 **58 组**（响应构建器待路由落地后再登记，parity 要求函数真实存在）。 - **数据契约表目录**：补两张表小节，94 → **96**。 - **测试**：`theme.rs` 16 个单测（成员 id 确定性、状态三态与公开可见、成员可见性逐格与收藏判定等价、根判定、页大小边界、游标往返与非法输入、排序稳定性与同 `sort_order` 兜底、分页不重不漏）。 - **门禁**：wasm build 0；`cargo check --all-targets` 0；`cargo test -p module-game-distribution` **97 passed**；`cargo test -p spacetime-module` 274 passed / 1 ignored；DTO parity **58 组**；`check:spacetime-schema` 0（**96** tables）；`check:server-rs-ddd` 0；`check:encoding` 0（5388 files）；`cargo fmt --all -- --check` 0；`git diff --check` 0（8 个改动文件 0 删除行）。	2026-10-06 01:46:23 +08:00
suzmii	f09607d903	feat(游戏共创): 收录（收藏）列表补真分页（cursor + limit） ... - 纯函数（`module-game-distribution/src/collection.rs`，与收藏另两条规则同文件）：`encode/parse_game_distribution_collection_cursor`（`"{created_at_micros}:{collection_id}"`，复用仓库既有 `"{micros}:{id}"` 惯例；非法 → Err「收藏列表游标格式无效」→ 400）、`game_distribution_collection_page_limit`（0/缺省 → 20，超界 → 50）、`game_distribution_collection_page`（稳定全序排序 → 跳过游标之前 → 取 limit → 多取一条判 has_more，只对页内最后一条编码下一游标） - 排序与顺序语义：`created_at` 倒序 + `collection_id` 升序兜底（主键、同用户内唯一 ⇒ 全序，翻页不重不漏）；**先按可见性过滤、再排序切页**——游标位置必须落在已过滤序列上，否则被过滤的行会让下一页漏项（推理写进 tx 与纯函数注释）；snapshot 只对最终页成员计算 - 模块：list 的 input 增 `limit` / `cursor`，result 增 `next_cursor`；api-server `my-collections` 加 `Query<MyCollectionsQuery>`，默认 20 / 上限 50（网格一屏 vs 单响应体积；与后台列表的 200 口径不必相等，理由写进注释），超界**截断**不报错，非法游标 400 透传不吞，日志带 `has_more` - 契约：Rust DTO 增 `next_cursor`、TS 镜像同步、parity 登记（50 组一致） - 文档：§3.4 的 `my-collections` 行补分页语义（默认/上限/游标格式/非法 400/末页 null/排序口径） - 测试 13 条：纯函数 8（不足一页 → None；恰好整页不产生空游标；5 条 limit=2 连翻 3 页不重不漏；同 `created_at` 用 `collection_id` 兜底；limit=0 与超界；游标往返 + 7 种非法输入）、模块事务结构 2、api-server 3（默认与截断、`nextCursor` 透传、非法游标 → 400） - 门禁：wasm build 0；`cargo check --all-targets` 0；`cargo test -p module-game-distribution` **81 passed**；`cargo test -p api-server game_distribution` **73 passed**；`cargo test -p spacetime-module` 274 passed / 1 ignored；DTO parity **50 组**；`check:spacetime-schema` 0（94 tables）；`check:encoding` 0（5382 files）；`cargo fmt --all -- --check` 0；`git diff --check` 0	2026-10-06 01:31:09 +08:00
suzmii	4b1f24a8fc	feat(游戏共创): 收录（收藏）契约与文档同步（块 3/3） ... - `shared-contracts`：新增 `GameDistributionCollectionState { collected, replayed: Option<bool> }` 承载 PUT/DELETE 共用形状（PUT 才发 `replayed`）；既有 `GameDistributionGameSummary` 增 `collected: Option<bool>`（公开详情登录时才带）——该类型只被 api-server 测试与 `GameDistributionListResponse` 引用，加字段不影响任何现有发送方 - `packages/shared` TS 镜像同步（`{ collected: boolean; replayed?: boolean }` 与 `GameDistributionGame.collected?: boolean`），并按既有约定登记进 `scripts/check-game-distribution-dto-parity.mjs`（PAIRS + 手拼响应构建器）；注意 `json!` 字面量里不插注释行（parity 脚本抓顶层键时不剥注释，这个坑今天踩过一次） - 技术方案：`§2.4` 入口矩阵补「收藏按钮 / 我的收藏（登录）与我的作品页同行风格」；`§3.4` 接口表补三条路由（含 404/409 语义、PUT 要求幂等键而 DELETE 不要求及理由、`my-collections` 只含公开作品且不删行）与公开详情 `collected` 的可见性口径；`§7` 把「收录/收藏」从范围外移除并标注已纳入落地 - 数据契约表目录：新增 `game_distribution_collection` 小节（主键确定性、两个索引、为什么不删行、为什么不建唯一索引），供 `check:spacetime-schema` 守卫通过（94 tables） - 门禁：DTO parity 0（**49 组** Rust/TS 一致，较本轮前 +7）；`check:spacetime-schema` 0（94 tables，对照新 merge-base `51cb05f4`）；`check:encoding` 0；`git diff --check` 0	2026-10-06 01:14:05 +08:00
suzmii	604ce7f3ec	feat(游戏共创): M2b 数据模型——版本行三列工程源包 + 契约与绑定（块 A） ... - `server-rs/crates/spacetime-module/src/game_distribution.rs`：`game_distribution_version` 表尾追加三列（明确默认值，遵循既有追加规则）——`project_bundle_object_key: Option<String>`（`#[default(None)]`）、`project_bundle_bytes: u64`（`#[default(0)]` = 未上传）、`project_bundle_sha256: Option<String>`（`#[default(None)]`）；三列同步进 `GameDistributionVersionSnapshot`、版本快照构造与建版本时的初始化 - 同文件：`GameDistributionForkSourceSnapshot` 与扁平结果类型追加 `project_bundle_sha256` / `project_bundle_bytes`，下行据此判断走 `project` 还是回落 `package`（字节数与摘要成对，缺一视为没有工程包） - 同文件：新增 `GAME_DISTRIBUTION_ACTION_UPLOAD_PROJECT_BUNDLE` 动作常量、输入 `GameDistributionConfirmProjectBundleInput`、事务 `confirm_game_distribution_project_bundle_tx` 与 procedure `confirm_game_distribution_project_bundle_and_return`。语义：可选资产、**不驱动版本状态机**；owner 校验 → 阶段门（`awaiting_upload` / `upload_failed`，与发行包确认同口径，已公开/已取消/已撤回一律拒绝）→ 同内容幂等重放 / 换内容冲突 → 写三列 + 幂等收据 - `spacetime-client`：`GameDistributionVersionRecord` 与 `map_version` 同步三列（生成绑定把 `project_bundle_sha256` 折成 `project_bundle_sha_256`，与 `package_sha_256` 同约定）；新增 `GameDistributionConfirmProjectBundleRecordInput` 与 `confirm_game_distribution_project_bundle`（沿用 `map_game_distribution_game_result` 再取 version 的既有写法） - 契约：`shared-contracts` 的 `GameDistributionPrivateVersion` 追加 `project_bundle_bytes`（必需，`0` = 未上传）与 `project_bundle_sha256`（可选）；`packages/shared` TS 镜像同步；api-server `private_version_payload` 追加同名键——**对象键不下发**，只回摘要与字节数 - 生成物：重跑 `npm run spacetime:generate -- --rust-only`，只保留 `module_bindings/game_distribution*`（含 2 个新文件）与 `module_bindings.rs`，其余 `module_bindings/**` 的 rustfmt 漂移已 `git checkout --` 还原 - 文档：数据契约表目录 `game_distribution_version` 小节补三列语义与对象键不出服务端的口径 - 顺手记下一条门禁陷阱：`scripts/check-game-distribution-dto-parity.mjs` 抓 `json!` 顶层键时要求「键前一个非空字符是 `{` 或 `,`」且**不剥注释**，在字面量里插注释行会让紧随其后的键被判成缺失（已写进 `private_version_payload` 的文档注释） - 门禁：wasm build 0；`cargo check --all-targets` 0；`cargo test -p module-game-distribution` 69 passed；`cargo test -p api-server game_distribution` 54 passed；DTO parity 42 组 OK；`check:spacetime-schema` 92 tables OK；`check:encoding` 5301 files OK；`git diff --check` 0；`cargo fmt --all -- --check` 0	2026-10-05 17:30:48 +08:00
suzmii	eeb345f2ad	feat(游戏共创): 上架时即可指定共创授权档位（创建作品请求增量） ... - TS 契约 `GameDistributionCreateGameRequest` 新增可选 `forkAuthorization?: GameDistributionForkAuthorization`，注释写明缺省禁止共创、非法值整请求 400、上架后只能单向提升 - Rust 契约同结构体新增 `#[serde(default)] pub fork_authorization: GameDistributionForkAuthorization`（非 `Option`）：省略与显式传 `forbidden` 得到同一个值，**幂等摘要因此相同**——创建请求的摘要取自整个请求体，若写成 `Option` + `skip_serializing_if`，两种写法会变成「同 key 不同请求」而互相冲突；未知取值由反序列化直接拒绝 - api-server `create_game`：载荷改为 `Result<Json<..>, JsonRejection>`，拒绝统一映射成平台信封 400（与 `set_fork_authorization` 同修法），并按 rejection 文本区分文案（含 `forkAuthorization` → 「共创授权档位不合法，只接受 forbidden / nonCommercial / full」，其余 → 「创建作品请求字段不合法」；框架文本只用于选文案，不回传客户端）；创建记录入参新增 `fork_authorization: fork_authorization_value(payload.fork_authorization)` - spacetime-client：`GameDistributionCreateGameRecordInput` 新增 `fork_authorization: String` 并透传给 procedure；重新生成的 `GameDistributionCreateGameInput` 同步带上该字段 - spacetime-module：`GameDistributionCreateGameInput` 新增 `fork_authorization: String`；创建事务里用 `ForkAuthorization::parse` 解析，未知取值失败关闭（`FORK_AUTHORIZATION_UNKNOWN`，**不静默落成 forbidden**），并把原来的硬编码 `FORK_AUTHORIZATION_FORBIDDEN` 换成解析结果 - 资料编辑复用创建校验的转换函数与既有测试夹具按新字段补默认值；AGC 侧测试字面量同步（AGC 发布面板的 UI 接线留到后续，缺省值等价于不传） - 测试：`create_game_request_defaults_fork_authorization_without_changing_digest`（缺省 → forbidden；显式 forbidden 与原缺省**摘要相同**；`nonCommercial` / `full` 原样保留；`"allowed"` 反序列化失败）与 `create_game_rejects_unknown_fork_authorization_with_envelope_bad_request`（未知档位 → 400 + 平台信封且无框架纯文本；非档位字段问题走通用文案；合法载荷不会被误拒——测试态发布灰度未配置，得到 503 而非 400，即证明载荷路径已通过且未触达创建） - 文档：技术方案 §2.4（发布入口上架时即选档位）、§3.4（`POST /games` 请求增量补 `forkAuthorization`）、§3.9（补充说明上架指定档位已支持、事后提升仍保留）	2026-10-05 17:30:46 +08:00
suzmii	8f87c826cf	feat(游戏共创): M2a 受鉴权内容下发通道（fork-source 元数据 + 整包取件） ... - 契约：新增 `GameDistributionForkSourceKind` / `GameDistributionForkSource` / `GameDistributionForkSourceResponse`（shared-contracts + TS 镜像 + parity 登记），字段 `gameId / versionId / source / sha256 / bytes / downloadPath`，**不含对象键** - 读取：spacetime-module 新增 `GameDistributionForkSourceInput`、扁平结果类型与 procedure `get_game_distribution_fork_source_and_return`；tx 把「行是否存在 / 能否作为来源（未删+已公开+有当前公开版本）/ 授权档位原值」分开回传——既有 owner-or-public 读会把「已软删除」与「未公开」都折成 None，HTTP 层就没法区分 404 与 409；`sha256` / `bytes` 取自版本行，不重算 - 客户端：spacetime-client 新增 record + mapper + `get_game_distribution_fork_source`（生成绑定把 `package_sha256` 折成 `package_sha_256`，与版本快照同约定） - 路由：新增 `fork_sources` 子路由（`require_bearer_auth` + `add_no_store_response_headers`，**不叠加发布灰度**），两条：`GET …/fork-source`（元数据）与 `GET …/fork-source/package`（ZIP 字节） - 校验：抽出纯函数 `fork_source_target` 供两个 handler 共用——404 `FORK_SOURCE_NOT_FOUND` / 409 `FORK_SOURCE_NOT_AVAILABLE` / 403 `FORK_NOT_AUTHORIZED`（未知档位按禁止解释）；`available` 为真却缺版本元数据时失败关闭为 409 - 取件本体：复用发行网关的 `release_package_bytes`（整包进内存 + 进程内缓存，4 条 / 256 MiB），不新造 OSS 客户端；缓存值由 `Arc<Vec<u8>>` 改为 `Bytes`，整包交给响应体只加引用计数、不复制；响应**不做**引用归一化与 `RELEASE_STORAGE_BOOTSTRAP` 注入（下发原始构建产物，客户端按摘要校验后离线解压）；`RELEASE_PACKAGE_CACHE` 顺手改用 `LazyLock`（初始值编译期已知） - 路径：`downloadPath` 为同源相对路径，复用新抽出的 `is_path_safe_game_id`（与发行入口同一判据），绝不下发对象键 - 测试：新增 4 条——两条路由未带 Bearer → 401；`fork_source_target` 的 404 / 409 / 403 / 未知档位 / 缺元数据失败关闭逐项断言（409 先于 403）；元数据 payload 的 sha256/bytes 取自行、downloadPath 形状、序列化后不含对象键；取件包头与长度（`application/zip`、`Content-Length` = 行 `package_bytes`、`Content-Disposition`、`no-store`） - 文档：技术方案 §3.4 把两个接口从「规划」改成与实现一致的形状，并单独拆出「登录用户（Bearer，不叠加发布灰度）」小节；§3.5.1 的「下载通道（当前不存在）」改为 M2a 已实现，写明它只服务当前公开版本、不做归一化、大包续传仍待做	2026-10-05 17:30:45 +08:00
suzmii	39669763fe	实现游戏共创 M3：创作族谱树与衍生列表 ... - 新增 module-game-distribution/src/lineage.rs：锚点可读性、可见性过滤、稳定排序、上限截断的纯函数，附 15 个单测（复用 M1 的软删除判定，不重写第二套规则） - 新增公开只读 procedure get_game_distribution_lineage / list_game_distribution_derived_games；锚点必须公开可读（未公开/已软删除/不存在一律按不存在处理），树内只出现未软删除且已公开的节点，不补 null 占位节点 - api-server 新增 GET /games/{id}/lineage 与 /games/{id}/derived（匿名可读、no-store），响应走结构化 DTO，节点键集合由测试钉死，杜绝下发对象键/素材键 - 作者自有游戏聚合追加 forkCount（与公开详情 forkCount 同口径），供「被改编 N」入口使用 - shared-contracts 与 TS 契约新增 LineageNode / LineageResponse / DerivedResponse 三型并登记 DTO 一致性检查 - 前端新增 /games/lineage 族谱页，登记 stage 类型、路由表、页面标题与壳层渲染分支；详情页共创卡新增「查看创作族谱」入口（仅已公开作品） - 我的作品页新增「被改编 N」行内展开，列出直接子代的标题/作者/代际/状态，含空态与失败重试（仅已公开作品） - 补前端组件/路由/标题/客户端用例与 api-server 路由、负载映射用例；同步里程碑验收标准与技术方案 §3.4 的锚点可读性口径	2026-10-05 17:30:45 +08:00
suzmii	1e7ec6dbe7	实现游戏共创 M1：作品级共创授权与改编血缘 ... - game_distribution_game 表尾追加 fork_authorization（默认 forbidden，只升不降，旧行自动取默认） - 新增 game_distribution_lineage 表，记录父作品、来源版本、根作品与代际，并按 parent/root/owner 建索引 - migration.rs 登记新表并注明血缘随迁移导出 - 新增 set_game_distribution_fork_authorization_and_return procedure 与幂等收据、期望值 CAS - 创建作品时校验改编声明：来源存在、已公开、授权开放、来源版本等于当前公开版本；复用既有身份时拒绝携带血缘 - 公开与后台响应增量：forkAuthorization、forkCount、lineage、generation、forkedFromGameId、derivedCount - 公开快照的作者名与头像改为读时联 user_account，不再落到「创作者」兜底文案 - api-server 新增 PUT /api/game-distribution/games/{game_id}/fork-authorization（Bearer、幂等键、期望值校验） - 错误映射新增 FORK_ 前缀分支并置于通用子串分支之前，避免被误判成 409 或 404 - module-game-distribution 增加授权阶梯、代际计算与错误码，并补单测覆盖阶梯与错误码前缀 - 网页端详情页新增共创信息卡，我的作品页新增授权提升入口，补服务层调用与定向测试 - 重新生成 SpacetimeDB 绑定，登记 DTO 一致性脚本的共创类型	2026-10-05 17:30:44 +08:00
suzmii	7b38ef9623	网页端接入游戏买断制泥点付费 ... - packages/shared 游戏契约补买断价与购买态：GameDistributionGame 增 priceMudPoints/purchased，版本摘要 entryUrl 可为 null - packages/shared 版本请求增 priceMudPoints，私有版本回读增同名字段；新增购买请求、购买记录、购买响应与播放会话 DTO - packages/shared 钱包流水来源类型增 game_purchase，网页与共享账单文案增「购买游戏」标签 - 游戏分发客户端新增 purchaseGame（Idempotency-Key + 期望价格）与 createGamePlaySession - 发布页新增「付费方式」免费/买断制表单，定价校验与服务端 0..=1000000 口径一致，价格随版本请求提交 - 详情页展示定价、付费未购买时主动作改为「N 泥点购买」，复用泥点确认弹窗展示余额，成功后刷新钱包并回到可玩状态，余额不足给出充值入口 - 游玩页付费作品先签发播放会话再挂载 iframe，免费作品链路不变；会话被拒时不挂载 iframe 也不上报游玩 - 发行入口守卫接受播放会话前缀路径，拒绝其它非发行路径 - 定向契约测试登记 4 组购买/播放会话 DTO，补发布定价、未购买不可玩、购买确认与播放会话挂载用例	2026-10-05 16:59:45 +08:00
suzmii	daae35a1a1	AGC 发布版本标签改由工程内部版本派生，拆除 projectVersion 写链路 ... - shared contracts：resolveGameCreationAppProjectVersion 改为按 manifest.versions 条数派生，删除 isGameCreationAppProjectVersion，projectVersion 注释降级为遗留兼容位 - Rust shared-contracts：删除 resolve_game_creation_app_project_version / is_game_creation_app_project_version / GAME_CREATION_APP_FIRST_PROJECT_VERSION，project_version 注释改遗留位并重写往返测试 - AGC 发布面板：项目版本改为 useMemo 派生只读输入框，删除本地 state、失焦落盘与 onManifestUpdated 回调 - AGC 发布服务：删除 saveGameDistributionProjectVersion，提交版本号缺省改为按 versions 派生 - AGC 原生：发布成功回写与绑定回填不再写 project_version（置空），删除 update_game_distribution_project_version 命令 - AGC 命令注册与白名单：desktop.rs 注销命令、check-config.mjs 移除白名单条目 - AGC 前端装配：App.tsx 移除两处 onManifestUpdated 传递 - AGC 测试：publish/panel 两条测试改为覆盖派生口径，删除四条写回用例 - 注释对齐：game_publish_attempt.rs / project/manifest.rs / styles.css / shared-contracts 的 game_distribution.rs 把版本标签口径改为「由 versions[] 派生」，清掉 projectVersion 遗留位表述 - 文档：decision-log 追加本决策条目，两份 2026-10-02 计划加取代标注，新增 2026-10-03 里程碑与实施计划	2026-10-04 00:16:14 +08:00
suzmii	3aa3e33ceb	实现统一项目发行版本 ... 以 projectVersion 作为 AGC 唯一用户版本，支持同版本重复提交和版本回退。 保留 publicationRevision 并发校验与旧客户端自动递增兼容。	2026-10-03 16:41:04 +08:00
suzmii	44f02ee19b	完善游戏审核试玩与客户端版本更新 ... 后台审核详情复用公开游戏详情样式，补齐发布者、冻结资料、素材换签和待审 ZIP 试玩。 AGC 保存已发布作品绑定，支持同一 gameId 更新版本并由用户填写目标版本号。 保留 SpacetimeDB 表结构不变，增加版本号请求校验、幂等边界和本地清单字段。	2026-10-03 12:35:57 +08:00
suzmii	72aff6a6e6	合并 origin/master 到作品管理分支	2026-10-02 15:14:34 +08:00
lhk229	b60aea4e71	实现网站游戏评分与评价 (#561) ... 公开游戏详情页新增评分与评价：登录用户可提交并修改自己对每款游戏的唯一一条 1–10 分评价，评论可空且最多 4000 个 Unicode 码点；游客可分页浏览评价并查看平均分与评分人数。 - 新增私有评价表及共享 DTO/API，事务内校验游戏公开可见性、保证唯一性，并计算分页与全量评分统计；下架或封禁后关闭读写，重新公开及更新版本保留评价。 - 详情页支持编辑预填、取消、提交期间冻结输入、失败保留草稿，以及保存、翻页和账号/游戏切换时的旧响应隔离；复用现有认证与公共组件。 - 同步主规范、里程碑、实施计划、生成绑定、表目录和验收脚本。不扩展 AGC、外部 API、评论审核或评分缓存。 验证： - 本轮审查复跑前端定向测试 40 项、评价领域测试 2 项，均通过。 - 网站 typecheck、Rust/TypeScript DTO 对齐、SpacetimeDB schema、文档索引、编码与 diff 检查通过。 - 实施文档另记录本地隔离数据库/API 49 项及桌面/移动视口浏览器 smoke 通过；本轮审查未重跑这些运行时验收，也未运行完整测试套件。 发布说明：新增 SpacetimeDB 表，部署时需同步 module 与 API。尚未部署 dev/production，待用户验收。 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/561 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-10-01 19:19:58 +08:00
suzmii	a2b70d92b8	作品管理与Phaser4客户端发布闭环 ... 补齐 Phaser4 客户端发布前校验、阶段进度与原生幂等账本 增加 Web 作者私有作品管理、资料编辑、版本历史与软删除 增加后台作品筛选、游标分页与删除治理 同步 SpacetimeDB schema、bindings、DTO、文档与定向测试	2026-10-01 16:30:40 +08:00
kdletters	46d8768529	对齐游戏分发响应 DTO 的 Rust 与 TypeScript 字段 ... - 给 GameDistributionGameSummary 补 coverObjectKey / screenshots / publicationRevision，给 GameDistributionPrivateVersion 补 publicationRevision，与 game_payload / private_version_payload 实际发出的键一致 - packages/shared 的 GameDistributionGame.currentVersion 改为可选，并写明作者侧响应自带同一份 game_payload 但不发这一项 - 删掉 DTO 一致性门禁里豁免这 4 个字段的 TS_ONLY_FIELDS 白名单，现在任一方向多出字段都会失败 - 同步游戏分发里程碑第 6 条的取证与剩余缺口	2026-09-28 17:58:00 +08:00
kdletters	87e52860a7	游戏发行入口改为平台同源路径 ... - 审核通过时由 api-server 按 gameId 派生 /games/{gameId}/ 相对路径写入公开投影，删除 AppConfig 的发行入口模板字段与读取逻辑 - 删除 deploy/env 两份示例中的 GENARRATIVE_GAME_DISTRIBUTION_RELEASE_ENTRY_TEMPLATE - 三份 nginx 模板内联同源发行入口 location，把 /games/<gameId>/ 与子资源转发到发行网关并在边缘清空 Cookie - SPA allowlist 补齐 components、design-system、games、games/detail、games/mine、games/play、games/publish - 前端 normalizeGameEntryUrl 支持相对路径与同源发行路径，按当前 origin 解析并补尾斜杠，继续兼容历史绝对 URL - 删除退役的独立来源模板 deploy/nginx/genarrative-release-origin.conf、门禁脚本 scripts/check-release-origin-config.mjs 与其 npm 脚本 - 游戏分发 e2e 脚本改为在公开投影上断言 entryUrl 等于 /games/{gameId}/ - 同步平台主规范、运维主规范、nginx README 与共享决策记录	2026-09-24 00:21:27 +08:00
kdletters	297d7bf1e7	优化 AGC 发布资料与截图交互 ... 发布门禁阻断提示改为独立弹窗且不写入聊天记录 移除发布面板发行包技术摘要 新增免费发布简介与分类建议接口和前端回填 接入封面泥点定价、确认与生成流程 截图改为并行上传，单张失败隔离且不阻断发布 截图操作改为图标，失败项内嵌错误与删除 同步发布合同、实施计划和决策记录	2026-09-23 17:40:08 +08:00
kdletters	4a2b270714	补齐游戏分发封面与截图的冻结、上传与展示 ... - 服务端：游戏表追加可空 cover_object_key / screenshots_json，版本表追加可空 metadata_json，创建版本时校验必需封面、最多 6 张截图与图片素材归属，并从素材记录派生对象键生成冻结资料。 - 服务端：审核通过时把冻结资料整体生效到游戏行；只有已公开且存在有效活动版本的游戏，其封面/截图素材才在 /api/assets/read-url 获得匿名读授权。 - 服务端：作者与管理员回读版本时追加 frozenMetadata，带回封面与截图素材 ID 供续发复用，公开投影仍只暴露对象键。 - 网页：/games/publish 新增「封面与截图」区，复用平台图片直传与 confirm 通道，缺封面或截图超量在发请求前拦截，更新版本时按冻结资料回填且不要求重新上传。 - 网页：游戏广场卡片与详情页 hero 换签展示真实封面，详情页新增可点击的截图缩略图条，无素材或换签失败时静默回退原有渐变占位。 - AGC：发布面板支持封面必选与截图最多 6 张，新增素材直传服务并在创建游戏前拦截缺封面，同一文件重复提交复用素材 ID。 - AGC：http 能力作用域新增阿里云 OSS 直传地址，客户端同时校验直传目标必须是平台素材存储。 - 契约与文档：同步 shared-contracts、packages/shared 契约，更新 SpacetimeDB 迁移注释、后端架构、玩法链路与实施计划文档，并补齐网页端与 AGC 定向测试。	2026-09-20 22:19:50 +08:00
kdletters	328ac31844	恢复游戏分发完整实现（特性分支） ... - 主站：游戏广场、详情、在线游玩、网页发布与作者中心，以及共享契约与客户端服务 - 后端：module-game-distribution 领域层、SpacetimeDB 表/迁移/绑定、spacetime-client facade、api-server 路由与发行网关 - 后台：游戏审核页（待审列表、通过/拒绝、安全下架） - AGC：发布面板、本地导出包读取命令与发布服务，含默认跳过的真实链路测试 - 运维：发行来源 nginx 模板与门禁、game-distribution:publish 灰度发布开关、OSS PutObject 受控重试 - 文档：主规范、里程碑与实施计划、决策日志与踩坑记录	2026-09-20 20:49:42 +08:00