168 Commits

Author	SHA1	Message	Date
suzmii	eeb101458a	Merge remote-tracking branch 'origin/master' into feat/game-fork ... # Conflicts: # apps/ai-game-creator-shell/src-tauri/src/game_distribution_publish.rs # apps/ai-game-creator-shell/src/components/game-distribution/GameDistributionPublishPanel.tsx # apps/ai-game-creator-shell/tests/gameDistributionPublishPanel.test.tsx # docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md # package.json # packages/shared/src/contracts/gameDistribution.ts # scripts/check-game-distribution-dto-parity.mjs # server-rs/crates/api-server/src/modules/game_distribution.rs # server-rs/crates/module-game-distribution/src/errors.rs # server-rs/crates/module-game-distribution/src/lib.rs # server-rs/crates/shared-contracts/src/game_distribution.rs # server-rs/crates/spacetime-client/src/active.rs # server-rs/crates/spacetime-client/src/active/mapper.rs # server-rs/crates/spacetime-client/src/active/mapper/game_distribution.rs # server-rs/crates/spacetime-client/src/game_distribution.rs # server-rs/crates/spacetime-client/src/module_bindings.rs # server-rs/crates/spacetime-client/src/module_bindings/game_distribution_game_snapshot_type.rs # server-rs/crates/spacetime-client/src/module_bindings/game_distribution_game_type.rs # server-rs/crates/spacetime-module/src/game_distribution.rs # server-rs/crates/spacetime-module/src/migration.rs # src/components/game-distribution/GameDetailPage.tsx # src/components/game-distribution/GameDistributionPages.test.tsx # src/components/game-distribution/GamePlayPage.tsx # src/components/platform-entry/PlatformEntryActiveFlowShell.tsx # src/services/gameDistributionClient.test.ts # src/services/gameDistributionClient.ts	2026-10-06 16:10:52 +08:00
suzmii	909f3d5fa2	网页端共创主题：共创 Tab + 主题页（逐根内嵌作品树）+ 详情页主题入口 + 网关清单 ... - 客户端：新增 listThemes（游标分页，读 nextCursor）与 getTheme（404 由页面渲染成降级态）；getGame 的返回类型增量 themes（匿名也返回；无主题时是空数组而不是缺键） - 共创 Tab：广场页新增「游戏 / 共创」页签，复用既有 game-category-tabs 结构与类名，切到 /games/themes - 主题列表页 GameThemesPage：卡片展示 name / summary / badge / memberCount；只有 nextCursor 非空才渲染「加载更多」并在点击时追加；空态与失败重试照既有写法 - 主题页 GameThemePage：标题 / 简介 / 角标 + 成员根清单；**逐根内嵌渲染作品树**——直接复用族谱页（GameLineagePage 新增 embedded 变体，只隐藏页面外壳：返回按钮 / 页头 / 脚注），树查询、可见性过滤、稳定排序与截断全部走 M3 那一份实现，不新建第二套树查询或树渲染（每根一次 /lineage 的 N+1 是技术方案 §3.10.4 已接受的取舍）；已发布但可见成员为空 → 明确空态而不是错误；主题不存在 / 未发布 → 错误态 - 详情页：共创信息卡渲染所属主题角标（点击进主题页），第 N 代作品同样可见（服务端按根反查）；无主题时不渲染空容器 - 路由登记：新增 /games/themes 与 /games/theme（详情用 ?id=），四处同批登记（STAGE_ROUTE_ENTRIES + SelectionStage 类型 + 壳层 lazy/回调/渲染分支 + 页面标题），并同步三份 nginx SPA allowlist 与 Pingora MAIN_SPA_PATHS：check:nginx-spa-routes（20 SPA routes / 3 模板）与 check:pingora-route-parity 均绿 - 测试：主题列表三例（渲染与卡片跳转 / 有游标时的加载更多与追加 / 空态与失败重试）、主题页三例（逐根两棵树且复用 lineage 查询 + 全屏入口参数 / 空成员空态 / 404 错误态）、详情页主题入口两例（渲染并可跳转 / 无主题不渲染容器）、路由与标题登记断言、壳层三例（页签切换 / 列表进主题页 / 主题页按 ?id= 渲染并复用族谱查询）	2026-10-06 03:45:38 +08:00
suzmii	dcef9b62a8	修复买断制付费评审问题：后台消耗统计、定价上限校验、付费入口自动化断言 ... - admin.rs：钱包流水来源映射补齐第 17 个变体（索引 16 → game_purchase），后台「消耗泥点」白名单新增 game_purchase，并抽出效果分类与单行累加函数 - profile.rs：消耗口径抽出 profile_wallet_ledger_source_counts_as_consumption，消费投影增量、历史花费重建、投影初始化三处一并纳入 GamePurchase - module-game-distribution/errors.rs：价格上限文案改为插值 MAX_GAME_PRICE_MUD_POINTS，并新增文案断言 - 新增 scripts/check-game-distribution-price-limit-parity.mjs 并挂进 npm run lint（随 Repository checks 在 CI 生效）：断言 TS / 服务端 Rust / AGC Rust 常量与网页侧别名四处同源 - api-server 发行网关抽出可注入 loader 的 serve_public_release_asset，付费 404 严格发生在读取包字节之前；播放会话准入抽出 resolve_paid_play_session_entitlement - 新增 api-server 单测：付费发行路径 404 且零次读包字节、免费放行且读到包字节、未购买 403 与作者 / 已购买 / 管理员放行 - spacetime-module：把「先判定后扣费」从源码扫描改为 resolve_game_purchase_pre_charge_plan 纯函数断言，删除 include_str 源码切片用例 - E2E 脚本：平台同源断言缺配置时记 SKIP 并在报告末尾汇总 SKIP 清单，E2E_REQUIRE_PLATFORM_ORIGIN=1 时缺配置直接 FAIL，汇总行改为输出 PASS/FAIL/WARN/SKIP 计数 - 修正注释里不存在的路由 POST /api/game-distribution/play-sessions（真实为 POST /api/game-distribution/games/{gameId}/play-session）与「管理员令牌 403」口径（403 需带 admin 角色的用户令牌）	2026-10-06 02:24:40 +08:00
suzmii	96309c895c	新增「原版与二创对比」页与路由登记（含 nginx×3 + Pingora allowlist） ... - 新增路由 /games/compare（stage game-compare）：STAGE_ROUTE_ENTRIES + SelectionStage 类型 + 壳层 lazy 引入/导航回调/渲染分支 + 页面标题，四处同批登记 - 三份 nginx SPA allowlist（deploy/nginx/genarrative.conf、deploy/nginx/genarrative-dev-http.conf、deploy/container/nginx.conf）与 Pingora MAIN_SPA_PATHS 同步放行 /games/compare（保持既有排序）：check:nginx-spa-routes 18 SPA routes、check:pingora-route-parity 均绿 - 对比页左右两侧各自取数与降级：任一侧不可读（不存在/未公开/已软删除）或没有可玩版本时只降级那一侧，另一侧照常；显示标题、作者与代际；桌面左右并排、窄屏上下堆叠 - iframe 复用游玩页同一份嵌入：抽出 GamePlayFrame（sandbox=allow-scripts、allow=fullscreen、referrerPolicy=no-referrer、.game-player-frame），游玩页改为渲染它，不再存在第二套嵌入逻辑 - 入口：二创作品详情页在存在父作品时给出「与原版对比」；族谱节点仅在其父作品可见时给出同一入口 - 测试：对比页两侧渲染与 iframe 复用属性、单侧降级后另一侧照常；详情页入口（有/无父作品）；族谱节点入口（父可见才出现）；路由与标题登记；壳层「族谱节点→对比页」导航与对比 stage 渲染 - 顺手：按 eslint 自动修复两个文件的 import 排序	2026-10-06 00:56:31 +08:00
suzmii	959ed4fd53	合并 origin/master（51cb05f41，22 个提交）到 feat/game-purchase ... - 逐块合并 server-rs/crates/api-server/src/modules/game_distribution.rs：以 master 的 ReleaseAssetResponseInput / 5 参 release_asset_response_with_cache / ETag / 304 / gzip 结构为准，并在其上保留本分支的付费 404 守卫（price_mud_points > 0 仍在 release_package_bytes 读包之前返回）；播放会话资源响应改用同一结构（etag None、cache_control no-store、沿用 accept-encoding 协商）。 - 合并 src/components/game-distribution/GamePlayPage.tsx：接入 master 的共享 PlatformGameLoadingSurface 与 PLATFORM_GAME_LOADING_TIMEOUT_MS，删除本地重复常量 GAME_PLAY_STARTUP_TIMEOUT_MS 与裸 div，买断制播放会话准备态改由共享加载面承载。 - 合并 src/components/game-distribution/GameDetailPage.tsx：同时保留 master 的 onOpenCreator 作者插槽与本分支的买断制购买弹窗、onOpenRecharge 充值入口。 - 合并 vite.config.ts：保留 master 的 /api/creators 代理，并保留 play-sessions 前缀清 Cookie 规则（顺序仍在通用 /api/game-distribution 之前）。 - 合并 deploy/nginx/README.md：保留 master 的 SPA allowlist 门禁口径（含 /creators、/creators/connections）与本分支的播放会话前缀章节；三份 nginx 模板的 ^~ play-sessions location 与清 Cookie 原样保留。 - 合并 apps/admin-web/src/pages/AdminGameDistributionReviewPage.test.tsx：保留 master 的加载面/超时用例与本分支的审核价格（冻结价优先、历史按 0）用例。 - 合并 src/components/game-distribution/GameDistributionPages.test.tsx：保留双方 mock，并新增「付费作品在会话签发期间显示共享加载面」用例。 - 合并 docs/【玩法创作】平台入口与玩法链路-2026-05-15.md（保留买断制合同并回填 master 的创作者主页与关注粉丝合同）、decision-log.md、pitfalls.md：追加双方条目，不改写任一侧正文。 - 保留 master 侧新增能力：release_asset_etag / if_none_match_matches / accepts_gzip_encoding / gzip_release_asset / release_asset_not_modified_response、SPA 加载面、创作者主页与关注粉丝（user_follow 表、creator 查询与 author_id 过滤）。	2026-10-06 00:28:36 +08:00
suzmii	bdcefe91d1	Merge remote-tracking branch 'origin/master' into feat/game-fork ... # Conflicts: # deploy/container/nginx.conf # deploy/nginx/genarrative-dev-http.conf # deploy/nginx/genarrative.conf # server-rs/crates/api-server/src/modules/game_distribution.rs # src/components/game-distribution/GameDetailPage.tsx # src/components/game-distribution/GameDistributionPages.test.tsx # src/components/platform-entry/PlatformEntryActiveFlowShell.tsx	2026-10-06 00:19:40 +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
suzmii	d7c4f82d7d	修复自查发现的门禁与体验问题：格式、超时态语义、压缩 CPU 边界 ... - 新增 Rust 测试补齐 cargo fmt；ESLint 按仓库约定收口：常量与解析函数拆到 platformGameLoadingSurfaceModel.ts，删除 GAME_PLAY_STARTUP_TIMEOUT_MS 常量别名（测试直接用共享常量） - 共享加载面新增 stalled：宿主判定等待不再推进时停掉进度动画并把 aria-busy 置回 false（去掉与 role=status 重复的 aria-live） - 后台试玩超时时传入 stalled，避免「一边转圈一边说超时」 - Accept-Encoding 权重参数名改为大小写不敏感（RFC 9110 §12.5.3），GZIP;Q=0 视为拒绝并补用例 - 发行资源压缩分级：≥2 MiB 改用 level 1（zlib 端实测约 1/3 耗时、压缩比差约 3%），小文件仍用 level 6 - 文档：主规范补压缩与条件请求契约（并写明 60 秒窗口与撤销窗口不放宽）、nginx README 修正 Pingora 压缩关闭时的口径、pitfalls 补 CPU 边界与措辞修正	2026-10-05 18:02:48 +08:00
suzmii	d40df89e2c	修复付费游戏播放会话在边缘转发 Cookie 导致 403 不可玩 ... - nginx：三份模板在通用 /api location 之前新增 location ^~ /api/game-distribution/play-sessions/，代理头与通用 /api 一致并清空 Cookie - nginx：^~ 保证该前缀不被正则 location ~ ^/api(?:/|$) 抢先；只匹配带尾斜杠的前缀，创建会话端点继续走通用 /api 并保留 Cookie - pingora：新增 RouteDecision::PlaySessionGateway，走 api 上游并同样套用 api 限流分组、大小上限与维护闸 - pingora：抽出 route_clears_cookie，发行入口 ReleaseGateway 与播放会话入口在上游代理阶段统一清空 Cookie - pingora：classify_path 在通用 /api 分支之前命中播放会话前缀，并新增播放会话路由、Cookie 清除与保护等级用例 - 路由矩阵：新增 play_sessions_gateway 用例，声明清空 Cookie 与 protectionClass api - 门禁 check:nginx-spa-routes：新增播放会话前缀断言——三份模板存在 ^~ location、块内清空 Cookie、代理头齐全且排在通用 /api location 之前 - 门禁 check:pingora-route-parity：新增断言——平台内容网关用例必须清空 Cookie 且不得复用通用 /api location，Rust 播放会话分支必须排在通用 /api 之前并由 route_clears_cookie 清理 - 门禁 check:pingora-gateway-smoke：新增真实网关用例——播放会话前缀转发到 api 上游并清空 Cookie、创建会话端点保留 Cookie - dev：vite.config.ts 在 /api/game-distribution 规则之前新增同名前缀代理并清除 Cookie - 文档：同步 Pingora 试点文档、本地开发运维文档、deploy/nginx/README 与 shared-memory 决策/踩坑记录	2026-10-05 17:53:51 +08:00
suzmii	5795a07a7d	fix(部署): nginx SPA allowlist 补 /games/lineage（三份模板同批） ... - `deploy/nginx/genarrative.conf:237`：allowlist 交替项插入 `games/lineage`（放在 `games/detail` 与 `games/mine` 之间，保持既有字典序） - `deploy/nginx/genarrative-dev-http.conf:209`：同上 - `deploy/container/nginx.conf:160`：同上（8 空格缩进，`~*` + `/?$` 形态不变） - 原因：M3 新增网页端 SPA 路由 `/games/lineage`（`src/routing/activeAppPageRoutes.ts:18`）后没同步三份 nginx 模板，`npm run check:nginx-spa-routes` 以 9 条断言失败（每份模板 3 条：缺少路由 / 未匹配完整路径 / 未允许大小写差异与尾部斜杠）；CI run 3387 的 `Repository checks`（3m36s）即因此红，属本分支引入（master 尖端 `6c9566058` 8/8 绿） - 只补路由项，未改门禁脚本、未放宽任何断言、未动 `apps/**`、`server-rs/**`、`src/**` - 验证：`npm run check:nginx-spa-routes` → OK（15 SPA routes / 1 prefix routes / 3 Nginx templates）	2026-10-05 17:30:47 +08:00
suzmii	3206f8f49b	修复在线游玩加载体验：加载期黑屏/空白与发行资源传输开销 ... - packages/shared 新增共享游戏加载面 PlatformGameLoadingSurface：封面/标题 + 动效进度 + 按时长推进的阶段文案（准备/资源/引擎）+ 慢加载提示，附用例 - 网页游玩页用共享加载面替换近黑壳上的一行小字，加载上限改为共享常量 PLATFORM_GAME_LOADING_TIMEOUT_MS - 后台审核试玩补加载面、20 秒超时与「重新创建试玩会话」入口，新会话重置加载态；补两条用例 - 发行网关（api-server）对文本类发行资源按 Accept-Encoding 下发 gzip，并下发强 ETag、命中 If-None-Match 返回 304；补 5 条 Rust 用例 - E2E 脚本 check-game-distribution-ops-rollback-e2e 补压缩/Vary/ETag/304/不接受 gzip 四条断言 - 同步 pitfalls、开发运维文档、nginx README 与两份里程碑记录	2026-10-05 17:14:32 +08:00
suzmii	ad0430fcd2	补上收银台深链 /pay/<checkoutToken> 的前缀路由（Nginx 三模板 + Pingora + 门禁） ... - 现状：只把 `/pay`、`/profile/payment` 加进 allowlist 只能让 check:nginx-spa-routes 变绿； payment.rs 生成的 checkoutUrl 是 `/pay/<checkoutToken>`，深链仍落默认 location 的 try_files → 404。同一批漂移里 check:pingora-route-parity 也是红的（Pingora MAIN_SPA_PATHS 缺 /pay、/profile/payment），只是被 lint 链里先失败的门禁掩盖，修一条要跑到链尾 - 真相源：src/routing/activeAppPageRoutes.ts 新增 APP_PREFIX_ROUTE_ENTRIES （'/pay' → payment-checkout），resolveSelectionStageFromPath 改用它 - 门禁：scripts/check-nginx-spa-routes.mjs 要求三份模板都有锚定前缀 location `location ~* "^/pay/[^/]+/?$"`（裸前缀仍由精确 location 负责；前缀 location 必须镜像精确 location 的维护闸与 try_files 回退）；新增 scripts/check-nginx-spa-routes.test.mjs 正/反用例 （把前缀写成精确匹配或过宽裸前缀都会红），由 npm run check:nginx-spa-routes 一起执行； check-pingora-route-parity 新增 MAIN_SPA_PREFIX_PATHS 与前端前缀路由的逐条比对 - 模板：deploy/nginx/genarrative.conf、deploy/nginx/genarrative-dev-http.conf、 deploy/container/nginx.conf 各加一条锚定前缀 location - Pingora：MAIN_SPA_PATHS 补 /pay、/profile/payment；新增 MAIN_SPA_PREFIX_PATHS 与 is_main_spa_prefix_path（大小写不敏感，只认「前缀 + 恰好一段」），矩阵新增 pay_checkout_spa_fallback 用例，并给网关补一条前缀正/反单测 - 文档：Pingora 试点文档的路由表与门禁说明、deploy/nginx/README 与本地开发/生产运维文档 同步前缀路由口径与线上 curl 复验方式 - 本地实跑：node --test scripts/check-nginx-spa-routes.test.mjs（4 passed）、 node scripts/check-nginx-spa-routes.mjs（OK，14 SPA routes / 1 prefix routes / 3 templates）、 npm run check:pingora-route-parity（OK，25 routes）、 cargo test -p pingora-gateway -- pay_checkout_deep_link matches_nginx_route_parity_matrix（2 passed）	2026-10-04 03:25:54 +08:00
suzmii	26b6e1095b	修复 Nginx SPA allowlist 缺少 /pay 与 /profile/payment ... - src/routing/activeAppPageRoutes.ts 的 STAGE_ROUTE_ENTRIES 已把 payment-checkout→/pay、 profile-payment→/profile/payment 定义为主站对外可直达的 SPA 路由（分别渲染 PaymentCheckoutView 与 PlatformPaymentServiceView），但三份 Nginx 模板的 SPA allowlist 仍停留在加入支付入口之前的集合，导致 check:nginx-spa-routes 在 master 上失败 - deploy/nginx/genarrative.conf、deploy/nginx/genarrative-dev-http.conf、 deploy/container/nginx.conf 的 SPA regex 补上 pay、profile/payment， 保持既有形状（锚定完整路径 + 大小写不敏感 + 允许一个尾部斜杠） - 本地实跑：node scripts/check-nginx-spa-routes.mjs → OK (14 SPA routes, 3 Nginx templates)	2026-10-04 00:56:54 +08:00
k88936	4246052bff	合并 origin/master 到 feat/typed-tool-error ... - 取 master 退役 DirectProject 工具调用与回合流账本（#560）：删除 direct_tool_calls / direct_turn_stream，direct_events 的回合更新收敛为状态与活动，不再广播 game-creator-direct-turn-update - 取 master 修复 AGC 文件列举被无关临时锁删除打断（#552）与素材导入 / 资源提交项目锁争用（#581） - 保留本分支 typed 工具错误口径：逐工具错误枚举、派发边界携带原始 error、工具返回不再软失败 - 保留本分支退役 AGC 独立 Agent Runtime / CLI 执行面的删除，继续删掉 master 侧 runtime_actions 等测试与入口 - 补齐 master 新增的 with_conversation_write_contention 测试助手，项目写锁调用统一为 acquire_project_write_lock_with_wait - 账户素材分页 offset 上限 500 的 schema、预检与行为对齐，越界 offset 返回 typed 错误并适配相关用例 - 错误事件结构体 message 保留调用方原文，脱敏只发生在落盘与应用日志边界	2026-10-02 16:18:50 +08:00
k88936	839051f532	退役AGC独立Agent Runtime与CLI执行面 ... - 删除 agent/runtime_driver、runtime_protocol、runtime_tools、runtime_actions、runtime_state、runtime_adapter、context_compaction、collaboration、delegation、goal 等自建 Runtime 执行面及专属测试与 fixture - CliCommand 收敛为 LlmStatus | EnvironmentCheck | PreviewServe，删除 --agent-run / --agent-task / --agent-goal-* / --agent-resume / --agent-context-compact 等 CLI 与 Tauri 命令白名单条目 - 外部 Runner 收缩为编辑器桥 RPC 与 runner.attach_gui_owner + GUI owner 参与锁 / watchdog，保留 --agent-runner - 前端删除 AgentRuntime* / AgentGoal* 状态与命令调用链，移除 agent-runtime real-e2e / steer / smoke / llm-transient-fault 脚本与对应 CI job - 内置工具错误收口为 typed error，抽取 agent/tool/error.rs 共享错误供各工具复用 - 新增 agent/redaction.rs、runtime_models.rs、json_sidecar.rs、task_lock.rs、process_identity.rs、art_manifest.rs、design_session.rs、direct_events.rs - 同步更新 ADR、decision-log、Runtime V1.1、App 实施计划、本地开发运维、pitfalls 与 CI 脚本	2026-10-02 15:23:12 +08:00
kdletters	ac4148d24b	生产 Nginx 收敛到仓库模板并同步生产机 host-only 覆盖 ... - 主模板 http 段新增 genarrative_gallery_rps 限流 zone，供公开作品架与自定义世界画廊读取接口使用 - 新增 deploy/nginx/snippets/genarrative-host-extras.conf：内部工具页、公开画廊读取 location、主站官网首页入口 - 主模板改为 include host-only snippet，线上 vhost 以仓库模板为唯一来源 - Server-Provision 安装、备份并回滚 genarrative-host-extras.conf，补充 require_path 与临时文件清理 - 生产运维护栏新增 host-only snippet 安装断言 - 运维文档补充主站 SPA 白名单与 host-only 覆盖小节及生效配置核对命令 - 踩坑记录新增线上手工维护漂移条目：/profile 刷新 404 与 client_max_body_size 停在 64m - 决策记录新增生产 vhost 单一来源、host-only 独立成 snippet、退役路由不做显式 404 的长期口径	2026-10-01 18:37:46 +08:00
kdletters	c25fd47d16	纠正清智创游官网游戏下载线上路由 ... 移除错误的独立主站 vhost 配置 补充官网现役 vhost 的精确下载接口 snippet 同步线上排障说明与回归测试	2026-09-30 14:52:02 +08:00
kdletters	05bf69f2c2	修复清智创游官网引擎下载接口路由 ... 新增 tsingnovagames.com 独立 Nginx vhost 并代理 /api 到 api-server 补充官网 /home/ 静态首页与下载接口回归测试 同步生产运维验收与排障说明	2026-09-30 14:18:12 +08:00
kdletters	38eb5b69ed	给路由 parity 门禁补反向覆盖，模板里的 location 必须被矩阵声明 ... - check-pingora-route-parity 新增 validateNginxLocationsAreCovered：两份 Nginx 模板里出现的每条 location 都必须被矩阵某条用例的 nginx 片段（location 前缀）声明，否则判红 - 这条针对的正是 2026-09-29 发行网关路由那类漂移：此前只做正向检查（矩阵片段必须存在于模板），模板单方面加路由时门禁一直是绿的 - 矩阵新增 web_root_spa（samplePath=/ → static/web/spa_fallback，片段 location = / + try_files /index.html =404;）并把三个新 id 列入必查清单；Pingora 试点文档补根路径回退与反向覆盖说明 - 验证：check:pingora-route-parity OK（24 路由）、check:nginx-spa-routes OK（12 路由 / 3 模板）、cargo test -p pingora-gateway 39 passed、check:production-ops、prettier / eslint / encoding / doc-index / diff 全绿；变异验证：往生产模板插一条无矩阵声明的 location → 只有反向覆盖报「production 模板的 location 没有被矩阵覆盖」	2026-09-29 07:29:41 +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	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	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	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
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
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
lhk229	85f2831f16	补齐客户端埋点环境变量示例 ... 补充本地、生产及容器的埋点 origin 配置示例和 dev/release 说明。 同步技术方案中的运行时配置入口与地址匹配要求。	2026-09-22 16:14:05 +00:00
lhk229	5c2f85c089	修复 CI 缓存镜像组装的基础镜像引用 ... 使用临时本地标签和宿主默认 builder 组装缓存镜像 组装成功或失败后清理临时标签，保持基础镜像清理归属 补充基础镜像复用、重建及失败清理测试 同步部署文档和项目共享记忆	2026-09-22 15:03:05 +00:00
lhk229	4380d453d7	修复 CI 缓存对象误判与产物下载完整性检查 ... 按 ZIP 成员内容和元数据识别等价缓存对象，保留真实冲突拒绝规则。 核对产物大小与 ZIP 完整性，为截断和临时传输失败增加有界重试。 补充回归测试并同步部署文档与共享记忆。 通过 80 项缓存测试、17 项工作流测试及真实产物和 HTTP 截断验证。	2026-09-22 14:40:55 +00:00
lhk229	7bc411119c	修复 CI 镜像脚本的 Buildx 驱动检查兼容性 ... 读取 buildx inspect 的 Driver 字段，移除不受支持的 --format 参数。 收紧 Docker 测试替身参数检查，并覆盖错误驱动拒绝行为。 更新部署文档与共享记忆，记录真实 Buildx 兼容性验证要求。	2026-09-22 11:45:22 +00:00
lhk229	1e6b0e5684	优化 Gitea CI 镜像下载缓存与维护日志 ... 使用专用 BuildKit builder 持久复用 Cargo 与 npm 下载缓存，并支持从可信镜像导入 按当前依赖物化镜像下载快照，配置独立缓存回收策略 补齐 AGC vendor 本地依赖清单并缩小构建上下文 增加缓存维护阶段、耗时和失败日志路径 补充下载缓存与构建上下文测试，同步部署说明和共享记忆	2026-09-22 11:23:46 +00:00
lhk229	b7ca94334f	修正 CI 缓存部署的网络地址与验收流程 ... 区分任务容器、Runner 网关和宿主源码拉取地址 记录内层 Docker 独立地址池与遗留网络定向清理方式 补充真实任务网络中的源码拉取和 API 连通性验收 同步团队开发流程中的部署约定	2026-09-22 10:05:23 +00:00
kdletters	c0c5255b31	Merge branch 'master' into codex/game-distribution	2026-09-22 17:26:50 +08:00
lhk229	705bb1e6b3	CI缓存自动维护与清理 (#462) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/462	2026-09-22 17:19:11 +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
lhk229	292e42cf5e	为全部 Rust 测试组启用隔离编译缓存 ... 扩展缓存消费到 AGC 双 lane、crates、smoke、后端及桌面壳测试 补齐各组实际编译目标和工作目录的可信快照预热 保留 SpacetimeDB 独立编译边界并排除发布构建缓存 根据完整快照体积将对象缓存上限调整为 4 GiB 更新工作流契约测试、运维文档及项目共享记忆	2026-09-22 05:52:16 +00:00
lhk229	48eb3d5007	Opt/ci (#456) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/456 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-22 12:42:27 +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	90207bc1d5	minimal 备份增加 freeze 副本路径 ... - database-backup-to-oss.mjs 新增 --freeze-dir：minimal 模式先把选中子集 rsync 成冻结副本（保持原始相对路径）再从副本上传，避免热备时最新 commitlog 持续追加触发 stat 漂移失败 - files-minimal systemd 模板与发布前 minimal 备份默认传入 freeze 目录 - 生产运维门禁同步 freeze 口径断言	2026-09-21 11:37:14 +08:00
kdletters	2f248ea0c3	新增 minimal 备份口径并切换 release 定时备份 ... - database-backup-to-oss.mjs 新增 --minimal/--retain-snapshots：按上游 retention 语义只备份最近 N 份 snapshot、覆盖最老保留 snapshot 的 commitlog 边界段及其后全部段，外加身份/配置/控制库/模块字节，且不停止任何服务 - 备份检查脚本补充 minimal 计划用例（保留次新+最新 snapshot、丢弃更早 snapshot 与 clog 段、状态路径齐全、保留数校验） - 发布前备份默认走 minimal 热备（GENARRATIVE_STDB_PUBLISH_BACKUP_MINIMAL=0 可回到冷备），不再需要 44.7GiB 冷备空间 - Server-Provision 新增 DATABASE_BACKUP_PROFILE=files-minimal 与 systemd drop-in，release 推荐使用并继续禁止 files-history - 运维文档与共享记忆记录上游 retention 依据、实测 40G→3.6G 与不停服热备口径	2026-09-21 11:33:39 +08:00
kdletters	0ac86f941c	优化 Gitea CI Rust 分片并发 ... 将四个 AGC Rust shard 合并为两条 lane，减少重复预热与排队 同步 workflow 契约测试、分片说明和运维文档	2026-09-21 07:56:06 +08:00
kdletters	4b788fa73a	修复 Gitea CI 镜像构建并刷新到 1.98.1 工具链 (#438) ... 修复 CI job 镜像无法构建的问题，并换用 Rust 1.98.1 工具链镜像，跑通 PR 门禁。 Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/438 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-21 06:15:57 +08:00
kdletters	5ac7f65c92	合并 master 并保留游戏分发功能 ... - 合并 origin/master（含 429f991bd 定向回滚、Godot 原生绑定迁移与策划 Agent 模型控件）。 - 回滚提交删除的游戏分发代码按功能面补回：SpacetimeDB 模块注册与迁移表、api-server 路由与权限映射、后台审核页、AGC 发布命令与 payload 类型、SelectionStage 的 games 阶段、ProjectSupervisorView 的 overlay 挂载点、主站路由与标题、Cargo 依赖与锁、vite/vitest 代理与 tailwind source。 - 保留 master 的 Godot C++ 迁移（移除旧 vendored GDExtension、新的 composer 控件布局）与其它 master 侧改动。 - 修正 master 自带的红灯断言：/api/creation-entry 已被 api-server 列入退役路由，dev 中间件按退役路径 404，测试改为断言不进入代理。 - 验证：cargo check（api-server / spacetime-module / spacetime-client / AGC 壳）、cargo test（api-server 游戏分发 17、module-game-distribution 11、AGC 本地导出 7）、全量 vitest 4557 passed、两端 typecheck、eslint、rustfmt、编码、文档索引与 SpacetimeDB schema guard。	2026-09-21 00:20:45 +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
suzmii	a35cdcc68c	同步 CI 镜像 tag 与文档口径，并补上工具链一致性护栏 ... - 将 CI job 镜像默认 tag 从 genarrative/gitea-project-ci:20260807.1 升为 20260920.1 - 将 Dockerfile 两处 org.opencontainers.image.version 统一为 2026.09.20.1（原先一处 2026.07.23.1、一处 2026.08.07.1，后写的覆盖先写的） - 同步 deploy/container/README.md 与开发运维文档中的镜像归档示例名 - 订正 pitfalls.md 中 CI 镜像的 Rust 版本，并记录 number_of_links 在 1.98.1 上实测仍未稳定 - 在 decision-log.md 追加本次 Rust 工具链升级到 1.98.1 的决策条目 - 在 scripts/project-ci-workflow.test.ts 新增一致性用例：镜像版本段、digest 与 tag 必须与 rust-toolchain.toml 及两份运维文档一致	2026-09-20 17:06:49 +08:00
suzmii	8a3daff55b	升级 Rust 工具链到 1.98.1 ... - 将 rust-toolchain.toml 的 channel 从 1.96.0 提升到 1.98.1，保留 rustfmt 组件要求 - 将 CI job 镜像 Rust stage 从 rust:1.96-bookworm 更新为 rust:1.98-bookworm，并同步新的固定镜像 digest - 同步 deploy/container/README.md 中 Rust 版本与 digest 的说明 - 同步开发运维文档中 CI 环境与 rust-toolchain.toml 的版本口径为 1.98.1	2026-09-20 15:59:07 +08:00
kdletters	f5b4293e80	预览控制面支持展示公网预览地址 ... - preview-deployer-server 新增可选配置 GENARRATIVE_PREVIEW_DEPLOYER_WEB_DOMAIN，并按「实例 ID + 预览域名」派生公开字段 webPublicUrl，卸载时与 webUrl/webPort 一起清空、加载状态文件时重新派生覆盖 - preview-deployer-web 在存在公网地址时把「打开公网预览」作为主入口，内网地址降级为次级链接，未配置时行为不变 - deploy/env/preview-deployer.env.example 补充 WEB_DOMAIN 键与留空语义说明 - 补充 cargo 与 vitest 用例覆盖公网地址派生、域名配置校验与页面展示	2026-09-17 20:29:42 +08:00
kdletters	1a7abfd059	AGC 项目定时快照上传（目标 OSS agc-dev） (#400) ... ## 交付内容 - 客户端新增 `project_snapshot` 模块：项目扫描与排除口径、增量索引、差异对比、上传编排、状态查询。 - 触发：工作区窗口存活期间的周期定时器 + 工作区窗口关闭（`CloseRequested`）；应用退出只在有界预算内等待在途同步收尾，不重复发起。 - 服务端新增两条登录态路由 `POST /api/agc/project-snapshots/files` 与 `/manifest`，由 api-server 用服务端凭据写入私有前缀 `agc/project-snapshots/v1/{user}/{project}/`；客户端不持有 OSS 凭据、不直连 OSS。 - `platform-oss` 新增内部对象精确写入与探测、项目快照对象键构造；修复 `head_internal_object` 读 HEAD 响应长度恒为 0（会导致服务端"已存在即跳过"永不生效）。 - `shared-contracts` 新增 `agc_project_snapshots` DTO 与项目 ID、相对路径、摘要校验。 - 真实 OSS 存储层冒烟示例 + 客户端真实链路冒烟用例（`#[ignore]`，env 驱动）。 - 登记 `check-config.mjs` 的 native-only 命令白名单，恢复 `npm run agc` 可启动。 ## 验证证据 - 存储层：`cargo run -p platform-oss --example agc_project_snapshot_live_smoke` 对真实 `agc-dev` 完成写入 → 读回（contentLength 32）→ 清单写入 → 探针清理。 - HTTP 层：登录态下 7 项校验（401 无 token、400 路径穿越/长度不一致/非法摘要/空正文/重复路径清单）全部符合预期且不写对象。 - 客户端链路（真实项目 gameagent-033b6cf3…）：第一次 `synced uploaded=6 uploadedBytes=36694 remoteSkipped=6`，紧接着第二次 `no-op uploaded=0`。 - GUI 触发：`trigger=periodic ... uploaded=6`；把周期设为 600 秒排除干扰、改一个文件后关窗得到 `trigger=project-close ... revision=2 uploaded=1`，索引摘要由 `28d837cd84f8ab62` 推进到 `bff34e2e336d901f`（同步在进程退出前完成）。 - 门禁：AGC `project_snapshot` 14 passed（+1 ignored live）、api-server `project_snapshots` 3 passed、platform-oss 39 passed、shared-contracts 87 passed、`cargo fmt --check`（两处）、`check:encoding`、`check:doc-index`、`git diff --check`、`check-config.mjs` 全部通过。 ## 已知未决（不阻塞本里程碑） - 远端对象只增不减：没有删除路径，也没有 bucket 生命周期规则；要收口需要先定保留语义（清单引用 GC 还是 OSS 生命周期）。 - 部署环境需确认 `GENARRATIVE_AGC_PROJECT_SNAPSHOT_OSS_*` 或回退的 `ALIYUN_OSS_*` 具备目标 bucket 私有前缀的 `PutObject` 权限；未配置时接口返回 503、客户端失败关闭（不推进索引）。 - 缺少按用户/项目的配额与限流（error_reports 有每小时提交上限的先例，本功能没有）。 - 没有界面入口与状态可见性：`read_local_project_snapshot_state` 已注册但未接 UI，失败只写本机日志。 ## 不做 - 不做云端下载/恢复、跨设备合并、版本回滚。 - 不改 `/api/external/v1` 与 External OpenAPI，不新增 SpacetimeDB 表。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/400	2026-09-17 18:34:51 +08:00