Enum ErrorCode 

pub enum ErrorCode {
    StaleRef,
    NotFound,
    PermDenied,
    Timeout,
    Ambiguous,
    NotActionable,
    AssertionFailed,
    Protocol,
    Internal,
    Aborted,
}

机器可读错误码(docs/06 §4 错误码表,全集变更属 spec 提交)。

Variants

StaleRef

ref 失效(fallback 链已穷尽)→ agent 应重新 snapshot

NotFound

选择器无匹配 → 用 find 放宽条件

PermDenied

权限不足(UIPI/管理员窗口)→ 提示用户,勿重试

Timeout

wait/谓词超时 → 重估前置状态

Ambiguous

匹配到多个元素 → 收紧条件

NotActionable

元素存在但不可操作(disabled/offscreen)→ 先 scroll/focus;hint 会指向 set-value

AssertionFailed

verify/–expect 断言未成立 → 检查前置步骤

Protocol

协议/参数错误(不可恢复)→ 修正命令参数

Internal

内部/UIA/系统层错误 → 重试一次;持续出现附 evidence 报 issue

Aborted

用户主动停止(紧急热键/停止文件)→ 清除停止标志后可安全重试

Implementations

impl ErrorCode

pub fn recovery_hint(self) -> &'static str

恢复建议(envelope 面向 agent,输出英文;docs 中文档为中文)。

Trait Implementations

impl Clone for ErrorCode

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ErrorCode

impl Debug for ErrorCode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorCode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ErrorCode

impl PartialEq for ErrorCode

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ErrorCode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ErrorCode