补充美术包工具的描述长度要求

在 Agent 可见的 brief 说明中明确 1 到 200 个 Unicode 字符及计数规则同步美术包技术文档，并关联输入契约后续改造 issue #660 保持 schema、请求组装、阶段校验与实际生成行为不变
2026-10-06 11:40:34 +01:00
parent 576d2709e0
commit 654e98fb01
2 changed files with 2 additions and 1 deletions
@@ -1596,6 +1596,7 @@ game-project/

 - 美术包核心图集的新请求必须把 brief 原文与客户端的素材内容、风格和排布要求共同写入 `iconDescriptions`。内容覆盖当前玩法需要的玩家主体及状态、目标或收集物、障碍或场景元素、反馈特效；各素材独立排布并留出切分间距，沿用规范图的轮廓、材质、色板与光照。描述条数和内容类别不代表切片数量或返回顺序。规范图通过 `referenceId`、比例和尺寸通过正式参数传入；透明结果由服务端纯色底生成与抠图提供，不向模型追加直接生成透明背景的要求。`generationInputs.artSpec` 仅保留描述性上下文，不能作为要求已进入生成提示词的证据。
 - Agent 在普通图集的 `prompt` 和美术包的 `brief` 中，需求明确时须列出各项素材的数量、状态及独立排布与留白要求；数量未确定时不编造。数量用于表达生成目标，不构成服务端切片数量保证，也不赋予返回顺序语义；生成后仍须看图确认实际切片内容与用途。工具参数说明与随包 skill 使用同一口径。
+- 美术包 `brief` 的 Agent 工具说明明确要求：去除首尾空白后整个 brief 为 1–200 个 Unicode 字符，标点与内部换行计入，调用前须精简至上限内，超限会在图集阶段被拒绝。本次仅补充说明，schema 的 4000 字符上限、请求组装、阶段校验和实际生成行为保持现状；删除旧 100 条描述输入方式并适当提高完整提示词字符上限的后续改造由 [issue #660](https://git.genarrative.world/git/GenarrativeAI/Genarrative/issues/660) 跟踪。
 - 美术包工具继续只接收 `brief` 与 `mode`，Agent 在 brief 中提供具体主题、风格、实体和反馈需求；客户端补齐通用要求。普通画布及 `agc_generate_image` 图标入口仍将 trim 后原文作为唯一描述项。美术包新增要求使用独立描述项并校验当前 API 的每条 200 字符、合计 2000 字符 / 6144 UTF-8 字节及 100 条上限，不挤占或截断原文；本次不扩展已有 brief 长度合同。只在没有冻结请求的新提交路径组装要求，已有 `prepared / accepted / legacy-completed` 请求按原请求体、幂等键与操作身份恢复，原 brief 的意图比较不受新增模板影响。验证必须覆盖实际 HTTP 请求、普通入口原文、描述边界及旧请求恢复，不以元数据或提示词文本存在代替传输证据。
 - 请求要求的自动化证据由 `art_package_spritesheet_posts_requirements_but_ordinary_icons_keep_original_text`、`art_package_spritesheet_recovers_old_requests_without_injecting_new_requirements` 与描述边界用例提供：生产生成入口经过本地 HTTP 夹具，核对真实 POST、原请求字节、幂等键及重复恢复零新增生成 POST。真实 Provider 的视觉效果不由请求夹具替代。
 - 标准美术包在客户端将规范图、背景图和主图集统一保存为 PNG：下载仍校验来源、声明类型与文件签名，随后按真实内容接受 PNG/JPEG/WebP，在已有 20 MiB、4096 像素单边和 64 MiB 解码内存限制内完整解码。有效 PNG 原样保留，JPEG/WebP 编码成 PNG，最终内容也不得超过 20 MiB；本地媒体类型固定为 `image/png`。转码不补造透明度，主图集与独立切片继续执行真实 alpha、可见像素、尺寸和唯一性合同；平台独立切片仍须为 PNG。此行为仅属于美术包，普通图片工具的指定扩展名合同不变。