162 Commits

Author	SHA1	Message	Date
k88936	6a1973b0e3	Merge remote-tracking branch 'origin/master' into feat/typed-tool-error ... # Conflicts: # apps/ai-game-creator-shell/src-tauri/src/agent/direct_tools_mcp.rs # docs/project-memory/shared-memory/decision-log.md	2026-10-01 16:04:30 +08:00
lhk229	55375b1406	清理测试编译warning (#509) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/509 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-10-01 15:29:23 +08:00
k88936	1dfe0dd8d4	内置工具错误改成每工具一个 typed enum，工具桥与 MCP 预检收口 ... - 每个内置工具在 agent/tool/<tool>/error.rs 定义自己的错误 enum：一个 case 一个变体，用户（以及转述给用户的模型）可见文案写在变体的 to_user_msg() 上，捕获处只调 to_user_msg() - 跨工具重复的 case（入参形状、项目权限门禁、分页、清单读取、资源登记完成投影、客户端 Direct 回合门禁、宿主执行门禁、未登记工具名）在 agent/tool/error.rs 定义一次，各工具用包装变体 + From 复用，不复制文案 - 工具失败诊断的 code 由「反推错误文案」改成稳定的工具名，开发者信息进 metadata：tool、脱敏 arguments、directTurn、dispatchDenied - 统一错误事件去掉 retryable 字段，AGENT_RUNTIME_ERROR_SCHEMA_VERSION 升到 agent-runtime-error.v2 - 独立客户端 MCP 的 validate_* 改成调用工具桥同一份入参规则，再用该工具 enum 的 to_user_msg() 渲染，删掉重复的字符串文案 - project/verification.rs 的项目权限策略判定改为返回 typed ProjectPermissionRejection（Denied / PolicyUnavailable） - 同步更新技术方案文档的字段表与共享记忆的决策记录	2026-10-01 10:51:50 +08:00
kdletters	e6c3729adb	AGC 发布前检查平台包体上限，并把上限单一来源 ... - shared-contracts 新增 GAME_DISTRIBUTION_MAX_PACKAGE_BYTES（200 MiB），服务端 module-game-distribution 保留同值常量并在注释里指明；api-server 新增 publish_package_limit_matches_the_shared_contract 守卫测试把两处锁一致 - AGC project/export 新增 ensure_within_platform_package_limit：读包阶段预检，超限返回「发行包 X MiB 超过平台上限 200 MiB；请精简资源后重新导出再发布」，不再让 200–512 MiB 的包白读盘/暂存后吃服务端 413 - 用例：project::export::npm_export_tests::publish_precheck_rejects_packages_over_the_platform_limit（边界=上限放行、超限文案、本地导出上限确实更宽） - 里程碑 C1 与 pitfalls 记录「本地导出上限 ≠ 平台发布上限」这一口径	2026-09-29 00:36:28 +08:00
lhk229	ec3a187dd7	处理编译大量warning问题 (#503) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/503 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-24 13:01:31 +08:00
kdletters	8dc0da4608	完善 AGC 发布前原型门禁与进度弹窗 ... 发布前校验可运行原型，未完成时禁止触发用户项目构建 缺失发布说明时自动生成 exports/README.md 移除发布流程的聊天确认卡，新增全屏发布进度弹窗 补充前后端回归测试与项目决策文档	2026-09-23 14:47:43 +08:00
kdletters	57a72f652c	Phaser 项目一键发布：发布前自动构建与打包 ... - AGC：export_local_project_package 改为发布前构建——已有可玩入口直接打包；否则解析 game/（Phaser 4 + Vite 脚手架）或项目根的 npm build 脚本，缺 game/node_modules 时先跑 project.bootstrap（npm install），再走 project.verify 的受控 npm 运行器执行 npm run build，最后校验入口并打包；安装/构建失败返回带日志尾部的可操作错误。 - 新增 resolve_publish_build_plan 纯函数与用例：game 子工程优先并要求先装依赖、根 npm 工程回退、没有可构建工程时失败关闭。 - 后端：发行网关根路径（含尾斜杠）等价于 index.html，路由级用例覆盖 Cookie 拒绝门与根路径；生产仍由每游戏 origin 把根路径映射到该游戏入口。 - 脚本：check:game-distribution-media-e2e 支持 E2E_PACKAGE_ZIP 直接发布真实构建产物，断言从包内派生入口/资源，本地审核入口改为发行网关路径。 - 文档：玩法链路与实施计划记录「作者不构建、不打 ZIP」的 Phaser 发布口径与验证证据。 - 验证：真实 Phaser 4.2.1 + Vite 7 构建产物（相对引用）经发布链路后网关 index.html 200 / assets 1,388,719 B 200，播放页在 allow-scripts 沙箱 iframe 内渲染 PHASER-PUBLISH-OK 且点击交互生效。	2026-09-22 20:38:00 +08:00
kdletters	1bd5fe9ff0	合并 master：AGC 项目快照整目录上传 ... - 合并 origin/master（bba4f0eb2：项目快照整目录上传 .agent，保留项目身份与 Agent 历史）。 - 自动合并无冲突；共享记忆与实施计划文档经复核保留双方条目，游戏分发功能面未受影响。 - 同步目的：Gitea PR 门禁要求 PR head 包含目标分支最新提交，合并后重新推送触发 Project CI。	2026-09-22 16:59:05 +08:00
kdletters	f1b282f3cd	合并 master 并接入 DirectProject 新聊天架构 ... - 合并 origin/master（304 个提交：DirectProject 聊天容器重构、Project Supervisor 退役、策划附件导入、CI 隔离编译缓存等）。 - 接受 master 对 ProjectSupervisorView / SupervisorChatOnlyView 的退役与预览快捷测试收敛；发布入口改由 DirectProject 聊天头承载。 - DirectProjectChatHeader 新增「发布到游戏广场」入口（无回调不渲染、回合忙态禁用），DirectProjectChatView 透传 onRequestGamePublish。 - App.tsx 继续由工作台壳持有试玩包导出与 GameDistributionPublishPanel，沿用 project.export_package 权限确认队列；check-config 把该命令从 native-only 清单移回 App invoke。 - 后台游戏审核 API / 类型 / 路由测试与 master 新增的 AGC 模板管理按双方保留合并，并修掉拼接造成的接口与用例闭合缺陷。 - 修正 master 自带的 viteProxyConfig 断言：/api/creation-entry 属退役路由，测试改为断言不进入代理。 - 记录合并踩坑：语法结构内部的冲突不能简单按「双方保留」拼接，必须按某一侧骨架重建并跑 tsc 与单文件测试。 - 验证：全量 vitest 393 文件 / 4374 用例通过，root / AGC / admin-web 三端 typecheck，cargo check 与游戏分发 Rust 测试，encoding、doc-index、rustfmt、SpacetimeDB schema guard。	2026-09-22 16:45:29 +08:00
kdletters	bba4f0eb24	项目快照整目录上传 .agent，保留项目身份与 Agent 历史 ... - 新增 should_skip_project_snapshot_sync_path：快照同步放行 .agent 组件，并放行其中 .db / .db-wal / .db-shm 的 Agent 状态数据库 - 组件与后缀排除表提取为常量；should_skip_project_snapshot_path 行为不变，项目索引、checkpoint、Agent 上下文与 git 检查继续排除整个 .agent - project_snapshot 扫描入口切到新口径，.agent 的 manifest、agent.db、会话、日志、checkpoint、workbench 与 project.lock 全部参与同步 - 新增整目录扫描用例与策略用例，覆盖 .agent 内凭据、.env、版本库与构建目录仍被排除 - 主规范更新上传内容边界与后台归档范围：工程 ZIP 可用于还原项目身份与 AGC 对话历史 - 里程碑、实施计划与共享记忆决策记录同步 .agent 全量口径、真实上传与后台 ZIP 的运行时验证证据，以及 v1/v2 键布局边界	2026-09-22 16:39:12 +08:00
kdletters	34b1ad5d5c	新增 Godot 模板并补按模板建项的 Godot 分流 ... - 新增 4 个仓库内手写 Godot 4.7 模板源：godot-empty-2d、godot-empty-3d、godot-hello-world、godot-platformer-2d，entry 统一为 project.godot，各自带 meta.json 与 960×540 封面 - template_library.rs：复制模板后按 project.godot 识别 Godot 模板，改写工程显示名后走既有 Godot 导入并写入 godotProjectRoot，不再落到 Web 占位入口 - manifest.rs：新增 apply_godot_project_display_name，只改 [application] 段的 config/name 一行，其余字节逐字保留 - manifest.rs：放宽 Godot 工作区发现，一层子目录多命中按目录名排序取第一个，project.godot 允许是符号链接 / reparse point / 硬链接 - commands.rs：同步 Godot 导入错误文案，去掉「普通文件」限定 - RuntimeConfigDialog.tsx：内置插件行去掉手动启动 / 停止按钮，启动由前端自动启动承担、停止走该行启用开关 - import_tests.rs 与 tests/project.rs：补显示名改写、多命中确定性、链接标记与错误文案的定向回归 - 同步更新 PRD、模板包组织指南、模板库与模板建项技术方案、AGC Godot 编辑器插件接入方案、实施计划与共享决策记录	2026-09-21 17:25:34 +08:00
kdletters	1cb91f9444	修复画布绑定查询与生成失败归因 ... - 画布绑定前置的项目列表查询改为 view=summary，站内与外部路由统一支持摘要视图（缺省 full 兼容，未知取值 400） - 项目摘要投影收敛到 editor_project，外部 API 与 MCP 复用同一份实现，摘要不做内联媒体修复也不回传画布与全量资源 - 外部编辑器请求失败文案补 kind 语义与底层因链，区分请求超时、正文截断与非法 JSON，不拼接 URL - 远端资源编辑终态文案带出稳定失败码并指向移出恢复队列这一唯一出口，上游原文仍不写入账本 - 补齐站内摘要视图与画布测试夹具的请求断言用例 - 更新共享决策记录与踩坑记录（图集切片上限条目归上游 #442，本提交不重复）	2026-09-21 13:33:23 +08:00
kdletters	485ed50b26	AGC 七项交付效率优化并升级捆绑 Codex 到 0.155.1 (#439) ... ## 背景 净月潭案例（2026-09-19 21:53 → 09-20 01:26，3 小时 33 分）的问题不是模型慢，而是环境未就绪、验收靠模型自述、预算只约束单个工具入口、工具调用被 SDK 全局串行闸门卡住。本 PR 落地确认后的七项交付效率合同，并把捆绑 Codex 升到当前 npm latest。 ## 结果 - 新建 Web 游戏在正式生成前由宿主自动预检：捆绑 Node/npm、真实 Vite 构建、受限浏览器桌面/移动截图；失败不启动生成或付费素材。 - 首个副作用前冻结交付合同，宿主保存权威证据与预算；证据齐全后先封口、排空并取得执行器完整退出证明，再产出交付报告，模型回复不再当作验收。 - 原生 shell、内置浏览器与托管命令、第三方 MCP 共用同一执行许可和累计执行时间；`validation.maxRuns` 改为执行/返修批次语义，另设 `maxTurnSeconds` 墙钟上限。 - 所有工具可并发：移除 SDK 全局串行的 `apply_patch`/`update_plan` 注册，改由宿主 `agc_apply_patch`（官方 parser + 当前回合写许可 + 受控进程树 + 短项目事务）和 `agc_update_plan` 提供等价能力；真实请求目录里已无串行注册，长 MCP 与补丁/计划实测在同一响应内重叠。 - 付费提交与本地写入绑定原回合原租约：容量与同动作锁等待可取消，封口、取消或预算耗尽后零新增提交；已越过提交边界的请求保留 operation ID 走 GET 对账，不自动重放。 - 新增请求与工具分段计时、有界并行批读和首轮上下文预取，未知耗时不补零。 - 捆绑 Codex 0.147.0 → 0.155.1：固定版本收敛到 `build_support/codex_bundle.rs` 单一声明，vendor 解析源码按 `rust-v0.155.1` 逐字节重取并更新 UPSTREAM 证据，适配 0.155 统一 exec（`exec_command`/`write_stdin`）；macOS 侧车最小系统版本仍为 15.0。 ## 验证 - 生产 CLI → 捆绑 Codex 0.155.1 → 本地 Responses/MCP 夹具 9/9：补丁、完成收尾、批次、只读/可写 MCP 并发、原生命令并发、原生资源并发、统一 exec 会话、期限终止（真实重叠 775 / 764 / 999 ms）。 - 真实模型目录 2/2；vendor 上游库 111 项；宿主定向与回归 106 项；真实 Windows 进程与取消 21 项；Node 侧门禁 52 项。 - 发行载荷：artifact-only 重建 NSIS，解包验证侧车清单 `codex-cli 0.155.1`、6 个组件哈希、打包后 `bin/codex.exe --version`、Node 运行时 2130 文件与双端 PNG、`--environment-check` ready。 - `check-config`、TypeScript、编码（4991 文件）、文档索引、`git diff --check`、`cargo fmt --check` 全部通过。 ## 未覆盖 - 真实陶泥儿登录态 Provider 生成尚未执行（本机 `--llm-status` 返回 `authentication-required`）。 - macOS 侧车只在本机做静态 Mach-O 与清单解析，未在 macOS 上跑 `check-macos-bundle.mjs`。 - 全仓库聚合套件在本机仍因负载敏感的后台 mock-provider 用例而红，与本次改动无关：改动前的旧二进制同样失败，换单线程后相关用例 3/3 通过。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/439	2026-09-21 02:29:29 +08:00
k88936	ae0ab0ddf4	音频后台生成不再传形同虚设的 sourceMediaType ... - `run_local_project_audio_generation_at` 提交 `derive_local_project_resource_at` 时把 `source_media_type` 从 `Some("audio/mpeg")` 改成 `None`（`generation_mode: Create` 下源快照的 媒体类型由 `edit_kind` 推出，这条通道根本不读该入参，留着会让读者以为它有作用） - 该函数文档补一句说明「Create 模式不读 `input.source_media_type`」，避免后续又被加回去	2026-09-21 00:11:31 +08:00
k88936	99fb6c38c1	AGC 音频生成并入图片类那份后台任务账本 ... - 原生：`start_local_project_asset_generation` 新增可选入参 `idempotencyKey`，并在音频 kind 上分叉；图片类载荷与分支逐字未改 - 原生：新增音频提交期收口 `prepare_local_project_audio_generation`（kind / 提示词上限 / 素材名 / operation 身份 / 幂等键） - 原生：新增 `run_local_project_audio_generation_at`，在派发时刻读项目 revision 并复用既有音频无源生成实现，不复制生成逻辑 - 原生：新增 `begin_local_project_audio_generation_task` / `run_local_project_audio_generation_task`，音频任务落同一份项目内账本并写 running → completed / failed，跑完没登记素材按失败收口 - 原生：补两条用例——被拒绝的提交零写入账本、音频任务落在同一账本且 kind 正确 - 前端任务模型：新增音频任务与 `idempotencyKey` 字段，恢复出来的历史任务不带它也不承接重试，入口文案扩到音频栏目 - 前端队列：按 kind 分流派发载荷，音频只发任务身份（任务 id 即 operation id）与幂等键 - 前端面板：音频生成面板改为点「生成」同步提交并立即关闭，删除「生成中…」「后台运行并关闭」与输入锁定 - 前端宿主：音频提交改为同步入队并展开「生成任务」侧栏，只有「后端从未受理」才连原草稿与原请求身份重开面板 - 前端清理：删除随本次改动失效的 `resourceCanvasGenerationSourceId` 与宿主里不再使用的 import - 测试：面板 / 队列 / 宿主生命周期 / 落点 / appSurface 改按后台账本口径断言，并补「未受理即时失败重开」用例（已用移除重开逻辑的变异验证其非空） - 文档：PRD §3.10 / §7.9、AGC 底部工具栏入口矩阵、V3 端到端验收 S11a 同步为音频后台化口径 - 文档：新增里程碑与实施计划（含验收证据矩阵），并在 decision-log 记下「音频并入后台任务账本」这条长期约定	2026-09-20 23:32:09 +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	37189c9252	记录项目主模型使用历史并补录旧项目 ... 在项目 .agent 中保存请求模型与响应确认型号，区分目录标识和真实模型 为旧项目补录带来源标记的模型信息，保留历史并确保重复打开幂等 在 Direct Codex 代理中提取模型元数据，异步落盘且不阻塞响应转发 补充模型追溯边界测试并同步技术方案与团队约定	2026-09-20 17:02:44 +08:00
kdletters	97d8a6c39a	清理并统一外置智能体提示词 ... 将智能体系统指令、工具说明和恢复模板集中到外置提示词目录 精简重复否定、历史对照与无关实现说明，保留必要执行约束 扩展提示词构建校验和源码边界检查并接入现有本地与持续集成门禁 同步内置技能、协作规范、技术文档与对应验证断言	2026-09-20 15:32:48 +08:00
lhk229	70271b408e	删除策划agent v2，与退役功能解耦 (#355) ... Reviewed-on: #355 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-20 14:49:57 +08:00
kdletters	33f5ad68bf	接入 DotCraft Unity 编辑器插件与受控执行链路 (#423) ... AGC 原有插件系统无法直接操作已打开的 Unity Editor。本变更增加内置 `agc-unity-editor`，在 Windows x64 / Unity Mono 上支持当前项目探测、连接与 C# 执行，不向 Unity 工程安装 UPM 桥接包。 ## 主要变更 - 固定复用 DotCraft.Unity 0.4.3 的 Attach 核心，提供自包含 .NET helper，保留上游许可证、来源及修改记录。 - GUI、Runtime、DirectProject 共用 Runner 执行服务；补齐项目身份、并发、总期限、回执确认与持久不确定状态阻断。 - 现有打开项目入口支持 Unity，按项目类型及开关暴露插件和 Agent 工具。 - Windows 构建准备 helper 并随包分发；插件 JS/Rust 测试接入现有 CI 组，Jenkins 增加 .NET 10 工具链预检。 ## 验证 - .NET helper 27 项测试、自包含发布及最小环境协议 smoke 通过。 - Unity 6000.3.7f1 实机验证通过：连接、C# 执行、编译错误修复、断连重连、Domain Reload 后重新握手；真实 Runner 的 ACK、并发拒绝和跨重启阻断通过。 - 宿主 Unity、PluginHost、Cocos、MCP、工具目录与引擎识别定向回归通过；前端类型检查、插件 JS/Rust、CI 配置、格式、编码和文档门禁通过。 Linux CI 不代替 Windows helper/实机验证；发行安装包 UI smoke、其它 Unity 版本和 Unity CoreCLR 未验证。Unity 演示工程中的场景和组件已撤销，不在此 PR 范围内。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/423	2026-09-19 12:29:27 +08:00
k88936	5d20f5bfeb	修复 AGC 资源 kind 枚举化后的编译与字符串回退 ... - canvas_generation：参考素材合同四个 helper 改收 GameCreationAppAssetKind，删除 ui-prototype/game-background/art-spritesheet 字符串比较 - direct_runtime：删除 game-background / art-spritesheet 的参考合同字符串映射，直接传枚举 - resource_editor：音效/BGM 编辑类型判据改为比较 ResourceEditSourceKind::Manifest(BackgroundMusic)，不再拼字符串 haystack - assets/commands：画板导入 kind 解析上移到 Tauri 命令边界，import_canvas_asset_at 只接收枚举 - 测试与批量标签脚手架：kind 参数由字符串改为 GameCreationAppAssetKind，恢复编译期穷举保护 - 技术方案：登记边界同口径改为描述命令边界解析	2026-09-19 02:38:30 +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	e5fd454bb3	收紧 AGC 资源 kind 类型边界并统一族判据 ... - 将 manifest 与本地导入回执的资源 kind 改为 ts-rs 生成绑定 - 集中音频与视觉资源族判据并复用 Rust 枚举方法 - 放宽 Unknown 未解析语义并清理上传类型墓碑注释 - 标记共享生成绑定并同步项目决策与实施计划	2026-09-18 15:21:19 +08:00
k88936	c2ab9674a0	合并资源编辑与当前主线改动 ... 保留资源 kind 强类型与栅格 subtype 严格校验 合并抠图模式、幂等账本、恢复轮询和 PNG 透明通道校验 修正共享资源枚举在 Cocos 登记与抠图桥接中的类型传递 保留双方模板库、项目快照、发布和 Provider 重试改动	2026-09-18 01:48:13 +08:00
k88936	72cd0747a4	拒绝栅格资源 subtype 静默降级 ... 非图片族和未知 sourceSubtype 改为明确报错 补充栅格正规化回归测试并同步规范	2026-09-17 23:06:30 +08:00
suzmii	20b1fd63de	合并最新主线抠图链路与开发监听修复 ... 合入master的抠图账本链路、Vite监听边界及窗口测试更新 保留画布占位参考生成、资源展示与批量标签追加功能 合并态通过137项定向测试、AGC类型检查及Rust全目标编译	2026-09-17 22:18:23 +08:00
suzmii	105591bac5	支持画布与资源面板多选素材批量追加标签 ... 复用标签编辑器并冻结整组选中素材，保留原标签与素材类型 原生批量校验后一次保存，覆盖权限、版本冲突与无变化边界 修复保存输入锁和切项目迟到回包，补齐混合选择入口原因 新增前后端回归并记录本地验证及待真实客户端验收事项	2026-09-17 21:51:59 +08:00
lhk229	195b7dd5dd	修复抠图401 404问题 (#394) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/394 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-17 21:37:23 +08:00
suzmii	0a85c4f87e	合并主线资源菜单和引擎预览功能 ... 合入PR410的常用操作收纳与卡片信息类型入口 保留本分支资源名称、文档图标、占位生成与批量移动能力 整合引擎结构摘要与当前图集测试契约	2026-09-17 21:06:15 +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	db5edc948c	合并最新主分支并修复画布静态检查问题 ... 合入master的更新摘要、策划运行边界及图集契约调整 保留画布生成引用占位、资源卡展示与批量布局功能 修正导入顺序、未使用项和稳定回调依赖	2026-09-17 20:15:38 +08:00
k88936	8dce016552	修正 manifest kind 留痕去重范围 ... 按 manifest 来源与资产身份去重 避免不同项目相同 ID 互相抑制日志	2026-09-17 19:18:07 +08:00
k88936	64879cfcdd	合并资源规范与画布 JSON 功能 ... 合并 canonical 资源 kind 校验与按类型提示词上限。\n保留 UI JSON 预览识别、严格 UI 文档持久化和画布编辑入口。\n修复合并后 Rust 资源 kind 测试夹具并补齐定向回归用例。	2026-09-17 18:28:19 +08:00
suzmii	aec9568c39	接通画布生成参考素材的原生链路 ... 新增 referenceAssetIds 原生入参：start_local_project_asset_generation 与 generate_local_project_asset 经 prepare_local_project_asset_generation 统一收口当前项目 manifest 图片素材 id PlatformArtAssetGenerationOptions 增加 reference_asset_ids，GUI、agent 桥、media 观察与 Direct 运行时构造点显式传空 参考解析固定规范图前置在前、用户参考按给出顺序随后，按远端资源 ID 去重，普通生成总量 5 张、有规范前置 4 张用户参考，图集拒绝额外参考而非静默丢弃 参考素材复用 manifest 到本地文件、图片解码、内容 hash、当前账号 binding 上传的既有通道，历史账号遗留远端 ID 不再复用 retained 阶段与清单校验改为与提交同一套请求合同：icon-spec、ui-prototype、game-background 允许正确引用，art-spritesheet 仍只接受唯一规范引用 修复 Part::file_name 的生命周期错误与 4 处测试构造点少传参考参数	2026-09-17 17:57:53 +08:00
k88936	796ad7bb51	资源 kind 只保留一个公开解析入口 ... - server-rs/crates/shared-contracts/src/game_creation_app/asset_kind.rs：删掉公开的 `from_str_or_unknown()`（`from_str_lossy` 的残留命名），严格匹配降级为私有 `match_canonical()`；`parse_with_context()` 成为唯一公开解析入口，`FromStr`、serde 与所有边界一律走它，认不出 canonical 值只有这一处收口并留痕。 - server-rs/crates/shared-contracts/src/game_creation_app/asset_kind.rs：词汇表用例改走唯一入口，并断言每个非 canonical 变体都留痕。 - apps/ai-game-creator-shell/src-tauri/src/project/manifest.rs：读侧回捞 legacy kind 时不再调用第二个解析函数，直接用唯一词汇表 `ALL` 判真值（`unknown` 本身是成员，自然跳过）。	2026-09-17 16:27:48 +08:00
k88936	0510cd8d9c	AGC 壳把资源 kind 的登记与解析边界统一到严格口径 ... - assets.rs：新增 `registration_asset_kind()`，空白入参落中性 `image`、非空认不出严格收口成 `Unknown` 并留痕；`import_canvas_asset_at` 改走该函数。 - commands.rs：`imported_platform_asset_kind` 与 `register_local_asset` 一并委托给 `registration_asset_kind()`，删掉两处各写一遍的 trim/严格解析分支。 - agent/generation/canvas_generation.rs：切片残留登记判据改为只看 `assets/art-spritesheet-slices/` 路径——历史切片刻的 kind 是非 canonical 值，严格解析后收口成 `unknown`，再带 kind 判据会漏掉半成品登记并静默跳过回填；补平台词汇映射用例钉住别名与未映射值落点。 - project/resource_editor.rs：栅格归一化的源 subtype 收口到图片族成员（音频/视频/文档/字体等一律按图片登记），Agent 回执派生物写回 `Document` 而不再主动写 `Unknown`；补派生 kind 用例。 - ui_editor/workflow.rs：新增 `same_sprite_asset_identity()`，比较 sprite 身份时忽略随 kind 派生的 `metadata.asset_type`，避免对既有 State 重跑工作流误报资源冲突。	2026-09-17 16:19:00 +08:00
k88936	b56566f40e	AGC 壳把资源 kind 留痕接到 app_log! 并把各解析边界统一为严格口径 ... - main.rs：新增 register_non_canonical_asset_kind_reporter()，把 shared-contracts 的原始串与上下文落到 app_log!，按 (原始串, 上下文) 去重；main() 启动时注册。 - commands.rs：imported_platform_asset_kind 改为直接 parse_with_context，不再先经别名表收口；用例改为断言 UI / ui / mystery / game-art / ui-prototype 等非 canonical 值一律落 unknown。 - assets.rs：画板/上传等用例的 kind 断言改用 GameCreationAppAssetKind::ALL 穷举口径。 - project/manifest.rs：读 manifest 的留痕去重键由「只有原始 kind」改成「原始 kind + 资产身份」，避免第二个写旧值的资产被静默吞掉。 - project/manifest.rs：from_str_lossy 调用点改名 from_str_or_unknown。 - agent/generation/canvas_generation.rs：画板 assetKind 的兜底分支改为 parse_with_context，非 canonical 值留痕收口为 unknown。 - project/version_resource_replacement.rs：subtypeEqual 改为 canonical kind 直接比较，去掉中间归一。	2026-09-17 15:44:02 +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
k88936	3ab56e6cfa	非 canonical 资源 kind 严格收口并留痕原始串 ... - manifest.rs：读 manifest 时若存在 `unknown` kind，从原始 JSON 回捞 `assets[].kind` 原值，连同资产 ID、路径写进应用日志；同一原值每进程只记一次，避免刷屏。 - recovery_tests.rs：新增用例钉住回捞范围（只报非 canonical 值，跳过 canonical 与字面 `unknown`；结构异常返回空表）。 - commands.rs：`imported_platform_asset_kind` 收口平台 `assetKind` 时，非 canonical 原值一并留痕，供后续定位平台侧 legacy 写入点。 - shared-contracts/Cargo.toml：`ts-bindings` 不再顺带打开 `kind-observability`，改由 AGC 壳显式声明，日志开关不再随绑定需求被动启停。 - 口径：kind 保持严格解析（无 trim/lowercase、无别名表、无迁移），认不出的值一律收口 `unknown` 并留痕，不做 fallback。	2026-09-17 13:41:41 +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
k88936	f185d21f55	资源编辑源身份改用独立词汇表，只传正式 kind 成员 ... - resource_editor.rs：新增 `ResourceEditSourceKind`，把源身份拆成 `Manifest(GameCreationAppAssetKind)` / `ProjectVersion` / `AgentResultText` - resource_editor.rs：`ResourceEditSourceSnapshot.asset_kind` 由 `String` 收紧为该枚举，项目版本与 Agent 回执不再冒充 manifest kind - resource_editor.rs：`infer_resource_edit_source_asset_kind` 直接返回枚举成员，`art-image` / `svg` / `text` 收口为 `Image` / `Image` / `Document` - resource_editor.rs：栅格源归一化只接受正式枚举成员，`task-artifact` 特判删除，未知值按 `Image` 收口 - resource_editor.rs：账本、HTTP 载荷与提示词边界改用 `as_str()`，manifest 写回改用 `manifest_kind()` - resource_editor.rs：`source_subtype` 字段补充「只接受 manifest 正式 kind」的文档说明，测试 fixture 同步改用枚举成员	2026-09-16 19:07:23 +08:00
k88936	a61b0cce81	收敛 AGC 资源 kind 写入与读取到正式枚举成员 ... - assets.rs：`register_local_asset_at` / `register_local_asset_entry` 改为接收 `GameCreationAppAssetKind`，画板导入与画板同步在边界解析 kind - assets.rs：`infer_canvas_export_asset_kind` 直接返回枚举成员，去掉仅供兜底的 canonical 归一 - commands.rs：资源登记按 `asset.register` 上下文解析 kind，字体导入写 `Font`，本地文件类型表与平台导入归一改用枚举 - direct_runtime.rs：直连游戏工程产物统一写 `Code`，图集切片读取按 `Icon` 叠加切片路径判定，陶泥儿美术身份改收枚举 - canvas_generation.rs：新增 `platform_art_asset_manifest_kind` 收口平台美术请求词汇，切片登记 category 改用 `Icon.as_str()` - manifest.rs：必填视觉资产校验改用 `IconSpec` / `UiDesign` / `IconSpritesheet`，修正此前与写入侧对不上的比对 - project_gates.rs、autonomous_policy.rs、recovery_scan.rs、direct_tool_bridge.rs、ui_editor workflow/persistence/resource_bridge：读取侧与 fixture 改用正式枚举成员 - tests：资源相关 fixture 与断言改用正式枚举成员	2026-09-16 19:07:12 +08:00
kdletters	4182979a19	平台会话身份与凭据分离，续期不再中断在途生成 ... - 原生会话快照拆成身份代次与写入 revision，安装与清除按 revision 排序、按身份归属判定 - 冻结平台会话校验改为只比身份，同账号 access token 轮换不再让在途生成、编辑、上传、确认和下载失败 - 同一身份代次禁止更换登录主体或服务 origin，换号、退出和 origin 变化继续失败关闭 - Runner attach 新增 platform_auth_revision，平台会话安装与校验按 revision 排序、按身份归属判定 - GUI owner 替换与清除改为计数器只增不减，同一主体重装保持身份代次，避免旧 epoch 迟到写入复活 - renderer 拆分平台原生身份代次与写入 revision，同账号续期只更新凭据，不推进身份代次 - 刷新失败结果新增权威失效判定，只有服务端明确 401 与 403 才清除本地会话，网络错误和 5xx 保留会话 - 收敛刷新判据，重复的刷新工具函数合并为一个对外判定，去掉一次性包装 - 补齐平台会话身份判据、续期与迟到写入的 Rust 与前端回归用例	2026-09-16 17:08:46 +08:00
lhk229	bfc7eaa794	修复 AGC CI 契约、JSON 预览与工具调用时间戳 (#380) ... 修复 AGC 的 Rust 编译、资源预览及工具调用时间戳问题，并包含当前分支已有的 Rust shard 4 修复。 变更： - 补齐 Direct 回合事件测试构造中的 reasoning_text、stream_items 字段。 - JSON/JSONC 不再按代码扩展名匹配，JSON 规格恢复文档预览。 - 工具条分隔线测试对齐当前动作组条件，去掉旧 CSS 与变量名断言。 - 实时事件与历史回读的工具调用时间戳在模型入口归一化为毫秒，界面仍显示秒/分钟。 - 防止失效的精灵切片绕过校验重新进入通用资源路径；同步混合历史记录的失败关闭测试契约。 验证： - 资源预览契约、真实 manifest、工具条测试：12 项通过。 - Direct 回合呈现测试：15 项通过。 - Rust direct_turn_update_payload_is_the_exact_camel_case_contract 通过，test target 编译成功。 - git diff --check 及提交钩子 ESLint、Prettier、Rustfmt 通过。 未运行完整 CI 或完整 appSurface 套件；其余对话区结构/文案断言未在此 PR 中批量调整。rehype-highlight 已在 master 的 package.json 与 lockfile 中声明，本 PR 未重复添加依赖。 Reviewed-on: #380 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-16 05:42:20 +08:00
k88936	3907a8bf74	补齐资源 kind 字符串字段转换 ... 资源编辑请求中的 sourceSubtype 统一从 AssetKind 显式转换字符串。	2026-09-15 20:52:53 +08:00
k88936	46dfa2cffb	修复资源枚举迁移后的测试类型错误 ... 将字体、角色和资源图 fixture 改为 AssetKind 枚举。 将资源 kind 回传到字符串字段时显式使用 to_string。	2026-09-15 20:45:55 +08:00
k88936	b4fd8d9b8b	收紧 AGC manifest 资源 kind 字段 ... 将 manifest 条目 kind 改为 Rust 枚举并把未知值收口为 Unknown 修正字体上传与图集切片的正式资源 kind 保持 source.kind 与 generationKind 等其他字符串字段不变	2026-09-15 17:37:28 +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