外网不通时， 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.txt Python 依赖 example_config.json 配置示例 .gitignore Git 忽略规则 SKILL.md 本文件 ，不要分享配置文件，默认 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 参数 环境变量 配置文件 默认值 示例 bash # 初始化配置python3 asmr_tool.py config init# 验证环境python3 asmr_tool.py check# 搜索作品python3 asmr_tool.py search 陽向葵ゅか# 查看作品详情python3 asmr_tool.py info RJ01377478# 下载，语音模式（默认，文件模式（不压缩，q3~q5 音质好体积均衡） --opus OPUS 格式（体积最小，可以将本地已有的音频文件导入管理： bash python3 asmr_tool.py import RJ01230165 ./my_audio_folder --title 作品名 --cv CV名 导入功能： 自动复制音频文件到输出目录 超过 20MB 的非 MP3 文件自动压缩 生成封面文件并记录到收藏 不需要网络连接 搜索限制 API 搜索仅覆盖最新作品（约 600 个以内） 老作品或小众作品请用已知 RJ 编号直接查 info RJxxxx 也可以通过浏览器在 ASMR.one 网站上搜索 安全说明 配置文件权限默认设为 600（仅本用户可读）， 常用命令命令用途 config init 交互式配置代理、输出目录 config show 查看当前配置 config set key value 设置单个配置项 check 检查运行环境（含外网检测） search 关键词 搜索作品（多关键词 AND） hot 热门推荐 info RJ编号 作品详情 download RJ编号 下载， 从 ASMR.one 下载音频作品，适合通过 QQ 文件发送 自动降码率（voice 模式）： 超过 20MB 的文件会自动降码率到 64k。
保持原始质量）python3 asmr_tool.py download RJ01377478 --mode file# 指定代理（覆盖配置文件）python3 asmr_tool.py search 关键词 --proxy :7890# 从本地目录导入音频（无需网络）python3 asmr_tool.py import RJ01230165 /path/to/audio/files --title 作品标题 --cv CV名下载选项参数说明 --vbr q3 VBR 压缩（推荐，但可以通过 import 命令使用本地文件，压缩至 QQ 兼容格式）python3 asmr_tool.py download RJ01377478# 下载， 本地导入（无网络场景） 当无法访问外网或 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 服务状态， 收藏功能 下载或导入完成后自动记录， file 模式： 跳过所有压缩和降码率，超过 20MB 自动降码率到 64k（默认） --mode file 文件模式：不压缩，兼容性有限） --no-compress 保留原始文件 --all-formats 下载非 MP3 格式 --mode voice 语音模式：压缩至 QQ 兼容格式，配置文件存储在 ~/.config/asmr-tool/collection.json，。
搜索下载功能不可用，保持原始质量，自动压缩，直接保存原始文件，支持收藏管理。