系统架构

虎鲸自动化采用三端协同架构，基于云原生架构，所有通信经云控台中转，确保数据安全和通信稳定。

三端角色详解

数据安全

• 租户数据物理隔离：每个租户独立数据库，数据绝不混存
• 全程加密传输：公网部署强制HTTPS，所有通信链路加密
• 安全令牌认证：所有接口均需安全令牌验证，杜绝未授权访问
• 每日自动备份：数据每日自动备份，保留7天，确保数据安全

云控台

云控台是平台的核心，负责任务管理、设备调度和通信中转。通过 /admin-v3/ 访问。

侧边栏导航

任务编辑器

核心工作区域，三栏布局：

• 左侧：任务列表，点击切换任务，新建/删除任务
• 中间：智能代码编辑器，支持语法高亮和自动补全
• 右侧：助手面板，自然语言对话生成脚本

动作按钮

编辑器上方提供21个动作按钮，点击即可在光标位置插入对应的DSL代码模板：

图片库

点击"图片库"按钮打开弹窗，管理FindImage所需的模板图片：

• 上传：支持PNG/JPG，单张最大200KB，同名图片自动拒绝
• 插入：点击图片自动插入 FindImage "图片名", 0, 0, 1080, 1920, 0.8 -> pos
• 删除：点击红色×删除图片
• 翻页：每页24张，超过自动分页
• 隔离：图片按租户隔离，不同租户互不可见

设备列表

二联表格设计：

• 上联：中控端列表，显示名称、绑定码、在线C端数量、创建时间。点击选中后下联刷新
• 下联：选中中控端下的C端设备，显示设备名、绑定码、在线状态、运行状态、剩余时间

创建中控端

点击"创建中控端"按钮，在弹窗中勾选该中控端可见的任务。只有被勾选的任务才能通过该中控端下发。

生成C端激活码

选中中控端后，点击"生成C端卡号"按钮，指定有效期（月数）和数量。确认后弹出结果列表，可复制或导出TXT。

中控端

中控端是操作员使用的Web界面，通过 https://hujingyun.com/b/login 访问。零安装，浏览器即用。

登录

使用8位中控端绑定码登录。登录后安全令牌保存在浏览器本地存储，永不过期。关闭浏览器后重新打开仍保持登录状态。

设备列表（左侧）

显示所有C端设备，每台设备显示：

• 在线状态：绿色圆点=在线，灰色=离线
• 运行状态：运行中/空闲/等待连接
• 设备名：可右键修改备注名
• 卡号：C端绑定码
• 剩余时间：C端激活码剩余有效期

搜索与过滤

设备列表上方提供搜索框和过滤标签：

• 搜索：按设备名或卡号模糊搜索
• 全部/在线/离线：快速过滤设备状态

多选与批量操作

勾选多台设备后，可批量下发任务或批量停止。每个设备的任务参数独立保存。

日志面板（右侧）

选中设备后右侧显示实时日志，支持3级过滤：

历史日志

点击"全部日志"标签页查看所有执行记录。每条记录包含：开始时间、任务名、执行时长。点击进入详情页查看完整日志。

合卡

将一个C端码的剩余时间合并到另一个C端码，实现续期操作。支持跨租户合卡（卡号即凭证）。

C端设备端

C端是运行在Android设备上的APK，负责执行任务和上报状态。无需Root，兼容Android 5+。

安装与激活

权限要求

截图与识别

C端搭载自研极速截图引擎，毫秒级响应，确保操作精准及时。配合图像识别算法，200ms精准定位目标位置。

绑定码体系

绑定码是设备接入平台的凭证，分为中控端码和C端码两种。所有绑定码由云控台生成。

中控端绑定码 vs C端激活码

生成流程

换绑规则

C端设备在线时，绑定码锁定不可被其他设备使用。设备离线后，新设备可使用该绑定码，旧设备自动解绑：

绑定码 CODE_1 绑定手机 PHONE_A：
├─ PHONE_A 在线 → CODE_1 不可被其他手机使用
├─ PHONE_A 离线 → 新手机输入 CODE_1 → 成功，PHONE_A 解绑
└─ 不同中控端实例的绑定码互不影响

合卡

将一个C端码的剩余时间合并到另一个C端码：

• 源码时间归零，变为已消耗状态
• 目标码获得续期
• 支持跨租户合卡（卡号即凭证）
• 合卡后中控端实时刷新剩余时间

撤销

云控台可撤销绑定码，撤销后：

• 旧安全令牌立即失效
• 设备断开连接
• 撤销和新建为独立操作，撤销不回收码值

DSL语法入门

DSL（Domain Specific Language）是虎鲸自动化自研的脚本语言，VB风格，5分钟即可上手。支持15类指令，接近图灵完备。

基本结构

' 这是注释（单引号或#号）
Click 540, 960     ' 点击屏幕坐标(540,960)
Sleep 2000        ' 等待2000毫秒(2秒)
Log "执行完成"  ' 输出日志到中控端

变量与运算

' 赋值
Set count = 0
Set name = "测试"

' 算术运算
Set total = count + 1
Set avg = (a + b) / 2

' 变量引用（裸变量名）
Click posX, posY

条件判断

' If...Then...Else...End If
If x >= 0 Then
    Click x, y
    Log "找到了"
Else
    Log "未找到"
End If

' 支持的运算符：== != > < >= <= ~= contains notContains

循环

' While循环
Set i = 0
While i < 10
    Click 540, 960
    Set i = i + 1
End While

' Repeat固定次数
Repeat 5
    Click 540, 960
    Sleep 1000
End Repeat

子程序

' 定义子程序（支持参数和返回值）
Sub CheckAndClick(imgName)
    FindImage imgName, 0, 0, 1080, 1920, 0.8 -> pos
    If pos >= 0 Then
        Click pos, 0
    End If
EndSub

' 调用子程序
Call CheckAndClick("btn_start.png")

找图与找色

' 找图（全屏搜索）
FindImage "btn.png", 0, 0, 1080, 1920, 0.8 -> pos

' 找色
FindColor 0, 0, 1080, 1920, "#FF0000" -> pos

' 取色
GetColor 100, 200 -> myColor

' 颜色模糊匹配（~=运算符）
If myColor ~= "#346BB8" 0.9 Then
    Log "颜色匹配(容差0.9)"
End If

指令参考

DSL脚本支持21条指令，覆盖测试全场景。完整语法请查看 DSL语法手册。

基础操作

图像识别

智能识别

基于视觉模型的智能识别指令，支持中/日/韩文识别，配合跨语言游戏UI词汇表实现模糊匹配。

流程控制

变量与运算

系统操作

条件运算符

高级用法

参数下放

在脚本中定义参数区，中控端可按设备粒度调整参数值，无需修改脚本。这是虎鲸自动化的核心差异化功能。

关键原理：注释决定下放。参数区中每个 Set 语句上方紧邻的注释行决定了该参数是否下放以及下放的类型。注释行写在 Set 的正上方才有效，隔行无效。

'########参数区
'循环次数 [数字, min=1, max=20]   ← 注释在Set上方，方括号标注类型→下放为数字框
Set loop_count = 5
'执行模式 [下拉, 快速, 标准, 深度]  ← 下放为下拉选择
Set mode = "标准"
'自动重试 [下拉, 开启, 关闭]          ← 下放为下拉选择（代替开关）
Set auto_retry = "开启"
'截图日志 [下拉, 开启, 关闭]          ← 另一个下拉开关
Set screenshot_log = "关闭"
'设备备注                         ← 无方括号→默认文本输入框
Set remark = "默认设备"
'########

' === 脚本区（直接使用变量名） ===
Repeat loop_count
    Click 540, 960
    Sleep 1000
End Repeat
Log "模式: " + mode + " 备注: " + remark

参数类型

颜色模糊匹配

使用 ~= 运算符进行颜色模糊匹配，适应不同屏幕色差：

' 获取颜色
GetColor 100, 200 -> myColor

' 模糊匹配（默认容差0.85）
If myColor ~= "#346BB8" Then
    Log "颜色匹配(默认容差)"
End If

' 自定义容差
If myColor ~= "#346BB8" 0.9 Then
    Log "颜色匹配(容差0.9)"
End If

容差范围0-1，值越大要求越严格。0.85为默认值，适合大多数场景；0.9以上适合要求精确匹配的场景。

中控端可见任务

创建中控端时可选择可见任务，该中控端只能下发被选中的任务。未勾选的任务对中控端不可见。适用于不同操作员只负责特定任务的场景。

多设备批量操作

中控端支持多选设备，批量下发任务或批量停止。参数按设备独立保存，不同设备可使用不同参数值。

实用脚本模板

等待图片出现后点击

' 等待图片出现（最多10秒）
FindImage "btn_confirm.png", 0, 0, 1080, 1920, 0.8, retry=10, timeout=10000 -> pos
If pos >= 0 Then
    Click pos, 0
    Log "点击确认按钮"
Else
    Log "确认按钮未出现"
End If

循环检测颜色变化

' 检测按钮变色（表示状态改变）
Set timeout = 0
While timeout < 30
    GetColor 540, 960 -> btnColor
    If btnColor ~= "#00FF00" 0.9 Then
        Click 540, 960
        Log "按钮变绿，已点击"
        Goto done
    End If
    Sleep 1000
    Set timeout = timeout + 1
End While
Log "等待超时"
Label done

定时执行+时间判断

' 等到早上8点再执行
Log "等待至08:00..."
WaitUntil "08:00"
Log "时间到，开始执行"

' 获取当前时间，根据时间段执行不同操作
GetTime -> now
Log now

助手使用指南

虎鲸自动化集成大模型，支持自然语言生成DSL脚本。

使用方式

使用技巧

• 描述越具体越好：说明坐标、等待时间、循环次数等细节
• 分步生成：复杂脚本可分多轮对话，先生成框架再补充细节
• 利用图片库：先上传模板图，再生成FindImage指令
• 参数下放：在脚本中加入参数区，方便中控端按设备调参