1105 Commits

Author	SHA1	Message	Date
k88936	95705cbb11	后端：客户端 IP 只信 X-Real-IP，不再取 XFF 首段 ... - request_context.rs：client_ip_from_headers 改为优先 nginx 覆盖写入的 x-real-ip，x-forwarded-for 只作回退且取最后一段（nginx 用 $proxy_add_x_forwarded_for 追加的真实对端），不再信任可伪造的首段 - 影响两个调用方：公开游玩上报的匿名身份与 IP+game 限流键、微信支付下单的 payer_client_ip - 更新测试：X-Real-IP 优先、XFF 回退取末段、空 X-Real-IP 回退与回环兜底	2026-10-04 11:38:47 +08:00
k88936	28ac8a1037	后端：游玩计数 flush 失败后直接丢弃剩余分片 ... - game_play_counter_worker.rs：任一分片失败即停止本次 flush，不再为后续分片逐个重建连接（连接不通时每片都会各自等一次超时） - Build（确定未发出）仍放回本批，剩余分片直接丢弃；其余错误连本批一起丢弃，并记录丢弃增量 - 补 total_delta 汇总剩余增量，模块文档写明失败即停止与丢弃口径	2026-10-04 11:10:03 +08:00
k88936	75ad087e2c	后端：关停不再强制 flush 游玩计数 ... - main.rs：finalize_shutdown 删除游戏游玩计数强制 flush，关停不再为它等待网络，内存里剩余增量随进程结束丢弃 - game_play_counter_worker.rs：删除 flush_game_play_counter_for_shutdown，flush_deltas 去掉 requeue_on_build 参数（关停路径已不存在），Build 仍放回等待下一轮 - game_play_counter.rs：take_pending 标记为仅测试使用，模块文档改指 take_pending_if_due	2026-10-04 11:07:02 +08:00
k88936	3f0a77e65e	后端：游玩上报先做内存限流预检再查库 ... - game_play_counter.rs：新增只读 is_rate_limited，不消耗额度也不改状态 - modules/game_distribution.rs：record_game_play 先做内存限流预检，超限直接 429，不再让这些请求也打一次 SpacetimeDB；真正计数时 record 仍会重新判定 - 补预检只读与固定窗口作用域测试	2026-10-04 11:04:52 +08:00
k88936	2122dc9469	后端：关停 flush 不再假承诺重试 ... - game_play_counter_worker.rs：flush_deltas 增加 requeue_on_build；worker 循环仍把 Build 失败放回下一轮，关停路径改为直接记丢失量，不再把增量放回一个不会再被 flush 的缓冲	2026-10-03 19:28:39 +08:00
k88936	ea8734b700	后端：游玩计数锁中毒时留日志 ... - game_play_counter.rs：lock 仍从中毒互斥锁恢复，但先 warn 一次，便于关联留下部分更新状态的 panic	2026-10-03 19:26:06 +08:00
k88936	7c3398029e	后端：游玩计数去重与限流改用元组键 ... - game_play_counter.rs：seen/rate 的键由 U+001F 拼接字符串改为 (identity, game_id)/(ip, game_id) 元组，clientId 携带分隔符时不再发生键碰撞 - 补分隔符碰撞回归测试	2026-10-03 19:23:37 +08:00
k88936	03f1828561	后端：游玩计数排序移出互斥锁 ... - game_play_counter.rs：drain 只负责在锁内取走增量，新增 sort_deltas 在释放锁后排序，避免 O(n log n) 排序阻塞并发 record	2026-10-03 19:19:57 +08:00
k88936	b196c1150f	后端：补充游玩上报端点与身份解析测试 ... - modules/game_distribution.rs：新增公开路由在未连接 SpacetimeDB 时可达、无需登录且 no-store 的断言 - 补 clientId 去空白/截断 128 字符与缺失 UA 回退的单测	2026-10-03 18:25:49 +08:00
k88936	d12ff72425	后端：新增公开游玩上报端点 ... - modules/game_distribution.rs：新增 POST /api/game-distribution/games/{game_id}/plays，公开可带 bearer，非公开 404、限流 429、成功 200 {recorded} - 身份组成：登录用 userId、匿名用 clientId、都缺失回退 IP+UA；无效 bearer 按匿名处理不影响计数 - 请求体读取原始 Bytes，空体或畸形体不阻断计数	2026-10-03 18:25:49 +08:00
k88936	dbf3adeb13	后端：接入游玩计数内存缓冲与 flush worker ... - game_play_counter.rs：新增纯内存计数器（30min 身份去重、IP+game 固定窗口限流、按时/按量取增量、requeue、过期清理）与 9 个单测 - game_play_counter_worker.rs：新增 flush worker，Build 失败放回重试、Timeout/ConnectDropped 丢弃并记录丢失量，关停前强制 flush - main.rs：HTTP 角色注册 worker，并在 finalize_shutdown 内按 outbox 超时强制落库 - state.rs/config.rs：AppState 持有计数器，新增 GENARRATIVE_GAME_PLAY_COUNTER_FLUSH_INTERVAL_MS（默认 5s） - request_context.rs：抽出 client_ip_from_headers 并补测试，runtime_profile.rs 改为复用	2026-10-03 18:25:49 +08:00
k88936	8301b7b25f	后端：spacetime-client 新增游玩计数 facade ... - game_distribution.rs：新增 GameDistributionPlayCountIncrementRecordInput 与 increment_game_distribution_game_play_counts，把批次映射为绑定输入并调用增量 procedure，错误转 procedure_failed	2026-10-03 18:25:49 +08:00
k88936	cc33c39f24	后端：新增批量游玩计数 procedure 与生成绑定 ... - spacetime-module/game_distribution.rs：新增 GameDistributionPlayCountIncrement(Input) 与 increment_game_distribution_game_play_counts_and_return，事务内只对 published 且有 active_version_id 的游戏 saturating_add，且不 bump updated_at - 重新执行 npm run spacetime:generate，新增 3 个绑定并同步 module_bindings.rs 等生成产物	2026-10-03 18:04:47 +08:00
lhk229	ae2d1a3a21	修复 AGC 生成准备依赖全量素材库的问题 (#592) ... 修复已有项目和素材目录绑定时，AGC 生成准备仍读取完整账户素材库、导致无关素材读取失败阻断生成的问题。 - 新增站内与 External v1 的单目录 GET，按主键读取并校验账号归属；复用目录 DTO，不读取素材列表或创建默认目录。 - 已有 binding 和 partial 恢复改为确认目标目录；首次建绑直接沿用稳定幂等创建，不再读取全库。 - 目录缺失、越权、超时、响应身份不符或会话切换时停止，保留恢复证据，不自动重建、不换键重发生成；已有生成账本继续沿用冻结快照恢复。 - 既有素材库与目录创建、修改、删除 API 合同保持不变，持久化表结构不变。同步 OpenAPI、生成绑定及技术文档。 验证： - AGC Rust：目录绑定 7 项、生成 94 项、资源编辑 60 项、抠图 5 项通过（目录绑定用例包含在生成组中）。 - api-server：External Editor 30 项、受保护路由矩阵 3 项通过。 - 真实隔离 SpacetimeDB：目录读取成功、空目录、缺失、越权、删除后缺失、只读不变，以及既有幂等/并发/孤儿检查通过。 - smoke 脚本测试 4 项通过；module 编译、生成绑定、87 张表 schema guard、DDD、编码、文档索引、定向 Rust 格式与 diff 检查通过。 - 已比较 OpenAPI：除新增单目录 GET 外，原有定义逐项保持一致。 验证限制：未完成独立 API `/healthz` 联调，本地隔离数据库与授权配置未就绪；启动尝试已停止并清理。未运行全量测试或真实付费生成。 发布顺序：先发布后端模块与 API，再发布新客户端；不提供全库回退。#574 的素材分页、筛选及按素材 ID 读取不在本 PR 范围内。 Closes #550 Reviewed-on: #592 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-10-03 14:48:54 +08:00
kdletters	3a0d92b622	Anthropic 直通只用 x-api-key 出示 Router 凭据 ... - llm：原生 Anthropic 直通不再同时带 Authorization: Bearer，只发 Anthropic 规范的 x-api-key - 实测：Router 对同一次 /v1/messages 请求，只带 x-api-key 时 200（4.7s 返回真实回复），同时带 Bearer 时 79 秒后被断开	2026-10-02 16:14:56 +08:00
kdletters	3e9bc76c2c	Anthropic 路由改回原生优先、桥接兜底 ... - llm：/api/llm/anthropic/* 先按 Anthropic 原样直通 Router 的 /v1/messages（20 秒首包上限），拿到 2xx 就直接透传 - llm：直通返回非 2xx、连接失败或首包超时才回退到 Anthropic→Chat 协议桥接，并记录 model/status 便于定位 - 测试：两条 Anthropic 路由用例改为「原生先被拒 + 桥接命中」的两段式 mock	2026-10-02 15:49:01 +08:00
kdletters	580c74759a	Anthropic 桥接对上游一律流式，并补非流式聚合 ... - anthropic_bridge：向 Router 一律请求 stream=true，兼容只接受流式 chat 的上游 - anthropic_bridge：新增 SSE 聚合，客户端要非流式时在网关侧拼回 OpenAI 形状再转 Anthropic message - llm：非流式分支按上游返回形状选择直读 JSON 或聚合 SSE - 测试：新增聚合单测（文本 + tool_calls + usage → Anthropic tool_use 还原）	2026-10-02 15:29:42 +08:00
kdletters	21a8886c4c	AGC Anthropic 网关改为桥接 Router 的 Chat Completions ... - llm/anthropic_bridge：新增 Anthropic Messages → OpenAI Chat Completions 请求转换（system、messages、tool_use、tool_result、图片、工具名安全化与还原） - llm/anthropic_bridge：新增 OpenAI SSE → Anthropic SSE 流式翻译（message_start、content_block_start/delta/stop、message_delta、message_stop，tool_calls 还原成 tool_use） - llm：/api/llm/anthropic/v1/messages 不再打现网不可用的 Router /v1/messages，改走转换后的 /v1/chat/completions；非流式响应同样翻译回 Anthropic message - llm：删除只服务旧直通的 Anthropic 流式结算辅助，结算点改为翻译器产出 message_stop 或流结束 - 测试：新增请求转换、工具名还原、流式翻译单测；Anthropic 路由测试改为断言 Chat Completions 上游与 Anthropic 形状回包	2026-10-02 15:09:52 +08:00
lhk229	aad5a0bcef	修复公开模型目录测试遗漏协议字段 ... 补齐公开模型目录完整 JSON 断言中的 protocol 字段。 同步后端契约文档中的回归验证说明。 验证模型目录定向测试、编码检查、文档索引和 Rust 格式检查通过。	2026-10-02 13:29:08 +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
kdletters	fee0dc1fa4	合并 origin/master：网站游戏评分与评价	2026-10-01 19:41:30 +08:00
kdletters	d1f789cc10	AGC 支持 Anthropic 独立网关路由与后台协议选项 ... 新增平台 Anthropic 网关路由 /api/llm/anthropic/{*path}，复用账号 Router 凭据边界 OpenAI 侧规范路径改为 /api/llm/v1/responses 与 /api/llm/v1/chat/completions，旧路径保留兼容 baseUrl 不再携带路由与版本段，统一由协议自己拼 v1/<op> cc 执行器改走平台网关，ANTHROPIC_AUTH_TOKEN 复用平台会话，不再直连 Router 后台模型目录 agentMode 增加 anthropic，管理页与客户端契约同步 补齐三条路由埋点与静态段白名单，新增三条回归测试 同步后端架构文档、模型别名文档与排障记忆	2026-10-01 19:41:08 +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
kdletters	dbc3355e3a	账单不再计入实际变动为 0 的泥点流水 ... - spacetime-module：每日免费 / 会员周期换期改为先算「换期后余额 + 实际变动」（新增 resolve_expiring_points_wallet_transition），实际变动为 0 时只更新余额状态、不再写 profile_wallet_ledger - spacetime-module：通用结算入口 apply_profile_wallet_signed_delta 在 amount_delta 为 0 时直接返回当前余额，不再落一条 0 变动流水 - spacetime-module：账单列表 list_profile_wallet_ledger_entries 在按余额结算链排序之后、截断 50 条上限之前剔除 amount_delta 为 0 的存量行，历史 0 流水立即从账单消失且不占用列表上限 - spacetime-module：新增 3 条定向单测覆盖换期实际变动与账单 0 变动过滤（去 0 后不改变其余条目顺序） - 文档：后端数据契约 profile_wallet_ledger 补「实际变动为 0 不进账单」口径并修正源码路径为 runtime/active/profile.rs；decision-log 追加 2026-10-01 条目说明根因是旧判据看入参而不是实际余额变动	2026-10-01 13:23:29 +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	5fee115f10	实现 Pingora 发行网关路由并关闭两处路由漂移待办 ... - 新增 RouteDecision::ReleaseGateway：/games/game_<32 位小写十六进制 id>/… 重写上游路径到 /api/game-distribution/releases/<gameId><asset>、清空 Cookie、不进 SPA fallback、不套接流保护分组、不受维护闸拦截，与 nginx 同名 location 同口径（只认小写 32 位十六进制） - 路由矩阵新增 games_release_gateway 用例（含 upstreamPath 期望值）与对应断言；parity 门禁支持 release_gateway 并把 games_spa_fallback、games_release_gateway 列入必查清单 - check:pingora-gateway-smoke 新增三条运行时断言：重写到发行网关且上游拿不到 Cookie、/games/detail 仍走 SPA、/games/game/index.html 仍是真实 404 - 文档：Pingora 试点文档补「平台同源发行入口」语义；pitfalls 记录 SPA allowlist 三处真相源与「发行入口不是 SPA」；按 docs/project-memory/README.md 删除两份已关闭待办，关闭记录写入开放事项索引第五节 - 验证：网关 39 passed、check:pingora-route-parity OK（23 路由）、check:nginx-spa-routes OK（12 路由 / 3 模板）、check:pingora-gateway-smoke 通过、cargo fmt --all --check、check:production-ops、encoding / doc-index / diff 检查全绿；变异验证：矩阵 upstreamPath 写错或拿掉 /games/detail 都会立刻变红	2026-09-29 07:24:52 +08:00
kdletters	589f3582ae	补齐 Pingora 网关的 SPA allowlist 并关闭 SPA 路由漂移待办 ... - Pingora MAIN_SPA_PATHS 从 5 条补到 12 条（补 /components、/design-system、/games、/games/detail、/games/mine、/games/play、/games/publish），与前端路由源和 nginx 三份模板逐条一致 - 路由对照矩阵新增 games_spa_fallback（/games/detail → static/web/spa_fallback）并同步 Pingora 试点文档的 SPA allowlist 表，让 cargo test -p pingora-gateway matches_nginx_route_parity_matrix 真正覆盖这条 - 门禁与验证：check:nginx-spa-routes OK（12 路由 / 3 模板）、check:pingora-route-parity OK（22 路由）、网关全量 38 passed、check:production-ops OK、cargo fmt --all --check OK；变异验证：临时拿掉 /games/detail 后矩阵用例以 static mode mismatch 变红；dev 与生产 5 条 /games* 深链实测 200 - 关闭【待办】主站SPA路由白名单与前端路由源不一致 并写入关闭记录；另立【待办】Pingora网关缺发行网关路由（三份 nginx 模板都有 /games/game_<32hex>/ → 发行网关，Pingora 缺这条代理，切流后会 404）	2026-09-29 07:16:00 +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	253f99d921	补齐错误 envelope 的请求上下文并扩展游戏分发审核取证 ... - api-server 的错误响应改用 attach_request_context 建立的 CURRENT_REQUEST_CONTEXT（tokio task_local），错误 envelope 与成功 envelope 一样带 meta.requestId / meta.operation，脱离请求任务时退回原形状 - 越权隔离脚本新增成功/失败 envelope 断言：修复前错误响应 requestId 为空让断言变红，修复后 23 项 PASS - 媒体链路脚本扩展审核治理段：普通作者不能提交审核动作、更新待审与被拒都不改变在线旧版 URL 与可玩内容、审核结论可在后台追溯，44 项 PASS - 游戏分发里程碑阶段 A 第 6 条、阶段 B 第 1/2 条改为已勾选并写入取证，阶段 B 其余条目列出具体缺口 - decision-log 补记错误 envelope 同一份 meta 与「按可消费取证」两条口径	2026-09-28 18:58:38 +08:00
kdletters	665f88b85f	补齐游戏分发并发上传与幂等重放用例并修掉并发落败的错误码 ... - 新增 scripts/check-game-distribution-upload-concurrency.mjs：同 key 重放建游戏/建版本返回同一条记录、换请求体 409、同版本同偏移并发写片只成功一片、权威已收字节等于单份包长、确认校验通过落到 uploaded、换 key 重复送审 409 且版本数仍为 1 - 分片追加失败后回读权威已收字节：长度已前进时返回 409 PACKAGE_UPLOAD_OFFSET_MISMATCH 与 receivedBytes，不再把 OSS position 冲突报成 502 UPSTREAM_ERROR - package.json 注册 check:game-distribution-upload-concurrency - 游戏分发里程碑阶段 A 第 4 条改为已勾选，并把第 5 条的缺口收窄到「响应丢失与进程退出后的续传编排」	2026-09-28 18:31:39 +08:00
kdletters	0989f9f40e	补齐游戏分发跨账号越权用例并统一送审的 404 口径 ... - 新增 scripts/check-game-distribution-owner-isolation.mjs：对本地真实栈注册两个账号，逐条验证私有版本读取、上传状态、分片写入、分包确认、送审、撤回与未认证访问的越权口径，并验证请求体伪造 owner 不生效 - api-server 的 submit_version 改用 load_owner_version_or_404：他人送审返回 404 而不是 403，不再用错误码泄露版本是否存在 - package.json 注册 check:game-distribution-owner-isolation - 游戏分发里程碑阶段 A 第 1 条改为已勾选，写入 21 项 PASS 取证与修复前的 403 变异证据	2026-09-28 18:23:52 +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	39a7343079	补齐游戏分发阶段 A 的三条领域用例并勾选失败关闭条目 ... - module-game-distribution 新增 rejects_symlink_entries：用 ZipWriter::add_symlink 造真实 S_IFLNK 条目（unix_permissions 会掩掉类型位），去掉 is_symlink 守卫时该用例变红 - 新增 failed_validation_keeps_the_previous_publication_and_confirmed_package：第二版校验失败后已公开游戏快照与上一版已确认包身份逐字段不变，变异成顺带更新游戏记录时变红 - 新增 a_version_accepts_only_one_confirmed_package：不同摘要/字节数确认被拒为 PackageMismatch，重复确认同一份内容返回同一身份，去掉守卫时变红 - 里程碑勾选第 3 条并写明「额度超限」按包/文件/展开量/条目数/压缩比上限口径验收（该链路无按用户配额）、第 4 条只剩并发不混写待补	2026-09-28 17:48:06 +08:00
kdletters	1e62d8317a	合并 origin/master 到 AGC 渲染层下沉分支并完成三处对齐 ... - 活动回合事实源统一到 Direct 线程管理器：删除 direct_runtime 的第二份快照，接单、进度内容变化与收口各广播一次活动回合变更事件 - 平台维护态判定移入 Rust 并在渲染层只订阅单一事件：新增 platform_maintenance 模块与各平台 facade 错误分支的分类入口 - 封面生成请求补 generationInputs.source，保持队列回填后仍能拿到平台素材 ID - 渲染层按 master 5398a53e6 退役诊断详情入口：删除 agentRuntimeErrorDetail 与「查看详情」交互及其专属用例 - 冲突收口：nginx SPA 白名单、.gitignore、mobile 检查脚本、capabilities 描述取上游，两个已退役计划随上游删除，文档保留双方条目 - 新增并回写本里程碑取证、decision-log 与 pitfalls 的 2026-09-28 记录	2026-09-28 15:07:30 +08:00
kdletters	e7309ad71b	server-rs 快照回收可测化与 Provider 配置脱敏 ... - project_snapshots 抽出 plan_project_snapshot_reclamation 纯函数并新增 3 条用例：只回收上一版登记过的对象、上一版清单读不到时一张都不删、单轮回收有硬上限。 - platform-llm / platform-oss / platform-wechat / platform-audio / platform-hyper3d / platform-image / platform-matting / platform-speech 的配置类型改为手写脱敏 Debug，只输出枚举、数值、有界标识与 <redacted> 占位。	2026-09-28 14:15:31 +08:00
lhk229	155f0d316a	新增 external v1 游戏场景生成路由并迁移 AGC 美术包背景阶段 (#516) ... - api-server 新增 POST /api/external/v1/editor/scenes/generations，复用 editor:image-generate scope、幂等键和站内场景生图队列 - editor_project.rs 抽取站内与外部共用的场景生图 payload 构造函数，站内 handler 改为调用共享函数 - 同步更新 external v1 OpenAPI 契约与 MCP 派生排除标记，登记 docs/README.md 索引 - AGC 客户端美术包背景阶段改走新场景路由，stylePreset 固定 custom + customStyle 保留现有风格文案 - external_generation_state 快照与 recovery_scan 账本白名单支持新场景路由 - direct_runtime 背景资源识别同时兼容新场景路由与旧通用路由，新增旧路由回放测试 - 更新 genarrative-external-editor-api skill 参考文档 - 新增主规范、里程碑规范与实施计划三份 SDD 文档 Reviewed-on: #516	2026-09-27 18:39:01 +08:00
suzmii	997eba2b7b	Merge branch 'master' into enhance/default-model	2026-09-24 18:02:01 +08:00
lhk229	a07bff85ec	升级mcp，增加按语义分类的工具。旧工具不变 (#493) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/493 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-24 17:19:45 +08:00
suzmii	4234a21eed	服务端：AGC 模型目录缺配置时改为启动期从上游同步，保留原目录格式 ... - module-runtime：删除写死的初始目录（高质量→gpt-6-astra、快速→gpt-5.6-luna），新增 from_upstream_models：id 用模型名 slug、alias/modelId 用上游原名、默认项取排序后第一项；字段与校验规则不变 - spacetime-module：read_agc_model_catalog 缺行返回 AGC_MODEL_CATALOG_NOT_INITIALIZED，不再返回内置目录 - api-server：新增启动期 ensure_agc_model_catalog_initialized，未初始化时从分组定价列表 GET /api/pricing?group=taonier 生成目录并按存量 revision 写回；拉不到只记录 error、不写替代目录，下次启动重试 - api-server：目录未初始化时 AGC 目录/对话接口与后台目录接口返回 503，不回落任何内置模型名；后台 PUT 同样要求已初始化 - api-server：上游请求 10s 超时、1 MiB 流式上限、禁止重定向、不带凭据；目标校验只校验地址，不再绑定已下线的固定模型哨兵；写回冲突后重读校验既有目录	2026-09-24 16:18:06 +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
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	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	297d7bf1e7	优化 AGC 发布资料与截图交互 ... 发布门禁阻断提示改为独立弹窗且不写入聊天记录 移除发布面板发行包技术摘要 新增免费发布简介与分类建议接口和前端回填 接入封面泥点定价、确认与生成流程 截图改为并行上传，单张失败隔离且不阻断发布 截图操作改为图标，失败项内嵌错误与删除 同步发布合同、实施计划和决策记录	2026-09-23 17:40:08 +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