V1.7.0 - 2026-04-24

新增功能

命令行文件打开支持

• 新增从命令行直接打开单个音频文件的功能
• 新增 load_single_file() 函数用于加载单个音频文件
• load_playlist() 函数现在支持文件路径，自动检测并调用相应加载逻辑
• 更新 -o/--open 参数，支持指定单个音频文件作为启动参数
• 更新帮助文档，添加单文件打开示例

桌面文件关联支持

• 桌面文件 Exec 参数添加 %f 占位符，支持从文件管理器直接打开音频文件
• 添加 MimeType 字段，声明支持的音频格式（MP3、FLAC、OGG、WAV、M4A、APE、OPUS 等）

MPRIS 媒体会话集成（可选）

• 新增可选的 MPRIS 媒体会话集成支持
• 允许系统媒体控制中心（如 GNOME/KDE 的媒体控制）控制播放器

Arch Linux 支持

• 新增 Arch Linux PKGBUILD 支持
• 添加 AUR 安装方法和手动构建步骤说明
• 优化版本号获取逻辑

Debian 打包支持

• 新增 Debian 打包元数据
• 优化 DEB 打包脚本

构建与依赖

依赖库更新

• 更新依赖库版本以支持更多 FFmpeg 版本

构建脚本修复

• 修复 build-deb.sh 中 README 文件引用错误（将 README_CN.md 更正为 README_zh-CN_Modern.md）
• 更新 build-rpm.sh 添加对 Debian/Deepin 系统的支持：
  • 自动检测系统类型（Debian/RPM）
  • 在 Debian 系统上检查 deb 格式的开发库依赖
  • 使用 --nodeps 选项跳过 rpmbuild 的 RPM 依赖检查
  • 根据系统类型显示正确的包管理器安装命令

文档更新

README 文档重构

• 创建 README_zh-CN_Modern.md 现代中文文档
• 将原中文文档重命名为 README_zh-CN_Legacy.md（文言文风格）
• 在 README.md 中添加其他语言版本链接
• 更新章节编号以保持一致性

安装方式扩展

• 添加 ZPM 包管理器安装说明（支持三种语言版本）
• 添加 Arch Linux PKGBUILD 详细安装和构建指南

项目信息更新

• 将项目主页链接从 Gitee 迁移至 GitHub（包括构建脚本和 README 文件）
• 更新中文 README 中的仓库链接
• 在中英文 README 中添加鸣谢章节，列出贡献者及其贡献
• 更新贡献者列表，补充 @guanzi008 关于 Debian 打包元数据和 MPRIS 媒体会话集成的新贡献说明

---

贡献者感谢：感谢 @guanzi008、@ZhongHongSoftware 等贡献者的辛勤付出！

---

v1.7.1 - 2026-04-24

Bug 修复

• 修复 desktop 图标点击报错问题

  • 修正 .desktop 文件的 Exec 字段格式，将 'ter-music -o %f' 改为 'ter-music %F'
  • 在 main.c 中添加位置参数支持，使程序能够接收命令行文件路径参数

  改进效果：

  • 直接点击桌面图标时，程序正常启动
  • 从文件管理器打开音频文件时，程序自动加载该文件

---

说明： 这是一个小版本修复，主要解决了 Linux 桌面环境下点击应用图标无法正常启动的问题，同时完善了从文件管理器直接打开音频文件的功能支持。

下载链接

https://github.com/YXZL985/ter-music/releases/tag/v1.7.1

写在后面的话

如果您有更好的建议，欢迎在论坛或ISSUES区域留言：
https://github.com/YXZL985/ter-music/issues

如果您想为开源社区贡献自己的力量，欢迎提交Pull Requests：
https://github.com/YXZL985/ter-music/pulls

1.7.0有重大bug，不建议使用。