# 163music-downloader

**Repository Path**: jiusem/163music-downloader

## Basic Information

- **Project Name**: 163music-downloader
- **Description**: 网易云音乐web端工具，可以将正在播放的音乐保存到本地。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-05
- **Last Updated**: 2026-04-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网易云音乐下载器 - Chrome 插件

## 安装步骤

1. 打开 Chrome 浏览器
2. 访问 `chrome://extensions/`
3. 右上角开启 **"开发者模式"**
4. 点击 **"加载已解压的扩展程序"**
5. 选择 `163music-downloader` 文件夹
6. 插件安装成功

## 使用方法

1. 打开网易云音乐网站：https://music.163.com/
2. 播放任意歌曲
3. 点击浏览器右上角的插件图标
4. 在弹窗中点击 **"下载"** 按钮
5. 选择保存位置即可

## 功能说明

- **自动监听**：插件会自动监听当前播放歌曲的音频请求
- **支持格式**：MP3 和 M4A 格式
- **原始文件名**：下载时使用服务器返回的原始文件名
- **资源列表**：弹窗中显示最近捕获的 20 个音频资源
- **自动清理**：超过 10 分钟的资源会自动清理

## 注意事项

1. **仅限个人使用**：请尊重音乐版权，下载内容仅限个人学习使用
2. **音质说明**：下载音质取决于网易云音乐服务器返回的资源，部分歌曲可能需要 VIP
3. **播放后才可下载**：需要先播放歌曲，插件才能捕获到音频流
4. **单页应用**：网易云音乐是单页应用，切换歌曲时无需刷新页面

## 文件结构

```
163music-downloader/
├── manifest.json      # 插件配置文件
├── background.js      # 后台服务脚本（监听网络请求）
├── content.js         # 内容脚本（获取播放信息）
├── popup.html         # 弹窗页面
├── popup.js           # 弹窗逻辑
└── icons/             # 图标文件夹
    ├── icon16.png
    ├── icon48.png
    └── icon128.png
```

## 故障排除

**问题：弹窗显示"暂无可下载资源"**
- 确保已在网易云音乐网站播放歌曲
- 点击弹窗右上角的"刷新"按钮
- 检查浏览器控制台是否有错误信息

**问题：下载失败**
- 检查 Chrome 是否允许下载权限
- 确认网络连接正常
- 某些歌曲可能有时效性限制，请尽快下载

**问题：插件图标不显示**
- 确认 `icons` 文件夹中有 3 个 PNG 图标文件
- 重新加载插件（在 `chrome://extensions/` 中点击刷新按钮）

## 技术说明

- **Manifest V3**：使用最新的 Chrome 扩展标准
- **webRequest API**：监听和拦截网络请求
- **downloads API**：调用 Chrome 原生下载功能
- **storage API**：临时存储捕获的音频资源

## 更新日志

**v1.0.0**
- 初始版本发布
- 支持 MP3/M4A 格式监听
- 支持当前播放歌曲下载
- 弹窗式用户界面