docs: add Full Disk Access prerequisite for macOS
Users must grant Full Disk Access to their terminal before running init, otherwise key extraction will fail silently.
This commit is contained in:
parent
019ef4eba6
commit
1eced78543
10
README.md
10
README.md
@ -109,6 +109,16 @@ If you're unsure which WeChat account is currently active, navigate to the data
|
||||
|
||||

|
||||
|
||||
#### macOS: Grant Full Disk Access to Terminal
|
||||
|
||||
Before running `init`, make sure your terminal app has **Full Disk Access**:
|
||||
|
||||
1. Open **System Settings → Privacy & Security → Full Disk Access**
|
||||
2. Add your terminal app (e.g. Terminal, iTerm2, or the terminal in your IDE)
|
||||
3. Restart the terminal after enabling
|
||||
|
||||
Without this permission, the tool cannot access WeChat's data directory and key extraction will fail.
|
||||
|
||||
#### macOS: `task_for_pid failed` Error
|
||||
|
||||
On some macOS systems, `init` may fail with `task_for_pid failed` even when running with `sudo`. This is due to macOS security restrictions on process memory access.
|
||||
|
||||
10
README_CN.md
10
README_CN.md
@ -107,6 +107,16 @@ wechat-cli init
|
||||
|
||||

|
||||
|
||||
#### macOS:提前开启终端的完全磁盘访问权限
|
||||
|
||||
在执行 `init` 之前,请确保已为终端开启**完全磁盘访问权限**:
|
||||
|
||||
1. 打开 **系统设置 → 隐私与安全性 → 完全磁盘访问权限**
|
||||
2. 添加你使用的终端应用(如 Terminal、iTerm2 或 IDE 内置终端)
|
||||
3. 开启后重启终端
|
||||
|
||||
未开启此权限会导致工具无法访问微信数据目录,密钥提取将失败。
|
||||
|
||||
#### macOS 遇到 `task_for_pid failed` 错误?
|
||||
|
||||
在某些 macOS 系统上,即使使用了 `sudo`,`init` 也可能报 `task_for_pid failed`。这是 macOS 的安全策略限制了进程内存访问。
|
||||
|
||||
Loading…
Reference in New Issue
Block a user