3603 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
suzmii	928a0ea13e	素材类型选项改成纵向单选列表，不再横排成一条 ... - ResourceTypePanel：选项区从 PlatformSegmentedTabs（3~6 列网格，6 项正好挤成一行）换成纵向单选列表，复用共享的 PlatformNavigableListItem 作行骨架 - ResourceTypePanel：容器改为 role="radiogroup" + aria-label，每项 role="radio" + aria-checked，选中态与读屏读的是同一个属性 - ResourceTypePanel：roving tabindex（只有选中项 tabIndex=0）与方向键在选项间移动焦点，走到头不越界；方向键不顺手选中，Enter/Space 才落盘（选中=一次 CAS 写盘，浏览选项不该连环写盘） - ResourceTypePanel：选中行额外渲染勾选图标作为第二视觉线索，图标 aria-hidden 不污染可读名字 - resourceTypePanel.css：选项容器改成单列网格（grid-template-columns: minmax(0, 1fr) + grid-auto-flow: row + align-content: start），一行一个选项 - resourceTypePanel.css：选项行补 width/min-width/min-height: 44px 与 overflow-wrap，移动端热区与窄屏换行都不依赖共享件的工具类 - resourceTypePanel.css：选中态由 [aria-checked='true'] 驱动并显式提权到 (0,3,0) 以上（含覆盖 :hover:not(:disabled)），避免被共享列表行的悬停底色顶掉 - resourceTypePanel.css：滚动从 body 挪到选项列表（列表现有 max-height: min(320px, 40dvh) + overflow-y: auto），body 改为 auto/minmax(0,1fr)/auto 三段，标题、素材名与错误提示不跟着滚 - 测试：新增「选项区是纵向单列列表」用例，按 styleCascade 解析真实生效声明（360/390/1440 三档宽度都是单列、行满宽、热区 44px），并断言 6 项都是 radiogroup 的直接子元素 - 测试：新增「单选语义与键盘」用例（radiogroup/radio + aria-checked + roving tabindex，方向键只移焦点不落盘，Enter 才写盘） - 测试：新增「选中态由 aria-checked 驱动并压过共享列表行悬停底色」用例 - 测试：把「面板有高度上界且中间行可滚动」改成「选项区有上界并独立滚动，标题与错误提示不滚」 - 测试：集成用例的类型选项查询从 button/aria-pressed 改为 radio/aria-checked	2026-09-14 18:16:56 +08:00
suzmii	ef3e783ab1	Merge remote-tracking branch 'origin/master' into feat/agc-resource-type-entry	2026-09-14 17:07:36 +08:00
suzmii	7ce4a3a9c6	把素材类型从「编辑素材标签」面板拆成独立入口 ... - 新增 ResourceTypePanel（src/view/project-development/ResourceTypePanel.tsx）：类型选一项即落盘，category 传用户选中值、tags 逐字回传落盘原值，保存在飞时沿用 closeOnBackdrop/closeOnEscape = !saving - 新增 resourceAssetDisplayName.ts：两块面板共用同一个素材名副标题口径（localPath basename），不再各写一份 - 新增 resourceTypePanel.css：类型面板的弹窗骨架与信息浮层「分类」行入口样式，按 AGC 内独立文件约定，不动 packages/** 与 styles.css - ResourceClassificationPanel 删掉类型 chip 与 categoryChoice：保存时恒回传 gameCreationAppAssetPersistedCategory(asset)，「只改标签不动分类」由结构保证 - index.tsx 新增 resourceTypeAssetId 与 resourceTypeAsset；工具条在「编辑标签」旁新增「素材类型」按钮（Shapes 图标） - index.tsx 用合并后的 resourceClassificationOverlayOpen 纳入点外部/Esc 浮层遮挡判据，并同步 useEffect 依赖项 - index.tsx 渲染新面板：保存成功后由宿主收起面板并沿用 manifest 重载路径，让卡片立刻落到新栏目 - 信息浮层「分类」行接出第二入口：按钮渲染在 dd 之外，不污染 dt/dd 字段读取口径；非 manifest 资产不给入口 - resourceCanvasInfoModel 导出 RESOURCE_INFO_CATEGORY_FIELD_LABEL，模型与入口共用同一行标识 - 新增 tests/resourceTypePanel.test.tsx：选中即落盘、tags 逐字回传、没碰过不写盘、显式待归类、失败回退、saving 锁、Esc/遮罩、面板骨架共 11 条 - 迁移「没碰过分类就回传落盘原值」对照用例并保留两条（标签面板侧），chip 用例搬到新面板文件 - 集成用例改走新入口：选中即落盘并自动关窗，另补 Esc/点外部不串台、只改标签后 manifest category 逐字不变两条宿主级用例 - appSurface 工具条清单补上「素材类型」	2026-09-14 17:07:15 +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	11beb65c36	修复桌面壳对根门禁 label 字面量的断言 ... run 2095 的 Native shell tests 红了，失败点是 desktop-shell 的 typecheck： apps/desktop-shell/scripts/check-config.mjs 断言根门禁脚本必须包含 `console.log('[check:native-shells] desktop-release-binary-artifact')` 字面量， 而拆分时我把 label 挪进了公共打印函数 runNativeShellGate(group, label, gate)， 源码里不再有这个字面量，断言随即报 「root native shell gate must keep desktop release artifact check」。 - runNativeShellGate 收窄为 (group, gate)：label 改回各门禁执行体里的字面量打印， 分组能力、日志格式与 `--groups=` 语义都不变，外部按字面量做的快照断言继续有效。 - 在该函数旁注明不要把 label 抽成变量：apps/desktop-shell 与 apps/mobile-shell 的 check-config 都会读取根脚本源码做字面量断言。 验证：node --check 通过；contract 分组通过（groups=contract + OK）；mobile-shell check-config exit 0；desktop-shell check-config 已越过第 740-777 行的根脚本断言 （本机只卡在本机不存在的 Tauri 生成产物目录，Linux CI 不受影响）； vitest scripts/project-ci-workflow.test.ts 11 passed；eslint 通过。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 16:26:10 +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
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
lhk229	28e4d6c627	Merge pull request '修复策划产物归类为文档' (#343) from opt/design-docs into master ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/343	2026-09-14 12:27:52 +08:00
lhk229	a7fa8e103a	修复策划产物归类为文档 ... 将策划产物注册 kind 从 design-document 调整为 document 同步更新项目工具测试夹具	2026-09-14 03:57:20 +00:00
lhk229	637bd90073	修复 Windows Git hook 测试链接权限 ... Windows 测试 fixture 使用 junction 创建 node_modules 目录链接 保留 Linux 目录符号链接行为并消除普通权限下的 EPERM	2026-09-13 11:46:45 +00:00
lhk229	6149aaf5f6	修复资源替换弹窗初始化竞态 ... 将弹窗打开态初始化改为 useLayoutEffect，避免素材选择被异步初始化清空 补充资源选择弹窗竞态的排障记录与定向验证命令	2026-09-13 11:44:27 +00:00
lhk229	340d8241a5	优化策划agent (#340) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/340 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-13 19:32:12 +08:00
lhk229	73b4eec8b7	Merge pull request 'AGC 资源画布与替换改造 V3.0' (#316) from feat/agc-canvas-resource-workbench-v3 into master ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/316	2026-09-13 18:53:32 +08: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
suzmii	3bf499ddfd	修复「所有资源」展开态文档卡与图片卡初始自动重叠 ... - resourceBookLayout：新增分带几何缓存键 resourceBookAllLayoutKey 与取几何的 resolveResourceBookAllLayout，键纳入布局是否就绪 / 卡片真实尺寸 / 排序模式，拖动只改坐标时键保持不变 - resourceBookLayout：抽出 ResourceBookAllLayoutInput，生产组件与回归用例共用同一份「键 + 缓存」口径 - index.tsx：展开态分带几何改走 resolveResourceBookAllLayout，并传入当前布局 hook 的 ready；此前只按项目 / 排序 / 可见资源 id 冻结，依赖模式关系图就绪前算出的单行带（144 高）被永久固化，图片带仍挤在 144 + 48 处，整排压住文档卡 - tests/resourceBookLayout.test.ts：新增混合类型（12 文档 + 12 图片）第一版坐标到位后分带重算、逐对矩形不相交的主用例 - tests/resourceBookLayout.test.ts：新增同一栏混排不同尺寸卡（类型 / 依赖两种模式）不相交、sidecar 手放坐标保留并让开下一带的对照用例 - tests/resourceBookLayout.test.ts：新增缓存键的拖动稳定性、就绪翻转、卡片尺寸与排序模式变化用例 - tests/projectResourceLiveIntegration.test.tsx：新增真宿主用例，依赖模式下打开「所有资源」，读渲染出的卡片世界矩形做逐对相交检查	2026-09-13 17:06:09 +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
suzmii	aa0fcc1d71	合并 master：修复 CI comparison base 门禁 ... - 合入 origin/master（b12a81e9c「修复 AGC 自主运行时测试目录权限与任务目录加固」），使 PR 头包含当前 master tip，门禁 Resolve comparison base 不再拦 - 冲突零：自动合并成功 - 验证：npm run typecheck exit 0；npm run check:rustfmt exit 0	2026-09-12 20:55:15 +08:00
suzmii	6f212a3f2c	合并资源工作台分支：PR review 前端批次并入（含滚轮归属与重命名 CAS） ... - 把远端最新 5ab33a8db 合入本分支（PR #316 review 前端三笔：d04fe83f1、d1581892d、a9a5fba92，41 文件） - 冲突零；同时保留两侧对滚轮的处理：本批把 ResourceBookScene 的重复 onWheel 改成 manager 原生监听（body portal 收不到），远端那笔的浮层守卫仍在 handleResourceBookWheel 内兜住留在 DOM 里带滚动区的浮层，互补不冲突 - 含追加契约：confirmResourceRename 补 expectedProjectId/expectedProjectRevision（与删除/分类同一套 CAS 口径）+ 共享错误码映射 projectAssetCommandErrorMessage - 验证：npm run typecheck exit 0；resourceRename / resourceCanvasFloatingDismiss / projectResourceLiveIntegration / resourceReferenceInput 四文件全绿	2026-09-12 20:52:38 +08:00
suzmii	a9a5fba92b	修复 PR #316 review（前端 TS/TSX）：图片编辑器素材弹窗 ... - ImageCanvasProjectAssetPickerDialog.tsx：打开时的重置 effect 只依赖 `open`，父级每次渲染重建 `selectedAssetIds` 不再清空进行中的搜索 / 筛选 / 选择 - ImageCanvasProjectAssetPickerDialog.tsx：素材卡媒体渲染抽成 `AssetCardMedia`，顺带去掉该处嵌套三元 - projectAssetReferencePickerModel.ts：`image-sequence` 单列一类（新增「序列帧」页签），不再混进「图片」——参考图链路只接受 `mediaType === 'image'`，混进去就是「按图片选中、按图片文案拒掉」；缩略图口径由 `projectAssetPickerUsesThumbnail` 收口 - 用例：父级重渲染不清空在选状态；序列帧分类归属与其被参考图链路过滤掉的事实	2026-09-12 20:49:37 +08:00
suzmii	d1581892d7	修复 PR #316 review（前端 TS/TSX）：资源工作台与资源画布 ... - 素材重命名（跨范围契约）：`rename_local_project_asset` 现在要求 `expectedProjectId` + `expectedProjectRevision`，前端按删除 / 分类保存同一套 CAS 口径补齐——先 `get_local_game_project_revision` 读当前 revision 再连同项目身份提交，不用可能过期的本地缓存值 - 失败文案统一：新增 `projectAssetCommandErrorMessage`，把 `project-identity-conflict` / `project-revision-conflict` 翻成用户可读中文，重命名 / 删除 / 分类保存三条链路共用一份映射，其余错误原样透出 - index.tsx：资源面板下载按 `resolveDownloadablePanelEntries` 过滤，版本卡这类合成 path 的条目不再进入落盘链路 - index.tsx：`characterAnimationPanel` 纳入画布浮层开关判据（抽 `resolveResourceCanvasFloatingPanelOpen`），「生成动画」面板与快速编辑 / 信息浮层共用同一条「点外部 / Esc 关闭」规则 - index.tsx：去掉 `ResourceBookScene` 上重复的 `onWheel`，滚轮只由 manager 上的原生 `passive:false` 监听处理，平移 / 缩放不再被翻倍 - index.tsx：快速编辑的源资源在层 id 命中不到时回落到已正规化的 `asset:<id>`，重试不再静默什么都不做；取不到时给出可见失败 - ResourceCanvasPanelView.tsx：下载按钮按可下载条数判可用、不再在上传中显示下载转圈；上传中禁掉 × / Esc / 遮罩三条关闭路径；预览占位文案抽 helper - GameRunVersionPicker.tsx：portal 菜单在滚动 / 缩放后重算位置；外部点击判定沿用共享 `useImageCanvasFloatingOptionDismiss` + `menuRef` 边界（review 该条已修，保留现状并补位置用例） - ResourceCanvasGenerationPanelView.tsx：`submitting` 改 `finally` 收回，成功路径不再永久锁住面板 - ResourceAssetDeleteDialog.tsx / ResourceRenameDialog.tsx / ResourceClassificationPanel.tsx：在飞时 `closeOnEscape` / `closeOnBackdrop` 与头部 × 一起挡住 - resourceEditModel.ts / resourceCanvasToolbarModel.ts / useProjectResourceCardPreviews.ts / projectResourceLiveUpdateModel.ts：抽 `resourceBaseName`、`canonicalProjectedResourceMediaType` 参数收窄去掉强转、删未使用参数、补「IO 失败会 reject」的签名说明 - resourceCanvasHistoryModel.ts：`resourceCanvasSnapshotsEqual` 不再比较不可恢复的 `manuallyPlaced`，消除「压进历史但撤销是空操作」 - resourceCanvasSectionMapping.ts：删掉从未接线、且注释与实现相矛盾的 `LEGACY_RESOURCE_CANVAS_SECTION_FALLBACK` - resourceCanvasChrome.css：`.game-resource-panel-grid` 补 `flex: 1 1 auto; min-height: 0`，卡片网格成为真正的滚动区 - 用例：重命名 CAS 载荷与读序、CAS 拒绝文案、版本卡下载门禁、上传中关闭路径、浮层判据、菜单跟随滚动、分区映射	2026-09-12 20:49:03 +08:00
suzmii	d04fe83f10	修复 PR #316 review（前端 TS/TSX）：@ 引用与提示词润色主链路 ... - App.tsx：`conversation.write` 策略确认后的重跑改为整体复用首轮入参（`directCodexPolicyRetryInput`），不再手写字段，修掉漏传 `references` 导致 @ 引用被静默丢弃的缺陷 - resourceReferences.ts：运行画面引用的判别指纹补上 `resourceIds`（排序集合口径）/`versionId`/`elementRole`/`width`/`height`，避免不同选点撞 key 被 `dedupeChatReferences` 去重丢掉 - ResourceReferenceInput.tsx：程序化重建编辑器内容改为把 chip 内联嵌在文本里的同名 token 位置（不再另起一段堆在末尾），并把 `lastEmittedDraftRef` 记为「编辑器实际读回来的草稿」而不是 props，消除每轮多一段 `@显示名` 的渲染循环 - ResourceReferenceInput.tsx：候选浮层（候选菜单 / 素材选择器）打开时 Enter 不再提交表单，把按键让给 `LexicalTypeaheadMenuPlugin` - ResourceReferenceInput.tsx：`assets` / `currentVersionAssetReferences` 的 memo 依赖改用内容签名；预览请求在换素材 / 卸载时主动作废上一个 scope；空态文案的嵌套三元抽成 `pickerEmptyMessage` - usePromptPolish.ts：`polish()` 补 `catch`，注入式 `requestPolish` 拒绝时给出可见失败提示而不是未处理拒绝；`reset()` 递增请求代次作废在飞请求 - ChatPromptPolishReminder.tsx：章节级 Esc 分支补 `busy` 判据，与关闭按钮 / 遮罩同一口径（在飞不许关面板） - LocalGamePreviewFrame.tsx：资源 id 改用专用净化（允许 `:` 与可打印非 ASCII），修掉 `local-asset:<id>`、`persisted-角色草图.png` 被整条过滤导致引用丢素材关联 - sessionPreview.ts：`get_local_game_preview_status` 读失败不再当作「确认没有在跑」去发停止命令，避免停掉真在跑的活体预览 - useHomeProjectCreation.ts：进项目流程加代次令牌，慢请求后到不再覆盖新项目 - WorkspaceLauncher.tsx：拒收恢复的阶段回写按 `projectId`/`heldRevision`/`snapshotRevision` 关联，不再把恢复结果盖到后续新拒收的提示上 - 用例：`directCodexPolicyRetryInput` 透传、引用指纹区分度、重建不循环、浮层打开时 Enter 不提交、润色拒绝 / reset 作废、预览读失败不停预览	2026-09-12 20:48:13 +08:00
kdletters	b12a81e9c2	修复 AGC 自主运行时测试目录权限与任务目录加固 ... 恢复 relaxed autonomous lane 的美术工具与写入门禁旁路 统一 Runtime 任务与事件目录的安全创建和校验 测试临时目录在 Windows 下初始化当前用户 owner	2026-09-12 20:31:43 +08:00
suzmii	5ab33a8db3	合并资源工作台分支：PR review 的 Rust 批次并入共享契约与滚轮修复 ... - 把远端最新 1cc258d2a 合入本分支（PR #316 review 的 Rust 三笔：3a9e45c80、daef9f6cc、64b0d2f76） - 覆盖：素材导出补敏感文件/控制面拒绝与自我覆盖保护、删除幂等、重命名 CAS、manifest 缓存 TOCTOU、标签上限、注入资源 ID 上限与去重、锁诊断与提权口径 - 冲突零：自动合并成功 - 注意：rename_local_project_asset 现要求 expectedProjectId/expectedProjectRevision，前端调用点由前端批次同批补齐	2026-09-12 20:24:01 +08:00
suzmii	64b0d2f766	收敛外部错误体、注入提示词与锁诊断的不设界行为 ... 收敛外部错误体、注入提示词与锁诊断的不设界行为（PR #316 review） - resource_editor.rs:2476 [bug · medium] 已被修复：`error_details` 改为 `error.details` 优先、顶层 `details` 兜底，与 docstring 声明的取值顺序一致；新增「两种形状同时出现」用例钉住优先级。 - resource_editor.rs:2468 [performance · low] 已被修复：4xx 错误体改走 `bytes_stream` 有界读取（64KiB 上限，超限即放弃取原因），不再用 `response.text()` 无上限缓冲外部正文。 - resource_editor.rs:2514-2525 [maintainability · low] 已被修复：provider / assetKind / mediaType / code 四个追加字段各自按 80 字符截断（`MAX_EDITOR_ERROR_DETAIL_CHARS`），最终文案长度不再随外部正文增长；新增超长字段整串比对用例。 - direct_codex_references.rs:175-182 [performance · medium] 已被修复：`resourceIds` 超过 32 条直接按模块失败关闭口径拒绝，并在同一 id 的重复项上做去重，注入提示词的「关联素材 ID」行长度与 manifest 扫描次数都有界；新增去重 + 超限用例。 - direct_runtime.rs:1795-1797 [maintainability · low] 已被修复：`direct_project_history_contention_failure` 收窄为只认追加锁超时标记（项目写锁争用已在更早的专用分支判掉，是死代码），恢复提示文案相应去掉「或项目锁」；新增用例钉住两条判据互不重叠、各自命中正确提示。 - conversation.rs:984-989 [maintainability · medium] 已被修复：`DIRECT_PROJECT_HISTORY_RECORD_TYPE` 提升为 `pub(crate)`，读取侧 `is_direct_project_history_row` 引用同一常量，`project.jsonl` 的信封契约改为编译期共享。 - agent_db.rs:3570-3574 [other · medium] 已被修复：`lock_with_attempts` 的进程内锁改为有界 `try_lock` 轮询（窗口与调用方一致，2000/200 次 × 5ms），同进程读路径不再被写者的 10s 跨进程等待拖住；顺序仍是「进程内锁 → 跨进程锁」，无 ABBA；新增用例验证短窗口 <5s 失败且释放后立即可重取。 - agent_db.rs:3668-3669 [maintainability · low] 已被修复：新增与锁同级的旁路诊断文件（普通共享写入），诊断优先读它、读不到再退回锁文件，Windows 上 zero-share 独占锁文件时也能报出持锁方；新增「取锁写出旁路文件」「锁文件不可读时退到旁路」两条用例。仅存 pid/用途/时间戳，不参与判活、回收或抢占。 - agent_db.rs:3827-3828 [maintainability · low] 已被修复：仅当修复错误真的符合提权口径（`windows_acl_error_may_need_elevation`）时才追加「自动提权修复未完成」，否则原样透传底层错误，不再重复报同一个错误并谎称尝试过提权。 - main.rs:29-31 [maintainability · low] 判定为不适用/不改：实测删掉那四个 import 会产生 18 处 E0425（`direct_tool_bridge` / `canvas_generation` / `assets` / `manifest` / `resource_editor` / `resource_dependency_graph` / `recovery_tests` 等经 `use super::*` 从 crate 根复用它们），而保留它们并不产生 `unused_imports` 警告（cargo check --all-targets 无一条指向这几行）；已按原样恢复 main.rs，工作树中该文件无改动。	2026-09-12 20:20:39 +08:00
suzmii	daef9f6cc9	修复素材删除幂等、重命名 CAS 与 manifest 预览缓存一致性 ... 修复素材删除幂等、重命名 CAS 与 manifest 预览缓存一致性（PR #316 review） - assets.rs:2048-2049 [bug · medium] 已被修复：删除登记在「身份 + revision 两项 CAS 都已通过」后遇到素材已不在 manifest 时按 no-op 成功收敛并照常推进 revision，不再报「项目资源不存在」；新增 `asset_delete_retry_converges_when_only_the_revision_advance_failed` 复现「manifest 已提交、revision 未推进」并验证重试收敛（原「不存在的素材必须报错」断言相应改为幂等语义，前端只消费 assetId/committedProjectRevision）。 - assets.rs:2035-2042 [performance · low] 已被修复：引用集合只算一次并用 `HashSet<String>` 做成员判定，`retain` 不再是 O(V²)；版本守卫闭包按约定在写入前另行求值、拿不到该可变借用，故两次扫描保留并已在注释里说明。 - commands.rs:1032 [maintainability · medium] 已被修复：`RenameLocalProjectAssetInput` 补 `expectedProjectId` / `expectedProjectRevision`，`rename_local_project_asset_at` 与删除/分类更新同口径做两段身份复核 + revision CAS，失败时磁盘、manifest、revision 全不动；新增 CAS 用例（陈旧 revision / 跨项目身份 / 空身份）。注意：前端 `confirmResourceRename` 必须同时补传这两个字段（TS 侧由前端 owner 落地）。 - asset_rename.rs:84 [bug · low] 已被修复：新增 `asset_frame_directory_matches`，目录段在 Windows/macOS 按大小写不敏感比较（Linux 保持敏感），与文件名比较同口径；新增 `Assets/hero.png` 帧对齐用例。 - asset_rename.rs:249-250 [bug · medium] 已被修复：revision 推进失败改为报 `reconciliation-required: 素材已改名…且 manifest 已落盘，但项目 revision 未能推进`，明确这是「已提交但对账未完成」而非普通失败；同时新增的 CAS 使后续命令必须按新 revision 重试，重试会命中同名 no-op 分支收敛。 - tests/asset_rename.rs:257-263 [maintainability · medium] 已被修复：删除 `RenameLocalProjectAssetFaultStage` 枚举与生产签名上的 `fault` 参数，故障注入改用 `#[cfg(test)]` 的 `.agent/runtime/test-fail-next-asset-rename-manifest-write` 标记文件（与 agent_db 既有约定一致），生产 API 面不再能被推上「只回滚、不写 manifest」的路径。 - manifest.rs:1386 [bug · medium] 已被修复：预览缓存失效点下沉到唯一的装盘公共体 `write_manifest_locked_with_version_guard`（install 成功后立即失效，含安装后回读不一致的失败路径），`mutate_manifest_at_allowing_version_removals` 与绑定改写通道一并覆盖；`write_manifest_with_lock_hook` 里的重复调用已移除。 - manifest.rs:1480-1482 [bug · medium] 已被修复：填充侧改为「先取身份快照 → 读取 → 复核快照一致才入缓存」，不再可能出现「旧内容 + 新文件身份」的缓存条目。 - manifest.rs:1135 [security · low] 已被修复：新增 `normalize_manifest_asset_tags`，在共享归一化之后按数量（16）与单标签长度（32 字符）失败关闭；超长标签不截断，避免与共享标签库静默分叉。 - manifest.rs:1180-1181 [bug · medium] 已被修复：审计改为幂等——前后分类与标签完全相同时不追加记录，重试不会再写出 `previousCategory == category` 的假变更审计（保留「manifest 落盘后、推进 revision 前追加」这一既有位置约定）。 - manifest.rs:1140 [maintainability · low] 已被修复：分类写入的项目写锁标签由 `asset.register` 改为 `asset.classification.update`，争用诊断不再误报成素材登记。 - 测试：新增 preview_cache_tests（命中/TOCTOU 不入缓存/身份漂移丢弃/主写入通道显式失效）、分类重复写入不留假审计、标签上下界拒绝；7 条变异验证全部 CAUGHT。	2026-09-12 20:20:12 +08:00
suzmii	3a9e45c805	修复素材导出缺少敏感文件拒绝与自我覆盖保护 ... 修复素材导出缺少敏感文件拒绝与自我覆盖保护（PR #316 review） - asset_export.rs:27-30 [security · high] 已被修复：`resolve_export_source_file` 现在与通用读取路径同一口径，normalize 后先 `reject_agent_runtime_private_control_path` 再 `reject_sensitive_project_file_read`，`.env` / 本地凭据配置与 `.agent/runtime|checkpoints|workbench` 控制面都不能被复制到项目外。 - asset_export.rs:31-33 [security · medium] 已被修复：源路径改用 `resolve_local_project_path` 逐段复核符号链接与 Windows reparse point，`assets` 本身是链接/junction 时不再把项目外文件当成素材导出。 - asset_export.rs:76-78 [bug · high] 已被修复：新增 `reject_export_destination_matching_source`，在创建写句柄之前按「路径等价（大小写不敏感平台忽略大小写）」+「文件身份（含硬链接，退化身份不参与判定）」拒绝保存目标与源素材同一份文件；否则 `File::create` 先截断源文件、复制读到 0 字节还会报成功。 - asset_export.rs:93-95 [other · low] 已被修复：复制改为同目录临时文件 + `sync_all` + `rename` 原子替换，失败时清理临时文件；不再先截断既有目标、也不再留下半截文件。 - 文档：命令 docstring 不再声称「只导出 manifest 已登记素材」——DirectProject 导入的附件同样要能另存，而它们不是 manifest 资产，所以这里明确写成与通用读取同一套路径门禁。 - 测试：新增 5 条用例覆盖敏感/控制面源拒绝、中间目录符号链接逃逸、目标即源文件、硬链接目标、原子替换不留临时文件；7 条变异验证全部 CAUGHT。	2026-09-12 20:19:57 +08:00
suzmii	1cc258d2a4	合并资源工作台分支：PR review 共享契约与样式批次并入滚轮修复 ... - 把远端最新 fc6743980（浮层滚轮归属修复）合入本分支（PR #316 review 的 shared/server-rs/CSS/scripts 三笔：9835bbec9、8b8597782、3b385ef57） - 冲突零：自动合并成功 - 验证：npm run typecheck exit 0；shared 契约/标签/筛选条与 lint-staged 用例全绿	2026-09-12 19:54:16 +08:00
suzmii	3b385ef575	修复 PR316 review：pre-commit Rust 格式检查按暂存文件筛 workspace ... - scripts/lint-staged-rustfmt.mjs:12 [maintainability medium] 改为读取 lint-staged 追加的暂存 .rs 路径，只对真正命中暂存文件的 workspace 跑 cargo fmt --all -- --check：此前永远全量跑两个 workspace，只暂存 server-rs 干净文件的提交会被别人未暂存的 src-tauri 改动挡下来；没收到暂存列表（手工执行）时回退全量检查并在 stderr 说明，避免假装检查过。 - scripts/lint-staged-rustfmt.mjs:7 [maintainability low] apps/desktop-shell/src-tauri 显式记为「有意排除」而不是静默通过：实测该 workspace 当前整体不过 cargo fmt --check（host_bridge/mod.rs 等），直接纳入会让任何 Rust 提交都失败；命中该前缀的暂存文件会打印跳过提示，纳入步骤写在模块注释里（同时要补 package.json 的 check:rustfmt / format:rust，package.json 不在本批次改动范围）。 - 新增 scripts/lint-staged-rustfmt-workspaces.mjs：把「暂存路径 → 待检查 workspace」的纯映射逻辑独立出来，附 Windows 反斜杠/绝对路径归一化。 - 新增 scripts/lint-staged-rustfmt.test.ts（vitest，随 npm test 运行）：覆盖只暂存单侧 workspace 的回归判据、手工执行回退全量、排除项与未登记路径必须被点名、路径归一化，以及与 package.json check:rustfmt 的 workspace 表同集交叉校验。	2026-09-12 19:44:18 +08:00
suzmii	8b85977828	修复 PR316 review：共享分段页签宽度下限作用域、标签契约与资源画布样式 ... - packages/shared/src/components/styles.css:528 [bug medium] min-width: max-content 收窄到新的 .platform-segmented-tabs--scroll 修饰类：grid 分支没有溢出容器、轨道是 minmax(0,1fr)，同样的下限只会让内容画到相邻格上；grid 侧靠轨道等分与宿主 truncateLabels 收口，选中 PlatformSegmentedTabs.tsx 的 scroll 分支补修修饰类。 - packages/shared/src/components/PlatformResourceFilterBar.test.tsx 同步改成钉「下限只挂在 --scroll」+「grid 分支不带 --scroll/overflow-x-auto」（声明级断言，jsdom 不计算外部样式表，属弱验证，真机判据见提交说明）。 - packages/shared/src/components/PlatformResourceFilterBar.tsx:24 [maintainability low] Props 改为以 tagItems 为判别项的联合类型：给 tagItems 就必须给 onToggleTag，非法状态编译期不可表达；组件内部再兜 disabled={!onToggleTag} 供给不带类型检查的调用方，并补对应运行时用例。 - packages/shared/src/components/PlatformResourceFilterBar.tsx:107 [style low] 标签行补 scrollbar-hide：它是唯一还画滚动条的横向滚动容器，与 styles.css 里 .scrollbar-hide 的注释口径对齐；补类名与声明级用例。 - packages/shared/src/contracts/gameCreationAppAssetTagLibrary.ts:51 [maintainability low] assetIds 排序改为确定性 code-unit sort()，不再依赖运行环境默认 locale（标签那一层仍显式钉 zh-CN），补跨输入顺序可复现的用例。 - packages/shared/src/contracts/gameCreationAppAssetTagLibrary.ts:68 [bug low] assetTagsMatchSelection 两侧对称归一化：selectedTags 也过 normalizeGameCreationAppAssetTags，' 像素风 ' 这类未归一化的选中项不再静默匹配不上。 - packages/shared/src/contracts/gameCreationApp.test.ts [test low] 新增解析 Rust PROJECT_RESOURCE_CANVAS_SECTIONS 与 TS 常量对齐的交叉校验（仿 assetKindCanonicalMapping.test.ts 解析 Rust 常量先例），钉住两侧分区顺序不漂移。 - packages/shared/src/contracts/gameCreationApp.ts 同步「读显示 / 写回」口径注释：未知 category 已在 Rust 读侧失败关闭，「非法值 → 派生」只剩内存对象语义。 - apps/ai-game-creator-shell/src/styles.css:5790 [bug medium] :has() 悬停高亮分类值换成现行 7 个分区（ui-interaction/character/scene/audio/document/unclassified/version），删掉永不渲染的 code/art 死选择器，补齐缺失栏目的高亮。 - apps/ai-game-creator-shell/src/styles.css:6873 [bug medium] hover/focus-within/is-selected 由只写 border-color 改为完整 border: 1px solid #d57b51（基规则 border: 0 下 border-color 无效果，选中/焦点态此前完全不可见），box-sizing: border-box 下不改卡片尺寸。 - apps/ai-game-creator-shell/src/styles.css:10151 [bug medium] 去掉高优先级 :focus-within 规则里的 box-shadow: none：它盖掉了 --platform-input-focus-ring 焦点光环，direct-codex 输入区此前没有任何可见焦点（无障碍回归），现在光环生效。 - apps/ai-game-creator-shell/src/styles.css:10198 [bug low] 润色状态文字与操作排改为同一行分列（grid-row: 2 + grid-column: 1 / 2），不再整行独占或与按钮重叠，状态出现/消失不改变输入框高度。 - apps/ai-game-creator-shell/src/styles.css:10206 [maintainability low] 删除永不命中的 .resource-reference-input-at direct-codex 规则（showTriggerButton={!directCodex} 不渲染该按钮），保留说明指向真正的 .project-supervisor-reference-trigger。 - 附带 prettier 对 .design-agent-reasoning summary 单行规则的换行归一（该文件本来未过 prettier --check）。	2026-09-12 19:43:58 +08:00
suzmii	9835bbec9f	修复 PR316 review：shared-contracts 资产级失败关闭 + 快速编辑别名白名单 ... - server-rs/crates/shared-contracts/src/game_creation_app.rs:517 [bug high] 资产级 wire 结构补 deny_unknown_fields：与顶层 GameCreationAppManifest 同一取向，避免「读一次 + 任意一次写」静默抹掉未来新增的 assets[i] 字段；新增契约测试 asset_manifest_entry_rejects_unknown_asset_fields（裸条目 + 顶层 manifest 两条读路径都失败关闭，且已知字段照旧往返）。 - server-rs/crates/shared-contracts/src/game_creation_app.rs:536 [bug medium] 未知 category 从「退回 kind 派生值」改为失败关闭：反序列化结果就是落盘原值、要被整结构体写回，静默替换等于无迁移改落盘数据；缺字段仍按 kind 派生，派生只保留在 game_creation_app_asset_effective_category；原用例改名重写为 asset_manifest_entry_keeps_explicit_category_and_rejects_unknown_category。 - server-rs/crates/shared-contracts/src/game_creation_app.rs:780 [test low] 分区顺序跨语言交叉校验：packages/shared 侧新增解析 Rust PROJECT_RESOURCE_CANVAS_SECTIONS 并与 TS 常量对齐的测试（TS 侧补，见后续提交）。 - server-rs/crates/api-server/src/editor_project.rs:4120 [bug medium] 静态图别名白名单补 "asset"（register_local_asset_entry 空 kind 兜底值，canonical 映射到 image），数组长度 17→18，并在用例里补放行/拒绝两条断言。 - server-rs/crates/api-server/src/editor_project.rs:20747 [test low] AGC 快速编辑回归用例不再自洽：agc_payload 真正反序列化成 EditorImageEditRequest 并由请求体自己的 generationInputs.assetKind 驱动判据，另加源码级闸门断言（resolve_editor_image_edit_source / ensure_editor_image_edit_target_matches_source 体内不得再出现 generation_inputs）。 - TS 侧 gameCreationApp 的口径注释同步为「非法值这一支已不可达」（见后续提交）。	2026-09-12 19:43:19 +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	bb91e8909d	修复选中资源工具条出现两条相邻分隔线 ... - 成因：共享工具条在 showQuickEdit 分支于「快速编辑」后输出一条分隔线，同时为 extraActions 自动生成前置分隔线（extraActionDivider）；AGC 资源卡是「快速编辑可用 + 中间动作未接通不渲染」的组合，两条因此相邻 - 修法：样式层去重（相邻的两条只显示一条），不改 JSX 结构，对美术画布与资源画布两端都成立，也不会隐藏任何真正起分隔作用的那一条 - 新增契约用例 selectedLayerToolbarDividerDedupe.test.ts 钉住去重规则与它的成因两端 - 验证：该用例 3 passed；变异验证（删掉去重规则）→ 1 failed，还原后 3 passed	2026-09-12 18:23:02 +08:00