mirror of
https://github.com/nonebot/nonebot2.git
synced 2025-10-27 04:56:39 +00:00
268 lines
6.6 KiB
Plaintext
268 lines
6.6 KiB
Plaintext
---
|
|
sidebar_position: 2
|
|
description: 从商店安装适配器和插件
|
|
|
|
options:
|
|
menu:
|
|
- category: tutorial
|
|
weight: 40
|
|
---
|
|
|
|
# 获取商店内容
|
|
|
|
import Tabs from "@theme/Tabs";
|
|
import TabItem from "@theme/TabItem";
|
|
import Asciinema from "@site/src/components/Asciinema";
|
|
|
|
:::tip 提示
|
|
|
|
如果你暂时没有获取商店内容的需求，可以跳过本章节。
|
|
|
|
:::
|
|
|
|
NoneBot 提供了一个[商店](/store/plugins)，商店内容均由社区开发者贡献。你可以在商店中查找你需要的适配器和插件等，进行安装或者参考其文档等。
|
|
|
|
商店中每个内容的卡片都包含了其名称和简介等信息，点击**卡片右上角**链接图标即可跳转到其主页。
|
|
|
|
## 安装插件
|
|
|
|
<Asciinema
|
|
url="https://asciinema.org/a/569650.cast"
|
|
options={{ theme: "monokai", poster: "npt:16.8" }}
|
|
/>
|
|
|
|
在商店插件页面中，点击你需要安装的插件下方的 `点击复制安装命令` 按钮，即可复制 `nb-cli` 命令。
|
|
|
|
请在你的**项目目录**下执行该命令。`nb-cli` 会自动安装插件并将其添加到加载列表中。
|
|
|
|
<Tabs groupId="cli-install">
|
|
<TabItem value="cli" label="使用命令" default>
|
|
|
|
```bash
|
|
nb plugin install <插件名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="interactive" label="交互式安装">
|
|
|
|
```bash
|
|
$ nb plugin install
|
|
[?] 想要安装的插件名称: <插件名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="pip" label="使用 pip">
|
|
|
|
```bash
|
|
pip install <插件包名>
|
|
```
|
|
|
|
插件包名可以在商店插件卡片中找到，或者使用 `nb-cli` 搜索插件显示的详情中找到。安装完成后，需要参考[加载插件章节](./create-plugin.md#加载插件)自行加载。
|
|
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
如果想要查看插件列表，可以使用以下命令
|
|
|
|
```bash
|
|
# 列出商店所有插件
|
|
nb plugin list
|
|
# 搜索商店插件
|
|
nb plugin search [可选关键词]
|
|
```
|
|
|
|
升级和卸载插件可以使用以下命令
|
|
|
|
<Tabs groupId="cli-install">
|
|
<TabItem value="cli" label="使用命令" default>
|
|
|
|
```bash
|
|
nb plugin update <插件名称>
|
|
nb plugin uninstall <插件名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="interactive" label="交互式安装">
|
|
|
|
```bash
|
|
$ nb plugin update
|
|
[?] 想要安装的插件名称: <插件名称>
|
|
$ nb plugin uninstall
|
|
[?] 想要卸载的插件名称: <插件名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="pip" label="使用 pip">
|
|
|
|
```bash
|
|
pip install --upgrade <插件包名>
|
|
pip uninstall <插件包名>
|
|
```
|
|
|
|
插件包名可以在商店插件卡片中找到，或者使用 `nb-cli` 搜索插件显示的详情中找到。卸载完成后，需要自行移除插件加载。
|
|
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
## 安装适配器
|
|
|
|
<Asciinema
|
|
url="https://asciinema.org/a/569664.cast"
|
|
options={{ theme: "monokai", poster: "npt:12.0" }}
|
|
/>
|
|
|
|
安装适配器与安装插件类似，只是将命令换为 `nb adapter`，这里就不再赘述。
|
|
|
|
请在你的**项目目录**下执行该命令。`nb-cli` 会自动安装适配器并将其添加到注册列表中。
|
|
|
|
<Tabs groupId="cli-install">
|
|
<TabItem value="cli" label="使用命令" default>
|
|
|
|
```bash
|
|
nb adapter install <适配器名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="interactive" label="交互式安装">
|
|
|
|
```bash
|
|
$ nb adapter install
|
|
[?] 想要安装的适配器名称: <适配器名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="pip" label="使用 pip">
|
|
|
|
```bash
|
|
pip install <适配器包名>
|
|
```
|
|
|
|
适配器包名可以在商店适配器卡片中找到，或者使用 `nb-cli` 搜索适配器显示的详情中找到。安装完成后，需要参考[注册适配器章节](../advanced/adapter.md#注册适配器)自行注册。
|
|
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
如果想要查看适配器列表，可以使用以下命令
|
|
|
|
```bash
|
|
# 列出商店所有适配器
|
|
nb adapter list
|
|
# 搜索商店适配器
|
|
nb adapter search [可选关键词]
|
|
```
|
|
|
|
升级和卸载适配器可以使用以下命令
|
|
|
|
<Tabs groupId="cli-install">
|
|
<TabItem value="cli" label="使用命令" default>
|
|
|
|
```bash
|
|
nb adapter update <适配器名称>
|
|
nb adapter uninstall <适配器名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="interactive" label="交互式安装">
|
|
|
|
```bash
|
|
$ nb adapter update
|
|
[?] 想要安装的适配器名称: <适配器名称>
|
|
$ nb adapter uninstall
|
|
[?] 想要卸载的适配器名称: <适配器名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="pip" label="使用 pip">
|
|
|
|
```bash
|
|
pip install --upgrade <适配器包名>
|
|
pip uninstall <适配器包名>
|
|
```
|
|
|
|
适配器包名可以在商店适配器卡片中找到，或者使用 `nb-cli` 搜索适配器显示的详情中找到。卸载完成后，需要自行移除适配器加载。
|
|
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
## 安装驱动器
|
|
|
|
<Asciinema
|
|
url="https://asciinema.org/a/569665.cast"
|
|
options={{ theme: "monokai", poster: "npt:14.0" }}
|
|
/>
|
|
|
|
安装驱动器与安装插件同样类似，只是将命令换为 `nb driver`，这里就不再赘述。
|
|
|
|
如果你使用了虚拟环境，请在你的**项目目录**下执行该命令，`nb-cli` 会自动安装驱动器到虚拟环境中。
|
|
|
|
请注意 `nb-cli` 并不会在安装驱动器后修改项目所使用的驱动器，请自行参考[配置方法](../appendices/config.mdx)章节以及 [`DRIVER` 配置项](../appendices/config.mdx#driver)修改驱动器。
|
|
|
|
<Tabs groupId="cli-install">
|
|
<TabItem value="cli" label="使用命令" default>
|
|
|
|
```bash
|
|
nb driver install <驱动器名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="interactive" label="交互式安装">
|
|
|
|
```bash
|
|
$ nb driver install
|
|
[?] 想要安装的驱动器名称: <驱动器名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="pip" label="使用 pip">
|
|
|
|
```bash
|
|
pip install <驱动器包名>
|
|
```
|
|
|
|
驱动器包名可以在商店驱动器卡片中找到，或者使用 `nb-cli` 搜索驱动器显示的详情中找到。
|
|
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
如果想要查看驱动器列表，可以使用以下命令
|
|
|
|
```bash
|
|
# 列出商店所有驱动器
|
|
nb driver list
|
|
# 搜索商店驱动器
|
|
nb driver search [可选关键词]
|
|
```
|
|
|
|
升级和卸载驱动器可以使用以下命令
|
|
|
|
<Tabs groupId="cli-install">
|
|
<TabItem value="cli" label="使用命令" default>
|
|
|
|
```bash
|
|
nb driver update <驱动器名称>
|
|
nb driver uninstall <驱动器名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="interactive" label="交互式安装">
|
|
|
|
```bash
|
|
$ nb driver update
|
|
[?] 想要安装的驱动器名称: <驱动器名称>
|
|
$ nb driver uninstall
|
|
[?] 想要卸载的驱动器名称: <驱动器名称>
|
|
```
|
|
|
|
</TabItem>
|
|
<TabItem value="pip" label="使用 pip">
|
|
|
|
```bash
|
|
pip install --upgrade <驱动器包名>
|
|
pip uninstall <驱动器包名>
|
|
```
|
|
|
|
驱动器包名可以在商店驱动器卡片中找到，或者使用 `nb-cli` 搜索驱动器显示的详情中找到。卸载完成后，需要自行移除适配器加载。
|
|
|
|
</TabItem>
|
|
</Tabs>
|