ASMR.one 下载器#

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

完整工作流#

text

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

---

快速安装#

bash

# 1. 安装依赖
pip3 install requests

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

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

---

---

环境验证#

bash

python3 asmr_tool.py check

输出示例：

text

  [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_targetQQ Bot 发送目标QQ_TARGET

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

---

示例#

bash

# 初始化配置
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 q3VBR 压缩（推荐，q3~q5 音质好体积均衡）--opusOPUS 格式（体积最小，兼容性有限）--no-compress保留原始文件--all-formats下载非 MP3 格式--mode voice语音模式：压缩至 QQ 兼容格式，超过 20MB 自动降码率到 64k（默认）--mode file文件模式：不压缩，保持原始质量，适合通过 QQ 文件发送

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

---

本地导入（无网络场景）#

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

bash

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。

bash

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

---

目录结构#

text

~/.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.txtPython 依赖example_config.json配置示例.gitignoreGit 忽略规则SKILL.md本文件