英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

看

一个以键盘为主、本地优先的启动器，适用于 macOS、Windows 和 Linux。无需离开键盘即可打开应用程序、文件、文件夹、剪贴板历史记录和快速命令。

📷 原文此处有图片，请前往 GitHub 仓库查看完整内容。
📘 文档 · 📖 用户指南

https://github.com/user-attachments/assets/167b028b-04b2-4c62-ba93-c2321482ac94

结果显示速度和你输入的速度一样快。在 macOS 上，它是一个基于 Rust 核心、运行在原生 SwiftUI 应用上的启动器；在 Windows 和 Linux 上，它是一个使用 GPU 渲染的 gpui 外壳，并且整个过程中没有浏览器引擎。没有后台守护进程。你的索引、剪贴板和历史记录都保留在你的机器上；无遥测。

对比情况

如果这有用，⭐ 给仓库加星 - 这是帮助项目持续发布的最大信号。

安装

macOS

brew install --cask look

然后将 Cmd+Space 绑定到 Look（在 System Settings > Keyboard > Keyboard Shortcuts > Spotlight 中禁用 Spotlight 的快捷键），或者在 ~/.look/config 中使用 launcher_hotkey 选择另一个快捷键。
发布版本已签名并经过公证 - 无需绕过 Gatekeeper。每个发行版本针对每种架构提供一个构建版本，适用于 Apple Silicon 和 Intel。
Homebrew 安装 Apple Silicon 版本；在 Intel Mac 上使用下面 其他安装选项 中的 curl 安装程序，它会为你的电脑选择相应的归档文件。

Nix（flake）：

nix profile install 'github:kunkka19xx/look?dir=apps/linows'

与 Homebrew 发布的相同的签名、经过公证的捆绑包，因此可访问性和自动化权限在更新后仍然有效。目前仅支持 Apple Silicon。nix-darwin 和 Home Manager：请参阅 BUILDING.md。

Linux

发布的构件仅 x86_64 。ARM 构建未发布；如果需要，请提交 issue。

Arch Linux (AUR)：

yay -S look-bin
# or
paru -S look-bin

或者没有 AUR 助手时：

git clone https://aur.archlinux.org/look-bin.git
cd look-bin
makepkg -si

Ubuntu/Debian:

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/linux/install-look.sh | bash

或者从 Releases 手动下载 .deb，然后运行 sudo dpkg -i Look_*.deb。

任何发行版（AppImage）：

chmod +x Look_*.AppImage
./Look_*.AppImage

安装后，可从终端使用 lookapp 启动，或在应用启动器中搜索“Look”。随时按 Alt+Space 切换窗口。
要绑定您自己的快捷键，请在 ~/.look/config 中设置 launcher_hotkey=none，然后重启 Look，并在桌面设置中绑定 lookapp --toggle。
默认情况下，Look 会在登录时自动启动（在完整桌面环境如 GNOME/KDE 中）。

卸载：

# Arch
yay -R look-bin

# Ubuntu/Debian
sudo dpkg -r lookapp

# AppImage - just delete the file
rm Look_*.AppImage

NixOS（flake）：

nix profile install 'github:kunkka19xx/look?dir=apps/linows'

陈述式：

inputs.look.url = "github:kunkka19xx/look?dir=apps/linows";

# in your nixosSystem modules
look.nixosModules.default
{ programs.lookapp.enable = true; }   # binary cache included

家庭管理器的更新和故障排除：请参见 BUILDING.md。

注意： 在 GNOME 桌面环境中，首次安装后请注销并重新登录，以便 GNOME Shell 扩展（用于在 Wayland 下的窗口聚焦和热键）能够加载。

窗口管理器用户（i3, sway, Hyprland, niri 等）： 通过 .desktop 文件的自动启动仅适用于完整的桌面环境（GNOME、KDE）。在独立 WM 上，需要手动将 Look 添加到你的配置中。在 i3、sway 和 Hyprland 上，Alt+Space 热键和窗口规则（浮动、无边框）会在运行时自动注册，因此你只需要自动启动的那一行；niri 需要手动添加绑定（见下文）：

# i3: ~/.config/i3/config
exec --no-startup-id lookapp
# (Alt+Space works via X11 global shortcut plugin)

# sway: ~/.config/sway/config
exec lookapp
# (Alt+Space, float, and border rules are injected automatically via swaymsg)

# Hyprland: ~/.config/hypr/hyprland.conf
exec-once = lookapp
# (Alt+Space, float, and border rules are injected automatically via hyprctl)

niri 没有在运行时添加绑定的 API，所以 Alt+Space 必须你自己放入 ~/.config/niri/config.kdl 中，或者放入任何配置包含的文件中。Look 在首次运行时的设置通知中显示了你的系统的确切段落（在 NixOS 上 gdbus 路径有所不同）:

spawn-at-startup "lookapp"

binds {
    Alt+Space allow-inhibiting=false { spawn "gdbus" "call" "--session" "--dest" "com.look.Desktop" "--object-path" "/com/look/Desktop" "--method" "com.look.Desktop.Toggle"; }
}

allow-inhibiting=false 很重要：如果没有它，niri 会将按键传递给持有键盘快捷键抑制器的窗口，而全屏游戏、浏览器和虚拟机都会占用此抑制器，Look 永远无法覆盖它们。

任何键都可以，都是相同的 spawn 行：Look 只看到 D-Bus 调用。绑定一个 niri 已经使用的键（Mod+D 在默认配置中会启动 fuzzel），niri 会将整个配置拒绝为重复的键绑定，只保留最后一个有效的，所以先删除现有绑定，然后使用 niri validate 检查，或者如果你用 -c 启动 niri，就用 niri --config <path> validate。设置通知会列出 Look 实际读取的文件，该文件路径是 -c，然后是 NIRI_CONFIG，然后是 ~/.config/niri/config.kdl，然后是 /etc/niri/config.kdl——niri 会加载其中一个文件，且从不合并。

浮动模式是在运行时通过 niri 的 IPC 应用的；只有当你也希望关闭焦点环和阴影时，才添加规则：

window-rule {
    match app-id="^lookapp$"
    open-floating true
    focus-ring { off; }
    shadow { off; }
}

仅限 Hyprland 0.55。 Focus-existing-window 使用 wlr-foreign-toplevel-management 协议。较旧的 Hyprland 版本依赖已在 0.55 中弃用的旧 hyprctl dispatch focuswindow 语法；在 <0.55 版本中选择一个已运行的应用可能会启动第二个实例，而不是聚焦。升级到 0.55 以获得正确行为。

要从源码构建，请参见 apps/linows/BUILDING.md。

窗口

发布的构建版本仅适用于 x86_64。ARM 上的 Windows（Surface Pro X / Snapdragon X）可以在仿真下运行 x64 构建；未发布原生 ARM 构建——如果需要，请提出问题。

一行 PowerShell，无需管理员权限：

iex "& { $(irm https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/windows/install-look.ps1) }"

或者使用 Scoop（如果你已经安装了它）：

scoop bucket add extras
scoop install extras/look

该脚本会解析最新版本，下载 NSIS 安装程序，验证其 SHA256 是否与公布的校验和一致，并将其静默安装到 %LOCALAPPDATA%\Programs\Look 中。SmartScreen 在第一次下载时会发出警告，当声誉建立后，如果 Windows 阻止脚本本身，请点击“更多信息 → 仍然运行”。

卸载：

# Scoop
scoop uninstall look

# Installer script
iex "& { $(irm https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/windows/install-look.ps1) } -Uninstall"

# Optional: wipe user data
Remove-Item -Recurse "$env:LOCALAPPDATA\look"

启动器的全局热键默认为 Alt+Space；在 ~/.look/config 中设置 launcher_hotkey（例如 launcher_hotkey=ctrl+space）以更改它，然后使用 Ctrl+Shift+; 重新加载。手动安装：从 Releases 下载 Look_<version>_x64-setup.exe，核对 SHA256 是否与发布的 Look-<version>-windows-checksums.txt 一致，然后运行。通过设置 → 应用程序或 %LOCALAPPDATA%\Programs\Look\uninstall.exe 卸载。要清除用户数据：Remove-Item -Recurse "$env:LOCALAPPDATA\look"。

其他安装选项（curl、PIN版本、更新/卸载）

macOS - 自制更新/卸载：

# update
brew upgrade --cask look

# uninstall
brew uninstall --cask look

macOS - curl 安装程序：

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash

固定特定版本或仓库分支：

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash -s -- --version <version> --repo kunkka19xx/look

直接网址：

curl -fsSL https://raw.githubusercontent.com/kunkka19xx/look/main/scripts/install-look.sh | bash -s -- --url "https://github.com/kunkka19xx/look/releases/download/v<version>/Look-<version>-macOS.zip"

CLI 命名说明：macOS 自带 /usr/bin/look，因此终端命令示例使用 lookapp。

如果 Look 已完全退出且 Spotlight 仍未绑定，请从 Launchpad 重新启动，或通过以下方式启动：

open "/Applications/Look.app"

基本快捷方式

（在剩余的文档中，macOS 上的 Cmd+X 映射到 Windows 和 Linux 上的 Ctrl+X；启动器切换热键在 Windows/Linux 上使用 Alt+Space 而不是 Cmd+Space，因为 Win+Space / Super+Space 通常被操作系统或桌面环境保留。）

表格中的每个和弦都是默认的。在所有三个平台上，在 Settings > Shortcuts 中重新绑定应用内的和弦，或者在 ~/.look/config 中设置 shortcut_<group>_<action>；启动器切换在 macOS 和 Windows 上也会记录在那里，而 Linux 则使用 launcher_hotkey=none 和你自己绑定的 lookapp --toggle。详情请见 键盘快捷键。

Cmd+E 和 Cmd+T 需要一个名为 ~/.look/config 的工具（text_editor、code_editor、terminal），并且 file_manager 会重新定位 Cmd+F。什么也不声明，每个都会回退到系统默认：请参见 首选工具。

哪些超级操作显示在条带上、它们的位置，以及任何自定义磁贴信息，都记录在 ~/.look/super-actions.toml 中，首次运行时生成：见 超级操作。

完整参考： docs/user-guide.md.

主题

内置：Catppuccin、Tokyo Night、Rose Pine、Gruvbox、Dracula、Kanagawa、Kindle、Liquid，以及自定义。Kanagawa 是 Linux 和 Windows 上的默认设置。
Kindle 是唯一的浅色预设——纸张、墨水和衬线字体。
Liquid 在 macOS 26 的 Liquid Glass 上渲染，在旧版本中隐藏；在 Linux 和 Windows 上，它以透明玻璃形式提供——相同的调色板和几何形状，使用镜面边缘而非折射，并在合成器允许的情况下（KDE、Hyprland 0.56、Niri）实现真实的窗口背后模糊效果。
在 Settings > Appearance 中切换。

文档

• 📘 文档网站 - 托管的、可搜索的用户指南和参考资料
• 用户指南（仓库内） - 完整功能参考、快捷键、配置、权限、故障排除
• 架构 - Swift 应用与 Rust 核心如何结合
• 功能 - 已发布的功能及计划中的功能
• 贡献 - 如何贡献
• 你自己的资源 - 从目录、文件和命令中声明自定义行
• lookbook - 可复制的现成资源：git、ssh、docker、项目
• 编写控件 - 向面板添加快速操作切换/按钮
• 开发 - 本地构建、仓库布局、发布流程

许可

版权所有 (C) 2026 kunkka19xx

该程序是自由软件：您可以根据自由软件基金会发布的GNU通用公共许可证的条款重新分发和/或修改它
基金会，可以是许可证的第3版，也可以是（由您选择的）任何后续版本。完整文本请参见 LICENSE。