托盘优先
点击菜单栏或系统托盘图标，或者按 CommandOrControl+Shift+V 即可唤起。v0.2.0 只让主窗口进入启动关键路径，preview 预热、低频窗口按需创建；Apple M2 协议实测托盘就绪中位数缩短 51.3%。
macOS 菜单栏 · Windows 系统托盘
mclip 常驻菜单栏或系统托盘。需要时一键唤起，快速搜索文字、图片和文件历史，用完继续回到手头工作。
v0.2.0 已于 2026-09-19 正式发布，可从 GitHub Release 下载。
mclip 的界面按真实使用路径组织：唤起、搜索、预览、复制，然后回到原来的工作。
点击菜单栏或系统托盘图标，或者按 CommandOrControl+Shift+V 即可唤起。v0.2.0 只让主窗口进入启动关键路径，preview 预热、低频窗口按需创建；Apple M2 协议实测托盘就绪中位数缩短 51.3%。
保存文字、截图和 Finder 或资源管理器里的文件。置顶上限默认为 10 条，可在历史设置中调整为 5–20，降低上限保留已有置顶。常用记录置顶在普通历史之前，不占主界面或分组条数；选择文件历史时仍会回填系统文件列表，详情仍会显示完整绝对路径和文件名。
最新 10 条默认保持紧凑，文本/文件行不会挤占图片高度；更多历史默认按 50 条分组，hover 详情保持独立。图片详情可在独立查看器中最大化查看、恢复，并用 Escape 关闭。
输入关键词即可过滤历史，方向键移动，回车复制，Esc 收起。搜索、键盘和鼠标共用同一个激活目标，主列表、分组和底部操作不会出现两套高亮。
剪贴板历史、设置和图片资源只保存在本机。v0.2.0 可用有界启发式规则标记并默认遮罩高置信度敏感文本，也可按来源应用排除捕获；这些能力可能误报或漏报。
支持 macOS 和 Windows，界面可跟随系统深浅色与系统语言，并提供中文、英文和日文；新安装默认保留 200 条、最多可调到 1000 条，还可调整主界面/分组条数、序号和主窗口 Logo，并在 Agent CLI 页安全安装、升级或重装匹配版本。
面向开发者和 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 只读并支持筛选置顶；pin/unpin 只修改一个稳定历史项；clear --yes --keep-pinned 清除普通历史并保留置顶。
Agent 模式默认输出 Markdown，也支持 JSON。transform 可在 stdin/stdout 中完成 JSON、Base64 和 URL 组件转换；copy 也支持唯一 stdin 输入。两者都不会直接修改历史。
安装 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 1printf '%s' '{"ok":true}' | mclip-cli transform json-prettifyprintf '%s' 'pipeline clipboard text' | mclip-cli copymclip-cli pin --id h_xxxmclip-cli list --pinned --jsonmclip-cli list --json --with-meta安装脚本会下载同一 GitHub Release 的预构建 mclip-cli 与 SHA-256 校验资产，验证成功后才替换旧 CLI；可用 MCLIP_VERSION 固定版本。只有二进制资产不存在时才回退到源码构建。Windows CLI 用户请在 Git Bash 或兼容 POSIX shell 中运行。
mclip 不上传剪贴板内容。v0.2.0 默认遮罩检测到的敏感文本，但历史仍是本地明文；遮罩不是静态加密，启发式检测和来源应用排除也不是 DLP 或泄露防护保证。
直接从已公开的 GitHub Release 选择平台包，并在安装前了解 macOS notarization、Windows 代码签名和 Linux 预览支持边界。
从 GitHub Releases 下载 DMG，把 mclip.app 拖入应用程序。当前版本未 notarize，如系统提示应用已损坏，可在确认信任后解除 quarantine。
下载 MSI 或 EXE 安装包后按向导安装。当前版本未代码签名，Windows SmartScreen 可能提示未知发布者。
从 v0.2.0 Release 下载 DEB 或 AppImage。托盘、快捷键、自动粘贴、来源应用识别和面板定位会随 X11、XWayland 或 Wayland 会话独立降级；当前不提供 ARM64 包。
源码在 GitHub 开放。项目使用 Tauri 2、React 19、TypeScript 和 Rust，可通过 pnpm run tauri:dev 本地运行。
这些问题不藏在脚注里。签名、公证、WebView2 和本地数据边界都应该在下载前看得到。
不会。历史记录、设置和图片历史资源只保存在本机系统配置目录里。Windows 安装器仅在缺少 WebView2 运行时时可能联网下载运行时组件。
不等于。v0.2.0 的遮罩只保护界面和默认 CLI 输出，原始历史仍以本地明文保存，以保证复制内容不变。检测与来源应用识别都是 best-effort，可能误报或漏报；纯 Wayland 当前无法执行来源应用排除。
当前 macOS 包使用 ad-hoc 签名，没有 Apple Developer ID notarization。把 mclip.app 拖入应用程序后，如果你信任该 Release，可以执行 xattr -dr com.apple.quarantine /Applications/mclip.app。
正常。当前 Windows 包还没有代码签名证书，所以 SmartScreen 可能提示未知发布者。请只安装你信任的 GitHub Release。
新安装默认最多保存 200 条，可在偏好设置里调整为 10–1000 条；主界面展示条数和历史分组展示条数可独立调整，也可以只保存文本、图片或文件中的一部分类型。