Usage

Usage

置顶服务

启用置顶服务后，ClipAnchor 会监听系统剪贴板。复制文本、图片或文件路径时，会创建一个独立的新弹窗。弹窗默认只有 Pin 按钮，点击后会裂变为 Copy 和 Unpin。

弹窗会按默认锚点加 20px 偏移堆叠，避免完全遮挡。已置顶弹窗可自由拖动，不会改变默认弹出位置。

弹窗尺寸与滚动

弹窗默认尺寸可在设置页调节。无论尺寸如何，弹窗内部都不出现滚动条；长文本会被裁剪并通过提示展示完整含义，避免小弹窗出现廉价的系统原生滚动区域。

历史记录

启用历史记录服务后，复制内容会写入 data/clipanchor.db。剪贴板页支持：

• 全部、收藏、文本、图片、文件视图
• 搜索摘要
• 双击复制
• 批量删除
• 点击前资源有效性检查

收藏夹与清空

任意历史记录可标记为收藏。收藏项会显示在专属分组中，并在常规删除和默认清空中受到保护。

清空历史有两种策略：

• 清空非收藏记录：适合日常整理，收藏项保留。
• 强制清空全部：包括收藏项，操作前会有明确警告。

从历史记录直接置顶弹窗

每条历史记录右侧都有 Pin 图标。点击后，ClipAnchor 会直接生成一个已置顶桌面弹窗，等同于“复制并自动 Pin”，但不会重写剪贴板，因此不会触发重复历史记录。

弹窗位置

进入设置页，在“弹窗位置”的屏幕地图中拖动模拟弹窗到目标位置后确认即可。地图边界会扣除当前弹窗尺寸，因此保存的位置不会让真实弹窗溢出屏幕。这个交互不需要手动输入 X/Y 坐标。

快捷键

默认快捷键：

• Ctrl+Shift+P：启动或关闭置顶服务
• Ctrl+Shift+H：启动或关闭历史记录服务
• Ctrl+Shift+X：显示或隐藏主界面；当 ClipAnchor 处于开机后台轻量模式时，该快捷键会直接唤醒并置前主窗口
• Ctrl+Shift+L：立即进入轻量模式（英文界面中称为 Lite mode，避免与浅色 Light theme 混淆）
• Ctrl+Shift+T：在深色和浅色主题之间切换

快捷键输入框会检测重复组合并高亮提示。

隐私模式

隐私模式会临时暂停监听剪贴板，适合复制密码、验证码或临时敏感内容时使用。

Popup Position Editor

Use Settings → Popup position to open an in-window locator. Drag the simulated popup and save. This avoids a separate transparent system overlay, so the editor remains responsive on Windows.

弹窗位置调整安全说明

弹窗位置调整使用设置页内的轻量屏幕地图，不再新建 WebView、不再全屏、不再截取桌面。这样定位功能不会抢占系统焦点，也不会因为 WebView2 白屏而阻塞整个软件。

Saved clips / 收藏内容

Saved clips are available from the main sidebar as a dedicated workspace for important records. Text items keep the same edit, copy, delete protection, and pin-as-popup actions as regular clipboard records.

收藏内容在左侧栏中作为独立工作区展示，用于集中管理重要记录。文本内容依旧支持编辑、复制、删除保护和一键生成置顶弹窗。

开机后台轻量模式

在设置中开启自启动后，ClipAnchor 写入的系统启动项会携带 --clipanchor-startup 参数。下次登录系统时，主窗口保持隐藏，只显示系统托盘图标，并继续运行剪贴板监听和历史记录服务。

需要恢复完整界面时，可以双击托盘图标、右键托盘选择“显示 ClipAnchor”，或按 Ctrl+Shift+X。这些入口共享同一个窗口激活逻辑，会先显示窗口、还原最小化状态，再在 Windows 上调用原生前台激活。

单实例唤醒

ClipAnchor 同一时间只允许一个长期运行的实例。再次启动程序时，新的启动请求会被交给已有实例处理，并把已有主窗口恢复到前台，避免两个进程同时监听剪贴板或写入同一个 data/clipanchor.db。

软件更新

ClipAnchor 启动时会在后台静默检查 GitHub Releases。后台检查不会在轻量模式或主界面关闭时打扰用户；如果发现新版本并成功下载，或发现新版本但兼容安装包下载失败，会在用户首次打开主界面时显示统一的更新卡片。

用户点击右下角检查更新按钮后，会立即进入更新状态页。该页面会展示正在检查、正在下载、已准备安装、未发现更新、下载失败或未找到兼容安装包等状态，避免网络较慢时用户误以为按钮没有生效。

更新包选择遵循统一规则：Windows 优先选择 ClipAnchor_Windows_x64.exe 这类 EXE 安装包；如果没有 EXE，则选择 MSI，并按系统语言优先匹配 ClipAnchor_Windows_x64_zh-CN.msi 或 ClipAnchor_Windows_x64_en-US.msi。macOS 选择 DMG；Linux 根据发行版家族选择 DEB 或 RPM。下载好的文件存放在 data/updates/，点击立即更新后交给系统安装器打开。

日志管理

ClipAnchor 会把必要运行事件写入 data/logs/clipanchor.log，包括启动、自启动、托盘、快捷键、弹窗创建/关闭、历史记录导入导出、清理操作和异常错误。日志不会写入剪贴板正文，只记录内容类型、记录 ID、大小、哈希前缀和操作结果，便于定位问题同时避免泄露复制内容。

日志文件会自动轮转并清理旧归档。进入设置 → 日志管理，可以查看日志占用、调整归档日志保留天数、打开日志目录、刷新日志状态或清理全部日志。归档日志默认保留 7 天。