1022 Commits

Author	SHA1	Message	Date
k88936	800da43a8d	说明生成结果 DTO 的 number 精度边界 ... 为 poll_after_ms、updated_at_micros、size_bytes 补充注释，说明其量级远低于 2^53，按 TS number 导出即可精确表示 重新生成 TypeScript 绑定，把上述说明同步为 JSDoc 技术方案补充同一说明，明确不做 bigint/string 特殊处理	2026-09-19 14:14:14 +08:00
k88936	b87d9358e5	对齐 Api 与 Request 的可重试状态码 ... TripoError::is_retryable 的 Api 分支补充 408 与 425，与 Request 分支的可重试集合保持一致	2026-09-19 13:15:31 +08:00
k88936	f4996d7ac2	auto_size 仅在显式开启时按模型能力拦截 ... validate_generation_options 中 auto_size 的 H25 校验由 is_some() 改为 == Some(true) auto_size: false 不再被当作启用，与 quad、smart_low_poly、generate_parts 的取值语义保持一致	2026-09-19 13:15:00 +08:00
k88936	09ef92420f	multiview 复用统一的 task_id 校验 ... 删除 submit_multiview_to_model 中重复的空白判断，改为调用 common::validate_task_id task_id 非法时的错误字段由 Inputs 改为更精确的 TaskId，与 get_task、download_model 保持一致	2026-09-19 13:14:32 +08:00
k88936	091938ed59	multiview 提交前裁剪 task_id ... to_sdk_params 改为提交 task_id.trim()，与 task_id.trim().is_empty() 的校验使用同一份标准化输入 带前后空白的 task_id 不再原样转发给 Provider	2026-09-19 13:13:54 +08:00
k88936	ddb8b9e8ba	multiview 空白视图按未提供处理 ... to_sdk_params 新增 optional_view，将仅含空白的 left、back、right 归一化为未提供 空白视图不再以 Some(FileInput) 形式提交，与提交前“至少两个视图”的校验保持一致	2026-09-19 13:13:35 +08:00
k88936	230e4d49f2	image_to_model 提交前统一使用裁剪后的输入 ... to_sdk_params 改为传入 request.input.trim()，与提交前的空值校验使用同一份标准化输入 带前后空白的输入不再原样转发给 Provider	2026-09-19 13:12:50 +08:00
k88936	6c209b115a	冒烟示例在任务未完成时跳过下载并继续后续入口 ... 轮询改用 throw_on_failure=false，失败终态交回示例按 status 判定而不是直接返回错误 非 Completed 的任务打印 status 与 failure 后 continue，避免一个入口失败中断其余入口的冒烟	2026-09-19 13:12:23 +08:00
k88936	b631125a16	冒烟示例不再输出完整下载地址 ... 产物行改用 TripoUrl::redacted()，避免把带签名的下载 URL 写入标准输出	2026-09-19 13:07:41 +08:00
k88936	771ff88440	脱敏 TripoUrl 的 Debug 输出 ... 为 TripoUrl 手写 Debug 实现，改用隐藏 query 与 fragment 的脱敏形式 新增 TripoUrl::redacted 提供日志用脱敏 URL，完整 URL 仍由 as_str 显式读取 TripoTaskSnapshot、TripoTaskOutput、TripoDownloadedModel 的调试输出随之不再暴露带签名的下载地址	2026-09-19 13:07:41 +08:00
k88936	950209f038	为 model3d 请求契约的可选字段补充 ts(optional) ... 为 image_to_model、multiview_to_model、text_to_model 三个请求的可选字段添加 ts(optional = nullable) multiview 视图分支的 left、back、right 同步标记为可选 重新生成 packages/shared/src/contracts/model3d 下的 TypeScript 绑定，使 TS 侧可按 serde 语义省略字段	2026-09-19 13:07:41 +08:00
k88936	42a5929a73	清理 model3d 请求契约中冗余的 serde(default) ... 移除 image_to_model、multiview_to_model、text_to_model 三个请求结构体 Option 字段上的 serde(default) 同步移除 multiview 视图分支中三个可选视图的 serde(default) serde 对 Option 字段本身即按 None 处理缺失字段，生成的 TypeScript 绑定保持不变	2026-09-19 13:07:41 +08:00
k88936	eda9da4d8d	单点维护 model3d 的 ts-rs 导出根目录 ... 在 model3d/mod.rs 新增 model3d_ts_export_dir 宏，集中定义仓库相对导出根路径 common、image_to_model、multiview_to_model、text_to_model 改为调用宏并只声明各自子目录名	2026-09-19 13:07:41 +08:00
k88936	da9ee65119	记录Tripo真实冒烟结果结构 ... 保留三个生成入口的脱敏真实结果形状与下载产物信息 使用实际可访问的 Rustacean 图片完成 image 与 multiview 示例 同步严格 endpoint 结果契约和真实 Provider 验收文档	2026-09-18 21:42:17 +08:00
k88936	527706b84e	按接口收紧Tripo任务结果类型 ... 为 text、image、multiview 三类生成定义独立必填结果结构 以枚举关联任务类型与具体结果并对缺失字段失败关闭 将通用 URL 类型由 TripoModelUrl 更名为 TripoUrl	2026-09-18 21:37:38 +08:00
k88936	a4beb53dc6	完善Tripo冒烟CLI产物流程 ... 等待三类生成任务完成并打印映射后的输出 完成后下载模型产物到当前目录并输出文件信息 仅在示例内部使用SDK轮询器，不扩展平台公共接口	2026-09-18 18:51:49 +08:00
k88936	25314d9a4a	新增Tripo三类生成冒烟CLI ... 增加仅通过环境变量配置的 Tripo generation example 顺序提交 text、image、multiview 三类任务并执行单次状态查询 保持无命令行参数且不调用 SDK 轮询接口	2026-09-18 18:42:58 +08:00
k88936	5be4a51ac1	完善Tripo枚举与参数组合校验 ... 按提供的 Tripo 文档补齐 compression、texture quality 与 texture version 枚举 移除未在三个生成接口出现的 style 占位字段并同步 Rust/TypeScript contracts 增加模型版本、纹理版本、生成部件、quad、smart-low-poly 与 face limit 的副作用前校验 同步 Provider 技术方案和 ADR	2026-09-18 17:23:55 +08:00
k88936	37b355a814	接入Tripo三类3D生成Provider ... 加入固定 revision 的 tripo-rust-sdk 与 platform-tripo workspace crate 实现 text-to-model、image-to-model、multiview-to-model 提交、通用任务查询和显式模型下载 抽取通用任务类型、状态映射、输出 URL 校验与 SDK 错误归一，保持 wait_for_task 不对外暴露 同步 Provider 边界文档并暂不接入 api-server	2026-09-18 16:02:13 +08:00
k88936	1c4009ea3b	建立3D生成目录化契约 ... 新增 model3d common、text-to-model、image-to-model、multiview-to-model Rust contracts 通过 ts-rs 按目录生成 TypeScript bindings，移除依赖 barrel 的组织方式 增加 model3d contracts 定向生成脚本	2026-09-18 15:59:19 +08:00
kdletters	f5b4293e80	预览控制面支持展示公网预览地址 ... - preview-deployer-server 新增可选配置 GENARRATIVE_PREVIEW_DEPLOYER_WEB_DOMAIN，并按「实例 ID + 预览域名」派生公开字段 webPublicUrl，卸载时与 webUrl/webPort 一起清空、加载状态文件时重新派生覆盖 - preview-deployer-web 在存在公网地址时把「打开公网预览」作为主入口，内网地址降级为次级链接，未配置时行为不变 - deploy/env/preview-deployer.env.example 补充 WEB_DOMAIN 键与留空语义说明 - 补充 cargo 与 vitest 用例覆盖公网地址派生、域名配置校验与页面展示	2026-09-17 20:29:42 +08:00
kdletters	1a7abfd059	AGC 项目定时快照上传（目标 OSS agc-dev） (#400) ... ## 交付内容 - 客户端新增 `project_snapshot` 模块：项目扫描与排除口径、增量索引、差异对比、上传编排、状态查询。 - 触发：工作区窗口存活期间的周期定时器 + 工作区窗口关闭（`CloseRequested`）；应用退出只在有界预算内等待在途同步收尾，不重复发起。 - 服务端新增两条登录态路由 `POST /api/agc/project-snapshots/files` 与 `/manifest`，由 api-server 用服务端凭据写入私有前缀 `agc/project-snapshots/v1/{user}/{project}/`；客户端不持有 OSS 凭据、不直连 OSS。 - `platform-oss` 新增内部对象精确写入与探测、项目快照对象键构造；修复 `head_internal_object` 读 HEAD 响应长度恒为 0（会导致服务端"已存在即跳过"永不生效）。 - `shared-contracts` 新增 `agc_project_snapshots` DTO 与项目 ID、相对路径、摘要校验。 - 真实 OSS 存储层冒烟示例 + 客户端真实链路冒烟用例（`#[ignore]`，env 驱动）。 - 登记 `check-config.mjs` 的 native-only 命令白名单，恢复 `npm run agc` 可启动。 ## 验证证据 - 存储层：`cargo run -p platform-oss --example agc_project_snapshot_live_smoke` 对真实 `agc-dev` 完成写入 → 读回（contentLength 32）→ 清单写入 → 探针清理。 - HTTP 层：登录态下 7 项校验（401 无 token、400 路径穿越/长度不一致/非法摘要/空正文/重复路径清单）全部符合预期且不写对象。 - 客户端链路（真实项目 gameagent-033b6cf3…）：第一次 `synced uploaded=6 uploadedBytes=36694 remoteSkipped=6`，紧接着第二次 `no-op uploaded=0`。 - GUI 触发：`trigger=periodic ... uploaded=6`；把周期设为 600 秒排除干扰、改一个文件后关窗得到 `trigger=project-close ... revision=2 uploaded=1`，索引摘要由 `28d837cd84f8ab62` 推进到 `bff34e2e336d901f`（同步在进程退出前完成）。 - 门禁：AGC `project_snapshot` 14 passed（+1 ignored live）、api-server `project_snapshots` 3 passed、platform-oss 39 passed、shared-contracts 87 passed、`cargo fmt --check`（两处）、`check:encoding`、`check:doc-index`、`git diff --check`、`check-config.mjs` 全部通过。 ## 已知未决（不阻塞本里程碑） - 远端对象只增不减：没有删除路径，也没有 bucket 生命周期规则；要收口需要先定保留语义（清单引用 GC 还是 OSS 生命周期）。 - 部署环境需确认 `GENARRATIVE_AGC_PROJECT_SNAPSHOT_OSS_*` 或回退的 `ALIYUN_OSS_*` 具备目标 bucket 私有前缀的 `PutObject` 权限；未配置时接口返回 503、客户端失败关闭（不推进索引）。 - 缺少按用户/项目的配额与限流（error_reports 有每小时提交上限的先例，本功能没有）。 - 没有界面入口与状态可见性：`read_local_project_snapshot_state` 已注册但未接 UI，失败只写本机日志。 ## 不做 - 不做云端下载/恢复、跨设备合并、版本回滚。 - 不改 `/api/external/v1` 与 External OpenAPI，不新增 SpacetimeDB 表。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/400	2026-09-17 18:34:51 +08:00
kdletters	fc14190f58	图集切片模式改为必须显式声明并补齐决策要求 (#408) ... ## 背景 切图新增基于连通域的切分后，LLM 仍倾向显式传 `sliceMode=grid`：参数只存在于部分 LLM 可见面、带默认值、没有任何决策规则，生成结果也不回显生效模式。 ## 变更 - 平台：`/api/editor/icon-spritesheets/generations` 与 `/api/external/v1/editor/icon-spritesheets/generations` 把 `sliceMode` 改为必填并移除默认值；缺失、空白或未知取值在引用解析、定价与任何 provider / OSS 副作用之前返回 `400`，错误统一带 `field` 与决策要求。 - 契约：`grid` 必须同时提供 `gridX`/`gridY`，`connected-components` 不接受网格尺寸；`sliceCount` 只约束连通域切分，请求与响应的公开上限统一为 `256`；OpenAPI 去掉默认值并补必填与失败语义。 - AGC：MCP 工具说明去掉默认值并补决策要求，桥接层新增可测试的切分声明校验；原生工具 `canvas.asset_generate` 暴露 `sliceMode/gridX/gridY/sliceCount` 并要求图集显式声明；生成结果回显 `sliceMode/gridX/gridY` 与 `slicePaths`；严格图集在本地提交前校验平台回显与请求声明一致。 - 标准美术包：显式声明 `connected-components` 加 `sliceCount=4`，并在四张 canonical 切片用途映射前校验数量，禁止截断或错位。 - 前端与画板：画板 Agent 工具装配与画板提交计划显式声明连通域切分；前端类型要求显式 `sliceMode` 并在本地校验声明自洽。 - 文档与 Skill：主规范、OpenAPI、AGC Skill、外部编辑器 Skill、里程碑与实施计划、共享决策记录同步更新。 - 测试环境：测试构建对提权 Windows 主机上系统临时目录的所有者偏差做一次性所有者初始化重试，临时目录之外的越权所有者继续失败关闭。 ## 兼容性影响 省略 `sliceMode` 的旧调用方（含已发布但未更新的 AGC 客户端与第三方外部 API 调用方）会在图集生成上收到 `400`；这是本次"不允许默认值"的预期结果，仓库内自有调用方已全部改为显式声明。 ## 验证 - 平台：`slice_mode_must_be_declared_*` 与 OpenAPI 契约测试通过；全量 `cargo test -p api-server` 1043 通过 / 11 失败（`wallet_refund_outbox` 临时文件 `拒绝访问`，已在改动前基线复现，属本机环境）。 - AGC：`slice` 30、`spritesheet` 21、`direct_tools_mcp` 23、`agent_native_tools` 16、`canvas_generation_tests` 83、提示词上限与桥接门禁各 1 条、`cargo check --tests` 全部通过。 - 前端：182 条定向测试与 `typecheck` 通过。 - 门禁：`cargo fmt --check`（两个 workspace）、`check:encoding`、`check:doc-index`、`git diff --check` 通过。 - 未验证：真实 Provider 与浏览器试玩、确定性 e2e 车道；整机全量 AGC 单进程运行在本机受提权 shell 的所有者与时序问题影响，不作为门禁信号。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/408	2026-09-17 18:10:34 +08:00
lhk229	9b6ed8a4cf	整理抠图测试导入并明确对外说明边界 ... 将主站与客户端抠图测试模块的导入统一放到模块顶部 明确 provider 选择与兜底策略仅保留在内部技术方案中	2026-09-17 00:54:28 +08:00
lhk229	16deb0ad61	补齐抠图参数透传与验收 ... 修复flat自动识别门禁并严格校验模式和颜色 保持旧请求幂等指纹并区分客户端抠图意图 同步工具说明和Skill契约并补充定向测试 记录真实BgFilter验证及本地数据库阻塞的待验收项	2026-09-17 00:54:28 +08:00
lhk229	ca761e093c	接通抠图模式到BgFilter队列 ... 透传backgroundMode和screenColor到内部worker 保留auto及省略颜色的下游识别语义	2026-09-17 00:54:28 +08:00
lhk229	a17367112f	增加主站抠图参数归一化 ... 缺省模式兼容为complex并校验颜色格式 将auto颜色原样保留给BgFilter	2026-09-17 00:54:28 +08:00
lhk229	d7a0c3cffd	扩展主站抠图请求契约 ... 增加backgroundMode和screenColor可选字段 同步External v1 OpenAPI抠图模式说明	2026-09-17 00:54:28 +08:00
kdletters	479120d368	修复刷新轮换竞争被放大成登出 ... - refresh 接口的轮换失败不再下发清空 refresh cookie 的响应，避免删掉并发请求刚写入的有效 cookie - 缺少 refresh cookie 的失败保持无副作用，cookie 失效只由吊销、过期或身份变更决定 - 网站前端在刷新返回 401 时先用当前 cookie 收敛重试一次，重试仍被拒绝才判权威失效 - 网站前端只在当前鉴权代次未变化时重试刷新，避免旧账号结论污染新代次 - 更新 api-server 与前端断言，覆盖轮换竞争与收敛重试两条路径	2026-09-16 17:08:47 +08:00
Git Hooks Test	0ce5eb35b0	提升图集切片上限并保留原始告警 ... 图标图集自动、手动和网格切片上限统一提高到 256。 同步 SpacetimeDB 批次与生成结果 item 上限，覆盖 256/257 边界。 严格图集提交校验透传 sliceWarning 原始原因，避免通用文案覆盖根因。 补充 Rust 定向测试、文档和共享决策记录。	2026-09-16 01:06:34 +08:00
kdletters	dd24690b02	新增图集连通域与可配置网格切分 ... 增加 connected-components 与 grid 切分模式 支持 gridX/gridY 并同步 API、MCP、Skill、AGC 客户端 移除固定 2x2 图集切分契约与文档	2026-09-15 20:06:36 +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
k88936	b082addc34	Merge remote-tracking branch 'origin/master' into feat/ui-editor-auto-seperation	2026-09-14 17:41:36 +08:00
kdletters	0f829cd252	完成 DirectProject Phaser 迁移闭环 (#353) ... ## 变更 单 HTML → Phaser 4 + Vite 的迁移链路现在有明确且可执行的工程合同：Phaser/npm 目标固定走 DirectProject，旧 JSON Generator 继续只处理单文件 HTML。 - 新增受控 `project.bootstrap`，仅允许项目内 `game` 目录执行无参数 `npm install`，校验 package/lock、路径、npm 管理器并记录依赖指纹。 - `project.verify` 支持相对 `cwd`，构建前诊断缺失依赖，`cwd=game` 的 build 必须产出 `game/dist/index.html`。 - npm bootstrap 使用受控网络沙箱；通用 `command.exec npm install` 仍被拒绝。 - 同步 Runtime 工具广告、执行分发、审计、权限策略、DirectProject/Generator 提示、前端权限面板、TypeScript/Rust 契约和项目文档。 - Phaser 迁移提示覆盖 Scene、输入、敌人/守卫、波次、胜负、重开和桌面/移动双视口验收。 ## 验证 - `npm run ai-game-creator-shell:typecheck` - `cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml` - `cargo fmt --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml -- --check` - `cargo test --locked -p shared-contracts --manifest-path server-rs/Cargo.toml game_creation_app` - 定向 `project.verify` Rust 测试 - `npm run check:encoding` - `npm run check:doc-index` - `git diff --check` - 真实 DirectProject：`npm install`、`npm run build` 成功，`game/dist/index.html` 存在。 - 浏览器试玩：桌面视口画布非空；移动视口触摸开火、键盘换道和重开逻辑均已观察确认。 真实项目没有纳入仓库提交；PR 只包含客户端合同、Runtime 能力和验证门禁。 Reviewed-on: #353	2026-09-14 13:57:24 +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	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
k88936	462fc856aa	为原始图片上传解析增加超时 ... 从请求入口开始计算准备截止时间，并限制 multipart 上传解析阶段的最长等待。	2026-09-12 21:33:48 +08:00
k88936	274bb1a3d2	兼容带参数的 PNG 内容类型 ... 解析 multipart Content-Type 的媒体类型部分，接受合法的 image/png 参数。	2026-09-12 21:33:06 +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	9835bbec9f	修复 PR316 review：shared-contracts 资产级失败关闭 + 快速编辑别名白名单 ... - server-rs/crates/shared-contracts/src/game_creation_app.rs:517 [bug high] 资产级 wire 结构补 deny_unknown_fields：与顶层 GameCreationAppManifest 同一取向，避免「读一次 + 任意一次写」静默抹掉未来新增的 assets[i] 字段；新增契约测试 asset_manifest_entry_rejects_unknown_asset_fields（裸条目 + 顶层 manifest 两条读路径都失败关闭，且已知字段照旧往返）。 - server-rs/crates/shared-contracts/src/game_creation_app.rs:536 [bug medium] 未知 category 从「退回 kind 派生值」改为失败关闭：反序列化结果就是落盘原值、要被整结构体写回，静默替换等于无迁移改落盘数据；缺字段仍按 kind 派生，派生只保留在 game_creation_app_asset_effective_category；原用例改名重写为 asset_manifest_entry_keeps_explicit_category_and_rejects_unknown_category。 - server-rs/crates/shared-contracts/src/game_creation_app.rs:780 [test low] 分区顺序跨语言交叉校验：packages/shared 侧新增解析 Rust PROJECT_RESOURCE_CANVAS_SECTIONS 并与 TS 常量对齐的测试（TS 侧补，见后续提交）。 - server-rs/crates/api-server/src/editor_project.rs:4120 [bug medium] 静态图别名白名单补 "asset"（register_local_asset_entry 空 kind 兜底值，canonical 映射到 image），数组长度 17→18，并在用例里补放行/拒绝两条断言。 - server-rs/crates/api-server/src/editor_project.rs:20747 [test low] AGC 快速编辑回归用例不再自洽：agc_payload 真正反序列化成 EditorImageEditRequest 并由请求体自己的 generationInputs.assetKind 驱动判据，另加源码级闸门断言（resolve_editor_image_edit_source / ensure_editor_image_edit_target_matches_source 体内不得再出现 generation_inputs）。 - TS 侧 gameCreationApp 的口径注释同步为「非法值这一支已不可达」（见后续提交）。	2026-09-12 19:43:19 +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
k88936	f05f6e49ab	复用原始图片编辑 HTTP 客户端 ... 让 raw edit 接收 api-server 构造的 VectorEngine reqwest 客户端。 通过 request builder 保留有效请求超时，不修改现有连接池策略。 移除不再使用的客户端构造错误分支并同步技术方案。	2026-09-12 16:33:33 +08:00
k88936	6764950aec	限制原始图片上传字节 ... 将 image 和 mask multipart 字段改为分块读取并限制单字段大小。 新增图片总字节上限、413 错误和字段/总量边界测试。 同步 Raw GPT Image 2 代理技术方案的资源防护合同。	2026-09-12 16:27:23 +08:00
k88936	0944667c37	限制原始图片解码并发 ... 为 raw image PNG 预处理增加 AppState 专用 semaphore。 按请求截止时间限制槽位等待和 blocking 解码等待，并让 permit 持有到任务结束。	2026-09-12 16:22:06 +08:00
k88936	413707da33	提前拒绝高位深 PNG 解码 ... 通过 image crate 的 ImageReader decoder 元数据在像素缓冲分配前拒绝 16-bit PNG。 继续使用同一外部 decoder 执行受限像素读取校验，不手写 PNG 解析器。	2026-09-12 15:40:26 +08:00
lhk229	74fad546ff	增加 Responses 槽位安全保险丝 ... 拒绝超出 4096 的 output_index，避免异常上游输入触发巨额扩容 补充安全边界测试且不限制正常输出内容	2026-09-12 07:17:16 +00:00
k88936	e9d0180054	集中管理 GPT Image 2 尺寸限制 ... 将请求尺寸压缩与原始编辑校验共用同一组像素、边长和对齐常量。	2026-09-12 15:00:55 +08:00
k88936	664bdd6877	避免伪造原始图片供应商请求编号 ... 原始图片响应未提供供应商 request id 时不再写入操作名作为关联编号。	2026-09-12 14:58:21 +08:00