搜题学习助手

这是一个本地题目学习助手项目，包含两个互相分开的版本：

• Chrome 插件版：在普通网页右下角打开一个小号可拖动悬浮窗。
• 桌面 App 版：macOS、Windows、Linux 使用的小窗 App，代码在 desktop-app/。

两个版本都支持框选题目区域，只对选中的小图做 OCR，再用 DeepSeek API 给出讲解。

开源协议

本项目使用 MIT License。第三方 OCR 依赖 Tesseract.js 和 tesseract.js-core 的许可证文件保留在 vendor/ 目录中。

能做什么

Chrome 插件版

• 在普通网页上选中题目，右键点击“把选中题目发到搜题学习助手”。
• 点击浏览器工具栏插件图标，在当前网页右下角打开小悬浮窗。
• 悬浮窗可以拖动、调整大小，也可以最小化成一条小标题栏。
• 点击“搜题：框选并讲解”，进入框选模式，拖出题目范围后自动识别并讲解。
• 保留“整屏识别备用”，适合页面只有一道题且排版干净时使用。
• 支持手动粘贴题目文字。
• 仍保留拍照或上传图片识别，作为当前屏幕识别不准时的备用方式。
• 支持“详细讲解 / 简洁答案 / 只给提示”三种模式。
• API Key 只保存在你的浏览器本地。

桌面 App 版

• 默认以小窗启动，可以调整大小。
• 支持框选屏幕区域做 OCR。
• 支持整屏识别备用、上传图片识别、读取剪贴板。
• 支持相同的 DeepSeek 讲解模式。
• macOS、Windows、Linux 打包配置在 desktop-app/package.json。

安装方法

Chrome 插件版

1. 打开 Chrome。
2. 地址栏输入 chrome://extensions/。
3. 右上角打开“开发者模式”。
4. 点击“加载已解压的扩展程序”。
5. 选择这个文件夹：google-question-helper。

桌面 App 版开发运行

cd desktop-app
npm install
npm start

桌面 App 版打包

cd desktop-app
npm run dist:mac
npm run dist:win
npm run dist:linux

也可以在 GitHub Actions 里手动运行 Desktop App Builds 工作流，分别生成 macOS、Windows、Linux 产物。

第一次使用

1. 点击 Chrome 工具栏里的扩展图标，在当前网页右下角打开小悬浮窗。
2. 点击右上角设置按钮。
3. 填入你的 DeepSeek API Key。
4. 模型可以先保持 deepseek-v4-flash。
5. 点击“保存设置”。

使用方式

• 方法一：点“搜题：框选并讲解”，插件会临时隐藏悬浮窗；你拖动框选题目范围，松开后只识别这个区域并自动讲解。
• 方法二：在任意网页选中题目文字，右键点击“把选中题目发到搜题学习助手”。
• 方法三：手动输入、粘贴，或上传图片识别。

图片题怎么办

优先点“搜题：框选并讲解”，把图片题所在区域框出来。如果 OCR 还是不准，再用“拍照/上传识别”选择更清晰的图片。第一次识别可能会下载中文和英文 OCR 语言包，所以会慢一点。

注意

这个插件适合用来学习、核对思路、理解题目。遇到考试、测验或有明确规则的作业时，请按老师或平台规则使用。

它不是防检测工具，不提供隐藏切屏、规避监控、绕过网页限制等功能，也不承诺任何网页“检测不到”。

如果你想以后不用自己填 API Key，可以再加一个自己的后端服务，把 Key 放在服务端，插件只请求你的后端。

隐私

详见 PRIVACY.md。

发布前可以运行 node scripts/privacy-scan.js，检查提交历史和项目文件里是否混入本机路径、真实姓名或本机邮箱。