潜在触达 · 全流程 + 复刻 SOP + 常态运维

把 已 DM 触达过、≥1 天没回的高/中意向用户（反评 RC 纳入为待做项）做成事件驱动盯防：本人一发新视频，就在发布 ≤20 分钟内（理想 ≤10min）自动完成点赞 + 评论1（评这条视频内容）+ 评论2（逐字搬首触原文）。每人每天 ≤1 次、累计 ≤7 次、对方一回复就停。潜在触达对已 DM 过的老 lead 统一都触、不按视频内容筛（哪怕当天发的是养狗/雨衣视频也照触；商家/同行排除只在「首次找新 lead」那层、不在这层）。监控 + 三连发送都搬无影一台云电脑常驻（路 B），队列与发送同机闭环。

六步全流程一个号的生命周期 · 耗时 · 原理 · 落库

#	步骤	耗时	原理	可云自动
0	关注补齐 （前置·瓶颈）	日限 30/号 补 164 ≈ 5–6 天	监控只能看到「号关注了的人」。关注写动作被抖音反爬挡死（raw API 403、Playwright 空白页），唯一通路 = 无影 GUI 原生登录点关注（_follow_grounded.py）。	半自动 无影 GUI 常驻
1	进池筛选 （候选计算）	秒级 批量 SQL	second-touch-worklist.ts：本号 DM 过 · 距最后一条 DM ≥1 天 · 原评论高/中意向 · 未停（未回未满 7 次）。	可全云 纯 DB，可 cron
2	实时监控 发新视频	检测延迟 ≤60s + 网络	f2 签名拉账号关注流 follow/feed，每 ~45s 翻 5 页，视频 age≤20min 才算新鲜入队。_realtime_touch_watch_wuying.py，纯只读 API。产物 → 入队 realtime-touch-queue.jsonl（视频id / sec_uid / 发布时间 / 文案）。	无影已跑 无 VPN、无 fake-IP
3	回复识别 （去重停发）	scan 扫收件箱 分钟级	列表预览指纹比对判 replied → 回了就停。洞② P0 已落库 conversations.last_inbound_at，回复真相首次可查、跨机收敛。	半自动 scan 需登录设备 GUI
4	话术生成	评论1 LLM 秒级 评论2 查表 0 延迟	评论1 = 逮到视频那刻 JIT：看这条视频标题/正文现场用 qwen3 生成对内容的反应（空正文 → 「赞赞赞」表情兜底）。评论2 = 查表逐字搬首触原文（DM/反评），照发不挡空（带微信/报价也发，封号风险走节奏层兜）。	已实现 评论1 无影 JIT / 评论2 mac 预生成查表
5	三连执行 点赞+评论1+评论2	每条 ~1–3min 须 ≤20min 窗内打完	无影 GUI douyin_comment_grounded.py：搜人 → 身份门 → 开视频 → 暂停 → 点赞 → 评论1 → 评论2（VL/模板匹配 + SendInput）。consumer _realtime_touch_consume_wuying.py 常驻 drain 队列。产物 → 写 comment_log_*.csv（点赞 / 评论1 / 评论2 各自状态 + 发送时刻）。	卡 GUI 无影专用，桌面须醒着
6	节奏控制 / 出库	秒级	mark-second-touch.ts + RPC：每天 ≤1 次、累计满 7 次 / 对方回复 → 永久出库；second_touch_state 单调推进、跨机去重。comment_log 摆渡回 mac 回写。	可全云 纯 DB

实时监控原理 ·「不点界面、纯后台读数据」为什么监控稳、发送脆

对比	点界面（发送 / 关注 · 写）	后台读数据（监控 · 读）
靠什么	鼠标点对坐标、屏幕长对样	一个数据请求
快慢	慢，一条 1–3 分钟	秒级，一次几十条
怕坐标 / 窗口	怕 坐标偏就点空	不怕 跟屏幕无关
抢不抢鼠标	抢 跑时别碰	不抢 后台静默
怕不怕黑屏	怕 黑屏就瘫	不怕 不看屏幕

翻页能力 · 会不会漏视频关注覆盖 + 池子涨大

监控每 ~45 秒翻 5 页 ≈ 75–100 条最新视频。「漏」= 某视频在它发布后 20 分钟里一直被更新的视频挤出前几页。当前池 318 人。

• 池子涨大怎么保证不漏（都是旋钮、几乎零成本）：① 加页 5 → 8–10（仍远低于关注流翻到 ~46 页卡死的红线）；② 加频 45s → 30s；③ 加体检——记录"逮到的视频落在第几页"，频繁落最后一页 = 接近边缘的信号，提前加页 / 加频。
• 一句话：现在不会漏、池子涨大也大概率不会漏；真要保险把"页数 / 频率"调一调就行，是个旋钮不是墙。

同事复刻 SOP换一个账号 / 换一个运营，从零跑起来

前提：你有①一台已登录抖音 PC 的无影云电脑（目录 C:\akke-wuying\wuying-dm\）；②本机（mac）能跑仓库 pnpm tsx + worker/.venv；③你的 messaging 账号 id（AKKE_ACCOUNT_ID）+ AKKE_ORG_ID。把下面命令里的账号换成你自己的。

1. 本机出关注池 + 话术表mac
   关注池 = 你号 DM/反评过、≥1 天没回的高中意向名单（special-follow-*.json）；话术表 = 每人「评论2 搬首触原文」查表（零 LLM、秒出）。

   pnpm tsx scripts/second-touch-worklist.ts            # 先出 worklist（评论2 文本源）
   worker/.venv/bin/python worker/scripts/wuying-dm/_gen-realtime-touch-table.py \
     --pool /tmp/special-follow-你.json --out /tmp/realtime-touch-table.json
   # 需 .env.local 的 AKKE_ORG_ID；评论1 不在表里（无影 JIT 现生成）

2. 打包摆渡到无影mac → 无影
   5 个文件打 tar.gz 传 paste.rs，无影一条命令拉下解压（必须 curl.exe，不能用 Invoke-WebRequest——会损坏 UTF-8 中文）。

   # mac：打包 + 上传
   tar -czf /tmp/rtb.tgz -C worker/scripts/wuying-dm \
     _realtime_touch_watch_wuying.py _realtime_touch_consume_wuying.py \
     _jit_comment1_wuying.py _start-realtime-touch.bat \
     -C /tmp realtime-touch-table.json
   curl -s --data-binary @/tmp/rtb.tgz https://paste.rs     # 拿到 URL + 记字节数
   
   # 无影 PowerShell：下载 + 核字节 + 解压
   cd C:\akke-wuying\wuying-dm
   curl.exe -s <URL> -o rtb.tgz
   (Get-Item rtb.tgz).Length        # 必须 == mac 那边字节数
   tar -xf rtb.tgz

   另需无影本地已有：dy_cookie.txt（你号 cookie）、special-follow.json（关注池，注意文件名）、douyin_comment_grounded.py（三连执行器）、_probe_follow_feed_wuying.py、.env（含 OPENROUTER_API_KEY + OCR key）。
3. 无影一次性环境无影
   pip install f2==0.0.1.7（硬钉这版，它锁 httpx==0.27.2，别升 httpx）；确认 .env 里有 OPENROUTER_API_KEY（评论1 JIT 用，缺了就全退「赞赞赞」）。
4. 验 JIT 评论1 能用无影

   py _jit_comment1_wuying.py "复式loft改造 楼梯下做了嵌入式储物柜"

   打印 key=有 + 一条贴合视频的评论 = ✅；打印 key=无(退兜底) + 赞赞赞 = .env 缺 key（补上才有内容反应版）。
5. 发送前置（每次开机必查）无影
   抖音 PC 已登录 + 最大化 + 前台；屏幕分辨率锁 2560×1600；输入法切 英文。
6. 启动常驻无影
   双击 _start-realtime-touch.bat → 弹两个黑窗口（Akke-watch 监控 + Akke-consume 消费），各带崩溃自动重启。跑批期间别碰鼠标键盘（发评论时全程控 GUI）。
7. 验证真发了mac
   别信消费日志的「✅已点发送」——它会假阳性。铁证两层：①执行器验证闸当场截图验（点赞验爱心变红、评论验气泡出现），验不过记 unverified 不算成功；②人工复核 = 用一筑「喜欢」列表看视频在不在 + 另号/无痕看评论气泡。⚠️ 三连的点赞不写 outreach_events（video_like/comment_like 恒 0，别拿它当铁证），证据看 comment_log + second_touch_state.last_touch_at。comment_log 摆渡回 mac 跑 mark-second-touch.ts --from-comment-log 回写节奏。

开机 / 启动 · 打开 shell 后怎么操作每次进无影先做这几步

1. 远程进无影桌面无影：确认抖音 PC 已登录 + 窗口最大化 + 在前台；分辨率锁 2560×1600；输入法切英文。
2. （建议）开评论宽松验证无影：脚本目录 .env 加 AKKE_COMMENT_VERIFY_LENIENT=1（减少「评论假失败」，6-15 查到一直没开 → send_unverified 虚高）。
3. 双击 _start-realtime-touch.bat无影 → 弹出 2 个黑窗口：Akke-watch（监控盯关注流）+ Akke-consume（消费发三连），各自崩溃会自动重启。就这 2 个，别多开、也别关。
4. 跑批期间别碰鼠标键盘无影：发评论时全程控 GUI，碰一下就 focus_fail。它一天只动几分钟、其余时间在空等。

怎么看它还在跑：监控窗 banner 有 lead池 318、日志在刷 🔥/⏰ 时间戳。断了（无影后半夜可能被平台层空闲挂起）→ 重新双击 .bat 即可。深夜 00–06 点本就没什么人发视频（占全天 1.8%），挂了不亏，重点保白天 + 傍晚高峰。

常态运维：要一直开着吗？最常被问

• cookie 会过期：dy_cookie.txt 约 15–30 天失效，监控开始报错就是它——本机重新导出 cookie、摆渡覆盖。
• 话术表要定期重生成：有新 DM / 新进池的人时，mac 重跑第 1 步出新表、摆渡覆盖 realtime-touch-table.json（消费端每轮热重读，不用重启）。
• 覆盖率靠补关注：想逮到更多人，得跑第 0 步（_follow_grounded.py，日限 30/号）把池子里没关注的人补上——这是产量天花板。

常见 QA

常见坑 · 踩过的

实战问题 & 解决2026-06-13~14 路 B 真跑无影踩的坑 + 解法

数据怎么落库 / 来回传哪台机器写、写到哪、怎么回

表 / 文件	在哪	记什么	谁写
second_touch_state	数据库	节奏大脑：每人触达几次、下次可触时间(next_eligible)、停没停(ladder)	mac 回写
comment_log_*.csv	云电脑	执行流水：今天发了谁、点赞/评论1/评论2 各自成没成、发送时刻	云电脑执行器
realtime-touch-queue.jsonl	云电脑	监控逮到的新视频队列（视频id / sec_uid / 发布时间 / 文案 / 逮到时刻）	云电脑监控
realtime-touch-touched.json	云电脑	本地「今天碰过谁」（撑「每天≤1」）	云电脑消费端
realtime-touch-seen.json	云电脑	已处理过的视频id（同一条视频不重复触）	云电脑监控
outreach_events	数据库	三连的「点赞」不写这张表（video_like/comment_like 恒 0）——别拿它当点赞铁证，证据看「喜欢」列表 + 评论气泡	—

回传闭环（现在）：云电脑发完 → comment_log 摆渡回 mac → mark-second-touch.ts --from-comment-log 把真发成功的写进 second_touch_state（次数+1、下次推到明天、满 7 停）。⚠️ 这步不幂等（每跑一次次数+1）：一份记录只跑一次、逐个核对跳过当天已计的（6-15 就因重复跑+两通道撞把和为贵刷到 2 次）。
PR #360 后：云电脑发完直接 HTTP 写回（complete 端点），不用人搬、顺带记「发布→完成」时效；发之前还会问数据库领号（claim），别的通道当天碰过就作废。

故障码词典comment_log 里的状态怎么读

列	码	意思
点赞	liked	爱心验证已变红 ✅ （前置幂等检查曾有单帧假阳性＝没点却记 liked，2026-06-16 已改双采确认修复，见下「升级」box）
	like_unverified	点了但没验到变红（可能点空）
	like_skip	没找到空心爱心（可能已经赞过）
评论1/评论2	sent	评论验证已出现在评论区 ✅
	send_unverified	点了发送但没验到气泡——验证常误判，可能其实发了
	focus_fail	抢不回抖音前台 / 输入框没焦点 → 根本没打字
评论2专属	no_msg2 / skip_c1_fail	话术表没这人评论2 / 评论1 没成功故不发评论2
身份	wrong_user	身份门没过（搜到同名错号）→ 跳过、冷却 1 天

快问快答 · 推演 / 吞吐 / 回传2026-06-16

问	答
端到端推到极限，能压到多快？怎么做？good/bad？	现实地板 ≈ 3min：三连执行 ~2.4min 固定（搜人→身份门→开视频→暂停→点赞→双评论，每步防风控 sleep）+ 检测 ≤45s/轮。质感 4.3min 已接近地板。再压只能两条路：① 路2 直盯目标主页 post-list（本人一发当场有，绕开 feed 上架的随机延迟）；② 压执行 sleep（不建议，像机器人、易限号）。good=越快越新鲜、评论趁视频热度高更易被看到、达标率高。bad=路2 高频盯主页吃反爬 + 单号 req/min 有容量上限（200 人每 3min≈67 req/min ≫ feed 的 ~8/min）→ 要多号分层、成本↑；压 sleep 伤号。探针①(feed延迟)②(单号 req/min) 还没跑出数 → 路2 到底能压多少、单号盯几人，未知。
「入队」入的是什么队？	无影本地文件队列 realtime-touch-queue.jsonl（每行一条待触视频：aweme / sec_uid / 发布时间 / 文案）。监控写、消费端 tail 它逐条发。是本地文件、不是数据库队列（区别于 DM/RC 的 Supabase dispatch_queue / rc_dispatch_queue 表）。
快车道 100 条过完要多久？	三连串行、每条 ~1.5–3min（含防风控 sleep）→ 100 条 ≈ 2.5–5 小时。一台无影只有一个抖音 GUI、串行不能并发，要快只能多号多机并行。（若"快车道"指 #340 抓评论热快道那是抓取侧、另一套，请说明。）
云电脑 DM / RC 数据怎么回传？	都全自动、走「DB 队列 + RPC 回写」，不靠文件摆渡：DM → dispatch_queue → complete_dispatch → 写 messages/conversations；RC → rc_dispatch_queue → complete_rc_dispatch → 写 outreach_events(channel=reverse_comment)。cron 派单、无影 wuying_poll_agent.py 拉取执行、发完调 RPC 回写。
更新的 PR #360 能自动回传吗？	能——complete 端点让无影发完直接 POST 回写 second_touch_state（次数 + e2e），不用人搬。但要无影脚本切到 --api-base 模式才生效（脚本已改好、还没切）。注：DM/RC 的自动回传不是 #360 带来的、它们早就有；#360 只补「潜在触达」这一条原本靠手动摆渡的缺口。

当前真实状态（2026-06-14 · 不粉饰）

• ✅ 三连首次在真视频落地：2026-06-14 一筑号实测，监控→入队→身份门→点赞→评论1→评论2→验证闸全链路跑通，第一条真视频点赞 + 评论都验证成功。执行链全部打通。
• ✅ 真发验证闸有效：点赞验爱心变红、评论验气泡出现，验不过记 unverified 不假报——6/12 那批"已点发送"假阳性被它挡住、不再误入库。
• ⚠️ 点赞验证有过假阳性（已修 6/16）：柴油案被记 liked 实际没点——根因是点赞前置幂等检查 _is_liked() 单帧 VL 误判「已红」就跳过点击。2026-06-16 已修：双采确认（两帧都判红才信已赞）+ prompt 收紧。教训：VL 验证两个方向都会误判（假阴性 + 假阳性），别无脑信任、更别开 TRUST_SEND。
• ✅ 关注覆盖够用：「覆盖率 12%」已确认是误判（关注流只露近期发视频的人），盲关 200 人计划已否决；wrong_user 用按抖音号反查定点修。
• ✅ 评论1 JIT + 评论2 照发不挡空：评论1 现场看视频正文 qwen3 生成干净反应（空正文退「赞赞赞」）；评论2 逐字搬首触原文、带促销词照发、0 人被闸挡空。
• ⚠️ 真 7×24 无人值守未解：无影平台层会空闲挂起（实测 9.5h 空白，powercfg 管不到）；现阶段靠「保持无影在线 + 双窗口自重启常驻」的半自动，治本待保活 / EDS 远程命令 + 按需唤醒。
• 一句话：执行链已全部打通、真视频已落地；剩的是把无影"空闲挂起"解掉、做到真常驻不靠人盯。

Akke · 潜在触达流程 + 复刻 SOP + 常态运维 · 口径随实现演进，以代码为准 · 2026-06-16