TankIC/3DTank/docs/ArchitectureModules.md

# 3DTank 架构模块调研

> 本文件内容全部由 `3DTank/names/module-graph.json` 的数据生成（一次性内联 node 命令，仓库不保留生成脚本）；计数、依赖、分层均非手工绘制。

## 1. 总览

- 模块总数：**126**（均为 webpack 代码模块；index.json 中其余条目是资源模块，不在本调研范围）
- 按 Kind：游戏本体 **40** / Kotlin生态库 **22** / 第三方库 **64**
- 依赖边总数：**533**；孤立模块（无出度且无入度）：**3** 个
- 依赖层次最深（最长依赖链）：**Level 17**

### 1.1 依赖与结构的抽取方法（覆盖率）

- **依赖（DependsOn）**：取模块工厂第 3 个参数作为 webpack require（形如 `(t, n, i) => {` 里的 `i`），再扫描 `i(<id>)` 静态调用，且 id 必须命中已知代码模块 id 集合。**126/126 模块都执行了抽取**，其中 **97 个模块抽到 ≥1 条边（77%）**；**29 个模块 DependsOn 为空**，原因是：24 个模块工厂只有 1~2 个参数（编译产物里根本没有 require 参数），5 个模块有 require 参数但源码无静态 `i(<id>)` 调用（7793、14766、17323、55920、94965；其中 55920 用 `t.require(n)` 动态取模块，无法静态解析）。`index.json` 只含 id/type/path，**不含依赖信息**，故依赖全部来自源码扫描。
- **Kind**：按 dir.file 职责描述判定。职责点名可识别外部包/产品（React、ReactDOM、Scheduler、Sentry、qrcode、fflate、Emotion、underscore、inline-style-prefixer、prop-types、react-is、react-list、hoist-non-react-statics、@preact/signals-react、WebViewJavascriptBridge、Google Play Billing、Yandex Metrica、Dijkstra 库等）→ 第三方库；Kotlin/JS 编译出的通用基础设施（kotlin-stdlib、kotlinx.serialization、kotlinx.coroutines、atomicfu、ByteBuffer、DOM/CSS 构建器、RBuilder、Kotlin<->React 桥、kotlin-redux 框架核心、通用工具模块）→ Kotlin生态库；其余游戏业务逻辑（客户端、协议编解码、模型注册、UI/HUD、战斗、资源、音频、埋点、游戏引擎、启动入口）→ 游戏本体。规则表已写死为显式 id 列表，126 个模块全部命中、无默认兜底。
- **Anchors**：优先取字符串字面量（长度 3~90，滤掉 HTML/CSS 噪声词与纯符号/数字串，CSS 函数名如 `image-set(` 保留），按 `跨模块出现次数`（仅 1 个模块出现 +4、≤3 个 +2、>40 个 -4）+ `错误信息关键词`（not found / exception / invalid / failed / unknown 等 +5）+ `camelCase 标识符`（+4）打分取前 5；**字面量不足 3 个时**用该模块内出现次数少的高辨识度标识符（导出名 / 属性名，如 `getPositions`、`createRoot`）补齐，纯转发模块补转发目标 `i(<id>)`。仍有 6 个模块（17323、19074、29545、31584、58309、99295）没有任何可用锚点，其 `Anchors` 为空数组（不编造）。
- **顶层类/函数**：统计最浅缩进层的 `function NAME(` 声明（Kotlin/JS 产物会把函数声明提升到同一层）；名称首字母大写计入 TopLevelClasses（Kotlin 类名 PascalCase，压缩后仍有大写开头，如 71105 中可见 `ResourceBatchLoadException`），其余计入 TopLevelFunctions。这是启发式口径，非精确语义。

### 1.2 代码量分布（按字节 Top 20）

| # | 模块 | 字节 | KB | Kind |
|---|---|---|---|---|
| 1 | `module_82347` | 5498676 | 5370 | 游戏本体 |
| 2 | `module_87072` | 3775340 | 3687 | 游戏本体 |
| 3 | `module_10032` | 1536764 | 1501 | 游戏本体 |
| 4 | `module_85183` | 1176860 | 1149 | 游戏本体 |
| 5 | `module_92980` | 822309 | 803.0 | 游戏本体 |
| 6 | `module_47243` | 534291 | 521.8 | 游戏本体 |
| 7 | `module_71105` | 372886 | 364.1 | 游戏本体 |
| 8 | `module_21300` | 355930 | 347.6 | 游戏本体 |
| 9 | `module_37036` | 347491 | 339.3 | Kotlin生态库 |
| 10 | `module_18334` | 303005 | 295.9 | 游戏本体 |
| 11 | `module_70130` | 293925 | 287.0 | 游戏本体 |
| 12 | `module_85196` | 235678 | 230.2 | 游戏本体 |
| 13 | `module_45555` | 224856 | 219.6 | 第三方库 |
| 14 | `module_36659` | 182712 | 178.4 | 游戏本体 |
| 15 | `module_63383` | 177741 | 173.6 | Kotlin生态库 |
| 16 | `module_55088` | 148469 | 145.0 | 游戏本体 |
| 17 | `module_52943` | 145059 | 141.7 | Kotlin生态库 |
| 18 | `module_3569` | 141181 | 137.9 | 游戏本体 |
| 19 | `module_9539` | 131066 | 128.0 | Kotlin生态库 |
| 20 | `module_30285` | 123696 | 120.8 | 第三方库 |

## 2. 依赖图摘要

### 2.1 入度 Top 15（被最多模块依赖）

| 模块 | 入度 | Kind | 职责 |
|---|---|---|---|
| `module_37036` | 59 | Kotlin生态库 | Kotlin/JS 标准库（kotlin-stdlib-js）的运行时核心模块 |
| `module_52943` | 39 | Kotlin生态库 | 网页游戏/应用底层工具库，认设备，管键盘，翻译，报错，调用浏览器本地存储，服务管理 |
| `module_61860` | 24 | 游戏本体 | 网络连接与游戏对象模型的核心模块，Kotlin/JS 编译产物。它把客户端和服务端连接起来，并管理游戏对象的生命周期。 |
| `module_24635` | 24 | Kotlin生态库 | Kotlin/JS 二进制序列化/反序列化（Protocol Buffer 风格）编解码框架 |
| `module_32088` | 18 | 游戏本体 | Alternativa3D，3D 数学库，用 Kotlin 编写 |
| `module_71105` | 15 | 游戏本体 | 游戏资源加载系统（Resource Loader） |
| `module_89613` | 15 | Kotlin生态库 | Kotlin Coroutines (kotlinx.coroutines) 核心基础设施的 JS 移植版 |
| `module_31908` | 12 | 游戏本体 | 游戏战斗（Battle）域的协议编解码模块 |
| `module_92980` | 11 | 游戏本体 | 使用 WebGL 技术开发的3D 游戏引擎或大型 3D 交互应用的渲染核心模块 |
| `module_7552` | 10 | 第三方库 | 转发实现 |
| `module_85196` | 8 | 游戏本体 | 游戏车库（Garage）系统的协议编解码模块，属于同一个坦克对战类游戏。它负责定义和注册与“车库/装备/商店”相关的网络协议消息的二进制编解码器。 |
| `module_3569` | 8 | 游戏本体 | 游戏客户端的输入与坦克预览模块 |
| `module_85667` | 8 | 游戏本体 | 客户端协议编解码模块 |
| `module_88693` | 8 | 游戏本体 | 网络协议与数据模型层的实现，主要负责处理客户端与服务器之间关于社交、好友、举报、通知权限等非战斗数据的序列化与反序列化，并管理相关的网络路由和回调。 |
| `module_10849` | 8 | Kotlin生态库 | Kotlin/JS 编译后的 Redux 状态管理框架核心模块 |

### 2.2 出度 Top 15（依赖最多模块）

| 模块 | 出度 | Kind | 职责 |
|---|---|---|---|
| `module_82347` | 46 | 游戏本体 | 负责注册大厅、车库、商店、部落、战斗结算等几乎所有核心 UI 界面的组件样式与逻辑。 |
| `module_13431` | 46 | 游戏本体 | Kotlin/JS 编译后的游戏客户端启动入口模块，负责整个游戏的初始化、渲染和启动流程。 |
| `module_18334` | 28 | 游戏本体 | 游戏客户端的总装配/依赖注入模块 |
| `module_10032` | 25 | 游戏本体 | 游戏客户端核心 Redux 状态管理模块。Redux 架构 |
| `module_87072` | 24 | 游戏本体 | 战斗系统，底盘与物理系统，战斗模式，物品池和特效系统，空投与补给系统，地图与场景渲染 |
| `module_21300` | 19 | 游戏本体 | Kotlin/JS 游戏战斗内 HUD（战斗界面）与用户交互系统 |
| `module_70130` | 19 | 游戏本体 | 游戏战斗场景（Battle）的模型注册与初始化模块 |
| `module_71105` | 16 | 游戏本体 | 游戏资源加载系统（Resource Loader） |
| `module_84441` | 13 | 第三方库 | 负责把文本数据编码成 QR 码的模块矩阵。qrcode 库 |
| `module_47243` | 11 | 游戏本体 | 游戏客户端"面板（Panel）系统"的协议编解码模块，用 Kotlin 编写。它是整个项目中最大的协议模块之一，定义了面板 UI 相关的所有枚举、数据类、编解码器。 |
| `module_52943` | 9 | Kotlin生态库 | 网页游戏/应用底层工具库，认设备，管键盘，翻译，报错，调用浏览器本地存储，服务管理 |
| `module_24923` | 9 | Kotlin生态库 | CSS-in-JS 样式引擎（类似 styled-components / Emotion / Stitches 的实现），用 Kotlin 编写并编译成 JS。它负责在运行时动态生成、管理和注入 CSS，支持 React 组件样式、主题、媒体查询、动画等。 |
| `module_57128` | 9 | 游戏本体 | UI 交互与触控/鼠标手势处理模块 |
| `module_85183` | 8 | 游戏本体 | 定义并注册游戏中各种网络协议消息的编解码器（Codec），用于在客户端与服务器之间序列化/反序列化数据。 |
| `module_3569` | 8 | 游戏本体 | 游戏客户端的输入与坦克预览模块 |

### 2.3 叶子模块（无出度，共 29 个）

其中属于游戏本体的（1 个）：`module_26482`

其余叶子模块：`module_905`(第三方库)、`module_7793`(第三方库)、`module_13532`(第三方库)、`module_14766`(第三方库)、`module_15330`(第三方库)、`module_17259`(第三方库)、`module_17323`(第三方库)、`module_19074`(第三方库)、`module_21973`(第三方库)、`module_27736`(第三方库)、`module_29545`(第三方库)、`module_31509`(第三方库)、`module_31584`(Kotlin生态库)、`module_37036`(Kotlin生态库)、`module_38335`(第三方库)、`module_43319`(第三方库)、`module_44794`(第三方库)、`module_55920`(第三方库)、`module_57328`(第三方库)、`module_64280`(第三方库)、`module_66610`(第三方库)、`module_76074`(第三方库)、`module_77672`(第三方库)、`module_78231`(第三方库)、`module_78931`(第三方库)、`module_79763`(第三方库)、`module_94965`(Kotlin生态库)、`module_99295`(第三方库)

### 2.4 孤立模块（既不被依赖也不依赖别人，共 3 个）

- `module_26482`（0.7 KB，游戏本体）Service Worker 注册模块
- `module_76074`（1.4 KB，第三方库）Yandex Metrica（俄版 Google Analytics）的集成模块，用于加载分析脚本并暴露事件上报接口。
- `module_78231`（5.2 KB，第三方库）WebView JavaScript Bridge 的加载与实现模块，用于原生 App（iOS/Android）与网页之间的双向通信。

## 3. 游戏本体模块逐条（40 个）

### `module_82347`（5370 KB）
- 职责：负责注册大厅、车库、商店、部落、战斗结算等几乎所有核心 UI 界面的组件样式与逻辑。
- 依赖的模块：`59411`, `7552`, `40293`, `28485`, `1901`, `14766`, `37036`, `52943`, `59131`, `90875`, `24923`, `61860`, `10032`, `57128`, `18334`, …（共 46 个）
- 顶层类 / 其它顶层函数：5256 / 5656
- 锚点：`imageBackgroundMessageError`、`getDerivedStateFromError`、`commonBlockMessageError`

### `module_87072`（3687 KB）
- 职责：战斗系统，底盘与物理系统，战斗模式，物品池和特效系统，空投与补给系统，地图与场景渲染
- 依赖的模块：`37036`, `52943`, `61860`, `24635`, `85183`, `61378`, `10032`, `10849`, `32088`, `31908`, `72834`, `55088`, `3569`, `92980`, `97556`, …（共 24 个）
- 顶层类 / 其它顶层函数：3094 / 3327
- 锚点：`Invalid weapon effect timings`、`Mesh texture not found`、`Invalid supply type `

### `module_10032`（1501 KB）
- 职责：游戏客户端核心 Redux 状态管理模块。Redux 架构
- 依赖的模块：`37036`, `10849`, `9539`, `52943`, `61430`, `31908`, `89803`, `47243`, `85667`, `88693`, `54199`, `41164`, `99527`, `85196`, `31584`, …（共 25 个）
- 顶层类 / 其它顶层函数：1100 / 1196
- 锚点：`FPS seems awful but cannot decrease the settings`、`Not found params for property `、`Unexpected response status `

### `module_85183`（1149 KB）
- 职责：定义并注册游戏中各种网络协议消息的编解码器（Codec），用于在客户端与服务器之间序列化/反序列化数据。
- 依赖的模块：`37036`, `24635`, `71105`, `61860`, `31908`, `32088`, `85196`, `52943`
- 顶层类 / 其它顶层函数：1164 / 1241
- 锚点：`pointCaptureStartNegativeSound`、`pointCaptureStartPositiveSound`、`pointCaptureStopNegativeSound`

### `module_92980`（803.0 KB）
- 职责：使用 WebGL 技术开发的3D 游戏引擎或大型 3D 交互应用的渲染核心模块
- 依赖的模块：`52943`, `37036`, `32088`, `97556`, `72834`, `9345`
- 顶层类 / 其它顶层函数：494 / 534
- 锚点：`Cannot use default vertex array object`、`Cannot create empty LodGroup`、`Cannot remove last layout`

### `module_47243`（521.8 KB）
- 职责：游戏客户端"面板（Panel）系统"的协议编解码模块，用 Kotlin 编写。它是整个项目中最大的协议模块之一，定义了面板 UI 相关的所有枚举、数据类、编解码器。
- 依赖的模块：`37036`, `24635`, `71105`, `31908`, `52943`, `25377`, `85196`, `85667`, `61860`, `88693`, `99527`
- 顶层类 / 其它顶层函数：605 / 643
- 锚点：`disabledNotificationTypes`、`expireActiveTimeRewards`、`expireRewardTimeRewards`

### `module_71105`（364.1 KB）
- 职责：游戏资源加载系统（Resource Loader）
- 依赖的模块：`37036`, `9539`, `89613`, `52943`, `61860`, `24635`, `9345`, `92980`, `32088`, `72834`, `16100`, `61430`, `36734`, `97556`, `7426`, …（共 16 个）
- 顶层类 / 其它顶层函数：226 / 250
- 锚点：`Unexpected 3D file format for `、`Invalid file extension `、`Unknown resource type `

### `module_21300`（347.6 KB）
- 职责：Kotlin/JS 游戏战斗内 HUD（战斗界面）与用户交互系统
- 依赖的模块：`7552`, `36659`, `82347`, `37036`, `24923`, `3569`, `10032`, `59131`, `52943`, `63383`, `10849`, `7426`, `90875`, `41164`, `31908`, …（共 19 个）
- 顶层类 / 其它顶层函数：348 / 385
- 锚点：`containerUserNickNameClanTag`、`commonContainerIconOptions`、`inputContainerSpectators`

### `module_18334`（295.9 KB）
- 职责：游戏客户端的总装配/依赖注入模块
- 依赖的模块：`37036`, `37504`, `10849`, `52943`, `10032`, `61860`, `47243`, `85667`, `88693`, `10283`, `85196`, `32088`, `3569`, `71105`, `99527`, …（共 28 个）
- 顶层类 / 其它顶层函数：237 / 266
- 锚点：`vkInitFailed`、`initError`、`Cannot find SteamAPI for SteamPaymentModel`

### `module_70130`（287.0 KB）
- 职责：游戏战斗场景（Battle）的模型注册与初始化模块
- 依赖的模块：`37036`, `52943`, `61860`, `87072`, `10032`, `92980`, `61378`, `31908`, `85183`, `10849`, `3569`, `36734`, `97556`, `32088`, `71105`, …（共 19 个）
- 顶层类 / 其它顶层函数：260 / 280
- 锚点：`onGrahpicsSettingsChange`、`onBattleSettingsChange`、`lightingEffectService`

### `module_85196`（230.2 KB）
- 职责：游戏车库（Garage）系统的协议编解码模块，属于同一个坦克对战类游戏。它负责定义和注册与“车库/装备/商店”相关的网络协议消息的二进制编解码器。
- 依赖的模块：`37036`, `24635`, `71105`, `85667`, `32088`, `61860`, `52943`
- 顶层类 / 其它顶层函数：312 / 342
- 锚点：`staticCollisionBoxes`、`mainCollisionBox`、`skyboxFrontSide`

### `module_36659`（178.4 KB）
- 职责：游戏客户端的纹理/资源注册与加载系统
- 依赖的模块：`37036`, `89613`, `52943`, `92980`, `71105`
- 顶层类 / 其它顶层函数：292 / 319
- 锚点：`desktopHudNuclearRechargeFlashBackground`、`deviceFasterHorizontalTrackingRailgun`、`deviceFasterHorizontalTrackingVulcan`

### `module_55088`（145.0 KB）
- 职责：物理引擎与碰撞检测系统，同样是 Kotlin/JS 编译产物。
- 依赖的模块：`32088`, `37036`, `52943`
- 顶层类 / 其它顶层函数：105 / 112
- 锚点：`Bound box size is zero`、`Negative mass`、`Level `

### `module_3569`（137.9 KB）
- 职责：游戏客户端的输入与坦克预览模块
- 依赖的模块：`37036`, `32088`, `52943`, `92980`, `9345`, `55088`, `97556`, `7426`
- 顶层类 / 其它顶层函数：130 / 133
- 锚点：`onPointerLockError`、`Cannot get free screen pointer!`、`Cannot find parent`

### `module_37504`（104.5 KB）
- 职责：游戏客户端"氏族（Clan）系统"的协议编解码模块，用 Kotlin 编写
- 依赖的模块：`37036`, `24635`, `52943`, `61860`
- 顶层类 / 其它顶层函数：103 / 110
- 锚点：`Enum item not found for code `、`modelRegistry`、`modelService`

### `module_61378`（92.7 KB）
- 职责：游戏世界（World）与实体-组件系统（ECS）的核心模块
- 依赖的模块：`37036`, `52943`, `92980`, `3569`, `32088`, `55088`, `89613`, `97556`
- 顶层类 / 其它顶层函数：66 / 73
- 锚点：`World.addGameEffect cannot add effect during update.`、`Cannot remove all while dispatching`、`Cannot dispose while dispatching`

### `module_10283`（91.4 KB）
- 职责：Kotlin/JS 编译后的协议模型注册模块
- 依赖的模块：`37036`, `24635`, `71105`, `52943`, `61860`, `67222`
- 顶层类 / 其它顶层函数：77 / 82
- 锚点：`proBattlesLimitSound`、`socialNetworkParams`、`entranceBackgrounds`

### `module_97675`（90.0 KB）
- 职责：WebView JS‑Native 双向通信桥（Bridge）
- 依赖的模块：`37036`, `52943`, `61430`, `9539`, `89613`
- 顶层类 / 其它顶层函数：30 / 53
- 锚点：`Invalid result structure`、`checkUnfinishedPurchases`、`finishVerifiedPurchase`

### `module_89803`（85.1 KB）
- 职责：游戏/应用中用于处理“匹配系统”和“对战大厅”网络通信和数据序列化的核心代码库。
- 依赖的模块：`37036`, `24635`, `31908`, `61860`, `71105`, `85667`, `52943`
- 顶层类 / 其它顶层函数：78 / 91
- 锚点：`matchmakingModeRanks`、`optionsDefaults`、`supportedModes`

### `module_85667`（80.6 KB）
- 职责：客户端协议编解码模块
- 依赖的模块：`37036`, `24635`, `71105`, `52943`, `61860`
- 顶层类 / 其它顶层函数：143 / 141
- 锚点：`browserExtensionsToDetect`、`stateWithCaptcha`、`clientKey`

### `module_32088`（79.7 KB）
- 职责：Alternativa3D，3D 数学库，用 Kotlin 编写
- 依赖的模块：`37036`, `9539`
- 顶层类 / 其它顶层函数：26 / 35
- 锚点：`Failed requirement.`、` +
          this.z1z_1 +
          `、` +
          this.a20_1 +
          `

### `module_31908`（77.2 KB）
- 职责：游戏战斗（Battle）域的协议编解码模块
- 依赖的模块：`37036`, `24635`, `88693`, `52943`, `61860`
- 顶层类 / 其它顶层函数：104 / 110
- 锚点：`experiencePremiumBonusByActions`、`suspiciousByIpUserIds`、`suspiciousUserIds`

### `module_61860`（74.9 KB）
- 职责：网络连接与游戏对象模型的核心模块，Kotlin/JS 编译产物。它把客户端和服务端连接起来，并管理游戏对象的生命周期。
- 依赖的模块：`24635`, `37036`, `52943`, `32088`, `72834`, `89613`, `61430`, `9539`
- 顶层类 / 其它顶层函数：69 / 72
- 锚点：`Constructor codec not found for model `、`Param config-template not found in url`、`Config load exception with status `

### `module_9345`（69.5 KB）
- 职责：A3D 二进制 3D 模型格式 的完整解析器
- 依赖的模块：`37036`, `72834`, `32088`, `97556`
- 顶层类 / 其它顶层函数：52 / 68
- 锚点：`Unknown attribute type id `、`Unknown attribute type `、` not found `

### `module_89679`（58.4 KB）
- 职责：集成 Google Play 计费 API
- 依赖的模块：`89613`, `10032`, `37036`, `52943`, `97675`, `10849`, `56077`, `47243`
- 顶层类 / 其它顶层函数：32 / 32
- 锚点：`Failed to complete payment response with fail`、`API not supported in this browser context`、`Unknown BridgeBillingService shop type`

### `module_16100`（57.0 KB）
- 职责：Kotlin/JS 编译后的战斗地图（BattleMap）协议模型注册模块
- 依赖的模块：`37036`, `24635`, `52943`
- 顶层类 / 其它顶层函数：74 / 82
- 锚点：`collisionGeometryOutsideGamingZone`、`collisionGeometry`、`textureParameter`

### `module_25377`（52.7 KB）
- 职责：游戏客户端与服务器之间的"通知/事件"协议编解码层，用 Kotlin 编写。它基于模块 24635 的二进制编解码框架，定义了所有服务器→客户端的通知消息类型及其序列化格式。
- 依赖的模块：`37036`, `24635`, `31908`, `52943`, `61860`, `85667`, `99527`
- 顶层类 / 其它顶层函数：61 / 69
- 锚点：`Enum item not found for code `、`wsProto`、`modelRegistry`

### `module_13431`（46.6 KB）
- 职责：Kotlin/JS 编译后的游戏客户端启动入口模块，负责整个游戏的初始化、渲染和启动流程。
- 依赖的模块：`30285`, `81886`, `37036`, `82347`, `21300`, `10032`, `89613`, `41164`, `52943`, `7426`, `3569`, `92980`, `10849`, `97675`, `61860`, …（共 46 个）
- 顶层类 / 其它顶层函数：44 / 38
- 锚点：`onVisibilityChanged`、`lockScreenLandscape`、`requestFullscreen`

### `module_36734`（40.5 KB）
- 职责：游戏客户端的音频系统，用 Kotlin 编写。它基于 Web Audio API 实现了完整的音效播放引擎，包括：音频解码、声道管理、优先级调度、3D 空间音效、音量/静音控制、分组增益
- 依赖的模块：`37036`, `32088`, `52943`, `89613`, `7426`
- 顶层类 / 其它顶层函数：35 / 26
- 锚点：`audioContextService`、`onChannelRecycled`、`effectiveGain`

### `module_54199`（39.8 KB）
- 职责：游戏聊天系统的网络协议编解码模块
- 依赖的模块：`37036`, `24635`, `88693`, `52943`, `61860`
- 顶层类 / 其它顶层函数：37 / 54
- 锚点：`linksWhiteList`、`battleIdHex`、`battleLinks`

### `module_88693`（34.3 KB）
- 职责：网络协议与数据模型层的实现，主要负责处理客户端与服务器之间关于社交、好友、举报、通知权限等非战斗数据的序列化与反序列化，并管理相关的网络路由和回调。
- 依赖的模块：`37036`, `24635`, `52943`, `61860`
- 顶层类 / 其它顶层函数：27 / 49
- 锚点：`Enum item not found for code `、`No enum constant projects.tanks.multiplatform.users.model.keys.KeyTypeEnum.`、`modelRegistry`

### `module_1510`（30.9 KB）
- 职责：库Kotlin/JS 编译的支付/交易协议处理器模块
- 依赖的模块：`37036`, `24635`, `52943`, `61860`
- 顶层类 / 其它顶层函数：31 / 47
- 锚点：`questToAchievementMap`、`itemIdMap`、`Enum item not found for code `

### `module_57128`（29.9 KB）
- 职责：UI 交互与触控/鼠标手势处理模块
- 依赖的模块：`14766`, `32088`, `37036`, `52943`, `31908`, `92980`, `71105`, `7426`, `59131`
- 顶层类 / 其它顶层函数：26 / 13
- 锚点：`Not found icon for `、`getBattleModeLocalizedShortName`、`intertialScroll`

### `module_45686`（15.0 KB）
- 职责：游戏客户端的模型注册与空间（Space）加载系统，用 Kotlin 编写。它负责把服务器下发的模型数据注册到客户端的模型注册表中，并管理"空间"（游戏场景/实例）的加载与切换。
- 依赖的模块：`37036`, `61860`, `29554`, `52943`, `71105`, `24635`
- 顶层类 / 其它顶层函数：3 / 24
- 锚点：`onError`、`gameTypeRegistry`、`modelRegister`

### `module_41164`（13.2 KB）
- 职责：游戏客户端的分析（Analytics）与埋点系统，用 Kotlin 编写。它负责向多个分析平台（Google Analytics、Yandex Metrica、自有分析服务）上报用户行为事件，包括登录、注册、战斗开始、购买、教程进度等。
- 依赖的模块：`37036`, `61430`, `97675`, `52943`
- 顶层类 / 其它顶层函数：8 / 22
- 锚点：`currencyCode`、`ecommerce`、`substage`

### `module_99527`（10.9 KB）
- 职责：Protobuf媒体编解码器 + 时间周期配置 + 参数校验
- 依赖的模块：`37036`, `24635`, `52943`, `61860`
- 顶层类 / 其它顶层函数：20 / 11
- 锚点：`FORBIDDEN`、`Enum item not found for code `、`modelRegistry`

### `module_29554`（9.7 KB）
- 职责：游戏客户端的模型/对象数据加载协议编解码模块
- 依赖的模块：`37036`, `24635`, `61860`, `71105`, `52943`
- 顶层类 / 其它顶层函数：18 / 0
- 锚点：`modelsData`、`modelService`、`_loadDependencies_dependenciesCodec`

### `module_67222`（8.1 KB）
- 职责：社交网络登录与账号绑定的网络协议模块
- 依赖的模块：`37036`, `24635`, `52943`, `61860`
- 顶层类 / 其它顶层函数：19 / 2
- 锚点：`failedRedirectUrl`、`codec_failedRedirectUrl`、`Enum item not found for code `

### `module_85745`（4.0 KB）
- 职责：资源图片帧动画相关的网络序列化 / 反序列化
- 依赖的模块：`37036`, `24635`, `52943`
- 顶层类 / 其它顶层函数：5 / 2
- 锚点：`Enum item not found for code `、` +
                  this.y1we_1 +
                  `、` +
                this.z1we_1 +
                `

### `module_26482`（0.7 KB）
- 职责：Service Worker 注册模块
- 依赖的模块：无（DependsOn 为空）
- 顶层类 / 其它顶层函数：0 / 0
- 锚点：`serviceWorker`、`SW registration failed: `、`manifest`

## 4. 依赖层次（由 DependsOn 计算，非手工绘制）

Level 定义：无依赖 = Level 0，否则 = 1 + 依赖的最大 Level（存在少量循环依赖，回边被递归守卫截断，取近似最长链）。

- **Level 0**（29 个）：游戏本体 1 个（`26482`）；Kotlin生态库/第三方库 28 个
- **Level 1**（24 个）：游戏本体 0 个；Kotlin生态库/第三方库 24 个
- **Level 2**（16 个）：游戏本体 1 个（`32088`）；Kotlin生态库/第三方库 15 个
- **Level 3**（10 个）：游戏本体 0 个；Kotlin生态库/第三方库 10 个
- **Level 4**（5 个）：游戏本体 1 个（`9345`）；Kotlin生态库/第三方库 4 个
- **Level 5**（3 个）：游戏本体 0 个；Kotlin生态库/第三方库 3 个
- **Level 6**（5 个）：游戏本体 4 个（`92980`、`55088`、`97675`、`36734`）；Kotlin生态库/第三方库 1 个
- **Level 7**（5 个）：游戏本体 5 个（`3569`、`61860`、`16100`、`41164`、`85745`）；Kotlin生态库/第三方库 0 个
- **Level 8**（8 个）：游戏本体 7 个（`71105`、`37504`、`61378`、`88693`、`1510`、`99527`、`67222`）；Kotlin生态库/第三方库 1 个
- **Level 9**（6 个）：游戏本体 6 个（`36659`、`10283`、`85667`、`31908`、`54199`、`29554`）；Kotlin生态库/第三方库 0 个
- **Level 10**（5 个）：游戏本体 5 个（`85196`、`89803`、`25377`、`57128`、`45686`）；Kotlin生态库/第三方库 0 个
- **Level 11**（2 个）：游戏本体 2 个（`85183`、`47243`）；Kotlin生态库/第三方库 0 个
- **Level 12**（1 个）：游戏本体 1 个（`10032`）；Kotlin生态库/第三方库 0 个
- **Level 13**（2 个）：游戏本体 2 个（`87072`、`89679`）；Kotlin生态库/第三方库 0 个
- **Level 14**（1 个）：游戏本体 1 个（`18334`）；Kotlin生态库/第三方库 0 个
- **Level 15**（2 个）：游戏本体 2 个（`82347`、`70130`）；Kotlin生态库/第三方库 0 个
- **Level 16**（1 个）：游戏本体 1 个（`21300`）；Kotlin生态库/第三方库 0 个
- **Level 17**（1 个）：游戏本体 1 个（`13431`）；Kotlin生态库/第三方库 0 个

### 4.1 骨架图（Mermaid，节点 = 入度最高的 12 个游戏本体模块 + 入口 `13431`/装配 `18334`，边取自 DependsOn 且两端都在节点集内）

```mermaid
graph LR
  N61860["61860"]
  N32088["32088"]
  N71105["71105"]
  N31908["31908"]
  N92980["92980"]
  N3569["3569"]
  N85196["85196"]
  N85667["85667"]
  N88693["88693"]
  N10032["10032"]
  N36734["36734"]
  N36659["36659"]
  N13431["13431"]
  N18334["18334"]
  N61860 --> N32088
  N71105 --> N61860
  N71105 --> N92980
  N71105 --> N32088
  N71105 --> N36734
  N31908 --> N88693
  N31908 --> N61860
  N92980 --> N32088
  N3569 --> N32088
  N3569 --> N92980
  N85196 --> N71105
  N85196 --> N85667
  N85196 --> N32088
  N85196 --> N61860
  N85667 --> N71105
  N85667 --> N61860
  N88693 --> N61860
  N10032 --> N31908
  N10032 --> N85667
  N10032 --> N88693
  N10032 --> N85196
  N10032 --> N32088
  N10032 --> N3569
  N10032 --> N36659
  N10032 --> N92980
  N10032 --> N36734
  N10032 --> N61860
  N36734 --> N32088
  N36659 --> N92980
  N36659 --> N71105
  N13431 --> N10032
  N13431 --> N3569
  N13431 --> N92980
  N13431 --> N61860
  N13431 --> N31908
  N13431 --> N85667
  N13431 --> N88693
  N13431 --> N85196
  N13431 --> N36734
  N13431 --> N71105
  N13431 --> N18334
  N13431 --> N36659
  N18334 --> N10032
  N18334 --> N61860
  N18334 --> N85667
  N18334 --> N88693
  N18334 --> N85196
  N18334 --> N32088
  N18334 --> N3569
  N18334 --> N71105
  N18334 --> N92980
  N18334 --> N31908
  N18334 --> N36734
```

### 4.2 节点对照表

| 节点 | 入度 | 出度 | 职责 |
|---|---|---|---|
| `61860` | 24 | 8 | 网络连接与游戏对象模型的核心模块，Kotlin/JS 编译产物。它把客户端和服务端连接起来，并管理游戏对象的生命周期。 |
| `32088` | 18 | 2 | Alternativa3D，3D 数学库，用 Kotlin 编写 |
| `71105` | 15 | 16 | 游戏资源加载系统（Resource Loader） |
| `31908` | 12 | 5 | 游戏战斗（Battle）域的协议编解码模块 |
| `92980` | 11 | 6 | 使用 WebGL 技术开发的3D 游戏引擎或大型 3D 交互应用的渲染核心模块 |
| `3569` | 8 | 8 | 游戏客户端的输入与坦克预览模块 |
| `85196` | 8 | 7 | 游戏车库（Garage）系统的协议编解码模块，属于同一个坦克对战类游戏。它负责定义和注册与“车库/装备/商店”相关的网络协议消息的二进制编解码器。 |
| `85667` | 8 | 5 | 客户端协议编解码模块 |
| `88693` | 8 | 4 | 网络协议与数据模型层的实现，主要负责处理客户端与服务器之间关于社交、好友、举报、通知权限等非战斗数据的序列化与反序列化，并管理相关的网络路由和回调。 |
| `10032` | 7 | 25 | 游戏客户端核心 Redux 状态管理模块。Redux 架构 |
| `36734` | 7 | 5 | 游戏客户端的音频系统，用 Kotlin 编写。它基于 Web Audio API 实现了完整的音效播放引擎，包括：音频解码、声道管理、优先级调度、3D 空间音效、音量/静音控制、分组增益 |
| `36659` | 6 | 5 | 游戏客户端的纹理/资源注册与加载系统 |
| `13431` | 0 | 46 | Kotlin/JS 编译后的游戏客户端启动入口模块，负责整个游戏的初始化、渲染和启动流程。 |
| `18334` | 3 | 28 | 游戏客户端的总装配/依赖注入模块 |

## 5. 未能确认 / 需注意的点

1. **dir.file 中有两处职责与源码内容不符**（JSON 的 Duty 仍按 dir.file 原样抄录，未擅自改写）：
   - `module_96480` 标注“Underscore.js 1.13.6”，但源码是 inline-style-prefixer 的 transition 前缀插件（`Webkit`/`Moz` 分支、`-webkit-`/`-moz-` 常量）。
   - `module_94965` 标注“ReactHTML HTML 标签构建器”，但源码是两段 UMD 包裹的 underscore 实现（导出映射含 `VERSION`、`restArguments`，字面量 `1.13.6`），且没有任何 `div`/`span` 等 HTML 标签字面量。
2. 6 个模块的 `Anchors` 为空数组（源码里没有可用的稳定字面量，且没有高辨识度标识符）：17323、19074、29545、31584、58309、99295。
3. 5 个模块有 require 参数但抽不到依赖：7793、14766、17323、55920、94965。推测是 webpack 模块连接（concatenation）把 require 调用内联消除，或依赖指向资源模块 id（本调研只统计代码模块 id）。
4. DependsOn 只覆盖静态 `i(<id>)` 调用：动态取模块（55920 的 `t.require(n)`）不计入；对 `static/` 资源模块的引用也不计入。
5. 顶层类/函数是按缩进 + 首字母大写的启发式统计（`TopLevelClasses` 不等于真实 Kotlin 类数量，压缩后部分类名非 PascalCase）；Kind 中有若干边界判定（如 89679 Google Play 计费、52943 通用工具库、94965）按“代码来源 + 职责”人工定案，规则见 1.1。
6. 分层为最长依赖链的近似值：图中存在循环依赖，回边在递归中被截断，Level 仅供骨架参考。