lhk229
27e385785f
Project CI / AI game creator shell Rust lane 1/2 (push) Has been cancelled
Project CI / AI game creator shell Rust lane 2/2 (push) Has been cancelled
Project CI / AI game creator shell Rust crates (push) Has been cancelled
Project CI / Backend tests (push) Has been cancelled
Project CI / Native shell tests (push) Has been cancelled
Project CI / Frontend tests (push) Has been cancelled
Project CI / Repository checks (push) Has been cancelled
Project CI / AI game creator shell web tests (push) Has been cancelled
修正美术包 API 指南、AGC 调用与切片用途判定 (#628)
AGC 美术包此前把内容、风格和排布要求放在未被提示词消费的元数据中，并要求恰好四张切片、按返回顺序分配用途。本 PR 完成以下三项修正：
- [x] API 文档：修正整个 `generationInputs` 的定位、保存与读取方式、接口保留/重建规则及已知消费者。任意元数据不会自动进入提示词，服务端行为和校验约束保持不变。
- [x] AGC 请求：美术包将原 brief 和内容、风格、排布要求写入实际消费的 `iconDescriptions`；普通图标入口继续原文单项透传。参考图、比例和尺寸使用正式参数，同步工具说明与随包 skill。
- [x] 客户端切片处理：美术包和直接生图工具不再暴露或发送 `sliceCount`，取消固定四片和按序赋义；按实际产物保存、登记和返回。切片目录按源图集隔离，文件名使用中性序号，普通清单指向真实总图。
四类素材需求只表达内容覆盖，不能证明四个连通区域或固定语义顺序。两个工具返回总图、完整切片路径及资源身份，预览逐项标注路径，未内嵌的图片列出路径供 Agent 查看。Agent 看图识别实体、状态和用途后再接入或处理；有效总图零切片时仍交付并保留告警。
本轮切片改造仅限客户端：服务端 API、请求侧 sliceCount 契约、切分算法和计费行为不变。不新增为数量不符找回、补切或凑数的工作流。保留文件完整性、平台身份、资源预算、事务与重生成恢复；兼容历史四用途产物和旧数量参数账本，旧请求正文、幂等键及 operation 不改写，候选身份不唯一时要求对账。完成结果快照补存切分声明，避免重放丢失响应字段。
验证：
- API 文档阶段：MCP 25 项、External editor API 30 项测试及 OpenAPI 约束等价检查通过。
- 本轮：317 项定向 Rust 测试通过（生成 118、Direct 运行时 93、工具桥 44、MCP 32、账本 6、提示词 24）。覆盖新请求完全省略字段、0/2/4/6 片、目录隔离、完整资源投影、动态事务回滚、旧请求和旧输出槽恢复；已受理任务恢复不新增生成 POST。
- cargo check、rustfmt、skill-pack:check、文档索引、变更文件编码及 git diff --check 通过。
- 未调用真实付费 Provider，未做客户端视觉试玩；PR 保持草稿，等待视觉及产品验收。
Closes #525
Reviewed-on: #628
Co-authored-by: Linghong <ink29535@proton.me>
Co-committed-by: Linghong <ink29535@proton.me>
2026-10-07 19:35:20 +08:00
..
2026-10-04 17:14:26 +08:00
2026-10-03 17:42:50 +08:00
2026-07-12 19:32:11 +08:00
2026-09-28 14:16:11 +08:00
2026-09-23 13:30:13 +08:00
2026-06-23 21:02:13 +08:00
2026-09-29 22:39:41 +08:00
2026-08-08 11:11:25 +08:00
2026-09-16 01:06:34 +08:00
2026-09-13 17:11:06 +08:00
2026-08-08 15:10:16 +08:00
2026-09-03 20:02:48 +08:00
2026-10-04 13:25:58 +08:00
2026-09-03 10:02:05 +08:00
2026-09-17 00:54:28 +08:00
2026-09-03 15:33:26 +08:00
2026-09-23 11:46:39 +08:00
2026-09-23 02:52:01 +00:00
2026-09-01 16:28:34 +08:00
2026-09-30 16:39:45 +08:00
2026-10-03 15:40:21 +08:00
2026-10-02 14:06:05 +08:00
2026-09-03 11:38:40 +08:00
2026-10-05 17:53:51 +08:00
2026-09-13 16:21:34 +08:00
2026-09-20 10:53:16 +08:00
2026-09-21 17:25:34 +08:00
2026-09-20 17:38:48 +08:00
2026-10-04 13:28:37 +08:00
2026-09-28 14:16:11 +08:00
2026-10-04 11:45:20 +08:00
2026-09-22 17:59:57 +08:00
2026-09-17 21:37:23 +08:00
2026-09-28 14:16:11 +08:00
2026-09-11 20:24:41 +08:00
2026-09-24 13:01:31 +08:00
2026-10-06 14:32:16 +08:00
2026-09-30 20:24:23 +08:00
2026-10-07 14:01:43 +08:00
2026-10-07 19:35:20 +08:00
2026-10-02 17:54:15 +08:00
2026-09-13 14:48:55 +08:00
2026-09-30 13:35:14 +08:00
2026-09-30 10:25:38 +08:00
2026-09-27 18:39:01 +08:00
2026-10-06 13:39:02 +08:00
2026-09-12 18:56:43 +08:00
2026-09-06 00:36:31 +08:00
2026-09-13 14:48:55 +08:00
2026-09-12 16:33:33 +08:00
2026-09-24 18:16:34 +08:00
2026-09-04 16:30:43 +08:00
2026-09-24 18:16:34 +08:00
2026-08-20 19:07:25 +08:00
2026-09-11 17:33:26 +08:00
2026-10-05 22:05:11 +08:00
2026-09-13 16:21:34 +08:00
2026-09-24 17:19:45 +08:00
2026-09-24 13:01:31 +08:00
2026-06-14 19:34:44 +08:00
2026-09-24 13:01:31 +08:00
2026-09-29 10:37:20 +01:00
2026-09-24 13:01:31 +08:00
2026-10-03 16:48:12 +08:00
2026-10-05 15:51:07 +08:00
2026-09-20 18:52:59 +08:00
2026-09-13 16:21:34 +08:00
2026-09-13 16:21:34 +08:00
2026-10-04 17:14:26 +08:00
2026-09-28 14:16:11 +08:00
2026-09-03 19:36:18 +08:00
2026-09-23 13:30:13 +08:00
2026-09-13 16:21:34 +08:00
2026-09-23 00:09:12 +08:00