实用音乐搜索工具（Practical Music Search）技术文档

1. 安装指南

在开始使用实用音乐搜索工具（Practical Music Search，简称PMS）之前，您需要确保已安装Go开发环境，并且版本为1.13或更高。

以下是安装PMS的步骤：

git clone https://github.com/ambientsound/pms
cd pms
make install

执行上述命令后，PMS的二进制文件将被放置在$GOBIN/pms目录中，通常位于~/go/bin/pms。您需要在具有TTY的常规终端中运行PMS。

如果在运行过程中PMS崩溃，且您希望报告错误，请包含调试日志：

pms --debug /tmp/pms.log 2>>/tmp/pms.log

2. 项目使用说明

PMS是一个交互式控制台客户端，用于Music Player Daemon（MPD），采用Go语言编写。其界面类似于Vim，旨在实现快速、可配置且实用的特性。

PMS具备多种功能，包括排序、搜索和导航，旨在有效地帮助您浏览音乐收藏集。目前实现的一些功能包括：

• Vim风格的界面和操作感受
• 可配置以最小化屏幕空间占用
• MPD播放器控制：播放、添加、暂停、停止、下一曲、上一曲、音量
• 高度可定制的顶部栏、标签头部、文本样式、颜色和键盘绑定
• 快速库搜索，支持UTF-8归一化、模糊搜索和评分
• 通过视觉模式、手动选择和特定标签选择歌曲
• 多种曲目列表操作方式，如剪切、复制、粘贴、过滤和排序
• 配置文件、标签完成、历史记录等更多功能！

3. 项目API使用文档

目前，PMS项目的API使用文档没有在readme中明确指出，但用户可以通过项目仓库中的Documentation获取更多信息。

4. 项目安装方式

PMS的安装方式已在“安装指南”部分详细介绍。以下是简要的安装步骤：

git clone https://github.com/ambientsound/pms
cd pms
make install

确保您拥有Go版本1.13或更高，以及正确的Go开发环境配置。

通过以上文档，您应该能够顺利安装和使用实用音乐搜索工具（PMS），并且更好地了解其功能和特性。