1060 Commits

Author	SHA1	Message	Date
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
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	20b594d4f2	清理后端未使用代码及废弃测试 ... 删除编辑器旧分段持久化、生成任务收尾和音频发布链路 删除未使用辅助函数及其专属测试，修正受影响的现有测试边界 保留现役实现，将纯退款测试辅助函数移入测试模块 同步原子提交、角色生成文档和计费验证说明 验证：API 全目标编译零警告，格式、编码和 diff 检查通过 定向测试：391 项通过，11 项退款 outbox 测试失败，含 Windows 权限错误	2026-09-23 02:52:01 +00:00
lhk229	1e186369c9	客户端埋点设置 (#446) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/446 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-23 00:09:12 +08:00
kdletters	f502829fde	发布灰度默认关闭：修掉客户端“看得到点不动”与后台看不到 key (#482) ... ## 解决什么 你反馈的两个现象都是真问题，这个 PR 一次修掉： 1. **没开灰度也能看到发布按钮**：发布开关此前是「无 gate 行 = 默认开放」，所以没配灰度时后端把 `gameDistributionPublishEnabled` 判成 true，客户端就渲染了发布入口。 2. **按钮点了没反应**：发布动作的提示原先只写 `workspaceStatus`，而普通项目走 `DirectProjectChatView` 时并不渲染工作台状态行，于是「先打开一个项目再发布」「构建失败…」这类信息全都看不见。 3. **后台看不到 key**：预设项此前在未合并的另一个 PR 里，而且后台只列「已创建」的 gate 行。 ## 改成什么 - `is_game_distribution_publish_enabled_for_user` 要求 gate 行存在且 `enabled=true`：**灰度默认关闭**，未登录/无行/`enabled=false` 一律不开放；只有白名单 / 灰度比例 / 用户标签命中才开放。作者写入与新版本激活都按这条判据。 - 新增与作者无关的总开关 `is_game_distribution_publish_open`：管理员审核激活新版本只看「灰度是否开启」，不会因为审核员不在作者白名单里而被挡住（这是合入后立刻发现的回归，已修 + 有用例）。 - AGC 新增 `announcePublishMessage`：发布相关提示同时写工作台状态与 DirectProject 对话，点「发布到游戏广场」不会再像没反应。 - 后台「灰度发布配置」新增「可配置开关」列表：`game-distribution:publish` 等预设即使还没创建行也会显示，点「配置」按默认关闭填表，运营开启后填白名单/比例即可放量。 ## 验证 - `npm run check:game-distribution-media-e2e`（真实 Phaser 构建产物）现在覆盖：灰度关闭 → 作者拿不到入口 + 写入口 503 → 开启灰度 → 真实封面/截图直传 → 创建游戏/版本/上传/送审 → 管理员审核通过 → 网关 index.html 与 bundle 200 → nosniff；全流程通过。 - 后端：`cargo test -p api-server game_distribution` 19 passed（含新增 `game_distribution_publish_open_ignores_author_allowlist_for_activation`）、`frontend_runtime_config` 6 passed。 - 前端：admin 灰度页 10 用例（含「未创建的预设开关可见并可一键配置」）、AGC 聊天头 3 用例、网页发布页 15 用例；三端 typecheck、`check:encoding`、`check:doc-index`、`check:rustfmt`、全量 `npm test`（400 文件 / 4441 用例）与 `check:repository-ci -- origin/master HEAD` 全绿。 ## 上线注意 灰度默认关闭是**刻意**的：合入后到运营在后台把 `game-distribution:publish` 配置并开启之前，作者看不到发布入口、写入口 503；已公开游戏、目录、详情、发行网关、安全下架不受影响。 Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/482 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-22 21:38:03 +08:00
kdletters	a56790eaa6	合并 Phaser 一键发布自动构建与打包	2026-09-22 21:03:57 +08:00
kdletters	57a72f652c	Phaser 项目一键发布：发布前自动构建与打包 ... - AGC：export_local_project_package 改为发布前构建——已有可玩入口直接打包；否则解析 game/（Phaser 4 + Vite 脚手架）或项目根的 npm build 脚本，缺 game/node_modules 时先跑 project.bootstrap（npm install），再走 project.verify 的受控 npm 运行器执行 npm run build，最后校验入口并打包；安装/构建失败返回带日志尾部的可操作错误。 - 新增 resolve_publish_build_plan 纯函数与用例：game 子工程优先并要求先装依赖、根 npm 工程回退、没有可构建工程时失败关闭。 - 后端：发行网关根路径（含尾斜杠）等价于 index.html，路由级用例覆盖 Cookie 拒绝门与根路径；生产仍由每游戏 origin 把根路径映射到该游戏入口。 - 脚本：check:game-distribution-media-e2e 支持 E2E_PACKAGE_ZIP 直接发布真实构建产物，断言从包内派生入口/资源，本地审核入口改为发行网关路径。 - 文档：玩法链路与实施计划记录「作者不构建、不打 ZIP」的 Phaser 发布口径与验证证据。 - 验证：真实 Phaser 4.2.1 + Vite 7 构建产物（相对引用）经发布链路后网关 index.html 200 / assets 1,388,719 B 200，播放页在 allow-scripts 沙箱 iframe 内渲染 PHASER-PUBLISH-OK 且点击交互生效。	2026-09-22 20:38:00 +08:00
kdletters	fd0c1007ad	清除旧创作模板历史表定义与绑定 ... 删除 63 张旧玩法表的 module 定义与 legacy schema 移除清空 procedure、迁移白名单和旧行兼容逻辑 重新生成 spacetime-client bindings 新增一次性 schema guard 删除白名单与回归测试 清理后台表名映射、旧回填工具和权威文档	2026-09-22 19:42:29 +08:00
kdletters	56fd5a98f7	修复 release 客户端下载清单的编码空格校验 ... 放行客户端下载清单 URL 中百分号编码的空格 补充 release 安装包文件名回归测试 更新客户端下载规范与排障文档	2026-09-22 17:29:19 +08:00
kdletters	e5460280ce	发布入口接入灰度开关 ... - 后端：GET /api/runtime/frontend-config 新增 gameDistributionPublishEnabled，复用 `game-distribution:publish` 判据（未配置或 enabled=false 时对已登录作者默认开放，显式收紧后只放行白名单/灰度命中用户，匿名恒为 false），前端入口与写入口共用同一事实源。 - 后端用例：新增 frontend_runtime_config_game_distribution_publish_is_scoped_to_authenticated_gate，覆盖默认开放、enabled=true 无白名单、白名单命中、deny 名单、enabled=false 回退与 rolloutPercent=100。 - 网页：平台壳按灰度隐藏「发布游戏 / 发布新版本」入口；/games/publish 直接访问时渲染「发布功能正在灰度中」并提供重新检查；读取失败按放行处理，由后端写入口把关并返回可读文案。 - AGC：新增 readGamePublishAvailability（同一运行时配置字段），只有命中才把发布回调交给 DirectProject 聊天头；字段缺失或读取失败按不开放处理。 - 文档：玩法链路、后端数据契约与实施计划记录灰度口径、入口行为与验证命令。	2026-09-22 17:12:04 +08:00
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	4e41bd3e56	修复预览发布测试状态文件恢复竞态 ... deploy_and_uninstall 测试在断言状态文件恢复前，改为轮询等待持久化状态到达 Stopped 新增 wait_for_persisted_status 辅助函数，经 load_deployments 真实加载路径校验状态文件	2026-09-22 00:53:47 +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	c5afc02e94	模板正文目录门禁：CLI 打包与后台上传统一拒绝身份/版本库/依赖/构建目录 ... - scripts/agc-template-library-publish.mjs：readProjectFiles 增加正文门禁，任意层级拒绝 .agent/.git/.svn/node_modules，根目录拒绝 dist/build/library/temp/local/.idea/.vscode - scripts/agc-template-library-publish.test.mjs：新增夹具源目录与门禁用例，覆盖 13 条拒绝路径及 game/dist/**、game/.gitignore 放行 - server-rs/crates/api-server/src/admin_templates.rs：上传归档校验与 CLI 用同一份段名单，新增 template_import_archive_rejects_identity_and_build_directories - docs/【模板规范】AGC模板包组织指南-2026-09-21.md：已知边界改为「已有机器门禁」，并说明同名目录段只在根目录受限 - docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md：CLI 与后台上传的校验口径补门禁，并追加 2026-09-21 证据（九个模板本地重打包摘要与线上清单逐条一致） - docs/project-memory/plans/【里程碑】后台模板上传-2026-09-21.md：验收标准 2 补充门禁证据 - docs/project-memory/shared-memory/decision-log.md：新增 2026-09-21 正文目录门禁决策记录	2026-09-21 16:25:35 +08:00
kdletters	4863c8c066	后台模板上传（后端）：新增批量导入接口与存储/领域支持 ... - shared-contracts 新增导入 manifest、逐条与结果 DTO（camelCase，拒绝未知字段） - module-assets 新增 prepare_template_import：新 ID 默认上架，已存在条目就地更新并保留上架状态与未知扩展字段；同一 ID 同版本字节不同时按 CLI 同一句文案拒绝，字节一致时按内容复用既有对象 - platform-oss 为 application/zip 放宽单对象上限到 64 MiB（图片与元数据仍 5 MiB），测试替身同步该口径 - api-server 新增 POST /admin/api/agc-templates/import：multipart（manifest + zip_N/cover_N），逐项校验归档安全性、entry 存在性与封面（按字节嗅探格式，仅 PNG/JPEG/WebP）后才取发布锁 - 锁内流程：CAS 校验 revision → 内容寻址写入 zip/封面/元数据并回读 → 一次提交清单 → 释放锁；断连由独立任务持有，不确定结果保留锁并返回 503 - 路由挂 require_admin_auth 与 200 MiB body 上限，页签权限矩阵与路由契约测试同步 - 新增用例：清单与文件字段校验、归档越界与符号链接拒绝、内容寻址键与封面嗅探、zip 内容类型存储上限 - 新增「后台模板上传」里程碑与实施计划文档 - 验证：cargo test（module-assets 11 项、platform-oss 12 项、api-server 定向 4 项）、cargo fmt --check、check:doc-index、check:encoding、git diff --check	2026-09-21 16:06:23 +08:00
kdletters	02a7abeb3f	新增后台 AGC 模板管理与模板库内容寻址落库 ... - 后台新增「模板管理」页：按权限查看并编辑模板名称/简介/标签/封面，支持上架与下架；路由、侧栏、tab 权限、API 客户端与 DTO 同步接入 - api-server 新增 /admin/api/agc-templates 读取与更新路由，复用现有后台鉴权与 tab 权限校验，权限不足按既有失败关闭口径拒绝 - module-assets 收敛模板库纯规则（active/inactive 投影、索引 schema 与重复项校验、ZIP 大小与摘要核对），platform-oss 承担对象存储读写、不可变对象复用与发布互斥锁 - shared-contracts 补后台模板 DTO；spacetime-module 账号存储适配保持既有 schema 不变 - AGC 壳内置模板索引与建项读取改为内容寻址对象，补模板安装、越界归档、索引不匹配等用例 - 模板库发布脚本支持定向发布与上架/下架合并、内容地址复用与锁语义，CLI 守卫用例同步；jenkins 两条客户端打包管线统一触发邮件通知 Job 并传递首装包链接 - 内置 5 个 Cocos 官方模板载荷与索引 fixture（内容地址对象，共 90 个文件） - 补「后台模板管理」里程碑与实施计划，更新模板库技术方案、开发运维文档与共享记忆 - 验证：admin-web 39 项用例与 typecheck、发布脚本 25 项用例、api-server 与 AGC 壳编译、模板库定向 Rust 用例（AGC 壳 18 项、module-assets/platform-oss 16 项、后台权限 1 项）、check:encoding / check:doc-index / check:production-ops / rustfmt 全部通过	2026-09-21 13:56:20 +08:00
kdletters	1cb91f9444	修复画布绑定查询与生成失败归因 ... - 画布绑定前置的项目列表查询改为 view=summary，站内与外部路由统一支持摘要视图（缺省 full 兼容，未知取值 400） - 项目摘要投影收敛到 editor_project，外部 API 与 MCP 复用同一份实现，摘要不做内联媒体修复也不回传画布与全量资源 - 外部编辑器请求失败文案补 kind 语义与底层因链，区分请求超时、正文截断与非法 JSON，不拼接 URL - 远端资源编辑终态文案带出稳定失败码并指向移出恢复队列这一唯一出口，上游原文仍不写入账本 - 补齐站内摘要视图与画布测试夹具的请求断言用例 - 更新共享决策记录与踩坑记录（图集切片上限条目归上游 #442，本提交不重复）	2026-09-21 13:33:23 +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	4a91e5865a	创建游戏同步校验封面与截图素材归属 ... - 服务端：抽出 `resolve_owned_game_media`，创建游戏与创建版本复用同一素材校验；不存在的素材返回 400，借用他人素材返回 403，避免游戏行先落一个无效素材 ID。 - 脚本：新增 `npm run check:game-distribution-media-e2e`（`scripts/check-game-distribution-media-e2e.mjs`），在本地 dev 栈上跑真实素材直传、冻结、审核生效、匿名换签读与发行网关的可重复检查。 - 文档：后端数据契约补充创建游戏的素材复核口径，实施计划记录真实本地栈 27 项媒体验证与真实浏览器封面/截图展示证据。	2026-09-20 22:34:33 +08:00
kdletters	4a2b270714	补齐游戏分发封面与截图的冻结、上传与展示 ... - 服务端：游戏表追加可空 cover_object_key / screenshots_json，版本表追加可空 metadata_json，创建版本时校验必需封面、最多 6 张截图与图片素材归属，并从素材记录派生对象键生成冻结资料。 - 服务端：审核通过时把冻结资料整体生效到游戏行；只有已公开且存在有效活动版本的游戏，其封面/截图素材才在 /api/assets/read-url 获得匿名读授权。 - 服务端：作者与管理员回读版本时追加 frozenMetadata，带回封面与截图素材 ID 供续发复用，公开投影仍只暴露对象键。 - 网页：/games/publish 新增「封面与截图」区，复用平台图片直传与 confirm 通道，缺封面或截图超量在发请求前拦截，更新版本时按冻结资料回填且不要求重新上传。 - 网页：游戏广场卡片与详情页 hero 换签展示真实封面，详情页新增可点击的截图缩略图条，无素材或换签失败时静默回退原有渐变占位。 - AGC：发布面板支持封面必选与截图最多 6 张，新增素材直传服务并在创建游戏前拦截缺封面，同一文件重复提交复用素材 ID。 - AGC：http 能力作用域新增阿里云 OSS 直传地址，客户端同时校验直传目标必须是平台素材存储。 - 契约与文档：同步 shared-contracts、packages/shared 契约，更新 SpacetimeDB 迁移注释、后端架构、玩法链路与实施计划文档，并补齐网页端与 AGC 定向测试。	2026-09-20 22:19:50 +08:00
kdletters	789aef4ce5	补齐游戏分发结构化可观测事件 ... - api-server 游戏分发模块新增 package_confirmed/package_rejected/version_submitted/version_cancelled 事件，带 request_id、game_id、version_id、耗时与体积/文件数（不记录凭据、URL 与文件内容） - 新增 review_backlog_listed（审核积压）、review_decided（审核结论与公开修订号）、game_unpublished/game_suspended（撤销传播）与 publish_switch_blocked/unavailable（开关拦截）事件 - 发行网关拒绝路径补 debug 级 release_rejected（cookie、扩展名、未公开、非公开版本）便于排查发行 4xx - 运维文档给出可直接 grep 的事件名与关键字段，实施计划记录真实栈复跑证据	2026-09-20 21:30:32 +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
kdletters	5822b64d7c	合并 Godot 编辑器插件与常用操作指导到主分支 ... 接入 Godot 原生桥、受控执行、Runner 回执与编辑器操作指南 保留主分支 Cocos 和 Unity 跨工程能力及外置提示词结构 解决插件生命周期、工具目录、前端启动和文档合并冲突	2026-09-20 17:38:48 +08:00
kdletters	54d0fb75ea	接入 Godot 编辑器插件与受控执行链路 ... 新增 GDExtension 自动引导、GDScript 执行和实例隔离缓存 接入 AGC 插件开关、Runner、Agent 工具与权限审计 完善执行回执确认、不确定状态阻断及卸载恢复 补齐 Windows 分发资源、定向测试与实机验收文档	2026-09-20 16:35:04 +08:00
kdletters	97d8a6c39a	清理并统一外置智能体提示词 ... 将智能体系统指令、工具说明和恢复模板集中到外置提示词目录 精简重复否定、历史对照与无关实现说明，保留必要执行约束 扩展提示词构建校验和源码边界检查并接入现有本地与持续集成门禁 同步内置技能、协作规范、技术文档与对应验证断言	2026-09-20 15:32:48 +08:00
lhk229	70271b408e	删除策划agent v2，与退役功能解耦 (#355) ... Reviewed-on: #355 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-20 14:49:57 +08:00
kdletters	623e007fae	完善客户端发布渠道并接入模板库灰度 ... 区分发布渠道与系统，支持 dev、release 和自定义渠道 允许网站通过服务端配置选择客户端下载检测渠道 接入模板库灰度权限并阻断退出和切号后的异步操作 补齐发布、下载、灰度与会话竞态测试及当前规范	2026-09-20 12:12:49 +08:00
kdletters	15774a1c02	修复项目自动上传并增加后台完整工程下载 ... 接入真实项目打开、切换和关闭生命周期并修复退出等待竞态 新增后台项目列表及按原目录校验导出的 ZIP 下载 补充快照完整性元数据、后台权限和取消清理 固定默认 AGC 存储目标并支持空文件与特殊字符路径 补充自动化测试及真实 OSS 只读导出验证 记录本地数据库 404 导致完整 HTTP 联调和安装版实机验证待补	2026-09-20 10:07:31 +08:00
kdletters	e3682fd06f	固定客户端dev服务并支持官网多平台下载 ... 移除服务器选择并按来源隔离登录凭据 新增官网客户端下载入口和匿名平台聚合接口 根据发布清单自动展示Windows与macOS首装包 补齐Mac首装元数据和上传顺序校验 同步定向测试与下载发布规范	2026-09-19 16:19:28 +08:00
kdletters	5bf036bb81	收敛后端依赖装配与鉴权并完善异步追踪 (#425) ... HTTP 请求取消后，在途计数原先无法释放；项目元数据和 External API 鉴权依赖完整 AppState，相同鉴权和追踪配置也散落在多个入口。本次集中装配这些依赖和横切能力，保持现有公开 API、权限、计费、幂等和事务规则。 ## 修改 - 91 个受保护路由集中应用鉴权；保留方法级 404/405/HEAD/Allow、公开入口、MCP、精选缓存头及 2/4 MiB 请求限制。 - 七个项目元数据入口改用缓存的 EditorProjectState，External/MCP 鉴权改用 ExternalApiAuthState；生产实现复用 SpacetimeClient，媒体修复维持原有上传和登记顺序。 - RAII 覆盖请求 Future 取消和 panic unwind 的计数清理；正常与降级服务复用 TraceLayer，指标采用 MatchedPath 模板及固定兜底。 - LLM 普通与流式调用增加跳过参数的异步 span，保持父上下文、流式回调、错误与重试行为；补充替代依赖测试并同步锁文件和文档。 ## 验证 | 验证面 | 结果 | | --- | --- | | platform-llm 完整本地回归 | 161 个单元测试、3 个集成测试通过；1 个真实 Provider 用例按原配置忽略 | | api-server 完整回归 | 执行时 1075 通过、12 失败、6 忽略；其中 1 个新增公开读取 fixture 断言已修正，14 个路由契约回归随后全部通过；剩余 11 个是下述既有 Windows 失败 | | 窄依赖、取消与追踪 | 元数据 owner/幂等/revision、鉴权及 MCP 错误传播、取消/panic/流式响应、追踪父子关系与敏感参数省略均通过 | | 实际本地服务 | 独立 SpacetimeDB 上 102/102 检查通过，两个动态项目 ID 的路由模板及请求 ID 日志核验 3/3 通过 | | 编译与边界 | api-server cargo check、AGC 锁文件下 platform-llm cargo check、rustfmt、编码、文档索引、DDD 与 diff 检查通过 | | 合入最新 master 后 | 后端源码及锁文件保持已测内容；再次通过 14 个路由契约测试、3 个 Provider 追踪测试及编码/文档/DDD/diff 检查 | 实际服务检查覆盖 health/ready、两账号登录、项目 CRUD、幂等重复、跨 owner 拒绝、revision 冲突、External/MCP 读取、Key 撤销及 404/405。使用既有 test 环境的本地 Router 拒绝 fixture，未调用真实付费 Provider；自建服务已关闭，原开发实例保留。 ## 已知测试限制 API 全量测试尚未全绿：11 个 wallet_refund_outbox 用例在 Windows 的目录同步处失败。其生产文件与变更前内容一致；标准库隔离复现确认 File::open(目录) 返回 OS 5，而普通文件写入、同步及 hard_link 正常。这个已有的目录持久化问题未混入本次重构，也未通过跳过或弱化相关断言掩盖。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/425	2026-09-19 12:29:19 +08:00
k88936	48caa23997	收紧AGC资源kind枚举边界 ... canvas生成与运行时统一使用共享GameCreationAppAssetKind 删除平台kind兼容映射与退役kind拒绝测试 更新资源kind审计里程碑与绑定文档	2026-09-19 01:28:27 +08:00
k88936	0d5940433d	删除资源 kind 兼容白名单 ... 服务端图片快速编辑改用共享枚举静态图片判定 移除退役 kind 的兼容放行与冗余回归测试 清理客户端恒假 art-spritesheet 判断并统一远端 kind 解析 同步 AGC kind 里程碑、实施计划与决策记录	2026-09-18 17:09:36 +08:00
k88936	e5fd454bb3	收紧 AGC 资源 kind 类型边界并统一族判据 ... - 将 manifest 与本地导入回执的资源 kind 改为 ts-rs 生成绑定 - 集中音频与视觉资源族判据并复用 Rust 枚举方法 - 放宽 Unknown 未解析语义并清理上传类型墓碑注释 - 标记共享生成绑定并同步项目决策与实施计划	2026-09-18 15:21:19 +08:00
k88936	c2ab9674a0	合并资源编辑与当前主线改动 ... 保留资源 kind 强类型与栅格 subtype 严格校验 合并抠图模式、幂等账本、恢复轮询和 PNG 透明通道校验 修正共享资源枚举在 Cocos 登记与抠图桥接中的类型传递 保留双方模板库、项目快照、发布和 Provider 重试改动	2026-09-18 01:48:13 +08:00
k88936	3d4c7929c3	统一画布生成 kind 为共享枚举 ... 工具白名单与 schema 改用 GameCreationAppAssetKind canonical 输入在生成适配边界映射旧账本值	2026-09-17 22:52:38 +08:00
lhk229	195b7dd5dd	修复抠图401 404问题 (#394) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/394 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-17 21:37:23 +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
kdletters	fc14190f58	图集切片模式改为必须显式声明并补齐决策要求 (#408) ... ## 背景 切图新增基于连通域的切分后，LLM 仍倾向显式传 `sliceMode=grid`：参数只存在于部分 LLM 可见面、带默认值、没有任何决策规则，生成结果也不回显生效模式。 ## 变更 - 平台：`/api/editor/icon-spritesheets/generations` 与 `/api/external/v1/editor/icon-spritesheets/generations` 把 `sliceMode` 改为必填并移除默认值；缺失、空白或未知取值在引用解析、定价与任何 provider / OSS 副作用之前返回 `400`，错误统一带 `field` 与决策要求。 - 契约：`grid` 必须同时提供 `gridX`/`gridY`，`connected-components` 不接受网格尺寸；`sliceCount` 只约束连通域切分，请求与响应的公开上限统一为 `256`；OpenAPI 去掉默认值并补必填与失败语义。 - AGC：MCP 工具说明去掉默认值并补决策要求，桥接层新增可测试的切分声明校验；原生工具 `canvas.asset_generate` 暴露 `sliceMode/gridX/gridY/sliceCount` 并要求图集显式声明；生成结果回显 `sliceMode/gridX/gridY` 与 `slicePaths`；严格图集在本地提交前校验平台回显与请求声明一致。 - 标准美术包：显式声明 `connected-components` 加 `sliceCount=4`，并在四张 canonical 切片用途映射前校验数量，禁止截断或错位。 - 前端与画板：画板 Agent 工具装配与画板提交计划显式声明连通域切分；前端类型要求显式 `sliceMode` 并在本地校验声明自洽。 - 文档与 Skill：主规范、OpenAPI、AGC Skill、外部编辑器 Skill、里程碑与实施计划、共享决策记录同步更新。 - 测试环境：测试构建对提权 Windows 主机上系统临时目录的所有者偏差做一次性所有者初始化重试，临时目录之外的越权所有者继续失败关闭。 ## 兼容性影响 省略 `sliceMode` 的旧调用方（含已发布但未更新的 AGC 客户端与第三方外部 API 调用方）会在图集生成上收到 `400`；这是本次"不允许默认值"的预期结果，仓库内自有调用方已全部改为显式声明。 ## 验证 - 平台：`slice_mode_must_be_declared_*` 与 OpenAPI 契约测试通过；全量 `cargo test -p api-server` 1043 通过 / 11 失败（`wallet_refund_outbox` 临时文件 `拒绝访问`，已在改动前基线复现，属本机环境）。 - AGC：`slice` 30、`spritesheet` 21、`direct_tools_mcp` 23、`agent_native_tools` 16、`canvas_generation_tests` 83、提示词上限与桥接门禁各 1 条、`cargo check --tests` 全部通过。 - 前端：182 条定向测试与 `typecheck` 通过。 - 门禁：`cargo fmt --check`（两个 workspace）、`check:encoding`、`check:doc-index`、`git diff --check` 通过。 - 未验证：真实 Provider 与浏览器试玩、确定性 e2e 车道；整机全量 AGC 单进程运行在本机受提权 shell 的所有者与时序问题影响，不作为门禁信号。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/408	2026-09-17 18:10:34 +08:00