内置扩展
Onin 内置了几个常用扩展,无需安装即可使用。
计算器
输入任意数学表达式,实时显示计算结果。
触发方式:直接输入数字或运算符,如 1+1、sin(30)、sqrt(16)
支持运算:
- 基础四则运算:
+、-、*、/ - 幂运算:
^或** - 括号:
() - 数学函数:
sin、cos、tan、sqrt、log、abs
使用示例:
输入:(100 + 200) * 3 / 2
结果:450按 Enter 可将结果复制到剪贴板。
剪贴板管理
查看当前剪贴板内容,并支持搜索历史记录(如果有剪贴板历史插件)。
触发方式:输入 clip 或 clipboard
文件搜索
搜索本机文件和文件夹,支持按名称、路径片段、扩展名和类型过滤,并可直接打开选中的结果。
触发方式:输入 file、files、find、search、文件搜索 或 本地搜索
使用示例:
- 输入
file,进入文件搜索模式 - 输入文件名、文件夹名或路径片段
- 使用
↑/↓选择结果 - 按
Enter或双击打开文件或文件夹
结果类型
文件搜索会返回两类结果:
| 类型 | 说明 | 打开行为 |
|---|---|---|
| File | 普通文件 | 使用系统默认应用打开 |
| Folder | 文件夹 | 使用系统默认文件管理器打开 |
选中结果后,右侧会显示详情。文件结果会尽量显示预览:图片、PDF、视频、音频、Markdown、JSON、XML、常见代码文件和纯文本文件会直接预览;不支持预览的文件会显示文件类型和元数据。
查询语法
文件搜索的查询由空格分隔的多个词组成。普通词会同时匹配文件名、文件夹名和路径片段;多个普通词需要同时匹配。
| 语法 | 作用 | 示例 |
|---|---|---|
notes | 搜索名称或路径中包含 notes 的结果 | notes |
project plan | 同时匹配 project 和 plan | project plan |
"project plan" | 将空格内的内容作为一个完整关键词 | "project plan" |
ext:<扩展名> | 按扩展名过滤 | project ext:md |
extension:<扩展名> | ext: 的等价写法 | report extension:pdf |
.<扩展名> | 扩展名过滤的简写 | image .png |
type:file 或 kind:file | 只显示文件 | config type:file |
type:folder 或 kind:dir | 只显示文件夹 | notes type:folder |
扩展名可以带点也可以不带点,例如 ext:md、ext:.md 和 .md 等价。查询不区分大小写。
类型过滤支持这些值:
| 类型 | 可用写法 |
|---|---|
| 文件 | type:file、type:files、kind:file、kind:files |
| 文件夹 | type:folder、type:folders、type:dir、type:dirs、type:directory、type:directories |
输入长度
- 中文、日文、韩文等 CJK 字符输入 1 个字符即可搜索
- 英文、数字和其他字符通常需要至少 2 个字符
- 只输入过滤条件不会返回结果,例如单独输入
ext:md没有普通关键词;应输入notes ext:md
排序规则
搜索结果会按相关性排序,优先级大致如下:
- 文件名完全匹配或不含扩展名的主文件名完全匹配
- 文件名前缀匹配
- 单词边界匹配,例如
my-project可被project命中 - 文件名包含匹配
- 去掉
-、_、.后的规范化匹配,例如myproject可匹配my-project - 模糊子序列匹配,例如
cfg可匹配config - 父目录或完整路径匹配
同分结果会优先显示文件夹、最近修改的结果、路径更浅的结果和名称更短的结果。桌面、文档、下载、图片、Projects、Code、Workspace 等常用目录中的结果会有额外排序加成。
搜索后端
Onin 不自己维护一套完整文件索引,而是调用当前系统可用的搜索后端:
- Windows:优先使用 Everything IPC;不可用时尝试 Everything CLI;未安装或不可用时使用 Windows Search
- macOS:使用 Spotlight
- Linux:使用
plocate或locate
Windows 上如果未检测到 Everything,进入文件搜索时会提示安装。也可以在设置 → 扩展 → 文件搜索中手动安装。
设置项
可在设置 → 扩展 → 文件搜索中配置:
- 排除路径:匹配这些路径的文件和文件夹不会出现在结果中
- 包含隐藏文件:默认不显示以
.开头的隐藏路径;开启后可显示 - 搜索后端状态:查看当前后端是否可用,以及 Windows 上 Everything 的安装和 IPC 状态
无论设置如何,搜索都会忽略常见缓存和构建目录,例如 .git、node_modules、target、dist、build、.cache、cache、caches、temp、tmp。
Emoji 搜索
在 Onin 中快速搜索并复制 Emoji。
触发方式:输入 emoji,然后在列表中搜索
使用示例:
- 输入
emoji,进入 Emoji 搜索模式 - 输入关键词如
fire、heart、smile - 选中后按
Enter将 Emoji 复制到剪贴板
翻译
快速翻译选中文本或输入内容。
触发方式:输入 trans 或 translate
支持的语言由翻译服务配置决定。
