Installation

Installation

Windows

使用发布包中的 .exe 或 .msi 安装，也可以直接运行便携包。NSIS .exe 安装器支持中英语言选择；MSI 使用 WiX 的多语言构建策略，会分别生成英文与简体中文安装包。自定义安装脚本可优先选择 D:/ClipAnchor，若没有非系统盘则使用 C:/Program Files/ClipAnchor。

开启自启动后，Windows 注册表启动项会附带轻量模式参数。系统登录时 ClipAnchor 只启动托盘图标、剪贴板监听和数据库服务，不弹出主界面。

Windows 端会同时维护注册表 Run 启动命令与任务管理器使用的启动批准状态。即使在软件内关闭自启动，启动项仍会保留在“任务管理器 → 启动应用”中并显示为已禁用，用户可继续从系统界面重新启用；程序下次手动启动时会把系统实际状态同步回设置页。

开发环境建议安装：

• Rust stable MSVC 工具链
• Node.js LTS
• Microsoft Visual Studio Build Tools
• WebView2 Runtime

macOS

使用生成的 .dmg 或 .app。公开分发前建议使用自己的 Apple Developer 证书签名和公证。

Linux

使用生成的 .deb 或 .rpm。启用自启动前请尽量保持程序目录稳定，避免桌面入口指向旧路径。

便携版

ClipAnchor 默认把所有用户数据写到程序同级 data/，--portable 参数可强制使用该行为。复制整个文件夹即可带走历史记录、设置和资源文件。

如果需要手动模拟开机后台启动，可使用 --clipanchor-startup 参数。普通双击启动不会带该参数，因此仍会显示主界面。

从源码运行

git clone https://github.com/SELFEMO/ClipAnchor.git
cd ClipAnchor
npm install --registry=https://registry.npmmirror.com
npm run desktop:dev

请在克隆后的 ClipAnchor 项目目录内执行命令；如果在上级目录执行，npm 会因为找不到 package.json 报错。需要清理旧依赖或构建缓存时请运行 npm run clean，不要手动使用平台相关的删除命令。项目根目录包含 .cargo/config.toml，Cargo 默认走 sparse 镜像源，解决 index.crates.io 在部分网络下连接超时的问题。

开发启动器会先验证本机回环端口是否可以绑定；固定端口被系统保留、占用或拒绝访问时，会自动选取其他可用端口，并用运行时配置覆盖 Tauri 的开发地址。

打包

npm run desktop:build

Apple Silicon 构建可在 macOS 主机上使用：

rustup target add aarch64-apple-darwin
npm run desktop:build:macos-arm64

构建结果通常位于 src-tauri/target/release/bundle/；指定 target 时位于 src-tauri/target/<target-triple>/release/bundle/。

单实例运行

ClipAnchor 集成单实例入口保护。再次双击桌面快捷方式或再次运行主程序时，新启动请求会转发给已有进程，已有主窗口会被显示、还原并置前；后台剪贴板监听和数据库写入始终只保留一份。