潜在触达「路B」复刻教程

0 · 先搞懂架构（不懂这个，排障全是瞎猜）

两个 Python 进程，同机各开一个窗口常驻：

GUI 执行器 = douyin_comment_grounded.py，像真人一样移鼠标/打字/点按钮/截屏验证（点赞评论抖音没接口，只能扮真人）。它脆就脆在屏幕/焦点/坐标一变就出错。
回写：本地表模式下触达写本地 comment_log_YYYYMMDD.csv，需摆渡回 mac 跑 mark-second-touch.ts 入库（端点直连回写还没做，见雷点④+roadmap）。

路 A vs 路 B（caffeinate/雷点里都会提到，先认清）：本教程讲的是 路 B = 监控 + 消费都在无影一台机常驻、同机闭环，真 7×24 不靠运营 Mac。路 A = 兜底备用，监控放 Mac 上跑（盯 lead 发新视频）、把名单摆渡给无影，无影只管发——万一无影上的监控不好使（cookie/网络）才退回它，这时 Mac 必须不睡（雷点⑯ caffeinate）。一句话：B = 全在无影；A = 监控在 Mac、摆渡给无影。

0.5 · 潜在触达的人(sec_uid)哪来的 + 两个 id 别混（常被问）

sec_uid 不是单独「抓」的——评论采集就随评论入库了。每条评论入库时，评论者的 douyin_user_id(=sec_uid)一起写进 comments 表，全站 sec_uid 都来自这。潜在触达不另外抓 id，只是 second-touch-worklist.ts 从已有 sec_uid 里按规则筛名单（DM 过 + ≥N 天没回 + 高/中意向 + 未 stopped + next_eligible 到期）。

两个 id 别混（排障关键）：

enrich 接在消费端补这一步：消费拿到 sec_uid → resolve_number(sec) 现场反查出抖音号 → 填进搜索词按号精确核身（治撞名 + 未知客户无昵称，雷点⑧）；反查失败回退昵称搜、不挡发。一条龙：

评论采集 → comments.sec_uid → worklist 筛名单 → special-follow.json(secUid列表)
→ 监控逮新视频(队列带 sec_uid) → 消费 enrich: sec_uid→抖音号 → 按号搜对人

1 · 前置 · 机器与账号

• 无影云电脑（个人版即可），抖音 PC 客户端已登录你的 messaging 账号（跟你 AKKE_ACCOUNT_ID 绑定那个）。
• 分辨率锁 2560×1600（坐标按这个标定，换分辨率全点歪）。
• 输入法切英文（中文输入法会把评论打成拼音/吞字）。
• 关 OS 休眠 = 让 Windows 别自动睡觉（默认闲置会自动睡眠/关屏/停盘→脚本全停）。下面 4 条把「多久后自动睡/关屏/停盘/休眠」全设成 0=永不（PowerShell 跑一次，幂等）。注意：只管 Windows 系统层，无影平台层深夜挂起 powercfg 管不到（雷点⑨）。

powercfg /change standby-timeout-ac 0
powercfg /change monitor-timeout-ac 0
powercfg /change disk-timeout-ac 0
powercfg /change hibernate-timeout-ac 0

关 Mac 休眠（仅当你在 Mac 上跑 route-B 相关长任务时） = 让 Mac 别睡，否则 route-A 兜底监控 / mac 侧 ferry / cron 一睡就停。这跟上面无影的 powercfg 是两台机、两套：Windows 用 powercfg，Mac 用 caffeinate，别搞混。

• 临时版（够用，但 Mac 重启/关机后会没）：caffeinate -dimsu &（不带 -t=永不自停；关终端/登出都不掉）。停用 killall caffeinate。
• 一劳永逸版（Mac 重启后自动恢复）= 装 LaunchAgent：把下面存成 ~/Library/LaunchAgents/com.<你名字>.caffeinate.plist，再 launchctl load -w ~/Library/LaunchAgents/com.<你名字>.caffeinate.plist。RunAtLoad=登录自动起、KeepAlive=死了自动重启。

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
  <plist version="1.0"><dict>
    <key>Label</key><string>com.<你名字>.caffeinate</string>
    <key>ProgramArguments</key><array><string>/usr/bin/caffeinate</string><string>-dimsu</string></array>
    <key>RunAtLoad</key><true/>
    <key>KeepAlive</key><true/>
  </dict></plist>

• 怎么彻底关掉（以后不想让 Mac 一直醒着）：launchctl unload ~/Library/LaunchAgents/com.<你名字>.caffeinate.plist 再 rm 掉那个 plist。⚠️ 注意：装了 LaunchAgent 后，光 killall caffeinate 停不掉它（KeepAlive 会自动把它重新拉起）——要真停必须先 launchctl unload。

• 账号参数（找 PM 一次性下发）：AKKE_ACCOUNT_ID（你的 messaging 账号 UUID）+ AKKE_ORG_ID。
  例 · 野荞：AKKE_ACCOUNT_ID=81cc9678-9b53-413b-9f40-7964341f4af1（小文（野荞）·cloud_pc）｜ AKKE_ORG_ID=00000000-0000-0000-0000-000000000001

1.5 · 🔴 头号前置 · 关注覆盖（不做这个，监控逮不到任何人）

2 · mac 端的料 · 你自己账号的池子（每人一套，不通用）

潜在触达对象 = 你自己账号 DM/RC 触达过、≥1 天没回、高/中意向的人。所以池子、话术表、关注 全是你账号下的、跟别人不通用——同事 A 的池子对同事 B 没用。

生成涉及 second-touch-worklist.ts（按你的 AKKE_ACCOUNT_ID 出名单）+ _gen-realtime-touch-table.py + 转换，目前由 fanny/PM 用你的账号跑、生成好给你摆渡。你拿到 3 份你账号专属文件：

⚠️ 换池必须同步重生成话术表（雷点⑪）。只换池子不换话术表 → 评论2 退空。

⚠️ 回复状态必须本机重扫：worklist 的「未回复」靠本机回复扫描数据判定。名单若是别人（PM/fanny）机器生成的，回复状态会是 unknown（没核实）——可能混着已回复过你的人。关注不受影响（照关），但触达前必须在你自己机器跑 scan-dm-replies.py 标出谁回了、回了的剔除/标 stopped，否则可能给正在聊的人又发评论。

3 · 无影端文件清单 全放 C:\akke-wuying\wuying-dm\

脚本 4 个（gitignore，走摆渡）：_realtime_touch_watch_wuying.py · _realtime_touch_consume_wuying.py（必须带 300s 超时版，雷点③）· douyin_comment_grounded.py（必须认「抖音」「douyin」两种标题版，雷点①）· douyin_dm_grounded.py
数据 3 个（§2 摆渡来）：special-follow.json · realtime-touch-table.json · dy_cookie.txt
配置：.env（见 §4）

4 · .env 必备项（无影本机）

SUPABASE_URL=...
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
SUPABASE_SCOPED_JWT=...           # role=wuying_worker 受控 JWT，回写直连 Supabase 用
AKKE_ACCOUNT_ID=<你的账号 UUID>
AKKE_ORG_ID=<org UUID>
AKKE_COMMENT_VERIFY_LENIENT=1     # 减评论假失败，必开（雷点⑩）
# 2560×1600 黄金值（饭粒机 06-21 实测验穿、新机直接抄，⚠️别再抄旧部署文档的错值 400,25/220,99）：
AKKE_C_SEARCH=432,25  AKKE_C_USERTAB=287,45  AKKE_C_FIRST=219,103  AKKE_C_SEARCH_BTN=589,14  AKKE_C_CLOSE=976,50
# ⚠️ 别设 AKKE_C_LIKE / AKKE_C_WORK_FIRST —— 留空走 VL 视觉定位，固定坐标会点空/开错视频（雷点⑬）
# ⚠️ 坐标改完还得采模板：py douyin_dm_grounded.py --capture（生成 templates\dm_button.png 等，"非主页"兜底+发送键定位要它；模板/坐标都不能跨机复用，雷点⑫）

5 · 启动 · 两个窗口（PowerShell）

监控窗口：

cd C:\akke-wuying\wuying-dm
python _realtime_touch_watch_wuying.py --max-age-min 20 --pool special-follow.json

• ⚠️ --pool 必须显式带（默认找中文名 special-follow-饭粒.json，你的叫 special-follow.json，不带就报「lead 池不存在」，雷点②）。
• ✅ banner 应是 … lead池 NNN … 触达闸 发布<=20min，NNN 两三百。

消费窗口（另开一个）：

cd C:\akke-wuying\wuying-dm
python _realtime_touch_consume_wuying.py

• ✅ banner 应是 … 本地表模式(无DB) … 自动发。
• ❌ 不要加 --api-base（端点模式连不上 Vercel，雷点④）。

摆位：抖音 PC 前台最大化，两个 PowerShell 窗口拖副屏/最小化、别盖在抖音上（雷点⑦）。

5.1 · 🏷️ 给每个窗口命名（带当天日期，强烈建议）

同机常驻多个窗口（监控 / 消费 / DM 派单），长得一模一样，加上天天开新窗口、旧窗口又常忘关，重启/排障时极易杀错或对着死窗口干等。每个窗口在跑脚本【之前】先设标题，标题栏立刻变、串流里一眼区分：

# $(Get-Date -Format 'MMdd') 自动取当天日期 → 标题变 PT监控-饭粒-0622，第二天自动变 0623
$host.UI.RawUI.WindowTitle = "PT监控-饭粒-$(Get-Date -Format 'MMdd')"   # 监控窗口
python _realtime_touch_watch_wuying.py --max-age-min 20 --pool special-follow.json

$host.UI.RawUI.WindowTitle = "PT消费-饭粒-$(Get-Date -Format 'MMdd')"   # 消费窗口（另开）
python _realtime_touch_consume_wuying.py

• 命名规则：<通道>-<谁的号>-<当天日期>，如 PT监控-饭粒-0622 / PT消费-饭粒-0622。
• 🗓️ 名字里带当天日期 $(Get-Date -Format 'MMdd')：昨天的死窗口和今天的新窗口一眼分得开，重启/排障不会对着旧窗口干等或杀错。
• 标题只活在当前这个窗口，关掉就没了；每次开新窗口都要重设一次（写进上面启动块就忘不了）。

6 · 验真发（消费日志/返回0 都不可信）

1. comment_log_YYYYMMDD.csv 的 status 列 = sent 才真发；send_unverified/focus_fail/wrong_user/no_msg2 都不算。
2. executor-runs.log（执行器分阶段落盘）= 看到「♥ 已点赞」+「✅ 评论已验证」才对；一堆「重夺焦点 3 次仍非抖音」= focus_fail（雷点①）。
3. 铁证（人工）：你账号看抖音「喜欢」列表有没有那条视频 + 另一个号/无痕看评论区有没有你的气泡。
4. 入库：comment_log 摆渡回 mac，跑 pnpm tsx scripts/mark-second-touch.ts --from-comment-log（一份只跑一次，非幂等）。

7 · 🔴 雷点清单（全是踩出来的血泪）