From 89407d96943798f36e75487f08fdc4aaecba50e6 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Tue, 31 Mar 2026 16:04:39 +0000
Subject: [PATCH] docs: add FFmpeg EACCES troubleshooting to README

https://claude.ai/code/session_01CqfKgV8GuCmWNpfx86H62X
---
 README.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/README.md b/README.md
index 7d2dd3f..7b0eb60 100644
--- a/README.md
+++ b/README.md
@@ -292,6 +292,13 @@ A：可以。在设置页面创建多个实例，分别连接不同的 TS 服务
 **Q：端口 3200 被占用？**
 A：QQ 音乐 API 启动时自动监听 3200 端口。如果之前的进程还在运行，程序会自动复用。如需重启可手动结束 `node` 进程。
 
+**Q：播放歌曲时报 FFmpeg EACCES 错误？**
+A：`ffmpeg-static` 内置的 FFmpeg 二进制文件缺少执行权限。程序已自动尝试修复，如果仍然失败，请手动执行：
+```bash
+chmod +x node_modules/ffmpeg-static/ffmpeg
+```
+或者确保系统已安装 FFmpeg（`apt install ffmpeg` / `brew install ffmpeg`），程序会自动回退使用系统版本。
+
 **Q：Docker 构建失败？**
 A：原生模块（opus、sqlite3）需要编译工具，Dockerfile 已包含。确保 Docker 有足够内存（建议 2GB+）。