Skip to content

Plugin Manifest

Plugin Manifest 是插件包的安装入口。它说明“这是谁、能运行在哪里、需要什么权限、包内哪些文件属于当前版本”。具体执行步骤由 Automation Spec 提供。

必需信息

字段说明
id全局稳定插件 ID
name用户可读名称
version插件包版本
description用用户语言说明用途和结果
min_runtime_version最低 Workova Runtime 版本
permissions域名、HTTP 方法、本地目录和能力
files包内文件及 SHA-256
entrypointAutomation Spec 文件路径
signing发布者和平台签名信息

示意:

json
{
  "id": "com.example.order-export",
  "name": "订单导出",
  "version": "1.0.0",
  "description": "按日期导出订单并返回 Excel 文件",
  "min_runtime_version": "1.0.0",
  "entrypoint": "execution-plan.json",
  "permissions": {
    "domains": ["https://example.com"],
    "http_methods": ["GET"],
    "local_directories": [],
    "capabilities": ["cloakbrowser", "download"]
  },
  "files": {},
  "signing": {}
}

包内文件

推荐结构:

text
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/

安装校验

Runtime 会校验:

  1. Manifest 和所有 Schema。
  2. 最低 Runtime 与平台能力。
  3. 每个文件的内容哈希。
  4. 发布签名和撤销状态。
  5. 权限是否覆盖且只覆盖执行计划实际使用的能力。
  6. 自检用例是否存在。

禁止包含

插件包不能保存 Cookie、密码、验证码、Token、真实身份快照、Profile 路径、用户下载文件或带敏感 Header 的完整录制。

网站浏览器

Manifest 可以声明 cloakbrowser 能力,但不能指定系统 Chrome、浏览器版本或替代运行时。CloakBrowser 未就绪时,网站插件进入明确阻塞状态。

Workova 官方文档