From 4626aeefd4229c1536cf37a1d429630c1cfbf118 Mon Sep 17 00:00:00 2001
From: Suzumiya <suzmii@qq.com>
Date: Mon, 5 Oct 2026 04:16:06 +0800
Subject: [PATCH] =?UTF-8?q?fix(=E5=9F=8B=E7=82=B9=E5=90=88=E5=90=8C):=20?=
 =?UTF-8?q?=E6=9C=8D=E5=8A=A1=E7=AB=AF=E5=90=8C=E6=AD=A5=20AGC=20=E6=96=B0?=
 =?UTF-8?q?=E5=A2=9E=E7=9A=84=20creation=5Fsource=3Dplatform=5Fgame?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 依据客户端提交 `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-09-21.md |  2 +-
 .../module-runtime/src/agc_analytics.rs       | 39 +++++++++++++++++++
 .../shared-contracts/src/agc_analytics.rs     |  4 +-
 3 files changed, 43 insertions(+), 2 deletions(-)

diff --git a/docs/technical/【技术方案】客户端本地埋点与主站入库契约-2026-09-21.md b/docs/technical/【技术方案】客户端本地埋点与主站入库契约-2026-09-21.md
index 6cc64acbd..ddb65a81d 100644
--- a/docs/technical/【技术方案】客户端本地埋点与主站入库契约-2026-09-21.md
+++ b/docs/technical/【技术方案】客户端本地埋点与主站入库契约-2026-09-21.md
@@ -210,7 +210,7 @@ Direct 的自动登录刷新重试仍属同一个 run。原生单次调用结束
 
 - 触发：新项目初始化完成，manifest 已持久化且稳定 project_id 已确认；覆盖自动创建与用户选目录创建。
 - 公共字段：status=success；project_id 必填；source=editor；任务/run/turn ID 均 null。
-- properties：creation_source=home_game / home_design / template / selected_directory；project_template_id 可选，仅填真实模板稳定 ID。
+- properties：creation_source=home_game / home_design / template / selected_directory / platform_game；project_template_id 可选，仅填真实模板稳定 ID。
 - 打开已有项目、幂等初始化不记创建；文件夹刚建立但后续失败不记成功。
 - 去重事实键：project_id + 本次创建操作 ID + event_name，沿用业务操作身份，不读取路径当项目 ID。
 - 只有成功事件，不能计算创建成功率；创建尝试数不在本版范围。
diff --git a/server-rs/crates/module-runtime/src/agc_analytics.rs b/server-rs/crates/module-runtime/src/agc_analytics.rs
index c0c2ed4a4..388c3e1ea 100644
--- a/server-rs/crates/module-runtime/src/agc_analytics.rs
+++ b/server-rs/crates/module-runtime/src/agc_analytics.rs
@@ -386,6 +386,45 @@ mod tests {
         raw["file_path"] = json!("secret");
         assert!(serde_json::from_value::<Event>(raw).is_err());
     }
+
+    /// `creation_source` 的取值集合必须与客户端埋点合同一一对应：客户端新增「从平台作品开始创作」
+    /// （`platform_game`）后，服务端不认得就会把整条事件判成 `invalid_properties` 丢掉。这里把
+    /// 全部受支持取值逐个跑通，并钉住未知取值仍然失败关闭（不得静默接受或静默丢弃）。
+    #[test]
+    fn agc_accepts_every_creation_source_and_rejects_unknown() {
+        for creation_source in [
+            "home_game",
+            "home_design",
+            "template",
+            "selected_directory",
+            "platform_game",
+        ] {
+            let mut e = event(
+                "project_create_success",
+                json!({ "creation_source": creation_source }),
+            );
+            // `project_create_success` 要求 source=editor 且 project_id 非空（见 `EventRules::validate`）。
+            e.project_id = Some("project-a".into());
+            assert_eq!(
+                validate_agc_analytics_batch(&batch(e)),
+                Ok(()),
+                "{creation_source}"
+            );
+        }
+        for unknown in ["remix", "platform", "PLATFORM_GAME", ""] {
+            let mut e = event(
+                "project_create_success",
+                json!({ "creation_source": unknown }),
+            );
+            e.project_id = Some("project-a".into());
+            assert_eq!(
+                validate_agc_analytics_batch(&batch(e)),
+                Err("invalid_properties"),
+                "{unknown}"
+            );
+        }
+    }
+
     #[test]
     fn agc_requires_explicit_nullable_fields_and_no_optional_nulls() {
         let mut raw =
diff --git a/server-rs/crates/shared-contracts/src/agc_analytics.rs b/server-rs/crates/shared-contracts/src/agc_analytics.rs
index bb26bdebd..6aa8171e3 100644
--- a/server-rs/crates/shared-contracts/src/agc_analytics.rs
+++ b/server-rs/crates/shared-contracts/src/agc_analytics.rs
@@ -55,7 +55,9 @@ values!(CreationSource {
     HomeGame,
     HomeDesign,
     Template,
-    SelectedDirectory
+    SelectedDirectory,
+    // 从平台作品开始创作（改编 Fork）：取件自平台已授权公开作品的发行成品包。
+    PlatformGame
 });
 values!(OpenSource {
     Create,