终末之歌并不是一个只能播放单曲的小工具，而是一套面向终端的轻量级音乐管理方案。它由Go语言编写，核心目标是让用户在没有图形界面的环境中也能快速扫描、检索、播放和管理本地音乐文件。和传统桌面播放器相比，它省去了窗口渲染、皮肤加载和大量后台服务，内存占用通常能控制在几十MB以内，因此在树莓派、NAS、远程服务器或者老旧的笔记本上都有不错的表现。
之所以叫终末之歌，是因为设计上强调终端的极简操作和本地音乐库的长期维护。它不会自动联网下载封面，也不会强制同步云端曲库，所有操作都围绕用户指定的音乐目录展开。如果你习惯在终端里完成日常工作，或者需要一台设备长期挂着播放背景音乐，这个工具的学习成本并不高，下面会把功能、安装、使用步骤和常见问题依次拆开说明。
一、终末之歌的核心功能
终末之歌的功能模块可以分成三块：本地音乐库管理、实时播放控制、终端界面增强。本地音乐库管理负责扫描指定目录，读取音频文件的元数据，包括标题、艺术家、专辑、时长和采样率。扫描结果会写入本地索引文件，后续搜索不需要重新遍历全部文件，速度会快很多。默认支持MP3、FLAC、AAC、OGG和WAV格式，FLAC和WAV这类无损格式可以直接播放，不需要额外插件。
实时播放控制是核心部分。命令行提供了完整的控制指令，例如tsong play开始播放，tsong pause暂停，tsong next切到下一首，tsong prev返回上一首。播放器的后端基于PortAudio，能够自动识别默认音频输出设备。如果系统里有多个声卡，也可以通过配置文件指定输出通道。播放时终端会显示当前歌曲信息、进度条和音量值，不使用图形渲染，而是用ASCII字符画出进度条。
第三块是歌词与播放列表。终末之歌支持读取本地.lrc歌词文件，并能根据歌曲文件名自动匹配。如果歌词文件是UTF-8以外的编码，例如GBK，可以在配置里声明编码后自动转换，避免中文显示乱码。播放列表则允许用户创建多个分组，把不同风格的音乐归类保存。播放列表文件存放在配置目录下，使用JSON格式，方便备份和迁移。
下面这个命令序列展示了最基本的功能调用：
# 扫描音乐目录 tsong scan ~/Music # 查看扫描到的歌曲数量 tsong stats # 播放全部歌曲 tsong play --all # 暂停 tsong pause
二、安装与初始化配置
安装终末之歌的方式取决于操作系统。macOS用户可以直接使用Homebrew，Linux用户可以选择下载.deb或.rpm安装包，Windows用户可以通过Scoop或手动解压压缩包。安装完成后，在终端执行tsong version，如果能返回版本号，说明可执行文件已经加入PATH。下面给出三套常见安装命令：
# macOS brew install tsong # Debian/Ubuntu sudo dpkg -i tsong_0.5.2_amd64.deb # Windows PowerShell scoop install tsong
第一次使用不要急着播放，建议先执行tsong init生成初始配置。命令会创建配置目录，Linux和macOS下通常是~/.config/tsong/，Windows下是C:\Users\当前用户名\.tsong\。配置目录里会有一个config.yaml文件，里面包含音乐目录、输出设备、默认音量、歌词编码等选项。下面是一份最小可用配置：
music_dir: "~/Music" output_device: "default" volume: 75 lyric_encoding: "utf-8" auto_resume: true
如果音乐文件存放在移动硬盘、网络挂载目录或者NAS共享目录里，需要把music_dir改成实际路径。修改配置后执行tsong scan，工具会递归扫描该目录下的所有音频文件。扫描完成后，本地索引会保存在配置目录中，以后启动播放器时直接读索引，不会重复扫描。若目录中文件变动比较频繁，可以设置定时扫描任务，例如每两小时执行一次tsong scan --update。
三、详细使用步骤
真正开始播放之前，建议先执行一次完整扫描。扫描命令支持排除隐藏目录和指定扩展名，例如tsong scan --exclude "*.m4a"可以跳过所有M4A文件。扫描结束后用tsong list查看音乐列表，列表会显示序号、标题、艺术家和时长。如果不加参数，默认按文件名排序。如果想按专辑或艺术家排序，可以加--sort参数。
播放时最常用的做法是直接指定歌曲序号或关键字。例如tsong play 3表示播放列表中的第三首歌，tsong play 海阔天空会执行模糊搜索并播放匹配结果。搜索支持中文和拼音首字母，所以即使不记得完整歌名，也能快速定位。下面演示一个从搜索到播放再到调整音量的完整流程：
# 搜索包含“雨”字的歌曲 tsong search 雨 # 根据搜索结果播放编号为2的歌曲 tsong play 2 # 音量调到80 tsong volume 80 # 下一首 tsong next
播放过程中终端会持续刷新当前进度。如果需要在后台运行，可以加上--daemon参数，这样关掉终端窗口后音乐不会中断。后台运行时，仍然可以通过新的终端窗口执行控制命令，因为控制端和播放端通过本地socket通信。这个设计适合远程登录服务器播放音乐的场景，SSH会话断开也不影响播放。
播放列表的创建和使用也足够简单。tsong playlist create night会创建一个名为night的播放列表，tsong playlist add night 3 5 8把第3、5、8首歌加入该列表。之后执行tsong playlist play night就能只播放这个列表里的内容。列表文件可以直接复制到另一台机器，只要音乐目录结构一致，就能无缝迁移。
四、常见问题解答
为什么扫描完成后一首歌都没有识别出来？多数情况下是音乐目录配置错误，或者目录里只有不支持的格式。先执行tsong config get music_dir确认路径是否正确，再检查文件扩展名是否在支持列表内。如果音乐文件存放在软链接目录下，需要在配置里开启follow_symlinks选项。
播放时提示无法初始化音频设备怎么办？这个错误通常和系统音频驱动有关。Linux下可以检查是否安装了ALSA或PulseAudio，macOS和Windows一般不会出现这类问题。如果确实没有声卡，可以设置output_device: "null"，让播放器在无音频设备的环境下静默运行，适合纯索引测试。
中文歌词显示乱码怎么处理？歌词文件可能是GBK或BIG5编码，而配置默认按UTF-8读取。把lyric_encoding改成gbk或big5，重新加载歌曲即可。如果歌词文件没有和歌曲同名，可以在播放时手动指定歌词路径，例如tsong lyric --path /path/to/song.lrc。
更新版本后配置丢失了怎么办？配置目录一般在用户主目录下，升级不会主动删除配置。但如果手动清理过目录，可以重新执行tsong init生成默认配置，再重新扫描音乐库。索引文件也可以随时删除重建，不会影响原始音频文件。