KytyPS5命令行参数全解30调试与诊断选项助你快速定位PS5模拟问题【免费下载链接】KytyPS5PlayStation 5 emulator for Windows, Linux and MacOS项目地址: https://gitcode.com/gh_mirrors/ky/KytyPS5KytyPS5 是一款免费开源的 PlayStation 5 模拟器支持 Windows、Linux 和 macOS。除了图形化启动器外它还提供了一组功能完整的KytyPS5 命令行参数覆盖窗口设置、GPU 选择、Vulkan 校验、着色器日志、性能分析等 30 多项调试与诊断选项。本文带你按场景掌握这些参数快速定位游戏崩溃、画面错误等 PS5 模拟问题。快速上手3 步用对 KytyPS5 命令行参数 KytyPS5 模拟器主程序为kyty_emulator基本格式为kyty_emulator --game 游戏目录或ELF [选项]查看帮助不带参数运行或加--help/-h即可打印全部选项及构建版本信息实现见 src/main.cpp 中的PrintUsage。指定游戏--game既可以是包含eboot.bin的游戏目录也可以直接指向 ELF 文件这是唯一必选参数。组合诊断选项按需叠加下文校验、日志、分析类参数。 所有配置项的默认值集中定义在 src/common/emulatorConfig.h 的ConfigOptions中参数解析逻辑位于 src/main.cpp 的ParseArgs函数。30 参数分类速查表下表按用途分组方便按需检索布尔参数支持true/false、1/0、on/off等写法。基础启动参数参数作用默认值--game dir\|elf游戏目录或 ELF 文件必选仅一次—--game-patch json加载 ETAHen 兼容的修改文件—--user-name name本地用户名1-16 字节Kyty--user-id num本地用户 ID1000--mic name指定麦克风设备省略则为静音静音--playgo-hack启用 PlayGo 桩回退关--console-language 0-29系统语言编号1美式英语窗口与显示参数参数作用默认值--screen-width num窗口宽度1280--screen-height num窗口高度720--fullscreen无边框桌面全屏关--vr启用虚拟 VR 头显关--vblank-frequency num虚拟垂直同步频率60--present-mode value提交模式Fifo/Mailbox/ImmediateMailboxGPU 与图形调试参数 参数作用默认值--gpu index指定 Vulkan 物理设备序号自动--vulkan-validation t\|f启用 Vulkan 校验层关--gpu-assisted-validation t\|f在 GPU 上检查着色器越界访问隐含开启校验非常慢关--shader-validation t\|f启用着色器校验关--shader-optimization-type value着色器优化None/Size/PerformanceNone--tessellation绘制曲面细分补丁默认跳过关--readback-linear-images t\|f提交时回读可写线性图像关--rd启用 RenderDoc 帧捕获关--command-buffer-dump t\|f导出命令缓冲关--command-buffer-dump-folder path命令缓冲导出目录_Buffers--graphics-debug-dump t\|f启用图形调试转储关--amd-cpu应用 AMD CPU 指令补丁关--redzone保护客端 SysV red zone仅 Windows关日志、诊断与性能分析参数 参数作用默认值--printf-direction value客端printf输出去向Silent/Console/FileSilent--printf-output-file path客端printf输出文件_kyty.txt--shader-log-direction value着色器重编译日志Silent/Console/FileSilent--shader-log-folder path着色器日志目录_Shaders--spirv-debug-printf t\|f启用 SPIR-V 调试 printf关--profile启用 Tracy 性能分析器关输入映射参数参数作用--keymap ControlInputDualSense 按键映射可重复使用多次--help/-h打印构建信息并列出全部选项5 组常用诊断组合快速定位 PS5 模拟问题以下组合覆盖了最常见的排障场景直接复制即可使用。1️⃣ 怀疑图形 API 调用出错花屏、崩溃kyty_emulator --game D:\Games\ExampleGame --vulkan-validation true若怀疑是着色器越界访问可加上--gpu-assisted-validation true但会显著拖慢运行速度。2️⃣ 捕获某帧画面做离线分析kyty_emulator --game /games/ExampleGame --rd启用后在渲染帧处触发 RenderDoc 捕获实现位于 src/graphics/presentation/renderDoc.cpp随后可在 RenderDoc 中逐帧检视 GPU 状态。3️⃣ 排查着色器重编译问题kyty_emulator --game D:\Games\ExampleGame --shader-log-direction File --shader-log-folder _Shaders --shader-validation true重编译后的着色器与日志会写入_Shaders目录代码路径见 src/graphics/shader/recompiler。4️⃣ 查看游戏内printf调试输出kyty_emulator --game D:\Games\ExampleGame --printf-direction Console选择File时输出写入--printf-output-file指定的文件默认_kyty.txt适合报告问题附件。5️⃣ 分析性能瓶颈kyty_emulator --game D:\Games\ExampleGame --profile启动 Tracy 分析器后用 Tracy 客户端连接查看各模块耗时配合--vblank-frequency可模拟不同刷新率下的表现。隐藏技巧环境变量与进阶选项 除命令行参数外还有两个环境变量值得关注见 src/graphics/presentation/window/window.cppSDL_VULKAN_LIBRARY手动指定 Vulkan 加载器路径。macOS 上模拟器会自动查找捆绑的 MoltenVK一般无需设置排查驱动问题时可显式指定。KYTY_BORDERLESSmacOS 上设置该变量强制创建无边框窗口用于规避 Rosetta 下的窗口异常。此外注意参数写错会立即报错退出如unknown option、missing value报错信息本身就是很好的排障线索--gpu-assisted-validation会自动隐含开启--vulkan-validation无需重复指定提交 Bug 前建议附上--printf-direction File生成的完整日志与--help输出的构建版本信息能显著提高问题的可复现性。相关代码路径参数定义与解析src/main.cpp默认配置值src/common/emulatorConfig.h运行入口结构src/emulator.hRenderDoc 捕获接口src/graphics/presentation/renderDoc.h窗口与 Vulkan 初始化src/graphics/presentation/window/window.cpp图形渲染后端src/graphics/host_gpu着色器重编译器src/graphics/shader/recompiler掌握这套 30 参数的 KytyPS5 命令行工具集后无论是崩溃、花屏还是性能问题你都能用最小代价收集到关键的诊断信息让排查事半功倍。【免费下载链接】KytyPS5PlayStation 5 emulator for Windows, Linux and MacOS项目地址: https://gitcode.com/gh_mirrors/ky/KytyPS5创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
