361 Commits

Author	SHA1	Message	Date
k88936	10e63ecb6b	合并 origin/master 到 feat/tribo3d-integeration：ts-rs 一律常开、Cargo 清单去重 ... - server-rs/Cargo.toml：删除与 workspace git 固定重复的 registry `ts-rs = "12.0.1"`，保留固定 commit 并写明「ts-rs 一律常开、绑定命令固定为 cargo test -p shared-contracts export_bindings」 - server-rs/crates/shared-contracts/Cargo.toml：删除 master 侧新增的 `ts-bindings` feature，`ts-rs` 保持常开依赖 - server-rs/crates/shared-contracts/src/game_creation_app/asset_kind.rs：去掉 `cfg_attr(feature = "ts-bindings", …)` 门控，derive 与字段级 `ts(...)` 无条件展开 - apps/ai-game-creator-shell/src-tauri/Cargo.toml：shared-contracts 依赖去掉 `features = ["ts-bindings"]`，继续保留本分支的 ts-rs git 固定 - apps/ai-game-creator-shell/src-tauri/Cargo.lock：按上述依赖变更同步（shared-contracts 指向 git 源 ts-rs） - docs：同步 5 处绑定生成命令（去掉 `--features ts-bindings`），并在 decision-log 记本次合并的决策、代价与验证 - 其余暂存改动为 origin/master 带入的内容，冲突按两侧目的逐一合并 验证：cargo metadata --locked（server-rs 与 AGC 两个 workspace）、cargo test -p shared-contracts（119 + 5 + 5 + 2 + 2 全绿且无告警）、npm run contracts:model3d:generate 后 packages/shared 零 diff、cargo check -p spacetime-module --target wasm32-unknown-unknown、npm run check:encoding、npm run check:rustfmt、npm run check:spacetime-schema、git diff --check、暂存集 eslint / prettier 全过	2026-09-22 13:12:28 +08:00
k88936	61fe4c48af	图片画布接入 3D 资源：新增 model3d 类别、3D 预览与 3D 生成入口 ... - 后端资源投影按 asset_kind 分叉，新增 project_editor_client_media_src 与 EDITOR_MODEL3D_ASSET_KIND：model3d 只投影预览图，模型本体只留 objectKey，预览缺失才回落历史口径 - tripo3d 存储新增按字节魔数识别模型 content_type 与扩展名映射，不采信 provider 声明与下载响应头 - editor_project_storage 把 model3d 加入 EDITOR_CANVAS_ASSET_KINDS 白名单 - 前端 CanvasAssetKind 与 image-canvas-core 类型新增 model3d：画布卡片渲染预览图或 3D 占位，类型角标新增「3D模型」，覆盖资格只在它与空类别之间成立 - 新增 model3d-preview 子目录（Model3dViewerModal / Model3dViewerModel），Tailwind 内联、不新增 CSS，失败原因分超限 / 格式不可识别 / 无 WebGL2 三类展示 - 选中工具条新增只读 preview-model3d 能力位，仅 objectKey 为空时置灰；打开预览同时选中图层并暂停画布快捷键与舞台交互 - 查看器包源对象 format 改为可选，新增「声明 Content-Type → 字节魔数 → 地址扩展名」三级格式判定并导出支持格式清单 - 导出工作流新增 3d_models/ 目录，模型下载按真实响应头 MIME 定扩展名、对象键扩展名兜底 - 新增 3D 生成入口：底部工具栏浮动子选项与文生 / 图生 3D 面板，落 projectResource + canvasCompletion，复用占位框与任务侧栏 - 3D 定价只读实时定价查询，段缺失即入口不可提交；幂等键由前端铸造，用户重试必须换键 - 新增 ADR 0003 / 0004 与实施计划、里程碑文档；更新 Tripo 技术方案、后端架构、CONTEXT 术语、decision-log 与 pitfalls - .gitignore 忽略仓库根目录手工下载的 3D 样例模型	2026-09-22 10:10:00 +08:00
k88936	c0d6531e92	三个入口的seed参数在TS契约里改用bigint ... - seed 是 i64，JS number 表示不了全部取值却又没有范围校验，客户端传 64 位值会被静默舍入 - text_to_model / image_to_model / multiview_to_model 的 image_seed、model_seed、texture_seed 由 number|null 改为 bigint|null - 同步重新生成的 ts-rs 绑定，仅这三个字段变化	2026-09-21 19:38:47 +08:00
k88936	3e426a1006	容器首帧无尺寸时按真实比例重算取景 ... - 取景原先只在加载完成时按 measureViewport() 的宽高比算一次，隐藏面板里挂载时只能拿到方形兜底值 - 抽出 computeFraming(aspect)，ResizeObserver 首次量到非零尺寸后按真实比例重算并复位一次，之后不再覆盖用户的缩放	2026-09-21 15:17:11 +08:00
k88936	03d5cde838	统一模型字节读取失败的报错口径 ... - response.arrayBuffer() 原先在 fetch 的 try/catch 之外，读到一半失败会直接抛出底层 DOMException - 改为包一层并把失败归一成 Model3dViewerLoadError 的 load-failed，与其它加载失败路径一致	2026-09-21 15:11:30 +08:00
k88936	a87e19444b	修复模型查看器环境贴图失败时的显存泄漏 ... - RoomEnvironment 建好之后若 PMREM 生成失败，原先只把引用置空，它的几何与贴图不会释放 - 失败分支改为先释放已建出的 RoomEnvironment，再释放可能已建出的 PMREMGenerator	2026-09-21 15:11:25 +08:00
k88936	ae426df240	修复模型查看器自动旋转状态可能停在旧值 ... - 场景创建使用 effect 开始时的 autoRotateRef.current，加载期间 prop 变化时 setAutoRotate 的 effect 因 sceneRef 为空被丢弃 - 场景就绪后按最新的 autoRotateRef.current 重新同步一次，避免旋转状态与 prop 不一致	2026-09-21 15:11:20 +08:00
k88936	f90e114bcb	生成目录化的Tripo API与画布TS绑定 ... - 生成模型输入、结果落点、产物元数据与按端点的结果类型到 packages/shared/src/contracts/model3d 子目录 - 新增 editor-canvas 生成目录，画布占位载荷不再依赖手写 TS - 更新 model3d 导出索引，移除已删除的占位作业类型 - contracts:model3d:generate 生成后自动跑 prettier	2026-09-21 12:39:33 +08:00
suzmii	de502e9bc3	替换面板改为非模态浮层，支持在画布上点选替换目标 ... - 共享选择组件新增 opt-in nonModal：不铺遮罩、不做焦点陷阱、限高 + 内部滚动，Esc 在 document 阶段截断后取消，关掉即卸载；网页端美术画布不传，弹窗行为逐字不变。 - 新增 initialSelectionRevision：面板开着时宿主换了目标才重同步当前选择，面板里的搜索词与分类筛选不被重置。 - AGC 侧把候选面板锚到画布右上角（任务开关下方），壳样式放共享样式表、宿主只负责锚定；面板开着时画布照常可点，点中合法候选落成面板当前选择，写入仍只由「确认」发起。 - 退役旧的「点选替换」按钮、画布提示条与 resourceReplacementPickMode：同一个功能不留两条 UI 路径；合法性判据仍复用 resolveResourceReplacementPick，写入仍是同一个 confirm 函数。 - 确认时用画布点选结果兜底，避免点完当帧按确认误报「请选择一个替换素材」。 - 测试：替换用例 4 条点选路径改写为非模态 + 面板点选（含四类非法目标在面板内报因、Esc 只收面板），新增「画布点选不清掉面板搜索/分类」；共享组件用例新增 nonModal 形态与浮层壳声明级契约。 - 文档：PRD 5.3 / 7.8 第 8 条改写、验收用例 S15a 改写、decision-log 新增 2026-09-21 条目、待办文档登记三项并勾掉对应需求。	2026-09-21 03:48:40 +08:00
kdletters	429f991bde	回滚误入 master 的游戏分发 WIP（夹带在 OSS v1 签名提交里） ... - 撤销 39aed2e48 夹带的游戏分发前后端、SpacetimeDB 绑定、主站路由、后台审核页、文档与 nginx 改动，master 恢复可编译状态 - 保留该提交自身的 AGC 发号改动：agc-global-version.mjs 与其参数构造单测 - 恢复被误删的 output 产物，避免把无关清理混进该提交 - 补回两篇技术文档在 docs/README.md 的索引（它们属于后续两个补提交文档，不属于游戏分发） - 游戏分发完整实现保留在 codex/game-distribution 分支继续开发	2026-09-20 20:52:24 +08:00
kdletters	39aed2e486	OSS 写入显式使用 v1 签名 ... ossutil v2 默认 v4 签名，缺 region 会直接失败\n总号写入与回读统一走 buildOssutilArgs，默认 --sign-version v1，可切 v4 并配合 AGC_OSS_REGION\n补充参数构造单测	2026-09-20 18:33:02 +08:00
kdletters	54d0fb75ea	接入 Godot 编辑器插件与受控执行链路 ... 新增 GDExtension 自动引导、GDScript 执行和实例隔离缓存 接入 AGC 插件开关、Runner、Agent 工具与权限审计 完善执行回执确认、不确定状态阻断及卸载恢复 补齐 Windows 分发资源、定向测试与实机验收文档	2026-09-20 16:35:04 +08:00
kdletters	e3682fd06f	固定客户端dev服务并支持官网多平台下载 ... 移除服务器选择并按来源隔离登录凭据 新增官网客户端下载入口和匿名平台聚合接口 根据发布清单自动展示Windows与macOS首装包 补齐Mac首装元数据和上传顺序校验 同步定向测试与下载发布规范	2026-09-19 16:19:28 +08:00
k88936	b0054fd51c	新增 3D 模型查看器独立包 ... - 新增 packages/model3d-viewer（@genarrative/model3d-viewer），含 Model3DViewer、scene、loader、framing、status 与 index - 组件只走 WebGL2 单一路径渲染 glb、单文件 gltf 与 fbx，未承诺格式或超过 32 MiB 时只渲染一行状态文案 - 取景按真实顶点做投影拟合，与模型尺度无关，复位回到打开时的取景 - 新增 framing 与 loader 的纯函数单测 - 根 package.json 的 workspaces 增加 packages/model3d-viewer - scripts/check-npm-workspaces.mjs 与 scripts/check-npm-workspaces.test.mjs 同步工作区清单 - vitest.config.ts 增加新包测试匹配 - 同步 package-lock.json 的工作区链接	2026-09-19 16:13:55 +08:00
k88936	1392303f1c	请求契约把 model 改为必填字段 ... 三个生成请求的 model 由 Option<Model3dModelVersion> 改为必填 Model3dModelVersion，并同步重新生成 TypeScript 绑定 validate_generation_options 不再重复校验 model 缺失，直接由必填的 model 推导 family 三个 client 的 to_sdk_params 改为直接提交模型版本字符串 冒烟示例与技术方案文档同步为必填写法	2026-09-19 14:16:39 +08:00
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	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	35be25dbd6	补齐 model3d 契约在 packages/shared 的导出入口 ... 新增 packages/shared/src/contracts/model3d/index.ts 聚合 ts-rs 生成的 3D 生成契约类型 contracts/index.ts 增加 export type * from './model3d' src/index.ts 增加 export type * from './contracts/model3d'	2026-09-19 13:02:01 +08:00
k88936	18252e24b8	合并主线并保留资源kind枚举收口 ... 合并 origin/master 的 AGC 画布参考与项目能力更新 解决 canvas 生成恢复与任务模型冲突并继续使用共享 GameCreationAppAssetKind 保留 run_id、generationKind 与外部协议字符串的独立边界	2026-09-19 01:50:09 +08:00
k88936	48caa23997	收紧AGC资源kind枚举边界 ... canvas生成与运行时统一使用共享GameCreationAppAssetKind 删除平台kind兼容映射与退役kind拒绝测试 更新资源kind审计里程碑与绑定文档	2026-09-19 01:28:27 +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	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
suzmii	2257a78d6b	收口思考等待反馈与紧凑过程样式及失败状态 ... 思考展开时隐藏重复预览并使用灯泡图标，首个响应前显示临时思考提示。 统一分钟内小数和分钟以上整数秒，保持内外过程的紧凑间距与正文层级。 失败工具与分组显示错误色，非零退出码不再误判为成功。 补齐状态、格式、样式和交互回归，本批其余需求留待后续PR。	2026-09-18 15:46:30 +08:00
k88936	e5fd454bb3	收紧 AGC 资源 kind 类型边界并统一族判据 ... - 将 manifest 与本地导入回执的资源 kind 改为 ts-rs 生成绑定 - 集中音频与视觉资源族判据并复用 Rust 枚举方法 - 放宽 Unknown 未解析语义并清理上传类型墓碑注释 - 标记共享生成绑定并同步项目决策与实施计划	2026-09-18 15:21:19 +08:00
suzmii	a0f6b7c67d	统一思考与执行过程折叠样式及中文耗时 ... 思考展开复用安全Markdown渲染，折叠显示浅色单行纯文本预览与右侧箭头。 共享过程摘要组件，执行过程按真实操作数显示统计并保留各组独立计时。 工具、整轮、生成任务和策划耗时统一为中文时分秒格式。 补齐格式与Markdown回归、更新已有界面断言并验证窄屏键盘操作。	2026-09-18 14:34:10 +08:00
k88936	c2ab9674a0	合并资源编辑与当前主线改动 ... 保留资源 kind 强类型与栅格 subtype 严格校验 合并抠图模式、幂等账本、恢复轮询和 PNG 透明通道校验 修正共享资源枚举在 Cocos 登记与抠图桥接中的类型传递 保留双方模板库、项目快照、发布和 Provider 重试改动	2026-09-18 01:48:13 +08:00
suzmii	c329c438d9	修复资源画布PR的CI回归（#410） ... 修复活动回合空快照引用及停用后晚到请求覆盖问题 对齐共享卡片角标与窗口发布次数回归断言 同步原生HTTP权限检查与图集显式切片测试契约 整理菜单组件导入顺序并记录本地验证范围	2026-09-17 20:17:26 +08:00
suzmii	7edc452c6a	重构AGC资源画布菜单与卡片入口（#409） ... 主菜单保留前五项，其余操作通过向上展开的更多菜单访问 类型与信息入口下沉资源卡片，并复用共享画布角标 补充菜单键盘、滚轮归属、换选及资源操作链路回归 同步方案A规范与待人工验收记录	2026-09-17 18:09:27 +08:00
k88936	04e5512777	UI 编辑器文档资产的 kind + mediaType 判据收敛到共享契约唯一实现 ... - packages/shared/src/contracts/gameCreationApp.ts：新增 `isGameCreationAppUiDesignDocAsset(asset)`，`kind` 严格解析后再比文档 kind、`mediaType` 比 `application/json`，这是该判据的唯一定义。 - packages/shared/src/contracts/gameCreationApp.test.ts：补用例钉住判据——只满足一半（kind 对 / mediaType 不符、mediaType 对 / kind 不是文档）与 legacy kind（`UI`、`ui`、带空格、大写）一律返回 false。 - apps/ai-game-creator-shell/src/view/project-development/index.tsx：桥接结果校验与「自动打开 ui-workflow 完成资源」两处改用共享判据，删掉本地 kind/mediaType 双条件。 - apps/ai-game-creator-shell/src/features/ui-editor/uiDesignResourceBridge.ts：`findLinkedUiDesignResource` 的过滤条件改用共享判据。 - apps/ai-game-creator-shell/src/features/project-workspace/ResourceReferenceInput.tsx：缩略图文档分支改用共享判据（原来只看 mediaType，kind 不同也能命中）。	2026-09-17 16:19:26 +08:00
k88936	6ed3772ff5	资源 kind 用例与 fixture 跟随严格口径（非 canonical 值一律停在待归类） ... - packages/shared/src/contracts/gameCreationApp.test.ts：新增严格解析用例（认不出的原值 console.warn 留痕、返回 unknown），分类映射与自愈用例改用 canonical ui-design / icon，并断言 kind:'ui' 收口成 unknown 后落 unclassified。 - tests/resourceTypePanel.test.tsx / tests/resourceClassificationPanel.test.tsx：自愈用例的 fixture kind 由 ui 改为 ui-design，让「显示口径 ≠ 落盘口径」这条判据继续真的被验证。 - tests/projectResourceLiveIntegration.test.tsx：fixture kind 改为 ui-design；用例按 canonical UI 设计图带「（待视觉验收）」的标签定位按钮，并把用例名与注释改回真实口径。 - tests/resourceCardPreviewRealManifest.test.ts：真机 61 条资产的取证结论改为严格口径——57 条 ui 与 game-entry 停在待归类，明确栏目只由落盘 category 决定；自愈断言改用 ui-design。 - tests/appSurface/home.suite.ts / project-development.suite.ts：fixture 里的 art-spritesheet / game-background / animation / ui-prototype / ui 改为 canonical icon-spritesheet / scene / character-animation / ui-design / icon。 - tests/projectResourceProjectionModel.test.ts / projectResourceLiveUpdateModel.test.ts：fixture kind 由 game-entry / asset 改为 code / image。	2026-09-17 15:46:43 +08:00
k88936	b0ce384b8d	前端资源 kind 改为只消费 Rust 生成的 union，删除壳内第二份实现 ... - packages/shared/src/contracts/gameCreationApp.ts：删除手写 GAME_CREATION_APP_CANONICAL_ASSET_KINDS、GameCreationAppCanonicalAssetKind、GAME_CREATION_APP_LEGACY_ASSET_KINDS 与 canonicalGameCreationAppAssetKind()，改为 re-export ts-rs 生成的 union。 - packages/shared/src/contracts/gameCreationApp.ts：新增穷举 GAME_CREATION_APP_ASSET_KIND_MEMBERS / GAME_CREATION_APP_ASSET_KINDS、isGameCreationAppAssetKind 与严格解析 parseGameCreationAppAssetKind（认不出的原值 console.warn 留痕并返回 unknown）。 - packages/shared/src/contracts/gameCreationApp.ts：分类映射表与 gameCreationAppAssetCategoryForKind 改按生成 union 穷举，unknown 落 unclassified。 - packages/shared/src/contracts/generated/GameCreationAppAssetKind.ts：ts-rs 生成物从壳内私有目录搬到 packages/shared（跨端契约目录）。 - apps/ai-game-creator-shell/src/contracts/assetKind.ts：删除这份壳内重复实现，消费方改从 packages/shared 导入。 - apps/ai-game-creator-shell/src/features/project-workspace/resourceReferences.ts / features/ui-editor/uiDesignResourceBridge.ts / view/project-development/index.tsx：导入点改到 packages/shared 的同一份 parser 与常量。 - apps/ai-game-creator-shell/tests/assetKindCanonicalMapping.test.ts：删除「正则解析 Rust 源码比对两份手写表」的守卫用例，跨语言一致性改由生成 union 在编译期保证。 - .prettierignore / .eslintrc.cjs：忽略规则跟着生成目录一起搬到 packages/shared/src/contracts/generated。	2026-09-17 15:45:24 +08:00
k88936	29ba9a358e	字体 kind 提升为 canonical 并去掉 font 别名 ... - game_creation_app.rs：`GAME_CREATION_APP_CANONICAL_ASSET_KINDS` 加入 `font`（17 → 18 项），分类表补 `font → document`，删除 `"font" => "document"` 别名。 - gameCreationApp.ts：TS 侧同步加入 `font`、删除别名表条目、补 `font: 'document'` 分类，并同步别名表注释。 - 测试：两侧用例改为断言 `font` 是 canonical 成员（大小写仍不敏感）、栏目仍是 document。 - 理由：字体上传写入侧直接落 `font`，再把它当别名会让「落盘值集合」与「canonical 集合」分叉；严格解析下写入侧的值必须本身就是 canonical。	2026-09-17 13:42:05 +08:00
k88936	f216381619	修正 UI 编辑器入口对 canonical ui-design 原型的判断 ... - packages/shared：新增 `GAME_CREATION_APP_UI_DESIGN_ASSET_KIND`（`ui-design`）并让 canonical kind 列表与分类表引用它，避免散落裸字符串。 - project-development/index.tsx：`openResourceUiEditor` 与 `selectedResourceOpensUiEditor` 的原型判断由旧值 `ui-prototype` 改为该常量，恢复原型图的「UI 编辑器」入口。 - resourceProjectionModel.ts：`isPendingUiPrototype` 同步改用该常量，恢复待视觉验收标注。 - project-development.suite.ts：候选界面图 fixture 改用 canonical kind，并补一条原型图打开 UI 编辑器桥接的回归用例（去掉修正即转红）。	2026-09-16 23:10:31 +08:00
k88936	a4296a4bdd	合并 origin/master 并收敛 DirectProject 引用渲染到 canonical user item ... - .eslintrc.cjs 冲突取双方 ignore 并集，保留 contracts/generated/** 与 project-workspace/generated/**。 - 实施计划文档冲突保留双方内容：2026-09-15 资源 kind 枚举化权威口径与 master 新增计划段并存。 - resourceReferences.ts 冲突合并双方 import：kind 解析入口与 canonical DirectCodexUserItem 类型同时保留。 - project-development.suite.ts 冲突合并双方 import：UI 设计文档 kind/mediaType 常量与 ProjectSupervisorView 同时保留。 - decision-log.md 冲突取双方条目，并补记 DirectProject 引用渲染收敛到 canonical user item 的决策。 - 接受 master 退役 agent/direct_codex_references.rs，把 UI 设计文档引用生成代码上下文的 prompt 注入迁入 agent/direct_codex_user_item/wire.rs。 - assets.rs 资源登记 kind 参数收紧为 GameCreationAppAssetKind，相应测试 fixture 改用正式枚举成员。 - 同步 project-memory 实施计划、里程碑与扫描清单中的模块路径。	2026-09-16 21:01:20 +08:00
suzmii	5cd02aa8b0	统一智能体对话层级并完善素材导出与文档预览 ... 当前Agent与策划Agent共用正文和过程表现组件，统一思考及工具调用的小字号浅色样式 素材工具栏按实际动作分组，导出紧邻删除并修复空分组重复分隔线 文档与代码使用共享Markdown预览和代码高亮，复用按需读取与缓存 移除未调用的活跃回合查询命令，保留正式快照恢复链路 补充回归用例并同步技术方案和团队约定	2026-09-16 03:59:27 +08:00
Git Hooks Test	d650bf9b74	完善项目工作台入口与账户兑换码 ... 修复 DirectProject 提交时的项目快照空值类型错误 将运行中项目列表移入窗口标题栏并支持展开查看 增加项目内打开项目目录按钮 在账户资产条中直接显示兑换码入口并保留兑换弹窗 补充相关测试、类型检查与产品文档	2026-09-16 02:39:12 +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
k88936	b7e3dac661	统一引用 UI 文档资产类型常量 ... 前端入口、资源桥接与引用预览统一使用共享常量 Rust 持久化与测试复用共享契约常量 补齐 UI 编辑器入口 fixture 的新资产类型	2026-09-14 21:36:43 +08:00
k88936	18654b6806	同步 UI 文档资产共享契约与前端识别 ... 共享契约新增 ui-design-doc 分类及中英文映射 前端编辑器与资源桥接严格识别文档资产 更新技术方案、实施计划和长期决策记录	2026-09-14 20:45:04 +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
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	8b85977828	修复 PR316 review：共享分段页签宽度下限作用域、标签契约与资源画布样式 ... - packages/shared/src/components/styles.css:528 [bug medium] min-width: max-content 收窄到新的 .platform-segmented-tabs--scroll 修饰类：grid 分支没有溢出容器、轨道是 minmax(0,1fr)，同样的下限只会让内容画到相邻格上；grid 侧靠轨道等分与宿主 truncateLabels 收口，选中 PlatformSegmentedTabs.tsx 的 scroll 分支补修修饰类。 - packages/shared/src/components/PlatformResourceFilterBar.test.tsx 同步改成钉「下限只挂在 --scroll」+「grid 分支不带 --scroll/overflow-x-auto」（声明级断言，jsdom 不计算外部样式表，属弱验证，真机判据见提交说明）。 - packages/shared/src/components/PlatformResourceFilterBar.tsx:24 [maintainability low] Props 改为以 tagItems 为判别项的联合类型：给 tagItems 就必须给 onToggleTag，非法状态编译期不可表达；组件内部再兜 disabled={!onToggleTag} 供给不带类型检查的调用方，并补对应运行时用例。 - packages/shared/src/components/PlatformResourceFilterBar.tsx:107 [style low] 标签行补 scrollbar-hide：它是唯一还画滚动条的横向滚动容器，与 styles.css 里 .scrollbar-hide 的注释口径对齐；补类名与声明级用例。 - packages/shared/src/contracts/gameCreationAppAssetTagLibrary.ts:51 [maintainability low] assetIds 排序改为确定性 code-unit sort()，不再依赖运行环境默认 locale（标签那一层仍显式钉 zh-CN），补跨输入顺序可复现的用例。 - packages/shared/src/contracts/gameCreationAppAssetTagLibrary.ts:68 [bug low] assetTagsMatchSelection 两侧对称归一化：selectedTags 也过 normalizeGameCreationAppAssetTags，' 像素风 ' 这类未归一化的选中项不再静默匹配不上。 - packages/shared/src/contracts/gameCreationApp.test.ts [test low] 新增解析 Rust PROJECT_RESOURCE_CANVAS_SECTIONS 与 TS 常量对齐的交叉校验（仿 assetKindCanonicalMapping.test.ts 解析 Rust 常量先例），钉住两侧分区顺序不漂移。 - packages/shared/src/contracts/gameCreationApp.ts 同步「读显示 / 写回」口径注释：未知 category 已在 Rust 读侧失败关闭，「非法值 → 派生」只剩内存对象语义。 - apps/ai-game-creator-shell/src/styles.css:5790 [bug medium] :has() 悬停高亮分类值换成现行 7 个分区（ui-interaction/character/scene/audio/document/unclassified/version），删掉永不渲染的 code/art 死选择器，补齐缺失栏目的高亮。 - apps/ai-game-creator-shell/src/styles.css:6873 [bug medium] hover/focus-within/is-selected 由只写 border-color 改为完整 border: 1px solid #d57b51（基规则 border: 0 下 border-color 无效果，选中/焦点态此前完全不可见），box-sizing: border-box 下不改卡片尺寸。 - apps/ai-game-creator-shell/src/styles.css:10151 [bug medium] 去掉高优先级 :focus-within 规则里的 box-shadow: none：它盖掉了 --platform-input-focus-ring 焦点光环，direct-codex 输入区此前没有任何可见焦点（无障碍回归），现在光环生效。 - apps/ai-game-creator-shell/src/styles.css:10198 [bug low] 润色状态文字与操作排改为同一行分列（grid-row: 2 + grid-column: 1 / 2），不再整行独占或与按钮重叠，状态出现/消失不改变输入框高度。 - apps/ai-game-creator-shell/src/styles.css:10206 [maintainability low] 删除永不命中的 .resource-reference-input-at direct-codex 规则（showTriggerButton={!directCodex} 不渲染该按钮），保留说明指向真正的 .project-supervisor-reference-trigger。 - 附带 prettier 对 .design-agent-reasoning summary 单行规则的换行归一（该文件本来未过 prettier --check）。	2026-09-12 19:43:58 +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	1be5218aeb	kind 别名表查表加 Object.hasOwn 守卫：原型键不再被误当成别名 ... - `canonicalGameCreationAppAssetKind`（TS）此前用对象字面量直接下标查别名表：`kind` 是外部输入，`constructor` / `__proto__` / `toString` / `valueOf` / `hasOwnProperty` 会命中 `Object.prototype` 上的成员，被当成 canonical kind 返回（`__proto__` 返回原型对象本身）；Rust 侧是 `match` 字面量，只会落 `image` 兜底，同一输入两侧分叉 - 改用 `Object.hasOwn(GAME_CREATION_APP_LEGACY_ASSET_KINDS, normalized)` 先确认命中的是表自己的键，再取值；`noUncheckedIndexedAccess` 下仍保留一次取值后的 truthy 判定 - 补断言（无断言的边界修法下次会被改回去）：`gameCreationApp.test.ts` 对 `constructor` / `__proto__` / `toString` / `valueOf` / `hasOwnProperty` 逐条断言 `canonicalGameCreationAppAssetKind` 落 `image`、`gameCreationAppAssetCategoryForKind` 落 `unclassified` - 跨语言对照：`assetKindCanonicalMapping.test.ts` 的 `decided` 表新增 `constructor` 与 `__proto__` 两行（`image` / `unclassified`），与 TS 同一份口径对照 - Rust 侧同步断言：`game_creation_app.rs` 的 `asset_category_mapping_covers_every_canonical_kind` 补 `constructor` / `__proto__` / `toString` / `valueOf` 必须落 `image` 与 `unclassified`，把「两侧一致」这件事写进两侧各自的用例 - 边界范围：只收口「原型成员被当成别名」这一种极端输入；`kind` 的正常词表、大小写口径与读时自愈规则不变，manifest 字段构成与顺序不变	2026-09-11 19:44:04 +08:00
suzmii	eb6f72ab9d	新增共享筛选浮层外壳 PlatformFilterPanel ... - packages/shared/src/components/PlatformFilterPanel.tsx：新增按需弹出的筛选浮层外壳，只承载通用表现——竖向字段容器、右上角关闭键与 role=dialog 语义；字段名与控件全部由宿主经 children 传入 - 字段排布约定收敛到 PlatformFilterPanelField：字段名在上、控件在下，可用 controlId 把字段名与控件关联；字段名复用既有 PlatformFieldLabel，不另写标签样式 - 不下沉任何领域规则：外壳不知道区域 / 标签 / 状态等概念，不接后端，不算过滤；筛选取值与判据都由宿主持有，因此同一外壳可在不同页面各装一套字段 - 不自带 position：定位与层级由宿主经 className 注入，避免共享层猜宿主布局 - packages/shared/src/components/PlatformFilterPanel.test.tsx：覆盖 dialog 语义与关闭转发、字段逐个渲染且不出现外壳自带的「状态」占位字段、controlId 字段名关联、以及宿主定位类注入且组件不自带 absolute / fixed	2026-09-11 19:43:51 +08:00
suzmii	3082c3e854	kind 别名表大小写不敏感并收口 font：堵住 8 条 UI 资产永远落「待归类」 ... - `canonical_game_creation_app_asset_kind`（Rust）与 `canonicalGameCreationAppAssetKind`（TS）改为对 trim 后的小写值查别名表与 canonical 目录，修正「UI 设计资产的现役写入侧写的是大写 `"UI"`」这条真机事实 - 别名表补 `font → document`：字体上传（`ttf / otf / woff / woff2`）登记的 manifest `kind` 就是 `font` - 为什么必须在别名表收口、读时自愈救不回来：`"UI"` 与 `"font"` 的派生结果本身就是 `unclassified`，自愈规则「派生值不是 unclassified 才触发」永不成立；真机 8 条 `kind:"UI"` + `mediaType:"application/json"` + `localPath:"ui/UI 设计 N.json"` 与写入路径逐字段吻合 - 改写 Rust 断言 `game_creation_app_asset_category_for_kind("UI") == Unclassified` → `UiInteraction`，并补 `canonical_...("UI") == "ui-design"` 与 `font == Document`：旧断言把这条 bug 钉成了「期望行为」，新形态才是唯一真源——写入侧真实写出的 kind 必须能落进明确栏目，否则真机资产永远归不了类 - 改写 TS 断言 `gameCreationAppAssetCategoryForKind('UI') == 'unclassified'` → `'ui-interaction'`，理由同上 - `game_creation_app.rs` 里「现役写入侧仍会写出这些非 canonical 值，必须在这里收口」的注释此前只收口了小写 `ui`，与大写写入侧矛盾，现按注释本意收口 - 新增写侧→分类的端到端契约用例：`resource_bridge.rs` 的 `bridge_is_idempotent_and_installs_source_image` 走真实生产函数 → 真实 `register_local_asset_at(..., "UI", ...)` → 断言落盘 `category` 为 `ui-interaction` - 新增 `assetKindCanonicalMapping.test.ts` 的「写侧 kind 字面量 → 分类」用例组：直接解析 UI 编辑器写侧源码第 3 个实参，写点换个新字面量就会红，防下次再漏	2026-09-11 18:46:58 +08:00
suzmii	576786324f	编辑标签面板回传落盘原值：堵住「只改标签」静默改分类 ... - 新增 `gameCreationAppAssetPersistedCategory`：写回口径，只做「缺失或非法 → 按 kind 派生」兜底，不套用读时自愈；它必然等于 Rust 反序列化后的落盘 `category` - `ResourceClassificationPanel` 的分类初值从 `gameCreationAppAssetCategory`（读显示口径、会把落盘 `unclassified` 自愈成派生值）改为 `gameCreationAppAssetPersistedCategory`，保存时回传落盘原值 - 修掉真机上「同一 `kind:"ui"` 资产同时存在 55 条 `unclassified` 与 2 条 `ui-interaction`」的漂移签名——后者正是自愈值被回写持久化的结果 - 面板注释更正：原注释写「保证『只改标签』不会顺带改动分类」，但那行读的是自愈后的值，这个保证是假的 - `gameCreationAppAssetCategory` 的文档补上「这是读显示口径，回写必须用 `gameCreationAppAssetPersistedCategory`」，避免下次再混用 - 新增面板用例「保存标签不改动落盘 category：自愈值不得被回写」：夹具 `{kind:'ui', category:'unclassified'}`，断言写入命令收到的 `category` 仍是 `unclassified` - 既有面板夹具 `{kind:'character', category:'character'}` 是自愈 no-op，永远测不出漂移，因此保留它作为对照、另加自愈夹具 - 新增契约用例「写回口径保留落盘 unclassified，读显示口径才自愈」，把两个口径的差集钉死	2026-09-11 18:45:38 +08:00
suzmii	4f3516a5d9	修复分类 chip 条叠字：分段页签子项补内容宽度下限 ... - packages/shared/src/components/PlatformSegmentedTabs.tsx：容器补 `platform-segmented-tabs` 稳定钩子类，供共享样式表精确命中子项（不依赖 Tailwind 任意值扫描） - packages/shared/src/components/styles.css：新增 `.platform-segmented-tabs > button` 的 `min-width: max-content`，给每个子项一个「内容宽度」下限；放不下时由容器横向滚动兜底 - apps/ai-game-creator-shell/src/view/project-development/ResourceClassificationPanel.tsx： 「资源分类与标签」的 6 类分类条由 `columns="threeToSix"` 改为 `layout="scroll"` + `frame="bare"` + `surface="transparent"`，与 `@` 面板和资源画布的分类条同一条既有形态 - packages/shared/src/components/PlatformResourceFilterBar.test.tsx：新增两条声明级断言， 钉住「子项不换行 + 容器横向可滚 + 子项有不低于内容宽度的下限」	2026-09-11 14:54:27 +08:00
suzmii	8a1917b7e1	同步分类自愈规则的契约用例：改断言并把盲区补成显式用例 ... - 修正 resolves asset category and tags with legacy and forward compatibility 中 { kind: 'character', category: 'unclassified' } 的期望：由 'unclassified' 改为 'character' - 该断言是 09-09 引入的旧口径，与 2026-09-10 落地的分类自愈规则冲突；按拍板保留自愈规则（它修复真机 57 条 kind:ui 资产落待归类），因此精确更新断言而非放宽为 not.toBe - 在断言处补注释说明这是本批有意行为，并写明已知盲区：用户手动把可明确分类的资产设为待归类时会被覆盖 - 新增用例「自愈规则覆盖落盘 unclassified：这是显式接受的盲区」，覆盖 character / ui / art-spritesheet 三条具体映射 - 新增用例「派生结果本身就是 unclassified 的 kind 不受自愈规则影响，保持落盘值」，覆盖 image / video / code / publication-material 与未知 kind - 新增用例「落盘为明确分类时信任落盘值，不被 kind 派生结果覆盖」，覆盖 image+scene / character+audio / ui+document - 变异验证：临时移除自愈规则后上述 2 条断言失败（expected 'unclassified' to be 'character'），恢复后全部通过	2026-09-11 12:16:26 +08:00