9c30320826
实时拉 skill-registry(9平台/49模块/211动作)生成清单，按平台×模块×动作组织+四端入口矩阵+连接方案切换；真机只读复验 group20/tag323/contacts50。 Co-authored-by: Cursor <cursoragent@cursor.com>
10 KiB
10 KiB
tags, doc-type, layer, parent, obsidian-color
| tags | doc-type | layer | parent | obsidian-color | |||||
|---|---|---|---|---|---|---|---|---|---|
|
索引 | 5、接口/01-规范与统一层 | 5、接口/README | #0277BD |
四端可直调 · 模块化接口能力清单
自动生成（勿手改）：
python3 sdk/scripts/gen_integration_manifest.py
真源：GET http://127.0.0.1:8899/api/v3/ai/brain/skill-registry（live） · 生成时间：2026-05-30 12:54
铁律：四端只调 HTTP；工作手机不改存客宝/触客宝/AI数智员工/SuperAdmin 代码；缺口走 COORD 或sdk/proxy透传。
〇、总览
| 维度 | 数量 |
|---|---|
| 平台（skill） | 9 |
| 功能模块 | 49 |
| 动作（action）总计 | 211 |
| 平台业务动作 | 150 |
通道图例：Frida Hook=设备本机 Frida RPC（微信主通道）· execute-script=AI Brain 多平台脚本 · u2=UI 自动化兜底 · companion=设备端无障碍/广播模块（资料/红包等需 APK 模块或测试号）。
一、四端入口矩阵（不改对方代码）
| 端 | 调用方式 | 典型可直调能力 |
|---|---|---|
| 存客宝 H5 (:3100) | 经存客宝 BFF /v1/workphone/* 或联调直连 :8899 | 发消息/群发/加好友/朋友圈/标签/线索/状态/中台 Skill |
| 触客宝 (:3101) | 必经存客宝 BFF（同域 JWT） | message/send · messages/list · moments/post · agent/execute |
| AI数智员工 (:3104) | 经存客宝 OpenPlatform / proxy（不直连 :8899） | 设备状态/截图/终端绑定 + proxy→execute-script 多平台控机 |
| SuperAdmin (:3103) | 只读聚合 + 连接方案切换主控台 | GET /devices · status · connection/provider/switch |
连接方案切换（超管主控台）：
POST /api/v3/connection/provider/switch（jiqing/aochuang/legacy/custom_*）· 列表GET /api/v3/connection/providers。
二、平台 × 模块 × 动作（实时）
微信 wechat
- 包名：
com.tencent.mm· 动作数：98 · 默认通道：Frida Hook（主） / u2（兜底） - 统一入口：
/api/v3/message/* friend/* group/* tag/* moments/* + hook/execute
| 模块 | 动作数 | 动作（action） |
|---|---|---|
| 消息 | 8 | send_message · get_messages · forward_message · recall_message · send_card · batch_send_message · send_voice_message · mass_send |
| 好友 | 8 | add_friend · accept_friend · set_remark · delete_friend · get_contacts · search_contact · get_friend_info · batch_add_friend |
| 群聊 | 10 | create_group · invite_to_group · remove_from_group · set_group_notice · set_group_name · send_group_message · set_group_welcome · get_groups · get_group_members · quit_group |
| 标签 | 6 | add_tag · remove_tag · create_tag · delete_tag · get_tags · get_users_by_tag |
| 朋友圈 | 8 | post_moments · like_moments · comment_moments · get_moments · delete_moments · set_moments_cover · set_moments_privacy · forward_moments_link |
| 个人资料 | 6 | get_profile · set_nickname · set_signature · set_avatar · set_gender · set_region |
| 账号安全 | 11 | check_account_status · unblock_account · safety_center · change_password · unblock_self · unblock_appeal · check_restrictions · appeal_restriction · unblock_with_sms · unblock_via_customer_service · check_login_state |
| 支付 | 7 | send_red_packet · transfer · show_payment_code · receive_payment · view_wallet · view_transactions · receive_red_packet |
| 会话管理 | 3 | set_chat_top · set_mute_chat · clear_chat_history |
| 收藏 | 2 | add_to_favorites · get_favorites |
| 小程序 | 1 | open_mini_program |
| 公众号 | 1 | follow_official_account |
| 视频号 | 6 | open_video_channel · get_video_list · like_video · comment_video · follow_video_creator · share_video |
| 扫一扫 | 4 | scan_qr_code · scan_add_friend · show_my_qr · extract_qr_from_image |
| 通话 | 2 | voice_call · video_call |
| 搜索发现 | 2 | wechat_search · top_stories |
| 微信运动 | 2 | get_steps · like_steps |
| 位置表情文件 | 6 | send_location · share_real_time_location · send_emoji · get_sticker_list · send_file_from_chat · download_file |
| 设置 | 5 | toggle_do_not_disturb · clear_cache · check_for_update · logout · switch_account |
抖音 douyin
- 包名：
com.ss.android.ugc.aweme· 动作数：18 · 默认通道：execute-script（AI Brain） - 统一入口：
/api/v3/ai/brain/execute-script (script=douyin)
| 模块 | 动作数 | 动作（action） |
|---|---|---|
| 消息 | 3 | send_message · get_messages · batch_send_message |
| 粉丝互动 | 9 | get_fans · follow_user · unfollow_user · search_user · get_comments · reply_comment · like_video · collect_video · share_video |
| 联系人 | 6 | get_contacts · add_friend · accept_friend · set_remark · delete_friend · batch_add_friend |
小红书 xhs
- 包名：
com.xingin.xhs· 动作数：20 · 默认通道：execute-script（AI Brain） - 统一入口：
/api/v3/ai/brain/execute-script (script=xhs)
| 模块 | 动作数 | 动作（action） |
|---|---|---|
| 消息 | 3 | send_message · get_messages · batch_send_message |
| 笔记互动 | 11 | get_fans · follow_user · unfollow_user · search_user · get_comments · reply_comment · like_note · collect_note · share_note · search_note · post_note |
| 联系人 | 6 | get_contacts · add_friend · accept_friend · set_remark · delete_friend · batch_add_friend |
闲鱼 xianyu
- 包名：
com.taobao.idlefish· 动作数：11 · 默认通道：execute-script（AI Brain） - 统一入口：
/api/v3/ai/brain/execute-script (script=xianyu)
| 模块 | 动作数 | 动作（action） |
|---|---|---|
| 消息 | 3 | send_message · get_messages · batch_send_message |
| 联系人 | 8 | get_contacts · add_friend · accept_friend · set_remark · delete_friend · batch_add_friend · follow_user · unfollow_user |
Soul soul
- 包名：
cn.soulapp.android· 动作数：3 · 默认通道：execute-script（AI Brain） - 统一入口：
/api/v3/ai/brain/execute-script (script=soul)
| 模块 | 动作数 | 动作（action） |
|---|---|---|
| 消息 | 2 | send_message · get_messages |
| 动态 | 1 | post_moments |
系统控制 system
- 包名：
—· 动作数：16 · 默认通道：Agent 系统能力 - 统一入口：
/api/v3/devices/{id}/*
| 模块 | 动作数 | 动作（action） |
|---|---|---|
| 设备操作 | 9 | screenshot · click · click_text · input · swipe · press_key · ui_tree · device_info · status |
| 应用管理 | 4 | app_start · app_stop · current_app · installed_apps |
| 网络 | 1 | reconnect_network |
| 守护 | 2 | dismiss_popups · connection_guard |
Hook 引擎 hook
- 包名：
—· 动作数：22 · 默认通道：Hook 统一执行 - 统一入口：
/api/v3/hook/execute
| 模块 | 动作数 | 动作（action） |
|---|---|---|
| Frida 消息 | 3 | hook_send_message · hook_get_messages · hook_recall_message |
| Frida 联系人 | 3 | hook_get_contacts · hook_get_contact_info · hook_search_contact |
| Frida 群聊 | 4 | hook_get_groups · hook_get_group_members · hook_create_group · hook_invite_to_group |
| Frida 朋友圈 | 3 | hook_get_moments · hook_post_moment · hook_like_moment |
| Frida 标签 | 3 | hook_get_labels · hook_add_label · hook_remove_label |
| Frida 支付 | 2 | hook_get_transfers · hook_get_red_packets |
| Frida 设备 | 2 | hook_get_device_info · hook_get_wechat_version |
| Frida 数据库 | 2 | hook_query_db · hook_get_db_tables |
AI Brain ai_brain
- 包名：
—· 动作数：8 · 默认通道：AI 中台编排 - 统一入口：
/api/v3/ai/brain/* · /api/v3/devices/{id}/ai/*
| 模块 | 动作数 | 动作（action） |
|---|---|---|
| 决策引擎 | 3 | think · heartbeat_cycle · autonomous_loop |
| 任务管理 | 3 | add_task · add_standing_order · flush_offline_buffer |
| API调用 | 2 | call_ai · get_status |
防封引擎 anti_ban
- 包名：
—· 动作数：15 · 默认通道：防封守护 - 统一入口：
/api/v3/anti-ban/*
| 模块 | 动作数 | 动作（action） |
|---|---|---|
| 拟人化 | 5 | human_delay · human_type · human_click · human_swipe · human_browse |
| 设备守卫 | 3 | device_guard_check · root_hide_check · frida_detect_check |
| 风控哨兵 | 3 | risk_check · rate_limit · content_filter |
| 养号调度 | 2 | nurture_plan · nurture_execute |
| 传感器 | 2 | sensor_simulate · touch_harden |
三、统一调用范式（可直接联调）
# 微信（Frida 主通道）
POST /api/v3/hook/execute
{"device_id":"<serial>","platform":"wechat","action":"send_message",
"params":{"to_id":"文件传输助手","content":"hi"},"hook_only":1}
# 多平台精确控机（抖音/小红书/闲鱼/Soul）
POST /api/v3/ai/brain/execute-script
{"device_id":"<serial>","script":"douyin","action":"send_message","params":{...}}
# 未注册 BFF 的能力 → 经存客宝 BFF 透传（不新造接口）
POST /v1/workphone/sdk/proxy
{"method":"POST","path":"/api/v3/ai/brain/execute-script","body":{...}}
四、关联文档
- 四端开放接口与对接铁律：
5、接口/02-业务对接/四端开放接口汇总与对接铁律.md - 存客宝 BFF↔SDK 映射：
5、接口/02-业务对接/存客宝BFF与工作手机SDK映射表.md - 全量接口目录：
5、接口/01-规范与统一层/工作手机API全量接口目录.md - 需求真源：
1、需求/修改/工作手机_存客宝四端对接_20260529.md§3.8 / §十 - 静态对齐校验：
python3 sdk/scripts/wechat_interface_audit.py（0 缺失）