3D 落点契约文档同步为平坦可选字段

- 技术方案的请求契约段改成平坦可选 projectId / canvasCompletion / assetFolderId / assetLabel，并把「二选一 + 同现拒绝」的口径与落点预检路径写清。
- 里程碑与实施计划把 tagged enum 的表述改成平坦字段与二选一验收口径。
- 前端入口与 Worker 计划的落点表述去掉 target 分支写法，改为只发 projectId / 素材库落点产出 assetId。
- 决策记录补一条：撤销请求侧 tagged enum、复用统一定点预检、素材名缺省回落默认名，并记下未做的目录归一与原因。

docs/technical/【技术方案】Tripo 3D生成API集成-2026-09-21.md

@@ -51,14 +51,18 @@ source = { kind: "resource", resourceId } | { kind: "asset", assetId }
 
 引用解析分两步，提交与执行互不代替：**提交时只做元数据预检**——按 `source.kind` 的分支做定点归属校验，确认记录类型与对象键存在，不读图片正文、不调用 provider，因此跨 owner、未登记、已删除与 `kind` 不符的引用都在扣费与入队之前返回 400；跨 owner、未登记与已删除对外收敛成同一句不可用，不泄漏他人 ID 是否存在，`kind` 与解析结果不符则单独报错（两个值都由调用方给出，不涉及探测他人数据）；**worker 执行时重新确认同一事实**，通过后才读一次图片正文并上传换 `file_token`。预检只按主键定点查引用，不允许拉取当前用户的完整工程列表或素材库。
 
-**结果落点**（两个端点都必填）使用 tagged enum：
+**结果落点**（两个端点都必填）与其它生成接口同形，是平坦的可选字段，不用 tagged enum；客户端不必为“落项目还是落素材库”多拼一层判别结构：
 
 ```text
-target = { kind: "projectResource", projectId, canvasCompletion? }
-       | { kind: "assetLibrary", folderId, label }
+projectId?        项目资源落点
+assetFolderId?    素材库落点
+assetLabel?       素材名称，缺省用平台默认名
+canvasCompletion? 画布占位框回填，只在项目资源落点下生效
 ```
 
-`projectResource` 分支必须给 `projectId`，可选 `canvasCompletion` 表达画布占位框回填；`assetLibrary` 分支的 `folderId` 与 `label` 必填。不存在“都不给就默认落素材库”的口径。
+`projectId` 与 `assetFolderId` 二选一且只能给一个：两个都不给、两个都给都拒绝；`assetLabel` 只在素材库落点下有默认值，`canvasCompletion` 与 `assetFolderId` 同现拒绝。不存在“都不给就默认落素材库”的口径。
+
+落点预检与其它付费编辑器生成共用同一条路径：提交时调只读 `preflight_editor_generation_target_and_return`，按认证 owner 对给定的那个落点做定点归属校验（不再为了一个目录 ID 读整个素材库），跨 owner / 已删除 / 不存在收敛成同一句 400；预检传下去的就是 trim 后的原值，校验值与入队、落库的值逐字一致。`project` 与 owner 默认素材目录的归一由落库 procedure 负责，因此本期不做 API 层的 `folder-*` → 默认目录改写——那需要把归一值一路带进入队载荷，等真正打开素材库落点入口时再补。
 
 **定价相关参数在 API 层必填并做组合校验**：`texture`、`textureQuality`、`geometryQuality`、`quad`、`smartLowPoly`、`generateParts` 必须显式给出。`texture=false` 时禁止出现 `textureQuality`，且 `pbr` 必须显式 `false`；`texture=true` 时 `textureQuality` 必填。理由是 provider 的隐式默认值会直接改变价格，一旦依赖默认值，报价与扣费会在“调用方少传字段”时分叉。
 
@@ -193,7 +197,7 @@ width/height  = 预览图像素尺寸
 7. submit 成功但 checkpoint 写入失败的 attempt 终态失败且不自动重提。
 8. provider 成功但落库失败时 job 失败、该 attempt 退款，checkpoint 保留供对账。
 9. 完成结果按端点严格类型返回，只含模型与预览的正式资源引用，不含 provider task ID 与带签名的临时 URL。
-10. `assetLibrary` 分支产出 `assetId`；`projectResource` 分支产出 `resourceId`，且 `assetKind=model3d`、`AssetObject.content_type` 为按字节识别出的模型 mime、`content_length` 与实际对象一致。
+10. 素材库落点产出 `assetId`；项目资源落点产出 `resourceId`，且 `assetKind=model3d`、`AssetObject.content_type` 为按字节识别出的模型 mime、`content_length` 与实际对象一致。
 11. 客户端媒体投影对 `model3d` 只暴露预览图：`imageSrc` / `thumbnailSrc` 指向预览对象、`objectKey` 指向模型本体；预览缺失时才回落到模型对象，且该回落不得让图片入口加载模型文件。
 12. 格式判定的顺序在查看器包内可被用例钉住：声明 `Content-Type` 优先于字节魔数、字节魔数优先于地址扩展名；三者都判不出来时模态展示 `unsupported-format` 原因与支持的格式清单，画布侧不做任何格式判断、也不在 `assetKind` 为空时按扩展名兜底。
 13. 真实 Provider smoke 覆盖 text-to-model 与 image-to-model 各一次，下载字节数与 `Content-Length` 一致。