[重构项目结构和文档，增强跨平台构建与部署能力]: 全面重构项目文档、优化打包脚本并统一开发环境配置

- **重构README文档**: 将简单的示例列表转换为结构化的项目文档，为每个示例添加详细的功能说明和视觉展示，提升项目的专业性和易用性
- **统一开发环境配置**: 用健壮的`Enter-VsDevShell.ps1`替换原有的`setVsDev.ps1`，增强Visual Studio开发环境检测和错误处理，支持多架构参数
- **优化打包工具链**: 重写macOS工具脚本`utils.sh`，增强错误处理和日志功能；重构Python上传工具`utils.py`，增加分块上传、进度显示和重试机制
- **增强跨平台支持**: 完善Windows、macOS和Ubuntu的打包说明，提供签名、公证和分发包制作的完整工作流指导
- **标准化脚本规范**: 为所有Shell脚本添加错误检查(`set -euo pipefail`)和日志功能，提高脚本的健壮性和可维护性

Author: RealChuan

.github/workflows/cmake.yml

@@ -47,7 +47,7 @@ jobs:
         if: startsWith(matrix.os, 'windows')
         shell: pwsh
         run: |
-          .\scripts\windows\setVsDev.ps1
+          .\packaging\windows\Enter-VsDevShell.ps1
           cmake `
             -S . `
             -B ./build `

.github/workflows/qmake.yml

@@ -52,7 +52,7 @@ jobs:
         if: startsWith(matrix.os, 'windows')
         shell: pwsh
         run: |
-          ..\scripts\windows\setVsDev.ps1
+          ..\packaging\windows\Enter-VsDevShell.ps1
           & qmake ./../.
           & jom
         working-directory: build

README.md

@@ -1,56 +1,59 @@
-#!/bin/bash -ex
+#!/bin/bash
+set -euo pipefail
+# ----------- 硬编码区 ---------------
+APPLE_ID="***@***"
+TEAM_ID="*********"
+NOTARY_PWD="*********"
+# ------------------------------------
+
+log() { echo "[$(date +%F\ %T)] $*"; }
+die() {
+	log "FATAL: $*"
+	exit 1
+}
 
+# 安全删除
 delete_file_or_dir() {
-    local target=$1
-
-    if [ -e "$target" ]; then
-        if [ -d "$target" ]; then
-            rm -rf "$target"
-            echo "Directory deleted: $target"
-        else
-            rm "$target"
-            echo "File deleted: $target"
-        fi
-    else
-        echo "Error: $target does not exist."
-    fi
+	local target=$1
+	[[ -e $target ]] || {
+		log "Skip: $target not exist"
+		return 0
+	}
+	if [[ -d $target ]]; then
+		rm -rf "$target" && log "DIR  deleted: $target"
+	else
+		rm -f "$target" && log "FILE deleted: $target"
+	fi
 }
 
+# 处理 plist
 process_plist() {
-    local plist_path="$1"
-
-    if [ -z "$plist_path" ]; then
-        echo "Error: Plist file path is not provided."
-        return 1
-    fi
-
-    if [ ! -f "$plist_path" ]; then
-        echo "Error: Plist file does not exist at path: $plist_path"
-        return 1
-    fi
-
-    echo "Converting plist to XML format..."
-    plutil -convert xml1 "$plist_path" 2>/dev/null
-
-    echo "Linting plist file..."
-    plutil -lint "$plist_path" 2>/dev/null
-
-    if [ $? -eq 0 ]; then
-        echo "Plist file processed successfully."
-    else
-        echo "Error occurred while processing plist file."
-        return 2
-    fi
+	local plist=$1
+	[[ -n $plist && -f $plist ]] || {
+		log "Skip plist: file missing"
+		return 0
+	}
+	log "Convert plist → XML"
+	plutil -convert xml1 "$plist"
+	log "Lint plist"
+	plutil -lint "$plist" >/dev/null || die "Plist lint failed"
+	log "Plist processed OK"
 }
 
+# 公证 + staple
 notarize_app() {
-    local target=$1
-    if [ ! -f "$target" ]; then
-        echo "Error: $target does not exist."
-        exit 1
-    fi
+	local target=$1
+	[[ -f $target ]] || die "Notarize target missing: $target"
+
+	log "Submitting for notarization..."
+	xcrun notarytool submit "$target" \
+		--apple-id "$APPLE_ID" \
+		--team-id "$TEAM_ID" \
+		--password "$NOTARY_PWD" \
+		--wait
+
+	log "Stapling ticket..."
+	xcrun stapler staple "$target"
 
-    xcrun notarytool submit $target --apple-id "***@***" \
-        --team-id "******" --password "******" --wait
-    xcrun stapler staple $target
+	log "Notarize & staple finished: $target"
 }

packaging/macos/utils.sh

@@ -79,26 +79,26 @@ def upload_platform(platform_key: str) -> None:
 
     # 生成 update.json
     json_path = os.path.join(RELEASES_PATH, "update.json")
-    utils.generate_json(VERSION, dst_path, dst_name, json_path)
+    utils.write_json_describe(VERSION, dst_path, dst_name, json_path)
 
     # 上传主安装包
-    utils.sftp_upload_file(
+    utils.upload_sftp(
         SFTP_SERVER,
         SFTP_PORT,
         SFTP_USER,
         SFTP_PWD,
-        dst_path,
         f"{cfg['remote']}/{dst_name}",
+        dst_path,
     )
 
     # 上传 update.json
-    utils.sftp_upload_file(
+    utils.upload_sftp(
         SFTP_SERVER,
         SFTP_PORT,
         SFTP_USER,
         SFTP_PWD,
-        json_path,
         f"{cfg['remote']}/update.json",
+        json_path,
     )
 
     print(f"[{platform_key}] 上传完成 ✔")