常见问题

先从运行详情中的错误码判断，不要只看“没有反应”。详细内部错误保存在执行电脑的脱敏日志中。

Workova 登录后又回到登录页

1. 确认网络可以访问 Workova 服务。
2. 如果刚修改密码，使用新密码重新登录。
3. 在登录窗口重新认证，不要手工复制旧 Token。

Workova 用户登录与“登录管理”中的网站或应用登录身份互不替代。

网站自动化提示浏览器不可用

网站自动化只使用 CloakBrowser。打开“设置 → 权限与自动化”，根据状态执行安装、修复或更新。

Workova 不会使用系统 Chrome 兜底。这样可以避免同一登录身份在浏览器内核、指纹和 Profile 之间发生不一致。

错误码：BROWSER_RUNTIME_MISSING 或 BROWSER_RUNTIME_INVALID。

登录状态暂时无法判断

先检查网络、代理和目标网站状态。429、5xx 或超时会标记为“暂时无法判断”，不会直接清除登录身份。

如果规则连续失败，再从登录详情打开“登录诊断”。需要扫码或验证码时，按提示人工完成。

本地定时没有运行

检查：

1. Schedule 是否启用，时区是否正确。
2. Workova 是否仍在托盘运行。
3. 电脑当时是否休眠或关机。
4. 错过任务策略是否选择“跳过”。
5. 同一登录身份是否被另一条任务占用。

电脑关机或 Workova 完全退出时，本地定时不会执行。恢复后按错过任务策略补跑或跳过。

自动化运行失败

打开“运行记录 → 运行详情”，先看失败分类：

• 网络或限流：等待后重试。
• 登录失效：重新登录。
• 系统权限：按提示开启权限。
• 输入不合法：修正表单字段。
• 页面、接口或软件界面变化：进入修复助手。

写操作出现 API_SIDE_EFFECT_UNKNOWN 时不要手工立即重跑，先确认目标系统是否已经产生结果。

手机或渠道没有触发电脑

检查：

1. 消息绑定的目标设备是否正确且未撤销。
2. 执行电脑是否在线并连接 Workova。
3. 自动化是否允许远程运行。
4. 手机用户、渠道发送者和会话是否在白名单。
5. Device Inbox 消息是否已经过期。

WebSocket 断开后设备会补拉消息；如果消息已经 received，重复发送同一 Message ID 不会再次执行。

CLI 无法连接

确认 Workova 桌面客户端正在托盘运行，并在“设置 → 权限与自动化”检查 CLI 状态。CLI 连接本地 Runtime IPC，不会临时启动 GUI 代替 Runtime。

找不到产物

产物默认保存在执行电脑。远程控制端只看到摘要；需要下载时，执行电脑必须在线，或该产物已经明确启用加密同步。

错误码：ARTIFACT_NOT_FOUND 或 ARTIFACT_WRITE_FAILED。

插件无法安装或运行

检查签名、内容哈希、最低 Runtime 版本、权限和自检状态。被撤销的版本会返回 PLUGIN_BLOCKED，校验失败会返回 PLUGIN_VERSION_INVALID。

不要通过关闭签名或扩大权限绕过错误，应改用可信版本或联系发布者修复。