GenarrativeAI/Genarrative
12
0
Fork 0
Code Issues 36 Pull Requests 7 Actions Packages Projects 1 Releases Wiki Activity

记录外部图片编辑字段原地升级决策

Browse Source 
确认 2026-08-08 线上仍无外部调用方
明确豁免 sourceImageSrc 到 sourceReferenceId 的 v1 breaking change
修正 provider 容量说明并增加旧字段文案回归
This commit is contained in:
王德宇
2026-08-08 15:47:26 +08:00
parent d7fe4137f4
commit 1f7f59ce66
4 changed files with 20 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/project-memory/shared-memory/decision-log.md
+8
View File
@@ -1,5 +1,13 @@
# 决策记录
## 2026-08-08 External v1 图片编辑来源字段允许原地收紧
- 背景：图片编辑主来源已经从可由客户端提交 objectKey 和类型提示的 `sourceImageSrc / sourceResourceId / assetKind`，收紧为服务端按项目资源 ID 或素材 ID 解析权威对象与类型的必填 `sourceReferenceId`。这会让严格 External v1 客户端立即失败，属于现役版本策略明确列出的 breaking change；2026-07-31 的历史豁免不能自动覆盖本次变更。
- 决策：产品负责人于 2026-08-08 根据当前线上 API Key 与调用方状态确认仍无外部调用方，明确允许本次继续使用 `/api/external/v1` 与 `info.version = 1.0.0` 原地替换字段，不保留兼容字段、不新开 `/api/external/v2`、不设弃用期。该豁免仅覆盖本次图片编辑来源字段替换，后续 breaking change 必须重新确认当日线上状态并形成新决策。
- 影响范围：`POST /api/external/v1/editor/images/edits` 只接受必填 `sourceReferenceId`；`sourceImageSrc / sourceResourceId / assetKind` 继续由 `additionalProperties: false` 拒绝。辅助 `referenceImageSrcs` 的 provider 容量说明按 `sourceReferenceId` 对应主来源原图计数。
- 验证方式：External OpenAPI 契约测试精确断言 `sourceReferenceId` 必填、三个旧字段不存在，并断言图片编辑辅助参考图说明只引用 `sourceReferenceId` 而不再引用 `sourceImageSrc`。
- 关联文档：`docs/【后端架构】外部OpenAPI与APIKey接入方案-2026-06-19.md`、`docs/openapi/genarrative-external-v1.openapi.json`。
## 2026-08-07 game-chat 使用单主路径按需补齐美术
- 背景：原 game-chat 把 Supervisor 的意图判断之后又硬接为 `design-director / code-director / art-* / code-prototype / preview-*` 固定图。`code-director` 代替程序主 Agent 判断素材缺口，会让“把现有美术资源应用到游戏中”被错误翻译成先生成美术，且美术回执无法天然回到同一个代码 Run 完成接入。