3163 Commits

Author	SHA1	Message	Date
k88936	d4416e8b88	把「已提交但没写下记录」的崩溃窗口写进文档 ... - docs/technical Tripo 集成方案：at-most-once submit 段新增「崩溃窗口（已知并接受，消不掉）」一条——submit 受理与 checkpoint 落库之间崩溃时库里没有任何记录，该窗口加判断消不掉；固定 max_attempts = 1 保证不会二次 submit / 二次计费，代价是这笔生成按失败退款、provider task id 也没留下 - docs/后端数据契约：provider checkpoint 那条把「重新 claim 一定能读到」的保证收窄为「checkpoint 已写下之后」，并指向集成方案的这一段	2026-09-24 21:06:59 +08:00
k88936	e20ff2e89e	provider 报 unknown 任务状态时改为可重试，不再直接判死 ... - platform-tripo：`TaskStatus::Unknown` 不再归一成 `OutputSchema` 终态失败，改成新的 `TripoError::TaskStatusUnknown`，并把它的可重试性判为真（SDK 自己也没把 unknown 算进终态） - platform-tripo：补用例——provider 回 `"status":"unknown"` 时必须返回可重试的 `TaskStatusUnknown`，不能当成正常快照 - api-server：错误映射补 `TaskStatusUnknown` 分支（502 + 固定文案，轮询侧早已按可重试继续查到截止时间） - api-server worker：状态查询遇到可重试错误时补一条 warn 日志，便于区分「一直是 unknown」和「一次网络抖动」 - docs：Provider 集成方案写明 unknown 按可重试处理及其理由	2026-09-24 21:06:04 +08:00
k88936	2aa59328de	3D 产物登记失败时删掉已经传上去的对象 ... - storage：新增 `discard_model3d_artifact`，按对象键删除刚写入的产物；OSS 未配置或删除失败都只记警告并带上对象键，方便人工清理 - worker：预览图上传失败时删掉已传的模型对象；登记失败时把模型与预览图两个对象都删掉；`persist_result` 改成接收引用，好让调用方在失败后还能按对象键清理 - docs/technical：写明「上传成功但后续失败就删掉对象，不接受失败就烂在 bucket 里」	2026-09-24 20:46:42 +08:00
k88936	8af02daeea	3D 产物上传带上退避重试，一次瞬时网络失败不再废掉整笔生成 ... - platform-oss：新增按前缀拼对象键的 `put_object_with_transient_retry`，与内部对象 PUT 共用同一套「可判定才重试」规则与退避（传输 / 超时 / 408 / 429 / 5xx 才重试，确定性 4xx 直接失败），body 只准备一次、每次 attempt 复用引用计数字节；重试次数或退避配置不足时按配置错误失败关闭 - api-server storage：3D 产物的模型 / 预览图 PUT 改用该入口，最多 3 次尝试、退避 250 / 500 ms（与角色动画同一口径）；模型上限 512 MiB 但实际产物远小，重试成本可控 - 新增用例：重试次数为 0 与退避不足都失败关闭；对一定解析不出的域名会真的按退避重试多次 - docs/technical：写明产物 PUT 的重试口径与「每个网络动作都要能重试」的理由	2026-09-24 20:43:39 +08:00
k88936	4ca1329d24	任务状态查询本身带上退避重试，瞬时故障不再作废一次计费任务 ... - platform-tripo：`get_task` 内部按 `TripoSettings::retries` 对瞬时故障（连接抖动 / 超时、408、429、5xx）退避重试，确定性失败（任务 id 非法、响应结构不符、404）立即返回；重试字段与退避函数改名，不再只服务产物下载 - api-server worker：查询在重试后仍是瞬时故障时继续按轮询间隔查到预算用尽，只有确定性失败才立刻收口 - 新增用例：一次 500 后成功（重试生效）、404 只打一次请求（不重试），并给测试客户端加了可指定 base_url 的构造 - docs/technical：写明查询带退避重试与「确定性失败立即返回」的边界	2026-09-24 20:39:12 +08:00
k88936	a08e3bf262	产物地址只允许公网主机，回环与内网段一律拒收 ... - platform-tripo：`TripoUrl::parse` 在协议与 userinfo 检查之后，再加一道主机检查——回环、内网、链路本地、组播与保留段（含云元数据 169.254.169.254）全部拒收；`localhost` 及其子域同样拒收；IPv4-mapped 的 IPv6 地址按内嵌的 IPv4 判定，`::ffff:127.0.0.1` 绕不过去 - 保留段按 IANA 特殊用途表逐段列出（0/8、100.64/10、192.0.0/24、198.18/15、240/4），因为 `Ipv4Addr::is_reserved` 与 `is_global` 在当前工具链上仍是 nightly - 新增用例覆盖 17 个拒收地址与 5 个放行地址；产物下载用例本来就跑在 127.0.0.1 的本地 mock 上，改用 `parse_unchecked_for_test` 构造 - docs/technical：写明这条主机规则与「域名解析结果在这一层看不见」的已知限制	2026-09-24 20:36:57 +08:00
k88936	93ef6cebf3	图生 3D 的引用预检改为按归类信号收敛，不再拿状态码猜 ... - api-server：`resolve_editor_reference_record_by_id_for_owner` 拆出 `..._classified` 版本，失败带「引用不可用 / 其它」归类；原函数保持逐字段一致的对外行为（其它调用方不受影响） - api-server tripo3d/image_source.rs：注入的解析闭包改为返回归类后的失败，只对 `Unavailable` 收敛成「图片输入必须是当前账号已登记的画布资源或素材」，400 / 404 里的 runtime 与通用过程错误原样上报；模块注释同步 - 用例：`image_source_resolution_only_collapses_unavailable_references` 改成「Unavailable 收敛、400/404/403/409/5xx 一律保留原错」 - docs/project-memory：pitfalls 新增「4xx 不等于用户输入错」一条，记下这条口径与新增模块文案时要同步的清单	2026-09-24 19:55:21 +08:00
k88936	453e351fc6	3D 资源没有预览图时封面留空，不再拿模型对象顶上去 ... - api-server：`project_editor_client_media_src` 对 `model3d` 在没有预览（`thumbnail_src` 与存储的 `image_src` 都缺）时直接返回空，不再回落到模型对象；用例改成断言空串，并补「存储的 image_src 是空白」一例 - docs/adr 0003：写明这是唯一允许「有对象但 `imageSrc` 为空」的类别，消费方按空值显示占位；被否决项里补上「拿模型对象冒充 imageSrc 的投影回落」 - docs/technical Tripo 集成方案：资源表说明改成「有预览才填」，验收项 11 改成「预览缺失时留空、不得回落成模型对象」 - 画布侧 `Model3dViewerModel` 的注释同步：历史布局里仍可能留着指向模型本体的地址，图片元素不能加载它	2026-09-24 19:51:47 +08:00
k88936	2dfb60a34e	格式判定的注释与文档改成「信任后端的检测结果」，不再说魔数纠正错误声明 ... - packages/model3d-viewer：`resolveModel3dViewerFormat` 与字节识别函数的注释改写——声明优先是因为后端的 `content_type` 写入前已按字节核过，魔数只在声明缺失或认不出来时兜住，不负责纠错一个认得出来但不对的声明 - docs/technical Tripo 集成方案：补上同一条口径，与实现里「声明 → 字节魔数 → 地址扩展名」的顺序对齐 行为不变，只改注释与文档。	2026-09-24 19:51:25 +08:00
k88936	a61725003e	补齐定价文档里漏掉的版本比对：技术方案与决策记录同步为整段覆盖 ... - docs/technical Tripo 集成方案：删掉「后台保存携带定价版本做事务内比对、不一致 409」这句，改成整段覆盖、不做版本比对 - docs/project-memory 决策记录：在 2026-09-23 那条设计决策末尾追加 2026-09-24 的修订说明，指向同日「模型定价保存去掉版本比对」	2026-09-24 19:51:19 +08:00
k88936	ad2b37c6d3	后台模型定价保存去掉版本比对：保存即整段覆盖 ... - shared-contracts：删掉 `EDITOR_GENERATION_PRICING_VERSION_CONFLICT` 常量 - spacetime-module：`EditorGenerationPricingConfigUpsertInput` 去掉期望版本字段，删掉版本比对方法与它的用例，入库只按请求内容整段覆盖 - spacetime-client：重新生成定价 upsert input 绑定（少一个字段），记录映射同步去掉版本 - api-server：进程内缓存去掉版本字段与 409 冲突错误，`editor_generation_pricing()` / `save_editor_generation_pricing()` 只返回配置本身，`EditorGenerationPricingStore::replace` 注释写明「只是缓存刷新、不做版本校验、不是拦截点」 - api-server admin/app：后台 GET 不再返回 `updatedAtMicros`，POST 不再读 `expectedUpdatedAtMicros`，删掉 409 映射与「旧版本被拒」用例，新增「连续保存两次以后一次为准」 - admin-web：定价类型去掉版本字段，保存请求不再回传版本，删掉 409 分支与「重新读取」提示及其用例 - docs：主规范新增「保存语义」段（整段覆盖、同时只有一个管理员在操作、缓存替换不是拦截点），后端数据契约、ADR 0005、里程碑 / 实施计划、决策记录与 pitfalls 同步为删除版本比对	2026-09-24 19:33:41 +08:00
k88936	6679dd2ebf	把 Tripo 配置写成明确的破坏性部署要求，并说明刻意不做开关 ... - docs 开发运维：Tripo 两项配置改成以「破坏性部署要求」表述，写明升级前必须配好、不做开关也没有缺配置先启动的逃生口，不需要 3D 的机器只跑不检查该配置的两个角色 - docs/adr 0006：补上同一条口径与理由（允许缺配置启动就会退回「起得来但悄悄坏掉」的形态），并写明被否决的逃生口	2026-09-24 19:18:27 +08:00
k88936	647822bbc4	写明产物是单文件，多文件模型的兄弟资源拼接只算兜底 ... - packages/model3d-viewer：把 resolveModel3dViewerResourceUrl 的注释改成实话——产物是单文件（.glb 自带几何贴图，.fbx 媒体内嵌），多文件模型不会出现，最多是「模型 + 一个 bin」；这段补签名只是最后一层兜底，签名按单个文件签发时会被云端拒绝，不指望它能读成功 - docs/adr 0003：同一条前提写进 ADR，并写明将来真要支持多文件模型时应当由宿主为每个兄弟文件分别换取临时地址，而不是继续扩展这段拼接	2026-09-24 19:18:10 +08:00
k88936	5748cf303f	种子字段的对外类型改成普通数字，不再导出 bigint ... - shared-contracts：多视图请求与文生 / 图生参数的 seed 注记从 `bigint | null` 改成 `number | null`，并写明只支持 JS 安全整数范围（2^53-1）内的取值；Rust 侧仍是 `Option<i64>`，反序列化行为不变 - packages/shared：重新生成 model3d 绑定，seed 变成 `number | null`，请求体可以直接 JSON 序列化（带 bigint 的请求在 JSON.stringify 阶段必定抛错）；顺带补上此前漏生成的多视图请求文档注释（「多视图生 3D」→「多视图生成 3D」） - docs/technical：在 Tripo Provider 集成方案里写明 seed 为什么按 number 导出、代价是超出 2^53-1 的取值无法从 TS 侧精确构造	2026-09-24 19:17:42 +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
k88936	42c3186e13	3D 生成面板开放模型版本选择，参数按模型能力门禁 ... - Model3dGenerationValidation.ts（新）：前端唯一一份参数校验，逐条复刻 platform-tripo 的 validate_generation_options 与 api-server 的 PricingParamView::validate（模型族能力、分件三个前置条件、face_limit_bounds、平台必显式项），并给出按契约联合类型做键的 MODEL3D_MODEL_TABLE 与禁用原因文案 - Model3dGenerationFormModel：模型版本改为用户可选，可选集只取当前端点有底价的版本；报价与请求体读同一个 resolveModel3dModelVersion；换版本或切档位时按新能力收敛档位与开关并开新一代次；v2.5 的贴图档位不带 textureQuality - Model3dGenerationForm：新增模型版本选择器（照图片面板的浮层选项形态），档位与开关按模型能力禁用并给出 title 原因 - Model3dGenerationModal：定价只读一次，模型选项与报价共用同一份快照 - Model3dGenerationSubmission / useModel3dGenerationTask：提交计划改成 endpoint 判别联合，两个端点各一个收口函数 - editorProjectClient：删掉「endpoint + 联合提交体」的单函数，改为 submitModel3dTextToModelRequest / submitModel3dImageToModelRequest 一个端点一个函数；basePrices 两层键改成契约枚举 - ImageCanvasOptionChoice.tsx（新）：把图片面板的浮层选项行抽成共享组件，3D 面板复用 - 测试：新增 Model3dGenerationValidation.test.ts（12 例），FormModel / Submission / Modal / useModel3dGenerationTask 补组合表与菜单用例，共 75 例通过 - 文档：实施计划与里程碑追加本轮口径与证据，decision-log 与 pitfalls 各记两条	2026-09-24 14:55:06 +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
lhk229	ec3a187dd7	处理编译大量warning问题 (#503) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/503 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-24 13:01:31 +08:00
suzmii	e80279c174	修复 AGC DirectProject 运行中过程卡的读秒粒度与样式 ... - apps/ai-game-creator-shell/src/view/project-development/chat/components/DirectProjectConversation/DirectProjectConversation.tsx 的 DirectTurnElapsed 改用对话侧共享时钟 useLiveNow（100ms），删掉组件自带的 1000ms setInterval 与 now state：耗时文案不足一分钟保留一位小数，秒级 tick 会让小数位一秒才动一格 - apps/ai-game-creator-shell/src/styles.css 重写 .project-chat-process-card：去掉旧面板遗留的 78px 最小高度与 9px 行距，收敛为单行状态条（padding 8px 12px） - apps/ai-game-creator-shell/src/styles.css 状态点与扫光改走 --platform-accent（原先写死绿色），标题提到 --platform-text-strong，耗时改 --platform-text-base 并加 tabular-nums - apps/ai-game-creator-shell/src/styles.css 删除两条永不命中的选择器（卡片渲染在消息列表外，规则却写着 …message-list > .project-chat-process-card）与已无 <p> 渲染的多行摘要样式 - apps/ai-game-creator-shell/src/styles.css 过程卡与最后一条消息之间补 12px 上间距，原先 margin 简写把它清零 - apps/ai-game-creator-shell/tests/directProjectProcessStatus.test.tsx 新增读秒粒度回归用例与「无运行中回合不订阅时钟」用例 - apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts 与 tests/AgentMessageContent.test.tsx 的选择器契约同步到现行 DOM 结构 - docs/project-memory/shared-memory/pitfalls.md 记录「刷新粒度必须与显示精度同格」这条复发坑	2026-09-24 11:47:32 +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	efbdf7031e	统一客户端维护态错误弹窗 ... 客户端维护响应统一识别并广播维护事件 AGC 与网页端根部展示维护大弹窗，收口发布、上传、资源换签和登录错误 补充维护态弹窗测试、类型检查与实施计划说明	2026-09-23 23:16:23 +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	e0c324c0ac	修复游戏封面生成素材 ID 回传 ... 生成游戏封面请求补充 AGC 客户端来源标记，确保队列 worker 返回 result。 补充封面生成请求断言，锁定平台素材 ID 回填链路。 同步记录缺陷根因与修复约定。	2026-09-23 21:29:18 +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
suzmii	5b1fc59d63	Merge pull request '运行页签补齐全屏预览与可收起的信息栏' (#497) from feat/run-view-chrome-cleanup into master ... Reviewed-on: #497	2026-09-23 20:50:42 +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
kdletters	eb192eb161	修复渠道配置替换窗口契约导致的系统标题栏回归与登录请求被拒 ... - 渠道 --config 改为从基线 tauri.conf.json 读取完整 client 窗口对象后展开、只覆盖 title，避免 Tauri JSON Merge Patch 整体替换 app.windows 丢掉 label / decorations / 尺寸 - build-release.test.mjs 新增合并守卫用例：按同一 merge patch 语义复现 Tauri 合并，断言 label=client、decorations=false、1280x800、min 1280x720，且承载 http:default 的 capability 必须包含该 label - check-config.mjs 增补基线 client 窗口 decorations 必须为 false 的门禁 - 更新 AGC 客户端更新检查与下载技术方案，写明渠道配置必须下发完整窗口对象的约定 - pitfalls.md 记录本次回归的现象、根因、现行口径与验证证据	2026-09-23 19:54:11 +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
suzmii	c723e0b1bf	合并 master：标题栏弹层契约、发行包上限与策划回复修复等上游变更 ... - 合并 origin/master（自绘标题栏作为窗口边框的弹层契约、游戏发行包上限提升到 200 MiB、策划回复重复播放修复 #501、标题栏品牌标签用例修正 f0ef06891 等）到本分支，保持 PR #497 可合并。 - 冲突仍只在 `docs/project-memory/shared-memory/decision-log.md` 顶部新增条目：按「新条目在上」保留双方内容，本分支的运行视窗条目在前。 - 上一轮合并记录的「`WindowChrome` 用例断言渠道产品名 stale」已由上游 f0ef06891 自行修复，本轮合并后该用例恢复通过。 - 上游改动未触及本分支的运行页 chrome 与预览适配文件；合并后重跑 `ai-game-creator-shell:check:web`、编码检查与 `git diff --check`。	2026-09-23 19:37:07 +08:00
suzmii	5e5407e4cf	合并 master：引用粘贴解析与渠道产品名等上游变更 ... - 合并 origin/master（引用名归一化与粘贴解析 #473 系列、客户端渠道产品名统一 ebb288a6a、#500 等）到本分支，保持 PR #497 可合并。 - 冲突仍只在 `docs/project-memory/shared-memory/decision-log.md` 顶部新增条目：按「新条目在上」保留双方内容，本分支的运行视窗条目在前。 - 上游改动落在 `features/project-workspace` 的引用链路与渠道命名脚本上，未触及本分支的运行页 chrome 与预览适配文件。 - 合并后 `apps/ai-game-creator-shell:check:web` 有 1 条红：`tests/WindowChrome.test.tsx` 仍断言标题栏品牌名为 `陶泥儿 GameAgent`，而 ebb288a6a 把该处改成读取 `APP_NAME`（未注入 `VITE_AGC_PRODUCT_NAME` 时回退 `陶泥儿开发版`），测试未同步。已验证与本分支无关：把这两个文件的合并前版本换回来 5/5 通过，换回合入版本即 1 条红。等上游修，本分支不动。	2026-09-23 19:21:33 +08:00
lhk229	248003a445	合并主线更新并保留双方排障记录 ... 合并 origin/master 的上传续传、标题栏弹窗及测试更新。 解决排障文档冲突，保留策划回复与标题栏问题记录。	2026-09-23 11:18:46 +00: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
kdletters	c38d07044a	修复 AGC 弹窗打开时自绘标题栏窗口按钮失效 ... - ThemedModal 的焦点陷阱只放行落在 [data-window-chrome-bar] 内的点击，标题栏拖拽与最小化/最大化/关闭恢复可用，工作区内容点击仍被拦住 - WindowChrome 标题栏加 data-window-chrome-bar 标记，作为这条约定的唯一契约点 - styles.css 明确「全屏弹层一律从标题栏下方开始」，.app-update-overlay 从 inset:0 改为标题栏下方，.game-publish-progress-overlay 显式声明 top - 新增 tests/windowChromeOverlayContract.test.ts 覆盖 7 个全屏弹层；themedModal / WindowChrome 用例补「标题栏点击放行 + 工作区点击仍被拦」回归；gamePublishFeedback 用例按新口径断言 - pitfalls 记录该静默失效的机制与现行口径	2026-09-23 19:05:33 +08:00
lhk229	efbfc8085d	Merge branch 'master' into fix/design-agent-fe	2026-09-23 19:04:31 +08:00
lhk229	2c778fb027	补全聊天作用域重置时的忙碌态清理 ... 重置聊天状态时同步清空 chatAgentBusy，保留旧请求的回合归属检查。 同步更新策划会话的作用域清理约定。	2026-09-23 11:03:03 +00:00
k88936	5ee9a1e2e2	共享记忆补记本轮 3D 收口的三条决策与一条踩坑 ... - decision-log：视图输入显式化并改按文档 view-key 形态发出、派生来源取自请求 source、失败态提交开新一代 - pitfalls：失败态沿用同一尝试代次会让主按钮只是重现同一次失败，以及新增提交入口时的判断口径	2026-09-23 18:59:54 +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	ebb288a6a4	统一客户端渠道产品名称 ... dev 渠道显示为陶泥儿开发版并保持既有 identifier 与升级链。 将产品名注入 Tauri、原生窗口、前端标题栏和关于页面，统一快捷方式与注册表展示来源。 补充渠道配置门禁、发布脚本测试和渠道身份文档。	2026-09-23 18:53:23 +08:00
k88936	c0e233fe6c	Merge remote-tracking branch 'origin/master' into feat/smart-paste	2026-09-23 18:50:15 +08:00
suzmii	16361bfbe1	修复退出全屏后运行画面不回缩，并收口信息栏开合与文档口径 ... - `resolveLocalGamePreviewFitLayout` 增加回退：上报的内容尺寸等于它被接受时的容器尺寸（自适应页面把视口原样报回）时不算内容高水位，直接按容器取画布——修复「全屏预览退出后画布仍保持全屏比例、永久带黑边」；真比容器高的页面（内容 ≠ 视口）仍按原生尺寸缩放显示。 - 该回退的已知残余（固定尺寸页面恰好等于接受时的容器且之后不上报新尺寸会被裁）与「内容尺寸没变就改认新容器」这条更差尝试一起写进代码注释与 decision-log；根治方向记在桥/协议侧。 - `tests/localGamePreviewFrame.test.ts` 抽出 `renderFittedFrame` 夹具，补「退出全屏回到容器尺寸」（改前必红）与「容器缩小后按新内容尺寸重新适配」两条用例。 - 信息栏手动态改为按资源 id 在渲染期派生（去掉 effect 回写），修掉「刚有内容那一帧先画收起态」的抖动，并让 `onClick` 写入的字段与派生读的字段一致。 - AGC 子集删掉恒真的「数值微调面板不存在」断言，保留「卡片不渲染」与「开合行不渲染」两条独立事实。 - 文档同步：PRD §3.4、技术方案与 decision-log 的信息栏判据口径改为「资源选中态」，并记录全屏回归的根因、修法、残余边界与桥协议根治方向；2026-08-23 适配条目补一条指向本次收口。	2026-09-23 18:38:47 +08:00
lhk229	688cf7a971	修复策划回复重复播放并保留伪流式 ... 按消息 ID 合并实时正文与正式消息，保留逐步显示进度 分离请求收尾与动画结束，隔离旧回合事件及异步返回 独立展示工具状态，保留 Provider 重试的正文重置语义 补充重复终态、整块回复、多消息及回合隔离回归测试 同步更新策划展示规范与排障记录	2026-09-23 10:38:01 +00:00
lhk229	c2ec978199	修复宿主继续请求重复发送原始用户输入 (#500) ... 区分首次用户请求与宿主反馈，继续时发送实际验收或错误信息 固定 GUI 和 CLI 的原始用户条目，保留历史与回合身份关联 补充结构化输入、反馈发送、图片输入和历史去重的定向回归测试 同步更新实施计划与排障记录，保持交付验收条件和预算不变 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/500 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-23 18:20:42 +08:00
k88936	58c59b750e	Merge remote-tracking branch 'origin/master' into feat/smart-paste ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-09-23 17:52:49 +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
suzmii	d7440473af	合并 master：最近项目重试与发布资料交互等 12 个提交 ... - 合并 origin/master（`297d7bf1e` 及之前 12 个提交：最近项目检查失败重试、AGC 发布资料与截图交互、模板库筛选表现等）到本分支，保持 PR #497 可合并。 - 冲突仍只在 `docs/project-memory/shared-memory/decision-log.md`：双方都在顶部新增 2026-09-23 条目，按「新条目在上」保留双方内容，本分支条目在前。 - `apps/ai-game-creator-shell/src/styles.css` 为自动合并；逐条核对本分支运行页改动（全屏钮、信息栏开合、数值微调隐藏）的五处选择器仍在，其余为上游更新弹窗与主题调整。	2026-09-23 17:49:44 +08:00
suzmii	8d487685f3	合并 master：上游 18 个提交并保留运行页签 chrome 改动 ... - 合并 origin/master（斜杠命令退役、筛选控件选中态、埋点后台排序、发版脚本等）到本分支，解决 PR #497 的冲突。 - 冲突只在 `docs/project-memory/shared-memory/decision-log.md`：双方都在文件顶部新增条目，按「新条目在上」保留双方内容，本分支的 2026-09-23 条目在前。 - `apps/ai-game-creator-shell/src/styles.css`、`tests/appSurface/project-development.suite.ts` 与实施计划技术方案为自动合并，逐块核对本分支的运行页改动（全屏钮、信息栏开合、数值微调隐藏）仍完整保留。	2026-09-23 17:41:00 +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