新规hook

docs/server/development-guide/02-子游戏接入与开发流程.md

@@ -32,7 +32,7 @@ server/<游戏容器目录>/<你的游戏>/     （容器目录名由接入方
 └── tests/        单元/集成测试
 ```
 
-> 举例（麻将）：`game/RoomAdapter.js`(房间↔对局适配)、`game/GameController.js`(对局编排)、`rpc/BroadcastManager.js`(差异化广播)、`rpc/handlers/*`(各操作处理)。换个玩法，分层思路不变，文件内容不同。
+> 举例（麻将）：`game/RoomAdapter.js`(房间↔对局适配)、`game/GameController.js`(对局编排)、`rpc/BroadcastManager.js`(差异化广播)、`rpc/handlers/*`(各操作处理)。换个玩法，分层思路不变。
 
 ---
 
@@ -51,17 +51,12 @@ var mod_<你的游戏> = mod_<你的游戏> || cls_mod.new("mod_<你的游戏>",
 
 ### 2.2 按依赖顺序加载文件
 
-被依赖的先加载；`export.js`/`import.js` 通常在业务类之后加载（它们会用到业务模块）：
+被依赖的先加载；`export.js`/`import.js` 通常在业务类之后加载（它们会用到业务模块）。浏览器/友乐用 `min_loadJsFile` 异步链式加载：
 
 ```js
-// 浏览器/友乐：min_loadJsFile 异步链式加载
 min_loadJsFile("<容器目录>/<你的游戏>/常量与工具.js", function(){
-min_loadJsFile("<容器目录>/<你的游戏>/数据结构.js",   function(){
-min_loadJsFile("<容器目录>/<你的游戏>/export.js",     function(){
-min_loadJsFile("<容器目录>/<你的游戏>/import.js",     function(){
-min_loadJsFile("<容器目录>/<你的游戏>/业务与rpc.js",  function(){
-    console.log("模块 [" + mod_<你的游戏>.modname + "] 加载完成");
-});});});});});
+  min_loadJsFile("<容器目录>/<你的游戏>/export.js", function(){ /* ...嵌套加载 import.js、业务与rpc.js... */ });
+});
 ```
 
 > 推荐分层加载顺序：**常量 → 工具 → 数据结构 → export/import → 收发包层 → 业务层 → 规则引擎**。Node 测试侧用 `require`（写在守卫块内），浏览器侧用 `min_loadJsFile`，两套并存但按全局名统一引用（见 01）。
@@ -83,7 +78,6 @@ RPC 方法是**前后端交互的服务端入口**。以下是必须遵守的规
 RPC 方法本身**不写业务逻辑**，只把 `pack` 转交给收发包层的 handler；真正的参数校验、业务编排、广播都在 handler 里：
 
 ```js
-// mod_<你的游戏> 上挂的 RPC 方法（示例名，可自定）
 mod_<你的游戏>.playCard = function(pack) {
     // 就绪守卫：handler 由 min_loadJsFile 异步加载，未就绪时防御性返回（见规则四）
     if (typeof RpcHandler === 'undefined' || !RpcHandler) {
@@ -91,9 +85,6 @@ mod_<你的游戏>.playCard = function(pack) {
     }
     return RpcHandler.handlePlayCard(pack);   // 委托到收发包层，真正逻辑在这里
 };
-mod_<你的游戏>.declareHu = function(pack) {
-    return RpcHandler.handleDeclareHu(pack);
-};
 ```
 
 > `RpcHandler`、`handlePlayCard` 这些是**本项目的命名示例**；换成任何风格都行，关键是"薄入口 + 委托"的分层。
@@ -184,14 +175,13 @@ mod_<你的游戏>.export = cls_<游戏>_export.new();   // 文件末尾自动
 
 ```js
 exp.makewar = function(o_room, o_game_config) {
-    // 1) 创建子游戏牌桌对象，并与房间建立【双向引用】
+    // 1) 创建牌桌对象，与房间建立【双向引用】
     if (!o_room.o_desk) { o_room.o_desk = {}; }
     if (!o_room.o_desk.data) { o_room.o_desk.data = {}; }
     o_room.o_desk.o_room = o_room;            // 反向引用
 
     // 2) 创建对局状态，挂到 o_room.o_desk.data.*（房间隔离的落点）
-    var gameState = createGameState(o_room, o_game_config);
-    o_room.o_desk.data.gameState = gameState; // 此后所有业务都从这里读对局态
+    o_room.o_desk.data.gameState = createGameState(o_room, o_game_config);
 
     // 3) 返回开战数据包（通常按座位差异化下发）
     return {
@@ -217,26 +207,15 @@ exp.makewar = function(o_room, o_game_config) {
 
 ## 4. `import.js` —— 子游戏调用平台的 4 个接口
 
-这 4 个接口是对平台 `youle_room.export` 的薄封装，**逻辑由平台实现，你只管在正确时机调用**：
+这 4 个接口是对平台 `youle_room.export` 的薄封装，**逻辑由平台实现，你只管在正确时机调用**。每个都形如 `imp.<接口> = function(...args){ return mod_<你的游戏>.app.youle_room.export.<接口>(...args); }`，本项目 4 个：
 
 ```js
 mod_<你的游戏>.import = (function() {
     var imp = {};
-    imp.check_player = function(agentid, gameid, roomcode, seat, playerid, conmode, fromid) {
-        return mod_<你的游戏>.app.youle_room.export.check_player(
-            agentid, gameid, roomcode, seat, playerid, conmode, fromid);
-    };
-    imp.deduct_roomcard = function(o_room) {
-        return mod_<你的游戏>.app.youle_room.export.deduct_roomcard(o_room);
-    };
-    imp.save_grade = function(o_room, o_gameinfo1, o_gameinfo2, freeroomflag) {
-        return mod_<你的游戏>.app.youle_room.export.save_grade(
-            o_room, o_gameinfo1, o_gameinfo2, freeroomflag);
-    };
-    imp.finish_gametask = function(agentid, o_player, taskid, finishamount) {
-        return mod_<你的游戏>.app.youle_room.export.finish_gametask(
-            agentid, o_player, taskid, finishamount);
-    };
+    imp.check_player     = function(agentid, gameid, roomcode, seat, playerid, conmode, fromid) { /* → youle_room.export.check_player(...) */ };
+    imp.deduct_roomcard  = function(o_room) { /* → youle_room.export.deduct_roomcard(o_room) */ };
+    imp.save_grade       = function(o_room, o_gameinfo1, o_gameinfo2, freeroomflag) { /* → youle_room.export.save_grade(...) */ };
+    imp.finish_gametask  = function(agentid, o_player, taskid, finishamount) { /* → youle_room.export.finish_gametask(...) */ };
     return imp;
 })();
 ```
@@ -306,4 +285,3 @@ mod_<你的游戏>.import = (function() {
 - [ ] 改了下发结构，前端 `StartWar`/`Reconnect`/对应操作解析同步检查。
 
 下一篇 [03-数据收发与通信协议](./03-数据收发与通信协议.md) 详解包结构、发包方式、主动推送与 `success` 成败协议。
-</content>