391 Commits

Author	SHA1	Message	Date
k88936	40c97bf876	旧 external_generation_job 归一化用例改成真断言 ... - server-rs/crates/spacetime-module/src/migration.rs：provider_kind / provider_task_id 的断言改成先 as_object() 取键再比 null，原先用 Value 索引在键缺失时返回 Null，归一化被删掉也照样通过	2026-09-24 17:48:41 +08:00
k88936	14294a2c9b	修掉多视图生成 3D 请求文档注释里的漏字 ... - server-rs/crates/shared-contracts/src/model3d/multiview_to_model/request.rs：公开文档注释「多视图生 3D」补回漏字，改成「多视图生成 3D」	2026-09-24 17:46:54 +08:00
k88936	ff38eb0308	Merge remote-tracking branch 'origin/master' into feat/tribo3d-integeration ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md # docs/project-memory/shared-memory/pitfalls.md	2026-09-24 15:28:01 +08:00
kdletters	87e52860a7	游戏发行入口改为平台同源路径 ... - 审核通过时由 api-server 按 gameId 派生 /games/{gameId}/ 相对路径写入公开投影，删除 AppConfig 的发行入口模板字段与读取逻辑 - 删除 deploy/env 两份示例中的 GENARRATIVE_GAME_DISTRIBUTION_RELEASE_ENTRY_TEMPLATE - 三份 nginx 模板内联同源发行入口 location，把 /games/<gameId>/ 与子资源转发到发行网关并在边缘清空 Cookie - SPA allowlist 补齐 components、design-system、games、games/detail、games/mine、games/play、games/publish - 前端 normalizeGameEntryUrl 支持相对路径与同源发行路径，按当前 origin 解析并补尾斜杠，继续兼容历史绝对 URL - 删除退役的独立来源模板 deploy/nginx/genarrative-release-origin.conf、门禁脚本 scripts/check-release-origin-config.mjs 与其 npm 脚本 - 游戏分发 e2e 脚本改为在公开投影上断言 entryUrl 等于 /games/{gameId}/ - 同步平台主规范、运维主规范、nginx README 与共享决策记录	2026-09-24 00:21:27 +08:00
kdletters	cc958f3678	后台新增游戏管理页与全量游戏列表接口 ... - SpacetimeDB 新增 list_admin_game_distribution_games_and_return：一个事务内返回全量游戏、版本数与最近 20 个版本，作者名/头像读时联 user_account - SpacetimeDB 新增 restore_game_distribution_game_and_return：恢复管理员暂停的游戏时重新激活最近一次由管理员暂停撤回的公开版本，作者自行下架的版本不会被恢复 - 后台新增 GET /admin/api/game-distribution/games 与 POST /admin/api/game-distribution/games/{gameId}/restore，并新增 game-management Tab 权限，待审队列仍只属于 editor-showcase - admin-web 新增 #game-management「游戏管理」页：标题/作者/gameId/状态/版本数/游玩数表格，行内下架、恢复与版本历史弹层，复用现有后台表格与二次确认 - 同步生成 spacetime 绑定并更新后端架构数据契约文档	2026-09-23 21:46:40 +08:00
kdletters	1b05a1d05e	后台充值订单实付口径、发放泥点列、用户累计充值与兑换码单位 ... - 新增 AdminRechargeOrderEntryPayload.paidAmountCents：只有 paid_at 存在的订单才有实付，未支付 / 已关闭 / 已过期固定为 0 - 充值管理列表把「金额 / 泥点」拆成「实付」「发放泥点」两列，未支付行实付显示「未支付」并附订单金额小字；退款面板「订单实付」改读同一字段 - 用户详情充值订单表新增「发放泥点」列，商品列只保留商品名，实付同样按 paidAmountCents 展示 - 用户详情新增 cumulativeRechargedCents：api-server 按 user_id 读取 profile_recharge_order，只累加 paid_at 存在的订单金额（退款不回减），单次上限 500 行，读取失败或命中上限返回 null - 用户详情身份区新增「累计充值」，读不到时显示「未知」，不用用户详情最多 20 条订单在 BFF 或前端近似重算 - 兑换码奖励单位收口为泥点：输入标签与列表列头改「奖励泥点」，单元格带「泥点」单位，避免被当成元 - 新增后端 2 条累计充值口径单测与前端 2 条用例（未支付不显示实付且发放泥点独立成列、累计充值未知态） - 同步后端架构数据契约（实付口径 / 累计充值来源与上限 / 兑换码奖励单位）与决策记录 - 验证：cargo check -p api-server；cargo test -p api-server --bin api-server admin（138 passed / 0 failed / 1 ignored）；npm run admin-web:typecheck；npx vitest run apps/admin-web/src（220 passed）；cargo fmt --all --check、check:encoding、check:doc-index、git diff --check 通过	2026-09-23 20:10:20 +08:00
kdletters	0dbd279dfc	后台 Dashboard 消耗泥点改为对冲退还后的净消耗 ... - consumedMudPoints 改为净额：按北京时间业务日先抵当日消耗，不足再回溯抵扣最近仍有净额的业务日，抵扣不完的丢弃，每日净额非负且区间合计严格等于「消耗 − 退还」 - 退还口径并入 asset_operation_refund 正向流水（生成失败退还、精选审核返还）与 llm_router_consume 正向冲正流水；充值退款追回、余额重置、赠送和 hold 仍不计入 - 契约新增 refundedMudPoints，后端新增「退还泥点」趋势图，后台时段数据并列「退还泥点数」卡，毛消耗可由「消耗 + 退还」核出 - 新增 4 条净额单测（同日对冲 / 回溯抵扣 / 超额归零 / 无退还保原值）与 Dashboard 用例断言 - 同步 Dashboard 运营看板方案指标口径与决策记录 - 验证：cargo test -p api-server --bin api-server admin（136 passed / 0 failed / 1 ignored）、npm run admin-web:typecheck、npx vitest run apps/admin-web/src（218 passed）、cargo fmt --all --check、npm run check:encoding、npm run check:doc-index、git diff --check 全部通过	2026-09-23 19:56:24 +08:00
k88936	d231cc4602	合并 origin/master：保留 3D 契约与 provider checkpoint，旧玩法表随主线退役 ... - server-rs/crates/shared-contracts/src/lib.rs：采用主线的模块裁剪（删掉 cfg(any()) 遗留模块、补上 agc_analytics 与 game_distribution），同时保留本分支的 editor_canvas、model3d 模块与 EDITOR_GENERATION_OPERATION_KINDS 导出 - server-rs/crates/spacetime-module/src/migration.rs：主线删除的 410 行旧玩法表 normalize 段保持删除，保留本分支的 provider_kind / provider_task_id 兼容段与对应用例 - docs/【开发运维】本地开发验证与生产运维-2026-05-15.md：校验清单同时保留 Tripo 3D 生成任务与 editor_background_music_generation / model3d_text_to_model / model3d_image_to_model - .gitignore：补回本分支新增的 3D 模型文件忽略规则（*.glb / *.gltf 等 12 行），压测数据段随主线一并删除 - 共享记忆：本分支的 3D 决策与踩坑条目保留在主线重排后的 decision-log.md 与 pitfalls.md 中	2026-09-23 19:39:30 +08:00
k88936	f198b7a6d0	multiview 视图输入显式化为 url / fileToken，线上按文档 view-key 形态发出 ... - 契约新增 Model3dViewInput（url / fileToken 的 tagged enum），views 的四个视图都改用它，裸字符串在契约层即被拒绝 - platform-tripo 不再走 SDK 的位置数组形态：按 Tripo 文档推荐的 view-key 构造 inputs，值写成显式 {url} / {file_token}，种类由契约字段决定、链路上不再猜前缀 - 视图校验（front 必填、至少两张、空白按未提供）与 inputs 构造合并成一条路径，不再两处重复规则 - 新增 4 条定向用例钉住发出的 JSON 形状、空白视图、视图数量与 taskId 复用；契约用例补齐裸字符串与视图内未知字段被拒 - 重新生成 ts-rs 绑定与导出索引，技术方案同步 multiview 输入口径	2026-09-23 18:59:05 +08:00
kdletters	297d7bf1e7	优化 AGC 发布资料与截图交互 ... 发布门禁阻断提示改为独立弹窗且不写入聊天记录 移除发布面板发行包技术摘要 新增免费发布简介与分类建议接口和前端回填 接入封面泥点定价、确认与生成流程 截图改为并行上传，单张失败隔离且不阻断发布 截图操作改为图标，失败项内嵌错误与删除 同步发布合同、实施计划和决策记录	2026-09-23 17:40:08 +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	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	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
kdletters	43b7aa809b	清理旧创作模板退役过程记录与死代码 (#489) ... - 删除一次性 schema guard 退役表白名单、isApprovedRetiredTableDeletion 导出与专属测试，compareTables 收回为内部函数 - 删除 shared-contracts 未挂载的旧玩法契约模块、api-server 旧 story 模块与旧压测资源 scripts/loadtest/ 及对应忽略/排除配置 - 清理 decision-log、pitfalls 中旧表退役、两阶段清表窗口与旧玩法过程记录，保留改写后的通用条目 - 移除权威文档、模块 README 与运维文档中的旧模板、历史表与旧压测叙述 Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/489 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-23 11:46:39 +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
lhk229	1e186369c9	客户端埋点设置 (#446) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/446 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-23 00:09:12 +08:00
k88936	62bf602fb1	多视图请求 DTO 补齐字段级说明并重生成绑定 ... - Model3dMultiviewToModelRequest 每个字段补一行中文语义说明与取值范围 - 结构体补严格反序列化与组合校验归属的说明 - 重新生成 ts-rs TS 绑定，注释同步进 Model3dMultiviewToModelRequest.ts	2026-09-22 16:48:57 +08:00
k88936	2348315dba	3D 结果打标契约测试补齐 preview 与 imageToModel 分支 ... - textToModel 用例补 preview 产物的相等断言 - 新增对称的 imageToModel 用例，守住 tag 路由与分支字段 - 裸字符串 source 的负例改为点名 Model3dGenerationSource 并单独反序列化 source 值	2026-09-22 16:46:19 +08:00
kdletters	f1b282f3cd	合并 master 并接入 DirectProject 新聊天架构 ... - 合并 origin/master（304 个提交：DirectProject 聊天容器重构、Project Supervisor 退役、策划附件导入、CI 隔离编译缓存等）。 - 接受 master 对 ProjectSupervisorView / SupervisorChatOnlyView 的退役与预览快捷测试收敛；发布入口改由 DirectProject 聊天头承载。 - DirectProjectChatHeader 新增「发布到游戏广场」入口（无回调不渲染、回合忙态禁用），DirectProjectChatView 透传 onRequestGamePublish。 - App.tsx 继续由工作台壳持有试玩包导出与 GameDistributionPublishPanel，沿用 project.export_package 权限确认队列；check-config 把该命令从 native-only 清单移回 App invoke。 - 后台游戏审核 API / 类型 / 路由测试与 master 新增的 AGC 模板管理按双方保留合并，并修掉拼接造成的接口与用例闭合缺陷。 - 修正 master 自带的 viteProxyConfig 断言：/api/creation-entry 属退役路由，测试改为断言不进入代理。 - 记录合并踩坑：语法结构内部的冲突不能简单按「双方保留」拼接，必须按某一侧骨架重建并跑 tsc 与单文件测试。 - 验证：全量 vitest 393 文件 / 4374 用例通过，root / AGC / admin-web 三端 typecheck，cargo check 与游戏分发 Rust 测试，encoding、doc-index、rustfmt、SpacetimeDB schema guard。	2026-09-22 16:45:29 +08:00
k88936	48cde9624c	operation_kind 白名单改为两 crate 共用的共享常量 ... - 白名单常量迁到 shared-contracts 并从 crate 根导出 - spacetime-module 的原子落库事务改为引用该常量，删除本地重复定义 - api-server 的登记测试不再解析对方源码文本，改为直接断言常量内容 - 后端架构文档补上白名单常量的位置与共用口径	2026-09-22 16:30:28 +08:00
k88936	9800477c7c	模型版本清单从声明表派生避免漏加新版本 ... - Model3dModelVersion 的变体、线上值与 ALL 改为由 model3d_model_versions! 单一声明表生成 - ALL 类型改为 &'static [Self]，新增版本只需在声明表加一行 - 定价校验与测试的遍历改用 iter().copied()	2026-09-22 16:03:55 +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	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
k88936	c0d6531e92	三个入口的seed参数在TS契约里改用bigint ... - seed 是 i64，JS number 表示不了全部取值却又没有范围校验，客户端传 64 位值会被静默舍入 - text_to_model / image_to_model / multiview_to_model 的 image_seed、model_seed、texture_seed 由 number|null 改为 bigint|null - 同步重新生成的 ts-rs 绑定，仅这三个字段变化	2026-09-21 19:38:47 +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	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	aebbd3bb99	多视图输入变体字段统一按camelCase序列化 ... - Model3dMultiviewInputs 的 serde 属性补 rename_all_fields = camelCase，结构体变体字段不再逐字段手工 rename - TaskId 变体去掉冗余的 taskId 显式 rename，序列化结果与生成绑定均无变化	2026-09-21 15:20:36 +08:00
k88936	d4af6802fb	补多视图请求契约的全字段往返用例 ... - 新增全字段往返：钉住 camelCase 字段名、各枚举线上取值与 Option 的可省略写法 - 新增显式 null 往返：确认可选字段回写时仍是 null 而不是整字段消失 - 补用例后字段改名或可空性漂移会被测试拦住，不再是只在 TS 绑定里可见	2026-09-21 15:16:06 +08:00
kdletters	02a7abeb3f	新增后台 AGC 模板管理与模板库内容寻址落库 ... - 后台新增「模板管理」页：按权限查看并编辑模板名称/简介/标签/封面，支持上架与下架；路由、侧栏、tab 权限、API 客户端与 DTO 同步接入 - api-server 新增 /admin/api/agc-templates 读取与更新路由，复用现有后台鉴权与 tab 权限校验，权限不足按既有失败关闭口径拒绝 - module-assets 收敛模板库纯规则（active/inactive 投影、索引 schema 与重复项校验、ZIP 大小与摘要核对），platform-oss 承担对象存储读写、不可变对象复用与发布互斥锁 - shared-contracts 补后台模板 DTO；spacetime-module 账号存储适配保持既有 schema 不变 - AGC 壳内置模板索引与建项读取改为内容寻址对象，补模板安装、越界归档、索引不匹配等用例 - 模板库发布脚本支持定向发布与上架/下架合并、内容地址复用与锁语义，CLI 守卫用例同步；jenkins 两条客户端打包管线统一触发邮件通知 Job 并传递首装包链接 - 内置 5 个 Cocos 官方模板载荷与索引 fixture（内容地址对象，共 90 个文件） - 补「后台模板管理」里程碑与实施计划，更新模板库技术方案、开发运维文档与共享记忆 - 验证：admin-web 39 项用例与 typecheck、发布脚本 25 项用例、api-server 与 AGC 壳编译、模板库定向 Rust 用例（AGC 壳 18 项、module-assets/platform-oss 16 项、后台权限 1 项）、check:encoding / check:doc-index / check:production-ops / rustfmt 全部通过	2026-09-21 13:56:20 +08:00
k88936	8f6458ffe2	新增api-server Tripo3D模块与泥点定价结构 ... - 新增 tripo3d/pricing.rs，底价按 endpoint × 模型版本 × 是否有贴图，add-on 按固定键表叠加 - 定价段加载即校验全部底价与 add-on 键，缺键即配置非法；缺段代表未配置，查价直接拒绝 - editor_generation_config 挂载可选 model3d 段并提供 fail-closed 查价入口 - 后台记录形状尚不支持 3D 段，暂由文件配置提供并留下同步待办 - model_version 增加 ALL 与排序，供定价表枚举校验	2026-09-21 12:53:02 +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
kdletters	4a2b270714	补齐游戏分发封面与截图的冻结、上传与展示 ... - 服务端：游戏表追加可空 cover_object_key / screenshots_json，版本表追加可空 metadata_json，创建版本时校验必需封面、最多 6 张截图与图片素材归属，并从素材记录派生对象键生成冻结资料。 - 服务端：审核通过时把冻结资料整体生效到游戏行；只有已公开且存在有效活动版本的游戏，其封面/截图素材才在 /api/assets/read-url 获得匿名读授权。 - 服务端：作者与管理员回读版本时追加 frozenMetadata，带回封面与截图素材 ID 供续发复用，公开投影仍只暴露对象键。 - 网页：/games/publish 新增「封面与截图」区，复用平台图片直传与 confirm 通道，缺封面或截图超量在发请求前拦截，更新版本时按冻结资料回填且不要求重新上传。 - 网页：游戏广场卡片与详情页 hero 换签展示真实封面，详情页新增可点击的截图缩略图条，无素材或换签失败时静默回退原有渐变占位。 - AGC：发布面板支持封面必选与截图最多 6 张，新增素材直传服务并在创建游戏前拦截缺封面，同一文件重复提交复用素材 ID。 - AGC：http 能力作用域新增阿里云 OSS 直传地址，客户端同时校验直传目标必须是平台素材存储。 - 契约与文档：同步 shared-contracts、packages/shared 契约，更新 SpacetimeDB 迁移注释、后端架构、玩法链路与实施计划文档，并补齐网页端与 AGC 定向测试。	2026-09-20 22:19:50 +08:00
kdletters	429f991bde	回滚误入 master 的游戏分发 WIP（夹带在 OSS v1 签名提交里） ... - 撤销 39aed2e48 夹带的游戏分发前后端、SpacetimeDB 绑定、主站路由、后台审核页、文档与 nginx 改动，master 恢复可编译状态 - 保留该提交自身的 AGC 发号改动：agc-global-version.mjs 与其参数构造单测 - 恢复被误删的 output 产物，避免把无关清理混进该提交 - 补回两篇技术文档在 docs/README.md 的索引（它们属于后续两个补提交文档，不属于游戏分发） - 游戏分发完整实现保留在 codex/game-distribution 分支继续开发	2026-09-20 20:52:24 +08:00
kdletters	328ac31844	恢复游戏分发完整实现（特性分支） ... - 主站：游戏广场、详情、在线游玩、网页发布与作者中心，以及共享契约与客户端服务 - 后端：module-game-distribution 领域层、SpacetimeDB 表/迁移/绑定、spacetime-client facade、api-server 路由与发行网关 - 后台：游戏审核页（待审列表、通过/拒绝、安全下架） - AGC：发布面板、本地导出包读取命令与发布服务，含默认跳过的真实链路测试 - 运维：发行来源 nginx 模板与门禁、game-distribution:publish 灰度发布开关、OSS PutObject 受控重试 - 文档：主规范、里程碑与实施计划、决策日志与踩坑记录	2026-09-20 20:49:42 +08:00
kdletters	39aed2e486	OSS 写入显式使用 v1 签名 ... ossutil v2 默认 v4 签名，缺 region 会直接失败\n总号写入与回读统一走 buildOssutilArgs，默认 --sign-version v1，可切 v4 并配合 AGC_OSS_REGION\n补充参数构造单测	2026-09-20 18:33:02 +08:00
kdletters	5822b64d7c	合并 Godot 编辑器插件与常用操作指导到主分支 ... 接入 Godot 原生桥、受控执行、Runner 回执与编辑器操作指南 保留主分支 Cocos 和 Unity 跨工程能力及外置提示词结构 解决插件生命周期、工具目录、前端启动和文档合并冲突	2026-09-20 17:38:48 +08:00
kdletters	54d0fb75ea	接入 Godot 编辑器插件与受控执行链路 ... 新增 GDExtension 自动引导、GDScript 执行和实例隔离缓存 接入 AGC 插件开关、Runner、Agent 工具与权限审计 完善执行回执确认、不确定状态阻断及卸载恢复 补齐 Windows 分发资源、定向测试与实机验收文档	2026-09-20 16:35:04 +08:00
lhk229	70271b408e	删除策划agent v2，与退役功能解耦 (#355) ... Reviewed-on: #355 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-20 14:49:57 +08:00
kdletters	15774a1c02	修复项目自动上传并增加后台完整工程下载 ... 接入真实项目打开、切换和关闭生命周期并修复退出等待竞态 新增后台项目列表及按原目录校验导出的 ZIP 下载 补充快照完整性元数据、后台权限和取消清理 固定默认 AGC 存储目标并支持空文件与特殊字符路径 补充自动化测试及真实 OSS 只读导出验证 记录本地数据库 404 导致完整 HTTP 联调和安装版实机验证待补	2026-09-20 10:07:31 +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
kdletters	e3682fd06f	固定客户端dev服务并支持官网多平台下载 ... 移除服务器选择并按来源隔离登录凭据 新增官网客户端下载入口和匿名平台聚合接口 根据发布清单自动展示Windows与macOS首装包 补齐Mac首装元数据和上传顺序校验 同步定向测试与下载发布规范	2026-09-19 16:19:28 +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	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	48caa23997	收紧AGC资源kind枚举边界 ... canvas生成与运行时统一使用共享GameCreationAppAssetKind 删除平台kind兼容映射与退役kind拒绝测试 更新资源kind审计里程碑与绑定文档	2026-09-19 01:28:27 +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