Installation

Installation

Windows

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

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

开发环境建议安装：

• 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 参数。普通双击启动不会带该参数，因此仍会显示主界面。

从源码运行

npm install --registry=https://registry.npmmirror.com
npm run desktop:dev

项目根目录包含 .cargo/config.toml，Cargo 默认走 sparse 镜像源，解决 index.crates.io 在部分网络下连接超时的问题。

打包

npm run desktop:build

构建结果通常位于 src-tauri/target/release/bundle/。

单实例运行

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