托盘优先
点击菜单栏或系统托盘图标,或者按 CommandOrControl+Shift+V,主窗口会轻轻出现,用完立刻收起。
macOS 和 Windows 菜单栏工具
mclip 常驻菜单栏或系统托盘。需要时一键唤起,快速搜索文字、图片和文件历史,用完继续回到手头工作。
当前版本 0.1.1,下载入口指向 GitHub Releases。
mclip 的界面按真实使用路径组织:唤起、搜索、预览、复制,然后回到原来的工作。
点击菜单栏或系统托盘图标,或者按 CommandOrControl+Shift+V,主窗口会轻轻出现,用完立刻收起。
保存常见复制场景:一段文字、一张截图、Finder 或资源管理器里的文件。选择文件历史时会回填系统文件列表,而不是只复制绝对路径。
最新 10 条默认保持紧凑,更多历史默认按 10 条分组;分组按真实内容定高,hover 详情使用独立窗口,长文件名在列表中间省略并在详情显示完整绝对路径。
输入关键词即可过滤历史,方向键移动,回车复制,Esc 收起,适合频繁复制粘贴的桌面工作流。
剪贴板历史、设置和图片资源只保存在本机。mclip 不上传剪贴板内容。
支持 macOS 和 Windows,界面可跟随系统深浅色与系统语言;也可调整主界面/分组条数、序号和主窗口 Logo。
面向开发者和 AI Agent
mclip-cli 是给 Codex、Claude Code、Cursor、Cline 等 AI Agent 使用的本地入口。Agent 模式会把最近剪贴板历史、可用命令和安全边界打包输出,不需要你反复手动粘贴。
mclip-cli agent --last 5 --json 会输出最近历史、命令能力表和安全边界,适合 Codex、Claude Code、Cursor、Cline 直接读取。
agent/list/get/search/context 只读;add 只写入历史不覆盖系统剪贴板;copy 才会把指定历史项写回剪贴板。
Agent 模式默认输出 Markdown,也支持 JSON;普通命令支持 text、JSON、raw、Markdown,方便把报错、代码片段和最近上下文交给 AI Agent。
安装 mclip-cli
curl -fsSL https://www.mclip.cn/install.sh | sh 常用命令
mclip-cli agent --last 5 --jsonmclip-cli list --limit 5 --jsonmclip-cli context --last 3 --format markdownmclip-cli add "note from agent"mclip-cli copy --index 1 安装脚本会下载同一 GitHub Release 的预构建 mclip-cli 与 SHA-256 校验资产,验证成功后才替换旧 CLI;可用 MCLIP_VERSION 固定版本。只有二进制资产不存在时才回退到源码构建。Windows CLI 用户请在 Git Bash 或兼容 POSIX shell 中运行。
mclip 的目标是做一个可信的小工具,而不是云服务。历史文件、设置文件和图片资源都保存在本机应用配置目录。
官网直接说明下载方式,也明确当前 macOS 未 notarize、Windows 未签名。
从 GitHub Releases 下载 DMG,把 mclip.app 拖入应用程序。当前版本未 notarize,如系统提示应用已损坏,可在确认信任后解除 quarantine。
下载 MSI 或 EXE 安装包后按向导安装。当前版本未代码签名,Windows SmartScreen 可能提示未知发布者。
源码在 GitHub 开放。项目使用 Tauri 2、React 19、TypeScript 和 Rust,可通过 npm run tauri:dev 本地运行。
这些问题不藏在脚注里。签名、公证、WebView2 和本地数据边界都应该在下载前看得到。
不会。历史记录、设置和图片历史资源只保存在本机系统配置目录里。Windows 安装器仅在缺少 WebView2 运行时时可能联网下载运行时组件。
当前 macOS 包使用 ad-hoc 签名,没有 Apple Developer ID notarization。把 mclip.app 拖入应用程序后,如果你信任该 Release,可以执行 xattr -dr com.apple.quarantine /Applications/mclip.app。
正常。当前 Windows 包还没有代码签名证书,所以 SmartScreen 可能提示未知发布者。请只安装你信任的 GitHub Release。
可以在偏好设置里调整最大历史条数、主界面展示条数、历史分组展示条数,也可以选择只保存文本、图片或文件中的一部分类型。