mirror of
https://github.com/nonebot/nonebot2.git
synced 2025-10-30 22:46:40 +00:00
🔖 Release 2.2.1
This commit is contained in:
noneflow[bot]
267
website/versioned_docs/version-2.2.1/tutorial/store.mdx
Normal file
267
website/versioned_docs/version-2.2.1/tutorial/store.mdx
Normal file
@@ -0,0 +1,267 @@
|
||||
---
|
||||
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>
|
||||
Reference in New Issue
Block a user