3170 Commits

Author	SHA1	Message	Date
suzmii	ee3e1c0c55	fix(游戏共创): 源码公开确认改回默认勾选（与「允许共创即开放源码」口径一致） ... 按产品裁定回落默认值：保留主动取消能力与全部知情告知，但确认项**默认已勾选**—— 「允许共创本身就意味着源码开放，不设独立开关」，默认不勾选等于第二个开关，与本面板 自己写着的那句「没有单独的源码可见性开关」自相矛盾。 - `projectBundleConfirmed` 初值 true；每次重新选择授权档位都重置为「非禁止档位即已勾选」， 避免把上一次的取消状态带到新的档位选择上（禁止共创时不显示该确认项，值本身无意义）。 - 告知文案一字不减（整个项目目录原样公开、含文档/截图/设计稿/笔记、只自动排除依赖/版本库/ 构建产物/常见凭据、一经发布不可撤销、无法收回已下载内容）。 - 新增一句提示说明默认值来源：「上面这项默认已勾选（平台按「允许共创即开放源码」的默认帮你 勾上，不是替你做决定——你可以随时取消）。」——避免作者以为平台偷偷替他决定。 - 未勾选时的后果提示保留，仍写清「不勾选则本次不上传工程源码……」。 测试（面板 23 条）：默认「禁止共创」无确认项；切到非禁止档位后确认项出现且**已勾选**， 并逐条断言告知文案 + 「默认已勾选/可随时取消」；默认状态提交不携带 `includeProjectBundle` （交给原生按授权执行上传）；作者主动取消后提交携带 `includeProjectBundle: false`（这是 「作者能退出」的证据）；重新选择档位回到已勾选；切回「禁止共创」确认项消失。	2026-10-05 16:31:02 +08:00
suzmii	e74148a755	fix(游戏共创): 工程源码公开改成作者的主动知情确认，文案如实告知外发范围 ... 背景（对抗性复核 D.7）：工程源包的拒绝规则是**黑名单**，作者的 `docs/`、`*.pdf`、`notes.txt`、 截图、设计稿、会议记录等不在任何拒绝集内，会被原样外发。也就是说「授权非禁止 + 上传工程源码」 = **整个项目目录（除少数排除项）对任何登录用户公开**。原来那句「同时公开工程源码……取消勾选则 只能被试玩」是免责声明式措辞，不足以构成知情同意。 文案（最终措辞）： - 授权三态说明统一口径：「授权非「禁止共创」即允许他人改编（**没有单独的源码可见性开关**）； 是否随本次发布把工程源码一起交出去，由下面的确认决定。上架后授权只能单向提升，不能撤销。」 - 确认项（仅授权非「禁止共创」且首次发布时出现）： 「我已确认项目里没有不愿公开的内容，同意随本次发布公开**整个项目目录**：源码、素材与其中 其它文件（含文档、截图、设计稿、笔记等）都会对任何登录用户公开；只会自动排除依赖目录、 版本库、构建产物与常见凭据文件。一经发布**不可撤销**：即使之后把授权降级，也无法收回别人 已经下载的内容。」 - 紧随其后写清不勾选的后果：「不勾选则本次不上传工程源码：作品仍可正常发布，但他人只能拿到 已构建成品试玩与参考，不能直接重新发布。」 交互选择：**默认不勾选 + 不勾选就不上传**（不是禁用发布按钮）。 - 选它的理由：① 它把第 3 点做成了真正的「主动确认动作」；② 发布本身不被阻断——工程包缺失本来 就不影响发布（服务端与原生链路都按「可选资产」设计），禁用按钮反而会把「禁止共创 / 只想先发 出去」的作者一起挡住；③ 勾选状态只作用于本次版本上传，不引入平台侧的独立开关，授权语义不变。 - 注意：这一条**取代**了早先「授权非禁止时默认帮作者上传」的默认值——知情同意优先于默认帮忙； 若要把默认值改回勾选，只需把 `projectPackageConfirmed` 初值改成 true 并翻转对应断言。 测试：改写两条面板用例——授权开放后确认项出现且**默认未勾选**、九处告知文案逐条断言（整个项目 目录 / 含文档截图设计稿笔记 / 只自动排除四类 / 不可撤销 / 无法收回已下载内容 / 不勾选则不上传 / 没有单独的源码可见性开关）、未确认时显式传 `includeProjectBundle: false`（不上传但照常发布）、 确认后不带该字段（由原生按授权执行上传）。	2026-10-05 16:24:52 +08:00
suzmii	e4e0fb7d3b	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 16:18:17 +08:00
suzmii	da24dd5bee	fix(游戏共创): 取件成功提示按两种取件形态如实措辞 ... M2b 之后取件有两种形态：工程源包解压即可编辑工程（没有 reference/ 参考副本），成品包才放在 reference/<gameId>/ 作可玩参考。原来的成功提示写死「参考产物在 reference/<gameId>/ 下」， 对工程源包形态是错的。改为两种情形都说明，并同步测试断言（仍保留「改编自 X」这条来源事实）。	2026-10-05 16:12:32 +08:00
suzmii	72f08c2646	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 16:10:46 +08:00
suzmii	5dd9d1c5d9	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 16:10:12 +08:00
suzmii	4d070dd1a9	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 15:57:20 +08:00
suzmii	be282d2b29	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 13:51:31 +08:00
suzmii	a6a235521c	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 11:24:15 +08:00
suzmii	317644aaba	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 10:27:17 +08:00
suzmii	04b99f8e8e	收口 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 04:40:07 +08:00
suzmii	b995cc8dd4	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 04:16:54 +08:00
suzmii	00ff911621	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 02:39:31 +08:00
suzmii	5d01e43b6e	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 02:31:30 +08:00
suzmii	bab47484b3	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 01:59:41 +08:00
suzmii	6c95660588	Merge pull request '优化 AGC 工作台顶栏布局：一行到底、版本入口钉右分级、播放并入运行页签（Issue #613）' (#615) from fix/agc-toolbar-layout into master ... Reviewed-on: #615	2026-10-04 20:04:30 +08:00
suzmii	42364befb1	同步发布面板测试：删除已废弃的「按首版」提示断言 ... - tests/gameDistributionPublishPanel.test.tsx：删除「已有绑定时进入更新模式，回填线上资料并按派生项目版本提交原 gameId」用例中对 /本次发布按首版 v1。/ 的断言（该文案随 5a651f3ea 删除 projectVersionHint 一并下线，属遗漏同步） - 版本派生本身仍由同用例的「项目版本」只读值 1、提交参数 versionNumber=1 覆盖，断言能力未削弱	2026-10-04 19:43:27 +08:00
suzmii	5a651f3eae	删除发布面板冗余提示文案 ... - GameDistributionPublishPanel.tsx：删除「项目版本」下的说明段（projectVersionHint 派生逻辑与其 useMemo、以及渲染它的 hint span），面板不再写「发布将使用最新内部版本 v{N}…」「线上最近提交 vN 是平台侧事实…」 - GameDistributionPublishPanel.tsx：删除简介/分类的三态提示文案（「正在根据创作内容生成简介和分类…」/「AI 已根据创作内容生成…」/「已根据创作内容预填…」）及支撑它们的 metadataSuggestionPending、metadataSuggestionReady 两个 state 与请求完成后的置位，保留静默预填行为 - apps/ai-game-creator-shell/src/styles.css：删除随上述提示一起作废的样式（-7 行） - tests/gameDistributionPublishPanel.test.tsx：同步删除对已废弃提示文案的断言（-15 行）	2026-10-04 18:45:56 +08:00
suzmii	f418ecfee9	Merge branch 'master' into fix/agc-toolbar-layout	2026-10-04 18:37:56 +08:00
suzmii	ab1045f72d	Merge remote-tracking branch 'origin/master' into feat/game-works-management	2026-10-04 18:28:11 +08:00
suzmii	2e74092743	发布版本文案去诱导：卡面角标只写最新，面板写明发布固定取最新内部版本 ... - resourceProjectionModel.ts：publicationTag 注释改为「值是内部版本序数（versions.length），也就是发布时会提交的那个标签」，并注明卡面只渲染中性的「最新」角标，不再写「发布标签 v{N}」 - GameDistributionPublishPanel.tsx：「项目版本」说明注释写明发布提交的标签是 versions.length（最新内部版本序数），不读任何「选中版本」；画布上的选中/「当前版本」只影响当前版本素材与运行播放哪一版 - index.tsx / styles.css：版本卡角标由「最新 · 发布标签 v{N}」改为中性的「最新」，并换用卡面既有的中性 pill 样式 - gameDistributionPublishPanel.test.tsx：同步旧的角标/文案断言	2026-10-04 17:58:50 +08:00
suzmii	8ada23ea0e	修复：AGC 工具调用组折叠箭头展开时仍朝下 ... - 删除 .agent-tool-call-group-head[aria-expanded='true'] .agent-tool-call-group-chevron 的 rotate(180deg)，消除与共享 AgentProcessSummary wrapper 叠加的 360° 旋转 - 在 .agent-tool-call-group-chevron 上方补注释，写明换向唯一来源在共享 wrapper，避免再次重复旋转	2026-10-04 17:34:27 +08:00
suzmii	206c625a58	顶栏两端留给两枚大分组：排序分段收行尾，版本入口移到它左边 ... - index.tsx：把「依赖 / 类型」分段从动作区中部挪到动作行最后一个子元素，版本入口紧邻其左（版本不再是最右那一枚） - styles.css：排序分段左边距的注释改成与左邻无关（现在左邻是版本入口） - 用例：资源版本切换新增顶栏顺序断言（版本入口在排序分段之前、排序分段是动作行行尾）；生成任务侧栏用例改判排序分段为动作行最后一个子元素 - 文档：PRD 两端分组条款、验收用例 S16 入口位置、决策记录、改动后对照图与 README 重拍	2026-10-04 17:14:26 +08:00
suzmii	aa4d178956	去掉与 master 重复的游戏评价页排布实现 ... - AdminGameReviewsPage.tsx：删除我们新增的重复 tableClassName（master 已在同一组件上有一份，保留 master 那处），保证同名 JSX 属性只剩一处 - AdminGameReviewsPage.tsx：操作列 td 去掉 className="admin-game-reviews-actions-cell"（该 class 的唯一样式来源已随本提交删除，留着就是死代码） - styles/admin.css：整段删除我们尾部新增的平行实现（.admin-game-reviews-table th:last-child 与 .admin-game-reviews-actions-cell .admin-action-row 的 width/nowrap/flex-end） - 保留 master 的评价列表排布体系：.admin-game-reviews-table .admin-status、td:last-child .admin-action-row{flex-wrap:nowrap;justify-content:flex-start} 与 >button{flex-shrink:0} - 自证：tableClassName="admin-game-reviews-table" 命中 1 处；admin-game-reviews-actions-cell 命中 0 处	2026-10-04 16:37:56 +08:00
k88936	a79b9e9f9c	Merge branch 'master' into test/silent-is-gold	2026-10-04 16:31:59 +08:00
suzmii	ee6f1d43c9	Merge remote-tracking branch 'origin/master' into feat/game-works-management	2026-10-04 16:23:57 +08:00
suzmii	620ac52461	后台游戏审核页展示游戏名与作者，不再只显示 gameId ... - AdminGameDistributionReviewPage.tsx：待审列表只回版本字段，新增 resolveGameMeta 用既有后台作品列表接口按 gameId 反查标题/作者，逐游戏去重并按会话缓存；单个游戏取不到只回落显示 gameId，不阻断审核列表 - 同文件：loadReviews 在拿到 entries 后并行补齐本页 distinct gameId 的元数据 - 同文件：游戏列由单个 gameId 文本改为「游戏名（主行）+ 作者名与 user_id（副行，截断显示，完整值放 title）」 - adminGameDistributionReview.css：以 .admin-game-review-game 网格布局替换 .admin-game-review-game-id，保留窄视口截断与 title 出口 - AdminGameDistributionReviewPage.test.tsx：补 listAdminGameDistributionGames 的 mock 与游戏列表 fixture，断言由 gameId 改为游戏名	2026-10-04 16:15:24 +08:00
suzmii	137898d182	游戏评价页操作列按内容取宽，避免按钮换行错行 ... - AdminGameReviewsPage.tsx：评价列表加 tableClassName="admin-game-reviews-table"，操作列单元格加 admin-game-reviews-actions-cell（与游戏管理页操作列同口径） - styles/admin.css：新增本页专属规则，操作列 width:1% + white-space:nowrap，动作行 flex-wrap:nowrap 并右对齐，避免「删除 / 查看详情 / 隐藏」被挤到第二行 - 选择器全部框在 .admin-game-reviews-table 内，不影响其它后台页面	2026-10-04 16:15:18 +08:00
suzmii	9eb537c6ff	运行视图没有画面时自动补一次载入（进入项目/切项目的运行页空态） ... - index.tsx：新增 autoRunPreviewProjectRef 记账，站在运行视图却没有可嵌入预览且可运行时自动补发一次 onPlay，同一个项目只补一次 - index.tsx：showRunView 先记账再发播放，避免点页签时被自动补发重复触发一次 - 用例：新增 runAutoLoadOnEnter（切项目自动补发一次、同项目不重复、点页签只发一次、有活体预览时不补发） - 文档：PRD 顶栏条款、验收用例 S17 判据、decision-log 同步自动载入口径	2026-10-04 15:56:41 +08:00
k88936	b5a39f425e	Merge remote-tracking branch 'origin/master' into test/silent-is-gold	2026-10-04 15:51:59 +08:00
k88936	84c30b680c	配置：CI 测试成功静默改用 cargo/node 原生 quiet ... - .gitea/workflows/project-ci.yml：全局加 CARGO_TERM_QUIET=true，cargo test 成功只打点号、失败才列用例名。 - scripts/build-gitea-rust-cache.sh：预热脚本同步 CARGO_TERM_QUIET=true，与 workflow 的 Cargo 环境一致。 - package.json：agc:plugins:test 改用 node --test --test-reporter=dot。 - apps/ai-game-creator-shell/package.json：bundled-resources:test 改用 node --test --test-reporter=dot。 - scripts/check-native-shells.mjs：去掉每个 step 的成功进度标签，失败时才打印标签。 - scripts/project-ci-workflow.test.ts：移除 silent: true 守护用例。 - docs/project-memory/shared-memory/decision-log.md：移除本次静默决策条目。 - docs/project-memory/shared-memory/development-workflow.md：移除本次静默说明段落。	2026-10-04 15:49:34 +08:00
suzmii	7c5bcc4fb0	内部版本登记后立即宣告清单失效，版本卡不再需要重开项目才出现 ... - 根因：版本追加只写盘、不发「清单已变」事件，而前端被当作「回合结束刷新」的那次调用实际发生在入队时（useDirectProjectChatController.ts:588-592 紧跟 startTurn 的 finally，await 的只是 enqueue_direct_codex_turn），于是 agent 追加版本后无人重读清单，新卡必须先重开项目才出现（旁证：resource-layouts/dependency.json 里 74 分钟缺该版本，直到重开项目才补齐） - 修复：版本真正追加成功时才 emit_game_creator_manifest_invalidated(root, "direct-codex.version")（与素材工具桥同口径），订阅侧立刻重读清单 - 版本卡显示顺序：orderIndex（内部版本序数）+ compareResourceOrder，修正初始版本被排到最后（4 版读作 2/3/4/1 → 现为 1..N 单调）；不带 orderIndex 的资源排序与坐标逐值不变 - 最新版本卡角标：`最新 · 发布标签 v{N}`（只给 versions 最后一条，N = versions.length = 发布面板取的标签） - 发布面板文案：「本次发布标签 = 最新内部版本 v{N}；agent 再改进一次后，下一次发布将是 v{N+1}」，并保留「平台线上号是平台侧事实、与本标签互不推导」 - 验证：vitest apps/ai-game-creator-shell/tests 1935 passed / 0 failed；cargo check（带编辑器 feature）通过；encoding / typecheck 通过；真机未验（环境重新拉起前无法核验，待补）	2026-10-04 15:13:31 +08:00
suzmii	2f6df57ce2	Merge remote-tracking branch 'origin/master' into feat/game-works-management ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md # docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md # server-rs/crates/api-server/src/modules/game_distribution.rs # server-rs/crates/spacetime-client/src/active.rs # server-rs/crates/spacetime-module/src/game_distribution.rs # src/components/game-distribution/GameDistributionPages.test.tsx	2026-10-04 15:00:23 +08:00
lhk229	33552d2ed6	修复游戏评价操作列左对齐 ... 将评价列表操作按钮与操作列头左对齐 同步评价列表布局规范	2026-10-04 07:52:24 +01:00
suzmii	0e75d132a7	修正运行页刷新用例的 preview 类型：改用 GameCreationAppPreviewState ... - runPreviewRefresh 的 preview 形参从自造字面量类型改为契约类型，避免 status 被放宽成 string 与 view 的 props 冲突（tsconfig.tests.json 才会覆盖 tests/ 目录，此前只跑 tsc -p tsconfig.json 漏检） - 已跑 npm run ai-game-creator-shell:typecheck（含 check:tests:types）与定向用例确认通过	2026-10-04 14:48:28 +08:00
lhk229	a1b80ffde9	修复后台游戏评价状态与操作按钮换行 ... 为游戏评价列表增加专属表格样式类 状态胶囊保持单行，操作按钮禁止换行和压缩 同步后台评价列表布局规范	2026-10-04 07:47:13 +01:00
suzmii	b8849b8c01	优化 AGC 工作台顶栏布局：一行到底、版本入口钉右分级、播放并入运行页签 ... - 顶栏去掉两侧 flex-wrap、工具条改 overflow: hidden，空间不足按 data-layout 三档降级而不是换行 - 新增 workbenchToolbarModel（档位顺序与 1px 判据）与 useWorkbenchToolbarLayout（ResizeObserver 管宽度、MutationObserver 管内容，实测内容宽度写档位） - 版本入口 margin-left: auto 钉在动作区最右，标识改「版本 N（原因 · 时间）」，窄档只留「版本 N」（序号复用资源画布版本卡编号口径） - 新增 WorkbenchMoreActionsMenu：「打开项目目录 / 资源面板 / 整理画布」在 collapsed-actions 档收进「更多」下拉 - 删除独立「播放」按钮，运行页签前加 ▶ 图标，点页签即切视图并载入游戏资源 - 运行画面右下角新增「刷新运行画面」，LocalGamePreviewFrame 新增 reloadNonce 换 iframe 元素身份重新载入页面 - 用例：新增 workbenchToolbarLayout / runPreviewRefresh；改写 appSurface 顶栏与播放/刷新断言、版本标识断言与顶栏样式断言	2026-10-04 14:04:02 +08:00
kdletters	81cfbae207	后台侧栏按业务分组支持折叠 ... 新增后台侧栏业务分组与当前页自动展开行为 补充折叠交互、路由分组和权限过滤测试 同步后台导航分组行为文档	2026-10-04 13:25:58 +08:00
suzmii	3cca4fb99c	项目版本卡按内部版本序数排序，修正初始版本被排到最后 ... - 根因：版本投影的显示顺序走依赖视图、同层按 opaque 资源 id 做字符串排序，而 `version:initial-*` 的字符串序大于 `version:agent-*`，于是初始版本被排到最后（4 个版本读作 2/3/4/1，既与卡面「版本 N」序号冲突，也与「最新版本 = 发布标签」冲突；已落盘坐标 agent-22(0,0) agent-42(228,0) agent-46(0,168) initial-13(228,168) 为证） - 改法：`ProjectResource` / `ResourceCanvasItem` 增加 `orderIndex`（= 内部版本序数，仅项目版本资源携带），新增 `compareResourceOrder`（先比序键、再回落 opaque id）并替换依赖视图 4 处 `compareStableIdentifier`；类型视图在 mediaType 之后插入序键比较（顺带修掉 ≥10 个版本时「版本 10」被字符串序排到「版本 2」之前的错位） - 兼容性：不带 `orderIndex` 的其它资源排序结果与落盘坐标逐值不变 - 验证：`npx vitest run apps/ai-game-creator-shell/tests` 199 文件 / 1935 passed / 0 failed；`npm run agc:typecheck` exit 0；`npm run check:encoding` passed；`git diff --check` 干净；真机 CDP 用 Vite 现网真实模块 + 真实 manifest 复算落位：修复前 2→3→4→5→1，修复后 1→2→3→4→5	2026-10-04 13:11:37 +08:00
suzmii	ddc3832279	Merge remote-tracking branch 'origin/master' into feat/game-works-management	2026-10-04 12:30:52 +08:00
suzmii	fa0427e595	去掉 AGC 发布抽屉的可见滚动条 ... - 改动规则：apps/ai-game-creator-shell/src/styles.css 的 `.game-distribution-publish-panel` 追加 `scrollbar-width: none` 与其 `::-webkit-scrollbar { display: none; }` - 为什么用 scrollbar-width: none：该抽屉自身就是唯一滚动区（用户口径：这条抽屉里的滚动条太丑）；实测隐藏后引擎不再为滚动条预留槽位，内容宽度恒定、无宽度跳变 - 另一条 webkit 规则的必要性：`scrollbar-width` 只覆盖标准路径（Firefox / 新引擎），Chromium / WebView2（AGC 真机）仍需 `::-webkit-scrollbar` 才能隐藏，否则真机上滚动条依旧可见 - 真机实测结论（CDP，WebView2）：滚动条布局占位 15px → 0，`clientWidth` 503 → 518，`scrollTopMax` 231 不变，滚轮与键盘仍可滚到底 - 验证命令：`npm run check:encoding`、`git diff --check`	2026-10-04 12:29:15 +08:00
kdletters	13a15fed5c	修复 AGC 渠道更新互相终止与快捷方式迁移 ... 为 release 与自定义渠道注入独立主程序名，隔离 Windows 更新进程。 新增 release 旧安装目录与快捷方式迁移钩子，保护 dev 历史目录清理。 同步渠道规范、共享决策与排障记录，补充发布脚本回归测试。	2026-10-04 11:45:20 +08:00
suzmii	0168aa7bc3	Merge remote-tracking branch 'origin/master' into feat/game-works-management ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md # docs/project-memory/shared-memory/pitfalls.md	2026-10-04 11:27:10 +08:00
suzmii	8abc35158c	Merge branch 'master' into feat/game-works-management	2026-10-04 09:23:45 +08:00
suzmii	4fc13bcfe3	合并 fix/ci-master-red（PR #609）到 fix/agc-canvas-reference-insert：取得 master 级 CI 修复 ... 把 #609 的 8/8 全绿修复并进本分支，满足「PR head 必须包含最新 base 提交」的门禁，同时带上共享红修复：check:nginx-spa-routes 的 /pay/<checkoutToken> 前缀路由与 Pingora 路由矩阵、external_mcp::semantic 真值 32、api-server/platform-llm 的 tracing interest 竞态、AGC 壳 Rust shard-4 两条偶发断言 本次 merge 无冲突自动完成：pitfalls.md 两边条目都保留（本分支的 issue #602 条目 + #609 的 2026-10-04 tracing/shard-4/SPA 深链三条） 未改动 #609 引入的任何文件	2026-10-04 03:40:21 +08:00
suzmii	9e2cea5b72	修复 AGC 壳 Rust shard-4 的两条偶发断言，并补齐 pitfalls 记录 ... - agent::thread_manager::tests::active_turn_changes_publish_one_notification_per_real_change 偶发 left 8/right 7：测试计数器 DIRECT_ACTIVE_TURNS_EVENT_TEST_COUNT 曾在 2026-10-01 按线程 作用域隔离，2026-10-02 退役 runtime_driver 把它搬进 agent/direct_events.rs 时降级回进程级 static AtomicU64，于是断言会取到宿主 tauri::async_runtime 后台回合在别的线程上的广播 （--test-threads=1 只串行测试线程）。改回 thread_local! Cell，并注明跨线程口径的覆盖取舍 - process_session::tests::process_session_graceful_terminate_keeps_wrapper_alive_for_target_cleanup 偶发 left "exited"/right "terminated"：测试命令里 leader 打印 READY 后立刻 exit 0，同组后代 仍存活，trampoline 从 leader 被回收起开始 800ms 宽限；客户端只要晚于宽限才发出 terminate 就只能读到既成事实。改为 leader 用 wait 等后台子进程，让 terminate 必然落在会话仍 running 时 （trap / sleep 0.4 / marker / 断言均未改），并注明该用例的确定性来自 400ms < 800ms 的时间余量 - docs/project-memory/shared-memory/pitfalls.md：更新 graceful terminate 那条已过时的验证口径， 补三条 2026-10-04 条目（tracing interest 竞态、AGC 两条偶发的串台根因、SPA 深链前缀路由） - 本地实跑：修复前把计数器临时改回 AtomicU64 时同一并行口径 17/20 红；修复后并行 20 次全绿、 agent::thread_manager:: 连跑 5 次 72 passed；第 2 条用例是 #[cfg(target_os = "linux")]， Windows 本机跑不到，已用真实 Linux 内核（WSL Alpine）验证命令形状（leader 活到 TERM、 同组后代完成 400ms 延迟清理 marker=done 0.41s、清理后组内零残留），CI 侧仍需跑 node apps/ai-game-creator-shell/scripts/run-rust-shell-test-shards.mjs --shards=4 --shard-index=4 复核	2026-10-04 03:25:54 +08:00
suzmii	c4b3d22042	回补 AGC 客户端发布与导出路径的机器级覆盖 ... master 839051f53（PR #568 退役 AGC 自建 Agent Runtime/CLI）整文件删除了 src-tauri/src/tests/project.rs（当时含 128 个用例），本分支合并 783ca014e 采纳了 这次删除，导致其中覆盖「客户端发布/导出」活代码的断言失去全部引用。本次不复活已删 文件，把同域用例按原断言意图重建在 project/export.rs 的现役测试模块。生产代码未改动。 mod publish_export_tests 本次新增： - publish_build_plan_prefers_game_subproject_and_requires_dependencies：构建计划优先 game 子工程； 缺 game/node_modules 时 needs_dependency_install=true，补齐后为 false。 - publish_build_plan_falls_back_to_root_npm_build：game 无 build 脚本时回落到项目根 npm 工程 （cwd_relative="."、command 取根 build 脚本、不需要装依赖）。 - publish_export_runs_project_build_before_packaging：原型完成后发布先跑项目 npm build 产出 dist/ 再打包，且 .agent/logs/command.log 必须记录一次 project.verify build。 - publish_export_blocks_build_until_runnable_prototype_is_completed：原型未完成时禁止触发用户 项目构建（无 build 标记文件、无 build 日志、错误含「首个可运行原型尚未完成」）。 - publish_export_reports_actionable_error_without_entry_or_build_script：缺可玩入口且没有 build 脚本时失败关闭，错误必须同时给出「还没有可玩入口」与「build 脚本」。 - local_project_export_package_publish_payload_contains_bytes_and_file_digests：发行载荷带 package_size_bytes、64 位十六进制 sha256 与逐文件清单；条目无 game/ 前缀、含 index.html 与 exports/README.md（体积/契约）。 - local_project_export_package_list_only_returns_recent_playtest_zips：包列表只返回 exports/playtest-package-*.zip，按修改时间倒序，忽略非 playtest 文件与非 exports 目录。 - local_project_export_package_list_skips_symlink_packages（cfg(unix)）：符号链接试玩包不得列出（安全）。 - local_project_export_package_rejects_symlink_assets（cfg(unix)）：assets/ 内符号链接素材必须 整包拒收，且不得留下试玩包（安全）。 - local_project_export_package_rejects_symlink_runtime_dirs_and_readme（cfg(unix)）：README 与 运行时目录被符号链接顶替时必须拒收（安全）。 同批提交中另含上一轮已重建的 7 条（同一文件）： publish_stack_validation_{accepts_scaffolded_phaser4_vite_project, reports_actionable_error_for_phaser3,requires_phaser_dependency_and_vite, reads_semver_ranges_and_lockfile_versions,rejects_projects_without_npm_build_workspace}、 publish_export_skips_build_when_phaser_vite_entry_exists、 built_project_publish_payload_includes_uploaded_assets_and_prefers_dist_assets。 不适用 / 已覆盖： - publish_export_skips_build_when_playable_entry_exists（原始版本）已由 publish_export_skips_build_when_phaser_vite_entry_exists 以 Phaser 4 + Vite 语境等价覆盖，不重复。 - 其余域（preview / assets / commands / windows / cli 等）缺口不在本 PR 交付面，未处理。 fixture 适配：unique_project_path 在 HEAD 为私有 fn，改用 crate::tests::canonical_test_tempdir； 随文件删除的 init_existing_html_project_at 与 fake_llm_game_draft 用最小内联 fixture 取代 （内联单文件可玩 HTML + 去掉 npm 工作区脚手架的工程）。	2026-10-04 01:18:29 +08:00
suzmii	0bf84e2886	消除 AGC 导出测试对 HOME 环境变量的依赖 ... - export.rs：npm_export_tests 的 2 条用例（npm_package_contains_dist_project_root_assets_and_publish_readme、本批新增的 built_project_publish_payload_includes_uploaded_assets_and_prefers_dist_assets）不再用 std::env::var("HOME") 拼临时根，改用仓库既有约定的 crate::tests::canonical_test_tempdir - 动机：Windows 只设 USERPROFILE、不设 HOME 时，std::env::var("HOME").unwrap() 会以 NotPresent panic；改后与本批另 5 条 publish_export_tests 的临时根口径一致 - 未动断言：两条用例的断言与语义保持不变，只替换临时根来源（canonical_test_tempdir 同样返回 tempfile::TempDir，root.path() 用法不变） - 验证（同一命令 cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --bin genarrative-ai-game-creator-shell -- --test-threads=1 project::export::）：HOME 未设置（env -u HOME）→ exit 0，test result: ok. 12 passed; 0 failed；HOME=C:/Users/dongy → exit 0，test result: ok. 12 passed; 0 failed - 顺带核对：project/verification.rs 仍有 1 处同名 HOME 写法，属其它模块范围，本次不动	2026-10-04 00:39:26 +08:00
suzmii	3f18e3dc77	按独立评审的三条 P2 收口：空批次不误报、重复注册留线索、文档与实测对齐 ... App.tsx 的监听处对空批次直接返回：空批次没有要插的东西，不能报成「没有可用的聊天输入区」（原因指向错了方向） activeChatComposer.registerActiveChatComposer 增加重复注册检测：dev 下 console.warn 指出后注册者顶替了前者，不改运行时语义（仍然后注册者接管、身份校验照旧兜住乱序卸载） tests/activeChatComposer.test.ts 补两条：空批次不打扰已挂载输入区；重复注册出现告警且乱序注销清不掉更新的句柄 tests/resourceCanvasChatReferenceDrop.test.tsx 补一条：直接构造空批次引用事件时不产生「没有可用的聊天输入区」告警 decision-log 的「影响范围」补记 tests/activeChatComposer.test.ts，「验证」换成合并 master 后的实跑数字；功能说明的用例表补两行 反向证伪：去掉空批次短路、去掉重复注册告警后，上面两条新用例各红一处	2026-10-04 00:38:06 +08:00
suzmii	72f299ee40	修正 AGC 测试与 tsconfig lib 不兼容的 Promise.withResolvers 用法 ... - 改动文件：apps/ai-game-creator-shell/tests/gameDistributionPublishPanel.test.tsx（仅此一个文件） - 写法替换：把 `Promise.withResolvers<unknown>()` 换成本地手写 deferred（`let settlePending` + `new Promise((resolve) => { settlePending = resolve })`），resolve 仍由外部持有、promise 仍交回测试，与原 onResolve/onReject 语义一致（原 reject 未被使用） - 为什么不改 tsconfig：`Promise.withResolvers` 需要 lib ES2024，而 apps/ai-game-creator-shell/tsconfig.json 是 target/lib ES2022；为单个测试把 lib 提到 ES2024 会改整个 AGC 客户端的编译目标与运行时假设，影响面远大于此处需求，故只在测试内手写等价 deferred - 验证：npm run agc:typecheck 五步全 0（check:tests:types → tsc -p tsconfig.json → skill-pack:check → bundled-resources:check → check-config.mjs）	2026-10-04 00:30:49 +08:00