nbr
| Crates.io | nbr |
| lib.rs | nbr |
| version | 0.4.3 |
| created_at | 2025-08-13 04:42:02.785565+00 |
| updated_at | 2025-12-24 11:34:51.152676+00 |
| description | CLI for NoneBot2 - A Rust implementation |
| homepage | |
| repository | https://github.com/nonebot/nbr |
| max_upload_size | |
| id | 1793266 |
| size | 270,189 |
Les Freire (fllesser)
documentation
README
基于 uv 的 NoneBot 命令行工具，用于管理 NoneBot2 项目、插件和适配器。
注意：该项目仍在开发中，部分功能可能尚未完全实现。
🚀 特性
- 快速包管理：使用 uv 管理依赖
- 项目管理：初始化、创建和管理 NoneBot2 项目
- 插件管理：安装、卸载和更新 NoneBot2 插件
- 适配器管理：管理 NoneBot2 适配器
- 环境检查：验证 Nonebot2 环境
- 兼容性：兼容 nb-cli, 不会破坏原有结构
📋 先决条件
必需
- uv (0.9.0+) - 用于 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 --create-venv 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
🤝 贡献
- Fork 仓库
- 创建一个功能分支 (
git checkout -b feature/amazing-feature) - 进行修改
- 运行测试 (
cargo test) - 提交修改 (
git commit -m 'Add amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 打开一个 Pull Request
📝 许可证
这个项目使用 MIT 许可证 - 详情请参阅 LICENSE 文件
🙏 致谢
📞 支持
- Issues: GitHub Issues
- NoneBot Community: NoneBot Documentation
注意: 这是一个 Rust 实现的 NoneBot CLI。对于原始的 Python 版本，请参阅 官方 NoneBot CLI。