#chat-bot #cli #nonebot

app nbr

CLI for NoneBot2 - A Rust implementation

41 releases

Uses new Rust 2024

0.3.14 Sep 10, 2025
0.3.13 Sep 8, 2025
0.3.11 Aug 31, 2025
0.2.7 Aug 25, 2025
0.1.18 Aug 19, 2025

#882 in Command line utilities

MIT license

175KB
4.5K SLoC

nbr

基于 uv 的 NoneBot 命令行工具,用于管理 NoneBot2 项目、插件和适配器。

注意:该项目仍在开发中,部分功能可能尚未完全实现。

🚀 特性

  • 快速包管理:使用 uv 管理依赖
  • 项目管理:初始化、创建和管理 NoneBot2 项目
  • 插件管理:安装、卸载和更新 NoneBot2 插件
  • 适配器管理:管理 NoneBot2 适配器
  • 环境检查:验证 Nonebot2 环境
  • 兼容性:兼容 nb-cli, 不会破坏原有结构

📋 先决条件

必需

  • uv (0.8.3+) - 用于 Python 依赖管理

安装 uv

使用 astral 官方安装脚本(推荐)
curl -LsSf https://astral.sh/uv/install.sh | sh

🛠 安装

使用 cargo 安装
cargo install nbr
从 releases 安装

仅支持 Linux(x86_64), MacOS(arm64) 和 Windows(x86_64)

Linux(x86_64) 安装
curl -Lf https://github.com/fllesser/nbr/releases/latest/download/nbr-Linux-musl-x86_64.tar.gz | tar -xzf - -C /usr/local/bin/ nbr && \
chmod +x /usr/local/bin/nbr
MacOS(arm64)

从 GitHub Releases 下载最新版本

curl -Lf https://github.com/fllesser/nbr/releases/latest/download/nbr-macOS-arm64.tar.gz | tar -xzf -

将二进制文件移动到 PATH

sudo mv nbr /Users/$USER/.local/bin/
Windows(x86_64)

从 GitHub Releases 下载最新版本

curl -LsSf https://github.com/fllesser/nbr/releases/latest/download/nbr-Windows-msvc-x86_64.zip | tar -xzf -

将二进制文件移动到 PATH

...
安装仓库最新分支
cargo install --git https://github.com/fllesser/nbr.git

📖 使用

项目管理

创建一个新的 NoneBot2 项目,选项 -p / --python 指定 Python 版本

nbr create

非询问式创建

nbr create awesome-bot -p 3.12 -t bootstrap --adapters "OneBot V11" --drivers fastapi,httpx,websockets --env dev --plugins echo --dev-tools ruff,basedpyright,pre-commit --gen-dockerfile true -f

运行 NoneBot2 项目,选项 -r / --reload 重新加载项目

nbr run
插件管理

安装一个插件

nbr plugin install nonebot-plugin-emojilike

安装一个插件,指定索引

nbr plugin install nonebot-plugin-emojilike --index https://pypi.org/simple/

从 github 仓库安装一个插件

nbr plugin install git+https://github.com/fllesser/nonebot-plugin-abs@master

卸载一个插件

nbr plugin uninstall nonebot-plugin-emojilike

更新一个插件,选项 -r / --reinstall 重新安装这个插件

nbr plugin update <plugin>

更新所有插件

nbr plugin update --all

列出所有已安装的插件,选项 --outdated 列出过时的插件

nbr plugin list
适配器管理

安装适配器

nbr adapter install

卸载适配器

nbr adapter uninstall

列出所有已安装的适配器,选项 -a / --all 列出所有已安装的适配器

nbr adapter list
环境管理

检查环境状态

nbr env check

打印环境信息

nbr env info

🤝 贡献

  1. Fork 仓库
  2. 创建一个功能分支 (git checkout -b feature/amazing-feature)
  3. 进行修改
  4. 运行测试 (cargo test)
  5. 提交修改 (git commit -m 'Add amazing feature')
  6. 推送到分支 (git push origin feature/amazing-feature)
  7. 打开一个 Pull Request

📝 许可证

这个项目使用 MIT 许可证 - 详情请参阅 LICENSE 文件

🙏 致谢

  • NoneBot2 - NoneBot2 框架
  • uv - Python 依赖管理工具

📞 支持


注意: 这是一个 Rust 实现的 NoneBot CLI。对于原始的 Python 版本,请参阅 官方 NoneBot CLI

Dependencies

~18–36MB
~464K SLoC