同步文档：界面图参考语义建议退役

- UI 编辑器代码地图更新 resource/commands 职责、关键命令列表、两步工作流与类型文件数量

- UI 工作流资源桥接文档改为普通桥接从 structure-recognition 开始

- UI 编辑器工作流完成通知弹窗文档收敛为两个动作并删除分析参考图文案

- UI 编辑会话模块边界删除 suggestion seam 描述

- App 实施计划追加 2026-09-23 退役条目覆盖旧 slave_to 口径

- decision-log 记录退役决策、合并优先级恒 0 与无迁移后果及验证结果

.dockerignore

@@ -30,3 +30,8 @@ server-rs/.data
 server-rs/.spacetimedb
 
 public/generated-*
+
+scripts/loadtest/data/*.local.json
+scripts/loadtest/data/k6-*.log
+scripts/loadtest/data/k6-*summary*.md
+scripts/loadtest/data/latest-*-prefix.txt

.env.example

@@ -239,12 +239,6 @@ GENARRATIVE_ENABLE_IMAGE_EDITOR_AGENT_SIDEBAR="false"
 # Windows/macOS 是系统维度，不填写 dev-win/dev-mac。
 GENARRATIVE_CLIENT_DOWNLOAD_CHANNEL="dev"
 
-# 客户端埋点接收绑定的公开 origin，由 API Server 运行时读取；修改后重启服务。
-# 必须与客户端登录地址一致，不带 /api、路径或尾部斜杠；未配置/非法时上传接口返回 503。
-# 本地端口按实际启动结果填写（端口漂移后需同步），localhost 与 127.0.0.1 不可混用。
-# dev 使用 https://dev.genarrative.world；release 使用 https://www.genarrative.world。
-GENARRATIVE_AGC_ANALYTICS_ORIGIN="http://127.0.0.1:8082"
-
 # Optional: official VikingDB credentials for regenerating build-tag similarities
 # with the Python embedding script. The script auto-loads `.env.local` and uses
 # the fixed `bge-large-zh` embedding model.

.eslintrc.cjs

@@ -213,8 +213,6 @@ module.exports = {
     '!src/services/clipboard.test.ts',
     '!src/services/frontendRuntimeConfigService.ts',
     '!src/services/frontendRuntimeConfigService.test.ts',
-    '!src/services/gameDistributionClient.ts',
-    '!src/services/gameDistributionClient.test.ts',
     '!src/services/sseStream.ts',
     '!src/services/sseStream.test.ts',
     'src/AdventurePanel.tsx',
@@ -365,6 +363,7 @@ module.exports = {
     'src/types.ts',
     'src/types/**',
     'src/uiAssets.ts',
+    'scripts/loadtest/**',
     'packages/shared/src/contracts/jumpHop.ts',
     'packages/shared/src/contracts/match3dAgent.ts',
     'packages/shared/src/contracts/match3dRuntime.ts',

.gitea/workflows/project-ci.yml

@@ -82,29 +82,12 @@ jobs:
             sleep $((attempt * 2))
           done
 
-      - name: Prepare isolated Rust compilation cache
-        shell: bash
-        run: |
-          set -euo pipefail
-          node --test scripts/ci-rust-cache.test.mjs
-          bash scripts/ci-rust-cache.sh prepare
-
       - name: Run AI game creator shell Rust shard 1/4
         run: npm run check:native-shells:agc-rust-shard-1
 
       - name: Run AI game creator shell Rust shard 2/4
         run: npm run check:native-shells:agc-rust-shard-2
 
-      - name: Report isolated Rust compilation cache
-        if: always()
-        run: bash scripts/ci-rust-cache.sh report
-      - name: Publish master Rust cache artifact
-        continue-on-error: true
-        if: ${{ !cancelled() && github.event_name == 'push' && github.ref == 'refs/heads/master' }}
-        env:
-          GENARRATIVE_GITEA_TOKEN: ${{ github.token }}
-        run: python3 scripts/export-gitea-rust-cache.py
-
   ai-game-creator-shell-rust-lane-2:
     name: AI game creator shell Rust lane 2/2
     runs-on: genarrative-ci
@@ -135,25 +118,12 @@ jobs:
             sleep $((attempt * 2))
           done
 
-      - name: Prepare isolated Rust compilation cache
-        run: bash scripts/ci-rust-cache.sh prepare
-
       - name: Run AI game creator shell Rust shard 3/4
         run: npm run check:native-shells:agc-rust-shard-3
 
       - name: Run AI game creator shell Rust shard 4/4
         run: npm run check:native-shells:agc-rust-shard-4
 
-      - name: Report isolated Rust compilation cache
-        if: always()
-        run: bash scripts/ci-rust-cache.sh report
-      - name: Publish master Rust cache artifact
-        continue-on-error: true
-        if: ${{ !cancelled() && github.event_name == 'push' && github.ref == 'refs/heads/master' }}
-        env:
-          GENARRATIVE_GITEA_TOKEN: ${{ github.token }}
-        run: python3 scripts/export-gitea-rust-cache.py
-
   # agent-run smoke 会 spawn `cargo run`（走壳自己的 manifest），同样不装 npm 依赖，
   # 单独一个 job，免得把已经压到 4 分钟级的片 job 拖长。
   ai-game-creator-shell-rust-smoke:
@@ -186,22 +156,9 @@ jobs:
             sleep $((attempt * 2))
           done
 
-      - name: Prepare isolated Rust compilation cache
-        run: bash scripts/ci-rust-cache.sh prepare
-
       - name: Run AI game creator shell agent-run smoke
         run: npm run check:native-shells:agc-rust-smoke
 
-      - name: Report isolated Rust compilation cache
-        if: always()
-        run: bash scripts/ci-rust-cache.sh report
-      - name: Publish master Rust cache artifact
-        continue-on-error: true
-        if: ${{ !cancelled() && github.event_name == 'push' && github.ref == 'refs/heads/master' }}
-        env:
-          GENARRATIVE_GITEA_TOKEN: ${{ github.token }}
-        run: python3 scripts/export-gitea-rust-cache.py
-
   # AGC 壳依赖的共享 / 平台和编辑器插件 crate 各自预热独立 manifest，再运行对应测试。
   ai-game-creator-shell-rust-crates:
     name: AI game creator shell Rust crates
@@ -300,22 +257,9 @@ jobs:
             sleep $((attempt * 2))
           done
 
-      - name: Prepare isolated Rust compilation cache
-        run: bash scripts/ci-rust-cache.sh prepare
-
       - name: Run AI game creator shell shared crate gates
         run: npm run check:native-shells:agc-rust-crates
 
-      - name: Report isolated Rust compilation cache
-        if: always()
-        run: bash scripts/ci-rust-cache.sh report
-      - name: Publish master Rust cache artifact
-        continue-on-error: true
-        if: ${{ !cancelled() && github.event_name == 'push' && github.ref == 'refs/heads/master' }}
-        env:
-          GENARRATIVE_GITEA_TOKEN: ${{ github.token }}
-        run: python3 scripts/export-gitea-rust-cache.py
-
   backend-tests:
     name: Backend tests
     runs-on: genarrative-ci
@@ -386,9 +330,6 @@ jobs:
       - name: Check server-rs boundaries
         run: npm run check:server-rs-ddd
 
-      - name: Prepare isolated Rust compilation cache
-        run: bash scripts/ci-rust-cache.sh prepare
-
       - name: Run server-rs workspace tests
         run: cargo test --locked --workspace --exclude spacetime-module --no-fail-fast --manifest-path server-rs/Cargo.toml
 
@@ -401,16 +342,6 @@ jobs:
       - name: Check SpacetimeDB module
         run: cargo check --locked -p spacetime-module --manifest-path server-rs/Cargo.toml
 
-      - name: Report isolated Rust compilation cache
-        if: always()
-        run: bash scripts/ci-rust-cache.sh report
-      - name: Publish master Rust cache artifact
-        continue-on-error: true
-        if: ${{ !cancelled() && github.event_name == 'push' && github.ref == 'refs/heads/master' }}
-        env:
-          GENARRATIVE_GITEA_TOKEN: ${{ github.token }}
-        run: python3 scripts/export-gitea-rust-cache.py
-
   # 客户端的壳级与契约门禁：静态契约断言、H5 / 微信 / 移动 / 桌面壳运行时门禁，
   # 以及依赖发布产物的构建 smoke。
   native-shell-tests:
@@ -453,32 +384,15 @@ jobs:
       - name: Run native shell contract gates
         run: npm run check:native-shells:contract
 
-      - name: Prepare isolated Rust compilation cache
-        run: bash scripts/ci-rust-cache.sh prepare
-
       - name: Run native shell gates
         run: npm run check:native-shells:shells
 
       - name: Run native shell release build smoke
-        # 发布构建有独立 profile/features 和资源 staging，不消费测试对象快照。
-        env:
-          RUSTC_WRAPPER: ''
-          CARGO_BUILD_RUSTC_WRAPPER: ''
         run: npm run check:native-shells:release
 
       - name: Ensure native lockfiles are unchanged
         run: git diff --exit-code -- apps/desktop-shell/src-tauri/Cargo.lock apps/ai-game-creator-shell/src-tauri/Cargo.lock
 
-      - name: Report isolated Rust compilation cache
-        if: always()
-        run: bash scripts/ci-rust-cache.sh report
-      - name: Publish master Rust cache artifact
-        continue-on-error: true
-        if: ${{ !cancelled() && github.event_name == 'push' && github.ref == 'refs/heads/master' }}
-        env:
-          GENARRATIVE_GITEA_TOKEN: ${{ github.token }}
-        run: python3 scripts/export-gitea-rust-cache.py
-
   frontend-tests:
     name: Frontend tests
     runs-on: genarrative-ci
@@ -496,7 +410,7 @@ jobs:
         run: bash scripts/ci-npm-ci-with-retry.sh
 
       - name: Run frontend and script tests
-        run: npm run test:ci:frontend
+        run: npm run test
 
       - name: Run BgFilter worker smoke harness tests
         run: npm run bgfilter-worker:smoke-test
@@ -560,11 +474,6 @@ jobs:
       - name: Install npm dependencies
         run: bash scripts/ci-npm-ci-with-retry.sh
 
-      - name: Validate CI cache maintenance behavior
-        run: |
-          python3 -m unittest discover -s scripts -p 'test_gitea_cache_*.py'
-          node --test scripts/export-ci-npm-download-cache.test.mjs
-
       - name: Run repository checks
         run: npm run check:repository-ci
 

.gitignore

@@ -88,3 +88,11 @@ nohup.out
 spacetime.local.json
 deploy/container/api-server.env
 deploy/container/worker-smoke/
+
+# Local load-test data extracted from private migration files
+scripts/loadtest/data/*.local.json
+
+# Local load-test run artifacts
+scripts/loadtest/data/k6-*.log
+scripts/loadtest/data/k6-*summary*.md
+scripts/loadtest/data/latest-*-prefix.txt

CONTEXT.md

@@ -194,34 +194,6 @@ _Avoid_: 进度通知、快照轮询、第二套历史
 把项目对话历史条目与运行态事件转换成消息气泡和工具卡片的读取期转换；不持久化，也不构成事实源。
 _Avoid_: 投影缓存文件、已脱敏卡片库、第二套 reducer
 
-**引用候选**:
-输入区可以命中的对象集合（`@` 素材、`$` Skill），由宿主按种类注入；输入区不判断候选属于哪一类。
-_Avoid_: 输入区自己读项目清单或应用目录、把候选取值写死在组件里
-
-**引用 provider**:
-一种引用种类向输入区提供的全部能力：触发符、候选、身份解析与正文文本形态；每种引用各一份，宿主按需选择性注入。
-_Avoid_: 一个总装对象决定所有种类、输入区按种类分叉、provider 之间互相知道对方
-
-**静默 provider**:
-不提供候选、只负责已有引用身份与文本形态的 provider；附件与运行画面区域属于这一类，只能由外部插入或草稿回填进入正文。
-_Avoid_: 给附件或运行画面区域造候选、为它们保留输入区内的专门分支
-
-**引用文本语法**:
-引用在正文文本里的形态（`@显示名` / `$名称` / `@附件名`）及其反解析；出站与解析必须同一口径，token 前后各留一个空白。
-_Avoid_: 出站与解析各写一套、在空白边界之外再补兼容别名、让解析依赖具体种类的字段
-
-**引用输入区**:
-只负责编辑与渲染引用的共享输入组件；候选、身份解析与文本语法都来自注入的 provider，它不持有项目清单、不访问后端。
-_Avoid_: 输入区自己拉 Skill 目录、把选择器面板塞在输入区内部
-
-**引用选择器**:
-宿主渲染的独立面板，自己拿数据与筛选状态，确认后把选中的引用交给输入区的插入缝。
-_Avoid_: 输入区自带面板、每个宿主各画一个、绕开插入缝另开第二条通道
-
-**附件芯片**:
-聊天附件在正文里的唯一表示；附件导入成功即以芯片进入正文，正文之外不存在第二份附件状态。
-_Avoid_: 待发送附件列表与正文芯片并存、提交时再拼一遍附件
-
 ## Relationships
 
 - 一个 **汪汪声浪大作战** 单局包含多个 **有效声浪触发**。
@@ -237,10 +209,6 @@ _Avoid_: 待发送附件列表与正文芯片并存、提交时再拼一遍附
 - **个人历史成绩** 由最近记录列表和个人最佳摘要组成，只允许本人查看；排行榜只公开入榜胜利成绩。
 - **正式作品入口闭环** 必须覆盖创作入口、作品详情 CTA、广场/作品卡片、我的作品/个人作品架、稳定作品 ID runtime 路由和 `work_play_start` 埋点。
 - **Phase 2 实施顺序** 固定为：契约与领域规则 → SpacetimeDB 表/reducer 与 api-server BFF → 最小前端纵切 → 投影与列表体验 → 收口验证。
-- **引用输入区** 由宿主注入的若干 **引用 provider** 组成；**引用候选** 与 **引用文本语法** 都来自 provider，输入区不判断引用种类。
-- **引用选择器** 不属于 **引用输入区**：它自己拿数据，确认后只通过输入区的插入缝交付引用。
-- 只有带触发符的 **引用 provider** 会产生候选；**静默 provider** 没有触发符，只能由外部插入或草稿回填进入正文。
-- **附件芯片** 是本轮附件的唯一事实源；附件导入失败时不产生芯片。
 
 ## Example dialogue
 

apps/admin-web/src/api/adminApiClient.test.ts

@@ -7,13 +7,9 @@ import {
   getAdminFeatureGateConfig,
   getAdminUserDetail,
   importAdminAgcTemplates,
-  listAdminAgcTrackingEvents,
-  listAdminGameDistributionReviews,
   listAdminRechargeOrders,
   reconcileAdminUserConsumption,
   resolveAdminRechargeRefundManualReview,
-  reviewAdminGameDistributionVersion,
-  suspendAdminGameDistributionGame,
   updateAdminAccount,
   updateAdminAgcTemplate,
   uploadAdminEditorShowcaseCampaignImage,
@@ -25,30 +21,6 @@ afterEach(() => {
   vi.unstubAllGlobals();
 });
 
-test('客户端埋点查询传递筛选和游标并复用后台认证', async () => {
-  const payload = { entries: [], nextCursor: null };
-  const fetchMock = vi.fn().mockResolvedValue(
-    new Response(JSON.stringify({ ok: true, data: payload }), {
-      status: 200,
-    }),
-  );
-  vi.stubGlobal('fetch', fetchMock);
-  expect(
-    await listAdminAgcTrackingEvents('token', {
-      userId: 'user+1',
-      projectId: 'project-1',
-      cursor: 'page/2',
-      limit: 50,
-    }),
-  ).toEqual(payload);
-  expect(fetchMock).toHaveBeenCalledWith(
-    '/admin/api/agc/tracking-events?userId=user%2B1&projectId=project-1&cursor=page%2F2&limit=50',
-    expect.objectContaining({
-      headers: expect.objectContaining({ Authorization: 'Bearer token' }),
-    }),
-  );
-});
-
 test('模板管理读取和更新复用认证封装，提交 revision 和封面但不提交 ZIP 或版本', async () => {
   const library = { revision: 'revision-new', writable: true, templates: [] };
   const fetchMock = vi.fn().mockImplementation(
@@ -482,134 +454,3 @@ test('退款人工复核使用独立 resolve 管理员路由', async () => {
     }),
   );
 });
-
-test('游戏审核列表与审核动作使用约定的 URL、方法和幂等键', async () => {
-  const fetchMock = vi.fn().mockImplementation(() =>
-    Promise.resolve(
-      new Response(JSON.stringify({ entries: [], nextCursor: null }), {
-        status: 200,
-      }),
-    ),
-  );
-  vi.stubGlobal('fetch', fetchMock);
-
-  await listAdminGameDistributionReviews('admin-token');
-  await reviewAdminGameDistributionVersion(
-    'admin-token',
-    'gamever/1',
-    'game-review-key-1',
-    {
-      decision: 'approve',
-      expectedPublicationRevision: 3,
-      entryUrl: 'https://games.example.test/releases/game_1/index.html',
-    },
-  );
-
-  expect(fetchMock.mock.calls[0]?.[0]).toBe(
-    '/admin/api/game-distribution/reviews?limit=48',
-  );
-  expect(fetchMock.mock.calls[1]?.[0]).toBe(
-    '/admin/api/game-distribution/versions/gamever%2F1/review',
-  );
-  expect(fetchMock.mock.calls[1]?.[1]).toEqual(
-    expect.objectContaining({
-      method: 'POST',
-      headers: expect.objectContaining({
-        Authorization: 'Bearer admin-token',
-        'Idempotency-Key': 'game-review-key-1',
-      }),
-      body: JSON.stringify({
-        decision: 'approve',
-        expectedPublicationRevision: 3,
-        entryUrl: 'https://games.example.test/releases/game_1/index.html',
-      }),
-    }),
-  );
-});
-
-test('安全下架请求携带公开修订号、原因与幂等键', async () => {
-  const fetchMock = vi.fn().mockImplementation(() =>
-    Promise.resolve(
-      new Response(JSON.stringify({ game: {}, replayed: false }), {
-        status: 200,
-      }),
-    ),
-  );
-  vi.stubGlobal('fetch', fetchMock);
-
-  await suspendAdminGameDistributionGame(
-    'admin-token',
-    'game/1',
-    'game-suspend-key-1',
-    { expectedPublicationRevision: 7, reason: '版权投诉' },
-  );
-
-  expect(fetchMock.mock.calls[0]?.[0]).toBe(
-    '/admin/api/game-distribution/games/game%2F1/suspend',
-  );
-  expect(fetchMock.mock.calls[0]?.[1]).toEqual(
-    expect.objectContaining({
-      method: 'POST',
-      headers: expect.objectContaining({
-        Authorization: 'Bearer admin-token',
-        'Idempotency-Key': 'game-suspend-key-1',
-      }),
-      body: JSON.stringify({
-        expectedPublicationRevision: 7,
-        reason: '版权投诉',
-      }),
-    }),
-  );
-
-  expect(() =>
-    suspendAdminGameDistributionGame('admin-token', '  ', 'key', {
-      expectedPublicationRevision: 1,
-    }),
-  ).toThrow('缺少游戏 ID');
-  expect(() =>
-    suspendAdminGameDistributionGame('admin-token', 'game-1', '  ', {
-      expectedPublicationRevision: 1,
-    }),
-  ).toThrow('下架幂等键必须是 1 到 128 个字符');
-  expect(fetchMock).toHaveBeenCalledTimes(1);
-});
-
-test('游戏审核拒绝请求携带理由，空幂等键在本地失败关闭', async () => {
-  const fetchMock = vi.fn().mockImplementation(() =>
-    Promise.resolve(
-      new Response(JSON.stringify({ version: {}, replayed: false }), {
-        status: 200,
-      }),
-    ),
-  );
-  vi.stubGlobal('fetch', fetchMock);
-
-  await reviewAdminGameDistributionVersion(
-    'admin-token',
-    'version-1',
-    'game-review-key-2',
-    {
-      decision: 'reject',
-      expectedPublicationRevision: 0,
-      reviewReason: '运行时报错',
-    },
-  );
-  expect(fetchMock.mock.calls[0]?.[1]).toEqual(
-    expect.objectContaining({
-      body: JSON.stringify({
-        decision: 'reject',
-        expectedPublicationRevision: 0,
-        reviewReason: '运行时报错',
-      }),
-    }),
-  );
-
-  expect(() =>
-    reviewAdminGameDistributionVersion('admin-token', 'version-1', '   ', {
-      decision: 'reject',
-      expectedPublicationRevision: 0,
-      reviewReason: 'x',
-    }),
-  ).toThrow('审核幂等键必须是 1 到 128 个字符');
-  expect(fetchMock).toHaveBeenCalledTimes(1);
-});

apps/admin-web/src/api/adminApiClient.ts

@@ -1,8 +1,6 @@
 import type {
   AdminAccountListResponse,
   AdminAgcTemplateLibraryResponse,
-  AdminAgcTrackingEventListResponse,
-  AdminAgcTrackingEventQuery,
   AdminConfirmEditorShowcaseCampaignImageUploadRequest,
   AdminCreateAccountRequest,
   AdminCreateAccountResponse,
@@ -32,9 +30,6 @@ import type {
   AdminExternalApiKeyListQuery,
   AdminExternalApiKeyListResponse,
   AdminFeatureGateConfigResponse,
-  AdminGameDistributionReviewListResponse,
-  AdminGameDistributionReviewRequest,
-  AdminGameDistributionReviewResponse,
   AdminImportAgcTemplatesResponse,
   AdminLoginResponse,
   AdminMeResponse,
@@ -411,31 +406,6 @@ export function listAdminTrackingEventKeys(token: string) {
   );
 }
 
-export function listAdminAgcTrackingEvents(
-  token: string,
-  query: AdminAgcTrackingEventQuery = {},
-) {
-  return request<AdminAgcTrackingEventListResponse>(
-    `/admin/api/agc/tracking-events${buildQueryString((params) => {
-      for (const key of [
-        'userId',
-        'projectId',
-        'creativeTaskId',
-        'agentRunId',
-        'eventName',
-        'clientVersion',
-        'startTime',
-        'endTime',
-        'cursor',
-      ] as const) {
-        appendQueryParam(params, key, query[key]);
-      }
-      appendNumericQueryParam(params, 'limit', query.limit);
-    })}`,
-    { token },
-  );
-}
-
 export function listAdminErrorReports(
   token: string,
   query: {
@@ -1230,75 +1200,6 @@ export function saveAgcModelCatalog(
   );
 }
 
-export function listAdminGameDistributionReviews(token: string, limit = 48) {
-  const normalizedLimit = Number.isFinite(limit)
-    ? Math.min(Math.max(Math.trunc(limit), 1), 48)
-    : 48;
-  return request<AdminGameDistributionReviewListResponse>(
-    `/admin/api/game-distribution/reviews?limit=${normalizedLimit}`,
-    { token },
-  );
-}
-
-/**
- * 审核游戏发行版本。幂等键由调用方生成并在同一次提交内复用，避免重复点击产生
- * 两条审核结论。
- */
-/**
- * 安全下架整个游戏。管理员下架同样要求 CAS 修订号与幂等键，避免并发审核互相覆盖。
- */
-export function suspendAdminGameDistributionGame(
-  token: string,
-  gameId: string,
-  idempotencyKey: string,
-  payload: import('./adminApiTypes').AdminGameDistributionSuspendRequest,
-) {
-  const normalizedGameId = gameId.trim();
-  const normalizedKey = idempotencyKey.trim();
-  if (!normalizedGameId) {
-    throw new Error('缺少游戏 ID');
-  }
-  if (!normalizedKey || normalizedKey.length > 128) {
-    throw new Error('下架幂等键必须是 1 到 128 个字符');
-  }
-  return request<
-    import('./adminApiTypes').AdminGameDistributionSuspendResponse
-  >(
-    `/admin/api/game-distribution/games/${encodeURIComponent(normalizedGameId)}/suspend`,
-    {
-      method: 'POST',
-      token,
-      headers: { 'Idempotency-Key': normalizedKey },
-      body: payload,
-    },
-  );
-}
-
-export function reviewAdminGameDistributionVersion(
-  token: string,
-  versionId: string,
-  idempotencyKey: string,
-  payload: AdminGameDistributionReviewRequest,
-) {
-  const normalizedVersionId = versionId.trim();
-  const normalizedKey = idempotencyKey.trim();
-  if (!normalizedVersionId) {
-    throw new Error('缺少发行版本 ID');
-  }
-  if (!normalizedKey || normalizedKey.length > 128) {
-    throw new Error('审核幂等键必须是 1 到 128 个字符');
-  }
-  return request<AdminGameDistributionReviewResponse>(
-    `/admin/api/game-distribution/versions/${encodeURIComponent(normalizedVersionId)}/review`,
-    {
-      method: 'POST',
-      token,
-      headers: { 'Idempotency-Key': normalizedKey },
-      body: payload,
-    },
-  );
-}
-
 export function getAdminAgcTemplates(token: string, signal?: AbortSignal) {
   return request<AdminAgcTemplateLibraryResponse>('/admin/api/agc-templates', {
     token,

apps/admin-web/src/api/adminApiTypes.ts

@@ -820,44 +820,6 @@ export interface AdminTrackingEventListResponse {
   entries: AdminTrackingEventEntryPayload[];
 }
 
-export interface AdminAgcTrackingEventQuery {
-  userId?: string;
-  projectId?: string;
-  creativeTaskId?: string;
-  agentRunId?: string;
-  eventName?: string;
-  clientVersion?: string;
-  startTime?: string;
-  endTime?: string;
-  cursor?: string;
-  limit?: number;
-}
-
-export interface AdminAgcTrackingEventEntry {
-  eventId: string;
-  schemaVersion: number;
-  eventName: string;
-  eventTime: string;
-  userId: string;
-  editorSessionId: string;
-  projectId: string | null;
-  creativeTaskId: string | null;
-  agentRunId: string | null;
-  agentTurnId: string | null;
-  status: string | null;
-  errorCode: string | null;
-  source: string;
-  clientVersion: string;
-  properties: Record<string, unknown>;
-  batchId: string;
-  receivedAt: string;
-}
-
-export interface AdminAgcTrackingEventListResponse {
-  entries: AdminAgcTrackingEventEntry[];
-  nextCursor: string | null;
-}
-
 export interface AdminTrackingEventKeyPayload {
   eventKey: string;
   eventTitle: string;
@@ -1081,51 +1043,6 @@ export interface AdminAgcModelCatalog {
   models: AdminAgcModel[];
 }
 
-export interface AdminGameDistributionReviewEntry {
-  versionId: string;
-  gameId: string;
-  versionNumber: number;
-  packageSha256: string;
-  packageBytes: number;
-  status: string;
-  publicationRevision: number;
-  reviewReason: string | null;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface AdminGameDistributionReviewListResponse {
-  entries: AdminGameDistributionReviewEntry[];
-  nextCursor: string | null;
-}
-
-export interface AdminGameDistributionReviewRequest {
-  decision: 'approve' | 'reject';
-  expectedPublicationRevision: number;
-  reviewReason?: string;
-  entryUrl?: string;
-}
-
-export interface AdminGameDistributionReviewResponse {
-  version: AdminGameDistributionReviewEntry;
-  replayed: boolean;
-}
-
-export interface AdminGameDistributionSuspendRequest {
-  expectedPublicationRevision: number;
-  reason?: string;
-}
-
-export interface AdminGameDistributionSuspendResponse {
-  game: {
-    id: string;
-    title: string;
-    status: string;
-    publicationRevision: number;
-  };
-  replayed: boolean;
-}
-
 export interface AdminAgcTemplatePayload {
   id: string;
   title: string;

apps/admin-web/src/app/AdminApp.tsx

@@ -20,7 +20,6 @@ import {
 import { AdminAccountsPage } from '../pages/AdminAccountsPage';
 import { AdminAgcModelsPage } from '../pages/AdminAgcModelsPage';
 import { AdminAgcTemplatesPage } from '../pages/AdminAgcTemplatesPage';
-import { AdminAgcTrackingPage } from '../pages/AdminAgcTrackingPage';
 import { AdminDashboardPage } from '../pages/AdminDashboardPage';
 import { AdminDatabaseTablesPage } from '../pages/AdminDatabaseTablesPage';
 import { AdminDebugHttpPage } from '../pages/AdminDebugHttpPage';
@@ -28,7 +27,6 @@ import { AdminEditorAssetQueryPage } from '../pages/AdminEditorAssetQueryPage';
 import { AdminEditorGenerationPricingPage } from '../pages/AdminEditorGenerationPricingPage';
 import { AdminEditorShowcaseReviewPage } from '../pages/AdminEditorShowcaseReviewPage';
 import { AdminErrorReportsPage } from '../pages/AdminErrorReportsPage';
-import { AdminGameDistributionReviewPage } from '../pages/AdminGameDistributionReviewPage';
 import { AdminGrayReleaseConfigPage } from '../pages/AdminGrayReleaseConfigPage';
 import { AdminInviteCodePage } from '../pages/AdminInviteCodePage';
 import { AdminLoginPage } from '../pages/AdminLoginPage';
@@ -234,12 +232,6 @@ export function AdminApp() {
           onUnauthorized={handleUnauthorized}
         />
       ) : null}
-      {activeRouteId === 'agc-tracking' ? (
-        <AdminAgcTrackingPage
-          token={token}
-          onUnauthorized={handleUnauthorized}
-        />
-      ) : null}
       {activeRouteId === 'error-reports' ? (
         <AdminErrorReportsPage
           token={token}
@@ -315,12 +307,6 @@ export function AdminApp() {
           onUnauthorized={handleUnauthorized}
         />
       ) : null}
-      {activeRouteId === 'game-distribution' ? (
-        <AdminGameDistributionReviewPage
-          token={token}
-          onUnauthorized={handleUnauthorized}
-        />
-      ) : null}
       {activeRouteId === 'editor-assets' ? (
         <AdminEditorAssetQueryPage
           token={token}

apps/admin-web/src/app/AdminShell.tsx

@@ -5,7 +5,6 @@ import {
   Coins,
   Database,
   FolderArchive,
-  Gamepad2,
   GitBranch,
   Images,
   LayoutDashboard,
@@ -40,7 +39,6 @@ const routeIcons = {
   tables: Database,
   debug: Bug,
   tracking: Table2,
-  'agc-tracking': Table2,
   'error-reports': Bug,
   'gray-release': GitBranch,
   redeem: TicketPercent,
@@ -51,7 +49,6 @@ const routeIcons = {
   'recharge-orders': ReceiptText,
   'editor-generation-pricing': Coins,
   'editor-showcase': Star,
-  'game-distribution': Gamepad2,
   'editor-assets': Images,
   'project-snapshots': FolderArchive,
   accounts: Users,

apps/admin-web/src/app/adminRoutes.test.ts

@@ -8,22 +8,6 @@ import {
   routeHash,
 } from './adminRoutes';
 
-test('客户端埋点路由遵守成员页签权限', () => {
-  expect(resolveAdminRoute('#agc-tracking')).toBe('agc-tracking');
-  expect(
-    getAccessibleAdminRoutes({
-      accountRole: 'member',
-      tabPermissions: ['agc-tracking'],
-    }).map((route) => route.id),
-  ).toEqual(['agc-tracking']);
-  expect(
-    getAccessibleAdminRoutes({
-      accountRole: 'member',
-      tabPermissions: ['tracking'],
-    }).some((route) => route.id === 'agc-tracking'),
-  ).toBe(false);
-});
-
 test('后台默认进入 Dashboard', () => {
   expect(adminRoutes[0]).toEqual({
     id: 'dashboard',
@@ -59,6 +43,12 @@ test('后台灰度发布路由可通过导航和 hash 访问', () => {
   expect(routeHash('gray-release')).toBe('#gray-release');
 });
 
+test('后台不再暴露旧创作模板管理路由', () => {
+  expect(resolveAdminRoute('#creation-entry')).toBe('dashboard');
+  expect(resolveAdminRoute('#creation-announcement')).toBe('dashboard');
+  expect(resolveAdminRoute('#work-visibility')).toBe('dashboard');
+});
+
 test('后台素材查询路由可通过导航和 hash 访问', () => {
   expect(adminRoutes).toContainEqual({
     id: 'editor-assets',
@@ -158,27 +148,6 @@ test('项目工程入口对 owner 与已授权 member 开放且可分配权限',
   ).not.toContainEqual(route);
 });
 
-test('后台游戏审核路由可通过导航和 hash 访问', () => {
-  expect(adminRoutes).toContainEqual({
-    id: 'game-distribution',
-    label: '游戏审核',
-    hash: '#game-distribution',
-  });
-  expect(resolveAdminRoute('#game-distribution')).toBe('game-distribution');
-  expect(routeHash('game-distribution')).toBe('#game-distribution');
-});
-
-test('member 可单独获得游戏审核 Tab 权限', () => {
-  const routes = getAccessibleAdminRoutes({
-    accountRole: 'member',
-    tabPermissions: ['game-distribution'],
-  });
-  expect(routes.map((route) => route.id)).toEqual(['game-distribution']);
-  expect(resolveAccessibleAdminRoute('#game-distribution', routes)).toBe(
-    'game-distribution',
-  );
-});
-
 test('模板管理只对 owner 或具有 agc-templates 权限的 member 可见', () => {
   expect(adminRoutes).toContainEqual({
     id: 'agc-templates',

apps/admin-web/src/app/adminRoutes.ts

@@ -5,7 +5,6 @@ export type AdminRouteId =
   | 'tables'
   | 'debug'
   | 'tracking'
-  | 'agc-tracking'
   | 'error-reports'
   | 'gray-release'
   | 'redeem'
@@ -16,7 +15,6 @@ export type AdminRouteId =
   | 'recharge-orders'
   | 'editor-generation-pricing'
   | 'editor-showcase'
-  | 'game-distribution'
   | 'editor-assets'
   | 'project-snapshots'
   | 'agc-models'
@@ -42,7 +40,6 @@ export const adminRoutes: AdminRouteDefinition[] = [
   { id: 'tables', label: '表查询', hash: '#tables' },
   { id: 'debug', label: 'API 调试', hash: '#debug' },
   { id: 'tracking', label: '埋点数据', hash: '#tracking' },
-  { id: 'agc-tracking', label: '客户端埋点', hash: '#agc-tracking' },
   { id: 'error-reports', label: '错误报告', hash: '#error-reports' },
   { id: 'gray-release', label: '灰度发布', hash: '#gray-release' },
   { id: 'redeem', label: '兑换码', hash: '#redeem' },
@@ -59,7 +56,6 @@ export const adminRoutes: AdminRouteDefinition[] = [
   { id: 'agc-models', label: 'AGC 模型', hash: '#agc-models', ownerOnly: true },
   { id: 'agc-templates', label: '模板管理', hash: '#agc-templates' },
   { id: 'editor-showcase', label: '精选审核', hash: '#editor-showcase' },
-  { id: 'game-distribution', label: '游戏审核', hash: '#game-distribution' },
   { id: 'editor-assets', label: '素材查询', hash: '#editor-assets' },
   { id: 'project-snapshots', label: '项目工程', hash: '#project-snapshots' },
   { id: 'accounts', label: '账号管理', hash: '#accounts', ownerOnly: true },

apps/admin-web/src/pages/AdminAgcTrackingPage.test.tsx

@@ -1,129 +0,0 @@
-// @vitest-environment jsdom
-import {
-  cleanup,
-  fireEvent,
-  render,
-  screen,
-  waitFor,
-  within,
-} from '@testing-library/react';
-import { afterEach, beforeEach, expect, test, vi } from 'vitest';
-
-import {
-  AdminApiError,
-  listAdminAgcTrackingEvents,
-} from '../api/adminApiClient';
-import type { AdminAgcTrackingEventEntry } from '../api/adminApiTypes';
-import { AdminAgcTrackingPage } from './AdminAgcTrackingPage';
-
-vi.mock('../api/adminApiClient', async (original) => ({
-  ...(await original<typeof import('../api/adminApiClient')>()),
-  listAdminAgcTrackingEvents: vi.fn(),
-}));
-vi.mock('../components/AdminUserReferenceButton', () => ({
-  AdminUserReferenceButton: () => null,
-}));
-
-const entry: AdminAgcTrackingEventEntry = {
-  eventId: 'event-1',
-  schemaVersion: 1,
-  eventName: 'project_save',
-  eventTime: '2026-09-21T12:00:00.123Z',
-  userId: 'user-1',
-  editorSessionId: 'session-1',
-  projectId: 'project-1',
-  creativeTaskId: 'project-1',
-  agentRunId: null,
-  agentTurnId: null,
-  status: 'success',
-  errorCode: null,
-  source: 'gui',
-  clientVersion: '1.0',
-  properties: { reason: 'manual' },
-  batchId: 'batch-1',
-  receivedAt: '2026-09-21T12:15:00.000Z',
-};
-
-beforeEach(() => {
-  vi.mocked(listAdminAgcTrackingEvents).mockReset();
-});
-afterEach(cleanup);
-
-test('翻页沿用游标，筛选和刷新从第一页重新查询，详情保留 null 和事件属性', async () => {
-  vi.mocked(listAdminAgcTrackingEvents)
-    .mockResolvedValueOnce({ entries: [entry], nextCursor: 'cursor-page-2' })
-    .mockResolvedValueOnce({
-      entries: [{ ...entry, eventId: 'event-2' }],
-      nextCursor: null,
-    })
-    .mockResolvedValue({ entries: [entry], nextCursor: 'cursor-new' });
-  render(<AdminAgcTrackingPage token="admin-token" onUnauthorized={vi.fn()} />);
-  await screen.findByText('保存项目', { selector: 'td' });
-  expect(listAdminAgcTrackingEvents).toHaveBeenLastCalledWith('admin-token', {
-    cursor: undefined,
-    limit: 50,
-  });
-  fireEvent.click(screen.getByText('查看详情'));
-  const dialog = screen.getByRole('dialog');
-  expect(within(dialog).getAllByText('—').length).toBe(3);
-  expect(within(dialog).getByText(/"reason": "manual"/)).toBeTruthy();
-  expect(within(dialog).getByText(entry.eventTime)).toBeTruthy();
-  fireEvent.click(within(dialog).getByLabelText('关闭详情'));
-  fireEvent.click(screen.getByText('下一页'));
-  await waitFor(() =>
-    expect(listAdminAgcTrackingEvents).toHaveBeenLastCalledWith('admin-token', {
-      cursor: 'cursor-page-2',
-      limit: 50,
-    }),
-  );
-  await waitFor(() =>
-    expect(screen.getByText('查询').closest('button')?.disabled).toBe(false),
-  );
-  fireEvent.click(screen.getByText('上一页'));
-  await screen.findByText('第 1 页');
-  expect(listAdminAgcTrackingEvents).toHaveBeenCalledTimes(2);
-  fireEvent.change(screen.getByLabelText('项目 ID'), {
-    target: { value: 'project-2' },
-  });
-  fireEvent.click(screen.getByText('查询'));
-  await waitFor(() =>
-    expect(listAdminAgcTrackingEvents).toHaveBeenLastCalledWith(
-      'admin-token',
-      expect.objectContaining({
-        projectId: 'project-2',
-        cursor: undefined,
-        limit: 50,
-      }),
-    ),
-  );
-  expect(screen.getByText('第 1 页')).toBeTruthy();
-  await waitFor(() =>
-    expect(screen.getByText('刷新').closest('button')?.disabled).toBe(false),
-  );
-  fireEvent.click(screen.getByText('刷新'));
-  await waitFor(() =>
-    expect(listAdminAgcTrackingEvents).toHaveBeenCalledTimes(4),
-  );
-});
-
-test('空结果、权限失败与登录失效沿用后台反馈', async () => {
-  const unauthorized = vi.fn();
-  vi.mocked(listAdminAgcTrackingEvents)
-    .mockResolvedValueOnce({ entries: [], nextCursor: null })
-    .mockRejectedValueOnce(
-      new AdminApiError({ status: 403, message: '无权访问客户端埋点' }),
-    )
-    .mockRejectedValueOnce(
-      new AdminApiError({ status: 401, message: '登录失效' }),
-    );
-  render(<AdminAgcTrackingPage token="token" onUnauthorized={unauthorized} />);
-  await screen.findByText('暂无客户端埋点数据');
-  fireEvent.click(screen.getByText('刷新'));
-  expect((await screen.findByRole('alert')).textContent).toContain(
-    '无权访问客户端埋点',
-  );
-  fireEvent.click(screen.getByText('刷新'));
-  await waitFor(() =>
-    expect(unauthorized).toHaveBeenCalledWith('登录状态已失效'),
-  );
-});

apps/admin-web/src/pages/AdminAgcTrackingPage.tsx

@@ -1,379 +0,0 @@
-import { Modal } from '@genarrative/shared/components';
-import { FormEvent, useEffect, useRef, useState } from 'react';
-
-import { listAdminAgcTrackingEvents } from '../api/adminApiClient';
-import type {
-  AdminAgcTrackingEventEntry,
-  AdminAgcTrackingEventListResponse,
-  AdminAgcTrackingEventQuery,
-} from '../api/adminApiTypes';
-import { AdminUserReferenceButton } from '../components/AdminUserReferenceButton';
-import { handlePageError } from './pageUtils';
-
-const eventLabels: Record<string, string> = {
-  editor_session_start: '编辑器会话开始',
-  editor_session_end: '编辑器会话结束',
-  editor_focus_start: '编辑器获得焦点',
-  editor_focus_end: '编辑器失去焦点',
-  project_create_success: '项目创建成功',
-  project_open: '打开项目',
-  creative_task_submit: '首次提交创作目标',
-  agent_run_completed: 'Agent 运行完成',
-  agent_run_failed: 'Agent 运行失败',
-  project_revision_created: '项目产生修改',
-  preview_ready: '预览就绪',
-  project_save: '保存项目',
-};
-
-const fieldLabels: Record<keyof AdminAgcTrackingEventEntry, string> = {
-  eventId: '事件 ID',
-  schemaVersion: '事件版本',
-  eventName: '事件类型',
-  eventTime: '发生时间',
-  userId: '用户 ID',
-  editorSessionId: '编辑器会话 ID',
-  projectId: '项目 ID',
-  creativeTaskId: '创作目标 ID',
-  agentRunId: 'Agent run ID',
-  agentTurnId: 'Agent turn ID',
-  status: '结果',
-  errorCode: '错误码',
-  source: '来源',
-  clientVersion: '客户端版本',
-  properties: '事件属性',
-  batchId: '批次 ID',
-  receivedAt: '入库时间',
-};
-
-function formatTime(value: string) {
-  const date = new Date(value);
-  return Number.isNaN(date.getTime()) ? value : date.toLocaleString('zh-CN');
-}
-
-export function AdminAgcTrackingPage({
-  token,
-  onUnauthorized,
-}: {
-  token: string;
-  onUnauthorized: (message?: string) => void;
-}) {
-  const [filters, setFilters] = useState({
-    userId: '',
-    projectId: '',
-    eventName: '',
-    startTime: '',
-    endTime: '',
-  });
-  const [query, setQuery] = useState<AdminAgcTrackingEventQuery>({});
-  const [cursors, setCursors] = useState<Array<string | undefined>>([
-    undefined,
-  ]);
-  const [page, setPage] = useState(0);
-  const [refresh, setRefresh] = useState(0);
-  const [entries, setEntries] = useState<AdminAgcTrackingEventEntry[]>([]);
-  const [nextCursor, setNextCursor] = useState<string | null>(null);
-  const [loading, setLoading] = useState(true);
-  const [error, setError] = useState('');
-  const [detail, setDetail] = useState<AdminAgcTrackingEventEntry | null>(null);
-  const cursor = cursors[page];
-  // 首页没有入站游标，返回首页时保留原快照，刷新才获取新数据。
-  const firstPage = useRef<{
-    token: string;
-    query: AdminAgcTrackingEventQuery;
-    response: AdminAgcTrackingEventListResponse;
-  } | null>(null);
-
-  useEffect(() => {
-    const saved = firstPage.current;
-    if (!cursor && saved?.token === token && saved.query === query) {
-      setEntries(saved.response.entries);
-      setNextCursor(saved.response.nextCursor);
-      setError('');
-      setLoading(false);
-      return;
-    }
-    let active = true;
-    setLoading(true);
-    setError('');
-    setEntries([]);
-    setNextCursor(null);
-    void listAdminAgcTrackingEvents(token, { ...query, cursor, limit: 50 })
-      .then((response) => {
-        if (!active) return;
-        if (!cursor) firstPage.current = { token, query, response };
-        setEntries(response.entries);
-        setNextCursor(response.nextCursor);
-      })
-      .catch((failure: unknown) => {
-        if (active) handlePageError(failure, onUnauthorized, setError);
-      })
-      .finally(() => {
-        if (active) setLoading(false);
-      });
-    return () => {
-      active = false;
-    };
-  }, [token, query, cursor, refresh, onUnauthorized]);
-
-  function resetPages() {
-    firstPage.current = null;
-    setCursors([undefined]);
-    setPage(0);
-    setDetail(null);
-  }
-
-  function search(event: FormEvent<HTMLFormElement>) {
-    event.preventDefault();
-    if (
-      filters.startTime &&
-      filters.endTime &&
-      new Date(filters.startTime) >= new Date(filters.endTime)
-    ) {
-      setError('结束时间必须晚于开始时间');
-      return;
-    }
-    resetPages();
-    setQuery({
-      userId: filters.userId.trim(),
-      projectId: filters.projectId.trim(),
-      eventName: filters.eventName,
-      startTime: filters.startTime
-        ? new Date(filters.startTime).toISOString()
-        : undefined,
-      endTime: filters.endTime
-        ? new Date(filters.endTime).toISOString()
-        : undefined,
-    });
-  }
-
-  function related(
-    key: 'creativeTaskId' | 'agentRunId' | 'clientVersion',
-    value: string,
-  ) {
-    resetPages();
-    setFilters({
-      userId: '',
-      projectId: '',
-      eventName: '',
-      startTime: '',
-      endTime: '',
-    });
-    setQuery({ [key]: value });
-  }
-
-  return (
-    <section className="admin-page admin-page-wide">
-      <div className="admin-page-heading">
-        <div>
-          <h2>客户端埋点</h2>
-          <p>按发生时间倒序展示</p>
-        </div>
-        <button
-          type="button"
-          className="admin-secondary-button"
-          disabled={loading}
-          onClick={() => {
-            resetPages();
-            setRefresh((value) => value + 1);
-          }}
-        >
-          刷新
-        </button>
-      </div>
-      <form className="admin-panel admin-form" onSubmit={search}>
-        <div className="admin-filter-grid">
-          {(['userId', 'projectId'] as const).map((key) => (
-            <label key={key} className="admin-field">
-              <span>{fieldLabels[key]}</span>
-              <input
-                value={filters[key]}
-                onChange={(event) =>
-                  setFilters({ ...filters, [key]: event.target.value })
-                }
-              />
-            </label>
-          ))}
-          <label className="admin-field">
-            <span>事件类型</span>
-            <select
-              value={filters.eventName}
-              onChange={(event) =>
-                setFilters({ ...filters, eventName: event.target.value })
-              }
-            >
-              <option value="">全部</option>
-              {Object.entries(eventLabels).map(([value, label]) => (
-                <option key={value} value={value}>
-                  {label}
-                </option>
-              ))}
-            </select>
-          </label>
-          {(['startTime', 'endTime'] as const).map((key) => (
-            <label key={key} className="admin-field">
-              <span>
-                {key === 'startTime'
-                  ? '发生时间起点（含）'
-                  : '发生时间终点（不含）'}
-              </span>
-              <input
-                type="datetime-local"
-                value={filters[key]}
-                onChange={(event) =>
-                  setFilters({ ...filters, [key]: event.target.value })
-                }
-              />
-            </label>
-          ))}
-        </div>
-        <div className="admin-action-row">
-          <button
-            type="submit"
-            className="admin-primary-button"
-            disabled={loading}
-          >
-            查询
-          </button>
-        </div>
-        {(['creativeTaskId', 'agentRunId', 'clientVersion'] as const)
-          .filter((key) => query[key])
-          .map((key) => (
-            <p key={key}>
-              {fieldLabels[key]}：{query[key]}（重新查询可清除）
-            </p>
-          ))}
-      </form>
-      {error ? (
-        <p role="alert" className="admin-error-message">
-          {error}
-        </p>
-      ) : null}
-      <div className="admin-panel">
-        <div className="admin-table-wrap">
-          <table className="admin-table">
-            <thead>
-              <tr>
-                {[
-                  '入库时间',
-                  '发生时间',
-                  '用户',
-                  '事件名称',
-                  '项目',
-                  '来源',
-                  '结果',
-                  '客户端版本',
-                  '详情',
-                ].map((label) => (
-                  <th key={label}>{label}</th>
-                ))}
-              </tr>
-            </thead>
-            <tbody>
-              {entries.map((entry) => (
-                <tr key={entry.eventId}>
-                  <td>{formatTime(entry.receivedAt)}</td>
-                  <td>{formatTime(entry.eventTime)}</td>
-                  <td>
-                    {entry.userId}
-                    <AdminUserReferenceButton
-                      token={token}
-                      userId={entry.userId}
-                      onUnauthorized={onUnauthorized}
-                    />
-                  </td>
-                  <td>{eventLabels[entry.eventName] ?? entry.eventName}</td>
-                  <td>{entry.projectId ?? '—'}</td>
-                  <td>{entry.source}</td>
-                  <td>{entry.status ?? '—'}</td>
-                  <td>{entry.clientVersion}</td>
-                  <td>
-                    <button
-                      type="button"
-                      className="admin-ghost-button"
-                      onClick={() => setDetail(entry)}
-                    >
-                      查看详情
-                    </button>
-                  </td>
-                </tr>
-              ))}
-            </tbody>
-          </table>
-        </div>
-        {loading ? (
-          <p role="status">加载中…</p>
-        ) : !error && entries.length === 0 ? (
-          <p>暂无客户端埋点数据</p>
-        ) : null}
-        <div className="admin-action-row">
-          <button
-            type="button"
-            className="admin-secondary-button"
-            disabled={loading || page === 0}
-            onClick={() => setPage((value) => value - 1)}
-          >
-            上一页
-          </button>
-          <span>第 {page + 1} 页</span>
-          <button
-            type="button"
-            className="admin-secondary-button"
-            disabled={loading || !nextCursor}
-            onClick={() => {
-              if (!nextCursor) return;
-              setCursors([...cursors.slice(0, page + 1), nextCursor]);
-              setPage(page + 1);
-            }}
-          >
-            下一页
-          </button>
-        </div>
-      </div>
-      {detail ? (
-        <Modal
-          open
-          title="客户端埋点详情"
-          closeLabel="关闭详情"
-          onClose={() => setDetail(null)}
-          className="genarrative-ui"
-        >
-          <dl>
-            {(
-              Object.keys(fieldLabels) as Array<
-                keyof AdminAgcTrackingEventEntry
-              >
-            )
-              .filter((key) => key !== 'properties')
-              .map((key) => (
-                <div key={key}>
-                  <dt>{fieldLabels[key]}</dt>
-                  <dd style={{ overflowWrap: 'anywhere' }}>
-                    {detail[key] == null ? '—' : String(detail[key])}
-                  </dd>
-                </div>
-              ))}
-          </dl>
-          <div className="admin-action-row">
-            {(['creativeTaskId', 'agentRunId', 'clientVersion'] as const).map(
-              (key) =>
-                detail[key] ? (
-                  <button
-                    type="button"
-                    key={key}
-                    className="admin-secondary-button"
-                    onClick={() => related(key, detail[key]!)}
-                  >
-                    查询同一{fieldLabels[key]}
-                  </button>
-                ) : null,
-            )}
-          </div>
-          <h3>事件属性</h3>
-          <pre style={{ whiteSpace: 'pre-wrap', overflowWrap: 'anywhere' }}>
-            {JSON.stringify(detail.properties, null, 2)}
-          </pre>
-        </Modal>
-      ) : null}
-    </section>
-  );
-}

apps/admin-web/src/pages/AdminDatabaseTablesPage.tsx

@@ -2641,6 +2641,48 @@ const databaseTableLabelMap: Record<string, string> = {
   profile_recharge_order: '充值订单',
   profile_feedback_submission: '反馈提交',
   profile_save_archive: '存档记录',
+  story_session: '剧情会话',
+  story_event: '剧情事件',
+  npc_state: 'NPC 状态',
+  inventory_slot: '背包槽位',
+  battle_state: '战斗状态',
+  treasure_record: '宝藏记录',
+  quest_record: '任务记录',
+  quest_log: '任务日志',
+  player_progression: '玩家进度',
+  chapter_progression: '章节进度',
+  custom_world_profile: '自定义世界档案',
+  custom_world_session: '自定义世界会话',
+  custom_world_agent_session: '自定义世界 Agent 会话',
+  custom_world_agent_message: '自定义世界 Agent 消息',
+  custom_world_agent_operation: '自定义世界 Agent 操作',
+  custom_world_draft_card: '自定义世界草稿卡片',
+  custom_world_gallery_entry: '自定义世界画廊条目',
+  puzzle_agent_session: '拼图 Agent 会话',
+  puzzle_agent_message: '拼图 Agent 消息',
+  puzzle_work_profile: '拼图作品档案',
+  puzzle_event: '拼图事件',
+  puzzle_runtime_run: '拼图运行记录',
+  puzzle_leaderboard_entry: '拼图排行榜条目',
+  match3d_agent_session: '抓大鹅 Agent 会话',
+  match3d_agent_message: '抓大鹅 Agent 消息',
+  match3d_work_profile: '抓大鹅作品档案',
+  match3d_runtime_run: '抓大鹅运行记录',
+  square_hole_agent_session: '方洞挑战 Agent 会话',
+  square_hole_agent_message: '方洞挑战 Agent 消息',
+  square_hole_work_profile: '方洞挑战作品档案',
+  square_hole_runtime_run: '方洞挑战运行记录',
+  visual_novel_agent_session: '视觉小说 Agent 会话',
+  visual_novel_agent_message: '视觉小说 Agent 消息',
+  visual_novel_work_profile: '视觉小说作品档案',
+  visual_novel_runtime_run: '视觉小说运行记录',
+  visual_novel_runtime_history_entry: '视觉小说历史条目',
+  visual_novel_runtime_event: '视觉小说运行事件',
+  big_fish_creation_session: '大鱼吃小鱼创建会话',
+  big_fish_agent_message: '大鱼吃小鱼 Agent 消息',
+  big_fish_asset_slot: '大鱼吃小鱼资产槽位',
+  big_fish_event: '大鱼吃小鱼事件',
+  big_fish_runtime_run: '大鱼吃小鱼运行记录',
   asset_object: '资产对象',
   asset_entity_binding: '资产实体绑定',
   asset_event: '资产事件',
@@ -2682,6 +2724,48 @@ const databaseTableDescriptionMap: Record<string, string> = {
   profile_recharge_order: '充值订单表',
   profile_feedback_submission: '反馈提交记录表',
   profile_save_archive: '用户存档记录表',
+  story_session: '剧情会话表',
+  story_event: '剧情事件表',
+  npc_state: 'NPC 状态表',
+  inventory_slot: '背包槽位表',
+  battle_state: '战斗状态表',
+  treasure_record: '宝藏记录表',
+  quest_record: '任务记录表',
+  quest_log: '任务日志表',
+  player_progression: '玩家进度表',
+  chapter_progression: '章节进度表',
+  custom_world_profile: '自定义世界档案表',
+  custom_world_session: '自定义世界会话表',
+  custom_world_agent_session: '自定义世界 Agent 会话表',
+  custom_world_agent_message: '自定义世界 Agent 消息表',
+  custom_world_agent_operation: '自定义世界 Agent 操作表',
+  custom_world_draft_card: '自定义世界草稿卡片表',
+  custom_world_gallery_entry: '自定义世界画廊条目表',
+  puzzle_agent_session: '拼图 Agent 会话表',
+  puzzle_agent_message: '拼图 Agent 消息表',
+  puzzle_work_profile: '拼图作品档案表',
+  puzzle_event: '拼图事件表',
+  puzzle_runtime_run: '拼图运行记录表',
+  puzzle_leaderboard_entry: '拼图排行榜条目表',
+  match3d_agent_session: '抓大鹅 Agent 会话表',
+  match3d_agent_message: '抓大鹅 Agent 消息表',
+  match3d_work_profile: '抓大鹅作品档案表',
+  match3d_runtime_run: '抓大鹅运行记录表',
+  square_hole_agent_session: '方洞挑战 Agent 会话表',
+  square_hole_agent_message: '方洞挑战 Agent 消息表',
+  square_hole_work_profile: '方洞挑战作品档案表',
+  square_hole_runtime_run: '方洞挑战运行记录表',
+  visual_novel_agent_session: '视觉小说 Agent 会话表',
+  visual_novel_agent_message: '视觉小说 Agent 消息表',
+  visual_novel_work_profile: '视觉小说作品档案表',
+  visual_novel_runtime_run: '视觉小说运行记录表',
+  visual_novel_runtime_history_entry: '视觉小说历史条目表',
+  visual_novel_runtime_event: '视觉小说运行事件表',
+  big_fish_creation_session: '大鱼吃小鱼创建会话表',
+  big_fish_agent_message: '大鱼吃小鱼 Agent 消息表',
+  big_fish_asset_slot: '大鱼吃小鱼资产槽位表',
+  big_fish_event: '大鱼吃小鱼事件表',
+  big_fish_runtime_run: '大鱼吃小鱼运行记录表',
   asset_object: '资产对象表',
   asset_entity_binding: '资产实体绑定表',
   asset_event: '资产事件表',

apps/admin-web/src/pages/AdminGameDistributionReviewPage.test.tsx

@@ -1,186 +0,0 @@
-/* @vitest-environment jsdom */
-
-import { fireEvent, render, screen, waitFor } from '@testing-library/react';
-import { beforeEach, expect, test, vi } from 'vitest';
-
-import {
-  listAdminGameDistributionReviews,
-  reviewAdminGameDistributionVersion,
-  suspendAdminGameDistributionGame,
-} from '../api/adminApiClient';
-import type { AdminGameDistributionReviewEntry } from '../api/adminApiTypes';
-import {
-  AdminGameDistributionReviewPage,
-  resolveGameReleaseEntryUrlError,
-} from './AdminGameDistributionReviewPage';
-
-vi.mock('../api/adminApiClient', () => ({
-  isAdminApiError: vi.fn(
-    (error: unknown) =>
-      typeof error === 'object' &&
-      error !== null &&
-      'status' in error &&
-      typeof error.status === 'number',
-  ),
-  formatAdminApiError: vi.fn((error: unknown) =>
-    error instanceof Error ? error.message : '请求失败',
-  ),
-  listAdminGameDistributionReviews: vi.fn(),
-  reviewAdminGameDistributionVersion: vi.fn(),
-  suspendAdminGameDistributionGame: vi.fn(),
-}));
-
-const entry: AdminGameDistributionReviewEntry = {
-  versionId: 'version-1',
-  gameId: 'game_1',
-  versionNumber: 2,
-  packageSha256: 'a'.repeat(64),
-  packageBytes: 2048,
-  status: 'pending_review',
-  publicationRevision: 4,
-  reviewReason: null,
-  createdAt: '2026-09-20T08:00:00Z',
-  updatedAt: '2026-09-20T08:00:00Z',
-};
-
-beforeEach(() => {
-  vi.mocked(listAdminGameDistributionReviews).mockReset();
-  vi.mocked(reviewAdminGameDistributionVersion).mockReset();
-  vi.mocked(suspendAdminGameDistributionGame).mockReset();
-  vi.mocked(listAdminGameDistributionReviews).mockResolvedValue({
-    entries: [entry],
-    nextCursor: null,
-  });
-});
-
-test('发行入口必须是带完整来源的 HTTPS 地址', () => {
-  expect(resolveGameReleaseEntryUrlError('')).toBe('请填写发行入口');
-  expect(
-    resolveGameReleaseEntryUrlError('http://games.test/a/index.html'),
-  ).toBe('发行入口必须以 https:// 开头');
-  expect(
-    resolveGameReleaseEntryUrlError('https://games.test/a/index.html?token=1'),
-  ).toBe('发行入口不能包含 query 或 fragment');
-  expect(
-    resolveGameReleaseEntryUrlError('https://u:p@games.test/a/index.html'),
-  ).toBe('发行入口不能包含凭据');
-  expect(
-    resolveGameReleaseEntryUrlError('https://games.test/a/index.html'),
-  ).toBe('');
-});
-
-test('通过审核时提交当前 publicationRevision 与发行入口并刷新列表', async () => {
-  vi.mocked(reviewAdminGameDistributionVersion).mockResolvedValue({
-    version: { ...entry, status: 'published' },
-    replayed: false,
-  });
-
-  render(
-    <AdminGameDistributionReviewPage
-      token="admin-token"
-      onUnauthorized={vi.fn()}
-    />,
-  );
-  await screen.findByText('game_1');
-
-  fireEvent.change(screen.getByLabelText('发行入口'), {
-    target: { value: 'https://games.test/releases/game_1/index.html' },
-  });
-  fireEvent.click(screen.getByRole('button', { name: '通过' }));
-
-  await waitFor(() =>
-    expect(reviewAdminGameDistributionVersion).toHaveBeenCalledTimes(1),
-  );
-  const [token, versionId, idempotencyKey, payload] =
-    vi.mocked(reviewAdminGameDistributionVersion).mock.calls[0] ?? [];
-  expect(token).toBe('admin-token');
-  expect(versionId).toBe('version-1');
-  expect(String(idempotencyKey)).toContain('version-1');
-  expect(payload).toEqual({
-    decision: 'approve',
-    expectedPublicationRevision: 4,
-    entryUrl: 'https://games.test/releases/game_1/index.html',
-  });
-  await waitFor(() =>
-    expect(vi.mocked(listAdminGameDistributionReviews)).toHaveBeenCalledTimes(
-      2,
-    ),
-  );
-});
-
-test('缺少拒绝理由时不调用审核接口', async () => {
-  render(
-    <AdminGameDistributionReviewPage
-      token="admin-token"
-      onUnauthorized={vi.fn()}
-    />,
-  );
-  await screen.findByText('game_1');
-
-  fireEvent.click(screen.getByRole('button', { name: '拒绝' }));
-
-  expect(await screen.findByText('拒绝审核必须填写理由')).toBeTruthy();
-  expect(reviewAdminGameDistributionVersion).not.toHaveBeenCalled();
-});
-
-test('安全下架需要二次确认，并携带公开修订号与原因', async () => {
-  vi.mocked(suspendAdminGameDistributionGame).mockResolvedValue({
-    game: {
-      id: 'game_1',
-      title: '测试游戏',
-      status: 'suspended',
-      publicationRevision: 5,
-    },
-    replayed: false,
-  });
-
-  render(
-    <AdminGameDistributionReviewPage
-      token="admin-token"
-      onUnauthorized={vi.fn()}
-    />,
-  );
-  await screen.findByText('game_1');
-
-  fireEvent.change(screen.getByLabelText('下架原因'), {
-    target: { value: '盗用素材' },
-  });
-  fireEvent.click(screen.getByRole('button', { name: '安全下架' }));
-
-  // 第一次点击只弹出确认面板，不直接调用后端。
-  expect(suspendAdminGameDistributionGame).not.toHaveBeenCalled();
-  expect(await screen.findByRole('dialog')).toBeTruthy();
-
-  fireEvent.click(screen.getByRole('button', { name: '确认' }));
-
-  await waitFor(() =>
-    expect(suspendAdminGameDistributionGame).toHaveBeenCalledTimes(1),
-  );
-  const [token, gameId, idempotencyKey, payload] =
-    vi.mocked(suspendAdminGameDistributionGame).mock.calls[0] ?? [];
-  expect(token).toBe('admin-token');
-  expect(gameId).toBe('game_1');
-  expect(String(idempotencyKey)).toContain('game_1');
-  expect(payload).toEqual({
-    expectedPublicationRevision: 4,
-    reason: '盗用素材',
-  });
-  expect(await screen.findByText(/已安全下架/u)).toBeTruthy();
-});
-
-test('取消确认时不下架', async () => {
-  render(
-    <AdminGameDistributionReviewPage
-      token="admin-token"
-      onUnauthorized={vi.fn()}
-    />,
-  );
-  await screen.findByText('game_1');
-
-  fireEvent.click(screen.getByRole('button', { name: '安全下架' }));
-  await screen.findByRole('dialog');
-  fireEvent.click(screen.getByRole('button', { name: '取消' }));
-
-  await waitFor(() => expect(screen.queryByRole('dialog')).toBeNull());
-  expect(suspendAdminGameDistributionGame).not.toHaveBeenCalled();
-});

apps/admin-web/src/pages/AdminGameDistributionReviewPage.tsx

@@ -1,365 +0,0 @@
-import { RefreshCcw } from 'lucide-react';
-import { useCallback, useEffect, useState } from 'react';
-
-import {
-  listAdminGameDistributionReviews,
-  reviewAdminGameDistributionVersion,
-  suspendAdminGameDistributionGame,
-} from '../api/adminApiClient';
-import type { AdminGameDistributionReviewEntry } from '../api/adminApiTypes';
-import { useAdminWriteConfirm } from '../components/useAdminWriteConfirm';
-import { handlePageError } from './pageUtils';
-
-interface AdminGameDistributionReviewPageProps {
-  token: string;
-  onUnauthorized: (message?: string) => void;
-}
-
-function formatBytes(value: number) {
-  if (value >= 1024 * 1024) {
-    return `${(value / (1024 * 1024)).toFixed(1)} MiB`;
-  }
-  if (value >= 1024) {
-    return `${(value / 1024).toFixed(1)} KiB`;
-  }
-  return `${value} B`;
-}
-
-function formatTime(value: string) {
-  const parsed = new Date(value);
-  if (Number.isNaN(parsed.getTime())) return value;
-  return parsed.toLocaleString('zh-CN', { hour12: false });
-}
-
-function createSuspendIdempotencyKey(gameId: string) {
-  const random =
-    typeof crypto !== 'undefined' && 'randomUUID' in crypto
-      ? crypto.randomUUID()
-      : `${Date.now()}-${Math.random().toString(16).slice(2)}`;
-  return `game-suspend-${gameId}-${random}`.slice(0, 128);
-}
-
-function createReviewIdempotencyKey(versionId: string) {
-  const random =
-    typeof crypto !== 'undefined' && 'randomUUID' in crypto
-      ? crypto.randomUUID()
-      : `${Date.now()}-${Math.random().toString(16).slice(2)}`;
-  return `game-review-${versionId}-${random}`.slice(0, 128);
-}
-
-export function resolveGameReleaseEntryUrlError(value: string) {
-  const normalized = value.trim();
-  if (!normalized) return '请填写发行入口';
-  if (!normalized.startsWith('https://')) {
-    return '发行入口必须以 https:// 开头';
-  }
-  if (normalized.includes('?') || normalized.includes('#')) {
-    return '发行入口不能包含 query 或 fragment';
-  }
-  try {
-    const parsed = new URL(normalized);
-    if (parsed.username || parsed.password) {
-      return '发行入口不能包含凭据';
-    }
-  } catch {
-    return '发行入口不是合法 URL';
-  }
-  return '';
-}
-
-export function AdminGameDistributionReviewPage({
-  token,
-  onUnauthorized,
-}: AdminGameDistributionReviewPageProps) {
-  const [entries, setEntries] = useState<AdminGameDistributionReviewEntry[]>(
-    [],
-  );
-  const [isLoading, setIsLoading] = useState(false);
-  const [busyVersionId, setBusyVersionId] = useState('');
-  const [errorMessage, setErrorMessage] = useState('');
-  const [statusMessage, setStatusMessage] = useState('');
-  const [entryUrlByVersion, setEntryUrlByVersion] = useState<
-    Record<string, string>
-  >({});
-  const [reasonByVersion, setReasonByVersion] = useState<
-    Record<string, string>
-  >({});
-  const [suspendReasonByGame, setSuspendReasonByGame] = useState<
-    Record<string, string>
-  >({});
-  const [busyGameId, setBusyGameId] = useState('');
-  const writeConfirm = useAdminWriteConfirm();
-
-  const loadReviews = useCallback(async () => {
-    setIsLoading(true);
-    setErrorMessage('');
-    try {
-      const response = await listAdminGameDistributionReviews(token);
-      setEntries(response.entries);
-    } catch (error) {
-      handlePageError(error, onUnauthorized, setErrorMessage);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [token, onUnauthorized]);
-
-  useEffect(() => {
-    void loadReviews();
-  }, [loadReviews]);
-
-  async function submitReview(
-    entry: AdminGameDistributionReviewEntry,
-    decision: 'approve' | 'reject',
-  ) {
-    const entryUrl = (entryUrlByVersion[entry.versionId] ?? '').trim();
-    const reason = (reasonByVersion[entry.versionId] ?? '').trim();
-    if (decision === 'approve') {
-      const invalid = resolveGameReleaseEntryUrlError(entryUrl);
-      if (invalid) {
-        setErrorMessage(invalid);
-        return;
-      }
-    } else if (!reason) {
-      setErrorMessage('拒绝审核必须填写理由');
-      return;
-    }
-    setBusyVersionId(entry.versionId);
-    setErrorMessage('');
-    setStatusMessage('');
-    try {
-      await reviewAdminGameDistributionVersion(
-        token,
-        entry.versionId,
-        createReviewIdempotencyKey(entry.versionId),
-        decision === 'approve'
-          ? {
-              decision,
-              expectedPublicationRevision: entry.publicationRevision,
-              entryUrl,
-            }
-          : {
-              decision,
-              expectedPublicationRevision: entry.publicationRevision,
-              reviewReason: reason,
-            },
-      );
-      setStatusMessage(
-        decision === 'approve'
-          ? `版本 v${entry.versionNumber} 已通过审核`
-          : `版本 v${entry.versionNumber} 已拒绝`,
-      );
-      await loadReviews();
-    } catch (error) {
-      handlePageError(error, onUnauthorized, setErrorMessage);
-    } finally {
-      setBusyVersionId('');
-    }
-  }
-
-  /**
-   * 管理员安全下架：先二次确认，再带当前公开修订号调用后端；并发审核导致修订号变化时
-   * 由服务端返回冲突，前端只提示刷新，不静默重试。
-   */
-  async function suspendGame(entry: AdminGameDistributionReviewEntry) {
-    const reason = (suspendReasonByGame[entry.gameId] ?? '').trim();
-    const confirmed = await writeConfirm.confirmWrite({
-      action: '安全下架游戏',
-      target: `${entry.gameId}（版本 v${entry.versionNumber}）`,
-    });
-    if (!confirmed) return;
-    setBusyGameId(entry.gameId);
-    setErrorMessage('');
-    setStatusMessage('');
-    try {
-      await suspendAdminGameDistributionGame(
-        token,
-        entry.gameId,
-        createSuspendIdempotencyKey(entry.gameId),
-        {
-          expectedPublicationRevision: entry.publicationRevision,
-          ...(reason ? { reason } : {}),
-        },
-      );
-      setStatusMessage(`游戏 ${entry.gameId} 已安全下架，发行入口已关闭`);
-      setSuspendReasonByGame((current) => ({ ...current, [entry.gameId]: '' }));
-      await loadReviews();
-    } catch (error) {
-      handlePageError(error, onUnauthorized, setErrorMessage);
-    } finally {
-      setBusyGameId('');
-    }
-  }
-
-  return (
-    <section className="admin-page admin-page-wide">
-      <div className="admin-page-heading">
-        <h1>游戏审核</h1>
-        <button
-          type="button"
-          className="admin-secondary-button"
-          onClick={() => void loadReviews()}
-          disabled={isLoading}
-        >
-          <RefreshCcw aria-hidden="true" />
-          刷新
-        </button>
-      </div>
-
-      {errorMessage ? (
-        <div className="admin-alert admin-alert-warning" role="alert">
-          {errorMessage}
-        </div>
-      ) : null}
-      {statusMessage ? (
-        <div className="admin-alert admin-alert-success" role="status">
-          {statusMessage}
-        </div>
-      ) : null}
-
-      <div className="admin-panel">
-        <div className="admin-panel-heading">
-          <h2>待审版本</h2>
-          <span className="admin-muted-text">共 {entries.length} 条</span>
-        </div>
-
-        {isLoading ? (
-          <p className="admin-muted-text">正在加载待审版本…</p>
-        ) : null}
-
-        {!isLoading && entries.length === 0 ? (
-          <p className="admin-muted-text">当前没有待审核的游戏版本。</p>
-        ) : null}
-
-        {!isLoading && entries.length > 0 ? (
-          <div className="admin-table-wrap">
-            <table className="admin-table admin-table-wide">
-              <thead>
-                <tr>
-                  <th>游戏</th>
-                  <th>版本</th>
-                  <th>发行包</th>
-                  <th>提交时间</th>
-                  <th>审核</th>
-                </tr>
-              </thead>
-              <tbody>
-                {entries.map((entry) => {
-                  const busy = busyVersionId === entry.versionId;
-                  return (
-                    <tr key={entry.versionId}>
-                      <td>
-                        <code>{entry.gameId}</code>
-                      </td>
-                      <td>
-                        v{entry.versionNumber}
-                        <div className="admin-muted-text">{entry.status}</div>
-                        {entry.reviewReason ? (
-                          <div className="admin-muted-text">
-                            {entry.reviewReason}
-                          </div>
-                        ) : null}
-                      </td>
-                      <td>
-                        {formatBytes(entry.packageBytes)}
-                        <div className="admin-muted-text">
-                          <code>{entry.packageSha256.slice(0, 12)}</code>
-                        </div>
-                      </td>
-                      <td>{formatTime(entry.createdAt)}</td>
-                      <td>
-                        <div className="admin-action-row">
-                          <div className="admin-field">
-                            <label
-                              htmlFor={`game-release-url-${entry.versionId}`}
-                            >
-                              发行入口
-                            </label>
-                            <input
-                              id={`game-release-url-${entry.versionId}`}
-                              value={entryUrlByVersion[entry.versionId] ?? ''}
-                              placeholder="https://"
-                              onChange={(event) =>
-                                setEntryUrlByVersion((current) => ({
-                                  ...current,
-                                  [entry.versionId]: event.target.value,
-                                }))
-                              }
-                              disabled={busy}
-                            />
-                          </div>
-                          <button
-                            type="button"
-                            className="admin-primary-button"
-                            disabled={busy}
-                            onClick={() => void submitReview(entry, 'approve')}
-                          >
-                            通过
-                          </button>
-                          <div className="admin-field">
-                            <label
-                              htmlFor={`game-reject-reason-${entry.versionId}`}
-                            >
-                              拒绝理由
-                            </label>
-                            <input
-                              id={`game-reject-reason-${entry.versionId}`}
-                              value={reasonByVersion[entry.versionId] ?? ''}
-                              onChange={(event) =>
-                                setReasonByVersion((current) => ({
-                                  ...current,
-                                  [entry.versionId]: event.target.value,
-                                }))
-                              }
-                              disabled={busy}
-                            />
-                          </div>
-                          <button
-                            type="button"
-                            className="admin-ghost-button"
-                            disabled={busy}
-                            onClick={() => void submitReview(entry, 'reject')}
-                          >
-                            拒绝
-                          </button>
-                          <div className="admin-field">
-                            <label
-                              htmlFor={`game-suspend-reason-${entry.versionId}`}
-                            >
-                              下架原因
-                            </label>
-                            <input
-                              id={`game-suspend-reason-${entry.versionId}`}
-                              value={suspendReasonByGame[entry.gameId] ?? ''}
-                              onChange={(event) =>
-                                setSuspendReasonByGame((current) => ({
-                                  ...current,
-                                  [entry.gameId]: event.target.value,
-                                }))
-                              }
-                              disabled={busy}
-                            />
-                          </div>
-                          <button
-                            type="button"
-                            className="admin-danger-button"
-                            disabled={busy || busyGameId === entry.gameId}
-                            onClick={() => void suspendGame(entry)}
-                          >
-                            {busyGameId === entry.gameId
-                              ? '正在下架…'
-                              : '安全下架'}
-                          </button>
-                        </div>
-                      </td>
-                    </tr>
-                  );
-                })}
-              </tbody>
-            </table>
-          </div>
-        ) : null}
-      </div>
-      {writeConfirm.confirmDialog}
-    </section>
-  );
-}

apps/admin-web/src/pages/AdminGrayReleaseConfigPage.test.tsx

@@ -175,107 +175,6 @@ test('灰度发布页可选择模板库并默认启用零比例灰度', async ()
   );
 });
 
-test('灰度发布页可选择游戏发布开关，默认保持「未开启即开放」语义', async () => {
-  const user = userEvent.setup();
-  render(
-    <AdminGrayReleaseConfigPage token="admin-token" onUnauthorized={vi.fn()} />,
-  );
-
-  await screen.findByRole('button', { name: 'editor.new-toolbar' });
-  await user.selectOptions(screen.getByLabelText('Gate Key 前缀'), [
-    'game-distribution',
-  ]);
-
-  expect((screen.getByLabelText('Gate Key') as HTMLInputElement).value).toBe(
-    'game-distribution:publish',
-  );
-  expect(
-    (screen.getByLabelText('Gate Key 目标') as HTMLSelectElement).value,
-  ).toBe('publish');
-  // 该开关的语义是「未配置/关闭 = 默认开放」，所以选中后不能默认打开收紧。
-  expect((screen.getByLabelText('启用') as HTMLInputElement).checked).toBe(
-    false,
-  );
-  expect((screen.getByLabelText('灰度比例') as HTMLInputElement).value).toBe(
-    '0',
-  );
-  expect(
-    (screen.getByLabelText('描述') as HTMLTextAreaElement).value,
-  ).toContain('游戏发布入口灰度');
-});
-
-test('灰度发布页保存游戏发布开关时写入白名单与比例', async () => {
-  const user = userEvent.setup();
-  vi.mocked(upsertAdminFeatureGateConfig).mockResolvedValueOnce({
-    gates: [
-      ...configResponse.gates,
-      {
-        gateKey: 'game-distribution:publish',
-        enabled: true,
-        rolloutPercent: 20,
-        allowUserIds: ['user-internal'],
-        allowUserTags: [],
-        denyUserIds: [],
-        description: '游戏发布入口灰度',
-        updatedAt: '2026-09-22T10:00:00Z',
-      },
-    ],
-  });
-  render(
-    <AdminGrayReleaseConfigPage token="admin-token" onUnauthorized={vi.fn()} />,
-  );
-
-  await screen.findByRole('button', { name: 'editor.new-toolbar' });
-  await user.selectOptions(screen.getByLabelText('Gate Key 前缀'), [
-    'game-distribution',
-  ]);
-  fireEvent.click(screen.getByLabelText('启用'));
-  fireEvent.change(screen.getByLabelText('灰度比例'), {
-    target: { value: '20' },
-  });
-  fireEvent.change(screen.getByLabelText('允许用户 ID'), {
-    target: { value: 'user-internal' },
-  });
-  fireEvent.change(screen.getByLabelText('描述'), {
-    target: { value: '游戏发布入口灰度' },
-  });
-  await user.click(screen.getByRole('button', { name: '保存配置' }));
-  await user.click(screen.getByRole('button', { name: '确认' }));
-
-  await waitFor(() =>
-    expect(upsertAdminFeatureGateConfig).toHaveBeenCalledWith('admin-token', {
-      gateKey: 'game-distribution:publish',
-      enabled: true,
-      rolloutPercent: 20,
-      allowUserIds: ['user-internal'],
-      allowUserTags: [],
-      denyUserIds: [],
-      description: '游戏发布入口灰度',
-    }),
-  );
-});
-
-test('未创建的预设开关在后台可见并可一键配置', async () => {
-  const user = userEvent.setup();
-  render(
-    <AdminGrayReleaseConfigPage token="admin-token" onUnauthorized={vi.fn()} />,
-  );
-
-  const row = await screen.findByText('game-distribution:publish');
-  expect(row).not.toBeNull();
-  // 该开关默认未创建：列表里给出「配置」入口，点击后按默认关闭填充表单。
-  const configureButton = row.closest('tr')?.querySelector('button');
-  expect(configureButton).not.toBeNull();
-  await user.click(configureButton!);
-
-  expect((screen.getByLabelText('Gate Key') as HTMLInputElement).value).toBe(
-    'game-distribution:publish',
-  );
-  expect((screen.getByLabelText('启用') as HTMLInputElement).checked).toBe(
-    false,
-  );
-});
-
 test('灰度发布页保存时转换数组和百分比', async () => {
   const user = userEvent.setup();
   vi.mocked(upsertAdminFeatureGateConfig).mockResolvedValueOnce({

apps/admin-web/src/pages/AdminGrayReleaseConfigPage.tsx

@@ -28,7 +28,6 @@ interface GateTargetOption {
 const GATE_PREFIX_LABELS: Record<string, string> = {
   'image-editor': '画布',
   agc: '客户端',
-  'game-distribution': '游戏分发',
 };
 
 const FIXED_GATE_TARGETS: GateTargetOption[] = [
@@ -46,14 +45,6 @@ const FIXED_GATE_TARGETS: GateTargetOption[] = [
     label: 'Agent 侧边栏',
     description: '画布 Agent 入口灰度',
   },
-  {
-    prefix: 'game-distribution',
-    suffix: 'publish',
-    key: 'game-distribution:publish',
-    label: '游戏发布',
-    description:
-      '游戏发布入口灰度：未配置或关闭时对已登录作者默认开放，开启后只放行白名单 / 灰度命中',
-  },
 ];
 
 export function AdminGrayReleaseConfigPage({
@@ -206,11 +197,6 @@ export function AdminGrayReleaseConfigPage({
     setErrorMessage('');
   }
 
-  // 预设里尚未创建行的开关也要可见：运营需要先看到 key 才能配置灰度。
-  const unconfiguredGateTargets = FIXED_GATE_TARGETS.filter(
-    (option) => !gates.some((gate) => gate.gateKey === option.key),
-  );
-
   function buildPayload(): AdminUpsertFeatureGateConfigRequest {
     return {
       gateKey: gateKey.trim(),
@@ -457,53 +443,6 @@ export function AdminGrayReleaseConfigPage({
             </div>
           )}
         </section>
-
-        <section className="admin-panel">
-          <div className="admin-panel-heading">
-            <h3>可配置开关</h3>
-            <span>{unconfiguredGateTargets.length}</span>
-          </div>
-          {unconfiguredGateTargets.length ? (
-            <div className="admin-table-wrap">
-              <table className="admin-table admin-table-compact">
-                <thead>
-                  <tr>
-                    <th>Gate</th>
-                    <th>说明</th>
-                    <th>操作</th>
-                  </tr>
-                </thead>
-                <tbody>
-                  {unconfiguredGateTargets.map((option) => (
-                    <tr key={option.key}>
-                      <td>
-                        {option.key}
-                        <small>
-                          {GATE_PREFIX_LABELS[option.prefix] ?? option.prefix} ·{' '}
-                          {option.label}
-                        </small>
-                      </td>
-                      <td>{option.description}</td>
-                      <td>
-                        <button
-                          className="admin-text-button"
-                          type="button"
-                          onClick={() => applyGateTarget(option)}
-                        >
-                          配置
-                        </button>
-                      </td>
-                    </tr>
-                  ))}
-                </tbody>
-              </table>
-            </div>
-          ) : (
-            <div className="admin-empty-state">
-              {isLoading ? '加载中' : '预设开关都已创建'}
-            </div>
-          )}
-        </section>
       </div>
 
       {confirmDialog}

apps/ai-game-creator-shell/scripts/build-release.mjs

@@ -648,32 +648,6 @@ function readHeadCommit() {
   }
 }
 
-/**
- * Git 的 %s 会把「标题后紧接说明行、没有空行」的整个首段拼成一行；
- * 更新摘要只允许展示原始提交消息的第一行，避免把说明暴露给用户。
- */
-function commitMessageTitle(message) {
-  return String(message ?? '')
-    .split(/\r?\n/u, 1)[0]
-    .trim();
-}
-
-/** 解析 `git log -z --format=%h%x09%B`，只保留每个 commit 的消息首行。 */
-function parseReleaseCommitLog(output) {
-  return output
-    .split('\0')
-    .map((record) => record.trimEnd())
-    .filter(Boolean)
-    .map((record) => {
-      const separator = record.indexOf('\t');
-      if (separator < 0) return null;
-      const sha = record.slice(0, separator);
-      const subject = commitMessageTitle(record.slice(separator + 1));
-      return sha && subject ? { sha, subject } : null;
-    })
-    .filter(Boolean);
-}
-
 /**
  * 上一次发布到本次之间的客户端相关提交。
  *
@@ -701,9 +675,8 @@ export function collectReleaseCommits(
       'git',
       [
         'log',
-        '-z',
         '--no-merges',
-        '--format=%h%x09%B',
+        '--format=%h%x09%s',
         `${previousCommit}..${headCommit}`,
         '--',
         ...paths,
@@ -713,22 +686,28 @@ export function collectReleaseCommits(
   } catch {
     return null;
   }
-  return parseReleaseCommitLog(output);
+  return output
+    .split(/\r?\n/u)
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line) => {
+      const [sha = '', ...subject] = line.split('\t');
+      return { sha, subject: subject.join('\t') };
+    });
 }
 
-/** 自动更新摘要：逐条列客户端相关改动标题，超过上限时折叠并整体截断。 */
+/** 自动更新摘要：逐条列客户端相关改动，超过上限时折叠并整体截断。 */
 export function formatReleaseNotes(
   commits,
   { limit = 12, subjectLength = 80, maxLength = 900 } = {},
 ) {
   if (!commits || commits.length === 0) return '';
-  const lines = commits.slice(0, limit).map(({ subject }) => {
-    const title = commitMessageTitle(subject);
+  const lines = commits.slice(0, limit).map(({ sha, subject }) => {
     const trimmed =
-      title.length > subjectLength
-        ? `${title.slice(0, subjectLength - 1)}…`
-        : title;
-    return `- ${trimmed}`;
+      subject.length > subjectLength
+        ? `${subject.slice(0, subjectLength - 1)}…`
+        : subject;
+    return `- ${trimmed}（${sha}）`;
   });
   if (commits.length > limit) {
     lines.push(`- 其余 ${commits.length - limit} 项客户端改动省略`);
@@ -747,21 +726,20 @@ export function collectRecentReleaseCommits({
   try {
     output = execFileSync(
       'git',
-      [
-        'log',
-        '-z',
-        '--no-merges',
-        `-n${limit}`,
-        '--format=%h%x09%B',
-        '--',
-        ...paths,
-      ],
+      ['log', '--no-merges', `-n${limit}`, '--format=%h%x09%s', '--', ...paths],
       { cwd, encoding: 'utf8' },
     );
   } catch {
     return null;
   }
-  const commits = parseReleaseCommitLog(output);
+  const commits = output
+    .split(/\r?\n/u)
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line) => {
+      const [sha = '', ...subject] = line.split('\t');
+      return { sha, subject: subject.join('\t') };
+    });
   return commits.length > 0 ? commits : null;
 }
 

apps/ai-game-creator-shell/scripts/build-release.test.mjs

@@ -645,19 +645,17 @@ test('Windows remains the default and explicit Windows overrides macOS environme
 
 test('no-bundle smoke skips version writes and manifest generation', async () => {
   const steps = [];
-  await withEnv({ AGC_UPDATE_CHANNEL: undefined }, () =>
-    buildRelease(['--no-bundle', '--target=aarch64-apple-darwin'], {
-      prepareVersion: () => {
-        steps.push('version');
-      },
-      build: (_args, context) => {
-        steps.push(context.channel);
-      },
-      generateManifest: () => {
-        steps.push('manifest');
-      },
-    }),
-  );
+  await buildRelease(['--no-bundle', '--target=aarch64-apple-darwin'], {
+    prepareVersion: () => {
+      steps.push('version');
+    },
+    build: (_args, context) => {
+      steps.push(context.channel);
+    },
+    generateManifest: () => {
+      steps.push('manifest');
+    },
+  });
   assert.deepEqual(steps, ['dev']);
 });
 
@@ -1077,17 +1075,20 @@ test('release entry forwards the built artifacts and dry-run mode to the uploade
   assert.ok(source.includes('\n  dryRun,\n'));
 });
 
-test('release notes list client commit subjects only and bound their size', () => {
+test('release notes list client commits with short sha and bound their size', () => {
   const notes = formatReleaseNotes([
     { sha: 'a5fd25f1', subject: '客户端更新切换到官方更新插件' },
     { sha: '55af6014', subject: '修'.repeat(120) },
   ]);
   const lines = notes.split('\n');
   assert.equal(lines.length, 2);
-  assert.equal(lines[0], '- 客户端更新切换到官方更新插件');
-  const truncatedSubject = lines[1].replace(/^- /u, '');
+  assert.match(lines[0], /^- 客户端更新切换到官方更新插件（a5fd25f1）$/u);
+  const truncatedSubject = lines[1]
+    .replace(/^- /u, '')
+    .replace(/（55af6014）$/u, '');
   assert.equal(truncatedSubject.length, 80, `主题应截断到 80 字：${lines[1]}`);
   assert.match(truncatedSubject, /…$/u);
+  assert.match(lines[1], /（55af6014）$/u);
 
   const many = formatReleaseNotes(
     Array.from({ length: 20 }, (_, index) => ({
@@ -1096,15 +1097,6 @@ test('release notes list client commit subjects only and bound their size', () =
     })),
   );
   assert.match(many, /- 其余 8 项客户端改动省略$/u);
-  assert.equal(
-    formatReleaseNotes([
-      {
-        sha: 'ignored',
-        subject: '提交标题\n不应展示的说明一\n不应展示的说明二',
-      },
-    ]),
-    '- 提交标题',
-  );
   assert.equal(formatReleaseNotes([]), '');
   assert.equal(formatReleaseNotes(null), '');
 });
@@ -1128,17 +1120,8 @@ test('release commits cover only client paths and skip merge commits', () => {
       path.join(directory, 'apps/ai-game-creator-shell/main.rs'),
       'fn main() {}\n',
     );
-    const commitMessagePath = path.join(
-      directory,
-      '.git',
-      'commit-message.txt',
-    );
-    writeFileSync(
-      commitMessagePath,
-      '客户端：新增更新插件接入\n补充更新插件接入的详细说明\n',
-    );
     git('add', '.');
-    git('commit', '--quiet', '-F', commitMessagePath);
+    git('commit', '--quiet', '-m', '客户端：新增更新插件接入');
 
     writeFileSync(path.join(directory, 'docs/readme.md'), '# 文档\n');
     git('add', '.');
@@ -1164,7 +1147,6 @@ test('release commits cover only client paths and skip merge commits', () => {
     const commits = collectReleaseCommits(base, 'HEAD', { cwd: directory });
     assert.ok(commits, '应能在临时仓库里收集提交');
     const subjects = commits.map((entry) => entry.subject);
-    // 标题后没有空行时，git %s 会把说明行拼进标题；摘要必须取原始首行。
     // 合并提交本身被 --no-merges 排除，但它带入的客户端改动仍然计入。
     assert.deepEqual(subjects, [
       '客户端：侧分支改动',

apps/ai-game-creator-shell/scripts/check-config.mjs

@@ -154,6 +154,7 @@ const allowedUncalledTauriCommands = [
   'steer_game_creator_agent_runtime_task',
   'write_local_agent_memory',
   'write_local_game_memory',
+  'write_local_project_file',
   // Agent 运行时会话 / 目标 / 协作命令由 native 侧与 CLI swarm 驱动，前端没有调用方。
   'archive_game_creator_agent_session',
   'clear_game_creator_agent_goal',
@@ -199,16 +200,15 @@ const allowedUncalledTauriCommands = [
   'read_agc_plugin_panel',
   'set_agc_plugin_enabled',
   // 下面这些命令的调用方只有随 Project Supervisor 前端链路一起删除的旧命令聊天入口；
-  // 现在 App 前端、工作台与策划聊天都没有接线（检查点 / 恢复 / 索引 /
+  // 现在 App 前端、工作台与策划聊天都没有接线（检查点 / 恢复 / 索引 / 导出包 /
   // 画板同步 / 素材登记 / 权限策略 / 本地草案 / 平台美术），Rust 侧只剩注册与实现，
   // `*_at` helper 仍由 Rust 用例覆盖。接回新入口还是删除属于 native 能力取舍，先按
   // native-only 登记，避免孤儿检查一直报错。
   // 预览不在本清单：`activate_local_game_preview` 已按 ADR 回接到 App 的「运行」入口。
-  // 导出试玩包同样不在本清单：发布链路（`requestGamePublish`）已把它接回
-  // DirectProject 聊天头的「发布」入口。
   'build_local_project_index',
   'control_agent_run',
   'create_local_project_checkpoint',
+  'export_local_project_package',
   'generate_local_game_draft',
   'generate_platform_art_asset',
   'import_canvas_asset',
@@ -516,7 +516,7 @@ function parseTauriHandlerCommandNames(source) {
     throw new Error('AI game creator shell Tauri handler list is missing');
   }
   return Array.from(
-    match[1].matchAll(/\b(?:[a-z][a-z0-9_]*::)*([a-z][a-z0-9_]*)\b/g),
+    match[1].matchAll(/\b([a-z][a-z0-9_]+)\b/g),
     ([, command]) => command,
   );
 }
@@ -549,12 +549,6 @@ function assertCommandNamesDisjoint(label, leftNames, rightNames) {
 }
 
 function runAppInvokeParserRegressionChecks() {
-  assert.deepEqual(
-    parseTauriHandlerCommandNames(
-      'tauri::generate_handler![plain_command, analytics::gui::capture_analytics_context,]',
-    ),
-    ['plain_command', 'capture_analytics_context'],
-  );
   assert.deepEqual(
     parseAppInvokeCommandNames(`
       invoke('direct_command', {});
@@ -1946,7 +1940,6 @@ for (const snippet of [
   '官方账号服务（固定）',
   'runtime_config.save',
   "'/run：运行自检，启动本地 HTTP 预览并载入客户端运行视图'",
-  '已载入客户端运行视图',
   'async function executeRunLocal',
   'function needsInitializedChatProject',
   "'/remember [short|long|blackboard] 内容：追加短期、长期或黑板记忆'",

apps/ai-game-creator-shell/scripts/nsis-toolset.mjs

@@ -88,21 +88,15 @@ export function resolveNsisCacheDir(
   env = process.env,
   platform = process.platform,
 ) {
-  const pathImpl = platform === 'win32' ? path.win32 : path.posix;
   const explicit = env.AGC_TAURI_NSIS_CACHE_DIR?.trim();
-  if (explicit) return pathImpl.resolve(explicit);
+  if (explicit) return path.resolve(explicit);
   // Jenkins Windows 节点以 SYSTEM 运行，ProgramData 稳定可写且不受工作区清理影响；
   // 缓存里只有待解压的原始归档，不会从该目录执行任何程序。
   if (platform === 'win32') {
     const programData = env.ProgramData?.trim() || 'C:\\ProgramData';
-    return pathImpl.join(programData, 'genarrative', 'tauri-nsis-cache');
+    return path.join(programData, 'genarrative', 'tauri-nsis-cache');
   }
-  return pathImpl.join(
-    os.homedir(),
-    '.cache',
-    'genarrative',
-    'tauri-nsis-cache',
-  );
+  return path.join(os.homedir(), '.cache', 'genarrative', 'tauri-nsis-cache');
 }
 
 /** 与 tauri-bundler 相同的镜像开关语义，便于构建机绕过不可达的 GitHub。 */

apps/ai-game-creator-shell/scripts/nsis-toolset.test.mjs

@@ -7,7 +7,6 @@ import { test } from 'node:test';
 import JSZip from 'jszip';
 
 import {
-  defaultAppRoot,
   ensureNsisToolset,
   extractNsisArchive,
   NSIS_ARCHIVE_ASSET_NAME,
@@ -24,7 +23,10 @@ import {
   verifyNsisToolset,
 } from './nsis-toolset.mjs';
 
-const appRoot = defaultAppRoot();
+const appRoot = path.resolve(
+  path.dirname(new URL(import.meta.url).pathname),
+  '..',
+);
 const silentLogger = { log() {}, warn() {} };
 
 function createSandbox() {
@@ -96,14 +98,6 @@ test('NSIS 工具链目录与 Tauri useLocalToolsDir 配置保持一致', () =>
 });
 
 test('缓存目录默认落在工作区之外并支持环境变量覆盖', () => {
-  assert.equal(
-    resolveNsisCacheDir({ AGC_TAURI_NSIS_CACHE_DIR: 'D:\\agc-cache' }, 'win32'),
-    'D:\\agc-cache',
-  );
-  assert.equal(
-    resolveNsisCacheDir({ ProgramData: 'D:\\ProgramData' }, 'win32'),
-    path.win32.join('D:\\ProgramData', 'genarrative', 'tauri-nsis-cache'),
-  );
   assert.equal(
     resolveNsisCacheDir(
       { AGC_TAURI_NSIS_CACHE_DIR: '/tmp/agc-cache' },
@@ -111,9 +105,13 @@ test('缓存目录默认落在工作区之外并支持环境变量覆盖', () =>
     ),
     '/tmp/agc-cache',
   );
+  assert.equal(
+    resolveNsisCacheDir({ ProgramData: 'D:\\ProgramData' }, 'win32'),
+    path.join('D:\\ProgramData', 'genarrative', 'tauri-nsis-cache'),
+  );
   assert.ok(
     resolveNsisCacheDir({}, 'linux').endsWith(
-      path.posix.join('.cache', 'genarrative', 'tauri-nsis-cache'),
+      path.join('.cache', 'genarrative', 'tauri-nsis-cache'),
     ),
   );
 });