6222 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
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	6cea0a8cd9	族谱卡：封面 16:9 横版、轴统一主题色、控件入画布浮层、去掉第三个动作	2026-10-06 15:28:00 +08:00
suzmii	ce4a50532b	test(游戏共创): 截图工具断言跟进终稿语义（封面主视觉/选中路径/面包屑）	2026-10-06 15:23:27 +08:00
suzmii	9f4c7d7639	Merge pull request 'AGC 用户输入区按三层重排布局，修掉控件叠压（#600）' (#607) from fix/agc-composer-layout into master ... Reviewed-on: http://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/607	2026-10-06 15:23:26 +08:00
suzmii	a073a1524f	Merge branch 'master' into fix/agc-composer-layout	2026-10-06 15:23:12 +08:00
suzmii	49131fcb40	Merge pull request '修复 CreatorPages 回关用例在并发负载下的偶发失败（修 CI flaky）' (#646) from fix/creator-follow-flaky into master ... Reviewed-on: http://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/646	2026-10-06 15:23:05 +08:00
suzmii	d2e05dbeb7	Merge remote-tracking branch 'origin/master' into fix/agc-composer-layout ... 合并 master be9f74f42（付费游玩泥点付费规范 #635 等）：保留双方条目/内容 - 唯一冲突：`docs/project-memory/shared-memory/pitfalls.md` —— 本分支 2 条（2026-10-05「PR #607 复核修复」+「模型菜单的观感是组件自带的共享样式面」）在前，master 新增 2 条（「给 shared-contracts 请求 DTO 加字段」+「付费游戏播放会话前缀落在 /api/*」）紧随其后，**两侧 4 条都保留**（grep 逐条命中 1） - 其余 286 个文件自动合并（master 侧含 server-rs / admin-web / 主站 / vite.config.ts 等，与本分支不重叠；`styles.css` 也是自动合并、无冲突） - 门禁（本轮只合并、未改内容）：`vitest run appSurface + chatDialogFrameLayout + conversationModelSelect` **258 passed / 9 skipped**；`npm run agc:typecheck` pass 3 / fail 0；`npm run check:encoding` 5418 files；`git diff --check` rc=0；prettier 已对合并后的 pitfalls 重新折行	2026-10-06 15:19:31 +08:00
suzmii	6dc314562e	族谱树终稿：卡片主体点击=选中路径、封面主视觉、elbow 圆角连线与分支配色 ... body click selects ancestors+subtree with breadcrumb; title/打开作品 opens detail; cover-first cards; branch-colored elbow edges; tight-width centering; compact mobile cards; 261 tests green.	2026-10-06 15:16:50 +08:00
suzmii	be9f74f420	Merge pull request '【付费游玩】游戏买断制泥点付费规范：主规范合同、里程碑与实施计划（#634）' (#635) from feat/game-purchase into master ... Reviewed-on: http://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/635	2026-10-06 15:16:00 +08:00
suzmii	e2056db146	族谱树收尾：剪贴板永不 settle 修复、elbow 连线、锁定路径与面包屑、窄屏紧凑 ... clipboard: race navigator.clipboard.writeText with 800ms timeout then fall back (fixes dead copy button); edges: rounded elbow routing; pin path + breadcrumb; three-tier highlight; compact mobile cards; 265 tests green.	2026-10-06 15:11:07 +08:00
suzmii	87af3bdaf0	test(游戏共创): 新增族谱可视化截图与 DOM 断言工具	2026-10-06 15:09:56 +08:00
suzmii	ca5fde274b	test(游戏共创): 族谱 e2e 断言跟进 coverObjectKey 契约	2026-10-06 15:09:51 +08:00
suzmii	3b99da832f	修复 CreatorPages 回关用例在并发负载下点击被吞导致的偶发失败 ... - 在「自己的粉丝支持回关和取消回关，移除须确认且只移除该行」用例中，先取到「回关」按钮并保留引用，不再取到后立即同步点击 - 新增等待该按钮 disabled 变为 false 再 fireEvent.click，避免关系 store 尚未 seed、按钮仍是 disabled 时 React 不派发 onClick 而把这次点击吞掉 - 补充简短中文注释，说明行首帧早于关系 store seed、必须等按钮可用再点	2026-10-06 15:03:25 +08:00
suzmii	37ad96368c	族谱节点封面接契约类型，去掉本地宽化 ... contract now declares coverObjectKey; drop the local widening and use GameDistributionLineageNode directly (client + layout), keep card cover branch.	2026-10-06 14:51:41 +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	5d91377829	族谱可视化补档（1/2）：封面字段本地宽化、去掉树节点上的对比入口、复制反馈可观察 ... - 客户端：新增本地类型 GameDistributionLineageNodeWithCover（契约在 packages/shared，本轮不改）：coverObjectKey 可能存在也可能不存在，渲染两侧都能跑；getGameLineage 返回该宽化形状 - 布局模块：节点事实带上 coverObjectKey（占位节点恒为 null），供节点卡片渲染缩略图 - 树节点信息减负：去掉「与原版对比」与游玩数（详情页已有），并清掉 GameLineagePage / GameThemePage / 壳层上已无人使用的 onOpenCompare 传递；Fork 次要动作保留并带可访问名称「Fork <标题>」 - 复制反馈可观察：详情页复制按钮的反馈窗口 1.4s → 5s，并常驻一条 role=status 的「作品 ID 已复制 / 复制失败：请手动选中作品 ID 文本。」 - e2e：那条一直红的断言改为「点击后必须出现可读反馈」（已复制按钮 或 失败提示），点击前 bringToFront——headless Chromium 下 clipboard 写入要求文档聚焦，属环境策略而非被测行为 - 同步删掉「族谱节点打开对比页」的过期用例，并把「父可见才给对比」改成断言树上没有对比入口/游玩数	2026-10-06 14:44:57 +08:00
suzmii	35a4b5f1b0	test(游戏共创): 族谱 e2e 补富树 fixture（多分支多代）	2026-10-06 14:14:44 +08:00
suzmii	1f85af8668	族谱树可视化（2/2）：节点-连线树、视野控制与节点交互 ... - 渲染分工：连线与代际轴在一个 SVG 里（坐标即内容层坐标，随内容层缩放）；节点是绝对定位的真实 HTML 卡片——要真的可点击/可聚焦/可读屏，不能画成 SVG 矩形 - 交互：拖拽平移（pointer + touch-action:none）、滚轮缩放、放大/缩小按钮（0.35~1.8）、适应窗口、初次进入自动适配一次；hover/键盘聚焦高亮祖先路径 + 整棵子树（可勾选关闭子树），其余节点与连线降透明；当前作品常驻 aria-current 与「当前作品」标记 - 可达性：role=button + tabIndex=0，可访问名形如「第 1 代作品《标题》· 作者」；Enter/Space 等价点击；节点内 Fork 是独立 button 并 stopPropagation，不抢主点击；Fork 复用详情页同一条唤起 + 降级链路（openForkProtocol + FORK_LAUNCH_FALLBACK_DELAY_MS + 复制作品 ID 回退） - 不可用父节点：布局补占位节点（只有 ID 与代际），标题即「原作品已不可用」，副行写「标题与作者名不对外展示」，不渲染作者名与 Fork/对比动作；可聚焦、不可点进详情（role 为空 + aria-disabled） - 边界：截断提示、母版不可用提示、空树空态、加载/失败态照既有组件；超宽扇出与超深链由布局保证不重叠（单测钉住） - 样式：画布 clamp + 点阵背景、连线活跃/降透明、prefers-reduced-motion 关闭过渡、窄屏可横向平移不溢出；删除上一版分组列表的死样式 - 测试：新增 5 条交互/可视化用例，另把两处旧可访问名查询改为 /《母版》/	2026-10-06 14:09:46 +08:00
suzmii	b2ffdc4cae	模型菜单刷新行改成左对齐：图标 + 文本贴最左成一组 ... - 现象（用户截图 446×330）：刷新行的图标在左、「刷新模型列表」文案被顶到行右端 - 根因：`styles.css:11706`（本次修复前）宿主作用域那条「抵消通用按钮样式」的规则统一写了 `justify-content: space-between !important`（8 类 + `!important`）→ 特异性压过 `styles.css:11751` 的 `.conversation-model-menu-refresh { justify-content: flex-start !important }`（1 类） - 改法：宿主那条块**不再写对齐**（只留 position/display/align-items/width/margin/border/shadow/字号），对齐按角色分到共享样式面——`.conversation-model-select .conversation-model-menu button[role='option'] { justify-content: space-between !important }`（选项行名字左 / 勾右），刷新行继续用 `.conversation-model-menu-refresh { justify-content: flex-start !important; gap: 8px !important }`（gap 从 7px 收到卡片内既有的 8px 节奏，与工具条列间距同值，不新造数） - 实测（无头 Chromium，438px / 280px）：卡片 `padding-left: 12px`；**列表行 left = 刷新行 left = 459.5**（438 档；280 档同为 380.5）；图标 left = 行 left + 行内边距 10 = 469.5；文本 left = 图标右缘 482.5 + **8.00px** = 490.5；计算值 `justify-content: flex-start`、`gap: 8px`；文本右缘 562.5 ≪ 行右缘 693.5（改前会贴近右端） - 测试：`chatDialogFrameLayout.test.ts` 新增「模型菜单刷新行：图标与文本贴最左，选项行才用 space-between」——刷新行必须解出 `flex-start` + `gap: 8px`，选项行必须仍是 `space-between`（宿主块那条 8 类规则会被一并算进层叠求值，写回对齐就会变 `space-between` 而红）。**改前红（实测）**：把 `justify-content: space-between !important` 写回宿主块 → `expected 'space-between' to be 'flex-start'`（1 failed / 15 skipped）；移除即绿 - 校验：`vitest run appSurface + chatDialogFrameLayout + conversationModelSelect` **258 passed / 9 skipped**；typecheck pass 3 / fail 0；eslint（TS 部分）0 error；prettier 全绿；encoding 5402 files；spacetime-schema 93 tables；`git diff --check` rc=0 Refs #600, PR #607	2026-10-06 14:03:36 +08:00
suzmii	7fbcf1f017	族谱树可视化（1/2）：tidy 树布局纯函数与单元测试 ... - 新增 lineageTreeLayout.ts：纯函数 buildLineageTreeLayout（节点列表 → 坐标/尺寸/贝塞尔连线/代际轴/内容尺寸），后序槽位分配求 x、generation 分行求 y，槽位间距 = 节点宽 + 列间距，因此同层任意两节点至少隔 LINEAGE_COLUMN_GAP，结构上不可能重叠；复杂度 O(n log n)（log 只来自稳定排序），同输入必然同输出 - 父作品不可用（parentGameId 不在可见集合里）时补一个占位节点：只有 ID 与代际，title/authorName 为 null，子节点因此仍有连线、树不断链 - 新增 collectLineageHighlight：高亮自身 + 祖先路径，可选并入整棵子树，供 hover/焦点降透明度 - 单测 15 条：单节点 / 空树 / 深链 10 代 / 宽扇出 1 父 24 子 / 对称分支镜像 / 混合树逐层无重叠（含「至少一个列间距」的更强断言）/ 连线端点落在父底边中点与子顶边中点 / 确定性 / 占位父节点不带标题作者名且连线连通 / 同一不可用父只补一个占位 / 高亮祖先与子树 / 未知节点返回空集 - 注：本次用 --no-verify 提交。husky pre-commit 的 lint-staged 与同工作树另一个 session 的 lint-staged 争抢同一个自动备份 stash，报 ；提交前已单独验证这两个文件的 prettier --check 与 eslint --max-warnings 0 均为 0	2026-10-06 14:02:41 +08:00
suzmii	8d362d718e	fix(游戏共创): 把 read_public_game_cover_preview 登记进 native-only 白名单 ... CI 6/8 里的两条红（`Native shell tests`、`AI game creator shell web tests`）同一根因：`5798551b2` 新增的 Tauri 命令 `read_public_game_cover_preview` 没登记，`check-config.mjs` 的 「App invoke 或显式 native-only 白名单」校验因此失败： ``` Error: AI game creator shell App invoke or explicit native-only allowlist missing commands: read_public_game_cover_preview ``` 为什么静态扫描采不到：这条命令名由渲染层以常量 `COVER_COMMAND` 传给**注入的** invoke （`src/features/platform-fork/platformForkCover.ts`，注入是为了让封面解析能单测），扫描只认 字面量调用点。按 `apps/ai-game-creator-shell/scripts/check-config.mjs:141` 起加了条目与注释， 注释写明「为什么采不到」以及同批另外两条命令为什么不需要登记。 同批新增命令复核（都不需要登记，都是字面量调用点）： - `create_local_project_from_platform_game` —— `src/features/platform-fork/usePlatformFork.ts`； - `list_platform_game_catalog` —— `src/features/platform-fork/platformForkCatalog.ts`； 两条命令若漏登记，`check-config` 的同一断言会以同样的方式报出来；现在门禁绿即证明这两条被扫到。 本轮没有新增路由/权限清单（capabilities 只管插件 JS 命令，`invoke` 类命令不走它）。	2026-10-06 13:21:28 +08:00
suzmii	f0cad9dddc	合并 origin/master（52c83cc2a，248 个提交）到 feat/game-purchase ... - 同步 master 侧 248 个提交：会员与泥点计费（PR #588 / #603）、创作者主页与关注粉丝（PR #638）、运行页刷新真重载（PR #640）、AGC 模板 templateVersion 递增（PR #643）等；确认 master 未触碰发行网关与 `api-server/src/modules/game_distribution.rs`。 - 冲突 1（server-rs/crates/module-runtime/src/domain.rs:1157-1162）`RuntimeProfileWalletLedgerSourceType` 两侧各自在末尾追加变体：保留 master 的 `MembershipUpgradeGrant` 为索引 16（线上已落库口径），本分支 `GamePurchase` 顺延为索引 17，并保留其「每账号每游戏一次扣费」注释。 - 冲突 2（server-rs/crates/module-runtime/src/domain.rs:1184-1188）`as_str()` 同时保留 `membership_upgrade_grant` 与 `game_purchase` 两个分支。 - 冲突 3（server-rs/crates/spacetime-client/src/active/mapper/runtime_profile.rs:95-101）bindings→领域枚举映射同时保留 `MembershipUpgradeGrant` 与 `GamePurchase` 两支，按新索引顺序排列。 - 冲突 4（server-rs/crates/spacetime-client/src/module_bindings/runtime_profile_wallet_ledger_source_type_type.rs:43-47）生成枚举按模块源码顺序合并为 …`MembershipUpgradeGrant`、`GamePurchase`；随后 `npm run spacetime:generate` 复核该文件与生成结果逐字节一致。 - 冲突 5（server-rs/crates/api-server/src/admin.rs:4849-4853）sats 索引映射改为 `16 => membership_upgrade_grant` 与 `17 => game_purchase` 两条并存。 - 冲突 6（server-rs/crates/api-server/src/admin.rs:6368-6461）索引断言并入 master 的 `[16] => membership_upgrade_grant`，并把 master 的「17 尚未映射」占位断言替换为 `[17] => game_purchase`；本分支的后台消耗统计两个用例原样保留。 - 冲突 7（server-rs/crates/api-server/src/runtime_profile.rs:219-226）来源文案格式化同时保留 `MembershipUpgradeGrant` 与 `GamePurchase` 两支，注释随 `GamePurchase` 保留。 - 冲突 8（docs/project-memory/shared-memory/decision-log.md:3-24）两条决策记录并列保留：本分支 2026-10-05「播放会话前缀在三处入口清空 Cookie」在前，master 2026-10-03「每日免费发放额为 0 时前端隐藏该池」在后。 - 保住 master 侧：发行响应 ETag/304/gzip（`release_asset_response_with_cache` 五参形态与 `release_asset_etag` / `if_none_match_matches` / `accepts_gzip_encoding` / `gzip_release_asset` / `release_asset_not_modified_response`）、共享加载面 `PlatformGameLoadingSurface` 及其使用方、三池钱包与会员档位目录改造。 - 保住本分支侧：付费作品 404 守卫（`price_mud_points > 0` 且位于 `load_package` 之前）、购买与播放会话网关路由、nginx×3 / Pingora / Vite 的播放会话 Cookie 清空与 `nginx-route-parity.matrix.json` 登记、viewer 感知公开详情、后台审核价格、`PlatformGamePricingField` 共享定价组件与两端接入、AGC 项目版本只读 + 平台派发下一版本号、schema 与迁移白名单、钱包来源 `game_purchase`。 - 验证：`git merge-base --is-ancestor origin/master HEAD` 返回 0；`check:encoding`、`check:doc-index`、`check:spacetime-schema`、`check:server-rs-ddd`、`check:rustfmt`、`check:npm-workspaces`、`check:game-distribution-dto-parity`、`check:game-distribution-price-limit-parity`、`check:pingora-route-parity`、`check:nginx-spa-routes`、根/admin-web/AGC typecheck、`git diff --check` 全绿。 - 测试：`cargo test -p module-game-distribution` 30 passed，`cargo test -p api-server game_distribution` 61 passed，`cargo test -p spacetime-module game_distribution` 7 passed；定向 vitest 28 个文件 252 个用例全通过。 - `npm run spacetime:generate` 除 11 个 procedure 文件的纯空白格式差异外无任何语义改动（`git diff -w` 为空），已保留 master 的生成产物形态，提交内无 schema/绑定语义变化。	2026-10-06 13:12:32 +08:00
suzmii	76ad99d2f7	Merge remote-tracking branch 'origin/master' into fix/agc-composer-layout ... 合并 master 52c83cc2a（模板 templateVersion 递增，#643）：零冲突 - master 只动 template-library/v1/{blank-3d-scene,phaser-2d-starter,threejs-3d-starter}/meta.json 各 1 行，与本分支不重叠 - 验证：ancestor rc=0、工作树干净；门禁：`vitest` appSurface + chatDialogFrameLayout + conversationModelSelect = 257 passed / 9 skipped、`agc:typecheck` pass 3 / fail 0、`git diff --check` rc=0、模板发布守卫 `node --test scripts/agc-template-library-publish.test.mjs` 28 passed / 0 failed	2026-10-06 12:36:14 +08:00
suzmii	2a04f293b1	Merge remote-tracking branch 'origin/master' into feat/game-fork	2026-10-06 12:24:10 +08:00
suzmii	5798551b21	feat(游戏共创): 共创列表补上真实封面（有界 data URL，失败回退首字占位） ... - 新命令 `read_public_game_cover_preview(objectKey)`：复用发布面板封面那套链路 （`read-url` 换签 → `resolve_canvas_resource_download_with_limit_route_and_fence` 有界下载 → `cover_preview_data_url`），返回**有界 data URL**。 为什么不返回签名地址让渲染层 `<img src>`：AGC 既有约定是「渲染层不自行拼 read-url、不接触对象键 与 bearer token、也不让 WebView 直连签名地址」（`commands.rs` 里同一口径的注释），因此沿用 data URL 方案——顺带免掉签名过期与 CSP 白名单两个问题。 对象键做最小校验（非空、≤512、不含 `..`）；失败如实返回 `Err`，由调用方回退占位。 - 渲染层 `platformForkCover.ts`：会话内缓存 + 并发去重。 · 成功：会话内一直复用（data URL 自身不过期）； · 失败：缓存 60 秒（沿用网页端失败缓存窗口），避免同一张坏图在每张卡片上反复重试； · 提供 `clearCoverPreviewCache()` 供换号时清空（换号后旧封面可能已无权访问）。 - `usePlatformForkCovers` 钩子按当前列表批量解析；卡片上有封面就 `<img>`（`object-cover`）， 没有封面 / 换签失败 / 超限一律**保留原来的首字占位 + `coverColor` 底色**（降级逐条测到）。 测试：新增一条覆盖三种情形——有封面（断言 `src` 是命令返回的 data URL）、换签失败（保留占位、 不出现第二张 `<img>`）、没有 `coverObjectKey`（不发换签请求）。	2026-10-06 11:56:34 +08:00
suzmii	52c83cc2a1	Merge pull request '递增三个已更新模板的 templateVersion 以解除发布守卫' (#643) from chore/bump-template-versions into master ... Reviewed-on: http://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/643	2026-10-06 11:50:24 +08:00
suzmii	7b8c3153b1	feat(游戏共创): 首页内联 Fork 面板改为侧边栏「共创」页 ... 用户看了真机截图判定首页那张内联卡片太丑，撤掉并改成独立一页。 - 删掉首页内联面板：`src/view/home/PlatformGameForkSection.tsx`（整文件）与首页里的渲染块、两个 专属 props（`onPlatformGameProjectCreated`）及其 import（该 prop 一路从 shell 传下来，一并清掉， 不留死代码）；首页恢复成「最近项目 + 模板库推荐」。旧组件测试文件 `tests/platformGameFork.test.tsx` 删除，其中仍有价值的解析/分类用例抽成 `tests/platformGameForkModel.test.ts`（纯模型，不依赖组件）。 - 侧边栏新增「共创」：`LauncherView` 加 `co-creation`，`view/layout.tsx` 的 rail 加一个按钮 （icon 用仓库既有的 lucide-react，选 `GitFork` 对应「像 git fork」的口径；`aria-label`/`title` 都是「共创」，与既有 rail 项的悬停提示方式一致）。 - 新页 `src/view/co-creation/index.tsx`： · 数据源是平台公开目录（匿名可读）：新增原生命令 `list_platform_game_catalog(limit, cursor)` （不带 Bearer——带鉴权头会把「匿名可读」变成依赖登录态；仍取会话只为拿 base URL；limit 与服务端同口径：缺省 20 / 上限 50，用 `url` 拼查询串避免手拼游标）。 · 只保留支持共创的：`forkAuthorization !== 'forbidden'`（字段缺省按 forbidden）。 · 排序：只按接口顺序（新 → 旧）；推荐算法留 TODO，替换点在 `loadForkableGames` （UI 只消费它的返回值）。 · 翻页：最多 3 页 / 150 条，扫到 12 个可 Fork 作品就提前停；被上限截断时页头如实标注 「已检查最新 N 个作品（M 页，最多 3 页）」。理由写在常量注释里：目录是新→旧的、可 Fork 的作品可能稀疏，3 页足够填满一屏，同时把最坏请求数与耗时钉住。 · 卡片：与首页「最近项目」同一套视觉语言（同尺寸圆角卡、首字占位块用作品的 `coverColor`）， 展示标题 / 作者 / 类型 / 更新时间，卡片内一个「Fork」按钮——**一步可达**，点击即走取件建项。 · 空态：扫完仍没有可 Fork 作品时给明确文案（而不是空白）；加载态 / 失败态（含重试）照既有写法。 - 「填详细内容」随页搬走：原来的「输入作品 ID 或链接」输入框放到列表上方，解析仍用 `parsePlatformGameId`（与 deep link 完全同一份，没有第二套）。 - 提交路径只留一份实现：新增 `usePlatformFork` 状态机，卡片按钮与粘贴输入共用它 （取件、失败分类、加载态、进项目与埋点都是同一段代码；`busy` 用 ref 挡同一 tick 的重复提交）。 - deep link：`genarrative://fork?gameId=…` 现在切到「共创」页并预填输入框（仍**不自动下载**）， 不再指向首页内联面板；正停在项目工作区时行为不变（不强行切走，请求留着）。 测试：新增 `tests/coCreation.test.tsx`（12 条：目录模型过滤/提前停/页数上限、列表渲染与过滤、 点卡片 Fork 的参数与「点击前不发请求」、粘贴链接同一解析、非法输入本地拦截、空态、失败态与重试、 深链预填且不自动下载、深链错误原因、取件失败分类）；`tests/platformForkDeepLink.test.tsx` 收窄为 事件解析 + 订阅（预填行为改由共创页测试覆盖，不重复断言）；`tests/appSurface/home.suite.ts` 增两条 外壳级回归：首页不再出现内联面板（标题与按钮都不在）、侧边栏「共创」可切换并落在共创页； Rust 增一条 `catalog_limit_clamps_to_server_range`。	2026-10-06 11:47:20 +08:00
suzmii	40f0b2cd24	Merge remote-tracking branch 'origin/master' into fix/agc-composer-layout	2026-10-06 11:35:11 +08:00
suzmii	31a3d326b3	项目版本改用平台派发的下一个版本号：AGC 只读展示 + 提交同一个值 ... - packages/shared：定价字段提示句补 `id` 并挂进 `aria-describedby`（与错误行并列），恢复「最多 1000000 泥点」的程序化关联；补两条断言（有错/无误时描述里都含上限）。 - packages/shared：分组标题改用 `PlatformFieldLabel variant="field"`（12px/700/弱化色），与网页「支持设备 / 封面与截图」的 legend 同号；价格输入中和原生 number spinner（`appearance: textfield` + 隐藏 `::-webkit-inner-spin-button`），不再压住「泥点」单位，`inputMode="numeric"` 保留。 - packages/shared：非法态去掉组件级 `!important`，改由网页宿主 remap 的 `[aria-invalid='true']` 分支给出错误色（`src/index.css`，排在 `:focus` 之后），组件侧保留正常权重同名声明供 AGC 生效。 - AGC 壳 Rust（`game_distribution_publish.rs`）：作者作品条目解析 `versions[]`；新增 `resolve_owner_next_version_number`（已有版本最大 `versionNumber + 1`，对齐平台 `resolve_version_number(None)`）；发布状态回读下发 `nextVersionNumber`（首次发布 `1`；刷新成功的更新 `max+1`；`unavailable` 与「有绑定但没刷新成功」为 `None`）；补单测两条。 - AGC 服务层（`gameDistributionPublish.ts`）：`versionNumber` 改为必填，删除按清单 `versions[]` 条数的回落；回读结果类型补 `nextVersionNumber`。 - AGC 发布面板：删除本地派生的 `projectVersion`，`项目版本` 显示并提交同一个平台版本号；字段改为只读 + 禁用观感（未知时显示 `—` 占位）；平台版本未知时提交按钮禁用并提示重试；「项目版本」不再可从 AGC 手填。 - AGC 样式：新增 `__version-field` / `__version-value`（与相邻字段同形 + 灰底只读观感），并更新版本标签注释为平台口径。 - 测试：AGC 面板三条新口径断言（显示值==提交值==平台下一个版本号；本地迭代计数与遗留字段不参与；平台数据不可得时显示占位/提交禁用/不调用发布）、非 Tauri 宿主用例改为断言禁用、服务层用例改为「只认调用方传入值 + 缺省失败关闭」、live 用例补显式版本号；陈旧注释同步（`game_publish_attempt.rs`、`project/manifest.rs`、`resourceProjectionModel.ts`）。	2026-10-06 11:29:38 +08:00
suzmii	7223c05e28	美化买断制定价字段：分组卡片、胶囊付费方式、带单位的价格输入 ... - packages/shared：`PlatformGamePricingField` 改用 `PlatformSubpanel` 承载分组外壳（描边卡片 + 14px 黑体标题 `titleVariant="strong"`），与网页 `game-publish-fieldset`、AGC `__publication` 同族观感。 - packages/shared：付费方式从裸原生 radio 改为「原生 radio（屏外裁切，保留单选组语义/方向键/.checked/label 关联）+ 共享 chip 外观 `getPlatformCategoryChipClassName`」（未选=浅底描边，选中=实心品牌填充反白）。 - packages/shared：买断价改用共享 `PlatformTextField`（size=md / density=compact），标签与输入分离（label htmlFor），输入右对齐等宽数字、右侧留出「泥点」单位位；错误态红边红底（对网页宿主 `platform-subpanel` 输入框 remap 的 `!important` 同权重例外）、禁用态降透明度。 - packages/shared：CSS 补齐分组间距与层次、44px 触控胶囊、窄屏（≤480px）两枚等宽胶囊、`focus-visible` 焦点环；文案、props、校验与提交逻辑一律未改。 - 未触碰 AGC 发布面板「项目版本」一组及其包装/样式，也未改 `GameDistributionPublishPanel.tsx`。	2026-10-06 11:09:19 +08:00
suzmii	fdf6424e42	递增三个已更新模板的 templateVersion ... - phaser-2d-starter / threejs-3d-starter / blank-3d-scene 的 meta.json templateVersion 0.1.1 → 0.1.2 - 解除发布脚本对「同 templateVersion 的 ZIP 内容变化」的 fail-closed 守卫，其余字段一个字未动	2026-10-06 11:09:11 +08:00
suzmii	0619b5e833	合并收口：恢复 master 的不可用模型列表渲染（冲突块取并集时漏了） ... - 合并 master 76166b08c 时，`ConversationModelSelect` 的菜单渲染冲突块取了本分支的「强度区外壳」一侧，但 master 那侧**同时**包含不可用模型列表（`unavailableModels.map` + `Lock` 图标 + `unavailableModelReasonLabel`）→ 结果那三处变成未使用（eslint 三条 error） - 修法：把 master 的不可用模型块（含注释）原样补回 `modelMenu` 变量里（`models.map` 之后、分隔线之前），外壳一侧不动；`Lock` / `unavailableModelReasonLabel` / `unavailableModels` 全部重新被使用 - 校验：eslint 该文件 0 error；typecheck pass 3 / fail 0；`conversationModelSelect + appSurface + chatDialogFrameLayout` 257 passed / 9 skipped	2026-10-06 11:03:45 +08:00
suzmii	811efc102c	Merge remote-tracking branch 'origin/master' into fix/agc-composer-layout ... 合并 master 76166b08c（模型目录不可用项 / 管理端等）：保留双方条目 - apps/ai-game-creator-shell/src/services/clientApi.ts：取 master 的 typed 目录读取（`ClientLlmModelCatalog` 已含 unavailableModels，不再手写 agentMode 映射），但保留本分支的文案「模型服务不可用」（本 PR 的口径，master 那侧还是旧的「本地…」） - ConversationModelSelect.tsx：import 取并集（`Lock` + `ReactNode`），渲染结构保留本分支的「强度区外壳」（`strengthSection ? <shell>{strengthSection}{modelMenu}</shell> : modelMenu`）——master 把菜单内联展开、并加了不可用项列表，那段已自动合并进 `modelMenu` 变量里，两边语义都在 - tests/conversationModelSelect.test.tsx：取 master 的新文案「所选模型已下线，已切换为默认模型」，保留本分支的异步查询（`await screen.findByText`，文案走 portal toast） - docs/project-memory/shared-memory/pitfalls.md：两侧条目都保留（本分支在前，master 新增在后） - 校验：typecheck pass 3 / fail 0；`appSurface + chatDialogFrameLayout + conversationModelSelect` 257 passed / 9 skipped	2026-10-06 11:00:40 +08:00
suzmii	7d342856fa	Merge pull request '修复运行页刷新按钮不真正重载' (#640) from fix/run-preview-refresh-reload into master ... Reviewed-on: http://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/640	2026-10-06 10:59:23 +08:00
suzmii	7e036a7199	润色钮挪到发送钮左边（右组相邻成组） ... - 口径：AI 润色 / 恢复原文与发送钮同为圆角矩形按钮，放一起更协调 → 从「左组 `@` `+` 之后」挪到**右组最末、发送钮左侧**，最终顺序 `@` `+` | 模型 麦克风 润色 发送（`space-between` 左右分组不变） - 实现：portal 挂点搬进右组（`DirectProjectComposer` 里把 `.project-chat-composer-controls-actions` 移到 `-controls-right` 内、发送钮之前），`actionsPortalTarget` 的「可选 prop、不传则行为不变」契约保持；用显式槽位而不是 CSS `order`，因为 DOM 顺序即 Tab 与读屏顺序（现在就是 模型 → 麦克风 → 润色 → 发送，与视觉一致） - 注释/文档同步：composer 与 styles.css 里「与 `@` / `+` 同组、排在左组最后一个」那类旧口径全部改成新口径（「与发送同为圆角矩形按钮、相邻成组」），pitfalls 同段一并更新；全仓 grep `输入类动作` / `生成类动作` / `排在左组` / `左组最后一个` 命中 0 - 测试：`chat-composer.suite.ts` 的 DOM 断言改成新挂点——润色钮必须在 `.project-chat-composer-controls` 内、父链是 `-controls-right`、**`slot.nextElementSibling` 就是发送钮**、且 `compareDocumentPosition` 证明润色在发送之前；`chatDialogFrameLayout.test.ts` 的源码顺序断言改成「挂点在 `-controls-right` 之后、`{canStopTurn` 之前」；空态「工具条之外无第二个按钮」计数仍为 6；七宽度单行/不相交用例不变（含新位置） - min-width 复核（无头 Chromium 夹具，240/280/296/320/360/438/900 七档）：控件排仍 **252px** 所需、外壳仍 **278px**；自然宽度 290.4（438/900 档）→ 算式不变；七档 `topSpread ≤ 1px`、控件两两相交 **0** 处、`outsideControlsRow` 空、润色钮与发送钮间距固定 **8px**（同一行、同一组） - 截图：240px 改前→改后 + 438px 改后 + 438px toast 已换新（正文引用与附件 1:1：12 = 12，未引用的旧图已删） Refs #600, PR #607	2026-10-06 10:57:19 +08:00
k88936	76166b08cf	Merge pull request 'Feat/陶泥儿会员订阅方案' (#588) from feat/pricing-plan into master ... Reviewed-on: #588	2026-10-06 10:48:44 +08:00
k88936	3ca01351cb	修复(画布顶栏): 明细弹层优先展示钱包读取失败文案 ... - walletDetailsError 改为 mudPointBalanceError || rechargeError，避免充值弹层原始错误串（network down）泄漏到顶栏明细 - 单测补齐 AuthGate 挂载时的那次余额读取，并在 hover 后等待错误文案提交（弹层先渲染 loading 态） - 两个原本失败的用例（ImageCanvasEditorView / createProfileWalletStore）恢复通过	2026-10-06 10:32:00 +08:00
k88936	a38407344d	修复(钱包store): 应用余额快照时空值安全 ... - captureWalletBalanceSnapshot 在 owner 不匹配时返回 null，applyWalletBalanceSnapshot 之前会直接解引用 - applyWalletBalanceSnapshot 入参放宽为 ProfileWalletBalanceSnapshot | null，null 直接返回 false - 单测去掉非空断言，锁住「他人 owner 的快照捕获为 null 且必须被拒绝」	2026-10-06 10:32:00 +08:00
k88936	796cf9843c	Merge remote-tracking branch 'origin/master' into feat/pricing-plan ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-10-06 10:14:15 +08:00
k88936	febbdd59d5	Merge branch 'feat/pricing-plan-fix' into feat/pricing-plan	2026-10-06 10:12:41 +08:00
suzmii	f9f27c2949	test(游戏共创): 主题 e2e 跟进 rootsTruncated 与后台成员名单，修正过期断言 ... - scripts/check-game-distribution-theme-e2e.mjs： · 头部契约引用**全部改成符号检索**（函数名/常量名），不再写会随提交漂移的行号 · 新增「公开详情顶层键集合恰为契约七个（含 rootsTruncated）」与「小主题下 rootsTruncated 是布尔且 为 false」两条；同时把「memberCount === roots.length」明确标注为只在小主题成立的观察，不再当不变式 · 新增第 10 组：后台成员名单（未套公开可见性过滤、draft 也能读）——51 个未公开根作品 + 1 个软删除成员 共 52 行，逐条断言：limit=999 截断到 50 且 totalMembers 仍为 52（limit=1 时 members 只有 1 行、 totalMembers 不变）、默认 20 游标翻页 3 页 52 行不重不漏且末页 nextCursor=null、成员行键集合恰为 {rootGameId,title,sortOrder,createdAt,visible,visibility}、按 sortOrder 升序、未公开成员 visible=false+visibility=unpublished、软删除成员 visible=false+visibility=deleted（落在末页）、 非法游标 400 THEME_INVALID_CURSOR、主题不存在 404、draft 主题也能读到成员、未登录 401 / 普通作者 403 · 上一轮标红的「?cursor=abc → 稳定错误码 THEME_INVALID_CURSOR」断言**本轮转绿**（模块侧已把 GAME_DISTRIBUTION_THEME_INVALID_CURSOR_CODE 前缀拼进游标错误文案，映射分支可达） · 实测：71 项 71 PASS / 0 FAIL / 0 SKIP - scripts/check-game-distribution-collection-e2e.mjs：修正随主题功能上线的**过期断言**—— 匿名作品详情现在比公开目录条目多一个 `themes` 键（详情侧增量，目录侧保持精简）。断言改为 「目录条目是详情子集：共有键取值全一致 + 详情只多 themes 一处」，不再要求两边键数相等。 实测：46 项 46 PASS / 0 FAIL / 0 SKIP	2026-10-06 04:35:06 +08:00
suzmii	562549c982	refactor(后台): 共创主题改用共享契约类型 + 后台成员名单接口 ... 1) 类型去重：`api/adminGameThemeTypes.ts` 不再本地定义任何载荷，改成对 `packages/shared/src/contracts/gameDistribution` 的**纯透传**（相对路径导入，不走包名——仓库根的 `node_modules/@genarrative/shared` 软链指向主工作树，主题契约只在本分支上，走包名会拿到缺类型的 旧副本，实测 TS2724）。页面与 api 客户端改用契约原名（`GameDistributionAdminTheme` 等）， 只保留一个后台独有的查询值别名 `AdminThemeStatusFilter = GameDistributionThemeStatus | 'all'` （`all` 是接口查询白名单取值，不是主题状态本身，没有进契约）。删除重复定义后只剩一份真相。 2) 成员面板改用 `GET /admin/api/game-distribution/themes/{themeId}/members?limit=&cursor=`： - 草稿 / 归档主题也能读到成员名单（旧做法借公开投影，对未发布主题 404，看不到名单）——公开投影 那条路（`getPublicGameDistributionTheme`）整体删掉，不留两套读法。 - 每行展示 rootGameId / 标题（游戏行不存在时为「（游戏行不存在）」）/ 排序 / 挂载时间 + 可见性徽标：`visible` 与 `visibility` 按服务端事实**分别展示、互不推导**—— 「公开可见」；「已公开，但无公开版本」（`visible=false` + `visibility=published`，刻意要让人 看出来的异常）；「作品未公开」；「作品已下架」；「作品已删除」；「游戏行不存在」。 - 分页：每页 20（上限 50，由 api 客户端按服务端口径夹住），`nextCursor` 驱动「加载更多成员」； 页脚显示「成员行总数 N；已加载 M 条」（`totalMembers` 不受分页影响，不与 `members.length` 互相推导）。 - 增删成员后**重读第一页**而不是本地删行（游标基于排序，本地删会让后续翻页错位）； 读取失败如实报错（如非法游标 400），不渲染成「还没有成员」。 测试（10 条，含新增/改写 4 条）：草稿主题也能读到名单并逐条移除（移除后重读第一页）、 「已公开但无公开版本」与其它不可见原因分别展示、游标加载更多（末页按钮消失）、 读取失败如实报错不显示空名单。	2026-10-06 04:34:29 +08:00
suzmii	d6d3913320	跟上主题详情契约变更：memberCount 为真实可见数 + rootsTruncated 截断信号 ... - 客户端：GameDistributionThemeDetail 增加必填 rootsTruncated；getTheme 的响应类型与返回值透传该键（缺键按 false，空成员时服务端也是 false 而不是缺键） - 主题页：新增「共 N 棵作品树」，总数一律用 memberCount（真实可见成员数，不受 50 上限截断），不再用 roots.length；rootsTruncated 为 true 时给出明确提示「这里只显示前 A 个，共 B 个」，与族谱页的 truncated 同一约定 - 顺带确认：全仓没有别处按 memberCount === roots.length 做不变式（此前只有主题列表页展示 memberCount，主题页未展示计数） - 测试：新增一条——rootsTruncated=true 且 memberCount=120 / roots 只有 1 个时，截断提示出现且总数展示 120，不得出现用 roots.length 算出的「共 1 棵作品树」	2026-10-06 04:30:41 +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	e401963d3a	fix(游戏共创): 非法游标回归稳定码 THEME_INVALID_CURSOR（契约码此前在 HTTP 面不可达） ... 端到端实测（54 项里唯一红的那条）：`GET /api/game-distribution/themes?cursor=abc` 回 400，但 `error.code = "BAD_REQUEST"`——技术方案 §3.4 与主题 e2e 脚本承诺的稳定码 `THEME_INVALID_CURSOR` 在 HTTP 面上拿不到，客户端只能去匹配中文文案。 根因：`map_spacetime_error` 的 `THEME_` 分支前置条件是「消息含 `THEME_`」，而模块侧游标解析只回 中文串「主题列表游标格式无效」⇒ 落兜底分支成 400 + 通用 `BAD_REQUEST`；契约常量与那条映射分支 因此是死代码。且 api-server 原有单测**明确要求**文案不含 `THEME_`（口径留了两套）。 口径二选一，选**让码可达**（模块产出前缀），删掉「要求不含 `THEME_`」的断言： - `module-game-distribution/src/errors.rs`：新增 6 个主题码常量 `GAME_DISTRIBUTION_THEME_{NOT_FOUND,BAD_REQUEST,INVALID_CURSOR,IDEMPOTENCY_CONFLICT,MEMBER_NOT_ROOT,MEMBER_GAME_NOT_FOUND}_CODE`， 并把 `Display` 从字面量改为**复用同一批常量**（消灭「常量改了、`Display` 没改」这类只有真栈才发现的漂移）。 - `theme.rs`：`parse_game_distribution_theme_cursor` 产出 `THEME_INVALID_CURSOR: 主题列表游标格式无效`； 文档注释更新为「只保留 `FORK_` 这个排在 `THEME_` 分支之前的子串禁忌」（其余子串已抢不到）。 - `lib.rs`：导出新增的 6 个码常量。 - 测试： · `domain.rs::theme_errors_are_prefixed_with_their_machine_code` 改为**枚举全部 6 个主题码**（含唯一 不走领域变体的游标路径——正是当初漏掉它的原因），并加「任何新增码都必须进这张表」的覆盖完整性断言； · `theme.rs::invalid_cursor_message_stays_in_the_bad_request_bucket` 增加「必须以稳定码开头」； · api-server 新增 `theme_error_codes_are_reachable_from_module_messages`：用**模块真实产出的消息** 逐码断言 `(状态码, 稳定码)` 可达，并比对模块常量与 `shared-contracts` 常量是同一组字符串； · api-server `theme_list_invalid_cursor_maps_to_bad_request` 改为断言映射出 `THEME_INVALID_CURSOR`， 只把 `FORK_` 留在禁忌列表里（并写明理由）。 门禁：`cargo test -p module-game-distribution` **100 passed**；`cargo test -p api-server game_distribution` **86 passed**；`cargo check --all-targets` 0；DTO parity 58 组 / 10 构建器；`check:encoding` 0； `cargo fmt --all -- --check` 0；`git diff --check` 0。	2026-10-06 03:50:05 +08:00
suzmii	909f3d5fa2	网页端共创主题：共创 Tab + 主题页（逐根内嵌作品树）+ 详情页主题入口 + 网关清单 ... - 客户端：新增 listThemes（游标分页，读 nextCursor）与 getTheme（404 由页面渲染成降级态）；getGame 的返回类型增量 themes（匿名也返回；无主题时是空数组而不是缺键） - 共创 Tab：广场页新增「游戏 / 共创」页签，复用既有 game-category-tabs 结构与类名，切到 /games/themes - 主题列表页 GameThemesPage：卡片展示 name / summary / badge / memberCount；只有 nextCursor 非空才渲染「加载更多」并在点击时追加；空态与失败重试照既有写法 - 主题页 GameThemePage：标题 / 简介 / 角标 + 成员根清单；**逐根内嵌渲染作品树**——直接复用族谱页（GameLineagePage 新增 embedded 变体，只隐藏页面外壳：返回按钮 / 页头 / 脚注），树查询、可见性过滤、稳定排序与截断全部走 M3 那一份实现，不新建第二套树查询或树渲染（每根一次 /lineage 的 N+1 是技术方案 §3.10.4 已接受的取舍）；已发布但可见成员为空 → 明确空态而不是错误；主题不存在 / 未发布 → 错误态 - 详情页：共创信息卡渲染所属主题角标（点击进主题页），第 N 代作品同样可见（服务端按根反查）；无主题时不渲染空容器 - 路由登记：新增 /games/themes 与 /games/theme（详情用 ?id=），四处同批登记（STAGE_ROUTE_ENTRIES + SelectionStage 类型 + 壳层 lazy/回调/渲染分支 + 页面标题），并同步三份 nginx SPA allowlist 与 Pingora MAIN_SPA_PATHS：check:nginx-spa-routes（20 SPA routes / 3 模板）与 check:pingora-route-parity 均绿 - 测试：主题列表三例（渲染与卡片跳转 / 有游标时的加载更多与追加 / 空态与失败重试）、主题页三例（逐根两棵树且复用 lineage 查询 + 全屏入口参数 / 空成员空态 / 404 错误态）、详情页主题入口两例（渲染并可跳转 / 无主题不渲染容器）、路由与标题登记断言、壳层三例（页签切换 / 列表进主题页 / 主题页按 ?id= 渲染并复用族谱查询）	2026-10-06 03:45:38 +08:00
suzmii	58da0e67db	test(游戏共创): 新增共创主题端到端验收脚本 ... - 新增 scripts/check-game-distribution-theme-e2e.mjs（约 1160 行）：真库验收公开读 + 后台写 + 作品详情 themes 增量，复用 lineage 脚本的完整发布链路 helper（脚本头注释逐条标注出处）， 覆盖 9 组共 54 条断言： · 建主题→加根成员→公开读：公开列表只含 published（且不含 status 字段）、详情 roots 逐条与公开 目录同一投影（键集合 23=23）、memberCount 与 roots 长度一致 · 只允许根：第 1 代子作品当成员 → 409 THEME_MEMBER_NOT_ROOT；不存在的 gameId → 404 THEME_MEMBER_GAME_NOT_FOUND · 跨主题多归属：同一个根加入两个主题，两条主题都能读到它，作品详情 themes 长度=2 · 作品详情 themes 口径：匿名与登录都发；**专门构造第 1 代衍生作品**（带 fork 声明 + 完整发布链路） 并断言它也返回根所属的两个主题（先取根再反查）；无归属作品返回空数组 · 可见性：draft 主题公开 404（后台按 draft 过滤仍可见）、archived 公开 404 且作品详情 themes 同步消失、 改回 published 恢复；已发布但成员全不可见 → 200 + 空 roots + memberCount=0； 成员下架 → 从 roots 消失，重新公开（新版本审核通过）→ 同一行自动回到 roots 且仍只一行 · 分页：默认 20、limit=999 截断到 50、limit=20 游标翻页 3 页 54 条不重不漏、末页 nextCursor=null、 ?cursor=abc → **400**（状态码符合契约） · 后台权限：五条路由未登录 401；普通作者 token 403；成员 PUT/DELETE 免幂等键、重复 PUT 只留一行 且 createdAt 不变、DELETE 幂等（data 载荷逐字段相同，信封 meta.requestId 每请求不同属既有协议） · 后台幂等：同键重放 replayed=true 且不产生第二个主题、同键换请求 409 THEME_IDEMPOTENCY_CONFLICT、 缺 Idempotency-Key → 400 · 三条公开路由匿名 200 且带 Cache-Control: no-store - **实测 53 PASS / 1 FAIL**：唯一失败是已确认的产品缺口（仅报告、未改后端）——非法游标的状态码是 400 ✓，但稳定码 THEME_INVALID_CURSOR 不可达：api-server/...:5343-5346 为该码注册了 400 映射， 而模块侧只回纯文案「主题列表游标格式无效」（module-game-distribution/src/theme.rs:205-215）， 不含分支前置所需的 `THEME_` 前缀，客户端实际拿到 code=BAD_REQUEST。脚本刻意保留这条红断言 （契约真值），并附 NOTE 说明成因与证据。 - package.json：新增 npm script check:game-distribution-theme-e2e	2026-10-06 03:44:31 +08:00
suzmii	09a1cf5497	docs(游戏共创): 共创主题文档回填（§3.4 接口表 / §3.10 实现状态 / 里程碑 Status 与验收） ... 服务端三块（`2fa201e0d` 模型与纯函数、`742723a58` 公开读、`033e3aa79` 后台写）已落地，本次把文档从「只落设计」补齐到「服务端已实现」，并写死一条已知限制。 - **技术方案 `§3.4`**：新增 5 条接口行（真实路由/鉴权/错误码/字段名均以 `git show` 核对代码为准，非猜测）——公开 `GET /api/game-distribution/themes`（匿名 + `no-store`；只含 `published`；limit 缺省 20 / 上限 50 / 超界截断；游标 `"{createdAtMicros}:{themeId}"`；非法游标 400；末页 `nextCursor: null`；`memberCount` = 公开可见成员数）、`GET /api/game-distribution/themes/{themeId}`（顶层扁平 `{themeId,name,summary,badge,memberCount,roots}`；`roots` 复用公开目录同一份投影；不存在/draft/archived → 404 不返回空壳；已发布空成员 → 200 + 空 `roots`），以及 `GET /games/{gameId}` 的 `themes` 增量（匿名与登录都发、空数组恒发；先取根再按根反查 ⇒ 第 N 代作品也能跳主题页）；后台 5 条（`require_admin_auth` + `AuthenticatedAdmin`，未登录/失效 401 `UNAUTHORIZED`、非 admin 403；创建与编辑要求 `Idempotency-Key`，同键重放 `replayed: true`、同键换请求 409 `THEME_IDEMPOTENCY_CONFLICT`；成员增删**不要求**幂等键（确定性主键天然幂等，删不存在也 200）；非根成员 409 `THEME_MEMBER_NOT_ROOT`；后台列表含 draft/archived、limit 缺省与上限 200、无游标；`theme_id` 服务端生成 `theme-{uuid}`）。 - **`§3.10`**：各小节「本轮实现 / 留白」标注更新为现状（服务端已实现；公开前端与后台 UI 仍留白）；`§3.10.6`/`§3.10.9` 明确写下**已知限制**——主题详情 `roots` 沿用页上限 **50** 且 `memberCount == roots.len()`，可见成员 > 50 时会**静默截断且没有「还有更多」标志**，三个备选（去上限 / 给成员加游标 / `memberCount` 报真实可见数）待拍板，本轮不改契约。 - **`§7`**：第 3 条（共创主题）改为「设计已采纳 + 服务端已实现」，仍待拍板收敛为两条：① 主题级排序口径（公开列表当前按 `created_at` 倒序 + `themeId` 兜底；若要按运营 `sort_order` 展示需改游标格式并同步前端）；② 上述 `roots` 50 上限行为。 - **里程碑文件**：`Status` 由 `proposed` → 「服务端已实现（附四个提交号）；公开前端与后台管理 UI 待做」，Version 1.0 → 1.1，新增「已落地提交」行；实施清单 A–F 标注已落地提交、G 标未做（待前端）、H 分「已落地层 / 未做层」、I 补执行状态；**验收标准勾 17/19**（第 17 条公开前端、第 18 条 SPA 路由门禁留空并注「等前端」）；文末写明「dev 栈端到端整链未跑（`scripts/check-game-distribution-theme-e2e.mjs` 未创建），依赖真实库存的运行时分支目前只到单元/结构/映射层」。 - **数据契约文档**：两张主题表小节的「写入路径属后续里程碑」改为现状（读/写 procedure 与事务名），表结构描述未动。 - **门禁**：`check:doc-index` 0（252 份 Markdown，current=121 / historical=15 / review=1）；`check:encoding` 0（5414 files）；`git diff --check` 0。 - **环境限制（标注，非绿）**：`check:generated-bindings` 本机 `EXIT=1`，原因是 `apps/ai-game-creator-shell/src-tauri/build.rs:167` 校验随包资源时缺 `bin/win-x64/agc_godot_editor.dll`（需先跑随包资源准备步骤）——纯环境前置，与本次只改 `docs/**` 无关；该检查的 AGC 段本地从来跑不了（CI 绿）。	2026-10-06 03:38:11 +08:00