1213 Commits

Author	SHA1	Message	Date
suzmii	7b21bc529e	合并 master：Cocos 插件按当前项目类型暴露 ... - 合入 origin/master c19b32178，使 PR 头包含当前 master tip，修 CI comparison base 门禁（11 秒红） - 冲突 1 处：docs/project-memory/shared-memory/decision-log.md 两侧追加记录，两条逐字保留（HEAD 的 2026-09-11 起多条 + master 的「2026-09-13 Cocos 插件按当前项目类型暴露」），只删 3 行冲突标记 - 验证：npm run check:doc-index 通过（97 份 Markdown）；npm run typecheck exit 0；check:encoding 4557 文件通过；git diff --check 干净；全仓无冲突标记	2026-09-13 17:27:14 +08:00
kdletters	c19b321785	Cocos 插件按当前项目类型暴露 ... 新增 Cocos 项目根识别门禁，限制插件、面板、RPC 和编辑器执行范围 让 DirectProject MCP 工具目录按当前项目类型动态过滤 切换离开 Cocos 项目时停止已运行的插件实例 补充项目级测试、Cocos 技术方案和插件说明	2026-09-13 17:12:37 +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	b498c2780e	修复改完素材标签后聊天侧标签统计与候选不刷新 ... - App.tsx：新增跟随工作台壳清单快照的 effect（`manifestRef` + 同一 `projectId` 且内容确实变了才 `setManifest`）， 让聊天侧 `@` 选择器的标签计数与候选在资源命令写入后跟上画布那份清单 - tests/resourceTagStatsRefresh.test.tsx（新增）：真宿主链路用例 —— 资源画布「编辑标签」保存后， 聊天 `@` 选择器出现该标签 chip 与计数、并按它收窄候选；反向用例钉住未标注标签时不渲染标签 chip - docs/project-memory/shared-memory/decision-log.md：记录标签派生数据的三处来源与各自数据源、 根因（`initialProjectManifest` 只是 `useState` 初值，壳里换清单不会再进来）、修复口径与已知未覆盖项	2026-09-12 18:48:04 +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	1079f6c91b	资源工作台可变更素材类型：面板加类型选择器、卡片角标改显示资源类型 ... - ResourceClassificationPanel.tsx：加素材类型（功能分类）选择器，与标签同一次保存、同一条写入路径；选项 = GAME_CREATION_APP_ASSET_CATEGORIES × resourceReferenceCategoryLabel，不新造第二套中文译名 - ResourceClassificationPanel.tsx：选择器读显示口径（与画布栏目 projectResourceAssetCategory 同源，选中项就是卡片所在栏目）；写回分两路——没碰过类型控件回传 gameCreationAppAssetPersistedCategory 的落盘原值，主动选过才写用户选的值（categoryChoice ?? persisted），保证「只改标签」不漂移分类 - index.tsx：资源卡右上角角标由「文件/媒体类型」改为「资源类型」，取 categoryLabels[resource.category]（栏目与筛选共用的同一份文案），角标恒等于该卡所在栏目；projectResourceTypeLabel 仍服务资源管理面板小字与总览摞分列，不再用于角标 - tests/resourceClassificationPanel.test.tsx：新增「变更素材类型」6 条用例（选择器 6 项与中文口径、选择器显示显示口径自愈值、主动选值写入载荷、只改标签回传落盘原值对照、显式待归类写入 unclassified、连续两次各带当次选择且不关窗），并按新增控件更新既有按钮序与「分类不再由面板编辑」两条断言 - tests/projectResourceLiveIntegration.test.tsx：新增真宿主跟随链用例（角标显示资源类型并与栏目同名、改类型后卡片进目标栏目且角标跟着变、原栏目不再有它），配套状态化宿主 fixture、分类写入与 get_local_game_manifest 两条命令桩、切栏目与读角标助手 - tests/appSurface/project-development.suite.ts：原 data-resource-type 媒体类型断言改为资源类型（角色与对象 / 待归类 / 音频），并说明卡面正文走媒体分支、角标走资源类型这两个独立轴 - docs：PRD §5.3 由「分类没有用户手动设置入口」改为当前两口径分叉（选择器读显示口径、写回按是否主动选过分流）与「显式待归类被读时自愈覆盖」盲区 - docs：AGC 资源工作台 V3 端到端验收 S5 的「前端交互不能改分类」改写为可改分类，补判据（角标读 .game-resource-card-type-badge）与盲区说明；实施计划写入命令一节的面板名与职责同步为「编辑素材标签（标签 + 素材类型）」 - docs：decision-log 新增条目记录本次决策（Rust 无需改动、画布跟随链无需额外迁移代码、待归类盲区、四条变异验证结果与一条不可构造的变异） - 说明：Rust、manifest 字段构成与 SpacetimeDB 均不改；写入命令 update_local_project_resource_classification 早已接受任意合法 category	2026-09-12 16:54:24 +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	028b20a590	修复清单快照误判：CAS 判据面收窄为「资源 + 版本」，预览起停不再触发用户可见拒收 ... - projectResourceLiveUpdateModel 新增 manifestCasFingerprint，按 { assets, versions } 判定同版本号冲突 - 同 revision 且判据面一致时，仅非 CAS 账目状态（preview 运行地址/端口、任务进度、项目名）变化改为 accepted 并让内容落地，revision 不推不退 - 判据面变化仍判 revision-conflict，保留「改了被保护内容却没推 revision」的可观测信号，不吞真实缺陷 - 新增回归用例：同 revision 仅预览状态变化必须被接受；同 revision 资产变化必须仍被拒收 - 变异验证：把判据改回整份 JSON 指纹后，新用例以 expected 'revision-conflict' to be 'accepted' 失败 - 定向验证：projectResourceLiveUpdateModel 17 passed、workspaceLauncherManifestMerge 5 passed、appSurface 413 passed、npm run typecheck exit 0、npm run check:encoding 4399 files passed、git diff --check 干净 - 同步 decision-log 与 pitfalls 记录 CAS 判据面契约与本次取证	2026-09-12 13:30:18 +08:00
suzmii	349c9d80ce	修复「所有资源」页面缩放读取错误视口 ... 展开态缩放、滚轮、平移和卡片拖动改读 all 专用内存视口 ref 避免复用普通栏目页视口导致按钮按下后倍率被旧状态覆盖 补充所有资源连续缩放 appSurface 回归断言，并同步更新项目决策与踩坑记录	2026-09-12 12:25:27 +08:00
suzmii	3f7e41e466	「所有资源」展开态改回平铺画布：不再为每个栏目渲染标题栏 ... 展开态真实栏目不再渲染栏目标题栏，整个场景只留 all 那一条钉在视口上、带「资源总览」收起入口的标题栏 原因是分带只为有可见资源的栏目生成，空栏目拿不到标题栏矩形后全部回落到世界原点叠成一摞（空项目必现，现场是 7 条） ResourceBookSceneCategoryPlan 新增 titlebar 字段，渲染层按它决定是否产出标题栏节点 分带去掉标题栏横带的高度预留与矩形换算，删除 RESOURCE_BOOK_ALL_BAND_TITLE_HEIGHT 与 resourceBookAllTitlebarRects 拖动写回口径不变（resourceBookAllBandLocalPoint 一行未改），零 CSS 变更 resourceBookLayout.test 与 appSurface 两条「所有资源」用例加反向守卫；变异验证改回旧行为时两条同时红（got 7） decision-log 与 pitfalls 记这次倒因为「缺一路坐标输入时不要静默回落到原点」	2026-09-12 09:38:03 +08:00
suzmii	21da95387b	decision-log：把守卫范围与本地限制两条裁定写进既有条目 ... - 取舍 bullet 补裁定理由：保持「整个 workspace」检查、不换成只查暂存文件（rustfmt --check --skip-children 与 cargo fmt 的口径不一致）；本批两次 CI 红的共同根因是「本地绿 ≠ CI 绿」，守卫必须与 CI 同口径 - 取舍 bullet 补流程归因：共树里的硌人是「共享 worktree」的症状、不是守卫的问题，对应流程修正是「一条线一个 worktree」 - 本地限制 bullet 定性为「本机环境限制，不是 CI 会红」，写明根因（Windows/WSL 跨 /mnt/c 的临时目录句柄在子进程退出后仍被持有）、删除重试实测无效且已还原、残留目录会累积（清前 16 个、最早 2026-09-05，本轮已清 0），并给出「Linux CI 上通过」的依据 - 明确裁定：接受该用例在 Windows 上红，不改它语义、本批不再修	2026-09-12 01:15:11 +08:00
suzmii	cafd989bfb	decision-log：记录 pre-commit 新增 Rust 格式守卫的取舍与本地限制 ... - 新增 2026-09-11 条目：背景（本地无 Rust 守卫、CI check:rustfmt 是唯一防线）、决策（lint-staged 增 *.rs + 包装脚本对两个 workspace 只查不改）、连带维护点（git-hooks.test.mjs 钉住整份配置形状，增键必须同步） - 记下刻意保留的取舍：无暂存 .rs 时不触发；一旦暂存 .rs 则按整个 workspace 检查（与 CI 同口径），副作用是别人的未暂存未格式化 .rs 会挡住本次提交 - 记下未修的本地限制：check:git-hooks 第 2 个用例在 Windows 因 finally 里 rmSync 报 EBUSY 而红（断言全过、红在清理），TEMP 里堆了 16 个残留目录最早到 2026-09-05，加删除重试实测无效，CI 在 Linux 上不受影响 - 不动历史条目：2026-08-12 那条的「提交门禁」一行按本文件顶部口径只用于追溯	2026-09-12 01:01:51 +08:00
suzmii	85358b2ca5	「所有资源」页的决策与验收判据跟上当前形态：分带几何口径 + 两页共用同一份布局数据 ... - decision-log 新增「各栏目按分带铺在同一张画布上」：记分带几何（buildResourceBookAllLayout + resourceBookAllTitlebarRects 复用总览标题栏渲染路径）与冻结口径（只在项目/排序/可见资源集变化时重算，拖动不重算；签名不含 token 的理由），以及本轮不动的三处"仍是另一套"（依赖连线 / 空态分带 / 总览缩略卡网格）与它们的后续顺序 - decision-log 新增「两页共用同一份布局数据」：记裁决（不开独立空间、写回同一 mode 同一 sidecar 的同一 section、提交前减带原点）、"为什么不会写偏"的依据、与"历史手动坐标只读恢复/不删除/不重置/不迁移"不冲突的理由，以及用户可自证的往返判据 - 验收文档 S7 行判据改写：旧判据 data-resource-book-all-page / data-resource-book-all-host 已随网格分支删除，改钉 .game-resource-book-scene-card[data-resource-book-category]（每张资源恰好一个宿主）、.is-active[data-resource-book-category="all"] 与 .game-resource-book-view；补上"展开态可拖且在栏目页看到同一位置"这条往返判据 - 验收文档 S7 期望结果同步：由"汇总页"改为"与栏目页同一套画本场景、各栏目按竖向分带铺开"	2026-09-11 23:40:12 +08:00
suzmii	47c88809b6	decision-log：记录冷启动首屏同卡重复读为后续项（本轮不修） ... - 新增一条 2026-09-11 决策记录：冷启动首屏同一张卡被读两次的现象、两条对照证据（eagerPreviewLimit 置 0 同形；hook 整份换回 A/B 之前的 HEAD 版本同样重复）、怀疑方向（observePreview 的注册回声扫描 + 取消 visible 预取后的立刻重扫 + 0/250/1000ms 多延迟点叠加）、未修原因（赶 DDL、非用户可见故障、属门禁与队列时序这条更脆的通路）、影响（首屏请求量比理论最小值多约 20%）与建议的修复断言； - 记录里写明 A+B 只改「取哪些、按什么顺序」，与这条重复读无关； - prettier 顺带把该文件整份规范化（改动 2 行缩进 + 2 个空行，属既有旧条目，纯格式无语义）。该文件在 HEAD 上本就不是 prettier-clean（已用 HEAD 副本 prettier --check 实测为 warn），本次一并收口。	2026-09-11 21:00:36 +08:00
suzmii	70e92bf407	校准资源替换的 PRD、技术方案与验收文档为直接替换口径 ... - decision-log 新增一条（背景 DDL + 用户裁决 / 决策 / 恒等绑定硬约束 / 准入与提示 / 存储与留痕 / 代价 / 文档口径 / 影响范围 / 验证方式 / 关联文档）：说明本次从「版本级替换」改成「直接替换」，并明确记录「替换历史不可回溯」这条代价（上一轮版本级形态里"父版本绑定"就是那份历史，现在只剩一条审计与 manifest 的 .previous 副本） - PRD §3.2：四条保留为未来合同，就地标注「当前实现为直接替换（2026-09-11），版本级替换暂缓」，并说明今天不实现的正是"创建下一迭代版本 / parentVersionId / 前后身份 / 创建原因"，而"可运行版本不可变"与"运行中版本不消费尚未生成的新版本变更"仍然成立 - PRD §5.3：DTO 与"三项兼容性必须同时为 true 才能创建下一版本"标注为未来合同；实现口径块整段改写为直接替换（落盘 = 改该版本绑定、绑定改写语义、硬门禁只有分类与类型、尺寸规格降级为提示、失败即拒绝、revision 前进与审计、入口与可见效果） - PRD §5.4 存储边界（当前状态）：新增第二个例外「直接替换时显式放行列出的版本允许改写自己的 resourceBindings」，写明六条不变式与两组互斥；开头的"已有记录不得删除、重排或修改"补两个例外的指向 - PRD §4 版本条目、§6 P1、§7.4 第 4 条、§7.8 验收六条全部按直接替换口径改写（验收新增第 7 条：审计留痕 + 替换历史不可回溯的声明） - 技术方案文末那一节整段重写为「资源替换（直接替换：只改该版本的绑定，不建新版本）」：新增放行口与六条不变式、命令与写入语义、准入与提示、成功后行为、已知代价、变异验证四条 + 门禁数字；:641 与 :669 的注解同步校准 - 【测试用例】验收文档：§7.3 第 1 条改写为"版本级替换当前不实现但保留为未来合同"，新增第 12/13 条（尺寸规格只提示、替换历史不可回溯），第 10 条去掉"版本下拉多一条"；§8 覆盖与不覆盖范围按新形态更新 - 【技术方案】AGC资源派生与非破坏性编辑合同 :28 的"已有版本数组元素不可修改、删除或重排"补上两个例外的指向	2026-09-11 20:24:41 +08:00
suzmii	d3b341948a	文档收口：工具条动作放行口径、生成动画接通与「改造 = 快速编辑」 ... - pitfalls.md：把「资源画布工具条的『改造』『角色动画』按钮点了没反应」按四不写改成已收口状态（不再写"尚未修"）：生成动画已接真实链路 + 参数入口为什么关、改造由快速编辑承担、其余 5 个动作逐项不做的证据；补记两条连带经验（复用共享面板时要逐个确认"可选参数在该宿主是否影响请求"；面板的泥点价就是提交按钮本身，档位常量必须与后端固定值一致）。 - decision-log.md：新增 2026-09-11 条目，记录四条决策（接通生成动画的门禁与链路、复用共享动画面板并关参数入口、改造认定为快速编辑、其余动作不接的逐项证据）与三条变异验证结果。 - AGC 技术方案「操作边界」：补 4 条当前口径（动作集合按"放进来就必须真能跑通"放行、生成动画的面板与固定档位、改造=快速编辑、未接通动作各自缺什么）。 - Issue #309 与 PR #316 正文未改：远程写操作需用户确认，decision-log 里已记录这两处需要怎么改。	2026-09-11 20:09:51 +08:00
suzmii	86d55a1aba	补资源筛选浮层的 PRD 条款与共享决策记录 ... - docs/prd/...PRD-2026-07-20.md：§5.2.4 新增资源筛选条款——按需弹出的独立浮层取代常驻筛选条（常驻条已移除、不回归）、固定三个字段（查找素材 / 所在区域 / 自定义标签）与各自口径、不提供「状态」字段及其理由、区域既是筛选维度也是画布当前栏目且必须是同一份状态、两种区域语义共用一份过滤实现、浮层与搜索浮层同锚点不得同时展开、关闭与高亮口径、筛选后空态要求 - docs/project-memory/shared-memory/decision-log.md：新增 2026-09-11 决策条目，按体例写背景 / 决策 / 影响范围 / 验证方式 / 关联文档 - decision-log 如实记录：已落地的部分是共享外壳、纯函数与 AGC 侧组件样式（各自独立提交），而 index.tsx 的 3 处接线因该文件被另一条线占用尚未提交，并写明接线完成后应补记——不把未落地行为写成已实现 - decision-log 记录「状态」字段不做的三条证据链（manifest 资产无 status、资源投影无 status、唯二候选任务状态与附件导入状态在投影里已被上游过滤故恒单值），以及区域用派生而非新增第二份 state、「全部区域」复用既有所有资源分组网格的取舍 - decision-log 记录 PlatformResourceFilterBar 不碰不扩的理由（横向常驻条且被主站参考图弹窗在役使用）与既有断言零放宽、三条变异验证实测结果	2026-09-11 20:04:33 +08:00
suzmii	ee8e12783e	校准读时重写的文档口径：写回一次 + 丢弃可见，并补一条口径变更决策 ... - decision-log 2026-09-10 那条把「不写迁移脚本、不删除、不重置」改成当前事实：读时会把 legacy 分区（art / code）坐标归并到新分区并写回一次 sidecar（revision +1）；不写迁移脚本、不重置坐标位置；但无法归并的坐标会被跳过（跳过条数在画布提示条上可见）。 - 新增 2026-09-11 decision-log 条目：背景（审计查实「读时原地重写」112 条 + 27%（66 + 16）丢弃与旧文档字面冲突）、决策（用户选 A：保留重写、不静默、改文档）、影响范围、验证方式（含两处变异验证）、关联文档。 - 技术方案【GameAgent资源自由画板与快速编辑】：同一句改成读路径写回一次 + 无法归并的坐标被跳过且可在提示条 / data-resource-canvas-layout-* 上读到。 - PRD【项目开发工作台】第 325 行同一句同样校准（避免权威文档里留着「不写迁移脚本、不删除、不重置」这句会误导排障）。 - 测试用例【AGC资源工作台V3端到端验收】S21 台账那格补上「存量项目第一次打开时读路径也会写回一次、并给一次性提示条」，避免把 revision 从 1 开始误判成异常。 - 行为、sidecar schema（v1）与跨端契约均未改动。	2026-09-11 19:19:51 +08:00
suzmii	d9822eca05	同步资源分类口径的文档：读显示 / 写回两个口径、别名表大小写不敏感 ... - PRD 的分类取值段落改为「读显示 / 写回两个口径」：写清跨端同构的两个函数名、Agent 投影不许再透传落盘 `category`、面板保存回传落盘原值、别名表大小写不敏感（`"UI"`、`font`） - 技术方案（AI游戏创作智能体App实施计划）的 manifest `category` 段落同步：`"UI" → ui-interaction`、`font → document`，其余映射不到的 kind 才落 `unclassified`；补上两侧口径函数名 - `pitfalls.md`：把「补别名只影响新登记，不重算 `category`」这条坑更新为已修形态，并写明「同 kind 重登记禁止动 `category`」这条必须保留的不变量；「读时重派生」条目补上两个口径不能混用与跨端必须同构两条 - `pitfalls.md` 新增条目「大写 `UI` / `font` 不在 alias 表 → 8 条真机 UI 资产永远落「待归类」，且自愈救不回」，记录成因链与三层守卫 - `decision-log.md` 新增决策条目：口径拆两半、自愈不下沉到反序列化、别名表大小写不敏感、重登记重派生但不抹掉显式分类，含变异验证与影响范围 - 端到端验收用例文档的 S5 栏目归属补一句：判定「编辑标签后分类有没有被改」必须比 manifest 文件，不能拿自愈后的显示值当落盘值	2026-09-11 18:49:32 +08:00
suzmii	c527c19bf8	校准 DirectProject 历史兼容口径的技术方案与共享决策记录 ... - 技术方案：把「不迁移旧 {role,content} 行 / 不会对旧格式做迁移或兼容」改成当前状态——读侧白名单兼容 legacy 行（含 tool 行只识别不注入）、写侧 DirectProject 自己的旧行写点已收口 - 技术方案：修正「Rust 是该历史文件的唯一写入方」，写清 project.jsonl 同时被通用对话链（agent_id=None 的项目主对话与 Runtime 公开状态消息）读写，并记录两条链互读兼容的规则 - 技术方案：说明为什么故意不给通用对话写入器加「Direct-owned 就拒写」的硬报错（会把旧行噪声换成任务起不来），以及这类失败为何按不可重试处理 - 技术方案：更新时间改 2026-09-11 - decision-log：新增 2026-09-11 条目，记录格式切换当年「唯一写入方 + 测试手动清理」的前提在存量用户项目上不成立、现改为「读侧白名单兼容 + 写侧统一」，以及为什么不做数据迁移	2026-09-11 18:36:29 +08:00
suzmii	b1377572d6	校准资源替换的 PRD、验收文档、技术方案与项目记忆 ... - PRD §5.3 补实现口径：替换落盘 = 改绑定 + 追加新版本、子版本绑定 = 源绑定去掉源素材并保证替换素材在集合里、前后身份用推导记录、三项兼容性逐条判据与 sizeSpecEqual 的降级声明、失败即拒绝、入口与可见效果；同时标注 :364-373 的 ProjectResourceDescriptor 是历史四分类形状（其 width/height/durationMs 在 manifest 里并不存在） - PRD §5.4 前的版本章节与 §6 P1、§7.4 第 4 条按当前状态校准：替换已实施，但版本聚焦态仍不提供创建/替换/切换/回滚按钮，资源替换入口在资源卡工具条 - PRD 新增 §7.8 P1 资源替换验收六条（入口放行判据、候选禁用与原因、只追加写入形状、两条绑定路径、拒绝零副作用、成功后切版本但不重载预览） - 【测试用例】AGC资源工作台V3端到端验收：删掉「PRD L387 兼容性三项属 C6 取消范围」那句（改为明确不属于），更新 §7.3 工具条 opt-in 清单，补三条已知边界（运行画面不因改绑定而变、候选弹窗不加载缩略图、picker 在 AGC 首次使用），§8 覆盖与不覆盖范围补资源替换 - 【技术方案】AI游戏创作智能体App实施计划：:669 的「本阶段不提供版本创建、替换、切换」与 :641 的布局切片范围按当前状态校准，并在文末新增「2026-09-11 AGC 资源工作台 V3：版本级资源替换」一节，写全命令、写入语义、前后身份推导口径、三项兼容性判据与降级声明、入口、成功后行为与验证数字 - decision-log 新增一条（背景 / 决策 / 恒等绑定硬约束 / 判据 / 降级 / 边界 / 影响范围 / 验证方式 / 关联文档）：说明本次按 PRD §3.2 / §5.3 恢复「替换后创建下一迭代版本」，与 2026-09-10 那条「不创建新版本、替换功能整条取消」的口径关系，以及 C6 的候选/队列/审核仍不做 - Issue #309 的三处口径（C1 决策、贯穿性决策 6、验收总纲的「不创建新版本 / 不产生新版本」）按远程写确认规则**未擅自改动**，需要在用户确认后再改	2026-09-11 18:12:41 +08:00
suzmii	082d8d62de	把运行页签的资源信息搬到画布选中工具条，两处共用一份只读字段 ... - 新增「信息」动作：排在「@引用」之后、「编辑标签」之前，点开非模态信息浮层，再点一次即收起（aria-pressed 反映开合） - 新增只读字段组件 ResourceInfoFieldsView（ResourceInfoPanelView.tsx），运行页签的「信息展示」与画布浮层共用，字段清单只在 resolveResourceInfoFieldRows 单点定义 - 字段口径：名称 / 路径 / 类型 + 只读分类与标签（分类取画布栏目口径，标签为空时给「暂无标签」），刻意不含来源任务、资产 ID 等 manifest 内部标识 - 浮层 chrome 与快速编辑浮层同族（同一锚点、同档圆角与阴影），样式落在 resourceCanvasChrome.css；关闭入口三处：动作按钮、面板关闭按钮、画布浮层统一的 Esc / 点边界外 - 关闭判据收口：resolveResourceCanvasQuickEditDismissOpen 更名为 resolveResourceCanvasFloatingPanelDismissOpen、参数改为 isFloatingPanelOpen，宿主把「快速编辑开」与「信息开」合成一个布尔 - .game-resource-info-panel 补进 RESOURCE_CANVAS_INTERACTION_SELECTOR，否则点在只读字段值上会被判成点画布空白而清掉选中 - 换选 / 清空选中 / 切项目时信息浮层自动收起：在选中派生处按 selectedResourceId 收口，不在每个重置点各补一行 - 测试：新增 resourceCanvasInfoModel 三条与「信息面板在画布浮层与运行页签里渲染同一份只读字段」（工具条顺序、开合、关闭按钮只收面板、点画布以外收起、Esc 连工具条一起收、运行页签字段逐行相同）；resourceCanvasFloatingDismiss 的判据用例与交互选择器夹具改为浮层通用口径 - resourceCanvasChrome.css 的字段排版收在浮层选择器下，不跨上下文改运行页签的字号与列宽 - decision-log 新增一条：记录这次对 Issue #309 C3「取消资源详情面板」的有意局部回退（只回退「看信息」，不恢复可编辑详情面板与全屏编辑路由），并登记需要同步的 C3 引用位置	2026-09-11 16:42:40 +08:00
suzmii	6bdc8bbd93	AGC 资源分类面板改为「编辑素材标签」：只编辑标签、分类不再有手动入口 ... - ResourceClassificationPanel.tsx：面板改为只编辑 manifest `assets[].tags`，移除分类 6 类 chip 那一排；标题与 aria-label 改「编辑素材标签」，副标题由资源路径改为素材名 （`localPath` 的 basename，仓库没有独立显示名字段） - ResourceClassificationPanel.tsx：标签状态由「整段逗号分隔字符串」改为字符串数组， 每个已有标签渲染成自带删除按钮的胶囊 pill；保存时把未落成 pill 的输入尾巴一并切分， 归一化仍走 `normalizeGameCreationAppAssetTags`，回车 / 中英文逗号 / 顿号提交方式不变 - ResourceClassificationPanel.tsx：写入命令 `category` 是必填，读一次当前权威值并 在保存时原样回传，保证「只改标签」不漂移分类；底部按钮「保存」改「保存标签」， 删除资源入口按既有保留（截图未画，但它是唯一的资源删除入口） - resourceClassificationTagPanel.css：新增标签 pill 样式，删除按钮嵌在 pill 内部 （视觉图标 11px、热区 32×32、负外边距抵消不撑高 pill）；若第二处出现带删除按钮的 标签 pill，抽到 `packages/shared` 做 `PlatformRemovableTagPill`，不要复制这份实现 - index.tsx：资源卡工具条入口 label / title / 文案由「分类与标签」改「编辑标签」， 与面板标题一致（否则入口写着分类、打开的是纯标签面板） - tests/resourceClassificationPanel.test.tsx：断言对齐截图文案、逐个 pill 自带删除、 点某个 × 只删对应标签、aria-label 可区分、保存 payload 的 tags 数组与 category 原样回传、 取消不写盘、入口 label 与面板标题一致、删除热区不小于 32px - 文档：PRD §5.3「分类取值优先级」改写为当前状态（分类没有用户手动设置入口、 该面板只编辑标签），并新增 decision-log 条目记录本次产品决策与「用户手动设 category 的能力就此移除」这一事实 - 说明：截图文案（编辑素材标签 / 新增标签，多个用逗号分隔 / 保存标签）在全仓检索 无命中，属仓库之外来源，本次按用户截图对齐，不是 PRD 明文	2026-09-11 15:34:36 +08:00
suzmii	399fcacb8e	同步删除栏目大纲导航的权威文档：PRD 与技术方案改成总览卡片/所有资源/下一页口径 ... - decision-log.md：新增「删除资源画布左侧的栏目大纲悬浮导航」决策，先记录查证结论（decision-log / pitfalls / PRD / 技术方案里此前只有要求保留该导航的条文，没有任何删除决策，本次是新决策），再写决策、语义变更、不做什么与变异验证结果。 - PRD：§阶段说明与 §7.2 验收两条不再写"大纲展示全部栏目""通过栏目大纲和滚轮访问全部栏目"，改为栏目大纲由「资源总览」的栏目缩略卡片承载、切栏目走总览卡片 +「所有资源」入口 + 页内「下一页」。 - 技术方案：目标、操作边界与验收共五处删掉"栏目大纲悬浮在画布左侧/只显示图标和栏目名称""点击大纲切页""分页大纲以悬浮 Dock 展示全部栏目"等条文，改成当前状态（左侧不再有悬浮导航）。 - pitfalls.md：补记一条 jsdom 坑——栏目页 fit key 需要非零可测量尺寸，jsdom 下恒为 0，所以"总览→栏目"往返会重新适配视口；进入栏目后应恢复上次 viewport 的用例在 jsdom 里必须避免这种往返，不要误判成产品回归、也不要去改 fit 逻辑。	2026-09-11 13:54:27 +08:00
suzmii	d1a3702062	记录构建版本判据与 loopback HTTP 预览方案的评估结论 ... 本轮「资源卡图片加载不出来」连续两轮按现役缺陷排查，最终发现真机数据在当前 HEAD 上判定全对、现象来自更早的客户端构建。把这次的方法教训与两条廉价判据固化成文档，避免后续重复投入。 - `pitfalls.md` 新增「用真机现象定性之前必须先确认客户端构建版本」：现象与「数据在 HEAD 上的实际判定」不一致时，第一个怀疑对象是构建版本而不是代码；两条廉价判据为真机 manifest 的 `category` 分布（旧构建 `unclassified:58`，新构建 `unclassified:1 / ui-interaction:59 / scene:1`）与控制台读 `[data-preview-kind]` 分布（新构建应为 `raster-image 52 / document 8 / code 1` 且无 `placeholder`）。同时记下方法教训：不要用 PowerShell 或手抄正则去复算 TS 判定表，誊本会引入假结论——本轮第一轮取证正是因此得出了不存在的「角标与预览分支分叉」，要跑就用真实源码跑。 - `decision-log.md` 新增「AGC 资源预览评估过本机 loopback HTTP 资源服务，因收益不匹配代价而暂缓」，并显式注明它与既有的 `asset:` 否决**不是同一条、理由不同**：`asset:` 是「绕过安全门禁」的原则问题，loopback HTTP 是「收益与代价不匹配」的性价比问题，其门禁可在服务端逐条复用。记录内容含 token 化不暴露路径、服务端复用同一套校验、与「不向 WebView 暴露本机文件协议」合同的关系判定（同构替代而非违约，信任边界转移到 token 与审计），以及流式下**必须明确降级的三条**：读取漂移复核、全局 3 permit 并发闸门、有界 tombstone 预算。量化依据为真机 52 张 PNG 的分层实测——Rust + JS 冷开合计约 0.3 s，大头是已由 `decoding="async"` 移出主线程的 37.2 MPx 解码，因此当前量级下 0.3 s 换「不向 WebView 暴露文件系统」这条合同是划算交易；并写明重新评估的触发条件（几百张资源 / 大图量级）。 - 同批一并暂缓的备选也记在案：Tauri 自定义协议（非 `asset:`）+ opaque token 因拿不到 HTTP 缓存语义而比 loopback HTTP 更差；磁盘缩略图缓存与 PRD 的纯内存口径及既有价值观冲突。 - 纯文档改动，无代码改动；`tauri.conf.json`、`Cargo.toml`、Rust 命令与 CSP 均未动。	2026-09-11 13:30:26 +08:00
suzmii	531392e506	退出路径统一收尾本地预览，陈旧预览记录不再留给下次进入 ... - preview.rs：新增 stop_local_game_preview_on_exit——退出时若 registry 里确有 running 预览，就用 stop_local_game_preview_for_root 把它真正停掉并写 stopped（顺带落 preview.log 与 trace 收尾）。预览服务器是进程内线程，进程一退 URL 就永久失效；不在这里收尾，.agent/manifest.json 会一直写着 running。 - main.rs：handle_game_creator_gui_run_event 的 RunEvent::Exit 分支先做预览收尾，再做既有的 Agent server / runner 关闭；失败按 `preview.gui_exit.stop_failed` 记日志，不阻断退出。 - 语义变更（用户已确认接受）：关窗不再保留预览——退出即停止预览并把记录写成 stopped，下次进项目一律落到资源管理。与"进入项目时按 registry 活体核对"配套：退出路径覆盖正常关闭，强杀 / 断电那类不走退出路径的情况由进入时的核对自愈。不引入 stale DTO 字段（判定仍要活体探测，且会把状态扩到跨端契约与全部消费方）。 - tests/project.rs：新增 gui_exit_stops_the_preview_and_clears_the_stale_record——退出收尾后 registry 归零且 manifest 记录为 stopped。 - tests/sessionPreview.test.ts：补两条 Rust 侧结构性守卫（本仓既有做法：直接解析源码）。① RunEvent::Exit 分支必须出现 preview::stop_local_game_preview_on_exit——这条接线没有别的行为测试覆盖（注册全局 registry 的用例会互相打架）；② 同项目重启预览的替换分支里，收尾必须排在"旧预览是否属于另一个项目"的判定之后。变异验证：把 main.rs 的退出收尾摘掉 → 守卫①立即红灯（已实测）。 - decision-log.md：新增 2026-09-11 决策条目，逐条写下背景（偶发进运行界面的成因链：进程内预览线程 + 随机临时端口 + 退出零清理 + 进门不核对 + 同项目重启覆盖刚写的 running）、A/B/C 三项决策、关窗不再保留预览这条语义变更及"为什么两者都做而不加 stale 字段"、不做什么与验证方式。同文件被 prettier 补了几处标题前空行（格式规范化，无内容变化）。 - 验证：cargo check --locked --all-targets exit 0；Rust 定向用例 restarting_preview_for_the_same_project / replacing_preview_for_another_project / stopping_without_a_live_preview / gui_exit_stops_the_preview 各 1 passed；AGC 子集 1198 passed / 4 skipped / 0 failed；共享组件 1385 passed；typecheck exit 0；编码 4378 文件；git diff --check 干净。	2026-09-11 12:36:08 +08:00
suzmii	95c5418c0f	合并 master（#318 写锁等待与可诊断）入 V3 分支 ... - 三个文档冲突按两边都保留解决：decision-log.md、pitfalls.md、实施计划技术方案；两边追加的是不同主题（资源画布/预览/聊天区 vs 写锁），语义无冲突 - Rust 侧 direct_runtime.rs、direct_tool_bridge.rs、project_gates.rs、project.rs 自动合并成功，无手工介入 - 冲突处仅移除 Git 标记行，未删改任何一方内容（每个文件恰好减少 3 行）	2026-09-11 11:33:12 +08:00
suzmii	364492de37	Revert "文档同步：资源管理页改为栏目分页纵向滚动网格" ... This reverts commit c2b851cc36.	2026-09-11 11:07:59 +08:00
suzmii	c2b851cc36	文档同步：资源管理页改为栏目分页纵向滚动网格 ... - PRD §3.3：栏目页改为纵向滚动网格，顺序由 sidecar 记录的 (y, x, resourceId) 读序推出，新增列数控件与栏目内拖拽排序条文 - PRD §3.3.1：三阶段改写为当前形态（本体卡保留；阶段二改为栏目分页网格；阶段三改为未排序栏目的初始顺序派生） - PRD §3.3.2：可见性预取口径改为以栏目滚动容器为交叉根 - PRD §5.2：实现状态与字段语义改为「x / y 只承载栏目内顺序」，新增顺序阶梯、已排序栏目新资源追加末尾、列数偏好与关系说明条文 - PRD §5.2.4：删除 viewport、wheel、拖动改写坐标等画布条文，改为网格、列数与拖拽排序 - PRD §5.2.5：手动拖动合同改为拖拽排序合同 - PRD §5.2.6：删除资源依赖关系图层整节 - PRD §7.2：验收改为顺序持久化；§7.3 依赖关系图验收整节删除；§7.5 重写为栏目分页纵向网格验收，新增「纵向滚动无横向溢出」与「列数被记住」两条判据 - PRD §6/§8：分阶段范围与非目标同步 - 技术方案：原《GameAgent资源自由画板与快速编辑》改名为《AGC资源管理页纵向网格与排序》，重写为当前形态（页面形态、栏目内顺序、列数偏好、拖拽排序、关系说明），保留权威数据、焦点竞态与派生编辑条文 - 实施计划：资源卡与资源管理页边界改为栏目网格、顺序落盘、列数偏好与滚动容器可见性 - decision-log：新增 2026-09-11 决策（含用户明确判断优于 PRD 的事实依据，以及有意推翻 1da7dc62a） - pitfalls：整体改写「AGC 资源管理页真正自制的交互面」条目 - docs/README.md 与 document-map.md：更新改名后的专题文档入口	2026-09-11 11:00:31 +08: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
lhk229	782fa77950	Merge branch 'master' into design_agent_refactor	2026-09-10 23:50:49 +08:00
suzmii	ff42fff61c	按评审意见把写锁等待挪出 runtime worker 并收紧 wait_exhausted 记账 ... - agc_write_file 写路径改经 bridge_write_file_in_blocking_pool 走 tokio::task::spawn_blocking：有界等待是同步轮询（最多约 10 秒），直接在 async handler 里跑会占住 tokio worker，争用窗口内同一轮并行写多个文件时会波及共享同一 runtime 的只读端点与 UI 命令 - 新增用例用默认 current_thread runtime 加心跳任务锁住该性质；把 handler 临时改回同步直调时该用例按预期失败，确认有区分度 - project.write_lock.wait_exhausted 与终态改判一起改为只在真的等过（max_attempts > 1）时发生：hydrate 的单次试探不再写 waitedMs 近似 0 的“耗尽”日志 - 技术方案、decision-log、pitfalls 同步这两条，并补“同步有界等待不能直接跑在 async handler 里”的排障经验	2026-09-10 21:38:48 +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	06f738dc99	将项目写锁从 project/filesystem.rs 纯搬移到 project/write_lock.rs ... - 新建 project/write_lock.rs：取锁、等待分类、持锁方诊断、残留回收与 4 条锁用例整体搬移，逻辑不变 - project/filesystem.rs 只保留项目文件 IO（1533 → 680 行），锁相关常量、结构、进程判据与用例全部移出 - project.rs 注册 mod write_lock 并 pub(crate) use write_lock::*，crate::project:: 与 crate:: 既有路径不变 - windows_metadata_is_reparse_point 提为 pub(crate)，供 write_lock 复用同一条 reparse point 判据 - agent_db.rs 与 checkpoint.rs 的 PROJECT_FILE_FLAG_OPEN_REPARSE_POINT 导入路径改为 super::write_lock - 同步修正技术方案、Fast GDD 技术方案、decision-log、pitfalls 中指向锁实现的文件路径，并把“拆锁”从后续事项改为已完成	2026-09-10 20:12:28 +08:00
suzmii	8c639e5d13	修复项目写锁重试判据用一次元数据观察误判瞬时争用 ... - 项目写锁分类改为只按错误码判定重试性，不再用 path.exists() 决定“要不要等”：真机 6 万次建锁/删锁竞争实测 396-538 例命中“ACCESS_DENIED(5) + 目标不可见”，旧判据会让等待层立刻失败关闭，把毫秒级竞争换成更误导的 ACL 文案 - 新增 ProjectWriteLockFailure（Retryable / Terminal）与 acquire_project_write_lock_failure，有界等待改按类型分流，acquire_project_write_lock 退化为它的文案包装 - Windows 的 ACCESS_DENIED(5) 终态改判移到等待预算耗尽之后：只有真的等过预算且目标此刻仍不存在时才投影成权限拒绝，单次试探保持争用语义 - 锁分类判据改为平台参数传入（project_write_lock_open_failure_for），Linux CI 可覆盖 Windows 分支；替换原先只在 Windows 本地执行的分类用例 - 零等待入口在错误码不可区分时补一句“可能是删除挂起、删除拆链窗口或权限 / ACL 拒绝”，争用前缀逐字不变，调用方既有重试语义不受影响 - PROJECT_WRITE_LOCK_CONTENTION_PREFIX 收口 provider_recovery.rs、planning_session_v2.rs、direct_runtime.rs 三处手写文案 - project.write_lock.wait_exhausted 日志补 projection= 分类，attempts 记为实际尝试次数 - 同步更新技术方案、decision-log、pitfalls，并修正 ownerIsSelf 只比 PID 的表述	2026-09-10 20:07:28 +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
lhk229	aaa52c2b34	接入策划 Agent 生产迁移初版 ... 新增独立设计会话、工作区工具和随包资源 platform-llm 支持 Responses 原生 input 续轮 无旧 V2 会话的策划入口切换到新设计 Agent 增加阶段审批、澄清卡和工作区文件浏览 同步迁移方案与决策记录	2026-09-10 08:45:11 +00:00
suzmii	81c2389132	修复 AGC Direct 写通道项目锁零等待与持锁方不可诊断 ... - Direct 写路径（agc_write_file）改用统一的有界等待，与 file.write / file.patch / file.delete 同语义，同一轮并行写多个文件按同一把锁串行，不再在 24-42ms 内把重叠判成"项目正在被其他写操作占用" - create_new 失败拆成争用 / 权限拒绝 / 其它三类：锁文件不存在却仍创建失败不再投影成争用；sharing violation(32) 与 lock violation(33) 恒定归争用 - 争用错误与等待日志带上持锁方身份（commandId / pid / createdAt / ownerIsSelf），锁文件处于删除挂起或未写完时显式表达成"身份不可读" - ProjectWriteLockSnapshot 补 commandId 与 describe_holder()，沿用既有快照 + 字节 CAS 回收机制，不新增第二套回收判据 - 有界等待预算耗尽记 project.write_lock.wait_exhausted（含等待毫秒数），权限拒绝记 project.write_lock.permission_denied，争用不在零等待入口里逐次记账 - 新增同进程重叠写等待、同轮并行写、活外部进程持锁带身份、权限拒绝分类、ACL 拒绝不投影成争用五条回归用例 - 同步 decision-log、pitfalls 与技术方案文档	2026-09-10 16:30:22 +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
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	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	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