Skip to content

使用指南

系统要求

项目要求
操作系统macOS 12+ / Windows 10 / 11(64 位)
内存8 GB 及以上
磁盘空间500 MB 及以上
网络需要访问服务端地址

Android 任务额外要求

项目要求
USB 数据线支持数据传输(非仅充电线)
手机系统Android 7.0 及以上
USB 调试已开启
USB 驱动已安装手机厂商驱动或 Google USB Driver

安装客户端

  1. 前往 下载页面 下载对应平台的安装包
  2. 安装客户端
    • Windows:双击运行安装程序,选择安装目录,点击安装。安装完成后桌面会生成快捷方式
    • macOS:双击 DMG 文件,将应用拖入 Applications 文件夹

下载提示(Windows)

由于安装包未携带数字证书,浏览器可能会将其标记为不安全文件而阻止下载:

  • Edge 浏览器:下载被阻止时,点击下载栏右侧的「···」按钮,点击保留,点击删除按钮旁边的向下箭头 ▾,选择「仍然保留」
  • Chrome 浏览器:下载被阻止时,点击下载栏中的「保留危险文件」或点击箭头选择「仍要保留」

安装提示(Windows)

安装过程中,Windows 智能应用控制可能会拦截安装程序。解决办法:在底部任务栏搜索框中搜索「智能应用控制」,在弹出的设置窗口中关闭智能应用控制开关,然后重新运行安装程序。

TIP

客户端已内置 ADB 工具和浏览器,无需额外安装。

macOS Gatekeeper 提示

首次打开时,macOS 可能会阻止运行,提示"无法验证开发者"。解决方法:右键点击应用 → 选择「打开」→ 在弹窗中点击「打开」。或者在终端执行:xattr -cr /Applications/语言驱动.app

登录

  1. 启动客户端,进入登录页面
  2. 输入用户名和密码
  3. 点击「登录」

WARNING

账号由管理员创建,客户端不支持注册。如无账号请联系管理员。

创建应用(自定义应用)

在左侧导航栏点击「创建应用」,填写以下内容:

字段说明
应用名称必填
平台选填。Android / 网页 / 桌面 三选一;留空 = 多平台应用,可在同一流程中同时操作浏览器、手机、桌面
应用描述选填。同时作为 AI 生成流程的提示词

点击「创建应用」:

  • 应用描述非空 → 自动调用 AI 生成流程后创建应用。平台未选择时,请在描述中明确操作平台类型(web 网页 / android 手机 / pc 桌面 / 多平台混合),AI 会按描述推断各步骤所属平台并选用对应指令。生成失败时提供两个按钮:「重试AI创建应用」「直接创建空应用」
  • 应用描述留空 → 跳过 AI 生成,直接创建空应用,进入编辑器手动设计流程

创建成功后自动进入流程编辑器,可继续调整 AI 生成的流程或从零编排。

录制生成(屏幕录制生成流程)

创建应用页的「录制生成」Tab 支持边操作边录制自动生成流程:

  1. 选择平台:
    • 网页:填写站点标识 + 选择账号(指纹浏览器与登录态)→ 点击「开始录制」→ 客户端打开录制浏览器
    • Android:选择手机设备 → 点击「开始录制」→ 打开投屏窗口
  2. 在浏览器/手机中正常操作:点击、输入、页面跳转都会被捕获
  3. 需要把"看数据"加进流程时,点击「标记单值查询」(AI 查询)或「标记列表查询」(提取列表数据),在页面上点选要提取的元素/列表行字段
  4. 点击「停止录制」→ 时间线展示捕获的操作,取消勾选可剔除误操作
  5. 点击「生成流程并创建应用」→ 服务端按事件规则生成流程(步骤名由 AI 整理,失败时自动降级),进入编辑器可继续调整

说明:录制值直接写入步骤参数(如搜索词"美食"),可在编辑器中改为变量;密码输入不记录明文;生成结果基于事件数据(选择器 + 输入值),无视频上传。

运行 Android 任务

第一步:连接手机

  1. 使用 USB 数据线将手机连接到电脑
  2. 确保手机已开启 USB 调试:
    • 进入「设置 → 关于手机」→ 连续点击「版本号」7 次开启开发者选项
    • 进入「设置 → 开发者选项」→ 开启「USB 调试」
  3. 手机弹出「允许 USB 调试」对话框时,点击确认
  4. 确保连接模式为文件传输(MTP),而非仅充电

第二步:安装应用

  1. 在左侧导航栏点击「应用市场」
  2. 找到需要的 Android 应用,点击「安装」
  3. 安装完成后,切换到「我的应用」查看已安装的应用

第三步:运行任务

  1. 在「我的应用」中,点击应用卡片上的「运行」按钮
  2. 在「运行任务」标签页中填写运行参数并选择设备
  3. 点击「启动任务」

运行参数说明

不同应用的运行参数略有差异,以下逐一说明。网页版应用的参数与对应的 Android 版完全一致。

搜索关键词(必填)

在目标 App 中搜索时使用的关键词。例如填写「装修」则会搜索与装修相关的内容。

  • 适用应用:抖音视频评论、抖音直播加关注、抖音评论回复、小红书搜索笔记并评论
  • 类型:文本,不能为空

排序方式

搜索结果的排序方式,默认为「综合排序」。

选项说明
综合排序平台默认排序,综合相关度和热度
最新发布按发布时间从新到旧排列
最多点赞按点赞数量从高到低排列

小红书额外支持:最多评论(按评论数量)、最多收藏(按收藏数量)。

  • 适用应用:抖音视频评论、抖音评论回复、小红书搜索笔记并评论

发布时间

筛选搜索结果的发布时间范围,默认为「不限」。

选项说明
不限不限制发布时间,显示所有结果
一天内仅显示最近 24 小时内发布的内容
一周内仅显示最近 7 天内发布的内容
半年内仅显示最近 6 个月内发布的内容
  • 适用应用:抖音视频评论、小红书搜索笔记并评论

搜索范围

限制搜索结果的范围,默认为「不限」。

选项说明(抖音)说明(小红书)
不限不限制范围不限制范围
关注的人 / 已关注仅显示已关注用户的内容仅显示已关注用户的内容
最近看过 / 已看过仅显示最近浏览过的内容仅显示浏览过的内容
还未看过 / 未看过仅显示尚未浏览过的内容仅显示未浏览过的内容
  • 适用应用:抖音视频评论、小红书搜索笔记并评论

最大浏览视频数

任务运行期间最多浏览的视频(或直播/笔记)数量。浏览到指定数量后任务自动结束。

  • 默认值:50
  • 取值范围:1 ~ 1000
  • 适用应用:抖音视频评论、抖音直播加关注、抖音评论回复、小红书搜索笔记并评论

每视频最大评论数

每个视频(或笔记)中最多抓取并分析的评论数量。设置越大,每个视频处理的评论越多,但单个视频耗时也越长。

  • 默认值:20
  • 取值范围:1 及以上
  • 适用应用:抖音视频评论、小红书搜索笔记并评论

每视频最大回复数

每个视频(或笔记)中,对意向客户最多发送的回复条数。设为 0 则不发送任何回复,仅关注和记录意向客户。

  • 默认值:1
  • 取值范围:0 ~ 20
  • 适用应用:抖音视频评论、小红书搜索笔记并评论

每日最大关注数

每天最多关注的目标用户数量。达到上限后当天不再执行关注操作,次日自动重置。此参数用于控制操作频率,避免被平台风控。

  • 默认值:50
  • 取值范围:0 及以上
  • 适用应用:抖音视频评论、抖音直播加关注、小红书搜索笔记并评论

每日最大回复数

每天最多发送的回复(评论回复或私信)数量。达到上限后当天不再发送回复,次日自动重置。

  • 默认值:50
  • 取值范围:0 及以上
  • 适用应用:抖音视频评论、抖音评论回复、抖音私信回复、小红书搜索笔记并评论

LLM 自定义提示词(llmPrompt)

llmPrompt 是意向判断和自动回复的核心参数,决定了 AI 如何识别意向客户以及生成怎样的回复话术。不填则使用默认逻辑。

  • 适用应用:所有应用

建议:可以通过豆包、ChatGPT 等大模型来生成 llmPrompt 初稿,然后根据自己的业务需求做修改。

示例(获客场景)

【角色设定】
你是一位拥有10年经验的B2B销售专家和潜在客户挖掘顾问。你的核心能力是通过分析社交媒体上的用户评论,精准识别出哪些评论发布者是你的目标潜在客户。

【业务背景】
我正在寻找需要"自动化精准获客解决方案"的企业或团队。我的目标客户通常具有以下特征:
有强烈的获客需求(如抱怨获客难、成本高、线索不精准)。
对营销工具、CRM、私域流量、AI营销、销售自动化等话题感兴趣。
身份可能是企业主、市场总监、销售主管、运营人员或创业者。

【任务目标】
请分析我提供的【用户评论内容】,判断该用户是否值得我进一步联系和转化,并给出意向等级和评分。

【判断标准与评分细则】
请基于以下维度将用户分为高、中、低三个意向等级,并给出0-10分的评分:
1、高意向(8-10分):
痛点极度明确(如直接抱怨"人工加好友太慢"、"线索太贵"、"求推荐自动化工具")。
身份高度匹配(明确是老板、市场/销售负责人)。
有明确的行动信号(正在寻找解决方案、对比竞品、询问价格)。
2、中意向(5-7分):
有相关痛点,但不够紧迫(如讨论"最近流量变差了"、"运营好累")。
3、低意向(0-4分):
纯闲聊、打广告、与获客/营销完全无关的内容。
身份不符(如学生、求职者、完全无关行业的吃瓜群众)。
负面情绪过重或明显是竞品的水军。
对行业话题感兴趣,但没有直接表达购买或寻找工具的意愿。
提供获客工具的同行竞争者。

【回复话术要求】
要求包含"我有AI智能获客Agent,可以自动化、规模化、智能化精准找到意向客户,欢迎私信了解详情及获取试用账号",再根据用户评论稍作润色:
请尽量模拟人的回复和随和,不要太像机器人、不要太过生硬,比如"私信领试用"就是太像机器人了,最好是"欢迎私信了解及获取试用账号哈"。

获取分享链接

是否在浏览视频时获取每个视频的分享链接。开启后,输出数据中会包含视频分享 URL。

  • 默认值:关闭
  • 适用应用:抖音视频评论、小红书搜索笔记并评论

各应用参数一览

参数抖音视频评论抖音直播加关注抖音评论回复抖音私信回复小红书笔记评论
搜索关键词✓ 必填✓ 必填✓ 必填✓ 必填
排序方式
发布时间
搜索范围
最大浏览数
每内容最大评论数
每内容最大回复数
每日最大关注数
每日最大回复数
LLM 自定义提示词
获取分享链接

任务运行中

  • 任务启动后,手机上将自动执行 AI 驱动的操作
  • 页面顶部显示任务状态标签:运行中、重连中、停止中等
  • 统计标签实时更新:浏览数、评论数、关注数、回复数、意向客户数
  • 如需中止,点击「停止任务」

运行网页任务

站点说明

网页应用的「站点」在运行期选择(应用创建时不再填写),它决定:

  • 站点标识(site):打开浏览器使用的指纹,以及登录信息的保存位置。同站点同账号会自动复用已保存的登录态(指纹一致,避免触发平台风控)
  • 站点URL(site_url):打开浏览器后跳转到该地址进行登录/操作可留空——留空时登录/捕获/校验场景会打开空白浏览器,由你手动输入目标网址

选择已有站点(本地已保存过登录态的站点)或手动输入新站点均可;不选账号时以「游客」身份运行(独立指纹、无登录态)。

一个应用操作多个站点:运行表单选择的是任务的默认站点;流程中的「启动浏览器 / 导航到URL」步骤可以带 site 参数(站点写死在流程里)切换到其它站点的指纹浏览器与登录态,accountName 参数(可填运行参数/变量)选择该站点账号。切换时旧浏览器保留后台运行,需要关闭时在切换前放一步「关闭浏览器」(自动保存登录态)。详见《流程编辑器指南》浏览器操作章节。

第一步:安装应用

  1. 在「应用市场」中找到需要的网页应用,点击「安装」

第二步:选择站点并添加登录账号

网页任务需要先保存网站登录状态,任务运行时将自动使用已保存的账号。

  1. 在「我的应用」中,点击应用的「运行」按钮
  2. 在「运行任务」标签页的「目标站点」区域,选择或输入站点标识(如 抖音),站点URL 自动带出、可修改
  3. 在「账号选择」区域,点击「添加账号」
  4. 在弹出的对话框中:
    • 站点:自动带出所选站点,无需修改
    • 账号名:输入便于识别的名称(如 douyin_yy01),仅支持字母、数字、中文
    • 代理(可选):如需使用代理,输入代理地址,格式 http://用户名:密码@代理地址:端口
  5. 点击「打开浏览器登录」
  6. 客户端会自动打开浏览器窗口,在浏览器中手动完成网站登录
  7. 登录成功后,回到客户端点击「完成登录」
  8. 系统自动保存登录状态(按「站点 + 账号」归档),下次同站点同账号运行时无需再次登录

TIP

同一个站点可以添加多个账号,运行任务时选择需要的账号即可。流程编辑器中捕获元素、校验选择器、测试运行同样需要先选择站点与账号。

第三步:运行任务

  1. 在「运行任务」标签页中:
    • 目标站点:选择或输入站点标识与站点URL(切换站点会清空已选账号)
    • 运行参数:填写任务参数(参数说明同 Android 任务)
    • 账号选择:从下拉框中选择该站点已登录的账号
  2. 点击「启动任务」
  3. 客户端自动打开浏览器窗口并开始执行任务

任务运行中

  • 浏览器窗口会自动执行操作,请勿手动操作浏览器
  • 如需暂停或中止,点击「停止任务」
  • 浏览器在任务完成后会保持空闲状态一段时间(约 60 分钟),下次运行同账号任务时可直接复用,减少启动时间

运行多平台应用

平台留空创建的应用为多平台应用,一个流程可以混合操作浏览器、手机、桌面。

运行表单

运行表单的设备/站点/账号参数按流程步骤动态生成

  • 手机设备:流程包含「启动应用 / 设备滑动」等手机步骤时显示(必选)
  • 站点与账号:流程中的每个站点(「启动浏览器 / 切换浏览器 / 导航到URL」步骤写死的站点标识)生成一行「站点(固定显示)+ 账号选择」,账号可空
  • 流程中账号留空的浏览器指令,运行时将使用此处为该站点选择的账号;不选 = 游客模式
  • 桌面步骤无需选择(自动控制本机)

流程中的设备切换

AI 操作步骤(AI 点击、AI 输入、AI 滚动等)作用于当前设备

步骤执行后当前设备
启动浏览器(browserLaunch)浏览器
切换浏览器(browserSwitch)浏览器(复用该站点后台窗口,不导航)
启动应用(launchApp)Android 手机
打开软件(computerLaunchApp)/ 电脑操作(computerMouseClick 等 computer*)PC 桌面

每个 AI 操作步骤之前必须有对应平台的启动步骤明确操作对象,否则运行时报错提示。切换设备只需执行另一平台的启动步骤;同一平台的连续操作无需重复启动。

AI 操作等步骤也可直接设置「操作平台」参数(自动/浏览器/手机/桌面)显式指定操作对象,无需前置启动步骤切换(详见《流程编辑器指南》多平台混合流程章节)。

定时任务目标(分片)

多平台应用的定时任务目标为分片列表,每个分片由一台客户端并行执行整个流程

  • 每站点账号:站点列表按流程步骤动态生成,每个站点可选一个账号(浏览器步骤使用其指纹与登录态)
  • 手机设备(可选):流程含手机步骤时选择
  • 桌面设备:从在线客户端自动枚举(每台运行客户端的电脑 = 一个桌面设备,以电脑名标识并显示)——流程含桌面步骤(computer* 指令)时每个分片必选;流程用 AI 指令(aiAct 等)操作桌面软件、或需要指定桌面执行机时,可手动选择;选中的电脑执行该分片(包括其中的桌面步骤),未选择时分片按账号/设备路由(全空时为本机桌面)
  • 分片的桌面设备、手机设备、站点账号必须位于同一台客户端电脑,否则创建调度时报错
  • 注意:桌面设备以电脑名标识,电脑改名后已保存调度中的该桌面设备失效(保存/执行时报「桌面设备不在线」),需重新编辑调度重新选择
  • 分片内账号与设备都未选择时(流程不含桌面步骤),该分片目标为本机桌面;可添加多个分片实现多客户端并行

任务目标特殊标记(__target)

平台为每个任务注入统一的 __target 参数(特殊标记 kind: "task_target"),自描述任务目标:

json
{
  "kind": "task_target",
  "deviceUdid": "R58M...",          // Android 设备(可选)
  "accounts": [                      // 站点+账号(一个或多个,[0] 为默认站点账号)
    { "site": "抖音", "accountName": "douyin_01" }
  ],
  "desktop": true                    // 桌面端:分片含桌面设备时由该机器执行整个流程
}

定时任务的桌面分片按机器路由(desktop: true + 目标中的机器 ID):分片所选桌面电脑执行整个流程,浏览器/手机部分经 __target.accounts / __target.deviceUdid 下发。分布式定时任务等场景可直接识别该标记;流程中也可通过 {{__target.accounts[0].site}} 等表达式引用目标信息。

任务管理

查看任务列表

在应用详情页,切换到「任务列表」标签页,可查看所有历史任务:

  • 状态:等待中、运行中、已停止、已完成、失败
  • 创建时间 / 完成时间:北京时间
  • 点击「详情」可查看任务参数、输出数据和错误信息

查看总体输出

切换到「总体输出」标签页,可查看该应用所有任务的输出数据汇总,支持分页浏览。

通过 AI 集成运行任务

平台支持两种方式让 AI Agent 驱动自动化任务:

自动更新

客户端支持自动更新:

  1. 启动后自动检查更新
  2. 发现新版本时弹出提示,可选择:
    • 下载更新:后台下载安装包
    • 稍后提醒:下次启动时再次提醒
  3. 下载完成后可选择:
    • 安装并重启:立即安装更新
    • 下次启动时安装:退出时自动安装

也可通过右上角用户菜单中的「检查更新」手动触发。

常见问题

Android 设备连接

问题:设备选择下拉框为空,提示「未检测到 ADB 设备」

排查步骤:

  1. 确认 USB 数据线支持数据传输(换线尝试)
  2. 确认手机已开启「USB 调试」
  3. 确认手机端弹出的「允许 USB 调试」已点击确认
  4. 确认 USB 连接模式为「文件传输」而非「仅充电」
  5. 尝试重新插拔 USB 线并点击「刷新」按钮
  6. 检查是否安装了手机厂商的 USB 驱动程序

问题:提示「ADB 调用失败」

可能原因:

  • 电脑上运行了其他 ADB 工具(如 Android Studio、微信开发者工具),导致 ADB 端口冲突。关闭这些工具后重试
  • USB 驱动未正确安装。安装手机厂商提供的驱动程序

问题:任务运行中断,提示设备重连中

  • 检查 USB 连接是否松动
  • 客户端会自动尝试重连,通常 15 秒内恢复
  • 如果持续无法重连,重新插拔 USB 线后重新启动任务

网页任务

问题:添加账号时点击「打开浏览器登录」后无反应

  • 等待 30 秒,浏览器首次启动较慢
  • 如果超过 60 秒仍未打开,关闭客户端重新启动

问题:浏览器打开后页面显示异常或加载缓慢

  • 检查网络连接是否正常
  • 如果配置了代理,确认代理地址和端口正确
  • 尝试删除该账号重新添加

问题:运行网页任务时浏览器窗口偏大

  • 客户端会自动根据屏幕尺寸调整浏览器窗口大小(宽度最大 1280px,高度为屏幕 80%)
  • 如仍需调整,可在任务运行前修改系统显示缩放比例

通用问题

问题:客户端窗口白屏

  • 等待 10-20 秒,客户端在加载大量数据时可能短暂白屏
  • 如果持续白屏,关闭后重新启动客户端

问题:登录失败

  • 确认用户名和密码正确
  • 确认服务端地址可达(联系管理员确认)
  • 检查网络连接

问题:任务一直显示「等待中」

  • 检查网络连接是否正常
  • 确认服务端运行正常
  • 点击「停止任务」后重新启动

MCP 接口

详见 AI 集成 → MCP 接口 页面。