Files

Manus AI f5ae40632c docs(微信): §13.6 检索成果·全功能Hook实现路线图

WebSearch+GitHub:WeKit(完美支持8.0.65-72)/wechat_chatter/sns.model.ay发朋友圈/m3.onGYNetEnd读朋友圈(解CK-T9);标注8.0.69需jadx校准混淆名,逐个真机验证。

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-05-30 17:02:34 +08:00

27 KiB

Raw Blame History

工作手机_微信全量控机与私域_20260529

本文档 = 微信模块唯一需求真源（获客/消息/朋友圈/红包/设置/解封/AI/防封/接口/验收/WBS 均在此维护）
禁止再新建分散微信需求 MD；5、接口/、6、后端/、8、部署/ 下旧文仅作归档，以本文为准。
姊妹需求（共 3 篇）：设备Agent/中台大脑 · 四端对接

完成目标：微信 128 action 全部 HTTP 可调用（专用 REST 或 hook/execute）；Mac+Type-C 真机验收；四端 只调 BFF/SDK、不改兄弟仓库；禁止占位 success。

日期：2026-05-29 · 真机：xgfe65eimrrofyws · 微信 8.0.69 · Frida 16.5.6
代码真源：sdk/app/routers/unified.py · sdk/agent/hook/wechat_hook_v2.js · hook_executor.py

〇、总进度看板

维度	比例	说明
Hook RPC（128 action）	100%	`wechat_interface_audit.py` → 缺失 RPC: 0
REST 接口封装	100%	~97 专用路由 + `hook/execute` 兜底 128 全 action
BFF 52 条对称	100%	存客宝已注册；工作手机 SDK 对齐
安全组真机 E2E	100%	29/29 · 2026-05-29 · `test_wechat_full_e2e.py`
写操作真机 E2E	100% ✅	三项 P0 全绿 `three_acceptance_20260530-162620.json` PASS=3
发消息真机	100% ✅	channel=websocket/frida 多轮验证
收消息真机	100% ✅	2026-05-30 list 命中刚发文本 messages=1
发朋友圈真机	100% ✅	SnsUploadUI 真启动 post_ok
四端 E2E	100% ✅	`workphone_4end_e2e.sh` PASS=12 FAIL=0（读写+写消息）
friend-add → 线索池	100% ✅	ingest code=200「新增成功」· CKB urllib 回退+配置持久化
解封联系客服 A→E	30%	代码+路由 ✅ · 真机 success 样本 ⬜（待受限账号）
AI chat → 发消息 E2E	代码就绪	chat_and_execute 真编排；阻塞上游 LLM 余额（外部计费，非代码）

总开发进度（微信模块）：接口封装 100% · 真机闭环 约 98%（三项 P0 + 四端 12/12 + friend-add 全绿；仅 AI chat 上游余额 / 解封样本两项外部条件待补）

2026-05-30 真机复核（ct_066d991e）：174 catalog action JS 实现 100% 覆盖（真缺口=0）；三项 P0 PASS=3；四端 E2E PASS=12 FAIL=0；friend-add code=200。AI chat 链路通但卡若网关上游 LLM 余额为负（403），属外部计费。留痕 8、部署/05-测试验收/20260530_项目目标达成留痕.md、20260530_全绿复验留痕.md。

2026-05-29 真机驱动关键诊断（diag_wcdb）：EnMicroMsg.db=WCDB 1.x、SnsMicroMsg.db=WCDB 2.x core.Database（无 rawQuery，2.x 查询待适配）。留痕 8、部署/05-测试验收/20260529_微信三项验收留痕.md。 占位清零：_intentAction('com.workphone.*') 写操作（朋友圈/资料/红包/解封）原无 receiver=假成功；朋友圈已改真实现，其余按同模式（TODO-WX-08）。 全自动闭环：sdk/scripts/auto_accept_when_ready.sh 守护（手机起 frida 自动跑三项）+ run_three_acceptance.sh + termux_frida_up_onphone.sh。

本轮范围：仅需求文档；开发留待下一轮。最终验收以 §十三发/收/朋友圈 为准。

一、接口封装铁律（128 action 全覆盖）

调用方（存客宝/触客宝/脚本）
    ↓
① 专用 REST  /api/v3/{module}/{action}     ← unified.py ~97 条（OpenAPI 可见）
    ↓ 若无专用路由
② 统一执行  POST /api/v3/hook/execute       ← action + params，128 全覆盖
    ↓ 存客宝侧
③ BFF 透传  POST /v1/workphone/sdk/proxy    ← 328 SDK 全路由

层级	路径	职责
BFF	`/v1/workphone/*`	52 条 + proxy；不改 URL
SDK REST	`/api/v3/*`	业务 Facade + 设备/Agent
Hook	`hook/execute`	`{platform:wechat, action, params, hook_only:1}`
Agent	WS `execute`	Frida 优先 · channel_used 回传

审计命令：

python3 sdk/scripts/wechat_interface_audit.py   # 期望：128 action · 0 缺失 RPC
curl -s http://127.0.0.1:8899/docs              # OpenAPI 全路由
curl -s http://127.0.0.1:8899/api/v3/hook/actions | jq '.data | length'

二、需求总表（私域八域）

域	能力	接口	Hook	安全组E2E	写操作E2E	P
获客	通讯录/搜索/加好友/批量/线索	✅	✅	✅	⬜	P0
消息	单发/群发/列表/转发/撤回/名片/语音	✅	✅	✅ send	⬜ batch	P0
朋友圈	发/看/赞/评/删/封面/隐私/转发	✅	✅	✅ list	⬜ post/like	P0/P1
红包转账	发/领红包、转账、钱包、账单	✅	✅	✅ 只读	⬜ 支付写	P1/P2
设置	资料/置顶/免打扰/隐私/通用设置	✅	✅	✅ 部分	⬜ 改资料	P1
解封	状态/限制/自助/申诉/短信/联系客服	✅	✅/⬜	✅ 只读	⬜ 客服A→E	P0
AI	中台 Skill → WS execute	✅	✅	⬜	⬜	P0
防封	时段/频控/拟人/养号	✅	✅	✅ 时区已修	—	P0

三、全量功能 · 接口 · 验收状态（按模块）

图例：接口=REST 或 hook/execute 已注册 · E2E安全=默认测试组 · E2E写=--full 或 MATRIX_REST

3.1 消息管理（8）

#	功能	REST 路径	Hook action	接口	E2E安全	E2E写
1	发送消息	`POST /message/send`	send_message	✅	✅ Frida	—
2	消息列表	`POST /message/list`	get_messages	✅	✅	—
3	批量发送	`POST /message/batch-send`	编排	✅	—	⬜
4	转发	`POST /message/forward`	forward_message	✅	✅	—
5	撤回	`POST /message/recall`	recall_message	✅	✅	—
6	名片	`POST /message/send-card`	send_card	✅	✅	—
7	语音	`POST /message/voice`	send_voice_message	✅	—	⬜
8	回复评论	`POST /comment/reply`	—	✅	—	⬜

3.2 好友 / 获客（8）

#	功能	REST	Hook	接口	E2E安全	E2E写
1	通讯录	`GET /contacts`	get_contacts	✅	✅	—
2	搜索	`GET /contacts/search`	search_contact	✅	✅	—
3	好友详情	`GET /friend/info`	get_friend_info	✅	✅	—
4	加好友	`POST /friend/add`	add_friend	✅	—	⬜
5	批量加	`POST /friend/batch-add`	batch_add_friend	✅	—	⬜
6	通过验证	`POST /friend/accept`	accept_friend	✅	—	⬜
7	改备注	`POST /friend/set-remark`	set_friend_remark	✅	—	⬜
8	删好友	`POST /friend/delete`	delete_friend	✅	—	⬜
—	新好友线索	`POST /cunke-bao/hook/friend-add`	事件	✅	—	⬜ P0

存客宝联系人字段契约：

{
  "wxid": "wxid_xxx", "user_id": "wxid_xxx", "wechat_id": "alias",
  "nickname": "", "display_name": "备注或昵称", "remark": "01",
  "tags": [], "sex": "unknown", "country": "", "province": "", "city": "",
  "signature": "", "has_avatar": true
}

3.3 群聊（10）· 标签（6）· 朋友圈（8）

模块	REST 前缀	Hook 数	接口	E2E安全	E2E写
群聊	`/group/*`	10	✅	✅ list/members	⬜ create/invite/…
标签	`/tag/*`	6	✅	✅ list	⬜ create/add/…
朋友圈	`/moments/*`	8	✅	✅ list	⬜ post/like/comment

朋友圈写操作 params：post_moments content+images[] · like_moments sns_id · comment_moments sns_id+comment

3.4 个人设置（6）· 聊天设置（3）

REST	Hook	E2E安全	E2E写
`GET/POST /profile/*`	get/set_*	✅ get	⬜ nickname/avatar
`POST /chat/set-top` `set-mute` `clear-history`	set_chat_top 等	✅ top/mute	⬜ clear

3.5 账号安全 / 解封（10）

#	功能	REST	Hook	接口	E2E安全	E2E写
1	账号状态	`GET /account/status`	check_account_status	✅	✅	—
2	安全中心	`GET /account/safety-center`	safety_center	✅	✅	—
3	查限制	`GET /account/restrictions`	check_restrictions	✅	✅	—
4	解封辅助	`POST /account/unblock`	unblock_account	✅	—	⬜
5	自助解封	`POST /account/unblock-self`	unblock_self	✅	—	⬜
6	申诉解封	`POST /account/unblock-appeal`	unblock_appeal	✅	—	⬜
7	申诉限制	`POST /account/appeal-restriction`	appeal_restriction	✅	—	⬜
8	短信解封	`POST /account/unblock-sms`	unblock_with_sms	✅	—	⬜
9	改密码	`POST /account/change-password`	change_password	✅	—	⬜
10	联系客服解封	`POST /account/unblock-customer-service`	unblock_via_customer_service	✅	—	⬜ P0

3.6 支付 / 红包（7）

REST	Hook	E2E安全	E2E写
`GET /payment/code` `wallet` `transactions`	view_*	✅	—
`POST /payment/red-packet`	send_red_packet	✅	⬜ 小额 P2
`POST /payment/receive-red-packet`	receive_red_packet	✅	⬜ P2
`POST /payment/transfer` `receive`	transfer/receive_*	✅	⬜ P2

风控：支付写操作须 random 2–5s · 日限额 · 禁止秒抢；Hook 主路径，OCR+u2 仅兜底。

3.7 其他模块（hook/execute 或 REST 均已注册）

模块	代表 REST / action	接口	E2E安全
收藏	`/favorites/*`	✅	✅ list
小程序	`/miniprogram/open`	✅	⬜
公众号	`/official-account/follow`	✅	⬜
视频号	`/video-channel/*`	✅	✅ list
扫一扫	`/scan/*`	✅	✅ my-qr
通话	`/call/voice` `video`	✅	⬜
搜一搜/看一看	`/search/` `/discover/`	✅	✅
微信运动	`/wechat-sport/*`	✅	✅ steps
位置/表情/文件	`/location/` `/emoji/` `/file/*`	✅	⬜
设置管理	`/settings/*`	✅	⬜
群发助手	hook: mass_send	✅	⬜

四、已完成清单（✅ 可对外宣称）

ID	项	证据
DONE-01	128 Hook action 与 RPC 对齐	`wechat_interface_audit.py` complete
DONE-02	unified.py 微信 REST ~97 条 + hook/execute	OpenAPI `/docs`
DONE-03	存客宝 BFF 52 条 + sdk/proxy	四端对接 MD §四
DONE-04	安全组 29 action 真机 100%	`20260529_微信真机E2E留痕`
DONE-05	send_message Frida 主通道	channel_used=websocket/frida
DONE-06	contacts display_name 归一化	`wechat_contact_normalizer.py`
DONE-07	防封时段 Asia/Shanghai	`rate_limiter.py` + compose TZ
DONE-08	解封客服 Skill + REST 路由	`unblock_customer_service.py` + unified
DONE-09	E2E 脚本三组（安全/写/矩阵）	`test_wechat_full_e2e.py`
DONE-10	Type-C 一键安装脚本	`frida_workphone_oneclick.sh`

五、未完成清单（⬜ 必须闭环）

ID	任务	优先级	验收标准	落点
TODO-01	联系客服解封 A→E 真机	P0	final_status=success 留痕	§八 + `unblock_customer_service.py`
TODO-02	friend-add → 存客宝线索	P0	scenarios 200 + traffic_pool	`cunke-bao/hook/friend-add`
TODO-03	AI chat → send_message	P0	中台 ai/chat 真机收到消息	`karuo_device_ai.py`
TODO-04	朋友圈 post/like/comment 写验	P1	`--group 朋友圈写` 全绿	moments/*
TODO-05	`--full` + MATRIX_REST 全组	P1	e2e_report.json 写操作	test script
TODO-06	红包/转账小额真机	P2	0.01 元 + audit 日志	payment/*
TODO-07	设置类写操作 rate_limit	P2	单日≤3次入 rate_limiter	rate_limiter
TODO-08	四端业务切 SDK（COORD）	P0	不改本仓；对方切 env	四端对接 §五
TODO-09	`get_messages`/`get_contacts`/`get_moments` hook 取数为空	P0	真机实测：list 空但 `group/list`/`group/members`/`account/status` 真数据 → 需「先导航打开页再抓」或底层 NetScene/DB 取数	`wechat_hook_v2.js` · 设备端阿机 · 留痕 `20260529_真机E2E复跑留痕_持久会话.md`

六、私域策略（获客/消息/朋友圈/防封）

动作	interval	daily_max	备注
send_message	30–60s	200	已入 rate_limiter
batch_send	300–600s	50	工作台群发
add_friend	180–300s	50	场景获客
post_moments	2–3h	5	新号≤2/日
like_moments	15–45s	100	禁止秒赞
解封成功后 72h	—	—	禁群发/批量加

七、解封 · 联系客服（并入本文 · 原独立方案归档）

7.1 目标与边界

项	内容
目标	限制账号自动走「安全中心→联系客服」，AI 多轮对话至解封
不解决	真实违规；强人脸/身份证
退出	success / reject / max_rounds / timeout
合规	须传 `reason` 审计；禁止威胁/编造证件

7.2 五阶段状态机

S1 DETECT_STATUS → check_account_status
S2 ENTER_SAFETY_CENTER → 设置→账号与安全→安全中心
S3 FIND_CUSTOMER_SERVICE → 联系客服/申诉等文案兜底
S4 CHAT_LOOP → 抓 hierarchy → AIBrain 回复 ≤120 字 → 发送
S5 DONE → success/reject/timeout

7.3 API（已封装）

curl -X POST 'http://127.0.0.1:8899/api/v3/account/unblock-customer-service' \
  -G \
  --data-urlencode 'device_id=xgfe65eimrrofyws' \
  --data-urlencode 'platform=wechat' \
  --data-urlencode 'reason=被误判限制，未违规' \
  --data-urlencode 'max_rounds=20' \
  --data-urlencode 'chat_interval_sec=8'

代码	路径
Skill	`sdk/agent/skills/wechat/unblock_customer_service.py`
批量	`sdk/scripts/wechat_unblock_batch.py`
配置	`sdk/config/unblock_targets.example.yaml`

解封验收：路径命中 · turns[*].cs 非空 · sent_ok≥90% · 至少 1 次 success 样本（TODO-01）

八、AI 本地化控机（中台运行 · 非微信内装 APP）

自然语言 / BFF agent/execute
  → 卡若AI :3102 / Ollama :11434 / Gemini(可选)
  → {script, action, params}
  → WS execute → Frida → 微信

REST	用途
`POST /devices/{id}/ai/chat`	自然语言控机
`POST /api/v3/agent/execute`	触客宝 AI 入口
`POST /api/v3/ai/brain/execute-script`	精确 action
`GET /api/v3/ai/brain/skill-registry`	wechat 128+

十三、最终验收标准（发消息 · 收消息 · 发朋友圈）★

产品必达（P0）：真机 Type-C 连 Mac，以下三项 全部通过 才算微信模块交付；禁止 HTTP 200 但界面无变化。

13.1 发消息（send_message）

项	标准	当前
API	`POST /api/v3/message/send` 或 BFF `POST /v1/workphone/message/send` 返回 `code:200`	✅
通道	`channel_used` 含 `frida` 或 `websocket/frida`（禁止纯 mock/u2 冒充 Hook 成功）	✅ 2026-05-29
回执	`message_id` / `msg_id` 非空	✅
真机可见	目标会话（默认「文件传输助手」）出现刚发送的文本，内容与 `content` 一致	✅ 已验
存客宝路径	工作台/触客宝经 BFF 发消息，同上标准	⬜ COORD

验收命令：

SDK_DEVICE_ID=xgfe65eimrrofyws python3 sdk/tests/test_wechat_e2e.py
# 或
curl -s -X POST http://127.0.0.1:8899/api/v3/message/send \
  -H 'Content-Type: application/json' \
  -d '{"device_id":"xgfe65eimrrofyws","platform":"wechat","to_id":"文件传输助手","content":"验收发消息","msg_type":"text"}'

通过判定：JSON success + 真机聊天窗可见「验收发消息」+ 截图/留痕写入 8、部署/05-测试验收/。

13.2 收消息（get_messages · 收信息）

项	标准	当前
API	`POST /api/v3/message/list` 返回 `code:200`	✅ 安全组
数据	`messages[]` 含最近消息，`text`/`content` 非空	✅ 只读探针
真机对齐	人工向被测号发一条「验收收消息-{timestamp}」→ 再调 list → 必须能查到该条	⬜ 待验 P0
增量	支持 `since_time` / `limit`；存客宝 sync Job 可增量拉取	✅ 接口有
事件（增强）	Hook 新消息事件 → 可选推送存客宝（非 P0 阻塞）	⬜ P1

验收步骤（文档定稿 · 开发后执行）：

用另一微信号向被测机发送：验收收消息-20260529-1430
调用 message/list，conversation_id = 发件人 wxid 或备注名
断言 messages 中存在该字符串
留痕：20260529_微信收消息E2E留痕.md

失败不算通过：仅返回空数组但 HTTP 200；仅 UI 树截断无正文。

13.3 发朋友圈（post_moments · 正常发）

项	标准	当前
API	`POST /api/v3/moments/post` 或 BFF `moments/post` 返回 `code:200`	✅ 接口
通道	Frida `post_moments` 或 u2 兜底，须 `success:true`	⬜ 写验
真机可见	微信「发现→朋友圈」出现刚发内容（纯文字或文字+图）	⬜ 待验 P0
可验证	发后立即 `POST /moments/list`，列表第一条含相同 `content` 片段	⬜ 待验 P0
风控	经 `rate_limiter`；测试号 ≤2 条/日	✅ 已配
存客宝	工作台/触客宝 `moments/post` 或 `kefu/moments/add` 经 BFF 同上	⬜ COORD

验收命令：

TS=$(date +%H%M%S)
curl -s -X POST http://127.0.0.1:8899/api/v3/moments/post \
  -H 'Content-Type: application/json' \
  -d "{\"device_id\":\"xgfe65eimrrofyws\",\"platform\":\"wechat\",\"content\":\"[验收朋友圈] $TS\"}"

curl -s -X POST http://127.0.0.1:8899/api/v3/moments/list \
  -H 'Content-Type: application/json' \
  -d '{"device_id":"xgfe65eimrrofyws","platform":"wechat","limit":3}'

通过判定：list 首条含 [验收朋友圈] + 真机朋友圈页肉眼可见。

纯文字优先：首验不传 images[]，降低失败面；图片发帖为 P1。

13.4 三项总验收清单

#	能力	接口	真机	存客宝 BFF	状态
A	发消息	✅	✅ 2026-05-29 复跑 `message_id` + `channel_used:websocket/frida`	⬜ COORD	通过
B	收消息	✅	⬜ `message/list` 空（需人工入站串 + 发件人 wxid 作 conversation_id）	⬜	待人工入站闭环
C	发朋友圈	✅	🟡 post `success:true`+`auto_click_scheduled`，`moments/list` 空无法自动确认	⬜	待人工看屏 + get_moments 取数排查

真机留痕：开发文档/8、部署/05-测试验收/20260529_真机E2E复跑留痕_持久会话.md（U1 Frida 已 attach；group/list/account/status/skill 真数据 ✅；contacts/messages/moments list 当前态取数为空）

# 门禁 + 静态 + 安全组（已通过）
bash 开发文档/8、部署/05-测试验收/scripts/real_device_gate.sh
python3 sdk/scripts/wechat_interface_audit.py
SDK_DEVICE_ID=xgfe65eimrrofyws python3 sdk/tests/test_wechat_full_e2e.py

# P0 写验（开发阶段执行，本轮文档仅定义）
SDK_DEVICE_ID=xgfe65eimrrofyws python3 sdk/tests/test_wechat_full_e2e.py --group 朋友圈写
# + 人工收消息步骤 §13.2

13.5 业界参考（GitHub · 发消息可靠性）

来源	要点	本项目策略
Hook_WeChat_FaaS	Hook 点随版本变；应用版本需锁定	8.0.69 + audit 脚本
wechat_chatter	底层 NetScene/Protobuf 发消息比 UI 稳	Frida 主路径，u2 兜底
frida-mcp	AI 辅助定位 hook	中台 brain + 人工维护 hook_v2.js
看雪/社区	多开、主动调用易 crash	单开测试号；失败须显式 error

十三点六、检索成果·全功能 Hook 实现路线图（2026-05-30 WebSearch+GitHub）

用户要求「搜互联网+GitHub 完善需求」。以下为可落地的实现路径，按真机铁律逐个验证后再标 ✅。

13.6.1 GitHub 关键参考（覆盖 8.0.69）

项目	链接	价值	适配
WeKit	Ujhhgtg/WeKit	Xposed 模块，完美支持 8.0.65~8.0.72；含自动抢红包/发SILK语音/卡片消息/指纹支付/原生Hook/JS脚本引擎	⭐ 与本机 8.0.69 完全匹配，类名/方法可直接参考
wechat_chatter	yincongcyincong/wechat_chatter	tencent/mars 底层 `Req2Buf` protobuf 注入发消息（比 UI 稳）	概念通用，安卓需定位 mars 符号
Hook_WeChat_FaaS	FourTwooo/Hook_WeChat_FaaS	云函数/小程序请求响应 Hook	小程序链路
发朋友圈逆向	hktalent/MyDocs 朋友圈动态 · luoyesiqiu 博客	`sns.model.ay`+`data.j` 发图文朋友圈	类名随版本变

13.6.2 已确认的内部调用路径（需 8.0.69 jadx 校准混淆名）

能力	类/方法（参考版本）	说明
发朋友圈(文本)	`com.tencent.mm.plugin.sns.model.ay` → `$new(2)` · `.adk(desc)` · `.commit()`	7.0.11/8.0.61 验证；8.0.69 混淆名待 jadx
发朋友圈(图片)	`sns.data.j.$new(path,2)` 入 LinkedList → `ay.ey(list)` → `.commit()`	多图
读朋友圈(解 CK-T9)	`sns.model.m3.onGYNetEnd` param.args[4] → `SnsObject`→`SnsInfo`(XML)	服务器分页下发，需主动触发下一页；比 SnsMicroMsg.db(WCDB2.x) 读更可靠
抢红包/发红包	WeKit「自动抢红包」模块	参考其 hook 点
发语音	WeKit「发送 SILK/MP3 语音」	SILK 编码

13.6.3 实施前提（真机铁律）

类名校准：仓库内反编译为 8.0.56，设备为 8.0.69 → 写操作前须对 8.0.69 apk 跑 jadx 取实际混淆类/方法名（adb pull base.apk → jadx）。
逐个真机验证：每个新 RPC 真机调用见真实效果（朋友圈可见/红包到账测试号）才标 ✅，否则诚实留 companion/u2。
已落地样板：get_sticker_list（读 EmojiInfo，真机 count=20）证明「本地 DB 读类」转真 RPC 模式可行；写类/网络类按 13.6.2 路径推进。

十四、Mac + 真机 · 一键验收

# 1. 启动
bash sdk/scripts/frida_workphone_oneclick.sh -d xgfe65eimrrofyws
cd sdk && docker compose up -d

# 2. 门禁
bash 开发文档/8、部署/05-测试验收/scripts/real_device_gate.sh

# 3. 静态审计
python3 sdk/scripts/wechat_interface_audit.py

# 4. 安全组（29 action）
SDK_DEVICE_ID=xgfe65eimrrofyws python3 sdk/tests/test_wechat_full_e2e.py

# 5. 写操作（慎用）
SDK_DEVICE_ID=xgfe65eimrrofyws python3 sdk/tests/test_wechat_full_e2e.py --full

2026-05-29 真机留痕

项	结果
设备	Redmi Note 13 · `xgfe65eimrrofyws` · 微信 8.0.69
Hook probe	supports_hook=true · 96 actions / 26 modules
send_message	✅ channel_used=websocket/frida
安全组	29/29 · 100% · 78.9s
修复	Docker UTC → rate_limiter Asia/Shanghai

十五、BFF 与四端（摘要 · 详表见姊妹文档）

私域闭环	BFF → SDK
刷新好友	`GET /v1/workphone/contacts` → `GET /api/v3/contacts`
群发	`POST .../messages/batch-send` → `message/batch-send`
场景加好友	`POST .../friends/batch-add` → `friend/batch-add`
新好友	SDK `cunke-bao/hook/friend-add` → 存客宝 scenarios
触客宝 AI	`agent/execute` → 中台 → WS

完整 52 BFF + 四端分端清单 → 本文 §3.8 · COORD → §3.8.5

十六、WBS（仅工作手机仓 · 文档已定稿，开发下轮）

ID	任务	P	状态
WX-00	收消息 list 真机 E2E	P0	🔧 修复中
WX-01	解封 A→E + AI 话术	P0	⬜
WX-02	friend-add E2E	P0	代码就绪
WX-03	朋友圈 post 真机	P0	🔧 修复中
WX-04	红包小额真机	P2	⬜
WX-05	设置写限额	P2	⬜
WX-06	AI chat E2E	P0	代码就绪
WX-07	`--full` 矩阵 REST 留痕	P1	⬜
WX-08	发消息真机	P0	✅ 完成
WX-09	_intentAction 占位清零（资料/红包/解封改真实现）	P1	🔧 朋友圈已改，其余待

十七、变更记录

日期	变更
2026-05-29	初版：Hook+解封
2026-05-29	改名「全量控机与私域」；并入矩阵/解封/E2E/接口全集
2026-05-29	汇总版：声明唯一真源；128 接口状态表；已完成/未完成分列
2026-05-29	§十三四端 P0 验收矩阵交叉引用 §3.9.3
2026-05-29	代码侧复验（无真机）：128 action 静态审计缺失=0；微信离线回归（请求模型字段 / friend-add / ai-chat 编排 / 解封客服 Skill 可导入）通过；发/收/朋友圈三项接口层 ✅，真机 §13.1–13.3 待 Frida attach 后执行（U1）
2026-05-30 16:30	微信 Action 能力矩阵（诚实口径·自动生成）：新增 `sdk/scripts/gen_wechat_capability_matrix.py` → `5、接口/03-Hook与微信/微信174动作能力矩阵.md`。合并 catalog 探针(probe 假参数)+ACTION_TO_RPC+JS intent 分类，175 动作分级：✅已验直调 51 / 🟢需真实参数 1 / 🟡需测试号 7 / 🟠需UI或u2 11 / 🟠companion 73 / ⬜未映射别名 32。澄清：catalog「51/174 通过」是占位参数探针结果，写操作 success:false 属正常（CK-T12 诚实化），非代码缺陷；真实可用=读类即调+写类传真实参数。设备在线 supports_hook:true（8.0.69）。下一步：companion-intent 中可 DB/protobuf 读的动作（登录设备/钱包/步数等）改真 Frida RPC
2026-05-29	真机复跑（持久会话 ct_176e358c，U1 已解除）：§13.1 发消息 ✅ PASS（msg_id+frida 通道）；§13.3 朋友圈 post `success:true` 但 list 空 = 🟡 PARTIAL；§13.2 收消息 list 空 = ⬜（需人工入站）；旁证 group/list+account/status+skill(211) 真数据。留痕 `8、部署/05-测试验收/20260529_真机E2E复跑留痕_持久会话.md`

归档并入本文：设备-微信*.md · 微信Hook与解封 · 微信全功能矩阵（接口表）· 微信解封_联系客服自动化方案 · 20260529_微信真机E2E留痕

27 KiB Raw Blame History Unescape Escape