5867 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
suzmii	eb7349ef3d	test(游戏共创): 新增收藏（收录）端到端验收脚本 ... - 新增 scripts/check-game-distribution-collection-e2e.mjs（约 750 行）：真实 HTTP 验收收藏链路， 复用 lineage 脚本的发布链路 helper（脚本头注释逐条标注出处），覆盖 9 组共 46 条断言： · 幂等与「只一行」：两次不同键都成功（replayed=false）；同键重放 replayed=true；两种情况都断言 my-collections 长度=1 且该作品只出现一次（无收藏计数接口，按工单允许的列表去重与长度证明） · 同键不同请求：换作品 → 409（「幂等键对应的请求摘要不一致」）；**换用户 → 200 新收藏**，与 api-server handler 注释「换用户也是 409」不一致（收据键含 user_id，模块侧注释与实测一致）， 脚本按实测断言并在 NOTE 与报告里标注 · DELETE 幂等：已收藏 / 未收藏 / 从未收藏且未公开 三种情形都 200 {collected:false} 且不发 replayed · 鉴权与缓存：三条路由未登录都 401 且带 Cache-Control: no-store（证明挂载而非 404/405）； 已登录但缺 Idempotency-Key 的 PUT → 400 · 状态门：草稿 PUT → 409「作品状态不允许收藏（未公开或已软删除）」（含「状态」不含「不存在」， 不泄露未公开作品存在性）；不存在的 gameId → 404「作品不存在」 · 下架 → 重新公开：收藏后下架读侧过滤掉该作品，重新公开（新版本审核通过）后又回到列表且仍只一行 （证明下架不删行、只在读侧过滤） · 公开详情 collected：匿名 23 键无 collected；已登录 24 键恰好多 collected=true； 去掉该键后与匿名逐字段一致；公开目录同作品条目与匿名详情键集合与取值完全一致 · 跨用户隔离：A 收藏后 B 的列表不含该作品、B 的 collected=false - package.json：新增 npm script check:game-distribution-collection-e2e - 实测：本地 dev 栈（SpacetimeDB 3110 / api-server 8188）46 项 46 PASS / 0 FAIL / 0 SKIP	2026-10-06 01:30:53 +08:00
suzmii	785152f70b	网页端收藏：作品详情页收藏切换 + 我的收藏页签 ... - 客户端：新增 setGameCollection（PUT 带 Idempotency-Key；DELETE 不带）与 listMyCollections（{games,nextCursor}，条目形状与公开目录逐字一致，可复用同一套卡片）；getGame 返回类型放宽为 GameDistributionGameWithCollection，collected 为可选 - 详情页：在动作区（「立即玩」旁，而不是共创信息卡——那张卡讲改编关系）新增收藏切换。三态严格区分：collected=true → 「已收藏」点击取消；collected=false → 「收藏」点击收藏；**缺字段（匿名 / 无效 token 被按匿名处理）绝不落成「未收藏」**，按钮 title 标注「登录后可收藏」，点击走既有登录门禁且不发请求 - 乐观更新 + 回滚：先切换本地态，失败回滚到服务端投影并用服务端 message 提示（role=status）；成功以服务端返回的 collected 为准 - 广场卡片：卡片本身没有操作区，按「没有就别硬塞」不动 - 我的收藏：落在 /games/mine 的页签（「我的作品」/「我的收藏」）。理由：两者都是登录后的个人内容、该页已有登录门禁；且不需要新路由，避免牵动「路由表 + nginx×3 + Pingora allowlist」这组必须同批登记的清单。复用公开目录同一套卡片（shared 的 GameCard + GameCover），空态/失败重试/登录态照既有写法 - 分页按「将来会有 cursor」的形态写：读 nextCursor，非空才渲染「加载更多」并在点击时追加；服务端当前恒为 null，不伪造分页数据 - 文案统一「收藏 / 已收藏」（不用需求文档旧词「收录」） - 测试：详情页收藏四例（已收藏→取消 / 未收藏→收藏 / 缺字段走门禁且零请求且不渲染已收藏 / 失败回滚+服务端文案）；我的收藏两例（空态且默认页签不预取 / 列表渲染+卡片点击跳详情+无 cursor 不出现「加载更多」）	2026-10-06 01:18:45 +08:00
suzmii	4b1f24a8fc	feat(游戏共创): 收录（收藏）契约与文档同步（块 3/3） ... - `shared-contracts`：新增 `GameDistributionCollectionState { collected, replayed: Option<bool> }` 承载 PUT/DELETE 共用形状（PUT 才发 `replayed`）；既有 `GameDistributionGameSummary` 增 `collected: Option<bool>`（公开详情登录时才带）——该类型只被 api-server 测试与 `GameDistributionListResponse` 引用，加字段不影响任何现有发送方 - `packages/shared` TS 镜像同步（`{ collected: boolean; replayed?: boolean }` 与 `GameDistributionGame.collected?: boolean`），并按既有约定登记进 `scripts/check-game-distribution-dto-parity.mjs`（PAIRS + 手拼响应构建器）；注意 `json!` 字面量里不插注释行（parity 脚本抓顶层键时不剥注释，这个坑今天踩过一次） - 技术方案：`§2.4` 入口矩阵补「收藏按钮 / 我的收藏（登录）与我的作品页同行风格」；`§3.4` 接口表补三条路由（含 404/409 语义、PUT 要求幂等键而 DELETE 不要求及理由、`my-collections` 只含公开作品且不删行）与公开详情 `collected` 的可见性口径；`§7` 把「收录/收藏」从范围外移除并标注已纳入落地 - 数据契约表目录：新增 `game_distribution_collection` 小节（主键确定性、两个索引、为什么不删行、为什么不建唯一索引），供 `check:spacetime-schema` 守卫通过（94 tables） - 门禁：DTO parity 0（**49 组** Rust/TS 一致，较本轮前 +7）；`check:spacetime-schema` 0（94 tables，对照新 merge-base `51cb05f4`）；`check:encoding` 0；`git diff --check` 0	2026-10-06 01:14:05 +08:00
suzmii	cc7d214136	feat(游戏共创): 收录（收藏）接口：三条路由 + 公开详情 collected（块 2/3） ... - 新增 `collections` 路由组（整组 `require_bearer_auth` + `add_no_store_response_headers`，用户态读不会被任何缓存复用）： · `PUT /api/game-distribution/games/{game_id}/collection` → `{ collected: true, replayed }`，要求 `Idempotency-Key`（沿用既有 `idempotency_key(&headers)?`）；同键重放 `replayed=true`，同键不同请求（摘要绑定 `(userId, gameId)`）→ 409，重复收藏（不同键）只留一行且成功 · `DELETE .../collection` → `{ collected: false }`，**不要求 Idempotency-Key**：按确定性主键删除本就幂等（不存在也算成功），没有「重放 vs 新意图」可区分；也**不要求作品仍公开**（下架后仍可清理） · `GET /api/game-distribution/my-collections` → `{ games: [<public_game_payload>…], nextCursor: null }`，逐条复用既有公开目录的组装方式，只含当前公开可读作品 - 公开详情 `GET /games/{game_id}` 增量：**已认证**返回 `collected: true|false`；**匿名不返回该键**（选这种口径的理由：`false` 会把「未登录」说成「没收藏」，客户端无法区分就会渲染出错误的按钮态）；携带无效/过期 token 时按**匿名**处理（沿用 `record_game_play` 的取舍——公开详情匿名可读，不该因此掉 401），因此该响应与纯匿名逐字节相同（单测断言）。实现复用既有 `auth::optional_access_token_from_headers`（`auth.rs:223`），**没有自造 extractor**；值来自新 procedure（真实投影），**未改动既有公开快照契约** - **共享缓存核实（硬性项）**：公开详情所在的 `public_games` 路由组带 `add_no_store_response_headers`；`app::build_router` 只做 merge/背压/错误归一化/request_id/tracing/`attach_request_context`，**没有任何响应体缓存或预渲染**；本模块唯一进程内缓存是 `RELEASE_PACKAGE_CACHE`（键 = OSS 对象键、值 = 发行包字节），与 per-user JSON 无关。结论：**该路径无共享缓存，不需要绕开** - 错误码：作品不存在 → 404；未公开/已软删除/无当前公开版本 → 409（文案「作品状态不允许收藏（未公开或已软删除）」刻意含「状态」而不含「已被删除」，以命中既有映射的 409 分支而非 404 分支） - 测试（本文件内，新增 5 条）：三条路由无 Bearer → 401 且 `no-store`；404/409/摘要不一致 409 的映射；摘要绑定 `(user, game)` 的幂等隔离；PUT/DELETE 的载荷形状；公开详情「匿名无 collected 且与目录负载逐字节相等、登录时 Some(true)/Some(false) 各出现且只多这一个键」 - 门禁：`cargo test -p api-server game_distribution` **70 passed**（含新增 5 条）；`cargo check --all-targets` 0	2026-10-06 01:13:37 +08:00
suzmii	77c30bb7b2	feat(游戏共创): 收录（收藏）数据模型与绑定（块 1/3） ... - `spacetime-module`：新增表 `game_distribution_collection`（`collection_id` 主键、`user_id` / `game_id` 各具名 btree 索引、`created_at`）。**防重靠确定性主键** `collection_id = "{user_id}:{game_id}"`（与 `profile_save_archive.archive_id` 同一写法）：同一 (用户, 作品) 在结构上不可能有第二行，不依赖「事务里先查后写」（那种写法只在单写者假设下成立，分片/并发时两个事务都可能先查到不存在再各写一行）；正因主键即约束，**不需要**再建 `(user_id, game_id)` 唯一索引，两个索引只服务两个读取方向 - 下架（未公开/软删除）**不删除**收藏行：收藏是用户态事实，读侧投影时才按当前公开性过滤，作品重新公开后同一行自动回到列表（注释写明） - 新增动作常量、4 个输入类型、3 个结果类型、3 个事务（collect / uncollect / list）+ 读态 helper + 4 个 procedure；`uncollect` 按确定性键删除且**不要求作品仍公开**（下架后拒绝取消会给用户留下清理不掉的脏行）；`list` 走 `user_id` 索引 + 既有 `public_game_distribution_snapshot` 投影，只含当前公开可读作品 - 新增 `module-game-distribution/src/collection.rs`：两条纯函数（`game_distribution_collection_id`、`game_distribution_collection_visible`）+ 单测——后者用「同一行、四种可见性输入」直接钉住「已收藏 → 下架 → 列表不含 → 重新公开 → 列表又含」这条链路，不必起真库 - `migration.rs`：新表进白名单并补中文注释 - `spacetime-client`：record + 3 个 mapper + 4 个方法 + 2 个 RecordInput，并按既有做法只保留 `module_bindings/game_distribution*`（13 个新文件）与 `module_bindings.rs` 的生成改动、还原其余 rustfmt 漂移 - 门禁：wasm build 0；`cargo check --all-targets` 0；`cargo test -p module-game-distribution` 75 passed；`cargo test -p spacetime-module` 273 passed / 1 ignored（含 4 条新事务结构断言）；`cargo fmt --all -- --check` 0	2026-10-06 01:13:08 +08:00
suzmii	c3030eddba	chore(游戏共创): 收尾清掉最后一条旧口径注释（成品包只作可玩参考 → 生成脚手架 + 参考副本）	2026-10-06 01:06:20 +08:00
suzmii	f94946ef8e	feat(游戏共创): 注册并处理 Fork 深链 genarrative://fork?gameId=… ... 冻结约定：`genarrative://fork?gameId=<gameId>`，同时接受 `genarrative://fork/<gameId>`。 方案（用官方两个插件，不手搓单实例与注册表）： - `tauri-plugin-single-instance`（开 `deep-link` feature）**第一个注册**：Windows/Linux 上深链是 「带 URL 启动第二个进程」，该插件把第二个实例的 argv 转交给已有实例，并（feature 生效时） 交给 deep-link 插件发事件——否则用户点第二次链接会再开一个窗口。macOS 上它用 Unix socket 做同样的收口（系统本身也只会有一个 .app 实例）。 - `tauri-plugin-deep-link`：`tauri.conf.json > plugins.deep-link.desktop.schemes = ["genarrative"]`。 · macOS：打包器按该配置往 `Info.plist` 注入 `CFBundleURLTypes`（插件 `config.rs` 里那句 `// Used in tauri-bundler` 是代码级证据），运行时由系统把 URL 交给已运行的 .app。 · Windows：运行时 `register_all()` 写 `HKCU\Software\Classes\genarrative`（`URL Protocol` 标记 + `DefaultIcon` + `shell\open\command`，不需要管理员）；安装器侧同样按该配置注册。 · Linux：运行时写用户级 `applications/<exe>-handler.desktop` 并调 xdg-mime（AGC 未以此平台分发， 但仍走同一条运行时路径）。 - 冷启动：插件在插件初始化阶段就解析 argv 并暂存，而应用 `setup` 晚于插件，因此 `initialize_fork_deep_link` **先取 `get_current()`**、再 `on_open_url` 订阅后续链接（漏了前者会 丢冷启动那一次）。 - 收到 URL 后：聚焦主窗口（unminimize + show + set_focus）→ 发 `game-fork-deep-link` 事件 `{ gameId | message }` → 渲染层把请求存进 store 并切回首页；**不自动下载**，用户按 「Fork 到我的项目」才走与手工输入完全相同的提交路径。正停在项目工作区时不强行切走 （避免把用户从进行中的项目里踢出来），请求留在 store 里等用户回到首页。 - 非法链接：解析出可读原因（空链接 / 非 genarrative 方案 / 非 fork 形式 / 缺 gameId / gameId 不合法） 一并聚焦窗口并交给渲染层展示，不做静默失败。 测试：`fork_game_id_from_deep_link` 的合法（两种形式、大小写、多余参数、game_id/id 别名）与 非法（空、错方案、错形式、缺 gameId、`../escape`、URL 编码斜杠、非 URL）各一组；`gameId` 形状 判据与取件路径共用（`is_safe_fork_game_id`）；TS 侧覆盖载荷解析、订阅映射、深链预填后**不自动 下载**、非法链接展示原因且不请求。	2026-10-06 01:05:04 +08:00
suzmii	96309c895c	新增「原版与二创对比」页与路由登记（含 nginx×3 + Pingora allowlist） ... - 新增路由 /games/compare（stage game-compare）：STAGE_ROUTE_ENTRIES + SelectionStage 类型 + 壳层 lazy 引入/导航回调/渲染分支 + 页面标题，四处同批登记 - 三份 nginx SPA allowlist（deploy/nginx/genarrative.conf、deploy/nginx/genarrative-dev-http.conf、deploy/container/nginx.conf）与 Pingora MAIN_SPA_PATHS 同步放行 /games/compare（保持既有排序）：check:nginx-spa-routes 18 SPA routes、check:pingora-route-parity 均绿 - 对比页左右两侧各自取数与降级：任一侧不可读（不存在/未公开/已软删除）或没有可玩版本时只降级那一侧，另一侧照常；显示标题、作者与代际；桌面左右并排、窄屏上下堆叠 - iframe 复用游玩页同一份嵌入：抽出 GamePlayFrame（sandbox=allow-scripts、allow=fullscreen、referrerPolicy=no-referrer、.game-player-frame），游玩页改为渲染它，不再存在第二套嵌入逻辑 - 入口：二创作品详情页在存在父作品时给出「与原版对比」；族谱节点仅在其父作品可见时给出同一入口 - 测试：对比页两侧渲染与 iframe 复用属性、单侧降级后另一侧照常；详情页入口（有/无父作品）；族谱节点入口（父可见才出现）；路由与标题登记；壳层「族谱节点→对比页」导航与对比 stage 渲染 - 顺手：按 eslint 自动修复两个文件的 import 排序	2026-10-06 00:56:31 +08:00
suzmii	4cf00ac07d	refactor(游戏共创): Fork 口径收敛为「把整个工程复制到你的项目里继续改造」 ... 产品裁定：不再对外解释「可玩参考 + 素材 / 不能一键复刻工程 / 需自建合规工程」那套口径。 统一一句话：**Fork = 把整个工程复制一份到你的项目里继续改造（与 git fork 同理）**，动作名统一 叫 Fork。必要告知只保留一句：开启共创并上传工程时，整个工程（含素材与文档）会对他人可见， 且不可撤销。 - 入口（首页）：`从平台作品 Fork` + 角标 `Fork`，说明压成一句「把平台上的作品整个工程复制到 你的项目里继续改造（像 git fork）。输入要 Fork 的作品 ID 或作品链接即可。」；按钮 `Fork 到我的项目`、加载态「正在 Fork：下载、校验并创建项目…」；成功态只留 「已创建项目《X》，Fork 自平台作品 <gameId>（来源已记录在 …fork-source.json）」， 删掉按取件形态分岔的长句。 - 发布面板：授权区只留一句「授权非「禁止共创」即允许他人 Fork 你的作品；开启共创并上传工程时， 整个工程（含素材与文档）会对他人可见，且不可撤销。」；确认项压成一句 「我已确认工程里没有不愿公开的内容，同意随本次发布公开整个工程（含素材与文档）；一经发布 不可撤销。」，其后一行写「默认已勾选，可随时取消；不勾选则本次不上传工程源码。」 - 错误与进度文案：取件失败四态改为 Fork 措辞（`无法 Fork` / `该作品当前不能被 Fork（未公开、 已下架或没有公开版本）`），读取/下载/响应类错误改为 `读取 Fork 信息失败` / `下载 Fork 内容失败`， 超限提示改为「Fork 内容超过客户端下载上限，无法完成」；「未上传工程源码」提示改为 「他人 Fork 时只能拿到平台已发布的成品」；默认项目名前缀 `改编项目` → `Fork 项目`； 记录标签 `项目改编来源记录` → `项目 Fork 来源记录`。 - 实现事实（成品包形态的脚手架 + `reference/<gameId>/`）保留在 Rust 文档注释里，不再作为对外 表述；`collect_project_bundle_files` 等实现注释不动。 - 测试：入口用例改为断言一句话口径与「Fork 自平台作品」并断言旧的解释性表述已消失；面板用例 断言新的简短告知与「默认已勾选，可随时取消；不勾选则本次不上传工程源码」；错误文案断言同步。	2026-10-06 00:55:53 +08:00
suzmii	928fb0e616	Fork 入口主路径改为唤起客户端（genarrative://fork），未失焦才降级为手动路径 ... - 新增 src/components/game-distribution/gameForkProtocol.ts 收口唤起：协议 genarrative://fork?gameId=<id>，用顶层 location.href 赋值（协议未注册时桌面浏览器只是「什么都不发生」，不会把页面导航走也不会被弹窗拦截，失败可观察），并导出降级等待窗口 FORK_LAUNCH_FALLBACK_DELAY_MS=1200 - 详情页点击「Fork 这个作品」直接唤起；失焦（window blur）或页面转入后台（visibilitychange=hidden）都视为客户端接手 → 只给状态反馈，不出降级面板 - 未失焦 → 经过降级窗口后展示手动面板（作品 ID / 完整作品链接 / 复制按钮 / 客户端指引 / 一句话告知） - 移动端与未知平台不尝试唤起（协议未注册时移动浏览器行为不可控），直接给手动路径 - 每条路径都有可观察反馈：正在唤起 / 已唤起 / 没有检测到客户端 / 当前设备无法直接唤起；定时器与失焦监听的清理覆盖卸载、重复点击、超时三条路径 - 顺手修掉同文件一个既有竞态：作者昵称补查的断言紧跟 findByRole（effect 尚未发出请求）导致偶发 0 次调用、让整份文件的门禁随机变红，改为 waitFor 等待	2026-10-06 00:50:28 +08:00
suzmii	b6fe63b551	文案收敛：动作名统一 Fork，去掉「可玩参考 + 素材 / 不能重新发布」那套表述 ... - 动作名统一：「改造这个作品」→「Fork 这个作品」，「登录后可改造」→「登录后可 Fork」 - 面板指引改为「在陶泥儿客户端里打开「从平台作品开始创作」，粘贴下面的作品 ID 或作品链接。」 - 对外口径统一为「Fork = 把整个工程复制一份到你的项目里继续改造（与 git fork 同理）」，并保留一句话必要告知：整个工程（含素材与文档）复制后对他人可见，且不可撤销 - 删除「成品包只能可玩参考 + 素材」「不能直接再次发布」「参考产物在 reference/<作品ID>/」等展开说明（冻结口径 1） - 测试同步：断言新文案与「不可撤销」告知，测试名与注释不再出现「改造」	2026-10-06 00:48:23 +08:00
suzmii	bdcefe91d1	Merge remote-tracking branch 'origin/master' into feat/game-fork ... # Conflicts: # deploy/container/nginx.conf # deploy/nginx/genarrative-dev-http.conf # deploy/nginx/genarrative.conf # server-rs/crates/api-server/src/modules/game_distribution.rs # src/components/game-distribution/GameDetailPage.tsx # src/components/game-distribution/GameDistributionPages.test.tsx # src/components/platform-entry/PlatformEntryActiveFlowShell.tsx	2026-10-06 00:19:40 +08:00
lhk229	51cb05f418	补充创作者主页与关注粉丝工程文档 (#638) ... 本 PR 补齐创作者主页与关注粉丝功能的产品合同和工程设计，供后续按里程碑实施；本次只修改文档。 桌面导航第四项进入自己的创作者主页，“我的”移到第五项。游戏详情可进入作者主页并关注/取消关注；自己或他人的关注、粉丝列表均公开可查看，点击用户头像或昵称可进入其主页。本人支持取消/重新关注、回关和移除粉丝，并明确两个关注方向独立。 工程设计包含关系表与 DTO、认证和事务边界、跨页状态同步、共享组件、深链及验收要求，拆分关系查询和页面交互两个里程碑。按用户要求，游戏列表沿用最多 48 项的现有限制，不增加游戏目录分页改造。 验证： - 已合入最新 origin/master（21c79f54a）；共享决策记录冲突保留双方新增内容。 - npm run check:encoding 通过。 - npm run check:doc-index 通过。 - git diff --check 与暂存差异检查通过。 - 相对 master 仅六份文档发生变化；没有业务代码或 schema 修改，未执行业务测试或部署。 Reviewed-on: #638 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-10-05 22:05:11 +08:00
suzmii	96859666ff	Merge pull request 'AGC 运行画面点选：canvas 玩法上识别 Phaser 4 / three.js 的已登记素材（#612）' (#624) from feat/agc-runtime-picking-engines into master ... Reviewed-on: http://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/624	2026-10-05 19:16:03 +08:00
suzmii	fa42cdb139	Merge pull request '修复在线游玩加载体验：加载期黑屏/空白与发行资源传输开销（#636）' (#639) from fix/game-play-loading into master ... Reviewed-on: http://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/639	2026-10-05 19:13:44 +08:00
suzmii	df221f4eb9	收口评审 P2：点选条款限定引擎档、对象名上限入边界、素材 id 格式写入 skill ... - 功能说明第 8 条「命中区域裁剪在画布内」限定为引擎档，并说明 DOM 档仍是元素矩形；证据表对应行同步对齐 - 功能说明「边界与非目标」新增一条：引擎档对象名超过 40 字符按取不到处理（有意保留），宿主侧标签上限另为 120 - SKILL.md「运行画面点选契约」第 3 条补一句：素材 id 不含空白与路径分隔符（localAssetId 由客户端生成） - skill-pack 指纹同步（agc-web-game-development version 2026-08-26.42 与 sha256）	2026-10-05 18:31:59 +08:00
suzmii	364b1aa342	Merge remote-tracking branch 'origin/master' into feat/agc-runtime-picking-engines ... - 冲突解决（3 处）： - agc-game-production-workflow/SKILL.md：双方都保留——第 4 条用本分支版本（含「运行画面点选契约」指针），第 5 条用 master 的新构建验证口径 - agc-skills/manifest.json：先取 master 侧，再用 `agc:skill-pack:sync` 按合并后内容重新生成 version 与指纹（2026-08-26.41），`skill-pack:check` 通过 - pitfalls.md：两侧新增条目全部保留（按日期倒序：本分支 10-05 / 10-04 条目在前，master 的 10-04 / 10-03 条目紧随，未改动任一方内容） - 无冲突但人工核对：`agc-web-game-development/SKILL.md`（本分支「运行画面点选契约」小节 + master 内容都在）、 `index.tsx`（我们的 `handleRuntimeInspectSelection` 回调体逐字不变，master 新增内容都在） - 桥脚本 sha256 未变（9513020cfffa79128fb6355d44cdaabe666eefecbd96b7e807b15d2c4601bf76），真机证据对应字节不变	2026-10-05 18:25:49 +08:00
suzmii	d7c4f82d7d	修复自查发现的门禁与体验问题：格式、超时态语义、压缩 CPU 边界 ... - 新增 Rust 测试补齐 cargo fmt；ESLint 按仓库约定收口：常量与解析函数拆到 platformGameLoadingSurfaceModel.ts，删除 GAME_PLAY_STARTUP_TIMEOUT_MS 常量别名（测试直接用共享常量） - 共享加载面新增 stalled：宿主判定等待不再推进时停掉进度动画并把 aria-busy 置回 false（去掉与 role=status 重复的 aria-live） - 后台试玩超时时传入 stalled，避免「一边转圈一边说超时」 - Accept-Encoding 权重参数名改为大小写不敏感（RFC 9110 §12.5.3），GZIP;Q=0 视为拒绝并补用例 - 发行资源压缩分级：≥2 MiB 改用 level 1（zlib 端实测约 1/3 耗时、压缩比差约 3%），小文件仍用 level 6 - 文档：主规范补压缩与条件请求契约（并写明 60 秒窗口与撤销窗口不放宽）、nginx README 修正 Pingora 压缩关闭时的口径、pitfalls 补 CPU 边界与措辞修正	2026-10-05 18:02:48 +08:00
suzmii	126fb7bc06	test(游戏共创): 两个浏览器 e2e 的登录等待抗冷启动（Vite 首次编译） ... - rebase 到 origin/master 后的第一次实跑里，lineage 与（同源的）fork 脚本在浏览器段都卡在 `page.waitForSelector('.platform-account-entry', { timeout: 120_000 })` 并超时： Vite dev server 重启后首次导航要现编译整张模块图，rebase 引入大量新代码时首屏会超过 120s。 证据：两次运行都在该行超时退出；随后用 Playwright 直接探针（同一 URL）页面正常渲染、 `.platform-account-entry` count=1、无 pageerror（仅两条未登录态 401 的资源错误）， 紧接着再跑同一脚本即 99/99 全绿。 - 修法：登录等待改成 240s + state:attached，并在超时后重载一次再等（避免把「开发服务器还没编译完」 误判成页面坏了）。两处改动逐字相同，lineage 与 fork 脚本各一处。 - 实测（HEAD 3ae0d129e，固定端口栈 3110/8188）：lineage 99/99、fork 48/48、project-bundle 72/72； 三条只读门禁 policy-parity / dto-parity / spacetime-schema 均 exit 0。	2026-10-05 17:52:16 +08:00
suzmii	05cf5b9547	docs(游戏共创): 修掉 §3.5.2 里那处嵌套加粗 ... - `docs/【技术方案】游戏共创与作品Fork-2026-10-03.md:362`：`- **服务端复核（已落地，**不信任客户端**）**：` → `- **服务端复核（已落地、不信任客户端）**：`（去掉内层多出的一对 `**`） - 之前改不掉的原因搞清楚了：edit 工具的模糊匹配按**整行**比对，我先前传的是该行前缀（该行还有 300+ 字符），相似度自然只有六七成；这次把**整行**（429 字符）作为 old_string 即一次命中。渲染上本来就是连续加粗，本次只是源码观感与「别让人以为漏了个闭合标记」 - 门禁：check:doc-index 248 份 OK；check:encoding 5305 files OK；git diff --check 0	2026-10-05 17:44:56 +08:00
suzmii	3ae0d129ef	test(游戏共创): 一致性门禁把内容嗅探与 magic bytes 纳入比对（补最后一处规则空白） ... - `scripts/check-project-bundle-policy-parity.mjs` 新增第 4 维：**凭据内容嗅探与嵌套包 magic bytes**。复核指出这两套「换名字也拦得住」的规则只靠常量表表达，过去门禁对 `sniff|PEM|AKIA|magic|secret` 零命中（只有看得见的规则才有守卫），本次补齐： · `SECRET_CONTENT_TEXT_EXTENSIONS` / `SECRET_CONTENT_SIGNATURES`（字符串数组集合相等）、`SECRET_CONTENT_MAX_SNIFF_BYTES` / `NESTED_ARCHIVE_SNIFF_BYTES`（整数相等）、`SECRET_AWS_ACCESS_KEY_PREFIX` / `PEM_PRIVATE_KEY_LINE_PREFIX` / `PEM_PRIVATE_KEY_MARKER`（字符串逐字相等）——新增 `rustStringConst` helper 抓 `&str` 常量 · `nested_archive_format` 里的 `b"..."` magic 字面量按「服务端 ⊆ 客户端」比对（客户端可以先拦、不能漏拦），并用新的 `byteStringLiterals` helper 抽取；两侧空集合一律 throw - **「故意改一侧会红」已验证（两处，均已原样恢复）**：① 从客户端 `BUNDLE_FORBIDDEN_PATH_CHARS` 去掉 `'?'`/`'*'` → 报两条「路径段禁止字符…客户端没有」；② 从客户端 `SECRET_CONTENT_SIGNATURES` 去掉 `ghp_` → 报「嗅探规则不一致：服务端 …=ghp_|github_pat_|…，客户端 …=github_pat_|…」 - 文档 §3.5.2 与 §5.2 同步门禁的四个覆盖维度（目录/前缀/后缀/全名 + 上限、路径形状、内容嗅探特征表、magic bytes），并把 §5.2 的门禁行从「P1-a」扩为「P1-a + 嗅探维度」 - 门禁：`check-project-bundle-policy-parity` 0（服务端 51 条规则全被客户端覆盖；嗅探：`ghp_/github_pat_/xoxa-/xoxb-/xoxp-` + `AKIA` + PEM 标记；magic：7z / PK / Rar! / gzip / ustar；窗口 512 字节两侧一致）；`check:doc-index` 248 份 OK；`check:encoding` 5305 files OK；`git diff --check` 0	2026-10-05 17:42:46 +08:00
suzmii	15024dab0a	docs(游戏共创): M2b 证据表与里程碑改为冻结点的实测数字（含补强证据与已知留白） ... - 技术方案 §5.2 三处过期数字按**自己去代码里数一遍**的结果改：校验器单测 16 → **19**（`project_bundle::tests`）、模块总测 69 → **73**、e2e 由「46 项 46 PASS」改为「**51 个 `check(` 调用点**」（复核另按 72 条断言计，差值来自同一 `check` 内的多条子断言）；「`package.rs` 零改动」改为「已同批补强（读取层按声明封顶 + 压缩比分母改为条目压缩字节，+70/−4）」；客户端行补「打包器 **24 条单测**、上传前按 `max_archive_bytes` 预检、定向 `cargo test -- project_bundle` **24 passed**」 - 技术方案 §5.2 新增四行：**校验器对抗性补强（P0-a/b/c）**（凭据目录/前缀/后缀/全名 + 小文本内容嗅探、嵌套包扩展名并集 + magic 嗅探、读取层封顶、新错误变体 `CredentialDirectoryNotAllowed` / `SecretContentDetected`）、**执行级交叉证据（P1-b）**（dev-dependency 交叉测试）、**一致性门禁路径形状维度（P1-a）**（含「故意破坏会红」实测）、**已知留白** - 里程碑：`前置依赖 ②` 里「客户端预检属待办」改为**已完成**并给出代码位置（`write_project_bundle_zip` 内 `bytes.len() > limits.max_archive_bytes` 失败关闭）；证据行与验收项重数、并补齐补强后的新增规则；新增「已知留白」条目（`.bz2`/`.xz`/`.zst`、`*.db`/`*.sql`、`.gcloud`/`.azure`/`.password-store`、CP437 条目名与 `external_attributes == 0`、峰值内存未量测、内容嗅探误报率无实测） - 本块在 rebase 之后完成，基线为新的 merge-base `21c79f54a` - 门禁：`check:doc-index` 248 份 OK；`check:encoding` 5305 files OK；`git diff --check` 0	2026-10-05 17:41:11 +08:00
suzmii	df43ffd05a	test(游戏共创): 工程源包 e2e 补对抗用例（路径/凭据/嵌套包/符号链接/声明说谎） ... - scripts/check-game-distribution-project-bundle-e2e.mjs 新增 A7 对抗段（脚本内自带裸 ZIP 写手， 可逐字节控制条目名、unix mode 与 central directory 声明值），逐条断言 422 + details.reason： · A7-1 路径穿越：foo/../bar、/etc/passwd、C:/evil.txt、a\..\b、./x、a//b → InvalidPath · A7-2 路径形状：a/secret.、a/secret（尾随空格）、src/a?.ts、a*b.ts → InvalidPath · A7-3 大小写变体：Node_Modules/… → DependencyDirectoryNotAllowed；.GIT/HEAD → VersionControlDirectoryNotAllowed；.AGENT/x → LocalStateDirectoryNotAllowed · A7-4 符号链接条目（external attrs=0o120777）→ SymlinkNotAllowed · A7-5 嵌套包改名 deps.dat（zip magic）→ NestedArchiveNotAllowed · A7-6 凭据：.aws/credentials、.ssh/id_ecdsa → CredentialDirectoryNotAllowed；.htpasswd、service-account-prod.json、terraform.tfstate、app.p8 → SensitiveFileNotAllowed · A7-7 内容嗅探：无扩展名文件里的 PEM 私钥块 → SecretContentDetected · A7-8 声明说谎：STORE 条目声明 1 字节、实际 4096 字节 → ReadFailed（失败关闭；非内存量测） · A7 收尾：全部拒绝后该版本仍 bytes=0/sha256 空；对照包（.dat/文本/无扩展名/PNG）200 不被过度拦截 - 修正一处我此前的错误判断：`./x`/`a//b` 并非「被 zip crate 归一化后放行」，而是被校验器自身的 路径形状检查（空段/`.`）拒为 InvalidPath（zip-2.4.2 types.rs:537-555 只拒 NUL/根/`..` 逃逸， 且返回未归一化原串）；脚本 NOTE 已按实测与源码改正，两条也改为严格 422 断言 - 实测：本地 dev 栈（SpacetimeDB 3110 / api-server 8188）72 项 72 PASS / 0 FAIL / 0 SKIP； 同栈回归 lineage-e2e 99/99（真实发行包上传，覆盖 package.rs 读取封顶改动）与 fork-authorization-e2e 48/48	2026-10-05 17:30:50 +08:00
suzmii	88368d0418	test(游戏共创): 一致性门禁补「路径形状」维度，并同步校验器文档 ... - `scripts/check-project-bundle-policy-parity.mjs` 新增第 3 维：服务端 `normalize_archive_path` 的拒绝形状必须被客户端打包器的三个常量逐 token 覆盖——**哨兵段**（`.` / `..`）与**路径段结尾字符**（空格 / 点）分别用 `rustStringArray` / `rustCharArray` 抽取，**路径段禁止字符**同时抓 `.contains('x')` 与 `matches!(expr, 'a' | 'b')` 两种写法；再单独钉「两侧都必须显式拒 `/` 开头与 `\`」两条独立分支（它们靠常量表覆盖不到）。**空集合一律 throw**，沿用既有「抽不到不许当绿灯」的写法 - 修掉我自己在第一版里写错的两处（由补强过程中的实测发现，并已用临时副本验证修法）：① `BUNDLE_FORBIDDEN_PATH_SEGMENTS` 是 `&[&str]` 而非 `&[char]`，须用 `rustStringArray`（`".."` 也无法用 char 字面量表达）；② 反斜杠分支的正则写成了 4 个字面反斜杠，而源码是 `contains('\\')`（2 个），已改为 `/contains\('\\\\'\)/u` - **「故意破坏会红」已验证**：临时从客户端 `BUNDLE_FORBIDDEN_PATH_CHARS` 去掉 `'?'` 与 `'*'` → 门禁立即报两条「路径段禁止字符：服务端有「?」/「*」，客户端没有」，随后已原样恢复 - 文档 `§3.5.2/§3.2.3`：校验器清单同步到新规则（新增目录/前缀/后缀/全名 + 内容嗅探及其取舍理由、嵌套包扩展名并集与 magic 嗅探、读取层封顶与压缩比口径更正、路径形状维度），并新增**产品口径「知情同意」**一条——清单是黑名单，`docs/`、`*.pdf`、`notes.txt`、截图等不在任何拒绝集内会原样外发，发布面板必须写明「整个项目目录（除少数排除项）会原样公开」 - 门禁：policy parity 0（服务端 51 条全被客户端覆盖 + 路径形状维度 OK）；`check:doc-index` 248 份 OK；`check:encoding` OK；`git diff --check` 0	2026-10-05 17:30:50 +08:00
suzmii	10d1fcbc5f	fix(游戏共创): 工程源包校验器对抗性补强（P0-a/b/c + 执行级交叉证据） ... 对抗性复核（`local://verify-m2b.md`）确认三个真实缺口，本次按 P0 → P1-b 补齐；两端规则逐条对齐，parity 门禁仍绿。 - **P0-a 凭据/依赖识别**：任意层级目录新增 `.aws` / `.ssh` / `.kube` / `.docker` / `.gnupg` / `.terraform` / `.secrets`（服务端新增独立变体 `CredentialDirectoryNotAllowed`）；文件名前缀新增 `credentials` / `id_ecdsa` / `id_dsa` / `terraform.tfstate` / `service-account`；后缀新增 `.jks` / `.keystore` / `.ppk` / `.p8` / `.kdbx` / `.der`；全名新增 `.htpasswd` / `.pgpass`。另外对**小体积文本条目**（≤256 KiB、扩展名在白名单或无扩展名）做内容特征扫描：PEM 私钥块、`AKIA`+16 位、`ghp_`/`github_pat_`/`xox*-`（服务端新增 `SecretContentDetected`）；更宽的前缀启发（如 `sk-`）**故意不做**并在注释里写明理由（误报会直接阻断作者发布） - **P0-b 规模检查不再被声明值骗**：两侧校验器改为**读取层封顶**——`by_index(index)?.take(declared_size + 1)` + 预分配收紧到单文件硬上限 + 多读 1 字节即判溢出、短读同样失败；压缩比分母从整包字节改为**该条目自身的压缩字节**；**同一修法同步到发行包校验器**（`package.rs` 原有同款洞），常量注释改成与实现一致（明确它不是整包炸弹防线） - **P0-c 嵌套包识别**：扩展名并集 `.zip/.tar/.gz/.tgz/.7z/.rar/.jar/.whl/.nupkg` + **magic bytes 嗅探**（zip/7z/rar/gzip/tar-ustar），改名成 `.dat` 也拦。**一处有证据的偏离**：`by_index_raw` 拿到的是**压缩流**（zip 2.4.2 文档与实测一致），按它嗅探会漏拦，因此改为对**已按声明大小封顶读出的解压内容**判 magic；客户端命中即报错并点名路径与格式 - **P1-b 执行级交叉证据（走 dev-dependency 路，未退化到 fixture）**：客户端 crate 加 `[dev-dependencies] module-game-distribution`，新测试用真实打包器产出字节喂给服务端 `validate_project_bundle_zip` 断言接受（并逐项比对摘要/字节数/条目顺序），再手造含 `.env` 与 `node_modules` 的包断言服务端独立拒绝 - 客户端同时补上**路径形状检查**（`BUNDLE_FORBIDDEN_PATH_CHARS` / `_SUFFIX_CHARS` / `_SEGMENTS` + `bundle_entry_path_shape_error`），修掉「macOS/Linux 上 `src/a?.ts`、`x.` 客户端能打、服务端必 422」的不一致；客户端压缩比预检也改按条目压缩字节 - 测试：`cargo test -p module-game-distribution` **73 passed**（+4）；AGC `cargo test -- project_bundle` **24 passed**（含交叉证据那条）；**发行包回归**：`cargo test -p api-server game_distribution` **60 passed / 0 failed**（`package.rs` 改动无行为回归，新增「声明说谎 → ReadFailed」用例） - 门禁：`cargo check --all-targets` 0；两端 `cargo fmt --check` 0；policy parity 0（服务端 51 条全被客户端覆盖）；DTO parity 0；schema 0；encoding 0；`git diff --check` 0	2026-10-05 17:30:50 +08:00
suzmii	18d19d5d54	fix(游戏共创): 源码公开确认改回默认勾选（与「允许共创即开放源码」口径一致） ... 按产品裁定回落默认值：保留主动取消能力与全部知情告知，但确认项**默认已勾选**—— 「允许共创本身就意味着源码开放，不设独立开关」，默认不勾选等于第二个开关，与本面板 自己写着的那句「没有单独的源码可见性开关」自相矛盾。 - `projectBundleConfirmed` 初值 true；每次重新选择授权档位都重置为「非禁止档位即已勾选」， 避免把上一次的取消状态带到新的档位选择上（禁止共创时不显示该确认项，值本身无意义）。 - 告知文案一字不减（整个项目目录原样公开、含文档/截图/设计稿/笔记、只自动排除依赖/版本库/ 构建产物/常见凭据、一经发布不可撤销、无法收回已下载内容）。 - 新增一句提示说明默认值来源：「上面这项默认已勾选（平台按「允许共创即开放源码」的默认帮你 勾上，不是替你做决定——你可以随时取消）。」——避免作者以为平台偷偷替他决定。 - 未勾选时的后果提示保留，仍写清「不勾选则本次不上传工程源码……」。 测试（面板 23 条）：默认「禁止共创」无确认项；切到非禁止档位后确认项出现且**已勾选**， 并逐条断言告知文案 + 「默认已勾选/可随时取消」；默认状态提交不携带 `includeProjectBundle` （交给原生按授权执行上传）；作者主动取消后提交携带 `includeProjectBundle: false`（这是 「作者能退出」的证据）；重新选择档位回到已勾选；切回「禁止共创」确认项消失。	2026-10-05 17:30:50 +08:00
suzmii	7972089a5f	fix(游戏共创): 工程源码公开改成作者的主动知情确认，文案如实告知外发范围 ... 背景（对抗性复核 D.7）：工程源包的拒绝规则是**黑名单**，作者的 `docs/`、`*.pdf`、`notes.txt`、 截图、设计稿、会议记录等不在任何拒绝集内，会被原样外发。也就是说「授权非禁止 + 上传工程源码」 = **整个项目目录（除少数排除项）对任何登录用户公开**。原来那句「同时公开工程源码……取消勾选则 只能被试玩」是免责声明式措辞，不足以构成知情同意。 文案（最终措辞）： - 授权三态说明统一口径：「授权非「禁止共创」即允许他人改编（**没有单独的源码可见性开关**）； 是否随本次发布把工程源码一起交出去，由下面的确认决定。上架后授权只能单向提升，不能撤销。」 - 确认项（仅授权非「禁止共创」且首次发布时出现）： 「我已确认项目里没有不愿公开的内容，同意随本次发布公开**整个项目目录**：源码、素材与其中 其它文件（含文档、截图、设计稿、笔记等）都会对任何登录用户公开；只会自动排除依赖目录、 版本库、构建产物与常见凭据文件。一经发布**不可撤销**：即使之后把授权降级，也无法收回别人 已经下载的内容。」 - 紧随其后写清不勾选的后果：「不勾选则本次不上传工程源码：作品仍可正常发布，但他人只能拿到 已构建成品试玩与参考，不能直接重新发布。」 交互选择：**默认不勾选 + 不勾选就不上传**（不是禁用发布按钮）。 - 选它的理由：① 它把第 3 点做成了真正的「主动确认动作」；② 发布本身不被阻断——工程包缺失本来 就不影响发布（服务端与原生链路都按「可选资产」设计），禁用按钮反而会把「禁止共创 / 只想先发 出去」的作者一起挡住；③ 勾选状态只作用于本次版本上传，不引入平台侧的独立开关，授权语义不变。 - 注意：这一条**取代**了早先「授权非禁止时默认帮作者上传」的默认值——知情同意优先于默认帮忙； 若要把默认值改回勾选，只需把 `projectPackageConfirmed` 初值改成 true 并翻转对应断言。 测试：改写两条面板用例——授权开放后确认项出现且**默认未勾选**、九处告知文案逐条断言（整个项目 目录 / 含文档截图设计稿笔记 / 只自动排除四类 / 不可撤销 / 无法收回已下载内容 / 不勾选则不上传 / 没有单独的源码可见性开关）、未确认时显式传 `includeProjectBundle: false`（不上传但照常发布）、 确认后不带该字段（由原生按授权执行上传）。	2026-10-05 17:30:49 +08:00
suzmii	843ecbf4a2	chore(游戏共创): 删掉打包器的 dead_code 豁免，并只保留真正被用到的范围分支 ... 上传链路已在 `5dd9d1c5d` 接好，`#![allow(dead_code)]` 的豁免期结束： - 删掉模块级 `#![allow(dead_code)]`，注释改成写明调用方（发布链路的 `upload_project_bundle_for_version`，取件侧摘要校验共用 `sha256_hex`）。 - 移除豁免后只剩一条 dead code：`ProjectBundleScope::GameDirectory` 从未被生产代码构造 （发布链路一律上传整个项目——收到方要能直接打开并重新构建，只带 `game/` 会丢掉根 `assets/`）。 该变体承载的是独立能力（不同的遍历根 + 剪枝 + 「没有 game/ 目录」失败关闭），且已被两条用例 覆盖，因此按仓库做法标 `#[cfg(test)]`（连带的 match 分支同步 cfg），并在注释里写清「真有生产 调用方时去掉 cfg」；没有连带删除其它代码——模块里其余函数与常量都已被生产路径引用。	2026-10-05 17:30:49 +08:00
suzmii	779bbd1157	docs(游戏共创): M2b 文档回填两处实现偏差 + 状态改已实现（含 M2b 证据表） ... - 技术方案 §3.4：上行路由行按端到端实测补两条按实现为准的细节——① **非作者上传返回 404 而不是 403**（`load_owner_version_or_404` 把 owner 不匹配按「版本不存在」处理，与发行包上行族同口径，不泄露版本存在性、响应不含对象键）；② **阶段门先判「已存在」再判档位**（`ensure_project_bundle_uploadable`：`project_bundle_bytes > 0` → 409 `PROJECT_BUNDLE_ALREADY_EXISTS`，再看 `status` → 409 `PROJECT_BUNDLE_UPLOAD_NOT_ALLOWED`），因此「已公开且已有工程包」返回 `ALREADY_EXISTS`，「已公开但无工程包」才返回 `UPLOAD_NOT_ALLOWED`。证据：`check-game-distribution-project-bundle-e2e` 的 A5 / A5b / A6 及其 NOTE - 技术方案 §3.5.2：AGC 侧「上传」「下载与建项」由「接线待做」改为**已落地**（发布时上传且失败不阻断、按 `source` 分支建项、来源记录 v2 兼容 v1、取件提示按形态措辞），并写明两端规则由 `npm run check-project-bundle-policy-parity` 机器门禁钉住一致 - 技术方案 §3.5.4：路线 B 由「服务端已实现、客户端接线待做」改为**两端均已落地** - 技术方案 §3.7：补 M2b 口径——共创写入仍复用 `game-distribution:publish`（未新增灰度键）；内容下发与工程包上传当前只有 `tracing` 日志，三个结构化埋点事件**仍未接**（待产品定事件口径） - 技术方案新增 §5.2「M2b（工程源包）实施证据」表：三列与契约、校验器（16 条单测 / 上限镜像）、上行路由族（api-server 60 passed）、下行优先与缓存不串味、端到端 `check:game-distribution-project-bundle-e2e` **46/46**、两端规则 parity 门禁、客户端 vitest 1961 passed 与定向 cargo test 17+16；并显式登记「backfill 明确不做」「真实极端边界与结构化埋点待补」 - 里程碑「作品工程源包与一键改造」：Status → `implemented-local`；新增「实现进展（2026-10-05）」列出两端提交 SHA 与证据命令、以及四条未做项及原因；验收标准改为 ✅/⏳/⏭ 三段并有证据指向（阶段门顺序、非作者 404、半包清理等按实测更新）；证据要求补上已落地的命令清单与「真机建项链路仍未跑」的括注 - 门禁：`check:doc-index` 248 份 OK；`check:encoding` 5304 files OK；`git diff --check` 0	2026-10-05 17:30:49 +08:00
suzmii	09a11ac215	fix(游戏共创): 取件成功提示按两种取件形态如实措辞 ... M2b 之后取件有两种形态：工程源包解压即可编辑工程（没有 reference/ 参考副本），成品包才放在 reference/<gameId>/ 作可玩参考。原来的成功提示写死「参考产物在 reference/<gameId>/ 下」， 对工程源包形态是错的。改为两种情形都说明，并同步测试断言（仍保留「改编自 X」这条来源事实）。	2026-10-05 17:30:49 +08:00
suzmii	1a4af39e56	feat(游戏共创): 取件按 source 分支建项，来源记录升到 v2（兼容 v1） ... - 来源记录 v2：新增 `source`（`package` / `project`），当前写入 `agc-fork-source.v2`； 解析同时接受 v1——v1 没有该字段，按「成品包」解释（当时只有这一条取件通道）， 因此老项目仍能正确读出「改编自哪个作品」，发布时照常带上声明。未知版本与非法取值仍按 「没有来源记录」失败关闭。 - 建项按取件形态分支（`create_project_from_platform_fork_at` 增加 `source` 入参，远程 `source` 取值在命令层映射）： · `project`（工程源包）：先把包解到**项目根**再走标准初始化。源包自带 `package.json` / `vite.config.*`，初始化会跳过 npm 脚手架判据，只补 `.agent` 身份、 目录与 agent.db，得到一份能继续改、能重新构建的工程；不再生成 `reference/` 参考副本。 · `package`（成品包）：维持原形态（合规脚手架 + `reference/<gameId>/` 可玩参考）。 - 解压仍走既有门禁（`extract_template_archive`：条目数/单文件上限、拒符号链接、条目路径 只允许项目内相对路径；ZIP 根 == 项目根与模板包同一合同）。 - 命令文档同步说明两种形态的差别（工程源包=解压即工程；成品包=可玩参考，不能直接再发布）。 测试：新增「工程源包建项得到可编辑工程」用例（源码逐字节不被脚手架覆盖、`.agent` 身份已补、 无 `reference/`、记录 source=project）与「v1 记录仍可读且按成品包解释」用例； 既有成品包建项用例补断言 source=package。	2026-10-05 17:30:49 +08:00
suzmii	1fc78faff2	feat(游戏共创): 授权非禁止时随版本上传工程源包（M2b 上传链路，失败不阻断发布） ... 上传链路（复用既有分片续传，不另写一套）： - `PackageUploadAsset` 收拢两条资产的差异（URL 资源段 `package` / `project-bundle`、文案、 偏移错误码 `PACKAGE_UPLOAD_OFFSET_MISMATCH` / `PROJECT_BUNDLE_UPLOAD_OFFSET_MISMATCH`、 是否有创建版本时预登记大小），`upload_staged_game_package` 改名 `upload_staged_version_asset`，发行包与工程源包共用同一段主循环与重试/续传语义。 - 发布流程：建游戏 → 建版本 → 上传发行包 → 〔授权非「禁止共创」且作者没取消时〕打包工程源包 并上传 → 送审。插入点必须在送审**之前**：服务端只允许 `awaiting_upload` / `upload_failed` 档位补传工程包，送审后即 409。 - 失败关闭与不阻断：工程源包打包/上传任何失败都只写进结果的 `projectBundleWarning` （「未上传工程源码，本作品只能被产物级改编：…」），发布本身照常成功；作者的作品仍可玩可发布。 - 进度复用既有 `game-package-upload-progress` 事件（phase 仍用 upload/verify，文案区分资产）， 渲染层的阶段联合是闭集，不新增阶段名。 面板与渲染层： - 新增「同时公开工程源码」勾选：仅当授权非「禁止共创」且为首次发布时出现，默认勾选， 文案写清「允许他人下载并使用你的工程源文件（含素材），且不可撤销」； 取消勾选才显式传 `includeProjectBundle: false`，其余情况交给原生按「授权非禁止即上传」判断， 渲染层不重复实现同一套默认值。 - 成功页如实展示 `projectBundleWarning`，避免作者误以为源码已随版本公开。 测试：Rust 新增「两条资产的路由段/偏移错误码/预登记大小差异」用例，并更新既有 `upload_url` 用例； TS 新增勾选默认值、取消勾选显式 false、未上传提示三条，服务层新增「true/缺省不带字段、 false 才带」用例。	2026-10-05 17:30:49 +08:00
suzmii	360cb9830a	test(游戏共创): 新增工程源包（M2b）端到端验收脚本 ... - 新增 scripts/check-game-distribution-project-bundle-e2e.mjs：真实 HTTP 验收 M2b 上行族与下行优先 · A1 合法工程源包整包 PUT → 200；版本私有 payload 的 projectBundleBytes/projectBundleSha256 与上传一致且不含对象键 · A2 >8 MiB 不可压缩负载两片续传：chunkBytes=8388608，偏移 8388608→9438176，upload-state 权威偏移逐片一致，complete 后 bytes/sha256 一致 · A3 含 .env → 422 PROJECT_BUNDLE_VALIDATION_FAILED，且该版本仍 bytes=0 / sha256 空 · A4 二次上传 → 409 PROJECT_BUNDLE_ALREADY_EXISTS · A5 已公开且已有工程包再传 → 409 ALREADY_EXISTS（阶段门先判已存在）；A5b 已公开但无工程包补传 → 409 PROJECT_BUNDLE_UPLOAD_NOT_ALLOWED · A6 未带 Bearer → 401；另一作者 token → 404（实现按不存在处理，脚本按实现断言并标注与工单 403 的差异） · B7/B8 发布后 fork-source source=project、sha256/bytes 一致、downloadPath 指向 project，下载校验 zip/length/sha256/解压条目 · B9 对照作品（无工程包）source 回落 package，/fork-source/project → 409 - package.json：新增 npm script check:game-distribution-project-bundle-e2e - 复用 lineage 脚本的发布链路与 helper（脚本头注释标注出处），未抽公共模块以免改动其它脚本 - 实测：本地 dev 栈 46 项 46 PASS / 0 FAIL / 0 SKIP	2026-10-05 17:30:48 +08:00
suzmii	524ca890c6	feat(游戏共创): 工程源包规则与服务端对齐，并加机器 parity 门禁 ... 规则对齐（以服务端为权威，`module-game-distribution/src/project_bundle.rs`）： - 凭据/隐私两侧补齐：客户端新增 `.git-credentials`、`id_rsa*`、`id_ed25519*`、`*.map`， 并把 `.env` 放宽成服务端同形的 `starts_with(".env")`（`.envrc` 之类一并排掉）。 反向无需补：客户端没有服务端缺的凭据类规则，比对一次后两侧凭据集合完全一致。 - 新增被漏掉的嵌套压缩包规则：服务端对任意层级 `*.zip` 一律拒收（解包阶段不递归校验， 等于绕过整份清单），客户端原来会把它打进包里 → 现在同样排除。 - `.agent` 由「项目根首层」对齐到**任意层级**（服务端口径；平台保留名两边一致比更宽松重要）。 - 客户端额外项保留并逐项写明理由：`game/dist`、`game/build`（AGC 脚手架构建输出）、 `.godot`（编辑器缓存，模板包指南同规则）、`exports`/`memory`（AGC 生成物与 Agent 记忆）。 - 规模上限统一到服务端数值：压缩包 ≤ 200 MiB（新增）、展开 ≤ 500 MiB、单文件 ≤ 64 MiB、 条目 ≤ 10 000、单文件 ≤ 包体 × 100（新增）。客户端先拦，不再出现「传到一半被 422 拒掉」。 - 顺手补上服务端已有的「大小写折叠后重名条目」防线：客户端提前失败关闭。 可机器比对的常量：规则集拆成 `BUNDLE_EXCLUDED_*` 常量、上限拆成 `PROJECT_BUNDLE_MAX_*`， 新增 `scripts/check-project-bundle-policy-parity.mjs` 逐 token/逐数值比对两侧（服务端每条规则 必须在客户端存在，客户端额外项只打印不算失败；抽不到 token 直接报错，避免假绿），并照既有 DTO parity 的形态接到 `package.json` 的 `check:*` 与 `lint` 链。 测试：客户端 17 条（新增 `.git-credentials`/`id_rsa`/`*.map`/`.envrc`/`.zip`/任意层级 `.agent`、 压缩包上限、压缩比上限各自一条；合同常量锚点改为与服务端逐项相等）。	2026-10-05 17:30:48 +08:00
suzmii	861dc0a676	feat(游戏共创): M2b 上行路由族 + 下行优先与缓存资产维度（块 C+D） ... - 上行（作者、Bearer + 发布灰度，与发行包族逐条对齐）：`PUT /versions/{id}/project-bundle`（整包一次上传，≤ 200 MiB）、`GET …/project-bundle/upload-state`、`PUT …/project-bundle/chunk`（`x-genarrative-upload-offset`，分片上限同发行包）、`POST …/project-bundle/complete`、`POST …/project-bundle/reset`；载体一律 `application/octet-stream`，分片边界与偏移语义只有一套 - 对象键：新增 `game_distribution_project_bundle_object_key(game_id, version_id)` = `…/{version_id}.project.zip`；发行包 helper **未改**（仍是 `.zip`）→ 同一（作品, 版本）的两份资产互不覆盖、也不会串用读取缓存 - 阶段门：新增**唯一**共享函数 `ensure_project_bundle_uploadable`，5 条上行路由全部调用、无重复实现。判定顺序：① 已确认（`project_bundle_bytes > 0`）→ 409 `PROJECT_BUNDLE_ALREADY_EXISTS`（必须先判：确认工程包不驱动版本状态机，已确认的版本可能仍停在 `awaiting_upload`）；② `status` ∉ {`awaiting_upload`, `upload_failed`} → 409 `PROJECT_BUNDLE_UPLOAD_NOT_ALLOWED`（与模块事务同口径） - `complete`：回读整包 → 与 HEAD 权威长度比对 → `validate_project_bundle_zip`（失败删半包对象 + 记上传失败 + 422 `PROJECT_BUNDLE_VALIDATION_FAILED`）→ `confirm_game_distribution_project_bundle`；幂等键与摘要口径照抄发行包 complete - 下行优先：`fork_source_target` 选定资产 = 有工程包时 `Project`（优先）否则 `Package`；「字节数 > 0 **且**摘要非空」才算有工程包，半写行回落 `package`（失败关闭）。元数据 `source` / `sha256` / `bytes` / `downloadPath` 随所选资产；新增 `GET /games/{id}/fork-source/project`（同两层中间件、无 Query 提取器；没有工程包时 409 `FORK_SOURCE_NOT_AVAILABLE`，**绝不静默回落成品包**），响应头与成品包同形（文件名 `{gameId}-{versionId}-project.zip`） - 缓存键加资产维度：`release_package_bytes` 泛化为 `release_asset_bytes(state, object_key, max_bytes)`（缓存键即对象键），发行包侧退化为薄封装——键字符串、上限、`Bytes` 值类型与 4 条 / 256 MiB 预算逐字节不变，既有缓存测试继续通过 - 顺着同一「不复制第二套」原则抽出/参数化的共享件：`fork_source_bundle_response`（两份资产共用响应构造）、`package_upload_offset(headers, asset)`、`require_octet_stream_content_type(headers, asset)`（按资产给错误文案，发行包文案不变） - 补上块 A 遗漏的两处客户端登记（否则下行字段读不到）：`spacetime_client` 对 `GameDistributionConfirmProjectBundleRecordInput` 的 re-export，以及 `GameDistributionForkSourceRecord` 新增 `project_bundle_sha256` / `project_bundle_bytes` 与对应映射 - 测试 6 条：5 条上行 + 1 条下行共 6 条路由未带 Bearer → 401（逐条）；`ensure_project_bundle_uploadable` 全状态（含「已确认优先于阶段」）+ 7 档拒绝；`fork_source_target` 6 种资产组合（工程包优先 / 回落成品包 / 两种半写行 / 只有工程包 / 两份都缺 → 409）；两个对象键互不相等 + `ReleasePackageCache` 双资产不串味；上限镜像（`MAX_PROJECT_BUNDLE_BYTES == MAX_PACKAGE_BYTES == shared_contracts::GAME_DISTRIBUTION_MAX_PACKAGE_BYTES`、分片放行量 > 分片大小）；校验失败 422 映射 - 门禁：`cargo check --all-targets` 0；`cargo test -p api-server game_distribution` **60 passed**（基线 54；既有发行包族用例全绿 → 抽取共享件未改发行包行为）；DTO parity 42 组 OK；`check:encoding` 5301 files OK；`git diff --check` 0；`cargo fmt --all -- --check` 0	2026-10-05 17:30:48 +08:00
suzmii	d39257b608	docs(游戏共创): M2b 文档按实现收敛（块 E） ... - 技术方案 §3.2.3：三列语义改为与实现一致；删掉原「保留一次补齐机会」的规则（**已公开版本的补传未实现**，本期不做），改为「只在 `awaiting_upload` / `upload_failed` 可写一次、写入后换内容 409、不做版本回溯」；补产品口径（不做独立「源码可见性」开关、作者不传即产物级改编、`nonCommercial` 约束力属平台规则层面）；对象键改为实现值 `…/{version_id}.project.zip` - 技术方案 §2.3：把「公开后可补传一次工程源包」的表述改为如实口径（公开后不接受补传，只能走试玩 + 素材） - 技术方案 §3.3：version 行的 `project_bundle_*` 迁移规则改为「只在未公开时可写一次」 - 技术方案 §3.4：`PUT /versions/{versionId}/project-bundle` 从「规划」改为**已实现**（整包 + 4 条分片族路由、作者限定、阶段门、无既有工程包、服务端派生对象键）；「登录用户」小节把取件接口从两个改为三个并说明 `source` 可能是 `project`（优先）或 `package`，新增 `/fork-source/project` 本体行（失败关闭、缓存含资产维度） - 技术方案 §3.5.2：打包/服务端复核/上传/下载建项/优先级五条按实现重写——写明服务端 `validate_project_bundle_zip` 的完整拒绝清单与与发行包逐项相等的上限（200 MiB / 500 MiB / 64 MiB / 10 000 / 100，理由：共用同一上传链路且反代按 200 MiB 校准），以及「打包器已落地、上传与建项接线待做」 - 技术方案 §3.5.4：记录产品已采纳推荐口径（A 默认继续服务未上传工程包的作品、B 服务端已实现、C 不做） - 里程碑「作品工程源包与一键改造」：Status → in-progress（服务端已落地 / 客户端接线待做）、Version 1.2；范围去掉「是否公开工程」选项（不存在独立开关）；不在范围内新增「已公开版本补传」；两条前置依赖标注已落地并写清 512 MiB 与 200 MiB 的对齐口径（客户端须按服务端上限预检）；验收标准改为带 ✅/⏳ 标注、删掉两条 backfill 验收、补阶段门与半写行回落等已实现项 - 门禁：`check:doc-index` 248 份 OK；`check:encoding` 5301 files OK；`git diff --check` 0	2026-10-05 17:30:48 +08:00
suzmii	8ce4649081	feat(游戏共创): M2b 工程源包专属 zip 校验器（块 B） ... - 新增 `server-rs/crates/module-game-distribution/src/project_bundle.rs`：`validate_project_bundle_zip(bytes) -> Result<ProjectBundleManifest, ProjectBundleError>` · 复用 `crate::package::normalize_archive_path`（不复制路径安全逻辑），路径不安全统一归 `InvalidPath` · 拒绝清单：空包 / 非 zip / 条目数 > 10 000 / 符号链接 / 加密条目 / 嵌套 `.zip` / 完全重复与大小写折叠重复路径 / `node_modules`（任意层级）/ `.git`、`.svn`（任意层级）/ `.agent`（任意层级：避免把上一个作品的改编来源记录带给下一个人）/ 根级 `dist`、`build`、`library`、`temp`、`local`（子目录同名允许，与模板包规则一致）/ 根级 `.idea`、`.vscode` / 凭据与隐私：`.env`、`.env*`、`*.pem`、`*.key`、`*.p12`、`*.pfx`、`.npmrc`、`.netrc`、`.git-credentials`、`id_rsa*`、`id_ed25519*`、`*.map` / 单文件 > 64 MiB / 累计 > 500 MiB / 单文件 > 包体 × 100 · 规模上限与发行包**逐项相等**（200 MiB / 500 MiB / 64 MiB / 10 000 / 100）：两者共用同一条上传链路，反代与 Pingora 的放行量就是按 200 MiB 校准的，放宽就得同步放开多处部署配置；单测用 `assert_eq!` 钉住这条等价关系 · 不要求根 `index.html`（源码包没有入口约定），非空即可 - `lib.rs` 只追加 `mod project_bundle;` 与 `pub use project_bundle::{...}`（+6 行）；`package.rs` **零改动**，发行包行为与测试不受影响 - 测试 16 条：合法源码包通过（故意不含 `index.html`）、上述每条拒绝规则各一条、「子目录里的 `dist/` 允许」反例、常量与发行包逐项相等、manifest 的 sha256/字节数与输入一致 - 门禁：`cargo test -p module-game-distribution` 69 passed（含本校验器 16 条）；wasm build 0；`cargo fmt --all -- --check` 0	2026-10-05 17:30:48 +08:00
suzmii	604ce7f3ec	feat(游戏共创): M2b 数据模型——版本行三列工程源包 + 契约与绑定（块 A） ... - `server-rs/crates/spacetime-module/src/game_distribution.rs`：`game_distribution_version` 表尾追加三列（明确默认值，遵循既有追加规则）——`project_bundle_object_key: Option<String>`（`#[default(None)]`）、`project_bundle_bytes: u64`（`#[default(0)]` = 未上传）、`project_bundle_sha256: Option<String>`（`#[default(None)]`）；三列同步进 `GameDistributionVersionSnapshot`、版本快照构造与建版本时的初始化 - 同文件：`GameDistributionForkSourceSnapshot` 与扁平结果类型追加 `project_bundle_sha256` / `project_bundle_bytes`，下行据此判断走 `project` 还是回落 `package`（字节数与摘要成对，缺一视为没有工程包） - 同文件：新增 `GAME_DISTRIBUTION_ACTION_UPLOAD_PROJECT_BUNDLE` 动作常量、输入 `GameDistributionConfirmProjectBundleInput`、事务 `confirm_game_distribution_project_bundle_tx` 与 procedure `confirm_game_distribution_project_bundle_and_return`。语义：可选资产、**不驱动版本状态机**；owner 校验 → 阶段门（`awaiting_upload` / `upload_failed`，与发行包确认同口径，已公开/已取消/已撤回一律拒绝）→ 同内容幂等重放 / 换内容冲突 → 写三列 + 幂等收据 - `spacetime-client`：`GameDistributionVersionRecord` 与 `map_version` 同步三列（生成绑定把 `project_bundle_sha256` 折成 `project_bundle_sha_256`，与 `package_sha_256` 同约定）；新增 `GameDistributionConfirmProjectBundleRecordInput` 与 `confirm_game_distribution_project_bundle`（沿用 `map_game_distribution_game_result` 再取 version 的既有写法） - 契约：`shared-contracts` 的 `GameDistributionPrivateVersion` 追加 `project_bundle_bytes`（必需，`0` = 未上传）与 `project_bundle_sha256`（可选）；`packages/shared` TS 镜像同步；api-server `private_version_payload` 追加同名键——**对象键不下发**，只回摘要与字节数 - 生成物：重跑 `npm run spacetime:generate -- --rust-only`，只保留 `module_bindings/game_distribution*`（含 2 个新文件）与 `module_bindings.rs`，其余 `module_bindings/**` 的 rustfmt 漂移已 `git checkout --` 还原 - 文档：数据契约表目录 `game_distribution_version` 小节补三列语义与对象键不出服务端的口径 - 顺手记下一条门禁陷阱：`scripts/check-game-distribution-dto-parity.mjs` 抓 `json!` 顶层键时要求「键前一个非空字符是 `{` 或 `,`」且**不剥注释**，在字面量里插注释行会让紧随其后的键被判成缺失（已写进 `private_version_payload` 的文档注释） - 门禁：wasm build 0；`cargo check --all-targets` 0；`cargo test -p module-game-distribution` 69 passed；`cargo test -p api-server game_distribution` 54 passed；DTO parity 42 组 OK；`check:spacetime-schema` 92 tables OK；`check:encoding` 5301 files OK；`git diff --check` 0；`cargo fmt --all -- --check` 0	2026-10-05 17:30:48 +08:00
suzmii	63e6c6345e	feat(游戏共创): 新增工程源包确定性打包器（M2b 客户端半，暂不接上传） ... - 新模块 `src-tauri/src/project_bundle.rs`：`build_project_bundle(root, scope)` 产出 `(bytes, sha256, file_count, entry_paths)`，口径见 `docs/【技术方案】游戏共创与作品Fork-…` §3.5.2。 - 确定性：条目按路径排序、固定时间戳（ZIP 下限 1980-01-01）、固定权限位 0o644、固定 deflate， 只写文件条目不写目录条目；同内容必然得到同一 sha256（有测试钉住，含「改一字节即变」）。 - 路径安全：条目名一律项目根相对并过解压侧同一道门禁 `template_library::safe_archive_relative_path`； 符号链接 / Windows 重解析点、非普通条目一律失败关闭。ZIP 根 == 项目根（与模板包同一合同）。 - 排除规则：依赖与 VCS 任意层级（`node_modules`/`.git`/`.svn`）、项目根首层构建产物与 IDE （`dist`/`build`/`library`/`temp`/`local`/`.idea`/`.vscode`/`.godot`）、任意层级凭据 （`.env`/`.env.*`/`*.pem`/`*.key`/`*.p12`/`*.pfx`/`.npmrc`/`.netrc`）、AGC 自有目录 （`.agent`/`exports`/`memory`，理由逐条写在模块注释里）。 - 带上限常量：条目 ≤ 4096、单文件 ≤ 256 MiB、展开总量 ≤ 512 MiB；超限失败关闭并点名违规条目， 不静默截断（测试用小上限跑同一段逻辑，不另写一条检查路径）。 - 复用而非另起一套：`safe_archive_relative_path`（解压侧）、`project::relative_project_path`、 `image_inspect::metadata_is_windows_reparse_point`、`export.rs` 的排序 + 逐文件写 ZIP 写法； 摘要实现抽出 `project_bundle::sha256_hex`，`game_fork` 的取件校验改为复用它（少一份副本）。 - 打包范围：`WholeProject`（默认，M2b 用）与 `GameDirectory`（只收集 `game/`，条目命名不变）。 - 未接上传：上行路由族未定，模块整体带 `#![allow(dead_code)]` 并在注释里写明接线时删除。 - 测试 14 条：每类排除规则、确定性（两次/乱序/改字节）、条目路径不变量 + 解压器往返、 两个打包范围、空包与三类超限失败关闭、合同常量锚点；符号链接用例按平台 `#[cfg(unix)]`。	2026-10-05 17:30:47 +08:00
suzmii	d2698cbb1d	fix(门禁): 补 /games/lineage 的 Pingora 登记，并修掉被掩盖的 eslint 失败 ... - `server-rs/crates/pingora-gateway/src/main.rs`（MAIN_SPA_PATHS，:64-79）：插入 `"/games/lineage"`（放在 `"/games/detail"` 之后，保持既有字典序）。这是主站 SPA 深链在 Pingora 网关下的登记，漏一条就把该深链打成 404；与上一提交补的三份 nginx 模板属同一条「新 SPA 路由三处同批更新」规则 - 矩阵与文档无需改：`deploy/pingora/nginx-route-parity.matrix.json` 的既有 `games_spa_fallback` 用例仍前缀匹配同一行 `location`（本次只改交替项、未新增 `location`），Pingora 试点文档的取值表同理未受影响 - `src/components/game-distribution/GameLineagePage.tsx:146`：把 `lineage?.nodes ?? []` 用 `useMemo(..., [lineage])` 稳定下来，消掉两条 `react-hooks/exhaustive-deps`。取值仍是同一表达式的结果，identity 只在 `lineage` 变化时改变，因此两个下游 useMemo（代际分组、可见 ID 集合）取值不变、只少做无谓重算；未用 disable 注释压掉告警 - 6 处 `simple-import-sort/imports` 用 `eslint --fix` 机械修（`apps/.../view/home/PlatformGameForkSection.tsx`、`apps/.../view/home/index.tsx`、`src/components/game-distribution/GameDetailPage.tsx`、`MyGamesPage.test.tsx`、`MyGamesPage.tsx`、`src/services/gameDistributionClient.ts`）：逐文件比对「剥掉 import 行后的正文」——5 个文件完全一致，`GameDetailPage.tsx` 仅多一个 import 分组空行 - 这批修的是「修 nginx 时被前一道红掩盖的第二、第三个失败」：CI run 3387 卡在 `check:nginx-spa-routes`，`check:pingora-route-parity` 与 `lint:eslint` 从未跑到 - 本地验证：`check:repository-ci` 的 15 个 lint 环节 + `appSurface` vitest + `npm run build` + `git diff --check 6c9566058...HEAD` 全绿，仅两个**本机不可执行**项（`check:git-hooks` 的 Windows EBUSY、`check:generated-bindings` 的 AGC `export_bindings` 本地构建）；另跑 `cargo test -p pingora-gateway` 40 passed、`npx vitest run apps/ai-game-creator-shell/tests` 1957 passed / 17 skipped	2026-10-05 17:30:47 +08:00
suzmii	5795a07a7d	fix(部署): nginx SPA allowlist 补 /games/lineage（三份模板同批） ... - `deploy/nginx/genarrative.conf:237`：allowlist 交替项插入 `games/lineage`（放在 `games/detail` 与 `games/mine` 之间，保持既有字典序） - `deploy/nginx/genarrative-dev-http.conf:209`：同上 - `deploy/container/nginx.conf:160`：同上（8 空格缩进，`~*` + `/?$` 形态不变） - 原因：M3 新增网页端 SPA 路由 `/games/lineage`（`src/routing/activeAppPageRoutes.ts:18`）后没同步三份 nginx 模板，`npm run check:nginx-spa-routes` 以 9 条断言失败（每份模板 3 条：缺少路由 / 未匹配完整路径 / 未允许大小写差异与尾部斜杠）；CI run 3387 的 `Repository checks`（3m36s）即因此红，属本分支引入（master 尖端 `6c9566058` 8/8 绿） - 只补路由项，未改门禁脚本、未放宽任何断言、未动 `apps/**`、`server-rs/**`、`src/**` - 验证：`npm run check:nginx-spa-routes` → OK（15 SPA routes / 1 prefix routes / 3 Nginx templates）	2026-10-05 17:30:47 +08:00
suzmii	d173e7975e	style(游戏共创): 按 rustfmt 格式化 AGC tauri 侧取件与发布改动（纯格式，无语义变化） ... CI run 3386 的 `Repository checks` 失败于 `cargo fmt --all -- --check`（AGC tauri workspace），本分支引入；本次只跑 `cargo fmt --all --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml`，漂移文件与 CI 报告完全一致，共 3 个： - game_distribution_publish.rs：404 分支的 `StatusCode::NOT_FOUND =>` 改成块、`game_id` 字符集判据的 `.chars().all(...)` 换行、`if let Some(...) = crate::project::read_project_fork_source(...)` 换行、下载路径测试里的 `fork_source_download_segments(...)` 调用换行。 - game_fork.rs：测试里两处 `writer.start_file(...).expect(...)` 与一处 `assert!(...)` 折行、`filter(|entry| ...)` 闭包折行。 - game_fork/desktop.rs：`use crate::game_distribution_publish::{...}` 收成单行。 逐文件核对过 `git diff`：只有折行 / 缩进 / 大括号位置 / 尾随逗号类变化，标识符、字符串 字面量、注释文本、逻辑一律未动。未改 server-rs、src、scripts，也未动 PR 状态。	2026-10-05 17:30:47 +08:00
suzmii	f40050afb1	收口 M3 复核遗留：文档如实口径、fork-source 状态说明、forkAuthorization 机器守卫、e2e 引用去行号 ... - 技术方案 §3.4：删掉「GET /games/{gameId} 追加 forkSourceAvailable」——实现里不存在该字段；改为如实口径：改造入口显隐只依据 forkAuthorization，真实可复刻形态由 /fork-source 的 source 回答，若 M2b 要区分「可源码级改造 / 只能参考」届时再加 - 实施计划（M1）§5：同步去掉 forkSourceAvailable 并注明「未实现、也不需要」，保留其余字段清单不动 - 技术方案 §2.6 时序图：说明字句从「GET …/fork-source 是待实现接口」改为「M2a 已实现（形状见 §3.4 登录用户表）」，并在图内加一行 Note 标注「图中字段名是 M2b 目标形状」；图属目标形态的免责声明保留 - parity 脚本：game_payload 增加 mustEmit ['forkAuthorization']——该字段 TS 侧可选（旧响应可省），但公开与作者响应必须发出，否则详情页授权徽章与改造入口会静默退化成「禁止共创」；public_game_payload 以 game_payload 为 base，因此一并受保护 - e2e 脚本头部：把全部行号引用（含已过期 2–4 行的那些）改为「文件 + 符号」引用（router()/lineage_read_or_not_found()/GameDistributionLineageNode/lineage.rs 常量与函数等），并删除「消费链路在未提交的 M2a WIP 里」这类会过期的措辞，改为「已在 M2a 落地」；只改注释，断言逻辑未动	2026-10-05 17:30:47 +08:00
suzmii	6759e56454	test(游戏共创): 族谱验收脚本补网页端「改造这个作品」入口断言 ... - scripts/check-game-distribution-lineage-e2e.mjs 新增 5 条浏览器断言，插入位置在族谱树断言之后、 软删除母版之前（母版一删该入口即消失，顺序不能反）： · 已公开且授权开放的母版详情页出现「改造这个作品」入口 · 展开面板：作品 ID 等于母版；可复制作品链接指向 /games/detail?id=<母版>；面板给出 「打开陶泥儿客户端 → 首页『从平台作品开始创作』→ 粘贴」引导，并给出成品包只能作为 可玩参考与素材、不能直接再次发布的口径 · 点「复制作品 ID」后只断言可观察 UI 反馈（按钮变为「作品 ID 已复制」）：真实剪贴板内容 需要额外权限，不在自动化范围，属人工验收项 · 对照断言：已公开但授权为 forbidden 的作品详情页不出现该入口（也不出现「登录后可改造」） · 展开态截图存临时目录并打印路径 - 入口文案常量做成可覆盖（E2E_REMIX_*），取值对齐 GameDetailPage.tsx:430-490（Commit 392cb3bb0） - 删除后回看族谱改为导航到先前记录的 lineage URL（原实现用 page.reload，新增入口步骤会先切走页面） - 实测：本脚本 99 项 99 PASS / 0 FAIL / 0 SKIP；复跑 check:game-distribution-fork-authorization-e2e 48/48 未回归	2026-10-05 17:30:47 +08:00
suzmii	0d4db90db1	新增作品详情页「改造这个作品」入口（复制作品 ID/链接 → 客户端粘贴） ... - 共创信息卡内新增入口：仅当作品已公开且 forkAuthorization != forbidden 时出现；授权为禁止共创时保持现状不出现 - 交互：点击展开获取方式——可复制的作品 ID 与完整作品链接（/games/detail?id=<gameId>，AGC 解析器接受的形态）+ 操作指引「打开陶泥儿客户端 → 首页『从平台作品开始创作』→ 粘贴」 - 复制反馈复用平台既有 CopyFeedbackButton + useCopyFeedback（统一剪贴板实现与「已复制 / 复制失败」状态） - 未登录：入口照常出现但显示「登录后可改造」，点击走仓库既有登录门禁（authUi.openLoginModal，与同页「登录后评价」同一做法），不静默隐藏、也不假装可唤起客户端 - 文案与 AGC 侧口径一致：可玩参考 + 素材、参考产物在 reference/<作品ID>/ 目录、成品包没有源码不能直接再次发布；不写「一键复刻工程」 - 不新增路由、不发 API 请求、不动服务端：网页端无法唤起客户端（未注册 deep link），只做「复制 → 粘贴」 - 测试：新增 4 例（公开+非禁止出现入口并可复制、forbidden 不出现、未公开不出现、未登录走登录门禁）；并把 M1 遗留的「不提供改造入口」断言改写为新契约 - 样式：.game-fork-remix-* 落在共创信息卡内，窄屏靠网格与 overflow-wrap 收在容器里	2026-10-05 17:30:47 +08:00
suzmii	d89e21ffd5	feat(游戏共创): 首页新增「从平台作品开始创作」入口（唯一可点的客户端路径） ... - 入口位置：首页模板库推荐位之后新增一节「从平台作品开始创作」。与模板库同属「从现成内容 起步」，但这条拿的是平台作品的已构建成品（可玩参考 + 素材），不是可编辑工程，因此单独成节 而不是塞进模板库；未登录用户进不到首页，服务端也确实对任何登录用户开放取件，无需额外灰度。 - 交互：输入平台作品 ID 或作品链接 → 解析出作品 ID（裸 ID / `?id=` / `?gameId=` / `/games/<id>`， 也容忍不带 scheme 的粘贴；解析不出就本地拦截、不发请求）→ 调 `create_local_project_from_platform_game`（name/planning 走默认，与模板链路一致）→ 成功后复用模板那条「原生已落盘 → 登记最近项目并进入工作区」通道进项目。 - 三类结果：① 未登录/登录过期（`authentication-required:`）→「请重新登录后重试」； ② 403 未开放授权（`permission-denied:`）与 409 未公开/已下架（`fork-source-not-available:`） 按服务端文案分别展示，且都不建项目、按钮可重试；③ 成功展示「改编自平台作品 <gameId>」 与 `reference/<gameId>/` 参考产物位置，让来源事实可见。 - 为此给取件的 404/409 补了与 401/403 同族的稳定前缀（`fork-source-not-found:` / `fork-source-not-available:`）：渲染层按前缀精确分类，不做文案子串猜测。 - 加载态：取件期间按钮禁用 + 明确提示「下载、校验、解压需要几分钟」，并用 ref 守卫挡住同一 tick 的重复提交（只认最后一次请求）。 - 文案严守产品口径：拿到的是「已构建成品」= 可玩参考 + 素材，不能直接再次发布，需在新工程里 改造后发布；不出现「一键复刻工程」这类说法。 - 门禁登记：命令已接回 App 入口，因此从 `scripts/check-config.mjs` 的 native-only 白名单移除 （该脚本要求「已接入」与「未接入」两个集合互斥）。 - 测试：新增 `tests/platformGameFork.test.tsx`（纯解析/失败分类 + 组件：空与非法输入不发请求、 403/409/401 各自提示且不建项目、加载态与重复提交、成功时命令参数与「改编自」展示）。	2026-10-05 17:30:47 +08:00
suzmii	4626aeefd4	fix(埋点合同): 服务端同步 AGC 新增的 creation_source=platform_game ... - 依据客户端提交 `5d01e43b6`：AGC 的 `CreationSource` 新增 `PlatformGame`，按 serde snake_case 落到线上取值 **`platform_game`**（同提交的 `creation_source_gains_platform_game_without_breaking_existing_values` 用例显式给出该字面量），上报字段仍是 `project_create_success` 的属性 `creation_source`。服务端枚举此前没有它，整条事件会被判 `invalid_properties` 直接丢弃 - `shared-contracts/src/agc_analytics.rs`：`values!(CreationSource { .. })` 追加 `PlatformGame`（注释与客户端一致）；解析走 serde 派生，无需新增匹配分支 - `module-runtime/src/agc_analytics.rs`：新增 `agc_accepts_every_creation_source_and_rejects_unknown`——五个受支持取值（home_game / home_design / template / selected_directory / **platform_game**）逐个通过整批校验（事件形如 `project_create_success` 且带 `project_id`），未知取值（`remix` / `platform` / `PLATFORM_GAME` / 空串）仍然失败关闭为 `invalid_properties` - 文档：`docs/technical/【技术方案】客户端本地埋点与主站入库契约-2026-09-21.md` §6.6 的 `creation_source` 取值列表补 `platform_game`（保持 `/` 分隔与 snake_case 风格） - 全仓核对：该枚举只有两处定义（AGC `analytics/contract.rs` 与 `shared-contracts`），**无第二处服务端镜像**、无 TS 联合类型、无 schema/OpenAPI 取值表；生成绑定不含该类型（埋点批量跨模块边界走 `payload_json: String`），因此无需重跑 spacetime generate	2026-10-05 17:30:46 +08:00
suzmii	e3bae05351	feat(游戏共创): 发布自动带改编声明，上架可选共创授权档位（AGC 面板三态） ... - 改编声明：`publish_local_project_game` 在**首次发布**（不带 gameId）时读取项目内 `.agent/fork-source.json`，把 `fork: { parentGameId, parentVersionId }` 并入创建作品请求； 带 gameId 的更新发布不重复带声明（服务端对「复用既有作品身份时再声明来源」失败关闭， 重复带会变成不可恢复的 409）。判据与注入点都在原生链路，渲染层既传不进也伪造不了； 声明在 `metadata_digest` 之前并入，幂等根键随之变化属预期行为。 - 授权档位：`GameDistributionPublishMetadata` / `normalizeMetadata` / `toCreateGameRequest` 接通 `forkAuthorization`（缺省 `forbidden`），发布面板新增「授权共创」三态单选， 文案复用 `packages/shared/src/contracts/gameDistribution.ts` 的标签常量；更新发布时该栏只读 并提示「共创授权只在首次发布时生效」——档位只在创建作品时生效，上架后只能单向提升。 附带按 `styles.css` 既有面板变量补齐这组 radio 的样式（不能套用整行输入框那条规则）。 - 门禁登记：新命令本轮只落 native 能力，按 `scripts/check-config.mjs` 的 native-only 清单登记。 - 测试：Rust 钉住「资料摘要同内容稳定、并入声明即变」；TS 钉住请求体形状 （带/不带档位、声明不由渲染层提交）与面板三态受控行为、更新模式只读。	2026-10-05 17:30:46 +08:00
suzmii	c5564e59ed	feat(游戏共创): 客户端落地「从平台作品开始创作」取件链路（本地来源记录 + 新命令） ... - 新增 `project/fork_source.rs`：项目改编来源记录落在 `.agent/fork-source.json` （`{schemaVersion,gameId,versionId,adoptedAtMillis}`，版本 `agc-fork-source.v1`）。 位置理由：`.agent/**` 随项目快照上云、随用户整目录拷贝，且导出包不带 `.agent`， 既随行又不干扰游戏产物；不改 `manifest.json`（它是 deny_unknown_fields + 只接受 v1）。 写入走统一入口 `write_game_creator_private_file`；读取容忍缺失/损坏/异形/非普通文件， 一律返回 None 而不报错、不 panic。 - 新增 `game_fork.rs` + `game_fork/desktop.rs` 与命令 `create_local_project_from_platform_game`（在 `desktop.rs` 的 generate_handler 注册）： 取平台会话 → 取件元数据 → 带 Bearer 下载整包 → 校验字节数与 SHA-256（失败关闭、不落盘） → `init_local_game_project_at` 生成合规 Phaser4+Vite 脚手架 → 参考副本解压到 `<project>/reference/<gameId>/`（复用 `safe_archive_relative_path` 与 `extract_template_archive` 的条目数/单文件/符号链接门禁，按最小改动把后者提到 pub(crate)） → 写来源记录；任一步失败都删掉半成品项目目录。 参考副本必须落在子目录：`create_npm_scaffold` 的判据是「没有 manifest 且根/`game` 都没有 index.html、package.json」，成品包若落在项目根或 `game/` 根，脚手架一个文件都不会生成。 - `game_distribution_publish.rs` 新增受鉴权取件实现：`fetch_platform_game_fork_source` （元数据 GET + 带 Bearer 的整包下载 + 404/409/403/401 四态可区分映射 + 下载路径同源校验）。 不复用模板库的 `fetch_limited_bytes`：它写死 `client.get(url)`，带不了鉴权头， 复用它会让受保护内容变成匿名下载。 - 埋点：新增 `CreationSource::PlatformGame`（`analytics/contract.rs` 的 values! 登记）并在建项 成功后上报，来源标识沿用模板链路的 ID 槽位。 - 修既有编译错误：`game_distribution_publish.rs` 的资料摘要测试缺 `fork` 字段 （上一提交给 `GameDistributionCreateGameRequest` 加了该字段但没同步该测试字面量）， 补 `fork: None` 以恢复测试目标可编译。	2026-10-05 17:30:46 +08:00
suzmii	9308029276	test(游戏共创): 新增创作族谱/衍生列表端到端验收脚本（含 Fork 取件通道） ... - 新增 scripts/check-game-distribution-lineage-e2e.mjs：真实 HTTP + 浏览器验收 M3 与 M2a · 404 规则：未公开草稿锚点与不存在的 gameId，/lineage 与 /derived 都断言 404 且不是成功信封空树，并断言 no-store · 真实树：完整发布链路（建版本→传包→送审→管理员通过）把母版与带改编声明的子作品推公开， 断言 rootGameId/root/节点集合/generation/parentGameId/status/作者名读取自账号展示名/代际升序/ 节点键集合恰好 7 个/响应不含对象键与素材键 · 衍生列表：锚点=母版时恰好含直接子作品且未截断 · 软删除降级：作者软删除母版后 nodes 不再含母版、root=null 但 rootGameId 仍回传、 子节点保留 generation/parentGameId、响应文本不含母版标题与作者名、已删锚点两个接口都 404 · Fork 取件通道（M2a）：未公开作品 409、公开但授权 forbidden 403、元数据 sha256/bytes/versionId 与公开版本行一致、downloadPath 为同源相对路径、按该路径下载后校验 content-type/长度/sha256/ZIP 头、 未带 Bearer 401、另一名已登录作者可取件 200 · 浏览器：详情页「查看创作族谱」入口 → /games/lineage 树渲染（母版/当前作品/作者名）→ 页面内触发父作品软删除 → 降级为「原作品已不可用」且父标题不再出现，删除前后各留截图 · 节点上限 200 未用真实 201 节点验证：改为源码常量钉住并在脚本里 NOTE 说明降级理由 - package.json：新增 npm script check:game-distribution-lineage-e2e，命名与既有 check:game-distribution-*-e2e 一致 - 实测（本地 dev 栈 + Chrome + 临时 playwright）：本脚本 90 项 90 PASS / 0 FAIL； 同时复跑 check:game-distribution-fork-authorization-e2e 48/48 未回归	2026-10-05 17:30:46 +08:00