Home

欢迎使用 OCR Box 用户指南

在这里，您将找到有关 OCR Box 扩展程序的用户手册、功能介绍，以及“首次设置”的详细指南。

---

✨ 功能特性

• ⚡️ 快速截图：按下快捷键或点击图标，即可像微信截图一样（四周暗化）选取屏幕区域。
• 🔌 API 驱动：使用 ocr.space API，识别率高，且完全免费（有每日额度限制）。
• 🔑 完全可配置：
  • API Key：用户必须提供自己的 API Key，确保了隐私安全，也使用了用户自己的免费额度。
  • 自定义快捷键：支持自定义 Alt, Ctrl, Shift + 任意主键的组合。
  • 引擎切换：支持“引擎1”（速度优先）、“引擎2”（中日韩优化）以及**“自动”**模式。
• 🤖 智能备援：
  • 在“自动”模式下，优先尝试引擎2。
  • 如果引擎2失败、超时（10秒）或返回服务器内部错误（E208），将自动无缝切换到引擎1重试。
• 🎨 现代化结果框：
  • 下一张：在结果框上直接开始下一次截图。
  • 复制：一键复制所有识别文本。
  • 浅/深主题：自适应的浅色/深色主题切换。
  • 设置：快速跳转到选项页。
  • 点击标题栏或按 ESC 键可快速关闭。
• 💡 智能提示：
  • 在 API Key 未设置时，会弹出提示并提供可点击的“立即设置”链接。
  • 在 API Key 错误或服务器错误时，会弹出友好的中文提示。

---

🚀 首次设置 (必读)

为了保护您的隐私并使用您自己的免费额度，本插件在您提供 API Key 之前无法工作。

第 1 步：获取 ocr.space API Key

1. 访问 ocr.space 免费 API 页面。
2. 注册一个 "FREE Plan" 账户 (或登录)。
3. 登录后，在您的账户信息中找到并复制您的 API 密钥 (API Key)。

第 2 步：配置插件

1. 在 Edge 浏览器右上角找到 OCR Box 插件图标，右键点击。
2. 在弹出的菜单中，选择“选项”。
3. 在打开的“选项”页面中：
   • （必填）API Key 设置：将您复制的 API 密钥粘贴到输入框中。
   • （选填）快捷键设置：设置您喜欢的快捷键 (默认为 Alt + 0)。
   • （选填）OCR 引擎设置：保持“自动 (推荐)”即可。
4. 点击“保存设置”。

设置完成后，插件即可使用。

---

🖱️ 日常使用

您有两种方式触发截图：

1. 快捷键：在任意网页上，按下您在选项页设置的快捷键 (默认为 Alt + 0)。
2. 点击图标：点击浏览器工具栏右上角的 OCR Box 插件图标。

触发后，屏幕会变暗，用鼠标拖动选择您想识别的区域即可。识别结果将自动在右下角弹出。

---

🤔 常见问题 (FAQ)

Q: 插件没反应/快捷键无效！

A: 请检查：

1. 刷新页面：如果您刚刚安装或更新了插件，请刷新 (F5) 您想截图的网页。
2. 受保护页面：插件无法在“新标签页”、edge:// 开头的设置页或 Edge 商店页面上运行。请在普通网页（如 baidu.com）上尝试。
3. 快捷键冲突：检查您设置的快捷键是否已被 Edge 浏览器或电脑上的其他软件（如 QQ、微信）占用。

Q: 提示 "API Key 无效"？

A: 请检查：

1. 拼写错误：请在“选项”页点击“显示”，检查您粘贴的 Key 是否完整，没有多余的空格。
2. 额度用完：ocr.space 的免费 API Key 有每日使用次数限制。您可能需要等到第二天。

Q: 提示 "E208" 或 "请求超时"？

A: 这是 ocr.space API 服务器的临时问题。

• 如果您的引擎设置为“自动 (推荐)”，插件会自动尝试切换到备用引擎。
• 如果仍然失败，请稍等几分钟后再试，或者尝试截取不同的网页内容。

Q: “引擎 1”, “引擎 2”, “自动” 有什么区别？

• 引擎 1：速度快，适合识别工整的英文或数字。
• 引擎 2：对中文、日文、韩文的识别效果更好，但免费版在高峰时段可能超载或卡顿。
• 自动 (推荐)：结合了两者的优点。优先使用引擎 2，如果它失败或超时，插件会自动用引擎 1 重新识别一次，最大化保证成功率。

---

您可以在 Wiki 侧边栏找到本项目的隐私政策 (Privacy Policy)。 如遇 Bug 或有功能建议，欢迎通过 GitHub Issues 提交。