从首个失败阶段开始
选择停止的位置，再按系统进行检查。
检查输入格式与目标参数
- 确认干净 ELF 和受支持模块目录；--sce-module-path 指向父目录。
- 明确添加 --windows；否则即使命名为 .exe，仍会使用默认 Linux 格式。
- 对照同一版本文档检查选项。基础尝试中不要加入已经弃用的调试参数。
退出码 0 可能只是显示了帮助；使用 --autorun 时，返回码可能来自被启动的程序。请连同命令和日志一起记录。
v0.1.2 输入、参数与退出码 ↗生成排障报告
整理报告后复制到 GitHub issue 或讨论；此表单不会上传输入。
使用其他构建？请按对应文档操作，并比较 AnyPS5 游戏报告。
AnyPS5 停止运行时，先确定问题发生在转换、加载替代库还是进入游戏之后。保留第一个有用的错误，通常比同时更换多项设置更容易找到原因。
本指南按 v0.1.2 的使用文档整理。目录布局可对照 AnyPS5 安装，环境条件可对照 AnyPS5 配置要求。
输入文件或模块无法转换
确认输入是干净、已解密 ELF，而不是加密包或 SELF/fSELF 容器。eboot.bin 等文件名本身不能说明内容格式。
source/
input.elf
sce_module/
bundled-module.prx
检查模块父目录中是否有 sce_module/、sce_modules/ 或 prx/；prx/ 可与其中之一共存，但前两者同时存在会报错。只扫描直接文件。目录不在输入旁时检查 --sce-module-path 指向的父目录；额外路径按游戏命令添加 --module-dir。
Windows 提示格式不正确，或出现非法指令
生成 Windows 输出必须传入 --windows。仅使用 .exe 后缀不会改变默认 Linux ELF 格式：
.\relinker-v0.1.2.exe --windows source\input.elf app.exe
Intel 的 --to-intel 改写转换时找到的受支持 AMD 指令，不能处理运行时生成的同类指令。记录非法指令、构建和场景后，再查对应游戏的已知问题。
Windows 错误 193 或 126
错误 193 可由把原主机 .prx 放进 libs/ 引起；这里需要的是为 Windows 构建的 AnyPS5 替代库。
错误 126 表示加载模块或其依赖失败。检查缺少的 DLL，而不只是表面上被点名的文件。Windows 库包中的 libgcc_s_seh-1.dll、libstdc++-6.dll 和 libwinpthread-1.dll 都应在 libs/。自行构建库时，使用同一 MinGW 工具链 mingw64/bin 中的 DLL，不要混用编译器运行时。
游戏自身已转换模块位于 app0/ 对应子目录。按 Guest module: 输出复制生成文件，保留 sce_module/、sce_modules/ 或 prx/ 的原目录名称。
映射内存失败
Windows 的 replace guest placeholder with resident direct memory 等错误可能与提交不足有关。每个标题的直接内存分配可能达到 13,824 MiB，映射时才提交。检查任务管理器“已提交”的当前值与上限；RAM 加页面文件需容纳这部分和其他提交内存。关闭其他程序或调整页面文件后重新尝试。
Linux 日志若提示 /dev/udmabuf 权限不足，检查设备的读写权限、所有者和组权限，并参考使用文档中的大小限制。受影响内存路径无法工作时，日志也可能显示 BDA access failed。
黑屏或使用了错误 GPU
先查 AnyPS5 游戏中的对应构建，看看黑屏是否是该标题的现有障碍。再检查资源目录、首个图形错误与 Vulkan 驱动。
运行库默认优先独立显卡。需要明确指定时，先查看 Physical device candidate 行，再将 ANYPS5_GPU 设为设备名称的部分字符串，不区分大小写：
$env:ANYPS5_GPU="NVIDIA"
.\app.exe
占位内容应换成日志实际打印的名称。没有可用设备匹配时，程序会停止，不会默默选择其他设备。
文字缺失或字体打不开
系统字体集可能需要放在可执行文件旁的 anyps5-fonts/，或通过 ANYPS5_SYSTEM_FONTS 指定路径。使用文档列出了原字体文件与受支持 Noto 替代方案；仅复制 app0/ 资源不能解决缺失系统字体的问题。
控制器或按键没有响应
运行库使用第一个识别到的 SDL 控制器。检查是否另一个手柄占用了第一个控制器位置；也可尝试内置键盘操作，区分映射问题和游戏停止响应，再对照输入说明。触摸板按下与触摸坐标是两回事，后者尚未实现。
键鼠自定义放在程序旁的 anyps5-input.ini，也可用 ANYPS5_INPUT_CONFIG 指定文件。这些设置不覆盖手柄映射。无效行会打印文件名与行号并停止输入初始化，先处理该错误。
保存日志
PowerShell 中可以同时在屏幕和文件中保留输出：
.\app.exe *>&1 | Tee-Object -FilePath .\launch-log.txt
Linux 可使用：
./app.elf 2>&1 | tee launch-log.txt
Windows 图形方式启动、没有标准输出句柄时，程序可能在可写目录中生成 anyps5.log；后续启动会覆盖旧文件，重要日志请先另存。
下一步报告什么
用页面的报告工具整理游戏和内容版本、AnyPS5 修订版/补丁、系统与 GPU、命令、停止阶段和首个错误。草稿在本地生成，复制前删除私人路径、用户名和令牌；不要上传游戏可执行文件或密钥。
到 AnyPS5 GitHub 指南寻找上游问题渠道。浏览器转换和保存问题另见 AnyPS5 网页转换器；社区讨论背景可读 AnyPS5 Reddit。