把喜欢的音乐带回家。
Pika 支持按关键词搜索下载，也支持按 Bilibili / YouTube 链接下载，把音乐保存到指定目录。可通过配置文件或环境变量为各平台提供 Cookie，默认优先选择可用高音质。
视频链接下载的是音频，不会下载画面。
Pika 非常适合由 AI Agent 调用：告诉具备终端执行能力的 Agent 想下载的歌手、歌名或链接，它就可以通过 CLI 将音乐保存到本地。
ffmpeg（必需）：Bilibili 与 YouTube Music 返回的常是 DASH 音频分段，CLI 会用它重新封装为常见播放器可打开的文件。
macOS：使用 Homebrew 安装；尚未安装 Homebrew 时，请先按其官网说明安装。
brew install ffmpegArch Linux：
sudo pacman -Syu ffmpegDebian：
sudo apt update
sudo apt install ffmpeg这些安装方式同时提供 ffmpeg 和 ffprobe。安装完成后，检查它们是否可从终端调用：
ffmpeg -version
ffprobe -versionPika 使用 ffmpeg 提取音轨并重新封装，直接复制音频数据，不重新编码；ffprobe 可用于检查下载文件的编码、容器和时长。
macOS 和 Linux 可以直接安装预编译二进制，无需 Go：
curl -fsSL https://raw.githubusercontent.com/rccoder/Pika/main/install.sh | sh脚本自动识别系统和 CPU 架构，下载最新 Release，校验 SHA256，并安装到 ~/.local/bin/pika。支持 Intel / Apple Silicon Mac，以及 amd64 / arm64 Linux；再次运行即可升级。
若提示 pika: command not found，将下面一行加到 ~/.zshrc 或 ~/.bashrc，然后重新打开终端：
export PATH="$HOME/.local/bin:$PATH"pika --help
pika download '周传雄 黄昏' -o ./music也可以从 Releases 手动下载对应压缩包。指定版本或安装目录时：
curl -fsSL https://raw.githubusercontent.com/rccoder/Pika/main/install.sh | PIKA_VERSION=v0.1.0 PIKA_INSTALL_DIR="$HOME/.local/bin" sh查看当前版本：
pika --version
# 或 pika version发版二进制显示对应标签版本（如 Pika v0.2.1），未注入版本号的本地构建显示 Pika dev。
config.ini 可以统一保存平台 Cookie、下载目录和平台优先级。配置 Cookie 后，Pika 可以使用已登录账号的播放权限，部分内容可获取更高音质，也可能减少匿名访问限制；具体取决于账号权限和音源。公开内容通常也可匿名下载。
安装脚本会自动创建 ~/.pika/config.ini（文件权限 600，目录权限 700），再次安装或升级会保留已有配置。用编辑器打开它，填写 Cookie 即可，无需每次指定配置路径。
手动安装或从源码运行时，也可以下载模板（仅在文件不存在时执行）：
mkdir -p ~/.pika
chmod 700 ~/.pika
curl -fsSL https://raw.githubusercontent.com/rccoder/Pika/main/config.example.ini -o ~/.pika/config.ini
chmod 600 ~/.pika/config.ini用编辑器打开 ~/.pika/config.ini，将浏览器中对应网站已登录会话的完整 Cookie 填入相应节（示例是占位符）：
[plugins.bilibili]
cookie = `SESSDATA=...; bili_jct=...`
[plugins.youtubemusic]
cookie = `SID=...; SAPISID=...`
[download]
output_dir = ~/Music/Pika
platform_priority = bilibili,youtubemusic浏览器开发者工具的 Network 面板中，选择对应网站的请求，在请求头中查找 Cookie；复制其值即可。Cookie 过期后需更新。不使用的平台可留空。
Pika 默认读取 ~/.pika/config.ini；也可以指定其他配置路径：
export PIKA_CONFIG="$PWD/config.ini"也可以每次在命令后加 --config ./config.ini。配置文件路径优先级为 --config > PIKA_CONFIG > ~/.pika/config.ini；默认文件不存在时可匿名运行。环境变量和独立 Cookie 文件的用法见后面的「其他配置方式」。
配置好后，无需重复传 Cookie 或下载目录：
pika download '周传雄 黄昏'
pika download 'https://youtu.be/dQw4w9WgXcQ'输入「歌手 + 歌名」最容易找到想要的歌曲：
pika download '周传雄 黄昏' -o ./music
pika download '李宗盛 山丘' -o ./music也支持只输入歌手或歌名：
pika download '周传雄' -o ./music当前会自动选择一首搜索结果下载，不提供交互选择，也不会批量下载歌手的所有歌曲。搜索结果可能包含翻唱、现场或剪辑版本；需要准确版本时，建议使用具体链接。
CLI 按配置的平台优先级搜索，检查候选音轨的实际档位并优先选择高音质；详情见下面的「平台选择与音质」。
将具体的 Bilibili 或 YouTube 链接传给同一个命令，自动识别平台：
pika download 'https://www.bilibili.com/video/BV1Rc1gBaERq' -o ./music
pika download 'https://youtu.be/dQw4w9WgXcQ' -o ./music
pika download 'https://music.youtube.com/watch?v=dQw4w9WgXcQ' -o ./music完成后会显示最终保存路径，例如：
Saved: music/UP主 - 视频标题.m4a
输出目录不存在时会自动创建；同名文件不会覆盖，而会自动追加 (2)、 (3) 等后缀。
不传 -o 时，可以在配置中设置固定输出目录：
[download]
output_dir = ~/Music/Pika输出目录优先级：--output / -o > PIKA_DOWNLOAD_OUTPUT_DIR > output_dir > 当前工作目录。支持 ~ 和 ~/；相对路径以执行命令的工作目录为基准。
download 后的 URL 可以放在选项之前或之后，两种写法都有效：
# 推荐：URL 在前，阅读更自然
pika download 'https://www.bilibili.com/video/BV1Rc1gBaERq' -o ./music
# 也支持先写选项
pika download -o ./music 'BV1Rc1gBaERq'download 是总入口。它会自动识别 Bilibili、YouTube 或 YouTube Music 的链接/ID，并使用相应插件：
pika download 'https://youtu.be/dQw4w9WgXcQ' -o ./music
pika download 'https://www.bilibili.com/video/BV1Rc1gBaERq' -o ./music也可以传入关键词。CLI 会按 platform_priority 搜索，检查候选曲目的实际下载流；有可用 high 流时优先下载它，所有候选都只能标准音质时则使用最高优先级平台的可用流。
pika download 'Never Gonna Give You Up' -o ./music链接的来源是确定的，不受平台优先级影响。关键词搜索不接受 --cookie 或 --cookie-file；请用环境变量或配置文件为各平台提供 Cookie。
在 [download] 中配置关键词搜索顺序：
[download]
platform_priority = bilibili,youtubemusic支持 bilibili、youtubemusic（也可写 youtube 或 ytm）；未配置时默认为 bilibili,youtubemusic。
安装 Pika、ffmpeg 并填写 ~/.pika/config.ini 后，可以直接对具备终端执行能力的 AI Agent 说：
使用 Pika 下载周华健的《朋友》，使用默认配置和下载目录，完成后告诉我文件保存在哪里。
Agent 可以执行：
pika download '周华健 朋友'也可以交给 Agent 一个具体链接：
使用 Pika 下载这个链接的音频：https://youtu.be/dQw4w9WgXcQ，保存到 ./music。
pika download 'https://youtu.be/dQw4w9WgXcQ' -o ./musicCLI 自动读取 ~/.pika/config.ini 中的 Cookie、平台优先级和输出目录；无需把 Cookie 发给 Agent 或放进命令。完成后，终端输出的 Saved: 行包含文件保存路径，失败时返回非零退出码，方便 Agent 判断结果。
批量任务也可以用自然语言交代，例如「分别下载李宗盛的《山丘》《凡人歌》《给自己的歌》」。Agent 需要逐首调用 CLI；Pika 每次只下载一首。关键词结果可能是翻唱或现场版本，指定版本时请提供对应链接。需要核对文件格式、时长或实际码率时，Agent 可继续调用 ffprobe 检查下载文件。
- 视频链接：
https://www.bilibili.com/video/BV... - AV 号链接或 ID：
av123456/https://www.bilibili.com/video/av123456 - 音频页：
https://www.bilibili.com/audio/au123456 - 短链：
https://b23.tv/xxxxxx - 多 P 视频：在链接中加
?p=2，例如https://www.bilibili.com/video/BV.../?p=2 - 纯 ID：
BV...、av...、au...
视频 URL 会下载选中分 P 的音轨。短链会先解析到最终的 Bilibili 页面。
使用 youtube download 子命令：
pika youtube download \
'https://music.youtube.com/watch?v=dQw4w9WgXcQ' \
--output ./music \
--quality high也支持普通 YouTube 链接、短链、Shorts 和 11 位视频 ID：
pika youtube download 'https://youtu.be/dQw4w9WgXcQ' -o ./music
pika youtube download 'https://www.youtube.com/shorts/dQw4w9WgXcQ' -o ./music
pika youtube download 'dQw4w9WgXcQ' -o ./musicYouTube Music 仅提供标准/高音质的 AAC、Opus 等有损音频，不支持无损或 Hi-Res；因此该命令只接受 standard 与 high。
使用 --quality 选择期望音质：
| 值 | 含义 |
|---|---|
standard |
标准音质 |
high |
高音质，默认值 |
lossless |
无损优先 |
hires |
Hi-Res 优先 |
例子：
pika download 'BV1Rc1gBaERq' -o ./music --quality hires实际能获取到的音质取决于稿件与账号权限。无法取得所选流时，命令会报错，不会悄悄保存不完整文件。
公开稿件通常不需要 Cookie。若需要访问受限内容、较高音质或遇到访问限制，请提供对应网站已登录会话的 Cookie。
Cookie 的优先级为：--cookie > --cookie-file > 平台环境变量 > 配置文件。
环境变量可避免在下载命令中传入 Cookie；直接执行含 Cookie 的 export 仍可能进入 shell 历史，建议从受保护的配置文件读取：
export PIKA_BILIBILI_COOKIE='SESSDATA=...; bili_jct=...'
pika download 'BV1Rc1gBaERq' -o ./music --quality hiresYouTube Music 则使用：
export PIKA_YOUTUBEMUSIC_COOKIE='SID=...; SAPISID=...'
pika youtube download 'dQw4w9WgXcQ' -o ./music将 Cookie 单独放入权限受限的文件：
chmod 600 ~/.config/pika/bilibili.cookie
pika download 'BV1Rc1gBaERq' \
--cookie-file ~/.config/pika/bilibili.cookie \
-o ./music复制示例配置：
curl -fsSL https://raw.githubusercontent.com/rccoder/Pika/main/config.example.ini -o config.ini
chmod 600 config.ini然后编辑 config.ini：
[plugins.bilibili]
cookie = `SESSDATA=...; bili_jct=...`
[plugins.youtubemusic]
# 可选：从已登录 music.youtube.com 会话导出的 Cookie
cookie = `SID=...; SAPISID=...`
[download]
output_dir = ~/Music/Pika
platform_priority = bilibili,youtubemusic
timeout_seconds = 90
proxy = http://127.0.0.1:7890
multipart = true
multipart_concurrency = 4使用它下载：
pika download 'BV1Rc1gBaERq' --config ./config.ini -o ./music也兼容较短的 [bilibili] 配置节。
不要提交 Cookie 文件，也不要把它贴进 Issue、日志或聊天记录。
| 变量 | 用途 |
|---|---|
PIKA_CONFIG |
默认 INI 配置文件路径，可被 --config 替代 |
PIKA_DOWNLOAD_OUTPUT_DIR |
下载目录，可被 --output / -o 替代 |
PIKA_BILIBILI_COOKIE |
Bilibili Cookie |
PIKA_YOUTUBEMUSIC_COOKIE |
YouTube Music Cookie |
PIKA_DOWNLOAD_TIMEOUT_SECONDS |
下载超时秒数，例如 120 |
PIKA_DOWNLOAD_PROXY |
媒体下载代理，例如 http://127.0.0.1:7890 |
命令行选项会覆盖对应的环境变量；环境变量会覆盖配置文件。
pika download <Bilibili/YouTube URL、ID 或关键词> [options]
pika youtube download <YouTube / YouTube Music URL 或视频 ID> [options]
--output, -o DIR 输出目录，默认当前目录
--quality QUALITY standard、high、lossless 或 hires，默认 high
--config FILE 可选 INI 配置文件
--cookie VALUE 当前平台 Cookie（不建议直接传，容易进入历史记录）
--cookie-file FILE 读取当前平台 Cookie 的文件
--timeout SECONDS 下载超时秒数，默认 90
--proxy URL HTTP/SOCKS 下载代理
安装 ffmpeg 并确认它在 PATH 中。CLI 需要它生成播放器兼容的最终文件，不能简单地把 DASH 分段改扩展名。
先确认链接在浏览器中可以播放；若是会员、地区限制或登录可见内容，配置包含 SESSDATA 的有效 Cookie 后重试。Cookie 过期时请从已登录浏览器重新导出。
可增加超时，或使用代理：
pika download 'BV1Rc1gBaERq' \
--timeout 180 \
--proxy http://127.0.0.1:7890 \
-o ./music下载结束后，可用 ffprobe 检查容器和音频编码：
ffprobe -v error \
-show_entries format=format_name,duration \
-show_entries stream=codec_name \
-of default=noprint_wrappers=1 \
'./music/下载后的文件.m4a'正常的 AAC 输出通常会显示 codec_name=aac 和 format_name=mov,mp4,m4a,...。
需要 Go 1.26+。克隆后即可独立构建：
git clone https://github.com/rccoder/Pika.git
cd Pika
go build -o bin/pika .
./bin/pika --help如需手动注入版本号：
go build -ldflags="-X main.version=v0.2.1" -o bin/pika .
./bin/pika --versionRelease 工作流会自动使用 Git 标签注入版本号。开发时也可直接执行 go run . download '周传雄 黄昏' -o ./music。检查代码：
go test ./...
go vet ./...
go build -o bin/pika .维护者推送版本标签后，Release 工作流自动测试并生成 macOS/Linux 的 amd64、arm64 压缩包和 SHA256SUMS，发布到 GitHub Releases：
git tag v0.1.0
git push origin v0.1.0后续版本使用新的标签，例如 v0.1.1；安装脚本默认跟随最新 Release。
感谢 MusicBot-Go 原项目及其作者、贡献者。本项目的 Bilibili、YouTube Music 平台解析、搜索与音频流获取，以及分片下载、重试和完整性校验等实现，源自 MusicBot-Go，并在此基础上整理为独立的命令行工具。原项目的工作为 Pika 提供了重要基础。
本项目包含并修改了 GPL-3.0 许可的 MusicBot-Go 相关实现，因此以 GPL-3.0 发布。