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::(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,