AI-Screenshot-Translator 的官方仓库，这是一个基于 Qt 6 和 WebView2 的 Windows 桌面工具 | 极客的赛博空间

🧭 核心功能与适用场景

该工具主要解决学术场景中遇到的几个痛点：

无法复制文本：扫描版 PDF 或图片中的文字。
公式乱码：从 PDF 复制 LaTeX 公式后格式丢失或不可用。
整篇翻译笨重：只想翻译图表、摘要或段落，而非整篇文档。

主要功能模块：

截图翻译：使用全局快捷键（默认 Ctrl+Alt+S）框选屏幕区域，调用 AI（OpenAI/Gemini/Claude）进行翻译。
结果窗口：翻译结果以富文本形式展示，支持Markdown、代码高亮和LaTeX 数学公式渲染。窗口可置顶，并支持键盘快捷键翻页（Z/X）、编辑和查看原图。
归档管理：所有翻译历史存储在本地（storage/history.json 和图片），提供筛选、批量操作和键盘导航功能。
多配置与代理：支持创建多个 API 配置文件、导入/导出，并可配置 HTTP 代理。

📦 系统要求与安装

1. 环境要求

操作系统：仅支持 Windows（未来计划跨平台）。
WebView2 运行时：Windows 11 通常已内置。Windows 10 可能需要从微软官网单独安装。
AI 服务 API 密钥：你需要有 OpenAI、Google Gemini 或 Anthropic Claude 的有效 API Key。

2. 安装方式

方式一：下载预编译 Release 包（推荐）

访问项目的 GitHub Releases 页面。
下载最新版本的 .zip 或安装程序（如 setup.iss 生成的安装包）。
解压或运行安装程序，将 AI-Screenshot-Translator-Cpp.exe 放置到你想要的位置。

方式二：从源码构建（开发者）
需要 Visual Studio 2022、CMake、Qt 6 和 WebView2 SDK。

# 克隆仓库
git clone https://github.com/Diraw/AI-Screenshot-Translator.git
cd AI-Screenshot-Translator

# 使用 CMake 配置和构建
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
cmake --build build --config Release

构建完成后，可执行文件位于 build\Release\ 目录下。你需要将 assets/ 文件夹和 WebView2Loader.dll（从 webview2_pkg/ 中获取）复制到与 exe 相同的目录。

🚀 首次使用与配置

启动程序：双击运行 AI-Screenshot-Translator-Cpp.exe。程序会出现在系统托盘中。
打开设置：右键点击托盘图标，选择“设置”，或使用默认快捷键（Alt+S 可打开归档，设置入口在菜单中）。
配置 AI 服务：
- 在“设置”窗口中，选择 Provider（OpenAI / Gemini / Claude）。
- 填写你的 API Key。
- （可选）根据需要修改 Base URL 和 Endpoint（注意拼接规则，避免重复路径）。
- 如果使用代理，在相应字段填写代理地址。
- 点击 “测试” 按钮验证连接是否成功。

🖥️ 日常使用流程

截图翻译：
- 使用全局快捷键 Ctrl+Alt+S（可自定义）激活截图模式。
- 鼠标拖拽框选需要翻译的区域。
- 释放鼠标后，会显示一个预览卡片，你可以调整选区或直接确认。
- 程序自动调用 AI 翻译，并在结果窗口中显示。
结果窗口操作：
- 窗口默认置顶，方便对照。
- 使用键盘快捷键：Z 查看上一页（历史），X 查看下一页。
- 按 T 可为当前条目添加标签。
- 你可以编辑 Markdown 内容，或点击按钮查看原始截图。
管理归档：
- 使用快捷键 Alt+S 打开归档窗口。
- 可以按日期或标签筛选历史记录。
- 支持批量选择、删除或批量添加/移除标签。
- 使用键盘 E（编辑）、R（查看切换）、S（截图预览）快速操作。

⚙️ 高级配置与故障排查

自定义快捷键：在设置页面中可以修改截图、打开归档等全局快捷键。
多配置文件：你可以在 %AppData%/AI-Screenshot-Translator-Cpp/profiles/ 目录下管理多个配置文件，用于切换不同的 API 设置。
调试日志：在设置中开启 “Debug Mode”，程序会在工作目录生成 debug.log 文件，便于排查问题。
常见问题：
- 测试连通成功但实际请求失败：检查 Base URL 和 Endpoint 是否重复了版本路径（如 /v1），或第三方服务的 Endpoint 与默认不符。
- WebView2 窗口空白或崩溃：确认系统已安装 WebView2 Runtime，并检查 WebView2Loader.dll 是否与 exe 在同一目录。
- 截图功能异常：确保程序以管理员权限运行（在某些 Windows 版本上可能需要）。

总结

AI-Screenshot-Translator 是一个专为学术论文阅读优化的辅助工具。其核心工作流是 截图 → AI 翻译 → 富文本结果（含公式）→ 归档管理。对于 Windows 用户，直接下载 Release 包并配置好 AI API Key 即可开始使用。其价值在于精准、高效地处理那些传统 OCR 或整篇翻译工具难以解决的公式和片段翻译问题。如果你需要在 macOS/Linux 下使用，需关注项目未来的跨平台更新。