极空间(com.zentraedi.zspace 2.5.653)阅读器逆向工程记录、可浏览的反编译源码,以及可复现的去壳重打包脚本。
仅用于个人学习 / 自有设备研究。仓库中的反编译代码、资源、so、dex 版权归原厂所有,请勿传播或商用。
基于 native_reader.md 的 LuaJIT FFI + C 桌面阅读器,支持 PDF / EPUB / MOBI / AZW3 / TXT,带书库、目录、进度、书签、设置、书内搜索和自动化测试。
GUI 使用 SDL2 + SDL2_ttf 直接绘制,无 WebView/Electron;页面渲染为 RGBA 纹理,事件驱动重绘,空闲不重绘,整体非常轻量。
./tools/build.sh # 编译
./tools/run.sh # 打开书库
./tools/run.sh testdata/sample.txt # 直接打开一本书
READER_LIBRARY=/path/to/books ./tools/run.sh
./tools/package.sh # 打包
./tools/install.sh # 安装到 ~/.local(含桌面图标)
# 产物:dist/native-reader-linux-x64.tar.gz安装后会创建:
-
~/.local/bin/native-reader -
~/Desktop/native-reader.desktop(桌面图标,双击启动) -
~/.local/share/applications/native-reader.desktop(应用菜单) -
~/.local/share/icons/hicolor/*/apps/native-reader.png -
图标使用 WordCard 的书本图标(
assets/icons/) -
launch.sh保证单实例;已在运行时会把窗口置前 -
书库默认扫描
~/Books/~/Downloads/book,可用READER_LIBRARY指定 -
阅读中
Esc返回书库,Q退出;S设置,T目录,B书签,/搜索,O打开新书 -
书库
Delete清除选中书的历史,Shift+Delete清空历史 -
依赖:SDL2、LuaJIT、MuPDF、libmobi、libxml2、libzip、SDL2_ttf
-
自动化:
tools/auto_core.lua、tools/auto_agent.lua、tools/auto_smoke.lua;一键回归./tools/test.sh -
外部 Agent:
reader-agent open /path/book [page](未运行会自动启动,支持dav:///smb:///sftp://)/reader-lua/automation/agent.lua -
字体:仓耳今楷02(
assets/fonts/) -
设计 / 迁移:
native_reader.md;开发规范:AGENTS.md
./build-apk.sh
# 输出:out/zspace-reader.apk依赖:zip、zipalign、apksigner、keytool,以及 Android SDK build-tools(默认 /opt/android-sdk/build-tools/34.0.0,可用 ANDROID_SDK_ROOT 覆盖)。
- 包名 / 版本与原版一致:
com.zentraedi.zspace/2.5.653 - 使用调试签名,不能覆盖官方版;需先卸载官方极空间(会丢登录 / 数据),或装到副用户 / 工作资料
- 仅支持
arm64-v8a
reader/
├── build-apk.sh # 入口,调用 tools/build-apk.sh
├── tools/
│ ├── build-apk.sh # 去壳重打包
│ ├── fixdex.py # 修 dex checksum / SHA-1
│ ├── frida/
│ │ ├── hook_sig.js # PackageManager 签名 hook
│ │ ├── libhook.js # Gadget 自动加载 + socket 回传
│ │ ├── diag.js # runtime / Java 环境诊断
│ │ ├── driver.py # attach / load / resume
│ │ └── listener.py # 宿主机 TCP 监听
│ ├── gadget/
│ │ └── CoreComponentFactory.java
│ └── stub/
│ ├── StubApp.java # 同名壳入口
│ └── NasApplication.java # 编译期占位
├── out/ # 构建产物(.gitignore)
├── reference/
│ ├── base/ # 原始 APK(.gitignore)
│ ├── app_dex/ # dump 出的真实 dex
│ ├── stub/ # StubApp 入口
│ ├── dex/ # 阅读器相关 dex
│ └── debug.keystore # 调试签名(.gitignore)
├── app/src/main/ # 反编译阅读器源码(浏览用)
│ ├── java/com/zentraedi/{reader,outreader,comic}
│ ├── java/com/zspace/mobi
│ ├── jniLibs/arm64-v8a/ # 阅读器原生库
│ ├── assets/reader/ # Office / DWG 资源
│ └── res/ # 反编译资源
└── REVERSE_ENGINEERING.md # 详细过程与工具
- 识别 360 加固:
com.stub.StubApp、assets/libjiagu_a64.so、加密的 40MBclasses.dex - 静态分析:从 manifest / 资源 / so 定位阅读器 Activity、
PageView、PDFTron / PDFium / MuPDF / libmobi / Readium - 内存脱壳:waydroid(root)+ 原签名 APK +
frida-server+frida-dexdump,dump 出真实 dex - 修复 dex:批量重算 Adler32 checksum / SHA-1
- jadx 反编译:分析格式解析与翻页实现
- 去壳重打包:去掉 360 壳,保留原
resources.arsc/res/assets/lib,加入真实 dex 与同名com.stub.StubApp入口,重新签名
详细步骤、踩坑与命令见 REVERSE_ENGINEERING.md。
| 格式 | 解析链路 |
|---|---|
PDFTron / Apryse PDFTronZReader;MuPDF PdfBitmapLoader;Tencent PDFium |
|
| EPUB | Readium 2:AssetRetriever + PublicationOpener + EpubNavigatorFragment |
| MOBI / AZW3 | MobiUtilBusiness → ZspaceMobiJni.convertToEpub(libmobi)→ EPUB |
| TXT | 自定义 PageView 编码识别与分页 |
| 漫画 | ComicEpubZReader / ComicReaderActivity |
翻页入口:com.zentraedi.reader.reader.PageView
- 右侧 1/3(
l1)→v1()下一页 - 左侧 1/3(
m1)→P1()上一页 - 中间 1/3 按上下半区分别触发上一页 / 下一页
| 脚本 | 用途 |
|---|---|
tools/fixdex.py |
批量修 dex checksum / SHA-1 |
tools/frida/hook_sig.js |
hook PackageManager 返回原始证书 |
tools/frida/libhook.js |
Gadget 自动加载 + socket 回传 |
tools/frida/diag.js |
runtime / Java 环境诊断 |
tools/frida/driver.py |
attach / load / resume |
tools/frida/listener.py |
宿主机 TCP 监听 |
tools/gadget/CoreComponentFactory.java |
appComponentFactory 注入 |
tools/stub/StubApp.java |
同名壳入口 |
tools/build-apk.sh |
去壳重打包 |
- 仓库不包含原始
base.apk和构建出的 APK(.gitignore已排除大文件) app/src/main/jniLibs/arm64-v8a/libPDFNetC.so约 50.5MB,超过 GitHub 50MB 建议值;未超 100MB 硬限制。后续大文件建议使用 Git LFS- 调试签名仅用于本地安装测试
- 反编译源码仅用于阅读分析,
app/模块不能直接编译运行