5856 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
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
suzmii	eeb345f2ad	feat(游戏共创): 上架时即可指定共创授权档位（创建作品请求增量） ... - TS 契约 `GameDistributionCreateGameRequest` 新增可选 `forkAuthorization?: GameDistributionForkAuthorization`，注释写明缺省禁止共创、非法值整请求 400、上架后只能单向提升 - Rust 契约同结构体新增 `#[serde(default)] pub fork_authorization: GameDistributionForkAuthorization`（非 `Option`）：省略与显式传 `forbidden` 得到同一个值，**幂等摘要因此相同**——创建请求的摘要取自整个请求体，若写成 `Option` + `skip_serializing_if`，两种写法会变成「同 key 不同请求」而互相冲突；未知取值由反序列化直接拒绝 - api-server `create_game`：载荷改为 `Result<Json<..>, JsonRejection>`，拒绝统一映射成平台信封 400（与 `set_fork_authorization` 同修法），并按 rejection 文本区分文案（含 `forkAuthorization` → 「共创授权档位不合法，只接受 forbidden / nonCommercial / full」，其余 → 「创建作品请求字段不合法」；框架文本只用于选文案，不回传客户端）；创建记录入参新增 `fork_authorization: fork_authorization_value(payload.fork_authorization)` - spacetime-client：`GameDistributionCreateGameRecordInput` 新增 `fork_authorization: String` 并透传给 procedure；重新生成的 `GameDistributionCreateGameInput` 同步带上该字段 - spacetime-module：`GameDistributionCreateGameInput` 新增 `fork_authorization: String`；创建事务里用 `ForkAuthorization::parse` 解析，未知取值失败关闭（`FORK_AUTHORIZATION_UNKNOWN`，**不静默落成 forbidden**），并把原来的硬编码 `FORK_AUTHORIZATION_FORBIDDEN` 换成解析结果 - 资料编辑复用创建校验的转换函数与既有测试夹具按新字段补默认值；AGC 侧测试字面量同步（AGC 发布面板的 UI 接线留到后续，缺省值等价于不传） - 测试：`create_game_request_defaults_fork_authorization_without_changing_digest`（缺省 → forbidden；显式 forbidden 与原缺省**摘要相同**；`nonCommercial` / `full` 原样保留；`"allowed"` 反序列化失败）与 `create_game_rejects_unknown_fork_authorization_with_envelope_bad_request`（未知档位 → 400 + 平台信封且无框架纯文本；非档位字段问题走通用文案；合法载荷不会被误拒——测试态发布灰度未配置，得到 503 而非 400，即证明载荷路径已通过且未触达创建） - 文档：技术方案 §2.4（发布入口上架时即选档位）、§3.4（`POST /games` 请求增量补 `forkAuthorization`）、§3.9（补充说明上架指定档位已支持、事后提升仍保留）	2026-10-05 17:30:46 +08:00
suzmii	775dea02ea	修正 M3 族谱口径注释并抽出图装配纯函数（第二批） ... - 修正 spacetime-module 里 get_game_distribution_lineage_and_return 的文档注释：锚点不存在/已软删除/未公开一律 found=false（api-server 映射 404），并写明理由——用空标题占位或空树代替 404 等于确认该 gameId 的存在、代际与血缘位置 - 修正 shared-contracts 里节点 status 的注释：当前只有已公开作品会成为节点（未公开节点被过滤、未公开锚点直接 404），线上取值实际恒为 published；保留该字段是为将来允许非公开节点进入树时不必再改契约 - 新增纯函数 assemble_lineage_tree_entries：家族归属校验（只保留 root_game_id 命中的血缘行）、根行以 0 代入集合、游戏行缺失的行安全跳过、重复行去重（根行优先）；module 侧只负责取行与按根查索引 - 新增纯函数 resolve_lineage_author_name：账号昵称优先（trim 后非空）→ 退回发布时冻结的作者名 → 两者都空白则 None（不占位） - 新增纯函数 lineage_entry_from_game_facts：族谱装配与衍生列表共用同一份字段映射 - module 删除 game_distribution_lineage_entry，衍生列表 tx 改用共用构造函数并复用同一份行事实折叠 - 新增 6 条单测：整族装配、旁支排除、缺行跳过、无根行回退、重复行去重、作者名归一三态 - 本批未改前端；package.json 与 lineage e2e 脚本属第三个 session，未触碰	2026-10-05 17:30:46 +08:00
suzmii	c6758e5e20	style(游戏共创): 按 rustfmt 修正本分支新增代码的格式（无语义变化） ... 判定依据（先判定再动手）：仓库根 `rustfmt.toml`（edition 2024 / max_width 100 / use_small_heuristics=Default）与本地 rustfmt 1.9.0-stable 一致；`cargo fmt --all --manifest-path server-rs/Cargo.toml -- --check` 的红项（24 处 hunk / 7 个文件）**全部落在本分支新增的代码上**，且 master 版本的同名文件在同样配置下是干净的（`git show 6c9566058:...errors.rs` 单文件 --check 通过），另三个 workspace（tauri / unity / godot）也 CLEAN。因此是本分支引入的格式漂移，不是环境差异——仓库 `npm run check:rustfmt`（在 `npm run lint` 里）会因此失败，故修正。 - api-server/src/modules/game_distribution.rs：两处 import 列表按宽度重排；`derived_games_payload` / `lineage_tree_payload` / `set_game_distribution_fork_authorization` 调用与 `fork_source_target` 的 `Err(...)`、取件相关测试的换行与尾逗号 - spacetime-module/src/game_distribution.rs：3 处 `return Err(...)` 与 `let Some(game) = ctx.db...` 的换行 - spacetime-client：`active.rs` 的 import 列表、`mapper/game_distribution.rs` 的 `collect()` 链、`game_distribution.rs` 的 procedure 回调换行 - module-game-distribution：`domain.rs` 的错误码字面量元组、`errors.rs` `Display` 分支的换行 验证：`cargo fmt --all --manifest-path server-rs/Cargo.toml -- --check` 退出 0；逐文件比对「删除全部空白后」的字符流，差异仅为 rustfmt 展开/折叠时增删的**尾逗号**（每文件长度差 ≤4 字符），无语义变化；格式化后 `cargo check --all-targets` 与 `cargo test -p api-server game_distribution`（52 passed）仍通过。	2026-10-05 17:30:45 +08:00
suzmii	8f87c826cf	feat(游戏共创): M2a 受鉴权内容下发通道（fork-source 元数据 + 整包取件） ... - 契约：新增 `GameDistributionForkSourceKind` / `GameDistributionForkSource` / `GameDistributionForkSourceResponse`（shared-contracts + TS 镜像 + parity 登记），字段 `gameId / versionId / source / sha256 / bytes / downloadPath`，**不含对象键** - 读取：spacetime-module 新增 `GameDistributionForkSourceInput`、扁平结果类型与 procedure `get_game_distribution_fork_source_and_return`；tx 把「行是否存在 / 能否作为来源（未删+已公开+有当前公开版本）/ 授权档位原值」分开回传——既有 owner-or-public 读会把「已软删除」与「未公开」都折成 None，HTTP 层就没法区分 404 与 409；`sha256` / `bytes` 取自版本行，不重算 - 客户端：spacetime-client 新增 record + mapper + `get_game_distribution_fork_source`（生成绑定把 `package_sha256` 折成 `package_sha_256`，与版本快照同约定） - 路由：新增 `fork_sources` 子路由（`require_bearer_auth` + `add_no_store_response_headers`，**不叠加发布灰度**），两条：`GET …/fork-source`（元数据）与 `GET …/fork-source/package`（ZIP 字节） - 校验：抽出纯函数 `fork_source_target` 供两个 handler 共用——404 `FORK_SOURCE_NOT_FOUND` / 409 `FORK_SOURCE_NOT_AVAILABLE` / 403 `FORK_NOT_AUTHORIZED`（未知档位按禁止解释）；`available` 为真却缺版本元数据时失败关闭为 409 - 取件本体：复用发行网关的 `release_package_bytes`（整包进内存 + 进程内缓存，4 条 / 256 MiB），不新造 OSS 客户端；缓存值由 `Arc<Vec<u8>>` 改为 `Bytes`，整包交给响应体只加引用计数、不复制；响应**不做**引用归一化与 `RELEASE_STORAGE_BOOTSTRAP` 注入（下发原始构建产物，客户端按摘要校验后离线解压）；`RELEASE_PACKAGE_CACHE` 顺手改用 `LazyLock`（初始值编译期已知） - 路径：`downloadPath` 为同源相对路径，复用新抽出的 `is_path_safe_game_id`（与发行入口同一判据），绝不下发对象键 - 测试：新增 4 条——两条路由未带 Bearer → 401；`fork_source_target` 的 404 / 409 / 403 / 未知档位 / 缺元数据失败关闭逐项断言（409 先于 403）；元数据 payload 的 sha256/bytes 取自行、downloadPath 形状、序列化后不含对象键；取件包头与长度（`application/zip`、`Content-Length` = 行 `package_bytes`、`Content-Disposition`、`no-store`） - 文档：技术方案 §3.4 把两个接口从「规划」改成与实现一致的形状，并单独拆出「登录用户（Bearer，不叠加发布灰度）」小节；§3.5.1 的「下载通道（当前不存在）」改为 M2a 已实现，写明它只服务当前公开版本、不做归一化、大包续传仍待做	2026-10-05 17:30:45 +08:00
suzmii	1ce3adb8d0	修复 M3 复核问题（第一批）：族谱页双重空态、节点上限常量未钉住、窄屏网格溢出 ... - 族谱页空态收敛为一条：nodes 为空时只给整体空态（这部作品还没有可展示的族谱节点），有节点但无衍生时才给衍生空态，两者互斥不再同时渲染 - 新增两条组件用例覆盖该组合：空树只出现一条空态且无 .game-lineage-tree；只有母版时渲染母版节点 + 衍生空态且不出现整体空态 - 纯函数测试改用 GAME_DISTRIBUTION_LINEAGE_NODE_LIMIT 常量，并新增 node_limit_constant_is_pinned_and_governs_truncation：同时钉住常量值 200（合同值）与满量/超量时的 truncated 行为，改常量或改截断实现都必须过门 - LineageTreeNode 文档写明作者名空值语义：空串/纯空白归一为 None 与 M1 的 fork_lineage_visible_identity 三态刻意保留属有意为之，两端展示层按 falsy 判断、行为等价 - 族谱节点网格列下限改为 min(13rem, 100%)：桌面列宽不变，极窄视口不再横向溢出 - 未动涉及 M2a session 的 spacetime-module / shared-contracts 注释与 lineage_entries 图装配测试，留待第二批	2026-10-05 17:30:45 +08:00
suzmii	39669763fe	实现游戏共创 M3：创作族谱树与衍生列表 ... - 新增 module-game-distribution/src/lineage.rs：锚点可读性、可见性过滤、稳定排序、上限截断的纯函数，附 15 个单测（复用 M1 的软删除判定，不重写第二套规则） - 新增公开只读 procedure get_game_distribution_lineage / list_game_distribution_derived_games；锚点必须公开可读（未公开/已软删除/不存在一律按不存在处理），树内只出现未软删除且已公开的节点，不补 null 占位节点 - api-server 新增 GET /games/{id}/lineage 与 /games/{id}/derived（匿名可读、no-store），响应走结构化 DTO，节点键集合由测试钉死，杜绝下发对象键/素材键 - 作者自有游戏聚合追加 forkCount（与公开详情 forkCount 同口径），供「被改编 N」入口使用 - shared-contracts 与 TS 契约新增 LineageNode / LineageResponse / DerivedResponse 三型并登记 DTO 一致性检查 - 前端新增 /games/lineage 族谱页，登记 stage 类型、路由表、页面标题与壳层渲染分支；详情页共创卡新增「查看创作族谱」入口（仅已公开作品） - 我的作品页新增「被改编 N」行内展开，列出直接子代的标题/作者/代际/状态，含空态与失败重试（仅已公开作品） - 补前端组件/路由/标题/客户端用例与 api-server 路由、负载映射用例；同步里程碑验收标准与技术方案 §3.4 的锚点可读性口径	2026-10-05 17:30:45 +08:00
suzmii	3d51d1309a	docs(游戏共创): 技术方案里提升共创授权的方法改为 PUT，与实现一致 ... - §2.6 流程图 A：`后续提升授权（POST fork-authorization，仅升）` → `后续提升授权（PUT /games/{gameId}/fork-authorization，仅升）` - §3.4 作者路由表：`POST /games/{gameId}/fork-authorization`（新） → `PUT /games/{gameId}/fork-authorization`（新） - 依据：实现侧（api-server `set_fork_authorization` 的 PUT 路由 + 前端 `updateGameForkAuthorization` 的 PUT + M1 实施计划 `PUT /api/game-distribution/games/{game_id}/fork-authorization`）一致为 PUT；表中路径沿用本节开头声明的 `/api/game-distribution` 命名空间，故未重复写前缀 - 顺手扫了全仓 `docs/`：除本文件这两处外没有其它把该路由写成 POST 的地方（`POST /games` 是既有的创建作品路由，与本次无关，未动）	2026-10-05 17:30:45 +08:00
suzmii	1f243f4edf	test(游戏共创): 新增作品级共创授权端到端验收脚本 ... - 新增 scripts/check-game-distribution-fork-authorization-e2e.mjs（789 行）： 真实 HTTP + 浏览器端到端验收作者侧共创授权链路 —— 从 .app/dev-stack.json 读栈地址； 开 game-distribution:publish 灰度；注册两个真实作者；上传封面并创建作品； 断言三态提升阶梯（forbidden→nonCommercial→full）、降级 409、过期 CAS 409、 未知档位 400、非作者 403、未带 Bearer 401、同 key 同 body 重放 replayed=true、 以及越权/非法请求无副作用；浏览器侧用 Playwright 在 /games/mine 断言入口与三态 编辑器（当前档位不可点、更高档位可点）并真跑一次网页提升，截图留档。 - package.json：新增 npm script check:game-distribution-fork-authorization-e2e， 命名与既有 check:game-distribution-*-e2e 保持一致。 - 实测：本地 dev 栈 + Chrome（E2E_PLAYWRIGHT_DIR 临时 playwright）跑 48 项断言 48 PASS / 0 FAIL；npm run check:encoding 通过。	2026-10-05 17:30:45 +08:00
suzmii	e9003a33bd	fix(游戏共创): 未知共创档位回平台信封 400，而不是框架 422 纯文本 ... - api-server `set_fork_authorization`：载荷由裸 `Json(..)` 改为 `Result<Json<GameDistributionSetForkAuthorizationRequest>, JsonRejection>`，拒绝统一映射成 400 + 平台信封（对齐同模块评价保存 / 评价管理两处的既有写法），文案「共创授权档位不合法，只接受 forbidden / nonCommercial / full」 - 保留领域层 `FORK_AUTHORIZATION_UNKNOWN`（map_spacetime_error 里映射 400）：procedure 读到库里存的未知档位字符串时仍由它兜底，HTTP 面不再可达不需要删 - 新增 HTTP 级用例 `set_fork_authorization_maps_unknown_authorization_to_envelope_bad_request`：目标档位未知、期望档位未知各断言 400、平台信封（`ok=false` / `data=null` / `error.code=BAD_REQUEST` / message 含「共创授权档位不合法」/ `meta.apiVersion` 存在），并断言响应体不含框架的 `Failed to deserialize` 纯文本；用生产同一套 `attach_request_context` 中间件 + `x-genarrative-response-envelope: v1` 才拿得到信封形状 - 既有的「共创授权路由未带 Bearer 必须 401」用例保持不变（`catalog_and_publish_routes_are_mounted` 通过） - 技术方案 §5.1：新增「未知共创档位（HTTP 面合同）」证据行	2026-10-05 17:30:45 +08:00
suzmii	036989d1cc	test(游戏共创): 软删除×Fork 三条规则提取为纯函数并补单测 ... - domain.rs：新增三个不依赖 SpacetimeDB / ReducerContext 的纯函数 · `can_serve_as_fork_source(is_deleted, is_published)`：来源可用性 = 未软删除 且 已公开 · `counts_as_public_derivative(is_deleted, is_published)`：衍生计数纳入，同条件但动机不同（避免虚报热度、避免泄露「这里曾有个作品」），单独成函数以免两条规则将来互相牵连 · `fork_lineage_visible_identity(parent_available, parent_title, parent_author_name)`：父可用才透传；父不可用必须返回 (None, None)，不做任何「拿不到标题就回退用行数据」的降级 - lib.rs：在既有 `pub use domain::{...}` 列表中导出上述三个函数（一行） - spacetime-module：三处调用点改为调用纯函数，行为完全不变——来源守卫合并为一个 `if`（仍统一映射 FORK_SOURCE_NOT_AVAILABLE）、衍生计数 filter 传入两个布尔、血缘快照的父身份与根标题共用同一函数；`visibility` 判定仍由 module 侧折叠成布尔 - domain.rs 测试：新增 `fork_soft_delete_tests` 5 条——来源可用性四组合（含「已删但 visibility 仍是 published」必须 false）、计数纳入四组合、父可用透传、父不可用即使传入非空标题/作者名也必须 (None, None)、作者名三态（None→None / 空串→空串 / 只含空白原样透传） - 技术方案 §5.1：把「权限与边界」行的说明改为已由纯函数单测覆盖的三条规则（真实栈用例仍标注待补）；「软删除语义收敛 ③溯源摘要」行补上 `fork_lineage_visible_identity` 单测证据	2026-10-05 17:30:45 +08:00
suzmii	d9c53a5b75	docs(游戏共创): 按只读侦察事实修正 M2a 方案：成品包只能试玩不能重发 ... - 技术方案 §2.5：把「成品包 = 产物级改造（可发布）」改成四列表（新增「能不能再发布」列），写明成品包只能试玩与提取素材、**不能直接重新发布**；补「被否证的旧表述」对照段并指向 §3.5.1/§3.5.4 - 技术方案 §1.3：新增三行缺口事实——无「按版本取 ZIP」的下载通道、导出/发布强制 Phaser 4 + Vite 声明、发行包只含 dist + 根 assets + exports/README（不含 package.json 与源码） - 技术方案 §3.5：加术语更正块；§3.5.1 重写为「零新增上传资产，但只到『可玩参考』」——试玩成立（verification.rs:49-66）与发布必然被拦（export.rs:262-265 → :405-470；注释 :407-408、反例测试 :1239-1243）、成品包无工程声明可补、下载通道当前不存在及其内存/无续传代价 - 技术方案 §3.5.4（新增）：A 参考式改编 / B 只做工程源包 / C 伪工程三条路线与推荐（A 先行、B 为正解排后续、C 不做），标注为待用户拍板材料；附 A 路线的脚手架触发互斥点 - 技术方案 §2.4 / §2.6：唤起方式（deep link 当前未注册）标为待拍板；审核队列标注文案改为「仅成品包可玩参考，不能直接发布」；用户流程图改为目标形态并加说明 - 技术方案 §5：验收表把「一键改造闭环 / 产物级改造路径」拆成源码路径闭环、参考路径（试玩 + 素材，且界面不得承诺可发布）、交付口径一致三条 - 技术方案 §6：M2a 行改名为「参考式改编（只试玩 + 素材 + 血缘，不含重新发布）」并注明成立前提；M2b 行标注为「一键复刻完整工程」的唯一正解路径 - 技术方案 §7：改写原第 1 条（其「成品包路径默认要做」的前提已被否证），追加第 8–12 条待拍板项（对外表述 / 血缘承载位 / 是否立刻做工程源包 / 唤起方式 / 是否允许伪工程） - 里程碑「成品包改造闭环」：按事实重写「目标 / 范围 / 不在范围内 / 依赖与前置条件 / 验收标准」，新增「事实依据」四条与「前置决策（未拍板前不得实现）」五项，删除全部「能发布」的验收项，改为「本地试玩 + 素材提取 + 在自建合规工程里发布时携带血缘」 - 里程碑「作品工程源包与一键改造」：标注为正解路径；新增前置依赖①「工程包下载/授权」接口（当前不存在）与②包内禁项定义（服务端已拒绝 node_modules / .git / .env* / *.map / *.pem / *.key 与嵌套 zip），并同步「降到试玩+素材参考」的口径	2026-10-05 17:30:45 +08:00