diff --git a/packages/shared/src/contracts/generated/NewGameVersionRequest.ts b/packages/shared/src/contracts/generated/NewGameVersionRequest.ts
index da1cee35a..b3cba23bf 100644
--- a/packages/shared/src/contracts/generated/NewGameVersionRequest.ts
+++ b/packages/shared/src/contracts/generated/NewGameVersionRequest.ts
@@ -17,7 +17,14 @@ projectKey?: string | null,
  * 作者提交的买断制价格（泥点）；`0` 表示免费，缺省按免费处理。
  * 价格随版本冻结，审核通过时与资料一起生效到游戏行。
  */
-priceMudPoints?: number, packageSha256: string, packageBytes: number, packageFileCount: number, packageEntryPath: string, 
+priceMudPoints?: number, packageSha256: string, packageBytes: number, packageFileCount: number, 
+/**
+ * 包入口路径。当前统一打包器固定产出 `index.html`，服务端预览也按该入口解析。
+ *
+ * 契约刻意保持 `string` 而不收窄成 `'index.html'` 字面量：入口由打包器决定，收窄会把
+ * 「当前实现」写死进公开 TS 类型，未来支持多入口时还得再改一次公开契约。约定值写在这里。
+ */
+packageEntryPath: string, 
 /**
  * 作品展示资料：首次发布用于 bootstrap 游戏行，同时冻结进版本资料快照。
  */
diff --git a/server-rs/crates/shared-contracts/src/game_distribution_publish.rs b/server-rs/crates/shared-contracts/src/game_distribution_publish.rs
index f508e59cf..8abe1ea8f 100644
--- a/server-rs/crates/shared-contracts/src/game_distribution_publish.rs
+++ b/server-rs/crates/shared-contracts/src/game_distribution_publish.rs
@@ -45,6 +45,10 @@ pub struct NewGameVersionRequest {
     #[cfg_attr(feature = "ts-bindings", ts(type = "number"))]
     pub package_bytes: u64,
     pub package_file_count: u32,
+    /// 包入口路径。当前统一打包器固定产出 `index.html`，服务端预览也按该入口解析。
+    ///
+    /// 契约刻意保持 `string` 而不收窄成 `'index.html'` 字面量：入口由打包器决定，收窄会把
+    /// 「当前实现」写死进公开 TS 类型，未来支持多入口时还得再改一次公开契约。约定值写在这里。
     pub package_entry_path: String,
     /// 作品展示资料：首次发布用于 bootstrap 游戏行，同时冻结进版本资料快照。
     pub game_metadata: GameMetadata,