nonebot/nb-cli repository overview

⁠ ⁠ ⁠ ⁠ ⁠
⁠ ⁠ ⁠ ⁠

文档⁠ · 安装⁠ · NoneBot 文档⁠

⁠功能

• 创建新的 Nonebot 项目
• 启动 Nonebot
• 管理插件
  • 创建新的插件
  • 搜索/安装/更新/卸载在官方商店上发布的插件
• 管理适配器
  • 创建新的适配器
  • 搜索/安装/更新/卸载在官方商店上发布的适配器
• 管理驱动器
  • 搜索/安装/更新/卸载在官方商店上发布的驱动器
• 支持 CLI 插件和运行脚本

⁠使用

完整使用文档请参考 文档⁠。

⁠安装

⁠使用 pipx 安装

pipx install nb-cli

⁠使用 uv 安装

uv tool install nb-cli@latest
uv tool update-shell

其中 latest 可以更改为指定的 CLI 版本

⁠使用 Docker 安装

docker pull nonebot/nb-cli:latest

Docker 镜像可以选择以下版本：

• latest, latest-slim：最新的稳定版本
• latest-${python版本}, latest-${python版本}-slim：指定 Python 版本的最新稳定版本
• ${cli版本}, ${cli版本}-slim：指定 CLI 版本的最新稳定版本
• ${cli版本}-${python版本}, ${cli版本}-${python版本}-slim：指定 CLI 和 Python 版本的最新稳定版本

⁠命令行使用

nb --help

• nb create (init) 创建新的 NoneBot 项目
• nb run 在当前目录启动 NoneBot
• nb generate 在当前目录生成启动脚本
• nb driver 管理驱动器
• nb plugin 管理插件
• nb adapter 管理适配器
• nb self 管理 CLI 内部环境
• nb <script> 运行脚本

⁠uv tool 使用

uvx --from nb-cli@latest nb --help

⁠Docker 镜像使用

docker run --rm -it -v ./:/workspaces nonebot/nb-cli:latest --help

挂载当前目录到容器的 /workspaces 目录，然后在容器中运行 nb 命令。

⁠交互式使用

nb

⁠uv tool 使用

uvx --from nb-cli@latest nb
# 或
uv tool run --from nb-cli nb

⁠Docker 镜像使用

docker run --rm -it -v ./:/workspaces nonebot/nb-cli:latest

⁠开发

⁠翻译

生成模板

pdm run extract

初始化语言翻译文件或者更新现有语言翻译文件

pdm run init en_US

更新语言翻译文件

pdm run update

编译语言翻译文件

pdm run compile