终极Phigros模拟器指南：如何快速打造自定义音乐节奏体验 🎵

sim-phi（GitHub加速计划）是一款基于JavaScript Canvas API的开源音乐节奏游戏模拟器，让你在浏览器中轻松体验Phigros风格的游戏乐趣。通过上传自定义谱面和资源文件，你可以自由创作个性化的音乐节奏关卡，支持多种参数调节和扩展插件功能。

🚀 3步极速启动指南

1️⃣ 一键克隆项目

git clone https://gitcode.com/gh_mirrors/si/sim-phi

2️⃣ 安装依赖（2分钟搞定）

进入项目目录后执行：

npm install

3️⃣ 启动开发服务器

npm start

打开浏览器访问 http://localhost:3000 即可看到模拟器主界面 ✨

🎮 自定义谱面完全教程

准备工作：文件格式要求

• 谱面文件：JSON格式（推荐使用官方谱面模板）
• 音乐文件：支持MP3/WAV格式
• 背景图片：PNG/JPG格式（建议分辨率1920×1080）

上传流程（超简单！）

1. 将谱面、音乐和图片文件打包成ZIP压缩包
2. 在模拟器界面点击 「上传文件」 按钮（位于public/index.html主界面）
3. 等待文件解析完成（通常只需几秒）

参数调节技巧 ⚙️

在public/index.html的设置面板中，你可以调整：

• 宽高比：默认16:9（1.777778），支持从5:4到22:13等多种比例
• 按键缩放：从极小（0.8）到极大（1.3），适应不同屏幕尺寸
• 背景效果：开启「背景模糊」和「多押高亮」获得更佳视觉体验
• 音效音量：支持0%到500%调节，满足不同场景需求

Phigros模拟器主界面设置面板，可调节谱面、音乐、背景等核心参数

💡 高级玩法：插件扩展功能

sim-phi提供丰富的插件系统，位于src/plugins/目录，让你的模拟器更强大：

必装插件推荐

• dynamic-score.js：动态评分系统，实时显示打击精度
• phizone.js：扩展判定区域功能，支持自定义判定范围
• skin.js：皮肤切换功能，自定义界面风格
• video-recorder.js：游戏过程录制，轻松分享精彩瞬间

使用方法

1. 在public/index.html中点击 「更多设置」
2. 进入 「扩展」 标签页
3. 启用所需插件并调整参数

🛠️ 常见问题解决

谱面加载失败？

检查：

• ZIP压缩包是否包含正确的文件结构
• 谱面JSON格式是否符合规范（可参考src/utils/parseCSV.ts解析逻辑）
• 文件编码是否为UTF-8

画面卡顿怎么办？

1. 关闭「背景模糊」和「过渡动画」
2. 降低「按键缩放」比例
3. 确保浏览器支持WebGL 2.0（可通过src/utils/checkSupport.ts检测）

🎯 最佳实践建议

1. 谱面设计：使用src/utils/Chart.ts工具分析节奏图谱，确保打击点与音乐节拍精准同步
2. 资源优化：图片建议压缩至2MB以内，音乐采用128kbps MP3格式
3. 性能调优：在低配置设备上关闭「自动演示」和「FC/AP指示器」

通过sim-phi，你可以轻松打造属于自己的音乐节奏体验！无论是学习谱面设计、分享创作成果，还是单纯享受游戏乐趣，这款开源模拟器都能满足你的需求。立即开始探索吧！ 🚀