GenarrativeAI/Genarrative
11
0
Fork 0
Code Issues 14 Pull Requests 3 Actions Packages Projects 3 Releases Wiki Activity
3,290 Commits 22 Branches 4 Tags
f09f5f9e9c6421dbeb31023cff63f8a588fc5ab3
Commit Graph

3290 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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
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 09cd47748c Merge branch 'feat/agc-v3-c7-version-switch' into feat/agc-canvas-resource-workbench-v3 2026-09-10 15:49:46 +08:00
agent 3d709ea1db 合并主干 C3 交互改造并接入 C7 版本切换 
- 合并 feat/agc-canvas-resource-workbench-v3：资源卡改为选中+浮出工具条、支持多选、删除资源详情面板与 resourceEditorRoute

- index.tsx 冲突以 C3 新结构为底：保留本包的素材重命名回调，丢弃被 C3 取消的 focusedResource 详情面板派生状态与浮层 JSX

- 重命名入口从已删除的详情面板搬到选中工具条 extraActions，与「分类与标签」并列

- check-config.mjs 的 allowlist 保持主干版本（normalize_local_project_raster_resource 一行已删）

- 还原 normalize_local_project_raster_resource Tauri 命令与注册：C3 已在前端接回调用方

- C7：新增 GameRunVersionPicker 运行模块右上角版本入口，无版本不渲染

- C7：版本状态收敛到 WorkspaceLauncherShell 一份，透传给资源画布与 @ 面板；换项目或版本消失时清回最新版本

- C7：currentVersionResourceBindingIds 接入 activeVersionId，复用 resolveActiveIterationVersion 口径，资源卡「当前使用」高亮随版本切换

- C7：切换版本时复用既有 onPlay 预览入口重载画面，不新增运行时资源重映射

- 新增 10 条测试覆盖版本判定口径、版本入口与切换、当前使用高亮、素材重命名链路
 2026-09-10 15:46:08 +08:00
suzmii 9121e89798 资源画布新增组织操作撤销重做（WP4） 
新增 features/resource-canvas/resourceCanvasHistoryModel：纯函数有界快照栈（capture/push/undo/redo/clear + 只回写差异位置），快照只含资源卡布局坐标，不回滚素材内容

新增 tests/resourceCanvasHistoryModel.test.ts 覆盖排序稳定、相同快照不入栈、栈上限、push 清空重做分支、撤销重做互逆、空栈返回 null、差异回写与已删除资源不重建

资源卡拖动持久化成功前先落快照，撤销/重做复用现役 commitPosition 手动 CAS 写链

画布缩放集群新增撤销/重做按钮（不可用时禁用），并支持 Ctrl/Cmd+Z 与 Ctrl/Cmd+Shift+Z、Ctrl+Y（输入框内不拦截）

项目切换时清空布局历史，避免跨项目回滚
 2026-09-10 15:43:03 +08:00
suzmii 9939a1bca0 Merge branch 'feat/agc-v3-c3-canvas-match' into feat/agc-canvas-resource-workbench-v3 2026-09-10 15:29:41 +08:00
suzmii f247a5106a 收敛资源画布交互复刻的测试：清理详情面板遗留断言，门禁回到基线 
删除用例 keeps the resource toolbar and canvas interactive while a non-modal detail card is open：该用例断言的「非模态详情卡」已被 C3 合同取消，按四不写删除

新增用例「资源卡 chrome 只保留选中按钮与当前版本边框」，接住被删用例里仍然有效的卡片 chrome 断言（无基础描边、is-current-version 边框、选中按钮样式）

版本卡与 Agent 回执卡没有美术画布动作，断言改为选中反馈（aria-pressed）而不是工具条

blocked.md 的策略失败提示原本渲染在已删除的详情面板里，断言随之移除

快速编辑测试的 fixture 增加栅格美术资产（includeArt 参数），不改动其它用例的 manifest
 2026-09-10 15:29:15 +08:00
agent f32445d700 补齐 AGC V3 附二素材重命名前端链路 
- 新增 ResourceRenameDialog：独立重命名面板，只输入新文件名，规则交给 Rust 侧强校验

- 资源详情面板新增「重命名」动作，严格按 deny_unknown_fields 只传 projectPath/assetId/newFileName

- 改名成功后复用 reloadManifestAfterAssetCommand 这条 manifest 重载路径刷新资源卡与 @ 面板显示名

- 删除 check-config.mjs 过渡 allowlist 里的 normalize_local_project_raster_resource，并移除已无调用方的同名 Tauri 命令与注册

- 新增 2 条前端测试覆盖严格入参、manifest 重载与改名后资源卡显示名刷新
 2026-09-10 15:24:20 +08:00
suzmii a74cd6c8b6 Merge branch 'feat/agc-v3-c3-canvas-match' into feat/agc-canvas-resource-workbench-v3 2026-09-10 15:19:53 +08:00
suzmii bd36587e0a 资源画布交互 1:1 复刻美术画布：点卡选中并浮出工具条，移除资源详情面板与全屏编辑路由 
新增 features/resource-canvas：资源卡到美术画布 CanvasLayer 的适配、工具条动作可用性判定、C5 当前版本绑定判定、快速编辑草稿工厂与 AGC 宿主 chrome 样式

资源卡点击改为选中（Shift/Ctrl/Meta 多选），选中后在卡片旁复用 ImageCanvasSelectedLayerToolbarView 浮出工具条

快速编辑复用 ImageCanvasQuickEditPanelView 浮层面板，先调 normalize_local_project_raster_resource 正规化任务产物，再走 derive_local_project_resource(editKind=image-reference) 产出新素材，失败重试复用同一 operationId/idempotencyKey

删除 resourceEditorRoute 全链路（ResourceEditSurface 路由、openResourceEditor、handleResourceCardOpenEditor、cancelResourceEditor、submitResourceEdit）与资源详情面板（focusedResource 状态/引用/浮层 JSX/CSS 断言）

分类与标签入口搬到选中工具条；UI 资源保留「UI 编辑器」入口并从工具条打开

移除 apps/ai-game-creator-shell/scripts/check-config.mjs 中 normalize_local_project_raster_resource 的过渡 allowlist 条目

为共享工具条组件新增 opt-in 的 supportedActions/extraActions（默认 null/undefined，网页端行为不变）

AGC vite-env.d.ts 补 wx/ReactNativeWebView/WeixinJSBridge 跨端全局声明；hostBridge fail 回调补显式 unknown 类型

测试：资源卡查询 helper 由资源详情按钮改为选中按钮，清理详情面板断言，画布空白左键改为框选后平移用例改用中键
 2026-09-10 15:19:17 +08:00
agent 3508957eda 补齐 AGC V3 C9 参考图选择弹窗与提交快照 
- 新增 ImageCanvasProjectAssetPickerDialog：独立弹窗，网格卡片、多选、筛选+搜索、清空/确认/取消，筛选状态自持

- 新增 projectAssetReferencePickerModel：素材分类与筛选判据、素材 id 快照引用构造、弹窗引用前缀判定

- 生成 composer 参考图来源菜单新增「从项目素材中选择」，由宿主决定是否出现，不改变原有从画布选择与上传两条路径

- 新增 replaceProjectAssetPickerReferences：确认时整组替换素材库来源的参考图，保留画布点选与上传的参考图

- 素材 id 经 sourceAssetId 走既有 createGenerationInputReference 落进 generationInputs.references，不新增后端接口

- 新增 13 条测试覆盖弹窗交互、筛选叠加、快照落库与整组替换语义
 2026-09-10 15:13:40 +08:00
agent 3379e6009e 抽出共享资源筛选条并接入画布标签筛选 
- 新增 packages/shared 的 PlatformResourceFilterBar：搜索（可选）+ 功能分类 + 标签的受控筛选条，只承载表现与交互

- 资源画布筛选改为复用该组件，去掉画布内联的分类 PlatformSegmentedTabs，搜索框保持原样不动

- 画布新增标签筛选状态与派生标签库，标签与功能分类共存可叠加

- 新增 3 条组件测试覆盖受控渲染、回调转发与缺省行隐藏
 2026-09-10 15:02:55 +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
agent 4d0cd425e1 补齐 AGC 标签库聚合派生纯模块 
- 新增 gameCreationAppAssetTagLibrary：从 manifest assets[].tags 派生去重、稳定排序、含使用计数的标签库

- 标签归一化沿用写入路径 normalizeGameCreationAppAssetTags，同素材重复标签只计一次

- 新增 assetTagsMatchSelection / gameCreationAppAssetMatchesTags 标签筛选判据（AND、空选择不过滤）

- 新增 5 条纯模块测试覆盖去重计数、顺序稳定、空标签与筛选判据
 2026-09-10 14:54:06 +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 b0d7121265 补充 C4 引用页签与 C8 润色提醒的定向测试 
- 新增 chatPromptPolish.test.tsx：覆盖提醒判据、草稿指纹、本机偏好读写与润色命令调用
- 覆盖主动润色回填、可重复润色覆盖结果、恢复原文回到最初原文
- 覆盖润色失败保留原文并在提醒面板内给出重试提示
- 覆盖长文本提交被提醒面板拦下、使用原文提交、关闭取消发送、AI 润色后发送
- 覆盖不再提醒偏好落本机 localStorage 后不再拦截，以及挂载时读取该偏好
- 覆盖短文本与命令不触发提醒
- resourceReferenceInput.test.tsx 新增：两个页签的独立搜索与筛选状态
- 新增：activeVersionId、版本回退、悬空绑定过滤与空态
- 新增：资源改名后 chip 与候选列表显示名刷新
- 新增：跨会话恢复草稿后光标落在文本末尾，引用追加在文本之后
 2026-09-10 14:38:59 +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 b96f5e1476 Merge branch 'feat/agc-v3-docs' into feat/agc-canvas-resource-workbench-v3 2026-09-10 14:27:53 +08:00
suzmii f8aa87c71c Merge branch 'feat/agc-v3-cleanup' into feat/agc-canvas-resource-workbench-v3 2026-09-10 14:27:47 +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 1c9b92e791 在 Agent 资源检索投影中暴露分类与自定义标签 
- agent/direct_tool_bridge.rs：bridge_registered_resource 投影新增 category 与 tags，位置固定在 mediaType 之后，保持稳定字段顺序
- agent/direct_tool_bridge.rs：category 直接取 manifest 条目已解析的功能分类（显式合法值原样保留，历史缺字段时已按 kind 派生），tags 缺失时为空数组，不改变 manifest 结构与对外契约
- agent/direct_tools_mcp.rs：agc_list_registered_assets 工具描述补上功能分类与自定义标签，与新增输出字段保持一致
- agent/direct_tool_bridge.rs：既有序列帧投影测试补充 category 与 tags 默认值断言
- agent/direct_tool_bridge.rs：新增 bridge_registered_resource_projects_manifest_classification_verbatim，锁定显式分类与标签原样透出且不泄漏 prompt / model
 2026-09-10 14:24:26 +08:00
suzmii 33ed85ba54 AGC 素材删除改为独立确认弹窗并支持勾选连带删除版本 
- 新增 ResourceAssetDeleteDialog：列出使用该素材的游戏版本（标识 + 创建时间），给出「把相关游戏版本一并删除」勾选，默认不勾
- ResourceClassificationPanel 删除入口改为先读 read_local_project_asset_references，再打开独立确认弹窗，不再用面板内二次确认态
- 确认删除时按勾选状态传 deleteReferencedVersions；未被任何版本引用时不显示连带删除勾选
- styles.css 补删除弹窗、版本列表与勾选行样式
- 重写并扩充 resourceClassificationPanel.test.tsx 的删除用例：确认弹窗才发起删除、未引用时不出现勾选、列出被引用版本且默认不勾、勾选后传 true、客户端拒绝时不报告删除
 2026-09-10 14:22:38 +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 912254afa0 Merge branch 'fix/agc-test-selector-cleanup' into feat/agc-canvas-resource-workbench-v3
Project CI / Repository checks (pull_request) Failing after 18m28s
Details
Project CI / Native shell tests (pull_request) Successful in 25m45s
Details
Project CI / Frontend tests (pull_request) Successful in 53m14s
Details
Project CI / Backend tests (pull_request) Successful in 57m10s
Details
2026-09-10 11:52:23 +08:00
suzmii 53afc85319 修正 AGC 测试按新的 Lexical 聊天输入区驱动与断言 
- appSurface/harness 补齐三处 jsdom 缺口：ClipboardEvent、DragEvent、Range.prototype.getBoundingClientRect；否则 Lexical 的粘贴通路直接抛 ReferenceError / TypeError
- appSurface/harness 的 submitChat 改为 async：全选并让编辑器吸收选区、清空、走产品真实 paste 通路写入，再让出一帧让 React 追平 draft，最后点发送
- 新增 composerText / composerValue / composerDisabled / setComposerText 助手，按原生控件与 Lexical contenteditable 两种 DOM 口径读写输入区
- 15 个测试文件中 116 处 toHaveProperty('value', …) 断言等义改写为 await composerText() / await composerValue()；1 处 placeholder 断言改查输入区占位文案；2 处 disabled 断言改用 composerDisabled（同时覆盖 data-disabled 与 contenteditable=false）；9 处 fireEvent.change 写入改用 setComposerText
- 328 处 submitChat 调用补 await，9 个非 async 用例补 async
- Godot 输入区键盘语义用例按 Lexical 实际行为改写：Shift+Enter 与组合态 Enter 由编辑器消化并插入换行、不发送、草稿保留
- 未改动 src 下任何产品代码，未放宽或删除断言
 2026-09-10 11:46:02 +08:00
suzmii e1044546ad 接入素材删除入口并收敛资源命令后的 manifest 重载 
- ResourceClassificationPanel 增加删除动作：首次点击进入确认态，二次点击才执行，避免误触不可逆操作
- 面板标题与按钮明确写出只移除登记、素材文件保留在磁盘
- 删除失败时把客户端的拒绝原因原样呈现（例如已被运行槽位绑定），并退出确认态
- index.tsx 抽出 reloadManifestAfterAssetCommand：资源分类更新与素材删除共用同一条重载路径，提交标识分别用 asset-classification / asset-delete 前缀
- 补 2 条面板测试：两次点击才删除且入参带 expectedProjectRevision、被运行槽位拒绝时不触发 onDeleted
 2026-09-10 10:53:13 +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 691d0a8ce6 修正 AGC 资源卡测试查询的资源详情按钮选择器歧义 
- appSurface/harness 新增 getResourceDetailButton / findResourceDetailButton / queryResourceDetailButton，按产品可访问名模板「打开资源详情：<分类标签> <资源文件名>」精确匹配，不再用会同时命中 @ 引用按钮的文件名正则
- project-development.suite 的 23 处资源卡按钮查询改用精确查询助手
- home.suite 的 7 处资源卡按钮查询改用精确查询助手
- projectResourceLiveIntegration.test 的 /rules\.md/ 按钮查询改用精确查询助手
- 未改动 src 下任何产品代码，未放宽任何断言
 2026-09-10 10:15:50 +08:00
suzmii d526439508 版本资源绑定升级为真实运行槽位 
- 新增 game_iteration_resource_bindings：优先使用使用清单里的 slotId 到 resourceId 绑定，再为未被槽位覆盖的资源补 asset:{id} 恒等绑定
- 恒等绑定保留是有意的：历史版本与既有校验语义不受影响，同一资源被多个槽位使用时只取首个槽位，不产生冲突语义
- ensure_initial_game_iteration_version_at 与 append_agent_game_iteration_version_at 共用该构造函数
- 补测试：无使用清单时保持恒等绑定；登记运行槽位后槽位绑定优先且未覆盖资源仍有兜底
 2026-09-10 10:13:46 +08:00
suzmii a571c6e225 新增运行期资源使用归属层（C1 素材使用清单） 
- 新增 project/asset_usage.rs：运行槽位到资源身份的稀疏归属清单，落在 .agent/workbench/asset-usage/usage.json
- 只保留 manifest 没有的事实（slotId/loadSite/attribution）；已登记资源只存身份引用，不复制 path/sha256/kind/mediaType，避免第二份资源清单
- 引用了不存在的资源 ID、未登记素材、文件缺失、槽位重复注册一律只产出 warning 诊断，不阻断运行
- revision 只允许前进；同 revision 重放幂等；projectId 不匹配按未登记处理
- 写入沿用 resource-layouts 同款 flock 独占锁 + 原子替换
- 补 11 条定向测试：稀疏引用、未登记/未知资源 ID、缺文件、重复槽位、无槽位引用、幂等、revision 回退拒绝、projectId 隔离、落盘不含 manifest 字段
 2026-09-10 10:05:28 +08:00
suzmii 3f5d3b43af 合并最新 master 到 AGC V3 资源画布分支
Project CI / Repository checks (pull_request) Failing after 7m37s
Details
Project CI / Frontend tests (pull_request) Failing after 8m52s
Details
Project CI / Backend tests (pull_request) Failing after 10m24s
Details
Project CI / Native shell tests (pull_request) Failing after 10m36s
Details 
- 合入 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)
Project CI / Frontend tests (push) Successful in 3m14s
Details
Project CI / Backend tests (push) Successful in 8m54s
Details
Project CI / Repository checks (push) Successful in 2m29s
Details
Project CI / Native shell tests (push) Successful in 19m23s
Details 
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
suzmii 7c49e7e51c Merge pull request '修复 AGC 项目写锁残留无法回收与启动失败无诊断' (#313) from fix/agc-stale-lock into master
Project CI / Backend tests (push) Has been cancelled
Details
Project CI / Repository checks (push) Has been cancelled
Details
Project CI / Frontend tests (push) Has been cancelled
Details
Project CI / Native shell tests (push) Has been cancelled
Details 
Reviewed-on: #313
Reviewed-by: 孔令弘 <ink29535@proton.me>
 2026-09-09 20:07:37 +08:00
suzmii 05d4d6d1d3 删除 asset-canvas 测试并同步资源派生测试口径 
- 删除 tests/assetCanvasSurface.test.tsx（4310 行，63 个用例全部属于草稿画布 Surface）
- projectResourceLiveIntegration.test.tsx 删除 AssetCanvasSurface mock、discover/recover 两个命令 stub、normalize_local_project_raster_resource stub、TaskImageWorkbench 与 4 个草稿精修用例；保留文档资源走资源编辑的用例
- project-development.suite.ts 把 showRunUnavailableHint 源码护栏正则去掉 !assetCanvasRoute，并把"in-place refine 预览失效"用例改写为仍有效的 preview version 装配与项目切换清理
- resourceEditModel.test.ts 把 PNG/WebP 两例从 image-canvas 改为 derive + image-reference，并移除 normalizeSource 断言
 2026-09-09 20:05:07 +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