diff --git a/docs/H5-Native-Contract.md b/docs/H5-Native-Contract.md
index face404..e5b34f9 100644
--- a/docs/H5-Native-Contract.md
+++ b/docs/H5-Native-Contract.md
@@ -690,34 +690,76 @@ _webView.scrollView.showsHorizontalScrollIndicator = NO;
 - LocalStorage 由 H5 自管（WKWebView 默认走 WebsiteDataStore）
 - 加载方式：**`loadFileURL:fileURL allowingReadAccessToURL:dirURL`**（file://），不走 HTTP
 
-### 4.2 JS 注入
+### 4.2 JS 注入（**已按原项目代码全面修订** — 见底部"修订记录"）
 
-在 `viewWillAppear` 内（每次加载 H5 之前）写出三个文件：
+H5 业务通过 `<script src="app_*.js">` 同步引入 4 个预生成的 `.js` 文件，文件内全是 `var app_xxx=...` 全局变量声明。原 msext 写入位置：`NewRootVC.m:1204`（大厅 initJSdata）/ `gameController.m:2160`（子游戏 initJSdata）/ `gameController.m:1191` `NewRootVC.m:1706`（battery 更新）/ `gameController.m:1198` `NewRootVC.m:1714`（network 更新）/ `AppDelegate.m:259` `gameController.m:197`（gamesname 更新）。
+
+**⚠️ 关键约束：文件名 ≠ 变量名**
+
+| 文件名（不带 get） | 文件内变量名（带 get） |
+|---|---|
+| `app_battery.js` | `var app_getbattery=...` |
+| `app_network.js` | `var app_getnetwork=...` |
+
+H5 端 `<script src="app_battery.js">` 引入后读到的是 `app_getbattery`（带 get 前缀），**不是** `app_battery`。任何拼写错误都会让 H5 业务读到 undefined。
+
+#### `app_data.js`（写到 `{gamedir}/{gamestart}/app_data.js`）
+
+12 个变量（**没有** `app_gameid` / `app_compareCode`，那两个是 §4.2 早期文档错误记录，原项目代码 `NewRootVC.m:1204` / `gameController.m:2160` 字面字符串里**根本不写**它们）：
 
-#### app_data.js（写到 `{gamedir}/{gamestart}/app_data.js`）
 ```js
-var app_gameconfig = "<gameconfig>";
-var app_gamedir    = "<gamedir>";
-var app_gamestart  = "<gamestart>";
-var app_agent      = "<agent>";
-var app_appversion = "<appversion>";
-var app_market     = "<market>";
-var app_channel    = "<channel>";
-var app_gameid     = "<gameid>";
-var app_compareCode= "<getcompareCode>";   // NSUserDefaults
+var app_version            = "1";        // 硬编码，沿用历史
+var app_gameconfig         = "<gameconfig>";
+var app_gamedir            = "<gamedir>";
+var app_gamestart          = "<gamestart>";
+var app_agent              = "<agent>";
+var app_appversion         = "<appversion>";    // int 字面，msext "var app_appversion='%d'"
+var app_market             = "<market>";
+var app_channel            = "<channel>";
+var app_Launchtype         = 0;          // ⚠️ L 大写！大厅=0 / 子游戏=1
+var app_getwifisignalLevel = 1;          // ⚠️ wifi 小写、signal/Level 区分大小写，硬编码 1
+var app_gamename           = "<gamename>";
+var app_invitationcode     = "<tuiguang_id>";   // 推广码 / 邀请码
 ```
 
-#### app_battery.js
+> 大厅 / 子游戏的字面差异（详见 §7.5 Design）：
+> - `app_Launchtype`：大厅 `0` / 子游戏 `1`
+> - `app_gamedir`：大厅 = `self.gamedir`（即 BundleConfig.gameDir）/ 子游戏 = `self.gamefilepath`（子游戏目录）
+> - `app_gamestart` + `app_gamename`：大厅 = `self.gamestart` / 子游戏 = `self.game_name`（子游戏名）
+
+#### `app_battery.js`（写到 `{gamedir}/{gamestart}/app_battery.js`）
+
 ```js
-var app_battery = "<UIDevice batteryLevel>";   // e.g. "0.85"
+var app_getbattery = 0.85;   // ⚠️ 变量名带 get！msext "var app_getbattery=%lf" double 字面
 ```
 
-#### app_network.js
+更新时机：`viewWillAppear` + `UIDeviceBatteryLevelDidChangeNotification` + 前台切换通知。
+
+#### `app_network.js`（写到 `{gamedir}/{gamestart}/app_network.js`）
+
 ```js
-var app_network = "<state>";   // "1"/"2"/"3"
+var app_getnetwork = 2;   // ⚠️ 变量名带 get！msext "var app_getnetwork=%d" int 字面：1 无网 / 2 WiFi / 3 蜂窝
 ```
 
-> H5 模板里 `index.html` 通过 `<script src="app_data.js">` 等同步引入这三个文件。新外壳必须保证这些文件**在 loadFileURL 之前**就写好，否则 H5 启动时变量未定义直接崩。
+更新时机：`viewWillAppear` + 网络变化（msext 用 AFNetworkReachability，新外壳用 NWPathMonitor）+ 前台切换通知。
+
+#### `app_gamesname.js`（写到 `{gamedir}/{gamestart}/app_gamesname.js`）
+
+```js
+var  app_gamesname = new Array('game1','game2',...);   // ⚠️ var 后面两个空格，沿用 msext AppDelegate.m:259 字面
+```
+
+更新时机：`AppDelegate.applicationDidFinishLaunching`（首次写入）+ 子游戏 `gameController.viewInit`（新装一个子游戏后追加；msext gameController.m:197 注释掉了实际写入逻辑，仅 AppDelegate 首次写入是活的）。
+
+> H5 模板里 `index.html` 通过 `<script src="app_data.js">` 等同步引入这 4 个文件。新外壳必须保证这些文件**在 loadFileURL 之前**就写好，否则 H5 启动时变量未定义直接崩。
+
+#### 修订记录
+
+| 日期 | 修订点 | 依据 |
+|------|---|---|
+| 2026-06-22 | 删 `app_gameid` / `app_compareCode`：原项目 grep `var app_` 在 `NewRootVC.m:1204` / `gameController.m:2160` 字面字符串里没有这两项 | daoqi 原项目代码全面 grep 验证 |
+| 2026-06-22 | `app_battery` 改为 `app_getbattery`、`app_network` 改为 `app_getnetwork`：变量名带 `get` 前缀，与文件名（不带 get）不一致 | daoqi `gameController.m:1191/1198`、`NewRootVC.m:1706/1714` |
+| 2026-06-22 | 新增 `app_version` / `app_Launchtype` / `app_getwifisignalLevel` / `app_gamename` / `app_invitationcode` / `app_gamesname` 共 6 项 | daoqi `NewRootVC.m:1204`、`gameController.m:2160`、`AppDelegate.m:259` |
 
 ### 4.3 WKUIDelegate（H5 alert / confirm）