Skip to content
This repository was archived by the owner on Mar 11, 2026. It is now read-only.

docs: translate deployment guides to English based on v4#123

Merged
LIghtJUNction merged 1 commit intov4from
feat/translate-docs-v4
Feb 5, 2026
Merged

docs: translate deployment guides to English based on v4#123
LIghtJUNction merged 1 commit intov4from
feat/translate-docs-v4

Conversation

@LIghtJUNction
Copy link
Copy Markdown
Member

@LIghtJUNction LIghtJUNction commented Feb 5, 2026

Summary by Sourcery

为 AstrBot 添加英文部署文档,涵盖多种平台和安装方式。

新功能:

  • 记录如何通过 Termux 在 Android 上部署 AstrBot,包括环境配置、运行步骤和故障排查。
  • 记录如何在 Windows 上使用一键式 PowerShell 安装程序部署 AstrBot,包括常见 Python 环境问题。
  • 记录社区贡献的 AstrBot Linux 与 Android 部署脚本和工具。
  • 记录通过 Arch 用户仓库(AUR)以及 systemd 用户服务安装和管理 AstrBot 的方法。

文档:

  • 新增 AstrBot 使用 Termux 在 Android 上部署的英文指南,涵盖前置条件、命令使用、后台运行以及已知错误的解决方案。
  • 新增使用官方一键安装程序在 Windows 上部署 AstrBot 的英文指南,包括 Python 安装及 PATH 相关问题的故障排查。
  • 新增概述社区维护的 AstrBot Linux 与 Android 部署脚本的英文指南,并附其代码仓库链接。
  • 新增通过系统包管理器(AUR)安装和管理 AstrBot 的英文指南,包括基础用法和 systemd 用户服务配置。
Original summary in English

Summary by Sourcery

Add English deployment documentation for AstrBot across multiple platforms and installation methods.

New Features:

  • Document deploying AstrBot on Android via Termux, including environment setup, running, and troubleshooting.
  • Document deploying AstrBot on Windows using the one-click PowerShell-based installer, including common Python environment issues.
  • Document community-contributed Linux and Android deployment scripts and tools for AstrBot.
  • Document AstrBot installation and service management via the Arch User Repository (AUR) with systemd user services.

Documentation:

  • Introduce an English guide for AstrBot deployment with Termux on Android, covering prerequisites, commands, background operation, and known error resolutions.
  • Add an English guide for deploying AstrBot on Windows using the official one-click installer, including troubleshooting Python installation and PATH issues.
  • Add an English guide summarizing community-maintained Linux and Android deployment scripts for AstrBot, with references to their repositories.
  • Add an English guide for installing and managing AstrBot via system package manager (AUR), including basic usage and systemd user service configuration.

Copilot AI review requested due to automatic review settings February 5, 2026 13:18
@LIghtJUNction LIghtJUNction merged commit 23fe37b into v4 Feb 5, 2026
4 checks passed
Copy link
Copy Markdown
Contributor

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

嗨,我给出了一些整体性的反馈:

  • Termux 部署指南在“错误解决方案(Error Solutions)”和“Termux 部署错误解决方案(Termux Deployment Error Solution)”两个小节里都重复出现了 uv sync failed / UV_LINK_MODE=copy 错误的解决办法;建议把它们合并到一个小节中,以避免重复以及后续内容可能出现的差异。
  • sys-pm.md 中,你提到只提供 AUR 版本,但没有明确说明这是针对基于 Arch 的发行版;建议补充一条关于支持发行版的简短说明(Arch/Manjaro/等),这样可以让用户更清楚适用范围。
给 AI 代理的提示(Prompt for AI Agents)
Please address the comments from this code review:

## Overall Comments
- The Termux deployment guide repeats the `uv sync failed` / `UV_LINK_MODE=copy` error solution in both the 'Error Solutions' and 'Termux Deployment Error Solution' sections; consider consolidating this into a single section to avoid duplication and potential divergence later.
- In `sys-pm.md`, you mention that only the AUR version is provided but don’t explicitly state that this is for Arch-based distributions; adding a brief note about supported distros (Arch/Manjaro/etc.) would make the scope clearer for users.

Sourcery 对开源项目是免费的——如果你喜欢我们的评审,请考虑分享它们 ✨
帮我变得更有用!请在每条评论上点 👍 或 👎,我会根据你的反馈改进后续评审。
Original comment in English

Hey - I've left some high level feedback:

  • The Termux deployment guide repeats the uv sync failed / UV_LINK_MODE=copy error solution in both the 'Error Solutions' and 'Termux Deployment Error Solution' sections; consider consolidating this into a single section to avoid duplication and potential divergence later.
  • In sys-pm.md, you mention that only the AUR version is provided but don’t explicitly state that this is for Arch-based distributions; adding a brief note about supported distros (Arch/Manjaro/etc.) would make the scope clearer for users.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- The Termux deployment guide repeats the `uv sync failed` / `UV_LINK_MODE=copy` error solution in both the 'Error Solutions' and 'Termux Deployment Error Solution' sections; consider consolidating this into a single section to avoid duplication and potential divergence later.
- In `sys-pm.md`, you mention that only the AUR version is provided but don’t explicitly state that this is for Arch-based distributions; adding a brief note about supported distros (Arch/Manjaro/etc.) would make the scope clearer for users.

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.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR translates AstrBot deployment documentation from Chinese to English for version 4. The documentation covers multiple deployment methods including Windows installer, Termux (Android), system package managers, and community-provided scripts.

Changes:

  • Added English translations for four deployment guide documents
  • Maintained all original technical details, commands, and troubleshooting steps
  • Preserved markdown formatting, code blocks, and warning/tip callouts

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
en/deploy/astrbot/windows.md Windows deployment guide with PowerShell installer instructions
en/deploy/astrbot/termux.md Android deployment guide using Termux and proot-distro
en/deploy/astrbot/sys-pm.md Linux system package manager installation guide (AUR)
en/deploy/astrbot/community-deployment.md Community-contributed deployment scripts and methods

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

sudo ./AstrbotScript.sh
```

> [!note]
Copy link

Copilot AI Feb 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Markdown alert syntax requires uppercase 'NOTE'. Changed 'note' to 'NOTE' for consistency with other alerts in the documentation.

Suggested change
> [!note]
> [!NOTE]

Copilot uses AI. Check for mistakes.
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants