Windows-first 桌面效率工具
Easy Launcher 产品文档
Easy Launcher 是一个基于 Tauri 2、Rust、React、TypeScript 和 Vite 构建的 Windows 桌面启动器。
它把应用启动、文件搜索、系统命令、快捷短语、网页搜索、工具命令、AI 文本处理和可配置快捷入口集中在一个紧凑入口里。
日常使用可以双击 Alt 呼出主窗口，也可以按住 Ctrl 后用鼠标划词，直接唤起 AI 小对话框处理选中文本。
当前能力
快速搜索
支持应用、文件、命令、计算器、快捷短语、网页搜索、工具命令和 AI 动作。
划词 AI
按住 Ctrl 用鼠标划词，松开后呼出小浮条，可记录原文、加入待办，或继续翻译、总结、解释和润色。
Slash Board
输入 Alias 打开两列快捷入口，可聚合命令、短语、划词记录、待办、网页模板、工具和最近打开。
桌面集成
支持托盘常驻、全局快捷键、开机自启动、配置导入导出、更新检查和未签名 MSI 构建。
系统要求
| 项目 | 要求 | 说明 |
|---|---|---|
| 操作系统 | Windows 10 / Windows 11 | 当前版本是 Windows-first，macOS 和 Linux 暂不支持。 |
| 前端环境 | Node.js 18 或更新版本 | 用于安装 npm 依赖、运行 Vite 和 Tauri CLI。 |
| 后端环境 | Rust stable toolchain | 用于编译 Tauri/Rust 后端。 |
| Windows 编译工具 | Microsoft C++ Build Tools 2022 | 需要 MSVC 和 Windows SDK。 |
| 可选依赖 | Everything | 用于高速文件搜索。未安装时仍可使用其他搜索源。 |
快速开始
安装 v0.2.1
当前 Windows 安装包产物为
Easy Launcher_0.2.1_x64_en-US.msi。MSI 仍未签名，安装时可能出现 Windows 安全提示。
安装依赖
npm install检查 Tauri 环境
npm run tauri -- info启动桌面开发版
npm run tauri -- dev
如果 Rust 安装在
D:\Dev\cargo 和 D:\Dev\rustup，项目内的 Tauri 包装脚本会自动补齐环境变量。
默认安装位置通常不需要额外设置。
主启动器使用
- 双击
Alt可快速打开启动器主窗口；也可以按Alt+1打开或隐藏主窗口。 - 隐藏后只保留系统托盘入口，不占用任务栏。
- 输入关键词搜索应用、文件、命令、计算器结果、快捷短语、网页搜索或 AI 动作。
- 使用方向键选择结果，按
Enter执行主动作。 - 右键结果或按
Shift+Enter打开上下文菜单，可执行打开目录、资源管理器选中、复制路径/名称/文件本体、打开方式、配置编辑器、快速访问、当前目录终端、管理员运行、以其他用户运行、删除和隐藏等次级动作。 - 搜索页可从非交互区域拖动窗口；从设置页返回搜索页时保留原搜索窗口位置。
- 点击设置入口可打开设置页面，管理搜索源、快捷键、AI 配置和导入导出。
搜索能力
| 能力 | 用法 | 说明 |
|---|---|---|
| 应用搜索 | 输入应用名、别名或拼音 | 索引开始菜单、桌面、常见安装目录、WindowsApps 和 PATH 程序。 |
| 文件搜索 | 输入文件名或路径片段 | 优先 Everything IPC，HTTP 作为备用；支持打开文件和打开所在目录。 |
| 目录内搜索 | C:\work\ easy |
在指定目录下搜索关键字，Everything 查询会带路径约束。 |
| Action Keyword | app、file、cmd、calc、phrase、ai、web |
通过显式前缀限定搜索来源，未知前缀会按普通查询处理。 |
| 快捷入口 Alias | /、/cmd、/phrase、/mark、/todo、/web、/tools |
输入 Alias 本身打开 Slash Board；进入工具后继续保留 Alias，例如 /tools enc 。 |
| 网页搜索模板 | 配置带 {query} 的 URL 模板 |
执行后使用默认浏览器打开，例如 Bing、Google 或内部检索地址。 |
| 计算器 | =1+2*3 或直接输入算式 |
返回可复制或执行的计算结果。 |
Everything 高级选项
- 支持全路径搜索开关。
- 支持可选内容搜索开关。
- Everything 未安装或未运行时，启动器会返回可执行诊断结果，引导安装或启动。
- HTTP Server 默认访问
127.0.0.1:8080，需要在 Everything 的“工具 > 选项 > HTTP 服务器”中手动开启。
快捷入口和 Slash Board
快捷入口默认 Alias 是 /，可在设置页改成 > 等更少冲突的符号。
空搜索页保持干净；只有输入 Alias 本身时才进入 Slash Board。
| 入口 | 内容 | 说明 |
|---|---|---|
/ |
Slash Board 两列面板 | 左侧是范围 rail，右侧显示当前范围下的具体内容。 |
/cmd |
自定义命令 | 只展示用户配置的自定义命令，不混入系统命令。 |
/phrase |
快捷短语 | 空输入展示全部短语，继续输入可按标题和内容过滤。 |
/mark |
划词记录 | 只展示通过划词浮条保存的原文记录，不进入普通搜索；可打开、复制或删除。 |
/todo |
待办提醒 | 集中管理划词加入的待办，支持完成、稍后、修改提醒时间、修改内容和删除。 |
/web |
网页搜索模板 | /web gh tauri 会使用 gh 模板搜索 tauri。 |
/tools |
工具命令 | 包含 enc、dec、pwd、time；进入工具时继续保留 Alias。 |
/recent-apps |
最近打开应用 | 只记录通过 Easy Launcher 打开的 exe 和 .lnk 快捷方式，最多展示 8 条。 |
/recent-folders |
最近打开目录 | 只展示通过 Easy Launcher 打开的真实目录，不从普通文件反推父目录。 |
Slash Board 菜单配置
- 左侧范围包括
All、Run、Text、Web、Tools、Recent、Open、System。 - 设置页可隐藏范围，也可通过三横线手柄拖拽排序。
- 两列排序按列优先展示：左列 01 到 04，右列 05 到 08。
- 至少保留一个可见范围；隐藏范围不影响直接输入对应命令。
- 配置存储在
slash.board.scopes，导入配置时会自动清理未知 id、重复 id 和全 hidden 状态。
划词菜单和 AI 动作
- 按
Alt+3打开 AI 面板，进行普通对话。 - 开启划词功能后，可在任意应用中按住
Ctrl并用鼠标拖选文本。 - 松开鼠标后会自动呼出划词浮条，浮条最多展示 6 个可见入口，多余 AI 动作收进下拉菜单。
- 记录图标会保存当前划词原文，保存后短暂显示“已记录”再关闭浮条；记录可通过
/mark找回。 - 待办入口会先选择提醒时间，支持 10 分钟后、30 分钟后、1 小时后、今晚/明晚 20:00、明早 09:00 和自定义日期时间；待办可通过
/todo管理。 - 划词动作包括翻译、总结、专业解释、润色和提取要点；可在设置中控制每个动作是否显示。
- 取词会临时模拟
Ctrl+C，等待系统剪贴板内容变化后恢复原文本剪贴板。
待办提醒
- 到提醒时间后会弹出独立提醒窗口，可直接完成或稍后提醒。
- 稍后提醒默认延迟 10 分钟。
- 已完成待办可在设置中批量清理。
AI 配置
AI 功能使用 OpenAI 兼容 Chat Completions 接口，需要在设置中填写：
Base URL：例如https://api.openai.com、兼容服务地址或完整/v1/chat/completions地址。API Key：服务提供方生成的密钥。Model：例如gpt-4.1-mini或兼容服务提供的模型名。
后端通过 Rust 发起请求，前端通过 Tauri event 接收流式输出，并支持取消请求。
设置和本地数据
可配置项
- 主启动器快捷键和 AI 面板快捷键。
- 应用、文件、系统命令、计算器、快捷短语、AI、网页搜索等搜索源开关。
- 快捷入口 Alias 和 Slash Board 左侧菜单显示/排序。
- 可配置文件编辑器和目录编辑器路径；配置后文件/目录上下文菜单会把当前路径传给对应编辑器。
- 搜索权重、网页搜索模板、自定义命令、快捷短语、排除规则。
- Everything 全路径搜索和内容搜索选项。
- AI Provider、Model Profile、Assistant 和划词动作入口。
- 划词记录和待办提醒清理操作。
- 开机自启动和划词触发模式开关。
- 更新检查开关、检查间隔、预发布版本开关和手动检查。
数据目录
%LocalAppData%\EasyLauncher\| 文件或目录 | 用途 |
|---|---|
data.db |
SQLite 数据库，保存设置、最近使用、应用索引和 AI 配置。 |
exports\ |
配置导出目录。 |
logs\ |
日志目录。 |
配置导出默认不包含
ai.api_key、最近使用记录和应用索引。
开发运行
| 命令 | 用途 |
|---|---|
npm run dev |
启动 Vite Web 预览，地址为 http://127.0.0.1:1420/。 |
npm run tauri -- dev |
运行带 Rust 后端的桌面开发版。 |
npm run task |
使用统一任务脚本，交互选择启动或打包。 |
npm run start:desktop |
直接启动桌面开发项目。 |
npm run build |
执行 TypeScript 类型检查并构建前端。 |
打包编译
前端生产构建
npm run build构建 Windows 桌面安装包
npm run tauri -- build使用项目打包脚本
npm run build:msi构建调试可执行文件但不打包安装器
npm run tauri -- build --debug --no-bundle| 产物 | 位置 |
|---|---|
| MSI 安装包 | src-tauri\target\release\bundle\msi\Easy Launcher_0.2.1_x64_en-US.msi |
| 调试可执行文件 | src-tauri\target\debug\easy-launcher.exe |
| 前端静态构建 | dist\ |
当前 MSI 未签名，Windows 安装时可能显示安全提示。这是当前版本的已知发布限制。
验证测试
Rust 单元测试
$env:RUSTUP_HOME='D:\Dev\rustup'
$env:CARGO_HOME='D:\Dev\cargo'
$env:Path='D:\Dev\cargo\bin;' + $env:Path
cargo test --manifest-path src-tauri\Cargo.toml前端构建验证
npm run build建议手动验证
- 双击
Alt呼出主窗口。 Alt+1呼出和隐藏主窗口。- 修改主快捷键后无需重启即可生效。
- 按住
Ctrl并用鼠标划词，松开后应呼出划词 AI 小对话框。 - 划词浮条中点击记录图标，应短暂显示“已记录”并关闭；输入
/mark应能看到刚保存的记录。 - 划词浮条中点击待办，选择提醒时间后加入；输入
/todo应能看到待办并执行完成、稍后、修改和删除。 - 输入
/打开 Slash Board，验证范围切换、拖拽排序和隐藏范围。 - 输入
/tools选择enc后，输入框应进入/tools enc。 - 搜索并启动 3 个本机应用。
- Everything 文件搜索、打开文件和打开目录。
- 搜索结果上下文菜单：资源管理器选中、复制路径/名称/文件本体、打开方式、配置编辑器、快速访问、当前目录终端、管理员运行、以其他用户运行、删除和隐藏。
- 配置导出、导入和非法 JSON 错误提示。
- 开机自启动注册表写入和删除。
- 托盘菜单的打开主窗口、打开设置、检查 Everything 状态和退出；主窗口隐藏后不应出现在任务栏。
- 拖动搜索页非交互区域后，进入设置再返回搜索页，窗口应恢复到原搜索位置。
- 配置真实 AI 服务后的翻译、总结、解释、流式输出和取消。
安全说明和限制
当前版本没有接入 Windows Credential Manager。AI API Key 会明文保存在本机 SQLite 数据库中：
%LocalAppData%\EasyLauncher\data.db。
- 不要在共享电脑、受管设备或不可信环境中保存重要 API Key。
- 划词取词通过模拟
Ctrl+C实现，已增加剪贴板变化检测和等待重试，但部分应用仍可能无法读取选中文本。 Ctrl+划词使用 Windows 全局键鼠监听实现，可能受安全软件、远程桌面、管理员权限边界或特殊应用输入模型影响；误触场景可切回默认快捷键模式。- 模拟复制会短暂占用剪贴板，程序会尝试恢复原文本剪贴板内容；如果原剪贴板不是文本内容，当前版本只能恢复为空文本。
- UWP / Microsoft Store 应用扫描暂不支持。
- 尚未完成自动更新和代码签名。