macOS 和 Windows 菜单栏工具

轻量、本地优先的剪贴板历史工具

mclip 常驻菜单栏或系统托盘。需要时一键唤起,快速搜索文字、图片和文件历史,用完继续回到手头工作。

当前版本 0.1.0,下载入口指向 GitHub Releases。

mclip 主窗口与历史预览界面
主窗口、分组预览、单条详情分别保持独立。

把复制历史放在手边,但不打扰你

mclip 的界面按真实使用路径组织:唤起、搜索、预览、复制,然后回到原来的工作。

托盘优先

点击菜单栏或系统托盘图标,或者按 CommandOrControl+Shift+V,主窗口会轻轻出现,用完立刻收起。

文本、图片、文件都能找回

保存常见复制场景:一段文字、一张截图、Finder 或资源管理器里的文件。选择文件历史时会回填系统文件列表,而不是只复制绝对路径。

独立预览窗口

最新 10 条保持紧凑,更多历史按组浏览;长文件名在列表中间省略并保留扩展名,单条详情显示完整绝对路径。

搜索和键盘操作

输入关键词即可过滤历史,方向键移动,回车复制,Esc 收起,适合频繁复制粘贴的桌面工作流。

本地优先

剪贴板历史、设置和图片资源只保存在本机。mclip 不上传剪贴板内容。

中英文和跨平台

支持 macOS 和 Windows,首次启动会按系统语言选择中文或英文。

面向开发者和 AI Agent

AI Agent 与 CLI

mclip-cli 是给 Codex、Claude Code、Cursor、Cline 等 AI Agent 使用的本地入口。它把最近剪贴板历史变成可搜索、可结构化读取的上下文,不需要你反复手动粘贴。

给 Agent 读上下文

mclip-cli list --limit 5 --json 可以把最近历史以结构化 JSON 输出给 Codex、Claude Code、Cursor、Cline。

只读,不打扰桌面

CLI 第一阶段只读取本机 history.json,不启动桌面 UI,也不修改剪贴板历史。

适合错误、代码和 Prompt

支持 text、JSON、raw、Markdown 输出,适合把报错、代码片段和最近上下文交给 AI Agent。

安装 mclip-cli

curl -fsSL https://www.mclip.cn/install.sh | sh

常用命令

mclip-cli list --limit 5 --json
mclip-cli context --last 3 --format markdown

当前安装脚本会从源码构建 mclip-cli,因此需要本机已有 Rust/Cargo 和 Git。

你的剪贴板历史只保存在本机。

mclip 的目标是做一个可信的小工具,而不是云服务。历史文件、设置文件和图片资源都保存在本机应用配置目录。

先从 GitHub Release 开始

第一版官网保持诚实:直接告诉用户如何下载,也明确当前 macOS 未 notarize、Windows 未签名。

macOS

从 GitHub Releases 下载 DMG,把 mclip.app 拖入应用程序。当前版本未 notarize,如系统提示应用已损坏,可在确认信任后解除 quarantine。

Windows

下载 MSI 或 EXE 安装包后按向导安装。当前版本未代码签名,Windows SmartScreen 可能提示未知发布者。

开发者

源码在 GitHub 开放。项目使用 Tauri 2、React 19、TypeScript 和 Rust,可通过 npm run tauri:dev 本地运行。

安装前常见问题

这些问题不藏在脚注里。签名、公证、WebView2 和本地数据边界都应该在下载前看得到。

mclip 会上传我的剪贴板内容吗?

不会。历史记录、设置和图片历史资源只保存在本机系统配置目录里。Windows 安装器仅在缺少 WebView2 运行时时可能联网下载运行时组件。

macOS 首次打开提示应用已损坏怎么办?

当前 macOS 包使用 ad-hoc 签名,没有 Apple Developer ID notarization。把 mclip.app 拖入应用程序后,如果你信任该 Release,可以执行 xattr -dr com.apple.quarantine /Applications/mclip.app。

Windows SmartScreen 提示未知发布者正常吗?

正常。当前 Windows 包还没有代码签名证书,所以 SmartScreen 可能提示未知发布者。请只安装你信任的 GitHub Release。

历史能保存多少条?

可以在偏好设置里调整最大历史条数,也可以选择只保存文本、图片或文件中的一部分类型。