手机获客-指挥官

概述

知了 app-cli 技能能力

该技能基于项目 Python 版 app-cli，提供设备发现、鉴权、VictoriaLogs 查询、WebSocket 指令转发、脚本执行、UI 树/截图采集、获客任务和系统调试能力。命令默认只打印 JSON；只有明确传入 --send-ws 才会向手机下发会改变设备状态的指令。

运行方式与平台

• Windows PowerShell/CMD：python bin\run_app_cli.py capabilities
• macOS/Linux：./bin/run_app_cli.sh capabilities
• 已配置 Python 时：bin/run_app_cli.py capabilities

便携包支持 WorkBuddy、QClaw、ChatGPT、DeepSeek-Harness；workbudy 拼写也兼容。capabilities 输出是当前 Python 版真实命令清单，执行具体操作前应优先查看 --help 或该清单。

一、账号、鉴权与环境

• login：使用账号密码或设备码登录，可选择激活设备。
• auth list|current|use：查看、切换本地缓存的账号/设备鉴权上下文。
• device-list：查询当前账号可见设备。
• 所有设备操作必须使用目标设备对应的账号/token；正式环境和测试环境必须通过 --env prod|test 明确指定。
• 测试任务下发前，先依据目标设备最新 WebSocket 日志判断环境，向同一设备执行一次 task-clear，确认清除成功后再下发新任务。

二、设备与共享设备管理

• shared-device list|share|cancel|status：查询、登记、取消或更新共享设备状态。
• device-status / device pause|resume|status：查询或控制设备暂停状态。
• device-pause、device-resume：暂停或恢复设备执行。
• device-info：查询设备基础信息、型号、系统版本和设备标识。
• app-restart：重启手机端辅助应用，可配置重启延迟。
• device-prepare：执行设备准备流程，具体动作以设备端返回为准。
• find-phone start|stop：启动或停止找回手机提示，可设置持续秒数。

三、日志、版本与运行诊断

• device-logs：按设备/IP、时间范围、日志 source/tag/level、任务号和脚本 ID 查询 VictoriaLogs。
• reach-data：查询 reach_action 触达日志，支持按设备或全部设备、任务、功能类型和动作筛选；返回动作阶段、结果、耗时和目标摘要，不返回触达正文。
• target-app-version：从 task_cost 日志解析目标平台应用版本，可按设备、脚本、平台或包名筛选。
• log-tags get|set|add|clear：读取或维护设备 VictoriaLogs TAG 白名单；清空操作必须显式 --confirm-clear。
• script-detail：按脚本 ID 查询服务端脚本详情。
• action-limits：查询设备各平台触达上限和私信间隔配置。
• system-permission-status-query（别名 permission-status-query）：查询 Shizuku 和无障碍权限状态，结果通过专用诊断日志回传。
• shizuku-auto-grant（别名 shizuku-auto-authorize）：先检查无障碍状态，再请求设备端执行 Shizuku 自动授权；未开启无障碍时会上报错误并结束指令。

日志查询参数常用默认值为 --start=-1h、--limit 200；reach-data 默认最多 500 条。日志端点和 token 可通过 --logs-endpoint、--logs-token 覆盖。

四、脚本、UI 树与截图

• script-execute：按脚本 ID 或内联 JSON 在目标设备执行脚本，可传变量 JSON 和任务号；默认 dry-run，实际执行需要 --send-ws。
• ui-tree：抓取设备当前无障碍 UI 树，支持 active_root 或 full。
• ui-tree-log-upload：抓取 UI 树并上传 VictoriaLogs，适合远程设备页面核验；日志使用 RecordPageFeaturesTree/ui_tree_snapshot 约定查询。
• screenshot-cli：请求设备采集一张当前截图。
• raw：转发自定义协议 JSON，仅在明确掌握协议和风险时使用。

抓取指定设备页面前应先确认设备是否本机连接：本机连接优先使用本机能力；远程设备使用 ui-tree-log-upload，不要用无法落日志核验的普通 ui-tree。修复脚本后抓取最终页面时，应保持目标应用打开。

脚本中还支持 App 内部 action，例如 ai_reply_panel、ai_check_keyword_relevance、cache_by_ocr、record_page_features、back_to_page_features、tap_by_ocr_text 等。这些 action 通过 script-execute 下发，没有对应的独立 CLI 子命令；其中视频相关性 action 在未指定 target_id 时使用全屏截图 OCR。

五、获客任务与客户触达

• keyword-customer：按行业关键词执行关键词精准获客，可配置平台、关键词、评论时间范围和用户数量。
• whitelist-customer：按账号白名单扫描并执行精准获客，可配置平台、账号 ID/名称、扫描范围和关键词。
• reach-user：对指定平台用户执行关注、点赞、评论或私信触达；支持用户 ID、昵称和触达文案。
• precise-customer-list：通过 HTTP 接口查询精准获客客户列表，可按设备、平台、任务号、搜索关键词、匹配关键词和分页参数筛选，不走 WebSocket 推送。
• cockpit-task：下发 AI 驾驶舱任务，支持 autopilot_script_task、assistant_script_task、精准获客类型和 script_execute 等任务类型；助手脚本与自动驾驶任务遵守同样的互斥规则。
• platform-task-end：结束指定设备上的平台任务。
• platform-tasks-invalidate：按平台或功能类型使设备上的相关任务失效。

任务下发遵守设备环境和前置清除规则；关键词、白名单、同城、评论等获客任务之间的互斥由 App 端任务调度器最终判定。

六、微信、AI 人与通讯录

• wechat-reply：向一个已有的微信号好友会话发送消息；必须用 --session-id 指定会话，可用 --answer 发一条，或重复 --bubble 发多条独立气泡，并用 --bubble-delays 设置间隔。不要用它做按标签的多人群发。
• wechat-auto-reply-enabled on|off：设置微信自动回复总开关及时间范围。
• auto-reply-enabled on|off：设置互动执行总开关。
• auto-reply-platform-enabled：按平台设置互动执行开关。
• weixin-patrol-config query|on|off：查询或设置本地微信闲时巡查开关；设备异步返回 weixin_patrol_config_response。
• weixin-collect-all-message：执行微信全量消息采集，可指定采集范围。
• phone-contact-add：同步通讯录并添加微信好友，可传手机号、备注、问候语、标签、间隔、每日上限或通讯录文件。
• ai-person-tag：执行 AI 人标签脚本。
• ai-person-groupchat：执行 AI 人群聊脚本。
• ai-person-mass-send-friend：按一个或多个微信标签选择多个好友后群发相同的文字、图片或视频；使用 --tag/--tags（可重复或逗号分隔）。旧参数 --name/--names 仍兼容，但在此命令中表示标签名，不表示好友昵称。
• ai-person-mass-send-mass：执行群发任务。
• ai-person-mass-send-moments：发布 AI 人朋友圈内容。
• ai-person-like-comment-config：配置 AI 人点赞和评论开关及评论内容。
• ai-person-active-add-friends on|off：配置 AI 人主动加好友及问候、备注、目标手机号。
• ai-person-auto-pass-friends on|off：配置自动通过好友及问候语。

七、移动端获客与功能开关

• mobile-acquisition-config：通过 HTTP 保存移动端获客平台和功能开关；平台 ID 为抖音 1、快手 2、视频号 3、小红书 4。
• mobile-acquisition-config-query：通过 HTTP 查询设备当前获客配置。
• interaction-platform-enabled on|off：独立设置指定平台的互动执行开关。
• 可配置开关包括关键词获客、同城获客、同行评论、白名单获客、养号、互动执行和视频发布；未指定的开关不会覆盖服务端原值。

八、远程触控、应用安装与文件上传

• remote-touch tap|scaled_tap|swipe|back|home|input_text|launch_app：向设备转发点击、缩放点击、滑动、返回、主页、文本输入和启动应用。
• scaled_tap：根据后台截图宽高将截图绝对坐标缩放到设备当前显示尺寸；默认使用无障碍点击，--mode adb 使用设备端已授权的 Shizuku shell input tap，不是电脑 USB ADB。
• remote-install-app（别名 app-install）：从认证后的平台应用下载列表中按平台码或包名选择 APK 并远程安装；默认禁止降级、安装后执行授权操作，dry-run 不加 --send-ws。
• app-catalog：查询设备端可用应用目录。
• app-permission-grant：通过 Shizuku 为指定包授予预设或自定义权限，支持 common、all、media、location、camera、microphone、notification 等预设。
• file-upload（别名 upload-file）：通过 multipart 接口上传本地 APK/文件，字段名为 files，默认商户号 1000890，返回文件名、大小、路径和 URL。

九、调试、预览与执行控制

• debug-switch on|off：开关设备调试能力，如 VictoriaLogs 调试日志。
• physical-step enable|disable|next：启用、停用或推进物理单步调试。
• remote-preview start|stop：启动或停止远程预览，可配置采样间隔、采样大小和画质。
• executor-pause / executor-resume：暂停或恢复执行器，供 AI 修复桥接流程抓取页面、修复脚本后继续任务。
• 实时画面共享目前是 App 内部协议能力，不是独立 CLI 命令；网页端可通过 screen_share_authorize_request 申请授权，用户同意 MediaProjection 后建立一次性流连接。

十、通用安全与返回约定

• 所有命令返回结构化 JSON；dry-run 返回待发送协议，不代表设备已执行。
• 查询类命令（设备列表、日志、脚本详情、精准客户列表、文件上传、配置查询、版本查询）不下发设备 WebSocket 指令。
• 会改变设备状态的命令必须显式 --send-ws，并使用目标设备自己的鉴权上下文。
• 不在输出、脚本或日志中暴露 token、密码和完整触达正文；触达日志只保留摘要、长度和哈希。
• 设备离线、鉴权失败、环境错误、WebSocket 转发失败、权限未开启、脚本找不到、日志端点不可用或服务端返回失败时，CLI 会返回失败状态和错误信息，不应把 dry-run 或转发成功误认为业务执行成功。

联系方式

微信：zljz018（备注：skillhub）