文档

安装、快捷键、同步、剪贴板、端口、AI 用量和更新。

安装

最快的方式，适用于任何发行版：

curl -fsSL https://quickdesk.click/install.sh | bash

它会为你的系统选择 .deb、.rpm 或 AppImage，校验 SHA-256 后安装（查看脚本）。也可以从下载页面获取软件包，然后这样安装下载的文件：

  • Ubuntu、Debian、Mint、Pop!_OS： sudo apt install ~/Downloads/QuickDesk_<version>_amd64.deb
  • Fedora、openSUSE： sudo dnf install ~/Downloads/QuickDesk-<version>-1.x86_64.rpm
  • 其他发行版： 给 AppImage 加上可执行权限后运行。它需要 FUSE 2（libfuse2，在 Ubuntu 24.04 上是 libfuse2t64）。

QuickDesk 需要近几年的 x86_64 系统（glibc 2.34 或更新）。它在 GNOME 上效果最好，Wayland 和 X11 均可。

Windows 10 和 11（64 位）： 在 PowerShell 中运行 irm https://quickdesk.click/install.ps1 | iex，或从下载页面下载安装程序。它只为你的用户安装，不需要管理员权限。安装程序尚未签名，因此 Windows 可能会提示“已保护你的电脑”：选择更多信息 → 仍要运行。在 Windows 上，快捷键是 Win Alt N / V / P，QuickDesk 位于系统托盘，自动粘贴无需设置。那里的 Runtimes 标签通过 mise、rustup 和 uv 工作（见语言版本）。

首次启动时，欢迎界面会列出快捷键并提供两个选项：登录时启动（剪贴板历史和 AI 圆环要一直工作就需要它）和即时粘贴（见自动粘贴）。之后 QuickDesk 就待在顶部栏中。

macOS

仍在开发中。Mac 版已经可以使用，但它还很新：并非所有功能都在每台 Mac 上测试过，自动粘贴和快捷键仍在完善中。如果有什么不能用，请告诉我们。

QuickDesk 可在 Apple 芯片（M1 及更新）的 macOS 11 或更高版本上运行。在终端中运行 curl -fsSL https://quickdesk.click/install.sh | bash：它会把 QuickDesk.app 放进“应用程序”并打开。也可以从下载页面下载 .dmg，把 QuickDesk 拖到“应用程序”。

首次打开。QuickDesk 尚未经过 Apple 公证，因此如果 .dmg 是用浏览器下载的，macOS 会在首次启动时提示“Apple 无法检查其是否包含恶意软件”。应用本身没有问题；只需执行以下任一方法一次（用命令安装则不会有警告）：

  1. 从“应用程序”打开 QuickDesk，在 macOS 警告时点击完成。然后打开“系统设置 → 隐私与安全性”，向下滚动到“安全性”，在“已阻止 QuickDesk 以保护你的 Mac”旁边点击仍要打开，用密码或触控 ID 确认，再点击打开。在 macOS 14 或更早版本上，按住 Control 点按 QuickDesk → 打开 → 打开 也可以。
  2. 或者在终端中运行 xattr -dr com.apple.quarantine /Applications/QuickDesk.app，然后照常打开 QuickDesk。

下载页面上也有同样的步骤。

  • QuickDesk 位于菜单栏，没有程序坞图标。它的弹出窗口会在你当前所在的空间中打开，即使有应用处于全屏状态。
  • 快捷键是 ⌃ ⌥ N / V / P（Control + Option）：⌘⌥V 和 ⌘⌥N 属于访达。
  • 自动粘贴会在你刚才使用的应用中按下 ⌘V，macOS 只有在你于“系统设置 → 隐私与安全性 → 辅助功能”中添加 QuickDesk 之后才允许这样做。macOS 会在你第一次选择记录时询问；在此之前，记录会被复制，由你自己按 ⌘V。Settings → Auto-paste 会显示是否已允许。
  • 较新的 macOS 版本可能会询问 QuickDesk 能否读取其他应用复制的内容。请选择“允许”，否则剪贴板历史会一直是空的。
  • Claude 用量：在 Mac 上，Claude Code 把登录信息保存在钥匙串中。AI 标签会提出从那里读取；随后 macOS 会询问一次（选择始终允许）。与其他系统一样，登录信息只会被读取，并且只发送到 api.anthropic.com。
  • 由于应用采用 ad hoc 签名，更新后 macOS 可能会再次请求“辅助功能”和钥匙串权限。如果自动粘贴失效，请把 QuickDesk 从“辅助功能”列表中移除后再重新添加。
  • Runtimes 标签的工作方式与 Linux 上相同，使用你的登录 shell（zsh：~/.zshrc）。用 Homebrew 安装的副本会显示出来，但不会被修改。

卸载：从菜单栏退出 QuickDesk，然后把它从“应用程序”移到废纸篓。你的数据保留在 ~/Library/Application Support/click.quickdesk，直到你删除该文件夹。

快捷键

快捷键打开
Super Alt N笔记
Super Alt V剪贴板历史弹窗
Super Alt P端口
未设置快速笔记弹窗（可在 Settings 中设置）

窗口打开时再次按下快捷键会将其关闭。可以在 Settings → Hotkeys 中更改任何快捷键；如果组合已被占用，QuickDesk 会发出提醒。

在 GNOME 上，快捷键会被添加到设置 → 键盘 → 自定义快捷键，并在 QuickDesk 退出时删除，因此在 Wayland 上也能使用。在其他桌面上，请在桌面的键盘设置中把 quickdesk toggle notes、quickdesk toggle clipboard、quickdesk toggle ports 或 quickdesk toggle quick-note 绑定到按键。

为什么是 Super + Alt？在文本框中输入时，Unikey 和 Bamboo 等越南语输入法会吞掉 Super + Shift + 字母；带 Alt 的组合则不受影响。

笔记

笔记使用 Markdown 和富文本编辑器：标题、粗体和斜体、列表、清单、引用和代码块。Ctrl N 新建笔记，Ctrl S 保存，Ctrl F 搜索。搜索会忽略重音符号，因此 tieng viet 能找到 “tiếng Việt”。

点星标可以把笔记固定在顶部。删除前会先询问，并且几秒内可以撤销。

在多台电脑之间同步笔记

笔记通过 QuickDesk Cloud 同步。不需要账号或邮箱：一台电脑获得一个同步码，你的其他电脑用它加入。只同步笔记；剪贴板历史和设置留在各自的电脑上。

设置

  1. 在第一台电脑上：Settings → Sync → Turn on sync，并选择一个密码短语（至少 8 个字符）。
  2. QuickDesk 会显示你的同步码（QD1-…）和恢复密钥。请把恢复密钥保存在安全的地方；它只显示一次。
  3. 在其他每台电脑上：Settings → Sync → I have a sync code，然后输入同步码和相同的密码短语（或恢复密钥）。

随时可以在 Settings → Sync 中用 Show sync code 再次显示同步码。

何时同步

  • 编辑笔记几秒钟之后，以及打开 QuickDesk 窗口时。
  • 其他时候，窗口打开时 QuickDesk 每分钟检查一次更改，待在托盘中时每 5 分钟检查一次。每次检查只是一个很小的请求；只有内容有变化时才会传输笔记。
  • Sync now 会立即检查。离线时的修改会在你重新联网后发送。
  • 如果同一条笔记在两台电脑上同时被修改，两个版本都会保留：较新的那个保留原位，另一个成为旁边的副本。编辑优先于删除。

隐私与密钥

  • 笔记在上传之前就在你的电脑上加密（XChaCha20-Poly1305，密钥通过 Argon2id 从你的密码短语派生）。QuickDesk Cloud 只以随机账户 ID 保存密文，无法读取你的笔记。
  • 需要同时拥有同步码（用于访问数据）和密码短语（用于解密）。请像对待密码一样对待同步码：仅凭它，别人仍然可以删除你已同步的笔记。
  • 忘记了密码短语？改为输入恢复密钥。两者都没有的话，QuickDesk Cloud 中的副本无法打开，但每台电脑上的笔记不受影响。
  • 如果 QuickDesk 要求 Unlock sync（例如系统钥匙串被重置之后），请再次输入密码短语。

关闭同步

Turn off sync… 会停止在某台电脑上同步，并保留它的笔记。勾选 Also delete my notes from QuickDesk Cloud 可为所有电脑删除已同步的副本。

每个同步码的上限：256 MB 和 20,000 个存储对象，远超笔记所需。

剪贴板历史

你复制的一切都会被保存：文字、图片（截图）以及在文件管理器中复制的文件。用 Super Alt V 打开弹窗，输入即可搜索，可按文字、图片或文件筛选，按 Enter 粘贴到你刚才使用的应用中。Ctrl Enter 只复制，Ctrl P 固定，Del 删除。

  • 历史记录留在这台电脑上，从不同步。
  • 被密码管理器标记为机密的内容会被跳过。在复制敏感内容之前，可以暂停保存 15 分钟、1 小时，或直到你重新开启（在 Clipboard 标签或托盘菜单中）。
  • QuickDesk 保留最近 1,000 条记录；已固定的永久保留。文字最大 1 MB，每张图片最大 10 MB，总计 200 MB。
  • Clipboard 标签中的 Clear… 会删除除已固定记录以外的所有内容。

自动粘贴

当你选中一条记录时，QuickDesk 会回到你刚才使用的应用并按下 Shift Insert，这在终端中也有效。在 Settings → Auto-paste 中选择方式：

  • Desktop portal（默认）：GNOME 只请求一次权限，粘贴时显示远程控制指示器。
  • Instant (virtual keyboard)：没有提示也没有指示器。启用时需要输入一次管理员密码，以允许以你的身份运行的程序创建虚拟键盘（Steam 为手柄使用的就是同样的权限）。

在 Clipboard 标签中关闭自动粘贴后，就只复制，由你自己按 Ctrl V。

端口

Super Alt P 列出所有正在监听的 TCP 端口（IPv4 和 IPv6），以及进程、完整命令行和用户，每 2 秒刷新一次。可以按端口、PID、进程或容器名称筛选。

  • Open 在浏览器中打开 http://localhost:<port>；Copy PID 和 Copy cmd 复制相应内容。
  • Kill 会先询问，然后温和地停止进程，只有在它不退出时才提供强制结束。
  • 由 Docker 发布的端口会显示容器和镜像，Stop 会停止容器，而不是结束 docker-proxy。
  • 属于其他用户的进程（系统服务）显示为隐藏；查看它们需要 root 权限。

语言版本（Runtimes）

Runtimes 标签管理这台电脑上各编程语言的版本（Node.js、Python、Rust、Go、Java、Ruby、Deno、Bun、PHP）。它显示新终端运行的版本及其来源。QuickDesk 会询问你的登录 shell，因此这正是执行 ~/.bashrc 或 ~/.zshrc 之后得到的结果，而不是桌面看到的。

  • 用 nvm（Node.js）、rustup（Rust）、uv（Python）或 mise（Go、Java、Ruby、Deno、Bun、PHP 等）安装的语言可以修改：Install version… 从工具提供的版本中选择（rustup 接受你输入的渠道或版本），Make default 设置新终端使用的版本，Uninstall 删除某个版本并释放空间。默认版本不能删除；请先选择另一个默认版本。
  • 安装在后台运行，有进度条，可以取消。一次只运行一项更改。版本列表默认显示每个版本线的最新版本；可切换为 LTS 或全部，也可以输入进行筛选。
  • 当已安装版本线有更新的版本发布时（例如 22.23.3 有了 Node 22.24.1，3.13.7 有了 Python 3.13.9），该版本会显示 ↑ 22.24.1：一键安装新版本，如果旧版本是默认版本，则把新版本设为默认。旧版本会保留，直到你卸载它。Rust 渠道则是原地更新：当 rustup 有更新的 stable 时，stable 会显示 ↑ 1.93.0，点击会运行 rustup update stable。
  • Apply right away in open terminals（标签顶部）让更改从下一个提示符起就作用于已经打开的终端：QuickDesk 会在你的 shell 文件中加一行，加载一个小的提示符钩子（~/.config/quickdesk/shell/hook.sh）。这个钩子会让 shell 在 QuickDesk 更改版本后重新查找命令，并让 Node 在你 cd 进入项目时跟随最近的 .nvmrc，否则使用你选择的默认版本（手动 nvm use 会一直有效，直到你更换文件夹或默认版本）。没有它的话，Rust 的更改仍会立即生效，Python 和 mise 的更改会作用于新终端（或在已打开的终端中执行 hash -r 之后），nvm 的更改只作用于新终端。
  • Set for a project… 会在你选择的文件夹中写入该工具自己的文件：.nvmrc、rust-toolchain.toml、.python-version 或 mise.toml（mise 会保留其中已列出的其他工具）。
  • 没有版本管理器的语言（例如通过 apt 安装的 Go）会提供 Install mise…：QuickDesk 从 github.com/jdx/mise 下载最新的 mise，用该版本的 SHA-256 校验和进行核对，并放到 ~/.local/bin。在你把某个版本设为默认之后，Fix PATH… 会提供在你的 shell 中启用 mise 的那一行。
  • 如果新终端运行的不是默认版本（例如系统自带的 python3 在 PATH 中排在前面），卡片会说明原因，Fix PATH… 会显示它将要添加的具体内容。只有在你同意之后，QuickDesk 才会把它们作为一个带标记的块添加到 shell 文件末尾，并在旁边留一份备份；之后也可以在同一处删除这个块。
  • PATH 修复和提示符钩子是为 bash（~/.bashrc）和 zsh（~/.zshrc）编写的；暂不支持 fish。
  • 电脑上还没有的语言列在 Add a language 下：选择一个，必要时先安装 mise，然后选择版本。
  • Windows：QuickDesk 询问 PowerShell 新终端运行的是什么，并通过 mise（安装到 %LOCALAPPDATA%\mise\bin）、rustup 和 uv 工作；nvm-windows 和 fnm 会显示但不会被修改，Microsoft Store 的 python.exe 占位程序会被忽略。Fix PATH… 会把工具的文件夹（对 mise 来说是它的 shims）放到你账户 PATH（即“设置 → 环境变量”中的那个）的最前面，不需要管理员权限；旧值保存在 ~\.config\quickdesk\path，同一个面板也可以再次删除这些文件夹。新终端会采用它；之后更改默认版本会立即生效。Windows 上不需要也不会显示 “Apply right away”。
  • 系统安装的副本（apt、dnf）永远不会被修改或删除；QuickDesk 从不运行 sudo。由它不支持的工具（fnm、volta、pyenv、SDKMAN…）管理的语言以只读方式显示。

AI 用量

顶部栏中的一个圆环显示你已经用了多少 AI 限额，用绿色、琥珀色或红色表示。它的菜单显示你跟踪的工具，每项限额一个进度条以及重置时间；AI 标签显示所有工具。

  • Claude Code：QuickDesk 读取 Claude Code 已保存在这台电脑上的登录信息，并向 Anthropic 查询你的用量，最多每 5 分钟一次。令牌只被读取：从不存储、刷新，也不会发送到 Anthropic 以外的任何地方。
  • Codex：读取 Codex 保存在 ~/.codex 中的会话日志。
  • Gemini（Antigravity）：它不提供百分比，因此 QuickDesk 根据它的日志显示你上次用完配额的时间。

在 Track 下选择要跟踪的工具和限额，或在 AI 标签中隐藏圆环。

更新

QuickDesk 在启动 30 秒后检查新版本，之后每 6 小时检查一次。有新版本时，主窗口中的横幅和托盘菜单顶部的一项会提示你，并附有 What’s New。在你点击 Update Now 之前，不会安装任何东西。

每次更新在安装前都会用 QuickDesk 的签名密钥进行验证。.deb 或 .rpm 会要求输入管理员密码；AppImage 会替换自身。随后 QuickDesk 会重启并显示更新内容。可以在 Settings → Updates 中关闭自动检查或手动检查。

卸载

  1. 在 Settings 中关闭 Start QuickDesk when I log in，然后从托盘退出。
  2. 删除软件包：sudo apt remove quick-desk（Debian/Ubuntu）或 sudo dnf remove QuickDesk（Fedora），或者删除 AppImage。
  3. 你的数据保留在 ~/.local/share/click.quickdesk，直到你删除该文件夹。

Windows：设置 → 应用 → 已安装的应用 → QuickDesk → 卸载。你的数据保留在 %APPDATA%\click.quickdesk，直到你删除该文件夹。

删除软件包也会移除即时粘贴权限（如果你启用过）。

故障排除

  • 快捷键没反应：在设置 → 键盘 → 自定义快捷键中检查是否有冲突，或在 Settings → Hotkeys 中换一个组合。
  • 自动粘贴没有输入任何内容：确认你刚才使用的应用仍然处于焦点状态；在 Settings → Auto-paste 中更换方式。记录总是会被复制，所以 Ctrl V 可以用。
  • 日志：~/.local/share/click.quickdesk/logs/。报告问题时请附上它们。

还有疑问？ 在 GitHub 上提问 · 隐私