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

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