FAQ

FAQ

数据存在哪里？

所有运行数据都存放在软件同级 data/ 目录，包括 clipanchor.db、设置、缩略图资源、导出文件和日志。

为什么普通清空不会删除收藏记录？

收藏记录通常代表长期保留内容，因此 ClipAnchor 默认保护它们。需要删除时，请先取消收藏，或在设置中选择强制清空全部。

历史记录 Pin 会不会又写入一条历史？

不会。历史记录 Pin 会从数据库读取内容并直接生成已置顶弹窗，不重写剪贴板，因此不会被监听线程当成新的复制事件。

为什么弹窗没有滚动条？

弹窗是高频、短停留的桌面卡片。为了保持紧凑和高级观感，ClipAnchor 对超长内容进行裁剪和提示，不在小弹窗内放置滚动区域。

自启动失效怎么办？

Windows 端请先在“任务管理器 → 启动应用”中确认 ClipAnchor 的实际状态。软件会同时维护 Run 启动命令和任务管理器使用的启动批准状态，设置页开关会同步这两处；如果用户在任务管理器中切换，下一次手动打开 ClipAnchor 时系统状态也会同步回设置页。移动程序目录后再次启动客户端，当前可执行文件路径会被自动修复，同时保留用户在任务管理器中的启用或禁用选择。自启动项附带 --clipanchor-startup，因此登录后只进入后台轻量模式，不弹出主界面。

macOS 或 Linux 移动程序目录后，请关闭自启动再重新开启，让 ClipAnchor 重新写入当前路径对应的 plist 或 desktop entry。

AppData 中为什么会出现很多 f_* 文件？

这些文件是 Windows WebView2/Chromium 磁盘缓存的数据块，不是剪贴板历史、数据库分片或异常生成的用户文件。ClipAnchor 现在会在创建任何 WebView 前把 WebView2 用户数据目录指定为软件数据目录下的 data/webview2/，因此新缓存不会继续写入 AppData\Local\com.clipanchor.desktop\EBWebView。旧目录不会在升级时自动删除，以免正在运行的旧实例或仍需迁移的 WebView 状态被破坏；完全退出所有 ClipAnchor 进程后，可手动删除旧的 EBWebView 目录。

开发运行为什么提示端口 EACCES？

Windows 可能把某些 TCP 端口保留给系统组件，也可能已有程序占用该端口。npm run desktop:dev 会先尝试配置端口，失败后自动选择其他可绑定的本机回环端口，并让 Vite 与 Tauri 使用同一地址，不再因为单个固定端口不可用而退出。

文件复制支持为什么不同平台表现不同？

不同系统暴露文件剪贴板格式的方式不同。ClipAnchor 默认支持路径列表和 file:// 文本形式，并保留了后端结构以扩展平台专用格式。

开机后为什么没有显示主窗口？

这是预期行为。开启自启动后，ClipAnchor 默认静默进入后台轻量模式，只保留托盘和后台服务。双击托盘图标、右键选择“显示 ClipAnchor”，或按 Ctrl+Shift+X 即可打开主界面。

重复启动会怎样？

ClipAnchor 会保持单实例运行。再次启动时不会留下第二个长期进程，而是通知已有实例显示并置前主窗口，避免重复监听剪贴板和并发写入数据库。

如何在命令行查看版本？

在安装目录或已加入 PATH 的环境中执行：

clipanchor.exe --version
clipanchor.exe -V

macOS 和 Linux 使用安装后的 clipanchor 可执行文件并传入相同参数。该命令只输出软件版本并退出，不会打开主窗口，也不会启动剪贴板监听服务。

日志会不会越积越多？

不会。ClipAnchor 的当前日志为 data/logs/clipanchor.log，当文件达到设定大小后会自动轮转为 clipanchor-*.log。归档日志会按保留天数和最大归档数量自动清理。设置 → 日志管理中可以查看日志占用、调整保留天数、打开日志目录、刷新状态或清理日志，归档日志默认保留 7 天。

软件如何更新？

ClipAnchor 使用 GitHub Releases 作为统一更新源。启动时会静默检查发布版本并尝试下载适合当前平台的安装包；手动点击检查更新时会立即打开更新状态页，显示检查和下载进度。Windows 会优先使用 EXE，如果只有 MSI，则按系统语言优先选择中文或英文 MSI；macOS 使用 DMG；Linux 使用 DEB 或 RPM。

更新包下载到哪里？

下载完成的更新包会保存到软件同级 data/updates/ 目录。点击立即更新时，ClipAnchor 会打开该安装包并把后续步骤交给系统安装器。

为什么显示没有匹配安装包？

这表示 GitHub Release 有新版本，但资产命名或格式无法匹配当前系统。建议发布时使用 ClipAnchor_Windows_x64.exe、ClipAnchor_Windows_x64_zh-CN.msi、ClipAnchor_Windows_x64_en-US.msi、ClipAnchor_macOS_arm64.dmg、ClipAnchor_Linux_x64.deb、ClipAnchor_Linux_x64.rpm 这类命名。