2468 Commits

Author	SHA1	Message	Date
suzmii	669c71d7e8	补记三条踩坑：rustfmt 作用域、build-gate 代理假红、worktree 与 MSYS bash 不兼容 ... - 新增「裸 rustfmt 会把一个文件放大成整个模块树」：现象是本想改 1 个文件实际改了 src/agent/ 下 50 个；原因是裸 rustfmt 把传入文件当模块根并跟随 mod 递归；处理口径是改格式前先 git diff --stat 确认范围、先备份，精确到文件用 cargo fmt -p <pkg> -- <文件...>，并行工作树里禁止盲跑 cargo fmt --all，误伤后用 git apply -R 反向补丁还原而不是 git checkout -- - 新增「build-gate 的警告门被代理环境变量误伤」：NODE_USE_ENV_PROXY=1 / HTTP_PROXY 会让 Node 打印 UNDICI EnvHttpProxyAgent experimental 警告，而 build-gate.mjs 只忽略含 ExperimentalWarning 字样的行，于是构建成功却判红；判据是同一 commit 清空这些变量后 npm run build 即 exit 0；CI 无这些变量不会触发，若要让本地带代理也能跑需在忽略规则补 EnvHttpProxyAgent / UNDICI-EHPA（属改门禁规则，本次未改） - 新增「worktree 里 MSYS bash 跑 git 脚本会失效」：check-repository-ci.sh 这类脚本在 worktree 里第一步就报比较基线不可用，根因是 bash 用 MSYS 的 /usr/bin/git、而 worktree 的 .git 存 Windows 绝对路径，解析成 /mnt/c/.../C:/Users/...；口径是按脚本同序同命令用 Windows git 逐条等价执行 - 只追加，未重排既有条目	2026-09-11 12:28:58 +08:00
suzmii	66bb240115	进项目时按内存 registry 核对预览活体，陈旧记录不再冒充可运行预览 ... - 新增 features/app-shell/sessionPreview.ts 的 resolveSessionPreviewOnProjectOpen：进入项目时问一次 get_local_game_preview_status（内存 registry 是活体的唯一真相），确实 running 才把它作为本次会话的预览；记录写着 running 而 registry 没有活体时判为陈旧，复用现役 stop_local_game_preview 把落盘记录对齐成 stopped，并同时把会话 manifest 按真相投影成 stopped（否则运行入口会继续拿着打不开的 URL 渲染运行画面）。 - useHomeProjectCreation.ts：enterProjectDevelopment 改为 async，先做这次核对再进工作台，并按核对结果决定会话预览与 manifest 投影；三个调用点（新建项目、创建项目、打开项目）都改为 await。 - preview.rs：同一个项目重启预览时，旧 registry 身份的收尾不再覆盖刚落盘的 running——只有当旧预览属于**另一个项目**时才替它收尾。此前同项目重启会把刚写进去的 running 覆盖成 stopped，下次进项目便丢掉"预览在跑"这条事实（记录反方向失真）。 - preview.rs：stop_local_game_preview_for_root 在没有活体可停、但落盘记录仍是 running 时也把记录收尾成 stopped（stop 的语义变成"真的停干净，包括记录"），因此陈旧记录既可由进入项目触发对齐，也可由用户显式停止对齐。 - tests/project.rs：新增三条 Rust 定向用例——同项目重启后记录仍为 running 且端口是新预览的；换项目启动时旧项目记录写 stopped、新项目写 running；registry 无活体而记录写着 running 时 stop 会把记录对齐成 stopped。 - tests/sessionPreview.test.ts（新增）：五条用例覆盖活体优先、陈旧记录对齐并投影、registry 不可读按没有在跑处理、记录本来不是 running 时不发多余停止命令、无 invoke 时零请求。变异验证：把活体核对去掉（直接信落盘记录）→「registry 里没有活体时不给会话预览」与「registry 不可读」两条立即红灯（已实测）。 - project-development.suite.ts：把「打开项目不查预览状态」那条断言改为「恰好核对一次预览活体」，并保留邻近的 start_local_game_preview 必须为 0 的断言——被新行为取代的是"从不核验"，"开项目不偷偷启动预览"这条原意一字未改。 - PRD §4.1：状态机按当前实现改写（进入项目一律落到 resource-overview；run 的自动进入只认内存 registry 的活体确认；落盘 preview 是记录而非活体，陈旧记录不触发切换也不参与渲染），并把退出收尾一并写进该节说明。	2026-09-11 12:27:31 +08:00
suzmii	95c5418c0f	合并 master（#318 写锁等待与可诊断）入 V3 分支 ... - 三个文档冲突按两边都保留解决：decision-log.md、pitfalls.md、实施计划技术方案；两边追加的是不同主题（资源画布/预览/聊天区 vs 写锁），语义无冲突 - Rust 侧 direct_runtime.rs、direct_tool_bridge.rs、project_gates.rs、project.rs 自动合并成功，无手工介入 - 冲突处仅移除 Git 标记行，未删改任何一方内容（每个文件恰好减少 3 行）	2026-09-11 11:33:12 +08:00
suzmii	364492de37	Revert "文档同步：资源管理页改为栏目分页纵向滚动网格" ... This reverts commit c2b851cc36.	2026-09-11 11:07:59 +08:00
suzmii	c2b851cc36	文档同步：资源管理页改为栏目分页纵向滚动网格 ... - PRD §3.3：栏目页改为纵向滚动网格，顺序由 sidecar 记录的 (y, x, resourceId) 读序推出，新增列数控件与栏目内拖拽排序条文 - PRD §3.3.1：三阶段改写为当前形态（本体卡保留；阶段二改为栏目分页网格；阶段三改为未排序栏目的初始顺序派生） - PRD §3.3.2：可见性预取口径改为以栏目滚动容器为交叉根 - PRD §5.2：实现状态与字段语义改为「x / y 只承载栏目内顺序」，新增顺序阶梯、已排序栏目新资源追加末尾、列数偏好与关系说明条文 - PRD §5.2.4：删除 viewport、wheel、拖动改写坐标等画布条文，改为网格、列数与拖拽排序 - PRD §5.2.5：手动拖动合同改为拖拽排序合同 - PRD §5.2.6：删除资源依赖关系图层整节 - PRD §7.2：验收改为顺序持久化；§7.3 依赖关系图验收整节删除；§7.5 重写为栏目分页纵向网格验收，新增「纵向滚动无横向溢出」与「列数被记住」两条判据 - PRD §6/§8：分阶段范围与非目标同步 - 技术方案：原《GameAgent资源自由画板与快速编辑》改名为《AGC资源管理页纵向网格与排序》，重写为当前形态（页面形态、栏目内顺序、列数偏好、拖拽排序、关系说明），保留权威数据、焦点竞态与派生编辑条文 - 实施计划：资源卡与资源管理页边界改为栏目网格、顺序落盘、列数偏好与滚动容器可见性 - decision-log：新增 2026-09-11 决策（含用户明确判断优于 PRD 的事实依据，以及有意推翻 1da7dc62a） - pitfalls：整体改写「AGC 资源管理页真正自制的交互面」条目 - docs/README.md 与 document-map.md：更新改名后的专题文档入口	2026-09-11 11:00:31 +08:00
suzmii	dcb750c318	补记跨层字段名静默忽略的排障口径，并把逐栏目用例提为首选证据 ... - `pitfalls.md` 新增「manifest 资产分类字段写错名会被静默忽略，跨层字段名相近时尤其危险」：manifest 上的字段名是 `category`，而 `assetCategory` 是前端投影后 `ProjectResource` 的字段名，写错层不报错也不告警，本文档记录现象、原因、处理与通用规则（「设置无效但没有任何报错」时第一优先怀疑字段名或层级错配）。 - 同文件「预览 Hook 的资源入参收窄会连带收窄 identity map」那条的验证行改为以新用例 `mounts a real card body in every non-empty resource section overview` 为首选证据：它逐栏目覆盖五个非空栏目并含变异验证；既有 `uses one full-page canvas per resource section with dependency-only guide lines` 降为补充（只覆盖一两个栏目）。 - 只追加与就地更正该条验证行，未重排任何既有条目。	2026-09-11 02:00:38 +08:00
suzmii	84b8f5130b	修复资源总览只画当前栏目卡片的问题：拆开身份口径与热预取口径 ... 前一次改动（60d8b8fbb）把 `useProjectResourceCardPreviews` 的 `resources` 从全量投影收窄成当前分页栏目，造成产品回归：该入参不只喂热预取，它同时决定返回的 `identityByResourceId`，而 `renderResourceBookCard` 在身份缺失时 `return null`，于是资源总览（main 态）只有当前分页栏目画出真实卡片，其余栏目只剩栏目标题栏加空的层叠占位。 - 拆成两个入参：`resources` 恢复全量资源投影语义（决定 `identityByResourceId`、缓存与卡片挂载），新增 `eagerResources` 只用于 `eagerPreviewLimit` 计数的热预取，缺省回退 `resources`。两个入参的语义写进 Hook 参数注释，调用方 `index.tsx` 在传参处注明「收窄 `resources` 会让其它栏目只剩标题栏」。 - 纠正前一次提交的说法：**identity map 必须保持全量**，不能跟着热预取一起收窄。热预取可以只喂当前栏目（上一个提交的意图保留、`A → B → 回 A` 会重读 A 可见卡的已知代价也保留），但身份 / 渲染口径收窄会让总览其它栏目不再挂载卡片——技术方案要求「主画布展示各子画布的缩略入口，内部按资源类型显示有限层叠卡片……主画布预览和子画布展开态复用同一套卡片视觉」，这是产品回归而非可接受的行为变更。 - 不使用「身份未知时用 idle 占位兜底渲染」这条备选：它会让总览卡片失去真实预览，观感更差。 - `pitfalls.md` 追加同题排障口径，含通用规则：凡 Hook 入参同时参与「身份 / 缓存 key」与「调度 / 预热」，就不能为优化调度去收窄它，应先确认它还有没有别的消费者。 - 回归用例 `appSurface > uses one full-page canvas per resource section with dependency-only guide lines` 已自行变绿（未改该断言）。验证：`npm run test -- apps/ai-game-creator-shell/tests` 1171 passed / 4 skipped / 0 failed；`appSurface.test.ts` + `useProjectResourceCardPreviews.test.ts` 415 passed；`src/components/image-editor` 1385 passed；typecheck exit 0；check:encoding 4374 文件；`git diff --check` 干净。	2026-09-11 01:47:04 +08:00
suzmii	1ac8cc3eca	补记本轮 AGC 修复的排障口径与既有约定 ... - pitfalls.md 新增「资源搜索栏改成临时叫出的浮层」条目：写清"回到资源总览点不动"的两层成因（横跨整行、z-index 40 的透明工具条带盖在 z-index 30 的栏目标题栏上吃掉命中区域；管理区 padding-top 与场景 inset 只为给搜索框腾带子）、浮层的几何口径（bottom: 58px = Dock 14px + 34px 高 + 10px 间隙，刻意不写 top；提示层 top: 58px = 标题栏 42px + 16px）、必须钉住的两条（提示层 pointer-events: none + 提示条 auto；收起不清搜索条件、由 Dock 按钮 is-active 表达），以及门禁为什么抓不到（jsdom 不做命中判定）。 - pitfalls.md 新增「画布侧分类筛选条已移除」条目：记录用户口径、只移除画布这一处用法而保留共享组件、随它删掉的画布筛选轴，以及"不要顺手改分区、将来恢复要重新设计入口"。 - pitfalls.md 新增「项目对话输入区必须留在对话框内部」条目：记录两只绝对定位盒子上下紧贴的成因、对话框=消息列表盒子 + 输入区三边内缩 12px 的做法，以及列表留白 256px 与编辑器 min/max 高度必须成对维护。 - 本次只补文档，不改代码；编码检查 4374 文件通过，文件保持 LF。	2026-09-11 01:24:17 +08:00
suzmii	5e29b1bb57	预览链去掉无消费者的摘要计算，并为预览读取加进程内 manifest 缓存 ... - 资源卡预览不再计算 SHA-256：`AgentRuntimeInspectionImage.sha256` 改为 `Option<String>`，读取函数新增 `include_sha256` 开关，门禁、分块读取、漂移与重开身份复核、签名与尺寸校验仍只有一份实现，只在末尾按调用方决定是否算摘要。预览路径传 `false`（它的 `LocalProjectImagePreview` 从来不消费摘要），Agent `image.inspect` 路径继续传 `true`。 - 取摘要改为 `sha256_digest() -> Result`，缺摘要失败关闭；`project_gates.rs` 提前算成 `image_sha256` 再进判定闭包，避免退化成「空摘要 == 记录里的空摘要」而静默通过视觉检查复核；`runtime_tools/media.rs` 改用仓库既有的 `match { Err => return failed observation }` 风格，不引入新的 panic 面。 - 新增 `read_manifest_cached_for_preview`，只接到 `read_local_project_image_preview_at`、`read_local_project_text_preview_at`、`read_local_project_media_preview_at` 三个预览命令，消掉一次画布装载中「每张卡片各读并解析一遍同一份 manifest」的重复开销。`read_manifest` 本体、`read_manifest_for_project` 和写入路径的安装后回读一字未动。 - 缓存命中判据每次重新获取当前文件身份：路径复核 + 非符号链接或 reparse point + 普通文件 + 长度 + mtime + 文件身份（Windows `(volume serial, file index)`，Unix `(dev, ino)`）；失败一律不入缓存，错误语义与 `read_manifest` 完全一致。为此放开 `metadata_is_windows_reparse_point` 为 `pub(crate)` 并新增跨平台 `open_file_identity_key`。 - 写入侧硬做失效：`write_manifest_with_lock_hook` 成功写入后调用 `forget_preview_manifest`。只靠长度 + mtime + 身份堵不住同长度原地改写，显式失效后正确性不再依赖时间戳粒度，读取侧身份复核保留为兜底。 - 收益如实记录：真机项目实测 52 次 manifest 读加解析约 10 ms 量级，并省下约 3.15 MiB 重复磁盘读取。这是消除重复工作的正确改动，但不是性能救命项；用户感知的加载耗时大头仍在资源卡图片解码。 - 决策记录补「AGC 资源卡预览维持 data URL 加纯内存 LRU，不引入 Tauri asset 协议」：正式否决该候选路径，写明原始合同原文（不向 WebView 暴露任意本机文件协议或绝对路径）、打通所需配置（`assetProtocol` 加 `protocol-asset` feature 加 scope 只能 `**/*`）、会绕过的全部门禁（`file.read` 权限、项目边界、登记复核、敏感路径、父目录链接、硬链接、读取漂移与重开身份、按魔术字类型校验、尺寸上限、取消语义与全局 3 permit），以及收益与代价不成比例；同时否决磁盘缩略图缓存。 - `pitfalls.md` 补同题排障口径，含判据陷阱：把「每次启动重读」当成本瓶颈是错的，真机 52 张 PNG 分层实测 Rust 加 JS 合计仅约 0.3 s。	2026-09-11 00:57:33 +08:00
suzmii	30acd9552c	写入侧产出 canonical kind，读取侧读时重派生自愈存量分类 ... - 写入侧：infer_canvas_export_asset_kind 直接返回 canonical kind（animation → character-animation、ui → ui-design、asset → image），不再让别名表替写入侧兜底 - 写入侧补防御性归一，并新增 canvas_export_asset_kind_is_always_canonical 逐分支钉死返回值为 canonical、且不再写回 ui / animation / asset - 读取侧：gameCreationAppAssetCategory 加收窄覆盖规则——落盘 category 为 unclassified 且 kind 能派生出明确非 unclassified 分类时采用派生值 - 该规则不写迁移脚本、永久自愈：真机 57 条 ui 资产待归类从 58 降到 1，UI 交互从 2 升到 59，仅剩 code 类 game-entry 在待归类（分类表设计口径） - 收窄条件把覆盖窗口压到最小：落盘值本身是明确分类时仍信任落盘值（保留用户在分类与标签面板手动设置的权威性） - kind 派生结果本身即 unclassified 的 image / video / code / publication-material 不受影响，补断言钉住 - resourceCardPreviewRealManifest 由「记录缺陷」改为「守住修复」：断言归位后的 58 → 1 分布与 57 条 ui 全部落 UI 交互 - PRD 与 pitfalls 补记分类取值优先级、读时自愈规则、唯一盲区（手动把可明确分类的资产设为待归类会被覆盖）及写入侧 canonical 化	2026-09-10 23:15:04 +08:00
suzmii	ff42fff61c	按评审意见把写锁等待挪出 runtime worker 并收紧 wait_exhausted 记账 ... - agc_write_file 写路径改经 bridge_write_file_in_blocking_pool 走 tokio::task::spawn_blocking：有界等待是同步轮询（最多约 10 秒），直接在 async handler 里跑会占住 tokio worker，争用窗口内同一轮并行写多个文件时会波及共享同一 runtime 的只读端点与 UI 命令 - 新增用例用默认 current_thread runtime 加心跳任务锁住该性质；把 handler 临时改回同步直调时该用例按预期失败，确认有区分度 - project.write_lock.wait_exhausted 与终态改判一起改为只在真的等过（max_attempts > 1）时发生：hydrate 的单次试探不再写 waitedMs 近似 0 的“耗尽”日志 - 技术方案、decision-log、pitfalls 同步这两条，并补“同步有界等待不能直接跑在 async handler 里”的排障经验	2026-09-10 21:38:48 +08:00
suzmii	b87120445c	Merge remote-tracking branch 'origin/master' into feat/agc-canvas-resource-workbench-v3	2026-09-10 21:24:05 +08:00
suzmii	df9c32b5ea	记录 kind 别名只救新登记不救存量 category 的陷阱 ... - 补记 ui 资产落待归类的完整成因链：kind 兜底 image 再经 image → unclassified 误分 - 写明 register_local_asset_entry 命中同路径时不重算 category，故存量 57 条无法自愈 - 写明读取侧必须信任落盘 category 的原因：存在用户手动改分类的正式链路 - 列出三个根治选项供拍板：读时重派生 / 一次性回填 / 只改写入侧 - 记录别名表在 TS 与 Rust 各有一份实现、必须成对维护，以及交叉守卫位置	2026-09-10 21:19:19 +08:00
suzmii	df4168f71f	记录资源预览读取分支与版本时间的排查口径 ... - PRD 明确队列身份用的 category 是资源分区栏目、只用于前端去重与布局，不作为 IPC 入参 - PRD 明确 read_local_project_media_preview 的线上 category 是原生读取分支，只接受 art / audio，须由卡片预览类型派生 - pitfalls 新增「媒体预览 category 是读取分支而非栏目」：记录阶段二把用例一起改成错误行为导致门禁失守，并写明现有守卫位置与实测失败口径 - pitfalls 新增「versions[].createdAt 是 Unix 秒」：记录夹具与实现一起错导致门禁失真，以及已知秒值断言年月日的验收口径	2026-09-10 21:05:30 +08:00
suzmii	71e9ad3133	修复锁失败终态判据漏传平台导致 CI 把权限改判成争用 ... - project_write_lock_permission_is_ambiguous 改为按平台加原始错误码判定（Windows 的 ACCESS_DENIED(5)）；只看 ErrorKind 在 Linux 上会得出相反结论：errno 5 在 Windows 是 ACCESS_DENIED、在 Linux 是 EIO - ProjectWriteLockFailure::Retryable 携带 platform，终态改判与争用文案都用同一次分类的平台，不再依赖宿主 errno 语义 - 终态投影用例显式用 Windows 平台构造失败并补 Unix 反例，两个平台上结论一致；CI 首次推送正是在此失败（2358 passed / 1 failed，left contention / right permission_denied） - pitfalls 补充“判据的每一环都要带平台”的排障经验	2026-09-10 20:46:10 +08:00
suzmii	2f8753f597	AGC 资源画布切换为 6 类资产分类加项目版本栏目（阶段二：投影轴与栏目表落地） ... - 契约层把 ProjectResourceCanvasPosition.section 加宽为 PersistedProjectResourceCanvasSection 并删除旧 ProjectResourceCanvasSection 联合 - 七个分区类型消费点改用 ProjectResourceCanvasCategory：投影、布局模型、布局 Hook、分区高度、依赖图层与画布历史 - RESOURCE_CANVAS_SECTION_ORDER 改为 PROJECT_RESOURCE_CANVAS_SECTIONS，删除 RESOURCE_CANVAS_VISIBLE_SECTION_ORDER - reconcileResourceCanvasLayout 接入读时归一化：旧栏目值按资源当前分区改写 section，坐标与手动标记原样保留 - 归并后的布局与原布局逐项不同，由既有协调路径判定 changed 并写回一次新分区，不引入迁移脚本 - 投影层五个资源入表点统一走 projectResourceCanvasCategory：项目版本独立成栏、Agent 回执归文档、其余按资产分类 - 新增 projectResourceDisplayKind 收敛 manifest 资产 subtype 即 kind 的显示类型口径，projectResourceTypeLabel 不再依赖旧栏目 - 卡片预览、编辑分流、媒体工具条、预览文案与画布历史快照改用显示类型与新分区，历史快照入栈时收窄到现行分区 - index.tsx 删除可见栏目导入与 visibleCategoryOrder，栏目标签由资源筛选唯一中文口径派生并补齐 7 栏 - index.tsx 补齐 7 栏默认视口与 7 个栏目图标（新增 LayoutGrid、Users、PackageOpen，移除已无用的 Code2） - index.tsx 删除 canvasResources 的 code 过滤：只登记游戏代码的项目现在落在待归类栏目并正常显示卡片 - 新增只登记游戏代码项目的 UI 回归用例，覆盖栏目大纲、默认落地栏目与代码卡片渲染 - 测试夹具按新分区轴迁移，新增旧栏目 sidecar 读时归并用例与栏目顺序用例 - 共享测试 harness 的资源卡查询正则允许栏目标签自带空格（UI 交互） - 同步 PRD 与共享记忆决策记录的栏目口径描述	2026-09-10 20:41:19 +08:00
suzmii	06f738dc99	将项目写锁从 project/filesystem.rs 纯搬移到 project/write_lock.rs ... - 新建 project/write_lock.rs：取锁、等待分类、持锁方诊断、残留回收与 4 条锁用例整体搬移，逻辑不变 - project/filesystem.rs 只保留项目文件 IO（1533 → 680 行），锁相关常量、结构、进程判据与用例全部移出 - project.rs 注册 mod write_lock 并 pub(crate) use write_lock::*，crate::project:: 与 crate:: 既有路径不变 - windows_metadata_is_reparse_point 提为 pub(crate)，供 write_lock 复用同一条 reparse point 判据 - agent_db.rs 与 checkpoint.rs 的 PROJECT_FILE_FLAG_OPEN_REPARSE_POINT 导入路径改为 super::write_lock - 同步修正技术方案、Fast GDD 技术方案、decision-log、pitfalls 中指向锁实现的文件路径，并把“拆锁”从后续事项改为已完成	2026-09-10 20:12:28 +08:00
suzmii	eda34187fc	修复 AGC 资源栏目大纲常态不可读：恢复 Dock 底板、栏目图标与完整文字 ... - styles.css：`.game-resource-outline` 常态从 `opacity: 0.68` + `scale(0.86)` + 透明底 + 无阴影，改回完整尺寸（`opacity: 1`、`transform: translateY(-50%)`）并给现有视觉语言的 Dock 底板（`--platform-subpanel-border` 边框 + `--platform-nav-fill` 背景 + 与右下角缩放 Dock 同款阴影 + `blur(6px)`）。 - styles.css：`.game-resource-outline button` 常态列宽由 `0 minmax(0,1fr)` 改为 `18px minmax(0,1fr)`、`gap: 6px`，栏目图标常态 width 14px / opacity 1，不再只在悬停时才出现。 - styles.css：栏目文字 11px → 12px；当前栏目（`.is-active`）常态就带 `--platform-nav-active-*` 的边框、底色和阴影，用户一眼能认出当前分区。 - styles.css：悬停/键盘聚焦保留为同一套 token 的加强（更深的边框、`--platform-nav-active-shadow`、`blur(10px)`），不再靠"常态缩到只剩文字"表达层级。 - 不改交互语义：大纲仍然是 `openResourceBookChild` 的入口，按钮 key、aria-label、aria-current 与未读小圆点全部保持原样。 - 测试：新增 CSS 声明级断言，钉住常态不降透明度、不 scale、有底板，图标常态 14px 且文字 12px（jsdom 不加载 styles.css，可见性只能钉声明）。 - 测试：新增 DOM 用例，断言每条栏目入口同时具备图标与栏目文字，且切换栏目后当前项带 `aria-current="page"`。 - 文档：同步《GameAgent资源自由画板与快速编辑》的「操作边界」与「验收」两条，把"常态缩小、只露栏目文字"改成"常态即可读可点"，并同步 pitfalls 里的对应口径。	2026-09-10 20:11:09 +08:00
suzmii	8c639e5d13	修复项目写锁重试判据用一次元数据观察误判瞬时争用 ... - 项目写锁分类改为只按错误码判定重试性，不再用 path.exists() 决定“要不要等”：真机 6 万次建锁/删锁竞争实测 396-538 例命中“ACCESS_DENIED(5) + 目标不可见”，旧判据会让等待层立刻失败关闭，把毫秒级竞争换成更误导的 ACL 文案 - 新增 ProjectWriteLockFailure（Retryable / Terminal）与 acquire_project_write_lock_failure，有界等待改按类型分流，acquire_project_write_lock 退化为它的文案包装 - Windows 的 ACCESS_DENIED(5) 终态改判移到等待预算耗尽之后：只有真的等过预算且目标此刻仍不存在时才投影成权限拒绝，单次试探保持争用语义 - 锁分类判据改为平台参数传入（project_write_lock_open_failure_for），Linux CI 可覆盖 Windows 分支；替换原先只在 Windows 本地执行的分类用例 - 零等待入口在错误码不可区分时补一句“可能是删除挂起、删除拆链窗口或权限 / ACL 拒绝”，争用前缀逐字不变，调用方既有重试语义不受影响 - PROJECT_WRITE_LOCK_CONTENTION_PREFIX 收口 provider_recovery.rs、planning_session_v2.rs、direct_runtime.rs 三处手写文案 - project.write_lock.wait_exhausted 日志补 projection= 分类，attempts 记为实际尝试次数 - 同步更新技术方案、decision-log、pitfalls，并修正 ownerIsSelf 只比 PID 的表述	2026-09-10 20:07:28 +08:00
suzmii	9196ba3c96	修复 AGC 资源画本框选没有任何颜色：给画本场景根补共享画布根类 ... - index.tsx：`ResourceBookScene` 的场景根 `.game-resource-book-scene` 补上 `genarrative-image-canvas` 类，让共享 `SelectionOverlay` 的框选 token 有定义它的祖先。 - 根因：共享选择框的 `border: 1px solid var(--genarrative-image-canvas-selection-border)` / `background: var(--genarrative-image-canvas-selection-fill)` 没有 fallback，这两个 token 只声明在 `packages/image-canvas-react/src/styles.css` 的 `.genarrative-image-canvas` 根类里，而该根类由共享 `CanvasViewport` 渲染；AGC 只渲染 `SelectionOverlay`、从不渲染根类，声明在计算值阶段被整条丢弃，用户框选时看不到任何选择框。 - 安全性：该根类只有 3 条自定义属性声明、无布局副作用，加 className 不改布局。 - 测试：新增真实 `pointerdown` / `pointermove` 框选用例，断言选择框存在、内联几何非空，且最近的 `.genarrative-image-canvas` 祖先就是画本场景根；去掉根类后该用例失败（已实测）。 - 测试：新增 CSS 声明级断言，钉住根类的描边/底色 token 存在且非透明，消费端仍按 var() 取值（jsdom 拿不到计算色，这里只能钉声明）。 - pitfalls.md：补记"复用共享画布子组件要自己渲染根类"的排查口径。	2026-09-10 20:00:42 +08:00
suzmii	59cab3d9fd	Merge remote-tracking branch 'origin/master' into fix/issue-318-write-lock-classification	2026-09-10 19:58:05 +08:00
suzmii	6f09bf3a00	AGC 资源画布分区轴改为 6 类资产分类加独立项目版本栏目（阶段一：契约与读时映射） ... - 契约层新增 PROJECT_RESOURCE_CANVAS_SECTIONS：6 类资产分类加末尾独立的项目版本栏目，并补齐分区类型 - 契约层新增旧四 / 五栏目取值白名单、Persisted 联合类型与两个类型守卫 - Rust 契约 ProjectResourceCanvasSection 增补 7 个现行 variant 并保留 Code / Art 旧值，新增同名分区常量 - Rust 契约不升 game-creator-resource-layout.v1 版本、不给未知 section 加兜底，损坏 payload 继续失败关闭 - 新增 resourceCanvasSectionMapping.ts：旧栏目到现行分区的映射表、回落栏目与读时归一化 - 读时归一化只改写 section，x / y / manuallyPlaced 原样保留，无法归并时沿用既有丢弃行为 - resourceProjectionModel 把扩展名分类器更名为 projectedResourceKind 并收敛为准入与显示类型 - resourceProjectionModel 新增 projectResourceCanvasCategory：项目版本独立成栏、Agent 回执归文档、其余按资产分类 - Rust resource_layout 测试夹具改用现行分区值，并新增既有旧 section sidecar 仍可读取的用例 - 新增 resourceCanvasSectionMapping 测试：旧值乘目标栏目矩阵覆盖坐标保留、section 改写、changed 判定与回落列不变量 - projectResourceProjectionModel 测试新增 7 栏分区投影、项目版本独立成栏与只登记游戏代码项目落在待归类 - 同步 PRD、GameAgent 资源自由画板技术方案、AGC 实施计划与共享记忆决策记录的分区口径	2026-09-10 19:57:34 +08:00
suzmii	180a157982	同步 pitfalls 中失效的 ACL 桩名称并补注入点说明 ... - pitfalls.md：把「测试超时补充」里引用的 persistenceOptions 改为当前实际使用的 skippedWindowsAclOptions，避免文档指向已不存在的名称。 - pitfalls.md：补一句 prepareSwarmTestRuntimeConfig 暴露的可选 secureWindowsPath 注入点、默认 null 走真实实现，以及单次调用最多加固 3 次的事实。	2026-09-10 19:56:02 +08:00
suzmii	fc5adf48aa	记录 AGC 配置向导单测的 Windows DACL 子进程超时坑 ... - pitfalls.md：在「终端真实测试不能混用配置参数、stdin EOF 和持续预览」下补一条测试超时补充，紧接既有的 Windows PowerShell 参数条目。 - 内容：配置向导读路径与写路径都会加固私有目录与配置文件，没拿到 secureWindowsPath 桩时 Windows 上每次调用各拉起一个真实 powershell.exe（本机实测约 0.6s / 次）；只桩写不桩读会累计 9 次加固、约 5.5s，稳定撞上 vitest 默认 5000ms 并报 Test timed out in 5000ms。 - 结论口径：只校验配置分层优先级、不校验 ACL 的用例，读写路径必须带同一份 persistenceOptions；确实要覆盖私有 ACL 的用例才保留真实加固并自行留足超时预算。	2026-09-10 19:34:04 +08:00
suzmii	7fe1fd9b64	Merge branch 'feat/agc-v3-canvas-generation-entry' into feat/agc-canvas-resource-workbench-v3	2026-09-10 17:40:49 +08:00
suzmii	94fc4c6779	Merge branch 'feat/agc-v3-c7-version-switch' into feat/agc-canvas-resource-workbench-v3	2026-09-10 17:40:46 +08:00
lhk229	9b5d1fe107	修复仓库回退配置模板被读取通道私有化 ACL 锁定 ... - config.rs 新增 game_creator_config_path_is_runtime_managed 判定，read_game_creator_config_file 按路径归属分流：AppData 托管目录内的真实凭据维持私有加固读取，仓库旁边的回退模板与 local 覆盖改用 open_project_snapshot_regular_file 非变异快照通道 - 根因：开发 CLI 无 AppHandle 时回退读取 worktree 内 git 跟踪模板，私有读通道在 Windows 上无条件收紧 DACL 为仅当前进程用户，导致其他账号与 cargo include_str! 全部 Access Denied - tests/mod.rs 新增 clear_test_runtime_config_dir 辅助 - tests/configuration.rs 新增两个回归测试锁定快照 / 私有两条读取通道的分流 - pitfalls.md 记录该排障经验与读取通道副作用白名单教训	2026-09-10 08:57:31 +00:00
suzmii	9ce31f905e	沉淀 AGC 画布现状与取数约束到共享记忆 ... - pitfalls.md 追加「AGC 走不了网页端 /api/editor 的取数链」：Tauri asset 协议 + CSP connect-src 未放行平台域名，且 dev 的 vite /api 代理会造成「能跑」假象 - pitfalls.md 追加「ImageCanvasStageView 是硬组合容器」：132 props（57 数据 + 75 回调）、无条件渲染 8 个子视图、83/132 需宿主伪造编辑器状态，且不透传 supportedActions - pitfalls.md 追加「AGC 资源画布真正自制的交互面」：resourceBookViewport.ts、resourceCanvasLayoutModel.ts 的 fit/normalize、index.tsx 3656-4090 指针段，并记录两条平移路径守卫不一致与右键菜单、chrome 样式缺口 - pitfalls.md 追加「资源画布工具条改造/角色动画按钮点了没反应」：空回调仍留在 supportedActions 里，按钮渲染但无人接	2026-09-10 16:50:02 +08:00
suzmii	6496601d12	资源画布接入生成素材入口并打通无源新建链路 ... - index.tsx 只做导入、一个生成入口按钮、一处浮层渲染与提交回调；无 invoke 桥或项目未就绪时入口不渲染 - 提交走 derive_local_project_resource 的 create 模式：sourceResourceId 为 create:<operationId>，sourceAssetId / sourcePath / sourceSubtype / producerTaskId / sourceVersionId 全为 null - 产出后经 pendingResourceFocusRef 定位并选中新素材卡，并写入生成资源已保存提示 - projectResourceLiveIntegration 补入口可见性、create 入参、重试复用 operationId 与新卡定位 2 条用例 - 实施计划文档补 C3 生成入口口径、图片无源生成未完成项与本轮验证数字	2026-09-10 16:37:52 +08:00
suzmii	81c2389132	修复 AGC Direct 写通道项目锁零等待与持锁方不可诊断 ... - Direct 写路径（agc_write_file）改用统一的有界等待，与 file.write / file.patch / file.delete 同语义，同一轮并行写多个文件按同一把锁串行，不再在 24-42ms 内把重叠判成"项目正在被其他写操作占用" - create_new 失败拆成争用 / 权限拒绝 / 其它三类：锁文件不存在却仍创建失败不再投影成争用；sharing violation(32) 与 lock violation(33) 恒定归争用 - 争用错误与等待日志带上持锁方身份（commandId / pid / createdAt / ownerIsSelf），锁文件处于删除挂起或未写完时显式表达成"身份不可读" - ProjectWriteLockSnapshot 补 commandId 与 describe_holder()，沿用既有快照 + 字节 CAS 回收机制，不新增第二套回收判据 - 有界等待预算耗尽记 project.write_lock.wait_exhausted（含等待毫秒数），权限拒绝记 project.write_lock.permission_denied，争用不在零等待入口里逐次记账 - 新增同进程重叠写等待、同轮并行写、活外部进程持锁带身份、权限拒绝分类、ACL 拒绝不投影成争用五条回归用例 - 同步 decision-log、pitfalls 与技术方案文档	2026-09-10 16:30:22 +08:00
suzmii	f09f5f9e9c	补齐 AGC V3 收口阶段的决策记录 ... - decision-log 新增两条 2026-09-10 决策：资源画布基础能力收口（撤销重做只作用于卡片布局、独立资源面板、上传走 upload_local_asset、下载改为显式保存链路 save_local_project_asset_file + dialog:allow-save） - decision-log 新增：运行模块版本切换（版本状态唯一一份放在 WorkspaceLauncherShell、运行模块右上角 GameRunVersionPicker、切换只重载预览不做运行时资源重映射）、参考图弹窗与共享筛选条、标签库纯派生口径、素材重命名前端接线 - 同步修正上文"重命名只落 Rust 侧"的已知中间状态：前端调用方已落地，该中间状态结束	2026-09-10 16:05:01 +08:00
agent	00963c5f67	同步 AGC V3 版本切换、参考图弹窗、标签库与素材重命名 UI 的功能文档 ... - 实施计划追加 2026-09-11 条目：标签库派生口径、共享筛选条、C7 版本切换、C9 参考图弹窗、素材重命名 UI 与 allowlist 收敛 - 写明版本切换不做运行时资源重映射的理由与参考图 ID 快照的落库路径 - 记录本次门禁实际数字与 5 条待 C3 侧更新的既有失败用例	2026-09-10 15:50:54 +08:00
suzmii	d851aa83ff	补充 AGC 资源工作台 V3 的实施计划条目 ... - 新增 2026-09-10 条目，写清版本绑定恒等化与撤回运行期资源观察侧车的边界（删 asset_usage 及其 16 条测试、绑定退回恒等映射） - 写清素材删除三分支语义、deleteReferencedVersions 入参、read_local_project_asset_references 只读命令，以及版本追加唯一例外的放行集合按写入前 manifest 求值 - 写清 agc_list_registered_assets 投影新增 category/tags 且不在投影层重新派生分类 - 写清 rename_local_project_asset 的语义（文件改名 + localPath 更新、id 不变）、校验、写失败回滚与 reconciliation-required 口径，以及"不改游戏源码引用"的已知边界 - 写清 @ 面板两个页签与 activeVersionId/versions 契约、polish_local_project_prompt 的入参与计费口径（不自建计费，走 server-rs 的 LLM 路由）、发送前提醒判据与本机偏好存储 - 记录本次全部门禁数字	2026-09-10 15:02:34 +08:00
suzmii	2c07396ef7	补充 AGC 复用网页端美术画布组件的跨端依赖排障记录 ... - pitfalls 新增一条：AGC 引 src/components/image-editor 组件会经 ImageCanvasGenerationModel 的 ApiClientError 值导入链到 src/services/apiClient.ts 与 host-bridge/hostBridge.ts，而它读的 wx / ReactNativeWebView / WeixinJSBridge 只在主仓 vite-env.d.ts 声明 - 记录处置口径：在 apps/ai-game-creator-shell/src/vite-env.d.ts 的 Window 上补同名同形字段（纯类型声明零运行时影响），不要关闭 AGC 的 noImplicitAny，也不要另写平行组件 - 记录已核实的运行时结论：hostBridge.ts 模块作用域只有常量与缓存声明、无导入即执行副作用，window.wx 仅在函数体内访问且有 typeof window 守卫，故该依赖链编入 AGC bundle 是惰性的	2026-09-10 14:56:45 +08:00
suzmii	30e93c6c43	合并 WS-D 阶段一：新增本地项目素材重命名命令 ... - 解决 main.rs / project.rs / tests/mod.rs 的相邻插入冲突：main.rs 保留 read_local_project_asset_references 与 rename_local_project_asset 两条注册，project.rs 与 tests/mod.rs 只保留 mod asset_rename（asset_usage 已由 WS-A 整体删除） - 解决 decision-log.md 末尾追加冲突：保留双方条目（WS-A/口径收敛、删除新口径、C3 交互、Agent 投影 + WS-D 素材重命名）	2026-09-10 14:46:15 +08:00
suzmii	26f1a7b19c	Merge branch 'feat/agc-v3-c4-mentions' into feat/agc-canvas-resource-workbench-v3	2026-09-10 14:43:58 +08:00
suzmii	dbbca47078	同步 C4 引用补全与 C8 润色提醒的功能文档 ... - 更新【功能说明】AGC聊天素材引用：补充素材面板双页签、activeVersionId 版本回退与空态口径 - 更新【功能说明】AGC聊天素材引用：把「改名刷新显示名」「跨会话恢复光标位置」从未完成移到已完成 - 新增【功能说明】AGC聊天AI润色与发送前提醒：写明润色回填、原文快照、失败保留原文与提醒面板行为 - 新增文档同时记录提醒判据、不再提醒偏好存本机 localStorage、以及计费仍走平台 LLM 路由的边界	2026-09-10 14:42:40 +08:00
suzmii	b2477c8ca9	新增本地项目素材重命名命令（Rust 侧） ... - 新增 Tauri 命令 rename_local_project_asset（输入 projectPath / assetId / newFileName），并在 main.rs 的 generate_handler! 中注册 - 新增 project/asset_rename.rs：重命名语义为“磁盘文件改名 + manifest localPath 更新”，资产 id / kind / mediaType / source / category / tags 全部不变，imageSequenceFrames 里指向该文件的本地帧一并对齐 - 校验判据：新名非空、不含路径分隔符（同时保证不跨目录）、不含 ..、通过可移植路径组件校验、扩展名与原文件一致、同目录不得已存在同名文件、assetId 与磁盘文件必须存在 - 事务与回滚：持既有项目写锁，manifest 写入走既有 write_manifest 边界（版本数组校验 + 安装后回读一致性）；写失败把文件改回原名，回滚也失败时两个错误都报出并标记 reconciliation-required；同名重命名按空操作处理 - 新增 tests/asset_rename.rs 9 条用例：成功改名与身份不变、同名空操作、空名 / 分隔符 / .. / 跨目录 / 扩展名不一致 / 目标同名冲突 / 资产与文件缺失拒绝、manifest 写失败回滚、同目录帧对齐 - decision-log 记录素材重命名语义、命令边界，以及“前端调用方落地前 ai-game-creator-shell:typecheck 必然失败”的已知中间状态	2026-09-10 14:42:11 +08:00
suzmii	48700083a3	补齐 AGC V3 资源口径与环境约束的权威文档 ... - PRD §5.4 版本记录补充"只允许追加"的唯一例外：用户显式确认的连带删除，并写明放行集合按写入前 manifest 求值、被放行版本不得进入追加段 - decision-log 新增三条 2026-09-10 定稿：版本绑定恒等化并撤回运行期资源观察侧车；素材删除新口径（三分支 + 可选连带删除版本）；资源画布交互 1:1 复刻美术画布（取消资源详情面板与全屏编辑路由、复用共享组件以可选 prop opt-in、AGC 宿主自备 chrome 样式） - pitfalls 新增四条：新工作树的 cargo 必须在 npm ci 之后跑；残留 dev stack 会拖死 Rust 门禁；改共享美术画布组件时 AGC 门禁覆盖不到它自己的测试；AGC 侧没有 image-canvas-editor__* chrome 样式	2026-09-10 14:26:57 +08:00
suzmii	c1ffb2386b	资源功能分类与自定义标签：筛选口径收敛为 category 并接入写入 UI ... - 删除 resourceReferences.ts 中 mediaType 优先的 7 桶筛选口径与 resourceReferenceFilterKind，改由 resourceReferenceCategory / resourceReferenceMatchesCategoryFilter 以 manifest 资产 category 为唯一权威筛选口径 - RESOURCE_REFERENCE_FILTERS 改为 6 类 + 全部（全部 / UI 交互 / 角色与对象 / 场景与环境 / 音频 / 文档 / 待归类），并新增 resourceReferenceCategoryLabel 让中文名只定义一处 - ResourceReference 新增 category / tags，由 resourceReferenceFromAsset 经 gameCreationAppAssetCategory / gameCreationAppAssetTags 从 manifest 资产投影；资源画布 ProjectResource 同步新增 assetCategory / assetTags 投影与 projectResourceAssetCategory 待归类兜底 - 新增 Tauri 命令 update_local_project_resource_classification 与 UpdateLocalProjectResourceClassificationInput/Result，实现落在 project/manifest.rs 的 update_manifest_asset_classification_at，复用既有 mutate_manifest_at manifest 写锁与原子写入 - 命令持项目写锁后按 expectedProjectId / expectedProjectRevision 做 CAS，冲突分别返回 project-identity-conflict 与 project-revision-conflict；category 非 6 个合法值即报错且不回退到 kind 派生；tags 走 normalize_game_creation_app_asset_tags；只改目标条目的 category / tags 并在成功后推进一次项目 revision - 新增 Rust 定向测试 project/manifest/classification_tests.rs：更新成功、非法分类被拒、tags 归一化、未引用资产更新不影响其它字段、revision/CAS 与既有写入一致、输入拒绝未知字段 - 前端新增 ResourceClassificationPanel（ThemedModal + PlatformSegmentedTabs + PlatformTextField），资源详情面板以「分类与标签」按钮打开独立面板，保存后重读 manifest 并经 onManifestChange 反映到筛选与投影 - @ 面板与资源画布共用 packages/shared 的 PlatformSegmentedTabs 渲染同一组功能分类标签；画布筛选状态与画布视口一样按「按依赖 / 按类型」分别保存，复用既有 sortMode 状态形状 - 更新 resourceReferenceInput.test.tsx 与 projectResourceProjectionModel.test.ts 覆盖新口径，新增 resourceClassificationPanel.test.tsx 覆盖写入命令的输入归一化与失败不回退 - 同步技术方案与 decision-log：记录按 mediaType 分类到按 category 分类的语义变化（图片 / 视频桶消失，image / video / code / publication-material 归待归类）与新写入命令契约	2026-09-10 10:25:22 +08:00
suzmii	3f5d3b43af	合并最新 master 到 AGC V3 资源画布分支 ... - 合入 origin/master 6 个提交（#313 项目写锁残留回收与启动诊断、#315 AGC Ctrl+C 残留后端修复） - 冲突解决：decision-log.md 保留 V3 两条 2026-09-09 决策与 master 的写锁回收条目 - 冲突解决：pitfalls.md 保留 V3 转场经验条目与 master 的 Ctrl+C 后端残留条目	2026-09-09 21:46:09 +08:00
suzmii	c936268337	Merge branch 'feat/agc-canvas-real-flip' into feat/agc-canvas-resource-workbench-v3	2026-09-09 21:40:37 +08:00
suzmii	4a5b2ad524	修复返回总览时非活动栏目标题栏从屏幕外飞入 ... - begin 只记录当时可见的节点：不可见节点（内联 opacity 0）的屏幕矩形不是可信的 First - 非活动栏目标题栏在子画布态保留总览布局坐标，却被子画布 world 变换推到屏幕外，返回总览时不再以它作为动画起点 - 没有 First 的节点只走淡入，位置保持不动；活动栏目标题栏仍按原有观感收回到总览位置 - 进入栏目方向不受影响：标题栏当时可见，仍钉在原地淡出 - 新增回归用例：不可见标题栏几何首末相等、活动标题栏仍有几何动画、进入方向标题栏原地淡出 - 同步技术方案转场段与 pitfalls 经验条目	2026-09-09 21:39:20 +08:00
suzmii	4582231b78	合并 C3：资源画本转场改为真实元素 FLIP ... - 合入 feat/agc-canvas-real-flip（resourceBookController 重写为同节点 FLIP、新增 sync 可中断重基、删除 ResourceBookTransitionLayer） - 冲突解决：index.tsx 的 resourceBookLayout 导入取 C3 版（buildResourceBookScenePlan 等），去掉已被收进内部的旧 helper 导入避免未使用 - 冲突解决：资源自由画板文档的验证命令合并两侧并去掉已删除的 assetCanvasSurface.test.tsx	2026-09-09 21:24:13 +08:00
suzmii	a23728e6c2	合并 C10：删除 asset-canvas 精修草稿链路 ... - 合入 feat/agc-asset-canvas-removal 5 个提交（前端解耦 / Rust 删除 / 测试 / 文档 / 合同文档退役） - 冲突解决：asset_canvas.rs、asset_canvas/generation.rs、asset_canvas_tests.rs 按 C10 删除（C2 在其中新增的 category/tags 构造点随之消失） - 冲突解决：decision-log.md 保留 C2 与 C10 两条 2026-09-09 决策条目 - 该合并吸收 C2 对被删文件的字段改动，无需单独处理	2026-09-09 21:19:52 +08:00
suzmii	f84d0ea4d0	AGC 资源功能分类与自定义标签数据层 ... - manifest 资源条目末尾新增 category（单值 6 类，默认 unclassified）与 tags（字符串数组，默认空数组），两字段始终序列化 - shared-contracts 新增 GameCreationAppAssetCategory 枚举、GAME_CREATION_APP_ASSET_CATEGORIES 与穷举 16 个 canonical kind 的默认映射表 GAME_CREATION_APP_ASSET_CATEGORY_BY_KIND - 历史 manifest 缺少字段时按 kind 派生分类、tags 取空数组；显式合法分类原样保留，未知分类字符串按前向兼容退回 kind 派生 - packages/shared 同步 TS 契约：分类常量与类型、映射表、gameCreationAppAssetCategory / gameCreationAppAssetTags 取值 helper 与 tags 归一化 helper - 收编壳内 17 处 Rust 构造点：新建条目写 kind 派生默认值，更新既有条目保留已有 category / tags - 补契约测试：字段 round-trip、默认值、legacy 兼容、未知分类前向兼容、16 项映射穷举、tags 归一化 - 同步 docs/technical 技术方案与 docs/project-memory decision-log	2026-09-09 21:10:01 +08:00
suzmii	91396f0615	删除已退役的客户端素材创作无限画布阶段一合同文档 ... - `docs/technical/【技术方案】客户端素材创作无限画布阶段一合同-2026-08-05.md` 整篇退役：该文档描述的中央 asset-canvas 状态、草稿 sidecar、Tauri 草稿/媒体/staging 命令、正式资产提交事务、提交事件、画布状态机与图片生成账本已随机制删除，按四不写不留墓碑文档。 - 仍有效内容已迁往：共享画布包目录与依赖方向、禁止复制的验收门、Host Port 边界、共享 chrome 与主题、图片能力与后续分期迁入 `docs/technical/【前端架构】图片画布编辑器前端拆分计划-2026-06-17.md`；成功投影顺序与焦点守卫迁入 `docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md`；共享源码与资源派生闭环现状迁入 `docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md`。 - 全类型现有资源非破坏性编辑的现成权威条款为 `docs/technical/【技术方案】AGC资源派生与非破坏性编辑合同-2026-09-09.md`，它是 `project/resource_editor.rs` 的现行合同，已改写为 derive + editKind='image-reference' 口径。 - decision-log 的 2026-09-09 条目改写为决策文体：写清退役理由与现权威口径所在文档，历史条目保留原样。 - 过渡项删除条件：资源画布重建快速编辑后，`normalize_local_project_raster_resource` 重新获得前端调用方，届时删除 `apps/ai-game-creator-shell/scripts/check-config.mjs` 中该 allowlist 条目。	2026-09-09 20:32:38 +08:00
suzmii	4c935ba219	同步 asset-canvas 退役后的文档现状并迁移仍有效合同 ... - 新增 docs/technical/【技术方案】AGC资源派生与非破坏性编辑合同-2026-09-09.md，承接阶段一合同第 16 节与第 5 节的现役条款，改写为 derive + editKind='image-reference' 口径 - 图片画布编辑器前端拆分计划新增"共享画布合同"一节，承接共享包目录与依赖方向、禁止复制的验收门、Host Port 边界、共享 chrome 与主题、图片能力与后续分期 - GameAgent资源自由画板与快速编辑删除精修草稿、最终图事务、精修来源规范化、事务恢复对账、批量导入与失败任务归档等退役章节，改写目标与操作边界，新增"编辑结果投影与焦点竞态"一节，并更新验证命令 - App实施计划删除阶段一至五的草稿画布描述，改写为共享画布源码与资源派生闭环现状，修正主视窗状态、适配器与派生提交条款 - 项目开发工作台 PRD 更新主视窗状态机与 ProjectWorkbenchViewState，移除 asset-canvas 状态 - decision-log 追加 2026-09-09 asset-canvas 整体退役决策（含保留项、路由口径、临时白名单与存量数据处置） - pitfalls 删除草稿 CAS、素材保存区、正式素材提交原子性、生成账本与 upload ticket 五条退役条目，修正仍有效条目的关联文件与 legacyPrefix 描述	2026-09-09 20:28:22 +08:00
suzmii	4fb0de2c94	C3 资源画本转场改为真实元素 FLIP ... - resourceBookController 重写为真实元素 FLIP：begin 在提交前记录 First，play 测 Last 后给同一节点加反向 transform，sync 按布局签名做可中断重基 - 转场进行中重基用剩余时长（下限 80ms），空闲布局变化用完整 420ms，预览图尺寸晚到的二次布局变化不再瞬移 - 宿主节点几何基准改存 world 局部坐标，平移和缩放不会让上一次的干净矩形过期 - 不可见节点钉在 First 淡出、挂载节点淡入；搜索/排序导致的卸载保留一帧淡出；返回总览时源栏目未回到摞上的卡片按子画布布局淡出 - 新增 buildResourceBookScenePlan 渲染计划，渲染、转场签名与淡出集合共用同一份数据 - 删除 ResourceBookTransitionLayer 与克隆快照逻辑，清理 styles.css 的转场层和 data-book-motion 隐藏规则 - 重写 resourceBookController.test.ts，补 resourceBookLayout/resourceBookModel 用例与 appSurface 同节点断言 - 同步技术方案转场段与 pitfalls 经验条目	2026-09-09 20:24:10 +08:00
suzmii	a1b9b24891	修复 AGC Ctrl+C 残留上个工作树后端导致切换工作树复用旧后端 (#315) ... closes #314 ## 现象 `npm run agc` 按 Ctrl+C 后有概率残留上个工作树的 `api-server.exe` / SpacetimeDB，切换 worktree 再启动时 AGC 复用旧后端，改过数据库 / schema 的工作树会串库。 ## 根因 1. Windows 下长驻服务都经 Node `shell: true` 的 `cmd.exe /d /s /c` 包装层启动，Ctrl+C 先杀包装层（`0xC000013A`）；`dev.mjs` 的 `stopProcess` 见到直接子进程已退出就 return，`taskkill /PID <已退出 PID> /T /F` 也只会失败，深处的 `cargo → api-server.exe` 无人清理。 2. 按根 PID 遍历依赖快照里的父子链，中间层先消失时链断，只能拿到根 PID。 3. 复用判据只看 `.app/dev-stack.json` status 与 `/healthz`、`/readyz`、`/v1/ping`，不校验端口上的进程属于哪个工作树，残留后端照样被判为健康并复用。 ## 改动 - 新增 `scripts/dev-windows-process.mjs`：按根 PID 遍历 + 按身份匹配（`server-rs/target/debug/api-server.exe` 绝对路径、SpacetimeDB `--data-dir`）两条独立清理路径，带 1s 快照缓存避免清理被拖慢。 - `scripts/dev.mjs`：直接子进程已退出时仍按记录 PID 清理后代；退出时按身份兜底清扫本工作树后端（复用他人 standalone 时跳过）；启动前清理旧 api-server 保留 `Wait-Process` 语义，避免 `failed to remove file`。 - `apps/ai-game-creator-shell/scripts/start-dev-stack.mjs`：复用前校验端口监听进程归属，无法证明归属就不复用、改为启动本工作树后端并允许端口漂移；信号与 `finally` 各兜底清扫一次；`taskkill` 失败时降级按 PID 遍历；等待就绪时输出归属校验失败原因，避免静默超时。探测不可用时退化为旧行为，不阻断本地启动。 - 测试与文档：新增 `scripts/dev-windows-process.test.ts`、扩充 AGC 复用门禁用例；同步 `docs/project-memory/shared-memory/pitfalls.md` 与本地开发运维文档。 ## 验证 - 伪造 `api-server.exe` 进程：按身份精确命中并杀掉（`matched=[17284] stopped=[17284]`）。 - 3 个真实监听进程下归属判定：`owned` / `api-server-owner-mismatch` / `spacetime-owner-mismatch` 均正确。 - `npx vitest run scripts/dev.test.ts scripts/dev-windows-process.test.ts scripts/dev-stack-port-utils.test.ts apps/ai-game-creator-shell/tests/...`：119 passed（唯一失败为 Windows 文件权限用例，已确认在合并基线 `origin/master` 上同样失败）。 - `node --check`、`eslint --max-warnings 0`、`prettier --check`、`npm run check:encoding`、`git diff --check` 全部通过。 ## 备注 Rust 侧 `api-server` 的 `with_graceful_shutdown` 没有超时上限，是「有概率」的来源之一；本次只在 Node 侧收口，是否给优雅退出加 deadline 可另行评估。 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/315 Co-authored-by: Suzumiya <suzmii@qq.com> Co-committed-by: Suzumiya <suzmii@qq.com>	2026-09-09 20:08:04 +08:00