Perseus 游戏脚本补丁工具零基础上手指南

项目概览：认识 Perseus

Perseus 是一款专为 Azur Lane 游戏设计的脚本补丁工具，其核心价值在于实现了"无偏移量依赖"的游戏脚本修改技术。简单来说，它就像一把智能手术刀，能够精准定位并修改游戏中的特定功能模块，而无需知道这些模块在内存中的具体位置。这种特性使得工具具有极强的版本适应性，即使游戏进行小幅度更新，补丁依然能够正常工作。

该工具主要面向 Android 平台，采用 C++ 作为底层开发语言，最终产物为动态链接库文件。在当前项目目录中，我们可以看到针对不同 CPU 架构的预编译库：arm64-v8a/libPerseus.so（64位 ARM 架构）、armeabi-v7a/libPerseus.so（32位 ARM 架构）和x86/libPerseus.so（x86 架构），这确保了工具在各类 Android 设备上的兼容性。

核心技术解析：工具背后的"黑科技"

C++ 底层逻辑构建

💡 通俗理解：如果把 Perseus 比作一座桥梁，C++ 就是建造这座桥梁的钢筋混凝土。它负责构建整个工具的核心逻辑，确保补丁操作的高效与稳定。

专业解释：作为系统级编程语言，C++ 提供了直接操作内存和硬件的能力，这对于需要与游戏进程深度交互的补丁工具至关重要。Perseus 使用 C++ 实现了内存搜索、代码注入和功能hook等核心功能，确保在性能损耗最小的情况下完成补丁操作。

应用场景：主要用于实现跨平台的底层补丁逻辑，包括游戏函数拦截、内存数据修改和自定义功能注入等关键操作。

Java原生接口桥接技术

💡 通俗理解：这就像一座语言翻译官，让 Java 编写的 Android 应用能"听懂"C++ 编写的补丁逻辑在说什么。

专业解释：Java原生接口（JNI）是连接 Java 代码与本地代码（如 C/C++）的桥梁技术。通过 JNI，Android 应用可以加载并调用 Perseus 的 C++ 动态库，实现高级应用逻辑与底层系统操作的无缝衔接。

应用场景：在 Android 应用启动时初始化 Perseus 模块，建立 Java 层与 C++ 层的通信通道，传递应用上下文和配置参数。

Android 原生开发套件

💡 通俗理解：这是一套专为 Android 平台"定制"的 C++ 开发工具箱，让 Perseus 能更好地适应 Android 系统环境。

专业解释：Android NDK（Native Development Kit）提供了一系列工具和头文件，允许开发者使用 C/C++ 编写能在 Android 设备上运行的原生代码。Perseus 使用 NDK 编译生成适用于不同 Android 设备架构的动态库文件。

应用场景：编译跨架构的 Perseus 动态库，确保工具在各种 Android 设备上的兼容性和高效运行。

And64InlineHook 内联钩子框架

💡 通俗理解：这就像一个"代码中间人"，能够在游戏代码执行到特定位置时"插队"执行我们的补丁逻辑。

专业解释：And64InlineHook 是一个针对 ARM/ARM64 架构的内联钩子库，它允许开发者在运行时修改程序的执行流程。Perseus 使用该库拦截游戏关键函数调用，实现功能修改和扩展。

应用场景：拦截游戏的皮肤加载函数、资源验证函数等关键流程，注入自定义逻辑以实现功能解锁。

Obfuscate 字符串混淆技术

💡 通俗理解：这就像给敏感信息"穿上迷彩服"，让逆向工程师难以理解代码中的关键字符串含义。

专业解释：Obfuscate 是一种字符串加密和混淆技术，通过对代码中的敏感字符串进行加密处理，增加逆向分析的难度。Perseus 使用该技术保护关键算法和配置信息。

应用场景：保护补丁逻辑中的关键字符串，如函数名、配置项和加密密钥等，提高工具的安全性。

环境准备：打造你的开发工作站

基础软件安装清单

在开始使用 Perseus 之前，请确保你的开发环境中已安装以下工具：

• Android Studio：官方 Android 开发 IDE，用于项目管理和调试
• Android NDK：原生代码开发工具集，版本建议 r21 或更高
• Git：版本控制系统，用于获取项目代码
• JDK：Java 开发工具包，建议版本 8 或 11

环境验证步骤

📌 验证 Java 环境

java -version

预期结果：输出 Java 版本信息，如 openjdk version "1.8.0_302"

📌 验证 Android NDK 配置

ndk-build --version

预期结果：输出 NDK 版本信息，如 NDK Version: 21.4.7075529

📌 验证 Git 安装

git --version

预期结果：输出 Git 版本信息，如 git version 2.34.1

分步实施：从零开始的使用流程

第一步：获取项目代码

📌 克隆代码仓库

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

预期结果：在当前目录下创建 Perseus 文件夹，包含完整的项目代码

第二步：项目导入与配置

📌 启动 Android Studio 并导入项目

1. 打开 Android Studio
2. 选择 "Open an existing Android Studio project"
3. 导航到克隆的 Perseus 文件夹并打开

📌 配置 NDK 路径

1. 打开 "File" → "Project Structure"
2. 在 "SDK Location" 部分找到 "Android NDK location"
3. 如未配置，点击 "Download" 按钮下载并安装 NDK
4. 如已安装，点击 "Select" 按钮选择 NDK 安装目录

预期结果：Android Studio 成功加载项目，无 NDK 相关错误提示

第三步：编译项目生成库文件

📌 执行编译操作

1. 点击菜单栏 "Build" → "Make Project"
2. 等待编译完成（首次编译可能需要较长时间）

预期结果：在 app/build/intermediates/cmake/debug/obj 目录下生成各架构的 libPerseus.so 文件

第四步：集成到目标应用

📌 修改 UnityPlayerActivity 在目标 Android 项目的 UnityPlayerActivity 类中添加以下代码：

// 静态代码块，在类加载时加载 Perseus 库
static {
    // 加载名为 "Perseus" 的动态库
    System.loadLibrary("Perseus");
}

// 声明 native 方法，用于初始化 Perseus
private static native void init(Context context);

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 在 Activity 创建时初始化 Perseus，传入应用上下文
    init(this);
}

预期结果：应用能够成功加载 Perseus 库并调用初始化方法

第五步：配置 Perseus 功能

📌 创建配置文件 在游戏的外部文件目录（通常为 /sdcard/Android/data/<包名>/files/）中创建 Perseus.ini 文件：

[Settings]
; 启用皮肤解锁功能
EnableSkinsMod=true
; 启用调试日志输出
DebugMode=false
; 设置皮肤加载优先级
SkinLoadPriority=high

预期结果：Perseus 在启动时能够读取配置文件并应用相应设置

第六步：测试与验证

📌 运行应用并验证功能

1. 将设备连接到开发机或启动 Android 模拟器
2. 点击 "Run" → "Run 'app'" 启动应用
3. 观察应用是否正常启动，检查目标功能是否生效

预期结果：应用正常启动，Perseus 功能按配置文件设置生效

常见问题：解决你的实操难题

编译错误：NDK 版本不兼容

问题描述：编译时出现 NDK version not supported 错误。

解决方案：

1. 打开 app/build.gradle 文件
2. 找到 ndkVersion 配置项
3. 修改为你已安装的 NDK 版本，如 ndkVersion "21.4.7075529"
4. 重新同步项目并编译

运行时错误：库文件加载失败

问题描述：应用启动时出现 java.lang.UnsatisfiedLinkError: couldn't find "libPerseus.so" 错误。

解决方案：

1. 检查 app/build.gradle 中是否正确配置了 abiFilters

   android {
       defaultConfig {
           ndk {
               abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86'
           }
       }
   }
   

2. 确认编译产物中包含对应架构的库文件
3. 检查设备架构是否在支持列表中

功能不生效：配置文件未被正确读取

问题描述：应用启动正常，但 Perseus 功能未按配置文件执行。

解决方案：

1. 通过 adb shell 检查配置文件路径是否正确

   adb shell ls /sdcard/Android/data/<包名>/files/Perseus.ini
   

2. 确认配置文件格式正确，键值对是否使用 = 连接
3. 检查应用是否具有文件读写权限

   <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
   <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
   

进阶路线：从使用到开发

功能扩展方向

1. 新增补丁模块：学习 And64InlineHook 的高级用法，为游戏添加新的功能补丁
2. 配置系统优化：实现更灵活的配置项，支持运行时动态调整参数
3. UI 配置界面：开发图形化配置界面，替代手动编辑 ini 文件

技术提升路径

1. 深入学习 Android NDK 开发：掌握 JNI 高级特性和原生内存管理
2. 研究 ARM 汇编：理解游戏代码的底层执行逻辑，提高钩子编写精度
3. 学习逆向工程：掌握 IDA Pro 等工具，分析游戏内部结构和函数调用

社区参与方式

1. 提交 Issue 报告使用中遇到的问题
2. 参与代码审查，为项目贡献改进建议
3. 分享使用经验和功能扩展案例

通过本指南，你已经掌握了 Perseus 工具的基本使用方法和核心技术原理。随着实践的深入，你将能够充分发挥这个工具的潜力，为游戏体验带来更多可能性。记住，开源项目的成长离不开每一位使用者的贡献，期待你在使用过程中提出宝贵的改进建议！