66 Commits

Author	SHA1	Message	Date
k88936	79ae24fa43	3D 产物的 content type 与落库值同源 ... - server-rs/crates/api-server/src/tripo3d/storage.rs：返回给调用方的 content_type 改为优先取 HEAD 复核回来的值（取不到才回落到本地解析值），与 asset_object.content_type 用同一份取值。此前接口返回的是本地解析值、落库的是 OSS 回显值，OSS 一旦归一化或回显空值，两个来源就会给出互相矛盾的元数据	2026-09-24 17:43:52 +08:00
k88936	8af4287bf3	落点校验的文档注释改成与实现一致 ... - server-rs/crates/api-server/src/tripo3d/validation.rs：validate_target 的注释此前写「项目资源与素材库二选一 / 不接受两个都给」，与实际实现（两个都接受、只要求至少一个）以及用例 target_accepts_both_locators_but_requires_at_least_one 矛盾，改为按实际口径描述	2026-09-24 17:43:43 +08:00
k88936	791011eacf	落点纵深防御的兜底字段名与归因口径对齐 ... - server-rs/crates/api-server/src/tripo3d/target.rs：两个落点都没给时的兜底报错由点 projectId 改为点 target，与 target_unavailable_field 对 both-missing 的归因一致，不再把错误指到一个调用方可能根本没传的键上	2026-09-24 17:43:36 +08:00
k88936	0b3c15ee7c	图生 3D 的源图对象键为空时按缺失处理 ... - server-rs/crates/api-server/src/tripo3d/image_source.rs：预检对 object_key 加非空判断，空串 / 纯空白与缺字段同义。此前 Some("") 能过预检，等任务已入队计费后才在下载源图时失败	2026-09-24 17:43:24 +08:00
k88936	643ffedfb6	provider 4xx 不再把原文错误体回给客户端 ... - server-rs/crates/api-server/src/tripo3d/errors.rs：400..=499 分支不再拼接 error.to_string()。TripoError::Api 的 Display 直接转述 provider 的 code/message/suggestion（HTTP 错误体原文，未做 URL 清洗），可能把带签名的地址等内部信息带进用户可见的任务错误；改为固定中文文案	2026-09-24 17:43:17 +08:00
k88936	110354fad9	请求路径也拦住写歪的 Tripo 网关地址 ... - server-rs/crates/api-server/src/tripo3d/provider.rs：URL 判据（合法 URL + HTTP(S) + 有主机名）抽成 validate_tripo_base_url_syntax，启动期门禁与 tripo_settings 共用；非空但缺 scheme / 非 HTTP(S) / 无主机名的地址在请求前就映射 503，不再拖到 SDK 里变成一条指向连接失败的报错 - server-rs/crates/api-server/src/tripo3d/provider.rs：补请求期拒绝写歪地址的用例	2026-09-24 17:38:28 +08:00
k88936	62600fe881	请求路径也拦住越界的 TRIPO_RETRIES ... - server-rs/crates/api-server/src/tripo3d/provider.rs：tripo_settings 显式校验 config.tripo_retries 不超过 TRIPO_MAX_RETRIES 并映射 503。TripoSettings::validate 只查空值与零超时，越界值会原样进 artifact_retries，把产物下载的挂起时间成倍拉长；注释里「第二道防线」的说法此前并不成立 - server-rs/crates/api-server/src/tripo3d/provider.rs：补越界拒绝 / 上限放行的用例	2026-09-24 17:36:55 +08:00
k88936	1600c107e0	修掉没测到 API Key 分支的用例 ... - server-rs/crates/api-server/src/tripo3d/provider.rs：missing_api_key_is_reported_as_unavailable 先补全 TRIPO_BASE_URL 再断言缺密钥。AppConfig::default() 的网关是空串，原用例一直停在「缺网关」分支上，API Key 校验删掉也能过	2026-09-24 17:35:45 +08:00
k88936	d1e11c705d	Tripo 配置改为启动期失败关闭，缺网关或密钥的进程拒绝启动 ... - api-server 新增启动期门禁：会提交或会执行 3D job 的角色（api / external-generation-worker / all）缺 TRIPO_BASE_URL 或 TRIPO_API_KEY、值为空白或网关不是合法 HTTP(S) 地址时直接拒绝启动；bgfilter-worker 与 external-generation-controller 不受影响 - 删除内置默认网关常量，AppConfig::default() 的 tripo_base_url 改为空串；请求路径不再把超时静默钳到 .max(1)、重试钳到 .min(10)，坏值原样交给 TripoSettings 并映射 503，作为启动期之后的第二道防线 - 两个运行旋钮仍可缺省（沿用内置 60000 / 2），显式声明时零超时、非数字或重试超过 10 都判启动失败 - .env.example 与 deploy/env/api-server.env.example 补齐 TRIPO_* 必填说明；deploy/container/api-server.env.example 与 container-worker-smoke 生成 env 补占位值，避免容器压测与 Jenkins 分支预览起不来 - 文档：新增 ADR 0006 并登记 docs/README.md，同步外部生成 Worker 化方案、开发运维文档、CONTEXT.md、决策记录、踩坑记录与实施计划	2026-09-24 13:53:43 +08:00
k88936	eb27bb9226	清掉 api-server 两条编译告警：未使用导入与测试态死代码 ... - server-rs/crates/api-server/src/tripo3d/routes.rs：删除未使用的 Model3dJobTarget 导入，同批使用的 Model3dJobKind 等保留 - server-rs/crates/api-server/src/state.rs：map_editor_generation_pricing_persistence_error 只被 cfg(not(test)) 分支调用，补 cfg_attr(test, allow(dead_code))，与同文件 seed_editor_generation_pricing_config 的既有写法一致 - 验证：cargo check --workspace --all-targets 零告警零错误	2026-09-23 19:59:09 +08:00
k88936	df6694c4a9	图生 3D 的资源派生来源改为取自请求的 source ... - job.rs 新增 Model3dJobRequest::source_resource_id()：resource 来源带出画布资源 id，素材库来源与文生 3D 没有可登记的来源资源 - worker.rs 落库时资源行与素材行都改用它：资源行记派生来源，素材行优先指向本项目的资源行、只落素材库时退回请求里的来源资源 - 新增单测钉住三种来源（resource / asset / 文生）的取值，不再拿本次新生成的输出资源 id 冒充来源	2026-09-23 18:51:10 +08:00
k88936	6b1114356c	59/60/61/65 按决定不修复，改为在代码里写清取舍 ... - worker.rs：说明 last_error_message 是落库且前端直接展示的摘要，只取 provider message，不塞内部 reason/taskStatus（#59） - platform-tripo error.rs：说明 ADR 0001 要求平台层不带出 SDK 错误模型，Io/Serde 只保留文本（#60） - platform-tripo mapping.rs：说明 Tripo 文档把 generated_image_url 列为 text_to_model 固定字段，按 ADR 0001 失败关闭保留必填（#61） - platform-tripo image_to_model/client.rs：说明 PublicUrl 只做非空白校验的边界条件与将来接外部地址时的校验位置（#65）	2026-09-23 18:04:29 +08:00
k88936	985955205c	把 checkpoint 分支写实为 at-most-once 硬约束而非续跑能力 ... - worker.rs 模块注释明确 Tripo job 固定 max_attempts = 1，崩溃后租约耗尽直接终态失败、不会被重新 claim，因此不存在续跑路径 - worker.rs 说明 existing_checkpoint 是防御性硬约束，checkpoint 的日常用途是人工对账 - 技术方案与 ADR 把「崩溃后重新 claim 只查询」改写为「不重新 claim，带 checkpoint 的路径绝不二次 submit」 - 实施计划与里程碑同步 checkpoint 语义，不再宣称续跑	2026-09-23 17:50:04 +08:00
k88936	85219ad1d4	提交前先判预算，耗尽时不再发起计费的 submit ... - run_model3d_job 在没有 checkpoint 的分支上先走 ensure_submit_budget： 预算已被解析 / 排队耗光时直接按 provider 超时终态失败，不去白花一次 provider 提交 - 续跑（已有 checkpoint）分支不受影响，仍然只轮询不提交 - 新增用例：预算耗尽必须拒绝提交，仍有预算必须放行	2026-09-23 17:45:22 +08:00
k88936	42b4315b4f	可重试性改为显式判定，不再由 status 缺省推断 ... - TripoError::Request 增加 retryable 字段：由产生错误的一方按真实分类判定 - 传输层失败按 reqwest 的 is_timeout / is_connect 分类（新增 transport_error_is_transient， 以及状态集合 http_status_is_transient） - SDK 的 Error::Request 只在带瞬时状态码、或底层 reqwest 错误确实瞬时时可重试； source 为空（空 body / 格式错误 / 缺 data 字段）不再重试 - 产物客户端构造失败标为不可重试；无数据推进、body 读取失败与长度不一致标为可重试 - 新增四组用例：显式标记、状态集合、SDK 分类，以及用真实 reqwest 错误（连接被拒 vs 非法地址）验证分类 - 同步技术方案：写明「可重试性由产生错误处判定」的口径	2026-09-23 17:40:18 +08:00
k88936	b33a8a141c	3D 产物下载的重试改为覆盖整个响应体 ... - download_model / download_rendered_image 把「取响应头 + 读完 body」作为一次可重试事务， 每次尝试都重新取响应头并整体重下，不做断点续传 - body 传输失败与长度不一致归一成可重试的传输错误（不再带 HTTP 200），HTTP 状态只留在文案里 - 新增 TripoArtifactBytes（读完的产物）并公开 download_model / download_rendered_image 的 max_bytes 上限； 超限按 OutputSchema 失败且不重试，流式句柄 TripoDownloadedArtifact 收回 crate 内部 - api-server 的 read_artifact 改成对完整产物做落库前校验（只判空），体积上限转由调用方传入 - smoke 示例改为一次写入完整字节；新增「body 中途断开后整体重下成功」与「超限不重试」两个用例 - 同步技术方案与实施计划：把「只重试响应头」的描述改成「重试包住整个 body」	2026-09-23 17:01:40 +08:00
k88936	a4132616d8	3D 产物 content type 只认字节或槽位白名单，去掉兜底 ... - 删除 fallback_extension 与「未知声明原样放行 + 扩展名兜底」的归一逻辑 - 槽位白名单收敛为唯一映射表（content type ↔ 对象键扩展名），跨槽位类型返回 None - resolve_artifact_content_type 改为返回 Result：字节认不出且声明不在白名单时按 502 失败， 不再把 text/plain 之类的声明连同拼出来的 .glb 扩展名落进 OSS 与 asset_object - 错误体只回显截断到 64 字符的声明值，避免把任意长度的 provider 文本带进响应 - 重写 storage 测试：新增白名单外声明、跨槽位类型与字节认不出三类用例 - 同步技术方案：说明白名单范围与「不做任何兜底」的口径	2026-09-23 16:39:15 +08:00
k88936	6a7cf294a0	3D 生成请求允许缺省 textureQuality 并按 standard 计价 ... - PricingParamView::validate 不再要求 texture=true 时显式给出 textureQuality，缺省按 standard 计价 - 只有显式 detailed / extreme 才命中 hdTexture / ultraTexture 加价，缺省不改变报价 - v2.5 拒绝任何显式 texture_quality，必填规则会让 H25 + texture=true 永远不可达 - texture=false 仍禁止出现贴图档位，原有冲突校验与用例保持不变 - 同步技术方案：说明 geometryQuality / textureQuality 两个字段允许缺省的共同理由	2026-09-23 16:30:22 +08:00
k88936	427b9f19a1	3D 生成请求允许缺省 geometryQuality 并按 standard 计价 ... - PricingParamView::validate 去掉 geometryQuality 必填，缺省按 standard 计入定价 - 只有显式 detailed 才命中 hdGeometry 加价，缺省不会改变报价 - 新增缺省几何质量的定价用例（v3.1 与 v2.5 两条路径），并把它从必填字段用例里移除 - 同步技术方案：说明该字段允许缺省的原因，v2.5 / P1 / P2 因 provider 不支持该参数而必须允许缺省	2026-09-23 16:24:18 +08:00
k88936	ffee739774	platform-tripo 构造配置时拒绝零超时与空白凭据 ... - TripoSettings::new 改为返回 Result：request_timeout 必须大于零，api_key / base_url 不能是空白 - 新增 TripoSettings::validate 与 TripoError::Configuration，字段是公开的，因此 TripoProviderClient::new 在使用前再校验一次 - 拒绝零超时的理由是同一个值存在两种语义：tokio::time::timeout 立即超时，reqwest 却当成不超时 - api-server 构造入口把构造失败按既有 503 口径映射，并补全 TripoError 的匹配分支 - smoke 示例与 platform-tripo 测试跟进新的构造签名，新增零超时 / 空白凭据用例	2026-09-23 16:16:27 +08:00
k88936	158f9b741d	3D 落点放宽为「至少一个」并把结果引用改成平坦字段 ... - 校验层不再要求「projectId 与 assetFolderId 恰好一个」：两个都不给 400 点名 projectId，canvasCompletion 与「没有 projectId」同现 400 点名 canvasCompletion，两个都给按合法处理；与其它画布生成工具同一口径。 - 落点预检改成对给出的每个落点逐个定点查，出错字段只在「只给一个」时点名该键，两个都给无法归因回落到 target；去掉已经没有意义的旧用法注释。 - 结果侧 Model3dGenerationTargetRef 从 tagged enum（kind=projectResource/assetLibrary）改成与请求落点同形的平坦可选字段 resourceId / assetId，两个落点都写就两个都带；生成绑定同步变宽。 - worker 的 target_ref 改为按「写了哪条落点行」分别带 ID，完成结果用例改成断言平坦字段且只落项目资源时不得凭空出现 assetId；契约测试对称覆盖「只落素材库」形态。 - 验证：cargo test -p api-server tripo3d::（56 passed）、cargo test -p shared-contracts、npm run contracts:model3d:generate、check:rustfmt / check:encoding / git diff --check 通过。	2026-09-23 15:54:07 +08:00
k88936	c64bfc3867	3D 预览产物 content type 改为按字节识别 ... - storage.rs 新增 sniff_preview_content_type（PNG / JPEG / WebP），resolve_artifact_content_type 改为按槽位判定：预览与模型一样先嗅探字节，嗅不出才回落声明值（最终仍回落 image/webp） - 修掉 provider / CDN 不写或写错 Content-Type 时 PNG 预览被写成 image/webp 并传播到 OSS metadata、asset_object.content_type 与生成结果的问题；对象键扩展名随之正确 - 定向用例重写为「字节优先 / 未知回落」两组，替换原先钉住「预览不嗅探」的用例 - 技术方案与决策记录同步该口径，并记录与其它图片链路（bgfilter / VectorEngine / 生成图落 OSS 适配器）的一致性对照	2026-09-23 15:28:23 +08:00
k88936	11d1324857	3D 图生输入解析的测试改为断言可观察行为 ... - 删掉 include_str! 嵌源码、按 token 断言「没出现列工程 / 列素材库」的守卫：它测的是实现文本，改名、换格式、调顺序都会误伤 - 定点查询用例改成覆盖 resource / asset 两个分支，断言每个分支只发起一次按 ID 的查询、且对象键原样来自记录 - 模块文档写明定点查询由注入签名收口（一个 ID → 一条记录），失败语义与测试口径一并写实	2026-09-23 14:58:44 +08:00
k88936	1be77d2f99	3D 图生输入解析只收敛「引用不可用」状态码 ... - resolve_source_object_key_with 的 4xx 收敛从 is_client_error() 收窄为 400 / 404，不再把 403 服务身份校验失败与 409 并发冲突也说成「图片必须是已登记资源」 - 与模块注释「只有基础设施失败保留原状态码」的实际口径统一，403 / 409 / 5xx 一律按原状态码上报 - 定向用例改名 image_source_resolution_only_collapses_unavailable_references，覆盖 400 / 404 收敛与 403 / 409 / 500 保留	2026-09-23 14:51:09 +08:00
k88936	8a8c00fbb6	3D 图生输入解析把「缺对象键」改判为服务端问题 ... - resolve_source_object_key_with 在记录已解析但缺对象键时返回 502 与 model3d-image-source-object-key-missing，不再复用「引用不可用」的 400 - 未登记 / 跨 owner / 已删除仍收敛成同一句 400；缺对象键口径与 editor_project::validate_editor_reference_id_for_owner 的 BAD_GATEWAY 对齐 - 定向用例改名为 image_source_resolution_reports_missing_object_key_as_server_side_failure，断言状态码与 reason	2026-09-23 14:49:18 +08:00
k88936	9edb4e5f80	3D 提交侧归一落点并删掉 Standard 顶层 result 透传 ... - 提交侧新增归一并写回请求：项目 ID 只 trim，素材夹 ID 走其它工具同一套 normalize_generated_asset_folder_id（project / 旧 folder-* 收敛到 owner 默认素材夹），素材名走 resolve_editor_generated_asset_label（trim、截断到上限、缺省「3D 模型」），保证预检值 = 队列载荷 = 落库值。 - 队列行 sourceEntityId 改用共用 editor_generation_source_entity_id（项目 ID，缺项目回落 job kind），不再拿素材夹 ID 顶替。 - 按你的决定删掉 Standard 消费者顶层 result 逐字透传：标准消费者只回来源身份，3D 结果与图片等画布任务一样靠画布 placement / 素材行读回，连带删掉「3D 生成没有画布读回路径」这条错注释。 - 技术方案与共享记忆同步落点归一、身份口径与结果读取路径；job.rs 补归一用例（含素材名截断）。 - 验证：cargo test -p api-server（1193 passed）、cargo test -p api-server tripo3d::（55 passed）、npx vitest run src/components/image-editor/model3d-generation src/components/image-editor/model3d-preview（63 passed）、check:rustfmt / check:encoding / check-doc-index / git diff --check 通过。	2026-09-23 14:36:50 +08:00
k88936	fd48829c24	3D 生成请求落点改为平坦可选字段并复用统一落点预检 ... - shared-contracts 的 text-to-model / image-to-model 请求用平坦可选 projectId / canvasCompletion / assetFolderId / assetLabel 取代 tagged enum target，删除 Model3dGenerationTarget 及其契约测试。 - 同步 ts-rs 生成绑定：新增四个可选字段并移除 Model3dGenerationTarget.ts 与 barrel 导出。 - api-server 校验层改按「项目资源 / 素材库二选一」校验，缺失、冲突与空白值都返回 400 并点名具体字段。 - 落点预检改用其它付费编辑器生成共用的 preflight_editor_generation_target_and_return，素材库落点不再读整库。 - worker 按平坦字段落库，素材名缺省回落到 MODEL3D_DEFAULT_ASSET_LABEL。 - 定向验证：cargo test -p shared-contracts 与 cargo test -p api-server tripo3d:: 全绿（54 passed）。	2026-09-23 14:02:44 +08:00
k88936	48ba8b3133	3D 结果序列化失败不再落「完成但 result 为空」的终态 ... - job_result_payload 改为返回 Result，失败按 500 上报服务端问题，去掉 result:null 兜底形状 - worker 持久化前用 ? 把失败交给既有失败链路：任务按失败终态处理并冲正扣费 - worker 测试夹具同步改为 expect，断言完成结果可序列化	2026-09-23 12:15:02 +08:00
k88936	83913785ae	补齐 Tripo 3D 错误映射的剩余分支测试 ... - 增补 SDK 参数错误、无状态码 Api、Api 5xx、Sdk 兜底与传输错误的 502 用例，断言只回固定文案、不回显上游报文与 task id - 增补 map_request_error 的字段口径用例：平台字段路径、provider 字段名与字段未知时不写 field - 增补 map_pricing_error / map_pricing_store_error / oss_unavailable 的状态码、provider 与 reason 断言	2026-09-23 12:12:26 +08:00
k88936	5e47f0c41e	3D 定价记录转换与读取归一化接上 SpacetimeDB 两段列 ... - 新增 editor_generation_model3d_records 深模块：配置与两段记录行之间双向转换 - 写入方向严格：落库前按契约强校验，缺键与契约外键都不写 - 读取方向归一化：记录缺键（含整段缺失的老行）用本地配置同段补齐，契约外键剔除并告警，补齐后仍不合法才判非法 - 定价配置读取以表为准，覆盖文件降级为种子与兜底；state.rs 保存路径写入两段 - spacetime-client 补导出 3D 定价记录类型，api-server 定向用例覆盖往返、补齐、剔除与拒绝	2026-09-23 11:12:57 +08:00
k88936	ebd904e193	公开读模型 3D 段保持迁移前的旧形状 ... - 新增 Model3dPricingPublicView，把内部两段结构投影回 basePrices 端点判别 + addOnPrices 单表 - 公开路由改用投影视图，画布 3D 入口与前端类型不需要随本次迁移改动 - 投影取文生 3D 段的加价项，两段不一致时打告警提示前端升级前不要差异化 - 公开路由用例补断言钉住 3D 段旧形状	2026-09-23 11:04:50 +08:00
k88936	9f4a71d2e3	3D 定价段拆成端点并列的两段结构 ... - Model3dPricingConfig 改为 textToModelPricing / imageToModelPricing 两段并列，各持自己的 versionPrices 与 addOnPrices - 新增 Model3dEndpointPricing 承接单端点定价，校验与查价按端点委派，溢出检查覆盖两段 - 受控默认 JSON 的 model3d 段同步改为两段结构 - 3D 定价相关用例夹具与断言更新到两段形状	2026-09-23 11:01:20 +08:00
k88936	bba96e18a1	队列状态映射改为借用记录避免提交路径整行克隆 ... - editor_generation_queue_state 收 &ExternalGenerationJobRecord，只克隆输出需要的三个字段 - Model3dSubmissionResponse::from_job 不再克隆整行 job，status_url 提前算好避免额外克隆 - 其余调用点改为传引用，行为不变	2026-09-22 16:44:47 +08:00
k88936	433ffb4a15	落库的模型版本改用严格 wire 取值 ... - Model3dJobRequest::model_version 改为返回 Result 并使用 wire_str - worker 落库前取不到契约取值即按服务端问题失败，不再写 Debug 兜底名 - 新增用例断言落库取值为契约线上值 v3.1-20260211	2026-09-22 16:40:48 +08:00
k88936	4e5ff179b2	3D 查价拒绝 texture=false 与贴图加价项的矛盾组合 ... - Model3dPricingError 新增 InconsistentTextureAddOn 变体与对应文案 - price() 在命中的 add-on 含贴图类而 texture=false 时失败关闭，不再照价收费 - 补齐矛盾组合报错与 texture=true 合法组合的价格用例	2026-09-22 16:38:24 +08:00
k88936	87ca86ae6a	图片输入解析抽出可注入查询的解析规则并补齐行为用例 ... - resolve_source_object_key 拆出 resolve_source_object_key_with 与 ResolvedReference 窄结果 - 新增按 ID 定点查询、类型不符、缺对象键、4xx 收敛与基础设施错误保留状态码的用例 - 源码文本断言不再按函数签名切片，只检查本模块不出现列工程 / 列素材库	2026-09-22 16:36:16 +08:00
k88936	48cde9624c	operation_kind 白名单改为两 crate 共用的共享常量 ... - 白名单常量迁到 shared-contracts 并从 crate 根导出 - spacetime-module 的原子落库事务改为引用该常量，删除本地重复定义 - api-server 的登记测试不再解析对方源码文本，改为直接断言常量内容 - 后端架构文档补上白名单常量的位置与共用口径	2026-09-22 16:30:28 +08:00
k88936	c8b4160fcd	3D 查价错误并入统一的定价错误枚举 ... - EditorGenerationPricingError 新增 Model3d 变体并实现 From<Model3dPricingError> - model3d_price 改为返回 EditorGenerationPricingError，内层文案直通保持响应不变 - 提交路由对 3D 定价错误与定价快照错误分别映射，未配置用例改断言 Model3d(NotConfigured)	2026-09-22 16:11:17 +08:00
k88936	9800477c7c	模型版本清单从声明表派生避免漏加新版本 ... - Model3dModelVersion 的变体、线上值与 ALL 改为由 model3d_model_versions! 单一声明表生成 - ALL 类型改为 &'static [Self]，新增版本只需在声明表加一行 - 定价校验与测试的遍历改用 iter().copied()	2026-09-22 16:03:55 +08:00
k88936	ee2d505eb3	3D 提交在扣费前预检落点归属 ... - 新增 target 预检模块：画布项目按 (project_id, owner) 定点确认，素材库文件夹按 owner 的库匹配 - 两个提交路由都在查价与入队之前调用；跨 owner / 不存在的落点回 400 model3d-target-unavailable - 只剩基础设施故障保留原状态码，并补了收敛口径的单测	2026-09-22 15:21:25 +08:00
k88936	8473877bc3	5xx 错误响应不再回带 provider task id ... - TaskFailure / OutputSchema / 上游兜底分支只回固定文案，完整错误写入服务端日志 - 补一条断言 502 details 不含 task id 与 provider 原文的用例	2026-09-22 15:17:50 +08:00
k88936	cda7724cae	上游瞬时状态不再回落成 400 ... - 408 / 425 / 429 与 platform-tripo 的 is_retryable 口径对齐，分别回 504 / 502 / 429 - 补上这三档与客户端 4xx 的分支测试	2026-09-22 15:15:27 +08:00
k88936	5049c27f3d	3D 定价表加载时拦截加总溢出 ... - 底价与加价项累加改用 checked_add 校验，配置阶段即失败 - 避免结算路径 saturating_add 在异常配置下静默少收	2026-09-22 13:49:01 +08:00
k88936	2916e112df	3D provider 重试次数按上限 10 封顶 ... - TRIPO_RETRIES 配置异常时不再让产物下载近乎无限重试	2026-09-22 13:48:13 +08:00
k88936	c5e0c6a14d	去掉被丢弃的 remove 返回值告警 ... - 幂等指纹字段摘除改为显式丢弃返回值，表明这是 best-effort 行为	2026-09-22 13:48:10 +08:00
k88936	444520b464	修正 storage.rs 注释错别字 ... - server-rs/crates/api-server/src/tripo3d/storage.rs：sniff_model_content_type 文档注释「说慌」改为「说谎」 验证：npm run check:encoding、git diff --check	2026-09-22 13:42:37 +08:00
k88936	326729a5ac	Idempotency-Key 校验错误保留请求上下文 ... - server-rs/crates/api-server/src/tripo3d/routes.rs：require_idempotency_key 增加 request_context 参数，缺失 / 格式非法的两个 400 改用 into_response_with_context(Some(..))，与同处理器其它校验、定价错误一致；此前传 None，客户端拿不到请求 ID / 关联标识 验证：cargo test -p api-server --locked idempotency_key（相关 6 个用例全绿）	2026-09-22 13:42:34 +08:00
k88936	14740e0ef6	3D 任务参数用例改为断言真实主张 ... - server-rs/crates/api-server/src/tripo3d/job.rs：把 job_request_rejects_payload_without_fingerprint_stripping_support 改名为 job_request_stays_strict_after_stripping_platform_fingerprint 并补断言——带指纹 + 其它未知字段的合法 payload 仍必须被拒（摘下平台字段不等于放宽严格解析）；原用例名声称验证指纹摘除，实际只断言了「缺字段的 payload 被拒」和「未知 job kind 被拒」 验证：cargo test -p api-server --locked job_request（2 个用例全绿）、npm run check:rustfmt	2026-09-22 13:40:13 +08:00
k88936	48a5bf06d0	3D 产物读取不再克隆 content type ... - server-rs/crates/api-server/src/tripo3d/artifacts.rs：content_type 只在本函数取一次、之后不再读句柄字段，改用 take() 转移所有权而不是 clone() 验证：cargo check -p api-server（--locked）	2026-09-22 13:36:28 +08:00
k88936	9263d79d42	3D 产物读取按声明长度预分配缓冲 ... - server-rs/crates/api-server/src/tripo3d/artifacts.rs：read_artifact 用 Vec::with_capacity 按 provider 声明的 content_length 预分配（并封顶到 512 MiB 上限，防止谎报长度撑爆内存），避免几百 MB 产物逐块 extend 反复搬移 验证：cargo check -p api-server（--locked）	2026-09-22 13:36:25 +08:00