97 Commits

Author	SHA1	Message	Date
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	87fbf92c58	合并 origin/master 到资源工作台 V3 分支：解 4 处冲突并保留两侧行为 ... - WorkspaceLauncher.tsx：保留本分支清单快照 CAS 拒收提示（manifestMergeNotice 提示条、data-manifest-merge-* 观察点、recoverRejectedManifestSnapshot「重新读取清单」）与 activeVersionId/onActiveVersionChange 版本口径，并入 master 的策划/游戏运行态切换（onMakeGame + switchToGameRuntime、suppressInitialGameTurn 抑制首轮、supervisor key 带 agentRuntimeMode、onSwitchToGameRuntime），planningStartMode 统一取 master 的派生值（上下文 startMode 为 planning 且未切到 game 运行时） - ProjectSupervisorView.tsx：props 同时保留本分支 versions/activeVersionId 与 master 的 designView/onDesignApprove/onDesignClarify/onDesignRetry，DesignAgentSurface 审批链路与本分支资源引用输入区并存；directCodex 输入区保留本分支 @ 引用按钮 + 模型选择 + 发送按钮控制条，发送按钮禁用条件并入 master 的 designView 审批待定口径，模型选择沿用 master 的「对话中可切换」口径 - styles.css：本分支追加的资源画布/输入区样式块与 master 追加的 .design-agent-reasoning 样式块都保留，并补上本分支最后一条规则的收尾大括号 - view/project-development/index.tsx：保留本分支的 image-editor 引用（ImageCanvasProjectAssetPickerDialog、ImageCanvasQuickEditPanelView、ImageCanvasSelectedLayerToolbarView、useImageCanvasFloatingOptionDismiss），去掉 master 对已退役 features/asset-canvas 的 import（本分支已由 resource-canvas 取代），保留 master 的 DesignWorkspacePanel 与 planningStartMode 策划工作台分支 - tests/workspaceLauncherManifestMerge.test.tsx：补 master 新引入的 get_design_agent_runtime_mode mock（返回 null，与 master 各套件同口径），拒收提示断言不变 - tests/appSurface/design-agent.suite.ts：审批待定禁用输入的断言改用本分支 Lexical 输入区的禁用口径（容器 data-disabled + editor.setEditable(false)），断言意图不变 - 验证：npm run typecheck 通过；apps/ai-game-creator-shell typecheck 通过；apps/ai-game-creator-shell/tests 96 个测试文件 1380 通过 4 跳过 0 失败；全仓 vitest 297 通过 2 失败（scripts 下两例为 Windows 权限语义导致的既有失败，相关文件与实现均未参与本次合并）；npm run check:encoding 与 git diff --check 通过	2026-09-12 17:31:51 +08:00
suzmii	e4ee6c2be8	合并 feat/agc-resource-replace：把「替换素材」接进资源工作台 ... - 解冲突 project/manifest.rs：保留版本写入公共体 write_manifest_locked_with_version_guard（版本只追加 + 绑定改写放行），并把 schema 校验并入该公共体，两侧语义都不丢 - 解冲突 shared-contracts：取当前分支的读显示口径 game_creation_app_asset_effective_category（含与 TS 交叉钉住的 EFFECTIVE_CATEGORY_CONTRACT 矩阵），同步改写 version_resource_replacement 对旧函数名的调用 - 解冲突 index.tsx：两处均为纯 import 追加，两侧都保留 - 解冲突 decision-log 与技术方案文档：两侧条目都是追加，全部保留 - 随之进入本分支：版本绑定改写窄放行通道、直接替换命令与其兼容性判据、资源卡工具条「替换素材」入口	2026-09-12 14:19:03 +08:00
suzmii	5b62d1e4ef	修复资源登记把任意图片写成 ui 类型 ... 停用本地导入图片的 ui 默认 kind：agent_local_project_file_type 的图片扩展名分支改写 canonical image（派生 unclassified，落「待归类」），并注明不许把 ui 当图片默认值及其不可恢复原因——读时自愈只在落盘 category 为 unclassified 时触发，kind 本身写错时自愈只会把错值放大成 ui-interaction 账户素材导入改用平台真实类型：新增 imported_platform_asset_kind，账户素材库记录自带的 assetKind 不再被常量 ui 顶掉，缺失才退回中性 image 平台素材导入改用响应里的 assetKind：网页项目画布与平台素材导入同样走 imported_platform_asset_kind，不再写死 ui 上传素材按内容证据推导 kind：upload_local_asset_at 不再把来源词 uploaded 当类型，改由 uploaded_asset_kind 按 mediaType 与扩展名推导 audio/video/image/document/code，判不出才用中性 asset；同一命令也收 .wav 与 .md，因此不能一刀切成 image 补 4 处回归与反查用例：本地导入与上传断言落盘 kind 与 category 且不得出现 ui、ui-interaction、uploaded；两处平台导入的 kind 解析加纯函数单测与调用点反查门禁；变异把错值改回来必须变红（M1/M2/M3 实测 4 个用例全红，还原后 diff 与基线逐字节一致） 覆盖边界：账户素材库与平台素材导入是异步 HTTP 路径，仓库内没有可复用的端到端夹具，这两条覆盖是纯函数单测加调用点反查门禁，不是端到端断言；本地导入与上传是读落盘 manifest 的行为级断言 后续事项：ImportedAsset.asset_kind 仍返回平台原始值（缺失为 none），与已落盘 kind 可能不一致，本次未改动	2026-09-12 02:30:31 +08:00
suzmii	4161888219	③ 资源画布布局的读/写命令补项目权限门 ... - read_local_project_resource_canvas_layout 补 enforce_project_auto_permission_policy(root, "asset.list")，与紧邻的 read_local_project_resource_graph 完全同口径 - update_local_project_resource_canvas_layout 补 enforce_project_permission_policy(root, "asset.register")，与本文件 update_local_project_resource_classification / delete_local_project_asset / rename_local_project_asset 同口径 - 权限位依据：读路径是同一块资源画布的渲染读路径，邻居用 asset.list；写路径是「改动项目内资源相关持久化数据」，manifest 侧的分类写入本身就用 acquire_project_write_lock(root, "asset.register")，故沿用同一权限位，不新造权限名 - 读用 auto、写用普通门是刻意的：asset.list 是 Auto，auto 口径默认放行，只有策略显式 deny/confirm 才拒绝（读路径没有可插入的确认交互，要求确认等同拒绝）；asset.register 默认是 Confirm，若写路径也用 auto 会直接打死默认路径 - tests/project.rs 补断言：默认策略下读与写都放行；deny asset.list 读失败、confirm asset.list 也读失败（钉住 auto 口径这一选择）；deny asset.register 时读仍放行、写被拒且被拒的写不留任何落盘副作用（断言 sidecar revision 未变）；恢复默认策略后写入照旧成功	2026-09-11 21:18:41 +08:00
suzmii	fc4a2c12f4	新增 AGC 版本级资源替换的后端命令与三项兼容性判据 ... - shared-contracts 新增 game_creation_app_asset_category_with_read_time_healing：把 PRD §5.3「分类取值优先级」的读时自愈口径落到 Rust（落盘 unclassified 且 kind 能明确分类时采用派生值），与 packages/shared 的 gameCreationAppAssetCategory 逐分支一致，并补定向用例锁定该窗口 - 新增 project/version_resource_replacement.rs：三项兼容性判据（categoryEqual 用读时自愈口径、subtypeEqual 用 canonical kind、sizeSpecEqual 用规范化媒体格式 + 已知帧尺寸与时长事实） - sizeSpecEqual 在代码注释里明确标注降级：manifest 资产表今天没有 width/height/durationMs 字段，且现役写入侧几乎全部写 imageSequenceFrames=None，所以该项实际退化为「媒体格式相等」；要支持跨图片格式替换必须先给 manifest asset 加尺寸字段（跨端契约变更） - 新增 replace_local_project_version_resource_at：持项目写锁并按 expectedProjectId + expectedProjectRevision 做 CAS，一次写入里追加 createdReason=resource-replacement 的子版本（parentVersionId 指向源版本），子版本绑定 = 源版本绑定去掉源素材并保证替换素材在集合里；全程不调用 mutate_manifest_at_allowing_version_removals，既有版本记录一个字节不改 - 替换前后资源身份按 PRD §5.4 版本字段表口径用推导记录（父−子 = {源素材}、子−父 = {替换素材}），并注明「替换素材在源版本创建时就已登记」时子−父为空集的已知限制 - 新增 read_local_project_version_replacement_candidates_at：只读返回候选与后端权威兼容性结论，候选渲染但禁用并给出原因，不在前端重算判据 - commands.rs 新增两个命令包装（读用 asset.list、写用 asset.register），main.rs 注册进 generate_handler - 新增 8 条定向用例：只追加与父子/修订关系、两条绑定路径（1:1 交换与替换素材已绑定）、三项兼容性逐项拒绝且零副作用、CAS、四条拒绝路径、候选读取顺序与原因、读时自愈口径锁定 - 中间状态声明：本提交落地时前端调用方尚未提交，npm run ai-game-creator-shell:typecheck 会因 check-config.mjs 要求「每个 Tauri 命令都有 App invoke 调用方」而失败；这是刻意保留的中间状态，不得把这两个命令加进 native-only 白名单换绿	2026-09-11 17:37:01 +08:00
lhk229	e6e2a5fda6	调整策划项目命名 ... 策划入口使用带随机短码的策划项目名称 保留游戏与素材入口的现有命名链路 补充自动建项测试与技术方案说明	2026-09-11 07:35:41 +00: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	f2f8a9af72	合并 WP4 资源面板与撤销重做：保留 C7 版本入口与资源面板接线 ... - project.rs 冲突：同时保留 mod asset_export（WS-B 下载命令）与 mod asset_rename（WS-D 重命名命令），丢弃已在 WS-A 退役的 asset_usage - index.tsx 冲突：同时保留 GameRunVersionPicker（C7 版本入口）与资源面板/历史模型导入（WP4）	2026-09-10 15:57:42 +08:00
suzmii	422a71d321	资源画布新增独立资源面板：预览/上传/下载/多选（WP4） ... 新增 features/resource-canvas/resourceCanvasAssetTransferModel：面板网格模型、选中集合解析、默认导出文件名、上传白名单（纯函数） 新增 features/resource-canvas/ResourceCanvasPanelView：独立浮层面板承载预览网格/上传/下载/全选/清空，选中状态直接读写画布同一份 selectedResourceIds，不造第二套选择 下载改为显式保存链路：前端 @tauri-apps/plugin-dialog save() 取目标路径，再调新命令 save_local_project_asset_file 复制素材文件，避免依赖不可靠的 <a download> Rust 新增 project/asset_export.rs 与命令 save_local_project_asset_file：校验项目根与相对路径、源必须是真实普通文件（拒绝符号链接与目录）、目标路径非空且父目录存在、分块流式复制不进整文件内存，返回目标路径与字节数 Rust 单测覆盖成功复制（内容一致 + byteLen + 源不变）、缺失源拒绝、目录源拒绝、空目标与父目录缺失拒绝、目标为目录拒绝 上传复用现役 upload_local_asset（落 assets/uploads 并登记 manifest 条目）后回读 manifest 刷新，只接受图片/音频/视频 capabilities/main.json 增加 dialog:allow-save；资源画布 chrome 样式补资源面板一套；index.tsx 只做导入/一处按钮/一处渲染/状态透传	2026-09-10 15:56:10 +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	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	89678173f5	补齐 AGC V3 C4 聊天通用引用与 C8 AI 润色发送前提醒 ... - @ 面板新增「当前版本素材 / 全部画布素材」两个页签，两个页签各自持有独立的搜索与分类筛选状态 - ResourceReferenceInput 新增可选 prop activeVersionId 与 versions，并把两者透传到 ProjectWorkspaceChatPane、ProjectSupervisorView、SupervisorChatOnlyView 和 App - 未传 / null 的 activeVersionId 回退到 manifest versions[] 中最新的版本；版本不存在或没有绑定时页签显示空态，不报错也不合成资源卡 - 「当前版本素材」按该版本 resourceBindings 取仍登记在 manifest 的资产，悬空绑定按资源 id 过滤掉 - 资源改名后按资源 id 刷新编辑区已有引用 chip 与候选列表的显示名，并把新显示名同步回父级草稿 - 程序化重建草稿后把光标收回草稿末尾，跨会话恢复草稿时后续引用不再插到已失效的位置 - 新增 Tauri 命令 polish_local_project_prompt（复用短文本生成通道，计费仍由平台 LLM 路由侧完成，未改 server-rs） - 输入区新增「AI 润色 / 恢复原文」按钮、润色中状态与失败可重试提示，失败、超时或未配置模型时保留原文 - 原文快照只在首次润色成功时落下，反复润色只覆盖结果，「恢复原文」始终回到最初原文 - 新增发送前提醒独立面板：AI 润色先润色再发送、使用原文提交、关闭取消发送、不再提醒 - 提醒判据：纯文本 trim 后不短于 40 字符、不是 / 开头的命令、本轮草稿未确认过、且用户未关闭提醒 - 「不再提醒」偏好写入本机 localStorage，不进 manifest、不进后端 - 补充润色按钮、状态提示、素材页签与提醒面板样式	2026-09-10 14:38:34 +08:00
suzmii	824934df41	收敛 AGC 资源口径：撤掉运行期使用侧车并改为确认式删除 ... - 整体删除运行期资源使用侧车模块 project/asset_usage.rs 与 tests/asset_usage.rs（含 16 条测试），并清理 project.rs、tests/mod.rs 里的 mod / use - game_iteration_resource_bindings 收敛为纯恒等映射 slotId=asset:{assetId}、resourceId=assetId，不再读取侧车、不再做槽位优先 - assets.rs 删除 GAME_ITERATION_IDENTITY_BINDING_PREFIX、asset_is_bound_to_runtime_slot 与 remove_asset_usage_references，删除不再判定运行槽位、不再清理侧车引用 - manifest 写入层把“版本数组只允许追加”校验改为显式接收放行删除的版本 ID：新增 mutate_manifest_at_allowing_version_removals，其余写入路径继续传空放行集合 - delete_manifest_asset_at 改为三分支语义：无任何版本引用直接删登记、被引用且未确认时只删登记并原样保留悬空绑定、被引用且确认时素材与相关版本在同一次 manifest 写入里一起删除 - DeleteLocalProjectAssetInput 增加 deleteReferencedVersions 入参，commands.rs 与 main.rs 同步 - 新增只读命令 read_local_project_asset_references，列出引用了该素材的版本标识、revision 与创建时间 - 新增 tests/asset_delete.rs，覆盖恒等绑定、无引用删除、未确认保留悬空绑定、确认连带删除、引用投影、只允许追加校验仍拒绝其它路径与 CAS	2026-09-10 14:22:18 +08:00
suzmii	16748821e3	Merge branch 'feat/agc-version-switch' into feat/agc-canvas-resource-workbench-v3	2026-09-10 10:42:20 +08:00
suzmii	69741e5e13	新增素材删除能力与运行槽位绑定判定 ... - project/asset_usage.rs 增加 write_local_project_asset_usage_at：就地改写引用与诊断，保持身份与 revision 不变 - assets.rs 新增 delete_manifest_asset_at：素材不可变，只摘掉 manifest 登记、保留磁盘文件，并清理使用清单里指向它的悬空引用 - 删除判定只承认真实运行槽位绑定：恒等绑定是版本创建时的兼容兜底，若把它也算作被引用，任何在版本创建前登记过的素材都将永远删不掉 - CAS 口径与资源分类更新一致：持项目写锁后校验 expectedProjectId 与当前 revision，失败时 manifest 与 revision 均不变；成功后 revision 推进一格 - 新增 delete_local_project_asset 命令并注册；内联测试换成带 CAS 的公开入口 - 补 4 条删除测试：恒等绑定不阻止删除、真实槽位绑定拒绝删除并报出版本与槽位、删除清理悬空引用、陈旧 revision 与跨项目身份被拒且状态不变	2026-09-10 10:42:02 +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	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	3ea94b27d4	删除 asset-canvas Rust 草稿存储与生成链路 ... - 删除 project/asset_canvas.rs（4784 行，草稿 sidecar、媒体 staging、正式提交事务与 journal） - 删除 project/asset_canvas/generation.rs（9514 行，草稿私有生成账本、参考图上传、服务身份确认、候选落盘与内联 63 个测试） - 删除 project/asset_canvas_tests.rs（2356 行） - project.rs 移除 mod asset_canvas 与 pub(crate) use asset_canvas::* - commands.rs 移除 851-1088 共 18 个 Tauri 命令（含 commit_local_project_asset、commit_local_project_asset_canvas_candidate） - main.rs 从 generate_handler! 移除对应 18 行注册 - 保留 canvas.asset_generate 命令契约（packages/shared 与 shared-contracts 的正式权限合同，Agent Runtime 仍在使用） - 保留 server-rs 的 asset-canvas-references 上传票据白名单契约（后续项，本次不动服务端）	2026-09-09 20:04:43 +08:00
lhk229	852d9af483	合并最新 master ... 同步远端主线至 b129589e7 保留当前分支的 V1 清理与主线文档和测试更新	2026-09-09 06:06:35 +00:00
lhk229	310091d28e	合并最新 master ... 同步主线 DirectProject 历史与 Markdown 展示改动 保留策划 V2 退役方案文档索引	2026-09-09 05:49:33 +00:00
lhk229	6a1e307b4a	合并最新master并协调模型配置保存逻辑 ... 合入服务端默认模型同步及前端模型选择更新 保留配置覆盖层回滚和设置页无外部诊断行为 同步模型ID与默认模型标记并补充交叉回归验证	2026-09-09 05:36:56 +00:00
lhk229	08c5917490	修复配置覆盖层写入失败后的部分更新 ... 提前序列化配置变更并在多文件写入失败时逆序回滚 保留单文件保存路径且不增加外部诊断或保存后回读 补充覆盖层写入失败回归测试及配置保存文档	2026-09-09 04:34:57 +00:00
lhk229	5bee48fede	合并最新master到常用设置修复分支 ... 同步远端master的最新修改	2026-09-09 02:15:42 +00:00
suzmii	2942489575	Merge remote-tracking branch 'origin/master' into feat/agc-client-sync-llm-config ... # Conflicts: # apps/ai-game-creator-shell/src/features/project-workspace/ConversationModelSelect.tsx # apps/ai-game-creator-shell/src/features/project-workspace/ProjectSupervisorView.tsx # apps/ai-game-creator-shell/tests/conversationModelSelect.test.tsx # docs/technical/【技术方案】AGC后台模型别名与对话选择-2026-09-05.md	2026-09-09 10:04:05 +08:00
k88936	d3f5d0a355	feat/AGC codex的工具调用 持久化处理 (#282) ... 重构directproject的thread持久化, 保存response items用来恢复thread 修改了DirectProject的对话jsonl格式, 不兼容不迁移. (测试需要手动清理旧对话jsonl文件) AGC显式写入user msg, 对codex 返回的user msg忽略 清理原来的上下文滑动窗口, 因为codex内部会自动compact 工具调用后重启,继续对话:  close #249 close #277 --------- Co-authored-by: 段舒康 <kdletters@qq.com> Reviewed-on: #282 Co-authored-by: 王德宇 <kvtodev@outlook.com> Co-committed-by: 王德宇 <kvtodev@outlook.com>	2026-09-08 22:04:37 +08:00
lhk229	1cf835418e	修复常用设置状态展示与本地覆盖保存 ... 删除常用设置账号权限状态栏及关联状态传递 复用保存前读取结果并同步冲突覆盖项，模型切换仅同步模型字段 补充配置保存定向测试并更新设置职责文档	2026-09-08 13:45:25 +00:00
lhk229	5efd88cb3e	修复客户端常用设置读写卡顿 ... 移除常用设置读取和保存后的外部诊断调用 减少配置读取时的重复权限修复和保存后的重复回读 补充常用设置无需外部诊断的原因注释	2026-09-08 12:58:29 +00:00
lhk229	ded3253b08	删除已退役策划 V1 的 Runtime 模块与残留分支 ... 按四不写原则移除 PR #159 引入、已被策划 V2 取代的整条 V1 链路 删除 runtime_protocol 下六个 V1 模块（planning_storage/submit/approval/coordinator/hydrate/provider_usage） V1 与 V2 共用的 GDD 数据模型抽到新模块 planning_gdd_model.rs 供 V2 继续复用 删除 prompt manifest 中 planning Agent 目录、role overlay、plan sections 与 supervisorPlan 组合及对应生成常量 删除四个 V1 提示词文件（roles/project-planning.md、plan/common.md、plan/supervisor-identity.md、plan/supervisor-playbook.md） 删除 game-creator.config.json 与配置代码中的 planning 能力开关 删除 CLI --swarm-chat 的 --plan 入口与 swarm_cli 中的 plan source 分支 删除 provider_retry 的 planning session binding 与 plan 专用请求指纹链路 删除 provider_action_batch 的 plan.submit_gdd v4 批次形状校验与 planning 绑定字段 删除 tool_policy_snapshot / agent_native_tools / tool_plan_protocol 中的 plan 根阶段收窄与 plan.submit_gdd 身份门 删除 main_loop 的 plan_gdd blocker 投影、plan 信封修复回路与 plan submit 业务拒绝限流 删除 pending_recovery 与 recovery_scan 的 plan submit 锚点恢复、planning session 投影恢复与审批投影恢复 删除 acceptance_graph 的 Fast GDD 取证覆盖校验与 plan 根验收前置门 删除 agent_db 的 plan.provider_usage、plan.gdd_decided、plan_submit_gdd.committed 三条专用持久车道及其预留配额 删除 AgentRuntimeState 的 plan_submit_gdd_rejection_count 字段 runtime_tools 的委派、run_status、goal_contract 恢复为通用路径（移除 plan 根对称性守卫与 acceptance gate 钩子） 同步删除只覆盖 V1 行为的测试用例（planning 澄清、锚点恢复、plan 根委派门、plan 提示词组合等）	2026-09-08 09:44:21 +00:00
suzmii	4fc9451492	修复AGC客户端未跟随服务端默认模型 ... - 客户端配置新增 selectedModelIsDefault，记录当前选择是否来自平台默认项 - 服务端默认项变化时，跟随默认项的选择自动切换并提示，手动选择不受影响 - 所选模型失效回退默认项时标记为默认项选择 - 补充配置读写与客户端定向测试，同步技术方案文档	2026-09-08 16:38:37 +08:00
lhk229	38b4abc403	删除已退役策划 V1 的前端数据通路与命令入口 ... 前端 App.tsx 删除 hydrate_game_creator_plan_gdd_state 旧读取与 decide_game_creator_plan_gdd 旧审批分支，策划状态只走 Planning V2 命令 hydratePlanningV2Session 在确认无 V2 会话时清空策划状态，避免残留旧卡片 Tauri 命令层删除 decide_game_creator_plan_gdd 与 hydrate_game_creator_plan_gdd_state 及其注册和输入解析 CLI 删除 --plan-gdd-status 与 --plan-gdd-decide 子命令、stdin 审批意见读取与对应解析测试 测试 harness 删除旧命令 mock 与 planGdd 状态注入，新增 V2 审批失败注入与 decisionId 记录 plan-gdd 测试套件改写为 V2 会话驱动，删除 recoveryPending 与旧 Supervisor 审批等待两个已退役语义的测试	2026-09-08 03:56:16 +00:00
lhk229	d7a09276e6	合并 origin/master 到 feat/design_agent_simple ... - 合入 AGC 官方 LLM Router 账号链路与流式联网输出（#242） - 新增后台模型别名与对话选择能力及 AGC 模型目录 - 解决 ProjectSupervisorView.tsx 与 decision-log.md 冲突	2026-09-07 03:07:05 +00:00
suzmii	4f3f0f24ff	接入AGC后台模型目录与对话模型选择 ... 新增后台 AGC 模型目录、别名、启停和默认项管理 客户端设置页恢复原状，对话框右下角按别名选择模型 服务端按稳定模型标识映射并校验实际模型白名单 修复 AGC 配套后端端口漂移、启动等待和 SpacetimeDB 版本检查 补充迁移、文档、启动与模型选择测试	2026-09-05 19:10:49 +08:00
lhk229	27246fbc5e	收口P4并关闭旧版策划入口 ... 旧 project-supervisor-plan 来源统一返回退役错误 避免旧入口启动 Runtime 或 Provider 同步收口 P4 验收状态与最简 P5 方案 记录 V1 不迁移且历史文件只读保留	2026-09-05 08:10:26 +00:00
suzmii	c12d744d91	合并master并保留双侧最新决策记录 ... 合入主站 AGC 请求头归属与项目命名链路改动。 保留本分支 Direct 过程卡决策记录。 保留主站登录归属、workspace 边界与 Native shell 决策记录。	2026-09-03 16:04:04 +08:00
suzmii	d5e05d79fe	优化项目名称显示与命名链路 (#248) ... ## 优化项目名称显示与命名链路 关联：#245 按 Issue 中的需求文档实现： - 新增项目名称修改入口，保存到本地项目 \.agent/manifest.json\ - 项目页、当前项目上下文、窗口标题在重命名后同步刷新 - 首页自动创建工作区时，根据用户输入用 LLM 提炼项目名 - LLM 命名失败或返回非法内容时，回退现有默认名，不阻断创作流程 --------- Co-authored-by: 段舒康 <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/248 Co-authored-by: suzmii <suzmii@qq.com> Co-committed-by: suzmii <suzmii@qq.com>	2026-09-03 15:50:55 +08:00
suzmii	8aaa3f5c7b	修复运行时配置诊断阻塞窗口 ... 将 Codex CLI 与 app-server 探测移入 Tokio 阻塞线程池 保持 GameAgent 运行时配置读写流程不变 增加异步 LLM 配置诊断回归测试并补充技术方案约束	2026-09-03 14:24:40 +08:00
k88936	422c8931d6	Feat/AGC错误报告 (#240) ... 实现: 在rust内存里维护错误事件队列, webview调用tauri command传入, 后台任务agent工具等直接插入 把rust , webview console的日志统一写到AppData文件夹下的(滚动保存的)日志文件. rust对传入的错误进行筛选,脱敏, 防抖,后通知前端提醒用户. 用户提醒是一个不阻塞的小UI, 展开后可以选择错误上报, 可以附加文字描述 上传时附带最近日志, 错误堆栈等信息 元数据存在数据库, 考虑到字符串信息很难查询, 所以在api server打包成zip存在OSS. 管理页面新增错误报告的查看页面     --------- Co-authored-by: 段舒康 <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/240 Co-authored-by: 王德宇 <kvtodev@outlook.com> Co-committed-by: 王德宇 <kvtodev@outlook.com>	2026-09-03 10:02:05 +08:00
lhk229	65d7a57eb7	AGC对主站的请求添加header (#241) ... Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/241 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-02 14:39:01 +08:00
kdletters	071faa482c	统一 Rust 与 TypeScript 格式化门禁 ... 纳入 AGC Cargo workspace 的统一 rustfmt 检查与格式化入口 完成项目 TypeScript/Prettier 与 Rust 全量格式化 修复 Pingora expected executable 门禁的空白敏感误报 同步开发运维文档与 AGC skill pack 格式化忽略规则	2026-09-01 16:28:34 +08:00
suzmii	f0142f7019	Close213/215 本地资源注册与后台表查询 (#232) ... ## 关联 Issue - Close #213：补充本地资源注册类型 - Close #215：后台表查询添加字段查询 ## 背景 本 PR 合并处理两个规模较小、已完成统一 review 的客户端与后台能力改动，整体已基于远端最新 master。 ## 本地资源注册（#213） - AGC 本地项目资源支持图片、字体、音频、视频、文档和代码类型。 - 支持 PNG/JPEG/WEBP/GIF/SVG/AVIF/BMP、TTF/OTF/WOFF/WOFF2、MP3/WAV/OGG/FLAC/M4A/AAC/OPUS、MP4/WEBM/MOV，以及常见文本、配置和源码扩展名。 - 同步更新 Direct Tool Bridge、MCP schema、Runtime/Provider Prompt、AGC Skill 文档和技术方案。 - 保留项目相对路径、敏感目录、符号链接、文件大小、字体解析、UTF-8、项目锁、manifest/revision 和幂等语义。 - 修复从 game 等目录复制到 assets/uploads 时扩展名退化为 .bin 的问题。 ## 后台表查询（#215） - 使用结构化筛选条件替换手写筛选 JSON。 - 支持多条件、比较、包含、前后缀、列表、空值和旧 JSON object 兼容。 - 优化预览表格、详情复制、Toast、JSON 预览和排序交互。 - 修复数字范围筛选，包括数据库字符串化数字的数值比较。 - 补充前后端回归测试与文档。 ## 验证 - AGC 本地资源导入测试：6/6 - AGC Direct/MCP 工具测试：8/8 - 本地资源扩展名与 Prompt 映射回归测试通过 - 后台 admin 数据库测试：17/17 - 后台页面 Vitest：16/16 - `npm run admin-web:typecheck` - `npm run admin-web:build` - `npm run check:encoding` - `git diff --check` - `rustfmt --edition 2024 --check server-rs/crates/api-server/src/admin.rs` ## 限制 - 未执行真实生产 SpacetimeDB、OSS 或其它付费服务验证。 - Native shell CI 及其它 PR CI 以最新 head 的远端结果为准。 - 当前 PR 保持 WIP，待 reviewer 基于最新 head 重新 review。 Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/232 Co-authored-by: 董羽秦 <suzmii@qq.com> Co-committed-by: 董羽秦 <suzmii@qq.com>	2026-09-01 14:27:39 +08:00
suzmii	80b8238d0a	修复 AGC Windows ACL 提权与文件访问边界 (#211) ... ### 背景 Windows 下 AGC 读取配置目录、项目文件和本地资源时，可能先于 ACL 校验阶段就因继承权限、错误 owner 或拒绝访问而失败，表现为 `拒绝访问。 (os error 5)`。 此前自定义 `--config-dir` 场景还存在 scope 无法传递到提权子进程的问题；native picker 路径也缺少进程内来源证明，递归索引可能跟随 junction/reparse point，新建文件在权限加固失败时可能留下残留文件。 ### 本次变更 1. 修复自定义 `--config-dir` 的 `managed / user-selected` scope 传递与提权票据校验。 2. 增加 native picker 文件/目录路径的短期 provenance 授权；未经过 picker 授权的任意 IPC 绝对路径不能触发 `user-selected` 自动提权。 3. 项目文件列表和索引递归改用 `symlink_metadata()`，拒绝 symlink、junction 和 Windows reparse point。 4. 统一在 metadata/read/open 前完成 ACL 准备，对 ACL 导致的 metadata 失败执行一次受控修复和重试。 5. 新建 conversation、导出包、Agent DB、资源、字体等文件在 harden 失败时关闭句柄并清理刚创建的文件。 6. 修复 UAC 提权授权票据以 `share_mode(0)` 独占打开后与 `GetNamedSecurityInfoW/SetNamedSecurityInfoW` 产生共享冲突的问题。 7. 同步 AGC Windows ACL 技术方案与安全回归测试。 ### 安全行为 - UAC 取消返回 `1223`，不会被当作成功。 - 提权子进程重新校验目标路径、scope、当前用户 SID、nonce、有效期和票据一次性消费。 - symlink、junction、reparse point 和非普通文件对象保持失败关闭。 - 自定义配置目录可以位于用户 profile 外部，但仍受 owner、DACL 和路径类型校验。 ### 验证结果 已执行并通过： ``` cargo check --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml private_path_elevation_policy_tests -- --nocapture # 10 passed cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml local_project -- --nocapture # 20 passed cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml checkpoint::security_tests -- --nocapture # 10 passed cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml private_file_write_tests -- --nocapture # 2 passed npm run check:encoding # 5554 files passed git diff --check # passed ``` 另外确认： - `origin/master` 是当前分支祖先。 - 交接文档已删除，且原本不在 Git 跟踪列表中。 - 全量 `cargo test` 未作为通过依据；此前存在与 ACL 无关的失败项。 - `cargo fmt --check` 仍受仓库已有格式漂移影响，本次未执行全仓库格式化。 - 真实 Windows UAC 点击“Yes”的手工回归仍需在目标机器上确认。 ### 手工验收 使用： ```powershell & "C:\Users\dongy\workspace\Genarrative\.worktrees\agc-windows-acl-fix\apps\ai-game-creator-shell\src-tauri\target\debug\genarrative-ai-game-creator-shell.exe" ` --config-dir "C:\Users\dongy\AppData\Local\Temp\agc-acl-live-20260830\deny-config-2" ``` 验收标准： 1. 选择“否”：进程返回 `exit code 1223`。 2. 重新启动并选择“Yes”：不再返回 `exit code 1`，ACL 修复完成后继续启动。 3. 再次启动同一配置目录：不应重复弹出修复。 4. 检查目录 owner 和 DACL，确认归当前用户所有且为私有权限。 --------- Co-authored-by: 段舒康 <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/211 Co-authored-by: 董羽秦 <suzmii@qq.com> Co-committed-by: 董羽秦 <suzmii@qq.com>	2026-08-31 14:37:34 +08:00
kdletters	9476ff7648	迁移仓库工具资源到 Codex 并固化执行边界 ... 将 .hermes 工具资源迁移至 .codex 同步代码、文档与 RAG 路径引用 补充任务范围、验收与时间盒执行规则	2026-08-27 13:55:25 +08:00
kdletters	2ac97b3f5e	退役客户端 MCP 约束与运行链路 ... 删除客户端 MCP 配置、Runtime 工具和安全门禁 移除 MCP E2E 套件、测试夹具和测试辅助代码 清理 MCP 依赖及 Skill/Prompt 中的 MCP 约束	2026-08-26 02:32:05 +08:00
kdletters	6b947c5430	修复 AGC 项目素材发现与受控导入 ... 发现项目内未登记媒体并保持正式素材身份边界 新增 Runtime 与 Direct MCP 素材查询和导入工具 支持图片素材在 AssetImporter 中受控登记 补充路径安全、契约测试和技术文档	2026-08-26 02:32:04 +08:00
lhk229	3d8e0211db	5分钟策划agent (#159) ... Co-authored-by: 段舒康 <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/159 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-08-24 21:44:44 +08:00
suzmii	532c6d51fd	完善 Game Agent 资源画布与图片精修生成事务 (#181) ... ## 背景 本合并请求整合 Game Agent 资源管理的栏目分页自由画布，以及图片持续精修、候选生成和本地恢复事务。 当前远端比较基线： - base：`master` @ `b00a3f80576949567bf3320f0c6c92b4ed0a649d` - head：`codex/game-agent-resource-section-pages` @ `5795d2f9b8797c342dcf2920ccefec2a3ff3f472` - 相对 base：28 commits、33 files（`+3746 / -1333`） ## 主要改动 ### 资源管理分页自由画布 - 固定展示“设计文档 → 美术资源 → 音乐音效 → 游戏代码 → 项目版本”五个栏目；空栏目仍可从悬浮 Dock 打开空画布。 - `按依赖` 与 `按类型` 共用栏目分页画布；每个“排序模式 + 栏目”组合独立保存 viewport。 - 普通滚轮使用有界意图队列切换栏目；Ctrl/Meta + 滚轮以指针为锚点缩放；空白拖拽可沿 x/y 无限平移，不以资源 extent 作为导航边界。 - 资源卡支持拖拽布局与一次 CAS 持久化；切页、排序切换和卸载会统一取消拖拽及 pointer capture。 - 资源详情为非模态独立卡片：打开、切换或关闭详情不卸载背景画布、资源卡或依赖连线，也不重置 viewport、搜索或排序状态。 - 顶部已移除“生成视频 / 生成音效 / 生成背景音乐 / 新增 UI 设计”的手动入口；保留播放、未完成编辑恢复、排序和画布复位，以及资源详情中的既有编辑动作。 ### 图片持续精修与生成事务 - 图片资源可进入唯一活动精修草稿，支持原生批量导入、图片下方快速编辑卡、候选图层、任务侧栏和“设为最终图”。 - 生成成功只合并候选图层和 generation 权威事实，不以全量 hydrate 覆盖生成期间的本地编辑。 - 候选媒体、图层和公开 generation 记录写入并回读成功后，才推进私有 `candidate-ready`。 - 候选确认接入 Surface 保存 FIFO 与重新打开 hydrate；revision-sensitive 操作等待确认屏障。 - 失败归档和正式图提交采用可恢复中间态，避免中断后出现幽灵任务、重复 revision 或不一致的正式资产。 ### 合同与文档 - `acknowledgeCandidateLayers`、`importLocalImages`、`archiveFailedGeneration` 为必选 Host Port；不支持的宿主返回结构化 `unsupported-capability`。 - 同步更新 TypeScript / Rust 合同、Tauri command 可达性、PRD、技术方案与项目共享记忆。 - 明确资源栏目无限画布合同：普通平移不夹取；资源 extent、图片测量、布局变更和 resize 不得重置用户 viewport；仅首次可测量布局与显式复位按真实卡片包围盒适配内容。 ## 验证 CI run [#1290](https://git.genarrative.world/git/GenarrativeAI/Genarrative/actions/runs/1290) 针对当前 head 已完成且四项均成功： - [x] Repository checks - [x] Frontend tests（235 test files、3166 tests passed；App Surface 410 tests） - [x] Backend tests - [x] Native shell tests 另有本地定向检查： - [x] `npm run agc:typecheck` - [x] 资源画布、App Surface、Asset Canvas 与资源实时集成定向回归 - [x] Rust 候选确认、候选中断恢复、失败归档与恢复定向测试 - [x] `cargo fmt --check` - [x] `npm run check:encoding` - [x] `git diff --check` ## 评审 provenance - review #247、#248、#252 都针对旧 head，当前在 Gitea 中均标记为 stale；不将其写作“已处理 #247”或当前 head 的评审结论。 - review #253 针对旧 `5456a1d…` head，提出 PRD 退役入口、共享 pitfalls 的 extent 旧合同和 PR 正文事实更新三项 P2；对应文档已在 `5795d2f…` head 修复并推送。 - 早期由 PR #176 引入的候选持久化、归档、Host Port 与快速编辑卡问题，当前已在 base/head 中具备对应修复，不作为本轮重复阻断项。 - 当前 head 仍需新的、针对最新提交的审批；历史 stale review 不能替代当前 head approval。 ## 影响范围 - 修改 AI 游戏创作 App 的资源管理、图片精修、Tauri 本地持久化与恢复语义，以及共享合同和权威文档。 - 会调整本地资源布局、精修 draft 和私有 generation ledger 的状态机。 - 不修改 SpacetimeDB schema，不新增或变更 `/api/external/v1` 路由。 --------- Co-authored-by: kdletters <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/181 Co-authored-by: suzmii <suzmii@qq.com> Co-committed-by: suzmii <suzmii@qq.com>	2026-08-24 20:42:58 +08:00
suzmii	15a524e6e0	Feat: 完善 Game Agent 资源画板与图片精修链路 (#176) ... ## 摘要 本 PR 将 Game Agent 资源管理页升级为真实自由画板，并打通图片资源的快速编辑、候选生成、导入、失败归档与正式图提交流程。 同时补齐图片精修的事务恢复、候选身份校验、生成中任务恢复、鉴权重试，以及“设为最终图”后游戏运行资源的稳定刷新链路。 ## 主要变更 ### 1. 资源管理页自由画板 - “按依赖”视图改为统一自由画板： - 支持指针拖拽平移 - 滚轮平移 - `Ctrl / Meta + wheel` 以指针为锚点缩放 - 支持复位和全量资源适配 - 增加隐藏导航边界： - 边界由全量资源世界范围加安全留白决定 - 搜索过滤不会缩小边界 - 用户不能把全部资源拖出可视区域 - 图片资源卡按真实宽高比展示： - 预览读取真实 `pixelWidth / pixelHeight` - 布局碰撞、世界范围、依赖连线共同消费同一资源矩形 - 非图片资源保持固定卡片尺寸 - 点击资源改为非模态详情卡： - 背景画板不卸载 - 顶部工具栏、搜索、排序、缩放状态不重置 - 图片详情不再进入全屏页 ### 2. 图片资源快速编辑与精修画布 - 点击图片资源后直接显示快速编辑卡。 - 图片精修顶栏收敛为紧凑操作： - 返回 - 导入 - 定位当前最终图 - 撤销 / 重做 - 删除、修改、设为最终图进入选中图片的上下文卡片。 - 快速编辑生成不再阻塞整张画布： - 立即创建生成占位卡 - 占位卡可拖动并持久化位置 - 右上任务列表显示排队 / 生成中 / 完成 / 失败状态 - 任务列表可折叠 - 生成失败只影响当前任务： - 保留失败占位 - 可显式归档失败任务 - `reconciliation-required` 任务不允许删除 - 原生多选图片导入： - 使用 Tauri 原生文件选择 - 后端批量安全读取 - 一次推进草稿 revision - 失败不留下半导入状态 ### 3. 候选图与正式图事务 - 生成成功只加入草稿私有候选层，不直接修改 manifest。 - “设为最终图”是唯一正式资源切换入口。 - refine 保持原 asset ID 和来源身份，不追加新的业务资产身份。 - 正式文件使用不可变路径： ```text assets/canvas/<name>--<commitId>.png --------- Co-authored-by: kdletters <kdletters@qq.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/176 Co-authored-by: suzmii <suzmii@qq.com> Co-committed-by: suzmii <suzmii@qq.com>	2026-08-24 16:27:33 +08:00