参考

本部分记录自动化公共契约。桌面、手机、渠道、CLI、API 和插件都应使用同一份类型，不得各自维护同义字段。

契约入口

• Automation Spec：一个自动化版本的输入、输出和执行计划。
• Plugin Manifest：插件身份、兼容性、内容哈希和权限入口。
• Schedule：本地定时规则和策略。
• Run / Event：LocalJob、StepRun 和 RuntimeEvent。
• Error Codes：跨桌面、CLI、API 和渠道稳定使用的错误码。

术语

• Automation：用户可以一键、定时或远程发起的稳定入口。
• Plugin Version：不可修改的执行版本，包含 Schema、计划、权限和自检。
• AutomationAccount：目标网站或应用的登录身份，引用本地 Profile 和登录规则。
• LocalJob：执行电脑创建的一次真实运行。
• StepRun：一次运行中某个步骤的一次尝试。
• Artifact：运行产生的文件或较大数据结果。
• Device Inbox：云端短期保存的设备消息，只负责投递，不负责执行。
• Automation Assistant：只辅助创建、登录规则、自检、修复、分享和显式结构化输入生成的能力。

TypeScript 以 desktop/packages/command-contracts 中的 Schema 为数据真源；Rust Runtime 使用等价强类型并通过共享契约样本验证。