抖音 DM 发送 Onboarding

装 Xcode + 命令行工具

Mac App Store 搜索 "Xcode" → 下载（约 12 GB，需要 1-2 小时网速看人）→ 装好后必须打开一次接受协议。

然后终端执行：

xcode-select --install
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
xcode-select -p   # 输出 /Applications/Xcode.app/... 即就绪

Apple ID 登录 Xcode + 开 Personal Team

1. Xcode 打开 → 顶部菜单 Xcode → Settings → Accounts → 点 "+" 加你的 Apple ID
2. 登录后会自动生成一个 "Personal Team"（团队 ID 是 10 位字符）
3. 把团队 ID 记下来（后面 sed 改 bundle ID 时要用到）

查 Team ID 的快捷方式：

security find-certificate -a -p ~/Library/Keychains/login.keychain-db \
  | openssl x509 -noout -subject 2>/dev/null \
  | grep -o 'OU=[A-Z0-9]\{10\}' | head -1
# 输出：OU=NQC9WL9445  ← Team ID 是 NQC9WL9445

clone WebDriverAgent 仓库 + 改 bundle ID

cd ~
git clone https://github.com/appium/WebDriverAgent.git
cd WebDriverAgent

# 把 Facebook 默认 bundle ID 改成你自己的（用你名字的拼音/缩写）
sed -i '' 's/com.facebook.WebDriverAgentRunner/com.<你名>.WebDriverAgentRunner/g' \
  WebDriverAgent.xcodeproj/project.pbxproj

把 <你名> 替换成英文小写名字（例：com.kara.WebDriverAgentRunner）。Personal Team 不能用别人占过的 bundle ID，必须改。

编译 WDA

cd ~/WebDriverAgent
xcodebuild build-for-testing \
  -project WebDriverAgent.xcodeproj \
  -scheme WebDriverAgentRunner \
  -destination 'generic/platform=iOS' \
  CODE_SIGNING_ALLOWED=NO

编译结果会在 ~/Library/Developer/Xcode/DerivedData/WebDriverAgent-* 下。

构建后 xctestrun 文件里的 bundle ID 也要改一次：

sed -i '' 's/com.facebook.WebDriverAgentRunner/com.<你名>.WebDriverAgentRunner/g' \
  ~/Library/Developer/Xcode/DerivedData/WebDriverAgent-*/Build/Products/*.xctestrun

把 WDA 安装到 iPhone

用数据线连上 iPhone（信任电脑），先取你的 UDID：

system_profiler SPUSBDataType | grep -A 4 "iPhone" | grep "Serial Number"

把 UDID 记下来（40 位字符），然后：

UDID=00008110-001A44421447801E   # 换成你的

# 找编译产物
APP=$(find ~/Library/Developer/Xcode/DerivedData/WebDriverAgent-* \
  -name "WebDriverAgentRunner-Runner.app" | head -1)

# 安装
xcrun devicectl device install app --device $UDID "$APP"

iPhone 上信任开发者证书

iPhone 第一次跑 WDA 会弹 "Untrusted Developer"，必须手动信任：

1. iPhone → 设置 → 通用 → VPN 与设备管理
2. 找到 "开发者 App" 一栏 → 点你的 Apple ID
3. 点 "信任 com.<你名>.WebDriverAgentRunner" → 弹窗再次确认 → 信任

iPhone 自动锁定改 "永不"

iPhone → 设置 → 显示与亮度 → 自动锁定 → 永不。

装 pymobiledevice3

iOS 17+ 必须用 pymobiledevice3（旧的 tidevice 已经不能用了）：

pip3 install --user 'pymobiledevice3>=9.12.0'
pymobiledevice3 --version  # 验证装好

clone Akke 仓库 + 装依赖

cd ~
git clone git@github.com:<Akke 仓库地址> Akke
cd Akke/worker
pip3 install -r requirements.txt
playwright install chromium  # 备用，目前 DM 不走 playwright 但其他工具会用

把 .env 放到 worker 目录

把现任 Owner 通过 1Password 给你的 worker .env 内容，保存到：

~/Akke/worker/.env

内容应该至少包含：

SUPABASE_URL=https://<xxx>.supabase.co
SUPABASE_SERVICE_ROLE_KEY=eyJ...
FLY_WORKER_SECRET=<长字符串>

启动 RSD 隧道（需要 sudo）

开终端 1，跑：

sudo pymobiledevice3 remote tunneld -d

这条命令需要前台保持运行，不要关。让它一直跑。

取 RSD 隧道地址

新开终端 2：

curl -s http://127.0.0.1:49151/ | python3 -c "
import sys, json
d = json.load(sys.stdin)
v = list(d.values())[0]
print(v['rsd_address'], v['rsd_port'])
"

会输出类似 fd68:295b:b075::1 55320（IPv6 地址 + 端口），抄下来。

启动 WDA xctest runner

终端 2 继续跑（替换上一步抄的地址 + 你自己的 bundle ID）：

pymobiledevice3 developer dvt xcuitest \
  --rsd fd68:295b:b075::1 55320 \
  com.<你名>.WebDriverAgentRunner.xctrunner

注意：bundle ID 末尾 .xctrunner 是固定后缀，不能省。这个终端也要保持前台。

转发端口 8100

新开终端 3：

pymobiledevice3 usbmux forward 8100 8100

这条会把 iPhone 的 WDA 端口映射到 Mac 的 localhost:8100。

验活

新开终端 4：

curl http://localhost:8100/status

返回 JSON 含 "sessionId" 字段就 OK。如果 timeout 或 connection refused 跳第 6 节"故障排查"。

iPhone 端暖场

1. 解锁 iPhone，确保屏幕亮（设置过"永不"那一步保持）
2. 打开抖音 App
3. 切到 "我" 标签 → 这一步是必须的，cold context（直接跳搜索/发现）会触发风控验证码
4. 返回首页推荐流停留 30 秒（看几条视频，给账号一个"今天活了"的信号）

跑 dm_send_v3

终端 4：

cd ~/Akke/worker
python3 dm_send_v3.py --max 5

--max 5 是本批最多发 5 条。新人头几次跑建议 --max 3 摸熟手感。

终端会打印每条候选的进度，类似：

[1/5] 候选: 榴莲 (sec_uid: MS4w...) intent=95
  → 暖场 OK
  → 跳转 profile OK
  → 点击私信 OK
  → 输入文案 OK
  → 发送 SENT ✓
  间隔 120s（随机 90-180s）
[2/5] ...