Workova 文档

Appearance

插件开发 ​

普通用户通过录制或助手自主创建插件。开发者也可以直接编写声明式插件包，并用相同的校验、自检、签名和发布流程交付。

推荐目录 ​

text
plugin/
├── manifest.json
├── input.schema.json
├── input.ui.json
├── output.schema.json
├── account.schema.json
├── login-rules.json
├── execution-plan.json
├── artifact-rules.json
├── permissions.json
├── tests/
└── assets/

这些文件共同组成不可变 Plugin Version。不要把运行所需信息隐藏在聊天记录或未声明脚本中。

开发顺序 ​

  1. 定义 Input Schema、UI Schema 和 Output Schema。
  2. 声明是否需要登录，以及使用哪些登录规则。
  3. 编写 API、DOM 或 Desktop Plan。
  4. 声明产物和权限。
  5. 为 Schema、登录、执行、文件、权限、取消和超时添加自检。
  6. 在本地安装草稿并运行测试。
  7. 计算内容哈希，发布不可变版本。

网站计划 ​

网站自动化只连接 Workova 管理的 CloakBrowser。插件不能指定系统 Chrome、浏览器版本或自行启动调试端口。

API Step 必须说明认证来源、CSRF、成功条件、Response Mapping、副作用、幂等键和回退策略。DOM Step 保存多个定位候选，不依赖一条脆弱的长 CSS 路径。

桌面计划 ​

桌面步骤只能选择 macOS AX、Windows UIA、Electron CDP、WebView 调试或坐标策略，并明确窗口、进程、目标和超时。优先使用可访问性元素，坐标只作为最后兜底。

OCR 仅可作为当前 macOS 录制选点器的识别辅助，不能写入 Desktop Plan 作为回放策略；Windows 当前没有正式 OCR 录制或回放能力。

校验 ​

开发时以命令契约中的 Zod/Rust 类型为数据真源。文档示例用于说明结构，不能替代运行时校验。

继续阅读：

Workova 官方文档

Copyright © Workova