企业官网建设流程全解析

从解压Release包到游戏跑起来：AnyPS5零基础首次体验全流程

【免费下载链接】AnyPS5Tool for automatic PS5 executables porting to Linux and Windows项目地址: https://gitcode.com/GitHub_Trending/an/AnyPS5

如果你第一次听说 AnyPS5，可能已经被"不是模拟器""原生移植""60FPS"这些词绕晕了。简单说：这是一套把 PS5 可执行文件静态转换为 Linux/Windows 原生程序的工具链——没有 CPU 模拟、没有运行时进程，游戏在被 relinker 处理之后，就是以普通进程的形式跑在 PC 上的。官方验证的两款作品里，Dreaming Sarah 在 GTX 1050 Ti / i5-7500 上能稳定 60FPS，DOOM Shareware（homebrew）也已经能在 Windows 和 Linux 上进入游戏。

但"能跑"和"会跑"之间隔着一整套目录约定、命令行参数和环境变量。本文以 Release 包为起点，把从解压到进入游戏的全过程拆开，每一步都对应仓库里的真实实现。

一、解压 Release 包：先搞清你手里有什么

Release 包通常包含两个关键部分：

1. relinker 可执行文件——转换工具本体，对应仓库中的 core/relinker；
2. 预构建的系统库*.prx——即 core/libs/prx 下各库编译出的共享对象，这是游戏在主机上运行时动态链接的"系统层"。

这两样东西各司其职：relinker 负责把 PS5 ELF 重写成目标平台格式，*.prx负责提供游戏运行时需要的系统函数。转换发生在构建阶段，游戏启动后不再有任何"翻译层"。

接下来准备游戏文件。官方文档对输入目录有严格要求（见 docs/user/USAGE.md）：把干净的 ELF 可执行文件放到某个目录，并把它自带的 ELF 模块放在旁边的sce_module/、sce_modules/或prx/子目录中：

source/ input.elf sce_module/ <bundled ELF modules>

几个容易踩的坑：

• 模块目录名用sce_module、sce_modules、prx三者之一即可；prx/可以与前者共存，但sce_module和sce_modules同时出现、或者三者全无，都会直接报错；
• relinker 只处理模块目录直接内部的文件，不递归子目录；
• 打包在 SELF 容器里的模块会被视为错误；
• 如果游戏模块放在别的路径下，可以用--sce-module-path <path>指定模块目录的父目录（不是模块目录本身），支持绝对路径和相对路径。

二、relinker：一条命令完成"换壳"

转换命令的形式是：

relinker [options] <input.elf> <output>

最朴素的 Linux 输出：

relinker source/input.elf app.elf

Windows 输出则必须显式加--windows（输出格式默认是 Linux ELF，光靠.exe后缀不会自动切换，relinker 甚至会在你只写.exe时打印警告）：

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

macOS 也有对应的--macos路径（生成 x86-64 Mach-O，可在 Apple Silicon 上经 Rosetta 运行）。

关键参数怎么选

• --to-intel：PS5 的 RDNA 指令集中有部分 AMD 专用指令，Intel 主机不支持。加上这个开关后，relinker 会在转换阶段把这类指令就地改写或替换为跳转桩（trampoline），并打印Intel substitution报告；遇到无法支持的指令或不可达的转换桩则报错。如果目标是 Apple Silicon 的 Rosetta，用--to-rosetta，它会额外把 RDSEED、CLWB、RDPID 等 Rosetta 缺失的指令降级。
• unused-filter=0|1|2：控制对未使用 NID 导入的过滤强度。0全量保留（最大兼容）；1基于控制流与 GOT 访问分析过滤非 PLT 导入，保留 PLT 导入；2做严格可达性分析并压缩 PLT，体积最小但要求输入 ELF 结构严格合规。新手建议从默认的0开始，跑通后再尝试收紧。
• --registry：生成<output>.registry.json符号注册表，记录每条外部引用（NID、库名、重定位类型、偏移、调用位置），字段定义见 core/relinker/relinker/src/output/CallRegistryWriter.cpp。配合 tools/import_audit.py 可以在启动游戏之前就摸清哪些系统函数已被实现、哪些还是抛异常的空桩、哪些完全缺失——这是排错的第一利器。
• --rpath <path>：系统库搜索路径，默认$ORIGIN/libs。在 Bash/PowerShell 里要记得给$ORIGIN加引号防止 shell 展开。
• --autorun：转换成功后直接运行输出并打印退出码，方便一键验证。

完整的参数表与退出码约定（0 成功、1 参数错误、2 转换失败）都在 docs/user/USAGE.md，relinker 的入口解析逻辑在 core/relinker/cli/src/CliArgs.cpp。

落地运行时布局：libs/ 与 app0/

转换完成后，relinker 会打印出它期望的运行时布局（相对输出可执行文件）：

app.elf (Linux) 或 app.exe (Windows) libs/ *.prx app0/ <app resources> sce_module/ <converted modules>

• libs/放的是 AnyPS5 的系统库（自编译时从build/core/libs/libs/*.prx复制，Release 包则已带好），绝不是原版 PS5 的.prx。把原版 PS5 模块放进 Windows 的libs/，Windows 会试图把它当 DLL 加载，可能直接报错误 193（不是有效的 Win32 应用程序）。
• app0/放游戏资源，被转换的捆绑模块会按原目录名保留在其下，relinker 会打印每个Guest module:的确切路径，照着放即可。
• Windows 自编译的libs/还需要工具链里的libgcc_s_seh-1.dll、libstdc++-6.dll、libwinpthread-1.dll（Release 包已包含）；库加载不走PATH，系统里别处有副本也不会被使用，缺失时即使.prx文件在也会报错误 126。

Linux 上运行前记得加执行权限：

chmod +x app.elf ./app.elf

Windows 上直接.\app.exe即可。

三、输入映射：手柄即插即用，键鼠随心配置

AnyPS5 的手柄支持走 SDL 映射：能被 SDL 识别的 Xbox 系与 PlayStation 系手柄都会按标准 PS 按键布局工作，摇杆和模拟扳机原样透传，游戏运行中也可以随时插拔，取第一个被识别的手柄。Xbox 布局下 A/B/X/Y 对应 Cross/Circle/Square/Triangle，LB/RB 对应 L1/R1，LT/RT 对应模拟 L2/R2，Start 对应 Options。

没有手柄时，内置的键盘鼠标键位直接可用。默认映射定义在 core/libs/prx/libScePad/include/InputMapping.hpp，核心键位如下：

要自定义键鼠映射，在游戏可执行文件旁边创建anyps5-input.ini（或用环境变量ANYPS5_INPUT_CONFIG指定其他路径）。格式为每行一条Action = Type:Value，动作名不区分大小写，#或;开头是注释；某动作的第一行会替换其内置绑定，后续行追加备用输入。比如把 Cross 改成 F 或空格、把左摇杆搬到 IJKL：

Cross = KEY:F Cross = KEY:Space LeftStickLeft = KEY:J LeftStickRight = KEY:L LeftStickUp = KEY:I LeftStickDown = KEY:K Square = MOUSE:Left R2 = MOUSE:Right ToggleMouse = MOUSE:Middle

支持的输入源有KEY:<SDL键名>、MOUSE:Left/Middle/Right/X1/X2、WHEEL:Up/Down；支持的动作共 27 个（Cross、Circle、Triangle、Square、L1–R3、D-pad 四向、左右摇杆八向、TouchLeft/TouchRight、ToggleMouse、ToggleFullscreen）。配置语法解析与校验逻辑见 docs/user/INPUT_MAPPING.md，手柄状态读取与运动传感器融合实现在 core/libs/prx/libScePad/src/PadState.cpp。

值得一提的还有自动化测试入口：设置环境变量APS5_PAD_INPUT_FILE=/tmp/anyps5-pad后启动游戏，再用仓库自带的 tools/pad_input.py 即可注入按键脉冲，例如模拟按下 Cross、按住 Down 500ms、再释放：

python3 tools/pad_input.py /tmp/anyps5-pad cross python3 tools/pad_input.py /tmp/anyps5-pad down --hold-ms 500 python3 tools/pad_input.py /tmp/anyps5-pad release

命令在第二个终端运行，注入的输入会叠加在物理手柄输入之上，默认按压 300ms 自动释放——调试菜单导航、验证按键响应非常好用。

四、常见排错速查

AnyPS5 的设计哲学是"要么做对，要么抛异常"：不支持或意外的状态会严格抛出std::runtime_error，what()打印到 stderr 后进程终止（见 README.md）。这种"宁可失败不可静默"的策略让排错有迹可循，以下是按仓库文档与实现整理的高频问题：

Linux 启动报[gpu] open /dev/udmabuf: Permission denied/BDA access failed

当 Vulkan 驱动通过 dma-buf 导入共享显存（NVIDIA 闭源驱动不走此路径）时，游戏需要/dev/udmabuf的读写权限。多数发行版以root:kvm0660 创建它：把当前用户加入kvm组并重新登录即可；setfacl -m u:$USER:rw /dev/udmabuf的 ACL 方案只持续到下次重启。超过默认 64 MiB 的size_limit_mb的区域也会走拷贝而非导入。

Windows 启动报错误 126 / 193

错误 126（指定模块找不到）通常是libs/缺少 MinGW 运行库（libgcc_s_seh-1.dll、libstdc++-6.dll、libwinpthread-1.dll）——虽然.prx文件都在，但系统库搜索不走PATH。错误 193（不是有效的 Win32 应用程序）则多半是libs/里混入了原版 PS5 模块。

启动时分配直接内存失败：create direct memory backing of 0x<n> bytes

Windows 上直接内存（sceKernelAllocateDirectMemory，单个标题最多 13824 MiB）在分配时就整体提交，任务管理器"已提交"的第二个值（物理内存 + 页面文件）必须覆盖它与所有其他已提交内存。不够就调大页面文件或关闭占用内存的程序。

游戏文字乱码 / 不显示

游戏通过sceSystemServiceParamGetInt查询主机语言，默认是英语（美国）。设ANYPS5_LANGUAGE可指定主机语言编号（0 日语、10 繁体中文、11 简体中文、21 阿拉伯语等）。若游戏打开系统字体集（sceFontOpenFontSet），还需要在可执行文件旁放anyps5-fonts/目录（或用ANYPS5_SYSTEM_FONTS指路），放从主机 dump 的 SST 系列字体，或改用公开授权的 Noto 系列替代，否则相关字体文本不会显示。

GPU 选择与着色器缓存

游戏默认跑在第一个带图形/计算队列且支持 swapchain 呈现的 Vulkan 1.1 设备上，优先独显。启动时会打印Physical device candidate行列出候选，用ANYPS5_GPU=<设备名片段>可指定（不区分大小写）。另外首次运行没有着色器缓存时，呈现内核在第一次 dispatch 才编译，第 1 帧可能来不及完成而切到 CPU 缩放器；之后的运行命中磁盘缓存就会恢复 AGC compute 呈现（ShaderDiskCache的实现见 core/shader/recompiler/ShaderDiskCache.cpp）。

从第一帧到 60FPS

至此，一条完整的链路已经打通：解压 Release 包 → 按sce_module/约定摆好游戏文件 → 一条 relinker 命令产出app.elf→ 把系统库放进libs/、资源放进app0/→ 手柄插上即玩或写一份anyps5-input.ini自定义键鼠 → 遇到问题看 stderr 的FAIL:信息对照本文排错。

AnyPS5 目前还处于"能跑的标题屈指可数"的早期阶段——兼容性列表（docs/user/COMPATIBILITY.md）里完整验证过的作品只有 Dreaming Sarah 和 DOOM Shareware，系统函数覆盖率与 RDNA 指令支持仍在持续增长（进度地图见 docs/dev/PROGRESS.md）。但对想亲手验证"非模拟器移植路线"的玩家和开发者来说，这套工具链的每一步都有源码可查、有错误可依，本身就已经是一个极好的工程样本。跑通一款游戏的那一瞬间，你会真正理解"原生移植"和"模拟"之间的差别有多大。

【免费下载链接】AnyPS5Tool for automatic PS5 executables porting to Linux and Windows项目地址: https://gitcode.com/GitHub_Trending/an/AnyPS5