关羽之歌便携版 v2.0

作者：@依然匹萨吧

安卓版：PizzaDark/GuanyuPlayer-android (github.com)

功能介绍

• 介绍视频
• 按下快捷键 Alt+G+Y 播放/停止音频
• 语音中检测到关键词自动播放（支持多关键词，需要语音模型）
• 支持自定义快捷键、音量调节、开机启动等
• 支持多音乐文件随机播放（预设模式/自定义模式）
• 可自定义语音识别模型路径

更新日志

v2.0新增以下功能：

• 多关键词支持：从单一关键词扩展到最多10个关键词，任意匹配即可触发
• 音乐预设模式：经典模式（单曲循环）、抽卡模式（4首变奏随机爽听）
• 自定义音乐管理：支持添加最多10个自定义音频文件，随机播放
• 自定义模型路径：模型已内置到程序中，也可自由选择语音识别模型位置，不再限制固定目录
• 音乐试听功能：在音乐管理器中可预览试听音频文件
• 配置文件管理：可直接打开配置文件所在位置
• 界面优化：新增关键词编辑器、音乐管理器等独立窗口

文件说明

关羽之歌便携版.exe - 主程序 guanyu_song.mp3 - 经典模式音频文件（必需） guanyu_song_1~4.mp3 - 抽卡模式音频文件（可选） guanyu_icon.ico - 程序图标 vosk-model-small-cn-0.22/ - 语音模型（可选）

快速开始

1. 双击运行build.bat

2. 或者手动输入：

3. # 推荐python3.10
   python -m venv .venv
   .venv\Scripts\activate (Windows)
   source .venv/bin/activate (macOS/Linux)
   
   pip install -r requirements.txt
   pip install pyinstaller
   
   pyinstaller --clean build.spec

4. 在dist目录下找到.exe并运行

语音识别（可选）

1. 下载模型：https://alphacephei.com/vosk/models 推荐选择：vosk-model-small-cn-0.22（也可用其他语言的版本）
2. 解压到任意位置
3. 在程序设置中点击"浏览"按钮，选择模型文件夹 （也可以解压到程序目录，程序会自动检测）
4. 运行程序，麦克风检测到任意关键词即可自动触发播放

快捷键设置

默认快捷键：Alt + G + Y 修改方法：点击"修改快捷键"按钮，按下新组合键 恢复默认：点击"恢复默认"按钮

关键词设置

默认关键词：释怀、天意（最多10个） 修改方法：点击"编辑关键词"按钮，每行输入一个关键词 恢复默认：点击"恢复默认"按钮 说明：语音识别时会检测任何一个关键词，匹配到则自动触发播放

音乐设置

预设模式：

• 预设1：经典模式 - 使用 guanyu_song.mp3（单曲）
• 预设2：抽卡模式 - 使用 guanyu_song_1.mp3 ~ guanyu_song_4.mp3（随机4选1）

自定义模式：

• 点击"管理音乐"按钮
• 最多添加10个音乐文件（支持mp3/wav/ogg格式）
• 选中文件后点击"试听"可预览
• 触发播放时将随机播放列表中的一首

说明：

• 删除仅从列表移除，不会删除磁盘文件
• 可随时切换回预设模式
• 配合mixline等软件或虚拟声卡可用于游戏语音连麦

系统托盘

• 关闭窗口 → 最小化到托盘
• 双击托盘图标 → 显示窗口
• 右键托盘图标 → 菜单选项
• 选择"退出" → 完全退出程序

常见问题

Q: 快捷键没反应？ A: 检查是否有其他软件占用，或修改为其他组合

Q: 语音识别不工作？ A: 1. 检查语音模型是否正确放置或路径是否正确 2. 检查麦克风是否正常工作 3. 确认语音识别选项已启用 4. 检查是否选择了正确的音频输入设备

Q: 如何切换音乐播放模式？ A: 在音乐管理器中可以选择预设模式或自定义模式

Q: v1.0和v2.0有什么区别？ A: v2.0支持多关键词、多音乐文件、自定义模型路径等新功能，详见上方"v2.0新特性"章节

系统要求

• Windows 7/8/10/11 (64位)
• 内存 2GB 以上
• 麦克风（语音识别需要）

配置文件

位置：C:\Users<用户名>.guanyu_song_config.json

说明：

• 存储快捷键、音量、关键词、音乐列表等所有设置
• 删除此文件可重置所有设置为默认值
• 可在程序中点击"打开配置文件位置"按钮快速定位

配置项包括：

• hotkey: 快捷键组合
• volume: 音量（0.0-1.0）
• keywords: 关键词列表
• audio_files: 音乐文件列表
• model_path: 自定义模型路径
• auto_start: 开机启动设置

开源许可证

本项目采用 知识共享 署名 - 非商业性使用 - 相同方式共享 4.0 国际许可证 (CC BY-NC-SA 4.0) 授权。

核心条款说明

1. 允许的行为：你可以自由复制、修改、分发本项目的代码 / 程序，前提是满足以下条件；
2. 禁止的行为：严禁将本项目（包括修改后的衍生版本）用于任何商业目的（如出售、付费分发、商业运营等）；
3. 必须遵守：
   • 署名：必须保留原作者信息（PizzaDark）；
   • 相同方式共享：若你修改 / 衍生本项目，必须采用与本协议相同的许可证发布。

协议完整文本

请查看官方协议全文：https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.zh

第三方组件许可证

本软件使用了以下开源组件：

• PyQt5: GPL-3.0 / Commercial
• pygame: LGPL-2.1
• Vosk: Apache-2.0
• pynput: LGPL-3.0
• sounddevice: MIT

声明

• 音乐版权归原作者(赵季平)所有，不包含在本许可证范围内
• 语音模型 vosk-model-small-cn-0.22 遵循 Apache-2.0 许可证

如果觉得好用，欢迎到B站关注支持https://space.bilibili.com/6297797