feat: add delete_all_now strategy and update backup strategy documentation

dongly · dongly · commit a10b601e058a · 2026-01-31T23:22:50.000+08:00
- Add D/d option for immediate delete without backup (delete_all_now)
- Update delete_all description: backup then delete, no restore
- Add manual operation prompts when backup/delete fails
- Add GPL copyright header to install.sh
- Update all documentation: README, README_ZH, install.ps1, install.sh, touch_env.py
diff --git a/README.md b/README.md
@@ -181,15 +181,16 @@ The following are the parameter descriptions common to all installation scripts:
 | `-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) |
+| `-b`, `--backup <strategy>` | Backup strategy: preserve (keep configs and toolchains), delete_all (backup then delete), delete_all_now (delete immediately, no backup), 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
+- **delete_all**: Backup then delete existing ENV directory, keep nothing
+- **delete_all_now**: Immediately delete existing ENV directory, no backup
 - **backup_all**: Create full backup, keep all content including configurations and toolchains
 
 **Usage Examples:**
diff --git a/README_ZH.md b/README_ZH.md
@@ -182,15 +182,16 @@ echo 'source ~/.rt-env/env.sh' >> ~/.zshrc
 | `-P`, `--packages <repo>[#<branch>]` | 指定 packages 仓库地址和分支，格式: url[#branch] |
 | `-E`, `--env <repo>[#<branch>]` | 指定 env 仓库地址和分支，格式: url[#branch] |
 | `-S`, `--sdk <repo>[#<branch>]` | 指定 sdk 仓库地址和分支，格式: url[#branch] |
-| `-b`, `--backup <strategy>` | 备份策略：preserve（保留配置和工具链）、delete_all（删除所有内容）、backup_all（完整备份） |
+| `-b`, `--backup <strategy>` | 备份策略：preserve（保留配置和工具链）、delete_all（备份后删除）、delete_all_now（立即删除，不备份）、backup_all（完整备份） |
 | `-t`, `--touch-env-url <url>` | 指定 touch_env.py 下载 URL |
 | `-h`, `--help` | 显示帮助信息 |
 | `-p`, `--python [path]` | 安装便携式 Python，安装目录为 path（仅 Windows，默认：D:\Tools\Python） |
 
 **备份策略说明：**
 
 - **preserve** (默认)：保留配置文件（.config）和工具链（local_pkgs），删除其他内容后重新安装
-- **delete_all**：完全删除现有 ENV 目录，不保留任何内容
+- **delete_all**：备份后删除现有 ENV 目录，不保留任何内容
+- **delete_all_now**：立即删除现有 ENV 目录，不备份
 - **backup_all**：创建完整备份，保留所有内容，包括配置和工具链
 
 **使用示例：**
diff --git a/tools/install.ps1 b/tools/install.ps1
@@ -69,8 +69,10 @@
 #                        当 ENV 已存在时的备份策略：
 #                          preserve: Keep .config and local_pkgs, restore and delete backup
 #                                    保留 .config 和 local_pkgs，恢复后删除备份
-#                          delete_all: Delete everything, no restore
-#                                    删除所有内容，不恢复
+#                          delete_all: Backup then delete everything, no restore
+#                                    备份后删除所有内容，不恢复
+#                          delete_all_now: Delete everything immediately, no backup
+#                                    立即删除所有内容，不备份
 #                          backup_all: Keep backup with hardlink restore
 #                                    保留备份，用硬链接恢复本地包
 #   -t, --touch-env-url <url> Specify touch_env.py download URL
@@ -250,7 +252,11 @@ function Print-Help {
         Write-Host "                        格式: url[#branch]"
         Write-Host "  -S, --sdk [repo]     指定 sdk 仓库地址和分支"
         Write-Host "                        格式: url[#branch]"
-        Write-Host "  -b, --backup [strategy] 备份策略 (preserve/delete_all/backup_all)"
+        Write-Host "  -b, --backup [strategy] 备份策略 (preserve/delete_all/delete_all_now/backup_all)"
+        Write-Host "                          preserve: 保留 .config 和 local_pkgs，恢复后删除备份"
+        Write-Host "                          delete_all: 备份后删除所有内容，不恢复"
+        Write-Host "                          delete_all_now: 立即删除所有内容，不备份"
+        Write-Host "                          backup_all: 保留备份，用硬链接恢复本地包"
         Write-Host "  -t, --touch-env-url [url] 指定 touch_env.py 下载 URL"
         Write-Host "  -h, --help           显示此帮助信息"
         Write-Host ""
@@ -275,7 +281,11 @@ function Print-Help {
         Write-Host "                        Format: url[#branch]"
         Write-Host "  -S, --sdk [repo]     Specify custom sdk repository and branch"
         Write-Host "                        Format: url[#branch]"
-        Write-Host "  -b, --backup [strategy] Backup strategy (preserve/delete_all/backup_all)"
+        Write-Host "  -b, --backup [strategy] Backup strategy (preserve/delete_all/delete_all_now/backup_all)"
+        Write-Host "                          preserve: Keep .config and local_pkgs, restore and delete backup"
+        Write-Host "                          delete_all: Backup then delete everything, no restore"
+        Write-Host "                          delete_all_now: Delete everything immediately, no backup"
+        Write-Host "                          backup_all: Keep backup with hardlink restore"
         Write-Host "  -t, --touch-env-url [url] Specify touch_env.py download URL"
         Write-Host "  -h, --help           Show this help message"
         Write-Host ""
@@ -1065,9 +1075,10 @@ function Install-PortablePython {
     $result = New-PythonConfig
 
     try {
+        # Download and extract portable Python
         Download-PortablePython -UseCNMirror $UseCNMirror
         Extract-PortablePython
-
+        # Configure python3xx._pth file
         Configure-PythonPth
         # Save portable Python path to global variable
         $portablePython = $script:Config.PythonConfig.PythonPath
@@ -1087,7 +1098,9 @@ function Install-PortablePython {
         }
     }
     catch {
-        $result.Result = 1
+        $result.Result = 2
+        Write-LogError "python_install_failed" $_.Exception.Message
+        Write-Host "请手动删除 Python 安装目录后重试" -ForegroundColor Yellow
     }
 
     return $result
diff --git a/tools/install.sh b/tools/install.sh
@@ -1,5 +1,27 @@
 #!/usr/bin/env bash
 #
+# File      : install.sh
+# This file is part of RT-Thread RTOS
+# COPYRIGHT (C) 2006 - 2026, RT-Thread Development Team
+#
+#  This program is free software; you can redistribute it and/or modify
+#  it under the terms of the GNU General Public License as published by
+#  the Free Software Foundation; either version 2 of the License, or
+#  (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public License along
+#  with this program; if not, write to the Free Software Foundation, Inc.,
+#  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+# Change Logs:
+# Date           Author          Notes
+# 2026-01-31     dongly         Refactored
+
 # RT-Thread ENV Installation Script (Unix)
 # Unified installation script for Linux and macOS
 # Supports: English / 中文
@@ -18,7 +40,15 @@
 #   -P, --packages <repo>[#<branch>]  Specify custom packages repository and branch
 #   -E, --env <repo>[#<branch>]  Specify custom env repository and branch
 #   -S, --sdk <repo>[#<branch>]  Specify custom sdk repository and branch
-#   -b, --backup <strategy> Backup strategy (preserve/delete_all/backup_all)
+#   -b, --backup <strategy> Backup strategy when ENV exists:
+#                          preserve: Keep .config and local_pkgs, restore and delete backup
+#                                    保留 .config 和 local_pkgs，恢复后删除备份
+#                          delete_all: Backup then delete everything, no restore
+#                                    备份后删除所有内容，不恢复
+#                          delete_all_now: Delete everything immediately, no backup
+#                                    立即删除所有内容，不备份
+#                          backup_all: Keep backup with hardlink restore
+#                                    保留备份，用硬链接恢复工具链
 #   -t, --touch-env-url <url> Specify touch_env.py download URL
 #   -h, --help           Show this help message
 #
@@ -401,7 +431,15 @@ print_help() {
     echo "  -P, --packages <repo>[#<branch>]  Specify custom packages repository and branch"
     echo "  -E, --env <repo>[#<branch>]  Specify custom env repository and branch"
     echo "  -S, --sdk <repo>[#<branch>]  Specify custom sdk repository and branch"
-    echo "  -b, --backup <strategy> Backup strategy (preserve/delete_all/backup_all)"
+    echo "  -b, --backup <strategy> Backup strategy (preserve/delete_all/delete_all_now/backup_all)"
+    echo "                          preserve: Keep .config and local_pkgs, restore and delete backup"
+    echo "                                    保留 .config 和 local_pkgs，恢复后删除备份"
+    echo "                          delete_all: Backup then delete everything, no restore"
+    echo "                                    备份后删除所有内容，不恢复"
+    echo "                          delete_all_now: Delete everything immediately, no backup"
+    echo "                                    立即删除所有内容，不备份"
+    echo "                          backup_all: Keep backup with hardlink restore"
+    echo "                                    保留备份，用硬链接恢复工具链"
     echo "  -t, --touch-env-url <url> Specify touch_env.py download URL"
     echo "  -h, --help           Show this help message"
     echo ""
diff --git a/tools/touch_env.py b/tools/touch_env.py
