204 Commits

Author	SHA1	Message	Date
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
lhk229	4864e92e30	修复策划智能体提示词边界与资源引用 (#433) ... 恢复顾问态不自主推进、不安排下一步和不提交阶段审批的约束 恢复过程文档轻量记录原则并明确审批与问询的职责边界 补回顶层设计的排除方向及星露谷示例定位 统一星露谷分析示例的五处旧路径引用 同步策划专题文档与团队共享约定 Reviewed-on: #433 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-20 18:07:37 +08:00
kdletters	97d8a6c39a	清理并统一外置智能体提示词 ... 将智能体系统指令、工具说明和恢复模板集中到外置提示词目录 精简重复否定、历史对照与无关实现说明，保留必要执行约束 扩展提示词构建校验和源码边界检查并接入现有本地与持续集成门禁 同步内置技能、协作规范、技术文档与对应验证断言	2026-09-20 15:32:48 +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	603650fbf4	修复 AGC 资源 kind 收敛后的 Rust 默认值与工具栏用例 ... - agent/runtime_tools/media.rs：asset_kind 只在入参未声明（空白）时落通道默认值，显式认不出的值保持 Unknown 交给下游失败关闭。 - tests/project.rs：规范图 / 图集用例的入参改传 canonical kind（icon-spec / icon-spritesheet），用例名与断言同步。	2026-09-19 03:21:25 +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
suzmii	deff6319e2	合并主线项目创建目录选择更新 ... 合入 master ee33af7b7 的项目目录选择与模板建项说明。 保留本批画布和对话修复，自动合并无冲突，类型检查通过。	2026-09-18 15:48:10 +08:00
kdletters	be370cc615	AGC 支持用户自选项目创建目录 ... - 新增设置「工作区」分类，承载「项目创建目录」的选择与恢复默认入口 - 自动建项命令新增可选 projectsRoot，未指定时沿用 AppData projects 默认目录 - 新增项目创建目录校验与解析：只接受目录选择器返回且通过私有路径门禁的既有目录 - 目录选择器新增可选 title 参数，用于「选择项目创建目录」文案 - 首页自动建项与模板建项在建项时携带用户选定的项目创建目录 - 客户端本地保存项目创建目录偏好，建项时重新校验，不作为授权凭据 - 补充设置页工作区、首页建项与目录偏好单测 - 修复项目开发视图缺失的 Shapes 图标导入，恢复 agc:typecheck 通过 - 同步实施计划、决策日志与排障记忆文档	2026-09-18 14:10:05 +08:00
k88936	03d7bca9a5	Merge remote-tracking branch 'origin/master' into feat/agc-organize-assetkind	2026-09-18 10:43:00 +08:00
k88936	2abad3b537	修复失败测试 ... 测试现在直接从 AGENT_RUNTIME_CANVAS_ASSET_KINDS 派生期望值，避免再次漂移。	2026-09-18 10:42:40 +08:00
suzmii	1bd153d7f2	合并主线对话状态与抠图背景色更新 ... 合入 master a2e6f205d，保留远端功能分支已有合并历史。 融合生成选项的参考素材、目标栏目与抠图背景色字段。 保留主线统一线程状态与重试策略，完成前端及原生定向验证。	2026-09-18 10:31:55 +08:00
lhk229	a2e6f205d6	修复最终回复失败测试重试超时 ... 最终回复失败测试显式关闭 Provider 重试 让非法回复 mock 按实际请求次数监听 同步运行态公共失败审计测试的 mock 参数	2026-09-18 04:55:05 +08:00
k88936	fc5cea43ac	Merge remote-tracking branch 'origin/master' into feat/agc-organize-assetkind	2026-09-18 01:55:16 +08:00
k88936	c2ab9674a0	合并资源编辑与当前主线改动 ... 保留资源 kind 强类型与栅格 subtype 严格校验 合并抠图模式、幂等账本、恢复轮询和 PNG 透明通道校验 修正共享资源枚举在 Cocos 登记与抠图桥接中的类型传递 保留双方模板库、项目快照、发布和 Provider 重试改动	2026-09-18 01:48:13 +08:00
lhk229	1c6e4c1e74	AGC生图工具暴露抠图背景色并补齐相关说明 (#414) ... agc_generate_image 新增 screenColor 参数，仅 kind=character/art-spritesheet 生效，说明含 12 色板 hex 与不得接近本体颜色的约束 screenColor 计入 standalone 生成动作身份，None 时跳过序列化，未使用该字段的请求身份与升级前逐字节一致 character 生图请求体按需注入 screenColor，art-spritesheet 图集把硬编码 auto 改为透传归一化值 bridge 侧只校验 auto/#RRGGBB 格式并统一大写，色板白名单交由服务端 400 权威校验，其它 kind 携带直接拒绝 修复 sliceCount 悬空指引：MCP schema 与双层字段白名单补齐，1-256 校验后透传至图集生成请求 精简 agc_generate_image 工具说明，删除美术包限制与客户端职责两段样板句 审计投影同步记录 screenColor，补充 bridge 归一化、动作身份指纹与工具目录契约测试 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/414 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-18 01:14:02 +08:00
lhk229	f5a333b839	Merge branch 'master' into feat/agc-canvas-acceptance	2026-09-18 01:04:04 +08:00
kdletters	2e15a70b14	Provider 瞬态重试次数严格按设置执行 ... 删除自主构建档位 12~16 的重试区间与 standard 档位 3 次上限，maxRetries 严格决定物理重试次数 上游 400 不再单独收窄到 2 次，与其它瞬态错误共用设置里的同一份预算 运行档位改为只决定上游 400 是否算瞬态，重试次数不再被档位改写 重写档位重试用例为设置值直取，同步 upstream-400 用例 decision-log 记录本次口径变更与本机既有失败边界	2026-09-18 00:01:40 +08:00
suzmii	0a85c4f87e	合并主线资源菜单和引擎预览功能 ... 合入PR410的常用操作收纳与卡片信息类型入口 保留本分支资源名称、文档图标、占位生成与批量移动能力 整合引擎结构摘要与当前图集测试契约	2026-09-17 21:06:15 +08:00
suzmii	efce7b102f	对齐主线图集契约与窗口同步测试要求 ... 补齐图集切分声明与工具目录字段边界断言 更新原生HTTP权限守卫及稳定空快照发布次数期望 修正末尾空行并记录CI排查证据，保留待远程验证状态	2026-09-17 21:01:26 +08:00
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
suzmii	db5edc948c	合并最新主分支并修复画布静态检查问题 ... 合入master的更新摘要、策划运行边界及图集契约调整 保留画布生成引用占位、资源卡展示与批量布局功能 修正导入顺序、未使用项和稳定回调依赖	2026-09-17 20:15:38 +08:00
suzmii	6001b87215	画布生成按入口栏目落盘目标分类 ... GUI 生成命令新增可选 targetCategory：generate_local_project_asset 与 start_local_project_asset_generation 经 options 传入完成登记 PlatformArtAssetGenerationOptions 增加 target_category，Agent 与 Direct 路径保持 None，仍按 kind 派生默认分类 新建条目与同 kind 重登记都按显式目标分类写入 manifest 既有 category 字段，不新增字段、不改数据结构 目标分类只接受 GameCreationAppAssetCategory 的六个合法值，version 与 all 等栏目伪值在提交前失败关闭 target_category 刻意不进 standalone 指纹与 durable 请求快照，分类只影响本地 manifest 落点，避免在途账本换槽重复 POST，同任务幂等恢复由调用方继续用同一栏目提交 补用例：kind=image 带 targetCategory=character 落到 character 而不是 unclassified、非法栏目值不产生生成请求、登记入口的显式分类与不传时的原 kind 派生行为	2026-09-17 18:58:53 +08:00
suzmii	d222aad2ec	参考素材改为提交前预检并补参考链路用例 ... 参考解析前增加纯本地预检：清单归属、受控路径与文件、媒体类型、可解码位图全部通过后才允许产生任何上传副作用，避免第一张参考已上传、第二张坏图才失败 明确拒绝 SVG 等矢量参考，媒体类型或文件扩展名任一命中即拒，本次不做矢量转换，坏图同样在本地失败关闭 asset.upload 门禁提前到预检阶段，显式拒绝该命令的项目连第一个上传凭证都不会签发 预检与实际上传共用同一份本地判据 helper，不新建平行流程，上传侧仍按同一判据重新读取与解码 补参考合同与恢复的账本用例：icon-spec 带用户参考、game-background 规范图加用户参考、图集超限、空白引用写入失败 补提交侧用例：拒绝路径、未登记、非图片、缺失文件、超限、SVG 与坏图，并断言零上传凭证与零生成 POST，反向验证同一张合格参考单独提交确实会签发凭证 补 asset.upload 拒绝用例，以及清单校验与 Direct 身份校验接受用户参考、拒绝用户参考顶替规范引用的覆盖	2026-09-17 18:28:19 +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
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	d23c808376	新建 UI 设计资源复用无冲突编号规则 ... - ui_editor/resource_bridge.rs：`next_ui_design_path` 提升为 `pub(crate)` 并补注释，作为两个写入侧唯一的「UI 设计 N」命名规则。 - commands.rs：`create_ui_design_resource` 不再按已登记文档数直接取名，改为复用该规则，resourceId 与文件名同一编号。 - tests/project.rs：新增已存在 `ui/UI 设计 1.json` 时仍能创建并落到编号 2 的回归用例。	2026-09-16 23:24:15 +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	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	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
lhk229	262deaf9b7	接入做成游戏后的策划文档指令 (#383) ... ## 变更说明 点击策划阶段的“做成游戏”后，切换到 GameAgent 并自动发送读取 `design_artifacts/` 文档的指令。 ## 验证 - npm run typecheck - git diff --check - 提交钩子 ESLint / Prettier Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/383	2026-09-16 16:51:37 +08:00
kdletters	c36a5170f8	AGC 新增本地自定义 LLM 配置与展示模型勾选 ... - 本地配置新增 llm.customEnabled 与 llm.visibleModels，显式开启后保留自定义连接和勾选列表，官方路由下仍清空凭据 - 配置迁移始终写出 customEnabled、visibleModels、apiKey、baseUrl、model、apiKind、reasoningEffort，便于手写自定义连接 - 新增 discover_game_creator_llm_models 命令，直连自定义端点 GET /models，限制超时与响应大小并脱敏错误 - codex_app_server 自定义模式改用配置里的地址与 Key 走本地凭据代理，不再经过平台 /api/llm，也不回退官方路由 - 模型目录按官方与自定义来源隔离缓存，自定义模式只展示勾选模型，选项失效时回退第一项 - 设置页在自定义模式展示 API 地址、API Key、协议与推理档，并提供模型读取、搜索、勾选与已勾选预览 - 补齐固定项排版与读取按钮样式，同步 AGC 模型选择规范、实施计划与共享概览	2026-09-16 16:39:15 +08:00
kdletters	dd24690b02	新增图集连通域与可配置网格切分 ... 增加 connected-components 与 grid 切分模式 支持 gridX/gridY 并同步 API、MCP、Skill、AGC 客户端 移除固定 2x2 图集切分契约与文档	2026-09-15 20:06:36 +08:00
kdletters	33369f1180	修复生图资产实时刷新 ... 兼容 Windows 普通、verbatim 与 UNC 项目路径的失效事件匹配 让普通生图成功后立即发送 manifest 刷新通知 补充资源卡片与桥接通知回归测试	2026-09-15 10:37:47 +08:00
lhk229	9aa6f5efea	解决platform-llm和策划agent reasoning问题，并修复若干bug (#350) ... Reviewed-on: #350	2026-09-15 00:50:36 +08:00
k88936	b7e3dac661	统一引用 UI 文档资产类型常量 ... 前端入口、资源桥接与引用预览统一使用共享常量 Rust 持久化与测试复用共享契约常量 补齐 UI 编辑器入口 fixture 的新资产类型	2026-09-14 21:36:43 +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	818cfdba50	收敛项目客户端占用锁语义 (#344) ... 本 PR 收敛项目锁的同进程重入语义，避免客户端内部调用等待自身持有的 `.agent/project.lock`。 变更： - 同进程嵌套项目锁返回 advisory guard，不删除真实持有者锁。 - 跨进程占用、残留回收和权限分类保持不变。 - 增加回归测试与锁收敛里程碑/实施计划文档。 验证： - 定向 Rust 锁测试通过。 - Runner owner 定向测试通过。 - cargo fmt --check 通过。 - npm run check:encoding 通过。 - git diff --check 通过。 后续里程碑：Runner 的 `.agent/runtime/execution-owner.lock` 迁移到统一项目占用锁仍需单独完成跨进程生命周期验证。 Reviewed-on: #344	2026-09-14 13:56:23 +08:00
lhk229	a7fa8e103a	修复策划产物归类为文档 ... 将策划产物注册 kind 从 design-document 调整为 document 同步更新项目工具测试夹具	2026-09-14 03:57:20 +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
suzmii	55fab1776a	AGC 画布验收问题修复与栏目画布底部工具栏 ... - 合并资源画布命名筛选与条件筛选为单一筛选浮层，Dock 只留放大镜入口 - 修复「编辑素材标签」面板标签多时不可见且不可滚：加高度上界与标签区独立滚动 - 替换素材新增点选替换模式，并在资源卡标注会话内替换血缘 - 新增栏目画布底部工具栏，按功能画布分流图片类生成、音频生成与上传入口 - 新增 Tauri IPC generate_local_project_asset，收口图片类无源生成的 kind 与提示词目录 - 同步 PRD、AGC 验收用例、决策日志、踩坑记录与待解决事项文档	2026-09-13 14:07:03 +08:00
suzmii	aa0fcc1d71	合并 master：修复 CI comparison base 门禁 ... - 合入 origin/master（b12a81e9c「修复 AGC 自主运行时测试目录权限与任务目录加固」），使 PR 头包含当前 master tip，门禁 Resolve comparison base 不再拦 - 冲突零：自动合并成功 - 验证：npm run typecheck exit 0；npm run check:rustfmt exit 0	2026-09-12 20:55:15 +08:00
kdletters	b12a81e9c2	修复 AGC 自主运行时测试目录权限与任务目录加固 ... 恢复 relaxed autonomous lane 的美术工具与写入门禁旁路 统一 Runtime 任务与事件目录的安全创建和校验 测试临时目录在 Windows 下初始化当前用户 owner	2026-09-12 20:31:43 +08:00
suzmii	daef9f6cc9	修复素材删除幂等、重命名 CAS 与 manifest 预览缓存一致性 ... 修复素材删除幂等、重命名 CAS 与 manifest 预览缓存一致性（PR #316 review） - assets.rs:2048-2049 [bug · medium] 已被修复：删除登记在「身份 + revision 两项 CAS 都已通过」后遇到素材已不在 manifest 时按 no-op 成功收敛并照常推进 revision，不再报「项目资源不存在」；新增 `asset_delete_retry_converges_when_only_the_revision_advance_failed` 复现「manifest 已提交、revision 未推进」并验证重试收敛（原「不存在的素材必须报错」断言相应改为幂等语义，前端只消费 assetId/committedProjectRevision）。 - assets.rs:2035-2042 [performance · low] 已被修复：引用集合只算一次并用 `HashSet<String>` 做成员判定，`retain` 不再是 O(V²)；版本守卫闭包按约定在写入前另行求值、拿不到该可变借用，故两次扫描保留并已在注释里说明。 - commands.rs:1032 [maintainability · medium] 已被修复：`RenameLocalProjectAssetInput` 补 `expectedProjectId` / `expectedProjectRevision`，`rename_local_project_asset_at` 与删除/分类更新同口径做两段身份复核 + revision CAS，失败时磁盘、manifest、revision 全不动；新增 CAS 用例（陈旧 revision / 跨项目身份 / 空身份）。注意：前端 `confirmResourceRename` 必须同时补传这两个字段（TS 侧由前端 owner 落地）。 - asset_rename.rs:84 [bug · low] 已被修复：新增 `asset_frame_directory_matches`，目录段在 Windows/macOS 按大小写不敏感比较（Linux 保持敏感），与文件名比较同口径；新增 `Assets/hero.png` 帧对齐用例。 - asset_rename.rs:249-250 [bug · medium] 已被修复：revision 推进失败改为报 `reconciliation-required: 素材已改名…且 manifest 已落盘，但项目 revision 未能推进`，明确这是「已提交但对账未完成」而非普通失败；同时新增的 CAS 使后续命令必须按新 revision 重试，重试会命中同名 no-op 分支收敛。 - tests/asset_rename.rs:257-263 [maintainability · medium] 已被修复：删除 `RenameLocalProjectAssetFaultStage` 枚举与生产签名上的 `fault` 参数，故障注入改用 `#[cfg(test)]` 的 `.agent/runtime/test-fail-next-asset-rename-manifest-write` 标记文件（与 agent_db 既有约定一致），生产 API 面不再能被推上「只回滚、不写 manifest」的路径。 - manifest.rs:1386 [bug · medium] 已被修复：预览缓存失效点下沉到唯一的装盘公共体 `write_manifest_locked_with_version_guard`（install 成功后立即失效，含安装后回读不一致的失败路径），`mutate_manifest_at_allowing_version_removals` 与绑定改写通道一并覆盖；`write_manifest_with_lock_hook` 里的重复调用已移除。 - manifest.rs:1480-1482 [bug · medium] 已被修复：填充侧改为「先取身份快照 → 读取 → 复核快照一致才入缓存」，不再可能出现「旧内容 + 新文件身份」的缓存条目。 - manifest.rs:1135 [security · low] 已被修复：新增 `normalize_manifest_asset_tags`，在共享归一化之后按数量（16）与单标签长度（32 字符）失败关闭；超长标签不截断，避免与共享标签库静默分叉。 - manifest.rs:1180-1181 [bug · medium] 已被修复：审计改为幂等——前后分类与标签完全相同时不追加记录，重试不会再写出 `previousCategory == category` 的假变更审计（保留「manifest 落盘后、推进 revision 前追加」这一既有位置约定）。 - manifest.rs:1140 [maintainability · low] 已被修复：分类写入的项目写锁标签由 `asset.register` 改为 `asset.classification.update`，争用诊断不再误报成素材登记。 - 测试：新增 preview_cache_tests（命中/TOCTOU 不入缓存/身份漂移丢弃/主写入通道显式失效）、分类重复写入不留假审计、标签上下界拒绝；7 条变异验证全部 CAUGHT。	2026-09-12 20:20:12 +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