6230 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
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	8ff01d65dd	feat(游戏共创): Fork 工程确认页（授权校验 + 强制阅读 + 真实同步阶段） ... 照需求文档「Fork 工程确认页（客户端）」新增独立确认页，把原来的「列表上直接 Fork」升级成 「先确认授权边界，再同步工程」。 - 父作品信息卡：封面（复用已有的有界 data URL 链路，失败/缺封面回落首字占位）、标题、作者、 当前授权类型（缺省读作「禁止共创」）；数据优先用列表已加载的那份，缺了才按 gameId 走公开详情 接口，**逐项降级不报错**。 - 二次确认 + 授权须知 + 风险说明（**强制阅读 3 秒**）：五类内容逐条全文可见（可滚动，不折叠）， 用已统一的 Fork 口径；商用权限按父作品授权档位分档写（非商用档明确「不得用于盈利」，全开放档 写明可商用）；底部确认按钮在前 3 秒禁用并显示倒计时与进度条。 - 工程同步状态条：**只显示原生真实阶段**（`game-fork-progress`：取回作品内容 → 校验摘要与字节 → 解压到项目 → 生成工程与来源记录），事件到哪一步点亮哪一步，阶段内部不可测量就只做「进行中」 指示，**没有百分比动画**。需求文档的四分类（源码/素材/场景/配置）假设按资产种类分别同步，而这条 链路是整包取回，因此如实降级并在页面上写明每个阶段在做什么。 - 底部「取消 / 确认并进入编辑」：确认 → 走既有取件建项链路 → 成功后由上层进入工作台；取消 → 回到 进入前的界面（列表）。 - 落点与入口：共创列表的卡片与「粘贴作品 ID/链接」都改为进确认页（粘贴仍用同一份解析）；深链 `genarrative://fork?gameId=…` 直接打开确认页并预填父作品（带错误原因的深链仍留在列表展示）。 测试：新增 `forkConfirm.test.tsx`（10 条：信息卡四字段 + 缺字段降级、3 秒闸门与倒计时与可点、 五类须知全文与关键口径、全开放档商用文案、真实阶段点亮与未知阶段丢弃、确认后的命令参数与进工作台、 失败展示与不进工作台、取消回上层、无目标时的可读提示）；列表测试改为断言「只打开确认页、不直接建项」； appSurface 增一条「深链落确认页并预填」。	2026-10-06 17:20:04 +08:00
suzmii	dab99e82a8	feat(游戏共创): Fork 真实阶段事件 + 公开作品详情读取 ... 为「Fork 工程确认页」提供两件原生能力。 1. 真实阶段事件（不造百分比）：ForkSyncStage 四类真实阶段 download/verify/extract/project （带稳定事件键与可读名），并在注释里写明与需求文档「源码/素材/场景/配置」四分类的关系—— 文档假设按资产种类分别同步，而客户端这条链路是整包取回（一次下载、一次校验、一次解压、 一次建项），没有按种类分开的可测量阶段，因此如实降级成四个真实阶段； create_project_from_platform_fork_at 加 on_stage 回调（4 处测试调用点补 no-op 闭包）， 在解压前/生成工程前按真实发生顺序报阶段；命令在取件前/校验前发 download/verify，新增事件 game-fork-progress（{ stage, label }）。 2. read_public_game_detail(gameId)：复用平台既有公开详情接口（匿名、不带 Bearer），给确认页的 父作品信息卡拿标题/作者/授权类型/封面对象键；顺手把匿名 GET 抽成 get_public_platform_json， 目录命令改走同一段（不再各写一遍请求与错误映射）。 3. 适配共享契约新增字段：创建版本请求补 change_summary: None（AGC 暂无收集入口，服务端把 None 当「未填写」并省略该键，与旧客户端行为一致）。 测试：阶段键与 serde 序列化一致 + 阶段名可读（新增）；既有 Fork 用例与深链解析用例全绿。	2026-10-06 17:19:22 +08:00
suzmii	3e3e009b11	共创模块C: 我的作品分类标签(全部/原创/我发布的共创/草稿) + 世代与子衍生数 + 数据概览	2026-10-06 17:16:58 +08:00
suzmii	b99dcb7ef2	共创模块B: 族谱页顶部筛选器 + 主干线(每代热度最高) + 右侧信息面板	2026-10-06 17:16:46 +08:00
suzmii	475acf0f41	共创模块A: 详情页世代/授权标签 + 一键 Fork 主操作 + 概览 + 溯源条 + 热门衍生	2026-10-06 17:06:50 +08:00
suzmii	172bc22404	fix(游戏共创): 合并后修正 game_distribution_game 列顺序（master 的 price_mud_points 回到第 26 位） ... CI（Backend tests 与 Repository checks）在 `check:spacetime-schema` 红： 「SpacetimeDB 表 game_distribution_game 的第 26 个字段从 price_mud_points 变为 fork_authorization，疑似字段顺序被调整」。 根因：本次合并把两侧各自「在表尾追加」的列并成了「我们的列在 master 的列之前」——schema guard 对表的字段 相对顺序是按 index 逐位比对的（只允许在结构体末尾追加）。 - `game_distribution_game` 表：`price_mud_points`（master 先追加，第 26 位）回到原位，本分支的 `fork_authorization` 追加在它**之后**（表尾）； - `GameDistributionGameSnapshot` 按同一纪律排（同一 game 行的 RPC 形状，避免表与快照两套顺序）； - 重新生成绑定：`module_bindings/game_distribution_game_type.rs`、`..._game_snapshot_type.rs` （列顺序属 wire format，客户端绑定必须与模块同步）； - 两处结构体注释写明该纪律（master 的列保持 index、我们的列追加在后），避免下一次合并再踩； - 文档：`docs/project-memory/shared-memory/pitfalls.md` 增一条「合并 master 后 schema guard 的基线盲区」—— 本地守卫默认基线是 `git merge-base HEAD origin/master`，**merge 提交尚未建立时看不见**这类重排， 因此合并后必须用 `SPACETIME_SCHEMA_BASE_REF=<PR base>` 复跑。 门禁：`SPACETIME_SCHEMA_BASE_REF=9f4c7d76 npm run check:spacetime-schema` 0（98 表）；wasm build 0； `cargo check --all-targets` 0；`cargo test -p module-game-distribution` 113 passed；`cargo test -p api-server game_distribution` 101 passed；`cargo test -p module-runtime` 0；`cargo test -p spacetime-client` 43 passed； `cargo test -p spacetime-module` 294 passed / 1 ignored；DTO parity 0（62 组 / 17 构建器 / 15 手拼类型）； `check:project-bundle-policy-parity` OK；`check:production-ops` OK；`check:doc-index` OK（261 份）；`check:encoding` 0（5525 files）；`cargo fmt --all --manifest-path server-rs/Cargo.toml -- --check` 0；`git diff --check` 0。	2026-10-06 16:47:38 +08:00
suzmii	a32ddd0e49	fix(游戏共创): 补齐发布用例的必填 versionNumber，并把授权三态计数收敛到本组	2026-10-06 16:34:58 +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	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