Skip to content

Repository files navigation

Snanswer · 截屏解题助手

使用演示

项目简介

这是一个面向中文用户的截屏解题助手:按下快捷键截取屏幕,AI 实时分析屏幕上的题目并给出解答。窗口对屏幕分享软件隐身,且不会抢占焦点。适配国内 AI 生态,简单易用。

核心能力

  • 截屏解题:通过快捷键抓取屏幕内容(可附带电脑声音的实时转录文字),发送给视觉大模型分析,流式展示解答;支持追加截图和追问,保持对话上下文连续
  • 手机显示模式:电脑端在局域网启动服务,手机扫码即可实时查看解答;截屏、追加截图、切换场景、深度思考均可在手机端操作,答题时电脑端零键盘输入
  • 场景化提示词:预置「解算法题」「英语考试」「通用问答」等场景,一键切换;也可以添加自定义场景,扩展到任意题型
  • 屏幕分享隐身:即使被要求分享屏幕,对方也看不到本助手的窗口
  • 不抢占焦点:窗口置顶半透明展示,不会导致原页面失焦,可规避“跳出网页”检测

适用场景

  • 编程面试 / 笔试:分析屏幕上的题目,实时给出解题思路和代码,支持 Python、JavaScript、Java、C++ 等主流编程语言
  • 英语机试:切换到「英语考试」场景,还可结合语音转录处理听力题
  • 在线考试:单选、多选、解答等通用题型,切换到「通用问答」场景即可
  • 其他场景:添加自定义提示词场景,自行扩展

如何使用

注意:项目有编译安装包,你也可以直接下载安装包使用(如何安装,以及安装完后如何配置,请参考 Wiki 教程)。

注意:详细的使用教程请移步本项目的 Wiki 页面查看。

1. 安装依赖

注:项目运行依赖 Node.js 环境,如未安装请先安装 下载地址

$ npm install

2. 启动程序开始正常使用

$ npm run dev

3. 配置 API Key

注意,应大家的要求,从 1.6 版本开始,添加了对「硅基流动」API 的支持,方便大家使用国内模型。

启动程序后,进入「设置」页面,配置 API Base URLAPI Key

API 地址和 API Key 需要从支持 OpenAI API 的代理服务商处获取。如国内的 硅基流动 或国外的 OpenRouter 等服务商,支持支付宝付款。

当然,如果你(人在海外)可以直接使用 OpenAI 官方的 API 更好,只需要配置 API Key 就够了。

也可以在项目根目录创建 .env 文件预配置,程序启动后会自动读取作为默认值。

API_BASE_URL="https://openrouter.ai/api/v1" # 聚合服务的 API 地址,这里以 OpenRouter 为例
API_KEY="sk-1234567890" # 代理服务商的 API Key,这里只是示例,需要改成你自己的

4. (可选)配置语音转录

语音转录功能可以实时将电脑播放的声音(如面试官讲话、听力音频)转为文字,并在截图时一起提交给 AI 辅助分析题意。

目前该功能固定使用 Fun-ASR 模型 (0.02元/分钟,新用户有10小时免费额度),需要配置阿里云百炼平台的 API Key:

  1. 访问 百炼平台控制台 注册并创建 API Key
  2. 在应用「设置」页面的「语音转录」部分填入 API Key
  3. 使用快捷键(默认 Alt+T / Ctrl+T)开始/暂停语音转录

5. (可选)开启手机显示模式

把解答从电脑悬浮窗「搬」到手机上:电脑端在局域网启动一个小型服务,手机浏览器扫码即可实时查看流式解答。答题全程电脑端零键盘输入——截屏由手机端按钮触发,主进程直接调用系统截屏能力,避免快捷键被监考软件记录。

使用步骤:

  1. 应用「设置」→「手机显示」→ 打开开关,会出现二维码和访问地址(需配对码,防止同一网络内他人接入)
  2. 手机连接与电脑相同的 Wi-Fi,扫码(或浏览器输入地址)打开手机页面
  3. 返回主界面后电脑窗口自动隐藏,解答实时推送到手机

手机端能力:

  • 截屏解题 / 追加截图:一键触发电脑截屏并开始解题,支持多截图连续追加
  • 深度思考:难题时开启,模型先推理再作答(更慢但更准),普通题关闭保持响应速度
  • 切换场景:解算法题 / 英语考试 / 通用问答等提示词场景一键循环切换
  • 全屏纯显示:竖屏满屏只看答案,隐藏所有控件;底部保留截屏/追加/思考/场景小按钮
  • 屏幕常亮:阅读解答时手机不息屏(Wake Lock,需较新的浏览器)
  • 其他:字号调节、代码块一键复制、追问输入框、电脑窗口显示/隐藏切换、断线自动重连

手机端推荐使用 Chrome / Edge / Safari 打开;电脑端窗口隐藏后,随时可用「隐藏/显示窗口」快捷键或手机端按钮恢复。

关于隐身能力的说明

目前隐身功能适配市面上大部分会议软件(如 腾讯会议 等),但很少部分软件和浏览器可能无法正常隐身。使用前自己做好测试,本项目不承担任何责任。相关问题欢迎大家提 Issue 讨论。

视频教程

具体可到 Wiki 页面查看。

许可协议(License)

本项目采用 CC BY-NC 4.0 协议许可。

您可以自由使用、复制、修改本项目代码,但 禁止任何形式的商业用途,包括但不限于售卖、集成入商业产品、SaaS 服务等。

如需商业授权,请联系作者获得书面许可。

类似项目

Interview-Coder 项目在网络上爆火之后,出现了很多类似的项目(本项目也是其中一个),每个项目都各有特色,这里列举一些比较火的项目供参考。

About

截屏解题助手:截屏 → AI 实时解题 → 手机端查看

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages