v1.1.6 稳定版本地优先剪贴板引擎

macOS 与 Windows 快速安装与授权配置指南 | VloamClip 文档手册

VloamClip 是面向 macOS 和 Windows 的本地原生桌面客户端。本章介绍双系统的安装流程、必要的辅助功能授权配置以及常见安装权限问题排查。

🍏 macOS 安装与辅助功能 (Accessibility) 授权

macOS 拥有严格的系统安全沙盒(Sandbox)与 TCC(Transparency, Consent, and Control)机制。为了能够向当前获得焦点的目标窗口(如浏览器、IDE、文本框)自动模拟按序键入内容,必须向 VloamClip 授予「辅助功能」权限。

1

下载 Universal DMG 镜像

从官网下载最新的 DMG 安装包。安装包采用 Universal 架构深度编译,原生适配 Apple Silicon (M1/M2/M3/M4) 及 Intel x86_64 处理器。

2

拖拽至 Applications(应用程序)目录

双击打开挂载的 DMG 镜像窗口,将 VloamClip 应用图标拖拽到旁边的 Applications 快捷方式文件夹中完成安装。

3

打开系统设置进行允许

前往 macOS「系统设置」→「隐私与安全性」→「辅助功能」,在列表中找到「VloamClip」,并将右侧开关切换为开启(绿色)。

ℹ️
辅助功能权限的安全保障

VloamClip 仅在触发顺序粘贴快捷键(如 ⌘V)时,调用系统的 CGEventPost / AXUIElement 接口向当前焦点窗口注入模拟按键。本软件 100% 离线运行,绝不监听键盘按键用于窃取隐私或上传网络。

解除 Gatekeeper 隔离提示 (未识别开发者)

在部分启用了严格企业策略或未开启“允许任何来源”的 Mac 上,首次打开时系统可能会提示“已损坏,无法打开”或“来自未识别的开发者”。这属于 macOS Gatekeeper 的隔离标记策略。

打开「终端 (Terminal)」应用,粘贴执行以下命令即可一键清除隔离标记:

zsh / bash
sudo xattr -rd com.apple.quarantine /Applications/VloamClip.app

🪟 Windows 安装与托盘常驻设置

Windows 版本支持 Windows 10 (1809 及更高版本) 与 Windows 11。采用轻量单文件静默安装包,安装过程无需复杂配置。

  • 托盘通知区域常驻:安装完成后,VloamClip 会常驻于任务栏右下角通知区域。右键单击托盘图标即可打开快捷菜单(开启队列、暂停监听、查看偏好设置、退出)。
  • Windows SmartScreen 提示说明:若 Windows Defender SmartScreen 提示“Windows 已保护你的电脑”,点击「更多信息」→「仍要运行」即可正常完成安装。
  • 与 Win+V 剪贴板完全兼容:VloamClip 默认全局呼出键为 Alt+V,与 Windows 自带的 Win+V 剪贴板互不抢占、互不冲突,两者可以完全共存。