2202 Commits

Author	SHA1	Message	Date
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	7edc452c6a	重构AGC资源画布菜单与卡片入口（#409） ... 主菜单保留前五项，其余操作通过向上展开的更多菜单访问 类型与信息入口下沉资源卡片，并复用共享画布角标 补充菜单键盘、滚轮归属、换选及资源操作链路回归 同步方案A规范与待人工验收记录	2026-09-17 18:09:27 +08:00
kdletters	5e4ff54a9d	删除模板工程内置的嵌套 package-lock ... - 模板 fixture 内的 package-lock.json 触发 workspace 守卫的「禁止嵌套 lockfile」规则，导致 master 门禁失败 - 其余五个模板都只提交 project 内容与 package.json，删除该文件与它们保持一致 - 模板 zip 由发布脚本现场打包并重新计算大小与哈希，仓库内没有引用该 lock 的脚本或测试	2026-09-17 18:04:21 +08:00
kdletters	1f5b7b250a	修正首页推荐位用例断言到模板库 ... - 首页「灵感推荐」已被模板库推荐位替换，用例改为断言模板库推荐卡片、已下载徽标与共 N 个模板计数 - 用例改为断言点击推荐位进入模板库页面，且不触发下载或由模板创建项目 - 保留不请求已退役展示流接口的断言	2026-09-17 18:03:15 +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
kdletters	a5fd25f10a	客户端更新切换到官方更新插件并按渠道分发 ... - 客户端接入 tauri-plugin-updater：原生侧注册插件，删除自研更新下载命令、下载进度事件与安装器启动逻辑 - 客户端更新服务与更新提示改走官方插件接口，删除自研清单解析、版本比较与下载实现 - 更新能力只授予客户端主窗口，移除只为自研清单放行的 OSS 白名单与 CSP 连接项 - 新增构建期更新检查开关：开发态默认关闭，agc 启动不请求更新清单、不显示更新入口 - 发布脚本按渠道生成官方更新插件清单与签名，universal macOS 产物同时挂两个平台键，缺签名失败关闭 - 发布脚本按渠道上传安装包、签名与渠道清单，并为 dev-win 生成旧协议 sha256 迁移清单 - 构建期按渠道注入更新端点配置，渠道与目标平台不匹配时发布失败关闭 - Jenkins 流水线新增渠道参数与签名凭据注入，归档补充签名与迁移清单 - 新增发布上传 dry-run 开关，只打印 ossutil 命令且不回显凭据 - 更新技术方案与开发运维文档，登记 macOS 渠道落地待办	2026-09-17 17:56:53 +08:00
kdletters	5db407c3dc	新增 AGC 模板库与由模板创建项目链路 (#396) ... ## 交付范围 - OSS `agc-dev` bucket 的 `templates/` 前缀作为 AGC 游戏模板库（**去掉 `agc/` 这一层**；`agc/` 继续只放客户端安装包与更新清单）。 - 模板正文改为 zip（zip 根 == AGC 项目根，如 `game/index.html`）；清单补齐 `tags`、封面字段与包大小/摘要，`templateVersion` 用于判断是否需要重下。 - 客户端：Rust 模板库模块、模板库全屏页、首页模板推荐位、左侧导航入口。 ## 客户端行为 - `fetch_game_template_library`：读取并校验清单（≤4 MiB），缓存到 `<app_data>/templates/index.json`；网络失败回退本机缓存并标注 `source=cache`。 - `download_game_template`：按清单下载 zip（≤512 MiB），校验字节数与 SHA-256 后解压到 `<app_data>/templates/installed/<id>/<version>/`，最后写 `installed.json` 作为安装完成标记。 - `create_automatic_local_game_project_from_template`：先把模板文件铺进新项目目录，再走既有 `init_local_game_project_at` 补 `.agent` 清单与标准目录；失败删除半成品目录。 - 解压只接受普通文件与目录（拒绝绝对路径、`..`、盘符、符号链接），安装目录名由标识符白名单拼出；远端只信「受信任 OSS 主机 + 对象键」，清单里的地址字段不参与请求。 - UI：搜索（空白分隔多关键词「与」）、标签/运行时筛选、仅看已下载、封面卡片与已下载徽标；「使用模板」在版本落后时先重下再建项。 ## 文档与脚本 - 主规范 `docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md`；里程碑与实施计划见 `docs/project-memory/plans/`；`decision-log.md` 记录库路径、清单 schema、安装缓存目录与 CSP 约定。 - 发布脚本 `scripts/agc-template-library-publish.mjs`（`--dry-run` 校验 → 上传 → 回读校验）。 - 首页「灵感推荐」替换为模板库推荐位，删除本机灵感图目录与 `InspirationGallery.tsx`；`tauri.conf.json` 的 `img-src` 放行受信任 OSS 主机用于加载封面。 ## 验证 - `cargo test --bin genarrative-ai-game-creator-shell template_library`：9 passed；`--ignored` 真连检查 `fetches_the_live_template_library_index` 通过。 - `npx vitest run src/features/template-library`：9 passed。 - `npm run typecheck`、`cargo fmt --check`、`npm run check:encoding`、`node scripts/check-doc-index.mjs`、`git diff --check` 均通过。 - OSS 侧匿名复核：`templates/index.json`、各 `cover.png` 与 `template.zip` 均返回 200。 ## 未做 / 待确认 - 本轮未做客户端点击级人工验收（下一步单独验证并把结果补进此 PR）。 - 模板封面目前是占位标题卡，正式封面由后续模板包提供。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/396	2026-09-17 17:48:06 +08:00
suzmii	0a1f0e0b26	画布布局收口：整理只动当前栏目、多选拖动一笔提交与一次撤销 ... - 整理画布重排目标栏目内全部素材（含手动坐标与被筛选隐藏的卡），「所有资源」页覆盖全部栏目 - 栏外坐标逐值保留：不再把其他栏目的自动坐标丢给重算，避免被顺带规整成规范槽位 - 手动标记纳入历史快照与相等判定，撤销整理恢复原坐标与原手动标记 - 新增批量坐标写入入口：多选拖动与撤销都只排一笔 CAS、只压一条历史 - 多选拖动按同一位移整批跟随，取消 / 捕获丢失 / 失焦回滚，切项目丢弃进行中的位移 - 补测试：栏外自动坐标保留、all 页整理范围、批量撤销与取消边界	2026-09-17 17:47:11 +08:00
suzmii	5c31ae91ca	返修资源卡完整名悬停入口并收短文档卡注释 ... - 完整资源名改挂在覆盖整卡、真正命中指针的选中按钮 title 上，名称条自身不再挂悬停不到的 title - 无障碍名保持原有 aria-label 不变，长名仍是 CSS 单行省略 - 断言改为校验选中按钮 title，并钉住名称条不挂 title - 文档卡分支注释只写当前行为，去掉旧实现说明	2026-09-17 17:37:48 +08:00
suzmii	2628b83d4b	画布资源卡统一显示正式资源名并简化文档卡卡面 ... - 资源卡新增卡面名称条，所有类型卡统一显示正式资源 label，长名单行省略、完整名进 title - 文档卡卡面改为居中图标，不再把正文前几行铺在卡面上，正文只在独立详情浮层读取 - 删除卡面正文摘要的取文本 helper 与行数/长度常量，移除对应 CSS 规则不留墓碑 - 名称条按媒体卡让出右下播放钮位置，替换血缘角标上移避免遮住名称 - 新增资源卡名称与文档卡卡面用例，并同步重命名链路与卡面正文的既有断言	2026-09-17 17:08:42 +08:00
lhk229	de9e8e0c7f	修复运行时默认重试次数的测试断言 ... 将恢复默认配置的重试次数断言同步为10。 补充默认配置变更时的测试核对规则。	2026-09-17 17:03:45 +08:00
suzmii	a7b2b0e23b	画布图片生成支持真实参考图引用 ... 新增参考图模型：候选为当前项目已登记图片，用户参考上限普通生成 5 张、带规范前置 4 张、图集为 0 生成浮层复用资源引用输入组件，提示词里的 @ 引用直接产出当前 manifest 资产 ID 作为参考 生成任务与队列新增 referenceAssetIds，派发时以 referenceAssetIds 交给原生侧解析账号绑定 图集入口不呈现参考选择器，超限在提交前给出原因并挡住提交，不做静默截断 补充参考模型、面板接线与队列派发的定向测试	2026-09-17 16:59:49 +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
lhk229	c958e1955b	Merge branch 'master' into opt/design-llm-call	2026-09-17 16:26:16 +08:00
lhk229	1b579acf47	提高客户端LLM默认重试次数到10 ... 内置默认值 DEFAULT_GAME_CREATOR_LLM_MAX_RETRIES 由 2 改为 10 随App分发的配置模板 game-creator.config.json 的 maxRetries 同步为 10 设置对话框草稿兜底值 maxRetries 同步为 10	2026-09-17 08:22:52 +00:00
k88936	20b34918d3	UI 编辑器桥接用例改回真实成功路径 ... - apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts：`ensure_ui_design_resource_for_prototype` 的 mock 从返回 `null` 改为返回真实形状的桥接结果（asset + manifest + committedProjectRevision + created），并新增 `data-resource-view-state === 'resources.ui-editor'` 断言，让用例真的覆盖它名字里的成功路径而不是被组件吞进错误分支。	2026-09-17 16:19:38 +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	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	1b56c0a586	Merge remote-tracking branch 'origin/master' into fix/effort-panel-overlay ... # Conflicts: # docs/project-memory/shared-memory/pitfalls.md	2026-09-17 15:56:56 +08:00
k88936	efdb364a52	修复推理档弹层被裁剪问题，增加 CSS 覆盖声明以确保窄布局下弹层完整显示。	2026-09-17 15:54:07 +08:00
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	a86ead93e4	资源登记草稿的推断 kind 收敛到 canonical 词汇 ... - projectArtifactSummaries.ts：inferProjectFileAssetDraft 的 json 分支由 data 改为 document、判不出扩展名时由 asset 改为 unknown，与 Rust 侧 uploaded_asset_kind 同口径——/asset-register 的 kind 会原样进 register_local_asset 的严格解析，写非 canonical 值只会被判成认不出并留痕。	2026-09-17 15:46:34 +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	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
k88936	6782d0ea23	GameCreationApp 资源 kind 词汇表收敛为 Rust 单源并接上可注册留痕回调 ... - asset_kind.rs：新增声明宏，由一张 kind 表派生出枚举、线上值 as_str、ALL、严格解析与 ts-rs 绑定，仓库里不再有第二份 kind 列表。 - asset_kind.rs：from_str_lossy 改名 from_str_or_unknown 并去掉 trim / lowercase 归一，parse_with_context 只做严格等值匹配，认不出的原值不查别名、不迁移。 - asset_kind.rs：留痕改为可注册回调 set_non_canonical_asset_kind_reporter，把原始串与调用上下文交给壳层日志，未注册时静默。 - game_creation_app.rs：删除手写 GAME_CREATION_APP_CANONICAL_ASSET_KINDS 与 canonical_game_creation_app_asset_kind 别名表（含 font → document 特例），分类映射表按枚举成员穷举。 - shared-contracts/Cargo.toml：删除 kind-observability feature 与 tracing 依赖，留痕不再靠 tracing。 - api-server/editor_project.rs：图片编辑白名单注释改成「API 兼容面」，不再自称 kind 别名表。	2026-09-17 15:43:51 +08:00
lhk229	ebc5dfe7db	修复策划工具乱序局部修改导致的中断 (#399) ... 按原文位置排序并顺序拼接补丁，避免替换偏移失效。 新增乱序、中文与长度变化的局部修改回归测试。 同步策划 Agent 批量局部修改技术说明。 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/399	2026-09-17 14:58:21 +08:00
kdletters	cd9faae9b2	修复 agc_tools 媒体资源提示词上限并按 kind 暴露 (#398) ... ## 改动 - 提示词上限收敛为 `resource_edit_prompt_max_chars` 单一权威：`agc_tools` MCP 工具层、客户端受控工具桥与提交校验共用同一数字与拒绝文案，不再出现「schema 写 4000、真实上限按 kind 分」的分叉。 - `agc_create_or_derive_resource` 的 schema 逐 kind 声明 `prompt.maxLength`（background-music / sound-effect / video 与 character-animation），`prompt` 描述写明每个数字；`agc_edit_image` 继续用图片口径 32000。 - 工具桥不再用通用 4000 校验 prompt：图片编辑 4000~32000 的提示词不再被误报成「超出安全边界」。 - 源资源未登记时的错误文案补上可执行两步：先用 `agc_list_registered_assets` 选已有 localAssetId；只在项目里的文件先 `agc_list_project_files` 确认 `assetImportable=true`，再用 `agc_import_account_assets.localPaths` 登记后重试。`agc_remove_background` 复用同一条文案。 - skill 包 `agc-client-projection` 的 SKILL.md 与 projection-contract.md 写明四个上限，并说明超限要在本地收敛而不是原样重发；清单指纹同步到 `2026-08-26.18`（已合并 master 的抠图文案）。 - 前端 `resourceEditModel.ts` 补注释指向 Rust 权威函数，数字未动。 - decision-log、pitfalls 与《AI游戏创作智能体App实施计划》记录本轮口径；未改 External v1 契约 / OpenAPI、SpacetimeDB schema 与客户端 UI 行为。 ## 问题 | 编号 | 问题 | 本 PR 状态 | | --- | --- | --- | | P1 | 背景音乐提示词真实上限 140，但 schema 只写 4000、skill 未写明，agent 写一句正常长度描述必被硬拒 | 已修复：口径单源 + 逐 kind 暴露 + skill 写明 | | P2 | 音效 1900 与图片编辑 32000 的上限只在 Rust 内部生效，MCP 与工具桥各自硬编码或误报 | 已修复：三处共用同一函数，图片编辑不再误报安全边界 | | P3 | 源资源未登记时只报「不属于当前项目已登记资源」，模型会原地重试 | 已修复：文案给出 `agc_list_registered_assets` 与登记工具两步动作 | | P4 | 这两个工具此前没有端到端用例，同类漂移无法被门禁拦住 | 已补：MCP 工具层 → 真实工具桥 → 假平台的契约用例 + 两条按 kind 上限门禁 | ## 验证 - `agent::direct_tools_mcp::tests` 23 passed / 0 failed：含新增的按 kind 上限门禁、图片快速编辑契约（断言 `POST /api/editor/images/edits` 的路径、Bearer、Idempotency-Key、正文且不得回填 assetKind）、背景音乐契约（断言 `POST /api/editor/audios/background-music/generations` 的 `gptDescriptionPrompt` 与 `makeInstrumental`）、超限零桥请求、未登记源资源提示。 - `agent::direct_tool_bridge::tests` 18 passed / 7 failed；`agent::skill_pack` 4 passed；`npm run agc:skill-pack:check` 与 `skill-pack:test` 通过（version `2026-08-26.18`）。 - AGC `typecheck`（tsc + skill-pack check + check-config）、`resourceEditModel` 6 项前端测试、`npm run check:encoding`、`npm run check:doc-index`、`cargo fmt --check`、`git diff --check` 通过。 - 那 7 条（以及 `project::resource_editor` 45 条）失败与本 PR 无关：全部是 `tempfile::tempdir()` 的 `Windows 安全对象不属于当前用户`，已 stash 改动并用基线复跑确认失败集合一致。 - 未跑整包 AGC Rust 全量分片、`npm run lint` 聚合门禁与 CI；未做任何付费生成。工具 schema 与 skill 文案都在应用内，终端用户需重新构建客户端才能看到修复效果。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: #398	2026-09-17 14:56:56 +08:00
suzmii	036395c6c9	修复历史重读后旧消息追加到末尾的乱序 ... 区分历史回读与实时消息来源，保留运行时所有权语义 防止旧页消息在历史刷新后追加到最新回复末尾 增加重新读取历史后再次翻页的顺序和去重回归 同步对话历史规范与实施计划	2026-09-17 13:54:00 +08:00
k88936	e6092dda6f	Merge remote-tracking branch 'origin/master' into feat/agc-organize-assetkind ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-09-17 13:52:45 +08:00
k88936	5f13698129	asset.list 的 kind 过滤改为拒绝非 canonical 值 ... - direct_tool_bridge.rs：`kind` 收口后既不是 canonical、也不是字面 `unknown` 时直接返回工具错误并带上原值，不再静默过滤出空列表。 - direct_tool_bridge.rs：新增用例，钉住"项目访问前就报错"与"字面 `unknown` 仍是合法过滤值"。 - direct_tools_mcp.rs：schema 描述改为必须是 canonical kind、非 canonical 值会被拒绝。	2026-09-17 13:42:22 +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	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
suzmii	d1f53fda4d	Merge branch 'master' into fix/agc-canvas-json	2026-09-17 13:05:33 +08:00
lhk229	a68a9621a7	修复前端测试状态泄漏与异步断言竞态 ... 隔离创作主页换签网络请求并使用独立响应 恢复快捷键选择状态、持久化路由和UI编辑页宿主mock 修正虚拟树尺寸与选择时序并纳入换签Hook测试 记录全量与随机顺序测试验证方式	2026-09-17 11:56:17 +08:00
suzmii	9d374a57b1	修正运行不可用提示的过期测试契约 ... 恢复运行提示与资源选择解耦的业务逻辑 更新界面源码契约测试，保留资源选中交互回归 补充运行提示及无障碍关联的验收口径	2026-09-17 11:51:14 +08:00
suzmii	7f9dce5f79	修复画布运行不可用提示契约 ... 恢复资源选中状态下运行提示的正确显示条件 使源码契约测试与实际行为保持一致	2026-09-17 09:48:19 +08:00
lhk229	9beb16f203	稳定CI测试并发与工作流 (#393) ... 为Project CI增加同分支并发取消，避免旧运行覆盖新结果 将Vitest默认线程数固定为1，降低异步UI测试竞态 Reviewed-on: #393 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-17 09:18:39 +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	13f56e644d	补充抠图模式调用说明 ... 说明complex语义分割与flat纯色背景抠图 明确纯色背景优先使用flat并移除内部实现术语	2026-09-17 00:54:28 +08:00
lhk229	e08b031761	调整抠图模式参数说明	2026-09-17 00:54:28 +08:00
lhk229	70ad794b28	扩展AGC抠图客户端参数 ... 支持complex与flat模式及auto背景色 保留旧客户端参数调用兼容性	2026-09-17 00:54:28 +08:00
k88936	56c4faa8ee	清理项目视觉资产判断里已不可达的旧 kind 字面量 ... - projectAssetSummaries.ts：`isProjectVisualAsset` 去掉 `sprite` / `ui` / `background` 三个旧 kind 判断。 - 理由：manifest kind 由 Rust 枚举序列化，只会是 canonical 成员或 `unknown`，这三个旧字面量在 TS 侧永远无法命中；图像与视频资产仍由 mediaType 分支覆盖。	2026-09-16 23:31:01 +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	41930b858e	修正陶泥儿运行态图片筛选残留的旧 kind 字面量 ... - direct_runtime/mod.rs：`direct_game_sources_referenced_taonier_assets` 的 manifest 兜底由 `art-spritesheet | art-spritesheet-slice | game-background` 改为 `IconSpritesheet | Icon | Scene`，恢复对项目自定义图集与背景的收录。 - direct_runtime/mod.rs：同处与 `direct_registered_taonier_runtime_image_paths` 的「切片不得绕过严格校验」排除条件改用 `GameCreationAppAssetKind::Icon`，并顺手把 `icon-spec` 比较改为枚举成员。 - 理由：kind 收紧为枚举后 `as_str()` 只会返回 canonical 名，旧字面量恒不命中，兜底筛选与切片排除同时失效。	2026-09-16 23:13:21 +08:00
k88936	9dccf5318e	UI 原型 kind 判断改用共享常量 ... - uiDesignResourceBridge.ts：原型 kind 比较由裸字符串 `'ui-design'` 改为 `GAME_CREATION_APP_UI_DESIGN_ASSET_KIND`，与 manifest kind 契约保持同一处定义。	2026-09-16 23:10:59 +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	d454d3fa4b	修正 asset.list 工具示例 kind 到 canonical 词汇 ... - direct_tools_mcp.rs：`agc_list_registered_assets` 的 kind 过滤示例把旧值 `art-spritesheet-slice` 换成 canonical 的 `icon-spritesheet`。 - 理由：manifest kind 收紧为枚举后，旧值在过滤前已收口为 `unknown`，按示例传参只会得到空结果。	2026-09-16 23:03:44 +08:00
k88936	a5ee45aa4e	构建脚本依赖不再打开 shared-contracts 的 ts-bindings ... - Cargo.toml：`[build-dependencies]` 的 shared-contracts 去掉 `features = ["ts-bindings"]`，只保留 `[dependencies]` 那份。 - build.rs 只用 `GameCreationAppAgentGroup` 与 `new_game_creation_app_seed_tasks`，不需要 ts-rs 导出，没必要让构建脚本图额外编译 ts-rs。	2026-09-16 23:01:51 +08:00
k88936	d333f783fe	修正资源 kind 解析边界对非字符串输入的日志 ... - assetKind.ts：非字符串输入不再走 `String(raw)` 字符串化，改为记录 `rawType` 并直接收口为 `unknown`。 - assetKind.test.ts：新增非字符串输入用例，钉住新的日志形状。	2026-09-16 23:00:42 +08:00