Skip to content

基础操作

分组操作

每一个片段都要属于某一个分组,因此必须先创建分组后才能继续使用。

创建分组

点击左侧 分组列表 下方的 + 号按钮,填写分组名称后完成分组的创建。

编辑分组

双击 想要修改的分组条目即可弹出分组修改窗口。

删除分组

首先点击需要删除的分组,点击完毕后会高亮显示对应条目,然后再点击左侧 分组列表 下方的 - 号按钮,即可删除分组。

注意

删除分组之前必须清空或移动分组下所有文本片段,保证分组下不能有任何文本片段才可进行删除。

分组排序

支持拖拽排序

分组搜索

点击分组右上方搜索图标, 输入搜索关键字回车即可完成搜索.

文本片段操作

片段包括 说明 启用状态 关键字 具体片段内容 4个基本实体内容,这是插件最底层的设计,所有功能都围绕此展开。

创建文本片段

文本片段创建支持三种方式,但无论哪一种方式都需要先创建一个分组才可以。

1. 普通方式创建

首先点击左侧一个分组, 然后点击右侧区域右下角的 + 号可弹出文本片段新增弹窗,这时候添加成功的片段就属于刚才点击的分组下面了。

2. 关键字方式创建

首先鼠标选中要添加的文本片段,然后呼出 uTools 在搜索框输入 添加文本片段 关键字即可快速进入插件并跳转到片段新增弹窗,片段内容也会自动添加好。

更加简单的操作是,可以将 添加文本片段 关键字设为快捷键,那操作就更加方便了。

3. 超级面板方式创建

首先鼠标选中要添加的文本片段,然后呼出 uTools 超级面板 选择 添加文本片段 即可快速进入插件并跳转到片段新增弹窗,片段内容也会自动添加好。

编辑文本片段

双击想要编辑的文本片段,会打开编辑弹窗页面。

删除文本片段

点击要删除的文本片段,然后点击右下角 - 号进行删除。

文本片段排序

文本片段支持拖拽排序

移动文本片段

打开编辑文本片段弹窗,会出现选择分组下拉框,保存后即可移动到其他分组。

文本片段弹窗中功能说明

新增/编辑文本片段会打开弹窗,接下来针对一些功能做说明。

文本片段说明

这个主要是为了备注片段是做什么的,在 uTools 搜索框模式为 列表模式 的情况下会在输入关键字下方出现此说明,在 聚合模式 下目前没有可显示的。

随着版本迭代,此说明可作为模糊匹配进行搜索。

所在分组

这里的下拉框会展示所有分组(但可能不会按照顺序),可以实现将文本片段切换到其他分组。

关键字

支持最多3个关键字,用于快速实现指定功能。

文本片段

这里是具体需要实现功能或粘贴之类的文本内容,支持占位符。

TIP

具体的占位符功能较多,规则较复杂详见: 占位符

v3.0.0 版本新增了分隔符设置, 可以对每个文本片段进行单独设置多参数的分隔符, 如果没有设置则使用全局配置的分隔符。

粘贴方式

目前支持三种方式,主要是为了解决部分软件的兼容性问题。

  • 模拟快捷键: 简单的将就是实现了将片段内容复制到剪贴板,然后执行 ctrl+V 粘贴到光标位置。
  • 键盘输入: 与模拟快捷键不同的是,此方式是使用输入法一个字一个字敲上去的,这会解决一些软件 ctrl+V 被占用的问题,比如 Xshell
  • 终端执行命令: 严格来说这不是一个粘贴方式,而是另一种功能选项,在文本片段是一个可执行的 bash 命令的时候,选择终端执行之后会自动打开终端->粘贴命令->敲击回车执行
  • 后置动作: 因为主要实现功能重度依赖剪贴板作为数据传输渠道,但有时候又不希望丢失刚刚剪切的内容,在这里可以设置保留/非保留的操作,和执行后是否按下回车键的操作。

终端执行命令类型

  • 默认: 使用系统默认的终端执行命令 (CMD / Terminal).
  • powershell: Windows可使用 PowerShell 执行命令.
  • iTerm2: MacOS用户可使用 iTerm2 执行命令, 需要提前安装 iTerm2.
  • Warp: MacOS用户可使用 Warp 执行命令, 需要提前安装 Warp.
  • Shell: 不显示任何终端窗口, 后台使用 Nodejs 执行 Sell命令, 如果执行出错会发送通知.

TIP

  • Shell类型 可以快速使用 webstrom vscode 等 IDE 打开执行项目, 可节省很多步骤.
  • cd /Users/xxx/front/example && /Applications/WebStorm.app/Contents/MacOS/webstorm ./ 这样的命令可以快速打开 WebStorm 并且打开指定项目.
  • Windows 使用 PowerShell 执行命令可使用 ; 将多个命令连接起来
  • 更多样的能力可以自行探索.

自定义图标

v3.0.2 版本为会员用户新增了可以对每一个文本片段自定义图标功能,允许上传 png 格式的图片作为图标。

推荐尺寸为 48x48 的透明背景图标, 将在 uTools 的搜索列表、插件主窗口以及分离窗口等对应位置中显示。

WARNING

  • uTools 动态功能的图标实现方式的限制,目前暂不支持数据导入导出时的图标保存,如果需要请手动重新上传。
  • 更改图标会有大概几分钟时间的缓存, 这是 uTools 的机制, 如果你想实时的查看效果可以重启 uTools 即可。

指令类型

v3.0.3 版本新增了指令类型的功能,主要是为了解决关键字无法自动固定到超级面板的问题,目前支持以下几种类型:

  • 默认: 选择此类型后关键字将无法自动固定到超级面板,需要手动固定或者手动在 uTools 的搜索框内触发。
  • 任意文本: 选择此类型后关键字将自动固定到超级面板,无需手动操作。
  • 正则匹配: 选择此类型后关键字将自动固定到超级面板,但只有在输入的关键字符合正则表达式的情况下才会在超级面板和搜索框中显示。

正则匹配场景示例

1. 匹配计算表达式

占位符: {selection:calculates:2}

指令类型: 正则匹配

正则表达式: /^(?:\d+(?:\.\d+)?|\(\d+(?:\.\d+)?\))(?:[-+*/](?:\d+(?:\.\d+)?|\((?:\d+(?:\.\d+)?(?:[-+*/]\d+(?:\.\d+)?)*)\)))*$/