企业官网建设流程全解析

RustCast 是一款用 Rust 编写的开源 macOS 启动器，它的**剪贴板历史（Clipboard History）**功能免费、本地化、无广告：每一次复制的文本、链接和图片都会自动存入本地 SQLite 数据库，按下快捷键即可秒级调取粘贴，是一款真正属于你自己的免费剪贴板管理器。

⚠️ 小提示：RustCast 目前已停止维护（retired），但代码完全开源，功能依旧稳定可用，日常当剪贴板管理器绰绰有余。

为什么选择 RustCast 剪贴板历史？

市面主流剪贴板管理工具要么收费，要么需要登录账号、把数据同步到云端。RustCast 的cbhist方案完全不同：

所有历史数据保存在本机~/Library/Application Support/rustcast/clipboard.db文件中，断网也能用，隐私完全可控。

快速安装 RustCast（1 分钟搞定）

方式一：Homebrew 一行命令安装（推荐）

brew install --cask unsecretised/tap/rustcast

方式二：手动下载 dmg 安装包

从 GitHub Releases 下载rustcast.dmg，拖入 Applications 即可。

首次启动后，RustCast 会自动在你的用户目录生成默认配置（参考 docs/default.toml），剪贴板历史功能默认已开启，无需任何设置即可直接使用。

三种方式打开剪贴板历史页面

RustCast 提供三种进入剪贴板历史（cbhist）页面的方式，任选其一：

1. 全局快捷键（最快）：默认是SUPER+SHIFT+C（即⌘ + ⇧ + C），在任何应用里随时按下；
2. 输入关键词：唤出 RustCast 主窗口（默认ALT+SPACE），在搜索框输入cbhist，回车即进入；
3. 搜索结果直达：在搜索框输入 cbhist 后会出现对应入口，方向键选中后回车。

进入后你会看到这样的界面：左侧是按时间倒序排列的历史条目列表，右侧是内容预览区。

核心操作：选一条历史，回车即粘贴

• ↑ / ↓ 方向键：在历史条目间移动（也支持 Vim 风格的Ctrl+N/Ctrl+P）
• Enter：把选中的内容复制回剪贴板，窗口自动收起；开启 Paste on select 后还会自动模拟 ⌘+V 粘贴到前台应用
• Esc：清空输入 / 返回 / 关闭窗口

图片也能秒级粘贴：图片剪贴板历史实战

这是 RustCast 最亮眼的能力之一：剪贴板中的截图、图片也会被自动捕获并持久化存储，而不只是文字。

图片捕获原理

在 src/app/tile.rs 中，RustCast 启动了一个后台监听协程，每 100 毫秒轮询一次系统剪贴板：

• 优先尝试读取图片内容（clipboard.get_image()）
• 否则判断是否为合法 URL（如截图分享链接）
• 最后兜底读取纯文本

内容一旦变化，立即写入 SQLite，所以你在任意应用里⌘+C复制一张截图后，历史页面立刻就能看到它。

图片历史记录怎么查看和粘贴？

1. 按⌘+⇧+C打开剪贴板历史；
2. 在搜索框输入image可快速筛选出所有图片类条目；
3. 方向键选中某条图片，右侧预览区会直接渲染出这张图；
4. 按 Enter，图片被写回系统剪贴板，你切回聊天/文档窗口粘贴即可。

数据库里图片是以二进制 BLOB 形式存储的（见 migrations/db_init.sql 中的blob_content字段），读取时由 src/database.rs 自动解码还原，全程无需手动干预。

文本与链接：20 字符缩略 + URL 一键打开

不同类型的历史记录在列表中有差异化展示（实现见 src/clipboard.rs）：

• 文本（text）：只显示前 20 个字符并加...缩略，超长内容在右侧预览区完整展开；
• 链接（url）：自动识别出 URL，选中后预览区下方会出现一个打开按钮，直接跳转浏览器；
• 图片（image）：显示Image标签，选中后渲染图片预览。

每条记录底部还有两个实用按钮：🗑️删除单条、Clear 清空全部历史。

配置进阶：剪贴板快捷键与 Paste on Select

修改剪贴板专用快捷键

编辑配置文件~/.config/rustcast/config.toml（完整字段说明见 docs/config.toml）：

# 打开剪贴板历史的快捷键，默认 SUPER+SHIFT+C clipboard_hotkey = "SUPER+SHIFT+C"

改成你顺手的组合，例如"SUPER+SHIFT+2"，保存后搜索refresh即可热加载配置。

开启「选中即粘贴」（Paste on select）

默认情况下，选中历史条目只会复制回剪贴板，仍需手动粘贴。开启 Paste on select 后，按 Enter 会直接模拟 ⌘+V，实现真正的秒级粘贴：

• GUI 方式：RustCast 设置面板 → 找到Paste on select开关（代码见 src/app/pages/settings.rs）；
• 配置方式：cbhist_paste_on_select = true（默认false）。

彻底关闭剪贴板记录

如果你偶尔需要"无痕"，把设置中的Enable clipboard history关闭（对应cbhist配置项），RustCast 会停止一切剪贴板捕获。

数据存储揭秘：SQLite 是怎么用的？

RustCast 的剪贴板历史是标准的Rust + SQLite工程实践，对想学 Rust 的读者很友好：

• 表结构：clipboard_entries表包含content_type（text/url/image）、text_content、blob_content、created_at、size_bytes字段，见 migrations/db_init.sql；
• 性能索引：created_at DESC上建了索引idx_created_at，保证"最近优先"查询始终走索引；
• 读写逻辑：插入与分页查询分别在 src/database.rs 的store_clipboard_content和load_clipboard_history中实现；
• 分页加载：历史页面默认加载一批条目，底部有Load 100 more items按钮按需加载（见 src/app/pages/clipboard.rs），官方特性文档 FEATURES.md 标注上限约 300 条，日常完全够用。

外观随心：主题定制不冲突

剪贴板历史窗口跟随 RustCast 全局主题，文字颜色、背景色、字体、模糊效果都可在 docs/config.toml 的[theme]段调整，深色模式下阅读长文本历史也不刺眼。

顺手体验：剪贴板之外的生产力彩蛋

RustCast 本质上是个全能启动器，装上后这些功能可以白嫖：

• Emoji 搜索：输入关键字弹出 emoji 网格，选中即复制到剪贴板（下图）；
• 计算器：直接输入算式，内联显示结果；
• 文件搜索：基于mdfind的 Spotlight 全文检索；
• Google 快捷搜索：搜索框末尾加?直接搜网页。

总结：免费、本地、秒级的剪贴板管理器

只需一条brew install命令，你就拥有了一个 SQLite 驱动、支持图片、选中即粘贴的免费剪贴板管理器。把它当成 Raycast 剪贴板功能的免费平替，日常复制粘贴体验会提升一个档次。