参数编辑器

通过 Schema 选择文件、应用、网址等参数的输入方式。

Plugin API v1

Documentation content is currently available in Simplified Chinese.

当参数不是普通文本时，可以在 Schema.format 中指定编辑器。例如，使用 application 后，用户可以通过选择器填写应用路径。

#字符串格式

format	编辑方式
`application`	选择应用程序
`file`	选择一个文件
`directory`	选择一个文件夹
`file-or-directory`	选择一个文件或文件夹
`uri`	输入包含协议的 URI
`hotkey`	录入热键
`screen-id`	选择屏幕
`appearance-icon`	打开按钮图标选择器，保存图标 ID。
`multiline`	输入多行文本

文件和应用选择器把选中的绝对路径作为字符串传给后台。需要限制扩展名时，用 filePicker.filters：

json

{
  "type": "string",
  "title": "数据文件",
  "format": "file",
  "filePicker": { "filters": [{ "name": "CSV 数据", "extensions": ["csv", "tsv"] }] }
}

file 和 file-or-directory 可以使用筛选器。directory 和 application 不使用扩展名筛选。

#URI 和热键

uri 参数要包含协议，例如 https://example.com。如果只允许特定协议，再填写 allowedSchemes。例如，自定义协议参数可以允许 myapp:。

hotkey 参数由热键编辑器录入，调用时会检查格式。发送热键的方法见 sendHotkey()。

#数字输入

number 和 integer 使用数字输入框。填写 minimum 与 maximum 后，飞块按这个范围检查输入；integer 还要求值为整数。

#图标

动作、预设及分类的 icon 使用图标库 ID（例如 host:outline/Globe、host:brand/LogoGithub）或包内静态 SVG 路径（例如 assets/icons/tool.svg）。插件清单顶层的 icon 填写包内图片路径。完整规则见插件图标与资源。

按钮外观的 button.icon 使用另一种结构，可以设置 emoji、图标包或应用图标，见 ButtonIcon。

#FilePicker

清单位置：Schema.filePicker。

#`FilePicker.filters`

FileFilter[] · 可选

文件筛选组，1–8 项。省略时可选择任意扩展名。

#FileFilter

清单位置：Schema.filePicker.filters[]。

#`FileFilter.name`

string · 必填

筛选组显示名称，1–80 个字符，例如“CSV 数据”。

#`FileFilter.extensions`

string[] · 必填

1–16 个扩展名，每个为 1–16 位字母或数字，不带前导点，例如 csv。同组不重复。