1245 Commits

Author	SHA1	Message	Date
kdletters	01e97d3a02	补齐 Direct 回合跨页面恢复 ... 新增活动 Direct 回合只读快照与状态更新 接入重进项目的忙碌态恢复和运行中项目面板 补充生命周期规范、决策记录与定向测试	2026-09-15 23:38:09 +08:00
kdletters	361daf374d	修复 AGC 统一错误诊断与素材验收 (#376) ... ## 变更内容 - 新增统一 Agent Runtime 错误事件和项目内诊断 sidecar，统一 DirectProject、Agent Runtime、app-server 与 AGC 工具桥的失败记录。 - 失败回执写回 DirectProject 对话历史，下一轮可读取上一轮失败证据；前端支持读取脱敏诊断详情。 - 区分 app-server 终态、空闲/硬超时、工具参数错误和试玩次数越界。 - 素材完成门扫描实际 npm 源码模块，并识别 manifest 中合法的自定义登记素材路径。 - 更新 AGC 技术规范、项目决策记录、里程碑和实施计划。 ## 验证 - cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --tests - 统一错误测试 6/6 通过 - DirectProject 失败诊断测试 4/4 通过 - npm 场景模块素材引用回归测试通过 - npm run --prefix apps/ai-game-creator-shell typecheck - npm run check:encoding - npm run check:doc-index - git diff --check、Rust 格式检查 真实 Provider / 安装包 smoke 尚未在本 PR 中运行。 --------- Co-authored-by: Git Hooks Test <git-hooks-test@example.invalid> Reviewed-on: #376	2026-09-15 20:21:53 +08:00
kdletters	29e84a77d1	切换 Tiantoken 并删除旧 Vidu 音效 ... 新增 TIANTOKEN_BASE_URL / TIANTOKEN_API_KEY 配置并切换文本与图片链路 保留 Suno VectorEngine 路径，删除旧 Vidu submit/poll/builder 实现 同步脚本、文档、测试与运行时 provider 路由	2026-09-15 19:43:35 +08:00
lhk229	9aa6f5efea	解决platform-llm和策划agent reasoning问题，并修复若干bug (#350) ... Reviewed-on: #350	2026-09-15 00:50:36 +08:00
suzmii	d0b15dbc54	AGC 生成任务侧栏：收起也补上退场动画，退场期间内容不跳 ... - 进场本来就有动画（`…-enter`），收起却是瞬间卸载，观感上"闪一下没了"。现在收起先播退场再卸载：`open` 变 false 后进入 `leaving`，根节点挂 `is-leaving` 播 `…-leave`（与进场同向反向，160ms，`pointer-events: none`），播完才卸载 - 时长在组件与 CSS 两处各写一次，组件导出 `RESOURCE_CANVAS_ASSET_GENERATION_TASKS_LEAVE_MILLIS` 并由用例钉住两处一致 - 减动效偏好下 CSS 已关掉动画，组件那边同步按 0ms 处理，收起立即卸载，不白等 160ms - 退场期间沿用收起前那一份列表（`lastRenderedRef`）：宿主会在同一帧里收起侧栏并把在途任务收口，直接吃新 props 会让退场动画里的内容跳一下；滚动区的空态分支也改读这份冻结快照，不能读实时 `ordered`（这是本批调试时用假时钟用例抓到的真问题） - 用例：面板用例新增「收起时先播完收起动画再卸载，动画期间列表内容不跳」；样式用例新增「is-leaving 挂上收起动画、pointer-events: none、减动效同样关掉」；既有生成任务相关性用例改为等退场动画走完再断言（新增 `waitForTasksSidebarLeaveAnimationToFinish`） - 文档：AGC 入口矩阵与 decision-log 同步退场动画口径 验证：tsc --noEmit 通过；appSurface 全量 441 条通过；侧栏面板 9 条、样式 10 条、开合与入口 3 条通过；变异验证：把早返回改回「立即卸载」与把 CSS 的 `is-leaving` 选择器写错，对应断言分别变红	2026-09-14 23:01:35 +08:00
suzmii	96971403ee	AGC 资源画布：定位到素材后把视口居中到该卡 ... - 根因：`handleResourceSelect` 只改选中、不移动画布，而这张画布是 transform 平移的、资源卡不在任何滚动容器里；既有的 `card.scrollIntoView()` 碰不到滚动祖先，卡在视口外时用户看到的就是「定位过去了但依然见不到素材」 - 新增 `centerResourceCanvasOnResource`：读该卡在当前布局位置表里的 x/y 与卡片尺寸，按 `canvasSize / 2 − 卡中心 × scale` 求视口平移量；缩放保持不变（定位不改用户缩放预期，与 `ensureResourceBookContentVisible` 同口径） - 聚焦链在「选中新资源」那一步之后调用它；`scrollIntoView` 保留（栏目页仍有带滚动条的祖先） - 用例：新增「centers the canvas viewport on the located asset so it is actually visible」，用渲染进 DOM 的真实画布尺寸断言 `viewportX + 卡中心 × scale = 画布中心` - 文档：decision-log 补「失去焦点即收起」与「定位必须让素材真的可见」两条决策；AGC 入口矩阵同步自动收起、入口顺序与定位居中口径 验证：tsc --noEmit 通过；appSurface 全量 441 条通过；变异验证：把定位链里的居中调用摘掉，新用例变红（450 vs 400，正好是画布宽 800 的一半与旧视口之差）	2026-09-14 22:36:32 +08:00
suzmii	96ae3db1df	AGC 资源工作台三处交互收口：侧栏关闭入口合并、删除折叠把手、播放左对齐 ... - 「生成任务」侧栏头部右上角由返回箭头（ChevronLeft / aria-label=收起生成任务）改为关闭 X，并与底部那枚重复的 X 统一为同一个 aria-label=关闭生成任务 - 删除「生成任务」侧栏底部 footer（关闭按钮 + border-top 分割线）：关闭入口只留头部一枚 - 删除「生成任务」侧栏折叠态的左侧贴边竖排把手（handle 及其标签 / 在途角标 / 进场动画 / 悬停位移）：折叠后组件不再渲染任何常驻入口 - 清理上述删除留下的悬空样式：focus-visible 分组选择器、480px 窄屏媒体查询与 prefers-reduced-motion 块里的把手分支 - 工具条「生成任务」入口移出 `mode === 'resources'` 分支：两个页签下都常驻。侧栏本体本来就是无条件渲染的浮层，运行态可见；入口只留资源页签时，切到运行关掉侧栏就再也打不开（此前靠左侧贴边把手兼作运行态入口） - 工具条把「播放」移到「资源管理 / 运行」右侧并左对齐：新增 .game-workbench-view-tabs 作为左侧控件组，播放按钮由 absolute + left:50% + translateX(-50%) 的居中悬浮改为 static；相应删除 max-width:1000px 里的居中兜底规则 - 播放按钮并进按钮基础外观与 focus-visible 规则列表：新位置不再命中 .game-workbench-tabs / .game-workbench-view-actions 的选择器，漏掉会掉成零圆角、零内边距、无边框、默认字号的裸按钮（颜色规则仍生效，肉眼容易漏） - 播放按钮保持两个页签下都常驻（回到改动前的可见性）：运行视图空态与预览失败态要靠它重跑 - 同步更新断言：侧栏关闭入口唯一且 footer 不存在、折叠态不渲染任何按钮或把手、样式表不残留被删类名、播放按钮声明为左对齐静态定位且仍在基础外观/焦点环规则内 - 生成任务用例补回机器证据：折叠后工具条按钮的 data-resource-generation-task-count 归零、重开后头部「在途生成任务 0」徽标跟上收口结果、运行页签下侧栏仍能重开（先用 aria-selected 钉住真的切了页签）；用例夹具新增 runnable 开关把首个原型标成完成 - 同步文档现状：PRD 顶部播放按钮与任务侧栏进度面两条、AGC 栏目画布底部工具栏入口矩阵的侧栏形态、decision-log 的进度面形态决策 验证：tsc -p apps/ai-game-creator-shell/tsconfig.json --noEmit 通过；vitest appSurface 全量 440 条通过、生成任务侧栏 8 条与侧栏样式 9 条通过；check-encoding 通过；prettier --list-different 未新增命中（project-development/index.tsx 属基线既有非格式化文件）；变异验证：还原播放按钮基础外观规则、还原折叠把手与 footer、还原折叠态早返回、把「生成任务」入口退回 mode 分支，对应断言均变红	2026-09-14 22:00:06 +08:00
suzmii	b077cb5277	更正 decision-log：「整理画布」最终位置固定在「生成素材」之后、「管理未完成编辑」之前（不在行尾）	2026-09-14 19:30:02 +08:00
suzmii	6c98c19c12	更正 decision-log：「整理画布」是资源工具条动作区里的独立动作按钮，不在「资源排列方式」分组内	2026-09-14 19:11:33 +08:00
suzmii	a6de1b5570	Merge remote-tracking branch 'origin/master' into fix/agc-canvas-acceptance-batch	2026-09-14 19:07:46 +08:00
k88936	411f49a65d	Merge pull request 'UI编辑器自动分图层切图标' (#304) from feat/ui-editor-auto-seperation into master ... Reviewed-on: #304	2026-09-14 18:59:00 +08:00
suzmii	a45172e055	同步文档：生成进度面收敛为常驻可折叠侧栏、提交即关面板、定位终局化、类型选项纵向列表 ... - PRD §3.10：进度面由「非模态浮层」改为「常驻画布的可折叠任务侧栏」（折叠把手带在途计数、两个分栏、已完成封顶 20、左侧覆盖式、提交后自动展开）；定位动作终局化（跨栏目先切栏目 / 不在投影给结论 / 3 秒有界兜底） - PRD §3.10 面板形态：改为「点「生成」即同步关闭面板、面板内不出现阶段文案；只有点击瞬间失败才带草稿重开；受理后失败只在侧栏收口」 - 栏目画布入口矩阵 §4/§4a：同步上述两条，并把 4a 标题由「「生成任务」面板」改为「「生成任务」侧栏」 - decision-log：新增 2026-09-14 条目（进度面收敛为常驻可折叠侧栏 + 提交即关面板 + 定位终局化，含位置取舍与覆盖式理由、五条变异证据）；并在「素材类型」条目补记选项形态修订（纵向单选列表、radio 语义、方向键只移焦点、行列与滚动口径、建议后续抽 PlatformRadioList）	2026-09-14 18:50:48 +08:00
kdletters	c799d00a93	记录分支保护现状：不把 Project CI 配成合并必需检查 ... 复核后确认本仓库不把 Project CI 的 context 配成 master 分支保护的合并必需检查，合并前由人工 确认最近一次结果。据此把文档里"必须设为合并必需检查 / 需补 6 个新 context"的强制口径改成 与现状一致，避免下次有人照着一个不执行的待办去逐个勾选 context： - 开发运维文档：说明当前不配 required context（代价是门禁红了不会自动阻止合并），把 11 个 context 清单降级为"将来若要启用时的清单"，并保留"不能残留已不再上报的旧 job 名，否则 PR 会永远停在等待该检查"这一条；master 交付口径里"当前 head 的七个 required context 全绿" 改为"最近一次 Project CI 全绿"。 - shared-memory/decision-log：AGC 壳分片那条的"影响范围"不再把它列为待补 context 的待办。 - shared-memory/pitfalls：置顶条目新增"分支保护口径"，并把旧条目里"要补齐两个新 AGC context"改成"确认没有残留旧 job 名"。 - .craft 的 gitea-ci-triage 技能同步为"改 job 集合或 job 名不需要同步分支保护"。 验证：prettier、check:encoding、check:doc-index 通过。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 18:35:00 +08:00
suzmii	b898590c7d	合并 feat/agc-resource-type-entry：类型选项改纵向单选列表 ... - 合并 WS4 追加修复（928a0ea13：类型选项由横排 PlatformSegmentedTabs 改为 role=radiogroup 纵向单选列表， 复用共享 PlatformNavigableListItem，列表有界独立滚动，rogiving tabindex + 方向键移焦点、Enter 落盘） - 同时并入 origin/master a70ef2d6e（PR #354 Windows sccache / CI 分片改「一片一 job」） - decision-log.md / pitfalls.md 冲突按「上游改写优先、我方新增保留」解： 保留我方新增的「放开手工图片生成本地并发」「素材类型独立入口」「退役同步命令」三条与 「严格 IPC 桩缺登记新命令」一条；AGC 壳 Rust 套件条目采用上游改写后的新标题（「一片一 job」）， 删掉被它取代的旧标题（旧正文早已被上游替换），不留自相矛盾的两条	2026-09-14 18:18:30 +08:00
suzmii	8ac77cb090	同步共享记忆与专题文档：并发槽身份、素材类型入口、退役同步命令 ... - PRD §3.10 本地排队一条：删掉已失效的「共用 single-flight 输出槽」理由，改为「本地槽已按精确动作指纹分槽（具备并行能力），本批前端仍按单条在途排队，真并行派发留待下一批」 - 栏目画布底部工具栏入口矩阵 §4a：同上更正，并写明槽身份材料的 8 个字段与旧槽懒迁移 - decision-log：追加三条 2026-09-14 条目（放开手工图片生成本地并发 / 素材类型拆成独立入口 / 同步命令 generate_local_project_asset 退役为仅测试调用） - decision-log：更正同日「图片类生成后台化」条目里已被同批次推翻的两处表述（槽身份、本地排队的理由），并给 2026-09-11 的类型选择器入口决策加「已被取代」标记 - decision-log/pitfalls：把「严格 IPC 桩缺登记新命令」的排障经验记入共享记忆（unhandled rejection 与不相干提示断言的组合症状、桩必须返回数组、形状错会「看着绿」） - 端到端验收用例 S12：更正「用户手动设置 category 已移除」与「面板内删除资源是唯一入口」两处与当前实现不符的描述	2026-09-14 17:52:27 +08:00
k88936	b082addc34	Merge remote-tracking branch 'origin/master' into feat/ui-editor-auto-seperation	2026-09-14 17:41:36 +08:00
kdletters	2566ae705f	AGC 壳 Rust 套件改为「一片一个 job」，客户端 Rust 关键路径压到 7 分钟以内 ... 上一轮把 2466 条 bin target 单测切成 4 片放在同一个 job 内多进程并行，run 2102 证明这条路 不通：门禁步骤跑满 18 分钟仍未结束，比整套串行的 507 秒还慢——同一容器内这几片共享 HOME、target 目录与固定临时路径，会互相拖慢。这一轮改成按 job 拆分。 - run-rust-shell-test-shards.mjs 新增 --shard-index=<i>：只跑第 i 片，供 CI 的每个分片 job 使用；覆盖自校验（片并集等于 --list 全集且互斥）仍针对全集执行，所以每个 job 都会 发现分片规则改动，不会被"只跑一片"绕过。负例 --shard-index 超出 --shards 立即失败。 不传 --shard-index 时行为不变（一条命令把 N 片放进程里并行），留给本地全量自测。 - project-ci.yml 由 7 个 job 变 11 个：原 AGC Rust job 拆成 AI game creator shell Rust shard 1/4 ~ 4/4 与 AI game creator shell Rust smoke，加上已有的 Rust crates，AGC 相关 门禁共 6 个 job。4 个片 job 只预热 AGC 壳自己那份锁定依赖，且与 smoke、crates 一样都是 纯 cargo 门禁，因此这 6 个 job 都不再执行 npm ci（每个省 1~3 分钟）。 - check-native-shells.mjs 分组由五个变十个：agc-rust-shard-1 ~ agc-rust-shard-4 与 agc-rust-smoke 取代 agc-rust-shell；每个分片分组的命令是 `npm run ai-game-creator-shell:check:rust:shell -- --shard-index=<i>`。 - project-ci-workflow.test.ts 相应更新：11 个 job、6 个 job 免 npm ci、10 个分组各被一个 job 恰好调用一次，并新增「每个分片 job 都落到 --shard-index」「4 个 index 各一次」 「分片运行器保留覆盖自校验」等断言。 - 同步运维文档、development-workflow、decision-log、pitfalls 与 gitea-ci-triage 技能到 job 级分片口径，并记录 run 2102 的反面实验，避免以后又改回单 job 内并行。 验证：npx vitest run scripts/project-ci-workflow.test.ts（12 passed）、eslint、prettier、 check:encoding（13330 文件）、check:doc-index、--groups=contract、mobile check-config 全绿； 分片运行器本地以 agent-runtime-core（7 条 → 2/2/2/1）验证 --shard-index 四个 index 各自 只跑一片、片 TMPDIR 隔离、无 index 时全量模式不变。Gitea master 分支保护需补 6 个新 context（共十一个），其中含 4 个分片 job、smoke job 与 crates job。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 17:32:06 +08:00
suzmii	6b5f67d207	Merge branch 'feat/agc-generation-task-progress' into fix/agc-canvas-acceptance-batch	2026-09-14 17:31:32 +08:00
suzmii	bb7cbae118	feat(agc): 图片类生成后台化，生成面板可随时关闭并新增「生成任务」进度面板 ... - Rust 新增 asset_generation_tasks.rs：图片类生成拆成「提交即返回任务记录 + 后台 spawn 生成」， 生成本身仍转调既有 generate_platform_art_asset_with_options_at（不复制生成 / 幂等 / 登记逻辑） - 任务账本落项目内 .agent/runtime/asset-generation-tasks/tasks.json（复用 agent runtime sidecar 原语）， 阶段文案 phaseDetail 由后端拥有，读取时把上次运行留下的非终态记录收口为「中断失败」，账本上限 50 条 - Rust 新增 IPC start_local_project_asset_generation / list_local_project_asset_generations 并在 main.rs 注册； 同步命令 generate_local_project_asset 保留不动 - 新增前端纯模型 resourceCanvasAssetGenerationTaskModel.ts：任务状态机、在途判据、账本恢复、耗时文案 - 新增 resourceCanvasAssetGenerationQueue.ts：本地排队驱动器，第二条不发提交 IPC、前一条终态后自动补发， 状态与阶段一律以后端账本为准，账本查不到该任务时按上限停止等待 - 两块生成浮层在提交期间放开 × / 遮罩 / Esc，次按钮在途时改为「后台运行并关闭」（关闭不等于取消请求）， 图片类面板的在途文案改为渲染后端 phaseDetail - 新增非模态「生成任务」面板（不铺遮罩 / 不做焦点陷阱 / 不进模态遮挡判据），显示状态、后端阶段、 已耗时与素材名，已完成条目复用 pendingResourceFocusRef 聚焦链定位素材卡 - index.tsx 宿主接线：任务列表状态与 ref、提交回调不再读面板状态、按项目恢复任务账本、 工具栏「生成任务」入口按钮与面板渲染点 - check-config.mjs：把已无前端调用方的同步命令 generate_local_project_asset 登记进 native-only 白名单 - 测试：新增「生成面板提交期间可关闭」「本地排队驱动器」「生成任务面板」三组用例； appSurface 生成载荷断言改为 start_local_project_asset_generation + list 轮询桩 - 文档：入口矩阵补 §4a 与验证命令、V3 验收 S11a 判据、decision-log 记录本次决策	2026-09-14 17:26:36 +08:00
suzmii	0b3bf3e52d	合并 fix/agc-resource-layout-manual：资源画布改为手动整理口径 ... - 合并 WS2 分支（新素材不再自动重排 + 显式「整理画布」+ 生成后自动聚焦） - index.tsx 与 useProjectResourceCanvasLayout.ts 自动合并成功，无需手工介入 - decision-log.md / pitfalls.md 冲突按「两侧语义都保住」解：保留 origin/master 新增的 「AGC 壳 Rust 套件分片并行」与「根门禁 label 字面量契约」两条，同时保留 WS2 新增的 「AGC 资源画布改为手动整理」与「不要恢复无条件重派生」两条，只删除冲突标记行 - 新增 tests/resourceCanvasManualLayout.test.tsx	2026-09-14 17:16:58 +08:00
suzmii	3b8ecb02d4	记录 AGC 资源画布「手动整理」口径变更 ... - decision-log：追加 2026-09-14 条目，记录默认 preserve、显式「整理画布」、 依赖侧关系图首次就绪的一次性重派生、新素材按 manifest 新增 id 聚焦四条决策与变异验证 - pitfalls：追加「不要恢复无条件重派生」条目，含 changed 门、ready 时序、 项目作用域 flag 与新素材基线四个易错点	2026-09-14 17:08:00 +08:00
kdletters	86b830cf2d	AGC 壳 Rust 套件分片并行，客户端 Rust 关键路径压到 7 分钟以内 ... run 2097 显示 AI game creator shell Rust tests 是客户端 CI 的关键路径（15 分 27 秒）： 前置 5 分 30 秒（checkout + npm ci + Cargo fetch）、编译 1 分 39 秒、AGC 壳 bin target 的 2466 条单测一条命令串行 507 秒、agent-run smoke 51 秒。 - 新增 apps/ai-game-creator-shell/scripts/run-rust-shell-test-shards.mjs：cargo test --no-run 编译一次拿到测试可执行文件，用 --list 取全部用例名，排序后按 index % shards 切 4 片，每片作为独立进程执行 <bin> --exact <名单> --test-threads=1，并给每片独立 TMPDIR。片并集必须等于 --list 全集且互斥（assertShardsCoverEveryTest），改分片规则 不会静默漏跑。串行口径只从「整套串行」放宽到「片内串行」：当年 libtest 线程并行会 互相干扰的是进程内后台锁与异步终态，进程分片不共享这些状态，因此不必放宽断言。 - package.json：ai-game-creator-shell:check:rust 拆成 :rust:crates（agent-runtime-core / orchestration / platform-llm / shared-contracts）与 :rust:shell（分片运行器），聚合 脚本保持同序，ai-game-creator-shell:check 与本地全量入口语义不变。 - check-native-shells.mjs：分组由五个变六个（新增 agc-rust-crates、agc-rust-shell， 移除 agc-rust）；smoke 与壳测试同组以共享 AGC 壳的依赖预热。 - project-ci.yml：新增第 7 个 job AI game creator shell Rust crates（预热 server-rs 与 两个无锁独立 crate 后跑四条 crate 测试）；AI game creator shell Rust tests 只保留壳 分片与 agent-run smoke，并只预热 AGC 壳自己那份 manifest（其 Cargo.lock 的 path 依赖 已覆盖 platform-llm / platform-agent / agent-runtime-core / shared-contracts）。 这两个 job 只用 cargo 与 node 内建模块，因此都不再执行 npm ci（各省 1~3 分钟）。 - project-ci-workflow.test.ts：新增纯 cargo job 免 npm ci、分片运行器覆盖校验、crate 级 job 预热顺序等断言；同步运维文档、development-workflow、decision-log、pitfalls。 验证：分片运行器本地以 agent-runtime-core（7 条 → 2/2/2/1）与 platform-llm（146 条 → 49/49/48）验证分片、--exact 与片 TMPDIR 隔离，参数负例 exit 1；vitest scripts/project-ci-workflow.test.ts 12 passed；contract 分组、AGC 与 mobile 壳 check-config、eslint、prettier、check:encoding（13400 文件）、check:doc-index 全绿。 Gitea master 分支保护需补 Project CI / AI game creator shell Rust crates (pull_request)。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 17:02:34 +08:00
kdletters	f9bd0adae1	补齐客户端 CI 拆分的共享记忆：label 字面量契约与实测耗时 ... - pitfalls：新增「根门禁的 [check:native-shells] <label> 是别处按字面量校验的契约」， 记录 run 2095 里 desktop-shell typecheck 的失败根因（label 被抽进公共打印函数后， check-config 的字面量断言落空）、处置与本地验证方式。 - decision-log：把「预计收敛到约 13 分钟量级」换成 run 2097 实测——六个 job 全绿、 wall-clock 15 分 27 秒（拆分前 run 2094 为 22 分 15 秒），关键路径转移到 AI game creator shell Rust tests，壳体串行套件 507 秒是硬底。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 16:47:35 +08:00
kdletters	20f109027a	按门禁组拆分客户端 CI，AGC 的 web / rust 两段并行 ... 原生壳门禁原本挤在同一个 job 里串行执行，跑一遍 18 分 37 秒，其中 AI 游戏创作 壳独占约 15 分钟（壳内 Rust 套件 2451 条用例串行 441 秒），而微信 / 移动 / 桌面 / H5 的全部门禁加起来不到 50 秒。长尾拖住短门禁，runner 也无法并行。 - scripts/check-native-shells.mjs 支持 `--groups=`（contract / shells / agc-web / agc-rust / release）：每个步骤与静态断言归属且只归属一个分组，不带参数时仍按 原顺序串行跑全部分组，本地 `npm run check:native-shells` 语义不变。 - 顺带修掉 H5 HostBridge 调用链扫描在 Windows 上恒红的缺陷：collectFiles 返回 反斜杠路径而期望清单是 POSIX 写法，scannedFiles.has() 永远为假。新增 normalizeScannedFilePath 只统一分隔符（不能复用会去后缀的 normalizeModulePath）， 在 Linux 上是恒等变换。 - package.json 增加 5 个分组脚本，并把 ai-game-creator-shell:check 拆成 :check:web 与 :check:rust；聚合脚本保持 web && rust && agent-run:smoke 同序。 agent-run smoke 会 spawn cargo，因此归入 agc-rust。 - .gitea/workflows/project-ci.yml 拆成 6 个 job：新增 native-shell-tests（contract + shells + release）、ai-game-creator-shell-web-tests、ai-game-creator-shell-rust-tests 三个门禁 job，与 backend-tests / frontend-tests / repository-checks 并列。 - scripts/project-ci-workflow.test.ts 增加 3 条结构测试：分组恰好被一个 job 调用且 与脚本内声明一致、CI 不再调用全量入口、AGC web/rust 拆分与聚合脚本等价、独立 crate 预热必须发生在 AGC Rust 门禁之前。 - 同步运维文档、development-workflow、decision-log、pitfalls。 验证：`--groups=contract` 本地通过；vitest 11 passed；eslint 与 prettier 通过； check:encoding 13329 文件通过；check:doc-index 103 份通过。shells / agc-web / agc-rust / release 分组只能由 Linux CI 执行（Windows 上 spawnSync npm.cmd 报 EINVAL，属既有平台限制，非本次引入）。分支保护需补两个新 required context： `Project CI / AI game creator shell web tests (pull_request)` 与 `Project CI / AI game creator shell Rust tests (pull_request)`。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 16:13:11 +08:00
kdletters	4e553bb15d	收窄项目写锁同进程复用判据为同线程重入 ... - 修复 write_lock.rs：advisory 复用判据从「本进程持锁」收窄为「同一线程重入或自主流水线」，新增按锁路径登记真实持锁线程的 PROJECT_WRITE_LOCK_THREAD_OWNERS，登记在 create_new 成功处、在 guard Drop 里按路径注销（guard 会被移到别的线程再 Drop） - 恢复本进程其它线程写通道的串行化：一致快照读、project.diff / action_history、command.output_read、steer 序号分配、项目 revision 侧车、pending sidecar 复核与恢复安装重新等待并保持终态占用 - 调整 tests/project_tools.rs 的 agent_runtime_file_write_lock_failure_redacts_project_path：改为在另一条线程持锁，保持「别的写者持锁时 file.write 失败关闭且脱敏」的断言语义 - 调整 ui_editor/persistence.rs 的 recovery_install_respects_the_project_write_lock：同样改为在另一条线程持锁，保持占用失败断言 - 同步技术方案「2026-09-14 项目客户端占用锁收敛」段落，以及里程碑和实施计划的目标、验收标准、修改顺序、验证命令与未决事项 - 在 decision-log 记录复用判据收窄为同线程重入，并在 pitfalls 记录「同进程复用判据不能只看 pid」的现场、原因、处理与易错点 - 回答 AGC 生命周期文档「同 PID advisory guard 是否放过并行写」的未决项：确认会放过并行写，已收窄 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 15:41:17 +08:00
kdletters	86c1187ddc	放开 DirectProject Codex 沙箱权限 (#347) ... ## 变更内容 - DirectProject Codex app-server 使用 danger-full-access sandbox。 - 移除 workspaceWrite / writableRoots 与文件变更审批根白名单。 - DirectProject app-server 交互请求不再按 grant root 裁剪；首页只读对话、AGC 受控 MCP、凭据隔离和 Runtime 审计边界保持不变。 - 同步更新 DirectProject 提示词、技术方案和决策记录。 ## 验证 - Rust 定向测试：49 passed，1 ignored。 - npm run check:encoding 通过。 - npm run check:doc-index 通过。 - git diff --check 通过。 - pre-push-master 门禁通过。 Reviewed-on: #347	2026-09-14 13:19:44 +08:00
k88936	513c25898c	Merge remote-tracking branch 'origin/master' into feat/ui-editor-auto-seperation ... # Conflicts: # apps/ai-game-creator-shell/src/view/project-development/index.tsx	2026-09-14 11:32:17 +08:00
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
k88936	a19684a5f5	Merge remote-tracking branch 'origin/master' into feat/ui-editor-auto-seperation	2026-09-12 19:46:41 +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
k88936	48e669d167	合并主线并解决界面编辑器冲突 ... 合并主线的 AGC Runtime、UI 工作流与开发脚本变更 保留现行 Prompt Runtime 结构并整合设计基础提示词契约断言 适配 CanvasWorld 逆缩放渲染并修正预览缩放回归测试 同步项目文档、共享契约与已退役策划资源清理	2026-09-12 11:38:50 +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