v0.2.54 - 双端朗读、多手机同步、千问直连

v0.2.54 — 双端朗读、多手机同步、千问直连

Windows / macOS 共同更新

• 控制台增加独立的「电脑端发声」「手机端发声」勾选项，并记住设置；可同时开启。
• 答案生成后自动朗读，开始下一题停止上一题的声音；截图对话答案也支持电脑端朗读。
• 多部手机扫描同一个二维码后共享截图操作、流式答案、聊天、模型选择与手机朗读开关。一部手机截题，其他手机实时更新。
• 新连接或重连的手机恢复正在生成的文字与待发送截图；一部手机离线不影响其他手机。
• 保留现有 Mac 控制台、截图手势、悬浮答案和二维码功能；桌面后台使用本机回环连接，二维码使用局域网地址。

模型调整

所有原 OpenRouter 路线迁移到阿里云百炼千问直连接口，不再使用 OpenRouter 地址或 Key。原有 DeepSeek 官方、豆包官方路线仍可独立选择。

千问提供 8 个图文模型：

• qwen3-vl-plus
• qwen3.8-flash
• qwen3.5-plus
• qwen3.5-flash
• qwen3.5-397b-a17b
• qwen3.5-122b-a10b
• qwen3.5-27b
• qwen3.5-35b-a3b

北京地域接口：https://dashscope.aliyuncs.com/compatible-mode/v1。Key 必须匹配所选地域，模型需在对应账户开通。模型信息参考百炼官方文档。

修复模型错误时自动切换平台的问题：选择千问就只调用千问，认证失败、额度不足或模型不可用时显示当前平台错误，不会再误报其他平台的 Key 错误。保留具体错误说明、HTTP 状态和模型名称。

安装与使用

• Windows：解压 QQMusic-Windows.zip，运行 QQMusic.exe，允许专用网络访问。
• Mac：退出旧程序，将 DMG 中的 QQMusic.app 放到 /Applications/QQMusic.app 后运行。Bundle ID 为 com.sayuriqvq.QQMusic。更新不清除本机用户设置与 API Key。
• 手机与电脑连接同一局域网。每部手机首次打开后点击「试听」激活浏览器语音，并确认音量。
• Mac 如系统重新要求截图或辅助功能权限，请为上述固定路径授权后完全退出再打开。当前 Mac 包为临时签名，未做 Apple 公证。
• 发布包不包含用户 API Key、用户配置或本地 .env。

验证范围

自动化测试覆盖平台路由、错误不跨平台回退、双端朗读开关、旧语音取消、多手机 WebSocket 同步、重连恢复、截图及现有界面逻辑。手机脚本测试覆盖两部手机一致显示、朗读取消与去重、截图恢复、模型同步。

自动化测试使用模拟模型响应，不消耗用户 API 额度。真实设备的扬声器、浏览器播放授权、系统截图权限，以及每个模型的账户开通情况，需由使用设备与账户实际确认。

本次构建结果

• 源码提交：9c7c0abfc7afa65e0d1a662455457e50e2aa8f42，main 与 v0.2.54 标签一致。
• Windows 云端构建：210 项 Python 测试通过，4 项手机脚本测试通过。
• Mac 云端构建：209 项 Python 测试通过，1 项 Windows 专用测试跳过，4 项手机脚本测试通过。
• Mac 包适用于 Apple 芯片（arm64），Windows 包为 x64。
• 已检查两个实际下载包中的语音引擎组件、手机脚本与 8 个千问模型配置；Mac Bundle ID 与临时签名校验通过。
• 北京接口只读模型列表认证成功，8 个所选模型均在列表中；此项检查不代表已经逐个执行付费图像推理。
• 下载后可使用附带的 SHA256SUMS.txt 核对文件完整性。