Q-Solver

📝 您的桌面笔试助手：自动识别题目，深度思考，即刻解答

特性 • 安装 • 配置 • 快捷键 • 开发 • English Docs

Warning

开发阶段提示：本项目目前处于早期开发活跃阶段 (Alpha/Beta)，可能会存在少量 Bug 或功能不稳定。如果您在使用过程中遇到问题，欢迎提交 Issue 反馈，我们会尽快修复！

📖 简介

Q-Solver 是一款专为求职者和学生量身打造的桌面笔试助手。它深度集成了 OpenAI、Google Gemini 和 Anthropic Claude 等顶级大模型，通过极简的截图交互，为您提供实时的代码分析、问题解答和内容创作辅助。

不同于传统的聊天机器人，Q-Solver 具备深度思考链可视化、无感隐身/防录屏和简历上下文感知等独创功能，完美融入您的笔试环境，是真正即刻解答的 AI 助手。

✨ 核心特性

🛡️ 无感交互模式 (Stealth Mode)

专为笔试/多任务环境打造。激活后：

• 无边框/半透明：完美悬浮于其他窗口之上
• 防抢焦：操作其他软件时不会自动隐藏，始终显示答案
• 防录屏/隐身：特殊窗口属性，避开部分即时通讯软件的截屏和录屏检测
• 鼠标穿透：点击窗口区域直达后方应用，互不干扰

🔌 全面模型支持 (Model Support)

• 原生 SDK 集成：内置 Google Gemini, Anthropic Claude 和 OpenAI 原生 SDK，非简单的 HTTP 转发，确保最佳的流式响应体验和稳定性。
• 自定义接入：支持 OneAPI 等聚合服务接入，灵活适配各种网络环境。

📄 简历与上下文感知

• 简历助手：导入 PDF/Markdown 简历，AI 将结合您的背景生成个性化回答（适合模拟面试、文书润色）。
• 智能记忆：支持多轮对话上下文，并在新话题开始时自动清理。

🎙️ Gemini Live API (实验性)

• 实时语音对话：支持与 Gemini 模型进行实时双向语音通话，提供极低延迟的交互体验。
• 面试官模式：模拟真实技术面试场景，实时语音转录面试官问题，并由 AI 提供即时回答建议。
• 注意：该功能目前处于实验性阶段，可能会受网络环境影响等问题导致连接不稳定或声音中断，请知悉。
• 支持模型：请选择gemini-2.0-flash-exp

🖼️ 功能预览

👆 实时演示：一键截图 -> 思考 -> 解答

---

🚀 快速开始

方式一：下载安装包 (推荐)

前往 Releases 页面下载最新的 Windows 安装包 (.exe)。

方式二：源码编译

如果您是开发者，可以克隆源码进行二次开发：

# 前置要求：Go 1.25+, Node.js 22+, Wails CLI (go install github.com/wailsapp/wails/v2/cmd/wails@latest)

# 1. 克隆仓库
git clone https://github.com/jym66/Q-Solver.git
cd Q-Solver

# 2. 开发模式运行 (支持热重载)
wails dev

# 3. 编译生产版本
wails build

---

⚙️ 配置指南

启动软件后点击右上角 设置 (Settings) 图标：

1. 选择提供商：支持 OpenAI, Gemini, Claude, 或 Custom。
2. API Key：填入对应平台的 API Key。
3. 模型参数：
   • Temperature: 控制回答的随机性 (0.0 - 2.0)
   • Thinking Budget: 设置 o1/Claude-3.5 思考过程的 Token 预算
4. Custom 自定义模式：
   • 选择 Custom 提供商
   • 填入聚合 API 地址 (如 OneAPI)
   • 支持根据模型前缀自动切换底层协议 (Gemini/Claude)

---

⌨️ 快捷键

按键	作用
F8	区域截图并提问 (核心功能)
F9	显示 / 隐藏主窗口
F10	开启 / 关闭鼠标穿透
Alt + ⬆️/⬇️/⬅️/➡️	微调窗口位置
Alt + PgUp/PgDn	快速翻页查看历史

---

支持

如果您喜欢这个项目，请给它一个 ⭐️ Star，这对我们非常有帮助！

免责声明：本项目仅供技术研究与个人学习使用，请勿用于任何非法用途。

Made with ❤️ by jym66