1199 Commits

Author	SHA1	Message	Date
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
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
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	cf19241544	游戏发行入口改为服务端按模板派生 ... - 后台审核页删除「发行入口」输入框与前端 HTTPS 校验，审核请求只提交结论与公开修订号 - api-server 新增 GENARRATIVE_GAME_DISTRIBUTION_RELEASE_ENTRY_TEMPLATE 模板配置，审核通过时读版本取 gameId 并派生该游戏独立来源地址 - 模板缺 {gameId}、生产未配置模板、gameId 非主机安全字符或派生结果非法时审核通过失败关闭，非生产未配置时回落本地回环发行网关 - 同步更新发行来源 nginx 模板与说明、两份 api-server 环境变量样例、平台与运维主规范、发行里程碑实施计划和决策记录 - 真实栈 e2e 脚本不再传 entryUrl，并断言审核结果里的入口为服务端派生值	2026-09-23 21:33:42 +08:00
kdletters	985df53a4e	Router API Key 分组改为与账号同组的 taonier ... - LLM_ROUTER_TOKEN_GROUP 由 default 改为 taonier，Router 用户与它名下固定 Token / API Key 现在同属 taonier 分组 - 保留固定契约归一：创建后无条件 PUT 完整契约（group / unlimited_quota / expired_time），复用与登录恢复路径同样 PUT，存量 default 分组 Token 会在下次 provisioning、登录恢复或显式准备 Key 时纠正 - 同步创建路径与复用路径的注释，保留“分组缺模型会失败为 model_not_found”的排查提示 - 用例同步：2 个用例重命名为 taonier 语义，6 处 group 断言改为 taonier - 文档同步：外部 OpenAPI 与 APIKey 接入方案写明 Token 与用户同组 taonier 及其前提；决策记录追加 2026-09-23 调整说明 - 验证：cargo test -p api-server --manifest-path server-rs/Cargo.toml --bin api-server external_api_keys（22 passed）、同命令 router 过滤（27 passed）、cargo fmt --all --check、npm run check:encoding、npm run check:doc-index、git diff --check	2026-09-23 20:52:01 +08:00
kdletters	1e0aeb95b0	后台表查询枚举列按 schema 展示变体名，不再只看数值 ... - 新增按 SpacetimeDB schema 解析枚举展示名的实现：读取 typespace.types 与表的 product_type_ref，为每个「Sum 且变体全为单元变体」的列建立按变体索引排列的展示名，变体名归一到 snake_case - 支持 Option<枚举> 列：标记 optional，[0, [索引, []]] 出变体名、[1, []] 仍是空值；Option<普通值> 与带载荷的 Sum 继续走通用解码，单变体枚举同样出名字 - 删除只覆盖 profile_recharge_order.kind / status 的硬编码映射 normalize_admin_database_known_enum - 枚举展示名同时作用于行的 cells 与 raw，关键词搜索、结构化筛选和稳定排序都按展示名生效 - 表查询行解析与行构建改为接收枚举映射，schema 夹具用例覆盖直接枚举、Option 枚举、单变体枚举与未知表 - 同步开发运维文档的表查询口径段、后台 skill 的 SATS 展示参考与决策记录 - 验证：cargo test -p api-server --manifest-path server-rs/Cargo.toml --bin api-server admin（139 passed / 0 failed / 1 ignored）；cargo check -p api-server；cargo fmt --all --check；npm run check:encoding；npm run check:doc-index；git diff --check；本地 dev schema 回放同一算法，85 张表 32 个直接枚举列 + 2 个 Option 枚举列全部解析出展示名、0 残留	2026-09-23 20:52:00 +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
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
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
kdletters	c2c5e1ced5	发行包上限提升到 200 MiB 并支持 AGC 分片续传上传 ... - 发行包上限 100→200 MiB、展开总量 250→500 MiB，整包路由请求体上限继续从包上限派生；发行静态资源进程内缓存预算提到 256 MiB - 反代放行量同步放宽到 210 MiB：Nginx 三份模板的 client_max_body_size、Pingora 网关默认值与 env 样例、路由对照矩阵 - platform-oss 新增内部对象追加写 append_internal_object(_with_retry)，以 OSS 返回的 next-append-position 作为权威已收字节 - api-server 新增 upload-state / chunk / complete / reset 四条分片路由，抽出共享收口 confirm_validated_package；偏移不符返回 409 与权威偏移，校验失败删除半包并落 upload_failed - AGC 新增原生上传器 game_package_upload.rs（内容寻址暂存、分片续传、受控重试、进度事件）与 prepare / upload 两条命令，退役整包回传命令 - 渲染进程改为 prepare → 创建游戏 → 创建版本 → 原生分片上传 → 送审，LocalProjectExportPackagePayload 整包类型退役 - 同时修正 live 用例无法指向本地栈的两处基础设施问题：平台基址按传入 URL 选择，桥接层把 jsdom realm 的 Headers / Blob / FormData 降级成 Node 原生值 - 测试：platform-oss 74、api-server game_distribution 23、AGC 原生 4、发布相关前端 20；live 用例补真实栈「中断 → 续传 → 确认」断言（分片偏移序列 [0, 8388608]） - 文档：玩法创作主规范的上传合同、运维与 Pingora 文档、决策记录、发行里程碑口径，以及新增的续传里程碑与实施计划	2026-09-23 19:06:02 +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
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
kdletters	297d7bf1e7	优化 AGC 发布资料与截图交互 ... 发布门禁阻断提示改为独立弹窗且不写入聊天记录 移除发布面板发行包技术摘要 新增免费发布简介与分类建议接口和前端回填 接入封面泥点定价、确认与生成流程 截图改为并行上传，单张失败隔离且不阻断发布 截图操作改为图标，失败项内嵌错误与删除 同步发布合同、实施计划和决策记录	2026-09-23 17:40:08 +08:00
k88936	f6f41f22c3	geometry_quality 预检只拒绝 detailed，standard 按不传处理 ... - validate_generation_options 对非 v3.1 / v3.0 家族只在取值 detailed 时拒绝， 与 quad / smart_low_poly / generate_parts「只拒绝启用值」的处理对称 - 新增 wire_geometry_quality：不支持的家族把 standard 收敛成不发（等价于 provider 默认档）， 三个 endpoint 的请求映射都过这一层，避免 provider 因「不支持该字段」整单拒绝 - 新增两组表驱动用例：非 v3 家族 standard 放行 / detailed 拒绝，以及映射层的收敛结果 - 同步技术方案：写明「预检只拒绝启用值」与映射层收敛 standard 的口径	2026-09-23 17:33:51 +08:00
lhk229	5bc5328c06	客户端埋点复用已有下载渠道配置 (#496) ... 删除独立埋点 origin 环境变量及配置字段，按 dev/release 渠道校验官方站点。 本地开发、测试及容器的 dev 渠道允许规范回环地址，兼容可变端口。 同步环境变量示例、技术方案和运维说明，补充渠道隔离与身份校验测试。 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/496	2026-09-23 17:03:17 +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
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
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
lhk229	20b594d4f2	清理后端未使用代码及废弃测试 ... 删除编辑器旧分段持久化、生成任务收尾和音频发布链路 删除未使用辅助函数及其专属测试，修正受影响的现有测试边界 保留现役实现，将纯退款测试辅助函数移入测试模块 同步原子提交、角色生成文档和计费验证说明 验证：API 全目标编译零警告，格式、编码和 diff 检查通过 定向测试：391 项通过，11 项退款 outbox 测试失败，含 Windows 权限错误	2026-09-23 02:52:01 +00: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
kdletters	f502829fde	发布灰度默认关闭：修掉客户端“看得到点不动”与后台看不到 key (#482) ... ## 解决什么 你反馈的两个现象都是真问题，这个 PR 一次修掉： 1. **没开灰度也能看到发布按钮**：发布开关此前是「无 gate 行 = 默认开放」，所以没配灰度时后端把 `gameDistributionPublishEnabled` 判成 true，客户端就渲染了发布入口。 2. **按钮点了没反应**：发布动作的提示原先只写 `workspaceStatus`，而普通项目走 `DirectProjectChatView` 时并不渲染工作台状态行，于是「先打开一个项目再发布」「构建失败…」这类信息全都看不见。 3. **后台看不到 key**：预设项此前在未合并的另一个 PR 里，而且后台只列「已创建」的 gate 行。 ## 改成什么 - `is_game_distribution_publish_enabled_for_user` 要求 gate 行存在且 `enabled=true`：**灰度默认关闭**，未登录/无行/`enabled=false` 一律不开放；只有白名单 / 灰度比例 / 用户标签命中才开放。作者写入与新版本激活都按这条判据。 - 新增与作者无关的总开关 `is_game_distribution_publish_open`：管理员审核激活新版本只看「灰度是否开启」，不会因为审核员不在作者白名单里而被挡住（这是合入后立刻发现的回归，已修 + 有用例）。 - AGC 新增 `announcePublishMessage`：发布相关提示同时写工作台状态与 DirectProject 对话，点「发布到游戏广场」不会再像没反应。 - 后台「灰度发布配置」新增「可配置开关」列表：`game-distribution:publish` 等预设即使还没创建行也会显示，点「配置」按默认关闭填表，运营开启后填白名单/比例即可放量。 ## 验证 - `npm run check:game-distribution-media-e2e`（真实 Phaser 构建产物）现在覆盖：灰度关闭 → 作者拿不到入口 + 写入口 503 → 开启灰度 → 真实封面/截图直传 → 创建游戏/版本/上传/送审 → 管理员审核通过 → 网关 index.html 与 bundle 200 → nosniff；全流程通过。 - 后端：`cargo test -p api-server game_distribution` 19 passed（含新增 `game_distribution_publish_open_ignores_author_allowlist_for_activation`）、`frontend_runtime_config` 6 passed。 - 前端：admin 灰度页 10 用例（含「未创建的预设开关可见并可一键配置」）、AGC 聊天头 3 用例、网页发布页 15 用例；三端 typecheck、`check:encoding`、`check:doc-index`、`check:rustfmt`、全量 `npm test`（400 文件 / 4441 用例）与 `check:repository-ci -- origin/master HEAD` 全绿。 ## 上线注意 灰度默认关闭是**刻意**的：合入后到运营在后台把 `game-distribution:publish` 配置并开启之前，作者看不到发布入口、写入口 503；已公开游戏、目录、详情、发行网关、安全下架不受影响。 Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/482 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-22 21:38:03 +08:00
kdletters	a56790eaa6	合并 Phaser 一键发布自动构建与打包	2026-09-22 21:03:57 +08:00
kdletters	57a72f652c	Phaser 项目一键发布：发布前自动构建与打包 ... - AGC：export_local_project_package 改为发布前构建——已有可玩入口直接打包；否则解析 game/（Phaser 4 + Vite 脚手架）或项目根的 npm build 脚本，缺 game/node_modules 时先跑 project.bootstrap（npm install），再走 project.verify 的受控 npm 运行器执行 npm run build，最后校验入口并打包；安装/构建失败返回带日志尾部的可操作错误。 - 新增 resolve_publish_build_plan 纯函数与用例：game 子工程优先并要求先装依赖、根 npm 工程回退、没有可构建工程时失败关闭。 - 后端：发行网关根路径（含尾斜杠）等价于 index.html，路由级用例覆盖 Cookie 拒绝门与根路径；生产仍由每游戏 origin 把根路径映射到该游戏入口。 - 脚本：check:game-distribution-media-e2e 支持 E2E_PACKAGE_ZIP 直接发布真实构建产物，断言从包内派生入口/资源，本地审核入口改为发行网关路径。 - 文档：玩法链路与实施计划记录「作者不构建、不打 ZIP」的 Phaser 发布口径与验证证据。 - 验证：真实 Phaser 4.2.1 + Vite 7 构建产物（相对引用）经发布链路后网关 index.html 200 / assets 1,388,719 B 200，播放页在 allow-scripts 沙箱 iframe 内渲染 PHASER-PUBLISH-OK 且点击交互生效。	2026-09-22 20:38:00 +08:00
kdletters	fd0c1007ad	清除旧创作模板历史表定义与绑定 ... 删除 63 张旧玩法表的 module 定义与 legacy schema 移除清空 procedure、迁移白名单和旧行兼容逻辑 重新生成 spacetime-client bindings 新增一次性 schema guard 删除白名单与回归测试 清理后台表名映射、旧回填工具和权威文档	2026-09-22 19:42:29 +08:00
kdletters	56fd5a98f7	修复 release 客户端下载清单的编码空格校验 ... 放行客户端下载清单 URL 中百分号编码的空格 补充 release 安装包文件名回归测试 更新客户端下载规范与排障文档	2026-09-22 17:29:19 +08:00
kdletters	e5460280ce	发布入口接入灰度开关 ... - 后端：GET /api/runtime/frontend-config 新增 gameDistributionPublishEnabled，复用 `game-distribution:publish` 判据（未配置或 enabled=false 时对已登录作者默认开放，显式收紧后只放行白名单/灰度命中用户，匿名恒为 false），前端入口与写入口共用同一事实源。 - 后端用例：新增 frontend_runtime_config_game_distribution_publish_is_scoped_to_authenticated_gate，覆盖默认开放、enabled=true 无白名单、白名单命中、deny 名单、enabled=false 回退与 rolloutPercent=100。 - 网页：平台壳按灰度隐藏「发布游戏 / 发布新版本」入口；/games/publish 直接访问时渲染「发布功能正在灰度中」并提供重新检查；读取失败按放行处理，由后端写入口把关并返回可读文案。 - AGC：新增 readGamePublishAvailability（同一运行时配置字段），只有命中才把发布回调交给 DirectProject 聊天头；字段缺失或读取失败按不开放处理。 - 文档：玩法链路、后端数据契约与实施计划记录灰度口径、入口行为与验证命令。	2026-09-22 17:12:04 +08:00