cris/wechat_msg_crawler
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add Full Disk Access prerequisite for macOS

Browse Source 
Users must grant Full Disk Access to their terminal before running
init, otherwise key extraction will fail silently.
This commit is contained in:
canghe 2026-04-06 09:37:39 +08:00
parent 019ef4eba6
commit 1eced78543
2 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
README.md
View File

@ -109,6 +109,16 @@ If you're unsure which WeChat account is currently active, navigate to the data
![init-claude-code-4](image/init-claude-code-4.png) ![init-claude-code-4](image/init-claude-code-4.png)
#### 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 #### 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. 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
View File

@ -107,6 +107,16 @@ wechat-cli init
![init-claude-code-4](image/init-claude-code-4.png) ![init-claude-code-4](image/init-claude-code-4.png)
#### macOS：提前开启终端的完全磁盘访问权限
在执行 `init` 之前，请确保已为终端开启**完全磁盘访问权限**：
1. 打开 **系统设置 → 隐私与安全性 → 完全磁盘访问权限**
2. 添加你使用的终端应用（如 Terminal、iTerm2 或 IDE 内置终端）
3. 开启后重启终端
未开启此权限会导致工具无法访问微信数据目录，密钥提取将失败。
#### macOS 遇到 `task_for_pid failed` 错误？ #### macOS 遇到 `task_for_pid failed` 错误？
在某些 macOS 系统上，即使使用了 `sudo`，`init` 也可能报 `task_for_pid failed`。这是 macOS 的安全策略限制了进程内存访问。 在某些 macOS 系统上，即使使用了 `sudo`，`init` 也可能报 `task_for_pid failed`。这是 macOS 的安全策略限制了进程内存访问。