3414 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
suzmii	e15456ea14	读时丢弃的坐标不再静默：提示条带条数并在 DOM 上分开三类计数 ... - readReport 增加 droppedMissingResource（资源已不在 manifest）/ droppedSectionMismatch（分区与资源分类不匹配）/ dropped（两者之和），判据仍是 normalizeResourceCanvasPosition，未改 resourceCanvasLayoutModel 的丢弃语义。 - 文案补上跳过条数与两类原因：归并与丢弃同时发生时用「另有 N 条坐标无法对齐已跳过（…）」；只有丢弃时用「打开项目时有 N 条坐标无法对齐已跳过（…）」。 - 提示条暴露 data-resource-canvas-layout-normalized / -dropped / -dropped-missing-resource / -dropped-section-mismatch，供排障直接读 DOM；完全没丢时四个值都是 0。 - 读盘触发条件放宽为「有归并或有丢弃」，避免只有丢弃时什么都不提示。 - 断言：读盘统计用例覆盖三种情况分离；文案用例覆盖四形态（含真机 112 / 66 / 16 口径）；appSurface 用例断言四个 data-* 与完整文案。 - 变异验证：把 dropped 计数改成恒 0 → 统计用例、读盘报告用例、提示条用例三处变红；去掉 data-resource-canvas-layout-dropped → 提示条用例变红。	2026-09-11 19:18:12 +08:00
suzmii	18361f8585	读时归并不再静默：打开项目归并旧分区坐标后给一次性提示 ... - useProjectResourceCanvasLayout 新增读盘只读统计 inspectProjectResourceCanvasLayoutRead 与文案 describeProjectResourceCanvasLayoutRead。 - 读盘判定 changed 时写入 readReport（项目作用域身份 + 排序模式 + 旧分区归并条数），判据复用 normalizeResourceCanvasPosition，只统计、不改写回与丢弃语义。 - index.tsx 在既有 game-resource-book-notices 提示层内渲染一次性提示条，复用 .game-resource-live-notice 样式与「知道了」关闭按钮；每个项目只提示一次，切换项目清空。 - 断言：useProjectResourceCanvasLayout.test.ts 覆盖归并时 readReport 与文案、无需归并且不写盘、只补新资源落位的写回不报读时统计；appSurface/project-development.suite.ts 覆盖提示条出现（data-resource-canvas-layout-normalized、可关闭）与无需归并时不出现。 - 变异验证：去掉 setReadReport → 上述读盘统计与提示条用例变红。	2026-09-11 19:14:44 +08:00
suzmii	27be57bf68	修正上一条提交里错位的别名表用例行 ... - 现象：提交 3082c3e85 把两条新增的 `decided` 表行（`'UI'`、`'font'`）插到了 `test.each(decided)` 的实参位置，`test.each` 拿到的是对象而不是回调，原来 7 条 `decided` 用例全部报 `fn2 is not a function` - 成因：pre-commit 的 lint-staged 对**部分暂存**文件做「隐藏未暂存改动 → 跑 prettier → 还原未暂存改动」时会重新落位 hunk，本次两条新增行落错了位置；该文件当时是部分暂存（提交 ① 只暂存了其中 3 个 hunk），因此被波及 - 修法：把两条行移回 `decided` 数组内的正确位置，`test.each(decided)` 恢复成「表 + 单回调」形态 - 本提交只暂存这一个文件（不部分暂存），避开同一成因	2026-09-11 18:57:42 +08:00
suzmii	d9822eca05	同步资源分类口径的文档：读显示 / 写回两个口径、别名表大小写不敏感 ... - PRD 的分类取值段落改为「读显示 / 写回两个口径」：写清跨端同构的两个函数名、Agent 投影不许再透传落盘 `category`、面板保存回传落盘原值、别名表大小写不敏感（`"UI"`、`font`） - 技术方案（AI游戏创作智能体App实施计划）的 manifest `category` 段落同步：`"UI" → ui-interaction`、`font → document`，其余映射不到的 kind 才落 `unclassified`；补上两侧口径函数名 - `pitfalls.md`：把「补别名只影响新登记，不重算 `category`」这条坑更新为已修形态，并写明「同 kind 重登记禁止动 `category`」这条必须保留的不变量；「读时重派生」条目补上两个口径不能混用与跨端必须同构两条 - `pitfalls.md` 新增条目「大写 `UI` / `font` 不在 alias 表 → 8 条真机 UI 资产永远落「待归类」，且自愈救不回」，记录成因链与三层守卫 - `decision-log.md` 新增决策条目：口径拆两半、自愈不下沉到反序列化、别名表大小写不敏感、重登记重派生但不抹掉显式分类，含变异验证与影响范围 - 端到端验收用例文档的 S5 栏目归属补一句：判定「编辑标签后分类有没有被改」必须比 manifest 文件，不能拿自愈后的显示值当落盘值	2026-09-11 18:49:32 +08:00
suzmii	f476eb89e5	同路径重登记：kind 变化时重派生 category，同 kind 时保留落盘分类 ... - `register_local_asset_entry`（`assets.rs`）命中同 `localPath` 的既有资产时，旧实现只覆盖 `kind` / `media_type` / `source`，**从不重算 `category`**：`kind` 变了而 `category` 停在旧值，且陈旧的非 `unclassified` 值会被读侧无条件信任（自愈只在落盘值是 `unclassified` 时才触发），该资产就永远停在错误栏目 - 修法：只在 `existing.kind != kind` 时重派生 `category`；`kind` 未变时刻意不动 `category`——落盘分类是权威值，同 kind 重登记不得抹掉它 - `register_local_asset_records_existing_asset_with_canvas_source` 补上 `category` 断言：首次登记 `kind:"character"` 落 `character`，重登记改成 `kind:"ui"` 后必须变 `ui-interaction`（旧用例只断言 `kind` 与 `source.kind`，正好走更新分支却漏掉 `category`，所以这条错位一直没被抓住） - 新增用例 `register_local_asset_keeps_explicit_category_when_kind_is_unchanged`：显式设成 `audio` 后同 kind 重登记，`category` 与 `tags` 必须原样保留，把「不能无条件重派生」这条不变量钉死 - 新增用例 `register_local_asset_derives_category_from_real_write_side_kinds`：用与现役写入侧逐字一致的字面量（`"UI"` / `"font"`）走真实 `register_local_asset_at`，断言落到 `ui-interaction` / `document`；它属于同一套 `register_local_asset_*` 写 API 的派生行为，因此与上面的更新分支断言放在同一个提交	2026-09-11 18:48:03 +08:00
suzmii	3082c3e854	kind 别名表大小写不敏感并收口 font：堵住 8 条 UI 资产永远落「待归类」 ... - `canonical_game_creation_app_asset_kind`（Rust）与 `canonicalGameCreationAppAssetKind`（TS）改为对 trim 后的小写值查别名表与 canonical 目录，修正「UI 设计资产的现役写入侧写的是大写 `"UI"`」这条真机事实 - 别名表补 `font → document`：字体上传（`ttf / otf / woff / woff2`）登记的 manifest `kind` 就是 `font` - 为什么必须在别名表收口、读时自愈救不回来：`"UI"` 与 `"font"` 的派生结果本身就是 `unclassified`，自愈规则「派生值不是 unclassified 才触发」永不成立；真机 8 条 `kind:"UI"` + `mediaType:"application/json"` + `localPath:"ui/UI 设计 N.json"` 与写入路径逐字段吻合 - 改写 Rust 断言 `game_creation_app_asset_category_for_kind("UI") == Unclassified` → `UiInteraction`，并补 `canonical_...("UI") == "ui-design"` 与 `font == Document`：旧断言把这条 bug 钉成了「期望行为」，新形态才是唯一真源——写入侧真实写出的 kind 必须能落进明确栏目，否则真机资产永远归不了类 - 改写 TS 断言 `gameCreationAppAssetCategoryForKind('UI') == 'unclassified'` → `'ui-interaction'`，理由同上 - `game_creation_app.rs` 里「现役写入侧仍会写出这些非 canonical 值，必须在这里收口」的注释此前只收口了小写 `ui`，与大写写入侧矛盾，现按注释本意收口 - 新增写侧→分类的端到端契约用例：`resource_bridge.rs` 的 `bridge_is_idempotent_and_installs_source_image` 走真实生产函数 → 真实 `register_local_asset_at(..., "UI", ...)` → 断言落盘 `category` 为 `ui-interaction` - 新增 `assetKindCanonicalMapping.test.ts` 的「写侧 kind 字面量 → 分类」用例组：直接解析 UI 编辑器写侧源码第 3 个实参，写点换个新字面量就会红，防下次再漏	2026-09-11 18:46:58 +08:00
suzmii	576786324f	编辑标签面板回传落盘原值：堵住「只改标签」静默改分类 ... - 新增 `gameCreationAppAssetPersistedCategory`：写回口径，只做「缺失或非法 → 按 kind 派生」兜底，不套用读时自愈；它必然等于 Rust 反序列化后的落盘 `category` - `ResourceClassificationPanel` 的分类初值从 `gameCreationAppAssetCategory`（读显示口径、会把落盘 `unclassified` 自愈成派生值）改为 `gameCreationAppAssetPersistedCategory`，保存时回传落盘原值 - 修掉真机上「同一 `kind:"ui"` 资产同时存在 55 条 `unclassified` 与 2 条 `ui-interaction`」的漂移签名——后者正是自愈值被回写持久化的结果 - 面板注释更正：原注释写「保证『只改标签』不会顺带改动分类」，但那行读的是自愈后的值，这个保证是假的 - `gameCreationAppAssetCategory` 的文档补上「这是读显示口径，回写必须用 `gameCreationAppAssetPersistedCategory`」，避免下次再混用 - 新增面板用例「保存标签不改动落盘 category：自愈值不得被回写」：夹具 `{kind:'ui', category:'unclassified'}`，断言写入命令收到的 `category` 仍是 `unclassified` - 既有面板夹具 `{kind:'character', category:'character'}` 是自愈 no-op，永远测不出漂移，因此保留它作为对照、另加自愈夹具 - 新增契约用例「写回口径保留落盘 unclassified，读显示口径才自愈」，把两个口径的差集钉死	2026-09-11 18:45:38 +08:00
suzmii	458a65cb5e	资源分类读显示口径下沉到 Rust：Agent 投影与 UI 同构 ... - 新增 `game_creation_app_asset_effective_category`：读显示口径的唯一实现——落盘 `category` 权威，仅在落盘值为 `unclassified` 且该资产 `kind` 能派生出明确的非 `unclassified` 分类时采用派生值，其余信任落盘值 - `GameCreationAppAssetManifestEntry` 的反序列化刻意不做自愈：反序列化结果就是落盘原值，「编辑标签」面板要靠它原样回写；自愈只属于读显示口径 - Agent 资源投影 `bridge_registered_resource` 不再直接透传 `asset.category`，改走有效分类，修掉真机 122 条资产里 55 条「UI 显示 UI 交互、Agent 读到待归类」的跨端口径分歧 - 新增 Rust 决策矩阵 `EFFECTIVE_CATEGORY_CONTRACT` 与用例 `asset_effective_category_follows_the_shared_contract_matrix`，矩阵是「落盘值 / kind 派生 / 读时自愈」三个口径的唯一真源 - 新增跨语言契约：`assetKindCanonicalMapping.test.ts` 解析 Rust 源码里的决策矩阵与 canonical kind→栏目表，逐条喂给 TS `gameCreationAppAssetCategory` 对照，任一侧改口径都会红 - `direct_tool_bridge` 新增 Agent 侧回归用例：`kind:"ui" + category:"unclassified"` 必须投影成 `ui-interaction` - 既有用例 `..._projects_manifest_classification_verbatim` 更名为 `..._keeps_explicit_manifest_classification`：逐字透传只在落盘值不是 `unclassified` 时成立，旧名字会与新的有效分类语义矛盾	2026-09-11 18:43:39 +08:00
suzmii	c527c19bf8	校准 DirectProject 历史兼容口径的技术方案与共享决策记录 ... - 技术方案：把「不迁移旧 {role,content} 行 / 不会对旧格式做迁移或兼容」改成当前状态——读侧白名单兼容 legacy 行（含 tool 行只识别不注入）、写侧 DirectProject 自己的旧行写点已收口 - 技术方案：修正「Rust 是该历史文件的唯一写入方」，写清 project.jsonl 同时被通用对话链（agent_id=None 的项目主对话与 Runtime 公开状态消息）读写，并记录两条链互读兼容的规则 - 技术方案：说明为什么故意不给通用对话写入器加「Direct-owned 就拒写」的硬报错（会把旧行噪声换成任务起不来），以及这类失败为何按不可重试处理 - 技术方案：更新时间改 2026-09-11 - decision-log：新增 2026-09-11 条目，记录格式切换当年「唯一写入方 + 测试手动清理」的前提在存量用户项目上不成立、现改为「读侧白名单兼容 + 写侧统一」，以及为什么不做数据迁移	2026-09-11 18:36:29 +08:00
suzmii	2b44b62599	DirectProject 历史格式类失败给出专门提示并按不可重试处理 ... - direct_runtime.rs：新增 direct_project_history_shape_failure 白名单（历史记录类型无效 / 缺少 payload / 解析历史失败） - direct_codex_failure_recovery_hint 增加专门 hint，指向真实现象与动作：该类旧格式已被读侧兼容，仍失败说明记录不在白名单内，请检查项目诊断后修复该历史文件 - direct_codex_failure_is_retryable 对该类失败返回 false，前端不再显示「可直接重试」（同一份历史每次读得到同一结论） - 打开/读取类 IO 失败不在白名单内，仍按可重试处理 - 补断言：hint 文案、IO 失败边界、诊断 message 里的 retryable=false 与 sidecar 的 "retryable": false	2026-09-11 18:36:19 +08:00
suzmii	5ac26b99c9	显式 Codex 返回不再往项目主对话投影旧格式行 ... - direct_tools_mcp.rs：删除 conversation.record_codex_response 末尾往 project.jsonl 追加 legacy 行的投影，它写的是 {schemaVersion:game-creator-conversation.v1,...} 旧行，会毒化共用该文件的 DirectProject 历史 - 顺带删掉只为那条投影存在的 key/message_id 计算与描述它的注释，不留墓碑 - 该工具的事实来源仍是自己的只读 journal .agent/conversations/codex-responses.jsonl，返回内容与 conversation.list/read 行为不变 - 补断言：record_codex_response 只写 codex-responses.jsonl，project.jsonl 保持为空	2026-09-11 18:36:16 +08:00
suzmii	f0d5687ab7	共享的 project.jsonl 让两条对话链互读对方的行，混合历史不再双向失败关闭 ... - project/conversation.rs：read_persisted_local_conversation_records_unlocked 跳过 type=response_item 且带 payload 的行（DirectProject 写给同一份「项目主对话」的行），其余解析失败仍按「解析对话记录失败」失败关闭 - 新增 is_direct_project_history_row 做行信封白名单，只认对方那一种明确枚举的形状，不放宽成「什么都跳过」 - 不把 response_item 行二次投影成 LocalConversationMessageRecord：DirectProject 侧已经拥有那份 Responses item → 聊天内容的投影，再造一份平行投影会与它漂移 - 不加「文件已属于 DirectProject 就拒绝追加旧行」的硬报错：runtime_driver/task_start.rs 在 ensure_..._accepted_public_status_at 返回 Err 时会中止后台任务（「后台任务启动确认落盘失败，任务未执行」），runtime_protocol/steering.rs:572/604/1300 也用 ? 上抛，加硬报错会把旧行噪声换成任务起不来；毒化本身已由读侧白名单堵住 - 补断言：混合文件里通用链只读自己的 legacy 行且坏行仍失败关闭、混合文件从两条链都能读（DirectProject 把两种行都读出来）、纯旧格式文件的写入行为不变	2026-09-11 18:36:07 +08:00
suzmii	bfb928295e	DirectProject 读侧白名单兼容格式切换前的旧行，存量项目不再全部读不动 ... - direct_project_history.rs：两处行信封判定收敛到 direct_project_history_item_from_parsed_line，response_item 与白名单化的 legacy 行走同一条判定路径 - 新增 direct_project_legacy_row：只认 schemaVersion=game-creator-conversation.v1、无 type、role 落在该写入器自己的角色集合（user/assistant/tool）内、content 为非空字符串的行，其余形状继续按损坏失败关闭 - user/assistant 旧行投影成与 direct_project_local_message_item 同形状的 message item：role 与 content 逐字节保留、不 trim、不改写、未知字段忽略，有 messageId 才带 id - tool 旧行已识别但不进 Codex 上下文：它不是 Responses item，无法还原成真正的工具 item，混入会造出假的工具消息；聊天投影本来也只展示 user/assistant - 抽出 direct_project_message_item 供本地补写与 legacy 投影共用，保证两种来源的 item 形状一致 - 补断言：旧行投影（role/content 逐字节、无 messageId 时无 id）、旧行与新行交替的混合文件按行顺序读取、tool 行被识别且不进上下文、非白名单异常行（role=system/developer、content 非字符串或为空、缺 role、缺 payload、坏 JSON）仍失败关闭、通用对话写入器产出的旧行形状落在白名单内 - 变异验证：去掉 legacy 兼容分支→投影/混合文件/通用写入器形状 3 个用例变红；把白名单放宽成「任意行都接受」→失败关闭用例变红	2026-09-11 18:35:26 +08:00
suzmii	f5b381dbd8	视图切换时只取消上一视图排队中的可见性预取 ... 用户离开某个视图后，继续为它排队读图没有任何收益，而这些排队的预取会**排在新视图按需请求的前面**（3 槽跨视图共享），把"进入总览后等图"变成纯等待。这是"进总览要等图"的主因，单张读取本身只有 5–15ms。 - `cancelQueuedVisiblePrefetches()`：只下掉**还在队列里**的 `visible` 理由任务。语义边界刻意收窄 —— - `detail` / `play` 理由的排队**保留**； - **在途请求不打断**（只占 3 槽中的 1 个，打断它拿不回已花的读盘成本，且切回来要重读）； - **缓存与身份不失效**（不触发 `disposeAllCachedPreviews`），切回原视图不重读已拿到的图。 - 修法 4 一并收口：视图切换 effect 在取消后**立即按几何复核一次**（`sweepVisiblePreviews`），仍然可见的卡重新入队、不可见的自然不再请求 —— 因此不存在"取消后永不重试"的死角。 - 依赖使用**派生后的** `prefetchScopeKey`（不是可能为 `undefined` 的 `input.prefetchScopeKey`）。这修掉了本轮自查发现的一个真 bug：早期写法在调用方未传该 prop 时直接 `return`，整段取消逻辑成了**永不执行的死代码**；由下面的断言暴露。 断言（`tests/useProjectResourceCardPreviews.test.ts` 新增 2 条）： 1. 「切视图只取消上一作用域排队中的可见性预取」：登记 6 张（3 在途占满槽 + 3 排队，其中 1 张为 `detail`），切视图后断言队列从 3 → 1、**留下的正是 `detail`**、且 `activeReadCount` 仍为 3（在途不被取消）、新视图 identity 立刻可用； 2. 「取消后再次可见会重新入队」：切走再切回，卡片重新注册且几何可见后，断言该卡**重新进入队列** —— 直接守住"不留永不重试死角"这条硬要求。 变异验证：把取消那一步去掉（effect 内只保留复核）→ 第 1 条断言立即失败（`expected [ …(3) ] to have a length of 1 but got 3`）；恢复后 24/24 通过。 验证（同一时刻、同一命令的前后对照；当时树上有并发改动：`src-tauri/.../direct_project_history.rs`）： - 改动前（只 stash 我的两个文件）：`86 files / 1236 passed / 4 skipped / 0 failed` - 改动后：`86 files / 1238 passed / 4 skipped / 0 failed`（多出的 2 条为本提交新增用例） - `src/components/image-editor` 1387 passed；typecheck exit 0；check:encoding 4388 文件；prettier 与 eslint 干净；`git diff --check` 干净。	2026-09-11 17:55:22 +08:00
suzmii	8edee9eef4	预览队列改为同级裁决：当前预取作用域优先，但不越过 play ... 背景：全局 3 槽跨视图共享，而 hook 的 scopeKey 只含 `projectPath + projectId`（不含视图）。用户在栏目页滚一遍会按可见性入队最多 51 个预览 job；点「回到资源总览」时它们仍排在同一个队列里，总览自己那几张「该出图」的卡只能排在后面 —— 这就是「进总览要等图」的真实来源。 - `nextPreviewJob` 改为两级裁决：**理由优先级固定 `play > detail > visible` 不变**，只在**同一理由内部**让当前预取作用域的请求优先。 - ⚠️ 早期写法用「作用域匹配则权值 +3」，会让当前视图的 `visible` 压过上一视图的 `play` —— 直接破坏 PRD §3.3.2 的固定调度优先级。这个错误是被本提交新增的契约用例抓到的，已改为同级裁决，并把该约束写进函数注释。 - 新增 `prefetchScopeKey`：优先取调用方显式传入的值；未传时退化为**被喂进 hook 的资源集合签名**，因此调用方（`index.tsx`）无需改动即可生效。 - 队列任务记录入队时的 `prefetchScopeKey`，供同级裁决使用。 - 新增只读 `previewQueueSnapshot()`：暴露「谁在排队、属于哪个预取作用域、当前活动读取数」。队列病理此前只能靠猜，有了它「当前视图的卡是否真的进了队列」可直接断言。不参与渲染、无副作用。 断言（`tests/useProjectResourceCardPreviews.test.ts`）：新增「当前预取作用域越过上一作用域的排队预取」契约用例，三条： 1. 当前作用域的 `visible` 越过上一作用域排队的 `visible`； 2. **但不得越过 PRD 优先级** —— 当前作用域的 `visible` 仍排在 `play` 之后； 3. 同一作用域内仍是 `detail > visible`。 变异验证：把作用域偏好关掉（`&& false`）→ 第 1 条断言立即失败（`expected 'previous' to be 'current'`）；恢复后 22/22 通过。断言不是恒真假守卫。 验证：typecheck exit 0；该测试文件 22 passed；check:encoding 4388 文件；`git diff --check` 干净。（AGC 全量与本条无关的并发改动混跑，故此处只报本文件的定向结果；全量对照见后续提交的回报。）	2026-09-11 17:44:21 +08:00
suzmii	a4bec3d018	记下「不再提醒」偏好保持单键、不按入口分域的理由 ... - 该键关掉的只有聊天输入区的「发送前提醒」；资源侧生成素材与快速编辑没有可关的提醒，润色是显式按钮动作 - 分域只在「每个入口都有可关的提醒」时才有意义，现在分域等于给不存在的提醒提前留位 - 只补注释，不改行为与断言	2026-09-11 17:06:35 +08:00
suzmii	327a5d38ee	同步验收文档里 #309 C3 的口径与两条入口的润色判据 ... - S9 行与 7.4 差异表补一句：只读信息浮层已回归（工具条「信息」动作），C3 取消的仍只是可编辑详情面板与全屏编辑路由 - S10 / S11 行补上两处入口的「AI 润色」判据：按钮 aria-label 与 aria-busy、成功回填与「恢复原文」、失败保留原文、超类型上限截断并提示「已按长度上限截断」 - 纯文档改动，不动代码与断言	2026-09-11 17:03:04 +08:00
suzmii	c2d3292769	快速编辑浮层接入提示词润色，提示词变了就重铸请求身份 ... - 选中工具条的快速编辑面板通过共享 composer 的注入位渲染同一个 ResourcePromptPolishSlot，场景约束为「图片素材的快速编辑提示词」 - 润色回填走 applyResourceQuickEditPrompt：与共享 composer 的 resetFailedDialogStatus 同口径，提示词变了就把上一次的失败状态清掉 - 提交侧请求身份按提示词收口：同 sourceLayerId 且提示词未变时复用（失败重试仍命中同一 operation 账本），提示词变了则重铸 operationId / 幂等键——Rust 的 request_fingerprint 含 prompt，复用旧身份会被判「已绑定到不同资源编辑请求」；正规化结果与 revision 属于别的事实，换身份时原样保留 - 打开面板时的初始身份改用统一的 createResourceEditRequestIdentity（绑定面板草稿提示词） - 测试：live integration 补两条——润色成功回填并换身份（断言 prompt 与 operationId/幂等键同时变化）、润色失败保留原文且身份不变 - 变异验证：提交侧去掉按提示词重铸（同 sourceLayerId 直接复用旧身份）→ 「润色后换身份」用例红灯（两次 operationId 相同，实测）	2026-09-11 17:02:17 +08:00
suzmii	d44e1ae8ea	生成素材弹窗接入提示词润色，并让请求身份绑住它铸造时的那句提示词 ... - 新增 ResourcePromptPolishSlot：素材侧两处入口共用的「AI 润色 / 恢复原文 / 润色中…」动作，取数走 AGC 侧 usePromptPolish，聊天框同款失败态（失败保留原文、可重试文案） - 场景约束走 polish_local_project_prompt 的 context：「这是素材生成提示词（音效）」+「只润色这一句、不要扩写成需求/方案/验收标准、不要新增事实」（本批不动后端提示词文件），文案落在 resourceCanvasPromptPolishModel - resourceEditModel 新增 truncateResourceEditPrompt：超上限先按类型截断（背景音乐 140 / 音效 1900 / 视频与角色动画 4000 / 其余 32000）再回填，并在状态行给出「已按长度上限截断」，不静默丢内容；后端上限未改 - resourceEditModel 新增 resolveResourceEditRequestIdentity：请求身份绑定到铸造时的 prompt（Rust request_fingerprint 含 prompt，改了提示词还复用同一 operationId 会被判「已绑定到不同资源编辑请求」）；提示词没变时仍复用，失败重试照旧命中同一账本 - 生成素材弹窗用注入位渲染润色动作（共享 composer 只提供插槽，不上 Tauri 调用），提交时按同一口径解析身份；原先只在这一处使用的 createResourceCanvasGenerationRequest 随之下线 - 样式落在 resourceCanvasChrome.css（resource-prompt-polish 一族），弹窗与 composer 共用一行 - 测试：模型层补截断边界与身份复用/重铸；弹窗层补润色回填与上下文、超限截断提示、失败保留原文、失败后提示词与润色一起锁定且重试复用同一请求 - 变异验证：截断改成恒等 → 模型用例与「超限截断」用例双双红灯（实测字段长度 206 ≠ 140）；身份去掉重铸 → 模型用例红灯	2026-09-11 16:58:49 +08:00
suzmii	62029fdc23	给共享生成 composer 加一个可选的提示词动作注入位 ... - ImageCanvasBasicGenerationComposerView 新增 promptActionSlot（可选）：不传时整块不渲染，默认 DOM 与行为逐字不变 - 注入位紧跟在提示词输入框之后，节点由宿主提供并自己负责在 composer 网格里的落位；共享组件内不做任何 Tauri 调用 - ImageCanvasQuickEditPanelView 原样透传该 prop，网页端两条调用链不传即不受影响 - 测试：composer 与快速编辑面板各补一条「不传时无占位节点、传入时落在提示词之后」，默认不变由既有用例继续覆盖	2026-09-11 16:54:57 +08:00
suzmii	25c55fcb7f	把提示词润色的状态机抽成 usePromptPolish，聊天输入区先迁过去 ... - 新增 features/project-workspace/usePromptPolish.ts：失败保留原文、首次成功落原文快照（反复润色只覆盖结果）、可重入保护、可注入的上下文与规范化回调，Tauri 调用固定在 AGC 侧（默认 requestChatPromptPolish） - 聊天输入区改用它，行为逐字不变：润色按钮 aria-busy/disabled、Loader2/Sparkles、「润色中…」/失败文案、失败保留原文、恢复原文回到最初原文、草稿清空后重置 - 聊天特有的「发送前提醒」留在输入区：提醒偏好、本轮已确认草稿指纹、表单捕获拦截、面板内润色用另一句失败文案 - chatPromptPolish.ts 的 requestChatPromptPolish 及其单测未改动，继续作为这条 LLM 通道的契约测试 - 护栏：chatPromptPolish.test.tsx（16 条）与 resourceReferenceInput.test.tsx（20 条）全绿	2026-09-11 16:53:33 +08:00
suzmii	3de2ec734b	预览门禁去掉单点依赖：observer 必定建出，并加可见性兜底扫描 ... 真机现场：整个「UI 交互」栏（51 项）全部只剩占位图标。根因链是**同一对文件里的两个缺陷叠加**，因此作为一个原子提交收口（拆成两半任一半都不足以独立成立：光修 observer 仍可能被回调时序漏掉，光加扫描则 observer 根本不存在时的判定精度无从恢复）。 一、确认 2a157ea6f 引入的回归：observer 可能永远不建 - 那次改动把「root 为 null」当成「不建 observer」，并指望「卡片注册」作为 root 就绪信号重建。 - 但那个 effect 每个 scope **实际只跑一次**（`requestPreview` 是稳定引用，其余依赖在 scope 内不变），一旦这一轮因 root 为 null 直接返回就再无第二次机会； - 而「卡片注册」信号只在**后续还有新注册**时才来 —— 初次挂载时 51 张卡一次性注册完，之后再没有新注册，信号永不再来。 - 结果：observer 永不创建、所有卡永不被观察、永远停在 `idle`，整栏只剩占位图标（`categoryIcons['ui-interaction'] = LayoutGrid`）。 - 修复：**绝不拿"root 未就绪"当作"不建 observer"的理由**。拿到容器 root 最好；拿不到就退到 canvas、再退到视口（`root: null`）。视口判定严格优于"没有 observer"——屏幕上真实可见的卡一定落在视口矩形内；代价只是视口外但仍在画布内的卡晚一步由滚动触发。容器 root 迟到时再有界重试（5 次、退避到 512ms）重建一次，恢复按画本容器裁剪的精确判定。 二、系统性防线：可见性兜底扫描（去掉单点依赖） - 门禁原先只有 `IntersectionObserver` 一条路，observer 没建出来 / 回调没送达 / 注册与创建交错，卡片就再无第二次机会。 - 新增 `sweepVisiblePreviews()`：按**与 observer 对齐的视口几何判据**（含 160px 余量）独立复核登记表，只对 `idle`（从未请求）的卡补一次 `visible`，`loading`/`queued`/`loaded`/`failed` 一律不碰。 - **不是第二条加载通路**：仍经 `requestPreview` 走同一条队列，受同一套去重、优先级、全局 3 槽与 `48` 项 / `64 MiB` 预算约束；**只补"可判定为可见"的卡，不退化成全量预读**（PRD §3.3.2 合同不变）。 - 触发点：scope 变化后 0 / 250 / 1000ms 各扫一次（覆盖晚挂载的卡）、observer 就绪后立即扫一次、每次卡片注册时扫一次、窗口 resize 与页面重新可见时各扫一次。 测试（`tests/useProjectResourceCardPreviews.test.ts`） - 更新「等真正的 root 就绪」这条契约：它原先断言"root 为 null 时不得建 observer"——那正是本轮回归的语义，改为断言"**仍然必须建出 observer**（`root: null` 视口判定）"，并要求容器 root 迟到后重建为容器 root； - 新增「不在热预取窗口内的可见卡不得停在 idle」（20 张 / 热预取 12）； - 新增「没有任何 observer 回调时，可见卡也必须被放行」——完全不触发回调，只靠几何可见性，专门守住兜底扫描； - 新增「视口外的已登记卡不得被请求」——守住"不退化成全量预读"。 变异验证：把兜底扫描改成直接 `return 0`（等价于去掉扫描）→ 「没有任何 observer 回调时可见卡也必须被放行」立即失败（`expected undefined to be 'loaded'`）；恢复后 21/21 通过。断言不是恒真假守卫。 可观测性：`data-preview-status` / `data-preview-error` 已在位，因此"可见却 idle"这类问题以后读一个 DOM 属性即可判定，不再需要解码图片或猜调度。 验证（同一时刻、同一命令的前后对照；树上另有并发改动）：改动前 `86 files / 1225 passed / 4 skipped / 0 failed`；改动后 `86 files / 1227 passed / 4 skipped / 0 failed`（多出的 2 条为本提交新增用例）。`src/components/image-editor` 1385 passed；typecheck exit 0；check:encoding 4384 文件；prettier 与 eslint 干净；`git diff --check` 干净。	2026-09-11 16:49:09 +08:00
suzmii	e088ede217	让「当前使用」的资源卡真的发光，并修掉版本高亮的两处既有缺陷 ... - .game-resource-card.is-current-version 的外向扩散层从 0 0 0 2px /14%（那是描边）改成 0 0 0 3px /32% + 0 0 20px /34% 的真发光，边框口径仍是 1px - 新增 game-resource-card-current-version-breathe 关键帧与 ::after 光环（只呼吸 opacity，照本页 .ui-editor-status-attention 的既有写法）：声明档位 38%，呼吸区间 0.58 ↔ 1，视觉上约 22% ↔ 38% - prefers-reduced-motion 下关掉动画但保留可见档位（opacity 0.75），收敛动画不收敛可见性 - 缺陷①：.game-resource-card.is-relation-version-binding 原本只写 border-color，而卡片本体 border: 0，规则从未生效（「点击版本卡后高亮绑定资源」这条 PRD 语义一直看不见）；改为真实的 1px 边框 + ring，并把该规则移到 .is-current-version 之前，让常驻光环在两者同时命中时仍然赢 - 缺陷②：当前版本规则与 hover/focus/selected 同权重且在后，导致当前版本卡几乎看不出被选中；新增 .is-current-version.is-selected / :hover / :focus-within / .is-dragging 变体，显式提权到 (0,3,0) 并带上选中态自己那层阴影 - 测试：新增 resourceCardCurrentVersionStyle.test.ts（外向扩散层档位、呼吸实现方式与关键帧区间、选中态变体权重更高、reduced-motion 下仍可见、版本聚焦规则不再是死规则） - 测试：resourceVersionSwitch 补 data-used-by-current-version 的 DOM 断言（命中为 "true"、未命中不含该属性、切版本后跟着换手） - 测试夹具修正：project-development.suite 的版本夹具把 slotId 从 'player' 改成恒等映射 'asset:asset-player'（'historical' → 'asset:asset-removed'），否则「当前版本」判定永远不命中、照它写断言必成假守卫；并补一条自证断言钉住它真的命中	2026-09-11 16:42:58 +08:00
suzmii	082d8d62de	把运行页签的资源信息搬到画布选中工具条，两处共用一份只读字段 ... - 新增「信息」动作：排在「@引用」之后、「编辑标签」之前，点开非模态信息浮层，再点一次即收起（aria-pressed 反映开合） - 新增只读字段组件 ResourceInfoFieldsView（ResourceInfoPanelView.tsx），运行页签的「信息展示」与画布浮层共用，字段清单只在 resolveResourceInfoFieldRows 单点定义 - 字段口径：名称 / 路径 / 类型 + 只读分类与标签（分类取画布栏目口径，标签为空时给「暂无标签」），刻意不含来源任务、资产 ID 等 manifest 内部标识 - 浮层 chrome 与快速编辑浮层同族（同一锚点、同档圆角与阴影），样式落在 resourceCanvasChrome.css；关闭入口三处：动作按钮、面板关闭按钮、画布浮层统一的 Esc / 点边界外 - 关闭判据收口：resolveResourceCanvasQuickEditDismissOpen 更名为 resolveResourceCanvasFloatingPanelDismissOpen、参数改为 isFloatingPanelOpen，宿主把「快速编辑开」与「信息开」合成一个布尔 - .game-resource-info-panel 补进 RESOURCE_CANVAS_INTERACTION_SELECTOR，否则点在只读字段值上会被判成点画布空白而清掉选中 - 换选 / 清空选中 / 切项目时信息浮层自动收起：在选中派生处按 selectedResourceId 收口，不在每个重置点各补一行 - 测试：新增 resourceCanvasInfoModel 三条与「信息面板在画布浮层与运行页签里渲染同一份只读字段」（工具条顺序、开合、关闭按钮只收面板、点画布以外收起、Esc 连工具条一起收、运行页签字段逐行相同）；resourceCanvasFloatingDismiss 的判据用例与交互选择器夹具改为浮层通用口径 - resourceCanvasChrome.css 的字段排版收在浮层选择器下，不跨上下文改运行页签的字号与列宽 - decision-log 新增一条：记录这次对 Issue #309 C3「取消资源详情面板」的有意局部回退（只回退「看信息」，不恢复可编辑详情面板与全屏编辑路由），并登记需要同步的 C3 引用位置	2026-09-11 16:42:40 +08:00
suzmii	d80011656b	把资源卡的 @ 引用入口挪进选中资源工具条 ... - 删除资源卡右上角的 @ 引用圆钮，连同它的 44×44 热区伪元素与全部样式一起退役 - 选中资源的画布工具条新增「@引用」动作，排在「UI 编辑器」之后，出站负载与来源逐字未变（source: 'resource-card'） - 测试：原「卡片圆钮视觉尺寸」用例改写为「入口只留在工具条里」的源级 + 样式级断言，并补反向断言卡片组件内不再出现插入调用 - 测试：新增键盘通路用例，聚焦后回车必须真正派发 agc-resource-reference-insert，且两条通路负载逐字相同、每次激活只派发一次 - harness 注释同步：资源卡本体只剩「选中资源」与媒体播放钮	2026-09-11 16:28:48 +08:00
suzmii	3bfc3f0849	新增 AGC 资源工作台 V3 端到端验收用例 ... - 新增 docs/technical/【测试用例】AGC资源工作台V3端到端验收-2026-09-11.md - 给出从建项、对话生成素材到运行收尾的一条主线，按 S1–S21 分步列出操作、期望结果、对应 PRD 条款、可观察判据与已知例外 - 落定每步的可观察形态：资源卡 data-preview-kind / data-preview-status / data-preview-error、data-used-by-current-version、data-resource-book-category、data-resource-view-state 与控制台判据脚本 - 记录前置条件与门禁口径：dev 态前端走 Vite HMR、Rust 侧改动需重启客户端、服务端改动需重启 api-server、build-gate 代理假红需清代理变量 - 列出只靠视频或截图表达的 7 处条款清单与补齐方式，并更正 F12 无法观察 Rust 到 api-server 的 HTTP 这一前提 - 列出已知未做与已取消项，以及文档与代码的四处偏差（资源卡打开详情按钮、运行入口提示文案、画布生成入口进度、真机落盘分类分布） - 附验收记录表与逐步骤失败排查索引	2026-09-11 15:45:01 +08:00
suzmii	5bf348d88a	把误入上一个提交的验收文档移出提交，交回其作者 ... - 81482b458 原本只应包含 tests/appSurface/project-development.suite.ts 一条断言同步， 但该验收文档当时已被预置在索引里，随那次提交一起被带走；这里只做「移出提交」， 不改动文档内容，文档仍完整保留在工作区，由它的作者自行提交 - 未使用 --amend：按纪律不改写已有提交	2026-09-11 15:42:24 +08:00
suzmii	81482b4587	同步「编辑标签」入口文案的既有断言 ... - tests/appSurface/project-development.suite.ts：跟随 6bdc8bbd9 把资源卡工具条入口由 「分类与标签」改为「编辑标签」，同步音频资源工具条那条既有断言（否则 HEAD 的树是红的） - 同一处注释同步说明：该面板只编辑 manifest `assets[].tags`，分类不再有手动入口	2026-09-11 15:41:17 +08:00
suzmii	ea9668e4a9	资源总览「所有资源」卡补上资源预览 ... - 现象与归因：「所有资源」卡的预览区一直是空的，原因是我在 1cc9a2381 里加的闸 `!isResourceBookAllTarget(category)`（当时为避开"同一张资源卡挂两份"）让它一张卡片计划都不生成；预览卡从来只由画本场景注入，占位摞本身不含卡片 - 改为真正生成卡片计划：喂进去的仍是全量投影（与标题栏计数徽标同一份口径），但当成一摞交给栏目卡同一个选取函数 `selectResourceBookOverviewCards`——没有视图中心时按投影顺序取前 `RESOURCE_BOOK_OVERVIEW_STACK_LIMIT`(=3) 张，与栏目卡每摞上限同口径；不分类型列，避免 66 项一口气铺出十几列 - 预览用同一个 `renderCard` 与同一套 `resourceBookOverviewCardLayout` 几何渲染，唯一差别是宿主类名换成 `.game-resource-book-preview-card`：转场层按 `.game-resource-book-scene-card` 收集 FLIP 节点并以 `card:${resourceId}` 为键，同一张卡两个宿主会让两条记录互相顶掉，因此预览宿主不进收集范围（`resourceBookController` 一行未改） - 预览宿主带 `aria-hidden` + `pointer-events: none`：无障碍树与 `getByRole` 里每张资源卡仍然只有栏目卡那一份，不会重复命中；点预览区仍走进「所有资源」页，栏目卡预览卡仍可选中 - 转场淡出集合（`resourceBookPlanKeysRef` 那段）跳过「所有资源」组，避免预览节点被当成"离开视图的卡片"按子画布坐标重新贴到画布别处 - `ResourceBookThumbnail`：该卡正文的占位摞从最多 3 摞改为对齐真实摞数的 1 摞，卡片高度回到与栏目卡同一条口径 - `styles.css`：把 `.game-resource-book-preview-card` 并进 `.game-resource-book-scene-card` 的两条既有规则（宿主几何、主态卡片圆角/阴影）与 `prefers-reduced-motion`；没有新写一套预览样式 - 断言（`project-development.suite.ts`）：预览卡的 `data-resource-card-id` 序列恰等于全量投影前 3 个、条数 == `min(3, 计数徽标)`、预览里是完整卡片（视觉体 + 选中按钮）、宿主在 `aria-hidden` 子树里、宿主几何规则与栏目卡共用同一条 - 断言（新增用例）：空项目下沿用既有空态「暂无资源」、预览节点 0 个、计数 `0 项`、入口行仍在，卡片不破版 - 单测（`resourceBookLayout.test.ts`）：把已被新行为取代的旧断言（`all` 组不出卡片、全计划无重复卡片键）删掉，换成新合同（预览 = 全量投影前 3 张、只铺一列、各栏目摞不变），并补空投影 → 0 张 - 变异验证（两条都跑过并已还原）：① 喂进去的资源改回空数组 → `AssertionError: expected +0 to be 4`；② 恢复旧闸（计数仍正确、预览为 0）→ `AssertionError: expected [] to deeply equal [ Array(3) ]`	2026-09-11 15:37:17 +08:00
suzmii	6bdc8bbd93	AGC 资源分类面板改为「编辑素材标签」：只编辑标签、分类不再有手动入口 ... - ResourceClassificationPanel.tsx：面板改为只编辑 manifest `assets[].tags`，移除分类 6 类 chip 那一排；标题与 aria-label 改「编辑素材标签」，副标题由资源路径改为素材名 （`localPath` 的 basename，仓库没有独立显示名字段） - ResourceClassificationPanel.tsx：标签状态由「整段逗号分隔字符串」改为字符串数组， 每个已有标签渲染成自带删除按钮的胶囊 pill；保存时把未落成 pill 的输入尾巴一并切分， 归一化仍走 `normalizeGameCreationAppAssetTags`，回车 / 中英文逗号 / 顿号提交方式不变 - ResourceClassificationPanel.tsx：写入命令 `category` 是必填，读一次当前权威值并 在保存时原样回传，保证「只改标签」不漂移分类；底部按钮「保存」改「保存标签」， 删除资源入口按既有保留（截图未画，但它是唯一的资源删除入口） - resourceClassificationTagPanel.css：新增标签 pill 样式，删除按钮嵌在 pill 内部 （视觉图标 11px、热区 32×32、负外边距抵消不撑高 pill）；若第二处出现带删除按钮的 标签 pill，抽到 `packages/shared` 做 `PlatformRemovableTagPill`，不要复制这份实现 - index.tsx：资源卡工具条入口 label / title / 文案由「分类与标签」改「编辑标签」， 与面板标题一致（否则入口写着分类、打开的是纯标签面板） - tests/resourceClassificationPanel.test.tsx：断言对齐截图文案、逐个 pill 自带删除、 点某个 × 只删对应标签、aria-label 可区分、保存 payload 的 tags 数组与 category 原样回传、 取消不写盘、入口 label 与面板标题一致、删除热区不小于 32px - 文档：PRD §5.3「分类取值优先级」改写为当前状态（分类没有用户手动设置入口、 该面板只编辑标签），并新增 decision-log 条目记录本次产品决策与「用户手动设 category 的能力就此移除」这一事实 - 说明：截图文案（编辑素材标签 / 新增标签，多个用逗号分隔 / 保存标签）在全仓检索 无命中，属仓库之外来源，本次按用户截图对齐，不是 PRD 明文	2026-09-11 15:34:36 +08:00
suzmii	2a157ea6f8	预览可见性门禁等 root 就绪再建 observer，并把登记表补挂齐 ... 真机现场：同一屏里 `idle` 与 `loaded` 交错，12 张相交卡从未入队（`idle` 的语义就是「从未请求」，不是被淘汰回退）。根因在 observer 的**创建时机**：`useProjectResourceCardPreviews` 建 IntersectionObserver 时把 `intersectionRootRef.current ?? canvasRef.current` 直接当 root 传下去，而 root 是资源画本容器、由被观察卡片所在的子树持有。创建那一刻 root 还是 `null` 时，浏览器会**退回按视口判定**，于是被画本容器裁掉的卡片永远报「不可见」，可见性门禁再也不放行它们 —— 卡面只剩占位图标，且没有任何错误提示。 - `useProjectResourceCardPreviews`：root 为 `null` 时**不建 observer**，等 root 就绪后由卡片注册触发的 `rootEpoch` 重建。判据是「卡片一定渲染在画本容器内部」，所以**有卡片注册本身就等价于 root 已就绪**，不需要新增跨组件契约、也不必改 `index.tsx`。 - 新增 `attachObservedCards()`：observer 就绪或重建后，按登记表把**每一张已注册卡片**补挂一遍。此前只在新 observer 创建时补挂一次，注册与创建分属不同 effect 存在时序窗口，错过那次补挂的卡会停在登记表里却从未被观察。 - root 未变且 observer 已在时只补挂、不重建，避免每次渲染重建观察器。 - `observePreview` 在没有 `IntersectionObserver` 的环境（如单测）保持静默，不制造多余渲染。 测试（`tests/useProjectResourceCardPreviews.test.ts` 新增 3 条契约）： - 「不在热预取窗口内的可见卡不得停在 idle」：注册 20 张、`eagerPreviewLimit: 12`，断言注册进 observer 的元素数等于注册数、回调报可见后全部落 `loaded`、且没有一张停留在未请求状态； - 「等真正的 root 就绪后再观察并加载」：root 首次为 `null` 时**不得建 observer**（否则按视口判定），注册后必须以真正的 root 建出来并完成加载； - 「建 observer 之前就注册的卡要被补挂」：断言 observer 就绪后登记表里的每一张都在观察集合内，且报可见后全部 `loaded`。 变异验证：把 root 守卫退回旧行为（允许 root 为 `null` 时照建 observer）后，「等真正的 root 就绪」这条立即失败（`expected [] to have a length of 0 but got 1`）；恢复后 19/19 通过。断言不是恒真假守卫。 边界说明：只改预览 hook 与它的测试，未动 `index.tsx` / `styles.css` / `resourceBookLayout.ts`（均在他人手上），未放宽任何既有断言、未取消可见性门禁（仍是按需加载）。 验证：`npm run test -- apps/ai-game-creator-shell/tests` 84 files passed / 1216 passed / 4 skipped / 0 failed；`src/components/image-editor` 1385 passed；typecheck exit 0；check:encoding 4379 文件；prettier 与 eslint 干净；`git diff --check` 干净。	2026-09-11 15:31:29 +08:00
suzmii	39a96aa418	模型下拉菜单高度有界：健壮性补强，条目多时不再盖住消息 ... - 性质说明：本条是**健壮性补强**，不是用户本轮报的那几条之一；由上一提交（锚点修复）排查时顺手发现的未修观察收尾。 - styles.css：`.conversation-model-menu` 补 `max-height: min(240px, 40vh)` + `overflow: auto` + `overscroll-behavior: contain`。菜单此前没有高度上限，模型条目很多时会长到 composer 顶边以上、盖住消息；240px 与视口 40vh 取小者，矮窗 / 窄屏（移动端优先）更稳。`overscroll-behavior: contain` 与既有 `.resource-reference-menu` 同一口径，菜单内滚动不传染给背后的消息列表。不新增视觉：border / radius / padding 与 token 全部沿用原值。 - 语义零改动：锚点与流式归属不变（`position: absolute; right: 0; bottom: calc(100% + 8px)` 未动），打开 / 选择 / 刷新模型列表的交互不变。 - project-development.suite.ts：新增声明级守卫「bounds the model dropdown height so a long catalog cannot cover the composer」——菜单规则必须同时声明 `max-height: min(240px, 40vh)`、`overflow: auto`、`overscroll-behavior: contain`，并仍是 `position: absolute`（高度有界不改锚点）。 - 变异验证（已实测）：把 `max-height` 摘掉 → 用例红灯（expected '…' to match /max-height:\s*min\(\s*240px\s*,\s*40vh\s*\)/u）。 - 门禁：typecheck exit 0；AGC 子集 1206 passed / 4 skipped / 0 failed（基线 1205 + 本次新增 1 条）；src/components/image-editor 1385 passed；check:encoding 4379 文件通过；`git diff --check` 全量与本次两个文件范围均 exit 0。	2026-09-11 14:59:42 +08:00
suzmii	4f3516a5d9	修复分类 chip 条叠字：分段页签子项补内容宽度下限 ... - packages/shared/src/components/PlatformSegmentedTabs.tsx：容器补 `platform-segmented-tabs` 稳定钩子类，供共享样式表精确命中子项（不依赖 Tailwind 任意值扫描） - packages/shared/src/components/styles.css：新增 `.platform-segmented-tabs > button` 的 `min-width: max-content`，给每个子项一个「内容宽度」下限；放不下时由容器横向滚动兜底 - apps/ai-game-creator-shell/src/view/project-development/ResourceClassificationPanel.tsx： 「资源分类与标签」的 6 类分类条由 `columns="threeToSix"` 改为 `layout="scroll"` + `frame="bare"` + `surface="transparent"`，与 `@` 面板和资源画布的分类条同一条既有形态 - packages/shared/src/components/PlatformResourceFilterBar.test.tsx：新增两条声明级断言， 钉住「子项不换行 + 容器横向可滚 + 子项有不低于内容宽度的下限」	2026-09-11 14:54:27 +08:00
suzmii	ff287c19fc	模型下拉弹层改回以触发钮为锚点，输入区高度变化不再牵动它 ... - styles.css：direct-codex 控制排里的 .conversation-model-select 由 position: static !important 改为 position: relative !important（只改这一个词，另补一段注释说明它同时是弹层锚点）。这颗容器是 .conversation-model-menu（position: absolute; right: 0; bottom: calc(100% + 8px)）与模型提示（[role='alert'] / [role='status']，position: absolute; bottom: 36px）的包含块；写成 static 时包含块回落到最近的有定位祖先——也就是 position: absolute 的 composer 盒子，菜单于是出现在整个 composer 上方、与触发钮之间隔着整个输入区，输入区一变高（多行、引用 chip、AI 润色）菜单与提示跟着往上飘：这就是"编辑框把元素挤开"的形态。 - styles.css：right/bottom: auto、flex: 0 1 auto、min-width: 0、max-width: 180px 全部保持原样——relative 不会把模型选择钮移出控制排，也不改它被压缩换行的行为；交互语义零改动（打开/选择/刷新模型、发送、@ 引用、快速模式全在原位）。 - project-development.suite.ts：新增一条声明级守卫。① 弹层不参与父容器流式布局（菜单与模型提示都是 absolute，菜单 bottom: calc(100% + …)、right: 0）；② 锚点必须是有定位的容器（relative 且不是 static），同时仍在原位（right/bottom auto、flex 0 1 auto、min-width 0）；③ 输入区高度变化不得推动同排操作元素（composer 是底边锚定的两行网格：position: absolute + bottom: 12px + grid-template-rows: auto auto；控制排是单行 flex 且不换行，@ 与发送钮 flex: 0 0 30px 不可压缩，窄屏下被压缩的是可收缩的模型选择钮）。 - conversationModelSelect.test.tsx：新增一条 DOM 守卫——菜单必须是 .conversation-model-select 的直接子节点，且不得成为控制排容器 .project-supervisor-composer-controls-right 的流式子节点。 - 变异验证（均已实测红灯）：① 锚点改回 static → "expected … to match /position:\s*relative\s*!important/"；② 菜单改成 position: static（弹层回流式）→ "expected … to match /position:\s*absolute/"；③ 把菜单渲染挪出触发钮容器（变成同排容器的流式子节点）→ DOM 守卫 "expected null not to be null"。 - 门禁：typecheck exit 0；AGC 子集 1205 passed / 4 skipped / 0 failed（基线 1203 + 本次新增 2 条）；src/components/image-editor 1385 passed；check:encoding 4379 文件通过；本次三个文件单独 `git diff --check` exit 0（全量 `git diff --check` 目前报的是另一位 Agent 在途修改的 packages/shared/src/components/styles.css:1281 EOF 空行，与本次无关）。	2026-09-11 14:53:11 +08:00
suzmii	9c4778c881	把资源卡右下角的 @ 引用按钮做小：视觉缩到 0.8×，热区保持 44×44 ... - styles.css：`.game-resource-card-reference` 视觉尺寸 30×30 → 24×24（0.8×），新加 `.game-resource-card-reference svg` 把内部 `AtSign` 图标同步从 16px 收到 13px，圆角/描边/底色/阴影 token 全部沿用原值。 - styles.css：`bottom` 由 9px 调到 14px，与右侧 34px 播放钮圆心对齐（9 + 34 / 2 = 14 + 24 / 2），避免缩小后两颗圆钮错位。 - styles.css：新增 `.game-resource-card-reference::before` 伪元素撑出 44×44 热区（本仓 window chrome / 素材选择列表同口径的最小可点尺寸），只扩命中范围、不参与布局也不改变绘制；整体向左让 4px，让热区右边缘与播放钮的盒子恰好相邻，不覆盖它。 - 语义未动：仍是「插入素材引用」入口，className、`aria-label={\`引用资源 ${resource.label}\`}`、key 与 `dispatchResourceReferenceInsert` 调用一行未改，本次只改 CSS 声明。 - 测试：新增 CSS 声明级用例，断言按钮与图标确实变小（24 < 30、13 < 16）、热区不小于 44×44、热区右边缘不越过播放钮盒子，并顺带钉住 `index.tsx` 里 @ 入口的 className / aria-label / 插入动作仍在。 - 变异验证：把按钮改回 30px、热区改回 24px、图标改回 16px → 用例红灯；只把热区缩回 24px → 用例同样红灯（均已实测，随后原样还原）。	2026-09-11 14:00:32 +08:00
suzmii	399fcacb8e	同步删除栏目大纲导航的权威文档：PRD 与技术方案改成总览卡片/所有资源/下一页口径 ... - decision-log.md：新增「删除资源画布左侧的栏目大纲悬浮导航」决策，先记录查证结论（decision-log / pitfalls / PRD / 技术方案里此前只有要求保留该导航的条文，没有任何删除决策，本次是新决策），再写决策、语义变更、不做什么与变异验证结果。 - PRD：§阶段说明与 §7.2 验收两条不再写"大纲展示全部栏目""通过栏目大纲和滚轮访问全部栏目"，改为栏目大纲由「资源总览」的栏目缩略卡片承载、切栏目走总览卡片 +「所有资源」入口 + 页内「下一页」。 - 技术方案：目标、操作边界与验收共五处删掉"栏目大纲悬浮在画布左侧/只显示图标和栏目名称""点击大纲切页""分页大纲以悬浮 Dock 展示全部栏目"等条文，改成当前状态（左侧不再有悬浮导航）。 - pitfalls.md：补记一条 jsdom 坑——栏目页 fit key 需要非零可测量尺寸，jsdom 下恒为 0，所以"总览→栏目"往返会重新适配视口；进入栏目后应恢复上次 viewport 的用例在 jsdom 里必须避免这种往返，不要误判成产品回归、也不要去改 fit 逻辑。	2026-09-11 13:54:27 +08:00
suzmii	29b99f213d	删除资源画布左侧的栏目大纲导航：切栏目改由总览卡片、所有资源入口与下一页承担 ... - index.tsx：整条删除 `ResourceBookOutlineNav` 组件（`.game-resource-outline` / `aria-label="资源栏目大纲"` / 栏目图标 + 栏目文字 + 未读红点）以及栏目页与「所有资源」页两处挂载点；`ResourceBookAllResourcesPage` 不再接收只服务导航的 `unreadCategories` / `onOpen`。 - index.tsx：一并清掉只服务这条导航的「未读红点」状态链（`unreadResourceCategoryState`、`resourceCategorySnapshotRef`、`resourceIdsByCategory`、`viewedResourceCategory` 与对应 effect），不留死代码、不留墓碑注释。 - styles.css：删除全部 `.game-resource-outline*` 规则（悬浮 Dock、常态/悬停态、图标列宽、`.game-resource-outline-label`、`.game-resource-outline-unread`，共 106 行）。 - 保留未动：分区栏目本身、栏目标题栏、资源卡、总览缩略卡片、第 0 张「所有资源」入口、「所有资源」汇总页、搜索、总览、快速编辑与选中工具条。 - 测试：切栏目 helper（appSurface/project-development、appSurface/home、resourceRename、resourceVersionSwitch）改为走「资源总览」缩略卡片（需要时先点「收起资源」回总览），不再点导航；栏目顺序断言改钉在总览缩略卡片的 `aria-label` 序列上（第 0 张「所有资源」+ 固定七栏目），断言内容未放宽。 - 测试：按「四不写」删除只守这条导航的断言——大纲常态可读性的 CSS 声明用例、大纲条目图标/文字的 DOM 用例（该用例保留其中与搜索浮层相关的断言并改名）、未读红点用例（该用例保留"只登记游戏代码的项目照常分页并落在待归类"的部分并改名）、空项目与「所有资源」页里的导航存在性断言。 - 测试：新增反向守卫 + 切栏目链路用例（`has no outline nav and keeps every section reachable through the remaining entries`）：断言 `资源栏目大纲` 标签、`.game-resource-outline` 类名与对应 `<nav>` 都不再渲染，并逐条走通总览缩略卡片（含空栏目）→ 下一页 → 标题栏「资源总览」→ 「所有资源」入口往返。 - 测试：`preserves independent art viewports across sort and workbench mode switches` 保留全部原断言，只去掉排序模式切换后那些"点当前栏目"的空操作往返（旧导航点在同栏目上是提前返回，改 helper 后变成真实往返，会在 jsdom 里触发重新 fit）。	2026-09-11 13:54:12 +08:00
suzmii	d1a3702062	记录构建版本判据与 loopback HTTP 预览方案的评估结论 ... 本轮「资源卡图片加载不出来」连续两轮按现役缺陷排查，最终发现真机数据在当前 HEAD 上判定全对、现象来自更早的客户端构建。把这次的方法教训与两条廉价判据固化成文档，避免后续重复投入。 - `pitfalls.md` 新增「用真机现象定性之前必须先确认客户端构建版本」：现象与「数据在 HEAD 上的实际判定」不一致时，第一个怀疑对象是构建版本而不是代码；两条廉价判据为真机 manifest 的 `category` 分布（旧构建 `unclassified:58`，新构建 `unclassified:1 / ui-interaction:59 / scene:1`）与控制台读 `[data-preview-kind]` 分布（新构建应为 `raster-image 52 / document 8 / code 1` 且无 `placeholder`）。同时记下方法教训：不要用 PowerShell 或手抄正则去复算 TS 判定表，誊本会引入假结论——本轮第一轮取证正是因此得出了不存在的「角标与预览分支分叉」，要跑就用真实源码跑。 - `decision-log.md` 新增「AGC 资源预览评估过本机 loopback HTTP 资源服务，因收益不匹配代价而暂缓」，并显式注明它与既有的 `asset:` 否决**不是同一条、理由不同**：`asset:` 是「绕过安全门禁」的原则问题，loopback HTTP 是「收益与代价不匹配」的性价比问题，其门禁可在服务端逐条复用。记录内容含 token 化不暴露路径、服务端复用同一套校验、与「不向 WebView 暴露本机文件协议」合同的关系判定（同构替代而非违约，信任边界转移到 token 与审计），以及流式下**必须明确降级的三条**：读取漂移复核、全局 3 permit 并发闸门、有界 tombstone 预算。量化依据为真机 52 张 PNG 的分层实测——Rust + JS 冷开合计约 0.3 s，大头是已由 `decoding="async"` 移出主线程的 37.2 MPx 解码，因此当前量级下 0.3 s 换「不向 WebView 暴露文件系统」这条合同是划算交易；并写明重新评估的触发条件（几百张资源 / 大图量级）。 - 同批一并暂缓的备选也记在案：Tauri 自定义协议（非 `asset:`）+ opaque token 因拿不到 HTTP 缓存语义而比 loopback HTTP 更差；磁盘缩略图缓存与 PRD 的纯内存口径及既有价值观冲突。 - 纯文档改动，无代码改动；`tauri.conf.json`、`Cargo.toml`、Rust 命令与 CSP 均未动。	2026-09-11 13:30:26 +08:00
suzmii	083df0aa2c	类型判定改为内容证据优先：消除 kind 与内容证据同权的脆弱点 ... **口径更正（后加的）**：本条提交**不是**"修复真机那 8 张卡"。经用真源码复算真机 manifest 确认，当前 HEAD 上这 8 张 `.json` 本就正确落 `document`、角标「文档」，该现象不复现——用户看到的是更早构建的行为。本条的真实价值是**消除 `kind` 与内容证据同权的脆弱点，并把「派发决策由内容证据决定」钉成不变量**，见下。 - 背景：真机「待归类」栏目曾出现 8 张卡——角标写「图片」、卡面却只有占位图标。该现象在当前 HEAD 上不复现（见上），但它对应一个**真实存在且此前只是碰巧没被踩中的脆弱点**：`projectedResourceKind` 里 `kind` 与内容证据**同权**，而 `artKind` 含 `ui`；一旦界面规格类资产丢了 `.json` 扩展名，预览派发就会翻车。原先能通过**完全依赖 `.json` 恰好在那张扩展名表里**，属巧合而非设计。 - 机制（旧行为）：`kind:"UI"` 被 `artKind` 命中 → 判定为 `art`；预览调度再按 `art` 走图像分支，又因 `mediaType:"application/json"` 不是图像而兜底成 `placeholder`，而 `requestPreview` 对 `placeholder` 直接返回——**一次 IPC 都不发**，卡片既不报错也没有图。 - `resourceProjectionModel.ts` 的 `projectedResourceKind` 改为两趟判定：第一趟只看 `mediaType` 与路径扩展名（文件内容的可验证证据），第二趟才看 `kind`（登记标签，可能过时或宽泛）。`kind` 不再与内容证据同权，因此 `kind:"ui"` 无法再把 `application/json` 改写成 `art`。 - 不改 `artKind` 的取值（`ui` 仍在表内），只调整判定顺序：最小改动面，`kind:"ui"` + `image/png` 这类正常资产行为不变（仍由 `mediaType` 命中）。 - 界面规格 JSON 现在落 `document` 分支，走 `read_local_project_text_preview`（Rust 侧 `.json` 与 `application/json` 本就在支持范围内且这些条目已登记），卡面渲染 JSON 文本摘要，角标随 `projectResourceTypeLabel` 变为「文档」。预览链条数、缓存、并发与门禁一律未动。 - `tests/resourceCardPreviewRealManifest.test.ts` 中记录旧行为的用例同步跟上新合同：`placeholder: 8` 改为 `document: 8`，用例名与注释改写为「52 张 PNG 走图片分支，8 条 UI 规格走文档分支，无一落占位」，并新增「角标与预览分支必须说同一件事」的逐条断言。旧断言记录的是缺陷本身，按「四不写」直接更新为当前权威行为，不做兼容保留；其余既有断言一条未放宽。 - 验证：`npm run test -- apps/ai-game-creator-shell/tests` 1202 passed / 4 skipped / 0 failed；`src/components/image-editor` 1385 passed；typecheck exit 0；check:encoding 通过；`git diff --check` 干净。	2026-09-11 13:30:14 +08:00
suzmii	5a37ccfd2b	资源卡暴露预览状态，并补「派发决策由内容证据决定」的契约用例 ... 占位分支对「还没读 / 读失败 / 压根不适用」给的是同一个图标，卡面也没有任何文字提示，现场只能看到「没有图」，无法区分是调度没发请求、原生拒绝了读取，还是这类资源本来就没有预览。本轮排查「图片加载不出来」时，这个不可观测性正是反复误判的来源。 - `index.tsx` 的 `ResourceCard` 根节点新增 `data-preview-status`（`idle` / `loading` / `loaded` / `failed`）与 `data-preview-error`（仅失败态给出原因）。排障从此只需读一个 DOM 属性，而不必去猜调度层。纯新增属性，不改变任何渲染分支与调度行为。 - 新增 `tests/resourcePreviewPredicateContract.test.ts`：把「派发决策必须由可验证的内容证据（mediaType，缺失时退路径扩展名）决定，登记标签 `kind` 只能在两者都给不出结论时兜底」钉成不变量。用 7 组「mediaType + 同通道扩展名」× 20 个 `kind` 的全量笛卡尔积断言 `kind` 不能改写预览分支，并断言组合总数等于笛卡尔积（防止将来收窄枚举让断言悄悄变弱）。另附本轮缺陷形状的最小复现（`application/json` + 任意图片类 `kind` 必须落 `document` 而不是 `placeholder`）、mediaType 缺失时由扩展名决定、以及扩展名与 mediaType 冲突时按既有设计由扩展名决定这三组显式合同。 - 该用例在**变异验证**下确实会红：把 `kind` 判定移回第一趟（还原本轮的分叉）后，本文件 4 条用例失败（不变量报出 56 处违规），恢复后全绿。断言不是恒真假守卫。 - 验证：`npm run test -- apps/ai-game-creator-shell/tests` 84 files passed / 1202 passed / 4 skipped / 0 failed；`src/components/image-editor` 1385 passed；typecheck exit 0；prettier 与 eslint 干净；check:encoding 4378 文件；`git diff --check` 干净。	2026-09-11 13:26:17 +08:00
suzmii	cd1aceb3d9	按 rustfmt 折行退出收尾用例：纯格式，无逻辑变更 ... - tests/project.rs：gui_exit_stops_the_preview_and_clears_the_stale_record 里 init_existing_html_project_at 那行超过 rustfmt 行宽（中文按双宽计），按 `cargo fmt --all --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml` 的结果折成两行。 - 用 cargo fmt（不是裸 rustfmt）：裸 rustfmt 会把文件当模块根、跟随 mod 递归格式化整个模块树，本次已有人因此误改 50 个文件。 - 范围核对：`git diff --stat` 只有 apps/ai-game-creator-shell/src-tauri/src/tests/project.rs（1 file changed, 2 insertions(+), 1 deletion(-)），crate 里其余文件本来就是 rustfmt 干净的，未被牵连。 - 门禁：`cargo fmt --all --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml -- --check` 与 `... --manifest-path server-rs/Cargo.toml -- --check` 均 exit 0；`cargo check --locked --all-targets` exit 0；AGC 子集 1198 passed / 4 skipped / 0 failed；四条预览定向用例仍各 1 passed。	2026-09-11 12:47:22 +08:00
suzmii	531392e506	退出路径统一收尾本地预览，陈旧预览记录不再留给下次进入 ... - preview.rs：新增 stop_local_game_preview_on_exit——退出时若 registry 里确有 running 预览，就用 stop_local_game_preview_for_root 把它真正停掉并写 stopped（顺带落 preview.log 与 trace 收尾）。预览服务器是进程内线程，进程一退 URL 就永久失效；不在这里收尾，.agent/manifest.json 会一直写着 running。 - main.rs：handle_game_creator_gui_run_event 的 RunEvent::Exit 分支先做预览收尾，再做既有的 Agent server / runner 关闭；失败按 `preview.gui_exit.stop_failed` 记日志，不阻断退出。 - 语义变更（用户已确认接受）：关窗不再保留预览——退出即停止预览并把记录写成 stopped，下次进项目一律落到资源管理。与"进入项目时按 registry 活体核对"配套：退出路径覆盖正常关闭，强杀 / 断电那类不走退出路径的情况由进入时的核对自愈。不引入 stale DTO 字段（判定仍要活体探测，且会把状态扩到跨端契约与全部消费方）。 - tests/project.rs：新增 gui_exit_stops_the_preview_and_clears_the_stale_record——退出收尾后 registry 归零且 manifest 记录为 stopped。 - tests/sessionPreview.test.ts：补两条 Rust 侧结构性守卫（本仓既有做法：直接解析源码）。① RunEvent::Exit 分支必须出现 preview::stop_local_game_preview_on_exit——这条接线没有别的行为测试覆盖（注册全局 registry 的用例会互相打架）；② 同项目重启预览的替换分支里，收尾必须排在"旧预览是否属于另一个项目"的判定之后。变异验证：把 main.rs 的退出收尾摘掉 → 守卫①立即红灯（已实测）。 - decision-log.md：新增 2026-09-11 决策条目，逐条写下背景（偶发进运行界面的成因链：进程内预览线程 + 随机临时端口 + 退出零清理 + 进门不核对 + 同项目重启覆盖刚写的 running）、A/B/C 三项决策、关窗不再保留预览这条语义变更及"为什么两者都做而不加 stale 字段"、不做什么与验证方式。同文件被 prettier 补了几处标题前空行（格式规范化，无内容变化）。 - 验证：cargo check --locked --all-targets exit 0；Rust 定向用例 restarting_preview_for_the_same_project / replacing_preview_for_another_project / stopping_without_a_live_preview / gui_exit_stops_the_preview 各 1 passed；AGC 子集 1198 passed / 4 skipped / 0 failed；共享组件 1385 passed；typecheck exit 0；编码 4378 文件；git diff --check 干净。	2026-09-11 12:36:08 +08:00
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	1801d2b227	清 AGC src-tauri 既有 rustfmt 欠账：5 个文件纯格式化，无逻辑变更 ... - `check:rustfmt` 跑 server-rs 与 AGC src-tauri 两条命令，CI 在 server-rs 那条就退出，AGC 侧欠账从未被跑到；本提交只做格式化，不改任何语义 - `src/agent.rs`：`mod` 声明与 `pub(crate) use` 按 rustfmt 排序口径调整 `direct_codex_references` 的位置（声明顺序无语义影响） - `src/assets.rs`：`infer_canvas_export_asset_kind` 的 `else if` 条件行重排；两处 `assert!` 参数按 use_small_heuristics 折叠；两个返回 `Result<..>` 的函数签名断行 - `src/project/asset_export.rs`：`resolve_export_source_file` 签名折成单行，`File::open`/`File::create` 两行重排，用例里 `SaveLocalProjectAssetFileInput` 实参折叠 - `src/tests/asset_rename.rs`：两处用例断行/折叠 - `src/tests/asset_delete.rs`：一处 `assert!` 实参折叠及连带重排 - 已用 `cargo fmt -p genarrative-ai-game-creator-shell -- --check <这 5 个文件>` 与整 crate `cargo fmt --all -- --check` 双重验证通过	2026-09-11 12:25:49 +08:00
suzmii	775b3792cd	修 rustfmt：resource_editor 新增用例按仓库格式折行 ... - `editor_api_rejection_reason_from_body` 用例里 3 处 `serde_json::json!(...).to_string().as_str()` 实参按 rustfmt 口径断行 - `editor_api_rejection_reason_from_body("<html>502</html>")` 断言折行 - 连带收掉 `remote-terminal-failed` 的 match 分支：该 arm 因上一提交改宽而超行宽，按 rustfmt 折成块 - `resource_editor.rs` 现在通过 `cargo fmt --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml -- --check`	2026-09-11 12:21:04 +08:00
suzmii	8a1917b7e1	同步分类自愈规则的契约用例：改断言并把盲区补成显式用例 ... - 修正 resolves asset category and tags with legacy and forward compatibility 中 { kind: 'character', category: 'unclassified' } 的期望：由 'unclassified' 改为 'character' - 该断言是 09-09 引入的旧口径，与 2026-09-10 落地的分类自愈规则冲突；按拍板保留自愈规则（它修复真机 57 条 kind:ui 资产落待归类），因此精确更新断言而非放宽为 not.toBe - 在断言处补注释说明这是本批有意行为，并写明已知盲区：用户手动把可明确分类的资产设为待归类时会被覆盖 - 新增用例「自愈规则覆盖落盘 unclassified：这是显式接受的盲区」，覆盖 character / ui / art-spritesheet 三条具体映射 - 新增用例「派生结果本身就是 unclassified 的 kind 不受自愈规则影响，保持落盘值」，覆盖 image / video / code / publication-material 与未知 kind - 新增用例「落盘为明确分类时信任落盘值，不被 kind 派生结果覆盖」，覆盖 image+scene / character+audio / ui+document - 变异验证：临时移除自愈规则后上述 2 条断言失败（expected 'unclassified' to be 'character'），恢复后全部通过	2026-09-11 12:16:26 +08:00
suzmii	caa188873d	删掉快速编辑目标校验里已失效的 generationInputs 形参 ... - `ensure_editor_image_edit_target_matches_source` 的 `generation_inputs` 形参在来源类型判据改为静态图集合、且 AGC 例外分支删除后再无任何使用，函数体内已无引用 - 同步删除该形参，并更新 1 处生产调用点与 8 处用例调用点传入的多余实参 - 该形参此前只用于把 generationInputs 透传给已删除的 `_for_request` 包装层，删除后判据与请求体字段彻底解耦	2026-09-11 12:14:40 +08:00
suzmii	49a30d51ff	修正 icon 全局放行后的两处判据：删掉死分支并更新旧断言 ... - 删除 `ensure_editor_image_edit_source_kind_allowed_for_request` 里 `AGC && assetKind=="icon" → Ok` 的例外分支：`icon` 已进静态图类型表被全局放行，该分支恒不改变判定结果 - 连带删除因此不再被引用的 `is_game_creator_resource_editor_generation` 与其定向用例（同一 scope 无人调用）；AGC 来源别名口径仍由 `EditorGenerationQueueResultContext::from_job` 的 queue consumer 判定承担并有既有用例覆盖 - 两处调用点改为直接调 `ensure_editor_image_edit_source_kind_allowed`，删掉没有行为的 `_for_request` 包装层与 `generation_inputs` 形参 - 旧用例 `game_creator_resource_editor_bypasses_quick_edit_whitelist_only_for_its_source` 改名 `quick_edit_source_kind_policy_ignores_generation_source`，改为断言来源类型判据与 generation source 无关 - 修正 master 侧旧断言 `editor_image_edit_target_binding_prefers_object_id_and_fails_closed`：反例 effective_asset_kind 从 `icon` 换成仍被拒的 `character-animation`，断言保持 Err，守卫意图（目标图层不能借壳成允许来源）不变	2026-09-11 12:11:37 +08:00
suzmii	a5aba86493	修 rustfmt：editor_project 新增行按仓库格式折行 ... - `ensure_editor_image_edit_source_kind_allowed` 的 `is_none_or(...)` 折叠为仓库 rustfmt 口径的换行 - 白名单用例里 `ensure_editor_image_edit_source_kind_allowed(Some("art-spritesheet"), Some("video"))` 断行 - `is_game_creator_resource_editor_generation(Some(&json!({})))` 断言断行 - `let queued_payload: Value = serde_json::from_str(...)` 折行 - 仅 `server-rs/crates/api-server/src/editor_project.rs` 一个文件，无其他文件被 rustfmt 改动	2026-09-11 12:08:06 +08:00