226 Commits

Author	SHA1	Message	Date
kdletters	7092689b36	收口 AGC 生命周期超时隔离与建项恢复 ... ## 变更内容 在 master（0f829cd25）上用故障注入复现出四类"每走一步都会卡住"的生命周期残留，本轮按"超时后真正隔离并核对底层操作"收口，不再新增 operation 字段： - 本地会话写入队列从"无限等上一次完成"改为带解围期限的闸门（60s）。Rust 侧 install/clear 本来就按 generation 单调拒绝更旧写入，所以渲染层只需保证新 generation 不被卡死的调用永久挡住； - generation floor 读取不再把一次瞬时失败缓存成永久失败（原先 `??=` 缓存了已 reject 的 promise，导致同一渲染进程内后续登录/退出全部失败）； - 登录 UI 的 45 秒围栏只放弃等待、不放弃结果：本地运行时确实装好会话时界面跟随进入工作区，且迟到结果不会覆盖更新的登录尝试； - 首页自动建项从 `deadlineMs: null` 改为 10 分钟兜底期限：到点解围并提示（底层创建继续在后台跑，迟到成功照常进项目），失败时保留 `scope.projectPath`、登记最近项目并新增「打开已创建的工作区」入口；底层创建未返回期间只挡"再建一个"，不挡打开已有项目； - 同步 `project.bootstrap` 权限文案断言、生命周期技术方案状态与 shared pitfalls。 ## 验证 - `npm --prefix apps/ai-game-creator-shell run typecheck`（含 skill-pack、check-config） - `vitest run apps/ai-game-creator-shell/tests/appSurface.test.ts`（428/428，含新增 5 个故障注入回归；`project.bootstrap` 文案断言在此前 master 上确定性失败） - 定向 `clientHttp`、`clientApi`、`clientOperation`、`recentProjectsModel`、`clientRuntimeErrorBoundary`、`sessionPreview`、`start-dev-stack`、`dev-port`、`start-tauri-dev`（全部通过） - `npm run check:doc-index`、`npm run check:encoding`、`git diff --check` 原生 Runner/IPC 与真实 Provider 下的同一批时序未执行，本轮结论来自 deterministic surface 与 mock 故障注入。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 14:49:45 +08:00
kdletters	c146f7f99c	建立 AGC 稳定版生命周期基础合同 (#348) ... ## 变更内容 这是基于 PR #346 的稳定版生命周期基础切换，承接已完成的 HTTP body timeout、Runner blocking worker、最近项目逐项刷新和首页跨页防重： - 新增统一 `ClientOperation` 合同，固定 operationId、requestId、phase、deadline、scope、cancellable 和 stale 判定； - 认证 refresh 投影 `auth-refresh` operation；登录、401 refresh、退出共用平台 session generation，并由 `auth-transition` 投影 Runner phase/成功/失败/不确定状态； - 首页自动创建记录 draft、startMode、phase 和建项后的 project scope，页面卸载不会释放 operation； - `.app/dev-stack.json` 增加 instanceId、repoRoot、服务级 dataDir/instanceId，AGC Vite marker 增加 repoRoot/processId/port；缺身份的旧状态拒绝 AGC 后端复用； - 新增稳定版生命周期主规范、开发运维口径和 shared pitfalls。 ## 验证 - `npm --prefix apps/ai-game-creator-shell run typecheck` - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/clientOperation.test.ts tests/clientApi.test.ts tests/clientHttp.test.ts tests/recentProjectsModel.test.ts tests/start-dev-stack.test.ts tests/dev-port.test.ts --reporter=dot`（61 passed，2 skipped） - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/appSurface.test.ts --reporter=dot`（423/423 passed） - `node --check scripts/dev.mjs` - `node --check apps/ai-game-creator-shell/scripts/start-dev-stack.mjs` - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` `scripts/dev.test.ts` 全量仍有 1 个 Windows 文件权限相关既有失败：bootstrap secret 测试在 Windows 上无法通过 chmod 模拟 0600；本变更未触及该逻辑。 Reviewed-on: #348	2026-09-14 13:56:56 +08:00
kdletters	991b2a1104	修复 AGC 异步操作恢复闭环 (#346) ... ## 变更内容 AGC 登录、Runner 会话、最近项目检查和首页自动创建原先各自维护异步状态，响应体卡住、单目录变慢或切页会导致按钮长期 busy、项目列表整体不可用或重复创建项目。本 PR 将这些入口收口到可恢复的生命周期边界： - 认证响应体读取增加独立超时，refresh singleflight 在失败后释放； - Runner 会话安装/清除移到 blocking worker，登录/退出增加 45 秒 UI fence； - 最近项目逐项检查并设置单项目超时，已完成行不受其它慢目录阻塞； - 首页自动创建锁提升到 WorkspaceLauncher，切页后仍防重并保留状态； - 新增异步闭环技术方案、body 卡住测试、逐行项目测试和跨页创建测试。 ## 验证 - `npm --prefix apps/ai-game-creator-shell run typecheck` - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/clientHttp.test.ts tests/clientApi.test.ts tests/recentProjectsModel.test.ts --reporter=dot` - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/appSurface.test.ts --reporter=dot` - `cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml` - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` `appSurface.test.ts` 390/390 通过；保留仓库既有 act/jsdom media warning。本 PR 未触发真实 Provider 或发布安装包。 Reviewed-on: #346 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-14 13:19:13 +08:00
lhk229	340d8241a5	优化策划agent (#340) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/340 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-13 19:32:12 +08:00
suzmii	7ae71441ba	合并 master：接入 AGC 内置插件宿主与 Cocos 编辑器能力（#338） ... 合并 origin/master 4a46f89c9 到 chore/agc-acceptance-build（HEAD 55fab1776），本次合并共涉及 117 个文件（113 个自动合并 + 4 个冲突）。 - 自动合并 113 个文件：插件宿主与插件工作区（plugin_host.rs / builtin_plugins.rs / editor_adapter(_s).rs / plugins/agc-cocos-editor / cocos-editor-bridge crate / editor-adapter-api）、构建与打包脚本、locked Cargo.lock 及 master 侧锁与资源链路改动；不逐条列出。 - 冲突 1 apps/ai-game-creator-shell/src/App.tsx:271-278：两侧各自新增一个 import（本分支 ./services/tauriEventSubscription、master ./services/pluginHost），两个 import 都保留，并按 simple-import-sort 口径排在 ./services/platformSession 之后、tauriEventSubscription 之前；四个符号都仍被使用。 - 冲突 2 docs/project-memory/shared-memory/decision-log.md:8338-8469：两侧在同一位置追加记录，逐字保留两侧记录且各自原有顺序不变（先本分支的 2026-09-11 资源卡预览 data URL / loopback HTTP 两条，后 master 的 2026-09-09～2026-09-12 通用插件宿主、Cocos 桥接与内置插件开关条目），不改写、不合并措辞。 - 冲突 3 docs/project-memory/shared-memory/pitfalls.md:79-112：同上，保留本分支的「2026-09-05 资源画本转场与视口分离」与 master 的「2026-09-11 首页自动工作区必须使用 AGC 管理目录」「2026-09-12 Cocos 项目识别不等于编辑器桥就绪」「2026-09-11 Cocos 项目必须走独立导入分支」，内容逐字保留、两侧原顺序不变。 - 冲突 4 apps/ai-game-creator-shell/src-tauri/src/agent/direct_project_history.rs:400-435：判据是「两侧不互斥」，解法为 both（语义超集）。 - 冲突 4 保留本分支的有界退避重试循环（DIRECT_PROJECT_HISTORY_CONTENTION_RETRY_BACKOFF_MS + is_direct_project_history_contention_failure + 测试注入点）与单次尝试函数 append_direct_project_history_item_once（含锁外幂等回扫与锁内状态复核）。 - 冲突 4 保留 master 的有界等待取项目写锁：把该函数内原来的零等待 crate::project::acquire_project_write_lock(root, "conversation.write") 换成 acquire_game_creator_agent_runtime_project_write_lock_with_wait(root, "conversation.write")，并原样保留 master 的注释（agc_write_file 占锁 5.5 秒期间，零等待取锁会让流式历史落盘直接失败）。 - 冲突 4 判断依据：master 只替换了同一处的取锁语义（零等待 → 约 10 秒有界等待，并有 append_waits_for_a_same_process_project_writer 用例锁定），不改变函数签名、调用方与错误类型；HEAD 的重试循环因此仍然可达，与有界等待叠加后语义更强——写文件占锁由有界等待吃掉，等待窗口耗尽后的残余争用再由一次 250ms 短退避重试兜底。未删除任何一侧行为，也未放弃任何一侧语义。 - 冲突 4 位置取舍：有界等待取锁仍放在锁外回扫与序列化之后（本分支结构），保住「幂等回扫与序列化留在锁外、不让他人等整份历史读完」的性能语义；master 的注释与调用参数逐字保留。 - 验证：npm run typecheck、npm --prefix apps/ai-game-creator-shell run typecheck、cargo check --locked --all-targets（exit 0，0 error）、npm run check:rustfmt、npm run check:encoding、git diff --check 全部通过；冲突标记扫描为空。 - 定向 Rust 测试（--test-threads=1）：direct_project_history 19 passed / 0 failed（含本分支 contention_failure_is_retried_with_bounded_backoff、contention_failure_beyond_the_backoff_budget_fails_closed、shape_failure_is_not_retried 与 master 的 append_waits_for_a_same_process_project_writer）；conversation 36 passed / 0 failed；write_lock 21 passed / 0 failed。两侧用例同时绿，证明有界等待取锁与有界退避重试叠加后语义自洽。 - 未跑全量测试（按仓库约定本地只跑定向，全量交给 CI）；本次不 push。	2026-09-13 15:33:48 +08:00
kdletters	4a46f89c9b	接入 AGC 内置插件宿主并补齐 Cocos 编辑器能力 (#338) ... 客户端新增随包提供的插件宿主和 Cocos Creator 集成：识别并导入 Cocos 项目，通过内置桥接操作已打开的编辑器，无需安装项目 MCP 扩展。DirectProject 现在公开 36 个独立 cocos_* 工具，保留通用 JavaScript 执行入口。 - 通用插件 SDK、命令/能力/面板注册、编辑器适配器和跨进程内置插件开关。 - Cocos 场景、节点、组件、Prefab、UI、Layout/Widget、资源、保存、撤销、日志与预览调试；目录和实现由 JS/native 共用。 - 编辑事务回读、失败回滚、后续手动修改保护及不确定结果禁止重放；预览截图通过 MCP image 返回。 - DirectProject 跳过无关专业 Agent 历史，将项目打开和历史读取中的同步 I/O 移出窗口线程，消除 Cocos 执行与项目文件锁的错误耦合。 验证： - 合并 master 后：类型/配置检查、编码检查、Rust 格式检查和提交钩子通过。 - 合并 master 后：Cocos 项目打开、插件面板和开发启动定向测试 10 通过、2 跳过；DirectProject MCP 测试 17 通过、1 项真实 Creator opt-in 忽略；插件宿主测试 9/9。 - 插件行为测试 17/17；native 测试 20/20，4 项 opt-in 测试默认忽略。 - 真实 Creator 3.8.8 的 36/36 操作 smoke，以及客户端 MCP tools/list、tools/call、UI/撤销和预览截图，在功能实现阶段已验证通过；本次 master 合并后未重复真实 GUI smoke。 验证边界：发行安装包和远端 CI 尚未验收。 Reviewed-on: #338 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-13 14:48:55 +08:00
suzmii	55fab1776a	AGC 画布验收问题修复与栏目画布底部工具栏 ... - 合并资源画布命名筛选与条件筛选为单一筛选浮层，Dock 只留放大镜入口 - 修复「编辑素材标签」面板标签多时不可见且不可滚：加高度上界与标签区独立滚动 - 替换素材新增点选替换模式，并在资源卡标注会话内替换血缘 - 新增栏目画布底部工具栏，按功能画布分流图片类生成、音频生成与上传入口 - 新增 Tauri IPC generate_local_project_asset，收口图片类无源生成的 kind 与提示词目录 - 同步 PRD、AGC 验收用例、决策日志、踩坑记录与待解决事项文档	2026-09-13 14:07:03 +08:00
suzmii	6f212a3f2c	合并资源工作台分支：PR review 前端批次并入（含滚轮归属与重命名 CAS） ... - 把远端最新 5ab33a8db 合入本分支（PR #316 review 前端三笔：d04fe83f1、d1581892d、a9a5fba92，41 文件） - 冲突零；同时保留两侧对滚轮的处理：本批把 ResourceBookScene 的重复 onWheel 改成 manager 原生监听（body portal 收不到），远端那笔的浮层守卫仍在 handleResourceBookWheel 内兜住留在 DOM 里带滚动区的浮层，互补不冲突 - 含追加契约：confirmResourceRename 补 expectedProjectId/expectedProjectRevision（与删除/分类同一套 CAS 口径）+ 共享错误码映射 projectAssetCommandErrorMessage - 验证：npm run typecheck exit 0；resourceRename / resourceCanvasFloatingDismiss / projectResourceLiveIntegration / resourceReferenceInput 四文件全绿	2026-09-12 20:52:38 +08:00
suzmii	d1581892d7	修复 PR #316 review（前端 TS/TSX）：资源工作台与资源画布 ... - 素材重命名（跨范围契约）：`rename_local_project_asset` 现在要求 `expectedProjectId` + `expectedProjectRevision`，前端按删除 / 分类保存同一套 CAS 口径补齐——先 `get_local_game_project_revision` 读当前 revision 再连同项目身份提交，不用可能过期的本地缓存值 - 失败文案统一：新增 `projectAssetCommandErrorMessage`，把 `project-identity-conflict` / `project-revision-conflict` 翻成用户可读中文，重命名 / 删除 / 分类保存三条链路共用一份映射，其余错误原样透出 - index.tsx：资源面板下载按 `resolveDownloadablePanelEntries` 过滤，版本卡这类合成 path 的条目不再进入落盘链路 - index.tsx：`characterAnimationPanel` 纳入画布浮层开关判据（抽 `resolveResourceCanvasFloatingPanelOpen`），「生成动画」面板与快速编辑 / 信息浮层共用同一条「点外部 / Esc 关闭」规则 - index.tsx：去掉 `ResourceBookScene` 上重复的 `onWheel`，滚轮只由 manager 上的原生 `passive:false` 监听处理，平移 / 缩放不再被翻倍 - index.tsx：快速编辑的源资源在层 id 命中不到时回落到已正规化的 `asset:<id>`，重试不再静默什么都不做；取不到时给出可见失败 - ResourceCanvasPanelView.tsx：下载按钮按可下载条数判可用、不再在上传中显示下载转圈；上传中禁掉 × / Esc / 遮罩三条关闭路径；预览占位文案抽 helper - GameRunVersionPicker.tsx：portal 菜单在滚动 / 缩放后重算位置；外部点击判定沿用共享 `useImageCanvasFloatingOptionDismiss` + `menuRef` 边界（review 该条已修，保留现状并补位置用例） - ResourceCanvasGenerationPanelView.tsx：`submitting` 改 `finally` 收回，成功路径不再永久锁住面板 - ResourceAssetDeleteDialog.tsx / ResourceRenameDialog.tsx / ResourceClassificationPanel.tsx：在飞时 `closeOnEscape` / `closeOnBackdrop` 与头部 × 一起挡住 - resourceEditModel.ts / resourceCanvasToolbarModel.ts / useProjectResourceCardPreviews.ts / projectResourceLiveUpdateModel.ts：抽 `resourceBaseName`、`canonicalProjectedResourceMediaType` 参数收窄去掉强转、删未使用参数、补「IO 失败会 reject」的签名说明 - resourceCanvasHistoryModel.ts：`resourceCanvasSnapshotsEqual` 不再比较不可恢复的 `manuallyPlaced`，消除「压进历史但撤销是空操作」 - resourceCanvasSectionMapping.ts：删掉从未接线、且注释与实现相矛盾的 `LEGACY_RESOURCE_CANVAS_SECTION_FALLBACK` - resourceCanvasChrome.css：`.game-resource-panel-grid` 补 `flex: 1 1 auto; min-height: 0`，卡片网格成为真正的滚动区 - 用例：重命名 CAS 载荷与读序、CAS 拒绝文案、版本卡下载门禁、上传中关闭路径、浮层判据、菜单跟随滚动、分区映射	2026-09-12 20:49:03 +08:00
suzmii	d04fe83f10	修复 PR #316 review（前端 TS/TSX）：@ 引用与提示词润色主链路 ... - App.tsx：`conversation.write` 策略确认后的重跑改为整体复用首轮入参（`directCodexPolicyRetryInput`），不再手写字段，修掉漏传 `references` 导致 @ 引用被静默丢弃的缺陷 - resourceReferences.ts：运行画面引用的判别指纹补上 `resourceIds`（排序集合口径）/`versionId`/`elementRole`/`width`/`height`，避免不同选点撞 key 被 `dedupeChatReferences` 去重丢掉 - ResourceReferenceInput.tsx：程序化重建编辑器内容改为把 chip 内联嵌在文本里的同名 token 位置（不再另起一段堆在末尾），并把 `lastEmittedDraftRef` 记为「编辑器实际读回来的草稿」而不是 props，消除每轮多一段 `@显示名` 的渲染循环 - ResourceReferenceInput.tsx：候选浮层（候选菜单 / 素材选择器）打开时 Enter 不再提交表单，把按键让给 `LexicalTypeaheadMenuPlugin` - ResourceReferenceInput.tsx：`assets` / `currentVersionAssetReferences` 的 memo 依赖改用内容签名；预览请求在换素材 / 卸载时主动作废上一个 scope；空态文案的嵌套三元抽成 `pickerEmptyMessage` - usePromptPolish.ts：`polish()` 补 `catch`，注入式 `requestPolish` 拒绝时给出可见失败提示而不是未处理拒绝；`reset()` 递增请求代次作废在飞请求 - ChatPromptPolishReminder.tsx：章节级 Esc 分支补 `busy` 判据，与关闭按钮 / 遮罩同一口径（在飞不许关面板） - LocalGamePreviewFrame.tsx：资源 id 改用专用净化（允许 `:` 与可打印非 ASCII），修掉 `local-asset:<id>`、`persisted-角色草图.png` 被整条过滤导致引用丢素材关联 - sessionPreview.ts：`get_local_game_preview_status` 读失败不再当作「确认没有在跑」去发停止命令，避免停掉真在跑的活体预览 - useHomeProjectCreation.ts：进项目流程加代次令牌，慢请求后到不再覆盖新项目 - WorkspaceLauncher.tsx：拒收恢复的阶段回写按 `projectId`/`heldRevision`/`snapshotRevision` 关联，不再把恢复结果盖到后续新拒收的提示上 - 用例：`directCodexPolicyRetryInput` 透传、引用指纹区分度、重建不循环、浮层打开时 Enter 不提交、润色拒绝 / reset 作废、预览读失败不停预览	2026-09-12 20:48:13 +08:00
suzmii	fc67439802	修复资源画布浮层里的滚轮被画布消费：@ 选择器列表滚动时画布跟着平移 / 缩放 ... - 共享浮层判据抽出 isEventInsideFloatingOverlay，并新增 isFloatingOverlayWheelEvent：关闭判定与滚轮归属共用同一份口径（DOM 不在边界里的 portal 浮层 + 已登记浮层） - isEventInsideFloatingMenu 返回值收紧为布尔，避免判据把命中的元素当真值往下传 - 资源画布唯一滚轮入口 handleResourceBookWheel 加统一守卫：浮层里的滚轮一律不消费（不 preventDefault、不动视口），不再逐浮层加 stopPropagation - resourceCanvasFocusModel 增加 RESOURCE_CANVAS_WHEEL_OVERLAY_SELECTOR 与 isResourceCanvasWheelOverlayTarget，登记留在画布 DOM 里自带滚动区的浮层（快速编辑 / 信息 / 筛选） - projectResourceLiveIntegration 新增用例：在选择器列表上派发真实 wheel → 浮层自己收到该事件、画布 data-resource-viewport 不变；对照组场景根派发 wheel → 视口照旧变化 - resourceCanvasFloatingDismiss 新增判据单测：portal 浮层 / 共享弹出层 / 已登记浮层三种来源归浮层，边界里的卡片与空白仍归画布，判不出归属不抢 - pitfalls.md 记录「portal 事件沿 React 树冒泡导致画布误吃滚轮」的根因与排查口径	2026-09-12 19:29:20 +08:00
suzmii	46458a8253	修复运行模块版本菜单「点了选项没反应」：portal 菜单被「点外部」判定吃掉 click ... 与 665982eb9 的 tauri 事件注销竞态是两个独立原因，用户看到的是同一个症状： ① 切换版本时的重载被事件竞态报错打断（665982eb9，已并入 6618207b5）； ② 版本菜单在选项收到 click 之前被「点外部」判定收掉，onSelectVersion 永远不被调用（本提交）。 - 现象：在运行模块点版本菜单里的选项没有任何反应（菜单直接消失、当前版本不切换）。 - 原因：菜单用 createPortal 挂到 document.body（运行画面会缩放，挂 body 才不跟着画布跑偏），DOM 上不在触发按钮 rootRef 的子树里；而「点外部关闭」判定只认 rootRef，落在选项上的那一次按下就被当成点外部，菜单在选项收到 click 之前被卸载，选项的 onClick 永远不会触发。 - 改法：删掉自建的 window mousedown 判定，复用共享 hook useImageCanvasFloatingOptionDismiss（AGC 的 view/project-development/index.tsx:1661 已在用同一份口径，不新造第二套判定），并把 portal 菜单登记成第二个边界：GameRunVersionPicker.tsx:35 新增 menuRef、:37-41 传 boundaryRefs: [rootRef, menuRef]、:69 把 menuRef 挂到菜单容器上。菜单的关闭时机随之从 mousedown 变为 click，与画布浮层口径一致。 - 回归用例（apps/ai-game-creator-shell/tests/resourceVersionSwitch.test.tsx，全部走真实指针序列 mousedown → mouseup → click，不再像旧用例那样只派发 click）： - does not dismiss the portal version menu when an option is pressed down：mousedown 后菜单必须还在，随后 mouseup+click 必须调用 onSelectVersion('version-root')。 - selects the version from the run module when the option is clicked after a real press：真实 launcher + 运行模块，走完真实序列后宿主必须收到 onActiveVersionChange('version-root')。 - keeps the portal menu mounted when the click lands on the menu itself：点 portal 菜单自身（非选项区）不算点外部。 - 变异验证（两条，都先红后绿）： - 还原旧实现（window mousedown + 只认 rootRef）→ 3 条新用例全红：2 条 AssertionError: expected null not to be null（菜单被关掉），1 条 expected "spy" to be called with arguments: [ 'version-root' ] / Number of calls: 0（onActiveVersionChange 没被调用，正是用户症状）。 - 只把边界收回 boundaryRefs: [rootRef]（仍复用 hook，但不登记 portal 菜单）→ keeps the portal menu mounted when the click lands on the menu itself 变红（expected null not to be null）。注意另两条此时仍绿：共享 hook 的判定在 click 而非 mousedown，所以要复现用户现象必须连旧的 mousedown 判定一起还原，这也是本次把判定整体换成共享 hook 的直接理由。 - 验证：npx vitest run apps/ai-game-creator-shell/tests/resourceVersionSwitch.test.tsx 7 passed（原 4 条 + 新 3 条）；npm --prefix apps/ai-game-creator-shell run typecheck exit 0。	2026-09-12 18:02:13 +08:00
suzmii	665982eb99	合并 fix/agc-version-switch-event：切换版本报 listeners[eventId].handlerId 的订阅竞态修复并入资源工作台 V3（解 App.tsx 冲突） ... - 合并来源：6618207b5（fix/agc-version-switch-event）。冲突只有 1 个文件 1 处：apps/ai-game-creator-shell/src/App.tsx:1889-1940。 - 冲突成因：master 侧（策划 agent 重构）在 planning-session-v2-stream 之后新增了一条 design-agent-update 订阅（App.tsx:1888）；6618207b5 则把这处相邻的 manifest-invalidated 守卫 `const listen = window.__TAURI__?.event?.listen; if (!listen)` 换成 `canSubscribeTauriEvents()`，两段文本相邻导致冲突。 - 解冲突（两侧都保留，未删任何一侧）： - 保留 master 新增的 design-agent-update effect 及其全部行为符号：designAgentTurnRef 轮次配对、payload.projectPath 比对、setPlanningV2TransientReply、setPlanningV2Reasoning、applyDesignView（App.tsx:1888-1931）；只把它的订阅方式换成 6618207b5 的入口（subscribeTauriEvent<DesignEvent> + canSubscribeTauriEvents 守卫）。 - 采用 6618207b5 对 manifest-invalidated 的写法：canSubscribeTauriEvents() 守卫 + subscribeTauriEvent<GameCreatorManifestInvalidatedEvent>（App.tsx:1933-1940），refreshManifest 行为不变。 - 冲突区外补齐同一件修复：apps/ai-game-creator-shell/src/features/project-workspace/DesignWorkspacePanel.tsx:264-301 是 master 新增、而 6618207b5 基于共同祖先 46788edbb 写作时还没出现（base 里没有这个文件）的一处订阅，事件同为 design-agent-update、写法同为「订阅后立刻注销」，会同样踩 React.StrictMode 的注销竞态，因此一并改走订阅入口；否则「唯一订阅入口」不成立、该竞态在本次要打包的版本里仍然活着。 - docs/project-memory/shared-memory/pitfalls.md 自动合并成功，6618207b5 与 ff0bc5a3e 两条 2026-09-12 记录都在（无手工取舍）。 - 自证：git grep '^<<<<<<<|^>>>>>>>' 无命中；AGC 内除 services/tauriEventSubscription.ts 自身外，已无 __TAURI__?.event?.listen 直连订阅。 - 验证（本提交时点）：npm --prefix apps/ai-game-creator-shell run typecheck exit 0；npx vitest run apps/ai-game-creator-shell/tests/resourceVersionSwitch.test.tsx 7 passed。全量验证（两侧 typecheck、AGC 全量用例、encoding、git diff --check）在两条修复都并入后统一执行。	2026-09-12 18:01:38 +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	6618207b5b	修复运行模块切换版本报 listeners[eventId].handlerId：事件订阅改为自建登记 + 幂等注销 ... - 新增 apps/ai-game-creator-shell/src/services/tauriEventSubscription.ts：AGC 唯一的事件订阅入口。真实 WebView 内用 plugin:event|listen + transformCallback 自建登记，注销时先 unregisterCallback(handlerId)（callbacks.delete，幂等、缺条目也不抛）再发 plugin:event|unlisten，并对重复注销去重，注销失败只在 console.warn 显式记录；非原生环境沿用注入的 event.listen（两参调用形状不变），未接桥接时返回空操作。tauri 2.11 的注销脚本会先读注册表条目再摘回调，而条目由注册 eval 异步写入，与 IPC 返回无序，这一层自建登记正好绕开该竞态（上游 tauri-apps/tauri#15799 / #15800，2.12 起脚本自带判空，升级后可删掉 internals 分支）。 - App.tsx：5 处事件订阅（game-creator-direct-turn-update / agent-progress / agent-runtime-update / planning-session-v2-stream / manifest-invalidated）与角色 Agent 流式回复监听改用订阅入口，守卫由 window.__TAURI__?.event?.listen 换成 canSubscribeTauriEvents()。 - features/app-shell/useDeveloperAgentPanel.ts：Agent Runtime 与角色 Agent 流式回复两处订阅改用订阅入口。 - services/errorReportingBridge.ts：error-report-updated 订阅改用订阅入口，不再直接依赖库内 listen。 - components/AppUpdateNotice.tsx：更新下载进度订阅改用订阅入口。 - components/WindowChrome.tsx：窗口尺寸监听不再走 nativeWindow.onResized，改为订阅 tauri://resize（限定当前窗口），避开库内注销竞态。 - 新增 tests/tauriEventFake.ts：与 tauri 2.11.3 等价的 Tauri 事件替身（注册表条目由注册 eval 异步写入、库内注销脚本读缺失条目即抛并留痕、全局桥 event.listen 按库内实现返回会读条目的注销函数）。 - 新增 tests/tauriEventSubscription.test.ts（7 例）：注册 eval 未落地就注销、重复注销只摘一次、注册落地后能投递且注销后不再投递、真实 WebView 不走库内注销脚本、无 internals 时回落注入桥接、无桥接时空操作。 - 新增 tests/runVersionSwitchEventSubscription.test.tsx（2 例）：真实 launcher + 运行模块连续切换两次版本（断言 start_local_game_preview 被调用）、卸载后后端订阅与 JS 回调都不泄漏、切换版本后清单失效事件仍能送达并重读清单。 - docs/project-memory/shared-memory/pitfalls.md：记录该竞态的成因、触发面、处理取舍与变异验证结论。	2026-09-12 17:23:22 +08:00
suzmii	35d3a92afd	快速编辑提示词支持 @ 引用素材，@ 面板补标签筛选 ... - 快速编辑面板提示词换成与聊天同一个 `ResourceReferenceInput`，`@` 候选、插入动作与引用模型全部复用聊天那一套 - 共享 composer / 快速编辑面板新增 `promptInputSlot` 注入位，宿主控件替换默认 textarea，不传时 DOM 与行为逐字不变 - `ResourceReferenceInput` 新增 `showPolishAction`：快速编辑的润色仍由 ResourcePromptPolishSlot 承担，面板里不再出现第二个润色入口 - `ResourceReferenceInput` 的多行输入区把 Enter 留给换行，只有单行输入区才用 Enter 提交 - `@` 面板的搜索与筛选改用共享 `PlatformResourceFilterBar`，搜索 + 功能分类 + 标签三者在面板内叠加生效 - 新增 `resourceReferenceMatchesTagSelection` / `resourceReferenceTagLibrary`，标签口径（多标签 AND、计数与排序）落在共享标签库，两个页签各持一份 - 宿主新增 `quickEditReferences` 与 `applyResourceQuickEditDraft`，派生请求的 prompt 就是输入区回填的那份文本（`@显示名`），不引入第二种引用格式 - `useImageCanvasFloatingOptionDismiss` 新增 `isInsideExtraOverlay`：宿主 portal 到 body 的 `@` 选择器与候选菜单不再被判成点外部而收起快速编辑面板 - 资源画布快速编辑提示词输入区补样式（铺满 composer 一整行、高度上限），`@` 面板去掉手写搜索行样式 - 用例：新增标签库口径、标签筛选（多标签叠加 + 关键字 + 功能分类）、两页签独立标签、聊天与快速编辑草稿一致性、快速编辑内 `@` 出选择器且派生 payload 断言；扩展 AGC 资源工作台 V3 端到端验收用例	2026-09-12 16:44:55 +08:00
suzmii	dc243b0d57	资源工作台「替换素材」候选窗接上预览管线，补齐候选排序、禁用态可读性与删除素材入口 ... - 「替换素材」候选卡缩略图接入资源卡同一条预览管线：新增 ResourcePreviewMedia，复用同一份预览身份、同一条队列与 LRU 缓存，不再只渲染类型占位图标 - 预览 hook 暴露 sweepVisiblePreviews：弹窗内容挂在 portal 下、不在资源画本 observer 的 root 子树内，改为在「弹窗打开」与「候选区滚动」两个几何变化点显式按同一套视口几何判据兜底放行，不新增第二条加载通路 - 候选排序抽出纯函数 sortResourceReplacementCandidates：可替换（无硬门禁失败）的排最前，其余按后端原名次跟随且仍渲染但禁用；判据与弹窗禁用状态同源，不会出现「排最前却点不动」 - 抽出纯函数 projectResourcesByManifestAssetId，让弹窗素材映射与候选缩略图共用同一份资源投影口径 - 共享选择弹窗的禁用态不再整卡压透明度：变灰只压在缩略图与名称上，「分类不同」这类禁用原因保持全对比度可读（网页端美术画布不传禁用原因，视觉逐字不变） - 资源卡选中工具条末位新增「删除素材」，前置共享工具条同一套分隔线与前面的非破坏性动作隔开，只在 manifestAssetId 存在时才渲染 - 删除流程抽成 useResourceAssetDeleteFlow（读引用信息 → ResourceAssetDeleteDialog 二次确认 → delete_local_project_asset 的 deleteReferencedVersions 三分支），工具条与面板共用同一份实现，没有第二套删除 - 「编辑素材标签」面板底部只留右下角一个「添加」：点它把输入框内容（含未按回车的尾巴）落成 pill 并按现有写入路径保存，分类仍原样回传落盘原值；删除素材/取消/保存标签三个按钮移除，关闭仍走头部 × - 标签 pill 内的删除标签按钮保持不变 - 更新与补充用例：候选排序、排序与禁用同源、候选缩略图真链路与滚动兜底放行、工具条删除入口位置与 IPC 载荷、连带删除分支、面板无删除入口与「添加」语义、禁用态可读性类名契约、工具条动作清单	2026-09-12 15:30:38 +08:00
lhk229	832f1e8b59	修复策划项目重开运行态恢复 ... 持久化策划项目 design 运行模式并在重开时恢复 design/game 工作台。 补充旧策划会话兼容判断、前端夹具和恢复回归测试。	2026-09-12 06:41:49 +00: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
lhk229	8853e3b48e	完善策划调试入口与顾问态切换 ... 统一策划 Debug 日志、快速推进按钮和快速推进命令的开关。 将做成游戏入口放到顾问阶段条末尾并接入正常运行时切换。 登记策划产物资产并补充工作区调试入口测试与技术文档。	2026-09-12 05:06:48 +00:00
lhk229	22c4807612	删除策划对话栏未接通的文件浏览死接线 ... DesignAgentSurface 移除从未消费的 files 与预览 props ProjectSupervisorView 同步移除死 props 声明与透传 App 移除 designWorkspaceFiles 等状态与 refreshDesignWorkspace，每轮策划事件不再多打一次 list_design_workspace	2026-09-12 09:44:09 +08:00
lhk229	86adaa738f	修复策划首轮错 lane 挂载导致 Agent 不工作 ... 运行模式改为随项目上下文同步派生，移除 effect 后置修正 做成游戏切换记录按项目路径与创建时间定位，跨项目自动失效 消除首帧游戏运行时挂载消耗首轮 claim 后策划实例无法补发的问题	2026-09-12 00:48:02 +08:00
suzmii	006e9cc2f3	素材上传不再每次触发一次拒收提示：上传与清单配对读放进同一个函数 ... - 原缺陷：上传路径在上传**前**读 get_local_game_project_revision，上传完把那个**旧 revision** 交给 reloadManifestAfterAssetCommand；后者重新读盘拿**新清单**再打上旧 revision。上传本身会推进项目 revision（Rust advance_agent_runtime_project_revision_locked），于是这一对是撕裂的，「同 revision 不同指纹」被 projectResourceLiveUpdateModel 判成 revision-conflict —— 用户每上传一次素材就先看到一条「资源清单更新被拒收…」。 - projectResourceLiveUpdateModel.ts 新增 uploadProjectAssetFilesAndReadSnapshot：上传动作与"配对读"由同一个函数拥有，配对读复用既有 rereadAuthoritativeProjectManifestSnapshot（同一次读里配对 revision + 清单，并再读一次 revision 确认没被写盘插队）。调用方拿不到中间那个 revision，也就没有机会把它贴错。 - index.tsx 的 uploadResourcePanelFiles 改用它，删掉上传前那次 revision 读取与旧 revision 的传递。 - 附带文案误报：describeProjectManifestMergeRejection 的 unresolved 文案由「重新读取磁盘清单失败，请重新打开项目」改为「未能按磁盘清单重新对齐，请重新打开项目」。unresolved 有三条进入路径，其中两条**重读是成功的**（读到的一对比手上旧、或读到的是撕裂的一对），写成"读盘失败"是误报；新文案对所有路径都成立。WorkspaceLauncher.tsx 在"读到了但不采用"那一支补注释说明 stage 不是读失败。 - 断言：projectResourceLiveUpdateModel.test.ts 新增「素材上传后的清单快照必须配对」——假后端在上传时推进 revision，断言 merge 判 accepted 且 projectManifestMergeRejectionDecision 为 null（即"上传一次不产生拒收提示"），并附一条对照钉子显式写出旧形状、断言它必被判 revision-conflict；另新增 unresolved 文案不得包含"读取磁盘清单失败"的用例。 - 变异验证（提交前已跑）：把 uploadProjectAssetFilesAndReadSnapshot 还原成"上传前读 revision + 上传后读清单"→ 配对用例变红（并给出 revision-conflict 的失败信息），还原后复跑 15 passed。 - 门禁：projectResourceLiveUpdateModel 15 passed、workspaceLauncherManifestMerge 5 passed。	2026-09-11 21:33:54 +08:00
lhk229	c2f2b9867a	修复策划项目首轮运行模式初始化 ... 规划项目首次挂载时保持 planning lane 保留切换游戏运行态后的 DirectProject 分流	2026-09-11 13:32:18 +00:00
lhk229	d77d0ca9eb	修复顾问态切换游戏后的策划分流 ... 统一 runtime mode 下的 planningStartMode 游戏运行态拒绝策划 Agent 续轮与阶段审批 补充游戏态运行时守卫测试	2026-09-11 13:11:03 +00:00
lhk229	5646824daf	补充策划Agent思考展示预留 ... 增加策划 Agent reasoningText 事件字段与默认折叠展示入口 补充正文、思考过程和工具状态的字体层级样式 记录当前 Provider 尚未输出 reasoning 的现状与后续边界	2026-09-11 13:02:55 +00:00
suzmii	a0d1fca30a	拒收提示不再被"进入项目"那一次清除吃掉：只在真的换项目时清 ... - 现象：打开项目这一提交里刚落下的拒收提示，会被同一次 [projectPath] 变化的清除 effect 清掉 —— 资产命令在项目刚打开后马上推送清单快照正是主场景，提示于是时有时无； - 改法：新增 manifestMergeNoticeScopeRef 记录上一次观察到的项目路径，undefined → 路径（首次进入）时不清；只有真正的 A→B 换项目或关掉项目才清提示与在飞标记； - 断言：新增"换项目必须清掉上一个项目的拒收提示"用例（确定性反向钉子，防止把清除整个删掉）； - 用例加固：拒收提示的三处断言改为每轮重新查询 DOM（阶段切换时 React 可能替换节点，抓着旧引用会在负载下瞬时红），异步恢复等待放宽到 4s； - 说明：这次加固的起因是一次偶发红（expected undefined to be 'revision-conflict'）。事后在改动前后各跑 18/28 轮未能复现"去掉护栏必红"，所以此处不声称护栏就是那次偶发的成因；护栏本身修的是同一提交窗口被清除这一确定性缺陷，长时压测（4 路并发同时跑两个用例文件）全绿。	2026-09-11 20:22:52 +08:00
lhk229	8528c5ffce	修复直接创作首轮消息被误抑制 ... 仅在顾问态切换到 GameAgent 时禁止自动首轮调用 恢复普通直接创作入口的初始需求投递	2026-09-11 12:12:24 +00:00
suzmii	e765c9f8a6	资源卡工具条接通「生成动画」：只放行真能跑通的角色图派生 ... - resourceCanvasToolbarModel：只有在「已登记的栅格角色图」上放行 character-animation （非角色 / 未登记为正式素材 / 非栅格三类都不放行；Rust 侧角色动画要解码源图取宽高，SVG 必失败）；其余动作仍按 opt-in 不渲染，并写明不做它们各自的阻塞证据。 - index.tsx：把源解析与 revision 缓存抽成 resolveResourceDeriveSource，快速编辑与生成动画共用，避免同一个源在两条链路上得到两份 manifest 视图；新增生成动画的源/浮层状态、请求身份（与快速编辑同一套「提示词变了才重铸」口径）与打开/提交/关闭时机。 - 面板复用共享 ImageCanvasCharacterAnimationPanelView，参数入口显式关闭（比例/时长/清晰度与模型由客户端 Rust 固定为 same/720p/32 帧/4 秒/seedance2.0-fast，改它不改变请求）；档位常量与 Rust 常量同值，泥点价按同一算法算，避免按钮上出现与实际计费不符的数字。 - 「改造」(redraw) 不再另起入口：其语义由既有「快速编辑」承担，接独立按钮只是同链路重复入口。 - 断言改写（四不写）：角色资源那条由「只放行快速编辑与下载」改写为「放行生成动画」，并新增三条反向守卫（非角色图片 / 角色图未登记 / 非栅格角色图均不放行）。 - 端到端新增「从角色资源卡生成动画」：断言 editKind/generationMode/prompt/assetName/sourceAssetId 与泥点价档位，并断言参数入口不存在。	2026-09-11 20:08:22 +08:00
suzmii	3245739385	前端改成直接替换：不切版本、尺寸规格降级为提示 ... - 口径跟进：前端从「版本级替换」改成「直接替换」——成功后**不再切换版本**（没有新版本可切），只重读 manifest；「当前使用」高亮会随新绑定自动移动（改的仍是同一个源版本） - resourceVersionReplacementModel：兼容性判据的展示口径收窄为「硬门禁只有分类与类型」，尺寸规格不再产生禁用原因，改为非阻断提示「格式与源素材不同」；新增 resourceReplacementWarning 与 resourceReplacementAssetHints；类型去掉 parentVersionId、加上 warning - index.tsx：confirmResourceVersionReplacement 去掉 selectActiveVersion 调用，失败仍保留弹窗与选择并显示原因（不切版本、不动高亮、不提示成功）；新增 hint 映射并传给弹窗 - ImageCanvasProjectAssetPickerDialog：以可选 prop assetHints 扩展（默认 undefined → 不渲染），用于展示"可选但有差异"的提示；与 assetBlockedReasons 的区别是提示不改变可点性，默认行为仍逐字不变 - 失败文案补一条：版本写入边界拒绝（「不可修改、删除或重排」）翻成「替换被项目版本写入边界拒绝，请刷新项目后重试」，不让用户看到内部口径原文 - 用例改造：模型 9 条（尺寸规格不再禁用、提示表只收可选候选、提示不覆盖真正的不兼容原因、边界拒绝文案）、真链路 4 条（候选弹窗禁用硬门禁项 + 格式提示仍可选、写入载荷精确、成功后不切版本且不重载预览、失败保留弹窗且不重读 manifest、候选读取失败不弹空壳弹窗） - 验证：两个前端用例文件 13 passed / 0 failed；npm run ai-game-creator-shell:typecheck（含 check-config）exit 0	2026-09-11 20:03:44 +08:00
lhk229	3047434b33	接入策划顾问态做成游戏运行时切换 ... 新增项目 Agent 运行时模式持久化与恢复判断 在顾问态增加做成游戏按钮并切换同项目 DirectProject 切换时不自动发起首轮 Provider 请求	2026-09-11 12:01:38 +00:00
suzmii	f88e6aa5fe	清单快照被拒收不再静默：可见提示 + 强制重读磁盘真相 ... - WorkspaceLauncher：applyManifestSnapshot 拒收分支此前直接 return，改为必须先留痕（console.warn 记 decision/source/两个 revision）再走恢复； - 新增 manifestMergeNotice 状态与提示条，DOM 暴露 data-manifest-merge-decision / -stage / -source / -held-revision / -snapshot-revision 作为排障观察点； - 新增 recoverRejectedManifestSnapshot：重读磁盘 revision + 清单并重建 merge 状态，把被拒快照漏掉的新资源真正带进项目上下文； - 同一项目只允许一条恢复在飞，避免拒收成串到达时打满读取槽； - 重读期间若有更新的快照已被接受，绝不回退 revision（宁可报未解决，不放宽 CAS）； - scope-mismatch 仍只记日志不弹提示：串项目的快照对用户没有可执行语义； - projectResourceLiveUpdateModel：新增拒收判定、三阶段文案与 rereadAuthoritativeProjectManifestSnapshot（两次读 revision 夹一次读清单，撕裂就放弃）； - styles.css：新增 .launcher-manifest-merge-notices 绝对定位提示位，容器不吃点击，与 .game-resource-book-notices 同口径； - 新增 apps/ai-game-creator-shell/tests/workspaceLauncherManifestMerge.test.tsx：拒收可见 + 重读采纳 + 重读失败报未解决 + 不回退 revision + 串项目快照保持静默； - projectResourceLiveUpdateModel.test.ts 追加拒收可见性/重读三读/撕裂放弃/跨项目拒绝/revision 非法/三阶段文案可区分六条断言。	2026-09-11 19:23:25 +08:00
lhk229	811abdd375	修复策划 Agent 四个审查问题 ... 修复 Retry 流式回合身份与阶段审批 transient 清理 拒绝无效 write_file 内容并补齐顾问阶段导轨	2026-09-11 10:57:49 +00:00
suzmii	097d86d337	接线 AGC 版本级资源替换的前端链路与弹窗复用 ... - 新增 resourceVersionReplacementTransport.ts：两个 IPC 边界（read_..._candidates / replace_..._resource）只传一个 input 对象，不在客户端内执行时明确报错；这两个 invoke 调用点是 check-config.mjs「每个 Tauri 命令都要有 App invoke 调用方」的落点 - 新增 resourceVersionReplacementModel.ts：PRD §5.3 的 ProjectVersionResourceReplacement / 兼容性类型、禁用原因与失败文案映射、候选→弹窗素材映射；判据不在前端重算，只做呈现 - 候选→弹窗素材复用资源投影口径（resourceCanvasMediaType / resourceCanvasAssetKind），src 固定为空串，缩略图交给弹窗的 renderAssetMedia，不给 img 喂空 src - ImageCanvasProjectAssetPickerDialog 以 6 个可选 prop 扩展：singleSelect / assetBlockedReasons / renderAssetMedia / selectionNoun / errorMessage 与新的禁用原因文案；全部默认值保持网页端美术画布行为逐字不变（默认仍是多选、仍是 img、仍是「参考图」文案、不渲染禁用与错误区） - project-development/index.tsx 接线：状态与处理函数（读候选→开弹窗→CAS 写入→重读 manifest→selectActiveVersion），失败保留弹窗并显示原因，候选读取失败不弹空壳弹窗而是说明原因；本提交暂不放行工具条入口 - styles.css 增 .game-resource-replacement-media：候选行的类型占位样式，避免挂破图	2026-09-11 17:42:00 +08:00
suzmii	a4bec3d018	记下「不再提醒」偏好保持单键、不按入口分域的理由 ... - 该键关掉的只有聊天输入区的「发送前提醒」；资源侧生成素材与快速编辑没有可关的提醒，润色是显式按钮动作 - 分域只在「每个入口都有可关的提醒」时才有意义，现在分域等于给不存在的提醒提前留位 - 只补注释，不改行为与断言	2026-09-11 17:06:35 +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	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	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
lhk229	e6e2a5fda6	调整策划项目命名 ... 策划入口使用带随机短码的策划项目名称 保留游戏与素材入口的现有命名链路 补充自动建项测试与技术方案说明	2026-09-11 07:35:41 +00: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
lhk229	123c699db9	修复策划澄清卡自由文本回答 ... 将自由文本与选项回答分开提交 补充澄清卡回归测试和迁移方案说明	2026-09-11 06:44:47 +00:00
lhk229	8444dee9e9	优化策划工作区后台刷新体验 ... 合并 Agent 工具事件并避免刷新时清空文件树 仅首次打开和手动刷新显示加载状态	2026-09-11 05:28:05 +00:00
lhk229	26169102a0	修复策划工作区文件树显示 ... 改用可展开的层级目录树显示文件 保留相对路径读取并修复目录内产物不可见问题	2026-09-11 05:16:39 +00: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	3ed567d99a	运行视图的自动切换只认会话内确认过的预览 ... - index.tsx：自动切运行的那条 effect 从「合并后的预览 URL」收窄为「会话预览 URL」（resolveEmbeddedPreviewUrl(previewOverride)）。manifest.preview 是"上次留下的一条落盘记录"：预览服务器是进程内线程、非 Linux 端口还是随机临时端口，客户端退出后记录仍会写着 running，照着它自动切视图就是把用户丢进一个打不开的运行界面。运行入口（运行 tab、播放按钮）与 runAvailable 一行未动，PRD §4.1「运行入口不可用时仍允许点击…但不切换状态」继续成立。 - useHomeProjectCreation.ts：enterProjectDevelopment 不再把 context.manifest.preview 播种成本次会话的预览（改为 null）。会话预览此后只由活体确认（下一提交）与本次会话里 preview.start / preview.status 的返回值经 onPreviewChange 回流两处写入。 - 有意接受的代价：「回到仍在运行的预览」从自动变成用户点一下「运行」；下一提交会把"确实还在跑"这条路径按活体确认接回自动进入。 - project-development.suite.ts：新增两条用例——① 仅 manifest.preview 为 running（不传 preview）时初始仍是「资源管理」、运行 tab 仍可用、点一下仍能进运行视图；② 会话预览为 running 时自动切到运行表现层。 - 变异验证：把这条 effect 还原成读合并后的 URL（即撤掉本次收窄），用例①立即红灯（已实测）。	2026-09-11 12:07:44 +08:00
lhk229	87711e4034	修复策划审批按钮的界面测试回归 ... 补齐批准和继续修改按钮的无障碍名称 同步审批按钮文档并通过 389 个界面用例	2026-09-11 04:03:21 +00:00
lhk229	9345236b93	重构策划 Agent 工作台界面 ... 新增始终可见的策划工作区与文件预览 复用 GameAgent 双栏布局并调整审批澄清交互 审批按钮改为文字与图标并保留现有 Runtime 行为	2026-09-11 03:34:56 +00:00
suzmii	14d1635858	修复游戏版本时间显示 1970 年：createdAt 按 Unix 秒换算成毫秒 ... - 写入侧真实单位是 Unix 秒：project/manifest.rs 的 GameIterationVersion.created_at 赋值为 unix_timestamp()，该函数返回 duration.as_secs() - formatIterationVersionLabel 原来把秒值直接交给 new Date()，被当成毫秒解释，真机因此显示 1970/1/22（1788075047 毫秒 = 1970/1/22 00:41:15，与截图逐秒吻合） - 显示侧改为 new Date(version.createdAt * 1000)，与 ResourceAssetDeleteDialog 和待确认资源编辑创建时间标签的既有秒口径一致 - 给 GameIterationVersion.createdAt 补契约注释，写明单位是 Unix 秒及换算要求，避免后续再按毫秒消费 - resourceCanvasVersionBindingModel 夹具由毫秒改为真实秒值，并用真机取值 1788075047 补断言：年月日必须是 2026/8/30 而不是 1970 - resourceVersionSwitch 夹具同步改为真实秒值，避免继续沿用误导性的毫秒夹具	2026-09-10 21:00:54 +08:00
suzmii	2f8753f597	AGC 资源画布切换为 6 类资产分类加项目版本栏目（阶段二：投影轴与栏目表落地） ... - 契约层把 ProjectResourceCanvasPosition.section 加宽为 PersistedProjectResourceCanvasSection 并删除旧 ProjectResourceCanvasSection 联合 - 七个分区类型消费点改用 ProjectResourceCanvasCategory：投影、布局模型、布局 Hook、分区高度、依赖图层与画布历史 - RESOURCE_CANVAS_SECTION_ORDER 改为 PROJECT_RESOURCE_CANVAS_SECTIONS，删除 RESOURCE_CANVAS_VISIBLE_SECTION_ORDER - reconcileResourceCanvasLayout 接入读时归一化：旧栏目值按资源当前分区改写 section，坐标与手动标记原样保留 - 归并后的布局与原布局逐项不同，由既有协调路径判定 changed 并写回一次新分区，不引入迁移脚本 - 投影层五个资源入表点统一走 projectResourceCanvasCategory：项目版本独立成栏、Agent 回执归文档、其余按资产分类 - 新增 projectResourceDisplayKind 收敛 manifest 资产 subtype 即 kind 的显示类型口径，projectResourceTypeLabel 不再依赖旧栏目 - 卡片预览、编辑分流、媒体工具条、预览文案与画布历史快照改用显示类型与新分区，历史快照入栈时收窄到现行分区 - index.tsx 删除可见栏目导入与 visibleCategoryOrder，栏目标签由资源筛选唯一中文口径派生并补齐 7 栏 - index.tsx 补齐 7 栏默认视口与 7 个栏目图标（新增 LayoutGrid、Users、PackageOpen，移除已无用的 Code2） - index.tsx 删除 canvasResources 的 code 过滤：只登记游戏代码的项目现在落在待归类栏目并正常显示卡片 - 新增只登记游戏代码项目的 UI 回归用例，覆盖栏目大纲、默认落地栏目与代码卡片渲染 - 测试夹具按新分区轴迁移，新增旧栏目 sidecar 读时归并用例与栏目顺序用例 - 共享测试 harness 的资源卡查询正则允许栏目标签自带空格（UI 交互） - 同步 PRD 与共享记忆决策记录的栏目口径描述	2026-09-10 20:41:19 +08:00
suzmii	cb76aadb48	AGC 输入区三处观感修复：AI 润色归位、@ 面板筛选条单行、引用 chip 原子化 ... - styles.css：把 direct-codex composer 下广播式的 `.project-supervisor-composer button` 规则 收窄到 `.project-supervisor-submit-button`（含 svg 那条与 media query 里那条）， 并给 `.resource-reference-input-actions` 补 `grid-column: 1 / -1` 让输入区操作排独占一行 - styles.css：`.resource-reference-input-actions` / `.resource-reference-input-at` 撤掉绝对定位， 操作排回到网格文档流，与输入框右下角对齐，不再浮在文本区中间 - styles.css：`.resource-reference-input-polish` 与 `.resource-reference-input-restore` 并入 `@` 按钮同一条尺寸规则（28px 方钮、8px 圆角、同 hover/disabled 观感） - styles.css：输入区状态行（润色中/润色失败）改为与应用排同一行，不再单独占一行顶高 22.8px - styles.css：direct-codex 输入框 padding 收为 `12px 15px 6px`，窄屏 `10px 12px 6px` - styles.css：`.resource-reference-chip` 的 `×` 删除按钮不再被 broadcast 规则摘出 chip - PlatformSegmentedTabs.tsx：分段页签 item 加 `whitespace-nowrap`，中文不再逐字竖排 - packages/shared/styles.css：补 `.scrollbar-hide` 实现（该类名一直被 `layout="scroll"` 引用但仓库未定义） - ResourceReferenceNode.tsx：`getTextContent()` 改为单个 U+FFFC 占位符并显式实现 `getTextContentSize()`，引用成为真正的原子内联节点（1 个引用 = 1 个字符） - tests/resourceReferenceInput.test.tsx：新增「1 个引用 = 1 个字符」与「chip 自带删除、一次删净」两条断言 - tests/appSurface/project-development.suite.ts：把 composer 按钮样式断言收窄到提交按钮， 并新增一条反向断言，钉住「广播到 composer 下所有 button」的规则不再出现	2026-09-10 19:05:57 +08:00