3543 Commits

Author	SHA1	Message	Date
suzmii	779bbd1157	docs(游戏共创): M2b 文档回填两处实现偏差 + 状态改已实现（含 M2b 证据表） ... - 技术方案 §3.4：上行路由行按端到端实测补两条按实现为准的细节——① **非作者上传返回 404 而不是 403**（`load_owner_version_or_404` 把 owner 不匹配按「版本不存在」处理，与发行包上行族同口径，不泄露版本存在性、响应不含对象键）；② **阶段门先判「已存在」再判档位**（`ensure_project_bundle_uploadable`：`project_bundle_bytes > 0` → 409 `PROJECT_BUNDLE_ALREADY_EXISTS`，再看 `status` → 409 `PROJECT_BUNDLE_UPLOAD_NOT_ALLOWED`），因此「已公开且已有工程包」返回 `ALREADY_EXISTS`，「已公开但无工程包」才返回 `UPLOAD_NOT_ALLOWED`。证据：`check-game-distribution-project-bundle-e2e` 的 A5 / A5b / A6 及其 NOTE - 技术方案 §3.5.2：AGC 侧「上传」「下载与建项」由「接线待做」改为**已落地**（发布时上传且失败不阻断、按 `source` 分支建项、来源记录 v2 兼容 v1、取件提示按形态措辞），并写明两端规则由 `npm run check-project-bundle-policy-parity` 机器门禁钉住一致 - 技术方案 §3.5.4：路线 B 由「服务端已实现、客户端接线待做」改为**两端均已落地** - 技术方案 §3.7：补 M2b 口径——共创写入仍复用 `game-distribution:publish`（未新增灰度键）；内容下发与工程包上传当前只有 `tracing` 日志，三个结构化埋点事件**仍未接**（待产品定事件口径） - 技术方案新增 §5.2「M2b（工程源包）实施证据」表：三列与契约、校验器（16 条单测 / 上限镜像）、上行路由族（api-server 60 passed）、下行优先与缓存不串味、端到端 `check:game-distribution-project-bundle-e2e` **46/46**、两端规则 parity 门禁、客户端 vitest 1961 passed 与定向 cargo test 17+16；并显式登记「backfill 明确不做」「真实极端边界与结构化埋点待补」 - 里程碑「作品工程源包与一键改造」：Status → `implemented-local`；新增「实现进展（2026-10-05）」列出两端提交 SHA 与证据命令、以及四条未做项及原因；验收标准改为 ✅/⏳/⏭ 三段并有证据指向（阶段门顺序、非作者 404、半包清理等按实测更新）；证据要求补上已落地的命令清单与「真机建项链路仍未跑」的括注 - 门禁：`check:doc-index` 248 份 OK；`check:encoding` 5304 files OK；`git diff --check` 0	2026-10-05 17:30:49 +08:00
suzmii	d39257b608	docs(游戏共创): M2b 文档按实现收敛（块 E） ... - 技术方案 §3.2.3：三列语义改为与实现一致；删掉原「保留一次补齐机会」的规则（**已公开版本的补传未实现**，本期不做），改为「只在 `awaiting_upload` / `upload_failed` 可写一次、写入后换内容 409、不做版本回溯」；补产品口径（不做独立「源码可见性」开关、作者不传即产物级改编、`nonCommercial` 约束力属平台规则层面）；对象键改为实现值 `…/{version_id}.project.zip` - 技术方案 §2.3：把「公开后可补传一次工程源包」的表述改为如实口径（公开后不接受补传，只能走试玩 + 素材） - 技术方案 §3.3：version 行的 `project_bundle_*` 迁移规则改为「只在未公开时可写一次」 - 技术方案 §3.4：`PUT /versions/{versionId}/project-bundle` 从「规划」改为**已实现**（整包 + 4 条分片族路由、作者限定、阶段门、无既有工程包、服务端派生对象键）；「登录用户」小节把取件接口从两个改为三个并说明 `source` 可能是 `project`（优先）或 `package`，新增 `/fork-source/project` 本体行（失败关闭、缓存含资产维度） - 技术方案 §3.5.2：打包/服务端复核/上传/下载建项/优先级五条按实现重写——写明服务端 `validate_project_bundle_zip` 的完整拒绝清单与与发行包逐项相等的上限（200 MiB / 500 MiB / 64 MiB / 10 000 / 100，理由：共用同一上传链路且反代按 200 MiB 校准），以及「打包器已落地、上传与建项接线待做」 - 技术方案 §3.5.4：记录产品已采纳推荐口径（A 默认继续服务未上传工程包的作品、B 服务端已实现、C 不做） - 里程碑「作品工程源包与一键改造」：Status → in-progress（服务端已落地 / 客户端接线待做）、Version 1.2；范围去掉「是否公开工程」选项（不存在独立开关）；不在范围内新增「已公开版本补传」；两条前置依赖标注已落地并写清 512 MiB 与 200 MiB 的对齐口径（客户端须按服务端上限预检）；验收标准改为带 ✅/⏳ 标注、删掉两条 backfill 验收、补阶段门与半写行回落等已实现项 - 门禁：`check:doc-index` 248 份 OK；`check:encoding` 5301 files OK；`git diff --check` 0	2026-10-05 17:30:48 +08:00
suzmii	604ce7f3ec	feat(游戏共创): M2b 数据模型——版本行三列工程源包 + 契约与绑定（块 A） ... - `server-rs/crates/spacetime-module/src/game_distribution.rs`：`game_distribution_version` 表尾追加三列（明确默认值，遵循既有追加规则）——`project_bundle_object_key: Option<String>`（`#[default(None)]`）、`project_bundle_bytes: u64`（`#[default(0)]` = 未上传）、`project_bundle_sha256: Option<String>`（`#[default(None)]`）；三列同步进 `GameDistributionVersionSnapshot`、版本快照构造与建版本时的初始化 - 同文件：`GameDistributionForkSourceSnapshot` 与扁平结果类型追加 `project_bundle_sha256` / `project_bundle_bytes`，下行据此判断走 `project` 还是回落 `package`（字节数与摘要成对，缺一视为没有工程包） - 同文件：新增 `GAME_DISTRIBUTION_ACTION_UPLOAD_PROJECT_BUNDLE` 动作常量、输入 `GameDistributionConfirmProjectBundleInput`、事务 `confirm_game_distribution_project_bundle_tx` 与 procedure `confirm_game_distribution_project_bundle_and_return`。语义：可选资产、**不驱动版本状态机**；owner 校验 → 阶段门（`awaiting_upload` / `upload_failed`，与发行包确认同口径，已公开/已取消/已撤回一律拒绝）→ 同内容幂等重放 / 换内容冲突 → 写三列 + 幂等收据 - `spacetime-client`：`GameDistributionVersionRecord` 与 `map_version` 同步三列（生成绑定把 `project_bundle_sha256` 折成 `project_bundle_sha_256`，与 `package_sha_256` 同约定）；新增 `GameDistributionConfirmProjectBundleRecordInput` 与 `confirm_game_distribution_project_bundle`（沿用 `map_game_distribution_game_result` 再取 version 的既有写法） - 契约：`shared-contracts` 的 `GameDistributionPrivateVersion` 追加 `project_bundle_bytes`（必需，`0` = 未上传）与 `project_bundle_sha256`（可选）；`packages/shared` TS 镜像同步；api-server `private_version_payload` 追加同名键——**对象键不下发**，只回摘要与字节数 - 生成物：重跑 `npm run spacetime:generate -- --rust-only`，只保留 `module_bindings/game_distribution*`（含 2 个新文件）与 `module_bindings.rs`，其余 `module_bindings/**` 的 rustfmt 漂移已 `git checkout --` 还原 - 文档：数据契约表目录 `game_distribution_version` 小节补三列语义与对象键不出服务端的口径 - 顺手记下一条门禁陷阱：`scripts/check-game-distribution-dto-parity.mjs` 抓 `json!` 顶层键时要求「键前一个非空字符是 `{` 或 `,`」且**不剥注释**，在字面量里插注释行会让紧随其后的键被判成缺失（已写进 `private_version_payload` 的文档注释） - 门禁：wasm build 0；`cargo check --all-targets` 0；`cargo test -p module-game-distribution` 69 passed；`cargo test -p api-server game_distribution` 54 passed；DTO parity 42 组 OK；`check:spacetime-schema` 92 tables OK；`check:encoding` 5301 files OK；`git diff --check` 0；`cargo fmt --all -- --check` 0	2026-10-05 17:30:48 +08:00
suzmii	f40050afb1	收口 M3 复核遗留：文档如实口径、fork-source 状态说明、forkAuthorization 机器守卫、e2e 引用去行号 ... - 技术方案 §3.4：删掉「GET /games/{gameId} 追加 forkSourceAvailable」——实现里不存在该字段；改为如实口径：改造入口显隐只依据 forkAuthorization，真实可复刻形态由 /fork-source 的 source 回答，若 M2b 要区分「可源码级改造 / 只能参考」届时再加 - 实施计划（M1）§5：同步去掉 forkSourceAvailable 并注明「未实现、也不需要」，保留其余字段清单不动 - 技术方案 §2.6 时序图：说明字句从「GET …/fork-source 是待实现接口」改为「M2a 已实现（形状见 §3.4 登录用户表）」，并在图内加一行 Note 标注「图中字段名是 M2b 目标形状」；图属目标形态的免责声明保留 - parity 脚本：game_payload 增加 mustEmit ['forkAuthorization']——该字段 TS 侧可选（旧响应可省），但公开与作者响应必须发出，否则详情页授权徽章与改造入口会静默退化成「禁止共创」；public_game_payload 以 game_payload 为 base，因此一并受保护 - e2e 脚本头部：把全部行号引用（含已过期 2–4 行的那些）改为「文件 + 符号」引用（router()/lineage_read_or_not_found()/GameDistributionLineageNode/lineage.rs 常量与函数等），并删除「消费链路在未提交的 M2a WIP 里」这类会过期的措辞，改为「已在 M2a 落地」；只改注释，断言逻辑未动	2026-10-05 17:30:47 +08:00
suzmii	4626aeefd4	fix(埋点合同): 服务端同步 AGC 新增的 creation_source=platform_game ... - 依据客户端提交 `5d01e43b6`：AGC 的 `CreationSource` 新增 `PlatformGame`，按 serde snake_case 落到线上取值 **`platform_game`**（同提交的 `creation_source_gains_platform_game_without_breaking_existing_values` 用例显式给出该字面量），上报字段仍是 `project_create_success` 的属性 `creation_source`。服务端枚举此前没有它，整条事件会被判 `invalid_properties` 直接丢弃 - `shared-contracts/src/agc_analytics.rs`：`values!(CreationSource { .. })` 追加 `PlatformGame`（注释与客户端一致）；解析走 serde 派生，无需新增匹配分支 - `module-runtime/src/agc_analytics.rs`：新增 `agc_accepts_every_creation_source_and_rejects_unknown`——五个受支持取值（home_game / home_design / template / selected_directory / **platform_game**）逐个通过整批校验（事件形如 `project_create_success` 且带 `project_id`），未知取值（`remix` / `platform` / `PLATFORM_GAME` / 空串）仍然失败关闭为 `invalid_properties` - 文档：`docs/technical/【技术方案】客户端本地埋点与主站入库契约-2026-09-21.md` §6.6 的 `creation_source` 取值列表补 `platform_game`（保持 `/` 分隔与 snake_case 风格） - 全仓核对：该枚举只有两处定义（AGC `analytics/contract.rs` 与 `shared-contracts`），**无第二处服务端镜像**、无 TS 联合类型、无 schema/OpenAPI 取值表；生成绑定不含该类型（埋点批量跨模块边界走 `payload_json: String`），因此无需重跑 spacetime generate	2026-10-05 17:30:46 +08:00
suzmii	eeb345f2ad	feat(游戏共创): 上架时即可指定共创授权档位（创建作品请求增量） ... - TS 契约 `GameDistributionCreateGameRequest` 新增可选 `forkAuthorization?: GameDistributionForkAuthorization`，注释写明缺省禁止共创、非法值整请求 400、上架后只能单向提升 - Rust 契约同结构体新增 `#[serde(default)] pub fork_authorization: GameDistributionForkAuthorization`（非 `Option`）：省略与显式传 `forbidden` 得到同一个值，**幂等摘要因此相同**——创建请求的摘要取自整个请求体，若写成 `Option` + `skip_serializing_if`，两种写法会变成「同 key 不同请求」而互相冲突；未知取值由反序列化直接拒绝 - api-server `create_game`：载荷改为 `Result<Json<..>, JsonRejection>`，拒绝统一映射成平台信封 400（与 `set_fork_authorization` 同修法），并按 rejection 文本区分文案（含 `forkAuthorization` → 「共创授权档位不合法，只接受 forbidden / nonCommercial / full」，其余 → 「创建作品请求字段不合法」；框架文本只用于选文案，不回传客户端）；创建记录入参新增 `fork_authorization: fork_authorization_value(payload.fork_authorization)` - spacetime-client：`GameDistributionCreateGameRecordInput` 新增 `fork_authorization: String` 并透传给 procedure；重新生成的 `GameDistributionCreateGameInput` 同步带上该字段 - spacetime-module：`GameDistributionCreateGameInput` 新增 `fork_authorization: String`；创建事务里用 `ForkAuthorization::parse` 解析，未知取值失败关闭（`FORK_AUTHORIZATION_UNKNOWN`，**不静默落成 forbidden**），并把原来的硬编码 `FORK_AUTHORIZATION_FORBIDDEN` 换成解析结果 - 资料编辑复用创建校验的转换函数与既有测试夹具按新字段补默认值；AGC 侧测试字面量同步（AGC 发布面板的 UI 接线留到后续，缺省值等价于不传） - 测试：`create_game_request_defaults_fork_authorization_without_changing_digest`（缺省 → forbidden；显式 forbidden 与原缺省**摘要相同**；`nonCommercial` / `full` 原样保留；`"allowed"` 反序列化失败）与 `create_game_rejects_unknown_fork_authorization_with_envelope_bad_request`（未知档位 → 400 + 平台信封且无框架纯文本；非档位字段问题走通用文案；合法载荷不会被误拒——测试态发布灰度未配置，得到 503 而非 400，即证明载荷路径已通过且未触达创建） - 文档：技术方案 §2.4（发布入口上架时即选档位）、§3.4（`POST /games` 请求增量补 `forkAuthorization`）、§3.9（补充说明上架指定档位已支持、事后提升仍保留）	2026-10-05 17:30:46 +08:00
suzmii	8f87c826cf	feat(游戏共创): M2a 受鉴权内容下发通道（fork-source 元数据 + 整包取件） ... - 契约：新增 `GameDistributionForkSourceKind` / `GameDistributionForkSource` / `GameDistributionForkSourceResponse`（shared-contracts + TS 镜像 + parity 登记），字段 `gameId / versionId / source / sha256 / bytes / downloadPath`，**不含对象键** - 读取：spacetime-module 新增 `GameDistributionForkSourceInput`、扁平结果类型与 procedure `get_game_distribution_fork_source_and_return`；tx 把「行是否存在 / 能否作为来源（未删+已公开+有当前公开版本）/ 授权档位原值」分开回传——既有 owner-or-public 读会把「已软删除」与「未公开」都折成 None，HTTP 层就没法区分 404 与 409；`sha256` / `bytes` 取自版本行，不重算 - 客户端：spacetime-client 新增 record + mapper + `get_game_distribution_fork_source`（生成绑定把 `package_sha256` 折成 `package_sha_256`，与版本快照同约定） - 路由：新增 `fork_sources` 子路由（`require_bearer_auth` + `add_no_store_response_headers`，**不叠加发布灰度**），两条：`GET …/fork-source`（元数据）与 `GET …/fork-source/package`（ZIP 字节） - 校验：抽出纯函数 `fork_source_target` 供两个 handler 共用——404 `FORK_SOURCE_NOT_FOUND` / 409 `FORK_SOURCE_NOT_AVAILABLE` / 403 `FORK_NOT_AUTHORIZED`（未知档位按禁止解释）；`available` 为真却缺版本元数据时失败关闭为 409 - 取件本体：复用发行网关的 `release_package_bytes`（整包进内存 + 进程内缓存，4 条 / 256 MiB），不新造 OSS 客户端；缓存值由 `Arc<Vec<u8>>` 改为 `Bytes`，整包交给响应体只加引用计数、不复制；响应**不做**引用归一化与 `RELEASE_STORAGE_BOOTSTRAP` 注入（下发原始构建产物，客户端按摘要校验后离线解压）；`RELEASE_PACKAGE_CACHE` 顺手改用 `LazyLock`（初始值编译期已知） - 路径：`downloadPath` 为同源相对路径，复用新抽出的 `is_path_safe_game_id`（与发行入口同一判据），绝不下发对象键 - 测试：新增 4 条——两条路由未带 Bearer → 401；`fork_source_target` 的 404 / 409 / 403 / 未知档位 / 缺元数据失败关闭逐项断言（409 先于 403）；元数据 payload 的 sha256/bytes 取自行、downloadPath 形状、序列化后不含对象键；取件包头与长度（`application/zip`、`Content-Length` = 行 `package_bytes`、`Content-Disposition`、`no-store`） - 文档：技术方案 §3.4 把两个接口从「规划」改成与实现一致的形状，并单独拆出「登录用户（Bearer，不叠加发布灰度）」小节；§3.5.1 的「下载通道（当前不存在）」改为 M2a 已实现，写明它只服务当前公开版本、不做归一化、大包续传仍待做	2026-10-05 17:30:45 +08:00
suzmii	39669763fe	实现游戏共创 M3：创作族谱树与衍生列表 ... - 新增 module-game-distribution/src/lineage.rs：锚点可读性、可见性过滤、稳定排序、上限截断的纯函数，附 15 个单测（复用 M1 的软删除判定，不重写第二套规则） - 新增公开只读 procedure get_game_distribution_lineage / list_game_distribution_derived_games；锚点必须公开可读（未公开/已软删除/不存在一律按不存在处理），树内只出现未软删除且已公开的节点，不补 null 占位节点 - api-server 新增 GET /games/{id}/lineage 与 /games/{id}/derived（匿名可读、no-store），响应走结构化 DTO，节点键集合由测试钉死，杜绝下发对象键/素材键 - 作者自有游戏聚合追加 forkCount（与公开详情 forkCount 同口径），供「被改编 N」入口使用 - shared-contracts 与 TS 契约新增 LineageNode / LineageResponse / DerivedResponse 三型并登记 DTO 一致性检查 - 前端新增 /games/lineage 族谱页，登记 stage 类型、路由表、页面标题与壳层渲染分支；详情页共创卡新增「查看创作族谱」入口（仅已公开作品） - 我的作品页新增「被改编 N」行内展开，列出直接子代的标题/作者/代际/状态，含空态与失败重试（仅已公开作品） - 补前端组件/路由/标题/客户端用例与 api-server 路由、负载映射用例；同步里程碑验收标准与技术方案 §3.4 的锚点可读性口径	2026-10-05 17:30:45 +08:00
suzmii	3d51d1309a	docs(游戏共创): 技术方案里提升共创授权的方法改为 PUT，与实现一致 ... - §2.6 流程图 A：`后续提升授权（POST fork-authorization，仅升）` → `后续提升授权（PUT /games/{gameId}/fork-authorization，仅升）` - §3.4 作者路由表：`POST /games/{gameId}/fork-authorization`（新） → `PUT /games/{gameId}/fork-authorization`（新） - 依据：实现侧（api-server `set_fork_authorization` 的 PUT 路由 + 前端 `updateGameForkAuthorization` 的 PUT + M1 实施计划 `PUT /api/game-distribution/games/{game_id}/fork-authorization`）一致为 PUT；表中路径沿用本节开头声明的 `/api/game-distribution` 命名空间，故未重复写前缀 - 顺手扫了全仓 `docs/`：除本文件这两处外没有其它把该路由写成 POST 的地方（`POST /games` 是既有的创建作品路由，与本次无关，未动）	2026-10-05 17:30:45 +08:00
suzmii	e9003a33bd	fix(游戏共创): 未知共创档位回平台信封 400，而不是框架 422 纯文本 ... - api-server `set_fork_authorization`：载荷由裸 `Json(..)` 改为 `Result<Json<GameDistributionSetForkAuthorizationRequest>, JsonRejection>`，拒绝统一映射成 400 + 平台信封（对齐同模块评价保存 / 评价管理两处的既有写法），文案「共创授权档位不合法，只接受 forbidden / nonCommercial / full」 - 保留领域层 `FORK_AUTHORIZATION_UNKNOWN`（map_spacetime_error 里映射 400）：procedure 读到库里存的未知档位字符串时仍由它兜底，HTTP 面不再可达不需要删 - 新增 HTTP 级用例 `set_fork_authorization_maps_unknown_authorization_to_envelope_bad_request`：目标档位未知、期望档位未知各断言 400、平台信封（`ok=false` / `data=null` / `error.code=BAD_REQUEST` / message 含「共创授权档位不合法」/ `meta.apiVersion` 存在），并断言响应体不含框架的 `Failed to deserialize` 纯文本；用生产同一套 `attach_request_context` 中间件 + `x-genarrative-response-envelope: v1` 才拿得到信封形状 - 既有的「共创授权路由未带 Bearer 必须 401」用例保持不变（`catalog_and_publish_routes_are_mounted` 通过） - 技术方案 §5.1：新增「未知共创档位（HTTP 面合同）」证据行	2026-10-05 17:30:45 +08:00
suzmii	036989d1cc	test(游戏共创): 软删除×Fork 三条规则提取为纯函数并补单测 ... - domain.rs：新增三个不依赖 SpacetimeDB / ReducerContext 的纯函数 · `can_serve_as_fork_source(is_deleted, is_published)`：来源可用性 = 未软删除 且 已公开 · `counts_as_public_derivative(is_deleted, is_published)`：衍生计数纳入，同条件但动机不同（避免虚报热度、避免泄露「这里曾有个作品」），单独成函数以免两条规则将来互相牵连 · `fork_lineage_visible_identity(parent_available, parent_title, parent_author_name)`：父可用才透传；父不可用必须返回 (None, None)，不做任何「拿不到标题就回退用行数据」的降级 - lib.rs：在既有 `pub use domain::{...}` 列表中导出上述三个函数（一行） - spacetime-module：三处调用点改为调用纯函数，行为完全不变——来源守卫合并为一个 `if`（仍统一映射 FORK_SOURCE_NOT_AVAILABLE）、衍生计数 filter 传入两个布尔、血缘快照的父身份与根标题共用同一函数；`visibility` 判定仍由 module 侧折叠成布尔 - domain.rs 测试：新增 `fork_soft_delete_tests` 5 条——来源可用性四组合（含「已删但 visibility 仍是 published」必须 false）、计数纳入四组合、父可用透传、父不可用即使传入非空标题/作者名也必须 (None, None)、作者名三态（None→None / 空串→空串 / 只含空白原样透传） - 技术方案 §5.1：把「权限与边界」行的说明改为已由纯函数单测覆盖的三条规则（真实栈用例仍标注待补）；「软删除语义收敛 ③溯源摘要」行补上 `fork_lineage_visible_identity` 单测证据	2026-10-05 17:30:45 +08:00
suzmii	d9c53a5b75	docs(游戏共创): 按只读侦察事实修正 M2a 方案：成品包只能试玩不能重发 ... - 技术方案 §2.5：把「成品包 = 产物级改造（可发布）」改成四列表（新增「能不能再发布」列），写明成品包只能试玩与提取素材、**不能直接重新发布**；补「被否证的旧表述」对照段并指向 §3.5.1/§3.5.4 - 技术方案 §1.3：新增三行缺口事实——无「按版本取 ZIP」的下载通道、导出/发布强制 Phaser 4 + Vite 声明、发行包只含 dist + 根 assets + exports/README（不含 package.json 与源码） - 技术方案 §3.5：加术语更正块；§3.5.1 重写为「零新增上传资产，但只到『可玩参考』」——试玩成立（verification.rs:49-66）与发布必然被拦（export.rs:262-265 → :405-470；注释 :407-408、反例测试 :1239-1243）、成品包无工程声明可补、下载通道当前不存在及其内存/无续传代价 - 技术方案 §3.5.4（新增）：A 参考式改编 / B 只做工程源包 / C 伪工程三条路线与推荐（A 先行、B 为正解排后续、C 不做），标注为待用户拍板材料；附 A 路线的脚手架触发互斥点 - 技术方案 §2.4 / §2.6：唤起方式（deep link 当前未注册）标为待拍板；审核队列标注文案改为「仅成品包可玩参考，不能直接发布」；用户流程图改为目标形态并加说明 - 技术方案 §5：验收表把「一键改造闭环 / 产物级改造路径」拆成源码路径闭环、参考路径（试玩 + 素材，且界面不得承诺可发布）、交付口径一致三条 - 技术方案 §6：M2a 行改名为「参考式改编（只试玩 + 素材 + 血缘，不含重新发布）」并注明成立前提；M2b 行标注为「一键复刻完整工程」的唯一正解路径 - 技术方案 §7：改写原第 1 条（其「成品包路径默认要做」的前提已被否证），追加第 8–12 条待拍板项（对外表述 / 血缘承载位 / 是否立刻做工程源包 / 唤起方式 / 是否允许伪工程） - 里程碑「成品包改造闭环」：按事实重写「目标 / 范围 / 不在范围内 / 依赖与前置条件 / 验收标准」，新增「事实依据」四条与「前置决策（未拍板前不得实现）」五项，删除全部「能发布」的验收项，改为「本地试玩 + 素材提取 + 在自建合规工程里发布时携带血缘」 - 里程碑「作品工程源包与一键改造」：标注为正解路径；新增前置依赖①「工程包下载/授权」接口（当前不存在）与②包内禁项定义（服务端已拒绝 node_modules / .git / .env* / *.map / *.pem / *.key 与嵌套 zip），并同步「降到试玩+素材参考」的口径	2026-10-05 17:30:45 +08:00
suzmii	1e7ec6dbe7	实现游戏共创 M1：作品级共创授权与改编血缘 ... - game_distribution_game 表尾追加 fork_authorization（默认 forbidden，只升不降，旧行自动取默认） - 新增 game_distribution_lineage 表，记录父作品、来源版本、根作品与代际，并按 parent/root/owner 建索引 - migration.rs 登记新表并注明血缘随迁移导出 - 新增 set_game_distribution_fork_authorization_and_return procedure 与幂等收据、期望值 CAS - 创建作品时校验改编声明：来源存在、已公开、授权开放、来源版本等于当前公开版本；复用既有身份时拒绝携带血缘 - 公开与后台响应增量：forkAuthorization、forkCount、lineage、generation、forkedFromGameId、derivedCount - 公开快照的作者名与头像改为读时联 user_account，不再落到「创作者」兜底文案 - api-server 新增 PUT /api/game-distribution/games/{game_id}/fork-authorization（Bearer、幂等键、期望值校验） - 错误映射新增 FORK_ 前缀分支并置于通用子串分支之前，避免被误判成 409 或 404 - module-game-distribution 增加授权阶梯、代际计算与错误码，并补单测覆盖阶梯与错误码前缀 - 网页端详情页新增共创信息卡，我的作品页新增授权提升入口，补服务层调用与定向测试 - 重新生成 SpacetimeDB 绑定，登记 DTO 一致性脚本的共创类型	2026-10-05 17:30:44 +08:00
suzmii	6678c9e0c0	补充游戏共创与作品 Fork 的产品设计与技术方案 ... - 新增【技术方案】游戏共创与作品Fork-2026-10-03.md：用户视角入口、授权三态与状态流转、数据模型、接口契约、验收标准、未决问题 - 新增里程碑规范：游戏共创授权与血缘 M1、成品包改造闭环 M2a、作品工程源包与一键改造 M2b、创作族谱与衍生列表 M3 - 新增 M1 实施计划，明确修改边界、顺序、验证命令、风险与回滚点 - 记录与 PR #565（作品管理与 Phaser4 客户端发布）的重叠面与软删除语义影响 - docs/README.md 登记主规范索引	2026-10-05 17:30:44 +08:00
suzmii	21c79f54a4	Merge pull request '修复：AGC 窗口标题栏项目标签改认当前项目（#618）' (#621) from fix/agc-titlebar-project-label into master ... Reviewed-on: http://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/621	2026-10-05 16:11:16 +08:00
suzmii	6af965dab8	Merge pull request '修复 #599：首页建项不再等待 AI 项目命名，改为后台条件改名' (#606) from fix/home-project-naming-async into master ... Reviewed-on: http://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/606	2026-10-05 16:06:47 +08:00
suzmii	a299252f2a	收口 #599 评审：文档补面板补读的门控条件、PR 正文用例数字与真实计数对齐 ... - 文档口径对齐：pitfalls 的「前端读快照的时序」边界与 decision-log 同段补上门控条件——面板打开时**仅当列表里确实存在在途命名行时才补读**（不给没有命名任务的项目多打一次账本 IPC，避免改变「轮询计数」这类外部可观测行为）；不再写成「无条件补读」。 - PR #606 正文数字统一为实测值：测试节 asset_generation_task 22 例 → 27 例、conditional_project_rename_tests 6 例 → 7 例（并补上新用例名），验证节全量 1934 → 1964 passed / 17 skipped，合并段补上 76cd1f057（merge f47a8f305）。 - 用例计数命令与输出：cargo test … asset_generation_task → running 27 tests / 27 passed；cargo test … conditional_project_rename_tests → running 7 tests / 7 passed；静态计数（按测试模块内 #[test] 计数）同为 27 / 7；前端 npx vitest run homeProjectNamingAsync projectNamingGenerationTaskRow → 12 + 3 passed，appSurface.test.ts → 209 tests（200 passed / 9 skipped）。 - 本轮同时把分支合并到最新 origin/master tip 76cd1f057（merge f47a8f305，含 #608 Direct 交付合同重构与临时文档清理）——与本文档/hunk 无冲突，合并后 git merge-base --is-ancestor origin/master HEAD 返回 0。 - 未改动项（评审判定非阻塞）：useHomeProjectCreation.ts 的改名 revision 回写沿用既有改名路径同形写法，本轮无改动。 - 门禁：cargo 定向 27 + 7、cargo fmt --check、agc:typecheck、lint:eslint（0 problems）、check:encoding、check:spacetime-schema（91 表）、git diff --check 全过；前端命名/面板 15 passed、appSurface 200 passed / 9 skipped。	2026-10-05 15:51:41 +08:00
kdletters	c70186f610	Merge branch 'master' into codex/release-macos-fetch-heartbeat	2026-10-05 15:47:04 +08:00
suzmii	f47a8f3054	Merge remote-tracking branch 'origin/master' into fix/home-project-naming-async	2026-10-05 15:45:05 +08:00
suzmii	45ae29461c	评审后续：修正标题栏项目标签的空态、视图门控与文案 ... - 面板形态：快照读取成功但没有在跑回合时不再渲染「未能读取正在运行的项目」，补回 !readFailed 守卫 - 发布门控：currentProjectPath / currentProjectName 只在 launcherView === 'project-development' 时发布，离开工作台按口径回落到最近启动的在跑项目 - 菜单头部只报运行中数量，读取失败结论由 role=status 一行独占，避免同一句连排两遍 - 标签提示拆成「作用域 + 运行状态」：回落态记为「最近运行的项目：X」、状态位「共 N 个项目在运行」，不再重复「正在运行」 - 数量徽标补 title 说明数字含义 - 用例：新增面板空态回归与两条视图门控回归，更新两处标签断言；三条定向文件 25 passed - 文档：决策日志补 2026-10-05 评审后续条目并修正实施计划交叉引用，里程碑补 2026-10-05 修订，实施计划与主规范同步口径	2026-10-05 15:35:55 +08:00
suzmii	f2f33aead3	合并 master 分支到 fix/agc-titlebar-project-label ... - 合入 Direct 交付合同与租约机制重构（PR #608），涉及 direct_execution、direct_validation、direct_delivery、direct_runtime、codex_app_server 等壳层代码与提示词、agc-skills - 合入已合入 Direct 重构临时文档的清理提交 - 解决 docs/project-memory/shared-memory/decision-log.md 冲突：保留本分支「AGC 窗口标题栏项目标签改认当前项目」条目，并追加 master 的四条 Direct 决策条目 - 合并后确认技术方案文档同时保留本分支标题栏条目（常态显示当前项目名、运行中项目降级为圆点与徽标）与 master 的 Direct 操作控制章节 - 验证：git diff --check 通过；npm run check:encoding 通过（5266 个文件）	2026-10-05 15:16:43 +08:00
lhk229	76cd1f057d	清理已合入的 Direct 重构临时文档 ... 删除合同、租约及收尾修复的六份临时里程碑和实施计划 移除主规范中的过期计划引用并保留验证边界 更新共享记忆中的合入状态与权威文档入口	2026-10-05 07:21:59 +01:00
lhk229	3ac8ab1c08	重构 Direct 交付合同与租约机制 (#608) ... 当前 Direct 把交付合同作为操作准入条件，并在任意付费/执行失败后进入全局 Draining；一条无关的挂起命令可因此阻断后续代码编辑。本 PR 用于推进 #518、#529 的合同与租约机制重构。 当前仅提交草稿里程碑，运行时代码尚未修改，问题尚未修复。 - 已确认：普通操作成功或失败后返回真实结果，由 Agent 决定下一步；宿主保留回合活动状态、时间与并发控制，取消全局失败排空及返修批次门禁。 - 保留既有权限、旧回合写入归属，以及资源操作自身的幂等和不确定结果核对。 - 待细化：交付合同是否及在哪些产品场景保留、工具与提示词调整、已有配置与账本兼容；实现前同步主规范和单里程碑实现计划。 工作范围：`docs/project-memory/plans/【里程碑】Direct合同与租约机制重构-2026-10-03.md`。 验证：`npm run check:doc-index`、`npm run check:encoding`、`git diff --cached --check` 通过。本次未运行运行时测试。 关联 #518、#529；当前不关闭问题。 Reviewed-on: #608 Co-authored-by: lhk <ink29535@proton.me> Co-committed-by: lhk <ink29535@proton.me>	2026-10-05 14:19:05 +08:00
kdletters	a377ece48e	修复 Mac release 构建的 Git 心跳 ... 为 macOS Jenkins Checkout 增加 SSH 保活与 fetch 心跳。\n增加 fetch 超时诊断并补充生产运维门禁。\n更新 Mac 构建运维说明。	2026-10-05 11:47:55 +08:00
suzmii	67d06bc168	独立评审收口 #599：命名行事件时序、命名任务 update 门禁、失败关闭与 legacy 用例 ... - P2-2：命名行的账本订阅与恢复读合并为同一次 effect 的「先订阅、后读、只读一次」（与素材队列先订阅后派发同口径），并在「生成任务」面板打开且**确有在途命名行**时补读一次兜底——多读会改变既有生成任务链路可观测的轮询计数，因此不给没有命名任务的项目加读。新增 2 条 appSurface 用例（错过终态事件仍到终态 / 面板打开补读），并做了「改前红」验证：退回「先读后订阅 + 面板不补读」两条即红。 - P2-3：update_local_project_naming_task 补 project.rename 权限门禁（与 enqueue 同口径）、校验记录 project_id 与项目一致、终态只接受同状态幂等重放（completed→failed 一律 Err 且不写盘）；新增 3 条 Rust 用例。 - P2-4：新增失败关闭与 schema 分支用例——超长项目名条件改名 Err 且 manifest/revision 不变、不支持 schemaVersion Err、缺 schemaVersion 按 v1 接受。 - P3-1：legacy v1 兼容用例改为断言兼容性质（字段原样保留），不再引用 phase 文案常量。 - 文档：pitfalls 补「兼容是单向的（旧构建读含命名记录的账本会整份失败，含影响面/触发条件/潜在低成本正向兼容方向）」与「先订阅后读快照」「update 门禁与终态语义」三条边界；decision-log 同步边界与数字。 - 门禁：AGC 全量 1964 passed / 17 skipped（appSurface 200 passed / 9 skipped）；cargo asset_generation_task 27 passed、conditional_project_rename_tests 7 passed；agc:typecheck、lint:eslint（0 problems）、check:encoding、check:spacetime-schema、cargo fmt --check、git diff --check 全过。	2026-10-05 00:55:29 +08:00
suzmii	d550d882d4	合并 master 6c9566058：保留 v2 账本/命名任务与 master 侧改动 ... - 冲突仅在 docs/project-memory/shared-memory/decision-log.md 与 pitfalls.md（双方都在顶部追加条目）：两边条目全部保留——本分支的 Issue 599 条目（AI 项目命名解耦 / 生成任务账本 taskType + live 集合）在前，master 侧新增条目（发布版本标签派生、随包 plugins feature 档位、.worktrees 下 Vite 忽略规则、并发 dev 栈、Windows 阻塞模态用例）原样保留，逐条核对无丢失。 - 其余文件（desktop.rs、check-config.mjs、view/project-development/index.tsx、src-tauri 多处、admin-web、game distribution 等）均为自动合并，无冲突。 - 合并后自证：v2 账本常量/命令注册/命名任务命令名/条件改名空 expected 校验/entrySettled 顺序/命名行与事件刷新/三个测试文件的关键断言全部在位（脚本逐条核对 ALL_OK）。	2026-10-04 23:37:57 +08:00
suzmii	9755b381c1	Merge branch 'master' into fix/agc-titlebar-project-label	2026-10-04 20:05:42 +08:00
suzmii	6c95660588	Merge pull request '优化 AGC 工作台顶栏布局：一行到底、版本入口钉右分级、播放并入运行页签（Issue #613）' (#615) from fix/agc-toolbar-layout into master ... Reviewed-on: #615	2026-10-04 20:04:30 +08:00
suzmii	c9df6edc63	修复：AGC 窗口标题栏项目标签改认当前项目（#618） ... - 窗口标题栏标签主文案恒为当前项目名：WindowChromeActiveProjectRuns 新增 currentProjectName，由 WorkspaceLauncher 发布当前项目清单名，WindowChrome 透传给标题栏入口 - 正在运行的项目降级为圆点、运行中数量徽标与展开菜单：ActiveProjectRunsPanel 主文案不再取开始时间最晚的在跑项目 - 展开菜单里当前项目那一行沿用清单项目名，meta 首位标「当前」，aria-current 保留 - 运行快照读取失败不再整块替换标签：圆点转告警色，结论落在菜单内一行；既无在跑项目又无当前项目名时保留原来的纯提示 - 新增 .launcher-runs-panel-dot.is-warning 与 .launcher-runs-titlebar-menu-note 样式 - 用例：directActiveTurns 新增三条回归（别的项目在跑时标签仍是当前项目、当前项目自己跑时列表带「当前」、读取失败不顶掉当前项目名），WindowChrome 新增当前项目优先级用例，并把「只显示最后开始的项目」用例改名为「不在项目内时…」 - 文档：修正主规范 2026-09-15 段的标题栏条目、里程碑与实施计划文末修订，decision-log 追加 2026-10-04 决策	2026-10-04 18:57:20 +08:00
suzmii	f418ecfee9	Merge branch 'master' into fix/agc-toolbar-layout	2026-10-04 18:37:56 +08:00
suzmii	3dcfbb1d10	合并 origin/master（33552d2ed）：文档冲突两边条目都保留 ... - 冲突仅在 docs/project-memory/shared-memory/decision-log.md 与 pitfalls.md（双方都在文件顶部追加最新条目）。 - 解决方式：两边条目全部保留——本分支的 Issue 599 条目（AI 项目命名解耦 / 生成任务账本 taskType）在前，master 侧的新条目（#604 游戏游玩次数两条、#602 AGC 画布引用、AGC 渠道更新两条）原样保留，逐条核对无丢失。	2026-10-04 17:17:30 +08:00
suzmii	206c625a58	顶栏两端留给两枚大分组：排序分段收行尾，版本入口移到它左边 ... - index.tsx：把「依赖 / 类型」分段从动作区中部挪到动作行最后一个子元素，版本入口紧邻其左（版本不再是最右那一枚） - styles.css：排序分段左边距的注释改成与左邻无关（现在左邻是版本入口） - 用例：资源版本切换新增顶栏顺序断言（版本入口在排序分段之前、排序分段是动作行行尾）；生成任务侧栏用例改判排序分段为动作行最后一个子元素 - 文档：PRD 两端分组条款、验收用例 S16 入口位置、决策记录、改动后对照图与 README 重拍	2026-10-04 17:14:26 +08:00
suzmii	a554b0c7ca	把 AI 项目命名接进「生成任务」体系：账本 v2 任务类型、命名任务入队与推进、面板命名行 ... - 账本 v2：记录新增 taskType（asset-generation / project-naming，缺省 asset-generation，旧壳按素材任务读回），kind 改为可选；schema 升 agc-asset-generation-task.v2，读取同时接受 v1 与 v2。 - 新增 enqueue_local_project_naming_task / update_local_project_naming_task：命名任务入队时登记 live、终态写盘后摘除（写盘失败只回滚本轮插入），中断残留按命名口径收口为 failed（文案不含「目标素材」）。 - 首页命名链路改为推进这条任务：入队 → 命名中 → 已完成（已应用 AI 名称 / 建议名与现状一致 / 用户已手动改名而跳过）或失败（无可用名称 / 自动改名失败，均保留兜底名）；账本只作展示旁路，推进失败只写诊断日志。 - 前端模型与面板支持命名行：按 taskType 把命名记录从素材任务分支剔除，命名行固定展示名「AI 项目命名」、只在终态显示结论、不渲染缩略图/提示词/定位动作；命令名写字面量以满足 check-config 静态枚举门禁。 - 工作台订阅账本变更事件做一次受控快照读取刷新命名行（不新增固定频率轮询）；另修：命名行的 useLiveNow 收进独立组件，避免行种类变化导致 hooks 数量变化。 - 测试：homeProjectNamingAsync 12 例（新增入队→命名中→终态推进序列断言）、projectNamingGenerationTaskRow 3 例、appSurface 建项后命名行可见 + 事件刷新出终态结论 + 标题/列表同步；Rust asset_generation_task 22 例（含 naming_task_stays_in_flight_across_ledger_reads_until_terminal、legacy_v1_ledger_reads_back_*）。 - 文档：decision-log 改写为「生成任务体系里的后台任务」、pitfalls 新增 taskType/live 集合条目、实施计划专题补任务接入口径。 - 门禁：AGC 全量 1925 passed / 17 skipped；cargo 定向 22 + 6；npm run agc:typecheck（含 check:tests:types 与 check-config）；cargo fmt --check；check:encoding；git diff --check。	2026-10-04 16:59:59 +08:00
suzmii	ee6f1d43c9	Merge remote-tracking branch 'origin/master' into feat/game-works-management	2026-10-04 16:23:57 +08:00
suzmii	9eb537c6ff	运行视图没有画面时自动补一次载入（进入项目/切项目的运行页空态） ... - index.tsx：新增 autoRunPreviewProjectRef 记账，站在运行视图却没有可嵌入预览且可运行时自动补发一次 onPlay，同一个项目只补一次 - index.tsx：showRunView 先记账再发播放，避免点页签时被自动补发重复触发一次 - 用例：新增 runAutoLoadOnEnter（切项目自动补发一次、同项目不重复、点页签只发一次、有活体预览时不补发） - 文档：PRD 顶栏条款、验收用例 S17 判据、decision-log 同步自动载入口径	2026-10-04 15:56:41 +08:00
suzmii	2f6df57ce2	Merge remote-tracking branch 'origin/master' into feat/game-works-management ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md # docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md # server-rs/crates/api-server/src/modules/game_distribution.rs # server-rs/crates/spacetime-client/src/active.rs # server-rs/crates/spacetime-module/src/game_distribution.rs # src/components/game-distribution/GameDistributionPages.test.tsx	2026-10-04 15:00:23 +08:00
lhk229	33552d2ed6	修复游戏评价操作列左对齐 ... 将评价列表操作按钮与操作列头左对齐 同步评价列表布局规范	2026-10-04 07:52:24 +01:00
lhk229	a1b80ffde9	修复后台游戏评价状态与操作按钮换行 ... 为游戏评价列表增加专属表格样式类 状态胶囊保持单行，操作按钮禁止换行和压缩 同步后台评价列表布局规范	2026-10-04 07:47:13 +01:00
suzmii	2bfc62f695	文档：同步 AGC 顶栏布局口径与改动后对照图 ... - PRD 顶栏条款改为一行到底 + 三档降级 + 运行页签即播放入口 + 运行画面刷新入口 - 验收用例 S17 改为「运行」页签入口语义，新增 S17a 刷新运行画面（含排障索引与验收记录表） - decision-log 新增 2026-10-04 顶栏布局决策（档位判据、两处「吞掉溢出」的坑、验证范围） - docs/README.md 索引新增改动后对照图；新增 docs/technical/assets/agc-toolbar-layout-after-20261004/（4 张真实 Chromium 实测截图）	2026-10-04 14:12:25 +08:00
kdletters	81cfbae207	后台侧栏按业务分组支持折叠 ... 新增后台侧栏业务分组与当前页自动展开行为 补充折叠交互、路由分组和权限过滤测试 同步后台导航分组行为文档	2026-10-04 13:25:58 +08:00
suzmii	ddc3832279	Merge remote-tracking branch 'origin/master' into feat/game-works-management	2026-10-04 12:30:52 +08:00
k88936	ff83b67196	Merge branch 'master' into feat/play-count-with-cache	2026-10-04 12:08:32 +08:00
k88936	57e259278d	Merge remote-tracking branch 'origin/master' into feat/play-count-with-cache ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-10-04 11:58:25 +08:00
kdletters	13a15fed5c	修复 AGC 渠道更新互相终止与快捷方式迁移 ... 为 release 与自定义渠道注入独立主程序名，隔离 Windows 更新进程。 新增 release 旧安装目录与快捷方式迁移钩子，保护 dev 历史目录清理。 同步渠道规范、共享决策与排障记录，补充发布脚本回归测试。	2026-10-04 11:45:20 +08:00
k88936	08020e664b	文档：同步客户端 IP 只信 X-Real-IP ... - ADR：身份与去重键节写明 IP 取 nginx 覆盖的 X-Real-IP、XFF 只取末段，并追加 2026-10-04 修订记录 - 玩法链路：去重与限流节标注 IP 来源 - decision-log：2026-10-04 条目补安全修正说明与标题	2026-10-04 11:39:00 +08:00
suzmii	0168aa7bc3	Merge remote-tracking branch 'origin/master' into feat/game-works-management ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md # docs/project-memory/shared-memory/pitfalls.md	2026-10-04 11:27:10 +08:00
k88936	c0148dda7e	文档：同步游玩计数关停不强制 flush 与失败丢弃口径 ... - ADR：修订「正常关停必须 force flush」为关停不做强制 flush，并补充 flush 任一分片失败即丢弃剩余分片；追加修订记录 - 玩法链路：缓冲与延迟改为崩溃/被杀/正常关停都允许丢一个窗口；限流节补充先做内存预检；写入语义补充失败丢弃口径 - decision-log：顶部新增 2026-10-04 修订条目，并给 2026-10-03 条目标注失效项 - docs/README：ADR 摘要去掉「关停 flush」	2026-10-04 11:13:55 +08:00
suzmii	8abc35158c	Merge branch 'master' into feat/game-works-management	2026-10-04 09:23:45 +08:00
suzmii	4fc13bcfe3	合并 fix/ci-master-red（PR #609）到 fix/agc-canvas-reference-insert：取得 master 级 CI 修复 ... 把 #609 的 8/8 全绿修复并进本分支，满足「PR head 必须包含最新 base 提交」的门禁，同时带上共享红修复：check:nginx-spa-routes 的 /pay/<checkoutToken> 前缀路由与 Pingora 路由矩阵、external_mcp::semantic 真值 32、api-server/platform-llm 的 tracing interest 竞态、AGC 壳 Rust shard-4 两条偶发断言 本次 merge 无冲突自动完成：pitfalls.md 两边条目都保留（本分支的 issue #602 条目 + #609 的 2026-10-04 tracing/shard-4/SPA 深链三条） 未改动 #609 引入的任何文件	2026-10-04 03:40:21 +08:00
suzmii	459fe5b432	Merge remote-tracking branch 'origin/fix/ci-master-red' into fix/home-project-naming-async	2026-10-04 03:39:42 +08:00