🧠 Q-Solver

AI 驱动的实时桌面助手 · 截图解题 · 语音对话

🎯 一键截图开启深度思考，实时语音连接智能未来

特性 • 安装 • 演示 • 配置 • English Documentation

Caution

🚧 开发阶段警告：本项目目前处于早期开发预览阶段 (Pre-Alpha)。功能可能会随版本更新发生重大变化，建议仅用于测试和尝鲜。

🌟 核心亮点

🖼️ 极速截图求解 只需一个快捷键，即刻捕获屏幕内容并进行 AI 分析。 📸 智能识别：精准识别文字、公式、代码。 🧠 深度思考：支持 o1, Claude 3.5 等强推理模型。 ⚡️ 零干扰：悬浮窗设计，不打断当前工作流。

🎙️ 沉浸式语音交互 集成了 Google Gemini Live API，体验丝滑的实时对话。 🗣️ 双向通话：毫秒级响应，如同真人交谈。 🗺️ 思维导图：对话内容自动整理为可视化导图。 📝 智能笔记：自动转录并总结重点。

✨ 核心特性

🛡️ 隐身模式 (Stealth Mode)

专为隐私与多任务设计，打造“幽灵”般的窗口体验。

⚠️ 提示：具体效果请自行测试。

特性	描述
🚫 防录屏检测	窗口对大多数录屏/截屏软件不可见
👻 鼠标穿透	开启后可透过窗口点击后方内容，互不影响
📌 全局置顶	始终悬浮在其他窗口之上，重要信息一眼即达
🔕 沉浸免打扰	精心设计的焦点管理，输入时不抢占主窗口焦点

---

🧠 多模型生态

支持 OpenAI / Gemini / Claude / DeepSeek (自定义) 等主流模型。

• Live API: 体验 Gemini 2.0 毫秒级实时语音通话。
• 自定义模型: 兼容所有 OpenAI 格式的 API 接口。

📸 界面展示

🚀 快速开始

📥 方式一：直接下载 (如果你想直接使用)

前往 Releases 页面 下载对应系统的最新安装包。

Note

macOS 用户提示：首次运行时如果提示“已损坏”或无法打开，请执行以下命令：

xattr -cr /Applications/Q-Solver.app
chmod +x /Applications/Q-Solver.app/Contents/MacOS/Q-Solver

🛠️ 方式二：源码构建 (如果你是开发者)

环境要求：Go 1.25+, Node.js 22+, Wails CLI

# 1. 安装 Wails
go install github.com/wailsapp/wails/v2/cmd/wails@latest

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

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

# 4. 编译发布版本
wails build -ldflags "-s -w" -tags prod

⌨️ 快捷键指南

💡 提示：目前 macOS 快捷键固定，Windows 支持自定义快捷键（下表为默认按键）。

动作	Windows	macOS
截图并提问 📸	F8	⌘ + 1
显示/隐藏窗口 👁️	F9	⌘ + 2
切换鼠标穿透 👻	F10	⌘ + 3
微调窗口位置 ↕️	Alt + 方向键	⌘⌥ + 方向键
快速翻页 📜	Alt + PgUp/Dn	⌘⌥⇧ + ↑/↓

⚙️ 配置与使用

1. 点击窗口右上角的 设置 (Settings) 图标。
2. 在 提供商 (Provider) 中选择你已有的 API 服务
3. 填入你的 API Key。

🍎 macOS 特别配置

macOS 需要额外权限以发挥完整功能：

🔐 屏幕录制权限 (必选)

为了实现截图功能，首次使用时：

1. 系统会弹窗提示请求 屏幕录制 权限。
2. 若未弹窗，请前往 系统设置 -> 隐私与安全性 -> 屏幕录制。
3. 勾选 Q-Solver。
4. 重启应用 生效。

🎙️ 系统音频内录 (Live API 必选)

若想让 AI 听到电脑播放的声音（如会议内容），需要安装虚拟声卡：

1. 安装 BlackHole:

   brew install blackhole-2ch

2. 打开 音频 MIDI 设置 (Audio MIDI Setup)。
3. 创建 多输出设备 (Multi-Output Device)，同时勾选 扬声器 和 BlackHole 2ch。
4. 将该多输出设备设为系统默认输出。
5. 在 Q-Solver 设置中，确保音频输入包含 BlackHole。

🛠️ 技术栈概览

• Core: Go (Logic) + Wails (Binding)
• UI: Vue 3 + Vue Flow (Mind Map)
• AI: Gemini Protocol, OpenAI SDK
• Audio: Miniaudio (via malgo), BlackHole

📈 Star 趋势

📄 许可证

本项目基于 CC BY-NC 4.0 协议开源，仅供 非商业个人学习与研究 使用。

---

Made with ❤️ by jym66

如果你觉得这个项目有趣，欢迎点个 ⭐ Star 支持一下！