修复客户端图标素材生成丢失用户描述

删除图标生成的固定提示词包装、默认美术说明和两次截断按服务端单条描述语义校验非空及200个Unicode字符，超限拒绝并保留原文保留内部换行，直接以单条iconDescriptions提交用户描述更新前端、原生入口和实际HTTP请求回归测试同步工具说明、生成契约及项目排障文档
2026-09-21 17:57:49 +08:00
parent c5afc02e94
commit 2ea7f8283b
13 changed files with 212 additions and 123 deletions
@@ -1,5 +1,12 @@
 # 踩坑与排障记录

+## 客户端图标素材描述不能先包装再截断
+
+- 现象：资源画布填写了具体图标需求，平台实际收到的 `iconDescriptions` 却只包含泛化的小游戏美术指令，生成结果不遵循输入。
+- 原因：客户端先给用户描述套“Web 小游戏首版原型、核心美术素材”和默认 brief 模板，再把包装后的文本压入单项 `200` 字符；固定前缀已占满额度，用户描述在发给 API Server 之前就被丢弃。服务端校验只能看到被截短的文本，无法恢复原需求。
+- 处理：客户端画布图标生成只 trim 描述并以单项 `iconDescriptions` 原样提交，保留内部换行；面板与原生入口按 `200` 个 Unicode 码点校验并拒绝空白或超限输入，不静默截断、不机械拆条。服务端共用的提示词流程负责规范图、背景与排布要求；其它图片生成的 `32000` 字符上限保持不变。
+- 验证：检查实际请求体与 trim 后的原文一致，并覆盖 `200/201` 码点、补充平面字符、换行和空白输入；不能只断言“请求长度未超限”。完整合同见 [画板图标素材生成入口设计](../../【编辑器】画板图标素材生成入口设计-2026-06-15.md)。
+
 ## 发布器守卫拒绝时不要把 process.exit 用在 fetch 句柄未关闭处

 - 现象：`agc-template-library-publish.mjs --dry-run` 撞上「同一 `templateVersion` 的 ZIP 不得变」门禁时，终端只剩一句 `Assertion failed: !(handle->flags & UV_HANDLE_CLOSING), file src\win\async.c`，看不到任何拒绝原因，看起来像脚本崩溃而不是被拒绝。