更新文档，新增系统包管理器安装途径 by LIghtJUNction · Pull Request #4879 · AstrBotDevs/AstrBot

LIghtJUNction · 2026-02-05T06:56:31Z

…nguages

Modifications / 改动点

修改了README

This is NOT a breaking change. / 这不是一个破坏性变更。

Screenshots or Test Results / 运行截图或测试结果

Checklist / 检查清单

😊 如果 PR 中有新加入的功能，已经通过 Issue / 邮件等方式和作者讨论过。/ If there are new features added in the PR, I have discussed it with the authors through issues/emails, etc.
👀 我的更改经过了良好的测试，并已在上方提供了“验证步骤”和“运行截图”。/ My changes have been well-tested, and "Verification Steps" and "Screenshots" have been provided above.
🤓 我确保没有引入新依赖库，或者引入了新依赖库的同时将其添加到了 requirements.txt 和 pyproject.toml 文件相应位置。/ I have ensured that no new dependencies are introduced, OR if new dependencies are introduced, they have been added to the appropriate locations in requirements.txt and pyproject.toml.
😮 我的更改没有引入恶意代码。/ My changes do not introduce malicious code.

由 Sourcery 提供的总结

在所有语言版本的 README 中补充 AstrBot 的其他安装选项说明。

文档更新：

在所有语言的 README 文件中，将 uv 部署说明从 uvx astrbot 更新为 uv tool install astrbot。
在所有语言版本的 README 中新增使用系统包管理器进行安装的说明，包括通过 yay 或 paru 使用 Arch Linux AUR 进行安装。

Original summary in English

Summary by Sourcery

Document additional installation options for AstrBot across all language READMEs.

Documentation:

Update uv deployment instructions to use uv tool install astrbot instead of uvx astrbot in all language README files.
Add system package manager installation instructions, including Arch Linux AUR usage via yay or paru, to all language README variants.

…nguages

sourcery-ai

Hey - 我发现了 3 个问题，并给出了一些整体性的反馈：

之前 README 使用的是 uvx astrbot，它会同时安装并运行该工具；在改成 uv tool install astrbot 之后，建议在后面补充一小段说明或命令，告诉用户在安装完成后应该如何实际调用 astrbot，以避免用户困惑。
在新的系统包管理器章节中，存在一个拼写错误以及一些不一致的地方（例如 README.md 中的 # debain系，暂不支持，以及各语言版本中围绕 Debian/Arch 的空格用法不一致）；建议修正拼写，并在所有本地化的 README 中统一发行版名称的用词和格式。

给 AI Agent 的提示

请根据这次代码评审中的评论进行修改：

## 整体评论
- 之前 README 使用的是 `uvx astrbot`，它会同时安装并运行该工具；在改成 `uv tool install astrbot` 之后，建议在后面补充一小段说明或命令，告诉用户在安装完成后应该如何实际调用 `astrbot`，以避免用户困惑。
- 在新的系统包管理器章节中，存在一个拼写错误以及一些不一致的地方（例如 README.md 中的 `# debain系，暂不支持`，以及各语言版本中围绕 `Debian`/`Arch` 的空格用法不一致）；建议修正拼写，并在所有本地化的 README 中统一发行版名称的用词和格式。

## 单独评论

### Comment 1
<location> `README.md:86-97` </location>
<code_context>
+#### 系统包管理器安装
+
+```bash
+# windows & macos
+# 推荐使用uv tool install
+
+# linux
+# debain系，暂不支持
+# arch系，可通过aur安装
+yay -S astrbot-git
+# 或者使用paru
</code_context>

<issue_to_address>
**suggestion (typo):** 修正 "debian" 的拼写，并将操作系统/发行版名称以及 AUR 首字母大写。

在这一段中，请做如下修改：
- "windows & macos" → "Windows & macOS"
- "linux" → "Linux"
- "debain系" → "debian系"（或 "Debian 系"）
- "aur" → "AUR"

```suggestion
```bash
# Windows & macOS
# 推荐使用uv tool install

# Linux
# Debian 系，暂不支持
# Arch 系，可通过 AUR 安装
yay -S astrbot-git
# 或者使用 paru
paru -S astrbot-git

```
```
</issue_to_address>

### Comment 2
<location> `README_fr.md:70-75` </location>
<code_context>
+#### 系统包管理器安装
+
+```bash
+# windows & macos
+# 推荐使用uv tool install
+
</code_context>

<issue_to_address>
**suggestion (typo):** 在法文文本中对操作系统和发行版名称使用标准的大写形式。

请将以下专有名词首字母大写：
- "windows & macos" → "Windows & macOS"
- "linux" → "Linux"
- "basé sur debian" → "basé sur Debian"
- "basé sur arch" → "basé sur Arch"

建议实现：

```
# Windows & macOS

```

在这个代码片段中我只看到包含 "windows & macos" 的那一行。要完全应用此评论，还需要在整个 README_fr.md 中查找并替换：
- 将 "linux" 替换为 "Linux"（在句子中保持合适的大小写），
- 将 "basé sur debian" 替换为 "basé sur Debian"，
- 将 "basé sur arch" 替换为 "basé sur Arch"。
</issue_to_address>

### Comment 3
<location> `README_ja.md:70-75` </location>
<code_context>
+#### 系统包管理器安装
+
+```bash
+# windows & macos
+# 推荐使用uv tool install
+
</code_context>

<issue_to_address>
**suggestion (typo):** 请在日文代码片段中将操作系统和发行版名称首字母大写。

在此代码块中，请做如下修改：
- "windows & macos" → "Windows & macOS"
- "linux" → "Linux"
- "debian系" → "Debian 系"
- "arch系" → "Arch 系"

建议实现：

```
# Windows & macOS
# uv tool install の使用を推奨します

```

对于同一文件中其他日文代码片段里的操作系统 / 发行版名称，也请按如下方式替换（在相应的注释或行出现的位置分别进行 SEARCH/REPLACE）：

1. `linux` → `Linux`（例: `# linux` → `# Linux`）
2. `debian系` → `Debian 系`（例: `# debian系` → `# Debian 系`）
3. `arch系` → `Arch 系`（例: `# arch系` → `# Arch 系`）

请根据各实际行的内容，添加对应的 `<<<<<<< SEARCH / ======= / >>>>>>> REPLACE` 块，并确保反映正确的大写形式和半角空格。
</issue_to_address>

Sourcery 对开源项目免费——如果你觉得这些评审有帮助，欢迎分享 ✨

_{帮我变得更有用！请在每条评论上点击 👍 或 👎，你的反馈将帮助我改进评审质量。}

Original comment in English

Hey - I've found 3 issues, and left some high level feedback:

Previously the README used uvx astrbot which both installed and ran the tool; after switching to uv tool install astrbot it would be helpful to add a short note or command showing how to actually invoke astrbot after installation to avoid confusion for users.
In the new system package manager section, there is a typo and some inconsistency (e.g., # debain系，暂不支持 in README.md and mixed spacing around Debian/Arch across languages); consider fixing the spelling and normalizing the wording/formatting for distribution names in all localized READMEs.

Prompt for AI Agents

Please address the comments from this code review:

## Overall Comments
- Previously the README used `uvx astrbot` which both installed and ran the tool; after switching to `uv tool install astrbot` it would be helpful to add a short note or command showing how to actually invoke `astrbot` after installation to avoid confusion for users.
- In the new system package manager section, there is a typo and some inconsistency (e.g., `# debain系，暂不支持` in README.md and mixed spacing around `Debian`/`Arch` across languages); consider fixing the spelling and normalizing the wording/formatting for distribution names in all localized READMEs.

## Individual Comments

### Comment 1
<location> `README.md:86-97` </location>
<code_context>
+#### 系统包管理器安装
+
+```bash
+# windows & macos
+# 推荐使用uv tool install
+
+# linux
+# debain系，暂不支持
+# arch系，可通过aur安装
+yay -S astrbot-git
+# 或者使用paru
</code_context>

<issue_to_address>
**suggestion (typo):** Fix spelling of "debian" and capitalize OS/distribution names and AUR.

In this block, please change:
- "windows & macos" → "Windows & macOS"
- "linux" → "Linux"
- "debain系" → "debian系" (or "Debian 系")
- "aur" → "AUR"

```suggestion
```bash
# Windows & macOS
# 推荐使用uv tool install

# Linux
# Debian 系，暂不支持
# Arch 系，可通过 AUR 安装
yay -S astrbot-git
# 或者使用 paru
paru -S astrbot-git

```
```
</issue_to_address>

### Comment 2
<location> `README_fr.md:70-75` </location>
<code_context>
+#### 系统包管理器安装
+
+```bash
+# windows & macos
+# 推荐使用uv tool install
+
</code_context>

<issue_to_address>
**suggestion (typo):** Use standard capitalization for OS and distribution names in French text.

Capitalize the proper names here:
- "windows & macos" → "Windows & macOS"
- "linux" → "Linux"
- "basé sur debian" → "basé sur Debian"
- "basé sur arch" → "basé sur Arch"

Suggested implementation:

```
# Windows & macOS

```

Je ne vois dans l'extrait que la ligne contenant "windows & macos". Pour appliquer complètement votre commentaire, il faudra aussi rechercher dans tout le fichier README_fr.md et remplacer :
- "linux" par "Linux" (en conservant la casse appropriée dans les phrases),
- "basé sur debian" par "basé sur Debian",
- "basé sur arch" par "basé sur Arch".
</issue_to_address>

### Comment 3
<location> `README_ja.md:70-75` </location>
<code_context>
+#### 系统包管理器安装
+
+```bash
+# windows & macos
+# 推荐使用uv tool install
+
</code_context>

<issue_to_address>
**suggestion (typo):** Capitalize OS and distribution names inside the Japanese snippet.

In this code block, please change:
- "windows & macos" → "Windows & macOS"
- "linux" → "Linux"
- "debian系" → "Debian 系"
- "arch系" → "Arch 系"

Suggested implementation:

```
# Windows & macOS
# uv tool install の使用を推奨します

```

同じファイル内の日本語スニペットにある他の OS / ディストリビューション名についても、以下のように置き換えてください（該当するコメントや行が存在する箇所でそれぞれ SEARCH/REPLACE を行ってください）:

1. `linux` → `Linux`（例: `# linux` → `# Linux`）
2. `debian系` → `Debian 系`（例: `# debian系` → `# Debian 系`）
3. `arch系` → `Arch 系`（例: `# arch系` → `# Arch 系`）

それぞれ実際の行内容に合わせて、大文字小文字と半角スペースを反映した形で `<<<<<<< SEARCH / ======= / >>>>>>> REPLACE` ブロックを追加してください。
</issue_to_address>

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}

README.md

sourcery-ai · 2026-02-05T06:58:09Z

README_fr.md

+# windows & macos
+# Recommandé d'utiliser uv tool install
+
+# linux
+# basé sur debian, pas encore supporté
+# basé sur arch, peut être installé via AUR


suggestion (typo): 在法文文本中对操作系统和发行版名称使用标准的大写形式。

请将以下专有名词首字母大写：

"windows & macos" → "Windows & macOS"

"linux" → "Linux"

"basé sur debian" → "basé sur Debian"

"basé sur arch" → "basé sur Arch"

建议实现：

# Windows & macOS

在这个代码片段中我只看到包含 "windows & macos" 的那一行。要完全应用此评论，还需要在整个 README_fr.md 中查找并替换：

将 "linux" 替换为 "Linux"（在句子中保持合适的大小写），

将 "basé sur debian" 替换为 "basé sur Debian"，

将 "basé sur arch" 替换为 "basé sur Arch"。

Original comment in English

suggestion (typo): Use standard capitalization for OS and distribution names in French text.

Capitalize the proper names here:

"windows & macos" → "Windows & macOS"

"linux" → "Linux"

"basé sur debian" → "basé sur Debian"

"basé sur arch" → "basé sur Arch"

Suggested implementation:

# Windows & macOS

Je ne vois dans l'extrait que la ligne contenant "windows & macos". Pour appliquer complètement votre commentaire, il faudra aussi rechercher dans tout le fichier README_fr.md et remplacer :

"linux" par "Linux" (en conservant la casse appropriée dans les phrases),

"basé sur debian" par "basé sur Debian",

"basé sur arch" par "basé sur Arch".

sourcery-ai · 2026-02-05T06:58:09Z

README_ja.md

+# windows & macos
+# uv tool install の使用を推奨します
+
+# linux
+# debian系、現在未対応
+# arch系、AUR経由でインストール可能


suggestion (typo): 请在日文代码片段中将操作系统和发行版名称首字母大写。

在此代码块中，请做如下修改：

"windows & macos" → "Windows & macOS"

"linux" → "Linux"

"debian系" → "Debian 系"

"arch系" → "Arch 系"

建议实现：

# Windows & macOS # uv tool install の使用を推奨します

对于同一文件中其他日文代码片段里的操作系统 / 发行版名称，也请按如下方式替换（在相应的注释或行出现的位置分别进行 SEARCH/REPLACE）：

linux → Linux（例: # linux → # Linux）

debian系 → Debian 系（例: # debian系 → # Debian 系）

arch系 → Arch 系（例: # arch系 → # Arch 系）

请根据各实际行的内容，添加对应的 <<<<<<< SEARCH / ======= / >>>>>>> REPLACE 块，并确保反映正确的大写形式和半角空格。

Original comment in English

suggestion (typo): Capitalize OS and distribution names inside the Japanese snippet.

In this code block, please change:

"windows & macos" → "Windows & macOS"

"linux" → "Linux"

"debian系" → "Debian 系"

"arch系" → "Arch 系"

Suggested implementation:

# Windows & macOS # uv tool install の使用を推奨します

同じファイル内の日本語スニペットにある他の OS / ディストリビューション名についても、以下のように置き換えてください（該当するコメントや行が存在する箇所でそれぞれ SEARCH/REPLACE を行ってください）:

linux → Linux（例: # linux → # Linux）

debian系 → Debian 系（例: # debian系 → # Debian 系）

arch系 → Arch 系（例: # arch系 → # Arch 系）

それぞれ実際の行内容に合わせて、大文字小文字と半角スペースを反映した形で <<<<<<< SEARCH / ======= / >>>>>>> REPLACE ブロックを追加してください。

Copilot

Pull request overview

This PR updates the installation documentation across all language versions (Chinese, English, Traditional Chinese, Japanese, French, and Russian) to add a new installation method via system package managers. The update changes the uv deployment command from uvx astrbot to uv tool install astrbot and adds a new section for system package manager installation, specifically documenting AUR installation for Arch Linux users.

Changes:

Updated uv deployment command from uvx astrbot to uv tool install astrbot across all README files
Added new "System Package Manager Installation" section documenting AUR installation for Arch Linux
Removed trailing blank lines at the end of some README files for consistency

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
README.md	Updated uv command and added system package manager installation section (Chinese)
README_en.md	Updated uv command and added system package manager installation section (English)
README_zh-TW.md	Updated uv command and added system package manager installation section (Traditional Chinese)
README_ja.md	Updated uv command and added system package manager installation section (Japanese)
README_fr.md	Updated uv command and added system package manager installation section (French)
README_ru.md	Updated uv command and added system package manager installation section (Russian)

Copilot · 2026-02-05T06:58:44Z

README.md

+# 推荐使用uv tool install
+
+# linux
+# debain系，暂不支持


Spelling error: "debain" should be "debian". This affects the accuracy of the technical documentation.

Suggested change

# debain系，暂不支持

# debian系，暂不支持

README.md

Copilot · 2026-02-05T06:58:45Z

README.md

+
+# linux
+# debain系，暂不支持
+# arch系，可通过aur安装


Inconsistent spacing: "可通过aur安装" is missing spaces around "aur". It should be "可通过 AUR 安装" for better readability and consistency with other language versions (which use "AUR" in uppercase).

Suggested change

# arch系，可通过aur安装

# arch系，可通过 AUR 安装

Soulter · 2026-02-05T07:41:22Z

README.md

+# 推荐使用uv tool install
+
+# linux
+# debain系，暂不支持


nitpick: typo

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com>

docs: sync system package manager installation instructions to all la…

9189c92

…nguages

Copilot AI review requested due to automatic review settings February 5, 2026 06:56

dosubot bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Feb 5, 2026

Copilot started reviewing on behalf of LIghtJUNction February 5, 2026 06:56 View session

sourcery-ai bot reviewed Feb 5, 2026

View reviewed changes

Copilot AI reviewed Feb 5, 2026

View reviewed changes

Soulter reviewed Feb 5, 2026

View reviewed changes

LIghtJUNction and others added 4 commits February 5, 2026 17:31

Update README.md

3da9045

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update README.md

322e4f8

Co-authored-by: sourcery-ai[bot] <58596630+sourcery-ai[bot]@users.noreply.github.com>

fix/typo

aebe0f8

Merge remote-tracking branch 'origin/feat/aur' into feat/aur

64af380

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

更新文档，新增系统包管理器安装途径#4879

更新文档，新增系统包管理器安装途径#4879
LIghtJUNction wants to merge 5 commits intomasterfrom
feat/aur

LIghtJUNction commented Feb 5, 2026 •

edited

Loading

Uh oh!

sourcery-ai bot left a comment

Uh oh!

Uh oh!

sourcery-ai bot Feb 5, 2026

Uh oh!

sourcery-ai bot Feb 5, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Feb 5, 2026

Uh oh!

Uh oh!

Copilot AI Feb 5, 2026

Uh oh!

Soulter Feb 5, 2026

Uh oh!

LIghtJUNction Feb 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	# arch系，可通过aur安装
	# arch系，可通过 AUR 安装

Uh oh!

Conversation

LIghtJUNction commented Feb 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Modifications / 改动点

Screenshots or Test Results / 运行截图或测试结果

Checklist / 检查清单

由 Sourcery 提供的总结

Summary by Sourcery

Uh oh!

sourcery-ai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sourcery-ai bot Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

sourcery-ai bot Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

Soulter Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

LIghtJUNction Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

LIghtJUNction commented Feb 5, 2026 •

edited

Loading