2454 Commits

Author	SHA1	Message	Date
suzmii	5e29b1bb57	预览链去掉无消费者的摘要计算，并为预览读取加进程内 manifest 缓存 ... - 资源卡预览不再计算 SHA-256：`AgentRuntimeInspectionImage.sha256` 改为 `Option<String>`，读取函数新增 `include_sha256` 开关，门禁、分块读取、漂移与重开身份复核、签名与尺寸校验仍只有一份实现，只在末尾按调用方决定是否算摘要。预览路径传 `false`（它的 `LocalProjectImagePreview` 从来不消费摘要），Agent `image.inspect` 路径继续传 `true`。 - 取摘要改为 `sha256_digest() -> Result`，缺摘要失败关闭；`project_gates.rs` 提前算成 `image_sha256` 再进判定闭包，避免退化成「空摘要 == 记录里的空摘要」而静默通过视觉检查复核；`runtime_tools/media.rs` 改用仓库既有的 `match { Err => return failed observation }` 风格，不引入新的 panic 面。 - 新增 `read_manifest_cached_for_preview`，只接到 `read_local_project_image_preview_at`、`read_local_project_text_preview_at`、`read_local_project_media_preview_at` 三个预览命令，消掉一次画布装载中「每张卡片各读并解析一遍同一份 manifest」的重复开销。`read_manifest` 本体、`read_manifest_for_project` 和写入路径的安装后回读一字未动。 - 缓存命中判据每次重新获取当前文件身份：路径复核 + 非符号链接或 reparse point + 普通文件 + 长度 + mtime + 文件身份（Windows `(volume serial, file index)`，Unix `(dev, ino)`）；失败一律不入缓存，错误语义与 `read_manifest` 完全一致。为此放开 `metadata_is_windows_reparse_point` 为 `pub(crate)` 并新增跨平台 `open_file_identity_key`。 - 写入侧硬做失效：`write_manifest_with_lock_hook` 成功写入后调用 `forget_preview_manifest`。只靠长度 + mtime + 身份堵不住同长度原地改写，显式失效后正确性不再依赖时间戳粒度，读取侧身份复核保留为兜底。 - 收益如实记录：真机项目实测 52 次 manifest 读加解析约 10 ms 量级，并省下约 3.15 MiB 重复磁盘读取。这是消除重复工作的正确改动，但不是性能救命项；用户感知的加载耗时大头仍在资源卡图片解码。 - 决策记录补「AGC 资源卡预览维持 data URL 加纯内存 LRU，不引入 Tauri asset 协议」：正式否决该候选路径，写明原始合同原文（不向 WebView 暴露任意本机文件协议或绝对路径）、打通所需配置（`assetProtocol` 加 `protocol-asset` feature 加 scope 只能 `**/*`）、会绕过的全部门禁（`file.read` 权限、项目边界、登记复核、敏感路径、父目录链接、硬链接、读取漂移与重开身份、按魔术字类型校验、尺寸上限、取消语义与全局 3 permit），以及收益与代价不成比例；同时否决磁盘缩略图缓存。 - `pitfalls.md` 补同题排障口径，含判据陷阱：把「每次启动重读」当成本瓶颈是错的，真机 52 张 PNG 分层实测 Rust 加 JS 合计仅约 0.3 s。	2026-09-11 00:57:33 +08:00
suzmii	30acd9552c	写入侧产出 canonical kind，读取侧读时重派生自愈存量分类 ... - 写入侧：infer_canvas_export_asset_kind 直接返回 canonical kind（animation → character-animation、ui → ui-design、asset → image），不再让别名表替写入侧兜底 - 写入侧补防御性归一，并新增 canvas_export_asset_kind_is_always_canonical 逐分支钉死返回值为 canonical、且不再写回 ui / animation / asset - 读取侧：gameCreationAppAssetCategory 加收窄覆盖规则——落盘 category 为 unclassified 且 kind 能派生出明确非 unclassified 分类时采用派生值 - 该规则不写迁移脚本、永久自愈：真机 57 条 ui 资产待归类从 58 降到 1，UI 交互从 2 升到 59，仅剩 code 类 game-entry 在待归类（分类表设计口径） - 收窄条件把覆盖窗口压到最小：落盘值本身是明确分类时仍信任落盘值（保留用户在分类与标签面板手动设置的权威性） - kind 派生结果本身即 unclassified 的 image / video / code / publication-material 不受影响，补断言钉住 - resourceCardPreviewRealManifest 由「记录缺陷」改为「守住修复」：断言归位后的 58 → 1 分布与 57 条 ui 全部落 UI 交互 - PRD 与 pitfalls 补记分类取值优先级、读时自愈规则、唯一盲区（手动把可明确分类的资产设为待归类会被覆盖）及写入侧 canonical 化	2026-09-10 23:15:04 +08:00
suzmii	b87120445c	Merge remote-tracking branch 'origin/master' into feat/agc-canvas-resource-workbench-v3	2026-09-10 21:24:05 +08:00
suzmii	df9c32b5ea	记录 kind 别名只救新登记不救存量 category 的陷阱 ... - 补记 ui 资产落待归类的完整成因链：kind 兜底 image 再经 image → unclassified 误分 - 写明 register_local_asset_entry 命中同路径时不重算 category，故存量 57 条无法自愈 - 写明读取侧必须信任落盘 category 的原因：存在用户手动改分类的正式链路 - 列出三个根治选项供拍板：读时重派生 / 一次性回填 / 只改写入侧 - 记录别名表在 TS 与 Rust 各有一份实现、必须成对维护，以及交叉守卫位置	2026-09-10 21:19:19 +08:00
suzmii	df4168f71f	记录资源预览读取分支与版本时间的排查口径 ... - PRD 明确队列身份用的 category 是资源分区栏目、只用于前端去重与布局，不作为 IPC 入参 - PRD 明确 read_local_project_media_preview 的线上 category 是原生读取分支，只接受 art / audio，须由卡片预览类型派生 - pitfalls 新增「媒体预览 category 是读取分支而非栏目」：记录阶段二把用例一起改成错误行为导致门禁失守，并写明现有守卫位置与实测失败口径 - pitfalls 新增「versions[].createdAt 是 Unix 秒」：记录夹具与实现一起错导致门禁失真，以及已知秒值断言年月日的验收口径	2026-09-10 21:05:30 +08:00
suzmii	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	eda34187fc	修复 AGC 资源栏目大纲常态不可读：恢复 Dock 底板、栏目图标与完整文字 ... - styles.css：`.game-resource-outline` 常态从 `opacity: 0.68` + `scale(0.86)` + 透明底 + 无阴影，改回完整尺寸（`opacity: 1`、`transform: translateY(-50%)`）并给现有视觉语言的 Dock 底板（`--platform-subpanel-border` 边框 + `--platform-nav-fill` 背景 + 与右下角缩放 Dock 同款阴影 + `blur(6px)`）。 - styles.css：`.game-resource-outline button` 常态列宽由 `0 minmax(0,1fr)` 改为 `18px minmax(0,1fr)`、`gap: 6px`，栏目图标常态 width 14px / opacity 1，不再只在悬停时才出现。 - styles.css：栏目文字 11px → 12px；当前栏目（`.is-active`）常态就带 `--platform-nav-active-*` 的边框、底色和阴影，用户一眼能认出当前分区。 - styles.css：悬停/键盘聚焦保留为同一套 token 的加强（更深的边框、`--platform-nav-active-shadow`、`blur(10px)`），不再靠"常态缩到只剩文字"表达层级。 - 不改交互语义：大纲仍然是 `openResourceBookChild` 的入口，按钮 key、aria-label、aria-current 与未读小圆点全部保持原样。 - 测试：新增 CSS 声明级断言，钉住常态不降透明度、不 scale、有底板，图标常态 14px 且文字 12px（jsdom 不加载 styles.css，可见性只能钉声明）。 - 测试：新增 DOM 用例，断言每条栏目入口同时具备图标与栏目文字，且切换栏目后当前项带 `aria-current="page"`。 - 文档：同步《GameAgent资源自由画板与快速编辑》的「操作边界」与「验收」两条，把"常态缩小、只露栏目文字"改成"常态即可读可点"，并同步 pitfalls 里的对应口径。	2026-09-10 20:11:09 +08:00
suzmii	9196ba3c96	修复 AGC 资源画本框选没有任何颜色：给画本场景根补共享画布根类 ... - index.tsx：`ResourceBookScene` 的场景根 `.game-resource-book-scene` 补上 `genarrative-image-canvas` 类，让共享 `SelectionOverlay` 的框选 token 有定义它的祖先。 - 根因：共享选择框的 `border: 1px solid var(--genarrative-image-canvas-selection-border)` / `background: var(--genarrative-image-canvas-selection-fill)` 没有 fallback，这两个 token 只声明在 `packages/image-canvas-react/src/styles.css` 的 `.genarrative-image-canvas` 根类里，而该根类由共享 `CanvasViewport` 渲染；AGC 只渲染 `SelectionOverlay`、从不渲染根类，声明在计算值阶段被整条丢弃，用户框选时看不到任何选择框。 - 安全性：该根类只有 3 条自定义属性声明、无布局副作用，加 className 不改布局。 - 测试：新增真实 `pointerdown` / `pointermove` 框选用例，断言选择框存在、内联几何非空，且最近的 `.genarrative-image-canvas` 祖先就是画本场景根；去掉根类后该用例失败（已实测）。 - 测试：新增 CSS 声明级断言，钉住根类的描边/底色 token 存在且非透明，消费端仍按 var() 取值（jsdom 拿不到计算色，这里只能钉声明）。 - pitfalls.md：补记"复用共享画布子组件要自己渲染根类"的排查口径。	2026-09-10 20:00:42 +08:00
suzmii	6f09bf3a00	AGC 资源画布分区轴改为 6 类资产分类加独立项目版本栏目（阶段一：契约与读时映射） ... - 契约层新增 PROJECT_RESOURCE_CANVAS_SECTIONS：6 类资产分类加末尾独立的项目版本栏目，并补齐分区类型 - 契约层新增旧四 / 五栏目取值白名单、Persisted 联合类型与两个类型守卫 - Rust 契约 ProjectResourceCanvasSection 增补 7 个现行 variant 并保留 Code / Art 旧值，新增同名分区常量 - Rust 契约不升 game-creator-resource-layout.v1 版本、不给未知 section 加兜底，损坏 payload 继续失败关闭 - 新增 resourceCanvasSectionMapping.ts：旧栏目到现行分区的映射表、回落栏目与读时归一化 - 读时归一化只改写 section，x / y / manuallyPlaced 原样保留，无法归并时沿用既有丢弃行为 - resourceProjectionModel 把扩展名分类器更名为 projectedResourceKind 并收敛为准入与显示类型 - resourceProjectionModel 新增 projectResourceCanvasCategory：项目版本独立成栏、Agent 回执归文档、其余按资产分类 - Rust resource_layout 测试夹具改用现行分区值，并新增既有旧 section sidecar 仍可读取的用例 - 新增 resourceCanvasSectionMapping 测试：旧值乘目标栏目矩阵覆盖坐标保留、section 改写、changed 判定与回落列不变量 - projectResourceProjectionModel 测试新增 7 栏分区投影、项目版本独立成栏与只登记游戏代码项目落在待归类 - 同步 PRD、GameAgent 资源自由画板技术方案、AGC 实施计划与共享记忆决策记录的分区口径	2026-09-10 19:57:34 +08:00
suzmii	180a157982	同步 pitfalls 中失效的 ACL 桩名称并补注入点说明 ... - pitfalls.md：把「测试超时补充」里引用的 persistenceOptions 改为当前实际使用的 skippedWindowsAclOptions，避免文档指向已不存在的名称。 - pitfalls.md：补一句 prepareSwarmTestRuntimeConfig 暴露的可选 secureWindowsPath 注入点、默认 null 走真实实现，以及单次调用最多加固 3 次的事实。	2026-09-10 19:56:02 +08:00
suzmii	fc5adf48aa	记录 AGC 配置向导单测的 Windows DACL 子进程超时坑 ... - pitfalls.md：在「终端真实测试不能混用配置参数、stdin EOF 和持续预览」下补一条测试超时补充，紧接既有的 Windows PowerShell 参数条目。 - 内容：配置向导读路径与写路径都会加固私有目录与配置文件，没拿到 secureWindowsPath 桩时 Windows 上每次调用各拉起一个真实 powershell.exe（本机实测约 0.6s / 次）；只桩写不桩读会累计 9 次加固、约 5.5s，稳定撞上 vitest 默认 5000ms 并报 Test timed out in 5000ms。 - 结论口径：只校验配置分层优先级、不校验 ACL 的用例，读写路径必须带同一份 persistenceOptions；确实要覆盖私有 ACL 的用例才保留真实加固并自行留足超时预算。	2026-09-10 19:34:04 +08:00
suzmii	7fe1fd9b64	Merge branch 'feat/agc-v3-canvas-generation-entry' into feat/agc-canvas-resource-workbench-v3	2026-09-10 17:40:49 +08:00
suzmii	94fc4c6779	Merge branch 'feat/agc-v3-c7-version-switch' into feat/agc-canvas-resource-workbench-v3	2026-09-10 17:40:46 +08:00
lhk229	9b5d1fe107	修复仓库回退配置模板被读取通道私有化 ACL 锁定 ... - config.rs 新增 game_creator_config_path_is_runtime_managed 判定，read_game_creator_config_file 按路径归属分流：AppData 托管目录内的真实凭据维持私有加固读取，仓库旁边的回退模板与 local 覆盖改用 open_project_snapshot_regular_file 非变异快照通道 - 根因：开发 CLI 无 AppHandle 时回退读取 worktree 内 git 跟踪模板，私有读通道在 Windows 上无条件收紧 DACL 为仅当前进程用户，导致其他账号与 cargo include_str! 全部 Access Denied - tests/mod.rs 新增 clear_test_runtime_config_dir 辅助 - tests/configuration.rs 新增两个回归测试锁定快照 / 私有两条读取通道的分流 - pitfalls.md 记录该排障经验与读取通道副作用白名单教训	2026-09-10 08:57:31 +00:00
suzmii	9ce31f905e	沉淀 AGC 画布现状与取数约束到共享记忆 ... - pitfalls.md 追加「AGC 走不了网页端 /api/editor 的取数链」：Tauri asset 协议 + CSP connect-src 未放行平台域名，且 dev 的 vite /api 代理会造成「能跑」假象 - pitfalls.md 追加「ImageCanvasStageView 是硬组合容器」：132 props（57 数据 + 75 回调）、无条件渲染 8 个子视图、83/132 需宿主伪造编辑器状态，且不透传 supportedActions - pitfalls.md 追加「AGC 资源画布真正自制的交互面」：resourceBookViewport.ts、resourceCanvasLayoutModel.ts 的 fit/normalize、index.tsx 3656-4090 指针段，并记录两条平移路径守卫不一致与右键菜单、chrome 样式缺口 - pitfalls.md 追加「资源画布工具条改造/角色动画按钮点了没反应」：空回调仍留在 supportedActions 里，按钮渲染但无人接	2026-09-10 16:50:02 +08:00
suzmii	6496601d12	资源画布接入生成素材入口并打通无源新建链路 ... - index.tsx 只做导入、一个生成入口按钮、一处浮层渲染与提交回调；无 invoke 桥或项目未就绪时入口不渲染 - 提交走 derive_local_project_resource 的 create 模式：sourceResourceId 为 create:<operationId>，sourceAssetId / sourcePath / sourceSubtype / producerTaskId / sourceVersionId 全为 null - 产出后经 pendingResourceFocusRef 定位并选中新素材卡，并写入生成资源已保存提示 - projectResourceLiveIntegration 补入口可见性、create 入参、重试复用 operationId 与新卡定位 2 条用例 - 实施计划文档补 C3 生成入口口径、图片无源生成未完成项与本轮验证数字	2026-09-10 16:37:52 +08:00
suzmii	f09f5f9e9c	补齐 AGC V3 收口阶段的决策记录 ... - decision-log 新增两条 2026-09-10 决策：资源画布基础能力收口（撤销重做只作用于卡片布局、独立资源面板、上传走 upload_local_asset、下载改为显式保存链路 save_local_project_asset_file + dialog:allow-save） - decision-log 新增：运行模块版本切换（版本状态唯一一份放在 WorkspaceLauncherShell、运行模块右上角 GameRunVersionPicker、切换只重载预览不做运行时资源重映射）、参考图弹窗与共享筛选条、标签库纯派生口径、素材重命名前端接线 - 同步修正上文"重命名只落 Rust 侧"的已知中间状态：前端调用方已落地，该中间状态结束	2026-09-10 16:05:01 +08:00
agent	00963c5f67	同步 AGC V3 版本切换、参考图弹窗、标签库与素材重命名 UI 的功能文档 ... - 实施计划追加 2026-09-11 条目：标签库派生口径、共享筛选条、C7 版本切换、C9 参考图弹窗、素材重命名 UI 与 allowlist 收敛 - 写明版本切换不做运行时资源重映射的理由与参考图 ID 快照的落库路径 - 记录本次门禁实际数字与 5 条待 C3 侧更新的既有失败用例	2026-09-10 15:50:54 +08:00
suzmii	d851aa83ff	补充 AGC 资源工作台 V3 的实施计划条目 ... - 新增 2026-09-10 条目，写清版本绑定恒等化与撤回运行期资源观察侧车的边界（删 asset_usage 及其 16 条测试、绑定退回恒等映射） - 写清素材删除三分支语义、deleteReferencedVersions 入参、read_local_project_asset_references 只读命令，以及版本追加唯一例外的放行集合按写入前 manifest 求值 - 写清 agc_list_registered_assets 投影新增 category/tags 且不在投影层重新派生分类 - 写清 rename_local_project_asset 的语义（文件改名 + localPath 更新、id 不变）、校验、写失败回滚与 reconciliation-required 口径，以及"不改游戏源码引用"的已知边界 - 写清 @ 面板两个页签与 activeVersionId/versions 契约、polish_local_project_prompt 的入参与计费口径（不自建计费，走 server-rs 的 LLM 路由）、发送前提醒判据与本机偏好存储 - 记录本次全部门禁数字	2026-09-10 15:02:34 +08:00
suzmii	2c07396ef7	补充 AGC 复用网页端美术画布组件的跨端依赖排障记录 ... - pitfalls 新增一条：AGC 引 src/components/image-editor 组件会经 ImageCanvasGenerationModel 的 ApiClientError 值导入链到 src/services/apiClient.ts 与 host-bridge/hostBridge.ts，而它读的 wx / ReactNativeWebView / WeixinJSBridge 只在主仓 vite-env.d.ts 声明 - 记录处置口径：在 apps/ai-game-creator-shell/src/vite-env.d.ts 的 Window 上补同名同形字段（纯类型声明零运行时影响），不要关闭 AGC 的 noImplicitAny，也不要另写平行组件 - 记录已核实的运行时结论：hostBridge.ts 模块作用域只有常量与缓存声明、无导入即执行副作用，window.wx 仅在函数体内访问且有 typeof window 守卫，故该依赖链编入 AGC bundle 是惰性的	2026-09-10 14:56:45 +08:00
suzmii	30e93c6c43	合并 WS-D 阶段一：新增本地项目素材重命名命令 ... - 解决 main.rs / project.rs / tests/mod.rs 的相邻插入冲突：main.rs 保留 read_local_project_asset_references 与 rename_local_project_asset 两条注册，project.rs 与 tests/mod.rs 只保留 mod asset_rename（asset_usage 已由 WS-A 整体删除） - 解决 decision-log.md 末尾追加冲突：保留双方条目（WS-A/口径收敛、删除新口径、C3 交互、Agent 投影 + WS-D 素材重命名）	2026-09-10 14:46:15 +08:00
suzmii	26f1a7b19c	Merge branch 'feat/agc-v3-c4-mentions' into feat/agc-canvas-resource-workbench-v3	2026-09-10 14:43:58 +08:00
suzmii	dbbca47078	同步 C4 引用补全与 C8 润色提醒的功能文档 ... - 更新【功能说明】AGC聊天素材引用：补充素材面板双页签、activeVersionId 版本回退与空态口径 - 更新【功能说明】AGC聊天素材引用：把「改名刷新显示名」「跨会话恢复光标位置」从未完成移到已完成 - 新增【功能说明】AGC聊天AI润色与发送前提醒：写明润色回填、原文快照、失败保留原文与提醒面板行为 - 新增文档同时记录提醒判据、不再提醒偏好存本机 localStorage、以及计费仍走平台 LLM 路由的边界	2026-09-10 14:42:40 +08:00
suzmii	b2477c8ca9	新增本地项目素材重命名命令（Rust 侧） ... - 新增 Tauri 命令 rename_local_project_asset（输入 projectPath / assetId / newFileName），并在 main.rs 的 generate_handler! 中注册 - 新增 project/asset_rename.rs：重命名语义为“磁盘文件改名 + manifest localPath 更新”，资产 id / kind / mediaType / source / category / tags 全部不变，imageSequenceFrames 里指向该文件的本地帧一并对齐 - 校验判据：新名非空、不含路径分隔符（同时保证不跨目录）、不含 ..、通过可移植路径组件校验、扩展名与原文件一致、同目录不得已存在同名文件、assetId 与磁盘文件必须存在 - 事务与回滚：持既有项目写锁，manifest 写入走既有 write_manifest 边界（版本数组校验 + 安装后回读一致性）；写失败把文件改回原名，回滚也失败时两个错误都报出并标记 reconciliation-required；同名重命名按空操作处理 - 新增 tests/asset_rename.rs 9 条用例：成功改名与身份不变、同名空操作、空名 / 分隔符 / .. / 跨目录 / 扩展名不一致 / 目标同名冲突 / 资产与文件缺失拒绝、manifest 写失败回滚、同目录帧对齐 - decision-log 记录素材重命名语义、命令边界，以及“前端调用方落地前 ai-game-creator-shell:typecheck 必然失败”的已知中间状态	2026-09-10 14:42:11 +08:00
suzmii	48700083a3	补齐 AGC V3 资源口径与环境约束的权威文档 ... - PRD §5.4 版本记录补充"只允许追加"的唯一例外：用户显式确认的连带删除，并写明放行集合按写入前 manifest 求值、被放行版本不得进入追加段 - decision-log 新增三条 2026-09-10 定稿：版本绑定恒等化并撤回运行期资源观察侧车；素材删除新口径（三分支 + 可选连带删除版本）；资源画布交互 1:1 复刻美术画布（取消资源详情面板与全屏编辑路由、复用共享组件以可选 prop opt-in、AGC 宿主自备 chrome 样式） - pitfalls 新增四条：新工作树的 cargo 必须在 npm ci 之后跑；残留 dev stack 会拖死 Rust 门禁；改共享美术画布组件时 AGC 门禁覆盖不到它自己的测试；AGC 侧没有 image-canvas-editor__* chrome 样式	2026-09-10 14:26:57 +08:00
suzmii	c1ffb2386b	资源功能分类与自定义标签：筛选口径收敛为 category 并接入写入 UI ... - 删除 resourceReferences.ts 中 mediaType 优先的 7 桶筛选口径与 resourceReferenceFilterKind，改由 resourceReferenceCategory / resourceReferenceMatchesCategoryFilter 以 manifest 资产 category 为唯一权威筛选口径 - RESOURCE_REFERENCE_FILTERS 改为 6 类 + 全部（全部 / UI 交互 / 角色与对象 / 场景与环境 / 音频 / 文档 / 待归类），并新增 resourceReferenceCategoryLabel 让中文名只定义一处 - ResourceReference 新增 category / tags，由 resourceReferenceFromAsset 经 gameCreationAppAssetCategory / gameCreationAppAssetTags 从 manifest 资产投影；资源画布 ProjectResource 同步新增 assetCategory / assetTags 投影与 projectResourceAssetCategory 待归类兜底 - 新增 Tauri 命令 update_local_project_resource_classification 与 UpdateLocalProjectResourceClassificationInput/Result，实现落在 project/manifest.rs 的 update_manifest_asset_classification_at，复用既有 mutate_manifest_at manifest 写锁与原子写入 - 命令持项目写锁后按 expectedProjectId / expectedProjectRevision 做 CAS，冲突分别返回 project-identity-conflict 与 project-revision-conflict；category 非 6 个合法值即报错且不回退到 kind 派生；tags 走 normalize_game_creation_app_asset_tags；只改目标条目的 category / tags 并在成功后推进一次项目 revision - 新增 Rust 定向测试 project/manifest/classification_tests.rs：更新成功、非法分类被拒、tags 归一化、未引用资产更新不影响其它字段、revision/CAS 与既有写入一致、输入拒绝未知字段 - 前端新增 ResourceClassificationPanel（ThemedModal + PlatformSegmentedTabs + PlatformTextField），资源详情面板以「分类与标签」按钮打开独立面板，保存后重读 manifest 并经 onManifestChange 反映到筛选与投影 - @ 面板与资源画布共用 packages/shared 的 PlatformSegmentedTabs 渲染同一组功能分类标签；画布筛选状态与画布视口一样按「按依赖 / 按类型」分别保存，复用既有 sortMode 状态形状 - 更新 resourceReferenceInput.test.tsx 与 projectResourceProjectionModel.test.ts 覆盖新口径，新增 resourceClassificationPanel.test.tsx 覆盖写入命令的输入归一化与失败不回退 - 同步技术方案与 decision-log：记录按 mediaType 分类到按 category 分类的语义变化（图片 / 视频桶消失，image / video / code / publication-material 归待归类）与新写入命令契约	2026-09-10 10:25:22 +08:00
suzmii	3f5d3b43af	合并最新 master 到 AGC V3 资源画布分支 ... - 合入 origin/master 6 个提交（#313 项目写锁残留回收与启动诊断、#315 AGC Ctrl+C 残留后端修复） - 冲突解决：decision-log.md 保留 V3 两条 2026-09-09 决策与 master 的写锁回收条目 - 冲突解决：pitfalls.md 保留 V3 转场经验条目与 master 的 Ctrl+C 后端残留条目	2026-09-09 21:46:09 +08:00
suzmii	c936268337	Merge branch 'feat/agc-canvas-real-flip' into feat/agc-canvas-resource-workbench-v3	2026-09-09 21:40:37 +08:00
suzmii	4a5b2ad524	修复返回总览时非活动栏目标题栏从屏幕外飞入 ... - begin 只记录当时可见的节点：不可见节点（内联 opacity 0）的屏幕矩形不是可信的 First - 非活动栏目标题栏在子画布态保留总览布局坐标，却被子画布 world 变换推到屏幕外，返回总览时不再以它作为动画起点 - 没有 First 的节点只走淡入，位置保持不动；活动栏目标题栏仍按原有观感收回到总览位置 - 进入栏目方向不受影响：标题栏当时可见，仍钉在原地淡出 - 新增回归用例：不可见标题栏几何首末相等、活动标题栏仍有几何动画、进入方向标题栏原地淡出 - 同步技术方案转场段与 pitfalls 经验条目	2026-09-09 21:39:20 +08:00
suzmii	4582231b78	合并 C3：资源画本转场改为真实元素 FLIP ... - 合入 feat/agc-canvas-real-flip（resourceBookController 重写为同节点 FLIP、新增 sync 可中断重基、删除 ResourceBookTransitionLayer） - 冲突解决：index.tsx 的 resourceBookLayout 导入取 C3 版（buildResourceBookScenePlan 等），去掉已被收进内部的旧 helper 导入避免未使用 - 冲突解决：资源自由画板文档的验证命令合并两侧并去掉已删除的 assetCanvasSurface.test.tsx	2026-09-09 21:24:13 +08:00
suzmii	a23728e6c2	合并 C10：删除 asset-canvas 精修草稿链路 ... - 合入 feat/agc-asset-canvas-removal 5 个提交（前端解耦 / Rust 删除 / 测试 / 文档 / 合同文档退役） - 冲突解决：asset_canvas.rs、asset_canvas/generation.rs、asset_canvas_tests.rs 按 C10 删除（C2 在其中新增的 category/tags 构造点随之消失） - 冲突解决：decision-log.md 保留 C2 与 C10 两条 2026-09-09 决策条目 - 该合并吸收 C2 对被删文件的字段改动，无需单独处理	2026-09-09 21:19:52 +08:00
suzmii	f84d0ea4d0	AGC 资源功能分类与自定义标签数据层 ... - manifest 资源条目末尾新增 category（单值 6 类，默认 unclassified）与 tags（字符串数组，默认空数组），两字段始终序列化 - shared-contracts 新增 GameCreationAppAssetCategory 枚举、GAME_CREATION_APP_ASSET_CATEGORIES 与穷举 16 个 canonical kind 的默认映射表 GAME_CREATION_APP_ASSET_CATEGORY_BY_KIND - 历史 manifest 缺少字段时按 kind 派生分类、tags 取空数组；显式合法分类原样保留，未知分类字符串按前向兼容退回 kind 派生 - packages/shared 同步 TS 契约：分类常量与类型、映射表、gameCreationAppAssetCategory / gameCreationAppAssetTags 取值 helper 与 tags 归一化 helper - 收编壳内 17 处 Rust 构造点：新建条目写 kind 派生默认值，更新既有条目保留已有 category / tags - 补契约测试：字段 round-trip、默认值、legacy 兼容、未知分类前向兼容、16 项映射穷举、tags 归一化 - 同步 docs/technical 技术方案与 docs/project-memory decision-log	2026-09-09 21:10:01 +08:00
suzmii	91396f0615	删除已退役的客户端素材创作无限画布阶段一合同文档 ... - `docs/technical/【技术方案】客户端素材创作无限画布阶段一合同-2026-08-05.md` 整篇退役：该文档描述的中央 asset-canvas 状态、草稿 sidecar、Tauri 草稿/媒体/staging 命令、正式资产提交事务、提交事件、画布状态机与图片生成账本已随机制删除，按四不写不留墓碑文档。 - 仍有效内容已迁往：共享画布包目录与依赖方向、禁止复制的验收门、Host Port 边界、共享 chrome 与主题、图片能力与后续分期迁入 `docs/technical/【前端架构】图片画布编辑器前端拆分计划-2026-06-17.md`；成功投影顺序与焦点守卫迁入 `docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md`；共享源码与资源派生闭环现状迁入 `docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md`。 - 全类型现有资源非破坏性编辑的现成权威条款为 `docs/technical/【技术方案】AGC资源派生与非破坏性编辑合同-2026-09-09.md`，它是 `project/resource_editor.rs` 的现行合同，已改写为 derive + editKind='image-reference' 口径。 - decision-log 的 2026-09-09 条目改写为决策文体：写清退役理由与现权威口径所在文档，历史条目保留原样。 - 过渡项删除条件：资源画布重建快速编辑后，`normalize_local_project_raster_resource` 重新获得前端调用方，届时删除 `apps/ai-game-creator-shell/scripts/check-config.mjs` 中该 allowlist 条目。	2026-09-09 20:32:38 +08:00
suzmii	4c935ba219	同步 asset-canvas 退役后的文档现状并迁移仍有效合同 ... - 新增 docs/technical/【技术方案】AGC资源派生与非破坏性编辑合同-2026-09-09.md，承接阶段一合同第 16 节与第 5 节的现役条款，改写为 derive + editKind='image-reference' 口径 - 图片画布编辑器前端拆分计划新增"共享画布合同"一节，承接共享包目录与依赖方向、禁止复制的验收门、Host Port 边界、共享 chrome 与主题、图片能力与后续分期 - GameAgent资源自由画板与快速编辑删除精修草稿、最终图事务、精修来源规范化、事务恢复对账、批量导入与失败任务归档等退役章节，改写目标与操作边界，新增"编辑结果投影与焦点竞态"一节，并更新验证命令 - App实施计划删除阶段一至五的草稿画布描述，改写为共享画布源码与资源派生闭环现状，修正主视窗状态、适配器与派生提交条款 - 项目开发工作台 PRD 更新主视窗状态机与 ProjectWorkbenchViewState，移除 asset-canvas 状态 - decision-log 追加 2026-09-09 asset-canvas 整体退役决策（含保留项、路由口径、临时白名单与存量数据处置） - pitfalls 删除草稿 CAS、素材保存区、正式素材提交原子性、生成账本与 upload ticket 五条退役条目，修正仍有效条目的关联文件与 legacyPrefix 描述	2026-09-09 20:28:22 +08:00
suzmii	4fb0de2c94	C3 资源画本转场改为真实元素 FLIP ... - resourceBookController 重写为真实元素 FLIP：begin 在提交前记录 First，play 测 Last 后给同一节点加反向 transform，sync 按布局签名做可中断重基 - 转场进行中重基用剩余时长（下限 80ms），空闲布局变化用完整 420ms，预览图尺寸晚到的二次布局变化不再瞬移 - 宿主节点几何基准改存 world 局部坐标，平移和缩放不会让上一次的干净矩形过期 - 不可见节点钉在 First 淡出、挂载节点淡入；搜索/排序导致的卸载保留一帧淡出；返回总览时源栏目未回到摞上的卡片按子画布布局淡出 - 新增 buildResourceBookScenePlan 渲染计划，渲染、转场签名与淡出集合共用同一份数据 - 删除 ResourceBookTransitionLayer 与克隆快照逻辑，清理 styles.css 的转场层和 data-book-motion 隐藏规则 - 重写 resourceBookController.test.ts，补 resourceBookLayout/resourceBookModel 用例与 appSurface 同节点断言 - 同步技术方案转场段与 pitfalls 经验条目	2026-09-09 20:24:10 +08:00
suzmii	a1b9b24891	修复 AGC Ctrl+C 残留上个工作树后端导致切换工作树复用旧后端 (#315) ... closes #314 ## 现象 `npm run agc` 按 Ctrl+C 后有概率残留上个工作树的 `api-server.exe` / SpacetimeDB，切换 worktree 再启动时 AGC 复用旧后端，改过数据库 / schema 的工作树会串库。 ## 根因 1. Windows 下长驻服务都经 Node `shell: true` 的 `cmd.exe /d /s /c` 包装层启动，Ctrl+C 先杀包装层（`0xC000013A`）；`dev.mjs` 的 `stopProcess` 见到直接子进程已退出就 return，`taskkill /PID <已退出 PID> /T /F` 也只会失败，深处的 `cargo → api-server.exe` 无人清理。 2. 按根 PID 遍历依赖快照里的父子链，中间层先消失时链断，只能拿到根 PID。 3. 复用判据只看 `.app/dev-stack.json` status 与 `/healthz`、`/readyz`、`/v1/ping`，不校验端口上的进程属于哪个工作树，残留后端照样被判为健康并复用。 ## 改动 - 新增 `scripts/dev-windows-process.mjs`：按根 PID 遍历 + 按身份匹配（`server-rs/target/debug/api-server.exe` 绝对路径、SpacetimeDB `--data-dir`）两条独立清理路径，带 1s 快照缓存避免清理被拖慢。 - `scripts/dev.mjs`：直接子进程已退出时仍按记录 PID 清理后代；退出时按身份兜底清扫本工作树后端（复用他人 standalone 时跳过）；启动前清理旧 api-server 保留 `Wait-Process` 语义，避免 `failed to remove file`。 - `apps/ai-game-creator-shell/scripts/start-dev-stack.mjs`：复用前校验端口监听进程归属，无法证明归属就不复用、改为启动本工作树后端并允许端口漂移；信号与 `finally` 各兜底清扫一次；`taskkill` 失败时降级按 PID 遍历；等待就绪时输出归属校验失败原因，避免静默超时。探测不可用时退化为旧行为，不阻断本地启动。 - 测试与文档：新增 `scripts/dev-windows-process.test.ts`、扩充 AGC 复用门禁用例；同步 `docs/project-memory/shared-memory/pitfalls.md` 与本地开发运维文档。 ## 验证 - 伪造 `api-server.exe` 进程：按身份精确命中并杀掉（`matched=[17284] stopped=[17284]`）。 - 3 个真实监听进程下归属判定：`owned` / `api-server-owner-mismatch` / `spacetime-owner-mismatch` 均正确。 - `npx vitest run scripts/dev.test.ts scripts/dev-windows-process.test.ts scripts/dev-stack-port-utils.test.ts apps/ai-game-creator-shell/tests/...`：119 passed（唯一失败为 Windows 文件权限用例，已确认在合并基线 `origin/master` 上同样失败）。 - `node --check`、`eslint --max-warnings 0`、`prettier --check`、`npm run check:encoding`、`git diff --check` 全部通过。 ## 备注 Rust 侧 `api-server` 的 `with_graceful_shutdown` 没有超时上限，是「有概率」的来源之一；本次只在 Node 侧收口，是否给优雅退出加 deadline 可另行评估。 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/315 Co-authored-by: Suzumiya <suzmii@qq.com> Co-committed-by: Suzumiya <suzmii@qq.com>	2026-09-09 20:08:04 +08:00
suzmii	c0ef876b14	修复 AGC 项目写锁回收的并发删除竞争与启动诊断死路径 ... - 锁文件回收改为单次快照解析：payload 只解析一次，删除前重新核对字节，内容已被并发方替换或文件已消失时返回 false 并重试 create_new，不再无条件 unlink，也不再把 remove_file 的 NotFound 当成硬失败 - mtime 读取失败改用 Option 区分“未知”与“纪元 0”：未知年龄不回收，未知锁创建时间不做 PID 复用推断，避免把保守判定反转成抢走活持有者 - 新增并发替换/已消失、旧格式活持有者、存活未知、mtime 未知四条回归用例 - 启动日志槽优先用已经生效的配置目录（含 --config-dir），否则退到平台配置根（APPDATA / Application Support / XDG_CONFIG_HOME） - 日志路径未知时 StartupLogSlot::fail 仍然给出用户可见提示，四处 inspect_err 不再被路径判空挡掉 - 同步 check-config 守卫、decision-log、pitfalls 与技术方案文档的用例数与新判据	2026-09-09 19:44:46 +08:00
suzmii	1abbbadb07	合并最新 master 到 AGC V3 资源画布分支 ... - 合入 origin/master 67 个提交（含 #285 无限画布图标模糊修复、#307 客户端常用设置读写卡顿修复等） - index.tsx 冲突按 V3 画本结构解决：保留 resourceBook 画布场景，未采用 master 的 CanvasWorld 包装 - 原因：game-resource-page-world 现仅承载依赖连线层，CanvasWorld 使用固定 12000 世界尺寸，会破坏按内容自适应的边界 - 保留 AtSign 图标导入（V3 引用输入区使用） - 合并后 npm run ai-game-creator-shell:typecheck 通过	2026-09-09 18:12:09 +08:00
suzmii	b7f27721c5	修复 AGC 项目写锁回收判据的跨平台 PID 边界 ... - 项目写锁存活判定把平台不可能分配出的进程号（0 或超出平台 pid 宽度）判为持有者不存在并直接回收，不再落回 600 秒保守分支 - 回归用例的死进程 PID fixture 由 0xFFFF_FFF0 改为 i32::MAX - 1，同时落在两个平台进程号空间之外且在 Unix 有符号 32 位范围内 - 新增 project_write_lock_reclaims_unrepresentable_owner_pid 用例，覆盖 u64::MAX 非法进程号残留锁 - 修正 project_lock_recovery 头部注释，说明这些用例是回归护栏而不是待修缺陷 - 同步 decision-log 的 PID 边界决策与 pitfalls 的跨平台 fixture 经验	2026-09-09 18:00:53 +08:00
suzmii	3153d4f674	修复 AGC 项目写锁残留无法回收与启动失败无诊断 ... - .agent/project.lock 新增 processStartedAt，PID 存活时核对进程启动身份，身份不一致判定 PID 复用并回收 - 旧锁缺少 processStartedAt 时退回“进程启动时间晚于锁 createdAt 加 5 秒容差”的 PID 复用推断 - 空锁 / 坏锁（崩溃停在 create_new 与落盘之间）宽限期由 600 秒收紧到 30 秒，无法判定持有者存活时仍保持 600 秒 - 新增 StartupLogSlot，配置目录就绪前后都能写 startup.log，startup.*.failed 与启动错误提示不再是死分支 - Windows 启动失败恢复系统消息框并附诊断日志路径，其它平台写 stderr，同一进程只提示一次 - 新增 project_lock_recovery 6 条回归用例：死 PID、空锁宽限、PID 复用时间推断、PID 复用身份不一致、身份一致不抢锁、新鲜空锁不抢锁 - 同步 decision-log 与 App 实施计划文档	2026-09-09 16:58:41 +08:00
lhk229	04128eb661	Merge branch 'master' into feat/design_agent_simple	2026-09-09 16:34:16 +08:00
k88936	7288c6f641	Fix/修复无限画布图标文字模糊 (#285) ... closes #279 closes #284 实现: 从2(暂定)倍放大绘制的画布scale 0.5* 真正的scale before:   after:   svg看起来stroke窄了一点点, 可以接受 Reviewed-on: #285	2026-09-09 16:32:43 +08:00
suzmii	6d3d24df5e	合并 #283 资源画本画布实现 ... 合入 feat/game-agent-canvas-resource-workbench-v2 的完整画布实现：资源画本控制器/模型/视口/布局、转场层、资源分页缓存与自动聚焦修复、资源总览卡片预览懒加载 保留本分支已有的聊天素材引用改动（引用输入区、@ 引用按钮、运行画面点选） 解决 index.tsx 状态声明与 pitfalls.md 文档冲突；styles.css 去重后仅保留一份画本视觉层	2026-09-09 15:43:32 +08:00
suzmii	10e28b038c	Merge remote-tracking branch 'origin/master' into feat/agc-canvas-resource-workbench-v3	2026-09-09 15:14:54 +08:00
suzmii	57a5b642fc	建立AGC资源语义类型契约 ... 共享契约新增 canonical 资源类型目录和历史类型读时映射 角色动画派生结果写入 character-animation 主类型 补充角色动画落盘与 legacy 类型映射回归测试 更新资源自由画板技术方案的类型边界说明	2026-09-09 15:03:54 +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
suzmii	b7a659cdfe	feat: AGC 聊天支持素材与运行画面结构化引用 ... - 新增通用素材引用编辑器与结构化引用协议 - 三个聊天入口接入 @ 候选和素材选择面板 - 资源卡新增 @引用 入口 - 运行画面新增区域点选与 runtime-region 引用 - Rust 按 manifest 二次校验并生成安全投影 - 补充前端与 Rust 定向测试	2026-09-09 13:32:10 +08:00
lhk229	08c5917490	修复配置覆盖层写入失败后的部分更新 ... 提前序列化配置变更并在多文件写入失败时逆序回滚 保留单文件保存路径且不增加外部诊断或保存后回读 补充覆盖层写入失败回归测试及配置保存文档	2026-09-09 04:34:57 +00:00