chore: 超级剪贴板动作编辑器教程更新

This commit is contained in:
ZiuChen 2024-11-19 13:08:19 +08:00
parent 671f9f46fe
commit 66761d6df9

View File

@ -43,11 +43,9 @@ sudo codesign --force --deep --sign -
## 如何创造自己的功能按钮
超级剪贴板为用户提供了自定义功能按钮的能力
超级剪贴板为用户提供了自定义功能按钮的能力,这让`超级剪贴板`真正变得“超级”起来。
这让`超级剪贴板`真正变得“超级”起来,用户可以通过编写`json`实现**携带数据跳转到任何其他插件**,这项功能给`超级剪贴板`带来了无限可能。
插件中,默认内置了若干使用样例:
用户可以通过插件内的「动作编辑器」自定义功能按钮,也可以从动作市场中获取更多内置的动作:
- 讯飞OCR识别
- 百度搜索
@ -58,25 +56,33 @@ sudo codesign --force --deep --sign -
- 上传到图床
- 翻译
自定义的功能按钮能够**携带数据跳转到任何其他插件**,这项功能给`超级剪贴板`带来了无限可能。
下面我将从这些样例出发对这项功能做简单介绍:
这项功能的原理是`utools.redirect()`,在不分离插件的情况下,在不同插件之间的跳转体验是连贯的。
### 基础用法
`百度搜索`为例,是通过`网页快开`提供的关键词实现的我们可以编写以下json
你可以在「动作编辑器」新增一个动作,按要求填写好动作名、插件应用名称、指令以及匹配类型
```json
{
"id": "custom.1663490859",
"title": "百度搜索",
"icon": "🔍",
"match": ["text"],
"command": "redirect:百度一下"
}
```
- 动作名
- 用于动作命名例如「百度OCR识别」
- 插件应用名称
- 要跳转的插件名称
- 指令
- 需要插件实现对应的指令
- 匹配类型
- 选中哪些种类的数据时,才会展示此动作
- 例如「百度搜搜」只会匹配文本类型的剪贴板历史
可以实现从剪贴板直接跳转到`网页快开`,也即打开百度并搜索当前选中的文本内容。
`百度搜索` 为例,跳转的目标插件应用名称为 `网页快开`,指令为 `百度一下`,匹配的指令类型为 `文本`
除了使用简单的字符串匹配不同的内容,`超级剪贴板`还支持使用正则表达式,以`上传到图床`功能为例:
此时当你在「超级剪贴板」中选中一个文本时,就可以直接用百度搜索当前选中的这段文本。
### 高级用例
除了使用简单的字符串匹配不同的内容,`超级剪贴板`还支持使用正则表达式,这需要你切换到「高级匹配」并填写 JSON。
`上传到图床`功能为例:
```json
{
@ -88,14 +94,13 @@ sudo codesign --force --deep --sign -
}
```
这个功能除了可以匹配图片,还可以将符合正则的图片文件匹配上,在匹配上的历史记录上展示`上传到图床`按钮,携带数据跳转到图床插件,一键上传。
这个动作除了可以匹配图片,还可以将符合正则的图片文件匹配上,在匹配上的历史记录上展示`上传到图床`按钮,携带数据跳转到图床插件,一键上传。
需要注意的是,因为自定义功能按钮实现的是**携带数据跳转不同插件**,所以`redirect`后的内容并不应该是普通关键字(普通关键字仅能作为插件入口,而不能携带数据),而应该是`文本`/`图片`/`文件或文件夹`
![](../assets/gi4.png)
![](../assets/gi5.png)
- `id`: `String` 全局唯一 必须以`custom`开头 建议以时间戳为后缀
- `title`: `String` 鼠标悬停时展示的文本
- `icon`: `String` 展示在插件内的图标