Appearance
Error Codes
协议只传稳定错误码、用户可读消息和是否可重试。内部堆栈、路径和上游敏感响应只写入脱敏后的本地技术日志。
登录和输入
| 错误码 | 含义 | 建议 |
|---|---|---|
AUTH_LOGIN_EXPIRED | 登录明确失效 | 重新登录 |
AUTH_PROBE_INCONCLUSIVE | 暂时无法判断 | 检查网络后重试 |
AUTH_VERIFICATION_REQUIRED | 需要扫码、验证码或人工确认 | 打开登录会话 |
INPUT_VALIDATION_FAILED | 输入不符合 Schema | 修正提示字段 |
SCHEDULE_INVALID | 定时规则无效 | 检查时区和时间 |
Job 和网络
| 错误码 | 含义 |
|---|---|
JOB_CANCELLED | 用户或调用方取消 |
JOB_INTERRUPTED | Runtime 异常退出或重启 |
NETWORK_UNAVAILABLE | 当前网络不可用 |
DEVICE_OFFLINE | 指定电脑不在线 |
DEVICE_REVOKED | 设备已被撤销 |
INBOX_MESSAGE_EXPIRED | 远程消息超过有效期 |
CloakBrowser
| 错误码 | 含义 |
|---|---|
BROWSER_RUNTIME_MISSING | CloakBrowser 未安装 |
BROWSER_RUNTIME_INVALID | 签名、哈希或版本校验失败 |
BROWSER_NAVIGATION_TIMEOUT | 页面加载超时 |
BROWSER_SELECTOR_NOT_FOUND | 已发布定位规则失效 |
BROWSER_DOWNLOAD_FAILED | 下载未完成或校验失败 |
缺少或无效时只阻止网站自动化，不回退系统 Chrome；桌面软件自动化仍可运行。
API
| 错误码 | 含义 |
|---|---|
API_RATE_LIMITED | 目标服务限流，应等待 |
API_AUTH_FAILED | API 登录或授权失败 |
API_RESPONSE_INVALID | 响应不满足已发布 Schema |
API_SIDE_EFFECT_UNKNOWN | 写操作结果无法确认，禁止盲目回退 |
桌面、助手和产物
| 错误码 | 含义 |
|---|---|
DESKTOP_ELEMENT_NOT_FOUND | 桌面元素定位失效 |
DESKTOP_PERMISSION_DENIED | 缺少系统权限 |
DESKTOP_APPLICATION_UNAVAILABLE | 目标软件没有安装、没有运行或无法启动 |
DESKTOP_CAPABILITY_UNAVAILABLE | 当前系统缺少步骤需要的执行能力 |
DESKTOP_RUNTIME_FAILED | 桌面执行组件异常退出 |
AGENT_BUDGET_EXCEEDED | 本次辅助达到预算上限 |
AGENT_OUTPUT_INVALID | 助手输出未通过 Schema |
ARTIFACT_NOT_FOUND | 本地产物已不存在或无权访问 |
ARTIFACT_WRITE_FAILED | 文件写入或校验失败 |
插件、额度和内部错误
| 错误码 | 含义 |
|---|---|
PLUGIN_BLOCKED | 版本被撤销或安全阻止 |
PLUGIN_VERSION_INVALID | Manifest、Schema、哈希或签名无效 |
QUOTA_EXCEEDED | 当前会员额度不足 |
INTERNAL_ERROR | 未分类内部错误，用户只看到安全提示 |
自动化调用方应按错误码和 retryable 判断是否重试，不应匹配中文消息。