2615 Commits

Author	SHA1	Message	Date
kdletters	b79ee96f7e	补齐容器预览的 AGC Router 密钥说明 ... - deploy/container/api-server.env.example 增加 AGC 官方 LLM Router 段，列明容器预览必须由 .env.secrets.local 提供的三个密钥 - 【开发运维】Jenkins容器预览部署控制面技术方案 补充预览 secrets 必含密钥与缺失时的失败表现 - 【开发运维】本地开发验证与生产运维 补充容器与 Jenkins 预览路径同样受 Router 启动校验约束 - project-memory pitfalls 补充容器预览缺少 Router 密钥时的排障特征	2026-09-14 19:52:27 +08:00
k88936	411f49a65d	Merge pull request 'UI编辑器自动分图层切图标' (#304) from feat/ui-editor-auto-seperation into master ... Reviewed-on: #304	2026-09-14 18:59:00 +08:00
kdletters	e8403e547b	补齐游戏从策划到成品的完整生产流程 ... 新增 AGC 完整游戏生产 workflow Skill，定义策划、资源、实现、构建、试玩和交付阶段。 将真实美术生成、处理、登记和接入从可选提示改为新游戏交付链路要求。 同步 Skill Pack 清单、系统提示、测试契约和实施计划文档。	2026-09-14 18:43:12 +08:00
kdletters	90d216e241	Merge remote-tracking branch 'origin/master'	2026-09-14 18:35:22 +08:00
kdletters	c799d00a93	记录分支保护现状：不把 Project CI 配成合并必需检查 ... 复核后确认本仓库不把 Project CI 的 context 配成 master 分支保护的合并必需检查，合并前由人工 确认最近一次结果。据此把文档里"必须设为合并必需检查 / 需补 6 个新 context"的强制口径改成 与现状一致，避免下次有人照着一个不执行的待办去逐个勾选 context： - 开发运维文档：说明当前不配 required context（代价是门禁红了不会自动阻止合并），把 11 个 context 清单降级为"将来若要启用时的清单"，并保留"不能残留已不再上报的旧 job 名，否则 PR 会永远停在等待该检查"这一条；master 交付口径里"当前 head 的七个 required context 全绿" 改为"最近一次 Project CI 全绿"。 - shared-memory/decision-log：AGC 壳分片那条的"影响范围"不再把它列为待补 context 的待办。 - shared-memory/pitfalls：置顶条目新增"分支保护口径"，并把旧条目里"要补齐两个新 AGC context"改成"确认没有残留旧 job 名"。 - .craft 的 gitea-ci-triage 技能同步为"改 job 集合或 job 名不需要同步分支保护"。 验证：prettier、check:encoding、check:doc-index 通过。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 18:35:00 +08:00
lhk229	2b5ce24a97	Merge branch 'master' into feat/ui-editor-auto-seperation	2026-09-14 18:31:38 +08:00
lhk229	cf4a275d26	缓存 sccache 探测结果避免重复阻塞 ... 在当前 dev 编排进程内复用 sccache wrapper 探测结果 避免 API 与 worker 重启重复同步等待 同步更新排障文档	2026-09-14 18:15:12 +08:00
lhk229	fed9960684	修正 POSIX sccache 绕过日志 ... 明确记录 Linux 和 macOS 本地开发实际绕过 sccache 补充 POSIX 日志回归测试并更新排障文档	2026-09-14 18:15:12 +08:00
lhk229	a3918c89f0	按显式配置控制 Windows sccache ... 未配置 wrapper 时默认回退到直接 rustc 处理 sccache 探测失败与 wrapper 配置冲突 同步更新开发运维和排障文档	2026-09-14 18:15:12 +08:00
lhk229	f955661146	增强 Windows sccache wrapper 探测回退 ... 使用限时真实 rustc wrapper 探测替代版本检查 探测失败或超时时回退到直接 rustc 同步更新 sccache 故障排障记录	2026-09-14 18:15:12 +08:00
lhk229	dcaa1a2dd5	支持 Windows 本地 sccache 自动回退 ... Windows 本地开发检测可用的 sccache 并启用缓存 未安装或不可执行时清空 Rust wrapper 并回退到 rustc 补充测试并更新开发运维文档	2026-09-14 18:15:12 +08:00
k88936	b082addc34	Merge remote-tracking branch 'origin/master' into feat/ui-editor-auto-seperation	2026-09-14 17:41:36 +08:00
kdletters	2566ae705f	AGC 壳 Rust 套件改为「一片一个 job」，客户端 Rust 关键路径压到 7 分钟以内 ... 上一轮把 2466 条 bin target 单测切成 4 片放在同一个 job 内多进程并行，run 2102 证明这条路 不通：门禁步骤跑满 18 分钟仍未结束，比整套串行的 507 秒还慢——同一容器内这几片共享 HOME、target 目录与固定临时路径，会互相拖慢。这一轮改成按 job 拆分。 - run-rust-shell-test-shards.mjs 新增 --shard-index=<i>：只跑第 i 片，供 CI 的每个分片 job 使用；覆盖自校验（片并集等于 --list 全集且互斥）仍针对全集执行，所以每个 job 都会 发现分片规则改动，不会被"只跑一片"绕过。负例 --shard-index 超出 --shards 立即失败。 不传 --shard-index 时行为不变（一条命令把 N 片放进程里并行），留给本地全量自测。 - project-ci.yml 由 7 个 job 变 11 个：原 AGC Rust job 拆成 AI game creator shell Rust shard 1/4 ~ 4/4 与 AI game creator shell Rust smoke，加上已有的 Rust crates，AGC 相关 门禁共 6 个 job。4 个片 job 只预热 AGC 壳自己那份锁定依赖，且与 smoke、crates 一样都是 纯 cargo 门禁，因此这 6 个 job 都不再执行 npm ci（每个省 1~3 分钟）。 - check-native-shells.mjs 分组由五个变十个：agc-rust-shard-1 ~ agc-rust-shard-4 与 agc-rust-smoke 取代 agc-rust-shell；每个分片分组的命令是 `npm run ai-game-creator-shell:check:rust:shell -- --shard-index=<i>`。 - project-ci-workflow.test.ts 相应更新：11 个 job、6 个 job 免 npm ci、10 个分组各被一个 job 恰好调用一次，并新增「每个分片 job 都落到 --shard-index」「4 个 index 各一次」 「分片运行器保留覆盖自校验」等断言。 - 同步运维文档、development-workflow、decision-log、pitfalls 与 gitea-ci-triage 技能到 job 级分片口径，并记录 run 2102 的反面实验，避免以后又改回单 job 内并行。 验证：npx vitest run scripts/project-ci-workflow.test.ts（12 passed）、eslint、prettier、 check:encoding（13330 文件）、check:doc-index、--groups=contract、mobile check-config 全绿； 分片运行器本地以 agent-runtime-core（7 条 → 2/2/2/1）验证 --shard-index 四个 index 各自 只跑一片、片 TMPDIR 隔离、无 index 时全量模式不变。Gitea master 分支保护需补 6 个新 context（共十一个），其中含 4 个分片 job、smoke job 与 crates job。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 17:32:06 +08:00
kdletters	86b830cf2d	AGC 壳 Rust 套件分片并行，客户端 Rust 关键路径压到 7 分钟以内 ... run 2097 显示 AI game creator shell Rust tests 是客户端 CI 的关键路径（15 分 27 秒）： 前置 5 分 30 秒（checkout + npm ci + Cargo fetch）、编译 1 分 39 秒、AGC 壳 bin target 的 2466 条单测一条命令串行 507 秒、agent-run smoke 51 秒。 - 新增 apps/ai-game-creator-shell/scripts/run-rust-shell-test-shards.mjs：cargo test --no-run 编译一次拿到测试可执行文件，用 --list 取全部用例名，排序后按 index % shards 切 4 片，每片作为独立进程执行 <bin> --exact <名单> --test-threads=1，并给每片独立 TMPDIR。片并集必须等于 --list 全集且互斥（assertShardsCoverEveryTest），改分片规则 不会静默漏跑。串行口径只从「整套串行」放宽到「片内串行」：当年 libtest 线程并行会 互相干扰的是进程内后台锁与异步终态，进程分片不共享这些状态，因此不必放宽断言。 - package.json：ai-game-creator-shell:check:rust 拆成 :rust:crates（agent-runtime-core / orchestration / platform-llm / shared-contracts）与 :rust:shell（分片运行器），聚合 脚本保持同序，ai-game-creator-shell:check 与本地全量入口语义不变。 - check-native-shells.mjs：分组由五个变六个（新增 agc-rust-crates、agc-rust-shell， 移除 agc-rust）；smoke 与壳测试同组以共享 AGC 壳的依赖预热。 - project-ci.yml：新增第 7 个 job AI game creator shell Rust crates（预热 server-rs 与 两个无锁独立 crate 后跑四条 crate 测试）；AI game creator shell Rust tests 只保留壳 分片与 agent-run smoke，并只预热 AGC 壳自己那份 manifest（其 Cargo.lock 的 path 依赖 已覆盖 platform-llm / platform-agent / agent-runtime-core / shared-contracts）。 这两个 job 只用 cargo 与 node 内建模块，因此都不再执行 npm ci（各省 1~3 分钟）。 - project-ci-workflow.test.ts：新增纯 cargo job 免 npm ci、分片运行器覆盖校验、crate 级 job 预热顺序等断言；同步运维文档、development-workflow、decision-log、pitfalls。 验证：分片运行器本地以 agent-runtime-core（7 条 → 2/2/2/1）与 platform-llm（146 条 → 49/49/48）验证分片、--exact 与片 TMPDIR 隔离，参数负例 exit 1；vitest scripts/project-ci-workflow.test.ts 12 passed；contract 分组、AGC 与 mobile 壳 check-config、eslint、prettier、check:encoding（13400 文件）、check:doc-index 全绿。 Gitea master 分支保护需补 Project CI / AI game creator shell Rust crates (pull_request)。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 17:02:34 +08:00
kdletters	f9bd0adae1	补齐客户端 CI 拆分的共享记忆：label 字面量契约与实测耗时 ... - pitfalls：新增「根门禁的 [check:native-shells] <label> 是别处按字面量校验的契约」， 记录 run 2095 里 desktop-shell typecheck 的失败根因（label 被抽进公共打印函数后， check-config 的字面量断言落空）、处置与本地验证方式。 - decision-log：把「预计收敛到约 13 分钟量级」换成 run 2097 实测——六个 job 全绿、 wall-clock 15 分 27 秒（拆分前 run 2094 为 22 分 15 秒），关键路径转移到 AI game creator shell Rust tests，壳体串行套件 507 秒是硬底。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 16:47:35 +08:00
kdletters	20f109027a	按门禁组拆分客户端 CI，AGC 的 web / rust 两段并行 ... 原生壳门禁原本挤在同一个 job 里串行执行，跑一遍 18 分 37 秒，其中 AI 游戏创作 壳独占约 15 分钟（壳内 Rust 套件 2451 条用例串行 441 秒），而微信 / 移动 / 桌面 / H5 的全部门禁加起来不到 50 秒。长尾拖住短门禁，runner 也无法并行。 - scripts/check-native-shells.mjs 支持 `--groups=`（contract / shells / agc-web / agc-rust / release）：每个步骤与静态断言归属且只归属一个分组，不带参数时仍按 原顺序串行跑全部分组，本地 `npm run check:native-shells` 语义不变。 - 顺带修掉 H5 HostBridge 调用链扫描在 Windows 上恒红的缺陷：collectFiles 返回 反斜杠路径而期望清单是 POSIX 写法，scannedFiles.has() 永远为假。新增 normalizeScannedFilePath 只统一分隔符（不能复用会去后缀的 normalizeModulePath）， 在 Linux 上是恒等变换。 - package.json 增加 5 个分组脚本，并把 ai-game-creator-shell:check 拆成 :check:web 与 :check:rust；聚合脚本保持 web && rust && agent-run:smoke 同序。 agent-run smoke 会 spawn cargo，因此归入 agc-rust。 - .gitea/workflows/project-ci.yml 拆成 6 个 job：新增 native-shell-tests（contract + shells + release）、ai-game-creator-shell-web-tests、ai-game-creator-shell-rust-tests 三个门禁 job，与 backend-tests / frontend-tests / repository-checks 并列。 - scripts/project-ci-workflow.test.ts 增加 3 条结构测试：分组恰好被一个 job 调用且 与脚本内声明一致、CI 不再调用全量入口、AGC web/rust 拆分与聚合脚本等价、独立 crate 预热必须发生在 AGC Rust 门禁之前。 - 同步运维文档、development-workflow、decision-log、pitfalls。 验证：`--groups=contract` 本地通过；vitest 11 passed；eslint 与 prettier 通过； check:encoding 13329 文件通过；check:doc-index 103 份通过。shells / agc-web / agc-rust / release 分组只能由 Linux CI 执行（Windows 上 spawnSync npm.cmd 报 EINVAL，属既有平台限制，非本次引入）。分支保护需补两个新 required context： `Project CI / AI game creator shell web tests (pull_request)` 与 `Project CI / AI game creator shell Rust tests (pull_request)`。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 16:13:11 +08:00
kdletters	4e553bb15d	收窄项目写锁同进程复用判据为同线程重入 ... - 修复 write_lock.rs：advisory 复用判据从「本进程持锁」收窄为「同一线程重入或自主流水线」，新增按锁路径登记真实持锁线程的 PROJECT_WRITE_LOCK_THREAD_OWNERS，登记在 create_new 成功处、在 guard Drop 里按路径注销（guard 会被移到别的线程再 Drop） - 恢复本进程其它线程写通道的串行化：一致快照读、project.diff / action_history、command.output_read、steer 序号分配、项目 revision 侧车、pending sidecar 复核与恢复安装重新等待并保持终态占用 - 调整 tests/project_tools.rs 的 agent_runtime_file_write_lock_failure_redacts_project_path：改为在另一条线程持锁，保持「别的写者持锁时 file.write 失败关闭且脱敏」的断言语义 - 调整 ui_editor/persistence.rs 的 recovery_install_respects_the_project_write_lock：同样改为在另一条线程持锁，保持占用失败断言 - 同步技术方案「2026-09-14 项目客户端占用锁收敛」段落，以及里程碑和实施计划的目标、验收标准、修改顺序、验证命令与未决事项 - 在 decision-log 记录复用判据收窄为同线程重入，并在 pitfalls 记录「同进程复用判据不能只看 pid」的现场、原因、处理与易错点 - 回答 AGC 生命周期文档「同 PID advisory guard 是否放过并行写」的未决项：确认会放过并行写，已收窄 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 15:41:17 +08:00
kdletters	7092689b36	收口 AGC 生命周期超时隔离与建项恢复 ... ## 变更内容 在 master（0f829cd25）上用故障注入复现出四类"每走一步都会卡住"的生命周期残留，本轮按"超时后真正隔离并核对底层操作"收口，不再新增 operation 字段： - 本地会话写入队列从"无限等上一次完成"改为带解围期限的闸门（60s）。Rust 侧 install/clear 本来就按 generation 单调拒绝更旧写入，所以渲染层只需保证新 generation 不被卡死的调用永久挡住； - generation floor 读取不再把一次瞬时失败缓存成永久失败（原先 `??=` 缓存了已 reject 的 promise，导致同一渲染进程内后续登录/退出全部失败）； - 登录 UI 的 45 秒围栏只放弃等待、不放弃结果：本地运行时确实装好会话时界面跟随进入工作区，且迟到结果不会覆盖更新的登录尝试； - 首页自动建项从 `deadlineMs: null` 改为 10 分钟兜底期限：到点解围并提示（底层创建继续在后台跑，迟到成功照常进项目），失败时保留 `scope.projectPath`、登记最近项目并新增「打开已创建的工作区」入口；底层创建未返回期间只挡"再建一个"，不挡打开已有项目； - 同步 `project.bootstrap` 权限文案断言、生命周期技术方案状态与 shared pitfalls。 ## 验证 - `npm --prefix apps/ai-game-creator-shell run typecheck`（含 skill-pack、check-config） - `vitest run apps/ai-game-creator-shell/tests/appSurface.test.ts`（428/428，含新增 5 个故障注入回归；`project.bootstrap` 文案断言在此前 master 上确定性失败） - 定向 `clientHttp`、`clientApi`、`clientOperation`、`recentProjectsModel`、`clientRuntimeErrorBoundary`、`sessionPreview`、`start-dev-stack`、`dev-port`、`start-tauri-dev`（全部通过） - `npm run check:doc-index`、`npm run check:encoding`、`git diff --check` 原生 Runner/IPC 与真实 Provider 下的同一批时序未执行，本轮结论来自 deterministic surface 与 mock 故障注入。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 14:49:45 +08:00
k88936	ad8f42a68f	回写自动切分问题节点状态 ... 扩展 problematic DTO 携带完整返工历史 分离流程回写 NeedReview 并清理成功节点旧状态 补充概览计数定位与状态覆盖测试 同步 UI workflow 规范文档	2026-09-14 14:34:33 +08:00
kdletters	0f829cd252	完成 DirectProject Phaser 迁移闭环 (#353) ... ## 变更 单 HTML → Phaser 4 + Vite 的迁移链路现在有明确且可执行的工程合同：Phaser/npm 目标固定走 DirectProject，旧 JSON Generator 继续只处理单文件 HTML。 - 新增受控 `project.bootstrap`，仅允许项目内 `game` 目录执行无参数 `npm install`，校验 package/lock、路径、npm 管理器并记录依赖指纹。 - `project.verify` 支持相对 `cwd`，构建前诊断缺失依赖，`cwd=game` 的 build 必须产出 `game/dist/index.html`。 - npm bootstrap 使用受控网络沙箱；通用 `command.exec npm install` 仍被拒绝。 - 同步 Runtime 工具广告、执行分发、审计、权限策略、DirectProject/Generator 提示、前端权限面板、TypeScript/Rust 契约和项目文档。 - Phaser 迁移提示覆盖 Scene、输入、敌人/守卫、波次、胜负、重开和桌面/移动双视口验收。 ## 验证 - `npm run ai-game-creator-shell:typecheck` - `cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml` - `cargo fmt --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml -- --check` - `cargo test --locked -p shared-contracts --manifest-path server-rs/Cargo.toml game_creation_app` - 定向 `project.verify` Rust 测试 - `npm run check:encoding` - `npm run check:doc-index` - `git diff --check` - 真实 DirectProject：`npm install`、`npm run build` 成功，`game/dist/index.html` 存在。 - 浏览器试玩：桌面视口画布非空；移动视口触摸开火、键盘换道和重开逻辑均已观察确认。 真实项目没有纳入仓库提交；PR 只包含客户端合同、Runtime 能力和验证门禁。 Reviewed-on: #353	2026-09-14 13:57:24 +08:00
kdletters	c146f7f99c	建立 AGC 稳定版生命周期基础合同 (#348) ... ## 变更内容 这是基于 PR #346 的稳定版生命周期基础切换，承接已完成的 HTTP body timeout、Runner blocking worker、最近项目逐项刷新和首页跨页防重： - 新增统一 `ClientOperation` 合同，固定 operationId、requestId、phase、deadline、scope、cancellable 和 stale 判定； - 认证 refresh 投影 `auth-refresh` operation；登录、401 refresh、退出共用平台 session generation，并由 `auth-transition` 投影 Runner phase/成功/失败/不确定状态； - 首页自动创建记录 draft、startMode、phase 和建项后的 project scope，页面卸载不会释放 operation； - `.app/dev-stack.json` 增加 instanceId、repoRoot、服务级 dataDir/instanceId，AGC Vite marker 增加 repoRoot/processId/port；缺身份的旧状态拒绝 AGC 后端复用； - 新增稳定版生命周期主规范、开发运维口径和 shared pitfalls。 ## 验证 - `npm --prefix apps/ai-game-creator-shell run typecheck` - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/clientOperation.test.ts tests/clientApi.test.ts tests/clientHttp.test.ts tests/recentProjectsModel.test.ts tests/start-dev-stack.test.ts tests/dev-port.test.ts --reporter=dot`（61 passed，2 skipped） - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/appSurface.test.ts --reporter=dot`（423/423 passed） - `node --check scripts/dev.mjs` - `node --check apps/ai-game-creator-shell/scripts/start-dev-stack.mjs` - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` `scripts/dev.test.ts` 全量仍有 1 个 Windows 文件权限相关既有失败：bootstrap secret 测试在 Windows 上无法通过 chmod 模拟 0600；本变更未触及该逻辑。 Reviewed-on: #348	2026-09-14 13:56:56 +08:00
kdletters	818cfdba50	收敛项目客户端占用锁语义 (#344) ... 本 PR 收敛项目锁的同进程重入语义，避免客户端内部调用等待自身持有的 `.agent/project.lock`。 变更： - 同进程嵌套项目锁返回 advisory guard，不删除真实持有者锁。 - 跨进程占用、残留回收和权限分类保持不变。 - 增加回归测试与锁收敛里程碑/实施计划文档。 验证： - 定向 Rust 锁测试通过。 - Runner owner 定向测试通过。 - cargo fmt --check 通过。 - npm run check:encoding 通过。 - git diff --check 通过。 后续里程碑：Runner 的 `.agent/runtime/execution-owner.lock` 迁移到统一项目占用锁仍需单独完成跨进程生命周期验证。 Reviewed-on: #344	2026-09-14 13:56:23 +08:00
kdletters	86c1187ddc	放开 DirectProject Codex 沙箱权限 (#347) ... ## 变更内容 - DirectProject Codex app-server 使用 danger-full-access sandbox。 - 移除 workspaceWrite / writableRoots 与文件变更审批根白名单。 - DirectProject app-server 交互请求不再按 grant root 裁剪；首页只读对话、AGC 受控 MCP、凭据隔离和 Runtime 审计边界保持不变。 - 同步更新 DirectProject 提示词、技术方案和决策记录。 ## 验证 - Rust 定向测试：49 passed，1 ignored。 - npm run check:encoding 通过。 - npm run check:doc-index 通过。 - git diff --check 通过。 - pre-push-master 门禁通过。 Reviewed-on: #347	2026-09-14 13:19:44 +08:00
kdletters	991b2a1104	修复 AGC 异步操作恢复闭环 (#346) ... ## 变更内容 AGC 登录、Runner 会话、最近项目检查和首页自动创建原先各自维护异步状态，响应体卡住、单目录变慢或切页会导致按钮长期 busy、项目列表整体不可用或重复创建项目。本 PR 将这些入口收口到可恢复的生命周期边界： - 认证响应体读取增加独立超时，refresh singleflight 在失败后释放； - Runner 会话安装/清除移到 blocking worker，登录/退出增加 45 秒 UI fence； - 最近项目逐项检查并设置单项目超时，已完成行不受其它慢目录阻塞； - 首页自动创建锁提升到 WorkspaceLauncher，切页后仍防重并保留状态； - 新增异步闭环技术方案、body 卡住测试、逐行项目测试和跨页创建测试。 ## 验证 - `npm --prefix apps/ai-game-creator-shell run typecheck` - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/clientHttp.test.ts tests/clientApi.test.ts tests/recentProjectsModel.test.ts --reporter=dot` - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/appSurface.test.ts --reporter=dot` - `cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml` - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` `appSurface.test.ts` 390/390 通过；保留仓库既有 act/jsdom media warning。本 PR 未触发真实 Provider 或发布安装包。 Reviewed-on: #346 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-14 13:19:13 +08:00
k88936	a0325d653e	补充图片编辑代理与素材切分工作流技术文档链接	2026-09-14 11:58:53 +08:00
k88936	513c25898c	Merge remote-tracking branch 'origin/master' into feat/ui-editor-auto-seperation ... # Conflicts: # apps/ai-game-creator-shell/src/view/project-development/index.tsx	2026-09-14 11:32:17 +08:00
lhk229	6149aaf5f6	修复资源替换弹窗初始化竞态 ... 将弹窗打开态初始化改为 useLayoutEffect，避免素材选择被异步初始化清空 补充资源选择弹窗竞态的排障记录与定向验证命令	2026-09-13 11:44:27 +00:00
suzmii	7b21bc529e	合并 master：Cocos 插件按当前项目类型暴露 ... - 合入 origin/master c19b32178，使 PR 头包含当前 master tip，修 CI comparison base 门禁（11 秒红） - 冲突 1 处：docs/project-memory/shared-memory/decision-log.md 两侧追加记录，两条逐字保留（HEAD 的 2026-09-11 起多条 + master 的「2026-09-13 Cocos 插件按当前项目类型暴露」），只删 3 行冲突标记 - 验证：npm run check:doc-index 通过（97 份 Markdown）；npm run typecheck exit 0；check:encoding 4557 文件通过；git diff --check 干净；全仓无冲突标记	2026-09-13 17:27:14 +08:00
suzmii	7ed88eb93c	修复文档索引检查：移除退役文档死链并登记 4 份未分类文档 ... - docs/README.md 移除指向已退役删除的「客户端素材创作无限画布阶段一合同」链接（该文档已由 91396f061 删除，链接成为死链，check:doc-index 报「链接不存在」） - 登记本分支新增但未入索引的 4 份文档为 current：AGC 资源派生与非破坏性编辑合同、AGC 聊天素材引用、AGC 聊天 AI 润色与发送前提醒（AI 游戏创作与 Agent Runtime 章节），AGC 资源工作台 V3 端到端验收（后端、运维与测试章节） - 成因：master #339 引入文档生命周期索引后，check:doc-index 要求 docs/README.md 链接全部有效、且 docs 下每份 Markdown 都必须分类；这 4 份文档只存在于本分支，master 上不存在，故 master 自身检查通过而本分支报「文档未分类」 - 验证：npm run check:doc-index 通过（97 份 Markdown，current=80 / historical=11 / review=1）；npm run check:encoding 4557 文件通过；git diff --check 干净	2026-09-13 17:20:23 +08:00
kdletters	c19b321785	Cocos 插件按当前项目类型暴露 ... 新增 Cocos 项目根识别门禁，限制插件、面板、RPC 和编辑器执行范围 让 DirectProject MCP 工具目录按当前项目类型动态过滤 切换离开 Cocos 项目时停止已运行的插件实例 补充项目级测试、Cocos 技术方案和插件说明	2026-09-13 17:12:37 +08:00
suzmii	840a62f7d0	合并 master：规范化历史文档并合入 AGC 插件宿主能力（#339） ... - 合入 origin/master 96b45e6ff，使 PR 头包含当前 master tip，修 CI comparison base 门禁（15 秒红） - master 侧 28 个文件，零冲突自动合并 - 验证：npm run typecheck exit 0；check:encoding 通过；git diff --check 干净	2026-09-13 17:11:06 +08:00
kdletters	96b45e6ffc	规范化历史文档并合入 AGC 插件宿主能力 (#339) ... ## 变更 - 建立文档生命周期与现状索引，统一 `current`、`historical`、`review`、开放事项和活动计划边界。 - 为历史/待复核文档补充状态头，将有源码与测试证据的专题纳入当前入口。 - 新增规范驱动开发 skill 与 `check:doc-index` 门禁，并接入 `lint`。 - 合入 `origin/master` 的 AGC 通用插件宿主与 Cocos Creator 编辑器能力，并补充父子规范关系和验收范围。 ## 合并说明 - 合入基线：`origin/master` `4a46f89c9`。 - 合并提交：`259134b59`。 - 合并过程无冲突。 ## 验证 - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` - `python -X utf8 C:/Users/kdletters/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/spec-driven-development` - 推送前 pre-push master 门禁通过。 ## CI 请以本 PR 的 Gitea CI 检查为准；提交后持续关注，失败时按失败 job 继续修复。 Reviewed-on: #339 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-13 16:21:34 +08:00
suzmii	7ae71441ba	合并 master：接入 AGC 内置插件宿主与 Cocos 编辑器能力（#338） ... 合并 origin/master 4a46f89c9 到 chore/agc-acceptance-build（HEAD 55fab1776），本次合并共涉及 117 个文件（113 个自动合并 + 4 个冲突）。 - 自动合并 113 个文件：插件宿主与插件工作区（plugin_host.rs / builtin_plugins.rs / editor_adapter(_s).rs / plugins/agc-cocos-editor / cocos-editor-bridge crate / editor-adapter-api）、构建与打包脚本、locked Cargo.lock 及 master 侧锁与资源链路改动；不逐条列出。 - 冲突 1 apps/ai-game-creator-shell/src/App.tsx:271-278：两侧各自新增一个 import（本分支 ./services/tauriEventSubscription、master ./services/pluginHost），两个 import 都保留，并按 simple-import-sort 口径排在 ./services/platformSession 之后、tauriEventSubscription 之前；四个符号都仍被使用。 - 冲突 2 docs/project-memory/shared-memory/decision-log.md:8338-8469：两侧在同一位置追加记录，逐字保留两侧记录且各自原有顺序不变（先本分支的 2026-09-11 资源卡预览 data URL / loopback HTTP 两条，后 master 的 2026-09-09～2026-09-12 通用插件宿主、Cocos 桥接与内置插件开关条目），不改写、不合并措辞。 - 冲突 3 docs/project-memory/shared-memory/pitfalls.md:79-112：同上，保留本分支的「2026-09-05 资源画本转场与视口分离」与 master 的「2026-09-11 首页自动工作区必须使用 AGC 管理目录」「2026-09-12 Cocos 项目识别不等于编辑器桥就绪」「2026-09-11 Cocos 项目必须走独立导入分支」，内容逐字保留、两侧原顺序不变。 - 冲突 4 apps/ai-game-creator-shell/src-tauri/src/agent/direct_project_history.rs:400-435：判据是「两侧不互斥」，解法为 both（语义超集）。 - 冲突 4 保留本分支的有界退避重试循环（DIRECT_PROJECT_HISTORY_CONTENTION_RETRY_BACKOFF_MS + is_direct_project_history_contention_failure + 测试注入点）与单次尝试函数 append_direct_project_history_item_once（含锁外幂等回扫与锁内状态复核）。 - 冲突 4 保留 master 的有界等待取项目写锁：把该函数内原来的零等待 crate::project::acquire_project_write_lock(root, "conversation.write") 换成 acquire_game_creator_agent_runtime_project_write_lock_with_wait(root, "conversation.write")，并原样保留 master 的注释（agc_write_file 占锁 5.5 秒期间，零等待取锁会让流式历史落盘直接失败）。 - 冲突 4 判断依据：master 只替换了同一处的取锁语义（零等待 → 约 10 秒有界等待，并有 append_waits_for_a_same_process_project_writer 用例锁定），不改变函数签名、调用方与错误类型；HEAD 的重试循环因此仍然可达，与有界等待叠加后语义更强——写文件占锁由有界等待吃掉，等待窗口耗尽后的残余争用再由一次 250ms 短退避重试兜底。未删除任何一侧行为，也未放弃任何一侧语义。 - 冲突 4 位置取舍：有界等待取锁仍放在锁外回扫与序列化之后（本分支结构），保住「幂等回扫与序列化留在锁外、不让他人等整份历史读完」的性能语义；master 的注释与调用参数逐字保留。 - 验证：npm run typecheck、npm --prefix apps/ai-game-creator-shell run typecheck、cargo check --locked --all-targets（exit 0，0 error）、npm run check:rustfmt、npm run check:encoding、git diff --check 全部通过；冲突标记扫描为空。 - 定向 Rust 测试（--test-threads=1）：direct_project_history 19 passed / 0 failed（含本分支 contention_failure_is_retried_with_bounded_backoff、contention_failure_beyond_the_backoff_budget_fails_closed、shape_failure_is_not_retried 与 master 的 append_waits_for_a_same_process_project_writer）；conversation 36 passed / 0 failed；write_lock 21 passed / 0 failed。两侧用例同时绿，证明有界等待取锁与有界退避重试叠加后语义自洽。 - 未跑全量测试（按仓库约定本地只跑定向，全量交给 CI）；本次不 push。	2026-09-13 15:33:48 +08:00
kdletters	4a46f89c9b	接入 AGC 内置插件宿主并补齐 Cocos 编辑器能力 (#338) ... 客户端新增随包提供的插件宿主和 Cocos Creator 集成：识别并导入 Cocos 项目，通过内置桥接操作已打开的编辑器，无需安装项目 MCP 扩展。DirectProject 现在公开 36 个独立 cocos_* 工具，保留通用 JavaScript 执行入口。 - 通用插件 SDK、命令/能力/面板注册、编辑器适配器和跨进程内置插件开关。 - Cocos 场景、节点、组件、Prefab、UI、Layout/Widget、资源、保存、撤销、日志与预览调试；目录和实现由 JS/native 共用。 - 编辑事务回读、失败回滚、后续手动修改保护及不确定结果禁止重放；预览截图通过 MCP image 返回。 - DirectProject 跳过无关专业 Agent 历史，将项目打开和历史读取中的同步 I/O 移出窗口线程，消除 Cocos 执行与项目文件锁的错误耦合。 验证： - 合并 master 后：类型/配置检查、编码检查、Rust 格式检查和提交钩子通过。 - 合并 master 后：Cocos 项目打开、插件面板和开发启动定向测试 10 通过、2 跳过；DirectProject MCP 测试 17 通过、1 项真实 Creator opt-in 忽略；插件宿主测试 9/9。 - 插件行为测试 17/17；native 测试 20/20，4 项 opt-in 测试默认忽略。 - 真实 Creator 3.8.8 的 36/36 操作 smoke，以及客户端 MCP tools/list、tools/call、UI/撤销和预览截图，在功能实现阶段已验证通过；本次 master 合并后未重复真实 GUI smoke。 验证边界：发行安装包和远端 CI 尚未验收。 Reviewed-on: #338 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-13 14:48:55 +08:00
suzmii	55fab1776a	AGC 画布验收问题修复与栏目画布底部工具栏 ... - 合并资源画布命名筛选与条件筛选为单一筛选浮层，Dock 只留放大镜入口 - 修复「编辑素材标签」面板标签多时不可见且不可滚：加高度上界与标签区独立滚动 - 替换素材新增点选替换模式，并在资源卡标注会话内替换血缘 - 新增栏目画布底部工具栏，按功能画布分流图片类生成、音频生成与上传入口 - 新增 Tauri IPC generate_local_project_asset，收口图片类无源生成的 kind 与提示词目录 - 同步 PRD、AGC 验收用例、决策日志、踩坑记录与待解决事项文档	2026-09-13 14:07:03 +08:00
k88936	9856bb7057	补充 UI 工作流安全边界说明 ... 记录提示清洗、图片解码限制、上传超时和 sidecar 产物恢复约束。	2026-09-12 21:44:12 +08:00
k88936	a19684a5f5	Merge remote-tracking branch 'origin/master' into feat/ui-editor-auto-seperation	2026-09-12 19:46:41 +08:00
suzmii	fc67439802	修复资源画布浮层里的滚轮被画布消费：@ 选择器列表滚动时画布跟着平移 / 缩放 ... - 共享浮层判据抽出 isEventInsideFloatingOverlay，并新增 isFloatingOverlayWheelEvent：关闭判定与滚轮归属共用同一份口径（DOM 不在边界里的 portal 浮层 + 已登记浮层） - isEventInsideFloatingMenu 返回值收紧为布尔，避免判据把命中的元素当真值往下传 - 资源画布唯一滚轮入口 handleResourceBookWheel 加统一守卫：浮层里的滚轮一律不消费（不 preventDefault、不动视口），不再逐浮层加 stopPropagation - resourceCanvasFocusModel 增加 RESOURCE_CANVAS_WHEEL_OVERLAY_SELECTOR 与 isResourceCanvasWheelOverlayTarget，登记留在画布 DOM 里自带滚动区的浮层（快速编辑 / 信息 / 筛选） - projectResourceLiveIntegration 新增用例：在选择器列表上派发真实 wheel → 浮层自己收到该事件、画布 data-resource-viewport 不变；对照组场景根派发 wheel → 视口照旧变化 - resourceCanvasFloatingDismiss 新增判据单测：portal 浮层 / 共享弹出层 / 已登记浮层三种来源归浮层，边界里的卡片与空白仍归画布，判不出归属不抢 - pitfalls.md 记录「portal 事件沿 React 树冒泡导致画布误吃滚轮」的根因与排查口径	2026-09-12 19:29:20 +08:00
suzmii	e4c2f2466f	合并资源工作台分支：卡片从所属摞浮现与既有三条修复并存 ... - 把远端最新 05612c46a（弹窗宿主类样式迁共享表 + 标签统计刷新 + 工具条分隔线去重）合入本分支 b41b26cab（卡片全部从所属摞浮现） - 冲突零：仅 pitfalls.md 两侧追加记录自动合并，两条都保留 - 验证：npm run typecheck exit 0；resourceBookController / resourceBookLayout / resourceTagStatsRefresh / projectAssetPickerDialogShellStyle / selectedLayerToolbarDividerDedupe 五文件全绿	2026-09-12 18:58:52 +08:00
suzmii	b41b26cab8	修复资源画本进栏目只有少数卡片有位移：没有 First 帧的卡片改从那一摞起飞 ... - apps/ai-game-creator-shell/src/view/project-development/resourceBookController.ts：begin() 顺带按 (栏目, 类型摞列号) 记下同一摞最深那张卡的 First 矩形当"堆锚点"，play() 时没有 First 帧的卡片认领它当合成 First（仍是同一套 FLIP，不新增动画系统、不为动画多渲染节点）；堆锚点只在本次转场有效（maybeFinish / settle / invalidate 清掉），转场中重基（已在跑动画）不认领锚点，起点仍是"此刻像素"。 - apps/ai-game-creator-shell/src/view/project-development/resourceBookLayout.ts：展开态（allOpen）的卡片补上真实类型摞列号，不再一律 0——否则第 2 摞之后的卡片会全从第 1 摞飞出来。 - apps/ai-game-creator-shell/src/view/project-development/index.tsx：卡片宿主补 data-resource-book-stack-column / data-resource-book-stack-index，把"哪一摞"的摞身份交给转场层。 - apps/ai-game-creator-shell/tests/resourceBookController.test.ts：新增 3 条用例——每一张卡都从自己那一摞位移出来（含第 0/1 摞分别认领各自锚点、总览已渲染的仍用自己 First）、转场中重基从此刻像素而不是被拉回摞上、转场收尾后挂载的卡片不从过期锚点飞出。 - apps/ai-game-creator-shell/tests/resourceBookLayout.test.ts：新增"展开态每张卡带自己那一摞的列号"用例（同栏目两摞 ⇒ [0,0,1]）。 - apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts：在既有总览/进栏目用例里钉住宿主上的摞身份属性（总览 3 张 = 下标 0,1,2；进栏目后 5 张 = 下标 0..4、同类型列号 0）。 - docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md：把资源画本转场一节更新为当前状态（堆锚点来源、锚点生命周期、展开态列号）。 - docs/project-memory/shared-memory/pitfalls.md：记录本次排障——现象、已用代码核实的原因（总览每摞只铺 3 张 ⇒ 其余卡片没有节点、没有 First 帧）、"钉住的标题栏移出 world"那笔改动不是原因的证据、处理、变异验证与真机判据。	2026-09-12 18:56:43 +08:00
suzmii	05612c46ae	合并资源工作台分支：弹窗宿主类样式迁到共享表与既有修复并存 ... - 把远端最新 b498c2780（标签统计刷新 + 工具条分隔线去重）合入本分支 074924190（弹窗宿主类 platform-modal-shell/overlay/backdrop 迁到共享样式表） - 冲突零：src/index.css 自动合并（本分支删除三条宿主类规则，远端最新新增分隔线去重规则） - 验证：npm run typecheck exit 0；projectAssetPickerDialogShellStyle + selectedLayerToolbarDividerDedupe + resourceTagStatsRefresh 三个用例文件全绿	2026-09-12 18:51:33 +08:00
suzmii	0749241908	修复 AGC「选择替换素材」弹窗面板透明：平台弹窗外壳规则移入共享样式表 ... - 根因：弹窗面板用的 `platform-modal-shell`（遮罩 `platform-overlay`）规则原先只写在网页端整站样式表 src/index.css；AGC 只加载 packages/shared/src/components/styles.css 与 theme.css，类名挂上了但一条声明都没命中，面板因此无底色、无边框、无阴影，背后模糊的资源画布直接透出 - 把 platform-modal-shell / platform-modal-backdrop / platform-overlay 三条宿主类规则从 src/index.css 移进 packages/shared/src/components/styles.css：两个宿主都 import 这张表，规则只保留一份，不在 AGC 业务样式里复制平行副本；三处声明逐字照搬，网页端层叠结果不变 - 新增 apps/ai-game-creator-shell/tests/projectAssetPickerDialogShellStyle.test.tsx：从 src/main.tsx 按真实 import 关系解析出「AGC 到底加载了哪些样式表」，断言清单里有这三条规则、背景引用主题 token、light 主题下 --platform-modal-fill 各色停 alpha ≥ 0.9；DOM 契约断言面板挂 platform-modal-shell、遮罩带 platform-overlay 与 platform-theme--light；并断言这三条规则只在共享表里各定义一次（禁止平行拷贝） - docs/project-memory/shared-memory/pitfalls.md 记录「共享弹窗的宿主类必须落在所有宿主都会加载的样式表里」的排障经验	2026-09-12 18:48:31 +08:00
suzmii	b498c2780e	修复改完素材标签后聊天侧标签统计与候选不刷新 ... - App.tsx：新增跟随工作台壳清单快照的 effect（`manifestRef` + 同一 `projectId` 且内容确实变了才 `setManifest`）， 让聊天侧 `@` 选择器的标签计数与候选在资源命令写入后跟上画布那份清单 - tests/resourceTagStatsRefresh.test.tsx（新增）：真宿主链路用例 —— 资源画布「编辑标签」保存后， 聊天 `@` 选择器出现该标签 chip 与计数、并按它收窄候选；反向用例钉住未标注标签时不渲染标签 chip - docs/project-memory/shared-memory/decision-log.md：记录标签派生数据的三处来源与各自数据源、 根因（`initialProjectManifest` 只是 `useState` 初值，壳里换清单不会再进来）、修复口径与已知未覆盖项	2026-09-12 18:48:04 +08:00
suzmii	4c180ac29a	合并 fix/agc-manifest-revision-cas：钉住的栏目标题栏移出画布缩放层（解 pitfalls.md 冲突） ... - 合并来源：ff0bc5a3e（fix/agc-manifest-revision-cas）。 - 冲突只有 1 个文件 1 处：docs/project-memory/shared-memory/pitfalls.md（两侧都在文件末尾追加了一条 2026-09-12 记录，文本上是同一个插入点）。 - 解冲突（两侧内容逐字都保留，都不改写、不删）： - 保留 HEAD 侧 6618207b5 的「运行模块切换版本报 listeners[eventId].handlerId」一节（pitfalls.md:5397）。 - 追加 ff0bc5a3e 的「资源工作台顶部那一行发虚」一节（pitfalls.md:5407）。 - 同一天的记录之间没有排序语义，取「HEAD 内容不动、新记录追加在末尾」，这样两侧 diff 都是纯插入。 - 另外两处自动合并（git 未报冲突）已逐段语义核对，两侧行为都在： - apps/ai-game-creator-shell/src/view/project-development/index.tsx：ff0bc5a3e 的 renderTitlebar 结构完整保留（:1187 定义、:1244 总览态在 world 内渲染、:1313-1317 钉住的那一条渲染在 world 之外、作为 world 的兄弟节点）；ff0bc5a3e 删掉的 titlebarTransform / safeViewport / safeMainViewport 已无残留；本分支 V3 的行为同时保留（:1234 plan.map 栏目卡、:1250 card.presentation、:1279 isResourceBookAllTarget 预览卡、:1307 worldOverlay、:1318 overlay）。 - apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts：ff0bc5a3e 钉的新不变量（:782-800 钉住标题栏不在 world 内、内联 transform 为空、父节点是场景根）与本分支 V3 既有用例都在。 - resourceBookController.ts 未冲突：nodeWorldTransform（:221）、readWorld 补的 element 输出、nodeWorld 贯穿 cleanRect / FLIP / worldScale（:457、:521）都在。 - 自证： - 仓库内 git grep '^<<<<<<<|^>>>>>>>' 无命中。 - git diff --name-only 87fbf92c5 <本提交> 恰好 18 个文件 = 6618207b5(10) + ff0bc5a3e(5，与前者共用 pitfalls.md) + 46458a825(2) + DesignWorkspacePanel.tsx(1)，没有多余文件。 - git diff ff0bc5a3e <本提交> -- resourceBookController.ts resourceBookController.test.ts 为空（这两个文件 ff0bc5a3e 改过、master 没碰，因此必须逐字一致）；与 ff0bc5a3e 的差异只落在双方都改过的 index.tsx / project-development.suite.ts / pitfalls.md 三个文件上。 - 验证（两条修复都并入后统一执行，全绿）：npm run typecheck exit 0；npm --prefix apps/ai-game-creator-shell run typecheck exit 0；npx vitest run apps/ai-game-creator-shell/tests → 98 files / 1394 passed | 4 skipped（0 failed）；npm run check:encoding → 4489 file(s) passed；git diff --check 干净；npm run check:rustfmt exit 0（这两笔修复都没动 Rust，额外确认一次）。	2026-09-12 18:09:57 +08:00
suzmii	665982eb99	合并 fix/agc-version-switch-event：切换版本报 listeners[eventId].handlerId 的订阅竞态修复并入资源工作台 V3（解 App.tsx 冲突） ... - 合并来源：6618207b5（fix/agc-version-switch-event）。冲突只有 1 个文件 1 处：apps/ai-game-creator-shell/src/App.tsx:1889-1940。 - 冲突成因：master 侧（策划 agent 重构）在 planning-session-v2-stream 之后新增了一条 design-agent-update 订阅（App.tsx:1888）；6618207b5 则把这处相邻的 manifest-invalidated 守卫 `const listen = window.__TAURI__?.event?.listen; if (!listen)` 换成 `canSubscribeTauriEvents()`，两段文本相邻导致冲突。 - 解冲突（两侧都保留，未删任何一侧）： - 保留 master 新增的 design-agent-update effect 及其全部行为符号：designAgentTurnRef 轮次配对、payload.projectPath 比对、setPlanningV2TransientReply、setPlanningV2Reasoning、applyDesignView（App.tsx:1888-1931）；只把它的订阅方式换成 6618207b5 的入口（subscribeTauriEvent<DesignEvent> + canSubscribeTauriEvents 守卫）。 - 采用 6618207b5 对 manifest-invalidated 的写法：canSubscribeTauriEvents() 守卫 + subscribeTauriEvent<GameCreatorManifestInvalidatedEvent>（App.tsx:1933-1940），refreshManifest 行为不变。 - 冲突区外补齐同一件修复：apps/ai-game-creator-shell/src/features/project-workspace/DesignWorkspacePanel.tsx:264-301 是 master 新增、而 6618207b5 基于共同祖先 46788edbb 写作时还没出现（base 里没有这个文件）的一处订阅，事件同为 design-agent-update、写法同为「订阅后立刻注销」，会同样踩 React.StrictMode 的注销竞态，因此一并改走订阅入口；否则「唯一订阅入口」不成立、该竞态在本次要打包的版本里仍然活着。 - docs/project-memory/shared-memory/pitfalls.md 自动合并成功，6618207b5 与 ff0bc5a3e 两条 2026-09-12 记录都在（无手工取舍）。 - 自证：git grep '^<<<<<<<|^>>>>>>>' 无命中；AGC 内除 services/tauriEventSubscription.ts 自身外，已无 __TAURI__?.event?.listen 直连订阅。 - 验证（本提交时点）：npm --prefix apps/ai-game-creator-shell run typecheck exit 0；npx vitest run apps/ai-game-creator-shell/tests/resourceVersionSwitch.test.tsx 7 passed。全量验证（两侧 typecheck、AGC 全量用例、encoding、git diff --check）在两条修复都并入后统一执行。	2026-09-12 18:01:38 +08:00
suzmii	87fbf92c58	合并 origin/master 到资源工作台 V3 分支：解 4 处冲突并保留两侧行为 ... - WorkspaceLauncher.tsx：保留本分支清单快照 CAS 拒收提示（manifestMergeNotice 提示条、data-manifest-merge-* 观察点、recoverRejectedManifestSnapshot「重新读取清单」）与 activeVersionId/onActiveVersionChange 版本口径，并入 master 的策划/游戏运行态切换（onMakeGame + switchToGameRuntime、suppressInitialGameTurn 抑制首轮、supervisor key 带 agentRuntimeMode、onSwitchToGameRuntime），planningStartMode 统一取 master 的派生值（上下文 startMode 为 planning 且未切到 game 运行时） - ProjectSupervisorView.tsx：props 同时保留本分支 versions/activeVersionId 与 master 的 designView/onDesignApprove/onDesignClarify/onDesignRetry，DesignAgentSurface 审批链路与本分支资源引用输入区并存；directCodex 输入区保留本分支 @ 引用按钮 + 模型选择 + 发送按钮控制条，发送按钮禁用条件并入 master 的 designView 审批待定口径，模型选择沿用 master 的「对话中可切换」口径 - styles.css：本分支追加的资源画布/输入区样式块与 master 追加的 .design-agent-reasoning 样式块都保留，并补上本分支最后一条规则的收尾大括号 - view/project-development/index.tsx：保留本分支的 image-editor 引用（ImageCanvasProjectAssetPickerDialog、ImageCanvasQuickEditPanelView、ImageCanvasSelectedLayerToolbarView、useImageCanvasFloatingOptionDismiss），去掉 master 对已退役 features/asset-canvas 的 import（本分支已由 resource-canvas 取代），保留 master 的 DesignWorkspacePanel 与 planningStartMode 策划工作台分支 - tests/workspaceLauncherManifestMerge.test.tsx：补 master 新引入的 get_design_agent_runtime_mode mock（返回 null，与 master 各套件同口径），拒收提示断言不变 - tests/appSurface/design-agent.suite.ts：审批待定禁用输入的断言改用本分支 Lexical 输入区的禁用口径（容器 data-disabled + editor.setEditable(false)），断言意图不变 - 验证：npm run typecheck 通过；apps/ai-game-creator-shell typecheck 通过；apps/ai-game-creator-shell/tests 96 个测试文件 1380 通过 4 跳过 0 失败；全仓 vitest 297 通过 2 失败（scripts 下两例为 Windows 权限语义导致的既有失败，相关文件与实现均未参与本次合并）；npm run check:encoding 与 git diff --check 通过	2026-09-12 17:31:51 +08:00
suzmii	6618207b5b	修复运行模块切换版本报 listeners[eventId].handlerId：事件订阅改为自建登记 + 幂等注销 ... - 新增 apps/ai-game-creator-shell/src/services/tauriEventSubscription.ts：AGC 唯一的事件订阅入口。真实 WebView 内用 plugin:event|listen + transformCallback 自建登记，注销时先 unregisterCallback(handlerId)（callbacks.delete，幂等、缺条目也不抛）再发 plugin:event|unlisten，并对重复注销去重，注销失败只在 console.warn 显式记录；非原生环境沿用注入的 event.listen（两参调用形状不变），未接桥接时返回空操作。tauri 2.11 的注销脚本会先读注册表条目再摘回调，而条目由注册 eval 异步写入，与 IPC 返回无序，这一层自建登记正好绕开该竞态（上游 tauri-apps/tauri#15799 / #15800，2.12 起脚本自带判空，升级后可删掉 internals 分支）。 - App.tsx：5 处事件订阅（game-creator-direct-turn-update / agent-progress / agent-runtime-update / planning-session-v2-stream / manifest-invalidated）与角色 Agent 流式回复监听改用订阅入口，守卫由 window.__TAURI__?.event?.listen 换成 canSubscribeTauriEvents()。 - features/app-shell/useDeveloperAgentPanel.ts：Agent Runtime 与角色 Agent 流式回复两处订阅改用订阅入口。 - services/errorReportingBridge.ts：error-report-updated 订阅改用订阅入口，不再直接依赖库内 listen。 - components/AppUpdateNotice.tsx：更新下载进度订阅改用订阅入口。 - components/WindowChrome.tsx：窗口尺寸监听不再走 nativeWindow.onResized，改为订阅 tauri://resize（限定当前窗口），避开库内注销竞态。 - 新增 tests/tauriEventFake.ts：与 tauri 2.11.3 等价的 Tauri 事件替身（注册表条目由注册 eval 异步写入、库内注销脚本读缺失条目即抛并留痕、全局桥 event.listen 按库内实现返回会读条目的注销函数）。 - 新增 tests/tauriEventSubscription.test.ts（7 例）：注册 eval 未落地就注销、重复注销只摘一次、注册落地后能投递且注销后不再投递、真实 WebView 不走库内注销脚本、无 internals 时回落注入桥接、无桥接时空操作。 - 新增 tests/runVersionSwitchEventSubscription.test.tsx（2 例）：真实 launcher + 运行模块连续切换两次版本（断言 start_local_game_preview 被调用）、卸载后后端订阅与 JS 回调都不泄漏、切换版本后清单失效事件仍能送达并重读清单。 - docs/project-memory/shared-memory/pitfalls.md：记录该竞态的成因、触发面、处理取舍与变异验证结论。	2026-09-12 17:23:22 +08:00
suzmii	ff0bc5a3e7	资源工作台钉住的标题栏移出画布缩放层：整行文字不再发虚 ... - 钉在视口上的栏目标题栏（栏目名 / 计数徽标 / 资源总览入口）改挂场景根，成为带 scale() 的 .game-resource-book-scene-world 的兄弟节点，不再用 scale(1 / s) 抵消 world；总览态的栏目标题栏仍留在 world 里与缩略卡对齐 - index.tsx 抽出 ResourceBookScene.renderTitlebar(placement.pinned) 一处产出两种宿主，删除只服务抵消变换的 titlebarTransform 与 safeViewport/safeMainViewport 中间量 - resourceBookController 按节点自己的坐标系换算：world 内用 world 缩放，world 外（钉住标题栏）用 1；新增 nodeWorldTransform，readWorld 补 element 输出，nodeWorld 贯穿 cleanRect / FLIP 反向 transform / worldScale - 更新 resourceBookFlipValues 与 readOrigin 的口径注释：translate 单位是宿主自身坐标系，不再假定所有宿主都在 world 里 - appSurface 用例改钉新不变量：钉住的标题栏内联 transform 必须为空、不在 world 内、父节点为场景根，卡片必须仍在 world 内；并说明标题栏宿主不再跨视图同一节点、转场仍由控制器按 key 记录的 First 屏幕矩形驱动 - resourceBookController 用例新增「屏幕坐标系的宿主不被 world 缩放除」，并保留 world 内卡片仍按缩放除的对照 - 技术方案 2026-09-05 段落同步新结构；pitfalls 增记取证（截图墨色峰值 98.6 vs 同色正文 91.7、点阵周期反推 dpr=1）、本机复现尝试与结论、三处变异验证和真机判据	2026-09-12 17:09:42 +08:00
suzmii	2d40f02286	合并资源工作台分支：素材类型可由用户变更与角标显示资源类型并入 ... - 把 v3 顶端 ace31a5f1（快速编辑 @ 引用素材 + @ 面板标签筛选）合入本分支，与本分支 1079f6c91（用户可变更素材类型、角标改显示资源类型）并存 - 冲突零：index.tsx 两侧改动落点不同（快速编辑 promptInputSlot 接线 vs 角标取值点），projectResourceLiveIntegration 与验收文档自动合并 - 验证：npm run typecheck exit 0；resourceClassificationPanel + projectResourceLiveIntegration 共 45 tests 全绿；check:encoding 4409 文件通过；git diff --check 干净	2026-09-12 16:57:28 +08:00
suzmii	1079f6c91b	资源工作台可变更素材类型：面板加类型选择器、卡片角标改显示资源类型 ... - ResourceClassificationPanel.tsx：加素材类型（功能分类）选择器，与标签同一次保存、同一条写入路径；选项 = GAME_CREATION_APP_ASSET_CATEGORIES × resourceReferenceCategoryLabel，不新造第二套中文译名 - ResourceClassificationPanel.tsx：选择器读显示口径（与画布栏目 projectResourceAssetCategory 同源，选中项就是卡片所在栏目）；写回分两路——没碰过类型控件回传 gameCreationAppAssetPersistedCategory 的落盘原值，主动选过才写用户选的值（categoryChoice ?? persisted），保证「只改标签」不漂移分类 - index.tsx：资源卡右上角角标由「文件/媒体类型」改为「资源类型」，取 categoryLabels[resource.category]（栏目与筛选共用的同一份文案），角标恒等于该卡所在栏目；projectResourceTypeLabel 仍服务资源管理面板小字与总览摞分列，不再用于角标 - tests/resourceClassificationPanel.test.tsx：新增「变更素材类型」6 条用例（选择器 6 项与中文口径、选择器显示显示口径自愈值、主动选值写入载荷、只改标签回传落盘原值对照、显式待归类写入 unclassified、连续两次各带当次选择且不关窗），并按新增控件更新既有按钮序与「分类不再由面板编辑」两条断言 - tests/projectResourceLiveIntegration.test.tsx：新增真宿主跟随链用例（角标显示资源类型并与栏目同名、改类型后卡片进目标栏目且角标跟着变、原栏目不再有它），配套状态化宿主 fixture、分类写入与 get_local_game_manifest 两条命令桩、切栏目与读角标助手 - tests/appSurface/project-development.suite.ts：原 data-resource-type 媒体类型断言改为资源类型（角色与对象 / 待归类 / 音频），并说明卡面正文走媒体分支、角标走资源类型这两个独立轴 - docs：PRD §5.3 由「分类没有用户手动设置入口」改为当前两口径分叉（选择器读显示口径、写回按是否主动选过分流）与「显式待归类被读时自愈覆盖」盲区 - docs：AGC 资源工作台 V3 端到端验收 S5 的「前端交互不能改分类」改写为可改分类，补判据（角标读 .game-resource-card-type-badge）与盲区说明；实施计划写入命令一节的面板名与职责同步为「编辑素材标签（标签 + 素材类型）」 - docs：decision-log 新增条目记录本次决策（Rust 无需改动、画布跟随链无需额外迁移代码、待归类盲区、四条变异验证结果与一条不可构造的变异） - 说明：Rust、manifest 字段构成与 SpacetimeDB 均不改；写入命令 update_local_project_resource_classification 早已接受任意合法 category	2026-09-12 16:54:24 +08:00