OpenClaw 的 Discogs 收藏管理技能

该技能提供一个命令行接口，用于与用户在 Discogs.com 上的唱片收藏进行交互。它专为在 OpenClaw 助理中使用而设计，采用类似 git 或 gog 的子命令结构。

前置条件

该技能是一个 Go 程序，要求系统已安装 Go 工具链。

安装（Debian/Ubuntu）：
sudo apt-get update && sudo apt-get install -y golang-go

一次性初始化设置

首次使用前，必须运行随附的安装脚本。该脚本将编译 Go 二进制文件，并将其放置在技能目录内一个确定的位置。

1. 运行安装器：

   skills/discogs-cli/install.sh
   

2. 配置凭据：
   该命令将您的 Discogs Token 和用户名保存至配置文件（~/.config/discogs-cli/config.yaml）。

   skills/discogs-cli/bin/discogs-cli config set -u "YourUsername" -t "YourSecretToken"
   

使用方法

所有命令均需以二进制文件的完整路径作为前缀。

获取专辑封面

下载指定发行版（release）的专辑封面，并在聊天窗口中显示。

skills/discogs-cli/bin/discogs-cli release art 

列出收藏夹文件夹

显示所有文件夹及其所含唱片数量。

skills/discogs-cli/bin/discogs-cli collection list-folders

列出某文件夹内的发行版

显示指定文件夹中的全部唱片。输出为格式化表格。

# 列出 "All" 文件夹（默认）中的所有发行版
skills/discogs-cli/bin/discogs-cli collection list

# 按文件夹 ID 列出特定文件夹中的所有发行版
skills/discogs-cli/bin/discogs-cli collection list --folder 8815833

搜索 Discogs 数据库

搜索发行版、艺人或厂牌。

# 搜索发行版（默认类型）
skills/discogs-cli/bin/discogs-cli search "Daft Punk - Discovery"

# 搜索艺人
skills/discogs-cli/bin/discogs-cli search --type artist "Aphex Twin"

管理您的愿望单（Wantlist）

对您的 Discogs 愿望单执行操作。

列出您的愿望单

显示您愿望单中的全部条目。

skills/discogs-cli/bin/discogs-cli wantlist list

添加至愿望单

通过发行版 ID 将其添加到您的愿望单中。

skills/discogs-cli/bin/discogs-cli wantlist add 12345

从愿望单中移除

通过发行版 ID 将其从您的愿望单中移除。

skills/discogs-cli/bin/discogs-cli wantlist remove 12345

缓存与估值相关命令

这些命令依赖本地缓存以提升性能。您必须先运行 sync 命令填充缓存。

同步收藏详情（耗时较长）

为收藏中的每一项获取详细数据，并构建本地缓存。该命令执行缓慢，建议在后台运行。请向用户说明此过程需要较长时间。

skills/discogs-cli/bin/discogs-cli collection sync

获取收藏估值（快速）

读取本地缓存，返回每张唱片的预估市场价格及整个收藏的总估值。该命令执行迅速。若执行失败，通常表示缓存尚未生成，此时需先运行 sync 命令。

skills/discogs-cli/bin/discogs-cli collection value

获取单张发行版详情（快速）

提供单张发行版的详细信息，包括曲目列表（tracklist）。

skills/discogs-cli/bin/discogs-cli collection get 35198584