2776 Commits

Author	SHA1	Message	Date
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	14066eea11	产物下载改为按「无数据推进」判超时 ... - artifact reqwest client 不再设包含响应体的总超时，改成 connect_timeout + read_timeout（reqwest 0.12 的「每次读操作」语义，读完自动重置） - 响应头之前没有数据推进时用显式 tokio::time::timeout 兜住，避免连上却不返回响应头时无限挂住 - 新增 TripoProviderClient::artifact_stall_timeout 统一承载三处预算，取值沿用 TripoSettings::request_timeout - 补 3 个 mock TCP 用例：响应头一直不来、传输中途断流按无数据推进失败，慢速但持续的下载必须完整收完（后者能拦住「改回总超时」的回归） - 同步技术方案与后端架构文档里的下载超时口径	2026-09-21 19:54:57 +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	a4d9418cd3	补记Tripo TS绑定目录化生成的重跑验证 ... - 实施计划进展记录 contracts:model3d:generate 重跑后 packages/shared 无 diff - 验证命令清单补上该生成命令	2026-09-21 15:34:46 +08:00
k88936	7d842f0b15	补记spacetime-client重复副本文件的排障经验 ... - 记录 active.rs 用 path 属性指定真实模块、同名副本不参与编译的现象与原因 - 给出改动前先查 path 属性、只改 active 目录、用编译双绿确认的处理口径	2026-09-21 15:32:30 +08:00
k88936	d6c7a04a1c	同步Tripo3D的worker领取范围与长任务预算口径 ... - worker 领取清单补上 model3d_text_to_model 与 model3d_image_to_model - 长任务预算说明补记两个 3D job kind 在单次 attempt 内轮询 provider 并占用并发位 - worker 化方案补记 Tripo provider 的四个环境变量、默认网关与缺密钥时的 503 口径	2026-09-21 15:31:04 +08:00
k88936	13dfe07f94	补记3D定价在模型定价体系中的例外口径 ... - 模型定价管理方案新增 model3d 段说明：形状、事实源仍为文件配置、后台改价不覆盖 - 说明段缺失即 fail closed，未确认前禁止写入猜测值或 provider credit 数字 - 记录后续把 3D 段迁入 SpacetimeDB 并接后台编辑的收敛路径 - 实施计划补记 spacetime schema guard 通过及其锚点	2026-09-21 15:26:31 +08:00
k88936	03d26d46af	修正provider文档里过期的下载包装类型名 ... - 文档写的 TripoDownloadedModel 已不存在，按当前代码改成 TripoDownloadedArtifact - 上一条文档提交的说明里已提到这处改动，但当时补丁没落上，这次补实	2026-09-21 15:22:08 +08:00
k88936	c0fcb8553d	补Tripo worker纯逻辑定向用例 ... - checkpoint 只在 provider task id 非空且去空白后有效时才算存在，空白等同未提交 - 完成结果按端点严格区分，且序列化后不含 provider、taskId 与带签名的临时地址 - 预览图尺寸必须能真实解码，损坏字节直接失败而不是写占位宽高 - 预检用例去掉多余的通配导入，实施计划进展同步当前通过数	2026-09-21 15:22:01 +08:00
k88936	25ee11771c	同步Tripo provider文档与本次行为修正 ... - 脱敏输出保留原分隔符、带 userinfo 的地址解析即拒绝 - 图片与视图引用提交前 trim；校验原因分 Required / InvalidCombination / OutOfRange - 下载前要求快照为完成态，filename 扩展名收紧为短 ASCII 字母数字 - 顺带把文档里的下载包装类型名改为当前的 TripoDownloadedArtifact	2026-09-21 15:21:12 +08:00
k88936	f732555a44	为Tripo提交路由补应用级验收用例 ... - 走真实 build_router 断言两个端点未鉴权一律 401，路径写错或漏 merge 会退化成 404 - 断言缺 Idempotency-Key 在解析之后、组合校验与定价之前返回 400 - 断言贴图档位冲突与定价必填字段缺失都在定价与 provider 副作用之前返回 400 并定位字段 - 实施计划进展补记该组用例与当前全量测试通过数	2026-09-21 15:16:22 +08:00
k88936	63c924dba0	补记Tripo图生3D图片引用提交预检口径 ... - 主规范明确图片引用解析分两步：提交时只做元数据预检，worker 执行时重新确认同一事实 - 主规范新增第 5 条验收标准，验收清单顺延至 12 条，里程碑同步引用范围 - 实施计划把图片输入预检写进固定执行顺序，并记录已改用定点引用查询取代宽查询 - 决策记录新增条目：站内引用禁止在提交路径读正文、调 provider 或列全量工程与素材库	2026-09-21 15:08:01 +08:00
k88936	8a828a43ba	同步Tripo 3D生成的图片输入与完成结果口径 ... - 主规范明确图片输入先读字节再上传换 file_token，不把带签名的临时地址交给第三方 - 主规范补完成结果读取口径：由既有任务查询的 result 字段返回，标准消费者仅透传调用方显式给出的 result - 实施计划把图片输入步骤改写为 file_token 口径，文件表补 storage.rs - 实施计划新增进展一节，写清已落地步骤、未确认的定价数值与尚未跑通的真实端到端 - 风险一节补 worker 并发位与长任务超时的运维前提	2026-09-21 14:38:20 +08:00
k88936	931be509f1	补记Tripo model3d的assetKind接入清单对照 ... - 主规范新增 assetKind 接入清单对照表，逐行登记后端-only 类别的触碰点口径 - 主规范明确原子落库 operation_kind 白名单必须新增两个 Tripo job kind，画布回填只走 placement-only - 主规范登记用户标签覆盖、快速编辑与改造 capability 三项结论均为不进入，并写明后续接前端需重评 - 实施计划把 provider 配置文件行更正为 provider.rs，并在产物落库步骤补白名单与 placement 口径验收 - 后端架构文档补充说明：不走编辑器前端的生成类别同样适用清单，不能靠无前端入口跳过	2026-09-21 13:59:53 +08:00
k88936	2182b075b8	新增Tripo生成Worker执行链路实施计划 ... - 固定 api-server 侧 tripo3d 目录的文件切分与各文件职责 - 明确提交路由执行顺序、幂等口径与图片输入解析边界 - 记录 Tripo job 固定 max_attempts=1 与 checkpoint 收口语义 - 里程碑二转 active 并回链实施计划，里程碑一补实施计划入口	2026-09-21 13:17:24 +08:00
k88936	a11fd709fa	同步external_generation_job表目录的provider checkpoint口径 ... - 补记 provider_kind 与 provider_task_id 的追加字段、租约栅栏与禁止覆盖语义 - 说明 checkpoint 不进 payload、read model、BFF 响应与公开契约 - 事件表目录补充 provider_checkpoint 事件	2026-09-21 13:11:06 +08:00
k88936	36036eed7b	修正Tripo定价文档口径为 fail-closed 与无单位 ... - 主规范去掉 model3d 段的 unit 字段，3D 恒为按次计价 - 主规范把加载即校验改为段存在时必须全键，并补充段缺失即拒绝提交 - 契约里程碑验收第 6 条同步为段缺失 fail-closed - 实施计划把定价步骤指向 api-server/src/tripo3d/pricing.rs	2026-09-21 13:00:45 +08:00
k88936	ddf8e2c213	同步Tripo生成API的文档索引与领域术语 ... - docs/README 增加主规范与 ADR 入口 - CONTEXT.md 补充 3D 模型生成操作、provider task、Tripo API facade 等术语 - provider 专题把应用层接入指向新主规范 - 文档生命周期索引改为指向活动计划目录	2026-09-21 12:29:40 +08:00
k88936	6db1079610	新增Tripo生成API的里程碑规范与实施计划 ... - 新增契约与数据模型里程碑，锁定范围、不做项与验收标准 - 新增 Worker 执行链路与 API 路由里程碑，标注 pending 与定价前置依赖 - 新增契约里程碑实施计划，固定步骤顺序、验证命令与回退范围	2026-09-21 12:29:29 +08:00
k88936	699f321651	新增Tripo生成API集成主规范与决策记录 ... - 新增主规范，固定两个端点的请求、异步执行、结果持久化与泥点扣费合同 - 新增 ADR 0002，记录不复用 Hyper3D、at-most-once submit、提交时定价与落库失败退款	2026-09-21 12:29:08 +08:00
k88936	49b6451548	补充Tripo下载器迁移待办 ... 记录Provider侧流式下载与第三方SDK保持原样的边界 增加等待上游SDK原生stream能力后的替换TODO	2026-09-19 23:16:02 +08:00
k88936	4c7fd968dd	明确Tripo模型流式下载边界 ... 记录SDK与Provider只提供分块模型下载流 约定未来OSS上传直接消费数据流而不缓存完整模型	2026-09-19 22:20:23 +08:00
k88936	c48f0627cf	修复 ts-rs 对 enum 级 deny_unknown_fields 的解析告警并保留契约严格性 ... - 把 server-rs 与 apps/ai-game-creator-shell/src-tauri 两个 workspace 的 ts-rs 从 registry 固定到上游修复 commit fd8679ef20f866f747c046b30bd29c15e3d7a003（PR #491：已发布版 12.0.1 的 EnumAttr 不识别 deny_unknown_fields，只有 StructAttr 会静默忽略它），两个 Cargo.lock 同步改成 git 源 - 说明固定原因与退出条件：crates.io 最新仍是 12.0.1、GitHub 最新 tag 仍是 v12.0.0，等发布 > 12.0.1 后改回 registry 版本并删除 commit 固定 - 明确不使用 ts-rs 的 no-serde-warnings feature 消警：它会连同 deserialize_with 这类真实未支持的 serde 属性一起静默，掩盖 Rust 与 TS 绑定的漂移 - 保留 shared-contracts 的 Model3dMultiviewInputs enum 级 deny_unknown_fields（该属性一直由 serde 生效，告警只来自 ts-rs 的属性解析），注释改为写明不要为消警删属性、也不要改用 no-serde-warnings - 新增契约测试 tests/model3d_multiview_request_contract.rs：钉住 views/taskId 变体内部与请求体顶层拒绝未知字段，并覆盖 kind 与 camelCase 字段名解析 - 记录排障经验与决策：pitfalls.md 说明无 span 的告警不代表属性失效，decision-log.md 记录固定 commit、影响面与回退条件 - 验证：cargo check -p shared-contracts 与该 crate 的 cargo test 不再出现 deny_unknown_fields 告警且全绿；cargo test --locked -p shared-contracts model3d 加 prettier 后 packages/shared 的 model3d 绑定零 diff；AGC 的 cargo check --locked --bin genarrative-ai-game-creator-shell 不再出现该告警（AGC 侧仍保留 1 条既有的 deserialize_with 告警，与本改动无关）；npm run check:encoding、npm run check:doc-index、git diff --check、cargo fmt --all --check 通过	2026-09-19 16:56:24 +08:00
k88936	092bca7444	更新Tripo 3D模型Provider集成文档覆盖三个生成入口 ... 文档改名为「Tripo 3D模型Provider集成」，H1 同步去掉“文本到”前缀，并更新 docs/README.md 链接 目标段改为三个入口共用 TripoProviderClient，列明 submit / submit_image_to_model / submit_multiview_to_model 新增「三个入口的输入」小节，记录 prompt 长度上限、image input 裸字符串引用、multiview views 与 taskId 二选一及视图数量要求 新增「任务查询与下载」小节，记录 TripoTaskSnapshot、TripoDownloadedModel 与必须重复取 task 的原因 补充契约分层说明：产品级结果契约目前只服务 text-to-model，image 与 multiview 结果仍在 provider 层 非目标标注前端查看器由 packages/model3d-viewer 独立实现、本阶段不接 UI 链路，验收补上输入校验与 smoke 行为	2026-09-19 16:19:05 +08:00
k88936	3c1059aa39	移除 TripoUrl 的 Display 实现 ... 删除 TripoUrl 的 Display，避免 `{}` 这类通用格式化输出带签名的完整 URL 完整 URL 仍可通过 as_str() 显式读取，日志与调试统一走 redacted() 或脱敏后的 Debug 技术方案文档补充该收敛说明	2026-09-19 14:17:00 +08:00
k88936	1392303f1c	请求契约把 model 改为必填字段 ... 三个生成请求的 model 由 Option<Model3dModelVersion> 改为必填 Model3dModelVersion，并同步重新生成 TypeScript 绑定 validate_generation_options 不再重复校验 model 缺失，直接由必填的 model 推导 family 三个 client 的 to_sdk_params 改为直接提交模型版本字符串 冒烟示例与技术方案文档同步为必填写法	2026-09-19 14:16:39 +08:00
k88936	800da43a8d	说明生成结果 DTO 的 number 精度边界 ... 为 poll_after_ms、updated_at_micros、size_bytes 补充注释，说明其量级远低于 2^53，按 TS number 导出即可精确表示 重新生成 TypeScript 绑定，把上述说明同步为 JSDoc 技术方案补充同一说明，明确不做 bigint/string 特殊处理	2026-09-19 14:14:14 +08:00
k88936	b703f0c374	同步Tripo集成文档的契约导出与脱敏说明 ... 补充 TripoUrl 脱敏输出与 as_str 读取完整 URL 的说明 补充请求可选字段在 TypeScript 绑定中为 field?: T | null 及 model3d barrel 导出入口 补充 ts-rs 生成后需 prettier 格式化再提交的流程说明	2026-09-19 13:17:58 +08:00
k88936	da9ee65119	记录Tripo真实冒烟结果结构 ... 保留三个生成入口的脱敏真实结果形状与下载产物信息 使用实际可访问的 Rustacean 图片完成 image 与 multiview 示例 同步严格 endpoint 结果契约和真实 Provider 验收文档	2026-09-18 21:42:17 +08:00
k88936	5be4a51ac1	完善Tripo枚举与参数组合校验 ... 按提供的 Tripo 文档补齐 compression、texture quality 与 texture version 枚举 移除未在三个生成接口出现的 style 占位字段并同步 Rust/TypeScript contracts 增加模型版本、纹理版本、生成部件、quad、smart-low-poly 与 face limit 的副作用前校验 同步 Provider 技术方案和 ADR	2026-09-18 17:23:55 +08:00
k88936	37b355a814	接入Tripo三类3D生成Provider ... 加入固定 revision 的 tripo-rust-sdk 与 platform-tripo workspace crate 实现 text-to-model、image-to-model、multiview-to-model 提交、通用任务查询和显式模型下载 抽取通用任务类型、状态映射、输出 URL 校验与 SDK 错误归一，保持 wait_for_task 不对外暴露 同步 Provider 边界文档并暂不接入 api-server	2026-09-18 16:02:13 +08:00
suzmii	6f161a6b36	Merge pull request '修复 AGC 开发态监听 Rust 构建目录导致的加载缓慢' (#382) from fix/agc-vite-target-watch into master ... Reviewed-on: #382	2026-09-17 21:18:59 +08:00
kdletters	0deaabfee6	回填更新摘要端到端展示证据 ... - 主规范记录 0.1.62 渠道清单自动摘要与客户端提示展示的用户实测结论	2026-09-17 21:06:55 +08:00
suzmii	e6849d2a45	Merge branch 'master' into refactor/agc-resource-menu	2026-09-17 20:45:21 +08:00
kdletters	fce546403f	文档记录 Jenkins、预览控制面与预览实例的公网入口口径 ... - 在【开发运维】本地开发验证与生产运维补充 jenkins.genarrative.world 与 build.genarrative.world 的公网入口、反向隧道端口、白名单依赖与排障顺序 - 在 shared-memory/decision-log.md 记录 Jenkins 公网入口、预览部署控制面公网入口、预览控制面公网预览地址口径三组决策及各自验证证据	2026-09-17 20:29:40 +08:00
kdletters	d5743cd4b8	资源画布支持引擎资源预览与模型交互预览 (#413) ... ## 目的 资源画布支持引擎（Cocos Creator）资源的**只读预览**：能被发现、登记、进入画布，并按类型出预览。 ## 主要改动 - 发现层识别 Cocos 资源并区分 `model` / `binary` 两个发现类别；`.meta` 等导入侧车文件仍只可发现 - 登记层按扩展名写入**既有** canonical kind（模型/场景/预制体 → `scene`，动画 → `character-animation`，材质/特效 → `code`，图集与容器 → `document`），不新增 manifest 契约字段 - 引擎工程的 `library/` / `temp/` / `profiles/` / `local/` 不再进入发现结果（仅当目录确实是 Cocos 工程），同名目录在非引擎工程里照常列出 - 资源画布新增三个卡面分支：模型缩略图（整页共用一个 WebGL 上下文）、结构摘要（Cocos 序列化资源）、类型卡（客户端解不了的容器） - 新增模型放大预览浮层：左键旋转 / 右键或中键平移 / 滚轮缩放 / 复位视角 - 模型预览上限 32 MiB；缩略图按布局尺寸 2 倍超采样，缓存键改用稳定身份 - 引擎图像容器（tga/tif/tiff/hdr）在原生侧转码成 PNG 后复用既有图片预览链路 - 修复资源卡状态边框吃掉内容盒导致的卡面与角标位移 - 同步 Agent 提示词与 AGC 技能文档，并补里程碑与踩坑文档 ## 验证 - `cargo check`、`cargo fmt --check` - Rust 定向：`cargo test … cocos` 9 条、`resource_inspect::tests` 7 条、`agent_asset_import_tests` 9 条、生成目录过滤用例 - 前端：`resource` + `project` 套件 52 文件 / 546 用例；`appSurface` 450 通过 / 20 跳过；app `tsc --noEmit` - `npm run check:encoding`、`git diff --check`、`npm run check:doc-index` - 真机：在真实客户端内打开本地 Cocos 夹具工程，逐栏核对模型缩略图 / 结构摘要 / TGA 转码 / 类型卡，并量过卡片在指针移开、悬停、选中三态下几何完全一致 ## 未验证 - 模型缩略图与放大预览的真机视觉只覆盖自带夹具工程；多文件 glTF（外部 .bin/贴图）与超大模型仍是类型卡 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/413	2026-09-17 20:28:39 +08:00
suzmii	c329c438d9	修复资源画布PR的CI回归（#410） ... 修复活动回合空快照引用及停用后晚到请求覆盖问题 对齐共享卡片角标与窗口发布次数回归断言 同步原生HTTP权限检查与图集显式切片测试契约 整理菜单组件导入顺序并记录本地验证范围	2026-09-17 20:17:26 +08:00
suzmii	ed6eced16b	Merge branch 'master' into fix/agc-vite-target-watch	2026-09-17 20:02:14 +08:00
kdletters	724d94c95c	更新摘要降级为不阻断发布 ... - 摘要锚点读取失败时降级为无锚点并告警，不再让整个发布失败 - 无锚点时列出最近 8 条客户端相关提交，并注明可能与上一版重复 - 新增锚点读取失败降级与最近提交兜底的定向用例 - 技术方案补充摘要不阻断发布的约束	2026-09-17 20:00:50 +08:00
kdletters	e146859ea2	更新摘要锚点支持 CI 兜底 ... - 摘要锚点优先取渠道清单 commit，缺失时回退 CI 传入的上一次成功构建 COMMIT_HASH - Jenkins 构建阶段解析上一次成功构建的 COMMIT_HASH 并注入 AGC_UPDATE_PREVIOUS_COMMIT，读取失败保持为空 - 新增锚点优先级与非法值忽略的定向用例 - 技术方案补充锚点兜底说明	2026-09-17 19:42:10 +08:00
kdletters	5ccc46ac1a	调度管线按路径过滤 Full Build 并回填升级证据 ... - 调度管线同时判定 AGC 与 Full Build 两条下游的发布范围，并分别决定是否触发 - Full Build 采用与线上站点/后端无关的路径黑名单，改动落在黑名单外照常部署，避免漏发 - 两条同时跳过时只推进 revision 状态、不触发任何发布，构建描述写明实际触发的下游 - 新增 Full Build 跳过模式守卫用例，并补齐开发运维与技术方案说明 - 主规范回填真实更新闭环证据：0.1.47 客户端完成提示、下载、安装与重启	2026-09-17 19:31:19 +08:00
suzmii	92d1269ccc	Merge branch 'master' into fix/agc-vite-target-watch	2026-09-17 19:30:05 +08:00
suzmii	959beebf63	Merge branch 'master' into refactor/agc-resource-menu	2026-09-17 19:30:00 +08:00
kdletters	ba089980b1	AGC 发布自动生成更新摘要 ... - 发布脚本读取渠道清单的 commit 字段，把上一次发布到本次之间客户端相关路径的提交标题写进清单 notes - 更新摘要同步写入旧协议清单 releaseNotes，并落盘 release-notes.txt 供 Jenkins 归档 - AGC_UPDATE_RELEASE_NOTES 非空时以手动文案为准，缺少上一次 commit 时不写摘要 - 提交取数固定在仓库根执行，避免 pathspec 相对应用目录解析导致漏取 - 新增摘要格式、真实临时仓库取数与调度管线路径表一致性用例 - 同步开发运维文档与技术方案的构建发布条款	2026-09-17 19:26:11 +08:00
suzmii	5adc3032e8	Merge branch 'master' into fix/agc-vite-target-watch	2026-09-17 19:06:11 +08:00
kdletters	6017d46088	AGC 定时发布增加变更路径过滤 ... - 调度管线新增 AGC 发布范围判定：比较上一轮 revision 与本次 revision 的变更路径 - 只有客户端、共享包、server-rs/crates、AGC 插件、桌面壳图标或根依赖清单变化时才触发 AGC Windows Build - 纯文档与流水线提交只触发 Full Build，不再推高客户端版本号 - 判定失败或浅取窗口取不到该 revision 时按需要发布处理，FORCE_TRIGGER 仍强制两条都触发 - 同步开发运维文档、技术方案与调度 job 配置描述	2026-09-17 19:00:45 +08:00
suzmii	260edb3521	合并 master 到 AGC 开发监听修复分支 ... 同步 master 最新代码与文档。 合并排障记录冲突，保留双方新增内容。	2026-09-17 18:58:31 +08:00
kdletters	55af6014ba	修复渠道版本链回退并记录高水位规则 ... - 发布脚本版本来源改为渠道清单与旧协议迁移指针取较大值，避免渠道启用初期把版本链改小 - 旧迁移指针只服务 dev-win，其它渠道不参与比较，旧指针 404 后自动只剩渠道清单 - 补充三条定向用例：旧指针高水位、两者取高、非 Windows 渠道不读旧指针 - 主规范记录版本高水位规则与 2026-09-17 首次渠道发布 0.1.57 退回 0.1.48、后以 0.1.60 纠偏的事实	2026-09-17 18:47:53 +08:00
kdletters	1a7abfd059	AGC 项目定时快照上传（目标 OSS agc-dev） (#400) ... ## 交付内容 - 客户端新增 `project_snapshot` 模块：项目扫描与排除口径、增量索引、差异对比、上传编排、状态查询。 - 触发：工作区窗口存活期间的周期定时器 + 工作区窗口关闭（`CloseRequested`）；应用退出只在有界预算内等待在途同步收尾，不重复发起。 - 服务端新增两条登录态路由 `POST /api/agc/project-snapshots/files` 与 `/manifest`，由 api-server 用服务端凭据写入私有前缀 `agc/project-snapshots/v1/{user}/{project}/`；客户端不持有 OSS 凭据、不直连 OSS。 - `platform-oss` 新增内部对象精确写入与探测、项目快照对象键构造；修复 `head_internal_object` 读 HEAD 响应长度恒为 0（会导致服务端"已存在即跳过"永不生效）。 - `shared-contracts` 新增 `agc_project_snapshots` DTO 与项目 ID、相对路径、摘要校验。 - 真实 OSS 存储层冒烟示例 + 客户端真实链路冒烟用例（`#[ignore]`，env 驱动）。 - 登记 `check-config.mjs` 的 native-only 命令白名单，恢复 `npm run agc` 可启动。 ## 验证证据 - 存储层：`cargo run -p platform-oss --example agc_project_snapshot_live_smoke` 对真实 `agc-dev` 完成写入 → 读回（contentLength 32）→ 清单写入 → 探针清理。 - HTTP 层：登录态下 7 项校验（401 无 token、400 路径穿越/长度不一致/非法摘要/空正文/重复路径清单）全部符合预期且不写对象。 - 客户端链路（真实项目 gameagent-033b6cf3…）：第一次 `synced uploaded=6 uploadedBytes=36694 remoteSkipped=6`，紧接着第二次 `no-op uploaded=0`。 - GUI 触发：`trigger=periodic ... uploaded=6`；把周期设为 600 秒排除干扰、改一个文件后关窗得到 `trigger=project-close ... revision=2 uploaded=1`，索引摘要由 `28d837cd84f8ab62` 推进到 `bff34e2e336d901f`（同步在进程退出前完成）。 - 门禁：AGC `project_snapshot` 14 passed（+1 ignored live）、api-server `project_snapshots` 3 passed、platform-oss 39 passed、shared-contracts 87 passed、`cargo fmt --check`（两处）、`check:encoding`、`check:doc-index`、`git diff --check`、`check-config.mjs` 全部通过。 ## 已知未决（不阻塞本里程碑） - 远端对象只增不减：没有删除路径，也没有 bucket 生命周期规则；要收口需要先定保留语义（清单引用 GC 还是 OSS 生命周期）。 - 部署环境需确认 `GENARRATIVE_AGC_PROJECT_SNAPSHOT_OSS_*` 或回退的 `ALIYUN_OSS_*` 具备目标 bucket 私有前缀的 `PutObject` 权限；未配置时接口返回 503、客户端失败关闭（不推进索引）。 - 缺少按用户/项目的配额与限流（error_reports 有每小时提交上限的先例，本功能没有）。 - 没有界面入口与状态可见性：`read_local_project_snapshot_state` 已注册但未接 UI，失败只写本机日志。 ## 不做 - 不做云端下载/恢复、跨设备合并、版本回滚。 - 不改 `/api/external/v1` 与 External OpenAPI，不新增 SpacetimeDB 表。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/400	2026-09-17 18:34:51 +08:00