smallclover/cloverviewer-tauri

---

📖 简介

CloverViewer-Tauri 是一款免费开源的 Windows 图片查看器与截图工具，基于 Tauri 2 构建。它是对原版 CloverViewer（egui/eframe 版）的新一代重实现——界面全面更新换代：从原版 Rust 原生 egui 界面，升级为基于 Web（Vite + TypeScript + Canvas）的现代化自定义无边框界面，观感与交互焕然一新。在功能对齐之外新增了内置 MCP Server，让 Claude Desktop 等 AI 客户端可以直接调用截图能力。轻量、快速，把图片浏览、多屏截图、标注与 OCR 装进一个便携的 Windows 应用。

🎯 适合谁用

• 想换掉系统看图工具：免费、开源、无广告、无捆绑，启动即用，不用注册登录。
• 经常截图写文档 / 提 bug：多屏截图 + 矩形、椭圆、箭头、画笔、马赛克、文字标注，Enter 直接复制。
• 需要长截图：聊天记录、网页全文、长列表、日志与代码 diff 一屏截不下时，滚动拼接成一张长图。
• 需要截图取字：基于 Windows 原生 OCR 提取中 / 英 / 日文字，不用上传到任何在线服务。
• 想让 AI 直接看屏幕：内置 MCP Server，Claude Desktop 等 MCP 客户端可列出显示器、截图、读文字。

✨ 功能特性

🖼️ 图片查看器

• 双视图模式：网格视图（缩略图）与单图视图（大图）切换
• 大目录友好：网格虚拟滚动 + 缩略图并发控制、请求合并与缓存；滚动时跳过已离开视野的排队任务，上千张图片的文件夹也能流畅浏览
• 文件夹浏览：打开文件夹自动加载全部图片；排序与缩略图大小控件仅在有图片时显示；F5 / Ctrl+R 刷新当前目录，保留当前图片与网格位置，同目录另存副本后自动更新列表
• 快速导航：键盘 ←/→ 切换，优先加载当前图片并限制相邻图片预加载；解码完成后平滑切换，快速连切不会显示过期图片
• 相邻图片预览：单图画布底部悬浮显示当前图片及前后各两张缩略图，点击即可切换；当前项放大，窄窗口可横向滚动。状态栏文件名前的按钮可即时展开或收起，与设置 → 查看中的开关同步并记住选择，不占用独立画布空间
• 流畅缩放：滚轮缩放、原始尺寸和适应窗口带平滑过渡，连续滚动以鼠标位置为中心接续，拖拽立即接管；缩放灵敏度可调，支持系统减少动态效果偏好。适应窗口时使用箭头，可拖动时显示手形
• 拖拽打开：图片或文件夹直接拖入窗口
• 图片属性：名称 / 路径 / 尺寸 / 大小 / 修改时间 + EXIF（相机、ISO、光圈、快门、焦距、镜头），可打开所在文件夹
• 右键菜单：复制图片、复制路径、查看、编辑图片
• 局域网分享：右键图片即可生成临时链接和二维码，让同一网络内的设备预览或下载；可在设置中控制有效期和下载一次后失效
• 旋转与翻转：R 旋转、H/V 翻转
• 图片编辑：从右键菜单或 Ctrl+E 进入；可裁剪、旋转、标注（矩形、椭圆、箭头、画笔、马赛克、文字）、选择删除和撤销/重做。裁切支持九宫格、边角调整和选区平移，框外保留原色并压暗；松开鼠标后平滑居中并调整预览比例，拖动期间比例稳定。底部工具栏按工具显示参数，“保存选项”提供格式、输出比例、另存为副本和覆盖原图；覆盖与放弃未保存编辑均使用应用内确认框。小图预览最多自动放大至 2 倍，并支持滚轮、缩放按钮、适应窗口、100% 与空格/中键平移。缩放控件统一放在底部工具栏，裁剪模式下框固定，通过缩放和平移框内图片调整构图；保存期间新增的修改仍受退出确认保护。导出为静态图片，不保留原始 EXIF/ICC，JPEG 以 90% 质量将透明区域填白。裁剪先作为草稿，Enter 应用、Esc 取消；旋转有独立按钮。图形与文字可重新选中移动、拖动角点旋转，画笔和马赛克固定；文字输入完成即可调整。重置全部编辑可撤销，参数栏与绘图工具组居中，未选中标注时收起调整提示

📸 截图与标注

• 选区外观：默认经典黑白虚线；设置 → 截图可切换自定义颜色，选择虚线或实线，选区外加深遮罩便于区分
• 多显示器支持：跨屏拼接虚拟桌面截图；后台准备截图窗口并直接传输原始像素，显示前同步窗口与内容区域尺寸，减少等待及偶发画面压缩。拖动选区时底图保持静态，遮罩、边框与放大镜独立更新，减少整幅画面重绘；导出保留原始像素
• 滚动截图（长截图）：框选可滚动区域后按自己的节奏滚动，程序逐帧按重叠像素配准、只把验证通过的新内容拼接成长图；识别出的固定顶栏仅保留首帧、固定底栏仅保留最后接受帧。配准时忽略固定侧栏的纹理，但不会自动裁掉侧栏，建议只选择正文；完成后可复制、存到桌面或直接在查看器中打开。设置里可开启试验性自动滚动，由程序探测目标应用接受的滚动方式（滚轮消息 / 模拟滚轮 / PageDown / 滚动条）后代为滚动。Enter 完成并预览，Esc 取消并丢弃本次内容；鼠标穿透时同样生效
• 标注工具：矩形、椭圆、箭头、画笔、马赛克、文字；线粗、字号、色块大小独立设置，以原图像素（px）计，本次使用中切换工具保留各自大小。图片编辑的初始大小和档位按预览比例调整，大图缩小显示时也能清晰标注；调整窗口不改写已选大小或已有标注。截图与图片编辑共用透明文字框，四角圆形标记清晰可见，输入框随内容自动伸缩；马赛克显示笔刷大小光圈，连续涂抹固定原图色块，预览与停笔后的效果一致。透明图片的马赛克色块使用实色底，遮住原图细节，未涂区域保持透明
• 颜色与大小：点击工具栏色块打开调色盘；点击大小按钮，按当前工具设置线粗、字号或马赛克色块大小
• 放大镜取色：实时显示坐标与像素色值，Alt+C（可自定义）复制颜色
• 撤销/重做：Ctrl+Z / Ctrl+Y
• 导出：Enter 复制到剪贴板 / 保存到桌面；工具栏可直接在查看器中打开普通截图
• 局域网分享：标注完成后可生成临时链接和二维码，供同一网络内的设备预览或下载截图
• OCR 文字识别：基于 Windows 原生 UWP OCR 引擎（Windows.Media.Ocr），中英日等多语言，含灰度 + 2× 最近邻放大预处理；识别后在查看器中打开原图与可复制、可临时修改的文字

🤖 MCP Server（新增）

内置 Model Context Protocol 服务器，把截图能力暴露给 AI 客户端：

• stdio 模式：CloverViewer.exe --mcp（单实例独立进程）
• HTTP 模式：CloverViewer.exe --mcp-http --token [--port 3000]（streamable HTTP，端点 /mcp，仅监听本机；请求须带 Authorization: Bearer ）
• 工具：list_monitors、take_screenshot、get_screenshot、ocr_screenshot 与 delete_screenshot。截图支持活动窗口、指定显示器、全部显示器和区域；默认直接返回供视觉模型使用的图片内容和结构化元数据。仅在客户端可访问 MCP 服务本地文件系统时，才使用 delivery: "path" 或 "both" 请求路径。

在 Claude Desktop 的 claude_desktop_config.json 中接入：

{
  "mcpServers": {
    "clover-viewer": {
      "command": "C:\\Path\\To\\CloverViewer.exe",
      "args": ["--mcp"]
    }
  }
}

完整的接入方式、工具参数、使用场景与隐私说明见 MCP 使用指南。

⚙️ 系统功能

• 三语言界面：简体中文 / English / 日本語，即时切换；同步页面语言标记，设置说明与编辑工具栏适配窄窗口
• 明暗主题：跟随系统 / 深色 / 浅色；设置与图片编辑使用统一的圆角下拉菜单，支持鼠标和键盘选择；系统主题变化时立即同步
• 界面缩放：默认 100%，可在设置 → 常规 → 语言与外观中选择 110% / 125% / 150%，主界面和截图界面立即同步并记住选择；截图输出仍保留原始像素
• 标题栏菜单：文件（打开图片、文件夹与设置）/ 截图（截图、滚动截图与截图设置）/ 帮助（快捷键、检查更新与关于）。F1 打开双栏快捷键速查弹窗，点击空白处或 Esc 收起菜单
• 全局热键：默认 Alt+S 唤起截图（托盘状态下可用，可自定义）
• 系统托盘：关闭窗口可选最小化到托盘；右键提供显示主窗口、截图、滚动截图、设置与退出，菜单语言与截图热键提示随设置更新
• 开机自启：写 HKCU\...\Run 注册表，--startup 参数静默启动到托盘
• 单实例：named mutex 防重复打开
• 配置兼容：与 egui 版共用 %APPDATA%\CloverViewer\config.json（失败回退 exe 旁，便携模式）
• 桌面小宠物：可显示 Live2D 角色，支持待机、眨眼、定时点头和鼠标跟随；可拖动，并可在设置中用 60%–200% 滑杆缩放，截图时自动隐藏；右键可选择截图、滚动截图、打开主界面或退出。
• 设置面板：分类 + 搜索的整页设置（常规 / 查看 / 截图 / 快捷键 / 缓存），每项带说明文字；含语言、主题、缩放灵敏度、相邻图片预览、桌面小宠物及其缩放、截图 / 取色 / 滚动截图三个热键、放大镜、最小化到托盘、开机自启及软件更新；局域网分享规则位于“截图”分类
• 临时缓存管理：设置 → 缓存 显示 %TEMP%\CloverViewer 里普通截图、长截图及 OCR 在查看器中打开时产生的临时 PNG 文件数与占用，可设保留期（默认 7 天，启动时自动清理）或按时间范围立即清理；此处不清理缩略图或 MCP 截图存储
• 软件更新：仅手动检查更新；持续显示下载进度与分阶段错误，网络下载失败最多尝试三次，签名验证通过后才安装

🖼️ 支持的格式

PNG · JPEG · GIF · BMP · WebP · TIFF (.tif / .tiff) · AVIF

🔧 技术栈

📦 安装

前往 Releases 下载 CloverViewer_x.y.z_x64-setup.exe（NSIS 安装器，per-user 安装无需管理员权限）。也可直接使用便携版 CloverViewer.exe。

🛠️ 从源码构建

前置：Rust + Node.js 24.x（满足当前锁定依赖的要求）+ WebView2 Runtime（需已安装）。

npm install

# 开发模式
npm run tauri dev

# Debug 构建
cd src-tauri && cargo build

# Release + NSIS 安装包
npm run tauri build
# 产物：src-tauri/target/release/cloverviewer-tauri.exe
#       src-tauri/target/release/bundle/nsis/CloverViewer_x.y.z_x64-setup.exe

国内网络注意：tauri build 首次会从 GitHub 下载 NSIS 工具链（nsis-3.11.zip + nsis_tauri_utils.dll，缓存于 %LOCALAPPDATA%\tauri\NSIS）。若下载卡住，可设置镜像：

# PowerShell（当前会话）
$env:TAURI_BUNDLER_TOOLS_GITHUB_MIRROR = "https://gh-proxy.com/https://github.com"
npm run tauri build

镜像不可用时：用浏览器手动下载上面两个文件，解压 zip 并将内容放入 %LOCALAPPDATA%\tauri\NSIS\，DLL 放入其 Plugins\x86-unicode\ 下即可跳过下载。

⌨️ 快捷键

图片查看器

截图工具

🔄 与原版的关系

• 原 egui 版：CloverViewer（eframe + 全 Rust UI）
• 本仓库：Tauri 2 重实现；界面全新换代，改用 Web 技术栈（HTML/CSS/TS）做出自定义无边框窗口，而非原版的 egui 原生控件
• 配置文件互通

❓ 常见问题（FAQ）

CloverViewer 是免费的吗？可以商用吗？

本仓库自有代码免费开源，协议为 MIT：个人使用、公司内部使用和二次开发都可以，只需保留版权声明。随桌宠打包的 Live2D 组件及角色资产适用独立条款，公开分发前请查看 第三方声明。

支持哪些 Windows 版本？

Windows 10 / 11，需要已安装 WebView2 Runtime。安装包是 NSIS 的 per-user 安装，不需要管理员权限；也可以直接使用便携版 CloverViewer.exe。

会把我浏览的图片或截图上传吗？

不会自动上传到第三方服务。图片浏览、截图、标注、长截图拼接和 OCR 全部在本机完成，应用没有账号体系，也不收集使用数据。主动创建局域网分享时，同一网络内持有链接的设备可临时访问该图片；启用 MCP 后，截图可交给你连接的 AI 客户端。软件更新只在你到「设置 → 常规 → 软件更新」点击「检查更新」时访问 GitHub Releases，并在确认更新后下载安装包，不在后台自动检查。

长截图（滚动截图）支持所有应用吗？

不保证 100% 成功。默认是手动滚动优先：你按自己的节奏滚动，程序逐帧配准并只把验证通过的新内容追加进长图；自动注入滚动属于设置里的试验功能，默认关闭。目标应用有粘性标题栏、动态内容或大面积动画时成功率会下降，失败或中途停止时已捕获的部分会保留。

和其它截图工具有什么不同？

它把「图片查看器」和「截图标注」合在同一个免费开源应用里，并且内置 MCP Server 让 AI 客户端可以直接调用截图与 OCR。长截图走的是「真实帧 + 重叠像素配准」路线：输出中的每个像素都来自某一帧真实屏幕画面，而不是推算出来的。

和原版 CloverViewer（egui 版）是什么关系？

本仓库是 Tauri 2 重实现：Rust 后端 + Web 前端（Vite + TypeScript + Canvas），界面由 egui 原生控件换成自定义无边框窗口。两者配置文件互通，共用 %APPDATA%\CloverViewer\config.json。

怎么让 Claude Desktop 用上截图能力？

按 MCP 使用指南 在 claude_desktop_config.json 中配置 CloverViewer.exe --mcp，即可调用 list_monitors、take_screenshot、get_screenshot、ocr_screenshot 与 delete_screenshot。

📚 文档

📝 更新日志

每个版本的用户可见变化见 CHANGELOG.md。

📄 开源协议

自有代码采用 MIT License。第三方组件与桌宠资产的适用条款见 第三方声明。