Perseus 安装配置指南：从环境搭建到功能验证的全流程解析

一、功能价值：为何选择 Perseus

核心优势：Azur Lane 脚本补丁的技术突破

Perseus 作为 Azur Lane 游戏的脚本补丁工具，其核心价值在于实现了无偏移量依赖的补丁机制。传统游戏补丁往往需要硬编码内存偏移地址，导致在游戏版本更新时频繁失效，而 Perseus 通过动态钩子技术解决了这一痛点，使补丁具备更强的版本兼容性。

应用场景：解锁游戏个性化体验

该工具主要面向两类用户：一是希望自定义游戏功能的普通玩家，如解锁皮肤、调整界面布局等；二是游戏 mod 开发者，可基于 Perseus 快速构建功能扩展模块。其轻量级设计确保对游戏性能影响极小，在主流 Android 设备上均可流畅运行。

二、技术解析：底层架构与实现原理

技术栈概览：跨语言协作的工程实践

Perseus 采用C++作为核心开发语言，通过 JNI(Java Native Interface)实现与 Android 系统的交互。项目架构包含三个关键层次：

• Native 层：基于 Android NDK 开发的核心补丁逻辑，包含内存钩子和代码注入模块
• Java 层：提供 Android 应用入口和配置管理功能
• 配置层：通过 INI 格式文件实现功能开关和参数调节

技术架构

技术选型逻辑：为何采用这些核心组件

1. C++与 NDK：选择 C++是为了追求底层操作的高效性和内存控制能力，NDK 则提供了直接访问 Android 系统底层 API 的能力，这对内存钩子功能至关重要
2. And64InlineHook：相比传统的 PLT 钩子，内联钩子能直接修改目标函数指令，实现更细粒度的代码拦截，特别适合游戏这种复杂二进制文件的 patch
3. Obfuscate 字符串混淆：游戏反作弊系统常通过特征字符串检测外挂，该库能将关键字符串动态加密，降低被检测风险

底层工作机制：补丁如何作用于游戏

Perseus 的工作流程可分为三个阶段：

1. 注入阶段：通过 UnityPlayerActivity 加载 libPerseus.so 动态库，实现代码注入
2. 钩子阶段：And64InlineHook 拦截游戏关键函数，如资源加载、UI 渲染等方法
3. 修改阶段：根据 Perseus.ini 配置，对目标函数的返回值或参数进行修改，实现功能定制

三、操作实践：从环境搭建到功能验证

阶段一：环境准备（🛠️ 开发环境配置）

基础依赖安装

1. Android Studio 配置

   • 下载并安装 Android Studio Electric Eel 或更高版本
   • 安装时勾选 "Android SDK"、"Android NDK" 和 "CMake" 组件

   注意事项：NDK 版本需选择 r23c 或兼容版本，过高版本可能导致编译兼容性问题
   

2. JDK 环境配置

   • 安装 OpenJDK 11（Android Studio 默认集成，可在 SDK Manager 中确认）
   • 验证安装：java -version 应显示 11.x 版本信息

项目获取与初始化

1. 克隆代码库：

   git clone https://gitcode.com/gh_mirrors/pers/Perseus
   

2. 项目结构解析：

   Perseus/
   ├── arm64-v8a/        # 64位ARM架构库文件
   ├── armeabi-v7a/      # 32位ARM架构库文件
   ├── x86/              # x86架构库文件
   ├── LICENSE.md        # 开源许可协议
   ├── README.md         # 项目说明文档
   └── prompt_template.md # 提示模板文件
   

验证方法

• 检查项目根目录是否包含上述文件结构
• 确认 Android Studio 能正常识别项目（无红叉错误提示）

阶段二：核心配置（🔧 项目编译与集成）

NDK 路径配置

1. 打开 Android Studio -> File -> Project Structure
2. 在 SDK Location 中设置 NDK 路径：
   • 若未安装 NDK，点击 "Download" 按钮自动安装
   • 已安装则手动指定 NDK 根目录（通常位于 SDK 目录下的 ndk/xxx 文件夹）

UnityPlayerActivity 集成

在游戏项目的 UnityPlayerActivity 中添加以下代码：

// 静态代码块加载Perseus库
static {
    System.loadLibrary("Perseus");
}

// 声明native方法
private static native void init(Context context);

// 在onCreate中初始化
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    init(this); // 初始化Perseus
}

注意事项：确保在 super.onCreate(savedInstanceState) 之后调用 init 方法，避免上下文未就绪导致的初始化失败

编译项目

1. 点击 Build -> Make Project (Ctrl+F9)
2. 编译成功后，在 app/build/intermediates/cmake/debug/obj 目录下生成各架构的 libPerseus.so

验证方法

• 检查编译输出窗口是否显示 "BUILD SUCCESSFUL"
• 确认各架构目录下是否生成 libPerseus.so 文件（大小通常在 100KB-500KB 之间）

阶段三：功能验证（✅ 配置与测试）

Perseus.ini 配置文件创建

在游戏的外部存储目录（通常为 /sdcard/Android/data/[游戏包名]/files/）创建 Perseus.ini：

[Settings]
EnableSkinsMod=true      ; 启用皮肤解锁功能
ShowDebugLog=false       ; 关闭调试日志
MaxSkinCache=50          ; 皮肤缓存最大数量

配置参数说明表

参数名	作用	取值范围	默认值
EnableSkinsMod	控制皮肤解锁功能开关	true/false	false
ShowDebugLog	是否输出调试日志	true/false	false
MaxSkinCache	皮肤资源缓存上限	10-200	50
HookDelay	钩子初始化延迟时间(ms)	0-5000	1000
PatchMode	补丁模式选择	normal/aggressive	normal

运行与测试

1. 将设备连接电脑，开启 USB 调试
2. 在 Android Studio 中点击 Run -> Run 'app'
3. 观察游戏启动过程，确认无崩溃现象

验证方法

• 游戏启动后检查是否生成日志文件（/sdcard/Perseus/log.txt）
• 尝试触发已配置功能（如皮肤解锁），验证是否生效

四、常见场景配置示例

场景一：全皮肤解锁配置

[Settings]
EnableSkinsMod=true
UnlockAllSkins=true
SkinQualityFilter=all  ; 可选: all/rare/epic/legendary

场景二：性能优化配置

[Settings]
EnableSkinsMod=true
EnableTextureCompression=true  ; 启用纹理压缩
MaxSkinCache=30               ; 减少缓存大小
HookDelay=2000                ; 延迟钩子初始化，提高启动速度

场景三：开发调试配置

[Settings]
EnableSkinsMod=true
ShowDebugLog=true
LogLevel=verbose  ; 详细日志级别
SaveHookedFunctions=true  ; 保存钩子函数列表到文件

五、故障排查速查表

问题现象	可能原因	解决方案
游戏启动崩溃	libPerseus.so 架构不匹配	确认设备架构（arm64-v8a/armeabi-v7a/x86）并使用对应库文件
功能未生效	Perseus.ini 路径错误	将配置文件移动到游戏的外部文件目录（通过 log.txt 确认正确路径）
日志文件未生成	存储权限未授予	在 AndroidManifest.xml 中添加 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
编译失败：NDK 版本错误	NDK 版本过高	在 build.gradle 中指定 ndkVersion "23.2.8568313"
钩子失效	游戏版本不兼容	检查项目 README 中的支持版本列表，或更新 Perseus 到最新版本

六、总结与扩展

Perseus 通过创新的无偏移量补丁技术，为 Azur Lane 玩家提供了灵活的功能定制方案。本文从技术原理到实际操作，详细介绍了项目的安装配置流程。开发者可基于本文所述方法，进一步扩展 Perseus 的功能，如添加新的游戏模块支持或优化钩子性能。

项目持续维护中，建议定期查看官方文档获取最新更新和功能扩展指南。对于复杂场景的定制需求，可参考源码中的 prompt_template.md 文件，了解更多高级配置技巧。