ASMR.one 音频下载器

从 ASMR.one 下载音频作品，自动压缩，并生成发送列表。使用场景：下载 RJ 编号的 ASMR 音频。

Install

openclaw skills install asmrone-downloader

ASMR.one 下载器

从 ASMR.one 下载音频作品，自动压缩，支持收藏管理。

完整工作流

配置环境 → 验证环境 → 搜索/推荐 → 下载压缩 → 收藏记录
无网络时 → 导入本地音频 → 压缩 → 收藏

快速安装

# 1. 安装依赖
pip3 install requests

# 2. 安装 ffmpeg（用于压缩）
# Ubuntu/Debian:
sudo apt install ffmpeg
# macOS:
brew install ffmpeg

# 3. 配置初始化
python3 asmr_tool.py config init

环境验证

python3 asmr_tool.py check

输出示例：

  [Python]    ✅ 3.12.3
  [requests]  ✅ 2.31.0
  [ffmpeg]    ✅ ffmpeg version 6.1.1
  [ffprobe]   ✅ ffprobe version 6.1.1
  [网络]
   外网: ✅
   ASMR.one: ✅
  [配置]      ✅ 配置文件已存在

网络检查会同时检测外网连通性和 ASMR.one 服务状态。外网不通时，搜索下载功能不可用，但可以通过 import 命令使用本地文件。

常用命令

命令	用途
`config init`	交互式配置代理、输出目录
`config show`	查看当前配置
`config set key value`	设置单个配置项
`check`	检查运行环境（含外网检测）
`search 关键词`	搜索作品（多关键词 AND）
`hot`	热门推荐
`info RJ编号`	作品详情
`download RJ编号`	下载，默认 voice 模式压缩至 QQ 兼容格式
`import RJ编号目录`	从本地目录导入已有音频文件
`sendlist RJ编号`	列出已下载文件
`collection`	查看收藏列表

配置项说明

配置项	含义	环境变量
`proxy`	代理地址	`ASMR_PROXY`
`output_dir`	下载目录	`ASMR_OUTPUT_DIR`
`default_vbr`	默认 VBR 质量 (q0~q9)	`ASMR_VBR`
`default_bitrate`	默认比特率	`ASMR_BITRATE`
`qq_target`	QQ Bot 发送目标	`QQ_TARGET`

配置优先级： CLI 参数 > 环境变量 > 配置文件 > 默认值

示例

# 初始化配置
python3 asmr_tool.py config init

# 验证环境
python3 asmr_tool.py check

# 搜索作品
python3 asmr_tool.py search "陽向葵ゅか"

# 查看作品详情
python3 asmr_tool.py info RJ01377478

# 下载，语音模式（默认，压缩至 QQ 兼容格式）
python3 asmr_tool.py download RJ01377478

# 下载，文件模式（不压缩，保持原始质量）
python3 asmr_tool.py download RJ01377478 --mode file

# 指定代理（覆盖配置文件）
python3 asmr_tool.py search "关键词" --proxy http://127.0.0.1:7890

# 从本地目录导入音频（无需网络）
python3 asmr_tool.py import RJ01230165 /path/to/audio/files --title "作品标题" --cv "CV名"

下载选项

参数	说明
`--vbr q3`	VBR 压缩（推荐，q3~q5 音质好体积均衡）
`--opus`	OPUS 格式（体积最小，兼容性有限）
`--no-compress`	保留原始文件
`--all-formats`	下载非 MP3 格式
`--mode voice`	语音模式：压缩至 QQ 兼容格式，超过 20MB 自动降码率到 64k（默认）
`--mode file`	文件模式：不压缩，保持原始质量，适合通过 QQ 文件发送

自动降码率（voice 模式）： 超过 20MB 的文件会自动降码率到 64k。 file 模式： 跳过所有压缩和降码率，直接保存原始文件。

本地导入（无网络场景）

当无法访问外网或 ASMR.one 时，可以将本地已有的音频文件导入管理：

python3 asmr_tool.py import RJ01230165 ./my_audio_folder --title "作品名" --cv "CV名"

导入功能：

自动复制音频文件到输出目录
超过 20MB 的非 MP3 文件自动压缩
生成封面文件并记录到收藏
不需要网络连接

搜索限制

API 搜索仅覆盖最新作品（约 600 个以内）
老作品或小众作品请用已知 RJ 编号直接查 info RJxxxx
也可以通过浏览器在 ASMR.one 网站上搜索

安全说明

配置文件权限默认设为 600（仅本用户可读），不要分享配置文件。

收藏功能

下载或导入完成后自动记录。配置文件存储在 ~/.config/asmr-tool/collection.json。

python3 asmr_tool.py collection          # 列表
python3 asmr_tool.py collection --detail # 详细信息

目录结构

~/.config/asmr-tool/          # 配置文件目录
├── config.json               # 代理、输出目录等配置（权限 600）
└── collection.json           # 收藏记录

~/asmr_downloads/             # 默认下载目录
└── RJxxxxxx/
    ├── RJxxxxxx_001_音轨.mp3
    ├── RJxxxxxx_002_音轨.mp3
    ├── raw/                   # 原始文件（压缩后保留）
    └── manifest.json         # 下载清单

文件说明

文件	说明
`scripts/asmr_tool.py`	主工具
`requirements.txt`	Python 依赖
`example_config.json`	配置示例
`.gitignore`	Git 忽略规则
`SKILL.md`	本文件