407 Commits

Author	SHA1	Message	Date
k88936	796cf9843c	Merge remote-tracking branch 'origin/master' into feat/pricing-plan ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-10-06 10:14:15 +08:00
lhk229	51cb05f418	补充创作者主页与关注粉丝工程文档 (#638) ... 本 PR 补齐创作者主页与关注粉丝功能的产品合同和工程设计，供后续按里程碑实施；本次只修改文档。 桌面导航第四项进入自己的创作者主页，“我的”移到第五项。游戏详情可进入作者主页并关注/取消关注；自己或他人的关注、粉丝列表均公开可查看，点击用户头像或昵称可进入其主页。本人支持取消/重新关注、回关和移除粉丝，并明确两个关注方向独立。 工程设计包含关系表与 DTO、认证和事务边界、跨页状态同步、共享组件、深链及验收要求，拆分关系查询和页面交互两个里程碑。按用户要求，游戏列表沿用最多 48 项的现有限制，不增加游戏目录分页改造。 验证： - 已合入最新 origin/master（21c79f54a）；共享决策记录冲突保留双方新增内容。 - npm run check:encoding 通过。 - npm run check:doc-index 通过。 - git diff --check 与暂存差异检查通过。 - 相对 master 仅六份文档发生变化；没有业务代码或 schema 修改，未执行业务测试或部署。 Reviewed-on: #638 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-10-05 22:05:11 +08:00
k88936	a938a4ef9e	兼容(契约): 响应 DTO 新增字段一律可选默认 ... - ProfileMudPointBalanceResponse.monthly_points 缺省为 0 - ProfileMembershipResponse 的 cycleIndex / cycleCount / cycleKind 缺省 1 / 1 / yearly - ProfileMembershipPlanResponse 的 recommended / unlimitedConcurrency 缺省 false - ProfileRechargeCenterResponse.membershipPlans 缺省空数组 - 补「旧服务端缺字段仍可整包解析」契约测试，身份与状态字段仍保持必填 - 后端架构文档新增 shared-contracts DTO 变更规则，并同步团队约定	2026-10-05 19:37:48 +08:00
k88936	87a3794423	文档(会员契约): 后台改档请求并发上限不再硬编码 128 ... - AdminUpsertProfileMembershipPlanRequest.concurrentJobLimit 改为引用后端下发的 unlimitedConcurrencyThreshold - 同步重新生成 ts-rs 绑定	2026-10-05 17:56:02 +08:00
k88936	8e9d2389e0	文档(会员契约): 并发上限不再硬编码 128 哨兵 ... - ProfileMembershipPlanResponse.concurrentJobLimit 改为引用后端下发的 unlimitedConcurrencyThreshold - 同步重新生成 ts-rs 绑定，避免哨兵值变更时注释误导消费方	2026-10-05 17:54:38 +08:00
k88936	759bcf98a8	文档(会员契约): 澄清 status 兜底只作用于 Rust 客户端 ... - ProfileMembershipResponse.status 注释改为“Rust 反序列化未知取值按 active 兜底，TS 侧不归一化” - 同步重新生成 ts-rs 绑定，避免 Web 消费方误以为前端也会 fail-open	2026-10-05 17:53:23 +08:00
k88936	bc3e36ff33	重构(会员契约): 会员结构体改用 ts-rs 生成类型 ... - shared-contracts 为 10 个会员结构体补 ts_rs::TS / ts(export)，64 位整数字段补 ts(type = "number") 对齐前端 number - 新增 10 个生成绑定；packages/shared 与 admin-web 改为 re-export 生成类型，仅 kind / status 等前端收窄联合用 Omit 组合保留 - 同步设计文档 §2.5 与决策日志	2026-10-05 15:51:07 +08:00
k88936	42c4cacf72	修复(会员契约): 响应 token 反序列化前向兼容 ... - shared-contracts 为会员响应 DTO 的 plan / status / cycle_kind / model_access 字段加 deserialize_with，未知取值 fail-open 兜底到已知最高档，避免 AGC Tauri shell 等旧 Rust 客户端因后端新增 token 整包解析失败 - 入参 DTO 保持严格拒绝，不改枚举自身 Deserialize，避免 Unknown 变体污染入参 - 补响应兼容与入参严格测试；同步设计文档 §2.5 与决策日志	2026-10-05 15:11:47 +08:00
k88936	cc0c07223c	重构(会员契约): 充值中心会员状态改用强类型 token ... - ProfileMembershipResponse.status 由裸 String 改为 ProfileMembershipStatusToken，与前端 ProfileMembershipStatus 对齐 - BFF 直接用 From<RuntimeProfileMembershipStatus> 转换，测试改用具名枚举	2026-10-05 12:22:28 +08:00
k88936	4bd080eff5	修复(LLM目录契约): 响应枚举未知取值前向兼容 ... - LlmModelsResponse 内 agentMode / protocol 遇到未知 token 回退 Codex / 由 agentMode 推导默认协议，不再让旧客户端整份反序列化失败 - 输入校验仍走严格 parse；补未知 token 用例	2026-10-05 12:19:15 +08:00
k88936	c7150b590c	修复(LLM目录契约): protocol 缺省改为按 agent_mode 推导 ... - LlmModelSummary/LlmUnavailableModel 反序列化缺失 protocol 时取 agent_mode 的默认协议，不再一律 openai_responses - 补 cc / anthropic 别名 / 显式 protocol 用例；同步生成绑定注释	2026-10-05 12:18:05 +08:00
k88936	6d9125586a	文档(AGC模型): access 字段注释改为访问级别 ... - AdminAgcModel.access 与 AgcModel.access 的注释不再写成「会员档位」，避免与会员 plan 档位混淆	2026-10-05 12:01:43 +08:00
k88936	a48b7f8de8	Merge remote-tracking branch 'origin/master' into feat/pricing-plan ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-10-05 10:50:30 +08:00
k88936	284b656b59	fix(充值商品): 移除已退役的 bonus_points / duration_days 入参 ... - 后台 upsert 请求 DTO 与 SpacetimeDB procedure 入参移除 bonus_points、duration_days（评审第 19 条） - 充点商品固定「¥1 = 10 泥点、无首充赠送」，module 落库统一写 0，保留退役列兼容存量 schema - 删除 InvalidRechargeProductFields 校验与错误文案；api-server / spacetime-client 同步收敛 - admin-web 表单移除「首充赠送」输入与状态，列表改为只展示基础泥点 - scripts/admin-web-fake-api.mjs 假数据同步 bonusPoints: 0	2026-10-04 21:33:39 +08:00
k88936	dcaab089cc	refactor(后台契约): AdminAgcModel.access 改 ProfileMembershipModelAccessToken ... - shared-contracts 的 AdminAgcModel.access 由裸 String 改为 ProfileMembershipModelAccessToken，未知值在反序列化阶段被拒（评审第 18 条） - module-runtime 补 AgcModelAccess <-> ProfileMembershipModelAccessToken 双向 From - api-server 的 agc_models 去掉 AgcModelAccess::parse 兜底，改直接 From - admin-web 的 AdminAgcModelAccess 改为复用 @genarrative/shared 生成类型 - 扩展 catalog_dto 测试断言缺省 Basic 与未知 access 反序列化失败	2026-10-04 20:58:21 +08:00
k88936	54d1df9d21	refactor(契约): 会员 token 枚举走 ts-rs 生成，前端不再手写联合类型 ... - shared-contracts 给 ProfileMembershipPlanToken/CycleKindToken/StatusToken/ModelAccessToken/ChangeKindToken 补 ts_rs::TS + ts(export)，生成 5 个 .ts 到 packages/shared/src/contracts/generated/（评审第 14 条） - packages/shared/src/contracts/runtime.ts 的 ProfileMembershipPlan/Status/CycleKind/ModelAccess 改为生成类型的别名并 re-export - apps/admin-web/src/api/adminApiTypes.ts 删除本地手写联合类型，改为从 @genarrative/shared 导入 / re-export - npm run check:generated-bindings、admin-web:typecheck、npm run typecheck 通过	2026-10-04 19:35:28 +08:00
k88936	3a955889f0	refactor(后台契约): 会员详情 plan/status/cycle_kind 收口为 token 枚举 ... - shared-contracts 新增 ProfileMembershipStatusToken（normal/active） - AdminProfileMembershipPayload 的 plan/status/cycle_kind 由 String 改为 ProfileMembershipPlanToken/ProfileMembershipStatusToken/ProfileMembershipCycleKindToken，未知值在反序列化即被拒（评审第 13 条） - module-runtime 补 RuntimeProfileMembershipStatus -> ProfileMembershipStatusToken 的 From 映射 - api-server 的 map_membership 改为直接 .into()，去掉 as_str().to_string()	2026-10-04 19:14:31 +08:00
k88936	e89420053a	feat(会员): 模型列表返回可用与不可用分桶 ... - shared-contracts 新增 llm_catalog.rs：LlmModelsResponse/LlmModelSummary/LlmUnavailableModel/LlmModelUnavailableReason（plan_required/disabled/unknown），未停用优先于档位的 disabled 语义留给域层 - AgcAgentMode/AgcModelProtocol 从 module-runtime 迁入 shared-contracts（前后端 + ts-rs 单一真源），module-runtime re-export 保持路径可用 - 整个目录 DTO 与枚举走 ts-rs，生成到 packages/shared/src/contracts/generated，revision 标 number - module-runtime 新增 AgcModelCatalog::unavailable_models_for(access)：保持目录顺序，停用优先于档位不足，补单测 - api-server public_model_catalog 产出 models + unavailableModels 两桶，重写 model_catalog_tests	2026-10-04 13:29:29 +08:00
k88936	2630b0f690	feat(会员): 后台 AGC 模型支持标注权限档 ... - AdminAgcModel 新增 access 字段（缺省 basic，失败开放），GET 回读 PUT 写入 - api-server 保存时校验权限档只允许 basic/full - 后台 AGC 模型页新增「权限档」列，可按模型选择基础/高性能模型 - fake API 与页面用例覆盖权限档选择与保存	2026-10-04 13:28:13 +08:00
k88936	d7dec9b475	枚举化(会员后台)：档位与模型权限请求字段改用 typed enum ... - AdminUpsertProfileMembershipPlanRequest.plan/model_access 由 String 改为 token 枚举 - 未登记的档位 / 权限 token 在反序列化阶段直接拒绝，后台不能再持久化任意字符串 - admin handler 去掉字符串解析分支，改为 From 转换 - 删除仅用于手写解析的 parse_runtime_profile_membership_* 辅助函数	2026-10-04 11:46:08 +08:00
k88936	c660ca41fe	枚举化(会员)：快照与报价/档位响应改用 typed enum ... - shared-contracts 新增 ProfileMembershipPlan/CycleKind/ModelAccess/ChangeKind Token 枚举 - RuntimeProfileMembershipOrderChangeSnapshot 与 UpgradeQuoteRecord 档位/周期改用模块枚举 - AdminMembershipOrderChangePayload、ProfileMembership/Plan/UpgradeQuote Response 改用 token 枚举 - module-runtime 提供模块枚举与 wire token 的双向 From 映射 - api-server / spacetime-client / spacetime-module 同步去掉 as_str().to_string() 拼装 - 重生成 SpacetimeDB 绑定：订单变更快照字段改为枚举	2026-10-04 11:43:57 +08:00
k88936	1744262b0b	对齐(会员订单)：granted_points_delta 全链路 i64 改 u64 ... - profile_recharge_order.membership_granted_points_delta 列由 i64 改为 u64 - RuntimeProfileMembershipOrderChangeSnapshot 与 AdminMembershipOrderChangePayload 同步改 u64 - 删除 snapshot/order 之间的 as i64 与 try_from 兜底转换 - 重生成 SpacetimeDB 绑定：profile_recharge_order、订单变更快照	2026-10-04 11:23:21 +08:00
suzmii	daae35a1a1	AGC 发布版本标签改由工程内部版本派生，拆除 projectVersion 写链路 ... - shared contracts：resolveGameCreationAppProjectVersion 改为按 manifest.versions 条数派生，删除 isGameCreationAppProjectVersion，projectVersion 注释降级为遗留兼容位 - Rust shared-contracts：删除 resolve_game_creation_app_project_version / is_game_creation_app_project_version / GAME_CREATION_APP_FIRST_PROJECT_VERSION，project_version 注释改遗留位并重写往返测试 - AGC 发布面板：项目版本改为 useMemo 派生只读输入框，删除本地 state、失焦落盘与 onManifestUpdated 回调 - AGC 发布服务：删除 saveGameDistributionProjectVersion，提交版本号缺省改为按 versions 派生 - AGC 原生：发布成功回写与绑定回填不再写 project_version（置空），删除 update_game_distribution_project_version 命令 - AGC 命令注册与白名单：desktop.rs 注销命令、check-config.mjs 移除白名单条目 - AGC 前端装配：App.tsx 移除两处 onManifestUpdated 传递 - AGC 测试：publish/panel 两条测试改为覆盖派生口径，删除四条写回用例 - 注释对齐：game_publish_attempt.rs / project/manifest.rs / styles.css / shared-contracts 的 game_distribution.rs 把版本标签口径改为「由 versions[] 派生」，清掉 projectVersion 遗留位表述 - 文档：decision-log 追加本决策条目，两份 2026-10-02 计划加取代标注，新增 2026-10-03 里程碑与实施计划	2026-10-04 00:16:14 +08:00
k88936	dfa92607b4	Merge remote-tracking branch 'origin/master' into feat/pricing-plan ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md # server-rs/crates/module-runtime/src/lib.rs	2026-10-03 20:32:40 +08:00
k88936	44bbc846ae	fix(后台会员): 并发上限展示与提示改用后端下发值 ... - ProfileMembershipPlanAdminListResponse 增加 unlimitedConcurrencyThreshold，会员档位列表接口下发 MEMBERSHIP_UNLIMITED_CONCURRENCY。 - admin-web 的档位响应补上 unlimitedConcurrency，列表“不设上限”展示改用该标志，表单提示与校验改用后端阈值，删除页面硬编码的 128。 - 本地假后台同步补 unlimitedConcurrency 与 unlimitedConcurrencyThreshold。	2026-10-03 17:45:30 +08:00
k88936	c9ad084f78	fix(后台权限): 补上 membership-plans Tab 授权 ... - ADMIN_TAB_PERMISSIONS 增加 membership-plans 并把数组长度改为 22，使非 owner 管理员可被授予会员档位页权限，修复该页接口对普通管理员恒 403。 - every_assignable_admin_tab_has_a_backend_route 增加断言：路由使用的每个 Tab 必须登记在 ADMIN_TAB_PERMISSIONS。	2026-10-03 17:36:43 +08:00
suzmii	f4ca1aeecc	合并最新 master 到作品管理分支	2026-10-03 17:34:23 +08:00
kdletters	4b529a8952	新增支付服务接入与订单收银台 ... 新增支付应用、API Key 与外部产品订单接口 接入微信 Native 下单、二维码收银台与支付结果回调 新增后台支付订单与回调投递页面 补齐 SpacetimeDB 支付表、生成绑定、OpenAPI 与使用说明	2026-10-03 17:18:13 +08:00
suzmii	3aa3e33ceb	实现统一项目发行版本 ... 以 projectVersion 作为 AGC 唯一用户版本，支持同版本重复提交和版本回退。 保留 publicationRevision 并发校验与旧客户端自动递增兼容。	2026-10-03 16:41:04 +08:00
k88936	4c6af9f190	会员目录响应下发推荐档位与不设并发上限标志 ... ProfileMembershipPlanResponse 新增 recommended 与 unlimitedConcurrency 两个派生布尔 module-runtime 新增 PROFILE_MEMBERSHIP_RECOMMENDED_PLAN 常量并导出，作为推荐档位唯一真相源 api-server 目录响应按该常量与 is_unlimited_concurrency 派生标志 前端 ProfileMembershipPlanRecord 契约补上两个字段 membershipCopy 删除硬编码的 'plus' 与 128，并发文案改读 unlimitedConcurrency 充值弹窗推荐标签改读 plan.recommended 更新充值弹窗测试夹具	2026-10-03 16:18:14 +08:00
k88936	14ddf09f30	Merge remote-tracking branch 'origin/master' into feat/pricing-plan	2026-10-03 13:36:04 +08:00
k88936	16f92f2110	refactor(会员): 会员档位目录移除无用的 sort_order，统一按 rank 排序 ... - module-runtime catalog.rs：RuntimeProfileMembershipPlanRecord 与种子目录去掉 sort_order，目录单测改为按 rank 断言 - module-runtime domain.rs/commands.rs：后台改价入参与构建函数去掉 sort_order - spacetime-module profile.rs：profile_membership_plan 表结构去掉排序列，membership_plan_records 改按 rank 升序读取 - shared-contracts runtime.rs：ProfileMembershipPlanResponse 与 AdminUpsertProfileMembershipPlanRequest 移除 sortOrder - spacetime-client：客户端签名、mapper 与 module_bindings 同步移除 sortOrder - api-server runtime_profile.rs：响应构建与测试夹具去掉 sortOrder - admin-web：AdminMembershipPlanPage 移除「排序」输入，档位列表改为按 rank 排序，契约类型同步 - packages/shared：ProfileMembershipPlanRecord 去掉 sortOrder，充值弹层改为直接沿用后端的 rank 顺序 - docs：泥点三池与会员计费后端设计同步目录字段与后台能力说明 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-03 13:14:04 +08:00
suzmii	44f02ee19b	完善游戏审核试玩与客户端版本更新 ... 后台审核详情复用公开游戏详情样式，补齐发布者、冻结资料、素材换签和待审 ZIP 试玩。 AGC 保存已发布作品绑定，支持同一 gameId 更新版本并由用户填写目标版本号。 保留 SpacetimeDB 表结构不变，增加版本号请求校验、幂等边界和本地清单字段。	2026-10-03 12:35:57 +08:00
k88936	7acae0d308	后台契约与接口透出会员变更快照与用户会员状态 ... - shared-contracts 新增 AdminMembershipOrderChangePayload 与 AdminProfileMembershipPayload - AdminProfileWalletPayload.membership_limited_points 改名 monthly_points - AdminRechargeOrderEntryPayload 增加 membership_change 快照字段 - AdminUserDetailResponse 增加 membership 字段 - admin_recharge 映射会员订单快照与用户会员中心投影 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-03 11:48:24 +08:00
k88936	abc92d230b	chore(契约): 三池余额 DTO 交给 ts-rs 生成，同步 SpacetimeDB 绑定 ... - 给 ProfileMudPointBalanceResponse 加 ts-bindings 特性下的 ts_rs::TS 导出，u64 标 ts(type = "number") 避免前端分叉成 bigint - 新增 packages/shared/src/contracts/generated/ProfileMudPointBalanceResponse.ts，runtime.ts 改为 re-export 不再手写第二份字段 - 新增 packages/shared/src/utils/mudPoints.ts：派生展示用合计与北京时间月度刷新文案 - 同步 spacetime-client 生成绑定：升级报价改名为 snapshot，与 module 侧改动对齐 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 19:00:08 +08:00
k88936	c772600d59	feat(会员): 新增补差升级报价接口、后台档位读写与订单权益快照 ... 新增 POST /api/profile/membership/upgrade-quote：只读报价，下单时后端用同一纯函数重算 新增后台 /admin/api/profile/membership-plans 的读取与按档位改价改权益接口 订单与管理端契约补上会员权益变更快照（变更前后档位、周期、补点、有效期与价格拆分） 报价结果统一走「模块侧快照 + application 记录侧投影」两段式，与既有 DTO 约定一致 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 17:36:26 +08:00
k88936	703a24b682	重构(计费): 余额接口并列暴露三池并去掉会员 tier 字段 ... - 余额响应改为每日免费 / 月度 / 永久三池并列，不再暴露总额与会员限时泥点 - 会员响应与充值中心以 plan 取代 tier，充值中心改为输出会员目录 - 微信虚拟支付按目录档位校验会员商品，不再依赖会员商品配置行 - 同步 shared-contracts 测试夹具到新的三池与 plan 口径 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 16:59:49 +08:00
suzmii	72aff6a6e6	合并 origin/master 到作品管理分支	2026-10-02 15:14:34 +08:00
k88936	26e1ea9e27	feat(泥点): 账本来源追加会员升级补点 ... - module-runtime：RuntimeProfileWalletLedgerSourceType 末尾追加 MembershipUpgradeGrant，保持枚举只追加 - shared-contracts：新增 PROFILE_WALLET_LEDGER_SOURCE_TYPE_MEMBERSHIP_UPGRADE_GRANT 常量 - api-server：后台枚举索引映射与来源格式化支持新来源，并补单测断言 - spacetime-client：手写 mapper 与生成绑定同步新增变体 - packages/shared 与主站前端：钱包流水来源标签新增「会员升级补点」 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 14:33:16 +08:00
kdletters	6bf57c1e51	AGC 把执行器与线协议拆成正交维度 ... AgcAgentMode 回退为仅 codex/cc，只表示执行器；新增 AgcModelProtocol 表示线协议 协议取值 openai_responses/openai_chat/anthropic，与执行器组合封闭并在校验时失败关闭 存量目录缺 protocol 时按执行器推导；历史误写的 agentMode=anthropic 读取时归一为 cc 后台 AGC 模型页拆成 Agent 模式与协议两列，新增协议下拉与对应测试 公开目录 /api/llm/models 与后台 DTO 同时下发解析后的 protocol 客户端持久化 selectedModelProtocol，选模型时按执行器推导兜底协议并校验组合 Codex wire_api 按协议在 responses/chat 间切换，不再硬编码 responses 同步 appSurface 与模型选择测试断言，补 protocol 字段 同步模型别名文档与后端架构文档的正交维度说明	2026-10-02 12:08:26 +08:00
lhk229	b60aea4e71	实现网站游戏评分与评价 (#561) ... 公开游戏详情页新增评分与评价：登录用户可提交并修改自己对每款游戏的唯一一条 1–10 分评价，评论可空且最多 4000 个 Unicode 码点；游客可分页浏览评价并查看平均分与评分人数。 - 新增私有评价表及共享 DTO/API，事务内校验游戏公开可见性、保证唯一性，并计算分页与全量评分统计；下架或封禁后关闭读写，重新公开及更新版本保留评价。 - 详情页支持编辑预填、取消、提交期间冻结输入、失败保留草稿，以及保存、翻页和账号/游戏切换时的旧响应隔离；复用现有认证与公共组件。 - 同步主规范、里程碑、实施计划、生成绑定、表目录和验收脚本。不扩展 AGC、外部 API、评论审核或评分缓存。 验证： - 本轮审查复跑前端定向测试 40 项、评价领域测试 2 项，均通过。 - 网站 typecheck、Rust/TypeScript DTO 对齐、SpacetimeDB schema、文档索引、编码与 diff 检查通过。 - 实施文档另记录本地隔离数据库/API 49 项及桌面/移动视口浏览器 smoke 通过；本轮审查未重跑这些运行时验收，也未运行完整测试套件。 发布说明：新增 SpacetimeDB 表，部署时需同步 module 与 API。尚未部署 dev/production，待用户验收。 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/561 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-10-01 19:19:58 +08:00
suzmii	a2b70d92b8	作品管理与Phaser4客户端发布闭环 ... 补齐 Phaser4 客户端发布前校验、阶段进度与原生幂等账本 增加 Web 作者私有作品管理、资料编辑、版本历史与软删除 增加后台作品筛选、游标分页与删除治理 同步 SpacetimeDB schema、bindings、DTO、文档与定向测试	2026-10-01 16:30:40 +08:00
kdletters	fb130d1847	新增 AGC 模型 Agent 模式与 Claude Agent SDK sidecar ... 后台模型目录增加 codex/cc 执行模式绑定，旧目录缺省兼容 Codex AGC 客户端按模型绑定路由 Codex app-server 或 Claude Agent SDK sidecar 随包携带 Node runtime、Claude Agent SDK 与匹配平台 Claude runtime 补充模型配置、客户端选择、运行时适配、MCP 取消和定向测试 同步 AGC 模型配置规范、里程碑计划与共享决策记录	2026-09-30 14:07:25 +08:00
kdletters	e6c3729adb	AGC 发布前检查平台包体上限，并把上限单一来源 ... - shared-contracts 新增 GAME_DISTRIBUTION_MAX_PACKAGE_BYTES（200 MiB），服务端 module-game-distribution 保留同值常量并在注释里指明；api-server 新增 publish_package_limit_matches_the_shared_contract 守卫测试把两处锁一致 - AGC project/export 新增 ensure_within_platform_package_limit：读包阶段预检，超限返回「发行包 X MiB 超过平台上限 200 MiB；请精简资源后重新导出再发布」，不再让 200–512 MiB 的包白读盘/暂存后吃服务端 413 - 用例：project::export::npm_export_tests::publish_precheck_rejects_packages_over_the_platform_limit（边界=上限放行、超限文案、本地导出上限确实更宽） - 里程碑 C1 与 pitfalls 记录「本地导出上限 ≠ 平台发布上限」这一口径	2026-09-29 00:36:28 +08:00
kdletters	25a992468d	写入对象存储时下发对象级 ACL，修掉发行包可匿名直取 ... - platform-oss 的内部 PUT 与分片追加显式下发 x-oss-object-acl（Private 为 private、Public 为 public-read），OssAppendInternalObjectRequest 增加 access 字段 - 直传 policy 增加 x-oss-object-acl 条件，表单字段与 shared-contracts 的 DirectUploadTicketFormFields 同步新增并透传到 ticket 响应 - 媒体链路 E2E 增加匿名直取直传封面与发行包两条探测：默认 WARN，E2E_REQUIRE_PRIVATE_BUCKET=1 时按失败处理 - 里程碑第 7 条、pitfalls 与 decision-log 记录根因、修复与复验（严格模式 65 项 PASS，两处匿名直取都 403）	2026-09-28 19:20:21 +08:00
kdletters	46d8768529	对齐游戏分发响应 DTO 的 Rust 与 TypeScript 字段 ... - 给 GameDistributionGameSummary 补 coverObjectKey / screenshots / publicationRevision，给 GameDistributionPrivateVersion 补 publicationRevision，与 game_payload / private_version_payload 实际发出的键一致 - packages/shared 的 GameDistributionGame.currentVersion 改为可选，并写明作者侧响应自带同一份 game_payload 但不发这一项 - 删掉 DTO 一致性门禁里豁免这 4 个字段的 TS_ONLY_FIELDS 白名单，现在任一方向多出字段都会失败 - 同步游戏分发里程碑第 6 条的取证与剩余缺口	2026-09-28 17:58:00 +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