2540 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
suzmii	7ed88eb93c	修复文档索引检查：移除退役文档死链并登记 4 份未分类文档 ... - docs/README.md 移除指向已退役删除的「客户端素材创作无限画布阶段一合同」链接（该文档已由 91396f061 删除，链接成为死链，check:doc-index 报「链接不存在」） - 登记本分支新增但未入索引的 4 份文档为 current：AGC 资源派生与非破坏性编辑合同、AGC 聊天素材引用、AGC 聊天 AI 润色与发送前提醒（AI 游戏创作与 Agent Runtime 章节），AGC 资源工作台 V3 端到端验收（后端、运维与测试章节） - 成因：master #339 引入文档生命周期索引后，check:doc-index 要求 docs/README.md 链接全部有效、且 docs 下每份 Markdown 都必须分类；这 4 份文档只存在于本分支，master 上不存在，故 master 自身检查通过而本分支报「文档未分类」 - 验证：npm run check:doc-index 通过（97 份 Markdown，current=80 / historical=11 / review=1）；npm run check:encoding 4557 文件通过；git diff --check 干净	2026-09-13 17:20:23 +08:00
kdletters	c19b321785	Cocos 插件按当前项目类型暴露 ... 新增 Cocos 项目根识别门禁，限制插件、面板、RPC 和编辑器执行范围 让 DirectProject MCP 工具目录按当前项目类型动态过滤 切换离开 Cocos 项目时停止已运行的插件实例 补充项目级测试、Cocos 技术方案和插件说明	2026-09-13 17:12:37 +08:00
suzmii	840a62f7d0	合并 master：规范化历史文档并合入 AGC 插件宿主能力（#339） ... - 合入 origin/master 96b45e6ff，使 PR 头包含当前 master tip，修 CI comparison base 门禁（15 秒红） - master 侧 28 个文件，零冲突自动合并 - 验证：npm run typecheck exit 0；check:encoding 通过；git diff --check 干净	2026-09-13 17:11:06 +08:00
kdletters	96b45e6ffc	规范化历史文档并合入 AGC 插件宿主能力 (#339) ... ## 变更 - 建立文档生命周期与现状索引，统一 `current`、`historical`、`review`、开放事项和活动计划边界。 - 为历史/待复核文档补充状态头，将有源码与测试证据的专题纳入当前入口。 - 新增规范驱动开发 skill 与 `check:doc-index` 门禁，并接入 `lint`。 - 合入 `origin/master` 的 AGC 通用插件宿主与 Cocos Creator 编辑器能力，并补充父子规范关系和验收范围。 ## 合并说明 - 合入基线：`origin/master` `4a46f89c9`。 - 合并提交：`259134b59`。 - 合并过程无冲突。 ## 验证 - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` - `python -X utf8 C:/Users/kdletters/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/spec-driven-development` - 推送前 pre-push master 门禁通过。 ## CI 请以本 PR 的 Gitea CI 检查为准；提交后持续关注，失败时按失败 job 继续修复。 Reviewed-on: #339 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-13 16:21:34 +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	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	e4c2f2466f	合并资源工作台分支：卡片从所属摞浮现与既有三条修复并存 ... - 把远端最新 05612c46a（弹窗宿主类样式迁共享表 + 标签统计刷新 + 工具条分隔线去重）合入本分支 b41b26cab（卡片全部从所属摞浮现） - 冲突零：仅 pitfalls.md 两侧追加记录自动合并，两条都保留 - 验证：npm run typecheck exit 0；resourceBookController / resourceBookLayout / resourceTagStatsRefresh / projectAssetPickerDialogShellStyle / selectedLayerToolbarDividerDedupe 五文件全绿	2026-09-12 18:58:52 +08:00
suzmii	b41b26cab8	修复资源画本进栏目只有少数卡片有位移：没有 First 帧的卡片改从那一摞起飞 ... - apps/ai-game-creator-shell/src/view/project-development/resourceBookController.ts：begin() 顺带按 (栏目, 类型摞列号) 记下同一摞最深那张卡的 First 矩形当"堆锚点"，play() 时没有 First 帧的卡片认领它当合成 First（仍是同一套 FLIP，不新增动画系统、不为动画多渲染节点）；堆锚点只在本次转场有效（maybeFinish / settle / invalidate 清掉），转场中重基（已在跑动画）不认领锚点，起点仍是"此刻像素"。 - apps/ai-game-creator-shell/src/view/project-development/resourceBookLayout.ts：展开态（allOpen）的卡片补上真实类型摞列号，不再一律 0——否则第 2 摞之后的卡片会全从第 1 摞飞出来。 - apps/ai-game-creator-shell/src/view/project-development/index.tsx：卡片宿主补 data-resource-book-stack-column / data-resource-book-stack-index，把"哪一摞"的摞身份交给转场层。 - apps/ai-game-creator-shell/tests/resourceBookController.test.ts：新增 3 条用例——每一张卡都从自己那一摞位移出来（含第 0/1 摞分别认领各自锚点、总览已渲染的仍用自己 First）、转场中重基从此刻像素而不是被拉回摞上、转场收尾后挂载的卡片不从过期锚点飞出。 - apps/ai-game-creator-shell/tests/resourceBookLayout.test.ts：新增"展开态每张卡带自己那一摞的列号"用例（同栏目两摞 ⇒ [0,0,1]）。 - apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts：在既有总览/进栏目用例里钉住宿主上的摞身份属性（总览 3 张 = 下标 0,1,2；进栏目后 5 张 = 下标 0..4、同类型列号 0）。 - docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md：把资源画本转场一节更新为当前状态（堆锚点来源、锚点生命周期、展开态列号）。 - docs/project-memory/shared-memory/pitfalls.md：记录本次排障——现象、已用代码核实的原因（总览每摞只铺 3 张 ⇒ 其余卡片没有节点、没有 First 帧）、"钉住的标题栏移出 world"那笔改动不是原因的证据、处理、变异验证与真机判据。	2026-09-12 18:56:43 +08:00
suzmii	05612c46ae	合并资源工作台分支：弹窗宿主类样式迁到共享表与既有修复并存 ... - 把远端最新 b498c2780（标签统计刷新 + 工具条分隔线去重）合入本分支 074924190（弹窗宿主类 platform-modal-shell/overlay/backdrop 迁到共享样式表） - 冲突零：src/index.css 自动合并（本分支删除三条宿主类规则，远端最新新增分隔线去重规则） - 验证：npm run typecheck exit 0；projectAssetPickerDialogShellStyle + selectedLayerToolbarDividerDedupe + resourceTagStatsRefresh 三个用例文件全绿	2026-09-12 18:51:33 +08:00
suzmii	0749241908	修复 AGC「选择替换素材」弹窗面板透明：平台弹窗外壳规则移入共享样式表 ... - 根因：弹窗面板用的 `platform-modal-shell`（遮罩 `platform-overlay`）规则原先只写在网页端整站样式表 src/index.css；AGC 只加载 packages/shared/src/components/styles.css 与 theme.css，类名挂上了但一条声明都没命中，面板因此无底色、无边框、无阴影，背后模糊的资源画布直接透出 - 把 platform-modal-shell / platform-modal-backdrop / platform-overlay 三条宿主类规则从 src/index.css 移进 packages/shared/src/components/styles.css：两个宿主都 import 这张表，规则只保留一份，不在 AGC 业务样式里复制平行副本；三处声明逐字照搬，网页端层叠结果不变 - 新增 apps/ai-game-creator-shell/tests/projectAssetPickerDialogShellStyle.test.tsx：从 src/main.tsx 按真实 import 关系解析出「AGC 到底加载了哪些样式表」，断言清单里有这三条规则、背景引用主题 token、light 主题下 --platform-modal-fill 各色停 alpha ≥ 0.9；DOM 契约断言面板挂 platform-modal-shell、遮罩带 platform-overlay 与 platform-theme--light；并断言这三条规则只在共享表里各定义一次（禁止平行拷贝） - docs/project-memory/shared-memory/pitfalls.md 记录「共享弹窗的宿主类必须落在所有宿主都会加载的样式表里」的排障经验	2026-09-12 18:48:31 +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	4c180ac29a	合并 fix/agc-manifest-revision-cas：钉住的栏目标题栏移出画布缩放层（解 pitfalls.md 冲突） ... - 合并来源：ff0bc5a3e（fix/agc-manifest-revision-cas）。 - 冲突只有 1 个文件 1 处：docs/project-memory/shared-memory/pitfalls.md（两侧都在文件末尾追加了一条 2026-09-12 记录，文本上是同一个插入点）。 - 解冲突（两侧内容逐字都保留，都不改写、不删）： - 保留 HEAD 侧 6618207b5 的「运行模块切换版本报 listeners[eventId].handlerId」一节（pitfalls.md:5397）。 - 追加 ff0bc5a3e 的「资源工作台顶部那一行发虚」一节（pitfalls.md:5407）。 - 同一天的记录之间没有排序语义，取「HEAD 内容不动、新记录追加在末尾」，这样两侧 diff 都是纯插入。 - 另外两处自动合并（git 未报冲突）已逐段语义核对，两侧行为都在： - apps/ai-game-creator-shell/src/view/project-development/index.tsx：ff0bc5a3e 的 renderTitlebar 结构完整保留（:1187 定义、:1244 总览态在 world 内渲染、:1313-1317 钉住的那一条渲染在 world 之外、作为 world 的兄弟节点）；ff0bc5a3e 删掉的 titlebarTransform / safeViewport / safeMainViewport 已无残留；本分支 V3 的行为同时保留（:1234 plan.map 栏目卡、:1250 card.presentation、:1279 isResourceBookAllTarget 预览卡、:1307 worldOverlay、:1318 overlay）。 - apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts：ff0bc5a3e 钉的新不变量（:782-800 钉住标题栏不在 world 内、内联 transform 为空、父节点是场景根）与本分支 V3 既有用例都在。 - resourceBookController.ts 未冲突：nodeWorldTransform（:221）、readWorld 补的 element 输出、nodeWorld 贯穿 cleanRect / FLIP / worldScale（:457、:521）都在。 - 自证： - 仓库内 git grep '^<<<<<<<|^>>>>>>>' 无命中。 - git diff --name-only 87fbf92c5 <本提交> 恰好 18 个文件 = 6618207b5(10) + ff0bc5a3e(5，与前者共用 pitfalls.md) + 46458a825(2) + DesignWorkspacePanel.tsx(1)，没有多余文件。 - git diff ff0bc5a3e <本提交> -- resourceBookController.ts resourceBookController.test.ts 为空（这两个文件 ff0bc5a3e 改过、master 没碰，因此必须逐字一致）；与 ff0bc5a3e 的差异只落在双方都改过的 index.tsx / project-development.suite.ts / pitfalls.md 三个文件上。 - 验证（两条修复都并入后统一执行，全绿）：npm run typecheck exit 0；npm --prefix apps/ai-game-creator-shell run typecheck exit 0；npx vitest run apps/ai-game-creator-shell/tests → 98 files / 1394 passed | 4 skipped（0 failed）；npm run check:encoding → 4489 file(s) passed；git diff --check 干净；npm run check:rustfmt exit 0（这两笔修复都没动 Rust，额外确认一次）。	2026-09-12 18:09:57 +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	ff0bc5a3e7	资源工作台钉住的标题栏移出画布缩放层：整行文字不再发虚 ... - 钉在视口上的栏目标题栏（栏目名 / 计数徽标 / 资源总览入口）改挂场景根，成为带 scale() 的 .game-resource-book-scene-world 的兄弟节点，不再用 scale(1 / s) 抵消 world；总览态的栏目标题栏仍留在 world 里与缩略卡对齐 - index.tsx 抽出 ResourceBookScene.renderTitlebar(placement.pinned) 一处产出两种宿主，删除只服务抵消变换的 titlebarTransform 与 safeViewport/safeMainViewport 中间量 - resourceBookController 按节点自己的坐标系换算：world 内用 world 缩放，world 外（钉住标题栏）用 1；新增 nodeWorldTransform，readWorld 补 element 输出，nodeWorld 贯穿 cleanRect / FLIP 反向 transform / worldScale - 更新 resourceBookFlipValues 与 readOrigin 的口径注释：translate 单位是宿主自身坐标系，不再假定所有宿主都在 world 里 - appSurface 用例改钉新不变量：钉住的标题栏内联 transform 必须为空、不在 world 内、父节点为场景根，卡片必须仍在 world 内；并说明标题栏宿主不再跨视图同一节点、转场仍由控制器按 key 记录的 First 屏幕矩形驱动 - resourceBookController 用例新增「屏幕坐标系的宿主不被 world 缩放除」，并保留 world 内卡片仍按缩放除的对照 - 技术方案 2026-09-05 段落同步新结构；pitfalls 增记取证（截图墨色峰值 98.6 vs 同色正文 91.7、点阵周期反推 dpr=1）、本机复现尝试与结论、三处变异验证和真机判据	2026-09-12 17:09:42 +08:00
suzmii	2d40f02286	合并资源工作台分支：素材类型可由用户变更与角标显示资源类型并入 ... - 把 v3 顶端 ace31a5f1（快速编辑 @ 引用素材 + @ 面板标签筛选）合入本分支，与本分支 1079f6c91（用户可变更素材类型、角标改显示资源类型）并存 - 冲突零：index.tsx 两侧改动落点不同（快速编辑 promptInputSlot 接线 vs 角标取值点），projectResourceLiveIntegration 与验收文档自动合并 - 验证：npm run typecheck exit 0；resourceClassificationPanel + projectResourceLiveIntegration 共 45 tests 全绿；check:encoding 4409 文件通过；git diff --check 干净	2026-09-12 16:57:28 +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	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
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
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
lhk229	8853e3b48e	完善策划调试入口与顾问态切换 ... 统一策划 Debug 日志、快速推进按钮和快速推进命令的开关。 将做成游戏入口放到顾问阶段条末尾并接入正常运行时切换。 登记策划产物资产并补充工作区调试入口测试与技术文档。	2026-09-12 05:06:48 +00: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	90177308e0	pitfalls：补记「同一条命令的口径差异」——CI 用提交范围比较 git diff --check ... - docs/project-memory/shared-memory/pitfalls.md：在「只跑门禁子集 → 同一天两次 CI 红」条目的「原因」里补第三类成因 - 口径差异：CI 跑 git diff --check "${base_ref}"..."${head_ref}"（提交范围），本地裸跑 git diff --check（工作树 vs 索引）在干净树上恒为空，所以本地绿不能证明 CI 这一跳会过 - 实例：pitfalls.md 末尾多出的空行（f16aa440b 引入），因前两次推送分别停在 check:git-hooks 与 check:rustfmt 而一直未被这一跳检查	2026-09-12 02:07:49 +08:00
suzmii	a5c7938d05	修 CI：去掉 pitfalls.md 末尾多余空行（git diff --check 报 new blank line at EOF） ... - docs/project-memory/shared-memory/pitfalls.md：删掉文件末尾多出的一个空行，使文件以单个换行结尾（UTF-8 无 BOM、LF 不变，仅 -1 行） - 该空行由先前提交 f16aa440b 引入；前两次 CI 分别停在 check:git-hooks 与 check:rustfmt，都没走到最后一道 git diff --check，因此一直潜伏 - 自检口径按 CI：git diff --check fafe6b63c..HEAD（CI 是提交范围比较；本地裸跑 git diff --check 在干净树上恒为空，看不出来）	2026-09-12 02:02:12 +08:00
suzmii	31fcbb79dc	pitfalls：记一条「只跑门禁子集 → 同一天两次 CI 红」 ... - 现象：dd7cf401a 给 lint-staged 加 *.rs 键，但本地从未跑过 check:git-hooks（它是 npm run lint 链里的一环），而 scripts/git-hooks.test.mjs 用 assert.deepEqual 钉住 lint-staged 的整份配置形状 → CI 以 deepStrictEqual 失败；本批更早还因 check:rustfmt 红过一次（15660a98b 修 8 处格式偏差），成因是 pre-commit 的 lint-staged 当时只覆盖 *.{js,mjs,cjs,ts,tsx}，Rust 格式本地无守卫 - 原因：npm run lint 是一条 && 长链（encoding / npm-workspaces / git-hooks / rustfmt / spacetime-schema / production-ops / preview-deployer / maintenance-page / eslint / typecheck），中间任一步失败则其后步骤根本不执行，「跑到第 N 步就以为本地绿了」；更隐蔽的是本地若因环境原因在中间断掉（如 Windows 上 check:git-hooks 第 2 个用例的 EBUSY），后面那些本来能通过的步骤也从未被验证 - 处理：push 前按完整链路跑；&& 链在某一步失败时，必须把失败步之后的每一步单独再跑一遍（10 步 + git diff --check）并逐条记 exit code（取 exit code 不要接管道）；改动碰到 package.json / .husky/ / scripts/ 下的门禁资产时，check:git-hooks 是必跑项 - 验证：本次 check:git-hooks 因本机 Windows EBUSY 中断后，补跑其后各步全部 exit 0（spacetime-schema / production-ops / preview-deployer / maintenance-page / lint:eslint / typecheck / encoding），只有 check:rustfmt 红且红在别人在途的 .rs（assets.rs:519 落在其未提交 hunk +470,62、commands.rs:3079 落在其未提交 hunk +3068,58）；变异验证：把 *.rs 从 package.json 摘掉 → 第 1 个用例以同样的 deepStrictEqual operator 变红，还原（SHA256 一致）后回 ok - 纯文档追加：文件末尾 +8 行、无删改；本条只提交 docs/project-memory/shared-memory/pitfalls.md 一个路径	2026-09-12 01:28:05 +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	f16aa440b9	补踩坑：第四类索引事故——git add <路径> 会把同一文件里别人的 hunk 一起暂存 ... - 记录 28781a420 的事故形态：该笔除我新增的用例（@@ -1260,6 +1260,51 @@）外，还混入了 peer 对「所有资源」测试期望的在途改动（@@ -9562,37 +9607,83 @@），提交描述与实际内容不符，且对方那份文件随即显示为干净、容易被误判为已收口；内容未丢 - 写清正确护栏：对可能被他人同时编辑的文件，把 git add <path> + git diff --cached（看内容、不只看文件名）+ git commit 压进同一条命令，并逐 hunk 确认每一个都是自己这次要写的；发现混入他人 hunk 后保持现状并立即上报，不在共享树里用 --amend/reset/checkout --/revert 做手术 - 写清状态信号：M （已暂存且工作区与索引一致）/ MM（add 后又改过）/ M（仅工作区），并点明「M 只能说明 add 之后没人再动过，不能说明这份文件里只有我的改动」 - 写清同类隐患：pre-commit 的 lint-staged 会对它格式化过的文件做 git add（prettier --write 之后 Applying modifications from tasks），与 npx lint-staged --diff=… 属同类反向 git add - 与前三类索引事故（git add -A 卷走别人的文件 / stash pop 弹出别人的 stash / lint-staged --diff 反向 add）并列，指明本类正是「按文件名校验」这道护栏的失效点 - 门禁：npm run check:encoding exit 0（4399 file(s)）	2026-09-11 23:08:57 +08:00
suzmii	3a850ee6e7	补两条踩坑：app-server 会 1:1 回显注入内容（读侧上限不得小于写侧允许量），以及“掉了就补读”的补扫不是修复 ... - 新增「Codex app-server 会 1:1 回显注入内容：读侧上限不得小于写侧允许量」：记录隔离探针实测（捆绑 codex-cli 0.147.0）——注入 5 MiB 的 item，app-server 接受并回一条 5 243 245 字节的 rawResponseItem/completed 单行，而读侧上限当时 4 MiB、写侧无上限，于是合法的注入被读行判成连接级故障，报错方向指向 app-server；同时记下 stderrBytes=405 那类摘要不能当证据（正常启动就有 275/452/546/5996 B 的插件/别名警告）、experimentalRawEvents 需要 initialize.capabilities.experimentalApi、以及探针必须用管道 stdin 与按 CommandLine 精确清理 - 新增「「掉了就补读」的补扫不是修复：自激回路会一路耗到内存」：明确标注**由并行工作线报告、本线未独立复核**，并给出取证据前不得引用的警示与“去掉补扫症状是否回来”的判据 - 门禁：npm run check:encoding exit 0（4399 files）	2026-09-11 22:51:24 +08:00
suzmii	1b7261685c	登记素材上传配对的踩坑与覆盖边界：断言打在生产函数上，端到端 UI 未覆盖 ... - `pitfalls.md` 新增「素材上传不要把『上传前读到的 revision』贴到『上传后读到的清单』上」：现象（每次上传都先吃一条拒收提示）、根因（上传本身推进 revision，错配必然发生而非竞态）、处理（上传动作与配对读收进同一个函数，调用方拿不到中间那个 revision，也就没机会贴错）、同类文案坑（`unresolved` 三条进入路径里有两条重读是**成功**的，写成"读取磁盘清单失败"就是误报）、验证与变异，并记录关联文件与提交。 - 覆盖边界（按当下口径写清，防止后人误读）：断言打在生产函数 `uploadProjectAssetFilesAndReadSnapshot` 上 —— 它同时拥有上传与配对读，所以配对语义是真测的；但 AGC 侧**没有**「资源面板上传 → 拒收提示条」的端到端 UI 用例（现有 harness 只有聊天入口的 `/asset.upload`，资源面板 file input 无用例），因此「界面上不再出现拒收提示」是推理结论而非端到端断言，禁止当成端到端覆盖引用。 - 同一条边界同时写进 `projectResourceLiveUpdateModel.test.ts` 用例组头部，随断言一起走，避免只看测试文件的人误读。 - 纯文档 + 测试注释，无功能改动。	2026-09-11 22:19:14 +08:00
suzmii	fef366a66b	文档跟进：资源画布的引用入口按当前状态描述（图标 @ + 文案「引用」） ... - 「当前已完成」清单里「资源画布素材卡提供 `@引用`」既不准确也不再是当前形态：入口已从卡片挪到选中工具条，且可见文案与 title 都不再自带 `@`（`@` 由 `AtSign` 图标承担，文案再写一次会渲染成「@ @引用」）。 - 按「四不写」把该条直接改写成当前状态：入口位置（选中工具条）、图标与文案口径（图标 @ + 文案「引用」）、以及插入对话里仍然是 `@素材名` 芯片。 - 纯文档，无代码改动；单独提交便于 cherry-pick。	2026-09-11 22:18:09 +08:00
lhk229	5646824daf	补充策划Agent思考展示预留 ... 增加策划 Agent reasoningText 事件字段与默认折叠展示入口 补充正文、思考过程和工具状态的字体层级样式 记录当前 Provider 尚未输出 reasoning 的现状与后续边界	2026-09-11 13:02:55 +00: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	3a4f95d7ca	Merge remote-tracking branch 'origin/master' into feat/agc-canvas-resource-workbench-v3 ... # Conflicts: # apps/ai-game-creator-shell/src/App.tsx	2026-09-11 20:56:14 +08:00
suzmii	fcaf1a8e91	补坑位记录：新增文件后必须重跑完整 typecheck ... - pitfalls.md 新增 2026-09-11 条目，记 lint-staged 只做 eslint 与 prettier、不做 tsc，因此 pre-commit 绿不等于类型正确 - 按体例写现象（第 113 行 TS2322、ref 元素类型不匹配）、原因（typecheck 是在新增该文件之前跑的）、处理（每新增或改名源文件后重跑完整 typecheck，门禁顺序固定为改完 → 全量 typecheck → 定向测试 → 其余门禁） - 验证写明：修复后 exit 0、修复前 exit 2，而定向测试修复前后都是 22 passed，说明测试通过推不出类型正确；并推广到未使用 import、类型层 props 不匹配、只有 tsc 才发现的 .tsx 泛型推断失败 - 该文件原本结尾没有换行符，追加后上一行必须重写为带换行，因此 diff 记为 11 增 1 删；已逐字核对被删行原样出现在新增行中，实际无内容丢失	2026-09-11 20:39:19 +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
lhk229	1102b5af23	Merge remote-tracking branch 'origin/master' into design_agent_refactor	2026-09-11 11:22:29 +00: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
lhk229	712f28e207	策划工作区改名为design_artifacts ... 更新策划文件工具和阶段产物检查路径 同步测试夹具与生产迁移方案文档	2026-09-11 10:16:15 +00:00