内置扩展

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、文件搜索 或 本地搜索

使用示例：

1. 输入 file，进入文件搜索模式
2. 输入文件名、文件夹名或路径片段
3. 使用 ↑ / ↓ 选择结果
4. 按 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

排序规则

搜索结果会按相关性排序，优先级大致如下：

1. 文件名完全匹配或不含扩展名的主文件名完全匹配
2. 文件名前缀匹配
3. 单词边界匹配，例如 my-project 可被 project 命中
4. 文件名包含匹配
5. 去掉 -、_、. 后的规范化匹配，例如 myproject 可匹配 my-project
6. 模糊子序列匹配，例如 cfg 可匹配 config
7. 父目录或完整路径匹配

同分结果会优先显示文件夹、最近修改的结果、路径更浅的结果和名称更短的结果。桌面、文档、下载、图片、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。

---

颜色转换

解析常见 CSS 颜色值，实时预览颜色，并在 Hex、RGB、HSL、HWB、HSV、OKLCH 和 color(srgb) 等格式之间转换。

触发方式：

• 在启动器直接输入可识别颜色值，例如 #ff5500、f50、rgb(255, 85, 0)、hsl(20, 100%, 50%)
• 输入 color、colour、颜色、色值、hex、rgb、hsl 等关键词进入颜色转换页面
• 输入 取色、吸管、屏幕取色、picker 或 eyedropper 启动屏幕取色

快速转换

在启动器中直接输入颜色值时，Onin 会显示颜色预览和标准化后的格式。按 Enter 可复制标准化 Hex。

输入示例	结果示例
#f50	#FF5500
336699	#336699
rgb(255, 85, 0)	#FF5500
rgb(255 85 0 / 50%)	#FF550080
hsl(20deg 100% 50% / .5)	#FF550080
color #ff5500	#FF5500

启动器直接识别 Hex、RGB/RGBA、HSL/HSLA，并支持逗号分隔和现代 CSS 空格分隔写法。Hue 支持 deg、rad、turn 和 grad。

颜色转换页面

进入颜色转换页面后，可以：

• 使用顶部输入框输入或粘贴颜色值
• 在色盘中拖动调整颜色和透明度
• 点击任意格式行复制该格式
• 点击「全部」复制所有格式
• 按 Enter 复制当前 Hex

颜色转换页面支持更多输入格式：

格式	示例
Hex	#ff5500、#ff550080、#f50
RGB/RGBA	rgb(255, 85, 0)、rgb(255 85 0 / 50%)
HSL/HSLA	hsl(20, 100%, 50%)、hsl(20deg 100% 50% / .5)
HSV/HSVA	hsv(20, 100%, 100%)
HWB	hwb(20 0% 0%)
OKLCH	oklch(0.7 0.2 40)
OKLab	oklab(0.7 0.1 0.1)
CSS color()	color(srgb 1 0.3333 0 / 50%)

输出会统一包含 Hex、RGB、HSL、HWB、HSV、OKLCH、color(srgb) 和百分比 RGBA。带透明度的颜色会输出 8 位 Hex，例如 #FF550080。

屏幕取色

屏幕取色会临时隐藏主窗口，显示全屏取色覆盖层。完成取色后会回到主窗口并复制取到的 Hex。

平台支持：

平台	状态
Windows	支持屏幕取色
macOS	支持屏幕取色
Linux	暂未实现屏幕取色

在不支持的平台上，颜色转换页面仍可正常使用手动输入和色盘调整。

---

Emoji 搜索

在 Onin 中快速搜索并复制 Emoji。

触发方式：输入 emoji，然后在列表中搜索

使用示例：

1. 输入 emoji，进入 Emoji 搜索模式
2. 输入关键词如 fire、heart、smile
3. 选中后按 Enter 将 Emoji 复制到剪贴板

---

翻译

快速翻译选中文本或输入内容。

触发方式：输入 trans 或 translate

支持的语言由翻译服务配置决定。