From 2945a9b975b0abfe19c2f801e2a9db591ea063e0 Mon Sep 17 00:00:00 2001
From: worldmozara <worldmozara@163.com>
Date: Sat, 24 Jan 2026 15:48:16 +0000
Subject: [PATCH 1/3] :memo: add usage for `uv tool` / `uvx`

---
 README.md | 32 ++++++++++++++++++++++++++++----
 1 file changed, 28 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 6f19d3f9..eae905df 100644
--- a/README.md
+++ b/README.md
@@ -68,13 +68,21 @@ _✨ NoneBot2 命令行工具 ✨_
 
 ### 安装
 
-使用 pipx 安装
+#### 使用 pipx 安装
 
 ```shell
 pipx install nb-cli
 ```
 
-使用 Docker 运行
+#### 使用 uv 安装
+
+```shell
+uv tool install nb-cli@latest
+```
+
+其中 `latest` 可以更改为指定的 CLI 版本
+
+#### 使用 Docker 安装
 
 ```shell
 docker pull nonebot/nb-cli:latest
@@ -106,7 +114,15 @@ nb --help
 - `nb self` 管理 CLI 内部环境
 - `nb <script>` 运行脚本
 
-Docker 镜像使用
+#### uv tool 使用
+
+```shell
+uvx --from nb-cli@latest nb --help
+# 或
+uv tool run --from nb-cli nb --help
+```
+
+#### Docker 镜像使用
 
 ```shell
 docker run --rm -it -v ./:/workspaces nonebot/nb-cli:latest --help
@@ -120,7 +136,15 @@ docker run --rm -it -v ./:/workspaces nonebot/nb-cli:latest --help
 nb
 ```
 
-Docker 镜像使用
+#### uv tool 使用
+
+```shell
+uvx --from nb-cli@latest nb
+# 或
+uv tool run --from nb-cli nb
+```
+
+#### Docker 镜像使用
 
 ```shell
 docker run --rm -it -v ./:/workspaces nonebot/nb-cli:latest

From ec08e99ef099bff563fb125026f7a2ef13607fac Mon Sep 17 00:00:00 2001
From: worldmozara <worldmozara@163.com>
Date: Sat, 24 Jan 2026 16:03:07 +0000
Subject: [PATCH 2/3] :memo: add installation guide of uv tool

---
 website/docs/guide/installation.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/website/docs/guide/installation.md b/website/docs/guide/installation.md
index c422437c..4a20b06e 100644
--- a/website/docs/guide/installation.md
+++ b/website/docs/guide/installation.md
@@ -31,3 +31,31 @@ pipx upgrade nb-cli
 ```shell title="卸载 NoneBot CLI"
 pipx uninstall nb-cli
 ```
+
+## 通过 uv tool 安装
+
+uv (by Astral) 是一个飞快的 Python 包与项目管理器，使用 Rust 语言编写。其也拥有工具集成管理的功能。
+
+请参考 [uv 文档](https://docs.astral.sh/uv/getting-started/installation/) 来安装 uv。
+
+```shell title="直接运行最新 NoneBot CLI"
+uvx --from nb-cli@latest nb
+```
+
+```shell title="安装 NoneBot CLI"
+uv tool install nb-cli@latest
+```
+
+```shell title="运行已安装的 NoneBot CLI"
+uvx --from nb-cli nb
+# 或
+uv tool run --from nb-cli nb
+```
+
+```shell title="升级 NoneBot CLI"
+uv tool upgrade nb-cli
+```
+
+```shell title="卸载 NoneBot CLI"
+uv tool uninstall nb-cli
+```

From eafae71e3c82ae36807882e7698e8a39bf82e141 Mon Sep 17 00:00:00 2001
From: worldmozara <worldmozara@163.com>
Date: Sat, 24 Jan 2026 16:19:05 +0000
Subject: [PATCH 3/3] :memo: add descriptions for specifying python version

---
 website/docs/guide/installation.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/website/docs/guide/installation.md b/website/docs/guide/installation.md
index 4a20b06e..bf78bea1 100644
--- a/website/docs/guide/installation.md
+++ b/website/docs/guide/installation.md
@@ -40,10 +40,16 @@ uv (by Astral) 是一个飞快的 Python 包与项目管理器，使用 Rust 语
 
 ```shell title="直接运行最新 NoneBot CLI"
 uvx --from nb-cli@latest nb
+
+# 指定 Python 版本（如 3.12）
+uvx -p 3.12 --from nb-cli@latest nb
 ```
 
 ```shell title="安装 NoneBot CLI"
 uv tool install nb-cli@latest
+
+# 指定 Python 版本（如 3.12）
+uv tool install -p 3.12 nb-cli@latest
 ```
 
 ```shell title="运行已安装的 NoneBot CLI"