471 Commits

Author	SHA1	Message	Date
suzmii	e6849d2a45	Merge branch 'master' into refactor/agc-resource-menu	2026-09-17 20:45:21 +08:00
kdletters	d5743cd4b8	资源画布支持引擎资源预览与模型交互预览 (#413) ... ## 目的 资源画布支持引擎（Cocos Creator）资源的**只读预览**：能被发现、登记、进入画布，并按类型出预览。 ## 主要改动 - 发现层识别 Cocos 资源并区分 `model` / `binary` 两个发现类别；`.meta` 等导入侧车文件仍只可发现 - 登记层按扩展名写入**既有** canonical kind（模型/场景/预制体 → `scene`，动画 → `character-animation`，材质/特效 → `code`，图集与容器 → `document`），不新增 manifest 契约字段 - 引擎工程的 `library/` / `temp/` / `profiles/` / `local/` 不再进入发现结果（仅当目录确实是 Cocos 工程），同名目录在非引擎工程里照常列出 - 资源画布新增三个卡面分支：模型缩略图（整页共用一个 WebGL 上下文）、结构摘要（Cocos 序列化资源）、类型卡（客户端解不了的容器） - 新增模型放大预览浮层：左键旋转 / 右键或中键平移 / 滚轮缩放 / 复位视角 - 模型预览上限 32 MiB；缩略图按布局尺寸 2 倍超采样，缓存键改用稳定身份 - 引擎图像容器（tga/tif/tiff/hdr）在原生侧转码成 PNG 后复用既有图片预览链路 - 修复资源卡状态边框吃掉内容盒导致的卡面与角标位移 - 同步 Agent 提示词与 AGC 技能文档，并补里程碑与踩坑文档 ## 验证 - `cargo check`、`cargo fmt --check` - Rust 定向：`cargo test … cocos` 9 条、`resource_inspect::tests` 7 条、`agent_asset_import_tests` 9 条、生成目录过滤用例 - 前端：`resource` + `project` 套件 52 文件 / 546 用例；`appSurface` 450 通过 / 20 跳过；app `tsc --noEmit` - `npm run check:encoding`、`git diff --check`、`npm run check:doc-index` - 真机：在真实客户端内打开本地 Cocos 夹具工程，逐栏核对模型缩略图 / 结构摘要 / TGA 转码 / 类型卡，并量过卡片在指针移开、悬停、选中三态下几何完全一致 ## 未验证 - 模型缩略图与放大预览的真机视觉只覆盖自带夹具工程；多文件 glTF（外部 .bin/贴图）与超大模型仍是类型卡 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/413	2026-09-17 20:28:39 +08:00
suzmii	c329c438d9	修复资源画布PR的CI回归（#410） ... 修复活动回合空快照引用及停用后晚到请求覆盖问题 对齐共享卡片角标与窗口发布次数回归断言 同步原生HTTP权限检查与图集显式切片测试契约 整理菜单组件导入顺序并记录本地验证范围	2026-09-17 20:17:26 +08:00
kdletters	5db407c3dc	新增 AGC 模板库与由模板创建项目链路 (#396) ... ## 交付范围 - OSS `agc-dev` bucket 的 `templates/` 前缀作为 AGC 游戏模板库（**去掉 `agc/` 这一层**；`agc/` 继续只放客户端安装包与更新清单）。 - 模板正文改为 zip（zip 根 == AGC 项目根，如 `game/index.html`）；清单补齐 `tags`、封面字段与包大小/摘要，`templateVersion` 用于判断是否需要重下。 - 客户端：Rust 模板库模块、模板库全屏页、首页模板推荐位、左侧导航入口。 ## 客户端行为 - `fetch_game_template_library`：读取并校验清单（≤4 MiB），缓存到 `<app_data>/templates/index.json`；网络失败回退本机缓存并标注 `source=cache`。 - `download_game_template`：按清单下载 zip（≤512 MiB），校验字节数与 SHA-256 后解压到 `<app_data>/templates/installed/<id>/<version>/`，最后写 `installed.json` 作为安装完成标记。 - `create_automatic_local_game_project_from_template`：先把模板文件铺进新项目目录，再走既有 `init_local_game_project_at` 补 `.agent` 清单与标准目录；失败删除半成品目录。 - 解压只接受普通文件与目录（拒绝绝对路径、`..`、盘符、符号链接），安装目录名由标识符白名单拼出；远端只信「受信任 OSS 主机 + 对象键」，清单里的地址字段不参与请求。 - UI：搜索（空白分隔多关键词「与」）、标签/运行时筛选、仅看已下载、封面卡片与已下载徽标；「使用模板」在版本落后时先重下再建项。 ## 文档与脚本 - 主规范 `docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md`；里程碑与实施计划见 `docs/project-memory/plans/`；`decision-log.md` 记录库路径、清单 schema、安装缓存目录与 CSP 约定。 - 发布脚本 `scripts/agc-template-library-publish.mjs`（`--dry-run` 校验 → 上传 → 回读校验）。 - 首页「灵感推荐」替换为模板库推荐位，删除本机灵感图目录与 `InspirationGallery.tsx`；`tauri.conf.json` 的 `img-src` 放行受信任 OSS 主机用于加载封面。 ## 验证 - `cargo test --bin genarrative-ai-game-creator-shell template_library`：9 passed；`--ignored` 真连检查 `fetches_the_live_template_library_index` 通过。 - `npx vitest run src/features/template-library`：9 passed。 - `npm run typecheck`、`cargo fmt --check`、`npm run check:encoding`、`node scripts/check-doc-index.mjs`、`git diff --check` 均通过。 - OSS 侧匿名复核：`templates/index.json`、各 `cover.png` 与 `template.zip` 均返回 200。 ## 未做 / 待确认 - 本轮未做客户端点击级人工验收（下一步单独验证并把结果补进此 PR）。 - 模板封面目前是占位标题卡，正式封面由后续模板包提供。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/396	2026-09-17 17:48:06 +08:00
k88936	1b56c0a586	Merge remote-tracking branch 'origin/master' into fix/effort-panel-overlay ... # Conflicts: # docs/project-memory/shared-memory/pitfalls.md	2026-09-17 15:56:56 +08:00
k88936	efdb364a52	修复推理档弹层被裁剪问题，增加 CSS 覆盖声明以确保窄布局下弹层完整显示。	2026-09-17 15:54:07 +08:00
kdletters	cd9faae9b2	修复 agc_tools 媒体资源提示词上限并按 kind 暴露 (#398) ... ## 改动 - 提示词上限收敛为 `resource_edit_prompt_max_chars` 单一权威：`agc_tools` MCP 工具层、客户端受控工具桥与提交校验共用同一数字与拒绝文案，不再出现「schema 写 4000、真实上限按 kind 分」的分叉。 - `agc_create_or_derive_resource` 的 schema 逐 kind 声明 `prompt.maxLength`（background-music / sound-effect / video 与 character-animation），`prompt` 描述写明每个数字；`agc_edit_image` 继续用图片口径 32000。 - 工具桥不再用通用 4000 校验 prompt：图片编辑 4000~32000 的提示词不再被误报成「超出安全边界」。 - 源资源未登记时的错误文案补上可执行两步：先用 `agc_list_registered_assets` 选已有 localAssetId；只在项目里的文件先 `agc_list_project_files` 确认 `assetImportable=true`，再用 `agc_import_account_assets.localPaths` 登记后重试。`agc_remove_background` 复用同一条文案。 - skill 包 `agc-client-projection` 的 SKILL.md 与 projection-contract.md 写明四个上限，并说明超限要在本地收敛而不是原样重发；清单指纹同步到 `2026-08-26.18`（已合并 master 的抠图文案）。 - 前端 `resourceEditModel.ts` 补注释指向 Rust 权威函数，数字未动。 - decision-log、pitfalls 与《AI游戏创作智能体App实施计划》记录本轮口径；未改 External v1 契约 / OpenAPI、SpacetimeDB schema 与客户端 UI 行为。 ## 问题 | 编号 | 问题 | 本 PR 状态 | | --- | --- | --- | | P1 | 背景音乐提示词真实上限 140，但 schema 只写 4000、skill 未写明，agent 写一句正常长度描述必被硬拒 | 已修复：口径单源 + 逐 kind 暴露 + skill 写明 | | P2 | 音效 1900 与图片编辑 32000 的上限只在 Rust 内部生效，MCP 与工具桥各自硬编码或误报 | 已修复：三处共用同一函数，图片编辑不再误报安全边界 | | P3 | 源资源未登记时只报「不属于当前项目已登记资源」，模型会原地重试 | 已修复：文案给出 `agc_list_registered_assets` 与登记工具两步动作 | | P4 | 这两个工具此前没有端到端用例，同类漂移无法被门禁拦住 | 已补：MCP 工具层 → 真实工具桥 → 假平台的契约用例 + 两条按 kind 上限门禁 | ## 验证 - `agent::direct_tools_mcp::tests` 23 passed / 0 failed：含新增的按 kind 上限门禁、图片快速编辑契约（断言 `POST /api/editor/images/edits` 的路径、Bearer、Idempotency-Key、正文且不得回填 assetKind）、背景音乐契约（断言 `POST /api/editor/audios/background-music/generations` 的 `gptDescriptionPrompt` 与 `makeInstrumental`）、超限零桥请求、未登记源资源提示。 - `agent::direct_tool_bridge::tests` 18 passed / 7 failed；`agent::skill_pack` 4 passed；`npm run agc:skill-pack:check` 与 `skill-pack:test` 通过（version `2026-08-26.18`）。 - AGC `typecheck`（tsc + skill-pack check + check-config）、`resourceEditModel` 6 项前端测试、`npm run check:encoding`、`npm run check:doc-index`、`cargo fmt --check`、`git diff --check` 通过。 - 那 7 条（以及 `project::resource_editor` 45 条）失败与本 PR 无关：全部是 `tempfile::tempdir()` 的 `Windows 安全对象不属于当前用户`，已 stash 改动并用基线复跑确认失败集合一致。 - 未跑整包 AGC Rust 全量分片、`npm run lint` 聚合门禁与 CI；未做任何付费生成。工具 schema 与 skill 文案都在应用内，终端用户需重新构建客户端才能看到修复效果。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: #398	2026-09-17 14:56:56 +08:00
suzmii	fca3df964c	Merge branch 'master' into fix/agc-canvas-json	2026-09-16 19:29:05 +08:00
suzmii	ac8a51ca79	同步master最新基线并准备画布修复PR ... 合入平台会话与主线测试修复 保持画布交互、JSON识别和对话历史分页修复范围不变	2026-09-16 18:59:32 +08:00
suzmii	1b010fb1f8	修复DirectProject对话历史分页卡页 ... 聊天历史按有效消息分页并返回原生游标，保留默认原始切片接口 工具和推理记录不占聊天页名额，逐行过滤避免传回大段工具输出 隔离重新加载和项目切换的迟到响应，补齐单飞、重试与消息去重 补充原生和真实App回归测试，增加人工只读日志重放入口 更新B05状态、规范与PR验收记录，不提交用户原始日志	2026-09-16 18:46:47 +08:00
kdletters	2bcfa10647	修复 AGC 客户端点「终止」整体闪退：同步命令线程改走 Tauri 全局异步 runtime ... - codex_app_server 新增 spawn_codex_app_server_task，统一经 tauri::async_runtime::spawn 派发中断与收尾任务 - 终止链路 maybe_interrupt、CodexThreadLease::drop、CodexTurnGuard::drop 三处改走该入口，避免同步 Tauri 命令线程上 tokio::spawn panic 后跨 IPC 回调边界 abort - 新增回归用例 codex_app_server_task_dispatch_needs_no_tokio_runtime_context，把派发入口钉在没有 tokio 上下文的线程上 - 同步 agc-skills manifest 指纹，修复 master 指纹回退导致的 skill-pack:check 失败（本地打包前置门禁） - 记录两条踩坑：同步命令线程 tokio::spawn 导致客户端 abort 闪退、cargo test 重写 generated/*.ts 后前端 typecheck 必红	2026-09-16 18:40:14 +08:00
suzmii	825ea76b7b	同步master最新变更 ... 合入当前主线的多窗口与配置更新 保留AGC画布交互和JSON识别修复 保留双方新增的项目排障记录并解决文档冲突	2026-09-16 17:45:06 +08:00
kdletters	0594a90bdd	合入平台会话身份与凭据分离 ... 平台会话快照拆分身份代次与写入 revision，凭据续期轮换不再中断在途生成 AGC Runner 请求参数新增 platform_auth_revision，并按 revision 做单调写入判定 解决与多窗口共享 Runner 的冲突，保留 claim adopt/publish 与界面参与锁语义 同步刷新轮换竞争、appSurface 鉴权用例与客户端 API 测试 补录平台会话身份与凭据分离的实施计划、共享记忆与决策记录	2026-09-16 17:42:00 +08:00
suzmii	910862fd06	修复AGC画布交互并识别UI设计JSON ... 稳定工作台与窗口标题栏状态同步，消除重复更新循环 支持画布右键平移并保留左键框选及资源拖动，完善中断清理 解耦运行不可用提示与资源选中状态 复用原生UI状态校验区分UI设计JSON和普通JSON，接入现有编辑器与代码预览 补充前端和原生回归测试、规范及待验收记录，明确对话历史分页尚未修复	2026-09-16 17:39:23 +08:00
kdletters	e08171fd2e	补记平台会话身份与凭据分离的规范与记忆 ... - 主规范新增平台会话身份与凭据分离条款，并修正长回合保活的口径 - 共享记忆补充并发生图登录态冲突的排障口径与验证方式 - 决策记录补充身份代次、凭据轮换、刷新失败语义的长期决策 - 新增本次里程碑与实施计划，记录证据与未验证项	2026-09-16 17:08:47 +08:00
kdletters	737a2266b9	支持同 AppData 多窗口共享 Agent Runner ... - owner 独占锁改为可多窗口同时持有的界面参与锁 agent-runner.gui-participant.lock - Runner 启动检查、attach 门禁与 watchdog 改用参与锁存活判定，最后一个窗口退出才关停 Runner - 窗口启动只采纳现有 owner claim，登录/refresh/退出/换号才发布新 epoch claim - 同 claim 重复 attach 改为幂等空操作，不再清空 Runner 平台登录态 - manifest 失效与 Runtime update relay 接收端改为按 token 去重的注册表并广播，失败只淘汰该接收端 - GUI 退出先释放参与锁，仍有其它窗口时保留 Runner 并记录 retained_for_other_windows - Runner 启动失败时按最新 endpoint 复用一次，避免两窗口同时冷启动被实例锁竞争误报 - 更新 runner 定向测试、GUI 生命周期集成测试与自检用例 - 同步 AGC 技术方案、决策记录、踩坑记录与多窗口里程碑/实施计划	2026-09-16 16:56:21 +08:00
kdletters	576ff07a5e	新增定时版本调度管线并收回两条下游管线的定时与去重 ... - 新增 Genarrative-Scheduled-Revision-Trigger：每小时用 git ls-remote 解析分支版本，与上一次触发过的 revision 不同才继续 - 触发时把同一个固定 COMMIT_HASH 同时传给 Full Build 与 AGC Windows Build，保证两条管线构建同一个版本 - Full Build 与 AGC Windows Build 去掉自带定时触发器与管线内版本去重 - 新增 scheduled-revision-trigger Job 配置 XML，使用本机 Git 入口与既有 SSH 凭据，定时器留在 Jenkinsfile - 生产运维门禁改为校验调度管线约束，并拦住两条下游管线重新加 cron 或自行去重 - 同步开发运维文档、共享开发工作流与踩坑记录	2026-09-16 10:55:16 +08:00
kdletters	5aa616134c	修复 Hook 链继承仓库定位变量导致真实仓库被夹具污染 ... - .husky/pre-commit 与 .husky/pre-push 入口清除 GIT_DIR/GIT_WORK_TREE/GIT_INDEX_FILE 等仓库定位变量 - scripts/check-repository-ci.sh 增加同样的清理，保证本地门禁与 CI 走同一套隔离 - scripts/git-hooks.test.mjs 夹具 Git 调用前自检仓库归属并禁用 Hook，命令落到外部仓库时直接失败 - 守卫用例的子进程必须真的继承 GIT_DIR，避免隔离断言空转 - 更新开发运维文档与 shared-memory/pitfalls.md，记录链接工作树注入形态与配置修复步骤	2026-09-16 10:35:07 +08:00
kdletters	1a8c30c865	修复后台轮询干扰会话隔离测试 ... 只核对刷新之后最后一次目标会话读取的完整参数 避免无关活动回合轮询改变全局最后调用而造成偶发失败 补充 IPC 异步测试边界约定	2026-09-16 02:01:59 +08:00
kdletters	e72a2da733	修复构建测试隔离并对齐 Direct 消息契约 ... 隔离 Git hook 测试子进程环境并验证外层仓库不变 恢复被测试污染的完整 ESLint 与 Prettier 配置并清除测试产物 撤销无依据的聊天参数和资源初始化时序变更 严格验证 canonical userItem 和现行历史切片契约 同步开发运维文档与共享排障约定	2026-09-16 01:40:58 +08:00
Git Hooks Test	0ce5eb35b0	提升图集切片上限并保留原始告警 ... 图标图集自动、手动和网格切片上限统一提高到 256。 同步 SpacetimeDB 批次与生成结果 item 上限，覆盖 256/257 边界。 严格图集提交校验透传 sliceWarning 原始原因，避免通用文案覆盖根因。 补充 Rust 定向测试、文档和共享决策记录。	2026-09-16 01:06:34 +08:00
kdletters	eeb0206164	修复 Stdb 发布临时目录权限 ... 将以服务用户执行的 WASM 发布临时目录移到 /var/tmp	2026-09-16 00:03:22 +08:00
kdletters	687bad0adf	修复登录失败原因提示 (#374) ... 登录失败时，部分网关或兼容接口返回字符串形式的 error，前端解析失败后只显示通用“登录失败”，用户无法判断具体原因。 本次修改： - 统一错误解析器支持字符串 error，并保留标准嵌套错误的优先级。 - 增加登录接口返回“手机号或密码错误”的回归测试。 - 同步认证排障记录。 验证： - API 客户端测试 32 项通过 - 认证服务与登录弹窗测试 55 项通过 - npm run typecheck 通过 - npm run lint:eslint 通过 - npm run check:encoding 通过 Reviewed-on: #374 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-15 19:27:14 +08:00
kdletters	dc8e03988f	修复AGC模型列表刷新无反馈与响应体无限等待 ... ConversationModelSelect：手动刷新立即显示「刷新中…」，真实刷新成功后显示「模型列表已刷新」，revision 未变化也有反馈 ConversationModelSelect：刷新失败按 HTTP 状态与超时给出可辨认提示，沿用有效缓存时不报告刷新成功，已选模型与挂载/聚焦语义不变 clientApi：成功与错误响应体统一走 readClientHttpResponseText 的 15 秒上限，响应体卡住时结束等待并释放模型目录在途请求 测试：补齐模型目录响应体超时后保留缓存并可重试、迟到响应不覆盖新目录、手动刷新进行中/同版本成功/失败反馈用例 文档：同步 AGC 模型目录刷新反馈与响应体超时合同，并在共享记忆记录该排障口径	2026-09-15 14:41:57 +08:00
kdletters	33369f1180	修复生图资产实时刷新 ... 兼容 Windows 普通、verbatim 与 UNC 项目路径的失效事件匹配 让普通生图成功后立即发送 manifest 刷新通知 补充资源卡片与桥接通知回归测试	2026-09-15 10:37:47 +08:00
kdletters	2bdee990a2	AGC 开发态补齐后台 Web 启动与端口汇总，端口归属探测从 WMI 换成 netstat ... - dev-port.mjs 新增 resolveAgcAdminWebEndpoint：后台 Web 端口按 Linux 用户端口段 start + 3、非 Linux 优先 3102 解析，ADMIN_WEB_PORT 可显式指定，并把已解析的 AGC Vite 端口列为保留端口 - start-dev-stack.mjs 随 AGC 一起拉起 apps/admin-web（AGC_DEV_ADMIN_WEB=0 关闭）：与 AGC Vite 一样由启动器直接持有并纳入信号与退出收束，不走会整体重写 .app/dev-stack.json 的 dev:admin-web - start-dev-stack.mjs 新增启动汇总行，一次给出前端、后端、后台、数据库与 bgfilter-worker 的实际地址，端口漂移后以该行为准 - start-dev-stack.mjs 端口归属探测改用 netstat -ano 取端口到 PID、.NET Process 读可执行文件路径，仅在核对 SpacetimeDB --data-dir 归属时按 PID 取命令行并做 5 分钟 TTL 缓存：本机实测单轮探测由约 43 秒降到 0.37 秒，agc:serve 的 starting backend stack 到 backend ready 由约 80 秒降到 16.7 秒 - 后台 Web 端口解析或启动失败只告警，不阻断也不连带停止 AGC 客户端与配套后端 - tests/dev-port.test.ts、tests/start-dev-stack.test.ts 补充用例覆盖后台 Web 端口解析与严格占用、失败软化、启动汇总、netstat 探测脚本与命令行缓存失效 - docs/【开发运维】与 docs/technical 同步 AGC 开发态启动口径，pitfalls.md 记录 WMI 慢速探测的实测数据、netstat 改法与 PID 取最后一列的易错点	2026-09-14 21:02:08 +08:00
suzmii	aeac6c7b74	合并 origin/master（279a5e8e0，#356 UI 编辑器返回后资源画布平移）到验收批次 ... - 合并最新 master，使 PR #358 的头包含当前 master 顶端（CI 门禁要求） - 冲突按「两侧语义都保住」解： - docs/project-memory/shared-memory/pitfalls.md：保留我方新增的「严格 IPC 桩缺登记新命令」 与上游新增的「UI 编辑器返回后资源画布滚轮平移失效」两条，只删除冲突标记行 - index.tsx / tests/appSurface/harness.ts / project-development.suite.ts：保留本批生成任务与 资源画布改动，同时并入上游的资源画布平移回归用例与共享 ResizeObserver 桩 - 工作树里另有 5 个版本号改动（package.json / Cargo.toml / Cargo.lock / tauri.conf.json / package-lock.json，0.1.29 → 0.1.34）属发布动作，**本次刻意未提交**，原样留在工作树	2026-09-14 20:27:05 +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	a0b5a84d61	Merge branch 'master' into fix/cant-pan-after-ui-editor	2026-09-14 19:00:47 +08:00
kdletters	90d216e241	Merge remote-tracking branch 'origin/master'	2026-09-14 18:35:22 +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
k88936	c485ce94a1	修复 UI 编辑器返回后资源画布平移 ... 资源管理卸载重挂时重新绑定画布 wheel 监听 补充 UI 编辑器返回后的资源画布平移回归用例 记录资源画布事件监听重挂排障经验	2026-09-14 18:30:33 +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
lhk229	cf4a275d26	缓存 sccache 探测结果避免重复阻塞 ... 在当前 dev 编排进程内复用 sccache wrapper 探测结果 避免 API 与 worker 重启重复同步等待 同步更新排障文档	2026-09-14 18:15:12 +08:00
lhk229	fed9960684	修正 POSIX sccache 绕过日志 ... 明确记录 Linux 和 macOS 本地开发实际绕过 sccache 补充 POSIX 日志回归测试并更新排障文档	2026-09-14 18:15:12 +08:00
lhk229	a3918c89f0	按显式配置控制 Windows sccache ... 未配置 wrapper 时默认回退到直接 rustc 处理 sccache 探测失败与 wrapper 配置冲突 同步更新开发运维和排障文档	2026-09-14 18:15:12 +08:00
lhk229	f955661146	增强 Windows sccache wrapper 探测回退 ... 使用限时真实 rustc wrapper 探测替代版本检查 探测失败或超时时回退到直接 rustc 同步更新 sccache 故障排障记录	2026-09-14 18:15:12 +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
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	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	7092689b36	收口 AGC 生命周期超时隔离与建项恢复 ... ## 变更内容 在 master（0f829cd25）上用故障注入复现出四类"每走一步都会卡住"的生命周期残留，本轮按"超时后真正隔离并核对底层操作"收口，不再新增 operation 字段： - 本地会话写入队列从"无限等上一次完成"改为带解围期限的闸门（60s）。Rust 侧 install/clear 本来就按 generation 单调拒绝更旧写入，所以渲染层只需保证新 generation 不被卡死的调用永久挡住； - generation floor 读取不再把一次瞬时失败缓存成永久失败（原先 `??=` 缓存了已 reject 的 promise，导致同一渲染进程内后续登录/退出全部失败）； - 登录 UI 的 45 秒围栏只放弃等待、不放弃结果：本地运行时确实装好会话时界面跟随进入工作区，且迟到结果不会覆盖更新的登录尝试； - 首页自动建项从 `deadlineMs: null` 改为 10 分钟兜底期限：到点解围并提示（底层创建继续在后台跑，迟到成功照常进项目），失败时保留 `scope.projectPath`、登记最近项目并新增「打开已创建的工作区」入口；底层创建未返回期间只挡"再建一个"，不挡打开已有项目； - 同步 `project.bootstrap` 权限文案断言、生命周期技术方案状态与 shared pitfalls。 ## 验证 - `npm --prefix apps/ai-game-creator-shell run typecheck`（含 skill-pack、check-config） - `vitest run apps/ai-game-creator-shell/tests/appSurface.test.ts`（428/428，含新增 5 个故障注入回归；`project.bootstrap` 文案断言在此前 master 上确定性失败） - 定向 `clientHttp`、`clientApi`、`clientOperation`、`recentProjectsModel`、`clientRuntimeErrorBoundary`、`sessionPreview`、`start-dev-stack`、`dev-port`、`start-tauri-dev`（全部通过） - `npm run check:doc-index`、`npm run check:encoding`、`git diff --check` 原生 Runner/IPC 与真实 Provider 下的同一批时序未执行，本轮结论来自 deterministic surface 与 mock 故障注入。 Co-authored-by: DotCraft <273930855+dotcraft-ai@users.noreply.github.com>	2026-09-14 14:49:45 +08:00
kdletters	c146f7f99c	建立 AGC 稳定版生命周期基础合同 (#348) ... ## 变更内容 这是基于 PR #346 的稳定版生命周期基础切换，承接已完成的 HTTP body timeout、Runner blocking worker、最近项目逐项刷新和首页跨页防重： - 新增统一 `ClientOperation` 合同，固定 operationId、requestId、phase、deadline、scope、cancellable 和 stale 判定； - 认证 refresh 投影 `auth-refresh` operation；登录、401 refresh、退出共用平台 session generation，并由 `auth-transition` 投影 Runner phase/成功/失败/不确定状态； - 首页自动创建记录 draft、startMode、phase 和建项后的 project scope，页面卸载不会释放 operation； - `.app/dev-stack.json` 增加 instanceId、repoRoot、服务级 dataDir/instanceId，AGC Vite marker 增加 repoRoot/processId/port；缺身份的旧状态拒绝 AGC 后端复用； - 新增稳定版生命周期主规范、开发运维口径和 shared pitfalls。 ## 验证 - `npm --prefix apps/ai-game-creator-shell run typecheck` - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/clientOperation.test.ts tests/clientApi.test.ts tests/clientHttp.test.ts tests/recentProjectsModel.test.ts tests/start-dev-stack.test.ts tests/dev-port.test.ts --reporter=dot`（61 passed，2 skipped） - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/appSurface.test.ts --reporter=dot`（423/423 passed） - `node --check scripts/dev.mjs` - `node --check apps/ai-game-creator-shell/scripts/start-dev-stack.mjs` - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` `scripts/dev.test.ts` 全量仍有 1 个 Windows 文件权限相关既有失败：bootstrap secret 测试在 Windows 上无法通过 chmod 模拟 0600；本变更未触及该逻辑。 Reviewed-on: #348	2026-09-14 13:56:56 +08:00
lhk229	6149aaf5f6	修复资源替换弹窗初始化竞态 ... 将弹窗打开态初始化改为 useLayoutEffect，避免素材选择被异步初始化清空 补充资源选择弹窗竞态的排障记录与定向验证命令	2026-09-13 11:44:27 +00: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