830 Commits

Author	SHA1	Message	Date
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	ee4a9434fa	后台定价读取带版本、保存整段必填并做事务内乐观锁 ... - shared-contracts 新增定价版本冲突标记，module 与 api-server 共用一处声明 - SpacetimeDB upsert input 增加期望版本，事务内比对不一致即整笔拒绝（种子写入显式不比对） - 定价 store 记录当前版本，读取路径带出 updated_at 微秒值 - 后台 GET 返回 models / 3D 两段 / updatedAtMicros，POST 要求两段显式给出且带期望版本 - 缺 3D 段 400、版本不匹配 409，退役 with_previous_model3d 与「省略即沿用」用例 - 绑定按 input 新字段重新生成，模块补乐观锁比对用例	2026-09-23 11:38:23 +08:00
k88936	952bc1ccaa	覆盖文件缺 3D 段时按受控默认价补齐，不再把 3D 整段算成未配置 ... - 新增 backfill_legacy_model3d_pricing：旧覆盖文件整段没有 3D 时补上默认 JSON 的两段并告警 - 覆盖文件继续只承担种子与兜底，避免老种子文件把 3D 生成整段关掉 - 补用例覆盖覆盖文件缺 3D 段的读取	2026-09-23 11:15:42 +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	774b74d3d6	SpacetimeDB 定价表追加 3D 两段列，记录形状先能表达端点 × 版本 × 贴图与加价项 ... - editor_generation_pricing_config 末尾追加 text_to_model_pricing / image_to_model_pricing 两个 Option 列并带显式默认值 - 新增模型版本底价、加价项、端点定价三个 SpacetimeType 行类型，模块侧按段校验空段、缺半段、重复键与非正价格 - upsert 输入、快照、生成绑定与客户端记录映射同步两段字段 - api-server 保存路径本次先写空值，读取仍走本地文件缓存；补模块段级归一化用例	2026-09-23 10:54:01 +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	050909a0b7	后台定价保存不再清空 3D 段 ... - payload 的 model3d 缺席或为 null 统一表示沿用当前 3D 定价，显式给出时才覆盖 - 保存路径先取当前快照合并，避免改图 / 视频价格让 3D 提交一直失败关闭 - 补用例覆盖「省略保持」与「显式覆盖」两种语义	2026-09-22 15:27:19 +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	129e2234f3	删掉 3D 引用解析里两个无人调用的宽查函数 ... - 两个 pub(crate) resolver 全仓无调用方，且会整表列举项目与素材 - 定点解析仍走既有按 ID 的窄查函数	2026-09-22 13:48:53 +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	058d851a69	去掉 model3d_price 上已过期的 dead_code 豁免 ... - server-rs/crates/api-server/src/editor_generation_config.rs：model3d_price 现在由 tripo3d 提交路由真实消费，删掉「里程碑二的路由接上之前只有测试消费」这句已过期注释与配套的 #[allow(dead_code)] 验证：cargo check -p api-server（--locked）无该函数相关告警	2026-09-22 13:43:45 +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
k88936	6d8164d37a	OSS 不可用错误补上机器可读的 reason ... - server-rs/crates/api-server/src/tripo3d/errors.rs：oss_unavailable 增加 reason=oss-unavailable，与同文件其它 5xx 映射及 editor_agent 的 OSS 错误口径一致，客户端可按 reason 分类这个 503 验证：cargo check -p api-server（--locked）	2026-09-22 13:35:23 +08:00
k88936	66b8c2bed0	3D 定价快照读取失败补上机器可读的 reason ... - server-rs/crates/api-server/src/tripo3d/errors.rs：map_pricing_store_error 增加 reason=model3d-pricing-store-error，与同文件其它映射一致，客户端可按 reason 分类这个 500；provider 保持 editor-generation-pricing（全仓库定价错误都是这个口径），不改写为 TRIPO_PROVIDER 验证：cargo check -p api-server（--locked）	2026-09-22 13:35:20 +08:00
k88936	10e63ecb6b	合并 origin/master 到 feat/tribo3d-integeration：ts-rs 一律常开、Cargo 清单去重 ... - server-rs/Cargo.toml：删除与 workspace git 固定重复的 registry `ts-rs = "12.0.1"`，保留固定 commit 并写明「ts-rs 一律常开、绑定命令固定为 cargo test -p shared-contracts export_bindings」 - server-rs/crates/shared-contracts/Cargo.toml：删除 master 侧新增的 `ts-bindings` feature，`ts-rs` 保持常开依赖 - server-rs/crates/shared-contracts/src/game_creation_app/asset_kind.rs：去掉 `cfg_attr(feature = "ts-bindings", …)` 门控，derive 与字段级 `ts(...)` 无条件展开 - apps/ai-game-creator-shell/src-tauri/Cargo.toml：shared-contracts 依赖去掉 `features = ["ts-bindings"]`，继续保留本分支的 ts-rs git 固定 - apps/ai-game-creator-shell/src-tauri/Cargo.lock：按上述依赖变更同步（shared-contracts 指向 git 源 ts-rs） - docs：同步 5 处绑定生成命令（去掉 `--features ts-bindings`），并在 decision-log 记本次合并的决策、代价与验证 - 其余暂存改动为 origin/master 带入的内容，冲突按两侧目的逐一合并 验证：cargo metadata --locked（server-rs 与 AGC 两个 workspace）、cargo test -p shared-contracts（119 + 5 + 5 + 2 + 2 全绿且无告警）、npm run contracts:model3d:generate 后 packages/shared 零 diff、cargo check -p spacetime-module --target wasm32-unknown-unknown、npm run check:encoding、npm run check:rustfmt、npm run check:spacetime-schema、git diff --check、暂存集 eslint / prettier 全过	2026-09-22 13:12:28 +08:00
k88936	61fe4c48af	图片画布接入 3D 资源：新增 model3d 类别、3D 预览与 3D 生成入口 ... - 后端资源投影按 asset_kind 分叉，新增 project_editor_client_media_src 与 EDITOR_MODEL3D_ASSET_KIND：model3d 只投影预览图，模型本体只留 objectKey，预览缺失才回落历史口径 - tripo3d 存储新增按字节魔数识别模型 content_type 与扩展名映射，不采信 provider 声明与下载响应头 - editor_project_storage 把 model3d 加入 EDITOR_CANVAS_ASSET_KINDS 白名单 - 前端 CanvasAssetKind 与 image-canvas-core 类型新增 model3d：画布卡片渲染预览图或 3D 占位，类型角标新增「3D模型」，覆盖资格只在它与空类别之间成立 - 新增 model3d-preview 子目录（Model3dViewerModal / Model3dViewerModel），Tailwind 内联、不新增 CSS，失败原因分超限 / 格式不可识别 / 无 WebGL2 三类展示 - 选中工具条新增只读 preview-model3d 能力位，仅 objectKey 为空时置灰；打开预览同时选中图层并暂停画布快捷键与舞台交互 - 查看器包源对象 format 改为可选，新增「声明 Content-Type → 字节魔数 → 地址扩展名」三级格式判定并导出支持格式清单 - 导出工作流新增 3d_models/ 目录，模型下载按真实响应头 MIME 定扩展名、对象键扩展名兜底 - 新增 3D 生成入口：底部工具栏浮动子选项与文生 / 图生 3D 面板，落 projectResource + canvasCompletion，复用占位框与任务侧栏 - 3D 定价只读实时定价查询，段缺失即入口不可提交；幂等键由前端铸造，用户重试必须换键 - 新增 ADR 0003 / 0004 与实施计划、里程碑文档；更新 Tripo 技术方案、后端架构、CONTEXT 术语、decision-log 与 pitfalls - .gitignore 忽略仓库根目录手工下载的 3D 样例模型	2026-09-22 10:10:00 +08:00
k88936	9fc55a5cac	写入Tripo 3D泥点默认价并锁定credit换算口径 ... - 受控默认配置新增 model3d 段：底价按端点 × 模型版本 × 是否有贴图，add-on 六项独立计价 - 换算口径固定为泥点 = ceil(0.8 × Tripo 官方 credit)，H 系列 10/20 与 20/30、P1 30/40 与 40/50、P2 100/110 - editor_generation_config 定向用例按 credit 表反算默认泥点价，改价必须先改 credit 表 - 段缺失语义改为显式摘段验证，仍保持 fail closed 不扣费不入队 - 主规范、里程碑、实施计划与定价管理方案同步默认价已确认与部署侧 override 风险	2026-09-21 22:07:55 +08:00
k88936	2691ca8aca	补记图生输入的OSS直读待讨论项 ... - api-server 的 image_source 模块头与 platform-tripo 的 upload_image 各留一条 TODO(oss-direct-read)：交签名 URL 或对端直读 OSS 能省掉字节中转，但把私有对象与带时效凭据交给第三方，安全口径与可行性待讨论 - 技术方案文档把图生输入口径更新为当前的 source 站内引用 tagged enum，并补同一条待讨论说明 - 讨论清楚之前保持「api-server 自己读、自己传」的现口径，不改行为	2026-09-21 20:02:18 +08:00
k88936	609b24c779	text-to-model入口的submit改名带端点 ... - TripoProviderClient::submit 改名为 submit_text_to_model，与 submit_image_to_model / submit_multiview_to_model 一致 - 同步 api-server tripo3d worker 与 tripo_generation_smoke example 的调用点 - 同步技术方案文档里写死的 submit 口径，方法名不再与另两个入口分叉	2026-09-21 19:49:31 +08:00
k88936	3af0d3d90b	契约枚举的线上取值只由serde定义 ... - shared-contracts 新增 wire_str 与 wire_str_lossy：线上取值只从 serde rename / rename_all 取，不再维护第二份字面量 - 删除模型版本、纹理质量、纹理版本、纹理对齐、几何质量、输入方向、导出方向、压缩共 8 个枚举上手工维护的 as_str - platform-tripo 新增 common/wire.rs 负责契约枚举到 provider 请求字符串的转换，三个入口的 to_sdk_params 改走它并把失败归一成 provider 错误 - api-server 的定价文案与 job 模型版本取值改用 serde 取值，job 的 model_version 由 &'static str 改为 String - 取值来源只剩 serde 一处，改 rename 不会再静默分叉	2026-09-21 19:46:43 +08:00
kdletters	4951b71d71	项目快照按渠道分区，后台项目工程支持渠道筛选与游标分页 ... 项目快照对象键升级为 agc/project-snapshots/v2/{channel}/{user}/{project}/，渠道取部署配置 GENARRATIVE_AGC_PROJECT_SNAPSHOT_CHANNEL（缺省沿用客户端下载渠道），非法渠道在写入处失败关闭 后台新增渠道列表接口，项目工程列表与下载接受 channel，游标绑定渠道并拒绝跨渠道复用 后台项目工程用户列改为素材查询口径：昵称 + 陶泥号 + 用户详情入口，由 api-server 解析作者信息 后台项目工程改为游标分页：每页 20/50/100、上一页/下一页与当前页提示，翻页失败保留当前页 部署环境示例补充快照渠道配置，并同步运维、技术方案、里程碑与决策记录文档	2026-09-21 16:57:16 +08:00
kdletters	c5afc02e94	模板正文目录门禁：CLI 打包与后台上传统一拒绝身份/版本库/依赖/构建目录 ... - scripts/agc-template-library-publish.mjs：readProjectFiles 增加正文门禁，任意层级拒绝 .agent/.git/.svn/node_modules，根目录拒绝 dist/build/library/temp/local/.idea/.vscode - scripts/agc-template-library-publish.test.mjs：新增夹具源目录与门禁用例，覆盖 13 条拒绝路径及 game/dist/**、game/.gitignore 放行 - server-rs/crates/api-server/src/admin_templates.rs：上传归档校验与 CLI 用同一份段名单，新增 template_import_archive_rejects_identity_and_build_directories - docs/【模板规范】AGC模板包组织指南-2026-09-21.md：已知边界改为「已有机器门禁」，并说明同名目录段只在根目录受限 - docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md：CLI 与后台上传的校验口径补门禁，并追加 2026-09-21 证据（九个模板本地重打包摘要与线上清单逐条一致） - docs/project-memory/plans/【里程碑】后台模板上传-2026-09-21.md：验收标准 2 补充门禁证据 - docs/project-memory/shared-memory/decision-log.md：新增 2026-09-21 正文目录门禁决策记录	2026-09-21 16:25:35 +08:00
kdletters	4863c8c066	后台模板上传（后端）：新增批量导入接口与存储/领域支持 ... - shared-contracts 新增导入 manifest、逐条与结果 DTO（camelCase，拒绝未知字段） - module-assets 新增 prepare_template_import：新 ID 默认上架，已存在条目就地更新并保留上架状态与未知扩展字段；同一 ID 同版本字节不同时按 CLI 同一句文案拒绝，字节一致时按内容复用既有对象 - platform-oss 为 application/zip 放宽单对象上限到 64 MiB（图片与元数据仍 5 MiB），测试替身同步该口径 - api-server 新增 POST /admin/api/agc-templates/import：multipart（manifest + zip_N/cover_N），逐项校验归档安全性、entry 存在性与封面（按字节嗅探格式，仅 PNG/JPEG/WebP）后才取发布锁 - 锁内流程：CAS 校验 revision → 内容寻址写入 zip/封面/元数据并回读 → 一次提交清单 → 释放锁；断连由独立任务持有，不确定结果保留锁并返回 503 - 路由挂 require_admin_auth 与 200 MiB body 上限，页签权限矩阵与路由契约测试同步 - 新增用例：清单与文件字段校验、归档越界与符号链接拒绝、内容寻址键与封面嗅探、zip 内容类型存储上限 - 新增「后台模板上传」里程碑与实施计划文档 - 验证：cargo test（module-assets 11 项、platform-oss 12 项、api-server 定向 4 项）、cargo fmt --check、check:doc-index、check:encoding、git diff --check	2026-09-21 16:06:23 +08:00
k88936	c0fcb8553d	补Tripo worker纯逻辑定向用例 ... - checkpoint 只在 provider task id 非空且去空白后有效时才算存在，空白等同未提交 - 完成结果按端点严格区分，且序列化后不含 provider、taskId 与带签名的临时地址 - 预览图尺寸必须能真实解码，损坏字节直接失败而不是写占位宽高 - 预检用例去掉多余的通配导入，实施计划进展同步当前通过数	2026-09-21 15:22:01 +08:00
k88936	f732555a44	为Tripo提交路由补应用级验收用例 ... - 走真实 build_router 断言两个端点未鉴权一律 401，路径写错或漏 merge 会退化成 404 - 断言缺 Idempotency-Key 在解析之后、组合校验与定价之前返回 400 - 断言贴图档位冲突与定价必填字段缺失都在定价与 provider 副作用之前返回 400 并定位字段 - 实施计划进展补记该组用例与当前全量测试通过数	2026-09-21 15:16:22 +08:00
k88936	eb4256f883	图生3D图片引用改为提交时定点预检 ... - image_source 拆成预检与执行两条路径，预检只做归属、记录类型与对象键校验，不读正文也不调用 provider - 定点解析改用既有 resolve_editor_reference_record_by_id_for_owner，取代列工程与读素材库的宽查询 - image-to-model 路由在扣费与入队前调用预检，跨 owner、未登记、已删除与 kind 不符统一返回 400 - editor_project 把定点引用查询暴露为 crate 内可见，供生成入口复用 - 新增源码钉住用例，防止预检退回宽查询或提前读图片正文	2026-09-21 15:08:46 +08:00
k88936	02ef84d9b6	清理Tripo3D新代码的死代码与无意义断言 ... - 删除 job.rs 中无调用的 is_model3d_job_kind、source_entity_id 与本地 target_source_entity_id - 删除 artifacts.rs 中未被引用的 map_artifact_error 及其 TripoError 导入 - 删除未被引用的 MODEL3D_JOB_MAX_ATTEMPTS 与只被同文件测试断言的 queue source module 常量 - 删除对常量自身取值的恒真断言测试	2026-09-21 14:45:04 +08:00
k88936	29e554a30c	新增api-server Tripo3D worker执行链路与结果落库 ... - 新增 artifacts/result/worker 三个文件：产物读取、严格结果构造与 at-most-once submit 执行链路 - 没有 checkpoint 才 submit；submit 成功后先落 checkpoint 再轮询，checkpoint 写入失败按终态失败，不退回可重试队列 - 模型与预览图分别写入 OSS 并按 operation 稳定 ID 登记 asset_object，预览对象单独登记以便按对象键解析归属 - 落点按 target 分支写入项目资源或账号素材，imageSrc 与 thumbnailSrc 指向预览图，模型本体留在 objectKey - 画布回填只走 placement-only；新增只依赖资源身份与尺寸的占位条目构造函数供 3D 复用 - 标准消费者的队列结果透传调用方显式给出的 result，使 3D 完成结果可从既有任务查询返回 - external_generation_worker 增加两个 job kind 分支并纳入长任务超时，用户可见失败文案收敛为稳定文本	2026-09-21 14:36:59 +08:00