feat(install): add multilingual setup and mainland China mirrors (#10629)

* feat(install): add multilingual setup and mainland China mirrors

* fix(install): support PowerShell 5.1 and Invoke-Expression

* fix(install): support BOM-free PowerShell pipeline execution

* fix(install): configure UTF-8 console output

* fix(install): set Windows console code page internally

* fix(install): keep IEX bootstrap menu ASCII-only

* fix(install): default language selection to English

* test(install): cover language source defaults

* fix(test): escape PowerShell assertion patterns

* fix(install): restore localized language menu

* fix(install): list English as first language

* fix(install): put English first in language prompt

* feat(install): add indented AstrBot installer header

* fix(install): apply indentation consistently

* feat(install): show AstrBot startup commands

* docs(install): clarify AstrBot startup steps

* feat(install): fall back from Python mirror

* fix(install): keep Windows setup in one console

* ci: run install tests in fixed shells

* fix(install): tolerate a removed current directory

* docs: simplify script deployment instructions

* fix(install): align Bash wizard with PowerShell flow

* fix(install): refresh shell before manual startup

* docs: rename deployment sidebar entries

* fix: restore PowerShell 5.1 installer compatibility

* test: isolate reboot thread mock from asyncio executor

* test: shorten long prompt IDs for Windows

* fix: keep completed traces closed when update timestamps collide

Author: Soulter

.github/workflows/install_script_test.yml

@@ -0,0 +1,54 @@
+name: Test install scripts
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - 'docs/public/install.ps1'
+      - 'docs/public/install.sh'
+      - 'tests/test_install_script.py'
+      - 'tests/install_script.Tests.ps1'
+      - '.github/workflows/install_script_test.yml'
+  pull_request:
+    paths:
+      - 'docs/public/install.ps1'
+      - 'docs/public/install.sh'
+      - 'tests/test_install_script.py'
+      - 'tests/install_script.Tests.ps1'
+      - '.github/workflows/install_script_test.yml'
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Windows PowerShell compatibility
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Test Windows PowerShell 5.1
+        shell: powershell
+        run: .\tests\install_script.Tests.ps1
+
+      - name: Test PowerShell 7
+        shell: pwsh
+        run: .\tests\install_script.Tests.ps1
+
+  shell:
+    name: Bash installer (${{ matrix.os }})
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Test Bash installer
+        shell: bash
+        run: |
+          /bin/bash -n docs/public/install.sh
+          python3 tests/test_install_script.py

README.md

@@ -102,7 +102,7 @@ Visit [AstrBot Launcher](https://github.com/Raven95676/astrbot-launcher) to down
 
 **More deployment methods**
 
-If you need panel-based management or deeper customization, see [BT-Panel Deployment](https://docs.astrbot.app/deploy/astrbot/btpanel.html) for BT Panel app-store setup, [1Panel Deployment](https://docs.astrbot.app/deploy/astrbot/1panel.html) for 1Panel app-market deployment, [CasaOS Deployment](https://docs.astrbot.app/deploy/astrbot/casaos.html) for NAS/home-server visual deployment, and [Manual Deployment](https://docs.astrbot.app/deploy/astrbot/cli.html) for fully custom source-based installation with `uv`.
+If you need panel-based management or deeper customization, see [BT-Panel Deployment](https://docs.astrbot.app/deploy/astrbot/btpanel.html), [1Panel Deployment](https://docs.astrbot.app/deploy/astrbot/1panel.html), [CasaOS Deployment](https://docs.astrbot.app/deploy/astrbot/casaos.html), or [Source Deployment](https://docs.astrbot.app/deploy/astrbot/cli.html).
 
 
 ## ❤️ Sponsors

README_zh-TW.md

@@ -101,7 +101,7 @@ uv tool upgrade astrbot --python 3.12
 
 **更多部署方式**
 
-若你需要面板化或更高自訂程度的部署，可參考 [寶塔面板](https://docs.astrbot.app/deploy/astrbot/btpanel.html)（BT Panel 應用商店安裝）、[1Panel](https://docs.astrbot.app/deploy/astrbot/1panel.html)（1Panel 應用商店安裝）、[CasaOS](https://docs.astrbot.app/deploy/astrbot/casaos.html)（NAS / 家用伺服器可視化部署）與 [手動部署](https://docs.astrbot.app/deploy/astrbot/cli.html)（基於原始碼與 `uv` 的完整自訂安裝）。
+若你需要面板化或更高自訂程度的部署，可參考 [寶塔面板](https://docs.astrbot.app/deploy/astrbot/btpanel.html)、[1Panel](https://docs.astrbot.app/deploy/astrbot/1panel.html)、[CasaOS](https://docs.astrbot.app/deploy/astrbot/casaos.html) 或 [原始碼部署](https://docs.astrbot.app/deploy/astrbot/cli.html)。
 
 ## ❤️ 贊助商
 

README_zh.md

@@ -102,7 +102,7 @@ uv tool upgrade astrbot --python 3.12
 
 **更多部署方式**
 
-若你需要面板化或更高自定义部署，可参考 [宝塔面板](https://docs.astrbot.app/deploy/astrbot/btpanel.html)（BT Panel 应用商店安装）、[1Panel](https://docs.astrbot.app/deploy/astrbot/1panel.html)（1Panel 应用商店安装）、[CasaOS](https://docs.astrbot.app/deploy/astrbot/casaos.html)（NAS / 家庭服务器可视化部署）和 [手动部署](https://docs.astrbot.app/deploy/astrbot/cli.html)（基于源码与 `uv` 的完整自定义安装）。
+若你需要面板化或更高自定义部署，可参考 [宝塔面板](https://docs.astrbot.app/deploy/astrbot/btpanel.html)、[1Panel](https://docs.astrbot.app/deploy/astrbot/1panel.html)、[CasaOS](https://docs.astrbot.app/deploy/astrbot/casaos.html) 和 [源码部署](https://docs.astrbot.app/deploy/astrbot/cli.html)。
 
 ## ❤️ 赞助商
 

astrbot/core/utils/trace_store.py

@@ -257,7 +257,8 @@ def _write(self, connection: sqlite3.Connection, batch: list[dict]) -> None:
                     has_models=MAX(traces.has_models, excluded.has_models),
                     has_plugins=MAX(traces.has_plugins, excluded.has_plugins),
                     search=excluded.search, data=excluded.data, size_bytes=excluded.size_bytes
-                    WHERE excluded.updated_ns >= traces.updated_ns""",
+                    WHERE excluded.updated_ns >= traces.updated_ns
+                        AND (traces.state = 'running' OR excluded.state != 'running')""",
                     (
                         trace_id,
                         int(summary["start_time_unix_nano"]),

docs/.vitepress/config.mjs

@@ -43,15 +43,15 @@ export default defineConfig({
             base: "/deploy",
             collapsed: false,
             items: [
-              { text: "包管理器部署", link: "/astrbot/package" },
+              { text: "脚本部署", link: "/astrbot/package" },
               { text: "雨云一键云部署", link: "/astrbot/rainyun" },
               { text: "桌面客户端部署", link: "/astrbot/desktop" },
               { text: "启动器一键部署", link: "/astrbot/launcher" },
               { text: "Docker 部署", link: "/astrbot/docker" },
               { text: "Kubernetes 部署", link: "/astrbot/kubernetes" },
               { text: "宝塔面板部署", link: "/astrbot/btpanel" },
               { text: "1Panel 部署", link: "/astrbot/1panel" },
-              { text: "手动部署", link: "/astrbot/cli" },
+              { text: "源码部署", link: "/astrbot/cli" },
               {
                 text: "其他部署方式",
                 link: "/astrbot/other-deployments",
@@ -313,14 +313,14 @@ export default defineConfig({
             base: "/en/deploy",
             collapsed: false,
             items: [
-              { text: "Package Manager", link: "/astrbot/package" },
+              { text: "Script Deployment", link: "/astrbot/package" },
               { text: "Desktop Client", link: "/astrbot/desktop" },
               { text: "One-click Launcher", link: "/astrbot/launcher" },
               { text: "Docker", link: "/astrbot/docker" },
               { text: "Kubernetes", link: "/astrbot/kubernetes" },
               { text: "BT Panel", link: "/astrbot/btpanel" },
               { text: "1Panel", link: "/astrbot/1panel" },
-              { text: "Manual", link: "/astrbot/cli" },
+              { text: "Source Deployment", link: "/astrbot/cli" },
               {
                 text: "Other Deployments",
                 link: "/astrbot/other-deployments",

docs/en/deploy/astrbot/package.md

@@ -1,24 +1,65 @@
-# Package Manager Deployment (uv)
+# Script Deployment
 
-Use `uv` to install and run AstrBot quickly.
+AstrBot provides installation scripts for Linux, macOS, WSL, and Windows. The scripts install `uv`, AstrBot, and Python 3.12.
 
-## Before You Start
+## Linux / macOS / WSL
 
-If `uv` is not installed, install it first by following the official guide:
-<https://docs.astral.sh/uv/>
+Interactive installation:
 
-`uv` supports Linux, Windows, and macOS.
+```bash
+curl -fsSL https://docs.astrbot.app/install.sh | bash
+```
+
+Unattended installation:
+
+```bash
+curl -fsSL https://docs.astrbot.app/install.sh -o install.sh
+bash install.sh --language en-US --download-source official --non-interactive
+```
+
+`--download-source` accepts `china`, `official`, or `custom`. The default language is English. If the source is omitted, Chinese uses the mainland China mirrors; English and Japanese use official sources.
+
+## Windows
+
+Run these commands in PowerShell 5.1 or PowerShell 7+.
+
+Interactive installation:
 
-## Important Notes
+```powershell
+irm https://docs.astrbot.app/install.ps1 | iex
+```
+
+Unattended installation:
+
+```powershell
+Invoke-WebRequest https://docs.astrbot.app/install.ps1 -OutFile install.ps1 -UseBasicParsing
+.\install.ps1 -Language en-US -DownloadSource official -NonInteractive
+```
+
+`-DownloadSource` accepts `china`, `official`, or `custom`. The default language is English. If the source is omitted, Chinese uses the mainland China mirrors; English and Japanese use official sources.
 
-> [!WARNING]
-> AstrBot deployed via `uv` **does not support upgrading through the WebUI**. To update, run `uv tool upgrade astrbot --python 3.12` from the command line.
+The mainland China option also configures the USTC mirror for Python 3.12 and retries with the official Python source on failure. Existing Python mirror environment variables or explicit options take priority.
 
-AstrBot requires Python 3.12 or later. Use `--python 3.12` to ensure that `uv` creates the tool environment with Python 3.12; if Python downloads are enabled, `uv` will download Python 3.12 automatically when it is missing.
+## After Installation
 
-## Install and Start
+The installer runs `uv tool update-shell`. Reload the environment for your shell:
 
 ```bash
-uv tool install astrbot --python 3.12
-astrbot
+# Bash
+source ~/.bashrc
+# Zsh
+source ~/.zshrc
+# Fish
+source ~/.config/fish/config.fish
+# PowerShell
+. $PROFILE
 ```
+
+Then run these commands manually:
+
+```bash
+astrbot init
+astrbot run
+```
+
+> AstrBot installed by script does not support upgrades through the WebUI. Run `uv tool upgrade astrbot --python 3.12` to update it.