# PsyZ PlayStation 移植库

> 用 C 编写的移植库，以原生实现替换 Sony PlayStation 运行时库 PSY-Q 的 API，使反编译得到的或原有的 PlayStation 源码能够在 Linux、macOS、iOS、Windows、WebAssembly 和 PSP 上编译，同时仍可为主机本身构建。它以 PSY-Q API 兼容为目标，另提供经由仿真 MMIO 端点访问的可选 GPU 与 SPU 仿真层，并包含对 PSY-Q 4.0 库的匹配反编译。

- 类型：工具
- 目标：游戏
- 类别：游戏分析工具
- 关联：基础工具
- 来源复核于：2026-10-19
- 收录于：2026-11-09
- 原始资源：<https://github.com/Xeeynamo/psyz>
- 一手来源：<https://github.com/Xeeynamo/psyz/blob/559adc76843bcca4945e9b3252d64889d58fc9e0/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/psyz/>
- 记录 JSON：<https://awesomerea.org/resources/psyz/record.json>
- 英文版：[English](https://awesomerea.org/resources/psyz/index.md)

## 使用条件与局限

- 需要 CMake 3.21 或更新版本、C11 编译器、SDL3，并递归克隆 SDL、cimgui 和 nugget 子模块；WebAssembly 构建使用 Emscripten。
- 游戏移植需要重建的 C 源码和移植指南要求的修改，包括排序表、图元标签类型及 64 位指针修正。PSY-Q 反编译仍在进行中；依赖硬件特性的游戏错误可能表现不同。
- 可选的 PlayStation SDK 设置会下载项目托管的专有 PSY-Q 4.0 和 4.7 SDK 压缩包，用于交叉编译和检查反编译库。
- CI 测试 Linux、Windows、macOS 和 PSP 构建；《恶魔城：月下夜想曲》序章的比较是作者的一次测量。
- 许可因目录而异：nugget、psyq2elf、samples 和 ztest 为 MIT；psyz/src/platform 和 psyz/src/psyz 为 MPL-2.0；psyz/include 和 psyz/src/psyq 未获许可；decomp/ 有自己的 MIT 许可。

## 一手来源

1. <https://github.com/Xeeynamo/psyz/blob/559adc76843bcca4945e9b3252d64889d58fc9e0/README.md>
2. <https://github.com/Xeeynamo/psyz/blob/559adc76843bcca4945e9b3252d64889d58fc9e0/LICENSE>
3. <https://github.com/Xeeynamo/psyz/blob/559adc76843bcca4945e9b3252d64889d58fc9e0/PORTING_GUIDE.md>
4. <https://github.com/Xeeynamo/psyz/blob/559adc76843bcca4945e9b3252d64889d58fc9e0/decomp/README.md>
5. <https://github.com/Xeeynamo/psyz/blob/559adc76843bcca4945e9b3252d64889d58fc9e0/decomp/LICENSE>
6. <https://github.com/Xeeynamo/psyz/blob/559adc76843bcca4945e9b3252d64889d58fc9e0/decomp/sdk/Makefile>
7. <https://github.com/Xeeynamo/psyz/blob/559adc76843bcca4945e9b3252d64889d58fc9e0/Makefile>
8. <https://github.com/Xeeynamo/psyz/blob/559adc76843bcca4945e9b3252d64889d58fc9e0/psyz/CMakeLists.txt>
9. <https://github.com/Xeeynamo/psyz/blob/559adc76843bcca4945e9b3252d64889d58fc9e0/.github/workflows/build.yaml>

## 同分区更多条目：游戏

- [GCRecomp](https://awesomerea.org/zh/resources/gcrecomp/index.md) · 工具
- [GBA-Recomp（GBA 静态重编译工具）](https://awesomerea.org/zh/resources/gba-recomp/index.md) · 工具
- [Kappa（VS Code 反编译扩展）](https://awesomerea.org/zh/resources/kappa/index.md) · 工具
- [Panda3DS](https://awesomerea.org/zh/resources/panda3ds/index.md) · 工具
- [Xbox XBE Recomp](https://awesomerea.org/zh/resources/xbox-xbe-recomp/index.md) · 工具
- [ModernGekko](https://awesomerea.org/zh/resources/modern-gekko/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。