293 Commits

Author	SHA1	Message	Date
kdletters	b7862288d0	移除AGC正式渠道产品名后缀 ... - release 渠道复用正式产品名陶泥儿，安装包与更新归档不再包含 Release 文本。 - 保留 release identifier 与 release-win/release-mac 更新分区，更新渠道身份回归测试。 - 同步客户端发布、运维与项目记忆文档。	2026-09-30 11:51:03 +08:00
lhk229	6d8969a6fa	清理过期共享记忆与固定文案检查 ... 移除运维和原生壳对记忆文案的固定措辞检查，保留实际契约与权限验证 清理过期决策和踩坑流水账，保留当前兼容约束与未完成验证边界 明确共享记忆维护规则，并同步修正游戏发行计划的现行入口说明	2026-09-29 15:04:32 +08:00
kdletters	30a190d183	修复 AGC NSIS 安装钩子在模板常量与插件目录之前编译导致的出包失败 ... - installer-hooks.nsh 顶层收敛为 !define / Var / !macro：迁移逻辑改成 !macro AgcMigrateLegacyIdentity，由 !macro NSIS_HOOK_POSTINSTALL 在模板插入点（Section Install，addplugindir 之后）展开，避免 include 时 INSTALLMODE 未定义走错分支、nsis_tauri_utils 插件目录还没 add 导致 makensis 报 Plugin not found 中断 - 旧展示名改走运行期变量 $AgcLegacyIdentity（替换 Push/Pop + Function），去掉 section 上下文里不可用的 Return 提前返回，清理与补建语义保持不变 - 文件头补编译期位置纪律：模板在 installer.nsi 第 28 行 include 本文件，早于 !define INSTALLMODE / MAINBINARYNAME 与 !addplugindir，顶层只能放声明 - build-release.test.mjs 新增守卫用例：顶层不得出现 Function、插件调用、模板常量引用或裸可执行语句（对修复前形态命中 36 条，含第 68 行顶层插件调用） - pitfalls 与 decision-log 记录该踩坑、根因、本机逐字复现与处理口径 - AGC 渠道安装身份隔离里程碑补 2026-09-29 钩子编译位置修正小节与本机探针取证	2026-09-29 18:00:03 +08:00
kdletters	80bf54c39d	修复 AGC dev 渠道改名后旧快捷方式仍指向旧安装 ... - 新增 src-tauri/windows/installer-hooks.nsh：安装结束时按旧展示名（陶泥儿、Genarrative AI Game Creator）清理旧快捷方式（先用 IsShortcutTarget 校验目标）、旧安装目录与旧卸载项 - 同一钩子在用户原本就有旧桌面图标时补建当前身份的桌面图标、并始终补建开始菜单图标，解决 /UPDATE 下模板不创建快捷方式导致「点旧快捷方式→更新→自动启动新版」的循环 - build-release.mjs 只在 dev 渠道 + Windows 目标注入 bundle.windows.nsis.installerHooks，并让 node runtime 资源映射与钩子共存 - build-release.test.mjs 新增用例：只有 dev+Windows 注入、钩子文件存在且旧身份表完整、JSON Merge Patch 后钩子不被资源映射顶掉 - pitfalls 与 decision-log 记录改名迁移口径、删除边界与「再改展示名必须追加旧身份」的纪律 - AGC 渠道安装身份隔离里程碑补 2026-09-29 修正小节与真机升级验收项	2026-09-29 12:23:14 +08:00
kdletters	4f47343108	记录 dev 真实部署的发行读取契约与门禁接线审计 ... - 游戏分发里程碑新增「真实部署只读取证（dev 环境）」小节：平台同源入口 /games/<gameId>/ 与直连发行网关路径匿名 200（nosniff、CORP=cross-origin、ACAO=*、发行专用 CSP、cache-control max-age=60）、同路径带 Cookie 403、带 Cookie 走 nginx 映射仍 200（证明 proxy_set_header Cookie "" 生效）；生产 /api/game-distribution/games 当前 0 条已发布 - 索引第三节补该证据；第五节新增 2026-09-29 广度回归（npm test 423 文件 / 4482 passed / 26 skipped）与门禁接线审计（check:* 共 80 个：53 个自动可达、27 个生产/凭据/环境依赖型人工门禁），并给出审计方法 - 一次性审计脚本不入库；接线结论与「加新门禁先问它有没有自动调用方」一起保留在 pitfalls 与索引里	2026-09-29 07:49:18 +08:00
kdletters	e34efc4675	按 2026-09-29 的真实状态重新盘点开放事项索引 ... - 第一节：占用锁计划补上 2026-09-28 的实测（write_lock 21 / gui_ 31 / project_execution_owner 8 / owner_diagnostic 4 passed），说明只差真机多窗口运行时表现与第 4 条 A/B 收口决定，并注明它用编号式验收标准、不计入复选框口径 - 第二节：重写为 current 口径——未勾选 11 条、6 份计划，按「macOS 节点 + 真机 / 桌面会话 / 真实 Provider」分组；另列 8 份已无未勾选但仍在等签收或外部环境的计划 - 第三节：游戏分发里程碑从「28 条」更正为剩 4 条，两份实施计划均 0 条；并更正解冻前提——2026-09-28 起发行入口改为平台同源路径，不再要求独立 HTTPS 发行域名与通配证书 - 第五节：补 2026-09-29 重新盘点（81 份计划 / 15 条未勾选 / 8 份文件），把 74 份与 43 条标为历史快照，并把 ``check:nginx-spa-routes``/``check:pingora-route-parity`` 从「仍红」更正为已转绿（含新增反向覆盖与 smoke 断言） - 阶段 A 实施计划：把「本机只到领域单测」更新为已补齐的真实栈证据（13 条 E2E + AGC live 发布 1 passed + 后台列表/ZIP 联调 10/10）	2026-09-29 07:34:14 +08:00
kdletters	9112207089	记录游戏分发 E2E 家族 13 条全绿与 AGC 一键发布客户端取证 ... - 里程碑：新增 2026-09-29 小节，记录其余 9 条 E2E（dto-parity / upload-safety / upload-resume 两段 / package-limits / owner-isolation / sandbox / validation-restart 两段 / media / ops-rollback）全部通过及各自要点 - 证据矩阵：第 1 节补上 AGC 一键提交的客户端侧 live 测试证据（真实 publishLocalProjectGame 打真实后端、分片偏移不重传不跳段、同 localProjectId 复用 gameId），第 3 节补 2026-09-29 复跑耗时 - 开放事项索引：补 2026-09-29 的 13 条 E2E 复跑与 AGC live 证据，瓶颈口径不变	2026-09-29 07:08:30 +08:00
kdletters	d8011a72fa	游戏分发 web E2E 的冷启动假失败改为浏览器级预热 ... - 现象：冷 Vite 下 check:game-distribution-web-e2e 先卡在目录卡片 20 秒等待，重跑又卡在游玩页「开始游戏」15 秒等待；同一时刻公开目录 API 已把该游戏排在第一 - 根因：原先的 fetch 预热只拿到 SPA 外壳（HTML 里没有路由模块），Vite 仍在断言阶段现编译这些模块图 - 修复：改成起浏览器后用一次性 context 真走 /games、/games/detail、/games/play（domcontentloaded + 2 秒 settle，120 秒上限，失败只告警），首个 goto 的 120 秒超时保留 - 复验：重启 dev 栈（冷缓存）→ 24/24 PASS；四条 web E2E（web / publish / publish-recovery / a11y）全部复跑通过 - 文档：里程碑补 2026-09-29 复跑记录，pitfalls 同日条目按实测证据补正	2026-09-29 06:54:47 +08:00
kdletters	198c208172	用已安装包现场取证随包 Codex，并收窄 Windows 验收边界 ... - Mac 客户端随包运行依赖补齐：记录已安装 陶泥儿开发版 0.1.154 的载荷完整性（coding-agent/win-x64 六个组件 SHA-256 与 manifest.json 6/6 一致、codex-cli 0.155.1）与随包 app-server 能在 Windows 起来的现场证据 - 说明该包在第一条 direct 回合报 items must not be empty 是 7ec984d0d 已修缺陷的现场复现（0.1.154 源码不含、0.1.158 源码包含，master 同用例通过），剩余验收收窄为安装器实跑 + GUI/Cocos 回归 - pitfalls 新增「用夹具 --agc-exe 直接验证已安装渠道包里的随包 Codex」的做法与判读口径 - 开放事项索引同步该行	2026-09-29 06:42:08 +08:00
kdletters	fdb09db8a3	打通本机 dev 栈的后台工程列表与 ZIP 联调并记录证据 ... - 项目自动上传与后台工程下载：查清「本地数据库 404」的成因是 standalone 未运行（并非库缺失），`npm run dev:spacetime` 启动后自动发布 xushi-p4wfr，`/healthz` 200 且认证投影从 spacetime 表恢复 - 记录联调结果：渠道端点返回 {"channels":["dev","release"]}、未认证 401、游标分页 50+34=84 条、官方门禁 check:agc-project-snapshot-admin-http 对两个真实项目各 10/10 通过（含逐文件 SHA-256 与 .agent 目录还原） - 开放事项索引同步：该计划只剩「新客户端安装版下的隔离实机自动上传」这一条	2026-09-29 06:37:40 +08:00
kdletters	d0b9bdebfe	补齐真机闭环的现场证据，并记下本会话不能跑 GUI 验收的约束 ... - 渠道安装身份隔离：记录本机 dev 0.1.154 与旧身份 陶泥儿 0.1.109 同机并存的真实样本、已装产物内嵌 agc/dev-win/latest.json 且不含 release 端点、两个安装包资源串互不串身份，并写明真机条件已具备 - 更新插件里程碑：写明检查一半已由清单核对脚本覆盖，安装一半在本机只差一次点击，并给出点击前后的取证口径 - DirectProject 两条运行时验收：勾选行注明宿主侧已由真 app-server 夹具取证，剩余部分是界面渲染与用户终止路径 - 记录环境约束：本会话不能启动用户可写目录下的可执行文件，GUI 验收必须在桌面会话执行	2026-09-29 06:27:04 +08:00
kdletters	3fa4501c68	用 Jenkins 真实证据关闭渠道化第 5 条，并记录 dev-mac 卡在离线 mac 节点 ... - 渠道化里程碑：四渠道全量只读核对（dev-win 0.1.158、release-win 0.1.159、release-mac 0.1.139、dev-mac 0.1.142）与真实 Jenkins 日志/归档取证，条目 5「凭据不落日志、不进归档」勾选关闭 - macOS 里程碑：记录节点 genarrative-agc-macos-01 自 2026-09-24 19:54:51 +08:00 起 ChannelTermination 离线（JNLP 只能在 Mac 本机启动）、离线期间不产出半成品，以及日调度 Job 因此连续失败 - pitfalls：新增「AGC 发布类 Job 变红或卡住先看构建节点在线状态」的排查口径与只读检查命令	2026-09-29 06:18:40 +08:00
kdletters	e1dacccec5	复核版本守卫在真实 dev-win 构建上的表现并记入里程碑 ... - 只读核对线上 dev-win 0.1.157（commit d39931a01a）：清单地址、产物签名、PE 身份与版本、统一总号四层同时成立 - 该构建是 assertArtifactVersionMatches 补上后的首个真实 Windows 渠道构建，确认守卫在 CI 不误伤也不漏放 - 渠道化里程碑记录本条证据，并保留仍未取证的 Jenkins 日志边界	2026-09-29 00:51:32 +08:00
kdletters	e39abe8b61	复核批量标签的原生写盘与跨窗口路径并记入里程碑 ... - 原生写盘：add_local_project_resource_tags 单次 add_manifest_asset_tags_at（整批校验/一次 manifest 写入/一次 revision/审计记录），前端 CAS 带项目身份与 revision，失败保留草稿 - 跨窗口：handleResourceBatchTagsSaved 用 epoch+路径+项目 ID 丢弃迟到回包，然后调用共用的 reloadManifestAfterAssetCommand 回读广播 - 相关定向用例 24 passed；里程碑记录该复核与仍未验收的真机边界	2026-09-29 00:47:54 +08:00
kdletters	c30248c4ad	封面生成客户端合同复核并记入里程碑 ... - 复核两处：generateGameDistributionCover 返回的 assetObjectId 直接作为封面（无本地二次上传）；read_cover_asset_id 取不到平台素材 ID 时失败关闭，不会退回本地文件 - 里程碑 C3 条记录该复核结论与仍未验收的边界（GUI 真实生成、Provider 出图与泥点扣费账实相符）	2026-09-29 00:43:49 +08:00
kdletters	a441af25e5	证据矩阵按 2026-09-29 的两次修复更新 ... - 第 3 条：包体上限改为单一来源 shared_contracts 常量，AGC 客户端读包阶段按平台上限预检，本地 512 MiB 导出上限只是防呆线 - 第 5 条：免费生成简介/分类补上客户端侧合同（上下文有界 6,000 字符、素材只带文件名脱敏、失败本地兜底不阻断发布）与用例证据 - 保证 D6 的矩阵与当前代码/证据一致，未取证项分类不变	2026-09-29 00:40:53 +08:00
kdletters	e6c3729adb	AGC 发布前检查平台包体上限，并把上限单一来源 ... - shared-contracts 新增 GAME_DISTRIBUTION_MAX_PACKAGE_BYTES（200 MiB），服务端 module-game-distribution 保留同值常量并在注释里指明；api-server 新增 publish_package_limit_matches_the_shared_contract 守卫测试把两处锁一致 - AGC project/export 新增 ensure_within_platform_package_limit：读包阶段预检，超限返回「发行包 X MiB 超过平台上限 200 MiB；请精简资源后重新导出再发布」，不再让 200–512 MiB 的包白读盘/暂存后吃服务端 413 - 用例：project::export::npm_export_tests::publish_precheck_rejects_packages_over_the_platform_limit（边界=上限放行、超限文案、本地导出上限确实更宽） - 里程碑 C1 与 pitfalls 记录「本地导出上限 ≠ 平台发布上限」这一口径	2026-09-29 00:36:28 +08:00
kdletters	cb44081040	发布资料建议的项目上下文改为脱敏：素材只带文件名 ... - GameDistributionPublishPanel：buildPublishProjectContext 不再原样拼接 asset.localPath，新增 contextSafeAssetLabel（统一分隔符、取最后一段、限长 80），绝对路径（含用户目录）不再进入提示词；上下文整体仍截到 6,000 字符 - 新增用例「发布资料建议只带脱敏且有界的项目上下文」：40 个绝对路径素材 + 超长版本说明，断言长度在 5,000~6,000、含文件名、不含 C:\Users 与项目目录；13 tests passed - 变异验证：改回 `asset.localPath` 原样拼接后该用例立即以 expected ... to not include 'C:\Users' 变红 - 游戏分发里程碑第 C2 条补记该客户端侧口径与剩余边界（GUI 与真实 Provider 仍待验收）	2026-09-29 00:27:07 +08:00
kdletters	1951a88fba	网页侧证据复跑并修掉 Vite 冷启动造成的假失败 ... - check-game-distribution-web-e2e：导航前先 fetch 预热 /games、/games/detail、/games/play 三条路由（120s 上限，失败只告警），首个 goto 超时提到 120s，避免 Vite dev 冷启动（实测 /games 首请求 20.2s、warm 后 14ms）被当成页面故障 - 复跑合并 Web 预检改动之后的网页侧四条 E2E：web-e2e 24/24 PASS、web-publish 全过、web-publish-recovery 全过、web-a11y 全过 - 里程碑补「网页侧证据复跑（2026-09-29）」小节；pitfalls 记录冷启动判据与修法	2026-09-29 00:21:43 +08:00
kdletters	25898969fb	给真机 DirectProject 夹具加一键入口 ... - 新增 scripts/run-agc-direct-execution-fixture.mjs：默认用 src-tauri/target/debug 的 AGC 二进制跑全部 11 个用例，支持 -- --cases 子集与 -- --agc-exe 覆盖；二进制缺失时给出构建提示并以退出码 2 结束 - package.json 注册 npm run check:agc-direct-execution-fixture - 复验：全量 11/11 passed（completed/passes/mcp/mcp-write/native/native-resources/patch/deadline/native-session/restart/running）；-- --cases restart 透传也通过 - DirectProject 里程碑记录该可复跑入口与 11/11 结果	2026-09-29 00:11:11 +08:00
kdletters	d39931a01a	把签名凭据卫生收进 check:production-ops 门禁 ... - 两个 AGC 打包管线必须用 withCredentials 把 AgcUpdaterSigningKey / ...Password 绑到 TAURI_SIGNING_PRIVATE_KEY / ..._PASSWORD - 禁止 echo $TAURI_SIGNING_PRIVATE_KEY、Write-Host $env:...、%VAR%、set -x 之类会把绑定凭据打进日志的写法；归档 glob 不得出现 *.pem|*.key|*.pfx|*.p12 - 变异验证：往 mac 管线插一行 echo $TAURI_SIGNING_PRIVATE_KEY 后门禁立刻以「不得把签名凭据打印到构建日志」失败退出；还原后 check:production-ops OK - 渠道化里程碑第 5 条补记该静态门禁与剩余边界（真实 Jenkins 运行日志仍需 CI 取证）	2026-09-29 00:05:54 +08:00
kdletters	f6ccabf425	补客户端更新"校验失败不得当成功"的回归用例 ... - appUpdate.test：新增「签名校验失败时拒绝安装、不重启进程，并保留待装更新供重试」——插件抛 signature verification failed 时断言错误原样上抛、restart_agc_app 未被调用、重试仍走安装链路并在成功后重启 - 变异验证：把 restartAppAfterUpdate() 挪到 await downloadAndInstall 之前，该用例立即以 expected "spy" to not be called with arguments: [ 'restart_agc_app' ] 变红；还原后 7 passed - 客户端更新里程碑补记该覆盖与剩余边界（真机安装闭环与插件侧临时文件清理需真实设备与已发布包）；pitfalls 记录"重启必须排在安装成功之后"	2026-09-29 00:02:17 +08:00
kdletters	a59329995e	真机夹具加 running 用例：进程存活期间宿主可观测到运行中回合 ... - direct-execution-production-fixture：新增 running 场景（工具阻塞期间进程存活），轮询宿主账本抓快照，断言 phase=working、active 里恰好一条 kind=execute 在途许可、executorStopped=false；收尾后 phase=completed、active 清空、executorStopped=true，宿主侧条目顺序不变 - 复验：completed,passes,mcp,mcp-write,native,deadline,restart,running 共 8/8 passed - 记录事实：CLI/无前端宿主既无用户消息也无最终助手回复（前端写入），夹具断言只校验宿主侧条目；宿主侧"正在跑"的可观测事实两路径一致 - 文档：DirectProject 里程碑补该轮核对；pitfalls 扩写 CLI 历史只含宿主侧条目这一坑	2026-09-28 23:39:11 +08:00
kdletters	c388803729	给真机夹具加 restart 用例：回合进行中杀进程后部分历史与宿主事实 ... - direct-execution-production-fixture：新增 restart 场景（契约 → 部分助手文本 + 阻塞原生工具 → 工具真开始后 SIGTERM 杀进程），断言部分文本与工具卡片按顺序落盘、被杀工具卡片是最后一行且无回执行、账本不伪造成 completed/executorStopped - 复验：completed,passes,mcp,mcp-write,native,deadline,restart 共 7/7 passed - 变异验证：把"等 400ms 再杀"改成"等 20s"（让回合自然跑完）后同一条用例立即变红（AGC must be killed mid-turn） - 记录事实：CLI/无前端宿主不写用户消息（GUI 由前端写），夹具断言据此只校验部分文本与工具卡片顺序 - 文档：DirectProject 里程碑补该轮核对与剩余 UI 侧边界；pitfalls 记 CLI 不写用户消息这一坑	2026-09-28 23:32:02 +08:00
kdletters	4415c7a5ff	修复宿主自己收尾被记成本轮未完成（CLI 回执不再是通道断开） ... - fail_turn：宿主自己关的连接（is_closed）只把原因追加进终态说明，不再调 session.interrupt，避免把正常收尾改写成 interrupted - direct_execution：新增 ExecutionSession::append_terminal_note，与 interrupt 同款留痕但不改阶段；用户主动终止与真实通道故障保持原口径 - 复验：真 AGC CLI → 真 app-server → loopback Responses 夹具 6/6 passed（原来 6/6 失败）；completed 用例 phase=completed、executorStopped=true，terminalReport 为宿主真实交付报告 - 定向单测 codex_app_server::execution 13 passed（含 host_ended_turn_is_not_a_failure、user_requested_stop_is_not_recorded_as_a_failure）、direct_execution 26 passed - 文档：pitfalls 记录 Killer 定位与修复、decision-log 记该决策与边界、DirectProject 里程碑说明该夹具现为可复跑证路（两条 UI 验收仍需真实客户端窗口）	2026-09-28 23:23:56 +08:00
kdletters	8b67efbcff	给 app-server 关闭原因加可观测日志并定位 DirectProject 收尾 Killer ... - codex_app_server：shutdown_game_creator_codex_app_server_inner 在 GENARRATIVE_AGC_DIRECT_DEBUG=1 下打印关闭原因，避免以后再靠插桩区分「宿主收尾」与「通道自己断了」 - 用该日志定位到：夹具里是宿主自己的 shutdown_and_report（execution.rs:938，reason=宿主执行预算或交付收尾）先置 closed 再关 app-server，关进程给在途回合发 TransportClosed，于是 CLI 回合拿到「连接断开」、账本落 interrupted - 记录修复方向（宿主主动收尾时先交付结果、不向该回合发 TransportClosed）与影响面（CLI / 单回合宿主，GUI 常驻不走这条路） - DirectProject 里程碑与 pitfalls 同步：四层排除结论 + Killer 定位；两条运行时验收继续未勾选	2026-09-28 23:10:59 +08:00
kdletters	a18a6e84b0	插桩排除 DirectProject 宿主收尾的两个候选原因 ... - 在 Drop for ExecutionBinding 分支插桩后一次都没打印：账本 interrupted 不是它补的 cancel_from_host - 临时打印 app-server stderr 分段原文：1242 字节全是 ProgramData/模型元数据/PowerShell shell snapshot 告警，没有 panic/error，说明子进程是被优雅关掉的 - 结合上一轮的「不是 codex 版本漂移、不是 stdin 被忽略」，记录下一步插桩点应落在宿主侧关闭 stdin / kill 子进程的代码；所有插桩已回滚，工作树保持干净 - DirectProject 里程碑与 pitfalls 同步该结论，两条运行时验收继续未勾选（本质要真实客户端窗口）	2026-09-28 23:04:26 +08:00
kdletters	90a414ebf3	清理随包 Codex 资源里的旧布局残留 ... - src-tauri/build.rs：stage_codex_target 拷贝前调用新增的 prune_stale_codex_components，删掉不在本轮布局也不在 manifest.json/NOTICE.md 白名单里的文件并收掉空目录 - 复验：重建后 resources/codex/win-x64 根目录那份 0.147.0 codex.exe 与临时备份被清除，六个声明组件、manifest.json 与 NOTICE.md 保留；同一二进制下 loopback 夹具仍跑到 requests=3、markers.ready=true - 文档：DirectProject 里程碑本轮核对细化第二层问题（不是 codex 版本漂移、不是 stdin；指向 Drop for ExecutionBinding 的收尾竞态，需插桩），并说明两条运行时验收本质要真实客户端窗口；pitfalls 记录该环境陷阱与修复	2026-09-28 22:55:41 +08:00
kdletters	7ec984d0d2	修复 DirectProject 空历史注入导致新项目第一条消息失败 ... - build_direct_project_history_injection_params 在历史为空时返回 Ok(None)，调用方跳过 thread/inject_items（codex app-server 0.155.1 起拒绝 items: []） - 新增两条单测：空历史不得构造载荷、有历史仍构造 1 条；cargo test direct_project_history_wire 3 passed、cargo fmt --check 通过 - 复验：真 AGC CLI → 真 app-server → loopback Responses 夹具从「4 秒失败、requests=[]」变为「requests=3、markers.ready=true、exit=0」 - 记录第二层未解决问题：同一用例账本仍落 phase=interrupted（app-server 收尾连接终止），两条运行时验收继续未勾选 - decision-log 与 pitfalls 记录缺陷、修复与证据；DirectProject 里程碑补本轮核对	2026-09-28 22:45:47 +08:00
kdletters	93af29314c	只读核对补旧协议指针的分区断言 ... - check:agc-update-channel-manifests：非 dev 的 Windows 渠道核对时断言 agc/latest.json 仍指向 dev-win 分区（全局单对象只属于 dev） - 渠道隔离里程碑与 decision-log 记录线上证据：release-win 核对通过，指针指向 dev-win 0.1.155	2026-09-28 22:30:15 +08:00
kdletters	e055cb1d7c	核对脚本能读 Windows 安装包内部渠道身份与版本 ... - 新增 scripts/pe-version-info.mjs：纯 Node 解析 PE RT_VERSION（VS_FIXEDFILEINFO + StringFileInfo），带非 PE 输入失败关闭的用例 - check:agc-update-channel-manifests：下载 Windows 安装包后断言 ProductName 与 FileVersion，与 mac 侧解 Info.plist 对称；实测 dev-win 0.1.155=陶泥儿开发版/0.1.155、release-win 0.1.150=陶泥儿 Release/0.1.150 - 渠道化与渠道隔离里程碑记录：dev-win 0.1.155 于 14:26:13 发布完成（总号/清单/旧协议指针三者对齐），但该构建源码早于 assertArtifactVersionMatches，守卫仍待下次真实构建验证 - decision-log 与 pitfalls 补记 PE 侧核对口径	2026-09-28 22:27:18 +08:00
kdletters	87a26f74df	渠道清单只读核对补统一总号与线上一致性断言 ... - check:agc-update-channel-manifests：读 agc/global-version.json，断言任何渠道清单版本不高于统一总号（渠道落后按 INFO 提示，只有反超才失败），复用 agc-global-version 的 compareVersions - 渠道化里程碑本轮核对补线上总号证据：总号 0.1.155（dev-win 取号），四个渠道 0.1.154/0.1.150/0.1.142/0.1.139 均不高于总号 - decision-log 记录该线上口径	2026-09-28 22:22:31 +08:00
kdletters	7da6de0b4e	补齐跨渠道产物隔离核对并把 dev-mac 缺陷钉到字节级 ... - check:agc-update-channel-manifests：新增「不同渠道更新包不得字节相同」断言（需 AGC_UPDATE_VERIFY_DOWNLOAD=1），并核对 Windows 安装包文件名带本渠道产品名 - 只读核对 dev-win/dev-mac/release-win/release-mac：dev-win 0.1.154、release-win 0.1.150、release-mac 0.1.139 身份与版本一致；dev-mac 0.1.142 与 release-mac 0.1.139 的更新包 sha256 相同，字节级证明 dev 分区放了 release 渠道的产物 - 渠道安装身份隔离里程碑补本轮核对（发布产物身份 + 跨渠道唯一性），真机并存仍待验收 - macOS 里程碑与 pitfalls、decision-log 记录字节级取证与新断言	2026-09-28 22:18:37 +08:00
kdletters	e23b0e871b	修复 macOS 渠道发布挑中残留产物，改为构建期核对包内版本与渠道身份 ... - build-macos-ci：构建前按后缀清空 macos/ 下的 *.app.tar.gz / *.sig / *.dmg / *.dmg.sha256，构建后读 Info.plist 核对版本与渠道身份，生成清单后再断言选中本轮更新包 - 新增 macos-release-identity.mjs 与单测：回归用例直接用线上 dev-mac 里那份 0.1.139 release 身份包 - prepare-macos-codex.test：残留清理断言改成按后缀全覆盖，并校验清理在构建前、身份核对在验签前 - Jenkinsfile.ai-game-creator-shell-macos-build：mac Job 增加身份守卫用例 - check:agc-update-channel-manifests：下载后解出 mac 包内 Info.plist 核对版本与身份，并按 2026-09-21 决策只要求 darwin-aarch64 - 文档：两份里程碑按现行决策修正口径并记录线上缺陷，decision-log 记决策与边界，pitfalls 记录「按目录扫描挑产物会选中残留」	2026-09-28 22:09:57 +08:00
kdletters	3702e0f8e0	记录游戏分发阶段 B 第 7 条已按本地可证范围取证 ... - 作者/管理员下架关闭发行读取、匿名直取 OSS 被拒、撤销传播窗口 60 秒三条都有 2026-09-28 的运行证据，勾选阶段 B 第 7 条并注明真实 CDN 属阶段 D	2026-09-28 22:00:36 +08:00
kdletters	a4d4d04d97	补齐 AGC 已发布渠道清单只读核对与线上差异取证 ... - 新增 scripts/check-agc-update-channel-manifests.mjs：只读核对 OSS 渠道清单结构、对象存在性、签名对象一致性，AGC_UPDATE_VERIFY_DOWNLOAD=1 时下载产物用内置公钥验签 - package.json 注册 npm run check:agc-update-channel-manifests - 渠道化里程碑条目 3 勾选：dev-win/dev-mac 产物下载验签通过，dev-win 的 sha256/size 与旧协议指针一致；条目 5 记录 withCredentials 与归档 glob 的静态核对结果 - macOS 里程碑记录线上 dev-mac 清单仍是单架构（0.1.142 / c07c10c0c），universal 需 mac 构建机重发 - pitfalls 记录「单测绿不等于线上清单符合契约」与 dev-mac 更新产物命名待核对	2026-09-28 21:56:50 +08:00
kdletters	d5dc95e822	补齐游戏分发主规范逐条证据矩阵 ... - 新增 docs/project-memory/plans/【证据矩阵】AGC游戏分发主规范逐条证据-2026-09-28.md：按主规范 9 节逐条映射证据与三档结论，HTTP 路由逐行核对，未取证项单列 - 里程碑阶段 D 第 6 条勾选，补「本轮核对（阶段 D 主规范逐条证据矩阵）」并更新阶段 D 现状 - 阶段 D 第 5 条注记告警现状：只有巡检 timer + 日志 operation，独立指标/告警规则未建	2026-09-28 21:50:48 +08:00
kdletters	e8b76da809	补齐游戏分发发布回滚窗口与发行网关缓存取证 ... - 新增 scripts/check-game-distribution-ops-rollback-e2e.mjs：关闭/开放发布开关、关投稿保在线、管理员批准被拦、拒绝审核与安全下架仍可用、换版保留旧版本、发行网关响应头与 60 秒缓存窗口、日志脱敏、边缘 /games/<gameId>/ 路由映射（40 项 PASS） - package.json 注册 npm run check:game-distribution-ops-rollback-e2e - 里程碑阶段 D 第 4、5 条勾选并补「本轮核对（阶段 D 发布回滚窗口与发行网关缓存）」，含变异验证结果 - pitfalls 记录发布开关用例要连拒绝审核与安全下架一起验，以及本机 check:production-health-patrol 必然 FAILED	2026-09-28 21:46:29 +08:00
kdletters	6afa63a9de	补齐游戏分发校验重启恢复与失败可观测取证 ... - 新增 scripts/check-game-distribution-validation-restart-e2e.mjs：两段式 prepare/resume，在确认校验中途杀掉 api-server，覆盖暂存字节不丢、重新确认可恢复、待审积压可查、坏包 422 失败可诊断、公开版本不被误删 - package.json 注册 npm run check:game-distribution-validation-restart-e2e - 里程碑阶段 D 第 3 条勾选，并补「本轮核对（阶段 D 重启恢复与失败可观测）」与阶段 D 现状描述 - pitfalls 记录两段式 E2E 的管理员凭据取决于 api-server 启动环境，以及同一状态文件只能 resume 一次	2026-09-28 21:34:24 +08:00
kdletters	b58fab7b52	补齐游戏分发 200 MiB 上限档与发包边界复跑 ... - 新增 scripts/check-game-distribution-package-limits-e2e.mjs：196 MiB 合法包走通上传+校验+送审并记录耗时与工作集，声明超限 413，文件数/单文件/展开量/压缩比四类边界各自 422 失败关闭并落 upload_failed - 校验实现无进程拉起，包内脚本未被执行 - 游戏分发里程碑阶段 D 第 2 条改为已勾选，并写明本轮可复核数据	2026-09-28 21:13:50 +08:00
kdletters	76cdb96c55	补齐游戏分发网页侧导航可达性与视觉约定取证 ... - 新增 scripts/check-game-distribution-web-a11y-e2e.mjs：桌面/移动导航切换、键盘焦点一路进到开始游戏、全屏按钮生效、安全区内边距、移动端发布面板无横向溢出，共 11 项 PASS - 游戏分发里程碑阶段 C 第 8 条改为已勾选，并记录移动端首次进入的阻断提示这一既有门槛 - 第 9 条按共享组件、warm token、无假统计/演示兜底、iframe 未放宽四条约定取证后勾选	2026-09-28 20:52:54 +08:00
kdletters	bbe416ca60	补齐游戏分发发布恢复链路并修掉双击提交建两份游戏 ... - 新增 scripts/check-game-distribution-web-publish-recovery-e2e.mjs：上传中断留草稿、关窗/登录失效后重登续传沿用原 versionId、双击只落一份、换账号不显示他人草稿，共 10 项 PASS - GamePublishPage 加同步 submitInFlightRef 在途守卫与按次稳定的 Idempotency-Key（失败重试复用、成功后清空），双击不再创建第二份游戏 - 游戏分发里程碑阶段 C 第 5 条改为已勾选 - pitfalls 记录「点一次会建资源的入口需要同步守卫或稳定幂等键」	2026-09-28 20:37:48 +08:00
kdletters	bbbd91db88	补齐游戏分发网页发布链路并修掉发布灰度按匿名判定 ... - 新增 scripts/check-game-distribution-web-publish-e2e.mjs：网页登录、选封面、选发行包 ZIP、填资料提交，待审不可见、审核后公开、更新沿用同一 gameId 且旧版在线，共 12 项 PASS - frontendRuntimeConfigService 去掉 skipAuth：发布灰度按作者判定，匿名请求恒为 false，之前只要显式配置过灰度网页端就永远没有发布入口；单测同步更新 - 游戏分发里程碑阶段 C 第 4 条改为已勾选，第 5 条缺口收窄到上传中断/双击/登录失效/窗口关闭与换账号 - pitfalls 记录「按用户灰度配置不能走 skipAuth」的经验	2026-09-28 20:21:34 +08:00
kdletters	f0ae3ce52c	补齐游戏分发网页侧链路取证并修掉返回目录丢关键词 ... - 新增 scripts/check-game-distribution-web-e2e.mjs：真实 dev 网页栈 + Chromium 游客走目录筛选、空态与重置、详情主动作、分享直达详情、按需加载发行 iframe、失败重试、退出不自动重启、移动端门槛与旋转提示，共 23 项 PASS - GameGalleryPage 的顶栏搜索词同步改为按 prop 值比对：原来的一次性 ref 守卫在开发态 StrictMode 双跑下会用空值清掉刚从 sessionStorage 恢复的关键词 - vite.config.ts 增加 /games/<gameId>/ 发行入口代理（rewrite 到发行网关并去掉 Cookie），本地网页栈与生产 nginx 同口径 - 游戏分发里程碑阶段 C 第 6、7 条改为已勾选，其余条目列出具体缺口 - pitfalls 记录 StrictMode 守卫击穿与 Vite 发行入口代理两条经验	2026-09-28 20:07:20 +08:00
kdletters	eb7c00658a	补齐 External v1 场景生成路由的本地真实栈受理 smoke ... - 新增 scripts/check-external-v1-scene-generation-smoke.mjs：dev 账号现建外部 API Key，校验非法 Key 401、缺幂等键/空 sceneContent/custom 缺 customStyle 各自 400、合法请求 202 且返回 operationId、同键重放同一 operationId、同键换请求体 409 - 轮询生成状态得到 completed 与 assetObjectId，并用 external read-url 换签名地址下载成功（200 image/png），证明 Provider 出图在本机可用 - 里程碑最后一条验收改为已勾选，并把先前「Provider 出图未验证」的环境结论更新为已实测	2026-09-28 19:52:16 +08:00
kdletters	ad2ab4cd60	补齐游戏发行沙箱的真实浏览器取证并勾选阶段 B 第 5/6 条 ... - 新增 scripts/check-game-distribution-sandbox-e2e.mjs：把探针包发布到本地发行网关，再用 Chromium 以 sandbox=allow-scripts 的 iframe 打开，断言 module 载入、storage/cookie/父文档 DOM 隔离、跨源 fetch 与 WebSocket、Worker、弹窗、顶层跳转、敏感权限全部被挡 - 同一次运行核对发行网关策略：最小 CSP（connect-src self / worker-src none）、nosniff、Access-Control-Allow-Origin *、带 Cookie 403、未知扩展名 404，共 22 项 PASS - 游戏分发里程碑阶段 B 第 5、6 条改为已勾选，并按主规范 2026 决策说明独立发行域名已由「平台同源路径 + sandbox 不透明来源」替代 - 第 7 条缺口收窄到只剩「撤销传播符合最大缓存窗口」需要生产 CDN/TTL	2026-09-28 19:43:59 +08:00
kdletters	2d875377a9	补齐项目快照的客户端上传与后台列表下载联调取证 ... - 新增 scripts/check-agc-project-snapshot-admin-http.mjs：核对后台列表里的快照统计、下载工程 ZIP、逐条与本地项目副本比对 SHA-256，并检查排除项与 .agent 目录 - 里程碑条目 9 改为已勾选，写入真实客户端共享模块上传（首次 synced、紧接着 no-op）与后台列表/ZIP 的 HTTP 联调取证，并把未验证项单独列出 - pitfalls 记录单用户每小时 3000 次文件上传配额对真实链路冒烟的影响与选项目口径	2026-09-28 19:35:22 +08:00
kdletters	25a992468d	写入对象存储时下发对象级 ACL，修掉发行包可匿名直取 ... - platform-oss 的内部 PUT 与分片追加显式下发 x-oss-object-acl（Private 为 private、Public 为 public-read），OssAppendInternalObjectRequest 增加 access 字段 - 直传 policy 增加 x-oss-object-acl 条件，表单字段与 shared-contracts 的 DirectUploadTicketFormFields 同步新增并透传到 ticket 响应 - 媒体链路 E2E 增加匿名直取直传封面与发行包两条探测：默认 WARN，E2E_REQUIRE_PRIVATE_BUCKET=1 时按失败处理 - 里程碑第 7 条、pitfalls 与 decision-log 记录根因、修复与复验（严格模式 65 项 PASS，两处匿名直取都 403）	2026-09-28 19:20:21 +08:00
kdletters	fb87e1d4ff	补齐游戏分发安全下架取证并记录发行包对象可匿名直取 ... - 媒体链路脚本新增管理员安全下架与恢复段：suspend 后目录/详情/发行读取全部关闭、过期 revision 的 suspend 被 CAS 拒绝、restore 后重新公开且可玩 - 新增匿名直取发行包对象探测：本地 dev bucket 返回 200（同 bucket 不存在 key 为 404），默认只打 WARN，E2E_REQUIRE_PRIVATE_BUCKET=1 时按失败处理 - 游戏分发里程碑阶段 B 第 7 条补上「不能绕过网关直取 OSS 在当前环境不成立」的实测、根因与剩余缺口 - pitfalls 记录 platform-oss 的 put_internal_object_bytes 从不发送 x-oss-object-acl 的问题与上线前处理	2026-09-28 19:08:51 +08:00
kdletters	6cbc56dd98	补齐游戏分发审核 CAS 与下架可见性取证 ... - 媒体链路脚本新增 publicationRevision CAS 段：过期审核与过期下架 409 PUBLICATION_CONFLICT、同 key 重放批准 replayed=true、并发激活只有一次成功、下架前的 revision 不能批准新版本 - 新增作者下架后的可见性段：公开目录不含、详情 404、发行网关 404，且目录与详情不返回对象存储地址 - 游戏分发里程碑阶段 B 第 3、4 条改为已勾选，脚本共 58 项 PASS	2026-09-28 19:04:23 +08:00