Perseus：跨平台脚本工具与无偏移量补丁技术全解析

Perseus 是一款专注于 Azur Lane 游戏的跨平台脚本补丁工具，核心功能是通过无偏移量补丁技术实现游戏脚本的动态修改，无需依赖固定内存地址即可实现皮肤解锁、功能扩展等高级操作。本文将从项目核心价值出发，深入拆解技术原理，提供零基础到进阶的环境部署方案，并详解功能配置实践与常见问题解决策略，帮助开发者快速掌握这款工具的使用与定制。

🚀 项目核心价值：重新定义游戏脚本补丁范式

Perseus 解决了传统游戏补丁工具依赖内存偏移量导致的兼容性问题，其核心价值体现在三个方面：

1. 跨平台兼容性架构

采用 C++ 作为底层实现语言，通过 JNI (Java Native Interface) 实现与 Android 系统的无缝对接，支持 arm64-v8a、armeabi-v7a、x86 等主流架构（对应项目根目录下的三个平台文件夹），确保在不同设备上的稳定运行。

2. 无偏移量补丁技术

创新采用模式匹配替代传统偏移量定位，通过分析目标函数特征实现动态挂钩，避免因游戏版本更新导致的补丁失效问题，显著降低维护成本。

3. 模块化扩展设计

支持通过 Perseus.ini 配置文件实现功能模块化开关，开发者可根据需求灵活启用皮肤解锁、功能增强等模块，无需修改核心代码。

🔧 技术原理拆解：从钩子到执行的完整链路

核心技术栈解析

Perseus 构建在四大技术支柱之上：

• Android NDK：提供 C++ 代码编译环境，生成适用于 Android 的原生库（如 libPerseus.so）
• And64InlineHook：实现 ARM/ARM64 架构下的内联钩子，用于拦截并修改游戏函数调用
• Obfuscate：字符串混淆库，通过加密关键字符串提升反逆向能力
• INI 配置系统：基于键值对的配置方案，支持运行时动态调整功能开关

JNI 调用流程可视化

Java 层                  Native 层
+----------------+      +----------------+
| UnityPlayerActivity |  |                |
| - onCreate()   |----->| Perseus_Init() |
| - init()       |<-----| Hook_Engine()  |
+----------------+      +----------------+
                             |
                             v
                        +----------------+
                        | And64InlineHook|
                        | - HookFunction |
                        +----------------+

钩子技术原理解析

1. 函数特征扫描：通过预定义的函数签名在内存中定位目标函数
2. 跳板函数生成：创建包含原始指令与自定义逻辑的中间函数
3. 内存地址重定向：修改目标函数入口地址指向跳板函数
4. 执行流程劫持：在原始函数执行前后插入补丁逻辑

📥 环境部署指南：零基础到进阶的双路径方案

新手友好模式：图形化界面操作

准备工作清单

工具名称	版本要求	获取方式
Android Studio	4.0+	官方网站下载
JDK	11+	Oracle 或 OpenJDK 分发
Git	2.30+	系统包管理器或官网

安装步骤

1. 克隆项目代码

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

   ⚠️ 注意事项：确保网络通畅，克隆过程中不要中断连接
   💡 小贴士：国内用户可配置 Git 代理加速克隆过程

2. 导入 Android Studio 项目

   • 启动 Android Studio → 选择 "Open an existing project"
   • 导航至克隆的 Perseus 文件夹并打开
   • 等待项目同步完成（首次同步可能需要下载依赖）

3. 配置 NDK 环境

   • 打开 "File → Project Structure → SDK Location"
   • 检查 "Android NDK location" 是否已配置
   • 如未配置，点击 "Download" 自动安装匹配版本 NDK

4. 编译生成库文件

   • 点击菜单栏 "Build → Make Project"
   • 编译成功后，在 app/build/intermediates/cmake/debug/obj 目录下生成各架构的 libPerseus.so

开发者进阶模式：命令行构建流程

环境要求

• 已安装 Android SDK 并配置 ANDROID_HOME 环境变量
• 已安装 NDK r21+ 并配置 NDK_HOME 环境变量

构建命令

# 进入项目目录
cd Perseus

# 创建构建目录
mkdir build && cd build

# 生成 Makefile
cmake -DCMAKE_TOOLCHAIN_FILE=$NDK_HOME/build/cmake/android.toolchain.cmake \
      -DANDROID_ABI=arm64-v8a \
      -DANDROID_PLATFORM=android-24 ..

# 编译
make -j4

⚠️ 注意事项：需根据目标设备架构修改 ANDROID_ABI 参数（arm64-v8a/armeabi-v7a/x86）
💡 小贴士：使用 -j 参数指定并行编译线程数，加速构建过程

⚙️ 功能配置实践：从基础设置到高级定制

核心配置文件解析：Perseus.ini

创建 Perseus.ini 文件并放置于游戏外部存储目录（如 /sdcard/Android/data/com.YoStarEN.AzurLane/files/），支持以下配置项：

配置项	默认值	推荐值	功能描述
EnableSkinsMod	false	true	启用皮肤解锁功能
EnableDebugLog	false	false	启用调试日志输出
HookDelayMs	1000	500	钩子初始化延迟时间（毫秒）
MaxPatchRetries	3	5	补丁应用最大重试次数

UnityPlayerActivity 集成示例

在游戏的 Unity 入口 Activity 中添加以下代码：

import android.content.Context;
import android.os.Bundle;

// 继承 UnityPlayerActivity
public class GameActivity extends com.unity3d.player.UnityPlayerActivity {
    
    // 静态代码块加载Perseus库
    static {
        try {
            // 加载编译生成的Perseus原生库
            System.loadLibrary("Perseus");
            android.util.Log.i("Perseus", "库加载成功");
        } catch (UnsatisfiedLinkError e) {
            android.util.Log.e("Perseus", "库加载失败: " + e.getMessage());
        }
    }

    // 声明JNI native方法
    private static native void init(Context context);
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        // 初始化Perseus，传入应用上下文
        init(getApplicationContext());
    }
}

⚠️ 注意事项：确保 Activity 名称与 AndroidManifest.xml 中声明的一致
💡 小贴士：通过 adb logcat | grep Perseus 命令查看初始化日志

🛠️ 常见问题解决：从编译错误到运行异常

编译阶段问题

问题1：NDK版本不兼容

症状：编译时报 undefined reference to '__android_log_print'
解决方案：在 CMakeLists.txt 中添加日志库链接

target_link_libraries(Perseus
    log  # 添加Android日志库
    android  # 添加Android原生API库
)

问题2：架构编译失败

症状：x86架构编译提示 invalid instruction
解决方案：修改 CMakeLists.txt，为x86架构添加特殊编译选项

if (${ANDROID_ABI} STREQUAL "x86")
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mssse3")
endif()

运行阶段问题

问题1：库加载失败

症状：日志显示 dlopen failed: library "libPerseus.so" not found
解决方案：

1. 检查 libs 目录是否包含对应架构的库文件
2. 在 build.gradle 中确保正确配置 abiFilters

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

问题2：钩子不生效

症状：功能未启用且无错误日志
解决方案：

1. 确认 Perseus.ini 配置文件路径正确
2. 检查游戏版本是否与当前补丁兼容
3. 启用 DebugLog 查看钩子安装状态

🌟 功能扩展建议与社区资源

功能扩展方向

1. 模块化补丁系统：将不同功能封装为独立模块，通过配置文件动态加载
2. 远程配置更新：实现配置文件的网络拉取，支持热更新补丁策略
3. UI控制面板：开发配套的设置界面，可视化调整各项参数

社区资源导航

• 官方文档：项目根目录下的 README.md 和 prompt_template.md
• 示例配置：参考 LICENSE.md 中的开源许可信息，了解二次开发规范
• 架构参考：通过分析 libPerseus.so 的导出函数，理解核心接口设计

通过本文的指南，您已掌握 Perseus 工具的核心原理与使用方法。无论是零基础入门还是高级功能定制，这款跨平台脚本工具都能为 Azur Lane 游戏的功能扩展提供强大支持。建议从简单配置开始实践，逐步深入底层原理，探索更多可能性。