支持的格式#

• flac
• mp3
• wav（不能读取音乐标签）

文件与模块一览#

• main.go：入口，调用 player.PageController() 启动交互流程。
• input_handler/用户输出处理目录，包括各种界面用户输入处理的逻辑和页面切换控制器。
• player/：播放核心目录，包含播放、输入控制、歌词解析、进度条等：
  • player.go：Player 结构体，负责解码（mp3/flac/wav）、初始化 beep 流、启动播放、管理 beep.Ctrl 用于暂停/恢复，以及歌词加载逻辑。。
  • lyric.go：逐字歌词解析与渲染逻辑，支持把相同时间戳的原文/译文配对并逐字高亮。
  • process_bar.go：进度条逻辑，按终端宽度动态计算进度长度并绘制。
• utils/：若干工具函数：
  • center.go：把带颜色的字符串居中显示（使用 stripansi 删除 ANSI 再测宽度）。
  • path.go：WalkDir、ListDir、PrintPathInfo 等目录/分页展示辅助。

关键依赖在 go.mod 中可以看到：beep、tag、stripansi、go-runewidth 等。

播放流程#

1. 启动页面控制器
2. 用户输入路径（handleHomeInput），若是目录进入菜单，否则直接播放文件
3. 在菜单中使用 ListDir 列出音乐文件和子目录，分页显示，+下一页，-上一页, q 退出，0播放当前目录所有音乐,a递归遍历目录并播放所有文件，加上r后可以随机播放
4. 选择播放时创建 Player（NewPlayer(path)），Init() 打开文件并根据扩展名用相应解码器（mp3.Decode、flac.Decode、wav.Decode）。
5. 使用 beep.Ctrl{Streamer: p.streamer} 作为控制器，在 speaker.Play(beep.Seq(ctrl, beep.Callback(...))) 中播放并等待播放完成信号。
6. 播放期间开启两个并发协程：一个绘制进度条（progressBar.printBar），另一个负责歌词显示（lyrics.print）。输出使用 ANSI 控制序列定位，printMu 用于避免多协程输出冲突，并且会开启一个监听用户输入的协程（handlePlayInput）,根据用户输入向其他协程发送信号来控制行为
7. 输入监听在 raw 模式下逐字读取字节，空格控制暂停/播放，-上一首,+下一首，q退出。

歌词实现细节#

• 借助 github.com/dhowden/tag 读取音频元数据中的歌词（如果存在）。
• 使用正则匹配时间戳信息和歌词信息
• lyric.go 实现了逐字解析：把带时间戳的行拆成若干 word（包含相对时间与文本），并把相同时间戳的行配对为原文+译文（lyricPair）。
• 渲染时根据播放器当前播放样本位置计算当前时间（通过 streamer.Position() 与 format.SampleRate 换算），定位到当前行和当前字并高亮已播放的字（蓝色）和未播放字（深灰）。
• 为了解决歌词闪烁，每一行只有当变化的时候才会重新渲染（虽然直到现在当逐字歌词词变化速度过快的时候还是会闪烁，我是真服了）

进度条与终端适配#

• progressBar 读取终端宽度（term.GetSize），减去显示当前/总时长位置后绘制进度块。
• 时间计算使用 streamer.Len() 与采样率换算为总时长，再通过 Position() 换算当前时间。
• 绘制时读取实时终端大小，并在每次绘制前清理目标行，借助 utils.Center 使部分文本居中。