安装与配置

适用版本：eaclip / Rust ClipHost 0.31.12 及以后（GPUI 原生界面），按 0.31.28 编写。当前最新公开版本见 eaclip Releases。

GPUI 版本不需要 WebView2，也不需要 .NET 运行时。不安装 Quicker 也能使用剪贴板历史与收藏（便携包直接运行）；Quicker 动作只是安装和唤起入口之一。

下载架构

0.31.28 起常规发布仅提供 Windows x64 包，适用于普通 Intel / AMD 64 位电脑。Quicker 安装入口统一选择 x64，暂时关闭 ARM64 自动判断和下载。

历史 ARM64 包仍可从旧版 Release 获取，本次不继续更新；Windows on ARM 的兼容运行未纳入验收，见 已知问题。

方式一：通过 Quicker 动作「剪贴板 n10」

1. 在 Quicker 中安装分享动作 剪贴板 n10。
2. 运行该动作。动作先从 Quicker 官方依赖库下载入口 DLL，再由入口 DLL 下载并安装 x64 宿主（来源为 Quicker 官方依赖库，Bitiful 为备用源）。
3. 宿主安装在 %LOCALAPPDATA%\Programs\ClipHostRust（程序为其中的 cliphost-app.exe）。
4. 之后再运行该动作，会唤起已在运行的程序（显示 / 隐藏剪贴板窗口）。

版本要求（0.31.28）：

项目	要求
宿主版本	剪贴板 n10 与超级菜单 n10 使用宿主 0.31.28.0
Quicker V1 / V2 入口	0.31.27.1，统一选择 x64 宿主
基本兼容下限	x64 宿主 ABI 的入口下限保持 0.31.7.0；本版动作实际要求上述新版入口

公开分享动作使用入口 DLL 完成宿主下载与升级；0.31.28 起该入口统一选择 x64。

方式二：便携包

1. 打开 eaclip Releases，下载 eaclip-<版本>-windows-x64.zip。
2. 可选：用同名的 .SHA256SUMS.txt 核对 ZIP 的 SHA-256。
3. 完整解压整个目录，运行 cliphost-app.exe，不要单独拿出 EXE（同目录 DLL 需要保留）。

便携包里还附带启动诊断入口 Start-ClipHostDiagnostics.cmd，用法见 常见问题。

便携包与 Quicker 安装版能同时用吗？

按程序代码核对的结论：

• 不能同时运行两份。 程序是"同一用户只允许一个实例"，与 EXE 放在哪里无关。已经有一份在运行时，再启动另一份（无论便携版还是安装版）只会把已运行的那份窗口唤出来，不会开第二个。
• 两者共用同一份数据。 数据位置不跟随程序目录，而是由 %LOCALAPPDATA%\BetterClipTauri 里的位置记录决定（见下文"数据位置"），所以便携版和安装版看到的是同一份历史、收藏和配置。
• 开机自启指向最后一次启动的那份程序。 "开机自启"开启时，程序每次启动都会把自启项改写成当前这份 EXE 的路径。换用另一份程序后，先启动一次新的那份即可；删除某份程序目录前，见下文"卸载"。

升级

• 用 Quicker 安装的，运行「剪贴板 n10」时按动作要求的最低宿主版本自动更新。
• 便携包：先从托盘退出程序，再下载新版本 ZIP 解压替换。
• 0.31.x 各版本说明均写明：升级不移动用户数据，继续读取原有历史、收藏、配置及图片目录，也不会自动迁移到实验中的新存储格式。

数据位置

在 设置 → 数据管理 → 数据文件夹 查看或修改。

• 首次启动时，程序会按顺序检测已有的旧版数据并直接使用（不搬动、不复制）：旧版 ClipHost 记录的自定义数据位置 → 文档\Quicker\Ceastld → %LOCALAPPDATA%\BetterClip\userdata（以存在 userdata.db 为准）。都没有时使用默认位置 %LOCALAPPDATA%\BetterClipTauri。选中的位置会记住，之后不再重新检测。
• 位置记录文件固定在 %LOCALAPPDATA%\BetterClipTauri\application-data-root.json。
• 在设置中留空即恢复默认位置。
• 自定义位置需填写程序目录以外的绝对路径；保存时会确认并重启。更改位置不会自动迁移数据，需要的话请先退出程序、自行复制数据文件夹。
• 数据文件夹里主要有：userdata.db（历史与收藏数据库）、Configs（配置）、Image（图片，含缩略图缓存）、blobs、logs（日志）、LanShare\Inbox（局域网收到的文件）。

开机自启与权限

在 设置 → 全局 → 系统：

选项	默认	说明
开机自启	开启	当前用户登录 Windows 时在后台启动（只进托盘，不弹窗口）。写入当前用户的注册表启动项 IntelliTools.ClipHost
以管理员身份运行	关闭	冷启动时尝试管理员权限；更改后按提示重启

卸载

程序没有单独的卸载程序，按下面步骤手动清理（依据程序代码整理）：

1. 先在设置里关掉会改系统的选项：
   • 设置 → 全局 → 系统 → 开机自启：关闭，程序会删除注册表启动项。
   • 如果开过 设置 → 触发 → 使用 Win+V 打开剪贴板：先关闭它，程序会恢复系统 Win+V 剪贴板历史的注册表项，并提示重启资源管理器。
2. 退出程序：托盘图标右键 → 退出。
3. 删除程序文件：
   • Quicker 安装版：删除 %LOCALAPPDATA%\Programs\ClipHostRust。
   • 便携版：删除解压出来的整个目录。
4. （可选）删除数据——删除后历史、收藏、配置无法恢复，建议先备份：
   • 数据文件夹（以 设置 → 数据管理 显示的位置为准，默认 %LOCALAPPDATA%\BetterClipTauri）。
   • %LOCALAPPDATA%\BetterClipTauri（即使数据放在别处，这里也存有位置记录文件）。
   • %LOCALAPPDATA%\ClipHostRust（诊断输出等）。
5. （可选）在 Quicker 里删除「剪贴板 n10」「超级菜单 n10」动作。

如果第 1 步之前程序已经被删掉：

• 自启项：在 HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run 里删除名为 IntelliTools.ClipHost 的值（也可在任务管理器"启动应用"里禁用）。
• Win+V：在 HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced 的 DisabledHotkeys 值里去掉字母 V，然后重启资源管理器。修改注册表有风险，不熟悉的话可以重新运行程序、关掉选项后再删除。