SongRec 反馈与问题报告渠道指南

更新时间

遇到 Bug 或想提功能请求，首选渠道是 GitHub issues；只有在 GitHub issues 不便使用时，才用 Matrix 频道 作为补充沟通方式，且该频道的消息可能被忽略，不适合作为首选。

首选：GitHub issues

SongRec 官方页面明确说明，与 SongRec 相关的任何 bug 报告或功能请求，都应通过 GitHub issues 作为沟通渠道提交。这是开发者指定的正式反馈入口，适合以下场景：

  • 识别结果错误、崩溃、界面异常等 Bug 报告
  • 新功能建议或改进请求
  • 安装包、发行渠道相关的问题反馈

提交前建议先浏览已有 issue，确认是否已有人报告同类问题，避免重复。提交时尽量写清：使用的发行渠道（Flathub、Launchpad PPA、Arch 官方仓库、Snap Store 或 Windows 安装包）、系统环境、复现步骤和预期结果。

补充：Matrix 频道

官方页面提到，只有在 GitHub issues 使用起来不令人满意时，才考虑 SongRec 的 Matrix 频道。需要特别注意的是，官方原文提示：发送到 Matrix 频道的内容可能会被遗忘。因此它更适合临时性、非正式的交流，而不是需要被跟踪处理的问题报告。

渠道 定位 适用情况 注意事项
GitHub issues 正式反馈入口 Bug 报告、功能请求、发行相关问题 官方指定的首选渠道
Matrix 频道 补充沟通渠道 GitHub issues 不便使用时 消息可能被忽略，不保证被处理

其他可参考的信息入口

如果问题不是反馈而是想了解功能与实现方式，官方页面指向 GitHub readme，其中列出了 SongRec 的功能列表和工作原理说明。SongRec 本身是一个用 Rust 编写的非官方开源 Shazam 客户端，支持从任意音频文件或麦克风识别歌曲，提供 GUI 与命令行两种文件识别方式，GUI 中可查看识别历史并导出为 CSV，还支持麦克风连续识别与选择输入设备，在兼容的 PulseAudio 环境下可从扬声器而非麦克风识别歌曲。这些功能细节在 readme 中有更完整的说明，遇到使用疑问时可先查阅。

常见卡点

  • 把 Matrix 当主渠道：官方已说明消息可能被遗忘，重要问题应走 GitHub issues。
  • 反馈信息不全：未注明安装渠道和系统环境，会增加定位难度。
  • 重复提交：提交前先搜索已有 issue，能减少无效沟通。