feat: 整合安装脚本到 tools 目录

- 将安装脚本统一移动到 tools 目录
- 更新 README 文档
- 优化 env.sh 和 env.py 中的 ENV_ROOT 默认值
- 支持 Windows PowerShell 安装脚本
- 添加 touch_env.py 工具

Author: dongly

.gitattributes

@@ -29,4 +29,5 @@
 *.md     text eol=crlf
 
 *.bat    text eol=crlf
-*.ps1    text eol=crlf
+*.ps1    text eol=crlf encoding=UTF-8-BOM
+*.sh     text eol=lf

README.md

@@ -1,84 +1,297 @@
 # Python Scripts for RT-Thread Env
 
-> WARNING
-> 
-> [env v2.0](https://github.com/RT-Thread/env/tree/master) and [env-windows v2.0](https://github.com/RT-Thread/env-windows/tree/v2.0.0) only **FULL SUPPORT** RT-Thread > v5.1.0 or [master](https://github.com/rt-thread/rt-thread) branch. if you work on RT-Thread <= v5.1.0, please use [env v1.5.x](https://github.com/RT-Thread/env/tree/v1.5.x) for linux, [env-windows v1.5.x](https://github.com/RT-Thread/env-windows/tree/v1.5.2) for windows
+**[中文文档](README_ZH.md)**
+
+> **⚠️ Important Notice**
+>
+> [env v2.0](https://github.com/RT-Thread/env/tree/master) and [env-windows v2.0](https://github.com/RT-Thread/env-windows/tree/v2.0.0) only **fully support** RT-Thread > v5.1.0 or the [master](https://github.com/rt-thread/rt-thread) branch. If you are using RT-Thread <= v5.1.0, please use [env v1.5.x](https://github.com/RT-Thread/env/tree/v1.5.x) (for Linux) or [env-windows v1.5.2](https://github.com/RT-Thread/env-windows/tree/v1.5.2) (for Windows).
 >
-> env v2.0 has made the following important changes:
-> - Upgrading Python version from v2 to v3
-> - Replacing kconfig-frontends with Python kconfiglib
+> **Key Changes in v2.0:**
+> - Upgraded Python version from v2 to v3
+> - Replaced kconfig-frontends with Python kconfiglib
 >
->  env v2.0 require python kconfiglib (install by `pip install kconfiglib`), but env v1.5.x confilt with kconfiglib (please run `pip uninstall kconfiglib`)
+> **Note:** env v2.0 requires Python kconfiglib (now automatically installed by the installer), but env v1.5.x conflicts with kconfiglib (please run `pip uninstall kconfiglib`).
 
-## Usage under Linux
+---
 
-### Tutorial
+## Table of Contents
 
-[How to install Env Tool with QEMU simulator in Ubuntu](https://github.com/RT-Thread/rt-thread/blob/master/documentation/quick-start/quick_start_qemu/quick_start_qemu_linux.md)
+- [Windows Installation Guide](#windows-installation-guide)
+  - [Install Env](#install-env)
+  - [Activate Environment](#activate-rt-thread-env)
+- [Linux/macOS Installation Guide](#linuxmacos-installation-guide)
+  - [Install Env](#install-env-1)
+  - [Activate Environment](#activate-rt-thread-env-1)
+- [Installation Script Parameters](#installation-script-parameters)
+- [Env Usage Guide](#env-usage-guide)
+- [Troubleshooting](#troubleshooting)
+- [Related Documents](#related-documents)
+- [License](#license)
+- [Related Links](#related-links)
+
+---
+
+## Windows Installation Guide
 
 ### Install Env
 
+**Prerequisites:**
+- First-time installation requires administrator privileges (to set script execution policy and enable long path support)
+- Subsequent updates can use normal user privileges
+
+**Supported PowerShell Versions:**
+- Windows PowerShell (PowerShell v5.1 and above)
+- PowerShell 7+ (cross-platform version)
+
+**Important Compatibility Notice:**
+
+> ⚠️ **PowerShell Encoding Compatibility**
+>
+> - **Windows PowerShell**: On Chinese Windows systems, the default encoding is GB2312. Downloaded .ps1 scripts are typically UTF-8 encoded, but Windows PowerShell does not support UTF-8 files without BOM. It can only read UTF-8 with BOM encoded files.
+>
+> - **PowerShell 7+**: Native UTF-8 support, no encoding issues.
+>
+> Installation scripts are configured as UTF-8 with BOM encoding to ensure compatibility.
+
+**Windows Installation Command:**
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy Bypass Process; irm https://raw.githubusercontent.com/RT-Thread/env/master/tools/install.ps1 | Out-File -Encoding utf8 .\install.ps1; .\install.ps1; Remove-Item .\install.ps1
 ```
-wget https://raw.githubusercontent.com/RT-Thread/env/master/install_ubuntu.sh
-chmod 777 install_ubuntu.sh
-./install_ubuntu.sh
-rm install_ubuntu.sh
+
+For users in China (optional):
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy Bypass Process; irm https://gitee.com/RT-Thread-Mirror/env/raw/master/tools/install.ps1 | Out-File -Encoding utf8 .\install.ps1; .\install.ps1; Remove-Item .\install.ps1
 ```
 
-对于中国大陆用户，请使用以下命令
+**Notes:**
+- Installation script automatically selects mirror sources based on geographic location (can be specified using `--cn` or `--official` parameters)
+- First-time installation requires administrator privileges
+
+For complete parameter descriptions, see [Installation Script Parameters](#installation-script-parameters).
+
+**Important Tips:**
+
+1. ✅ Installation script requires administrator privileges for script execution policy and long path support settings
+2. ⚠️ When running without administrator privileges, if the above settings are required, it will prompt and exit
+3. 🦠 Antivirus software may block installation, please temporarily disable if needed
+
+### Activate RT-Thread ENV
+
+After installation, you need to activate the environment variables.
 
+**Option A: Manual Activation Each Time**
+
+Run the following command each time you start a new PowerShell session:
+
+```powershell
+~/.rt-env/env.ps1
 ```
-wget https://gitee.com/RT-Thread-Mirror/env/raw/master/install_ubuntu.sh
-chmod 777 install_ubuntu.sh
-./install_ubuntu.sh --gitee
-rm install_ubuntu.sh
+
+**Option B: Auto Activation on Startup (Recommended)**
+
+Create or edit a PowerShell configuration file to automatically activate the environment:
+
+```powershell
+# Open configuration file (creates if it doesn't exist)
+notepad $PROFILE
+
+# Add the following line to the file:
+~/.rt-env/env.ps1
 ```
 
-### Prepare Env
+**Configuration File Paths:**
 
-PLAN A: Whenever start the ubuntu system, you need to type command `source ~/.env/env.sh` to activate the environment variables.
+| PowerShell Version | Configuration File Path |
+|-------------------|------------------------|
+| Windows PowerShell (v5.1) | `C:\Users\<username>\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1` |
+| PowerShell 7+ | `C:\Users\<username>\Documents\PowerShell\Microsoft.PowerShell_profile.ps1` |
 
-or PLAN B: open `~/.bashrc` file, and attach the command `source ~/.env/env.sh` at the end of the file. It will be automatically executed when you log in the ubuntu, and you don't need to execute that command any more.
+After adding the activation command, the environment will be loaded automatically each time you restart PowerShell, no need to execute Option A.
 
-### Use Env
+---
+## Linux/macOS Installation Guide
 
-Please see: <https://github.com/RT-Thread/rt-thread/blob/master/documentation/env/env.md#bsp-configuration-menuconfig>
+**Unified Installation Script (Linux and macOS)**
 
-## Usage under Windows
+```bash
+wget -O- https://raw.githubusercontent.com/RT-Thread/env/master/tools/install.sh | bash
+```
 
-Tested on the following version of PowerShell:
+For users in China (optional):
 
-- PSVersion                      5.1.22621.963
-- PSVersion                      5.1.19041.2673
+```bash
+wget -O- https://gitee.com/RT-Thread-Mirror/env/raw/master/tools/install.sh | bash --cn
+```
 
-### Install Env
+**Notes:**
+- Installation script automatically selects mirror sources based on geographic location (can be specified using `--cn` or `--official` parameters)
+- Linux installation script automatically uses `sudo` to elevate privileges as needed, no need to manually run as root
+- All systems support installation with normal user privileges, installation script automatically handles privilege elevation
 
-您需要以管理员身份运行 PowerShell 来设置执行。（You need to run PowerShell as an administrator to set up execution.）
+For complete parameter descriptions, see [Installation Script Parameters](#installation-script-parameters).
 
-在 PowerShell 中执行（Execute the command in PowerShell）：
+### Activate RT-Thread ENV
 
-```powershell
-wget https://raw.githubusercontent.com/RT-Thread/env/master/install_windows.ps1 -O install_windows.ps1
-set-executionpolicy remotesigned
-.\install_windows.ps1
+After installation, you need to activate the environment variables before using RT-Thread tools.
+
+**Option A: Manual Activation Each Time**
+
+Run the following command each time you open a new terminal:
+
+```bash
+source ~/.rt-env/env.sh
+```
+
+**Option B: Auto Activation on Login (Recommended)**
+
+Add the activation command to your shell configuration file to make it run automatically:
+
+```bash
+# For bash
+echo 'source ~/.rt-env/env.sh' >> ~/.bashrc
+
+# For zsh
+echo 'source ~/.rt-env/env.sh' >> ~/.zshrc
 ```
 
-对于中国大陆用户，请使用以下命令：
+After adding, the environment will be automatically activated each time you log in, no need to manually execute the command.
 
+### Tutorial
+
+**Env Tool Tutorials:**
+
+- [Install Env with QEMU Simulator in Ubuntu](https://github.com/RT-Thread/rt-thread/blob/master/documentation/quick-start/quick_start_qemu/quick_start_qemu_linux.md)
+
+---
+## Installation Script Parameters
+
+The following are the parameter descriptions common to all installation scripts:
+
+| Parameter | Description |
+|-----------|-------------|
+| `-y`, `--yes`, `--auto` | Automatic installation, no interaction |
+| `-c`, `--cn`, `--gitee` | Use China mirror sources (Gitee, PyPI TUNA) |
+| `-o`, `--official` | Force use of official sources |
+| `-d`, `--pyocd` | Install pyocd (for debugging) |
+| `-r`, `--env-root <path>` | Set custom .rt-env directory path (overrides default `~/.rt-env`) |
+| `-e`, `--en`, `--english` | Force English display |
+| `-z`, `--zh`, `--chinese` | Force Chinese display |
+| `-P`, `--packages <repo>[#<branch>]` | Specify packages repository address and branch, format: url[#branch] |
+| `-E`, `--env <repo>[#<branch>]` | Specify env repository address and branch, format: url[#branch] |
+| `-S`, `--sdk <repo>[#<branch>]` | Specify sdk repository address and branch, format: url[#branch] |
+| `-b`, `--backup <strategy>` | Backup strategy: preserve (keep configs and toolchains), delete_all (delete all), backup_all (full backup) |
+| `-t`, `--touch-env-url <url>` | Specify touch_env.py download URL |
+| `-h`, `--help` | Display help information |
+| `-p`, `--python [path]` | Install portable Python, installation directory is path (Windows only, default: D:\Tools\Python) |
+
+**Backup Strategy Description:**
+
+- **preserve** (default): Keep configuration files (.config) and toolchains (local_pkgs), delete other content and reinstall
+- **delete_all**: Completely delete existing ENV directory, keep nothing
+- **backup_all**: Create full backup, keep all content including configurations and toolchains
+
+**Usage Examples:**
+
+**Windows (PowerShell):**
 ```powershell
-wget https://gitee.com/RT-Thread-Mirror/env/raw/master/install_windows.ps1 -O install_windows.ps1
-set-executionpolicy remotesigned
-.\install_windows.ps1 --gitee
+# Basic installation
+.\install.ps1
+
+# Use China mirror + automatic installation
+.\install.ps1 -c -y
+
+# Install portable Python
+.\install.ps1 -p "D:\Tools\Python" -r "D:\RT-Env"
+
+# Specify custom env repository branch
+.\install.ps1 -E "https://github.com/RT-Thread/env.git#master"
+
+# Install pyocd + official source
+.\install.ps1 -d -o
+```
+
+**Linux/macOS (bash):**
+```bash
+# Basic installation
+./install.sh
+
+# Use China mirror + automatic installation
+./install.sh -c -y
+
+# Specify custom packages repository
+./install.sh -P "https://gitee.com/RT-Thread/packages.git#master"
+
+# Use backup strategy
+./install.sh -b preserve
+
+# Specify custom sdk repository
+./install.sh -S "https://github.com/RT-Thread/sdk.git#master"
+```
+
+## Env Usage Guide
+
+For detailed usage instructions, please refer to:
+
+- [Env Tool Usage Guide](https://github.com/RT-Thread/rt-thread/blob/master/documentation/env/env.md)
+- [Env Official User Manual](https://www.rt-thread.org/document/site/#/development-tools/env/env)
+
+---
+## Troubleshooting
+
+### Mirror Connection Issues
+
+If download is slow or fails:
+
+- Try using `--cn` parameter to use gitee default mirror
+- Check network connection
+
+### Permission Issues (Linux/macOS)
+
+The Linux installation script automatically uses `sudo` to install system dependencies, no need to manually execute permission-related commands.
+
+If you encounter permission issues:
+
+```bash
+# Check .rt-env directory permissions
+ls -la ~/.rt-env
+
+# If .rt-env belongs to root user, try the following command
+sudo chown -R $USER:$USER ~/.rt-env
 ```
 
-注意：
+### Permission Issues (Windows)
+
+If you encounter permission errors:
+
+1. Check if antivirus software is blocking the installation
+2. The script automatically detects if administrator privileges are needed and will prompt you to run as administrator if required
+
+---
+
+## Related Documents
+
+- [Env Tool Complete Documentation](https://github.com/RT-Thread/rt-thread/blob/master/documentation/env/env.md)
+- [QEMU Quick Start](https://github.com/RT-Thread/rt-thread/blob/master/documentation/quick-start/quick_start_qemu/quick_start_qemu_linux.md)
+- [BSP Configuration Guide](https://github.com/RT-Thread/rt-thread/blob/master/documentation/env/env.md#bsp-configuration-menuconfig)
+
+---
+
+## License
+
+This project is open-sourced under the GPL-2.0 license.
+
+---
+
+## Related Links
 
-1. Powershell要以管理员身份运行。
-2. 将其设置为 remotesigned 后，您可以作为普通用户运行 PowerShell。（ After setting it to remotesigned, you can run PowerShell as a normal user.）
-3. 一定要关闭杀毒软件，否则安装过程可能会被杀毒软件强退
+- [GitHub Repository](https://github.com/RT-Thread/env)
+- [RT-Thread Official Website](https://www.rt-thread.org/)
+- [RT-Thread Documentation Center](https://www.rt-thread.io/document/site/)
 
-### Prepare Env
+---
 
-方案 A：每次重启 PowerShell 时，都需要输入命令 `~/.env/env.ps1`，以激活环境变量。（PLAN A: Each time you restart PowerShell, you need to enter the command `~/.env/env.ps1` to activate the environment variable.）
+## Contributors
 
-方案 B (推荐)：打开 `C:\Users\user\Documents\WindowsPowerShell`，如果没有`WindowsPowerShell`则新建该文件夹。新建文件 `Microsoft.PowerShell_profile.ps1`，然后写入 `~/.env/env.ps1` 内容即可，它将在你重启 PowerShell 时自动执行，无需再执行方案 A 中的命令。（or PLAN B (recommended): Open `C:\Users\user\Documents\WindowsPowerShell` and create a new file `Microsoft.PowerShell_profile.ps1`. Then write `~/.env/env.ps1` to the file. It will be executed automatically when you restart PowerShell, without having to execute the command in scenario A.）
+Thanks to all developers who have contributed to the RT-Thread Env project.