From 66761d6df9d2cc088e41df47387566e12f6516ce Mon Sep 17 00:00:00 2001 From: ZiuChen Date: Tue, 19 Nov 2024 13:08:19 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E8=B6=85=E7=BA=A7=E5=89=AA=E8=B4=B4?= =?UTF-8?q?=E6=9D=BF=E5=8A=A8=E4=BD=9C=E7=BC=96=E8=BE=91=E5=99=A8=E6=95=99?= =?UTF-8?q?=E7=A8=8B=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/project/ClipboardManager/guide/index.md | 43 +++++++++++--------- 1 file changed, 24 insertions(+), 19 deletions(-) diff --git a/docs/project/ClipboardManager/guide/index.md b/docs/project/ClipboardManager/guide/index.md index b4d6d53c..de80afea 100644 --- a/docs/project/ClipboardManager/guide/index.md +++ b/docs/project/ClipboardManager/guide/index.md @@ -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` 展示在插件内的图标