AnyPS5：PS5 可执行文件移植

它在做什么

两个部件：

• relinker —— 把 PS5 的 ELF 可执行文件重链接成目标系统的原生格式
• 系统 prx 库实现 —— 提供动态链接所需的 prx

没有模拟，没有单独的运行时进程。 程序最终是原生指令直接跑在你机器上。

对照一下就明白代价：模拟器路线是「实现一整套主机行为」，这条路是「翻译这一个程序用到的那部分」。后者快、也干净，但任何游戏用到未实现的东西就会撞墙。

准备输入

用一个干净的 ELF 可执行文件。把它自带的 ELF 模块放到可执行文件旁边的 sce_module/、sce_modules/ 或 prx/ 目录里：

textsource/
    input.elf
    sce_module/
        <自带的 ELF 模块>

目录规则有两条容易踩的：

• prx/ 可以和 sce_module/ 或 sce_modules/ 其中之一共存
• sce_module/ 和 sce_modules/ 同时存在是错误；三个都不存在也是错误

转换

Linux 输出：

shrelinker source/input.elf app.elf

Windows 输出：

shrelinker --windows source/input.elf app.exe

Intel 主机（AMD 专属指令转换）加 --to-intel。

两个容易误解的点：

• 输出格式默认是 Linux ELF，跟文件名无关。光写 .exe 不会选 Windows，必须显式 --windows。
• 没有 --help 标志。 不带参数运行会打印用法语法并以错误码退出——这就是它的帮助。

选项

所有开关默认关闭。unused-filter 默认 0，--rpath 默认 $ORIGIN/libs。

关于废弃标志： --skip-sce-module、--exclude-sce-module <file>、--skip-syscall-check、--lazy-binding 都已废弃。官方明确说带着这些标志运行会极不稳定、不适合一般使用，它们只用来调试。

unused-filter 不带 --，最多给一次。未知选项和多余的位置参数都是错误。

运行目录布局

路径相对于输出可执行文件：

textapp.elf (Linux) 或 app.exe (Windows)
libs/
    *.prx
app0/
    <应用资源>
    sce_module/
        <已转换的模块>

要做三件事：把构建好的系统库从 build/core/libs/libs/*.prx 复制到 libs/（注意用为目标系统构建的那份）；把应用资源放进 app0/；relinker 会保留每个模块在 app0/ 下的目录并打印它的准确路径。

输入目录如果叫 sce_modules/ 或 prx/，对应地用它们。

Windows 上一个容易踩的坑

Windows 上直接内存（sceKernelAllocateDirectMemory，每个标题最高 13824 MiB）是在标题申请时全额提交，不是按首次使用的页提交。系统提交上限（已装内存 + 页面文件大小，也就是任务管理器「已提交」那一行的第二个值）必须和其他所有已提交内存一起覆盖它。

不够的话会抛 create direct memory backing of 0x<n> bytes (<m> MiB) 并带 Windows 错误码。解法是加大页面文件或者关掉其他应用。

运行

Linux：

shchmod +x app.elf
./app.elf

手柄与键鼠

SDL 映射的游戏手柄都支持，包括摇杆和扳机。键鼠要在 anyps5-input.ini 里配置，支持的设备和配置格式在 docs/user/INPUT_MAPPING.md。

出错时会怎样

遇到不支持或不符合预期的状态，它会严格抛 std::runtime_error，把 what() 打到 stderr 然后终止进程。

不静默降级、不假装成功。这对研究工具是正确取舍（你不会以为跑通了其实没跑），但也意味着任何未实现的系统调用都会让程序直接崩掉。

现在能跑什么

官方测试过的兼容性表目前只有一款游戏：

Linux 那一栏是官方自己标的问号。库函数和着色器的完成度在项目主页有实时徽章（boykopovar.github.io/AnyPS5），系统库那个百分比是「已声明的函数里项目已知的比例」，不是「所有 PS5 系统函数的比例」——总数会随着函数声明增加而涨。

看这个百分比要理解它的增长方式。 它衡量的是已知覆盖，不是完成度目标。

前提与边界

项目声明面向互操作性、研究、保存与兼容性用途，不包含、不分发、也不需要受版权保护的软件、固件、加密密钥或专有库。你需要自己确保手上的二进制来源合法、符合许可条款。

开发

仓库里还带了三份工程文档：docs/dev/BUILD.md（构建）、docs/dev/TechnicalDebt.md（技术债清单，53KB，是了解项目真实状态最有价值的一份）、docs/dev/CONVENTIONS.md（代码风格约定）。shader 重编译器在 core/shader/recompiler/Recompiler.cpp，能生成 SPIR-V，开 ANYPS5_ENABLE_SPIRV_TOOLS 构建时用 Spirv-Tools 校验。