4250 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
k88936	f90e114bcb	生成目录化的Tripo API与画布TS绑定 ... - 生成模型输入、结果落点、产物元数据与按端点的结果类型到 packages/shared/src/contracts/model3d 子目录 - 新增 editor-canvas 生成目录，画布占位载荷不再依赖手写 TS - 更新 model3d 导出索引，移除已删除的占位作业类型 - contracts:model3d:generate 生成后自动跑 prettier	2026-09-21 12:39:33 +08:00
k88936	7790a181c4	provider按参数分层并公开组合校验入口 ... - submit 改为接收生成参数，图片输入由调用方解析后单独传入 - 公开 validate_text_to_model_params / validate_image_to_model_params 供平台层在副作用前预检 - 参数到 provider 校验选项的映射收敛为 From 实现，去掉重复拼装 - smoke 示例跟随新签名	2026-09-21 12:39:20 +08:00
k88936	e0108f7d57	分层Tripo生成的provider参数与平台API请求契约 ... - common 新增 Model3dGenerationSource、Model3dGenerationTarget、Model3dGenerationTargetRef 与产物元数据 - text/image 各自的参数类型独立成 params，API 请求为 generation + 平台字段 + target - 图片输入只接受站内引用，input 由服务端解析后注入 provider - 删除宽松的作业与结果占位 DTO，改为按端点的严格结果与端点 tagged enum - 新增契约严格性测试，覆盖分支必填字段、图片输入歧义与顶层未知字段	2026-09-21 12:38:46 +08:00
k88936	93306952d9	把画布占位载荷移出受feature门控的assets模块 ... - 新增 shared-contracts::editor_canvas，承载画布占位与回填载荷并接入 ts-rs 生成 - assets 模块改为内部引用该类型，不再自带定义 - api-server 七处引用改到新模块路径	2026-09-21 12:38:28 +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	188614d5d2	改用Provider流式下载Tripo产物 ... 保持第三方SDK不变并在Provider侧读取签名模型URL 逐块暴露模型响应并校验Content-Length，smoke示例改为异步落盘 为未来SDK原生stream能力保留迁移TODO	2026-09-19 23:14:00 +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	b0054fd51c	新增 3D 模型查看器独立包 ... - 新增 packages/model3d-viewer（@genarrative/model3d-viewer），含 Model3DViewer、scene、loader、framing、status 与 index - 组件只走 WebGL2 单一路径渲染 glb、单文件 gltf 与 fbx，未承诺格式或超过 32 MiB 时只渲染一行状态文案 - 取景按真实顶点做投影拟合，与模型尺度无关，复位回到打开时的取景 - 新增 framing 与 loader 的纯函数单测 - 根 package.json 的 workspaces 增加 packages/model3d-viewer - scripts/check-npm-workspaces.mjs 与 scripts/check-npm-workspaces.test.mjs 同步工作区清单 - vitest.config.ts 增加新包测试匹配 - 同步 package-lock.json 的工作区链接	2026-09-19 16:13:55 +08:00
k88936	0c4b1c34d9	标注模型下载的重复 task 查询 ... 在 download_model 增加 TODO，说明 SDK 只提供 download_model(&Task) 因而必须再取一次 task 若将来 SDK 支持按 URL 下载，可直接使用 snapshot 中的模型 URL 省掉这次请求	2026-09-19 14:17:31 +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	12512f26b2	multiview 输入拒绝未知字段 ... Model3dMultiviewInputs 增加 deny_unknown_fields，与 Model3dMultiviewToModelRequest 的严格反序列化保持一致 未知视图键（例如拼写错误的 righ）不再被静默丢弃，避免用少于调用方预期的视图提交任务 ts-rs 12 不支持 enum 级该属性，构建时会打印一条可忽略的告警，已在代码注释说明	2026-09-19 14:14:55 +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	b87d9358e5	对齐 Api 与 Request 的可重试状态码 ... TripoError::is_retryable 的 Api 分支补充 408 与 425，与 Request 分支的可重试集合保持一致	2026-09-19 13:15:31 +08:00
k88936	f4996d7ac2	auto_size 仅在显式开启时按模型能力拦截 ... validate_generation_options 中 auto_size 的 H25 校验由 is_some() 改为 == Some(true) auto_size: false 不再被当作启用，与 quad、smart_low_poly、generate_parts 的取值语义保持一致	2026-09-19 13:15:00 +08:00
k88936	09ef92420f	multiview 复用统一的 task_id 校验 ... 删除 submit_multiview_to_model 中重复的空白判断，改为调用 common::validate_task_id task_id 非法时的错误字段由 Inputs 改为更精确的 TaskId，与 get_task、download_model 保持一致	2026-09-19 13:14:32 +08:00
k88936	091938ed59	multiview 提交前裁剪 task_id ... to_sdk_params 改为提交 task_id.trim()，与 task_id.trim().is_empty() 的校验使用同一份标准化输入 带前后空白的 task_id 不再原样转发给 Provider	2026-09-19 13:13:54 +08:00
k88936	ddb8b9e8ba	multiview 空白视图按未提供处理 ... to_sdk_params 新增 optional_view，将仅含空白的 left、back、right 归一化为未提供 空白视图不再以 Some(FileInput) 形式提交，与提交前“至少两个视图”的校验保持一致	2026-09-19 13:13:35 +08:00
k88936	230e4d49f2	image_to_model 提交前统一使用裁剪后的输入 ... to_sdk_params 改为传入 request.input.trim()，与提交前的空值校验使用同一份标准化输入 带前后空白的输入不再原样转发给 Provider	2026-09-19 13:12:50 +08:00
k88936	6c209b115a	冒烟示例在任务未完成时跳过下载并继续后续入口 ... 轮询改用 throw_on_failure=false，失败终态交回示例按 status 判定而不是直接返回错误 非 Completed 的任务打印 status 与 failure 后 continue，避免一个入口失败中断其余入口的冒烟	2026-09-19 13:12:23 +08:00
k88936	b631125a16	冒烟示例不再输出完整下载地址 ... 产物行改用 TripoUrl::redacted()，避免把带签名的下载 URL 写入标准输出	2026-09-19 13:07:41 +08:00
k88936	771ff88440	脱敏 TripoUrl 的 Debug 输出 ... 为 TripoUrl 手写 Debug 实现，改用隐藏 query 与 fragment 的脱敏形式 新增 TripoUrl::redacted 提供日志用脱敏 URL，完整 URL 仍由 as_str 显式读取 TripoTaskSnapshot、TripoTaskOutput、TripoDownloadedModel 的调试输出随之不再暴露带签名的下载地址	2026-09-19 13:07:41 +08:00
k88936	950209f038	为 model3d 请求契约的可选字段补充 ts(optional) ... 为 image_to_model、multiview_to_model、text_to_model 三个请求的可选字段添加 ts(optional = nullable) multiview 视图分支的 left、back、right 同步标记为可选 重新生成 packages/shared/src/contracts/model3d 下的 TypeScript 绑定，使 TS 侧可按 serde 语义省略字段	2026-09-19 13:07:41 +08:00
k88936	42a5929a73	清理 model3d 请求契约中冗余的 serde(default) ... 移除 image_to_model、multiview_to_model、text_to_model 三个请求结构体 Option 字段上的 serde(default) 同步移除 multiview 视图分支中三个可选视图的 serde(default) serde 对 Option 字段本身即按 None 处理缺失字段，生成的 TypeScript 绑定保持不变	2026-09-19 13:07:41 +08:00
k88936	eda9da4d8d	单点维护 model3d 的 ts-rs 导出根目录 ... 在 model3d/mod.rs 新增 model3d_ts_export_dir 宏，集中定义仓库相对导出根路径 common、image_to_model、multiview_to_model、text_to_model 改为调用宏并只声明各自子目录名	2026-09-19 13:07:41 +08:00
k88936	35be25dbd6	补齐 model3d 契约在 packages/shared 的导出入口 ... 新增 packages/shared/src/contracts/model3d/index.ts 聚合 ts-rs 生成的 3D 生成契约类型 contracts/index.ts 增加 export type * from './model3d' src/index.ts 增加 export type * from './contracts/model3d'	2026-09-19 13:02:01 +08:00
k88936	da9ee65119	记录Tripo真实冒烟结果结构 ... 保留三个生成入口的脱敏真实结果形状与下载产物信息 使用实际可访问的 Rustacean 图片完成 image 与 multiview 示例 同步严格 endpoint 结果契约和真实 Provider 验收文档	2026-09-18 21:42:17 +08:00
k88936	527706b84e	按接口收紧Tripo任务结果类型 ... 为 text、image、multiview 三类生成定义独立必填结果结构 以枚举关联任务类型与具体结果并对缺失字段失败关闭 将通用 URL 类型由 TripoModelUrl 更名为 TripoUrl	2026-09-18 21:37:38 +08:00
k88936	a4beb53dc6	完善Tripo冒烟CLI产物流程 ... 等待三类生成任务完成并打印映射后的输出 完成后下载模型产物到当前目录并输出文件信息 仅在示例内部使用SDK轮询器，不扩展平台公共接口	2026-09-18 18:51:49 +08:00
k88936	25314d9a4a	新增Tripo三类生成冒烟CLI ... 增加仅通过环境变量配置的 Tripo generation example 顺序提交 text、image、multiview 三类任务并执行单次状态查询 保持无命令行参数且不调用 SDK 轮询接口	2026-09-18 18:42:58 +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
k88936	1c4009ea3b	建立3D生成目录化契约 ... 新增 model3d common、text-to-model、image-to-model、multiview-to-model Rust contracts 通过 ts-rs 按目录生成 TypeScript bindings，移除依赖 barrel 的组织方式 增加 model3d contracts 定向生成脚本	2026-09-18 15:59:19 +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	133bb2f350	修正 AGC 原生 HTTP 契约守卫与更新摘要证据 ... - 契约守卫不再要求 http 插件放行 OSS 域名：更新清单与安装包下载已改由 tauri-plugin-updater 在原生侧完成 - 主规范回填 0.1.62 自动更新摘要与客户端提示展示的用户实测证据	2026-09-17 21:06:55 +08:00
kdletters	0deaabfee6	回填更新摘要端到端展示证据 ... - 主规范记录 0.1.62 渠道清单自动摘要与客户端提示展示的用户实测结论	2026-09-17 21:06:55 +08:00
suzmii	c16e32cc89	Merge pull request '重构AGC资源画布菜单与卡片入口' (#410) from refactor/agc-resource-menu into master ... Reviewed-on: #410	2026-09-17 20:56:43 +08:00
suzmii	e6849d2a45	Merge branch 'master' into refactor/agc-resource-menu	2026-09-17 20:45:21 +08:00
kdletters	f5b4293e80	预览控制面支持展示公网预览地址 ... - preview-deployer-server 新增可选配置 GENARRATIVE_PREVIEW_DEPLOYER_WEB_DOMAIN，并按「实例 ID + 预览域名」派生公开字段 webPublicUrl，卸载时与 webUrl/webPort 一起清空、加载状态文件时重新派生覆盖 - preview-deployer-web 在存在公网地址时把「打开公网预览」作为主入口，内网地址降级为次级链接，未配置时行为不变 - deploy/env/preview-deployer.env.example 补充 WEB_DOMAIN 键与留空语义说明 - 补充 cargo 与 vitest 用例覆盖公网地址派生、域名配置校验与页面展示	2026-09-17 20:29:42 +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