From e246a5f032669e47d5c889abdcb095864916c50b Mon Sep 17 00:00:00 2001 From: Nacho Date: Fri, 21 Jul 2023 22:49:51 +0800 Subject: [PATCH] Update README.md --- README.md | 79 +++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 59 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index d544d89..2163eba 100644 --- a/README.md +++ b/README.md @@ -28,28 +28,62 @@

-## 安装 -### 使用pip安装 -1.`pip install nonebot-plugin-ncm` 进行安装 -2.并在`bot.py`添加`nonebot.load_plugin('nonebot-plugin-ncm')` -### 使用nb-cli安装(推荐) -`nb plugin install nonebot-plugin-ncm` 进行安装 +## 安装 💿 + +
+使用 nb-cli 安装 +在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装 + + nb plugin install nonebot-plugin-ncm + 或者 + python -m nb_cli plugin install nonebot-plugin-ncm + +
+ +
+使用包管理器安装 +在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令 + +
+pip + + pip install nonebot-plugin-ncm +
+
+pdm + pdm add nonebot-plugin-ncm +
+
+poetry + + poetry add nonebot-plugin-ncm +
+ +打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分追加写入 + + plugins = ["nonebot-plugin-ncm"] + +
如果希望使用`nonebot2 a16`及以下版本 - 请使用`pip install nonebot-plugin-ncm==1.1.0`进行安装 + + pip install nonebot-plugin-ncm==1.1.0
-## 升级 -1.`pip install nonebot-plugin-ncm --upgrade` 进行升级 -2. 低于`1.5.0`版本升级请删除`db`文件夹内`ncm`开头文件 -3. 根据新的`config`项配置`.env`文件 -## 快速使用 +## 快速使用 ▶️ 将链接或者卡片分享到聊天群或机器人,回复分享的消息并输入`下载`即可进行下载 分享之后是没有反应的,只有对需要解析的消息回复`下载`才会响应 -**默认下载状态为关闭,请在每个群内使用`/ncm t`开启,私聊则默认开启** +**默认下载状态为关闭,请在每个群内使用`/ncm t`开启,私聊则默认开启** ![a1v9gk.png](https://files.catbox.moe/a1v9gk.png) -### 命令列表: + + +## 注意说明 ⚠️ +- 使用的网易云账号**需要拥有黑胶VIP** +- 默认下载最高音质的音乐,可以修改`ncm_bitrate`项更改音乐品质 +- 本程序实质为调用web接口下载音乐上传 + +### 命令列表 📃 | 命令 | 备注 | |--------------------|-----------| | /ncm | 获取命令菜单 | @@ -62,13 +96,18 @@ | /ncm private qq号 f | 关闭该用户私聊下载 | - 命令开始符号会自动识别[`COMMAND_START`](https://v2.nonebot.dev/docs/api/config#Config-command_start)项 -## 注意说明 -- 使用的网易云账号**需要拥有黑胶VIP** -- 默认下载最高音质的音乐 -- 本程序实质为调用web接口下载音乐上传 -## 配置文件说明 +## 配置文件说明 ⚙️ +| 配置项 | 必填 | 默认值 | 说明 | +|:-----:|:----:|:----:|:----:| +| ncm_admin_level | 否 | 1 | 设置命令权限(1:仅限superusers和群主,2:在1的基础上+管理员,3:所有用户) | +| ncm_ctcode | 否 | 86 | 手机号区域码 | +| ncm_phone | 是 | | 网易云绑定的手机号(留空则二维码登录) | +| ncm_password | 是 | | 网易云账号密码(留空则短信登录) | +| ncm_playlist_zip | 否 | False | 是否开启本地图片存储,True为开启本地图片存储 | +| ncm_bitrate | 否 | 320 | 下载码率(单位K) <=96: m4a, >=320:flac, 96< mp3 <320| ``` +# 这是示例 ncm_admin_level=1 # 设置命令权限(1:仅限superusers和群主,2:在1的基础上+管理员,3:所有用户) ncm_ctcode="86" # 手机号区域码,默认86 ncm_phone= # 手机登录 @@ -77,7 +116,7 @@ ncm_playlist_zip=False # 上传歌单时是否压缩 ncm_bitrate: int = 320 # 下载码率(单位K) 96及以下为m4a,320及以上为flac,中间mp3 ``` -## 功能列表 +## 功能列表 📃 - [x] 识别/下载 网易云单曲 - 链接 - 卡片