使用指南
系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | macOS 12+ / Windows 10 / 11(64 位) |
| 内存 | 8 GB 及以上 |
| 磁盘空间 | 500 MB 及以上 |
| 网络 | 需要访问服务端地址 |
Android 任务额外要求
| 项目 | 要求 |
|---|---|
| USB 数据线 | 支持数据传输(非仅充电线) |
| 手机系统 | Android 7.0 及以上 |
| USB 调试 | 已开启 |
| USB 驱动 | 已安装手机厂商驱动或 Google USB Driver |
安装客户端
- 前往 下载页面 下载对应平台的安装包
- 安装客户端
- Windows:双击运行安装程序,选择安装目录,点击安装。安装完成后桌面会生成快捷方式
- macOS:双击 DMG 文件,将应用拖入 Applications 文件夹
下载提示(Windows)
由于安装包未携带数字证书,浏览器可能会将其标记为不安全文件而阻止下载:
- Edge 浏览器:下载被阻止时,点击下载栏右侧的「···」按钮,点击保留,点击删除按钮旁边的向下箭头 ▾,选择「仍然保留」
- Chrome 浏览器:下载被阻止时,点击下载栏中的「保留危险文件」或点击箭头选择「仍要保留」
安装提示(Windows)
安装过程中,Windows 智能应用控制可能会拦截安装程序。解决办法:在底部任务栏搜索框中搜索「智能应用控制」,在弹出的设置窗口中关闭智能应用控制开关,然后重新运行安装程序。
TIP
客户端已内置 ADB 工具和浏览器,无需额外安装。
macOS Gatekeeper 提示
首次打开时,macOS 可能会阻止运行,提示"无法验证开发者"。解决方法:右键点击应用 → 选择「打开」→ 在弹窗中点击「打开」。或者在终端执行:xattr -cr /Applications/语言驱动.app
登录
- 启动客户端,进入登录页面
- 输入用户名和密码
- 点击「登录」
WARNING
账号由管理员创建,客户端不支持注册。如无账号请联系管理员。
创建应用(自定义应用)
在左侧导航栏点击「创建应用」,填写以下内容:
| 字段 | 说明 |
|---|---|
| 应用名称 | 必填 |
| 平台 | 选填。Android / 网页 / 桌面 三选一;留空 = 多平台应用,可在同一流程中同时操作浏览器、手机、桌面 |
| 应用描述 | 选填。同时作为 AI 生成流程的提示词 |
点击「创建应用」:
- 应用描述非空 → 自动调用 AI 生成流程后创建应用。平台未选择时,请在描述中明确操作平台类型(web 网页 / android 手机 / pc 桌面 / 多平台混合),AI 会按描述推断各步骤所属平台并选用对应指令。生成失败时提供两个按钮:「重试AI创建应用」「直接创建空应用」
- 应用描述留空 → 跳过 AI 生成,直接创建空应用,进入编辑器手动设计流程
创建成功后自动进入流程编辑器,可继续调整 AI 生成的流程或从零编排。
录制生成(屏幕录制生成流程)
创建应用页的「录制生成」Tab 支持边操作边录制自动生成流程:
- 选择平台:
- 网页:填写站点标识 + 选择账号(指纹浏览器与登录态)→ 点击「开始录制」→ 客户端打开录制浏览器
- Android:选择手机设备 → 点击「开始录制」→ 打开投屏窗口
- 在浏览器/手机中正常操作:点击、输入、页面跳转都会被捕获
- 需要把"看数据"加进流程时,点击「标记单值查询」(AI 查询)或「标记列表查询」(提取列表数据),在页面上点选要提取的元素/列表行字段
- 点击「停止录制」→ 时间线展示捕获的操作,取消勾选可剔除误操作
- 点击「生成流程并创建应用」→ 服务端按事件规则生成流程(步骤名由 AI 整理,失败时自动降级),进入编辑器可继续调整
说明:录制值直接写入步骤参数(如搜索词"美食"),可在编辑器中改为变量;密码输入不记录明文;生成结果基于事件数据(选择器 + 输入值),无视频上传。
运行 Android 任务
第一步:连接手机
- 使用 USB 数据线将手机连接到电脑
- 确保手机已开启 USB 调试:
- 进入「设置 → 关于手机」→ 连续点击「版本号」7 次开启开发者选项
- 进入「设置 → 开发者选项」→ 开启「USB 调试」
- 手机弹出「允许 USB 调试」对话框时,点击确认
- 确保连接模式为文件传输(MTP),而非仅充电
第二步:安装应用
- 在左侧导航栏点击「应用市场」
- 找到需要的 Android 应用,点击「安装」
- 安装完成后,切换到「我的应用」查看已安装的应用
第三步:运行任务
- 在「我的应用」中,点击应用卡片上的「运行」按钮
- 在「运行任务」标签页中填写运行参数并选择设备
- 点击「启动任务」
运行参数说明
不同应用的运行参数略有差异,以下逐一说明。网页版应用的参数与对应的 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 参数(可填运行参数/变量)选择该站点账号。切换时旧浏览器保留后台运行,需要关闭时在切换前放一步「关闭浏览器」(自动保存登录态)。详见《流程编辑器指南》浏览器操作章节。
第一步:安装应用
- 在「应用市场」中找到需要的网页应用,点击「安装」
第二步:选择站点并添加登录账号
网页任务需要先保存网站登录状态,任务运行时将自动使用已保存的账号。
- 在「我的应用」中,点击应用的「运行」按钮
- 在「运行任务」标签页的「目标站点」区域,选择或输入站点标识(如 抖音),站点URL 自动带出、可修改
- 在「账号选择」区域,点击「添加账号」
- 在弹出的对话框中:
- 站点:自动带出所选站点,无需修改
- 账号名:输入便于识别的名称(如 douyin_yy01),仅支持字母、数字、中文
- 代理(可选):如需使用代理,输入代理地址,格式
http://用户名:密码@代理地址:端口
- 点击「打开浏览器登录」
- 客户端会自动打开浏览器窗口,在浏览器中手动完成网站登录
- 登录成功后,回到客户端点击「完成登录」
- 系统自动保存登录状态(按「站点 + 账号」归档),下次同站点同账号运行时无需再次登录
TIP
同一个站点可以添加多个账号,运行任务时选择需要的账号即可。流程编辑器中捕获元素、校验选择器、测试运行同样需要先选择站点与账号。
第三步:运行任务
- 在「运行任务」标签页中:
- 目标站点:选择或输入站点标识与站点URL(切换站点会清空已选账号)
- 运行参数:填写任务参数(参数说明同 Android 任务)
- 账号选择:从下拉框中选择该站点已登录的账号
- 点击「启动任务」
- 客户端自动打开浏览器窗口并开始执行任务
任务运行中
- 浏览器窗口会自动执行操作,请勿手动操作浏览器
- 如需暂停或中止,点击「停止任务」
- 浏览器在任务完成后会保持空闲状态一段时间(约 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 驱动自动化任务:
- Claude Code 技能包 (Skills):安装后直接用自然语言操控设备,适合终端用户。详见 AI 集成 → Claude Code 技能包
- MCP 接口:通过 JSON-RPC 协议供外部 Agent 程序化调用,适合开发者集成。详见 AI 集成 → MCP 接口
自动更新
客户端支持自动更新:
- 启动后自动检查更新
- 发现新版本时弹出提示,可选择:
- 下载更新:后台下载安装包
- 稍后提醒:下次启动时再次提醒
- 下载完成后可选择:
- 安装并重启:立即安装更新
- 下次启动时安装:退出时自动安装
也可通过右上角用户菜单中的「检查更新」手动触发。
常见问题
Android 设备连接
问题:设备选择下拉框为空,提示「未检测到 ADB 设备」
排查步骤:
- 确认 USB 数据线支持数据传输(换线尝试)
- 确认手机已开启「USB 调试」
- 确认手机端弹出的「允许 USB 调试」已点击确认
- 确认 USB 连接模式为「文件传输」而非「仅充电」
- 尝试重新插拔 USB 线并点击「刷新」按钮
- 检查是否安装了手机厂商的 USB 驱动程序
问题:提示「ADB 调用失败」
可能原因:
- 电脑上运行了其他 ADB 工具(如 Android Studio、微信开发者工具),导致 ADB 端口冲突。关闭这些工具后重试
- USB 驱动未正确安装。安装手机厂商提供的驱动程序
问题:任务运行中断,提示设备重连中
- 检查 USB 连接是否松动
- 客户端会自动尝试重连,通常 15 秒内恢复
- 如果持续无法重连,重新插拔 USB 线后重新启动任务
网页任务
问题:添加账号时点击「打开浏览器登录」后无反应
- 等待 30 秒,浏览器首次启动较慢
- 如果超过 60 秒仍未打开,关闭客户端重新启动
问题:浏览器打开后页面显示异常或加载缓慢
- 检查网络连接是否正常
- 如果配置了代理,确认代理地址和端口正确
- 尝试删除该账号重新添加
问题:运行网页任务时浏览器窗口偏大
- 客户端会自动根据屏幕尺寸调整浏览器窗口大小(宽度最大 1280px,高度为屏幕 80%)
- 如仍需调整,可在任务运行前修改系统显示缩放比例
通用问题
问题:客户端窗口白屏
- 等待 10-20 秒,客户端在加载大量数据时可能短暂白屏
- 如果持续白屏,关闭后重新启动客户端
问题:登录失败
- 确认用户名和密码正确
- 确认服务端地址可达(联系管理员确认)
- 检查网络连接
问题:任务一直显示「等待中」
- 检查网络连接是否正常
- 确认服务端运行正常
- 点击「停止任务」后重新启动
MCP 接口
详见 AI 集成 → MCP 接口 页面。
