Mvlvx 客户端
完整图文使用指南

使用前检查

1. 前往官网「下载」页，获取最新安装包。
2. 双击安装包，按向导完成安装并启动 Mvlvx。
3. 新用户先注册，已有账号直接登录。登录后进入客户端主界面。
4. 如提示有新版本，先完成更新，再继续后续配置。

1. 输入宿主机 IP 并保存；需要时根据界面填写 SSH 账号信息。
2. 在宿主机行点「部署」，客户端会检查并部署 host_agent。
3. 首次连接会显示 SSH 指纹。请与设备后台或可信渠道中的指纹核对，一致后再确认。
4. 等待「部署成功」及版本号出现；有多台时可勾选后批量部署。

1. 按宿主机、运行状态或关键字筛选，找到要使用的坑位。
2. 勾选云机后点「批量开机」；已经开机的项目会自动跳过。
3. 需要统一环境时点「一键初始化」，按弹窗选择初始化项。
4. 可使用「应用管理」处理应用，或打开投屏窗确认云机界面。

组件库

搜索点击、输入、等待、条件、循环、应用控制等动作，拖入画布。

画布

用连线表示执行顺序，可切换主流程与子流程，并支持缩放、对齐和自动整理。

参数区

点选节点后填写它的必填项、定位条件、超时、失败策略与运行参数。

顶部工具栏

包含文件、撤销 / 重做、AI 生成、设备选择、流程检查、试运行和日志。

1. 新建工作流，优先选择与目标最接近的模板或场景；没有合适项再从空白画布开始。
2. 从左侧拖入需要的组件。建议先放「启动应用」，再加一个可快速验证的动作。
3. 从上一节点的「之后」端口拉出连线，连到下一节点，让执行顺序从前往后。
4. 逐个点选节点，在右侧填写红色提示的必填参数。目标应用可使用实际包名或工作流入参。
5. 点「检查」或留意底部诊断。有错误时按清单定位到节点，直到无必填项和断线问题。

1. 首次使用时点 AI 按钮旁的设置入口，按界面指引配置模型。密钥仅保存在本机安全存储中。
2. 把目标写清楚：「在哪个应用」、「先后做什么」、「什么情况结束」。
3. 先在 AI 工作台检查步骤，确认无多余高风险动作，再导入到当前画布。
4. 补齐应用包名、文本、元素定位和超时等真实参数，然后再做单机试运行。

1. 在顶部试运行设备中，按名称或坑位选择刚才准备好的单台云机。
2. 先点「检查」。若有必填项、断开连线或结构错误，先修复再运行。
3. 点「试运行」，观察节点颜色、执行顺序和底部日志时间线。
4. 失败时先看第一条红色日志，点日志定位节点；有失败截图时打开核对当时画面。
5. 修复后重新试运行，直到整条流程稳定完成 2–3 次。

1. 在编辑器的「文件」菜单中存一个版本，用清楚的名称标识用途。
2. 进入「任务管理」，左侧任务类型会显示已保存的工作流；选中本次要运行的项。
3. 在右侧按宿主机或坑位勾选目标云机，建议第一次批量先选 2–5 台。
4. 如工作流定义了运行入参或任务参数，在创建前为本批次填入实际值。
5. 点「添加任务」进入队列，然后前往「任务中心 → 运行队列」开始执行。

1. 在「运行队列」按状态、类型或宿主机筛选，确认本批次任务数量。
2. 设置每台宿主机并发数；首次用保守值，观察宿主机资源和任务成功率后再增加。
3. 点「开始执行」；也可勾选部分云机后使用批量开始、批量停止或批量重试。
4. 任务失败时先查看错误和日志，确认原因已处理后再重试，避免无意义重复执行。
5. 需要定时运行时切换「任务计划」，设置触发时间、目标坑位和工作流参数。

宿主机离线

确认 IP 可达、SSH 信息正确，回到「宿主机管理」重新检查并部署 host_agent。

云机不在列表

先确认所属宿主机在线，再刷新云机列表并清除筛选条件。

试运行不启动

确认已选在线云机，且流程检查没有必填项、断线或结构错误。

节点执行失败

从第一条红色日志入手，核对失败截图、定位属性、界面语言和等待时间。

批量成功率低

下调每宿主机并发数，用小批量复现，再分别检查代理、入参、资源和目标应用状态。