update at 2025-10-26 10:24:17

QUICKSTART.md

@@ -1,4 +1,4 @@
-# 快速开始 - 滑块验证自动化（v1.1.0）
+# 快速开始 - 滑块验证自动化（v1.2.0）
 
 ## 🚀 5 分钟上手
 
@@ -9,7 +9,13 @@ cd /Users/gavin/douban-login
 npm install
 ```
 
-### 2. 启用自动滑块验证登录
+### 2. 授予完全磁盘访问权限（macOS）
+
+- 系统设置 → 隐私与安全性 → 完全磁盘访问权限 → 添加终端（Terminal/iTerm2/VS Code）
+- 勾选开关后重启终端，确保能够读取 `~/Library/Messages/chat.db`
+- 想快速验证，可执行 `ls ~/Library/Messages/chat.db` 检查权限
+
+### 3. 启用自动滑块验证登录
 
 ```bash
 DOUBAN_AUTO_SLIDER=1 DOUBAN_PHONE=你的手机号 npm run login
@@ -21,8 +27,9 @@ DOUBAN_AUTO_SLIDER=1 DOUBAN_PHONE=你的手机号 npm run login
 - ✅ 计算精确的滑动距离
 - ✅ 模拟真人滑动轨迹
 - ✅ 自动重试直到成功（最多 10 次）
+- ✅ 在 macOS 上自动读取短信验证码，读取失败会提示手动输入
 
-### 3. 独立测试滑块功能
+### 4. 独立测试滑块功能
 
 ```bash
 npm run slider
@@ -38,7 +45,7 @@ npm run slider
 DOUBAN_AUTO_SLIDER=1 DOUBAN_PHONE=13800138000 npm run login
 ```
 
-脚本会自动完成整个登录流程，包括滑块验证。
+脚本会自动完成整个登录流程，包括滑块验证与 macOS 短信验证码读取（授权不足时会提示手动输入）。
 
 ### 场景 2：查看检测过程
 
@@ -120,6 +127,16 @@ const result = await controller.solveSlider(page);
 
 ## 🔧 故障排查
 
+### 问题：短信读取失败或一直等待
+
+**症状**：终端反复打印 `[短信读取] 未检测到新的豆瓣验证码短信`，最终回退到手动输入。
+
+**排查步骤**：
+1. 确认已为终端授予“完全磁盘访问权限”，并在授权后重新启动终端；
+2. 使用 `ls ~/Library/Messages/chat.db` 验证终端是否具备读取权限；
+3. 检查短信是否确实到达 Mac 的“信息”应用；
+4. 若仍失败，可直接在提示时手动输入验证码，稍后再排查权限问题。
+
 ### 问题：检测不到滑块
 
 **症状**：日志显示"未检测到滑块"或"检测到 0 个滑块"