Perseus：Azur Lane脚本补丁工具完全指南

一、项目价值解析：为何选择Perseus？

在移动游戏 mod 开发领域，内存偏移量依赖一直是开发者面临的主要挑战——游戏版本更新往往导致原有补丁失效。Perseus 作为一款专注于 Azur Lane 的脚本补丁工具，通过无偏移量依赖技术，实现了对游戏脚本的动态修改，尤其在皮肤解锁、功能扩展等场景中表现出色。

💡 核心优势：

• 版本无关性：无需因游戏更新重新计算内存偏移
• 轻量级集成：通过 JNI 接口与 Unity 游戏引擎无缝对接
• 配置灵活：支持通过 INI 文件自定义功能开关

二、技术架构解析：Perseus如何工作？

2.1 核心技术栈

• C++：底层补丁逻辑实现语言，提供高效内存操作能力
• JNI (Java Native Interface)：实现 Java 与 C++ 代码的跨语言调用，是 Android 平台原生开发的桥梁
• Android NDK：将 C++ 代码编译为 Android 可执行的.so库文件
• And64InlineHook：Android 平台的内联钩子库，用于在运行时修改目标函数
• Obfuscate：字符串混淆工具，通过加密敏感字符串提高逆向难度

2.2 工作原理

Perseus 采用三层架构设计：

1. 接口层：通过 JNI 暴露 Java 调用接口
2. 核心层：C++ 实现的补丁引擎，包含钩子管理和内存操作模块
3. 配置层：INI 文件解析模块，支持运行时功能配置

⚠️ 技术风险提示：内联钩子技术可能触发部分游戏的反作弊机制，请仅在个人设备上使用。

三、实践指南：从零开始使用Perseus

3.1 开发环境准备

必备工具：

• Android Studio Hedgehog (2023.1.1) 或更高版本
• Android NDK 25.1.8937393 或兼容版本
• OpenJDK 17
• Git 2.34+

3.2 项目获取与构建

1. 克隆代码仓库

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

   ✅ 预期结果：本地生成 Perseus 项目文件夹，包含完整源码结构

2. 配置 NDK 路径

   • 打开 Android Studio → File → Project Structure → SDK Location
   • 确认 "Android NDK location" 已正确设置
   • 如未配置，点击 "Download" 自动安装兼容版本

3. 编译原生库

   cd Perseus
   ./gradlew :app:externalNativeBuildDebug
   

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

3.3 集成到 Unity 项目

1. 导入原生库

   • 将编译生成的 libPerseus.so 文件复制到 Unity 项目的 Assets/Plugins/Android/ 目录
   • 确保包含 arm64-v8a、armeabi-v7a 和 x86 三个架构版本

2. 修改 UnityPlayerActivity

   // 在 UnityPlayerActivity 类中添加
   static {
       // 加载 Perseus 原生库
       System.loadLibrary("Perseus");
   }
   
   // 声明 JNI 接口
   private static native void initialize(Context context);
   
   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       // 初始化 Perseus 引擎
       initialize(this);
   }
   

3. 创建配置文件 在设备存储根目录创建 Perseus.ini：

   [Features]
   # 启用皮肤解锁功能
   UnlockAllSkins=true
   # 启用调试日志
   DebugMode=false
   

3.4 测试与验证

1. 部署应用

   • 连接 Android 设备并启用 USB 调试
   • 在 Android Studio 中点击 "Run" 按钮部署应用

2. 验证功能

   • 启动游戏后检查皮肤列表是否完整显示
   • 查看 logcat 输出确认 Perseus 初始化信息：

     I/Perseus: Engine initialized successfully
     I/Perseus: Configuration loaded from /sdcard/Perseus.ini
     

四、常见问题与解决方案

Q1: 应用启动后崩溃，提示 "libPerseus.so not found"

A：检查以下几点：

• 确保所有架构的 .so 文件都已正确放置
• 确认 System.loadLibrary("Perseus") 调用位置正确
• 检查 AndroidManifest.xml 中是否声明了必要权限

Q2: 皮肤解锁功能不生效

A：可能原因及解决：

1. INI 文件路径错误 - 确保文件位于 /sdcard/Perseus.ini
2. 配置项名称错误 - 检查是否使用了正确的键名 "UnlockAllSkins"
3. 游戏版本不兼容 - 查看项目 README 获取支持的游戏版本信息

Q3: 编译时提示 NDK 版本不兼容

A：在 app/build.gradle 中指定兼容的 NDK 版本：

android {
    defaultConfig {
        externalNativeBuild {
            cmake {
                arguments "-DANDROID_NDK_VERSION=25.1.8937393"
            }
        }
    }
}

五、扩展阅读

• 高级配置：通过修改 INI 文件可实现更多定制化功能，完整配置项说明参见项目中的 prompt_template.md
• 源码解析：核心补丁逻辑位于项目根目录的 C++ 源文件中
• 社区支持：遇到问题可参考项目 LICENSE.md 中的联系方式获取帮助

💡 最佳实践：建议定期同步项目更新，以获取最新的兼容性修复和功能增强。在进行重大修改前，建议备份原始游戏文件和配置。