引擎数据契约与数据驱动边界（互操作 / schema 级）
本篇回答一个常被问的问题：引擎 .so 里到底有没有"硬编码关卡数据"？游戏数据到底住在哪、 长什么样？ 结论会顺带厘清一条对 Web 化可行性 至关重要的分界线—— 哪些是"纯原生运行时"，哪些是"数据驱动"。
来源与边界（务必先读）
- 全文只到 结构 / schema / 规模 级：ELF 段大小、导出符号计数、JSON 的字段名与类型。
- 不含任何值内容：不导出反汇编、不导出角色名/台词/数值等版权数据。字段名是 schema/接口事实（等同于描述一份数据库表结构），不是受保护的表达。
- 素材来自本地只读分析仓库内既有文件（
lib/*.so、assets/**皆随反编译 APK 附带） 与项目自有代码，无反编译产物入库。
一句话结论
"关卡数据硬编码在 .so 里"基本是把位置搞混了。 .so 是客户端运行时代码本体 （渲染 / 音频 / 战斗演出 / 网络 / 下载状态机 + 静态中间件），关卡本身的数据不在里面； 真正的游戏数据分布在下载资产包、bundled 资产、服务器响应三处，且大多是干净的 JSON。 所谓"能在 .so 里找到关卡数据"，实为一个 bundled 的测试关卡 JSON （assets/…/quest/testStageData1.json，17 KB）——是资产文件、非二进制内嵌。
.so 是什么：运行时代码，不是数据库
对 lib/arm64-v8a/libmadomagi_native.so（30.5 MB，aarch64，stripped）的结构实测：
| 段 | 大小 | 说明 |
|---|---|---|
.text（代码） | ~14.4 MB | 引擎 + 游戏逻辑 + 静态链入的全部中间件 |
.rodata（只读常量） | ~2.0 MB | 格式串、字段名、资产 key、少量 ID/URL——是代码常量，不是数据库 |
.data.rel.ro / .data | ~1.0 MB | 重定位只读 / 可写数据 |
.bss | ~33 MB | 运行时零初始化，文件里无内容 |
DT_NEEDED只有系统库（libGLESv2/libEGL渲染、libOpenSLES音频、libc/m/stdc++） → Cocos2d-x + CRI ADX2 + Live2D 等中间件全部静态链入这一颗 .so，无独立中间件库。- stripped，但仍有 ~59,000 个 C++ 动态符号可见（这是项目能"按 mangled 名 hook"的前提； 内部静态函数名已抹除）。按子系统的导出符号计数（近似规模）：
| 子系统 | 符号数 | 子系统 | 符号数 |
|---|---|---|---|
| CRI ADX2 音频 | ~3700 | 任务 Quest | ~815 |
| 场景 Scene | ~2350 | 剧情 / CG | ~730 |
| Live2D Cubism | ~1350 | 扭蛋 Gacha | ~500 |
| http2 网络栈 | ~1150 | 下载 / 资源 | ~200 |
| 战斗 Battle | ~160 |
- 只读串里：JSON 字段名 ~1490、资产 key ~520、硬编码 URL 仅 4 个、
/magica/路径 17 个、 以及大量 debug/test 脚手架（含 test/debug/sample 的串 ~3350）。少量写死标识符 （如序章OP020）。这些是解析数据的代码常量，不是数据本身。
数据驱动边界（对 Web 化最关键）
把上面的符号规模与资产格局对齐，可以画出这条线：
| 面向 | 归属 | 例子 |
|---|---|---|
| 纯原生运行时（Web 化的真正壁垒） | 代码，在 .so | GLES 渲染、Cocos2d-x 场景框架、Live2D 播放器、CRI 音频引擎、战斗演出/播放器、http2 客户端、资源下载状态机 |
| 数据驱动（可绕开二进制理解） | JSON / 资产 / 服务器 | 关卡/任务定义、战斗结算、扭蛋结果、编成/账号状态、剧情脚本、master-data |
| 数据资产（原生播放器消费的素材） | 资产包 | Live2D 模型(moc3)、CRI 音频(hca/acb)、图集(plist+png)、动画(ExportJson)、着色器(vsh/fsh) |
要点：原生那颗是"播放器 / 渲染器 / 网络与下载机"，而"玩什么"（关卡、结算、剧情、编成） 是数据——大多还是服务端下发的结构化 JSON。这意味着理解游戏内容完全可以绕开 二进制，只从数据契约走（净室友好）。
"数据驱动"不等于"服务端算"
本节说的是内容定义（打什么）是数据；它不保证结算逻辑（怎么算）也在服务端。 真机流量已证实战斗结算在客户端——见下文 webData 一节的更正。
Bundled 资产格式地图
assets/ 里随包附带的基础集（下载包之外的启动/兜底/测试资产）：
assets/package/顶层分区：quest · story · movie · memoria · evolution · top · web · window · loading · startup · tap · selectURL · download · debug · live2dViewer · anotherQuest · shaders · spacer—— 一眼可见"每个游戏子系统一个目录"，含debug/live2dViewer等开发/调试分区。assets/resource/：image_native（图集/场景图）、scenario（剧情脚本）、sound_native（BGM/SE，HCA/ACB）。
按扩展名的形态（bundled 部分）：plist(Cocos 图集) ·png/jpg ·ExportJson(Cocos Studio 动画) · json(UI/数据) ·vsh/fsh(GLSL 着色器) ·js/html(WebView 前端片段)。这些格式本身多为公开 格式，可自由据其结构解析；游戏专有的取值内容留在原资产、不复制。
战斗关卡数据契约（关键实证）
那份 bundled 测试关卡 testStageData1.json（17 KB）的 schema（仅字段名/类型，无任何值）：
根 object（13 键）
├─ battleType : str # 战斗种类
├─ scenario : object # 关卡元数据
│ keys: auto, bgm, bgmBoss, cost, difficulty, missionList,
│ questType, sheetType, title, titleExtend
├─ playerList : array # 我方编成（每个元素 ~数十字段）
│ elem keys: ai, align, attack, defence, blast, charge,
│ charId, cardId, diskId, connectId, doppelId,
│ discType1..5, endMessageId, friend, helper, …
├─ waveList : array # 敌人波次
│ elem keys: boss, effect, enemyList, field
├─ artList : array # "art"=光碟/技能效果
│ elem keys: artId, code, growPoint, rate, sub, target, turn
├─ memoriaList : array # 记忆（装备）
│ elem keys: artList, cost, description, displayType, icon,
│ level, memoriaId, name, type, voice
├─ magiaList : array # 魔法（必杀）
│ elem keys: artList, description, icon, level, magiaId, name
├─ connectList : array # connect 技
├─ doppelList : array # doppel（变身）
├─ webData : object # ★ 见下
│ keys: gameUser, resultCode, userItemList,
│ userQuestBattleResultList, userStatusList
├─ isHalfSkill / continuable : bool
└─ attackAlignmentRateTable : array # 属性克制表★ 关于 webData 的推测已被证伪（更正）
webData 的键是 gameUser / resultCode / userQuestBattleResultList / userStatusList—— 这是一份服务器 API 响应的形状（战斗结算 + 玩家状态）。本篇早期版本据此推测 "战斗 = 服务端算好、客户端回放"。这个推测是错的。
真机流量的结论是战斗结算完全在客户端：服务端只在 quest/start 建档（计数器全零）、 在 quest/native/get 下发战斗定义，然后由客户端把算好的结果通过 quest/native/result/send 上报；全程无随机种子、无逐回合轨迹， 服务端无从复现或校验。
为什么形状会骗人：这些结算类字段确实存在于响应中，但它们是 "为客户端上报的结果记账"，不是"服务端算出来的战斗"。判断权威性 不能只看响应里有没有结算字段，必须看方向与时序。完整证据链、 正确判据与由此修订的路线权衡见 Web 化可行性评估 · Phase 0 结论。
WebView ↔ 引擎命令桥（98 个命令，实证）
元游戏前端（/magica/* 那套 WebView 应用）不直接操作引擎，而是通过一条命令桥 让 native 干活：播 BGM、推场景、加 Live2D、放过场动画、发本地通知……
这条桥的完整命令表就在底包里——assets/package/web/test/config.js，98 个命令码， 是 f4samurai 留下的开发测试页的一部分。旁边的 command.html / touch2.html / command.js 是能跑的测试台，逐个演示这些命令怎么调。
为什么这对 Web 化很关键
它等于一份**「要把元游戏跑进浏览器，需要用 Web 技术顶替掉的 native 能力清单」**， 而且一条不落、带官方命名。更重要的是：它是静态的、已经在我们仓库里， 不依赖任何还活着的服务器——与前端应用本身（只能从活服务器抓）性质完全不同。
线格式
JS 侧的封装（command.js 原样）：
function command(id, pram) {
var message = "game:" + id + "," + pram; // 载荷格式：game:<命令码>,<参数>
try {
webkit.messageHandlers.gameCommand.postMessage(message); // iOS 传输
} catch (e) {
alert(message);
}
}载荷是 game:<命令码>,<参数>，两端一致；传输方式两个平台不同——所以测试页里 那个 try/catch 不是防御性编程，是因为它写的是 iOS 分支。Android 侧从 smali 可读出：
| 环节 | Android 实现 |
|---|---|
| JS 可见的桥对象 | androidCommand（WebViewImpl 构造里 addJavascriptInterface(new Javascript(), "androidCommand")） |
唯一的 @JavascriptInterface 方法 | jsCallback(String)，内部 startsWith("game") 过滤 |
| 另一条传输 | mJsScheme = "game"，即导航到 game: URL 由 shouldOverrideUrlLoading 拦截 |
| 过 JNI | Java_jp_f4samurai_web_WebViewHelper_onJsCallback |
| C++ 落点 | web::WebViewImpl::onJsCallback(std::string) → web::WebViewManager::jsCallback → web::WebView::setOnJSCallback 注册的处理器 |
反向（引擎 → JS） 靠在页面里求值全局函数，native 库里能直接 strings 出调用点：
nativeCallback("GachaResult");
nativeCallback("SCENE_PUSH_EVENT_RAID");
nativeCallback("SCENE_SHOW_REWARD_EVENT_RAID");
nativeCallback("purchasePopup");
getBaseData(<json>) // 批量回传 base64 图片，供页面直接贴成背景我们的 CnvBridge 与游戏的桥是两套，不要混
补丁在游戏注册完 androidCommand 之后紧接着插入 WebViewInterceptor.installJsBridge(...)，把自己的 CnvBridge 注册上去。 两者对象名不同、互不干扰。CnvBridge 的能力与来源闸见 WebView 拦截与状态重放。
命令表
命令码按功能分段，段内留有空洞（官方预留）。以下为 config.js 原样：
数据与设备 <100（24 个）
| 码 | 名称 | 码 | 名称 |
|---|---|---|---|
1 | DATA_CLEAR_WEB_CACHE | 25 | DATA_CLOSE_APP |
2 | DATA_REMOVE_ASSET | 30 | DATA_GET_FONT |
5 | DATA_CALL_TOUCHES_BEGIN | 40 | DATA_GET_QUEST_RESULT_JSON |
6 | DATA_CALL_TOUCHES_MOVE | 50 | DATA_OPEN_URL |
7 | DATA_CALL_TOUCHES_END | 60 | DATA_GET_BASE64 |
10 | DATA_AWAKE_PURCHASE | 62 | DATA_SET_CLIPBOARD |
11 | DATA_PURCHASE_ITEM | 70 | DATA_GET_REWARD |
12 | DATA_GET_PURCHASE_STATE | 71 | DATA_DELETE_REWARD |
20 | DATA_GET_SNS_USER_ID | 90 | DATA_OPEN_EDIT_BOX |
21 | DATA_GET_APP_VERSION | 95 | DATA_GET_QUEST_REPLAY_DATA_ID |
22 | DATA_GET_DOWNLOAD_CONFIG | 96 | DATA_DELETE_QUEST_REPLAY_DATA |
23 | DATA_GET_DEVICE_INFO | 97 | DATA_GET_QUEST_REPLAY_VERSION |
音效 100–199（14 个）
| 码 | 名称 | 码 | 名称 |
|---|---|---|---|
100 | SOUND_BGM_PLAY | 111 | SOUND_SE_STOP |
101 | SOUND_BGM_STOP | 114 | SOUND_SE_SET_VOL |
102 | SOUND_BGM_RESUME | 115 | SOUND_SE_GET_VOL |
103 | SOUND_BGM_PAUSE | 120 | SOUND_VO_PLAY |
104 | SOUND_BGM_SET_VOL | 121 | SOUND_VO_STOP |
105 | SOUND_BGM_GET_VOL | 124 | SOUND_VO_SET_VOL |
110 | SOUND_SE_PLAY | 125 | SOUND_VO_GET_VO |
场景切换 200–399（24 个）
| 码 | 名称 | 码 | 名称 |
|---|---|---|---|
201 | SCENE_PUSH_WEBVIEW | 281 | SCENE_PUSH_ARENA |
202 | SCENE_POP_WEBVIEW | 282 | SCENE_POP_ARENA |
211 | SCENE_PUSH_LOADING | 291 | SCENE_PUSH_CHAT |
221 | SCENE_PUSH_DOWNLOAD | 292 | SCENE_POP_CHAT |
231 | SCENE_PUSH_GACHA | 301 | SCENE_PUSH_TOP |
241 | SCENE_PUSH_EVOLUTION | 302 | SCENE_POP_TOP |
251 | SCENE_PUSH_MEMORIA_COMPOSE | 341 | SCENE_PUSH_ANOTHER_QUEST |
261 | SCENE_PUSH_STORY | 342 | SCENE_POP_ANOTHER_QUEST |
271 | SCENE_PUSH_QUEST | 343 | SCENE_PLAY_ANOTHER_QUEST |
272 | SCENE_POP_QUEST | 351 | SCENE_PUSH_MOVIE |
275 | SCENE_PUSH_QUEST_REPLAY | 361 | SCENE_PUSH_MOVIE_CHAR |
276 | SCENE_SEND_QUEST_REPLAY_DATA | 371 | SCENE_PUSH_EVENT_TEST |
显示与演出 400–499（20 个）
| 码 | 名称 | 码 | 名称 |
|---|---|---|---|
400 | DISPLAY_SET_WEBVIEW_VISIBLE | 440 | DISPLAY_ADD_MOVIE |
410 | DISPLAY_CHANGE_BG | 450 | DISPLAY_PLAY_COMPOSE_EFFECT |
420 | DISPLAY_ADD_L2D | 451 | DISPLAY_SHOW_COMPOSE_RESULT |
421 | DISPLAY_REMOVE_L2D | 452 | DISPLAY_HIDE_COMPOSE |
422 | DISPLAY_PALY_L2D_MOTION | 460 | DISPLAY_PLAY_COMPOSE_MAGIA |
430 | DISPLAY_ADD_MINI | 465 | DISPLAY_PLAY_AWAKE_ABILITY |
431 | DISPLAY_REMOVE_MINI | 470 | DISPLAY_PLAY_NORMAL_GACHA_TOP |
432 | DISPLAY_PLAY_MINI_MOTION | 471 | DISPLAY_STOP_NORMAL_GACHA_TOP |
433 | DISPLAY_PLAY_MINI_EFFECT | 490 | DISPLAY_PLAY_MEMORIA_TOP |
434 | DISPLAY_STOP_MINI_EFFECT | 491 | DISPLAY_STOP_MEMORIA_TOP |
本地通知 500–599（10 个）
| 码 | 名称 | 码 | 名称 |
|---|---|---|---|
500 | NOTI_GET_CONF_PNOTE | 511 | NOTI_TURN_ON_WEEKLY_QUEST |
501 | NOTI_AWAKE_PNOTE | 512 | NOTI_TURN_OFF_WEEKLY_QUEST |
502 | NOTI_TURN_ON_PNOTE | 520 | NOTI_GET_CONF_AP_FULL |
503 | NOTI_TURN_OFF_PNOTE | 521 | NOTI_TURN_ON_AP_FULL |
510 | NOTI_GET_CONF_WEEKLY_QUEST | 522 | NOTI_TURN_OFF_AP_FULL |
显示与演出（续） 600+（6 个）
| 码 | 名称 | 码 | 名称 |
|---|---|---|---|
600 | DISPLAY_PLAY_FORMATION | 611 | DISPLAY_STOP_WEEKLY_QUEST_TOP |
601 | DISPLAY_STOP_FORMATION | 620 | DISPLAY_PLAY_FORMATION_ENEMY |
610 | DISPLAY_PLAY_WEEKLY_QUEST_TOP | 621 | DISPLAY_STOP_FORMATION_ENEMY |
表是底包版本的快照
这份表来自当前底包（totentanz 1.2.0_r128 / 游戏 3.1.9）的 config.js。 换底包时应重新提取比对——命令码是引擎与前端的私有约定，官方没有兼容性承诺。 提取方式：
grep -oE '^\s*[A-Z_0-9]+\s*:\s*[0-9]+' assets/package/web/test/config.js综合结论
.so= 运行时代码（渲染/音频/演出/网络/下载 + 静态中间件），不是游戏数据库；- 游戏数据是数据驱动的干净 JSON/资产，分布在下载包、bundled 资产、服务器响应三处；
- 数据驱动边界清晰：原生是"播放器"，内容是"数据"——理解内容无需碰二进制；
- 战斗结算在客户端（真机流量证实，非本篇早期推测的"服务端权威回放"）：服务端下发 定义、客户端算完上报结果。因此纯 Web 化除表现层外，还需自行重写结算引擎—— 范围有界但工作量实在，详见 Web 化可行性评估。
合规再强调
本篇只刻画结构/schema/规模。任何进一步实现都应延续净室口径：可据公开格式与自采数据契约 自行实现解析/渲染，但不得照搬引擎反编译产物，也不得再分发提取出的游戏美术/音频/文本内容。
交叉链接
- 引擎四子系统运行逻辑 → Native 引擎逻辑（互操作重建）
- 运行时 hook 如何拦这些子系统 → Native Hook 层
- 资源下载与离线包（数据从哪来） → 资源下载与离线包
- WebView 拦截与我们自己的 JS 桥 → WebView 拦截与状态重放
- WebView 前端与 API 缓存重放 → WebView 拦截与状态重放
- 战斗权威性结论与 Web 化路线 → Web 化可行性评估
- 序章重看入口的下游设计 → 序章完成后静默进主页（设计草案）