refactor(*): LoginPage 消息追踪统一与 Flow 长方法拆分 (#12)

refactor: LoginPage 消息追踪统一与 Flow 长方法拆分

.github/workflows/build-test.yml

@@ -4,10 +4,6 @@ name: Build Test
 # It is triggered when a pull request is opened, synchronized, or reopened against the main branch.
 
 on:
-  push:
-    branches:
-      - main
-
   pull_request:
     branches:
       - main
@@ -15,7 +11,6 @@ on:
       - opened
       - synchronize
       - reopened
-  # Allow manual trigger for testing
   workflow_dispatch:
 
 #
@@ -49,11 +44,13 @@ jobs:
       uses: actions/setup-python@v6
       with:
         python-version: '3.13'
+        cache: 'pip'
+        cache-dependency-path: requirements.txt
 
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -r requirement.txt
+        pip install -r requirements.txt
 
     - name: Solve ddddocr compatibility and copy model files
       run: |
@@ -125,7 +122,7 @@ jobs:
           "    binaries=[],"
           "    datas=["
           "        ('models\\common.onnx', 'ddddocr'),"
-          "        ('src\\gui\\resources\\icons\\AutoLibrary_32x32.ico', 'gui\\resources\\icons'),"
+          "        ('src\\gui\\resources\\icons\\AutoLibrary_Logo_64.ico', 'gui\\resources\\icons'),"
           "    ],"
           "    hiddenimports=[],"
           "    hookspath=[],"
@@ -153,7 +150,7 @@ jobs:
           "    target_arch=None,"
           "    codesign_identity=None,"
           "    entitlements_file=None,"
-          "    icon=['src\\gui\\resources\\icons\\AutoLibrary_32x32.ico'],"
+          "    icon=['src\\gui\\resources\\icons\\AutoLibrary_Logo_64.ico'],"
           ")"
           ""
           "coll = COLLECT("
@@ -169,9 +166,11 @@ jobs:
         $specLines | Out-File -FilePath "Main.spec" -Encoding UTF8
 
         Write-Host "✓ Main.spec (non-single file) generated successfully"
-        Write-Host "`nGenerated Main.spec ============"
+        Write-Host "`n========================================"
+        Write-Host "Generated Main.spec"
+        Write-Host "========================================"
         Get-Content "Main.spec" | Write-Host
-        Write-Host "==================================`n"
+        Write-Host "========================================`n"
       shell: pwsh
 
     - name: Build with PyInstaller
@@ -186,7 +185,7 @@ jobs:
         $distDir = "dist/AutoLibrary-$version"
         $zipName = "AutoLibrary.$tagName-windows-x86_64.zip"
 
-        echo "ZIP_NAME=$zipName" >> $env:GITHUB_OUTPUT
+        "ZIP_NAME=$zipName" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
 
         Write-Host "Looking for distribution directory: $distDir"
         if (Test-Path $distDir) {
@@ -210,12 +209,283 @@ jobs:
 
     - name: Upload build summary
       run: |
-        Write-Host "## Build Test Summary" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8
-        Write-Host "" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
-        Write-Host "✓ Pull request build test completed successfully!" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
-        Write-Host "- Version: ${{ steps.get_version.outputs.VERSION }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
-        Write-Host "- Tag: ${{ steps.get_version.outputs.TAG_NAME }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
-        Write-Host "- Pull Request #${{ github.event.pull_request.number }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
-        Write-Host "- Branch: ${{ github.event.pull_request.head.ref }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
-        Write-Host "- Event: ${{ github.event_name }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "## Build Test Summary" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8
+        "" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "========================================" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "✓ Pull request build test completed successfully!" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "- Version: ${{ steps.get_version.outputs.VERSION }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "- Tag: ${{ steps.get_version.outputs.TAG_NAME }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "- Pull Request #${{ github.event.pull_request.number || 'N/A' }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "- Branch: ${{ github.event.pull_request.head.ref || github.ref }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "- Event: ${{ github.event_name }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
       shell: pwsh
+
+  #
+  # Build macOS
+  #
+
+  build-macos:
+    runs-on: macos-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v6
+      with:
+        ref: ${{ github.ref }}
+
+    - name: Get version info
+      id: get_version
+      run: |
+        version="pr-test"
+        tag_name="pr-test"
+        echo "✓ Mode: Pull Request Test Build"
+        echo "✓ Tag: $tag_name"
+        echo "✓ Version: $version"
+        echo "VERSION=$version" >> $GITHUB_OUTPUT
+        echo "TAG_NAME=$tag_name" >> $GITHUB_OUTPUT
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: '3.13'
+        cache: 'pip'
+        cache-dependency-path: requirements.txt
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+
+    - name: Solve ddddocr compatibility and copy model files
+      run: |
+        ddddocr_path=$(python -c "import ddddocr, os; print(os.path.dirname(ddddocr.__file__))")
+        echo "ddddocr package location: $ddddocr_path"
+
+        init_file="$ddddocr_path/__init__.py"
+        if [ -f "$init_file" ]; then
+          echo "Fixing ddddocr compatibility in: $init_file"
+          # macOS 使用 BSD sed，要求 -i 后跟备份后缀名（空字符串 = 不备份）
+          sed -i '' 's/Image\.ANTIALIAS/Image.Resampling.LANCZOS/g' "$init_file"
+          echo "✓ Fixed: Image.ANTIALIAS -> Image.Resampling.LANCZOS"
+        else
+          echo "✗ ddddocr __init__.py not found"
+          exit 1
+        fi
+
+        mkdir -p models
+        echo "✓ Created models directory"
+
+        # 多路径 fallback 搜索 ONNX 模型，提升 ddddocr 版本兼容性
+        onnx_source=""
+        onnx_dest="models/common.onnx"
+        candidate_paths=(
+          "$ddddocr_path/common.onnx"
+          "$ddddocr_path/models/common.onnx"
+          "$ddddocr_path/ddddocr/common.onnx"
+        )
+        for candidate in "${candidate_paths[@]}"; do
+          if [ -f "$candidate" ]; then
+            onnx_source="$candidate"
+            break
+          fi
+        done
+        # 若以上候选均未命中，回退到全包搜索
+        if [ -z "$onnx_source" ]; then
+          echo "⚠ 未在已知路径找到 ONNX 模型，回退到全包搜索..."
+          onnx_source=$(find "$ddddocr_path" -name "*.onnx" -type f 2>/dev/null | head -1)
+        fi
+
+        if [ -n "$onnx_source" ] && [ -f "$onnx_source" ]; then
+          cp "$onnx_source" "$onnx_dest"
+          echo "✓ ONNX model copied: $onnx_source -> $onnx_dest"
+        else
+          echo "✗ ONNX model not found in ddddocr package"
+          echo "  Searched directory: $ddddocr_path"
+          ls -la "$ddddocr_path/" || true
+          exit 1
+        fi
+
+        if [ -f "$onnx_dest" ]; then
+          file_size=$(du -h "$onnx_dest" | cut -f1)
+          echo "✓ Model file verified: $onnx_dest (Size: $file_size)"
+        else
+          echo "✗ Failed to copy model file"
+          exit 1
+        fi
+
+    - name: Compile Qt Resource files
+      run: |
+        cd batchs
+        bash compile_rc.sh
+
+    - name: Compile Qt UI files
+      run: |
+        cd batchs
+        bash compile_ui.sh
+
+    - name: Generate 'Main.spec'
+      env:
+        APP_VERSION: ${{ steps.get_version.outputs.VERSION }}
+      run: |
+        version="$APP_VERSION"
+        exe_name="AutoLibrary-$version"
+        echo "Generating Main.spec for version: $version"
+        echo "App name: $exe_name"
+
+        printf '%s\n' \
+          '# -*- mode: python ; coding: utf-8 -*-' \
+          '' \
+          'a = Analysis(' \
+          "    ['src/Main.py']," \
+          '    pathex=[],' \
+          '    binaries=[],' \
+          '    datas=[' \
+          "        ('models/common.onnx', 'ddddocr')," \
+          "        ('src/gui/resources/icons/AutoLibrary_Logo_64.ico', 'gui/resources/icons')," \
+          '    ],' \
+          '    hiddenimports=[],' \
+          '    hookspath=[],' \
+          '    hooksconfig={},' \
+          '    runtime_hooks=[],' \
+          '    excludes=[],' \
+          '    noarchive=False,' \
+          '    optimize=0,' \
+          ')' \
+          'pyz = PYZ(a.pure)' \
+          '' \
+          'exe = EXE(' \
+          '    pyz,' \
+          '    a.scripts,' \
+          '    [],' \
+          '    exclude_binaries=True,' \
+          "    name='AutoLibrary'," \
+          '    debug=False,' \
+          '    bootloader_ignore_signals=False,' \
+          '    strip=False,' \
+          '    upx=True,' \
+          '    upx_exclude=[],' \
+          '    runtime_tmpdir=None,' \
+          '    console=False,' \
+          '    disable_windowed_traceback=False,' \
+          '    argv_emulation=False,' \
+          '    target_arch=None,' \
+          '    codesign_identity=None,' \
+          '    entitlements_file=None,' \
+          "    icon=['src/gui/resources/icons/AutoLibrary_Logo_64.ico']," \
+          ')' \
+          '' \
+          'coll = COLLECT(' \
+          '    exe,' \
+          '    a.binaries,' \
+          '    a.zipfiles,' \
+          '    a.datas,' \
+          '    strip=False,' \
+          '    upx=True,' \
+          '    upx_exclude=[],' \
+          "    name='${exe_name}'," \
+          ')' \
+          '' \
+          'app = BUNDLE(' \
+          '    coll,' \
+          "    name='AutoLibrary.app'," \
+          "    icon='src/gui/resources/icons/AutoLibrary_Logo.icns'," \
+          "    bundle_identifier='com.kenanzhu.autolibrary'," \
+          '    info_plist={' \
+          "        'NSHighResolutionCapable': 'True'," \
+          "        'CFBundleName': 'AutoLibrary'," \
+          "        'CFBundleDisplayName': 'AutoLibrary'," \
+          "        'CFBundleShortVersionString': '${version}'," \
+          "        'CFBundleVersion': '${version}'," \
+          "        'CFBundleExecutable': 'AutoLibrary'," \
+          "        'NSPrincipalClass': 'NSApplication'," \
+          "        'LSMinimumSystemVersion': '11.0'," \
+          "        'NSRequiresAquaSystemAppearance': 'False'," \
+          "        'NSHumanReadableCopyright': 'Copyright 2025 - 2026 KenanZhu. All rights reserved.'," \
+          '    },' \
+          ')' \
+          > Main.spec
+
+        echo "✓ Main.spec generated successfully"
+        echo ""
+        echo "========================================"
+        echo "Generated Main.spec"
+        echo "========================================"
+        cat Main.spec
+        echo "========================================"
+
+    - name: Build with PyInstaller
+      run: |
+        python -m PyInstaller Main.spec
+
+    - name: Create DMG
+      run: |
+        tag_name="${{ steps.get_version.outputs.TAG_NAME }}"
+        dmg_name="AutoLibrary.$tag_name-macos-arm64.dmg"
+        app_path="dist/AutoLibrary.app"
+
+        if [ ! -d "$app_path" ]; then
+          echo "✗ App bundle not found: $app_path"
+          echo "Files in dist directory:"
+          ls -la dist/
+          exit 1
+        fi
+
+        echo "Creating DMG from: $app_path"
+        xattr -cr "$app_path" 2>/dev/null || true
+
+        tmp_dmg_dir=$(mktemp -d)
+        cp -R "$app_path" "$tmp_dmg_dir/"
+        ln -s /Applications "$tmp_dmg_dir/Applications"
+
+        hdiutil create \
+          -volname "AutoLibrary $tag_name" \
+          -srcfolder "$tmp_dmg_dir" \
+          -ov \
+          -format UDZO \
+          "$dmg_name"
+
+        rm -rf "$tmp_dmg_dir"
+
+        if [ -f "$dmg_name" ]; then
+          dmg_size=$(du -h "$dmg_name" | cut -f1)
+          echo "✓ DMG created: $dmg_name (Size: $dmg_size)"
+        else
+          echo "✗ Failed to create DMG"
+          exit 1
+        fi
+
+        echo "✓ Artifacts ready:"
+        echo "  - $dmg_name"
+        echo "  - $app_path"
+
+    - name: Archive artifacts
+      uses: actions/upload-artifact@v6
+      with:
+        name: AutoLibrary.${{ steps.get_version.outputs.TAG_NAME }}-macos-arm64
+        path: |
+          AutoLibrary.${{ steps.get_version.outputs.TAG_NAME }}-macos-arm64.dmg
+          dist/AutoLibrary.app/**
+        retention-days: 7
+
+    - name: Upload build summary
+      run: |
+        tag_name="${{ steps.get_version.outputs.TAG_NAME }}"
+        version="${{ steps.get_version.outputs.VERSION }}"
+        dmg_name="AutoLibrary.$tag_name-macos-arm64.dmg"
+
+        {
+          echo "## Build Test Summary (macOS)"
+          echo ""
+          echo "========================================"
+          echo "✓ Pull request build test completed successfully!"
+          echo "- Version: $version"
+          echo "- Tag: $tag_name"
+          echo "- Pull Request #${{ github.event.pull_request.number || 'N/A' }}"
+          echo "- Branch: ${{ github.event.pull_request.head.ref || github.ref }}"
+          echo "- Event: ${{ github.event_name }}"
+          echo "- DMG: $dmg_name"
+          echo ""
+          echo "### How to test on macOS"
+          echo '1. Download the DMG artifact'
+          echo '2. Open the DMG and drag AutoLibrary.app to /Applications'
+          echo '3. Right-click → Open the app (to bypass Gatekeeper)'
+        } >> $GITHUB_STEP_SUMMARY

.github/workflows/build.yml

@@ -1,7 +1,10 @@
 name: Build
 
-# This workflow compiles the application for Windows platform using PyInstaller, and
-# archives the built artifacts as 'AutoLibrary.<tag_name>-windows-x86_64.zip'.
+# This workflow compiles the application for Windows and macOS platforms using
+# PyInstaller, and archives the built artifacts.
+#
+# - Windows: AutoLibrary.<tag_name>-windows-x86_64.zip
+# - macOS:   AutoLibrary.<tag_name>-macos-arm64.dmg
 #
 # It is triggered when called by the release workflow.
 
@@ -76,20 +79,22 @@ jobs:
       run: |
         $versionInfoFile = "src/gui/ALVersionInfo.py"
         Write-Host "Verifying $versionInfoFile content:"
-        Write-Host "=================================="
+        Write-Host "========================================"
         Get-Content $versionInfoFile | Write-Host
-        Write-Host "=================================="
+        Write-Host "========================================"
       shell: pwsh
 
     - name: Set up Python
       uses: actions/setup-python@v6
       with:
         python-version: '3.13'
+        cache: 'pip'
+        cache-dependency-path: requirements.txt
 
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -r requirement.txt
+        pip install -r requirements.txt
 
     - name: Solve ddddocr compatibility and copy model files
       run: |
@@ -161,7 +166,7 @@ jobs:
           "    binaries=[],"
           "    datas=["
           "        ('models\\common.onnx', 'ddddocr'),"
-          "        ('src\\gui\\resources\\icons\\AutoLibrary_32x32.ico', 'gui\\resources\\icons'),"
+          "        ('src\\gui\\resources\\icons\\AutoLibrary_Logo_64.ico', 'gui\\resources\\icons'),"
           "    ],"
           "    hiddenimports=[],"
           "    hookspath=[],"
@@ -189,7 +194,7 @@ jobs:
           "    target_arch=None,"
           "    codesign_identity=None,"
           "    entitlements_file=None,"
-          "    icon=['src\\gui\\resources\\icons\\AutoLibrary_32x32.ico'],"
+          "    icon=['src\\gui\\resources\\icons\\AutoLibrary_Logo_64.ico'],"
           ")"
           ""
           "coll = COLLECT("
@@ -205,9 +210,11 @@ jobs:
         $specLines | Out-File -FilePath "Main.spec" -Encoding UTF8
 
         Write-Host "✓ Main.spec (non-single file) generated successfully"
-        Write-Host "`nGenerated Main.spec ============"
+        Write-Host "`n========================================"
+        Write-Host "Generated Main.spec"
+        Write-Host "========================================"
         Get-Content "Main.spec" | Write-Host
-        Write-Host "==================================`n"
+        Write-Host "========================================`n"
       shell: pwsh
 
     - name: Build with PyInstaller
@@ -222,7 +229,7 @@ jobs:
         $distDir = "dist/AutoLibrary-$version"
         $zipName = "AutoLibrary.$tagName-windows-x86_64.zip"
 
-        echo "ZIP_NAME=$zipName" >> $env:GITHUB_OUTPUT
+        "ZIP_NAME=$zipName" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
 
         Write-Host "Looking for distribution directory: $distDir"
         if (Test-Path $distDir) {
@@ -242,16 +249,315 @@ jobs:
         name: AutoLibrary.${{ steps.get_version.outputs.TAG_NAME }}-windows-x86_64
         path: |
           ${{ steps.zip_release.outputs.ZIP_NAME }}
-        retention-days: ${{ github.event_name != 'workflow_call' && 7 || 90 }}
+        retention-days: ${{ inputs.is_test == 'true' && 7 || 90 }}
 
     - name: Upload build summary
-      if: ${{ github.event_name != 'workflow_call' }}
+      if: ${{ inputs.is_test == 'true' }}
       run: |
-        Write-Host "## Build Summary" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8
-        Write-Host "" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
-        Write-Host "✓ Build test completed successfully!" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
-        Write-Host "- Version: ${{ steps.get_version.outputs.VERSION }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
-        Write-Host "- Tag: ${{ steps.get_version.outputs.TAG_NAME }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
-        Write-Host "- Event: ${{ github.event_name }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
-        Write-Host "- Ref: ${{ github.ref }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "## Build Summary" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8
+        "" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "========================================" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "✓ Build test completed successfully!" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "- Version: ${{ steps.get_version.outputs.VERSION }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "- Tag: ${{ steps.get_version.outputs.TAG_NAME }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "- Event: ${{ github.event_name }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        "- Ref: ${{ github.ref }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
       shell: pwsh
+
+  #
+  # Build macOS
+  #
+
+  build-macos:
+    runs-on: macos-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v6
+      with:
+        ref: ${{ github.ref }}
+
+    - name: Download build version of ALVersionInfo.py
+      uses: actions/download-artifact@v6
+      with:
+        name: updated-version-info-for-build
+        path: src/gui/
+
+    - name: Get version info
+      id: get_version
+      run: |
+        is_test="${{ inputs.is_test }}"
+        if [ "$is_test" = "true" ]; then
+          version="test"
+          tag_name="test"
+          echo "✓ Mode: Test Build"
+        else
+          version="${{ inputs.version }}"
+          tag_name="${{ inputs.tag_name }}"
+
+          if [ -z "$version" ]; then
+            version="test"
+            tag_name="test"
+            echo "✓ Mode: Independent Build (No inputs provided)"
+          fi
+        fi
+
+        echo "✓ Tag: $tag_name"
+        echo "✓ Version: $version"
+
+        echo "VERSION=$version" >> $GITHUB_OUTPUT
+        echo "TAG_NAME=$tag_name" >> $GITHUB_OUTPUT
+
+    - name: Verify 'ALVersionInfo.py' was updated
+      run: |
+        version_info_file="src/gui/ALVersionInfo.py"
+        echo "Verifying $version_info_file content:"
+        echo "========================================"
+        cat "$version_info_file"
+        echo "========================================"
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: '3.13'
+        cache: 'pip'
+        cache-dependency-path: requirements.txt
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+
+    - name: Solve ddddocr compatibility and copy model files
+      run: |
+        ddddocr_path=$(python -c "import ddddocr, os; print(os.path.dirname(ddddocr.__file__))")
+        echo "ddddocr package location: $ddddocr_path"
+
+        init_file="$ddddocr_path/__init__.py"
+        if [ -f "$init_file" ]; then
+          echo "Fixing ddddocr compatibility in: $init_file"
+          # macOS 使用 BSD sed，要求 -i 后跟备份后缀名（空字符串 = 不备份）
+          sed -i '' 's/Image\.ANTIALIAS/Image.Resampling.LANCZOS/g' "$init_file"
+          echo "✓ Fixed: Image.ANTIALIAS -> Image.Resampling.LANCZOS"
+        else
+          echo "✗ ddddocr __init__.py not found"
+          exit 1
+        fi
+
+        mkdir -p models
+        echo "✓ Created models directory"
+
+        # 多路径 fallback 搜索 ONNX 模型，提升 ddddocr 版本兼容性
+        onnx_source=""
+        onnx_dest="models/common.onnx"
+        candidate_paths=(
+          "$ddddocr_path/common.onnx"
+          "$ddddocr_path/models/common.onnx"
+          "$ddddocr_path/ddddocr/common.onnx"
+        )
+        for candidate in "${candidate_paths[@]}"; do
+          if [ -f "$candidate" ]; then
+            onnx_source="$candidate"
+            break
+          fi
+        done
+        # 若以上候选均未命中，回退到全包搜索
+        if [ -z "$onnx_source" ]; then
+          echo "⚠ 未在已知路径找到 ONNX 模型，回退到全包搜索..."
+          onnx_source=$(find "$ddddocr_path" -name "*.onnx" -type f 2>/dev/null | head -1)
+        fi
+
+        if [ -n "$onnx_source" ] && [ -f "$onnx_source" ]; then
+          cp "$onnx_source" "$onnx_dest"
+          echo "✓ ONNX model copied: $onnx_source -> $onnx_dest"
+        else
+          echo "✗ ONNX model not found in ddddocr package"
+          echo "  Searched directory: $ddddocr_path"
+          ls -la "$ddddocr_path/" || true
+          exit 1
+        fi
+
+        if [ -f "$onnx_dest" ]; then
+          file_size=$(du -h "$onnx_dest" | cut -f1)
+          echo "✓ Model file verified: $onnx_dest (Size: $file_size)"
+        else
+          echo "✗ Failed to copy model file"
+          exit 1
+        fi
+
+    - name: Compile Qt Resource files
+      run: |
+        cd batchs
+        bash compile_rc.sh
+
+    - name: Compile Qt UI files
+      run: |
+        cd batchs
+        bash compile_ui.sh
+
+    - name: Generate 'Main.spec'
+      env:
+        APP_VERSION: ${{ steps.get_version.outputs.VERSION }}
+      run: |
+        version="$APP_VERSION"
+        exe_name="AutoLibrary-$version"
+        echo "Generating Main.spec for version: $version"
+        echo "App name: $exe_name"
+
+        printf '%s\n' \
+          '# -*- mode: python ; coding: utf-8 -*-' \
+          '' \
+          'a = Analysis(' \
+          "    ['src/Main.py']," \
+          '    pathex=[],' \
+          '    binaries=[],' \
+          '    datas=[' \
+          "        ('models/common.onnx', 'ddddocr')," \
+          "        ('src/gui/resources/icons/AutoLibrary_Logo_64.ico', 'gui/resources/icons')," \
+          '    ],' \
+          '    hiddenimports=[],' \
+          '    hookspath=[],' \
+          '    hooksconfig={},' \
+          '    runtime_hooks=[],' \
+          '    excludes=[],' \
+          '    noarchive=False,' \
+          '    optimize=0,' \
+          ')' \
+          'pyz = PYZ(a.pure)' \
+          '' \
+          'exe = EXE(' \
+          '    pyz,' \
+          '    a.scripts,' \
+          '    [],' \
+          '    exclude_binaries=True,' \
+          "    name='AutoLibrary'," \
+          '    debug=False,' \
+          '    bootloader_ignore_signals=False,' \
+          '    strip=False,' \
+          '    upx=True,' \
+          '    upx_exclude=[],' \
+          '    runtime_tmpdir=None,' \
+          '    console=False,' \
+          '    disable_windowed_traceback=False,' \
+          '    argv_emulation=False,' \
+          '    target_arch=None,' \
+          '    codesign_identity=None,' \
+          '    entitlements_file=None,' \
+          "    icon=['src/gui/resources/icons/AutoLibrary_Logo_64.ico']," \
+          ')' \
+          '' \
+          'coll = COLLECT(' \
+          '    exe,' \
+          '    a.binaries,' \
+          '    a.zipfiles,' \
+          '    a.datas,' \
+          '    strip=False,' \
+          '    upx=True,' \
+          '    upx_exclude=[],' \
+          "    name='${exe_name}'," \
+          ')' \
+          '' \
+          'app = BUNDLE(' \
+          '    coll,' \
+          "    name='AutoLibrary.app'," \
+          "    icon='src/gui/resources/icons/AutoLibrary_Logo.icns'," \
+          "    bundle_identifier='com.kenanzhu.autolibrary'," \
+          '    info_plist={' \
+          "        'NSHighResolutionCapable': 'True'," \
+          "        'CFBundleName': 'AutoLibrary'," \
+          "        'CFBundleDisplayName': 'AutoLibrary'," \
+          "        'CFBundleShortVersionString': '${version}'," \
+          "        'CFBundleVersion': '${version}'," \
+          "        'CFBundleExecutable': 'AutoLibrary'," \
+          "        'NSPrincipalClass': 'NSApplication'," \
+          "        'LSMinimumSystemVersion': '11.0'," \
+          "        'NSRequiresAquaSystemAppearance': 'False'," \
+          "        'NSHumanReadableCopyright': 'Copyright 2025 - 2026 KenanZhu. All rights reserved.'," \
+          '    },' \
+          ')' \
+          > Main.spec
+
+        echo "✓ Main.spec generated successfully"
+        echo ""
+        echo "========================================"
+        echo "Generated Main.spec"
+        echo "========================================"
+        cat Main.spec
+        echo "========================================"
+
+    - name: Build with PyInstaller
+      run: |
+        python -m PyInstaller Main.spec
+
+    - name: Create DMG
+      run: |
+        tag_name="${{ steps.get_version.outputs.TAG_NAME }}"
+        dmg_name="AutoLibrary.$tag_name-macos-arm64.dmg"
+        app_path="dist/AutoLibrary.app"
+
+        if [ ! -d "$app_path" ]; then
+          echo "✗ App bundle not found: $app_path"
+          echo "Files in dist directory:"
+          ls -la dist/
+          exit 1
+        fi
+
+        echo "Creating DMG from: $app_path"
+        xattr -cr "$app_path" 2>/dev/null || true
+
+        tmp_dmg_dir=$(mktemp -d)
+        cp -R "$app_path" "$tmp_dmg_dir/"
+        ln -s /Applications "$tmp_dmg_dir/Applications"
+
+        hdiutil create \
+          -volname "AutoLibrary $tag_name" \
+          -srcfolder "$tmp_dmg_dir" \
+          -ov \
+          -format UDZO \
+          "$dmg_name"
+
+        rm -rf "$tmp_dmg_dir"
+
+        if [ -f "$dmg_name" ]; then
+          dmg_size=$(du -h "$dmg_name" | cut -f1)
+          echo "✓ DMG created: $dmg_name (Size: $dmg_size)"
+        else
+          echo "✗ Failed to create DMG"
+          exit 1
+        fi
+
+        echo "✓ Artifacts ready:"
+        echo "  - $dmg_name"
+        echo "  - $app_path"
+
+    - name: Archive artifacts
+      uses: actions/upload-artifact@v6
+      with:
+        name: AutoLibrary.${{ steps.get_version.outputs.TAG_NAME }}-macos-arm64
+        path: |
+          AutoLibrary.${{ steps.get_version.outputs.TAG_NAME }}-macos-arm64.dmg
+          dist/AutoLibrary.app/**
+        retention-days: ${{ inputs.is_test == 'true' && 7 || 90 }}
+
+    - name: Upload build summary
+      if: ${{ inputs.is_test == 'true' }}
+      run: |
+        tag_name="${{ steps.get_version.outputs.TAG_NAME }}"
+        version="${{ steps.get_version.outputs.VERSION }}"
+        dmg_name="AutoLibrary.$tag_name-macos-arm64.dmg"
+
+        {
+          echo "## Build Summary (macOS)"
+          echo ""
+          echo "========================================"
+          echo "✓ Build test completed successfully!"
+          echo "- Version: $version"
+          echo "- Tag: $tag_name"
+          echo "- Event: ${{ github.event_name }}"
+          echo "- Ref: ${{ github.ref }}"
+          echo "- DMG: $dmg_name"
+          echo ""
+          echo "### How to test on macOS"
+          echo '1. Download the DMG artifact'
+          echo '2. Open the DMG and drag AutoLibrary.app to /Applications'
+          echo '3. Right-click → Open the app (to bypass Gatekeeper)'
+        } >> $GITHUB_STEP_SUMMARY

.github/workflows/commit-release.yml

@@ -83,7 +83,9 @@ jobs:
 
         echo "✓ File replaced: $FILE_PATH"
         echo ""
-        echo "Updated file content ==================="
+        echo "========================================"
+        echo "Updated file content"
+        echo "========================================"
         cat  "$FILE_PATH"
         echo "========================================"
 
@@ -151,3 +153,9 @@ jobs:
         COMMIT_SHA=$(git rev-parse --short HEAD)
         echo "commit_sha=$COMMIT_SHA" >> $GITHUB_OUTPUT
         echo "✓ New commit SHA: $COMMIT_SHA"
+        echo "## Commit Release Summary" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "========================================" >> $GITHUB_STEP_SUMMARY
+        echo "- Version: ${{ inputs.version }}" >> $GITHUB_STEP_SUMMARY
+        echo "- Tag: ${{ inputs.tag_name }}" >> $GITHUB_STEP_SUMMARY
+        echo "- Commit SHA: $COMMIT_SHA" >> $GITHUB_STEP_SUMMARY

.github/workflows/release.yml

@@ -21,8 +21,10 @@ name: Release
 #       Commits version changes to release branch and creates the release tag.
 
 # 4. Build:
-#       Compiles the application for Windows platform using PyInstaller, and
-#       archives the built artifacts as 'AutoLibrary.<tag_name>-windows-x86_64.zip'.
+#       Compiles the application for Windows and macOS platforms using PyInstaller, and
+#       archives the built artifacts.
+#       - Windows: AutoLibrary.<tag_name>-windows-x86_64.zip
+#       - macOS:   AutoLibrary.<tag_name>-macos-arm64.dmg
 
 # 5. Release:
 #       Creates GitHub release with generated artifacts and release notes
@@ -47,7 +49,7 @@ on:
 jobs:
   #
   # Start :
-  #   virtual job that indacates the start of the release process
+  #   virtual job that indicates the start of the release process
   #
 
   start:
@@ -158,7 +160,7 @@ jobs:
     needs:
       - update-version
       - commit-release
-    if: always() && needs.update-version.result == 'success' && needs.commit-release.result == 'success'
+    if: always() && needs.update-version.result == 'success' && (needs.commit-release.result == 'success' || needs.commit-release.result == 'skipped')
     uses: ./.github/workflows/build.yml
     permissions:
       contents: write
@@ -181,12 +183,18 @@ jobs:
       contents: write
 
     steps:
-    - name: Download artifacts
+    - name: Download Windows artifacts
       uses: actions/download-artifact@v6
       with:
         name: AutoLibrary.${{ needs.extract-version.outputs.tag_name }}-windows-x86_64
         path: artifacts/
 
+    - name: Download macOS artifacts
+      uses: actions/download-artifact@v6
+      with:
+        name: AutoLibrary.${{ needs.extract-version.outputs.tag_name }}-macos-arm64
+        path: artifacts/
+
     - name: Create release
       id: create_release
       uses: softprops/action-gh-release@v2
@@ -195,6 +203,7 @@ jobs:
         name: AutoLibrary ${{ needs.extract-version.outputs.tag_name }}
         files: |
           artifacts/AutoLibrary.${{ needs.extract-version.outputs.tag_name }}-windows-x86_64.zip
+          artifacts/AutoLibrary.${{ needs.extract-version.outputs.tag_name }}-macos-arm64.dmg
         draft: false
         prerelease: ${{ needs.extract-version.outputs.is_rc == 'true' }}
         generate_release_notes: true
@@ -205,7 +214,7 @@ jobs:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
   # End :
-  #   virtual job that indacates the end of the release process
+  #   virtual job that indicates the end of the release process
   #
 
   end:
@@ -227,7 +236,7 @@ jobs:
       - release
       - extract-version
       - commit-release
-    if: ${{ needs.release.result == 'success' && needs.commit-release.result == 'success' }}
+    if: ${{ needs.release.result == 'success' && (needs.commit-release.result == 'success' || needs.commit-release.result == 'skipped') }}
     runs-on: ubuntu-latest
     permissions:
       contents: write
@@ -267,9 +276,13 @@ jobs:
         git checkout ${MAIN_BRANCH}
 
         # Show branch status before merge
-        echo "=== Branch status before merge ==="
+        echo "========================================"
+        echo "Branch status before merge"
+        echo "========================================"
         git log --oneline --graph --all -5
-        echo "=== Diff between ${MAIN_BRANCH} and origin/${BRANCH_NAME} ==="
+        echo "========================================"
+        echo "Diff: ${MAIN_BRANCH} vs origin/${BRANCH_NAME}"
+        echo "========================================"
         git diff ${MAIN_BRANCH} origin/${BRANCH_NAME} --stat || echo "No differences found"
 
         # Force create a merge commit even if there are no changes
@@ -279,7 +292,9 @@ jobs:
           -m "chore(release): merge ${BRANCH_NAME} to ${MAIN_BRANCH} [auto release commit]"
 
         # Show merge result
-        echo "=== Merge result ==="
+        echo "========================================"
+        echo "Merge result"
+        echo "========================================"
         git log --oneline --graph -3
 
         # Push to main
@@ -310,6 +325,7 @@ jobs:
 
         echo "## Release Cleanup Summary" >> $GITHUB_STEP_SUMMARY
         echo "" >> $GITHUB_STEP_SUMMARY
+        echo "========================================" >> $GITHUB_STEP_SUMMARY
         echo "✓ Release completed successfully!" >> $GITHUB_STEP_SUMMARY
         echo "" >> $GITHUB_STEP_SUMMARY
         echo "### Actions Performed:" >> $GITHUB_STEP_SUMMARY

.github/workflows/update-version.yml

@@ -128,10 +128,15 @@ jobs:
         echo "Build version file location: $VER_INFO_BUILDFILE"
         echo "Commit version file location: $VER_INFO_COMMITFILE"
         echo ""
-        echo "Build version ALVersionInfo.py content ="
+        echo "========================================"
+        echo "Build version ALVersionInfo.py"
+        echo "========================================"
         cat "$VER_INFO_BUILDFILE"
+        echo "========================================"
         echo ""
-        echo "Commit version ALVersionInfo.py content "
+        echo "========================================"
+        echo "Commit version ALVersionInfo.py"
+        echo "========================================"
         cat "$VER_INFO_COMMITFILE"
         echo "========================================"
 
@@ -140,11 +145,16 @@ jobs:
       run: |
         if git diff --quiet src/gui/ALVersionInfo.py; then
           echo "has_changes=false" >> $GITHUB_OUTPUT
-          echo "! No changes detected in ALVersionInfo.py"
+          echo "⚠ No changes detected in ALVersionInfo.py"
         else
           echo "has_changes=true" >> $GITHUB_OUTPUT
           echo "✓ ALVersionInfo.py has been modified"
         fi
+        echo "## Update Version Summary" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "========================================" >> $GITHUB_STEP_SUMMARY
+        echo "- Version: ${{ steps.get_version.outputs.VERSION }}" >> $GITHUB_STEP_SUMMARY
+        echo "- Tag: ${{ steps.get_version.outputs.TAG_NAME }}" >> $GITHUB_STEP_SUMMARY
 
     - name: Upload modified ALVersionInfo.py ready for build
       if: steps.check_changes.outputs.has_changes == 'true'

README.md

@@ -2,7 +2,7 @@
 # AutoLibrary
 ---
 
-![AutoLibrary Logo](./src/gui/resources/icons/AutoLibrary_128x128.ico)
+![AutoLibrary Logo](./src/gui/resources/icons/AutoLibrary_Logo_128.svg)
 
 [![GitHub stars](https://img.shields.io/github/stars/KenanZhu/AutoLibrary.svg?style=social&label=Star)](https://github.com/KenanZhu/AutoLibrary)
 ![License](https://img.shields.io/github/license/KenanZhu/AutoLibrary?label=license)
@@ -25,7 +25,7 @@
 6. 定时任务 - 使用内置定时任务管理，添加定时任务，指定时间后按当前预约信息自动运行，支持设置重复任务
 7. 驱动管理 - 内置浏览器驱动自动管理，支持自动检测浏览器版本并下载对应驱动，无需手动下载
 
-*具体操作方法和注意事项请访问我们的 [帮助手册](https://www.autolibrary.kenanzhu.com/manuals)*
+*具体操作方法和注意事项请访问我们的 [帮助手册](https://manuals.autolibrary.kenanzhu.com)*
 
 ### 如何使用
 

manuals/README.md

@@ -0,0 +1,3 @@
+This folder is used to store the manuals.
+
+Our manuals are available at https://manuals.autolibrary.kenanzhu.com

manuals/readme.md

@@ -1,3 +0,0 @@
-This folder is used to store the manuals.
-
-Our manuals are available at https://www.autolibrary.kenanzhu.com/manuals

requirements.txt

@@ -0,0 +1,39 @@
+attrs==26.1.0
+certifi==2026.2.25
+cffi==2.0.0
+charset-normalizer==3.4.6
+ddddocr==1.0.6
+flatbuffers==25.12.19
+h11==0.16.0
+idna==3.11
+lupa==2.8
+mpmath==1.3.0
+numpy==2.4.3
+onnxruntime==1.24.4
+outcome==1.3.0.post0
+packaging==26.0
+pefile==2024.8.26
+pillow==12.1.1
+protobuf==7.34.0
+pybrowsers==1.3.2
+pycparser==3.0
+pyinstaller==6.19.0
+pyinstaller-hooks-contrib==2026.3
+PySide6==6.10.2
+PySide6_Addons==6.10.2
+PySide6_Essentials==6.10.2
+PySocks==1.7.1
+pywin32-ctypes==0.2.3
+requests==2.32.5
+selenium==4.38.0
+setuptools==82.0.1
+shiboken6==6.10.2
+sniffio==1.3.1
+sortedcontainers==2.4.0
+sympy==1.14.0
+trio==0.33.0
+trio-websocket==0.12.2
+typing_extensions==4.15.0
+urllib3==2.6.3
+websocket-client==1.9.0
+wsproto==1.3.2

src/Main.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2025 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -22,9 +22,9 @@ def main():
 
     app = QApplication(sys.argv)
     translator = QTranslator()
-    if translator.load(":/res/trans/translators/qtbase_zh_CN.ts"):
+    if translator.load(":/res/translators/qtbase_zh_CN.ts"):
         app.installTranslator(translator)
-    app.setStyle('Fusion')
+    app.setStyle("Fusion")
     app.setApplicationName("AutoLibrary")
     if not initializeApp():
         sys.exit(-1)

src/autoscript/ASEngine.py

@@ -0,0 +1,262 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from datetime import (
+    date,
+    datetime,
+)
+
+from lupa import LuaRuntime as _LuaRuntime
+
+from autoscript._helpers import (
+    _TYPE_DEFAULT_VAR,
+    _assignPath,
+    _checkDateFormat,
+    _checkTimeFormat,
+    _checkType,
+    _cleanLuaError,
+    _navigatePath,
+)
+
+try:
+    from lupa.lua55 import LuaError as _LuaError, LuaSyntaxError as _LuaSyntaxError
+except ImportError:
+    try:
+        from lupa.lua54 import LuaError as _LuaError, LuaSyntaxError as _LuaSyntaxError
+    except ImportError:
+        _LuaError = Exception
+        _LuaSyntaxError = Exception
+
+
+__all__ = ["ASEngine"]
+
+
+class ASEngine:
+
+    @staticmethod
+    def getCurrentDate(
+    ) -> str:
+
+        return date.today().isoformat()
+
+    @staticmethod
+    def getCurrentTime(
+    ) -> str:
+
+        return datetime.now().strftime("%H:%M")
+
+    @staticmethod
+    def _sandbox(
+        lua,
+    ) -> None:
+
+        lua.execute("""
+            io = nil
+            require = nil
+            dofile = nil
+            loadfile = nil
+            load = nil
+            package = nil
+            rawget = nil
+            rawset = nil
+            rawequal = nil
+            getfenv = nil
+            setfenv = nil
+            debug = nil
+            if os then
+                os.execute = nil
+                os.exit = nil
+                os.getenv = nil
+                os.remove = nil
+                os.rename = nil
+                os.tmpname = nil
+                os.setlocale = nil
+            end
+        """)
+
+    @staticmethod
+    def _registerHelpers(
+        lua,
+    ) -> None:
+
+        lua.execute("""
+            function date(y, m, d)
+                return os.time({year = y, month = m, day = d})
+            end
+
+            function time(h, m)
+                return h * 60 + m
+            end
+
+            function datenow()
+                local now = os.date("*t")
+                return os.time({year = now.year, month = now.month, day = now.day})
+            end
+
+            function timenow()
+                local now = os.date("*t")
+                return now.hour * 60 + now.min
+            end
+
+            function dateadd(date_val, n)
+                return date_val + n * 86400
+            end
+
+            function timeadd(time_val, n)
+                return (time_val + n * 60) % 1440
+            end
+
+            function strtodate(iso_str)
+                local y, m, d = iso_str:match("(%d+)-(%d+)-(%d+)")
+                return os.time({year = y, month = m, day = d})
+            end
+
+            function strtotime(hm_str)
+                local h, m = hm_str:match("(%d+):(%d+)")
+                return h * 60 + m
+            end
+
+            function datetostr(ts)
+                return os.date("%Y-%m-%d", ts)
+            end
+
+            function timetostr(m)
+                return string.format("%02d:%02d", math.floor(m / 60), m % 60)
+            end
+        """)
+
+    def __init__(
+        self,
+        targetVars: list[tuple] = None,
+    ):
+
+        self._targetVars: dict[str, dict] = {}
+        self._lua = None
+
+        if targetVars:
+            for item in targetVars:
+                name, varType, keyPath = item[0], item[1], item[2]
+                self.addTargetVar(name, varType, keyPath)
+
+    def _getLua(
+        self,
+    ):
+
+        if self._lua is None:
+            self._lua = _LuaRuntime(unpack_returned_tuples=True)
+            self._sandbox(self._lua)
+            self._registerHelpers(self._lua)
+        return self._lua
+
+    def _push(
+        self,
+        targetData: dict,
+    ) -> None:
+
+        lua = self._getLua()
+        g = lua.globals()
+        strToDate = g["strtodate"]
+        strToTime = g["strtotime"]
+
+        for varName, info in self._targetVars.items():
+            keyPath = info["keyPath"]
+            vt = info["type"]
+            raw = _navigatePath(targetData, keyPath)
+            if vt == "Date":
+                if not isinstance(raw, str) or not raw.strip():
+                    raise ValueError(
+                        f"Date 类型变量 '{varName}' 对应的数据为空或不是字符串类型，"
+                        f"请检查路径 {keyPath} 的值是否为合法的日期字符串 (YYYY-MM-DD)"
+                    )
+                raw = raw.strip()
+                _checkDateFormat(raw, varName)
+                g[varName] = strToDate(raw)
+            elif vt == "Time":
+                if not isinstance(raw, str) or not raw.strip():
+                    raise ValueError(
+                        f"Time 类型变量 '{varName}' 对应的数据为空或不是字符串类型，"
+                        f"请检查路径 {keyPath} 的值是否为合法的时间字符串 (HH:MM)"
+                    )
+                raw = raw.strip()
+                _checkTimeFormat(raw, varName)
+                g[varName] = strToTime(raw)
+            else:
+                if raw is None:
+                    raw = _TYPE_DEFAULT_VAR.get(vt, False)
+                g[varName] = raw
+
+    def _pull(
+        self,
+        targetData: dict,
+    ) -> None:
+
+        lua = self._getLua()
+        g = lua.globals()
+        dateToStr = g["datetostr"]
+        timeToStr = g["timetostr"]
+
+        for varName, info in self._targetVars.items():
+            try:
+                luaVal = g[varName]
+            except KeyError:
+                continue
+            vt = info["type"]
+            if vt == "Date":
+                luaVal = dateToStr(luaVal)
+            elif vt == "Time":
+                luaVal = timeToStr(luaVal)
+            elif vt == "Float" and isinstance(luaVal, int) and not isinstance(luaVal, bool):
+                luaVal = float(luaVal)
+            _checkType(varName, vt, luaVal)
+            _assignPath(targetData, info["keyPath"], luaVal)
+
+    def addTargetVar(
+        self,
+        name: str,
+        varType: str,
+        keyPath: list,
+    ) -> None:
+
+        upperName = name.upper().strip()
+        self._targetVars[upperName] = {
+            "type": varType,
+            "keyPath": keyPath,
+        }
+
+    def execute(
+        self,
+        scriptText: str,
+        targetData: dict,
+    ) -> None:
+
+        if not scriptText or not scriptText.strip():
+            return
+        try:
+            self._push(targetData)
+            self._getLua().execute(scriptText)
+            self._pull(targetData)
+        except _LuaSyntaxError as e:
+            raise ValueError(
+                f"AutoScript 语法错误: {_cleanLuaError(str(e))}"
+            )
+        except _LuaError as e:
+            raise ValueError(
+                f"AutoScript 运行时错误: {_cleanLuaError(str(e))}"
+            )
+        except ValueError as e:
+            raise ValueError(f"AutoScript 数据错误: {e}")
+        except Exception as e:
+            raise ValueError(f"AutoScript 未知错误: {e}")
+
+    def reset(
+        self,
+    ) -> None:
+
+        self._targetVars = {}
+        self._lua = None

src/autoscript/__init__.py

@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from .ASEngine import ASEngine
+
+__version__ = "1.0.0" # autoscript version
+
+_TARGET_VAR_DEFS = [
+    ("USERNAME",           "String",  ["username"],                           "用户名"),
+    ("USER_ENABLE",        "Boolean", ["enabled"],                            "用户启用"),
+    ("RESERVE_DATE",       "Date",    ["reserve_info", "date"],               "预约日期"),
+    ("RESERVE_BEGIN_TIME", "Time",    ["reserve_info", "begin_time", "time"], "预约开始时间"),
+    ("RESERVE_END_TIME",   "Time",    ["reserve_info", "end_time",   "time"], "预约结束时间"),
+]
+_MOCK_TYPE_VALUES = {
+    "String": "__mock__",
+    "Boolean": True,
+    "Date": "2099-01-01",
+    "Time": "00:00",
+    "Int": 0,
+    "Float": 0.0,
+}
+
+
+def createAllVariablesTable(
+) -> dict:
+
+    return {
+        displayName: (name, varType)
+        for name, varType, _, displayName in _TARGET_VAR_DEFS
+    }
+
+def createTargetVarDefs(
+) -> list:
+
+    return list(_TARGET_VAR_DEFS)
+
+def createMockTargetData(
+) -> dict:
+
+    data = {}
+    for _, varType, keyPath, _ in _TARGET_VAR_DEFS:
+        d = data
+        for key in keyPath[:-1]:
+            d = d.setdefault(key, {})
+        d[keyPath[-1]] = _MOCK_TYPE_VALUES.get(varType, "")
+    return data
+
+def createEngine(
+) -> ASEngine:
+
+    return ASEngine(_TARGET_VAR_DEFS)

src/autoscript/_helpers.py

@@ -0,0 +1,153 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from datetime import (
+    date,
+    datetime,
+)
+
+
+_TYPE_DEFAULT_VAR: dict[str, str | int | float | bool] = {
+    "String": "",
+    "Int": 0,
+    "Float": 0.0,
+    "Boolean": False,
+}
+
+
+def _navigatePath(
+    data: dict,
+    keyPath: list,
+    default=None,
+):
+
+    d = data
+    for key in keyPath[:-1]:
+        d = d.get(key, {})
+        if not isinstance(d, dict):
+            return default
+    return d.get(keyPath[-1], default)
+
+def _assignPath(
+    data: dict,
+    keyPath: list,
+    value,
+) -> None:
+
+    d = data
+    for key in keyPath[:-1]:
+        d = d.setdefault(key, {})
+    d[keyPath[-1]] = value
+
+def _checkDateFormat(
+    dateStr: str,
+    varName: str = "",
+) -> None:
+
+    prefix = f"Date 类型变量 '{varName}' 的" if varName else ""
+    try:
+        date.fromisoformat(dateStr)
+    except ValueError:
+        raise ValueError(
+            f"{prefix}值 '{dateStr}' 不是合法的日期格式，"
+            f"应为 YYYY-MM-DD"
+        )
+
+def _checkTimeFormat(
+    timeStr: str,
+    varName: str = "",
+) -> None:
+
+    prefix = f"Time 类型变量 '{varName}' 的" if varName else ""
+    try:
+        datetime.strptime(timeStr, "%H:%M")
+    except ValueError:
+        raise ValueError(
+            f"{prefix}值 '{timeStr}' 不是合法的时间格式，"
+            f"应为 HH:MM"
+        )
+
+def _checkType(
+    varName: str,
+    varType: str,
+    value,
+) -> None:
+
+    if varType == "Date":
+        if not isinstance(value, str):
+            raise ValueError(
+                f"Date 类型变量 '{varName}' 只能接受日期字符串，"
+                f"不能接受 {_pyTypeToASType(value)} 类型"
+            )
+        _checkDateFormat(value, varName)
+        return
+    if varType == "Time":
+        if not isinstance(value, str):
+            raise ValueError(
+                f"Time 类型变量 '{varName}' 只能接受时间字符串，"
+                f"不能接受 {_pyTypeToASType(value)} 类型"
+            )
+        _checkTimeFormat(value, varName)
+        return
+    if varType == "Int":
+        if isinstance(value, bool):
+            raise ValueError(
+                f"Int 类型变量 '{varName}' 不能接受 Boolean 类型的值"
+            )
+        if not isinstance(value, int) and not (isinstance(value, float) and value == int(value)):
+            raise ValueError(
+                f"Int 类型变量 '{varName}' 不能接受 {_pyTypeToASType(value)} 类型的值"
+            )
+        return
+    if varType == "Float":
+        if isinstance(value, bool):
+            raise ValueError(
+                f"Float 类型变量 '{varName}' 不能接受 Boolean 类型的值"
+            )
+        if not isinstance(value, (int, float)):
+            raise ValueError(
+                f"Float 类型变量 '{varName}' 不能接受 {_pyTypeToASType(value)} 类型的值"
+            )
+        return
+    if varType == "Boolean":
+        if not isinstance(value, bool):
+            raise ValueError(
+                f"Boolean 类型变量 '{varName}' 不能接受 {_pyTypeToASType(value)} 类型的值"
+            )
+        return
+    if varType == "String":
+        if not isinstance(value, str):
+            raise ValueError(
+                f"String 类型变量 '{varName}' 不能接受 {_pyTypeToASType(value)} 类型的值"
+            )
+        return
+
+def _pyTypeToASType(
+    value,
+) -> str:
+
+    if isinstance(value, bool):
+        return "Boolean"
+    if isinstance(value, int):
+        return "Int"
+    if isinstance(value, float):
+        return "Float"
+    if isinstance(value, str):
+        return "String"
+    return "Unknown"
+
+def _cleanLuaError(
+    rawMsg: str,
+) -> str:
+
+    msg = rawMsg.replace('[string "<python>"]:', "").strip()
+    stackIdx = msg.find("stack traceback:")
+    if stackIdx != -1:
+        msg = msg[:stackIdx].strip()
+    return msg

src/base/LibOperator.py

@@ -1,37 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Copyright (c) 2025 - 2026 KenanZhu.
-All rights reserved.
-
-This software is provided "as is", without any warranty of any kind.
-You may use, modify, and distribute this file under the terms of the MIT License.
-See the LICENSE file for details.
-"""
-import queue
-
-from base.MsgBase import MsgBase
-
-
-class LibOperator(MsgBase):
-    """
-        Base abstract class for library operation.
-
-        This class provides the foundation for library-related operations, inheriting
-        message handling and tracing abilities from MsgBase. It serves as an abstract
-        base class that must be subclassed to implement specific library functionality.
-    """
-
-    def __init__(
-        self,
-        input_queue: queue.Queue,
-        output_queue: queue.Queue
-    ):
-
-        super().__init__(input_queue, output_queue)
-
-
-    def _waitResponseLoad(
-        self
-    ) -> bool:
-
-        pass

src/base/LibTimeSelector.py

@@ -1,141 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Copyright (c) 2025 - 2026 KenanZhu.
-All rights reserved.
-
-This software is provided "as is", without any warranty of any kind.
-You may use, modify, and distribute this file under the terms of the MIT License.
-See the LICENSE file for details.
-"""
-import queue
-
-from datetime import datetime
-
-from base.LibOperator import LibOperator
-
-
-class LibTimeSelector(LibOperator):
-    """
-        Base class for time selection operations.
-
-        This class provides common time selection logic for reservation and renewal
-        operations, including time conversion utilities and best time option finding.
-    """
-
-    def __init__(
-        self,
-        input_queue: queue.Queue,
-        output_queue: queue.Queue
-    ):
-
-        super().__init__(input_queue, output_queue)
-
-    @staticmethod
-    def _timeStrToMins(
-        time_str: str
-    ) -> int:
-
-        """
-            Convert time string "HH:MM" to minutes since midnight.
-
-            Example:
-                "10:00" -> 600
-                "13:30" -> 810
-        """
-        hour, minute = map(int, time_str.split(":"))
-        return hour*60 + minute
-
-    @staticmethod
-    def _minsToTimeStr(
-        mins: int
-    ) -> str:
-
-        """
-            Convert minutes since midnight to time string "HH:MM".
-
-            Example:
-                600 -> "10:00"
-                810 -> "13:30"
-        """
-        hour, minute = divmod(int(mins), 60)
-        return f"{hour:02d}:{minute:02d}"
-
-
-    def _formatTimeRelation(
-        self,
-        abs_diff: int,
-        actual_diff: int,
-        time_type: str
-    ) -> str:
-
-        """
-            Format time difference relation string.
-        """
-        if actual_diff < 0:
-            return f"早了 {abs_diff} 分钟"
-        elif actual_diff > 0:
-            return f"晚了 {abs_diff} 分钟"
-        else:
-            return f"正好等于 {time_type}"
-
-
-    def _findBestTimeOption(
-        self,
-        time_options: list,
-        target_time: int,
-        max_time_diff: int,
-        prefer_earlier: bool,
-        is_reserve: bool = True
-    ) -> tuple:
-        """
-            Find the best time option from available times.
-
-            Args:
-                time_options: List of WebElement time options
-                target_time: Target time in minutes
-                max_time_diff: Maximum acceptable time difference in minutes
-                prefer_earlier: If True, prefer earlier times when diffs are equal
-                is_reserve: If True, parse 'time' attribute; if False, parse 'id' attribute
-
-            Returns:
-                Tuple of (best_time_element, best_time_text, actual_diff, free_times_list)
-                or (None, None, None, []) if no suitable option found
-        """
-        free_times = []
-        best_time_diff = max_time_diff
-        best_actual_diff = None
-        best_time_opt = None
-
-        for time_opt in time_options:
-            # Parse time value based on context
-            if is_reserve:
-                # Reservation context: parse 'time' attribute
-                time_attr = time_opt.get_attribute("time")
-                if time_attr == "now":
-                    now = datetime.now()
-                    time_val = now.hour*60 + now.minute
-                elif time_attr and time_attr.isdigit():
-                    time_val = int(time_attr)
-                else:
-                    continue
-            else:
-                # Renewal context: parse 'id' attribute
-                time_attr = time_opt.get_attribute("id")
-                if not (time_attr and time_attr.isdigit()):
-                    continue
-                time_val = int(time_attr)
-            free_times.append(time_opt.text.strip() if not is_reserve else self._minsToTimeStr(time_val))
-            actual_diff = time_val - target_time
-            abs_diff = abs(actual_diff)
-
-            # Update best option if current is better
-            if (abs_diff < best_time_diff or
-                (abs_diff == best_time_diff and
-                 ((prefer_earlier and actual_diff <= 0) or
-                  (not prefer_earlier and actual_diff >= 0)))):
-                best_time_diff = abs_diff
-                best_actual_diff = actual_diff
-                best_time_opt = time_opt
-        if best_time_opt is not None:
-            return (best_time_opt, best_time_opt.text.strip(), best_actual_diff, free_times)
-        return (None, None, None, free_times)

src/base/MsgBase.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2025 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -11,7 +11,7 @@ import logging
 import queue
 import datetime
 
-from managers.log.LogManager import getLogger
+import managers.log.LogManager as LogManager
 
 
 class MsgBase:
@@ -54,11 +54,10 @@ class MsgBase:
         self._input_queue = input_queue
         self._output_queue = output_queue
         try:
-            self._logger = getLogger(self._class_name)
+            self._logger = LogManager.getLogger(self._class_name)
         except RuntimeError:
             self._logger = None
 
-
     def _showMsg(
         self,
         msg: str
@@ -66,7 +65,6 @@ class MsgBase:
 
         self._output_queue.put(f"[{self._class_name:<15}] >>> : {msg}")
 
-
     def _showTrace(
         self,
         msg: str,
@@ -79,7 +77,6 @@ class MsgBase:
         if self._logger and not no_log:
             self._logger.log(level, msg)
 
-
     def _showLog(
         self,
         msg: str,
@@ -89,7 +86,6 @@ class MsgBase:
         if self._logger:
             self._logger.log(level, msg)
 
-
     def _waitMsg(
         self,
         timeout: float = 1.0

src/base/__init__.py

@@ -1,8 +1,9 @@
-
+# -*- coding: utf-8 -*-
 """
-    Base module for the AutoLibrary project.
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
 
-    Here are the classes and modules in this package:
-    - MsgBase: Base class for messages.\
-    - LibOperator: Base class for library operators.
-"""
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""

src/boot/AppInitializer.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2026 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -16,7 +16,7 @@ from managers.config.ConfigManager import instance as configInstance
 from managers.driver.WebDriverManager import instance as webdriverInstance
 
 
-def initializeLogManager(
+def _initializeLogManager(
 ) -> bool:
 
     app_dir = QStandardPaths.writableLocation(QStandardPaths.StandardLocation.AppDataLocation)
@@ -27,7 +27,7 @@ def initializeLogManager(
     logInstance(log_dir)
     return True
 
-def initializeConfigManager(
+def _initializeConfigManager(
 ) -> bool:
 
     logger = logInstance().getLogger("AppInitializer")
@@ -49,16 +49,15 @@ def initializeConfigManager(
     configInstance(new_config_dir)
     return True
 
-def initializeWebDriverManager(
+def _initializeWebDriverManager(
 ) -> bool:
 
     logger = logInstance().getLogger("AppInitializer")
 
     app_dir = QStandardPaths.writableLocation(QStandardPaths.StandardLocation.AppDataLocation)
     driver_dir = os.path.join(app_dir, "drivers")
-    logger.info("初始化驱动目录 %s", driver_dir)
     if not QDir(driver_dir).exists():
-        logger.error("创建驱动目录 %s 失败", driver_dir)
+        logger.info("初始化驱动目录 %s", driver_dir)
         if not QDir().mkpath(driver_dir):
             logger.error("创建驱动目录 %s 失败", driver_dir)
             return False
@@ -67,11 +66,17 @@ def initializeWebDriverManager(
 
 def initializeApp(
 ) -> bool:
+    """
+        Initialize the application components
 
-    if not initializeLogManager():
+        Order:
+            LogManager -> ConfigManager -> WebDriverManager
+    """
+
+    if not _initializeLogManager():
         return False
-    if not initializeConfigManager():
+    if not _initializeConfigManager():
         return False
-    if not initializeWebDriverManager():
+    if not _initializeWebDriverManager():
         return False
     return True

src/boot/__init__.py

@@ -1,6 +1,9 @@
+# -*- coding: utf-8 -*-
 """
-    Boot module for the AutoLibrary project.
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
 
-    Here are the classes and modules in this package:
-    - AppInitializer: Application initializer class.
-"""
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""

src/gui/ALAboutDialog.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2025 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -9,18 +9,23 @@ See the LICENSE file for details.
 """
 import platform
 
-from PySide6.QtGui import (
-    QIcon, QFont
-)
-from PySide6.QtWidgets import (
-    QDialog, QApplication
-)
 from PySide6.QtCore import (
-    QTimer, Qt
+    Qt,
+    QTimer
+)
+from PySide6.QtGui import QIcon
+from PySide6.QtWidgets import (
+    QApplication,
+    QDialog,
+    QTabWidget,
+    QTextBrowser
 )
 
 from gui.ALVersionInfo import (
-    AL_VERSION, AL_COMMIT_SHA, AL_COMMIT_DATE, AL_BUILD_DATE
+    AL_VERSION,
+    AL_COMMIT_SHA,
+    AL_COMMIT_DATE,
+    AL_BUILD_DATE
 )
 from gui.resources.ui.Ui_ALAboutDialog import Ui_ALAboutDialog
 from gui.resources import ALResource
@@ -38,19 +43,28 @@ class ALAboutDialog(QDialog, Ui_ALAboutDialog):
         self.modifyUi()
         self.connectSignals()
 
-
     def modifyUi(
         self
     ):
 
-        self.LogoIconLabel.setPixmap(QIcon(":/res/icon/icons/AutoLibrary_32x32.ico").pixmap(48, 48))
-        info_text = self.generateAboutText()
-        self.AboutInfoBrowser.setHtml(info_text)
-        browser_font = self.AboutInfoBrowser.font()
-        browser_font.setFamily("Courier New")
-        self.AboutInfoBrowser.setFont(browser_font)
-        self.AboutInfoBrowser.setTextInteractionFlags(Qt.TextBrowserInteraction)
-
+        self.LogoIconLabel.setPixmap(QIcon(":/res/icons/AutoLibrary_Logo_64.svg").pixmap(48, 48))
+        self.TabWidget = QTabWidget()
+        self.TabWidget.setDocumentMode(True)
+        AboutBrowser = QTextBrowser()
+        AboutBrowser.setHtml(self.generateAboutText())
+        AboutBrowser.setOpenExternalLinks(True)
+        AboutBrowser.setLineWrapMode(QTextBrowser.LineWrapMode.NoWrap)
+        AboutBrowser.setTextInteractionFlags(Qt.TextBrowserInteraction)
+        BrowserFont = AboutBrowser.font()
+        BrowserFont.setFamilies(["Courier New", "Consolas", "Menlo", "DejaVu Sans Mono", "monospace"])
+        AboutBrowser.setFont(BrowserFont)
+        self.TabWidget.addTab(AboutBrowser, "关于")
+        LicenseBrowser = QTextBrowser()
+        LicenseBrowser.setHtml(self.generateLicenseText())
+        LicenseBrowser.setOpenExternalLinks(True)
+        LicenseBrowser.setTextInteractionFlags(Qt.TextBrowserInteraction)
+        self.TabWidget.addTab(LicenseBrowser, "许可证")
+        self.AboutInfoLayout.addWidget(self.TabWidget)
 
     def connectSignals(
         self
@@ -58,39 +72,61 @@ class ALAboutDialog(QDialog, Ui_ALAboutDialog):
 
         self.CopyButton.clicked.connect(self.copyAboutInfo)
 
-
     def generateAboutText(
         self
     ) -> str:
 
         os_info = self.getOSInfo()
+        run_on = f"{os_info['system']} {os_info['version']} {os_info['architecture']}"
+        selenium_ver = self.getSeleniumVersion()
         about_text = f"""
-<h4>Version Information:</h4>
-Version: {AL_VERSION}<br>
+<b style="font-size:14px;">VERSION: {AL_VERSION}</b><br>
 Commit SHA: {AL_COMMIT_SHA}<br>
 Commit date: {AL_COMMIT_DATE}<br>
 Build date: {AL_BUILD_DATE}<br>
-Python version: {platform.python_version()}<br>
-Qt version: {self.getQtVersion()}<br>
-
-<h4>System Information:</h4>
+<br>
+<b style="font-size:14px;">SYSTEM</b><br>
+Running on: {run_on}<br>
 Processor: {platform.processor()}<br>
-Operating system: {os_info['system']}<br>
-System version: {os_info['version']}<br>
-System architecture: {os_info['architecture']}<br>
-
-<h4>Project Information:</h4>
-License: MIT License<br>
-Project repository: <a href="https://www.github.com/KenanZhu/AutoLibrary" style="text-decoration: none;">https://www.github.com/KenanZhu/AutoLibrary</a><br>
-Project website: <a href="https://www.autolibrary.kenanzhu.com" style="text-decoration: none;">https://www.autolibrary.kenanzhu.com</a><br>
-
-<h4>Author Information:</h4>
-Developer: KenanZhu<br>
-Contact: nanoki_zh@163.com<br>
-GitHub: <a href="https://www.github.com/KenanZhu" style="text-decoration: none;">https://www.github.com/KenanZhu</a><br>
+<br>
+<b style="font-size:14px;">DEPENDENCIES</b><br>
+Python: {platform.python_version()}<br>
+Qt(PySide6): {self.getQtVersion()}<br>
+Selenium: {selenium_ver}<br>
+<br>
+<b style="font-size:14px;">PROJECT</b><br>
+Website: <a href="https://www.autolibrary.kenanzhu.com" style="text-decoration:none;">https://www.autolibrary.kenanzhu.com</a><br>
+Repository: <a href="https://www.github.com/KenanZhu/AutoLibrary" style="text-decoration:none;">https://www.github.com/KenanZhu/AutoLibrary</a><br>
+<br>
+<b style="font-size:14px;">AUTHOR</b><br>
+Developer/Maintainer: KenanZhu<br>
+Contact: <a href="mailto:nanoki_zh@163.com">nanoki_zh@163.com</a><br>
+GitHub: <a href="https://www.github.com/KenanZhu" style="text-decoration:none;">https://www.github.com/KenanZhu</a><br>
 """
         return about_text
 
+    def generateLicenseText(
+        self
+    ) -> str:
+
+        return """
+<b>MIT License</b>
+<p>Copyright &copy; 2025 - 2026 KenanZhu</p>
+<p>Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:</p>
+<p>The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.</p>
+<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.</p>"""
 
     def getOSInfo(
         self
@@ -123,7 +159,6 @@ GitHub: <a href="https://www.github.com/KenanZhu" style="text-decoration: none;"
             'architecture': architecture
         }
 
-
     def getQtVersion(
         self
     ):
@@ -134,14 +169,23 @@ GitHub: <a href="https://www.github.com/KenanZhu" style="text-decoration: none;"
         except:
             return "Unknown"
 
+    def getSeleniumVersion(
+        self
+    ):
+
+        try:
+            import selenium
+            return selenium.__version__
+        except Exception:
+            return "Unknown"
 
     def copyAboutInfo(
         self
     ):
 
-        about_text = self.AboutInfoBrowser.toPlainText()
-        clipboard = QApplication.clipboard()
-        clipboard.setText(about_text)
+        about_text = self.TabWidget.currentWidget().toPlainText()
+        Clipboard = QApplication.clipboard()
+        Clipboard.setText(about_text)
         original_text = self.CopyButton.text()
         self.CopyButton.setText("已复制")
-        QTimer.singleShot(2000, lambda: self.CopyButton.setText(original_text))
+        QTimer.singleShot(2000, lambda: self.CopyButton.setText(original_text))

src/gui/ALAutoScriptEditDialog.py

@@ -0,0 +1,669 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from copy import deepcopy
+
+from PySide6.QtCore import (
+    QDate,
+    QSize,
+    Qt,
+    QTime,
+    QTimer,
+    Slot
+)
+from PySide6.QtGui import (
+    QColor,
+    QFont,
+    QIcon,
+    QSyntaxHighlighter,
+    QTextCharFormat,
+)
+from PySide6.QtWidgets import (
+    QApplication,
+    QComboBox,
+    QDateEdit,
+    QDialog,
+    QDialogButtonBox,
+    QDoubleSpinBox,
+    QFormLayout,
+    QFrame,
+    QGridLayout,
+    QGroupBox,
+    QHBoxLayout,
+    QHeaderView,
+    QLabel,
+    QLineEdit,
+    QMessageBox,
+    QPlainTextEdit,
+    QPushButton,
+    QSpinBox,
+    QSplitter,
+    QStyle,
+    QTabWidget,
+    QTableWidget,
+    QTableWidgetItem,
+    QTimeEdit,
+    QVBoxLayout,
+    QWidget,
+)
+
+from autoscript import (
+    createAllVariablesTable,
+    createMockTargetData,
+    createTargetVarDefs,
+    createEngine,
+)
+
+
+class ALScriptHighlighter(QSyntaxHighlighter):
+    """
+        Syntax highlighter for Lua-based AutoScript.
+    """
+
+    def __init__(
+        self,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self._rules = []
+
+        KeywordFmt = QTextCharFormat()
+        KeywordFmt.setForeground(QColor("#569CD6"))
+        KeywordFmt.setFontWeight(QFont.Weight.Bold)
+        for kw in [
+            "if", "elseif", "else", "end", "then",
+            "and", "or", "not",
+            "local", "function", "return", "nil",
+        ]:
+            self._rules.append((r"\b" + kw + r"\b", KeywordFmt))
+        BoolFmt = QTextCharFormat()
+        BoolFmt.setForeground(QColor("#4FC1FF"))
+        BoolFmt.setFontWeight(QFont.Weight.Bold)
+        self._rules.append((r"\btrue\b", BoolFmt))
+        self._rules.append((r"\bfalse\b", BoolFmt))
+        CmpFmt = QTextCharFormat()
+        CmpFmt.setForeground(QColor("#C586C0"))
+        CmpFmt.setFontWeight(QFont.Weight.Normal)
+        for op in [r"==", r"~=", r">=", r"<=", r">", r"<"]:
+            self._rules.append((op, CmpFmt))
+        ArithFmt = QTextCharFormat()
+        ArithFmt.setForeground(QColor("#C586C0"))
+        ArithFmt.setFontWeight(QFont.Weight.Normal)
+        for op in [r"\+", r"-", r"\*", r"/", r"\.\."]:
+            self._rules.append((op, ArithFmt))
+        FuncFmt = QTextCharFormat()
+        FuncFmt.setForeground(QColor("#DCDCAA"))
+        FuncFmt.setFontWeight(QFont.Weight.Normal)
+        for fn in [ "time", "date", "datenow", "timenow", "dateadd", "timeadd"]:
+            self._rules.append((r"\b" + fn + r"\b", FuncFmt))
+        VarFmt = QTextCharFormat()
+        VarFmt.setForeground(QColor("#9CDCFE"))
+        VarFmt.setFontWeight(QFont.Weight.Normal)
+        var_names = [name for _, (name, _) in createAllVariablesTable().items()]
+        for var in var_names:
+            self._rules.append((r"\b" + var + r"\b", VarFmt))
+        StrFmt = QTextCharFormat()
+        StrFmt.setForeground(QColor("#CE9178"))
+        StrFmt.setFontWeight(QFont.Weight.Normal)
+        self._rules.append((r'"[^"]*"', StrFmt))
+        self._rules.append((r"'[^']*'", StrFmt))
+        NumFmt = QTextCharFormat()
+        NumFmt.setForeground(QColor("#B5CEA8"))
+        NumFmt.setFontWeight(QFont.Weight.Normal)
+        self._rules.append((r"\b\d+(?:\.\d+)?\b", NumFmt))
+        CommentFmt = QTextCharFormat()
+        CommentFmt.setForeground(QColor("#6A9955"))
+        CommentFmt.setFontItalic(True)
+        self._rules.append((r"--[^\n]*", CommentFmt))
+
+    def highlightBlock(
+        self,
+        text
+    ):
+
+        import re
+        for pattern, fmt in self._rules:
+            for match in re.finditer(pattern, text, re.IGNORECASE):
+                start = match.start()
+                length = match.end() - match.start()
+                self.setFormat(start, length, fmt)
+
+
+class _DebugResultDialog(QDialog):
+
+    def __init__(
+        self,
+        changes: list,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self.setWindowTitle("调试运行结果 - AutoLibrary")
+        self.setMinimumSize(600, 200)
+        DbgLayout = QVBoxLayout(self)
+        DbgTable = QTableWidget(len(changes), 3)
+        DbgTable.setHorizontalHeaderLabels(["目标变量", "原始数据", "运行后数据"])
+        DbgTable.horizontalHeader().setStretchLastSection(True)
+        DbgTable.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)
+        DbgTable.setEditTriggers(QTableWidget.EditTrigger.NoEditTriggers)
+        for row, (display_name, name, var_type, before_val, after_val) in enumerate(changes):
+            label = f"{display_name}: {name}({var_type})"
+            DbgTable.setItem(row, 0, QTableWidgetItem(label))
+            DbgTable.setItem(row, 1, QTableWidgetItem(str(before_val)))
+            DbgTable.setItem(row, 2, QTableWidgetItem(str(after_val)))
+        DbgLayout.addWidget(DbgTable)
+        DbgBtnBox = QDialogButtonBox(QDialogButtonBox.StandardButton.Ok)
+        DbgBtnBox.button(QDialogButtonBox.StandardButton.Ok).setText("确定")
+        DbgBtnBox.accepted.connect(self.accept)
+        DbgLayout.addWidget(DbgBtnBox)
+
+
+class _TabToSpacesEditor(QPlainTextEdit):
+
+    def keyPressEvent(
+        self,
+        event
+    ):
+
+        if event.key() == Qt.Key.Key_Tab:
+            self.insertPlainText("    ")
+            return
+        super().keyPressEvent(event)
+
+
+class ALAutoScriptEditDialog(QDialog):
+
+    def __init__(
+        self,
+        parent = None,
+        script: str = "",
+        mockData: dict = None
+    ):
+
+        super().__init__(parent)
+        self._fontSize = 21
+        self._mockWidgets = {}
+
+        self.setupUi()
+        self.connectSignals()
+        self.TextEdit.setPlainText(script)
+        self._Highlighter = ALScriptHighlighter(
+            self.TextEdit.document()
+        )
+        if mockData:
+            self.setMockData(mockData)
+
+    def setupUi(
+        self
+    ):
+
+        self.setWindowTitle("AutoScript 编辑 - AutoLibrary")
+        self.setMinimumSize(660, 600)
+        Layout = QVBoxLayout(self)
+        Layout.setSpacing(3)
+        Layout.setContentsMargins(3, 3, 3, 3)
+        ToolbarLayout = QHBoxLayout()
+        self.ZoomInBtn = QPushButton("＋")
+        self.ZoomInBtn.setFixedSize(25, 25)
+        self.ZoomOutBtn = QPushButton("－")
+        self.ZoomOutBtn.setFixedSize(25, 25)
+        self.ZoomResetBtn = QPushButton("")
+        self.ZoomResetBtn.setIcon(QIcon(":/res/icons/Reset.svg"))
+        self.ZoomResetBtn.setIconSize(QSize(20, 20))
+        self.ZoomResetBtn.setFixedSize(25, 25)
+        self.ZoomResetBtn.setToolTip("重置缩放")
+        self.ZoomLabel = QLabel(f"{self._fontSize}px")
+        self.ZoomLabel.setFixedHeight(25)
+        self.OrchBtn = QPushButton("编排")
+        self.OrchBtn.setFixedHeight(25)
+        self.OrchBtn.setToolTip("可视化生成 AutoScript 代码并插入到光标位置")
+        ToolbarLayout.addWidget(self.OrchBtn)
+        self.DebugBtn = QPushButton("▶ 调试运行")
+        self.DebugBtn.setFixedHeight(25)
+        self.DebugBtn.setToolTip("使用右侧模拟数据执行脚本，查看目标变量变化")
+        ToolbarLayout.addWidget(self.DebugBtn)
+        Sep = QFrame()
+        Sep.setFrameShape(QFrame.Shape.VLine)
+        Sep.setFrameShadow(QFrame.Shadow.Sunken)
+        Sep.setFixedWidth(1)
+        ToolbarLayout.addWidget(Sep)
+        ToolbarLayout.addWidget(self.ZoomInBtn)
+        ToolbarLayout.addWidget(self.ZoomOutBtn)
+        ToolbarLayout.addWidget(self.ZoomResetBtn)
+        ToolbarLayout.addWidget(self.ZoomLabel)
+        ToolbarLayout.addStretch()
+        self.CopyBtn = QPushButton("")
+        self.CopyBtn.setIcon(QIcon(":/res/icons/Copy.svg"))
+        self.CopyBtn.setIconSize(QSize(20, 20))
+        self.CopyBtn.setFixedSize(25, 25)
+        self.CopyBtn.setToolTip("复制脚本")
+        ToolbarLayout.addWidget(self.CopyBtn)
+        Layout.addLayout(ToolbarLayout)
+        self.TextEdit = _TabToSpacesEditor(self)
+        self.TextEdit.setTabStopDistance(40)
+        self.TextEdit.setLineWrapMode(
+            QPlainTextEdit.LineWrapMode.NoWrap
+        )
+        self.TextEdit.setStyleSheet(
+            "QPlainTextEdit {"
+            "  font-family: 'Courier New', 'Consolas', monospace;"
+           f"  font-size: {self._fontSize}px;"
+            "}"
+        )
+        Layout.addWidget(self.TextEdit)
+        self.createButtonPanel(Layout)
+        self.BtnBox = QDialogButtonBox(
+            QDialogButtonBox.StandardButton.Ok |
+            QDialogButtonBox.StandardButton.Cancel
+        )
+        self.BtnBox.button(QDialogButtonBox.StandardButton.Ok).setText("确定")
+        self.BtnBox.button(QDialogButtonBox.StandardButton.Cancel).setText("取消")
+        Layout.addWidget(self.BtnBox)
+
+    def createButtonPanel(
+        self,
+        ParentLayout
+    ):
+
+        Splitter = QSplitter(Qt.Orientation.Horizontal)
+        TabWidget = QTabWidget()
+        TabWidget.setMaximumHeight(150)
+        BasicWidget = QWidget()
+        BasicLayout = QGridLayout(BasicWidget)
+        BasicLayout.setSpacing(4)
+        BasicLayout.setContentsMargins(4, 4, 4, 4)
+        BasicLayout.setAlignment(Qt.AlignLeft | Qt.AlignTop)
+        controlButtons = [
+            ("如果 (if...)", "if  then\n    \nend"),
+            ("再如果 (elseif...)", "elseif  then\n    "),
+            ("否则 (else)", "else"),
+            ("结束 (end)", "end"),
+            ("跳过 (pass)", "-- pass"),
+        ]
+        self.addButtonsToGrid(BasicLayout, controlButtons, 0, 0, 3)
+        assignButtons = [
+            ("赋值 (=)", " = "),
+        ]
+        self.addButtonsToGrid(BasicLayout, assignButtons, 1, 2, 3)
+        TabWidget.addTab(BasicWidget, "基本语法")
+        OperatorWidget = QWidget()
+        OperatorLayout = QGridLayout(OperatorWidget)
+        OperatorLayout.setSpacing(4)
+        OperatorLayout.setContentsMargins(4, 4, 4, 4)
+        OperatorLayout.setAlignment(Qt.AlignLeft | Qt.AlignTop)
+        arithmeticButtons = [
+            ("加 (+)", " + "),
+            ("减 (-)", " - "),
+        ]
+        self.addButtonsToGrid(OperatorLayout, arithmeticButtons, 0, 0, 3)
+        compareButtons = [
+            ("等于 (==)", " == "),
+            ("不等于 (~=)", " ~= "),
+            ("大于 (>)", " > "),
+            ("小于 (<)", " < "),
+            ("大于等于 (>=)", " >= "),
+            ("小于等于 (<=)", " <= "),
+        ]
+        self.addButtonsToGrid(OperatorLayout, compareButtons, 1, 0, 3)
+        logic_buttons = [
+            ("且 (and)", " and "),
+            ("或 (or)", " or "),
+        ]
+        self.addButtonsToGrid(OperatorLayout, logic_buttons, 2, 0, 3)
+        TabWidget.addTab(OperatorWidget, "运算符")
+        LiteralWidget = QWidget()
+        LiteralLayout = QGridLayout(LiteralWidget)
+        LiteralLayout.setSpacing(4)
+        LiteralLayout.setContentsMargins(4, 4, 4, 4)
+        LiteralLayout.setAlignment(Qt.AlignLeft | Qt.AlignTop)
+        bool_buttons = [
+            ("真 (true)", "true"),
+            ("假 (false)", "false"),
+        ]
+        self.addButtonsToGrid(LiteralLayout, bool_buttons, 0, 0, 3)
+        dateTimeButtons = [
+            ("日期", 'date(2026, 1, 1)'),
+            ("时间", 'time(0, 0)'),
+        ]
+        self.addButtonsToGrid(LiteralLayout, dateTimeButtons, 1, 0, 3)
+        hintButtons = [
+            ("字符串", '"请输入文本"'),
+            ("数字", "123"),
+            ("注释", "-- 请输入注释"),
+        ]
+        self.addButtonsToGrid(LiteralLayout, hintButtons, 2, 0, 3)
+        TabWidget.addTab(LiteralWidget, "字面量")
+        VarWidget = QWidget()
+        VarLayout = QGridLayout(VarWidget)
+        VarLayout.setSpacing(4)
+        VarLayout.setContentsMargins(4, 4, 4, 4)
+        VarLayout.setAlignment(Qt.AlignLeft | Qt.AlignTop)
+        varButtons = [
+            (display_name, name) for display_name, (name, _) in createAllVariablesTable().items()
+        ]
+        self.addButtonsToGrid(VarLayout, varButtons, 0, 0, 3)
+        TabWidget.addTab(VarWidget, "变量")
+        FuncWidget = QWidget()
+        FuncLayout = QGridLayout(FuncWidget)
+        FuncLayout.setSpacing(4)
+        FuncLayout.setContentsMargins(4, 4, 4, 4)
+        FuncLayout.setAlignment(Qt.AlignLeft | Qt.AlignTop)
+        funcButtons = [
+            ("datenow()", "datenow()", "返回当前日期的 Unix 时间戳"),
+            ("timenow()", "timenow()", "返回当前时间在一天中的分钟数"),
+            ("dateadd(day, n)", "dateadd(, )", "日期偏移: dateadd(日期时间戳, 天数)"),
+            ("timeadd(time, n)", "timeadd(, )", "时间偏移: timeadd(分钟数, 分钟数)"),
+        ]
+        for i, (text, template, tooltip) in enumerate(funcButtons):
+            Btn = QPushButton(text)
+            Btn.setProperty("template", template)
+            Btn.clicked.connect(self.insertTemplate)
+            Btn.setFixedWidth(100)
+            Btn.setFixedHeight(25)
+            Btn.setToolTip(tooltip)
+            FuncLayout.addWidget(Btn, i // 2, i % 2)
+        TabWidget.addTab(FuncWidget, "工具函数")
+        MockPanel = self.createMockPanel()
+        MockPanel.setMinimumWidth(260)
+        Splitter.addWidget(TabWidget)
+        Splitter.addWidget(MockPanel)
+        Splitter.setStretchFactor(0, 1)
+        Splitter.setStretchFactor(1, 1)
+        Splitter.setSizes([530, 530])
+        ParentLayout.addWidget(Splitter)
+
+    def addButtonsToGrid(
+        self,
+        grid_layout,
+        buttons,
+        start_row,
+        start_col,
+        max_columns
+    ):
+
+        col = start_col
+        row = start_row
+
+        for btn_text, template in buttons:
+            Btn = QPushButton(btn_text)
+            Btn.setProperty("template", template)
+            Btn.clicked.connect(self.insertTemplate)
+            Btn.setFixedWidth(100)
+            Btn.setFixedHeight(25)
+            Btn.setToolTip(f"插入: {template}")
+            grid_layout.addWidget(Btn, row, col)
+            col += 1
+            if col >= start_col + max_columns:
+                col = start_col
+                row += 1
+
+    def createMockPanel(
+        self
+    ) -> QGroupBox:
+
+        Group = QGroupBox("模拟目标数据")
+        Form = QFormLayout(Group)
+        Form.setSpacing(4)
+        Form.setContentsMargins(5, 10, 5, 5)
+        self._mockWidgets = {}
+        mockData = createMockTargetData()
+        for name, var_type, key_path, display_name in createTargetVarDefs():
+            d = mockData
+            for key in key_path:
+                d = d[key]
+            default = d
+            Widget = self.makeMockInput(var_type, default)
+            Label = QLabel(f"{display_name}: {name}({var_type})")
+            Form.addRow(Label, Widget)
+            self._mockWidgets[name] = (Widget, var_type, key_path)
+        return Group
+
+    def makeMockInput(
+        self,
+        var_type: str,
+        default
+    ) -> QWidget:
+
+        if var_type == "String":
+            W = QLineEdit()
+            W.setText(str(default))
+            return W
+        if var_type == "Boolean":
+            W = QComboBox()
+            W.addItems(["是", "否"])
+            W.setCurrentIndex(0 if default else 1)
+            return W
+        if var_type == "Date":
+            W = QDateEdit()
+            W.setCalendarPopup(True)
+            W.setDisplayFormat("yyyy-MM-dd")
+            W.setDate(QDate.fromString(str(default), "yyyy-MM-dd"))
+            return W
+        if var_type == "Time":
+            W = QTimeEdit()
+            W.setDisplayFormat("HH:mm")
+            W.setTime(QTime.fromString(str(default), "HH:mm"))
+            return W
+        if var_type == "Int":
+            W = QSpinBox()
+            W.setMinimum(-999999)
+            W.setMaximum(999999)
+            W.setValue(int(default) if default else 0)
+            return W
+        if var_type == "Float":
+            W = QDoubleSpinBox()
+            W.setMinimum(-999999.0)
+            W.setMaximum(999999.0)
+            W.setDecimals(2)
+            W.setValue(float(default) if default else 0.0)
+            return W
+        W = QLineEdit()
+        W.setText(str(default))
+        return W
+
+    def getMockData(
+        self
+    ) -> dict:
+
+        data = {}
+        for name, var_type, key_path, display_name in createTargetVarDefs():
+            widget, _, _ = self._mockWidgets[name]
+            value = self.getMockValue(widget, var_type)
+            d = data
+            for key in key_path[:-1]:
+                d = d.setdefault(key, {})
+            d[key_path[-1]] = value
+        return data
+
+    def setMockData(
+        self,
+        data: dict
+    ):
+
+        if not data:
+            return
+        for name, var_type, key_path, display_name in createTargetVarDefs():
+            d = data
+            try:
+                for key in key_path:
+                    d = d[key]
+            except (KeyError, TypeError):
+                continue
+            widget, _, _ = self._mockWidgets[name]
+            self.setMockValue(widget, var_type, d)
+
+    def getMockValue(
+        self,
+        widget: QWidget,
+        var_type: str
+    ):
+
+        if var_type == "Boolean":
+            return widget.currentIndex() == 0
+        if var_type == "Date":
+            return widget.date().toString("yyyy-MM-dd")
+        if var_type == "Time":
+            return widget.time().toString("HH:mm")
+        if var_type == "Int":
+            return widget.value()
+        if var_type == "Float":
+            return widget.value()
+        return widget.text()
+
+    def setMockValue(
+        self,
+        widget: QWidget,
+        var_type: str,
+        value
+    ):
+
+        if var_type == "Boolean":
+            widget.setCurrentIndex(0 if value else 1)
+        elif var_type == "Date":
+            widget.setDate(QDate.fromString(str(value), "yyyy-MM-dd"))
+        elif var_type == "Time":
+            widget.setTime(QTime.fromString(str(value), "HH:mm"))
+        elif var_type == "Int":
+            widget.setValue(int(value))
+        elif var_type == "Float":
+            widget.setValue(float(value))
+        else:
+            widget.setText(str(value))
+
+    def connectSignals(
+        self
+    ):
+
+        self.BtnBox.accepted.connect(self.accept)
+        self.BtnBox.rejected.connect(self.reject)
+        self.OrchBtn.clicked.connect(self.onOpenOrchDialog)
+        self.DebugBtn.clicked.connect(self.onDebugRun)
+        self.ZoomInBtn.clicked.connect(self.onZoomIn)
+        self.ZoomOutBtn.clicked.connect(self.onZoomOut)
+        self.ZoomResetBtn.clicked.connect(self.onZoomReset)
+        self.CopyBtn.clicked.connect(self.onCopy)
+
+    def getScript(
+        self
+    ) -> str:
+
+        return self.TextEdit.toPlainText()
+
+    def updateFontSize(
+        self
+    ):
+
+        self.TextEdit.setStyleSheet(
+            "QPlainTextEdit {"
+            "  font-family: 'Courier New', 'Consolas', monospace;"
+            f"  font-size: {self._fontSize}px;"
+            "}"
+        )
+        self.ZoomLabel.setText(f"{self._fontSize}px")
+
+    @Slot()
+    def insertTemplate(
+        self
+    ):
+
+        Btn = self.sender()
+        if not isinstance(Btn, QPushButton):
+            return
+        template = Btn.property("template")
+        if not template:
+            return
+        cursor = self.TextEdit.textCursor()
+        cursor.insertText(template)
+
+    @Slot()
+    def onZoomIn(
+        self
+    ):
+
+        self._fontSize = min(self._fontSize + 2, 40)
+        self.updateFontSize()
+
+    @Slot()
+    def onZoomOut(
+        self
+    ):
+
+        self._fontSize = max(self._fontSize - 2, 8)
+        self.updateFontSize()
+
+    @Slot()
+    def onZoomReset(
+        self
+    ):
+
+        self._fontSize = 21
+        self.updateFontSize()
+
+    @Slot()
+    def onCopy(
+        self
+    ):
+
+        Clipboard = QApplication.clipboard()
+        Clipboard.setText(self.TextEdit.toPlainText())
+        self.CopyBtn.setEnabled(False)
+        QTimer.singleShot(2000, lambda: (
+            self.CopyBtn.setEnabled(True)
+        ))
+
+    @Slot()
+    def onOpenOrchDialog(
+        self
+    ):
+
+        from gui.ALAutoScriptOrchDialog import ALAutoScriptOrchDialog
+        Dlg = ALAutoScriptOrchDialog(self)
+        if Dlg.exec() == QDialog.DialogCode.Accepted:
+            script = Dlg.getScript()
+            if script:
+                cursor = self.TextEdit.textCursor()
+                cursor.insertText(script)
+        Dlg.deleteLater()
+
+    @Slot()
+    def onDebugRun(
+        self
+    ):
+
+        script = self.TextEdit.toPlainText().strip()
+        if not script:
+            QMessageBox.warning(self, "提示", "脚本内容为空。")
+            return
+        target_data = self.getMockData()
+        before = deepcopy(target_data)
+        try:
+            engine = createEngine()
+            engine.execute(script, target_data)
+        except ValueError as e:
+            QMessageBox.warning(self, "运行错误", str(e))
+            return
+        changes = []
+        for name, var_type, key_path, display_name in createTargetVarDefs():
+            before_val = before
+            after_val = target_data
+            try:
+                for key in key_path:
+                    before_val = before_val[key]
+                    after_val = after_val[key]
+            except (KeyError, TypeError):
+                continue
+            if before_val != after_val:
+                changes.append((display_name, name, var_type, before_val, after_val))
+        if not changes:
+            QMessageBox.information(self, "调试运行", "目标变量未发生变化。")
+            return
+        Dlg = _DebugResultDialog(changes, self)
+        Dlg.exec()
+        Dlg.deleteLater()

src/gui/ALAutoScriptOrchDialog/__init__.py

@@ -0,0 +1,10 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from ._dialog import ALAutoScriptOrchDialog

src/gui/ALAutoScriptOrchDialog/_blocks.py

@@ -0,0 +1,265 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+"""
+    Conditional block widget for the AutoScript orchestration dialog.
+"""
+from PySide6.QtCore import Slot
+from PySide6.QtWidgets import (
+    QComboBox,
+    QGroupBox,
+    QHBoxLayout,
+    QLabel,
+    QPushButton,
+    QSizePolicy,
+    QVBoxLayout,
+    QWidget,
+)
+
+from gui.ALAutoScriptOrchDialog._widgets import (
+    ActionStepFrame,
+    ConditionRowFrame,
+)
+
+
+class ConditionalBlock(QGroupBox):
+
+    def __init__(
+        self,
+        blockIndex: int,
+        varMgr = None,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self.blockIndex = blockIndex
+        self._varMgr = varMgr
+        self._actionWidgets = []
+        self._conditionRows = []
+
+        self.setupUi()
+        self.connectSignals()
+        self.addInitialConditionRow()
+
+    def setupUi(
+        self
+    ):
+
+        self.setUpdatesEnabled(False)
+        self.setStyleSheet(
+            "QGroupBox { font-weight: bold; border: 1px solid #ccc; "
+            "margin-top: 5px; padding-top: 5px; }"
+        )
+        self.setSizePolicy(QSizePolicy.Preferred, QSizePolicy.Fixed)
+        MainLayout = QVBoxLayout(self)
+        MainLayout.setSpacing(6)
+        MainLayout.setContentsMargins(8, 8, 8, 8)
+        HeaderLayout = QHBoxLayout()
+        HeaderLayout.setSpacing(8)
+        self.TypeCombo = QComboBox(self)
+        self.TypeCombo.addItem("IF", "IF")
+        self.TypeCombo.addItem("ELSE IF", "ELSE IF")
+        self.TypeCombo.addItem("ELSE", "ELSE")
+        self.TypeCombo.setFixedHeight(25)
+        if self.blockIndex == 0:
+            self.TypeCombo.setEnabled(False)
+        HeaderLayout.addWidget(QLabel("类型:", self))
+        HeaderLayout.addWidget(self.TypeCombo)
+        HeaderLayout.addStretch()
+        self.DeleteBlockBtn = QPushButton("删除此块", self)
+        self.DeleteBlockBtn.setStyleSheet("color: red;")
+        self.DeleteBlockBtn.setFixedHeight(25)
+        HeaderLayout.addWidget(self.DeleteBlockBtn)
+        MainLayout.addLayout(HeaderLayout)
+        self.ConditionWidget = QWidget(self)
+        self.ConditionWidget.setSizePolicy(
+            QSizePolicy.Preferred, QSizePolicy.Preferred
+        )
+        CondLayout = QVBoxLayout(self.ConditionWidget)
+        CondLayout.setContentsMargins(4, 4, 4, 4)
+        CondLayout.setSpacing(6)
+        self.CondRowsLayout = QVBoxLayout()
+        self.CondRowsLayout.setSpacing(4)
+        CondLayout.addLayout(self.CondRowsLayout)
+        self.AddCondBtn = QPushButton("+ 添加条件", self.ConditionWidget)
+        self.AddCondBtn.setFixedHeight(25)
+        CondLayout.addWidget(self.AddCondBtn)
+        MainLayout.addWidget(self.ConditionWidget)
+        self.ActionLabel = QLabel("执行步骤:", self)
+        self.ActionLabel.setFixedHeight(25)
+        MainLayout.addWidget(self.ActionLabel)
+        self.ActionsLayout = QVBoxLayout()
+        self.ActionsLayout.setSpacing(4)
+        MainLayout.addLayout(self.ActionsLayout)
+        self.AddActionBtn = QPushButton("+ 添加执行步骤", self)
+        self.AddActionBtn.setFixedHeight(25)
+        MainLayout.addWidget(self.AddActionBtn)
+        self.setUpdatesEnabled(True)
+
+    def connectSignals(
+        self
+    ):
+
+        self.TypeCombo.currentIndexChanged.connect(self.onTypeChanged)
+        self.AddCondBtn.clicked.connect(self.addConditionRow)
+        self.AddActionBtn.clicked.connect(self.addActionStep)
+
+    def addInitialConditionRow(
+        self
+    ):
+
+        Row = ConditionRowFrame(
+            self._varMgr, self.blockIndex,
+            isFirst=True, parent=self
+        )
+        self._conditionRows.append(Row)
+        self.CondRowsLayout.addWidget(Row)
+
+    def addConditionRow(
+        self
+    ):
+
+        Row = ConditionRowFrame(
+            self._varMgr, self.blockIndex,
+            isFirst=False, parent=self
+        )
+        Row.DeleteBtn.clicked.connect(lambda: self.removeConditionRow(Row))
+        self._conditionRows.append(Row)
+        self.CondRowsLayout.addWidget(Row)
+
+    def removeConditionRow(
+        self,
+        row: ConditionRowFrame
+    ):
+
+        if row in self._conditionRows and len(self._conditionRows) > 1:
+            self._conditionRows.remove(row)
+            self.CondRowsLayout.removeWidget(row)
+            row.hide()
+            row.deleteLater()
+
+    def addActionStep(
+        self
+    ):
+
+        Step = ActionStepFrame(self._varMgr, self.blockIndex, parent=self)
+        Step.DeleteBtn.clicked.connect(lambda: self.removeActionStep(Step))
+        self._actionWidgets.append(Step)
+        self.ActionsLayout.addWidget(Step)
+
+    def removeActionStep(
+        self,
+        step: ActionStepFrame
+    ):
+
+        if step in self._actionWidgets:
+            self._actionWidgets.remove(step)
+            self.ActionsLayout.removeWidget(step)
+            step.hide()
+            step.deleteLater()
+
+    def getBlockType(
+        self
+    ) -> str:
+
+        return self.TypeCombo.currentData()
+
+    def getConditionRows(
+        self
+    ):
+
+        return list(self._conditionRows)
+
+    def getActionSteps(
+        self
+    ):
+
+        return list(self._actionWidgets)
+
+    def countActionSteps(
+        self
+    ) -> int:
+
+        return len(self._actionWidgets)
+
+    def toScript(
+        self
+    ) -> list:
+        """
+            Generate Lua script lines for this conditional block.
+        """
+
+        blockType = self.getBlockType()
+        lines = []
+        if blockType in ("IF", "ELSE IF"):
+            condTexts = [
+                r.toScript() for r in self._conditionRows if r.toScript()
+            ]
+            if not condTexts:
+                condTexts = ["true"]
+            if len(condTexts) == 1:
+                combined = condTexts[0]
+            else:
+                parts = []
+                for i, ct in enumerate(condTexts):
+                    if i > 0:
+                        logic = self._conditionRows[i].getLogic() or "and"
+                        parts.append(f" {logic} ")
+                    parts.append(f"({ct})")
+                combined = "".join(parts)
+            if blockType == "IF":
+                lines.append(f"if {combined} then")
+            else:
+                lines.append(f"elseif {combined} then")
+        else:
+            lines.append("else")
+        for step in self._actionWidgets:
+            scriptLine = step.toScript()
+            if scriptLine:
+                lines.append(scriptLine)
+        return lines
+
+    def refreshVarCombos(
+        self
+    ):
+
+        for row in self._conditionRows:
+            row.refreshVarCombos()
+        for step in self._actionWidgets:
+            step.refreshVarCombos()
+
+    def setPrevBlockType(
+        self,
+        prevType: str | None
+    ):
+
+        model = self.TypeCombo.model()
+        if model is None:
+            return
+        for data in ("ELSE IF", "ELSE"):
+            idx = self.TypeCombo.findData(data)
+            if idx < 0:
+                continue
+            item = model.item(idx)
+            shouldEnable = prevType != "ELSE"
+            item.setEnabled(shouldEnable)
+        if prevType == "ELSE" and self.TypeCombo.currentData() in ("ELSE IF", "ELSE"):
+            self.TypeCombo.setCurrentIndex(0)
+
+    @Slot(int)
+    def onTypeChanged(
+        self,
+        _idx
+    ):
+
+        isCond = self.TypeCombo.currentData() in ("IF", "ELSE IF")
+        self.ConditionWidget.setVisible(isCond)
+        self.ActionLabel.setText(
+            "执行步骤:" if isCond else "ELSE 执行步骤:"
+        )

src/gui/ALAutoScriptOrchDialog/_dialog.py

@@ -0,0 +1,164 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+"""
+    Orchestration dialog for visually composing AutoScript scripts.
+"""
+from PySide6.QtCore import Slot
+from PySide6.QtWidgets import (
+    QDialog,
+    QDialogButtonBox,
+    QFrame,
+    QMessageBox,
+    QPushButton,
+    QScrollArea,
+    QVBoxLayout,
+    QWidget,
+)
+
+from gui.ALAutoScriptOrchDialog._helpers import VariableManager
+from gui.ALAutoScriptOrchDialog._blocks import ConditionalBlock
+
+
+class ALAutoScriptOrchDialog(QDialog):
+
+    def __init__(
+        self,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self._blocks = []
+        self._varMgr = VariableManager(self)
+
+        self.setupUi()
+        self.connectSignals()
+        self.addBlock()
+        self.ScrollLayout.addStretch()
+
+    def setupUi(
+        self
+    ):
+
+        self.setWindowTitle("AutoScript 指令编排 - AutoLibrary")
+        self.setMinimumSize(640, 600)
+        self.setModal(True)
+        MainLayout = QVBoxLayout(self)
+        Scroll = QScrollArea()
+        Scroll.setWidgetResizable(True)
+        Scroll.setFrameShape(QFrame.NoFrame)
+        ScrollContent = QWidget()
+        self.ScrollLayout = QVBoxLayout(ScrollContent)
+        self.ScrollLayout.setSpacing(5)
+        Scroll.setWidget(ScrollContent)
+        MainLayout.addWidget(Scroll)
+        self.AddBlockBtn = QPushButton("+ 添加判断块")
+        self.AddBlockBtn.setFixedHeight(25)
+        MainLayout.addWidget(self.AddBlockBtn)
+        self.BtnBox = QDialogButtonBox(
+            QDialogButtonBox.StandardButton.Ok |
+            QDialogButtonBox.StandardButton.Cancel
+        )
+        self.BtnBox.button(QDialogButtonBox.StandardButton.Ok).setText("确定")
+        self.BtnBox.button(QDialogButtonBox.StandardButton.Cancel).setText("取消")
+        MainLayout.addWidget(self.BtnBox)
+
+    def connectSignals(
+        self
+    ):
+
+        self.BtnBox.accepted.connect(self.onAccept)
+        self.BtnBox.rejected.connect(self.reject)
+        self.AddBlockBtn.clicked.connect(self.addBlock)
+
+    def updateBlockTypeRestrictions(
+        self
+    ):
+
+        prevType = None
+        for block in self._blocks:
+            block.setPrevBlockType(prevType)
+            prevType = block.getBlockType()
+
+    def addBlock(
+        self
+    ):
+
+        Block = ConditionalBlock(
+            len(self._blocks), self._varMgr, parent=self
+        )
+        Block.DeleteBlockBtn.clicked.connect(lambda: self.removeBlock(Block))
+        Block.TypeCombo.currentIndexChanged.connect(self.updateBlockTypeRestrictions)
+        Block.addActionStep()
+        self._blocks.append(Block)
+        self.updateBlockTypeRestrictions()
+        if self.ScrollLayout.count() > 0:
+            lastItem = self.ScrollLayout.itemAt(
+                self.ScrollLayout.count() - 1
+            )
+            if lastItem and lastItem.spacerItem():
+                self.ScrollLayout.insertWidget(
+                    self.ScrollLayout.count() - 1, Block
+                )
+                return
+        self.ScrollLayout.addWidget(Block)
+
+    def removeBlock(
+        self,
+        block: ConditionalBlock
+    ):
+
+        if len(self._blocks) <= 1:
+            QMessageBox.information(self, "提示", "至少保留一个判断块。")
+            return
+        if block in self._blocks:
+            self._blocks.remove(block)
+            self.ScrollLayout.removeWidget(block)
+            block.hide()
+            block.deleteLater()
+        for i, blk in enumerate(self._blocks):
+            blk.blockIndex = i
+            if i == 0:
+                blk.TypeCombo.setEnabled(False)
+                blk.TypeCombo.setCurrentIndex(0)
+            else:
+                blk.TypeCombo.setEnabled(True)
+            blk.refreshVarCombos()
+        self.updateBlockTypeRestrictions()
+
+    def getScript(
+        self
+    ) -> str:
+        """
+            Generate the complete Lua script from all blocks.
+        """
+
+        parts = []
+        prevType = None
+        for block in self._blocks:
+            blockType = block.getBlockType()
+            if blockType == "IF" and prevType is not None:
+                parts.append("end")
+            lines = block.toScript()
+            parts.extend(lines)
+            prevType = blockType
+        if self._blocks and self._blocks[0].getBlockType() == "IF":
+            parts.append("end")
+        return "\n".join(parts)
+
+    @Slot()
+    def onAccept(
+        self
+    ):
+
+        script = self.getScript().strip()
+        if not script:
+            QMessageBox.warning(self, "提示", "脚本内容为空，请添加至少一个操作步骤。")
+            return
+        self.accept()

src/gui/ALAutoScriptOrchDialog/_helpers.py

@@ -0,0 +1,516 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+"""
+    Helper utilities and constants for the AutoScript orchestration dialog.
+"""
+import re
+
+from PySide6.QtCore import QObject
+from PySide6.QtWidgets import (
+    QComboBox,
+    QDateEdit,
+    QDoubleSpinBox,
+    QHBoxLayout,
+    QLabel,
+    QLineEdit,
+    QSizePolicy,
+    QSpinBox,
+    QStackedWidget,
+    QTimeEdit,
+    QWidget,
+)
+
+from autoscript import createAllVariablesTable
+
+VARTYPE_INFOS = [
+    # varType, isArithType
+    ("String",  False),
+    ("Int",     True),
+    ("Float",   True),
+    ("Boolean", False),
+    ("Date",    True),
+    ("Time",    True),
+]
+
+
+def getTypeOrder(
+) -> list:
+
+    return [t for t, _ in VARTYPE_INFOS]
+
+def getArithType(
+    varType: str
+) -> bool:
+
+    for t, a in VARTYPE_INFOS:
+        if t == varType:
+            return a
+
+def getPresetVars(
+) -> list:
+
+    return [
+        {"name": name.upper(), "type": vtype, "display": display}
+        for display, (name, vtype) in createAllVariablesTable().items()
+    ]
+
+
+COMPARE_OPTIONS = [
+    ("等于", "=="),
+    ("不等于", "~="),
+    ("大于", ">"),
+    ("小于", "<"),
+    ("大于等于", ">="),
+    ("小于等于", "<="),
+]
+LOGIC_OPTIONS = [
+    ("并且 (and)", "and"),
+    ("或者 (or)", "or"),
+]
+ACTION_OPTIONS = [
+    ("设置为", "set"),
+    ("增加", "add"),
+    ("减少", "sub"),
+]
+DATE_OPTIONS = [
+    ("前天", "day_before_yesterday"),
+    ("昨天", "yesterday"),
+    ("今天", "today"),
+    ("明天", "tomorrow"),
+    ("后天", "day_after_tomorrow")
+]
+DATE_OFFSET_OPTIONS = [
+    ("天", "days"),
+    ("周", "weeks"),
+    # NOTE: "月" and "年" use fixed day counts (30 / 365), not calendar months/years,
+    # because dateadd() works with second-level offsets (n * 86400).
+    ("月", "months"),
+    ("年", "years"),
+]
+
+
+class _DateInputContainer(QWidget):
+
+    def __init__(
+        self,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self.setupUi()
+
+    def setupUi(
+        self
+    ):
+
+        Layout = QHBoxLayout(self)
+        Layout.setContentsMargins(0, 0, 0, 0)
+        Layout.setSpacing(4)
+        self._ModeCombo = QComboBox(self)
+        self._ModeCombo.addItem("相对日期", "relative")
+        self._ModeCombo.addItem("绝对日期", "absolute")
+        self._ModeCombo.setFixedHeight(25)
+        self._Stack = QStackedWidget(self)
+        self._RelCombo = QComboBox(self)
+        for display, data in DATE_OPTIONS:
+            self._RelCombo.addItem(display, data)
+        self._RelCombo.setFixedHeight(25)
+        self._Stack.addWidget(self._RelCombo)
+        self._DateEdit = QDateEdit(self)
+        self._DateEdit.setDisplayFormat("yyyy-MM-dd")
+        self._DateEdit.setCalendarPopup(True)
+        self._DateEdit.setFixedHeight(25)
+        self._Stack.addWidget(self._DateEdit)
+        self._ModeCombo.currentIndexChanged.connect(
+            lambda i: self._Stack.setCurrentIndex(i)
+        )
+        Layout.addWidget(self._ModeCombo)
+        Layout.addWidget(self._Stack)
+        Layout.addStretch()
+
+    def getValue(
+        self
+    ) -> str:
+
+        mode = self._ModeCombo.currentData()
+        if mode == "relative":
+            return self._RelCombo.currentText()
+        return self._DateEdit.date().toString("yyyy-MM-dd")
+
+
+class _TimeInputContainer(QWidget):
+
+    def __init__(
+        self,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self._TimeEdit = QTimeEdit(self)
+        self._TimeEdit.setDisplayFormat("HH:mm")
+        self._TimeEdit.setFixedHeight(25)
+
+        Layout = QHBoxLayout(self)
+        Layout.setContentsMargins(0, 0, 0, 0)
+        Layout.addWidget(self._TimeEdit)
+
+    def getValue(
+        self
+    ) -> str:
+
+        return self._TimeEdit.time().toString("HH:mm")
+
+
+class _DateOffsetContainer(QWidget):
+
+    def __init__(
+        self,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self._SpinBox = QSpinBox(self)
+        self._SpinBox.setRange(0, 99999)
+        self._SpinBox.setFixedHeight(25)
+        self._UnitCombo = QComboBox(self)
+        for display, data in DATE_OFFSET_OPTIONS:
+            self._UnitCombo.addItem(display, data)
+        self._UnitCombo.setFixedHeight(25)
+
+        Layout = QHBoxLayout(self)
+        Layout.setContentsMargins(0, 0, 0, 0)
+        Layout.setSpacing(4)
+        Layout.addWidget(self._SpinBox)
+        Layout.addWidget(self._UnitCombo)
+        Layout.addStretch()
+
+    def getValue(
+        self
+    ) -> str:
+
+        return str(self.getOffsetDays())
+
+    def getOffsetDays(
+        self
+    ) -> int:
+
+        val = self._SpinBox.value()
+        unit = self._UnitCombo.currentData()
+        if unit == "weeks":
+            return val*7
+        if unit == "months":
+            return val*30
+        if unit == "years":
+            return val*365
+        return val
+
+
+class _TimeOffsetContainer(QWidget):
+
+    def __init__(
+        self,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self._SpinBox = QSpinBox(self)
+        self._SpinBox.setRange(0, 99999)
+        self._SpinBox.setSuffix(" 小时")
+        self._SpinBox.setFixedHeight(25)
+
+        Layout = QHBoxLayout(self)
+        Layout.setContentsMargins(0, 0, 0, 0)
+        Layout.addWidget(self._SpinBox)
+
+    def getValue(
+        self
+    ) -> str:
+
+        return str(self.getOffsetHours())
+
+    def getOffsetHours(
+        self
+    ) -> int:
+
+        return self._SpinBox.value()
+
+
+class VariableManager(QObject):
+
+    def __init__(
+        self,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self._vars = []
+        self._nameMap = {}
+
+        self.initPresetVars()
+
+    def initPresetVars(
+        self
+    ):
+
+        for p in getPresetVars():
+            entry = {"name": p["name"], "type": p["type"], "display": p["display"]}
+            self._vars.append(entry)
+            self._nameMap[p["name"]] = entry
+
+    def getInfoByName(
+        self,
+        name: str
+    ):
+
+        return self._nameMap.get(name.upper().strip())
+
+    def populateCombo(
+        self,
+        combo: QComboBox
+    ):
+
+        currentData = combo.currentData()
+        combo.blockSignals(True)
+        combo.clear()
+        for entry in self._vars:
+            combo.addItem(
+                entry["display"],
+                (entry["name"], entry["type"])
+            )
+        if currentData:
+            for i in range(combo.count()):
+                d = combo.itemData(i)
+                if d and d[0] == currentData[0]:
+                    combo.setCurrentIndex(i)
+                    break
+        combo.blockSignals(False)
+
+
+def makeValueWidget(
+    var_type: str,
+    parent: QWidget = None
+) -> QWidget:
+
+    if var_type == "Int":
+        w = QSpinBox(parent)
+        w.setRange(-999999, 999999)
+        w.setFixedHeight(25)
+        w.setMinimumWidth(100)
+        return w
+    if var_type == "Float":
+        w = QDoubleSpinBox(parent)
+        w.setRange(-999999.0, 999999.0)
+        w.setDecimals(2)
+        w.setFixedHeight(25)
+        w.setMinimumWidth(100)
+        return w
+    if var_type == "String":
+        w = QLineEdit(parent)
+        w.setPlaceholderText("输入值")
+        w.setFixedHeight(25)
+        w.setMinimumWidth(120)
+        return w
+    if var_type == "Boolean":
+        w = QComboBox(parent)
+        w.addItem("是 (true)", "true")
+        w.addItem("否 (false)", "false")
+        w.setFixedHeight(25)
+        w.setMinimumWidth(100)
+        return w
+    if var_type == "Date":
+        return _DateInputContainer(parent)
+    if var_type == "Time":
+        return _TimeInputContainer(parent)
+    w = QLineEdit(parent)
+    w.setPlaceholderText("输入值")
+    w.setFixedHeight(25)
+    w.setMinimumWidth(120)
+    return w
+
+def makeOffsetWidget(
+    var_type: str,
+    parent: QWidget = None
+) -> QWidget:
+
+    if var_type == "Int":
+        w = QSpinBox(parent)
+        w.setRange(-999999, 999999)
+        w.setFixedHeight(25)
+        w.setMinimumWidth(100)
+        return w
+    if var_type == "Float":
+        w = QDoubleSpinBox(parent)
+        w.setRange(-999999.0, 999999.0)
+        w.setDecimals(2)
+        w.setFixedHeight(25)
+        w.setMinimumWidth(100)
+        return w
+    if var_type == "Date":
+        return _DateOffsetContainer(parent)
+    if var_type == "Time":
+        return _TimeOffsetContainer(parent)
+    w = QLabel("(不支持该操作)", parent)
+    w.setFixedHeight(25)
+    return w
+
+def makeVarRefCombo(
+    parent: QWidget = None
+) -> QComboBox:
+
+    Cb = QComboBox(parent)
+    Cb.setFixedHeight(25)
+    Cb.setMinimumWidth(120)
+    Cb.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Fixed)
+    return Cb
+
+def makeComboWidget(
+    items,
+    min_width: int = 80,
+    parent: QWidget = None
+) -> QComboBox:
+
+    Cb = QComboBox(parent)
+    for display, data in items:
+        Cb.addItem(display, data)
+    Cb.setFixedHeight(25)
+    Cb.setMinimumWidth(min_width)
+    return Cb
+
+def makeLabel(
+    text: str,
+    parent: QWidget = None,
+    width: int = None
+) -> QLabel:
+
+    Lbl = QLabel(text, parent)
+    Lbl.setFixedHeight(25)
+    if width:
+        Lbl.setFixedWidth(width)
+    return Lbl
+
+def getValueFromWidget(
+    w: QWidget
+) -> str:
+
+    if hasattr(w, "getValue"):
+        return w.getValue()
+    if isinstance(w, QTimeEdit):
+        return w.time().toString("HH:mm")
+    if isinstance(w, QDateEdit):
+        return w.date().toString("yyyy-MM-dd")
+    if isinstance(w, QComboBox):
+        return w.currentData() or w.currentText()
+    if isinstance(w, QSpinBox):
+        return str(w.value())
+    if isinstance(w, QDoubleSpinBox):
+        return str(w.value())
+    if isinstance(w, QLineEdit):
+        return w.text()
+    return ""
+
+def encodeValueStr(
+    raw_value: str,
+    var_type: str
+) -> str:
+    """
+        Encode a raw widget value as a Lua expression.
+
+        Arithmetic expressions (A + B) are passed through for numeric types;
+        Date/Time arithmetic is translated to ``dateadd()`` / ``timeadd()`` calls.
+    """
+
+    if var_type in ("Date", "Time"):
+        return encodeDateOrTime(str(raw_value), var_type)
+    if isinstance(raw_value, bool):
+        return "true" if raw_value else "false"
+    s = str(raw_value)
+    if isArithExpr(s):
+        return s
+    if var_type == "Boolean":
+        up = s.upper().strip()
+        if up in ("TRUE", "FALSE"):
+            return up.lower()
+        return "true" if raw_value else "false"
+    if var_type == "String":
+        escaped = s.replace("\\", "\\\\").replace('"', '\\"')
+        return f'"{escaped}"'
+    return s
+
+def encodeDateOrTime(
+    raw_value: str,
+    var_type: str
+) -> str:
+    """
+        Translate a date/time widget value into a Lua expression.
+    """
+
+    s = raw_value.strip()
+    up = s.upper()
+    # Input comes from widget values — single binary expressions only (e.g. "A + 3",
+    # "CURRENT_DATE + 5"). Multi-operator expressions are not produced by the UI.
+    m_arith_spaced = re.match(r'^(.+?)\s+([+-])\s+(.+)$', s)
+    m_arith_nospace = re.match(r'^([A-Za-z_]\w*)([+-])(\d+|[A-Za-z_]\w*)$', s)
+    m_arith = m_arith_spaced or m_arith_nospace
+    if m_arith:
+        left = m_arith.group(1).strip().upper()
+        sign = m_arith.group(2)
+        right = m_arith.group(3).strip()
+        operand = right if sign == "+" else f"-{right}"
+        if left == "CURRENT_DATE":
+            return f"dateadd(datenow(), {operand})"
+        if left == "CURRENT_TIME":
+            return f"timeadd(timenow(), {operand})"
+        if var_type == "Date":
+            return f"dateadd({left}, {operand})"
+        if var_type == "Time":
+            return f"timeadd({left}, {operand})"
+        return f"{left} {sign} {right}"
+    if up == "CURRENT_DATE":
+        return "datenow()"
+    if up == "CURRENT_TIME":
+        return "timenow()"
+    _REL_MAP = {
+        "前天": "dateadd(datenow(), -2)",
+        "昨天": "dateadd(datenow(), -1)",
+        "今天": "datenow()",
+        "明天": "dateadd(datenow(), 1)",
+        "后天": "dateadd(datenow(), 2)",
+    }
+    if s in _REL_MAP:
+        return _REL_MAP[s]
+    if var_type == "Date":
+        m_date = re.match(r"^(\d{4})-(\d{2})-(\d{2})$", s)
+        if m_date:
+            y, m, d = int(m_date.group(1)), int(m_date.group(2)), int(m_date.group(3))
+            return f"date({y}, {m}, {d})"
+    if var_type == "Time":
+        m_time = re.match(r"^(\d{1,2}):(\d{2})$", s)
+        if m_time:
+            h, m = int(m_time.group(1)), int(m_time.group(2))
+            return f"time({h}, {m})"
+    if re.match(r"^[+-]?\d+$", s):
+        return s
+    if re.match(r"^[A-Za-z_]\w*$", s):
+        return s
+    return f'"{s}"'
+
+# Pre-compiled patterns for detecting arithmetic expressions (A + B / A - B)
+_RE_ARITH_SPACED = re.compile(r'^(.+?)\s+([+-])\s+(.+)$')
+_RE_ARITH_NOSPACE = re.compile(r'^([A-Za-z_]\w*)([+-])(\d+|[A-Za-z_]\w*)$')
+
+def isArithExpr(
+    expr: str
+) -> bool:
+    """
+        Return True if expr looks like a two-operand arithmetic expression (A ± B).
+    """
+
+    s = expr.strip()
+    return bool(_RE_ARITH_SPACED.match(s) or _RE_ARITH_NOSPACE.match(s))

src/gui/ALAutoScriptOrchDialog/_widgets.py

@@ -0,0 +1,468 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+"""
+    Widget components for the AutoScript orchestration dialog.
+"""
+from PySide6.QtCore import Slot
+from PySide6.QtWidgets import (
+    QComboBox,
+    QFrame,
+    QHBoxLayout,
+    QLabel,
+    QPushButton,
+    QSizePolicy,
+    QStackedWidget
+)
+
+from gui.ALAutoScriptOrchDialog._helpers import (
+    ACTION_OPTIONS,
+    COMPARE_OPTIONS,
+    LOGIC_OPTIONS,
+    encodeValueStr,
+    getPresetVars,
+    getTypeOrder,
+    getValueFromWidget,
+    getArithType,
+    makeComboWidget,
+    makeLabel,
+    makeOffsetWidget,
+    makeValueWidget,
+    makeVarRefCombo,
+)
+
+
+class ConditionRowFrame(QFrame):
+
+    def __init__(
+        self,
+        varMgr,
+        parentBlockIndex: int = 0,
+        isFirst: bool = False,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self._varMgr = varMgr
+        self._blockIndex = parentBlockIndex
+        self._isFirst = isFirst
+        self._isBoolMode = False
+        self._rawRhsExpr = ""
+
+        self.setupUi()
+        self.connectSignals()
+
+    def setupUi(
+        self
+    ):
+
+        self.setUpdatesEnabled(False)
+        self.setFrameShape(QFrame.StyledPanel)
+        self.setFrameShadow(QFrame.Raised)
+        self.setFixedHeight(32)
+        Layout = QHBoxLayout(self)
+        Layout.setContentsMargins(2, 2, 2, 2)
+        Layout.setSpacing(4)
+        if self._isFirst:
+            self.LogicCombo = None
+        else:
+            self.LogicCombo = makeComboWidget(LOGIC_OPTIONS, min_width=110, parent=self)
+            Layout.addWidget(self.LogicCombo)
+        self.LeftVarCombo = QComboBox(self)
+        self.LeftVarCombo.setFixedHeight(25)
+        self.LeftVarCombo.setMinimumWidth(120)
+        self.LeftVarCombo.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Fixed)
+        self.populateLeftVarCombo()
+        Layout.addWidget(self.LeftVarCombo)
+        self.OpCombo = makeComboWidget(COMPARE_OPTIONS, min_width=80, parent=self)
+        Layout.addWidget(self.OpCombo)
+        self._CompTypeCombo = makeComboWidget([
+            ("特定值", "literal"),
+            ("变量", "variable"),
+        ], min_width=70, parent=self)
+        Layout.addWidget(self._CompTypeCombo)
+        self.RhsStack = QStackedWidget(self)
+        self.RhsStack.setFixedHeight(25)
+        self.initLiteralStack()
+        self.RhsVarCombo = makeVarRefCombo(self)
+        self.RhsStack.addWidget(self.RhsVarCombo)
+        self.RhsStack.setCurrentIndex(0)
+        Layout.addWidget(self.RhsStack)
+        if not self._isFirst:
+            self.DeleteBtn = QPushButton("×", self)
+            self.DeleteBtn.setFixedSize(25, 25)
+            self.DeleteBtn.setStyleSheet("color: red; font-weight: bold;")
+            Layout.addWidget(self.DeleteBtn)
+        else:
+            self.DeleteBtn = None
+        Layout.addStretch()
+        self.setUpdatesEnabled(True)
+
+    def populateLeftVarCombo(
+        self
+    ):
+
+        wasBool = self._isBoolMode
+        boolName = None
+        if wasBool:
+            data = self.LeftVarCombo.currentData()
+            if data:
+                boolName = data[0]
+        self._varMgr.populateCombo(self.LeftVarCombo)
+        # Append boolean literal sentinels at the end
+        self.LeftVarCombo.insertSeparator(self.LeftVarCombo.count())
+        self.LeftVarCombo.addItem("true", ("true", "Boolean"))
+        self.LeftVarCombo.addItem("false", ("false", "Boolean"))
+        if wasBool and boolName:
+            for ci in range(self.LeftVarCombo.count()):
+                d = self.LeftVarCombo.itemData(ci)
+                if d and d[0] == boolName:
+                    self.LeftVarCombo.setCurrentIndex(ci)
+                    break
+
+    def populateRHSVarCombo(
+        self
+    ):
+
+        self._varMgr.populateCombo(self.RhsVarCombo)
+
+    def initLiteralStack(
+        self
+    ):
+
+        self.LiteralStack = QStackedWidget(self)
+        self.LiteralStack.setFixedHeight(25)
+        self._literalWidgets = {}
+        for vt in getTypeOrder():
+            W = makeValueWidget(vt, self.LiteralStack)
+            self._literalWidgets[vt] = W
+            self.LiteralStack.addWidget(W)
+        self.LiteralStack.setCurrentWidget(self._literalWidgets.get("String"))
+        self.RhsStack.addWidget(self.LiteralStack)
+
+    def connectSignals(
+        self
+    ):
+
+        self.LeftVarCombo.currentIndexChanged.connect(self.onLeftVarChanged)
+        self._CompTypeCombo.currentIndexChanged.connect(self.onCompTypeChanged)
+
+    def getLogic(
+        self
+    ) -> str:
+
+        return self.LogicCombo.currentData() if self.LogicCombo else ""
+
+    def updateRHSLiteralWidget(
+        self,
+        vartype: str
+    ):
+
+        if vartype not in self._literalWidgets:
+            vartype = "String"
+        self.LiteralStack.setCurrentWidget(self._literalWidgets[vartype])
+
+    def toScript(
+        self
+    ) -> str:
+
+        data = self.LeftVarCombo.currentData()
+        if self._isBoolMode and data:
+            return data[0]
+        if not data:
+            return ""
+        name, vartype = data
+        # CURRENT_DATE / CURRENT_TIME map to datenow() / timenow()
+        if name == "CURRENT_DATE":
+            name = "datenow()"
+        elif name == "CURRENT_TIME":
+            name = "timenow()"
+        opSym = self.OpCombo.currentData()
+        if self._rawRhsExpr:
+            return f"{name} {opSym} {self._rawRhsExpr}"
+        isVarRef = (self._CompTypeCombo.currentData() == "variable")
+        if isVarRef:
+            rd = self.RhsVarCombo.currentData()
+            if rd:
+                rhsName = rd[0]
+                if rhsName == "CURRENT_DATE":
+                    rhsName = "datenow()"
+                elif rhsName == "CURRENT_TIME":
+                    rhsName = "timenow()"
+                return f"{name} {opSym} {rhsName}"
+            rhsText = self.RhsVarCombo.currentText().strip()
+            if rhsText:
+                return f"{name} {opSym} {rhsText}"
+            return ""
+        w = self._literalWidgets.get(vartype)
+        if w:
+            rawVal = getValueFromWidget(w)
+            encoded = encodeValueStr(rawVal, vartype)
+            return f"{name} {opSym} {encoded}"
+        return ""
+
+    def refreshVarCombos(
+        self
+    ):
+
+        self.populateLeftVarCombo()
+        self.populateRHSVarCombo()
+
+    @Slot(int)
+    def onLeftVarChanged(
+        self,
+        idx
+    ):
+
+        self._rawRhsExpr = ""
+        if idx < 0:
+            return
+        data = self.LeftVarCombo.itemData(idx)
+        if not data:
+            return
+        name, vartype = data
+        isBool = name in ("true", "false")
+        self._isBoolMode = isBool
+        self.OpCombo.setVisible(not isBool)
+        self._CompTypeCombo.setVisible(not isBool)
+        self.RhsStack.setVisible(not isBool)
+        if not isBool:
+            self.updateRHSLiteralWidget(vartype)
+
+    @Slot(int)
+    def onCompTypeChanged(
+        self,
+        idx
+    ):
+
+        self._rawRhsExpr = ""
+        isVar = (self._CompTypeCombo.currentData() == "variable")
+        self.RhsStack.setCurrentIndex(1 if isVar else 0)
+        if isVar:
+            self.populateRHSVarCombo()
+
+
+class ActionStepFrame(QFrame):
+
+    def __init__(
+        self,
+        varMgr,
+        parentBlockIndex: int = 0,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self._varMgr = varMgr
+        self._blockIndex = parentBlockIndex
+        self._currentTargetType = "String"
+
+        self.setupUi()
+        self.connectSignals()
+
+    def setupUi(
+        self
+    ):
+
+        self.setUpdatesEnabled(False)
+        self.setFrameShape(QFrame.StyledPanel)
+        self.setFrameShadow(QFrame.Raised)
+        self.setFixedHeight(35)
+        Layout = QHBoxLayout(self)
+        Layout.setContentsMargins(2, 2, 2, 2)
+        Layout.setSpacing(4)
+        self.OpTypeCombo = makeComboWidget(ACTION_OPTIONS, min_width=70, parent=self)
+        Layout.addWidget(self.OpTypeCombo)
+        Layout.addWidget(makeLabel("设置", self))
+        self.TargetCombo = QComboBox(self)
+        self.TargetCombo.setFixedHeight(25)
+        self.TargetCombo.setMinimumWidth(120)
+        self.populateTargetCombo()
+        Layout.addWidget(self.TargetCombo)
+        Layout.addWidget(makeLabel("为", self))
+        self.ValueSrcCombo = makeComboWidget([
+            ("特定值", "literal"),
+            ("变量", "variable"),
+        ], min_width=70, parent=self)
+        Layout.addWidget(self.ValueSrcCombo)
+        self.ValueStack = QStackedWidget(self)
+        self.ValueStack.setFixedHeight(25)
+        self.initValueStacks()
+        Layout.addWidget(self.ValueStack)
+        self.ExistingVarCombo = makeVarRefCombo(self)
+        self.ExistingVarCombo.setVisible(False)
+        Layout.addWidget(self.ExistingVarCombo)
+        self.DeleteBtn = QPushButton("×", self)
+        self.DeleteBtn.setFixedSize(25, 25)
+        self.DeleteBtn.setStyleSheet("color: red; font-weight: bold;")
+        Layout.addWidget(self.DeleteBtn)
+        self.setUpdatesEnabled(True)
+
+    def populateTargetCombo(
+        self
+    ):
+
+        self.TargetCombo.blockSignals(True)
+        self.TargetCombo.clear()
+        for p in getPresetVars():
+            if p["name"] in ("CURRENT_TIME", "CURRENT_DATE"):
+                continue
+            info = self._varMgr.getInfoByName(p["name"])
+            if info:
+                self.TargetCombo.addItem(
+                    info["display"],
+                    (info["name"], info["type"])
+                )
+        self.TargetCombo.blockSignals(False)
+
+    def initValueStacks(
+        self
+    ):
+
+        self._literalWidgets = {}
+        self._offsetWidgets = {}
+        for vt in getTypeOrder():
+            self._literalWidgets[vt] = makeValueWidget(vt, self.ValueStack)
+            self.ValueStack.addWidget(self._literalWidgets[vt])
+            if getArithType(vt):
+                self._offsetWidgets[vt] = makeOffsetWidget(vt, self.ValueStack)
+                self.ValueStack.addWidget(self._offsetWidgets[vt])
+            else:
+                Lbl = QLabel("(不支持该操作)", self.ValueStack)
+                Lbl.setFixedHeight(25)
+                self._offsetWidgets[vt] = Lbl
+                self.ValueStack.addWidget(Lbl)
+
+    def connectSignals(
+        self
+    ):
+
+        self.OpTypeCombo.currentIndexChanged.connect(self.onOpTypeChanged)
+        self.TargetCombo.currentIndexChanged.connect(self.onTargetChanged)
+        self.ValueSrcCombo.currentIndexChanged.connect(self.onValueSrcChanged)
+
+    def getTargetName(
+        self
+    ) -> str:
+
+        data = self.TargetCombo.currentData()
+        return data[0] if data else ""
+
+    def updateValueWidget(
+        self
+    ):
+
+        op = self.OpTypeCombo.currentData()
+        isArith = (op in ("add", "sub"))
+        actualType = self._currentTargetType
+        if isArith and actualType in self._offsetWidgets:
+            self.ValueStack.setCurrentWidget(self._offsetWidgets[actualType])
+        elif actualType in self._literalWidgets:
+            self.ValueStack.setCurrentWidget(self._literalWidgets[actualType])
+        else:
+            self.ValueStack.setCurrentWidget(self._literalWidgets.get("String"))
+
+    def toScript(
+        self
+    ) -> str:
+        """
+            Generate a single line of Lua script from the current widget state.
+        """
+
+        target = self.getTargetName()
+        op = self.OpTypeCombo.currentData()
+        if op == "pass":
+            return "    -- pass"
+        if not target:
+            return ""
+        rawVal = self.getValueRaw()
+        vartype = self._currentTargetType
+        if op == "set":
+            encoded = encodeValueStr(rawVal, vartype)
+            return f"    {target} = {encoded}"
+        elif op == "add":
+            if vartype == "Date" and hasattr(self.ValueStack.currentWidget(), "getOffsetDays"):
+                days = self.ValueStack.currentWidget().getOffsetDays()
+                return f"    {target} = dateadd({target}, {days})"
+            if vartype == "Time" and hasattr(self.ValueStack.currentWidget(), "getOffsetHours"):
+                hours = self.ValueStack.currentWidget().getOffsetHours()
+                return f"    {target} = timeadd({target}, {hours})"
+            return f"    {target} = {target} + {rawVal}"
+        elif op == "sub":
+            if vartype == "Date" and hasattr(self.ValueStack.currentWidget(), "getOffsetDays"):
+                days = self.ValueStack.currentWidget().getOffsetDays()
+                return f"    {target} = dateadd({target}, -{days})"
+            if vartype == "Time" and hasattr(self.ValueStack.currentWidget(), "getOffsetHours"):
+                hours = self.ValueStack.currentWidget().getOffsetHours()
+                return f"    {target} = timeadd({target}, -{hours})"
+            return f"    {target} = {target} - {rawVal}"
+        return ""
+
+    def getValueRaw(
+        self
+    ) -> str:
+
+        if self.ValueSrcCombo.currentData() == "variable":
+            data = self.ExistingVarCombo.currentData()
+            return data[0] if data else ""
+        w = self.ValueStack.currentWidget()
+        if w:
+            return getValueFromWidget(w)
+        return ""
+
+    def refreshVarCombos(
+        self
+    ):
+
+        currentData = self.TargetCombo.currentData()
+        self.populateTargetCombo()
+        if currentData:
+            for i in range(self.TargetCombo.count()):
+                d = self.TargetCombo.itemData(i)
+                if d and d[0] == currentData[0]:
+                    self.TargetCombo.setCurrentIndex(i)
+                    break
+        self._varMgr.populateCombo(self.ExistingVarCombo)
+
+    @Slot(int)
+    def onTargetChanged(
+        self,
+        idx
+    ):
+
+        if idx < 0:
+            return
+        data = self.TargetCombo.itemData(idx)
+        if not data:
+            return
+        _, vartype = data
+        self._currentTargetType = vartype
+        self.updateValueWidget()
+        self.onValueSrcChanged(self.ValueSrcCombo.currentIndex())
+
+    @Slot(int)
+    def onOpTypeChanged(
+        self,
+        idx
+    ):
+
+        self.updateValueWidget()
+
+    @Slot(int)
+    def onValueSrcChanged(
+        self,
+        idx
+    ):
+
+        isVar = (self.ValueSrcCombo.currentData() == "variable")
+        self.ValueStack.setVisible(not isVar)
+        self.ExistingVarCombo.setVisible(isVar)
+        if isVar:
+            self._varMgr.populateCombo(self.ExistingVarCombo)
+        else:
+            self.updateValueWidget()

src/gui/ALConfigWidget.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2025 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -10,26 +10,46 @@ See the LICENSE file for details.
 import os
 
 from PySide6.QtCore import (
-    Qt, Signal, Slot, QTime, QDate, QDir, QFileInfo
-)
-from PySide6.QtWidgets import (
-    QDialog, QWidget, QLineEdit, QMessageBox, QFileDialog,
-    QTreeWidgetItem, QMenu, QInputDialog
+    QDate,
+    QDir,
+    QFileInfo,
+    Qt,
+    QTime,
+    Signal,
+    Slot
 )
 from PySide6.QtGui import (
-     QCloseEvent, QAction
+    QAction,
+    QCloseEvent
+)
+from PySide6.QtWidgets import (
+    QDialog,
+    QFileDialog,
+    QInputDialog,
+    QLineEdit,
+    QMenu,
+    QMessageBox,
+    QTreeWidgetItem,
+    QWidget
 )
 
 import managers.config.ConfigManager as ConfigManager
 
-from utils.JSONReader import JSONReader
-from utils.JSONWriter import JSONWriter
-
-from gui.resources.ui.Ui_ALConfigWidget import Ui_ALConfigWidget
 from gui.ALSeatMapSelectDialog import ALSeatMapSelectDialog
 from gui.ALSeatMapTable import ALSeatMapTable
-from gui.ALUserTreeWidget import ALUserTreeWidget, ALUserTreeItemType
+from gui.ALUserTreeWidget import (
+    ALUserTreeItemType,
+    ALUserTreeWidget
+)
 from gui.ALWebDriverDownloadDialog import ALWebDriverDownloadDialog
+from gui.resources.ui.Ui_ALConfigWidget import Ui_ALConfigWidget
+from interfaces.ConfigProvider import (
+    CfgKey,
+    ConfigProvider
+)
+from managers.config.ConfigUtils import ConfigUtils
+from utils.JSONReader import JSONReader
+from utils.JSONWriter import JSONWriter
 
 
 class ALConfigWidget(QWidget, Ui_ALConfigWidget):
@@ -42,8 +62,8 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
     ):
 
         super().__init__(parent)
-        self.__cfg_mgr = ConfigManager.instance()
-        self.__config_paths = ConfigManager.getValidateAutomationConfigPaths()
+        self.__cfg_mgr: ConfigProvider = ConfigManager.instance()
+        self.__config_paths = ConfigUtils.getAutomationConfigPaths()
         self.__config_data = {"run": {}, "user": {}}
 
         self.setupUi(self)
@@ -52,7 +72,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         if not self.initializeConfigs():
             self.close()
 
-
     def modifyUi(
         self
     ):
@@ -68,7 +87,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         self.initializeFloorRoomMap()
         self.initializeUserInfoWidget()
 
-
     def connectSignals(
         self
     ):
@@ -92,7 +110,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         self.ConfirmButton.clicked.connect(self.onConfirmButtonClicked)
         self.CancelButton.clicked.connect(self.onCancelButtonClicked)
 
-
     def showEvent(
         self,
         event
@@ -116,7 +133,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
 
         return result
 
-
     def closeEvent(
         self,
         event: QCloseEvent
@@ -125,7 +141,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         self.configWidgetIsClosed.emit()
         super().closeEvent(event)
 
-
     def initializeFloorRoomMap(
         self
     ):
@@ -159,7 +174,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             "五层": ["五层考研"]
         }
 
-
     def initializeConfigToWidget(
         self,
         which: str,
@@ -174,7 +188,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             self.setUsersToTreeWidget(config_data)
             self.CurrentUserConfigEdit.setText(self.__config_paths["user"])
 
-
     def initializeConfig(
         self,
         which: str
@@ -208,7 +221,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                     is_success = False
         return is_success
 
-
     def initializeConfigs(
         self
     ) -> bool:
@@ -221,7 +233,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             self.initializeConfigToWidget(which, self.__config_data[which])
         return is_success
 
-
     def defaultRunConfig(
         self
     ) -> dict:
@@ -245,7 +256,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             }
         }
 
-
     def defaultUserConfig(
         self
     ) -> dict:
@@ -255,7 +265,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             ]
         }
 
-
     def collectRunConfigFromWidget(
         self
     ) -> dict:
@@ -277,7 +286,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         run_config["mode"]["run_mode"] = run_mode
         return run_config
 
-
     def setRunConfigToWidget(
         self,
         run_config: dict
@@ -316,7 +324,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                 "文件可能被意外修改或已经损坏\n"
             )
 
-
     def initializeUserInfoWidget(
         self
     ):
@@ -341,7 +348,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         self.MaxRenewTimeDiffSpinBox.setValue(30)
         self.PreferLateRenewTimeCheckBox.setChecked(False)
 
-
     def collectUserFromWidget(
         self
     ) -> dict:
@@ -374,30 +380,28 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         user["reserve_info"]["renew_time"]["prefer_early"] = not self.PreferLateRenewTimeCheckBox.isChecked()
         return user
 
-
     def collectUsersFromTreeWidget(
         self
     ) -> dict:
 
         user_config = self.defaultUserConfig()
         for i in range(self.UserTreeWidget.topLevelItemCount()):
-            group_item = self.UserTreeWidget.topLevelItem(i)
+            GroupItem = self.UserTreeWidget.topLevelItem(i)
             group_config = {
-                "name": group_item.text(0),
-                "enabled": group_item.checkState(1) == Qt.CheckState.Checked,
+                "name": GroupItem.text(0),
+                "enabled": GroupItem.checkState(1) == Qt.CheckState.Checked,
                 "users": []
             }
-            for j in range(group_item.childCount()):
-                user_item = group_item.child(j)
-                user = user_item.data(0, Qt.UserRole)
+            for j in range(GroupItem.childCount()):
+                UserItem = GroupItem.child(j)
+                user = UserItem.data(0, Qt.UserRole)
                 if not user:
                     continue
-                user["enabled"] = user_item.checkState(1) == Qt.CheckState.Checked
+                user["enabled"] = UserItem.checkState(1) == Qt.CheckState.Checked
                 group_config["users"].append(user)
             user_config["groups"].append(group_config)
         return user_config
 
-
     def setUserToWidget(
         self,
         user: dict
@@ -439,7 +443,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                 "文件可能被意外修改或已经损坏\n"
             )
 
-
     def setUsersToTreeWidget(
         self,
         users: dict
@@ -450,18 +453,18 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         try:
             if "groups" in users:
                 for group_config in users["groups"]:
-                    group_item = QTreeWidgetItem(self.UserTreeWidget, ALUserTreeItemType.GROUP.value)
-                    group_item.setText(0, group_config["name"])
-                    group_item.setFlags(group_item.flags() | Qt.ItemIsEditable)
-                    group_item.setCheckState(1, Qt.Checked if group_config.get("enabled", True) else Qt.Unchecked)
+                    GroupItem = QTreeWidgetItem(self.UserTreeWidget, ALUserTreeItemType.GROUP.value)
+                    GroupItem.setText(0, group_config["name"])
+                    GroupItem.setFlags(GroupItem.flags() | Qt.ItemIsEditable)
+                    GroupItem.setCheckState(1, Qt.Checked if group_config.get("enabled", True) else Qt.Unchecked)
                     for user_config in group_config["users"]:
-                        user_item = QTreeWidgetItem(group_item, ALUserTreeItemType.USER.value)
-                        user_item.setText(0, user_config["username"])
-                        user_item.setText(1, "" if user_config.get("enabled", True) else "跳过")
-                        user_item.setData(0, Qt.UserRole, user_config)
-                        user_item.setCheckState(1, Qt.Checked if user_config.get("enabled", True) else Qt.Unchecked)
-                        user_item.setDisabled(not group_config.get("enabled", True))
-                    group_item.setExpanded(True)
+                        UserItem = QTreeWidgetItem(GroupItem, ALUserTreeItemType.USER.value)
+                        UserItem.setText(0, user_config["username"])
+                        UserItem.setText(1, "" if user_config.get("enabled", True) else "跳过")
+                        UserItem.setData(0, Qt.UserRole, user_config)
+                        UserItem.setCheckState(1, Qt.Checked if user_config.get("enabled", True) else Qt.Unchecked)
+                        UserItem.setDisabled(not group_config.get("enabled", True))
+                    GroupItem.setExpanded(True)
         except KeyError as e:
             QMessageBox.warning(
                 self,
@@ -481,7 +484,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         finally:
             self.UserTreeWidget.itemChanged.connect(self.onUserTreeWidgetItemChanged)
 
-
     def loadRunConfig(
         self,
         run_config_path: str
@@ -505,7 +507,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             )
             return None
 
-
     def saveRunConfig(
         self,
         run_config_path: str,
@@ -527,7 +528,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             )
             return False
 
-
     def loadUserConfig(
         self,
         user_config_path: str
@@ -561,7 +561,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             )
             return None
 
-
     def saveUserConfig(
         self,
         user_config_path: str,
@@ -583,7 +582,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             )
             return False
 
-
     def saveConfigs(
         self,
         run_config_path: str,
@@ -606,7 +604,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                 return False
         return True
 
-
     def loadConfig(
         self,
         config_path: str
@@ -635,52 +632,49 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         except:
             return False
 
-
     def addGroup(
         self,
         group_name: str = ""
     ) -> QTreeWidgetItem:
 
         self.UserTreeWidget.itemChanged.disconnect(self.onUserTreeWidgetItemChanged)
-        group_item = QTreeWidgetItem(self.UserTreeWidget, ALUserTreeItemType.GROUP.value)
+        GroupItem = QTreeWidgetItem(self.UserTreeWidget, ALUserTreeItemType.GROUP.value)
         if not group_name:
             group_name = f"新分组-{self.UserTreeWidget.topLevelItemCount()}"
-        group_item.setText(0, group_name)
-        group_item.setFlags(group_item.flags() | Qt.ItemIsEditable)
-        group_item.setCheckState(1, Qt.Checked)
-        self.UserTreeWidget.setCurrentItem(group_item)
+        GroupItem.setText(0, group_name)
+        GroupItem.setFlags(GroupItem.flags() | Qt.ItemIsEditable)
+        GroupItem.setCheckState(1, Qt.Checked)
+        self.UserTreeWidget.setCurrentItem(GroupItem)
         self.UserTreeWidget.itemChanged.connect(self.onUserTreeWidgetItemChanged)
-        return group_item
-
+        return GroupItem
 
     def delGroup(
         self,
-        group_item: QTreeWidgetItem = None
+        GroupItem: QTreeWidgetItem = None
     ):
 
-        if group_item is None:
+        if GroupItem is None:
             return
-        if group_item.type() != ALUserTreeItemType.GROUP.value:
+        if GroupItem.type() != ALUserTreeItemType.GROUP.value:
             return
-        index = self.UserTreeWidget.indexOfTopLevelItem(group_item)
+        index = self.UserTreeWidget.indexOfTopLevelItem(GroupItem)
         self.UserTreeWidget.takeTopLevelItem(index)
 
-
     def addUser(
         self,
-        group_item: QTreeWidgetItem = None
+        GroupItem: QTreeWidgetItem = None
     ) -> QTreeWidgetItem:
 
-        if group_item is None:
-            current_item = self.UserTreeWidget.currentItem()
-            if current_item is None:
-                group_item = self.addGroup()
-        if group_item.type() == ALUserTreeItemType.USER.value:
-            group_item = group_item.parent()
-        if group_item.checkState(1) == Qt.CheckState.Unchecked:
+        if GroupItem is None:
+            CurrentItem = self.UserTreeWidget.currentItem()
+            if CurrentItem is None:
+                GroupItem = self.addGroup()
+        if GroupItem.type() == ALUserTreeItemType.USER.value:
+            GroupItem = GroupItem.parent()
+        if GroupItem.checkState(1) == Qt.CheckState.Unchecked:
             return None
         new_user = {
-            "username": f"新用户-{group_item.childCount()}",
+            "username": f"新用户-{GroupItem.childCount()}",
             "password": "000000",
             "enabled": True,
             "reserve_info": {
@@ -709,34 +703,32 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             }
         }
         self.UserTreeWidget.itemChanged.disconnect(self.onUserTreeWidgetItemChanged)
-        user_item = QTreeWidgetItem(group_item, ALUserTreeItemType.USER.value)
-        user_item.setText(0, new_user["username"])
-        user_item.setText(1, "")
-        user_item.setData(0, Qt.UserRole, new_user)
-        user_item.setCheckState(1, Qt.CheckState.Checked)
-        group_item.setExpanded(True)
-        self.UserTreeWidget.setCurrentItem(user_item)
+        UserItem = QTreeWidgetItem(GroupItem, ALUserTreeItemType.USER.value)
+        UserItem.setText(0, new_user["username"])
+        UserItem.setText(1, "")
+        UserItem.setData(0, Qt.UserRole, new_user)
+        UserItem.setCheckState(1, Qt.CheckState.Checked)
+        GroupItem.setExpanded(True)
+        self.UserTreeWidget.setCurrentItem(UserItem)
         self.setUserToWidget(new_user)
         self.UserTreeWidget.itemChanged.connect(self.onUserTreeWidgetItemChanged)
-        return user_item
-
+        return UserItem
 
     def delUser(
         self,
-        user_item: QTreeWidgetItem = None
+        UserItem: QTreeWidgetItem = None
     ):
 
-        if user_item is None:
+        if UserItem is None:
             return
-        if user_item.type() != ALUserTreeItemType.USER.value:
+        if UserItem.type() != ALUserTreeItemType.USER.value:
             return
-        parent_item = user_item.parent()
-        index = parent_item.indexOfChild(user_item)
-        parent_item.takeChild(index)
-        if parent_item.childCount() == 0:
+        ParentItem = UserItem.parent()
+        index = ParentItem.indexOfChild(UserItem)
+        ParentItem.takeChild(index)
+        if ParentItem.childCount() == 0:
             self.UserTreeWidget.setCurrentItem(None)
 
-
     def renameItem(
         self,
         item: QTreeWidgetItem,
@@ -795,19 +787,19 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         room = self.RoomComboBox.currentText()
         floor_idx = self.__floor_rmap[floor]
         room_idx = self.__room_rmap[room]
-        dialog = ALSeatMapSelectDialog(
+        Dialog = ALSeatMapSelectDialog(
             self,
             floor,
             room,
             ALSeatMapTable[floor_idx][room_idx]
         )
-        dialog.selectSeats(self.SeatIDEdit.text().split(","))
-        if dialog.exec() == QDialog.DialogCode.Accepted:
-            selected_seats = dialog.getSelectedSeats()
+        Dialog.selectSeats(self.SeatIDEdit.text().split(","))
+        if Dialog.exec() == QDialog.DialogCode.Accepted:
+            selected_seats = Dialog.getSelectedSeats()
             if len(selected_seats) == 0:
                 self.SeatIDEdit.clear()
                 return
-            self.SeatIDEdit.setText(",".join(dialog.getSelectedSeats()))
+            self.SeatIDEdit.setText(",".join(Dialog.getSelectedSeats()))
 
     @Slot()
     def onUserTreeWidgetCurrentItemChanged(
@@ -852,57 +844,54 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         if item.type() == ALUserTreeItemType.GROUP.value:
             is_checked = item.checkState(1) == Qt.CheckState.Checked
             for i in range(item.childCount()):
-                child = item.child(i)
-                if self.UserTreeWidget.currentItem() == child:
+                Child = item.child(i)
+                if self.UserTreeWidget.currentItem() == Child:
                     self.UserTreeWidget.setCurrentItem(item)
-                child.setDisabled(not is_checked)
+                Child.setDisabled(not is_checked)
         else:
             is_checked = item.checkState(1) == Qt.CheckState.Checked
             item.setText(1, "" if is_checked else "跳过")
 
-
     def showTreeMenu(
         self,
         menu: QMenu
     ):
 
-        add_group_action = QAction("添加分组", menu)
-        add_group_action.triggered.connect(self.addGroup)
-        menu.addAction(add_group_action)
-
+        AddGroupAction = QAction("添加分组", menu)
+        AddGroupAction.triggered.connect(self.addGroup)
+        menu.addAction(AddGroupAction)
 
     def showGroupMenu(
         self,
         menu: QMenu,
-        group_item: QTreeWidgetItem = None
+        GroupItem: QTreeWidgetItem = None
     ):
 
-        add_user_action = QAction("添加用户", menu)
-        rename_group_action = QAction("重命名分组", menu)
-        del_group_action = QAction("删除分组", menu)
-        add_user_action.triggered.connect(lambda: self.addUser(group_item))
-        rename_group_action.triggered.connect(lambda: self.renameItem(group_item))
-        del_group_action.triggered.connect(lambda: self.delGroup(group_item))
-        menu.addAction(add_user_action)
+        AddUserAction = QAction("添加用户", menu)
+        RenameGroupAction = QAction("重命名分组", menu)
+        DelGroupAction = QAction("删除分组", menu)
+        AddUserAction.triggered.connect(lambda: self.addUser(GroupItem))
+        RenameGroupAction.triggered.connect(lambda: self.renameItem(GroupItem))
+        DelGroupAction.triggered.connect(lambda: self.delGroup(GroupItem))
+        menu.addAction(AddUserAction)
         menu.addSeparator()
-        menu.addAction(rename_group_action)
-        menu.addAction(del_group_action)
-        if group_item.checkState(1) == Qt.CheckState.Unchecked:
-            add_user_action.setEnabled(False)
-
+        menu.addAction(RenameGroupAction)
+        menu.addAction(DelGroupAction)
+        if GroupItem.checkState(1) == Qt.CheckState.Unchecked:
+            AddUserAction.setEnabled(False)
 
     def showUserMenu(
         self,
         menu: QMenu,
-        user_item: QTreeWidgetItem = None
+        UserItem: QTreeWidgetItem = None
     ):
 
-        rename_user_action = QAction("重命名用户", menu)
-        del_user_action = QAction("删除用户", menu)
-        rename_user_action.triggered.connect(lambda: self.renameItem(user_item))
-        del_user_action.triggered.connect(lambda: self.delUser(user_item))
-        menu.addAction(rename_user_action)
-        menu.addAction(del_user_action)
+        RenameUserAction = QAction("重命名用户", menu)
+        DelUserAction = QAction("删除用户", menu)
+        RenameUserAction.triggered.connect(lambda: self.renameItem(UserItem))
+        DelUserAction.triggered.connect(lambda: self.delUser(UserItem))
+        menu.addAction(RenameUserAction)
+        menu.addAction(DelUserAction)
 
     @Slot()
     def onUserTreeWidgetContextMenu(
@@ -910,31 +899,31 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         pos
     ):
 
-        current_item = self.UserTreeWidget.itemAt(pos)
-        menu = QMenu(self.UserTreeWidget)
-        if current_item is None:
-            self.showTreeMenu(menu)
-        elif current_item.type() == ALUserTreeItemType.GROUP.value:
-            self.showGroupMenu(menu, current_item)
+        CurrentItem = self.UserTreeWidget.itemAt(pos)
+        Menu = QMenu(self.UserTreeWidget)
+        if CurrentItem is None:
+            self.showTreeMenu(Menu)
+        elif CurrentItem.type() == ALUserTreeItemType.GROUP.value:
+            self.showGroupMenu(Menu, CurrentItem)
         else:
-            self.showUserMenu(menu, current_item)
-        menu.exec_(self.UserTreeWidget.mapToGlobal(pos))
+            self.showUserMenu(Menu, CurrentItem)
+        Menu.exec_(self.UserTreeWidget.mapToGlobal(pos))
 
     @Slot()
     def onAddUserButtonClicked(
         self
     ):
 
-        current_item = self.UserTreeWidget.currentItem()
-        self.addUser(current_item)
+        CurrentItem = self.UserTreeWidget.currentItem()
+        self.addUser(CurrentItem)
 
     @Slot()
     def onDelUserButtonClicked(
         self
     ):
 
-        current_item = self.UserTreeWidget.currentItem()
-        self.delUser(current_item)
+        CurrentItem = self.UserTreeWidget.currentItem()
+        self.delUser(CurrentItem)
 
     @Slot()
     def onBrowseBrowserDriverButtonClicked(
@@ -950,21 +939,19 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         if browser_driver_path:
             self.BrowseBrowserDriverEdit.setText(QDir.toNativeSeparators(browser_driver_path))
 
-
     @Slot()
     def onAutoDownloadWebDriverButtonClicked(
         self
     ):
 
-        dialog = ALWebDriverDownloadDialog(self)
-        dialog.show()
-        dialog.exec_()
-        selected_driver_info = dialog.getSelectedDriverInfo()
+        Dialog = ALWebDriverDownloadDialog(self)
+        Dialog.show()
+        Dialog.exec_()
+        selected_driver_info = Dialog.getSelectedDriverInfo()
         if selected_driver_info and selected_driver_info.driver_path:
             self.BrowserTypeComboBox.setCurrentText(selected_driver_info.driver_type.value)
             self.BrowseBrowserDriverEdit.setText(QDir.toNativeSeparators(str(selected_driver_info.driver_path)))
 
-
     @Slot()
     def onBrowseCurrentRunConfigButtonClicked(
         self
@@ -984,13 +971,13 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                 self.setRunConfigToWidget(data)
                 self.__config_paths["run"] = run_config_path
                 self.CurrentRunConfigEdit.setText(run_config_path)
-                paths = self.__cfg_mgr.get(ConfigManager.ConfigType.GLOBAL, "automation.run_path.paths", [])
+                paths = self.__cfg_mgr.get(CfgKey.GLOBAL.AUTOMATION.RUN_PATH.PATHS, [])
                 if run_config_path not in paths:
                     paths.append(run_config_path)
                     index = len(paths) - 1
                 else:
                     index = paths.index(run_config_path)
-                self.__cfg_mgr.set(ConfigManager.ConfigType.GLOBAL, "automation.run_path", {"current": index, "paths": paths})
+                self.__cfg_mgr.set(CfgKey.GLOBAL.AUTOMATION.RUN_PATH.ROOT, {"current": index, "paths": paths})
             else:
                 QMessageBox.warning(
                     self,
@@ -1019,13 +1006,13 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                 self.setUsersToTreeWidget(data)
                 self.__config_paths["user"] = user_config_path
                 self.CurrentUserConfigEdit.setText(user_config_path)
-                paths = self.__cfg_mgr.get(ConfigManager.ConfigType.GLOBAL, "automation.user_path.paths", [])
+                paths = self.__cfg_mgr.get(CfgKey.GLOBAL.AUTOMATION.USER_PATH.PATHS, [])
                 if user_config_path not in paths:
                     paths.append(user_config_path)
                     index = len(paths) - 1
                 else:
                     index = paths.index(user_config_path)
-                self.__cfg_mgr.set(ConfigManager.ConfigType.GLOBAL, "automation.user_path", {"current": index, "paths": paths})
+                self.__cfg_mgr.set(CfgKey.GLOBAL.AUTOMATION.USER_PATH.ROOT, {"current": index, "paths": paths})
             else:
                 QMessageBox.warning(
                     self,
@@ -1146,8 +1133,8 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         self
     ):
 
-        current_item = self.UserTreeWidget.currentItem()
-        if current_item and current_item.type() == ALUserTreeItemType.USER.value:
+        CurrentItem = self.UserTreeWidget.currentItem()
+        if CurrentItem and CurrentItem.type() == ALUserTreeItemType.USER.value:
             self.UserTreeWidget.setCurrentItem(None)
         if self.saveConfigs(
             self.__config_paths["run"],

src/gui/ALMainWindow.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2025 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -10,25 +10,37 @@ See the LICENSE file for details.
 import queue
 
 from PySide6.QtCore import (
-    Qt, Signal, Slot, QTimer, QUrl,
-)
-from PySide6.QtWidgets import (
-    QMainWindow, QMenu, QSystemTrayIcon, QMessageBox
+    QTimer,
+    QUrl,
+    Qt,
+    Signal,
+    Slot
 )
 from PySide6.QtGui import (
-    QTextCursor, QCloseEvent, QFont, QIcon, QDesktopServices
+    QCloseEvent,
+    QDesktopServices,
+    QFont,
+    QIcon,
+    QTextCursor
+)
+from PySide6.QtWidgets import (
+    QMainWindow,
+    QMenu,
+    QMessageBox,
+    QSystemTrayIcon
 )
 
-import managers.config.ConfigManager as ConfigManager
-
 from base.MsgBase import MsgBase
-
-from gui.resources.ui.Ui_ALMainWindow import Ui_ALMainWindow
-from gui.resources import ALResource
-from gui.ALConfigWidget import ALConfigWidget
-from gui.ALTimerTaskManageWidget import ALTimerTaskManageWidget
 from gui.ALAboutDialog import ALAboutDialog
-from gui.ALMainWorkers import TimerTaskWorker, AutoLibWorker
+from gui.ALConfigWidget import ALConfigWidget
+from gui.ALMainWorkers import (
+    AutoLibWorker,
+    TimerTaskWorker
+)
+from gui.ALTimerTaskManageWidget import ALTimerTaskManageWidget
+from gui.resources import ALResource
+from gui.resources.ui.Ui_ALMainWindow import Ui_ALMainWindow
+from managers.config.ConfigUtils import ConfigUtils
 
 
 class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
@@ -44,9 +56,8 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
 
         MsgBase.__init__(self, queue.Queue(), queue.Queue())
         QMainWindow.__init__(self)
-        self.__cfg_mgr = ConfigManager.instance()
         self.__timer_task_queue = queue.Queue()
-        self.__config_paths = ConfigManager.getValidateAutomationConfigPaths()
+        self.__config_paths = ConfigUtils.getAutomationConfigPaths()
         self.__alTimerTaskManageWidget = None
         self.__alConfigWidget = None
         self.__auto_lib_thread = None
@@ -61,13 +72,12 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
         self.startTimerTaskPolling()
         self._showLog("主窗口初始化完成")
 
-
     def modifyUi(
         self
     ):
 
-        self.icon = QIcon(":/res/icon/icons/AutoLibrary_32x32.ico")
-        self.setWindowIcon(self.icon)
+        self.Icon = QIcon(":/res/icons/AutoLibrary_Logo_64.svg")
+        self.setWindowIcon(self.Icon)
         self.MessageIOTextEdit.setFont(QFont("Courier New", 10))
         self.ManualAction.triggered.connect(self.onManualActionTriggered)
         self.AboutAction.triggered.connect(self.onAboutActionTriggered)
@@ -92,22 +102,19 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
         self.__alTimerTaskManageWidget.timerTaskManageWidgetIsClosed.connect(self.onTimerTaskManageWidgetClosed)
         self.__alTimerTaskManageWidget.setWindowFlags(Qt.WindowType.Window|Qt.WindowType.WindowCloseButtonHint)
 
-
     def onAboutActionTriggered(
         self
     ):
 
-        about_dialog = ALAboutDialog(self)
-        about_dialog.exec()
-
+        AboutDialog = ALAboutDialog(self)
+        AboutDialog.exec()
 
     def onManualActionTriggered(
         self
     ):
 
-        url = QUrl("https://www.autolibrary.kenanzhu.com/manuals")
-        QDesktopServices.openUrl(url)
-
+        Url = QUrl("https://www.autolibrary.kenanzhu.com/manuals")
+        QDesktopServices.openUrl(Url)
 
     def setupTray(
         self
@@ -116,7 +123,7 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
         if not QSystemTrayIcon.isSystemTrayAvailable():
             self._showTrace("操作系统不支持系统托盘功能, 无法创建系统托盘图标", self.TraceLevel.WARNING)
             return
-        self.TrayIcon = QSystemTrayIcon(self.icon, self)
+        self.TrayIcon = QSystemTrayIcon(self.Icon, self)
         self.TrayIcon.setToolTip("AutoLibrary")
 
         self.TrayMenu = QMenu()
@@ -130,7 +137,6 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
         self.TrayIcon.activated.connect(self.onTrayIconActivated)
         self.TrayIcon.show()
 
-
     def hideToTray(
         self
     ):
@@ -143,7 +149,6 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
             2000
         )
 
-
     def onTrayIconActivated(
         self,
         reason: QSystemTrayIcon.ActivationReason
@@ -152,7 +157,6 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
         if reason == QSystemTrayIcon.DoubleClick:
             self.showNormal()
 
-
     def connectSignals(
         self
     ):
@@ -164,7 +168,6 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
         self.SendButton.clicked.connect(self.onSendButtonClicked)
         self.MessageEdit.returnPressed.connect(self.onSendButtonClicked)
 
-
     def closeEvent(
         self,
         event: QCloseEvent
@@ -190,7 +193,6 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
         self._showLog("主窗口关闭")
         QMainWindow.closeEvent(self, event)
 
-
     def appendToTextEdit(
         self,
         text: str
@@ -204,7 +206,6 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
         scrollbar = self.MessageIOTextEdit.verticalScrollBar()
         scrollbar.setValue(scrollbar.maximum())
 
-
     def startMsgPolling(
         self
     ):
@@ -213,7 +214,6 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
         self.__msg_queue_timer.timeout.connect(self.pollMsgQueue)
         self.__msg_queue_timer.start(100)
 
-
     def startTimerTaskPolling(
         self
     ):
@@ -222,7 +222,6 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
         self.__timer_task_timer.timeout.connect(self.pollTimerTaskQueue)
         self.__timer_task_timer.start(500)
 
-
     def pollTimerTaskQueue(
         self
     ):
@@ -256,7 +255,6 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
             self.__is_running_timer_task = False
             pass
 
-
     def setControlButtons(
         self,
         config_button_enabled: bool,
@@ -300,7 +298,7 @@ class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
             self.__alConfigWidget.configWidgetIsClosed.disconnect(self.onConfigWidgetClosed)
             self.__alConfigWidget.deleteLater()
             self.__alConfigWidget = None
-        self.__config_paths = ConfigManager.getValidateAutomationConfigPaths()
+        self.__config_paths = ConfigUtils.getAutomationConfigPaths()
         self.setControlButtons(True, None, None)
         self._showLog("配置窗口已关闭,配置文件路径已更新")
 

src/gui/ALMainWorkers.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2025 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -12,12 +12,14 @@ import time
 import queue
 
 from PySide6.QtCore import (
-    Slot, Signal, QThread
+    Signal,
+    QThread,
 )
 
 from base.MsgBase import MsgBase
-from operators.AutoLib import AutoLib
+from pages.AutoLib import AutoLib
 from utils.JSONReader import JSONReader
+from autoscript import createEngine
 
 
 class AutoLibWorker(MsgBase, QThread):
@@ -29,14 +31,13 @@ class AutoLibWorker(MsgBase, QThread):
         self,
         input_queue: queue.Queue,
         output_queue: queue.Queue,
-        config_paths: dict
+        config_paths: dict,
     ):
 
         MsgBase.__init__(self, input_queue, output_queue)
         QThread.__init__(self)
         self.__config_paths = config_paths
 
-
     def checkTimeAvailable(
         self,
     ) -> bool:
@@ -45,13 +46,12 @@ class AutoLibWorker(MsgBase, QThread):
         if current_time >= "23:30" or current_time <= "07:30":
             self._showTrace(
                 "当前时间不在图书馆开放时间内, 请在 07:30 - 23:30 之间尝试",
-                self.TraceLevel.WARNING
+                self.TraceLevel.WARNING,
             )
             return False
         self._showLog(f"时间检查通过, 当前时间: {current_time}", self.TraceLevel.INFO)
         return True
 
-
     def checkConfigPaths(
         self,
     ) -> bool:
@@ -61,82 +61,113 @@ class AutoLibWorker(MsgBase, QThread):
         ):
             self._showTrace(
                 "配置文件路径不存在, 请检查配置文件路径是否正确",
-                self.TraceLevel.ERROR
+                self.TraceLevel.ERROR,
             )
             return False
-        self._showLog(f"配置文件路径检查通过, 路径: {self.__config_paths}", self.TraceLevel.INFO)
+        self._showLog(
+            f"配置文件路径检查通过, 路径: {self.__config_paths}",
+            self.TraceLevel.INFO,
+        )
         return True
 
-
     def loadConfigs(
-        self
+        self,
     ) -> bool:
 
         self._showTrace(
             f"正在加载配置文件, 运行配置文件路径: {self.__config_paths["run"]}",
-            no_log=True
+            no_log=True,
         )
-        self.__run_config = JSONReader(self.__config_paths["run"]).data()
+        self._run_config = JSONReader(self.__config_paths["run"]).data()
         self._showTrace(
             f"正在加载配置文件, 用户配置文件路径: {self.__config_paths["user"]}",
-            no_log=True
+            no_log=True,
         )
-        self.__user_config = JSONReader(self.__config_paths["user"]).data()
-        if self.__run_config is None or self.__user_config is None:
+        self._user_config = JSONReader(self.__config_paths["user"]).data()
+        if self._run_config is None or self._user_config is None:
             self._showTrace(
                 "配置文件加载失败, 请检查配置文件是否正确",
-                self.TraceLevel.ERROR
+                self.TraceLevel.ERROR,
             )
             return False
-        if not self.__user_config.get("groups"):
+        if not self._user_config.get("groups"):
             self._showTrace(
                 "用户配置文件中无有效任务组, 请检查用户配置文件是否正确",
-                self.TraceLevel.WARNING
+                self.TraceLevel.WARNING,
             )
             return False
-        self._showLog(f"配置文件加载成功, 任务组数量: {len(self.__user_config.get('groups', []))}", self.TraceLevel.INFO)
+        self._showLog(
+            f"配置文件加载成功, 任务组数量: {len(self._user_config.get("groups"))}",
+            self.TraceLevel.INFO,
+        )
         return True
 
+    def _runName(
+        self,
+    ) -> str:
+
+        return "常规任务"
+
+    def _beforeCreateAutoLib(
+        self,
+    ):
+
+        return
+
+    def _onChecksFailed(
+        self,
+    ) -> bool:
+
+        return True
+
+    def _onFinished(
+        self,
+    ):
+
+        self.autoLibWorkerIsFinished.emit()
+
+    def _onError(
+        self,
+        error_msg: str,
+    ):
+
+        self._showTrace(error_msg, self.TraceLevel.ERROR)
+        self.autoLibWorkerFinishedWithError.emit()
 
     def run(
-        self
+        self,
     ):
 
         auto_lib = None
-        self._showTrace("AutoLibrary 开始运行")
-        if not self.checkTimeAvailable()\
-        or not self.checkConfigPaths():
-            # time or config existence check failed, skip and finish
-            pass
+        self._showTrace(f"{self._runName()} 开始运行")
+
+        if not self.checkTimeAvailable() or not self.checkConfigPaths():
+            if not self._onChecksFailed():
+                return
         else:
             try:
                 if not self.loadConfigs():
                     raise Exception("配置文件加载失败")
+                self._beforeCreateAutoLib()
                 auto_lib = AutoLib(
                     self._input_queue,
                     self._output_queue,
-                    self.__run_config
+                    self._run_config,
                 )
-                groups = self.__user_config.get("groups")
+                groups = self._user_config.get("groups")
                 for group in groups:
-                    if not group["enabled"]:
-                        self._showTrace(f"任务组 {group["name"]} 已跳过", no_log=True)
+                    if not group.get("enabled", False):
+                        self._showTrace(f"任务组 {group.get("name", "未知")} 已跳过", no_log=True)
                         continue
-                    self._showTrace(f"正在运行任务组 {group["name"]}", no_log=True)
-                    auto_lib.run(
-                        { "users": group.get("users", []) }
-                    )
+                    self._showTrace(f"正在运行任务组 {group.get("name", "未知")}", no_log=True)
+                    auto_lib.run({"users": group.get("users", [])})
             except Exception as e:
-                self._showTrace(
-                    f"AutoLibrary 运行时发生异常 : {e}",
-                    self.TraceLevel.ERROR
-                )
-                self.autoLibWorkerFinishedWithError.emit()
+                self._onError(f"{self._runName()} 运行时发生异常 : {e}")
                 return
         if auto_lib:
             auto_lib.close()
-        self._showTrace("AutoLibrary 运行结束")
-        self.autoLibWorkerIsFinished.emit()
+        self._showTrace(f"{self._runName()} 运行结束")
+        self._onFinished()
 
 
 class TimerTaskWorker(AutoLibWorker):
@@ -148,37 +179,70 @@ class TimerTaskWorker(AutoLibWorker):
         timer_task: dict,
         input_queue: queue.Queue,
         output_queue: queue.Queue,
-        config_paths: dict
+        config_paths: dict,
     ):
 
         super().__init__(input_queue, output_queue, config_paths)
         self.__timer_task = timer_task
 
-        self.autoLibWorkerIsFinished.connect(self.onTimerTaskIsFinished)
-        self.autoLibWorkerFinishedWithError.connect(self.onTimerTaskFinishedWithError)
+    def _runName(
+        self,
+    ) -> str:
 
-    def run(
-        self
+        return f"定时任务 '{self.__timer_task.get("name", "未知")}'"
+
+    def _beforeCreateAutoLib(
+        self,
     ):
 
-        self._showTrace(f"定时任务 {self.__timer_task['name']} 开始运行")
-        super().run()
+        self.applyRepeatAutoScript()
 
-    @Slot()
-    def onTimerTaskFinishedWithError(
-        self
+    def _onChecksFailed(
+        self,
+    ) -> bool:
+
+        self._showTrace("定时任务跳过执行: 时间或配置文件检查未通过")
+        self.timerTaskWorkerIsFinished.emit(False, self.__timer_task)
+        return False
+
+    def _onFinished(
+        self,
     ):
 
-        self._showTrace(
-            f"定时任务 {self.__timer_task['name']} 运行时发生异常",
-            self.TraceLevel.ERROR
-        )
+        self.timerTaskWorkerIsFinished.emit(False, self.__timer_task)
+
+    def _onError(
+        self,
+        error_msg: str,
+    ):
+
+        self._showTrace(error_msg, self.TraceLevel.ERROR)
         self.timerTaskWorkerIsFinished.emit(True, self.__timer_task)
 
-    @Slot()
-    def onTimerTaskIsFinished(
-        self
+    def applyRepeatAutoScript(
+        self,
     ):
 
-        self._showTrace(f"定时任务 {self.__timer_task['name']} 运行结束")
-        self.timerTaskWorkerIsFinished.emit(False, self.__timer_task)
+        auto_script = self.__timer_task.get("repeat_auto_script", "")
+        if not auto_script or not auto_script.strip():
+            return
+        self._showTrace("检测到重复定时任务 AutoScript, 开始执行...", no_log=True)
+        groups = self._user_config.get("groups", [])
+        affected_count = 0
+        for group in groups:
+            if not group.get("enabled", False):
+                continue
+            for user in group.get("users", []):
+                try:
+                    engine = createEngine()
+                    engine.execute(auto_script, user)
+                    affected_count += 1
+                except ValueError as e:
+                    self._showTrace(
+                        f"AutoScript 执行错误 (用户 {user.get("username", "未知")}): {e}",
+                        self.TraceLevel.ERROR,
+                    )
+        self._showLog(
+            f"AutoScript 执行完毕, 影响 {affected_count} 个用户",
+            self.TraceLevel.INFO,
+        )

src/gui/ALSeatFrame.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2025 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -63,14 +63,12 @@ class ALSeatFrame(QFrame):
             self.toggleSelection()
             self.clicked.emit(self.__seat_number)
 
-
     def isSelected(
         self
     ):
 
         return self.__is_selected
 
-
     def toggleSelection(self):
 
         self.__is_selected = not self.__is_selected

src/gui/ALSeatMapSelectDialog.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2026 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -8,15 +8,20 @@ You may use, modify, and distribute this file under the terms of the MIT License
 See the LICENSE file for details.
 """
 from PySide6.QtCore import (
-    Qt, Slot, Signal
-)
-from PySide6.QtWidgets import (
-    QDialog, QLabel, QHBoxLayout, QVBoxLayout,
-    QPushButton,
+    Qt,
+    Signal,
+    Slot
 )
 from PySide6.QtGui import (
     QCloseEvent
 )
+from PySide6.QtWidgets import (
+    QDialog,
+    QHBoxLayout,
+    QLabel,
+    QPushButton,
+    QVBoxLayout
+)
 
 from gui.ALSeatMapView import ALSeatMapView
 
@@ -42,7 +47,6 @@ class ALSeatMapSelectDialog(QDialog):
         self.setupUi()
         self.connectSignals()
 
-
     def setupUi(
         self
     ):
@@ -85,7 +89,6 @@ class ALSeatMapSelectDialog(QDialog):
         self.SeatMapWidgetControlLayout.addWidget(self.ConfirmButton)
         self.SeatMapWidgetMainLayout.addLayout(self.SeatMapWidgetControlLayout)
 
-
     def connectSignals(
         self
     ):
@@ -93,7 +96,6 @@ class ALSeatMapSelectDialog(QDialog):
         self.ConfirmButton.clicked.connect(self.onConfirmButtonClicked)
         self.CancelButton.clicked.connect(self.onCancelButtonClicked)
 
-
     def showEvent(
         self,
         event
@@ -117,7 +119,6 @@ class ALSeatMapSelectDialog(QDialog):
 
         return result
 
-
     def closeEvent(
         self,
         event: QCloseEvent
@@ -131,7 +132,6 @@ class ALSeatMapSelectDialog(QDialog):
         self.seatMapSelectDialogIsClosed.emit(self.getSelectedSeats())
         super().closeEvent(event)
 
-
     def selectSeat(
         self,
         seat_number: str
@@ -139,7 +139,6 @@ class ALSeatMapSelectDialog(QDialog):
 
         self.SeatMapGraphicsView.selectSeat(seat_number)
 
-
     def selectSeats(
         self,
         seat_numbers: list[str]
@@ -147,14 +146,12 @@ class ALSeatMapSelectDialog(QDialog):
 
         return self.SeatMapGraphicsView.selectSeats(seat_numbers)
 
-
     def getSelectedSeats(
         self
     ) -> list[str]:
 
         return self.SeatMapGraphicsView.getSelectedSeats()
 
-
     def clearSelections(
         self
     ):

src/gui/ALSeatMapView.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2026 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -8,14 +8,21 @@ You may use, modify, and distribute this file under the terms of the MIT License
 See the LICENSE file for details.
 """
 from PySide6.QtCore import (
-    Qt, Slot, QEvent
+    Qt,
+    Slot,
+    QEvent
 )
 from PySide6.QtWidgets import (
-    QFrame, QWidget,
-    QGridLayout, QGraphicsView, QGraphicsScene, QGraphicsItem
+    QFrame,
+    QWidget,
+    QGridLayout,
+    QGraphicsView,
+    QGraphicsScene,
+    QGraphicsItem
 )
 from PySide6.QtGui import (
-    QPainter, QWheelEvent
+    QPainter,
+    QWheelEvent
 )
 
 from gui.ALSeatFrame import ALSeatFrame
@@ -35,18 +42,6 @@ class ALSeatMapView(QGraphicsView):
 
         self.setupUi()
 
-    @staticmethod
-    def formatSeatNumber(
-        seat_number: str
-    ) -> str:
-
-        if seat_number and not seat_number[-1].isdigit():
-            digits = seat_number[:-1]
-            letter = seat_number[-1]
-            return digits.zfill(3) + letter
-        return seat_number.zfill(3)
-
-
     def eventFilter(
         self,
         watched,
@@ -61,7 +56,6 @@ class ALSeatMapView(QGraphicsView):
             return True
         return super().eventFilter(watched, event)
 
-
     def zoomGraphicsView(
         self,
         event: QWheelEvent
@@ -80,7 +74,6 @@ class ALSeatMapView(QGraphicsView):
         self.setTransformationAnchor(QGraphicsView.ViewportAnchor.AnchorUnderMouse)
         self.scale(zoom_factor, zoom_factor)
 
-
     def setupUi(
         self
     ):
@@ -100,7 +93,6 @@ class ALSeatMapView(QGraphicsView):
         self.ContainerProxy = self.SeatMapGraphicsScene.addWidget(self.SeatsContainerWidget)
         self.ContainerProxy.setFlag(QGraphicsItem.GraphicsItemFlag.ItemIsSelectable, False)
 
-
     def setupSeatMap(
         self
     ):
@@ -111,21 +103,20 @@ class ALSeatMapView(QGraphicsView):
             seats_number = [seat.strip() for seat in row.split(",")]
             for seat_number in seats_number:
                 if seat_number:
-                    seat_widget = ALSeatFrame(seat_number)
-                    seat_widget.clicked.connect(self.onSeatClicked)
-                    self.SeatsContainerLayout.addWidget(seat_widget, row_idx, col_idx)
-                    self.__seat_frames[seat_number] = seat_widget
+                    SeatWidget = ALSeatFrame(seat_number)
+                    SeatWidget.clicked.connect(self.onSeatClicked)
+                    self.SeatsContainerLayout.addWidget(SeatWidget, row_idx, col_idx)
+                    self.__seat_frames[seat_number] = SeatWidget
                 else:
-                    spacer = QFrame()
-                    spacer.setFixedSize(20, 30)
-                    spacer.setStyleSheet("background-color: transparent; border: none;")
-                    self.SeatsContainerLayout.addWidget(spacer, row_idx, col_idx)
+                    Spacer = QFrame()
+                    Spacer.setFixedSize(20, 30)
+                    Spacer.setStyleSheet("background-color: transparent; border: none;")
+                    self.SeatsContainerLayout.addWidget(Spacer, row_idx, col_idx)
                 col_idx += 1
         self.SeatsContainerLayout.setSpacing(20)
         self.SeatsContainerLayout.setContentsMargins(20, 20, 20, 20)
         self.SeatsContainerWidget.adjustSize()
 
-
     def selectSeat(
         self,
         seat_number: str
@@ -142,7 +133,6 @@ class ALSeatMapView(QGraphicsView):
         widget.toggleSelection()
         self.__selected_seats.append(seat_number)
 
-
     def selectSeats(
         self,
         selected_seats: list
@@ -152,14 +142,12 @@ class ALSeatMapView(QGraphicsView):
         for seat_number in selected_seats:
             self.selectSeat(seat_number)
 
-
     def getSelectedSeats(
         self
     ) -> list[str]:
 
         return self.__selected_seats
 
-
     def clearSelections(
         self
     ):
@@ -185,4 +173,15 @@ class ALSeatMapView(QGraphicsView):
             if len(self.__selected_seats) < 1:
                 self.__selected_seats.append(seat_number)
             else:
-                self.__seat_frames[seat_number].toggleSelection()
+                self.__seat_frames[seat_number].toggleSelection()
+
+    @staticmethod
+    def formatSeatNumber(
+        seat_number: str
+    ) -> str:
+
+        if seat_number and not seat_number[-1].isdigit():
+            digits = seat_number[:-1]
+            letter = seat_number[-1]
+            return digits.zfill(3) + letter
+        return seat_number.zfill(3)

src/gui/ALStatusLabel.py

@@ -1,14 +1,28 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
 
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
 from enum import Enum
 
-from PySide6.QtWidgets import (
-    QLabel
-)
 from PySide6.QtCore import (
-    Qt, Property, QPropertyAnimation, QEasingCurve
+    Property,
+    QEasingCurve,
+    QPropertyAnimation,
+    Qt
 )
 from PySide6.QtGui import (
-    QPainter, QColor, QConicalGradient, QPalette
+    QColor,
+    QConicalGradient,
+    QPainter,
+    QPalette
+)
+from PySide6.QtWidgets import (
+    QLabel
 )
 
 
@@ -36,14 +50,12 @@ class ALStatusLabel(QLabel):
 
         self.setupUi()
 
-
     def setupUi(
         self
     ):
 
         self.setFixedSize(36, 36)
         self.setAlignment(Qt.AlignmentFlag.AlignCenter)
-
         self.RunningAnimation = QPropertyAnimation(self, b"iconAngle")
         self.RunningAnimation.setDuration(1000)
         self.RunningAnimation.setStartValue(0)
@@ -51,14 +63,12 @@ class ALStatusLabel(QLabel):
         self.RunningAnimation.setLoopCount(-1)
         self.RunningAnimation.setEasingCurve(QEasingCurve.Type.Linear)
 
-
     def isDarkMode(
         self
     ) -> bool:
 
         return self.palette().color(QPalette.ColorRole.Window).value() < 128
 
-
     def getMarkColor(
         self
     ) -> QColor:
@@ -103,41 +113,40 @@ class ALStatusLabel(QLabel):
         self.__icon_angle = value
         self.update()
 
-
     def paintEvent(
         self,
         event
     ):
 
-        painter = QPainter(self)
-        painter.setRenderHint(QPainter.RenderHint.Antialiasing)
+        Painter = QPainter(self)
+        Painter.setRenderHint(QPainter.RenderHint.Antialiasing)
         center_x = self.width()/2
         center_y = self.height()/2
         radius = min(center_x, center_y) - 3
         match self.__status:
             case self.Status.WAITING:
-                pen = painter.pen()
-                pen.setWidth(2)
-                pen.setBrush(Qt.BrushStyle.NoBrush)
-                pen.setCapStyle(Qt.PenCapStyle.RoundCap)
-                pen.setColor(QColor("#969696")) # grey
-                painter.setPen(pen)
-                painter.drawEllipse(
+                Pen = Painter.pen()
+                Pen.setWidth(2)
+                Pen.setBrush(Qt.BrushStyle.NoBrush)
+                Pen.setCapStyle(Qt.PenCapStyle.RoundCap)
+                Pen.setColor(QColor("#969696")) # grey
+                Painter.setPen(Pen)
+                Painter.drawEllipse(
                     int(center_x - radius),
                     int(center_y - radius),
                     int(radius*2),
                     int(radius*2)
                 )
             case self.Status.RUNNING:
-                gradient = QConicalGradient(center_x, center_y, self.__icon_angle)
-                gradient.setColorAt(0.0, QColor("#2294FF" if self.isDarkMode() else "#0094FF"))
-                gradient.setColorAt(1.0, QColor("#2294FF00"))
-                pen = painter.pen()
-                pen.setWidth(3)
-                pen.setBrush(gradient)
-                pen.setCapStyle(Qt.PenCapStyle.RoundCap)
-                painter.setPen(pen)
-                painter.drawEllipse(
+                Gradient = QConicalGradient(center_x, center_y, self.__icon_angle)
+                Gradient.setColorAt(0.0, QColor("#2294FF" if self.isDarkMode() else "#0094FF"))
+                Gradient.setColorAt(1.0, QColor("#2294FF00"))
+                Pen = Painter.pen()
+                Pen.setWidth(3)
+                Pen.setBrush(Gradient)
+                Pen.setCapStyle(Qt.PenCapStyle.RoundCap)
+                Painter.setPen(Pen)
+                Painter.drawEllipse(
                     int(center_x - radius),
                     int(center_y - radius),
                     int(radius*2),
@@ -145,102 +154,102 @@ class ALStatusLabel(QLabel):
                 )
             case self.Status.SUCCESS:
                 # draw the success green circle
-                pen = painter.pen()
-                pen.setWidth(2)
-                pen.setBrush(Qt.BrushStyle.NoBrush)
-                pen.setCapStyle(Qt.PenCapStyle.RoundCap)
-                pen.setColor(QColor("#4CAF50" if self.isDarkMode() else "#00AF50")) # green
-                painter.setPen(pen)
-                painter.drawEllipse(
+                Pen = Painter.pen()
+                Pen.setWidth(2)
+                Pen.setBrush(Qt.BrushStyle.NoBrush)
+                Pen.setCapStyle(Qt.PenCapStyle.RoundCap)
+                Pen.setColor(QColor("#4CAF50" if self.isDarkMode() else "#00AF50")) # green
+                Painter.setPen(Pen)
+                Painter.drawEllipse(
                     int(center_x - radius),
                     int(center_y - radius),
                     int(radius*2),
                     int(radius*2)
                 )
                 # draw the success check mark '✓'
-                painter.setPen(Qt.PenStyle.SolidLine)
-                pen = painter.pen()
-                pen.setWidth(3)
-                pen.setBrush(Qt.BrushStyle.NoBrush)
-                pen.setCapStyle(Qt.PenCapStyle.RoundCap)
+                Painter.setPen(Qt.PenStyle.SolidLine)
+                Pen = Painter.pen()
+                Pen.setWidth(3)
+                Pen.setBrush(Qt.BrushStyle.NoBrush)
+                Pen.setCapStyle(Qt.PenCapStyle.RoundCap)
                 # white when dark mode, black when light mode
-                pen.setColor(self.getMarkColor())
-                painter.setPen(pen)
+                Pen.setColor(self.getMarkColor())
+                Painter.setPen(Pen)
                 mark_size = radius/2
                 mark_path = [
                     (center_x - mark_size, center_y),
                     (center_x - mark_size/3, center_y + mark_size/2),
                     (center_x + mark_size, center_y - mark_size/2)
                 ]
-                painter.drawLine(
+                Painter.drawLine(
                     int(mark_path[0][0]),int(mark_path[0][1]),
                     int(mark_path[1][0]),int(mark_path[1][1])
                 )
-                painter.drawLine(
+                Painter.drawLine(
                     int(mark_path[1][0]),int(mark_path[1][1]),
                     int(mark_path[2][0]),int(mark_path[2][1])
                 )
             case self.Status.WARNING:
                 # draw the warning orange circle
-                pen = painter.pen()
-                pen.setWidth(2)
-                pen.setBrush(Qt.BrushStyle.NoBrush)
-                pen.setCapStyle(Qt.PenCapStyle.RoundCap)
-                pen.setColor(QColor("#FF9800")) # orange
-                painter.setPen(pen)
-                painter.drawEllipse(
+                Pen = Painter.pen()
+                Pen.setWidth(2)
+                Pen.setBrush(Qt.BrushStyle.NoBrush)
+                Pen.setCapStyle(Qt.PenCapStyle.RoundCap)
+                Pen.setColor(QColor("#FF9800")) # orange
+                Painter.setPen(Pen)
+                Painter.drawEllipse(
                     int(center_x - radius),
                     int(center_y - radius),
                     int(radius*2),
                     int(radius*2)
                 )
                 # draw the warning exclamation mark '!'
-                painter.setPen(Qt.PenStyle.SolidLine)
-                pen = painter.pen()
-                pen.setWidth(3)
-                pen.setBrush(Qt.BrushStyle.NoBrush)
-                pen.setCapStyle(Qt.PenCapStyle.RoundCap)
+                Painter.setPen(Qt.PenStyle.SolidLine)
+                Pen = Painter.pen()
+                Pen.setWidth(3)
+                Pen.setBrush(Qt.BrushStyle.NoBrush)
+                Pen.setCapStyle(Qt.PenCapStyle.RoundCap)
                 # white when dark mode, black when light mode
-                pen.setColor(self.getMarkColor())
-                painter.setPen(pen)
-                painter.drawLine(
+                Pen.setColor(self.getMarkColor())
+                Painter.setPen(Pen)
+                Painter.drawLine(
                     int(center_x), int(center_y - radius/2),
                     int(center_x), int(center_y + radius/6)
                 )
-                painter.drawPoint(
+                Painter.drawPoint(
                     int(center_x), int(center_y + radius/2)
                 )
             case self.Status.FAILURE:
                 # draw the failure red circle
-                pen = painter.pen()
-                pen.setWidth(2)
-                pen.setBrush(Qt.BrushStyle.NoBrush)
-                pen.setCapStyle(Qt.PenCapStyle.RoundCap)
-                pen.setColor(QColor("#DC0000")) # red
-                painter.setPen(pen)
-                painter.drawEllipse(
+                Pen = Painter.pen()
+                Pen.setWidth(2)
+                Pen.setBrush(Qt.BrushStyle.NoBrush)
+                Pen.setCapStyle(Qt.PenCapStyle.RoundCap)
+                Pen.setColor(QColor("#DC0000")) # red
+                Painter.setPen(Pen)
+                Painter.drawEllipse(
                     int(center_x - radius),
                     int(center_y - radius),
                     int(radius*2),
                     int(radius*2)
                 )
                 # draw the failure cross mark '✗'
-                painter.setPen(Qt.PenStyle.SolidLine)
-                pen = painter.pen()
-                pen.setWidth(3)
-                pen.setBrush(Qt.BrushStyle.NoBrush)
-                pen.setCapStyle(Qt.PenCapStyle.RoundCap)
+                Painter.setPen(Qt.PenStyle.SolidLine)
+                Pen = Painter.pen()
+                Pen.setWidth(3)
+                Pen.setBrush(Qt.BrushStyle.NoBrush)
+                Pen.setCapStyle(Qt.PenCapStyle.RoundCap)
                 # white when dark mode, black when light mode
-                pen.setColor(self.getMarkColor())
-                painter.setPen(pen)
+                Pen.setColor(self.getMarkColor())
+                Painter.setPen(Pen)
                 mark_size = radius/3
-                painter.drawLine(
+                Painter.drawLine(
                     int(center_x - mark_size), int(center_y - mark_size),
                     int(center_x + mark_size), int(center_y + mark_size)
                 )
-                painter.drawLine(
+                Painter.drawLine(
                     int(center_x + mark_size), int(center_y - mark_size),
                     int(center_x - mark_size), int(center_y + mark_size)
                 )
-        painter.end()
+        Painter.end()
         super().paintEvent(event)

src/gui/ALTimerTaskAddDialog.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2025 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -12,11 +12,26 @@ import uuid
 from enum import Enum
 from datetime import datetime, timedelta
 
-from PySide6.QtCore import Slot, QDateTime
-from PySide6.QtWidgets import QLabel, QDialog, QWidget, QSpinBox, QHBoxLayout, QGridLayout, QDateTimeEdit
+from PySide6.QtCore import (
+    Slot,
+    QDateTime,
+    QUrl
+)
+from PySide6.QtGui import QDesktopServices
+from PySide6.QtWidgets import (
+    QLabel,
+    QDialog,
+    QWidget,
+    QSpinBox,
+    QHBoxLayout,
+    QVBoxLayout,
+    QDateTimeEdit,
+    QGroupBox,
+    QPushButton
+)
 
 from gui.resources.ui.Ui_ALTimerTaskAddDialog import Ui_ALTimerTaskAddDialog
-import utils.TimerUtils as TimerUtils
+from utils.TimerUtils import TimerUtils
 
 
 class ALTimerTaskStatus(Enum):
@@ -34,15 +49,19 @@ class ALTimerTaskAddDialog(QDialog, Ui_ALTimerTaskAddDialog):
 
     def __init__(
         self,
-        parent = None
+        parent = None,
+        timer_task: dict = None
     ):
 
         super().__init__(parent)
+        self.__edit_timer_task = timer_task
 
         self.setupUi(self)
         self.modifyUi()
         self.connectSignals()
 
+        if self.__edit_timer_task:
+            self.loadTask(self.__edit_timer_task)
 
     def modifyUi(
         self
@@ -51,6 +70,8 @@ class ALTimerTaskAddDialog(QDialog, Ui_ALTimerTaskAddDialog):
         self.TimerTypeComboBox.setCurrentIndex(0)
         self.SpecificTimerWidget = QWidget()
         self.SpecificTimerLayout = QHBoxLayout(self.SpecificTimerWidget)
+        self.SpecificTimerLayout.setContentsMargins(0, 0, 0, 0)
+        self.SpecificTimerLayout.setSpacing(5)
         self.SpecificTimerLayout.addWidget(QLabel("定时时间："))
         self.SpecificDateTimeEdit = QDateTimeEdit()
         self.SpecificDateTimeEdit.setCalendarPopup(True)
@@ -59,9 +80,10 @@ class ALTimerTaskAddDialog(QDialog, Ui_ALTimerTaskAddDialog):
         self.SpecificDateTimeEdit.setDateTime(QDateTime.currentDateTime().addSecs(60))
         self.SpecificTimerLayout.addWidget(self.SpecificDateTimeEdit)
         self.TimerConfigLayout.addWidget(self.SpecificTimerWidget)
-
         self.RelativeTimerWidget = QWidget()
         self.RelativeTimerLayout = QHBoxLayout(self.RelativeTimerWidget)
+        self.RelativeTimerLayout.setContentsMargins(0, 0, 0, 0)
+        self.RelativeTimerLayout.setSpacing(5)
         self.RelativeTimerLayout.addWidget(QLabel("相对时间："))
         self.RelativeDaySpinBox = QSpinBox()
         self.RelativeDaySpinBox.setMinimum(0)
@@ -85,7 +107,82 @@ class ALTimerTaskAddDialog(QDialog, Ui_ALTimerTaskAddDialog):
         self.RelativeTimerLayout.addWidget(self.RelativeSecondSpinBox)
         self.TimerConfigLayout.addWidget(self.RelativeTimerWidget)
         self.RelativeTimerWidget.setVisible(False)
+        self.AutoScriptGroupBox = QGroupBox("AutoScript 指令")
+        self.AutoScriptLayout = QVBoxLayout(self.AutoScriptGroupBox)
+        self.AutoScriptLayout.setContentsMargins(3, 3, 3, 3)
+        self.AutoScriptLayout.setSpacing(3)
+        AutoScriptBtnLayout = QHBoxLayout()
+        self.AutoScriptEditButton = QPushButton("编辑")
+        self.AutoScriptEditButton.setMinimumHeight(25)
+        self.AutoScriptEditButton.setFixedWidth(80)
+        AutoScriptBtnLayout.addWidget(self.AutoScriptEditButton)
+        AutoScriptBtnLayout.addStretch()
+        self.AutoScriptHelpButton = QPushButton("?")
+        self.AutoScriptHelpButton.setFixedSize(20, 20)
+        self.AutoScriptHelpButton.setToolTip(
+            "AutoScript 是一种轻量级 DSL 语言，基于 Lua 实现。\n"
+            "用于在重复定时任务执行前，对用户的预约数据进行预处理\n"
+            "\n"
+            "点击查看完整在线文档"
+        )
+        self.AutoScriptHelpButton.setStyleSheet(
+            "QPushButton { border-radius: 10px; border: 1px solid #999; "
+            "font-weight: bold; color: #555; }"
+            "QPushButton:hover { background-color: #E0E0E0; }"
+        )
+        AutoScriptBtnLayout.addWidget(self.AutoScriptHelpButton)
+        self.AutoScriptStatusLabel = QLabel("未设置")
+        self.AutoScriptStatusLabel.setStyleSheet("color: #969696;")
+        self.AutoScriptStatusLabel.setFixedHeight(25)
+        AutoScriptBtnLayout.addWidget(self.AutoScriptStatusLabel)
+        self.AutoScriptLayout.addLayout(AutoScriptBtnLayout)
+        self.ALAddTimerTaskLayout.insertWidget(
+            self.ALAddTimerTaskLayout.indexOf(self.TaskConfigGroupBox) + 1,
+            self.AutoScriptGroupBox
+        )
+        self.AutoScriptGroupBox.setVisible(False)
+        self.__auto_script = ""
+        self.__mock_target_data = None
 
+    def loadTask(
+        self,
+        task: dict
+    ):
+
+        self.TaskNameLineEdit.setText(task.get("name", ""))
+        time_type = task.get("time_type", "特定时间")
+        self.TimerTypeComboBox.setCurrentText(time_type)
+        self.SpecificDateTimeEdit.setDateTime(
+            QDateTime(task["execute_time"])
+        )
+        self.RelativeDaySpinBox.setValue(0)
+        self.RelativeHourSpinBox.setValue(0)
+        self.RelativeMinuteSpinBox.setValue(0)
+        self.RelativeSecondSpinBox.setValue(0)
+        if task.get("silent", False):
+            self.SilentlyRunRadioButton.setChecked(True)
+        else:
+            self.ShowBeforeRunRadioButton.setChecked(True)
+        repeat = task.get("repeat", False)
+        self.RepeatCheckBox.setChecked(repeat)
+        if repeat:
+            repeat_days = task.get("repeat_days", [])
+            self.MonCheckBox.setChecked(0 in repeat_days)
+            self.TueCheckBox.setChecked(1 in repeat_days)
+            self.WedCheckBox.setChecked(2 in repeat_days)
+            self.ThuCheckBox.setChecked(3 in repeat_days)
+            self.FriCheckBox.setChecked(4 in repeat_days)
+            self.SatCheckBox.setChecked(5 in repeat_days)
+            self.SunCheckBox.setChecked(6 in repeat_days)
+            auto_script = task.get("repeat_auto_script", "")
+            if auto_script:
+                self.__auto_script = auto_script
+                self.AutoScriptStatusLabel.setText("已设置")
+                self.AutoScriptStatusLabel.setStyleSheet("color: #4CAF50;")
+            mock_data = task.get("mock_target_data")
+            if mock_data:
+                self.__mock_target_data = mock_data
+        self.ConfirmButton.setText("保存")
 
     def connectSignals(
         self
@@ -95,7 +192,8 @@ class ALTimerTaskAddDialog(QDialog, Ui_ALTimerTaskAddDialog):
         self.ConfirmButton.clicked.connect(self.accept)
         self.TimerTypeComboBox.currentIndexChanged.connect(self.onTimerTypeComboBoxIndexChanged)
         self.RepeatCheckBox.toggled.connect(self.onRepeatCheckBoxToggled)
-
+        self.AutoScriptEditButton.clicked.connect(self.onPreviewAutoScript)
+        self.AutoScriptHelpButton.clicked.connect(self.onAutoScriptHelp)
 
     def getTimerTask(
         self
@@ -119,18 +217,36 @@ class ALTimerTaskAddDialog(QDialog, Ui_ALTimerTaskAddDialog):
                 minutes = self.RelativeMinuteSpinBox.value(),
                 seconds = self.RelativeSecondSpinBox.value()
             )
-        task_data = {
-            "name": name,
-            "uuid": uuid.uuid4().hex.upper() + f"-{added_time.strftime("%Y%m%d%H%M%S")}",
-            "time_type": self.TimerTypeComboBox.currentText(),
-            "execute_time": execute_time,
-            "silent": silent,
-            "added_time": added_time,
-            "status": ALTimerTaskStatus.PENDING,
-            "executed": False,
-            "repeat": self.RepeatCheckBox.isChecked(),
-        }
-        if task_data["repeat"]:
+
+        if self.__edit_timer_task:
+            task_data = dict(self.__edit_timer_task)
+            task_data["name"] = name
+            task_data["execute_time"] = execute_time
+            task_data["silent"] = silent
+            task_data["status"] = ALTimerTaskStatus.PENDING
+            task_data["executed"] = False
+            task_data["repeat_auto_script"] = self.__auto_script
+            task_data["mock_target_data"] = self.__mock_target_data
+        else:
+            task_data = {
+                "name": name,
+                "uuid": uuid.uuid4().hex.upper() + f"-{added_time.strftime("%Y%m%d%H%M%S")}",
+                "time_type": self.TimerTypeComboBox.currentText(),
+                "execute_time": execute_time,
+                "silent": silent,
+                "added_time": added_time,
+                "status": ALTimerTaskStatus.PENDING,
+                "executed": False,
+                "repeat": self.RepeatCheckBox.isChecked(),
+                "repeat_auto_script": self.__auto_script,
+                "mock_target_data": self.__mock_target_data,
+            }
+
+        repeat = self.RepeatCheckBox.isChecked()
+        task_data["repeat"] = repeat
+        if repeat:
+            if "repeat_history" not in task_data:
+                task_data["repeat_history"] = []
             repeat_days = []
             if self.MonCheckBox.isChecked():
                 repeat_days.append(0)
@@ -152,7 +268,7 @@ class ALTimerTaskAddDialog(QDialog, Ui_ALTimerTaskAddDialog):
             task_data["repeat_hour"] = execute_time.hour
             task_data["repeat_minute"] = execute_time.minute
             task_data["repeat_second"] = execute_time.second
-            task_data["execute_time"] = TimerUtils.calculateNextRepeatTime(
+            task_data["execute_time"] = TimerUtils.getNextTimerRepeatTime(
                 task_data["repeat_days"],
                 task_data["repeat_hour"],
                 task_data["repeat_minute"],
@@ -181,4 +297,30 @@ class ALTimerTaskAddDialog(QDialog, Ui_ALTimerTaskAddDialog):
         self.ThuCheckBox.setEnabled(checked)
         self.FriCheckBox.setEnabled(checked)
         self.SatCheckBox.setEnabled(checked)
-        self.SunCheckBox.setEnabled(checked)
+        self.SunCheckBox.setEnabled(checked)
+        self.AutoScriptGroupBox.setVisible(checked)
+
+    @Slot()
+    def onPreviewAutoScript(self):
+        from gui.ALAutoScriptEditDialog import ALAutoScriptEditDialog
+        Dlg = ALAutoScriptEditDialog(self, self.__auto_script, self.__mock_target_data)
+        if Dlg.exec() == QDialog.DialogCode.Accepted:
+            script = Dlg.getScript()
+            self.__auto_script = script
+            self.__mock_target_data = Dlg.getMockData()
+            if script:
+                self.AutoScriptStatusLabel.setText("已设置")
+                self.AutoScriptStatusLabel.setStyleSheet("color: #4CAF50;")
+            else:
+                self.AutoScriptStatusLabel.setText("未设置")
+                self.AutoScriptStatusLabel.setStyleSheet("color: #969696;")
+        Dlg.deleteLater()
+
+    @Slot()
+    def onAutoScriptHelp(
+        self
+    ):
+
+        QDesktopServices.openUrl(
+            QUrl("https://www.autolibrary.kenanzhu.com/manuals/autoscript")
+        )

src/gui/ALTimerTaskHistoryDialog.py

@@ -28,22 +28,19 @@ class ALTimerTaskHistoryDialog(QDialog):
     ):
 
         super().__init__(parent)
-
         self.__task_data = task_data
-        self.__history = task_data.get("history", [])
+        self.__history = task_data.get("repeat_history", [])
 
-        self.modifyUi()
+        self.setupUi()
         self.connectSignals()
 
-
-    def modifyUi(
+    def setupUi(
         self
     ):
 
         self.setWindowTitle("定时任务执行历史 - AutoLibrary")
         self.setMinimumSize(300, 300)
         self.setMaximumSize(500, 400)
-
         MainLayout = QVBoxLayout(self)
         InfoLayout = QGridLayout()
         TaskNameLabel = QLabel(f"任务: {self.__task_data.get('name', '未命名')}")
@@ -53,7 +50,6 @@ class ALTimerTaskHistoryDialog(QDialog):
         TaskUUIDLabel.setStyleSheet("color: #969696; font-size: 11px;")
         InfoLayout.addWidget(TaskUUIDLabel, 1, 0)
         InfoLayout.setColumnStretch(0, 1)
-
         if self.__task_data.get("repeat", False):
             RepeatLabel = QLabel("可重复性任务")
             RepeatLabel.setStyleSheet("color: #2294FF; font-size: 12px;")
@@ -70,7 +66,6 @@ class ALTimerTaskHistoryDialog(QDialog):
         self.HistoryTableWidget.setSelectionBehavior(QTableWidget.SelectionBehavior.SelectRows)
         self.loadHistory()
         MainLayout.addWidget(self.HistoryTableWidget)
-
         ButtonLayout = QHBoxLayout()
         ButtonLayout.addStretch()
         self.CloseButton = QPushButton("关闭")
@@ -83,7 +78,6 @@ class ALTimerTaskHistoryDialog(QDialog):
         ButtonLayout.addWidget(self.CloseButton)
         MainLayout.addLayout(ButtonLayout)
 
-
     def connectSignals(
         self
     ):
@@ -91,7 +85,6 @@ class ALTimerTaskHistoryDialog(QDialog):
         self.CloseButton.clicked.connect(self.accept)
         self.ClearHistoryButton.clicked.connect(self.onClearHistoryButtonClicked)
 
-
     def loadHistory(
         self
     ):
@@ -100,6 +93,11 @@ class ALTimerTaskHistoryDialog(QDialog):
         for row, record in enumerate(self.__history):
             self.addHistoryRow(row, record)
 
+    def getHistory(
+        self
+    ) -> list:
+
+        return self.__history
 
     def addHistoryRow(
         self,
@@ -137,11 +135,4 @@ class ALTimerTaskHistoryDialog(QDialog):
 
         self.__history.clear()
         self.HistoryTableWidget.setRowCount(0)
-        self.__task_data["history"] = self.__history
-
-
-    def getHistory(
-        self
-    ) -> list:
-
-        return self.__history
+        self.__task_data["repeat_history"] = self.__history

src/gui/ALTimerTaskManageWidget.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2025 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -15,26 +15,46 @@ from enum import Enum
 from datetime import datetime, timedelta
 
 from PySide6.QtCore import (
-    Qt, Signal, Slot, QTimer
-)
-from PySide6.QtWidgets import (
-    QDialog, QWidget, QListWidgetItem, QMessageBox,
-    QHBoxLayout, QVBoxLayout, QLabel, QPushButton
+    QTimer,
+    Qt,
+    Signal,
+    Slot
 )
 from PySide6.QtGui import (
+    QAction,
     QCloseEvent
 )
+from PySide6.QtWidgets import (
+    QDialog,
+    QHBoxLayout,
+    QLabel,
+    QListWidgetItem,
+    QMenu,
+    QMessageBox,
+    QPushButton,
+    QVBoxLayout,
+    QWidget
+)
 
 import managers.config.ConfigManager as ConfigManager
-import utils.TimerUtils as TimerUtils
 
-from gui.resources.ui.Ui_ALTimerTaskManageWidget import Ui_ALTimerTaskManageWidget
-from gui.ALTimerTaskAddDialog import ALTimerTaskAddDialog, ALTimerTaskStatus
+from gui.ALTimerTaskAddDialog import (
+    ALTimerTaskAddDialog,
+    ALTimerTaskStatus
+)
 from gui.ALTimerTaskHistoryDialog import ALTimerTaskHistoryDialog
+from gui.resources.ui.Ui_ALTimerTaskManageWidget import Ui_ALTimerTaskManageWidget
+from interfaces.ConfigProvider import (
+    CfgKey,
+    ConfigProvider
+)
+from utils.TimerUtils import TimerUtils
 
 
 class ALTimerTaskItemWidget(QWidget):
 
+    editRequested = Signal(dict)
+
     def __init__(
         self,
         parent = None,
@@ -43,9 +63,11 @@ class ALTimerTaskItemWidget(QWidget):
 
         super().__init__(parent)
         self.__timer_task = timer_task
+        self.__manage_widget = parent
 
         self.modifyUi()
-
+        self.setContextMenuPolicy(Qt.ContextMenuPolicy.CustomContextMenu)
+        self.customContextMenuRequested.connect(self.showContextMenu)
 
     def modifyUi(
         self
@@ -145,6 +167,27 @@ class ALTimerTaskItemWidget(QWidget):
             self.DeleteButton.setEnabled(False)
         self.setFixedHeight(55)
 
+    @Slot(object)
+    def showContextMenu(
+        self,
+        pos
+    ):
+
+        Menu = QMenu(self)
+        EditAction = QAction("编辑", self)
+        EditAction.triggered.connect(
+            lambda: self.editRequested.emit(self.__timer_task)
+        )
+        Menu.addAction(EditAction)
+        if self.__timer_task["status"] != ALTimerTaskStatus.RUNNING\
+        and self.__timer_task["status"] != ALTimerTaskStatus.READY:
+            DeleteAction = QAction("删除", self)
+            DeleteAction.triggered.connect(
+                lambda: self.__manage_widget.deleteTask(self.__timer_task)
+            )
+            Menu.addAction(DeleteAction)
+        Menu.exec(self.mapToGlobal(pos))
+
 
 class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
 
@@ -164,9 +207,9 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
     ):
 
         super().__init__(parent)
-        self.__cfg_mgr = ConfigManager.instance()
+        self.__cfg_mgr: ConfigProvider = ConfigManager.instance()
         self.__timer_tasks = []
-        self.__check_timer = None
+        self.__CheckTimer = None
         self.__sort_policy = self.SortPolicy.BY_EXECUTE_TIME
         self.__sort_order = Qt.SortOrder.AscendingOrder
 
@@ -176,7 +219,6 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
         if not self.initializeTimerTasks():
             raise Exception("定时任务配置文件初始化失败 !")
 
-
     def connectSignals(
         self
     ):
@@ -187,15 +229,13 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
         self.TimerTaskSortOrderToggleButton.clicked.connect(self.onSortOrderToggleButtonClicked)
         self.timerTasksChanged.connect(self.onTimerTasksChanged)
 
-
     def setupTimer(
         self
     ):
 
-        self.__check_timer = QTimer(self)
-        self.__check_timer.timeout.connect(self.checkTasks)
-        self.__check_timer.start(500)
-
+        self.__CheckTimer = QTimer(self)
+        self.__CheckTimer.timeout.connect(self.checkTasks)
+        self.__CheckTimer.start(500)
 
     def initializeTimerTasks(
         self
@@ -212,20 +252,19 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
             return True
         return False
 
-
     def getTimerTasks(
         self
     ) -> list:
 
         try:
-            timer_tasks = self.__cfg_mgr.get(ConfigManager.ConfigType.TIMERTASK)
+            timer_tasks = self.__cfg_mgr.get(CfgKey.TIMERTASK.ROOT)
             if timer_tasks and "timer_tasks" in timer_tasks:
                 for task in timer_tasks["timer_tasks"]:
                     task["added_time"] = datetime.strptime(task["added_time"], "%Y-%m-%d %H:%M:%S")
                     task["execute_time"] = datetime.strptime(task["execute_time"], "%Y-%m-%d %H:%M:%S")
                     task["status"] = ALTimerTaskStatus(task["status"])
-                    if "history" in task:
-                        for item in task["history"]:
+                    if "repeat_history" in task:
+                        for item in task["repeat_history"]:
                             item["result"] = ALTimerTaskStatus(item["result"])
                 return timer_tasks["timer_tasks"]
             raise Exception("定时任务配置文件格式错误")
@@ -237,7 +276,6 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
             )
             return None
 
-
     def setTimerTasks(
         self,
         timer_tasks: list
@@ -248,10 +286,10 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
                 task["added_time"] = task["added_time"].strftime("%Y-%m-%d %H:%M:%S")
                 task["execute_time"] = task["execute_time"].strftime("%Y-%m-%d %H:%M:%S")
                 task["status"] = task["status"].value
-                if "history" in task:
-                    for item in task["history"]:
+                if "repeat_history" in task:
+                    for item in task["repeat_history"]:
                         item["result"] = item["result"].value
-            self.__cfg_mgr.set(ConfigManager.ConfigType.TIMERTASK, "", { "timer_tasks": timer_tasks })
+            self.__cfg_mgr.set(CfgKey.TIMERTASK.ROOT, { "timer_tasks": timer_tasks })
             return True
         except Exception as e:
             QMessageBox.warning(
@@ -261,7 +299,6 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
             )
             return False
 
-
     def showEvent(
         self,
         event
@@ -285,7 +322,6 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
 
         return result
 
-
     def closeEvent(
         self,
         event: QCloseEvent
@@ -295,7 +331,6 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
         self.timerTaskManageWidgetIsClosed.emit()
         event.ignore()
 
-
     def sortTimerTasks(
         self,
         policy: SortPolicy = SortPolicy.BY_EXECUTE_TIME,
@@ -318,7 +353,6 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
                 reverse = order is Qt.SortOrder.DescendingOrder
             )
 
-
     def updateStat(
         self
     ):
@@ -345,7 +379,6 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
         self.ExecutedTaskLabel.setText(f"已执行：{executed}")
         self.InvalidTaskLabel.setText(f"无效的：{invalid}")
 
-
     def updateTimerTaskList(
         self
     ):
@@ -353,64 +386,82 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
         self.TimerTasksListWidget.clear()
         self.sortTimerTasks(self.__sort_policy, self.__sort_order)
         for timer_task in self.__timer_tasks:
-            item = QListWidgetItem()
-            item.setData(Qt.UserRole, timer_task)
-            widget = ALTimerTaskItemWidget(self, timer_task)
-            widget.DeleteButton.clicked.connect(
+            Item = QListWidgetItem()
+            Item.setData(Qt.UserRole, timer_task)
+            Widget = ALTimerTaskItemWidget(self, timer_task)
+            Widget.DeleteButton.clicked.connect(
                 lambda _, task = timer_task: self.deleteTask(task)
             )
-            if timer_task.get("repeat", False) and hasattr(widget, "HistoryButton"):
-                widget.HistoryButton.clicked.connect(
+            if timer_task.get("repeat", False) and hasattr(Widget, "HistoryButton"):
+                Widget.HistoryButton.clicked.connect(
                     lambda _, task = timer_task: self.showTaskHistory(task)
                 )
-            item.setSizeHint(widget.size())
-            self.TimerTasksListWidget.addItem(item)
-            self.TimerTasksListWidget.setItemWidget(item, widget)
-
+            Widget.editRequested.connect(self.editTask)
+            Item.setSizeHint(Widget.size())
+            self.TimerTasksListWidget.addItem(Item)
+            self.TimerTasksListWidget.setItemWidget(Item, Widget)
 
     def addTask(
         self
     ):
 
-        dialog = ALTimerTaskAddDialog(self)
-        if dialog.exec() == QDialog.DialogCode.Accepted:
-            timer_task = dialog.getTimerTask()
+        Dialog = ALTimerTaskAddDialog(self)
+        if Dialog.exec() == QDialog.DialogCode.Accepted:
+            timer_task = Dialog.getTimerTask()
             self.__timer_tasks.append(timer_task)
             self.timerTasksChanged.emit()
 
+    def editTask(
+        self,
+        timer_task: dict
+    ):
+
+        Dialog = ALTimerTaskAddDialog(self, timer_task)
+        if Dialog.exec() == QDialog.DialogCode.Accepted:
+            updated = Dialog.getTimerTask()
+            for i, task in enumerate(self.__timer_tasks):
+                if task["uuid"] == updated["uuid"]:
+                    self.__timer_tasks[i] = updated
+                    break
+            self.timerTasksChanged.emit()
+
     @staticmethod
     def getTimerTaskDetailMessage(
         timer_task: dict
     ):
 
+        if "repeat_history" not in timer_task:
+            history = []
+        else:
+            history = timer_task["repeat_history"]
+        history_count = len(history)
         return (
             f"任务名称：{timer_task["name"]}\n"
             f"添加时间：{timer_task["added_time"]}\n"
             f"当前状态：{timer_task["status"].value}\n"
             f"下次执行时间：{datetime.strftime(timer_task["execute_time"], "%Y-%m-%d %H:%M:%S")}\n"
-            f"已记录次数：{len(timer_task['history'] if 'history' in timer_task else 0)}"
+            f"已记录次数：{history_count}"
         )
 
-
     def deleteTask(
         self,
         timer_task: dict
     ):
 
         if timer_task["repeat"]: # when delete a repeat task
-            msgbox = QMessageBox(self)
-            msgbox.setIcon(QMessageBox.Icon.Question)
-            msgbox.setWindowTitle("警告 - AutoLibrary")
-            msgbox.setStandardButtons(
+            MsgBox = QMessageBox(self)
+            MsgBox.setIcon(QMessageBox.Icon.Question)
+            MsgBox.setWindowTitle("警告 - AutoLibrary")
+            MsgBox.setStandardButtons(
                 QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No
             )
-            msgbox.setText("删除可重复性任务将同时删除所有已执行的记录 !\n是否继续 ?")
-            msgbox.setDetailedText(
+            MsgBox.setText("删除可重复性任务将同时删除所有已执行的记录 !\n是否继续 ?")
+            MsgBox.setDetailedText(
                 "以下可重复性任务将被删除：\n"\
                 "\n"
                 f"{self.getTimerTaskDetailMessage(timer_task)}"
             )
-            result = msgbox.exec()
+            result = MsgBox.exec()
             if result != QMessageBox.StandardButton.Yes:
                 return
         task_uuid = timer_task["uuid"]
@@ -420,7 +471,6 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
         ]
         self.timerTasksChanged.emit()
 
-
     def clearAllTasks(
         self
     ):
@@ -456,13 +506,13 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
         ]
         repeat_tasks_count = len(repeat_tasks)
         if repeat_tasks_count > 0:
-            msgbox = QMessageBox(self)
-            msgbox.setIcon(QMessageBox.Icon.Question)
-            msgbox.setWindowTitle("警告 - AutoLibrary")
-            msgbox.setStandardButtons(
+            MsgBox = QMessageBox(self)
+            MsgBox.setIcon(QMessageBox.Icon.Question)
+            MsgBox.setWindowTitle("警告 - AutoLibrary")
+            MsgBox.setStandardButtons(
                 QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No
             )
-            msgbox.setText(
+            MsgBox.setText(
                 f"存在 {repeat_tasks_count} 个可重复性任务,\n"
                 "删除可重复性任务将同时删除所有已执行的记录 !\n"
                 "是否继续 ?"
@@ -470,29 +520,27 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
             delete_msgs = [
                 self.getTimerTaskDetailMessage(x) for x in repeat_tasks
             ]
-            msgbox.setDetailedText(
+            MsgBox.setDetailedText(
                 "以下可重复性任务将被删除：\n"\
                 "\n"
                 f"{"\n\n".join(delete_msgs)}"
             )
-            result = msgbox.exec()
+            result = MsgBox.exec()
             if result != QMessageBox.StandardButton.Yes:
                 return
         # clear all tasks
         self.__timer_tasks.clear()
         self.timerTasksChanged.emit()
 
-
     def showTaskHistory(
         self,
         task: dict
     ):
 
-        dialog = ALTimerTaskHistoryDialog(self, task)
-        if dialog.exec() == QDialog.DialogCode.Accepted:
+        Dialog = ALTimerTaskHistoryDialog(self, task)
+        if Dialog.exec() == QDialog.DialogCode.Accepted:
             self.timerTasksChanged.emit()
 
-
     def checkTasks(
         self
     ):
@@ -554,7 +602,6 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
         self.updateTimerTaskList()
         self.updateStat()
 
-
     @Slot(dict)
     def onTimerTaskIsRunning(
         self,
@@ -567,7 +614,6 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
                 break
         self.timerTasksChanged.emit()
 
-
     def onRepeatTimerTaskIs(
         self,
         status: ALTimerTaskStatus,
@@ -579,12 +625,12 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
                          ALTimerTaskStatus.OUTDATED}
         if status not in valid_statuses:
             return timer_task
-        if "history" not in timer_task:
-            timer_task["history"] = []
+        if "repeat_history" not in timer_task:
+            timer_task["repeat_history"] = []
         if status != ALTimerTaskStatus.OUTDATED:
             executed_time = datetime.now()
             duration = (executed_time - timer_task["execute_time"]).total_seconds()
-            timer_task["history"].append({
+            timer_task["repeat_history"].append({
                 "execute_time": timer_task["execute_time"].strftime("%Y-%m-%d %H:%M:%S"),
                 "executed_time": executed_time.strftime("%Y-%m-%d %H:%M:%S"),
                 "result": status,
@@ -598,14 +644,14 @@ class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
             delta_days = (current_time - execute_time).days
             for i in range(delta_days + 1):
                 if (execute_weekday + i)%7 in timer_task["repeat_days"]:
-                    timer_task["history"].append({
+                    timer_task["repeat_history"].append({
                         "execute_time": (execute_time + timedelta(days=i)).strftime("%Y-%m-%d %H:%M:%S"),
                         "executed_time": (execute_time + timedelta(days=i)).strftime("%Y-%m-%d %H:%M:%S"),
                         "result": status,
                         "duration": 0,
                         "uuid": timer_task["uuid"]
                     })
-        next_time = TimerUtils.calculateNextRepeatTime(
+        next_time = TimerUtils.getNextTimerRepeatTime(
             timer_task["repeat_days"],
             timer_task["repeat_hour"],
             timer_task["repeat_minute"],

src/gui/ALUserTreeWidget.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 - 2026 KenanZhu.
+Copyright (c) 2025 KenanZhu.
 All rights reserved.
 
 This software is provided "as is", without any warranty of any kind.
@@ -10,14 +10,22 @@ See the LICENSE file for details.
 from enum import Enum
 
 from PySide6.QtCore import (
-    Qt, QSize, QCoreApplication, QRect, QPoint
+    Qt,
+    QSize,
+    QCoreApplication,
+    QRect,
+    QPoint
 )
 from PySide6.QtWidgets import (
-    QAbstractScrollArea, QAbstractItemView,
-    QTreeWidget, QTreeWidgetItem
+    QAbstractScrollArea,
+    QAbstractItemView,
+    QTreeWidget,
+    QTreeWidgetItem
 )
 from PySide6.QtGui import (
-     QDragEnterEvent, QDragMoveEvent, QDropEvent
+     QDragEnterEvent,
+     QDragMoveEvent,
+     QDropEvent
 )
 
 
@@ -39,14 +47,13 @@ class ALUserTreeWidget(QTreeWidget):
         self.setupUi()
         self.translateUi()
 
-
     def setupUi(
         self
     ):
 
-        __qtreewidgetitem = QTreeWidgetItem()
-        __qtreewidgetitem.setText(0, u"\u5206\u7ec4/\u7528\u6237");
-        self.setHeaderItem(__qtreewidgetitem)
+        __QTreeWidgetItem = QTreeWidgetItem()
+        __QTreeWidgetItem.setText(0, u"\u5206\u7ec4/\u7528\u6237");
+        self.setHeaderItem(__QTreeWidgetItem)
         self.setObjectName(u"UserTreeWidget")
         self.setMinimumSize(QSize(230, 0))
         self.setMaximumSize(QSize(250, 16777215))
@@ -70,14 +77,12 @@ class ALUserTreeWidget(QTreeWidget):
         self.header().setHighlightSections(False)
         self.header().setProperty(u"showSortIndicator", True)
 
-
     def translateUi(
         self
     ):
 
-        ___qtreewidgetitem = self.headerItem()
-        ___qtreewidgetitem.setText(1, QCoreApplication.translate("ALConfigWidget", u"\u72b6\u6001", None));
-
+        ___QTreeWidgetItem = self.headerItem()
+        ___QTreeWidgetItem.setText(1, QCoreApplication.translate("ALConfigWidget", u"\u72b6\u6001", None));
 
     @staticmethod
     def isDragPositionValid(
@@ -90,7 +95,6 @@ class ALUserTreeWidget(QTreeWidget):
             y_offset < target_rect.height()*0.8)
         return valid
 
-
     def dragEnterEvent(
         self,
         event: QDragEnterEvent
@@ -98,7 +102,6 @@ class ALUserTreeWidget(QTreeWidget):
 
         super().dragEnterEvent(event)
 
-
     def dragMoveEvent(
         self,
         event: QDragMoveEvent
@@ -106,27 +109,27 @@ class ALUserTreeWidget(QTreeWidget):
 
         super().dragMoveEvent(event)
 
-        source_item = self.currentItem()
-        target_item = self.itemAt(event.position().toPoint())
-        if source_item is None:
+        SourceItem = self.currentItem()
+        TargetItem = self.itemAt(event.position().toPoint())
+        if SourceItem is None:
             event.ignore()
             return
-        if source_item.type() == ALUserTreeItemType.GROUP.value:
-            if target_item is not None:
+        if SourceItem.type() == ALUserTreeItemType.GROUP.value:
+            if TargetItem is not None:
                 event.ignore()
                 return
-        elif source_item.type() == ALUserTreeItemType.USER.value:
-            if target_item is None:
+        elif SourceItem.type() == ALUserTreeItemType.USER.value:
+            if TargetItem is None:
                 event.ignore()
                 return
-            if target_item.type() != ALUserTreeItemType.GROUP.value:
+            if TargetItem.type() != ALUserTreeItemType.GROUP.value:
                 event.ignore()
                 return
-            if target_item.checkState(1) == Qt.CheckState.Unchecked:
+            if TargetItem.checkState(1) == Qt.CheckState.Unchecked:
                 event.ignore()
                 return
             if not self.isDragPositionValid(
-                self.visualItemRect(target_item),
+                self.visualItemRect(TargetItem),
                 event.position().toPoint()
             ):
                 event.ignore()
@@ -136,7 +139,6 @@ class ALUserTreeWidget(QTreeWidget):
             return
         event.acceptProposedAction()
 
-
     def dropEvent(
         self,
         event: QDropEvent

src/gui/ALVersionInfo.py

@@ -5,11 +5,11 @@
     workflow process. Do not edit manually.
 
     This file is auto-generated during the workflow process.
-    Last updated: 2026-03-21 10:54:51 UTC
+    Last updated: 2026-05-09 06:05:13 UTC
 """
 
-AL_VERSION = "1.2.0"
-AL_TAG = "v1.2.0"
+AL_VERSION = "1.3.0"
+AL_TAG = "v1.3.0"
 AL_COMMIT_SHA = "local"
 AL_COMMIT_DATE = "null"  # time zone : UTC
 AL_BUILD_DATE = "null"  # time zone : UTC

src/gui/ALWebDriverDownloadDialog.py

@@ -11,20 +11,30 @@ import threading
 from typing import Optional
 
 from PySide6.QtCore import (
-    Qt, Slot, QThread, Signal
+    Qt,
+    Slot,
+    QThread,
+    Signal
 )
 from PySide6.QtWidgets import (
-    QDialog, QLabel, QComboBox, QProgressBar,
-    QPushButton, QVBoxLayout, QHBoxLayout,
-    QMessageBox, QFrame, QLineEdit
-)
-from PySide6.QtGui import (
-    QCloseEvent
+    QDialog,
+    QLabel,
+    QComboBox,
+    QProgressBar,
+    QPushButton,
+    QVBoxLayout,
+    QHBoxLayout,
+    QMessageBox,
+    QFrame,
+    QLineEdit
 )
+from PySide6.QtGui import QCloseEvent
 
 from managers.driver.WebDriverManager import (
-    instance as webdriver_manager_instance,
-    WebDriverManager, WebDriverInfo, WebDriverType,
+    instance as webdriverInstance,
+    WebDriverManager,
+    WebDriverInfo,
+    WebDriverType,
     WebDriverStatus
 )
 from gui.ALStatusLabel import ALStatusLabel
@@ -142,7 +152,6 @@ class ALWebDriverDownloadDialog(QDialog):
         self.initializeDriverManager()
         self.refreshDriverList()
 
-
     def showEvent(
         self,
         event
@@ -165,7 +174,6 @@ class ALWebDriverDownloadDialog(QDialog):
             self.move(target_pos)
         return result
 
-
     def setupUi(
         self
     ):
@@ -174,14 +182,11 @@ class ALWebDriverDownloadDialog(QDialog):
         self.setMaximumHeight(240)
         self.setMinimumHeight(240)
         self.setWindowTitle("浏览器驱动下载 - AutoLibrary")
-
         self.MainLayout = QVBoxLayout(self)
         self.MainLayout.setContentsMargins(5, 5, 5, 5)
         self.MainLayout.setSpacing(5)
-
         self.BrowserCountLabel = QLabel("检测到 0 个可用浏览器：")
         self.MainLayout.addWidget(self.BrowserCountLabel)
-
         self.DriverInfoLayout = QHBoxLayout()
         self.DriverInfoLayout.setSpacing(5)
         self.DriverComboBox = QComboBox()
@@ -190,7 +195,6 @@ class ALWebDriverDownloadDialog(QDialog):
         self.StatusLabel.setFixedSize(32, 32)
         self.DriverInfoLayout.addWidget(self.StatusLabel)
         self.MainLayout.addLayout(self.DriverInfoLayout)
-
         self.DetailLayout = QVBoxLayout()
         self.DetailLayout.setSpacing(5)
         self.DetailLayout.setContentsMargins(5, 5, 5, 5)
@@ -203,7 +207,6 @@ class ALWebDriverDownloadDialog(QDialog):
         self.PathLabel.setText("路径：未安装")
         self.DetailLayout.addWidget(self.PathLabel)
         self.MainLayout.addLayout(self.DetailLayout)
-
         self.Line = QFrame()
         self.Line.setFrameShape(QFrame.Shape.HLine)
         self.Line.setFrameShadow(QFrame.Shadow.Sunken)
@@ -229,7 +232,6 @@ class ALWebDriverDownloadDialog(QDialog):
         self.ConfirmButton = QPushButton("确认")
         self.ConfirmButton.setFixedSize(80, 25)
         self.ConfirmButton.setEnabled(False)
-
         self.ControlLayout.addWidget(self.RefreshButton)
         self.ControlLayout.addWidget(self.DownloadButton)
         self.ControlLayout.addWidget(self.DeleteButton)
@@ -237,7 +239,6 @@ class ALWebDriverDownloadDialog(QDialog):
         self.ControlLayout.addWidget(self.ConfirmButton)
         self.MainLayout.addLayout(self.ControlLayout)
 
-
     def connectSignals(
         self
     ):
@@ -249,18 +250,16 @@ class ALWebDriverDownloadDialog(QDialog):
         self.ConfirmButton.clicked.connect(self.onConfirmButtonClicked)
         self.DriverComboBox.currentIndexChanged.connect(self.onDriverComboBoxChanged)
 
-
     def initializeDriverManager(
         self
     ):
 
         try:
-            self.__driver_manager = webdriver_manager_instance(self.__driver_dir)
+            self.__driver_manager = webdriverInstance(self.__driver_dir)
         except ValueError as e:
             QMessageBox.warning(self, "初始化失败", f"WebDriverManager 初始化失败:\n{str(e)}")
             self.reject()
 
-
     def refreshDriverList(
         self
     ):
@@ -270,18 +269,20 @@ class ALWebDriverDownloadDialog(QDialog):
         self.__driver_manager.refresh()
         self.__driver_infos = self.__driver_manager.getDriverInfos()
         self.DriverComboBox.clear()
+        installed = 0
         installed_idx = 0
         for i, driver_info in enumerate(self.__driver_infos):
-            if driver_info.driver_status == WebDriverStatus.INSTALLED:
-                installed_idx = i # get the installed driver index
             display_text = f"{driver_info.driver_type.value} - {driver_info.browser_version}"
+            if driver_info.driver_status == WebDriverStatus.INSTALLED:
+                installed += 1
+                installed_idx = i # get the installed driver index
+                display_text += " : 已安装"
             self.DriverComboBox.addItem(display_text)
         count = len(self.__driver_infos)
-        self.BrowserCountLabel.setText(f"检测到 {count} 个可用浏览器：")
+        self.BrowserCountLabel.setText(f"检测到 {count} 个可用浏览器，{installed} 个已安装驱动：")
         if self.__driver_infos:
             self.DriverComboBox.setCurrentIndex(installed_idx)
 
-
     def onDriverComboBoxChanged(
         self,
         index: int
@@ -294,6 +295,116 @@ class ALWebDriverDownloadDialog(QDialog):
         self.updateProgressBarStates(driver_info)
         self.updateButtonStates(driver_info)
 
+    def closeEvent(
+        self,
+        event: QCloseEvent
+    ):
+
+        if self.__download_thread and self.__download_thread.isRunning():
+            reply = QMessageBox.question(
+                self,
+                "确认关闭 - AutoLibrary",
+                "驱动正在下载中, 确定要取消并关闭对话框吗 ?",
+                QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No
+            )
+            if reply == QMessageBox.StandardButton.No:
+                event.ignore()
+                return
+            self.__download_thread.stop()
+        if not self.__confirmed:
+            self.__selected_driver_info = None
+        event.accept()
+        super().closeEvent(event)
+
+    def onThreadFinished(
+        self
+    ):
+
+        if self.__download_thread:
+            self.__download_thread.deleteLater()
+            self.__download_thread = None
+
+    def getSelectedDriverInfo(
+        self
+    ) -> Optional[WebDriverInfo]:
+
+        return self.__selected_driver_info
+
+    def updateDriverInfoDisplay(
+        self,
+        driver_info: WebDriverInfo
+    ):
+
+        if driver_info.driver_type == WebDriverType.CHROME:
+            driver_type = "Google Chrome"
+        elif driver_info.driver_type == WebDriverType.FIREFOX:
+            driver_type = "Mozilla Firefox"
+        elif driver_info.driver_type == WebDriverType.EDGE:
+            driver_type = "Microsoft Edge"
+        else:
+            driver_type = "未知"
+        self.BrowserTypeLabel.setText(f"类型：{driver_type}")
+        self.VersionLabel.setText(f"版本：{driver_info.driver_version}")
+        if driver_info.driver_path:
+            self.PathLabel.setText(str(driver_info.driver_path))
+        else:
+            self.PathLabel.setText("未安装")
+        match driver_info.driver_status:
+            case WebDriverStatus.NOT_INSTALLED:
+                self.StatusLabel.status = ALStatusLabel.Status.WAITING
+            case WebDriverStatus.INSTALLED:
+                self.StatusLabel.status = ALStatusLabel.Status.SUCCESS
+            case WebDriverStatus.DOWNLOADING:
+                self.StatusLabel.status = ALStatusLabel.Status.RUNNING
+            case WebDriverStatus.ERROR:
+                self.StatusLabel.status = ALStatusLabel.Status.FAILURE
+
+    def updateProgressBarStates(
+        self,
+        driver_info: WebDriverInfo
+    ):
+
+        if driver_info.driver_status == WebDriverStatus.NOT_INSTALLED:
+            self.ProgressBar.setValue(0)
+            self.ProgressText.setText("未安装")
+        elif driver_info.driver_status == WebDriverStatus.INSTALLED:
+            self.ProgressBar.setValue(100)
+            self.ProgressText.setText("已安装")
+        elif driver_info.driver_status == WebDriverStatus.DOWNLOADING:
+            pass # update  by worker thread
+        elif driver_info.driver_status == WebDriverStatus.ERROR:
+            self.ProgressBar.setValue(0)
+            self.ProgressText.setText("下载失败")
+
+    def updateButtonStates(
+        self,
+        driver_info: WebDriverInfo
+    ):
+
+        if driver_info.driver_status == WebDriverStatus.NOT_INSTALLED:
+            self.RefreshButton.setEnabled(True)
+            self.DeleteButton.setEnabled(False)
+            self.DownloadButton.setEnabled(True)
+            self.CancelButton.setEnabled(True)
+            self.ConfirmButton.setEnabled(False)
+        elif driver_info.driver_status == WebDriverStatus.INSTALLED:
+            self.RefreshButton.setEnabled(True)
+            self.DownloadButton.setEnabled(False)
+            self.DeleteButton.setEnabled(True)
+            self.CancelButton.setEnabled(True)
+            self.ConfirmButton.setEnabled(True)
+        elif driver_info.driver_status == WebDriverStatus.DOWNLOADING:
+            self.RefreshButton.setEnabled(False)
+            self.DownloadButton.setEnabled(False)
+            self.DeleteButton.setEnabled(False)
+            self.CancelButton.setEnabled(True)
+            self.ConfirmButton.setEnabled(False)
+        elif driver_info.driver_status == WebDriverStatus.ERROR:
+            self.RefreshButton.setEnabled(True)
+            self.DownloadButton.setEnabled(True)
+            self.DeleteButton.setEnabled(False)
+            self.CancelButton.setEnabled(True)
+            self.ConfirmButton.setEnabled(False)
 
     @Slot()
     def onRefreshButtonClicked(
@@ -302,7 +413,6 @@ class ALWebDriverDownloadDialog(QDialog):
 
         self.refreshDriverList()
 
-
     @Slot()
     def onDeleteButtonClicked(
         self
@@ -355,7 +465,7 @@ class ALWebDriverDownloadDialog(QDialog):
         self.__download_thread.downloadFinished.connect(self.onDownloadFinished)
         self.__download_thread.downloadError.connect(self.onDownloadError)
         self.__download_thread.downloadCancelled.connect(self.onDownloadCancelled)
-        self.__download_thread.finished.connect(self.__onThreadFinished)
+        self.__download_thread.finished.connect(self.onThreadFinished)
         self.__download_thread.start()
 
     @Slot()
@@ -406,7 +516,6 @@ class ALWebDriverDownloadDialog(QDialog):
             self.updateButtonStates(driver_info)
         QMessageBox.critical(self, "下载失败 - AutoLibrary", error_message)
 
-
     @Slot()
     def onDownloadCancelled(
         self
@@ -423,7 +532,6 @@ class ALWebDriverDownloadDialog(QDialog):
             self.updateButtonStates(driver_info)
             self.ProgressText.setText("下载已取消")
 
-
     @Slot()
     def onConfirmButtonClicked(
         self
@@ -439,7 +547,6 @@ class ALWebDriverDownloadDialog(QDialog):
         self.__confirmed = True
         self.accept()
 
-
     @Slot()
     def onCancelButtonClicked(
         self
@@ -458,119 +565,3 @@ class ALWebDriverDownloadDialog(QDialog):
             self.__confirmed = False
             self.__selected_driver_info = None
             self.reject()
-
-
-    def closeEvent(
-        self,
-        event: QCloseEvent
-    ):
-
-        if self.__download_thread and self.__download_thread.isRunning():
-            reply = QMessageBox.question(
-                self,
-                "确认关闭 - AutoLibrary",
-                "驱动正在下载中, 确定要取消并关闭对话框吗 ?",
-                QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No
-            )
-            if reply == QMessageBox.StandardButton.No:
-                event.ignore()
-                return
-            self.__download_thread.stop()
-        if not self.__confirmed:
-            self.__selected_driver_info = None
-        event.accept()
-        super().closeEvent(event)
-
-    def __onThreadFinished(
-        self
-    ):
-
-        if self.__download_thread:
-            self.__download_thread.deleteLater()
-            self.__download_thread = None
-
-
-    def getSelectedDriverInfo(
-        self
-    ) -> Optional[WebDriverInfo]:
-
-        return self.__selected_driver_info
-
-
-    def updateDriverInfoDisplay(
-        self,
-        driver_info: WebDriverInfo
-    ):
-
-        if driver_info.driver_type == WebDriverType.CHROME:
-            driver_type = "Google Chrome"
-        elif driver_info.driver_type == WebDriverType.FIREFOX:
-            driver_type = "Mozilla Firefox"
-        elif driver_info.driver_type == WebDriverType.EDGE:
-            driver_type = "Microsoft Edge"
-        else:
-            driver_type = "未知"
-        self.BrowserTypeLabel.setText(f"类型：{driver_type}")
-        self.VersionLabel.setText(f"版本：{driver_info.driver_version}")
-        if driver_info.driver_path:
-            self.PathLabel.setText(str(driver_info.driver_path))
-        else:
-            self.PathLabel.setText("未安装")
-        match driver_info.driver_status:
-            case WebDriverStatus.NOT_INSTALLED:
-                self.StatusLabel.status = ALStatusLabel.Status.WAITING
-            case WebDriverStatus.INSTALLED:
-                self.StatusLabel.status = ALStatusLabel.Status.SUCCESS
-            case WebDriverStatus.DOWNLOADING:
-                self.StatusLabel.status = ALStatusLabel.Status.RUNNING
-            case WebDriverStatus.ERROR:
-                self.StatusLabel.status = ALStatusLabel.Status.FAILURE
-
-
-    def updateProgressBarStates(
-        self,
-        driver_info: WebDriverInfo
-    ):
-
-        if driver_info.driver_status == WebDriverStatus.NOT_INSTALLED:
-            self.ProgressBar.setValue(0)
-            self.ProgressText.setText("未安装")
-        elif driver_info.driver_status == WebDriverStatus.INSTALLED:
-            self.ProgressBar.setValue(100)
-            self.ProgressText.setText("已安装")
-        elif driver_info.driver_status == WebDriverStatus.DOWNLOADING:
-            pass # update  by worker thread
-        elif driver_info.driver_status == WebDriverStatus.ERROR:
-            self.ProgressBar.setValue(0)
-            self.ProgressText.setText("下载失败")
-
-
-    def updateButtonStates(
-        self,
-        driver_info: WebDriverInfo
-    ):
-
-        if driver_info.driver_status == WebDriverStatus.NOT_INSTALLED:
-            self.RefreshButton.setEnabled(True)
-            self.DeleteButton.setEnabled(False)
-            self.DownloadButton.setEnabled(True)
-            self.CancelButton.setEnabled(True)
-            self.ConfirmButton.setEnabled(False)
-        elif driver_info.driver_status == WebDriverStatus.INSTALLED:
-            self.RefreshButton.setEnabled(True)
-            self.DownloadButton.setEnabled(False)
-            self.DeleteButton.setEnabled(True)
-            self.CancelButton.setEnabled(True)
-            self.ConfirmButton.setEnabled(True)
-        elif driver_info.driver_status == WebDriverStatus.DOWNLOADING:
-            self.RefreshButton.setEnabled(False)
-            self.DownloadButton.setEnabled(False)
-            self.DeleteButton.setEnabled(False)
-            self.CancelButton.setEnabled(True)
-            self.ConfirmButton.setEnabled(False)
-        elif driver_info.driver_status == WebDriverStatus.ERROR:
-            self.RefreshButton.setEnabled(True)
-            self.DownloadButton.setEnabled(True)
-            self.DeleteButton.setEnabled(False)
-            self.CancelButton.setEnabled(True)
-            self.ConfirmButton.setEnabled(False)

src/gui/__init__.py

@@ -1,18 +1,9 @@
+# -*- coding: utf-8 -*-
 """
-    GUI module for the AutoLibrary project.
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
 
-    Here are the classes and modules in this package:
-    - ALMainWindow: Main window class.
-    - ALAboutDialog: About dialog class.
-    - ALConfigWidget: Configuration widget class.
-    - ALSeatFrame: Seat frame class.
-    - ALSeatMapView: Seat map view class.
-    - ALSeatMapTable: Seat map table class.
-    - ALSeatMapSelectDialog: Seat map select dialog class.
-    - ALTimerTaskAddDialog: Timer task add dialog class.
-    - ALTimerTaskHistoryDialog: Timer task history dialog class.
-    - ALTimerTaskManageWidget: Timer task manage widget class.
-    - ALUserTreeWidget: User tree widget class.
-    - ALMainWorkers: Main workers class.
-    - ALVersionInfo: Version info class.
-"""
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""

src/gui/resources/ALResource.qrc

@@ -1,8 +1,11 @@
 <RCC>
-    <qresource prefix="/res/icon">
-        <file>icons/AutoLibrary_32x32.ico</file>
-    </qresource>
-    <qresource prefix="/res/trans">
+    <qresource prefix="/res">
+        <file>icons/AutoLibrary_Logo_64.svg</file>
+        <file>icons/AutoLibrary_Logo_128.svg</file>
+
+        <file>icons/Copy.svg</file>
+        <file>icons/Reset.svg</file>
+
         <file>translators/qtbase_zh_CN.qm</file>
     </qresource>
 </RCC>

src/gui/resources/__init__.py

@@ -1,3 +1,9 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
 """
-    GUI resources module for the AutoLibrary project.
-"""

src/gui/resources/icons/Copy.svg

@@ -0,0 +1,6 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M13 7H7V5H13V7Z" fill="currentColor"/>
+  <path d="M13 11H7V9H13V11Z" fill="currentColor"/>
+  <path d="M7 15H13V13H7V15Z" fill="currentColor"/>
+  <path fill-rule="evenodd" clip-rule="evenodd" d="M3 19V1H17V5H21V23H7V19H3ZM15 17V3H5V17H15ZM17 7V19H9V21H19V7H17Z" fill="currentColor"/>
+</svg>

src/gui/resources/icons/Reset.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="currentColor">
+  <path d="M20.817 11.186a8.94 8.94 0 0 0-1.355-3.219 9.053 9.053 0 0 0-2.43-2.43 8.95 8.95 0 0 0-3.219-1.355 9.028 9.028 0 0 0-1.838-.18V2L8 5l3.975 3V6.002c.484-.002.968.044 1.435.14a6.961 6.961 0 0 1 2.502 1.053 7.005 7.005 0 0 1 1.892 1.892A6.967 6.967 0 0 1 19 13a7.032 7.032 0 0 1-.55 2.725 7.11 7.11 0 0 1-.644 1.188 7.2 7.2 0 0 1-.858 1.039 7.028 7.028 0 0 1-3.536 1.907 7.13 7.13 0 0 1-2.822 0 6.961 6.961 0 0 1-2.503-1.054 7.002 7.002 0 0 1-1.89-1.89A6.996 6.996 0 0 1 5 13H3a9.02 9.02 0 0 0 1.539 5.034 9.096 9.096 0 0 0 2.428 2.428A8.95 8.95 0 0 0 12 22a9.09 9.09 0 0 0 1.814-.183 9.014 9.014 0 0 0 3.218-1.355 8.886 8.886 0 0 0 1.331-1.099 9.228 9.228 0 0 0 1.1-1.332A8.952 8.952 0 0 0 21 13a9.09 9.09 0 0 0-.183-1.814z" fill="currentColor"/>
+</svg>

src/gui/resources/ui/ALAboutDialog.ui

@@ -19,7 +19,7 @@
   <property name="maximumSize">
    <size>
     <width>800</width>
-    <height>400</height>
+    <height>600</height>
    </size>
   </property>
   <property name="windowTitle">
@@ -103,53 +103,6 @@
      <property name="spacing">
       <number>0</number>
      </property>
-     <item>
-      <widget class="QFrame" name="AboutInfoSpaceFrame">
-       <property name="minimumSize">
-        <size>
-         <width>56</width>
-         <height>0</height>
-        </size>
-       </property>
-       <property name="maximumSize">
-        <size>
-         <width>56</width>
-         <height>16777215</height>
-        </size>
-       </property>
-       <property name="frameShape">
-        <enum>QFrame::Shape::NoFrame</enum>
-       </property>
-       <property name="frameShadow">
-        <enum>QFrame::Shadow::Plain</enum>
-       </property>
-       <property name="lineWidth">
-        <number>0</number>
-       </property>
-      </widget>
-     </item>
-     <item>
-      <widget class="QTextBrowser" name="AboutInfoBrowser">
-       <property name="frameShadow">
-        <enum>QFrame::Shadow::Plain</enum>
-       </property>
-       <property name="verticalScrollBarPolicy">
-        <enum>Qt::ScrollBarPolicy::ScrollBarAlwaysOff</enum>
-       </property>
-       <property name="horizontalScrollBarPolicy">
-        <enum>Qt::ScrollBarPolicy::ScrollBarAlwaysOff</enum>
-       </property>
-       <property name="lineWrapMode">
-        <enum>QTextEdit::LineWrapMode::NoWrap</enum>
-       </property>
-       <property name="openExternalLinks">
-        <bool>true</bool>
-       </property>
-       <property name="openLinks">
-        <bool>true</bool>
-       </property>
-      </widget>
-     </item>
     </layout>
    </item>
    <item>

src/gui/resources/ui/ALTimerTaskAddDialog.ui

@@ -13,7 +13,7 @@
   <property name="minimumSize">
    <size>
     <width>350</width>
-    <height>400</height>
+    <height>460</height>
    </size>
   </property>
   <property name="maximumSize">

src/interfaces/ConfigProvider.py

@@ -0,0 +1,119 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from dataclasses import dataclass
+from enum import Enum
+from typing import Any, Optional, Protocol
+
+
+class ConfigType(Enum):
+    """
+        Config type enum. Values represent the default filename.
+    """
+
+    GLOBAL = "autolibrary.json"
+    BULLETIN = "bulletin.json"
+    TIMERTASK = "timer_task.json"
+
+
+@dataclass(frozen=True)
+class ConfigPath:
+    """
+        A typed configuration path that carries both the config file
+        and the dot-separated key in a single object.
+
+        Consumers pass this directly to ConfigProvider.get/set,
+        eliminating the need to import ConfigType separately.
+    """
+
+    config_type: ConfigType
+    key: str = ""
+
+
+class CfgKey:
+    """
+        Type-safe hierarchical configuration key constants.
+
+        Each leaf is a ConfigPath that can be passed directly to
+        ``ConfigProvider.get()`` or ``ConfigProvider.set()``.
+
+        Usage::
+
+            CfgKey.GLOBAL.AUTOMATION.RUN_PATH.PATHS
+            # -> ConfigPath(ConfigType.GLOBAL, "automation.run_path.paths")
+
+            config.get(CfgKey.GLOBAL.AUTOMATION.RUN_PATH.PATHS, [])
+            config.set(CfgKey.GLOBAL.AUTOMATION.RUN_PATH.PATHS, value)
+    """
+
+    class GLOBAL:
+        class AUTOMATION:
+            ROOT = ConfigPath(ConfigType.GLOBAL, "automation")
+
+            class RUN_PATH:
+                ROOT = ConfigPath(ConfigType.GLOBAL, "automation.run_path")
+                CURRENT = ConfigPath(ConfigType.GLOBAL, "automation.run_path.current")
+                PATHS = ConfigPath(ConfigType.GLOBAL, "automation.run_path.paths")
+
+            class USER_PATH:
+                ROOT = ConfigPath(ConfigType.GLOBAL, "automation.user_path")
+                CURRENT = ConfigPath(ConfigType.GLOBAL, "automation.user_path.current")
+                PATHS = ConfigPath(ConfigType.GLOBAL, "automation.user_path.paths")
+
+    class TIMERTASK:
+        ROOT = ConfigPath(ConfigType.TIMERTASK, "")
+        TIMER_TASKS = ConfigPath(ConfigType.TIMERTASK, "timer_tasks")
+
+    class BULLETIN:
+        ROOT = ConfigPath(ConfigType.BULLETIN, "")
+        BULLETIN = ConfigPath(ConfigType.BULLETIN, "bulletin")
+        LAST_SYNC_TIME = ConfigPath(ConfigType.BULLETIN, "last_sync_time")
+
+
+class ConfigProvider(Protocol):
+    """
+        Abstract interface for configuration storage access.
+
+        Concrete implementations (e.g. ConfigManager) conform to
+        this protocol structurally rather than through explicit
+        inheritance.
+    """
+
+    def get(
+        self,
+        key: ConfigPath,
+        default: Optional[Any] = None
+    ) -> Any:
+        """
+            Retrieve a configuration value.
+
+            Args:
+                key: A ConfigPath object specifying which config file
+                     and key to read from.
+                default: Fallback value if the key is not found.
+
+            Returns:
+                The configuration value at the given key path.
+        """
+        ...
+
+    def set(
+        self,
+        key: ConfigPath,
+        value: Any = None
+    ) -> None:
+        """
+            Set a configuration value and persist to disk.
+
+            Args:
+                key: A ConfigPath object specifying which config file
+                     and key to write to.
+                value: The value to store.
+        """
+        ...

src/interfaces/__init__.py

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""

src/managers/__init__.py

@@ -1,8 +1,9 @@
+# -*- coding: utf-8 -*-
 """
-    Managers module for the AutoLibrary project.
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
 
-    Here are the classes and modules in this package:
-    - ConfigManager: Config manager for managing configuration files.
-    - LogManager: Log manager for logging.
-    - WebDriverManager: Web driver manager for managing web drivers.
-"""
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""

src/managers/config/ConfigManager.py

@@ -10,26 +10,17 @@ See the LICENSE file for details.
 import os
 import threading
 
-from enum import Enum
 from typing import Any, Optional
 
 from utils.JSONReader import JSONReader
 from utils.JSONWriter import JSONWriter
+from interfaces.ConfigProvider import ConfigType, ConfigPath
 
 
 # This config manager class only responsible for global and other
 # unconfigurable config files.
 
 
-class ConfigType(Enum):
-    """
-        Config type class. Values represent the default filename.
-    """
-    GLOBAL = "autolibrary.json" # Global config file.
-    BULLETIN = "bulletin.json" # Bulletin board config file.
-    TIMERTASK = "timer_task.json" # Timer task config file.
-
-
 class ConfigTemplate:
     """
         Config template class.
@@ -42,7 +33,6 @@ class ConfigTemplate:
 
         self.__config_type = config_type
 
-
     def template(
         self
     ) -> dict:
@@ -92,7 +82,6 @@ class ConfigManager:
 
         self.initialize()
 
-
     def initialize(
         self
     ):
@@ -100,7 +89,6 @@ class ConfigManager:
         for config_type in ConfigType:
             self.load(config_type)
 
-
     def load(
         self,
         config_type: ConfigType
@@ -117,47 +105,42 @@ class ConfigManager:
         self.__config_data[config_type.value] = ConfigTemplate(config_type).template()
         JSONWriter(config_path, self.__config_data[config_type.value])
 
-
     def get(
         self,
-        config_type: ConfigType,
-        key: str = "",
+        key: ConfigPath,
         default: Optional[Any] = None
     ) -> Any:
 
         with self.__config_lock:
-            config_data = self.__config_data[config_type.value]
-            if key == "":
+            config_data = self.__config_data[key.config_type.value]
+            if key.key == "":
                 return config_data
-            keys = key.split('.')
+            keys = key.key.split('.')
             for k in keys[:-1]:
                 config_data = config_data.get(k, None)
                 if config_data is None:
                     return default
             return config_data.get(keys[-1], default)
 
-
     def set(
         self,
-        config_type: ConfigType,
-        key: str = "",
+        key: ConfigPath,
         value: Any = None
     ):
 
         with self.__config_lock:
-            root_data = self.__config_data[config_type.value]
-            if key == "":
-                self.__config_data[config_type.value] = value
+            root_data = self.__config_data[key.config_type.value]
+            if key.key == "":
+                self.__config_data[key.config_type.value] = value
             else:
-                keys = key.split('.')
+                keys = key.key.split('.')
                 config_data = root_data
                 for k in keys[:-1]:
                     if k not in config_data:
                         config_data[k] = {}
                     config_data = config_data[k]
                 config_data[keys[-1]] = value
-        self.save(config_type)
-
+        self.save(key.config_type)
 
     def save(
         self,
@@ -167,7 +150,6 @@ class ConfigManager:
         config_path = os.path.join(self.__config_dir, config_type.value)
         JSONWriter(config_path, self.__config_data[config_type.value])
 
-
     def configDir(
         self
     ) -> str:
@@ -176,52 +158,11 @@ class ConfigManager:
 
 
 # ConfigManager singleton instance.
-_config_manager_instance = None
-
-# Utility functions.
-#
-# Utility function to get validated automation config paths.
-def getValidateAutomationConfigPaths(
-) -> dict:
-    """
-        Get validated automation config paths from ConfigManager instance.
-        These function will validate the config paths and return the validated paths in a dict.
-
-        Returns:
-            dict: Validated automation config paths.
-    """
-    config_paths = {"run": "", "user": ""}
-    auto_config = _config_manager_instance.get(ConfigType.GLOBAL, "automation", {})
-    for cfg_type in ["run", "user"]:
-            paths = auto_config.get(f"{cfg_type}_path", {}).get("paths", [])
-            index = auto_config.get(f"{cfg_type}_path", {}).get("current", 0)
-            if paths == []:
-                paths.append(os.path.join(_config_manager_instance.configDir(), f"{cfg_type}.json"))
-            if index < 0:
-                index = 0
-            if index >= len(paths):
-                index = len(paths) - 1
-            config_paths[cfg_type] = paths[index]
-            data = {"current": index, "paths": paths}
-            auto_config[f"{cfg_type}_path"] = data
-    _config_manager_instance.set(ConfigType.GLOBAL, "automation", auto_config)
-    return config_paths
-
-# Utility function to get base config directory.
-def getBaseConfigDir(
-) -> str:
-    """
-        Get base config directory, on Windows, it is usually at :
-            'C:\\Users\\<username>\\AppData\\Local\\AutoLibrary\\config'.
-
-        Returns:
-            str: Base config directory.
-    """
-
-    return _config_manager_instance.configDir()
+_config_manager_instance : ConfigManager | None = None
 
 # Singleton instance of ConfigManager.
 _instance_lock = threading.Lock()
+
 def instance(
     config_dir: str = ""
 ) -> ConfigManager:
@@ -240,6 +181,6 @@ def instance(
         else:
             if config_dir == "":
                 return _config_manager_instance
-            if getBaseConfigDir() != config_dir:
+            if _config_manager_instance.configDir() != config_dir:
                 raise ValueError("ConfigManager 的实例已初始化,不能使用不同的配置目录。")
     return _config_manager_instance

src/managers/config/ConfigUtils.py

@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+import os
+
+import managers.config.ConfigManager as ConfigManager
+
+from interfaces.ConfigProvider import CfgKey
+
+class ConfigUtils:
+    """
+        Config utilities class.
+    """
+
+    @staticmethod
+    def getAutomationConfigPaths(
+    ) -> dict[str]:
+        """
+            Get validated automation config paths from ConfigManager instance.
+            These function will validate the config paths and return the validated paths in a dict.
+
+            Returns:
+                dict[str]: Validated automation config paths (include user and run config paths).
+        """
+        cfg_mgr = ConfigManager.instance() # config manager instance
+
+        config_paths = {"run": "", "user": ""}
+        auto_config = cfg_mgr.get(CfgKey.GLOBAL.AUTOMATION.ROOT, {})
+        for cfg_type in ["run", "user"]:
+                paths = auto_config.get(f"{cfg_type}_path", {}).get("paths", [])
+                index = auto_config.get(f"{cfg_type}_path", {}).get("current", 0)
+                if paths == []:
+                    paths.append(os.path.join(cfg_mgr.configDir(), f"{cfg_type}.json"))
+                if index < 0:
+                    index = 0
+                if index >= len(paths):
+                    index = len(paths) - 1
+                config_paths[cfg_type] = paths[index]
+                data = {"current": index, "paths": paths}
+                auto_config[f"{cfg_type}_path"] = data
+        cfg_mgr.set(CfgKey.GLOBAL.AUTOMATION.ROOT, auto_config)
+        return config_paths

src/managers/config/__init__.py

@@ -1,6 +1,9 @@
+# -*- coding: utf-8 -*-
 """
-    Config managers module for the AutoLibrary project.
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
 
-    Here are the classes and modules in this package:
-    - ConfigManager: Config manager for managing configuration files.
-"""
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""

src/managers/driver/WebBrowserDetector.py

@@ -1,5 +1,14 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
 import platform
-import installed_browsers
+import browsers
 
 from pathlib import Path
 from enum import Enum
@@ -32,6 +41,7 @@ class WebBrowserArch(Enum):
     MACX86_64 = 6
     MACARM = 7
 
+
 @dataclass
 class WebBrowserInfo:
     """
@@ -61,7 +71,6 @@ class WebBrowserArchDetector:
 
         pass
 
-
     def detect(
         self
     ) -> WebBrowserArch:
@@ -114,7 +123,6 @@ class WebBrowserDetector:
         self.browser_arch = WebBrowserArchDetector().detect()
         self.browser_infos : list[WebBrowserInfo] = []
 
-
     def detect(
         self
     ) -> list[WebBrowserInfo]:
@@ -128,7 +136,7 @@ class WebBrowserDetector:
 
         self.browser_infos = []
         try:
-            all_browsers = installed_browsers.browsers()
+            all_browsers = list(browsers.browsers())
         except Exception as e:
             self.browser_infos = []
             return self.browser_infos
@@ -140,14 +148,14 @@ class WebBrowserDetector:
             'msedge': WebBrowserType.EDGE,
         }
         for browser in all_browsers:
-            internal_name = browser.get('name', '').lower()
+            internal_name = browser.get("browser_type", "").lower()
             if internal_name not in type_map:
                 continue  # Not one of the browsers we care about
-            version = browser.get('version')
+            version = browser.get("version", "")
             if not version:
                 # Skip browsers with no version info (unlikely, but defensive)
                 continue
-            exe_path = browser.get('location')
+            exe_path = browser.get("path", "")
             if not exe_path:
                 continue
             try:
@@ -163,4 +171,13 @@ class WebBrowserDetector:
                 browser_path=path,
             )
             self.browser_infos.append(info)
+        # Deduplicate: keep only one entry per (type, version)
+        seen = set()
+        unique = []
+        for info in self.browser_infos:
+            key = (info.browser_type, info.browser_version)
+            if key not in seen:
+                seen.add(key)
+                unique.append(info)
+        self.browser_infos = unique
         return self.browser_infos

src/managers/driver/WebDriverDownloader.py

@@ -1,3 +1,12 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
 import os
 import time
 import shutil
@@ -86,7 +95,6 @@ class WebDriverName:
 
         self.driver_type = driver_type
 
-
     def __str__(
         self
     ) -> str:
@@ -116,7 +124,6 @@ class WebDriverExecName:
         self.driver_type = driver_type
         self.arch = arch
 
-
     def __str__(
         self
     ) -> str:
@@ -191,7 +198,6 @@ class WebDriverURL:
         self.arch = arch
         self.file_name = str(WebDriverFileName(self.version, self.driver_type, self.arch))
 
-
     def __str__(
         self
     ) -> str:
@@ -241,31 +247,6 @@ class WebDriverDownloader:
         self.download_dir.mkdir(mode=0o0755, parents=True, exist_ok=True)
         self.download_path = self.download_dir/str(WebDriverFileName(self.version, self.driver_type, self.arch))
 
-
-    def download(
-        self,
-        progress_callback: Optional[Callable[[float, int, float, str], None]] = None,
-        cancel_event: Optional[threading.Event] = None
-    ) -> Optional[Path]:
-
-        try:
-            # downlaod file : 0% - 98%
-            if not self._download(progress_callback, cancel_event=cancel_event):
-                return None
-            # verify file : 98% - 99%
-            if not self._verify(progress_callback):
-                progress_callback(0, 100, 0.0, "验证失败")
-                return None
-            # extract file : 99% - 100%
-            driver_path = self._extract(progress_callback)
-            if not driver_path:
-                progress_callback(0, 100, 0.0, "解压失败")
-                return None
-            return driver_path
-        except Exception as e:
-            raise e
-
-
     def _download(
         self,
         progress_callback: Optional[Callable[[float, int, float, str], None]] = None,
@@ -343,7 +324,6 @@ class WebDriverDownloader:
                     continue
                 raise e
 
-
     def _verify(
         self,
         progress_callback: Optional[Callable[[float, int, float, str], None]] = None
@@ -352,7 +332,6 @@ class WebDriverDownloader:
         progress_callback(98, 100, 0.0, "验证完成")
         return True
 
-
     def _extract(
         self,
         progress_callback: Optional[Callable[[float, int, float, str], None]] = None
@@ -388,7 +367,6 @@ class WebDriverDownloader:
         except Exception:
             return None
 
-
     def _cleanup(
         self,
         driver_file: Path
@@ -401,6 +379,29 @@ class WebDriverDownloader:
                 else:
                     item.unlink()
 
+    def download(
+        self,
+        progress_callback: Optional[Callable[[float, int, float, str], None]] = None,
+        cancel_event: Optional[threading.Event] = None
+    ) -> Optional[Path]:
+
+        try:
+            # downlaod file : 0% - 98%
+            if not self._download(progress_callback, cancel_event=cancel_event):
+                return None
+            # verify file : 98% - 99%
+            if not self._verify(progress_callback):
+                progress_callback(0, 100, 0.0, "验证失败")
+                return None
+            # extract file : 99% - 100%
+            driver_path = self._extract(progress_callback)
+            if not driver_path:
+                progress_callback(0, 100, 0.0, "解压失败")
+                return None
+            return driver_path
+        except Exception as e:
+            raise e
+
 
 class ChromeDriverDownloader(WebDriverDownloader):
     """

src/managers/driver/WebDriverManager.py

@@ -81,7 +81,6 @@ class WebDriverManager:
 
         self.initialize()
 
-
     def initialize(
         self
     ):
@@ -93,7 +92,6 @@ class WebDriverManager:
         self._checkDriverStatus()
         self.__initialized = True
 
-
     def _detectBrowsers(
         self
     ):
@@ -105,7 +103,6 @@ class WebDriverManager:
                 for info in browser_infos
             ]
 
-
     def _checkDriverStatus(
         self
     ):
@@ -117,7 +114,6 @@ class WebDriverManager:
                     driver_info.driver_path = driver_path
                     driver_info.driver_status = WebDriverStatus.INSTALLED
 
-
     def _mapWebBrowserTypeToDriver(
         self,
         browser_type: WebBrowserType
@@ -132,7 +128,6 @@ class WebDriverManager:
         else:
             raise ValueError(f"不支持的 Web 浏览器类型 : {browser_type}")
 
-
     def _mapWebBrowserArchToDriver(
         self,
         browser_type: WebBrowserType,
@@ -199,7 +194,6 @@ class WebDriverManager:
         else:
             raise ValueError(f"不支持的 Web 浏览器类型 : {browser_type}")
 
-
     def _mapFirefoxDriverVersion(
         self,
         version: str
@@ -240,7 +234,6 @@ class WebDriverManager:
         except Exception as e:
             raise ValueError(f"无效的 Firefox 版本格式 : {version}") from e
 
-
     def _getDriverInfo(
         self,
         browser_info: WebBrowserInfo
@@ -256,7 +249,6 @@ class WebDriverManager:
         driver_info.browser_version = browser_info.browser_version
         return driver_info
 
-
     def _getDriverPath(
         self,
         driver_info: WebDriverInfo
@@ -286,7 +278,6 @@ class WebDriverManager:
         driver_path = driver_dir/exe_name
         return driver_path
 
-
     def refresh(
         self
     ):
@@ -294,7 +285,6 @@ class WebDriverManager:
         self._detectBrowsers()
         self._checkDriverStatus()
 
-
     def getDriverInfos(
         self
     ) -> list[WebDriverInfo]:
@@ -302,7 +292,6 @@ class WebDriverManager:
         with self.__lock:
             return self.__driver_infos.copy()
 
-
     def getDriverInfo(
         self,
         driver_type: WebDriverType
@@ -315,7 +304,6 @@ class WebDriverManager:
                 if info.driver_type == driver_type
             ]
 
-
     def getDriverPath(
         self,
         driver_info: WebDriverInfo
@@ -325,7 +313,6 @@ class WebDriverManager:
             return driver_info.driver_path
         return None
 
-
     def installDriver(
         self,
         driver_info: WebDriverInfo,
@@ -390,7 +377,6 @@ class WebDriverManager:
                 driver_info.driver_status = WebDriverStatus.ERROR
             raise e
 
-
     def cancelDriverDownload(
         self,
         driver_info: WebDriverInfo
@@ -411,7 +397,6 @@ class WebDriverManager:
         except Exception:
             return False
 
-
     def uninstallDriver(
         self,
         driver_info: WebDriverInfo,
@@ -441,7 +426,6 @@ class WebDriverManager:
                 driver_info.driver_status = WebDriverStatus.ERROR
             raise
 
-
     def driverDir(
         self
     ) -> str:

src/managers/driver/__init__.py

@@ -1,8 +1,9 @@
+# -*- coding: utf-8 -*-
 """
-    Driver managers module for the AutoLibrary project.
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
 
-    Here are the classes and modules in this package:
-    - WebBrowserDetector: Web browser detector class.
-    - WebDriverDownloader: Web driver downloader class.
-    - WebDriverManager: Web driver manager class.
-"""
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""

src/managers/log/LogManager.py

@@ -89,7 +89,6 @@ class LogManager:
 
         self.initialize()
 
-
     def initialize(
         self
     ):
@@ -139,7 +138,6 @@ class LogManager:
 
         self.__initialized = True
 
-
     def getLogger(
         self,
         name: Optional[str] = None
@@ -149,7 +147,6 @@ class LogManager:
             return self.__logger.getChild(name)
         return self.__logger
 
-
     def setLevel(
         self,
         level: int
@@ -158,7 +155,6 @@ class LogManager:
         if self.__logger:
             self.__logger.setLevel(level)
 
-
     def logDir(
         self
     ) -> str:
@@ -171,6 +167,7 @@ _log_manager_instance = None
 
 # Singleton instance lock.
 _instance_lock = threading.Lock()
+
 def instance(
     log_dir: str = ""
 ) -> LogManager:
@@ -186,7 +183,7 @@ def instance(
                 raise ValueError("LogManager 的实例已初始化, 不能使用不同的日志目录")
     return _log_manager_instance
 
-
+# export function to get logger
 def getLogger(
     name: Optional[str] = None
 ) -> logging.Logger:

src/managers/log/__init__.py

@@ -1,6 +1,9 @@
+# -*- coding: utf-8 -*-
 """
-    Log managers module for the AutoLibrary project.
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
 
-    Here are the classes and modules in this package:
-    - LogManager: Log manager for logging.
-"""
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""

src/operators/AutoLib.py

@@ -1,359 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Copyright (c) 2025 - 2026 KenanZhu.
-All rights reserved.
-
-This software is provided "as is", without any warranty of any kind.
-You may use, modify, and distribute this file under the terms of the MIT License.
-See the LICENSE file for details.
-"""
-import os
-import queue
-
-from selenium import webdriver
-from selenium.common.exceptions import TimeoutException
-from selenium.webdriver.common.by import By
-from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.support import expected_conditions as EC
-from selenium.webdriver.edge.service import Service as EdgeService
-from selenium.webdriver.chrome.service import Service as ChromeService
-from selenium.webdriver.firefox.service import Service as FirefoxService
-
-from base.MsgBase import MsgBase
-from operators.LibChecker import LibChecker
-from operators.LibLogin import LibLogin
-from operators.LibLogout import LibLogout
-from operators.LibReserve import LibReserve
-from operators.LibCheckin import LibCheckin
-from operators.LibRenew import LibRenew
-
-
-class AutoLib(MsgBase):
-
-    def __init__(
-        self,
-        input_queue: queue.Queue,
-        output_queue: queue.Queue,
-        run_config: dict
-    ):
-        super().__init__(input_queue, output_queue)
-
-        self.__run_config = run_config
-        self.__user_config = None
-        self.__driver = None
-        if not self.__initBrowserDriver():
-            raise Exception("浏览器驱动初始化失败 !")
-        else:
-            if not self.__initDriverUrl():
-                self.close()
-                raise Exception("浏览器驱动URL初始化失败 !")
-            self.__initLibOperators()
-
-
-    def __initBrowserDriver(
-        self
-    ) -> bool:
-
-        self._showTrace("正在初始化浏览器驱动......", no_log=True)
-
-        web_driver_config = self.__run_config.get("web_driver", None)
-        self.__driver_type = web_driver_config.get("driver_type")
-        match self.__driver_type.lower():
-            case "edge":
-                driver_options = webdriver.EdgeOptions()
-            case "chrome":
-                driver_options = webdriver.ChromeOptions()
-            case "firefox":
-                driver_options = webdriver.FirefoxOptions()
-            case _:
-                self._showTrace(
-                    f"不支持的浏览器驱动类型: {self.__driver_type} !",
-                    self.TraceLevel.WARNING
-                )
-                return False
-
-        if not web_driver_config:
-            self._showTrace("未配置浏览器驱动参数 !", self.TraceLevel.ERROR)
-            return False
-        if web_driver_config.get("headless"):
-            driver_options.add_argument("--headless")
-            driver_options.add_argument("--disable-gpu")
-            driver_options.add_argument("--no-sandbox")
-            driver_options.add_argument("--disable-dev-shm-usage")
-
-        # must be 1920x1080, otherwise the page will cause some elements not accessible
-        driver_options.add_argument("--window-size=1920,1080")
-
-        # omit ssl errors and verbose log level
-        driver_options.add_argument("--ignore-certificate-errors")
-        driver_options.add_argument("--ignore-ssl-errors")
-        driver_options.add_argument("--log-level=OFF")
-        driver_options.add_argument("--silent")
-
-        # set options for chrome and edge
-        if self.__driver_type.lower() in ["edge", "chrome"]:
-            driver_options.add_argument("--remote-allow-origins=*")
-            driver_options.add_experimental_option("excludeSwitches", ["enable-automation"])
-            driver_options.add_experimental_option("useAutomationExtension", False)
-            driver_options.add_argument("--disable-blink-features=AutomationControlled")
-            user_agent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "\
-                         "AppleWebKit/537.36 (KHTML, like Gecko) "\
-                         "Chrome/120.0.0.0 "\
-                         "Safari/537.36"
-            if self.__driver_type.lower() == "edge":
-                user_agent += " Edg/120.0.0.0"
-        # set options for firefox
-        elif self.__driver_type.lower() == "firefox":
-            driver_options.set_preference("dom.webdriver.enabled", False)
-            driver_options.set_preference("useAutomationExtension", False)
-            user_agent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:120.0) "\
-                         "Gecko/20100101 Firefox/120.0"
-        driver_options.add_argument(f"user-agent={user_agent}")
-
-        # init browser driver
-        self.__driver_path = web_driver_config.get("driver_path")
-        if not self.__driver_path:
-            self._showTrace("未配置浏览器驱动路径 !", self.TraceLevel.WARNING)
-            return False
-        self.__driver_path = os.path.abspath(self.__driver_path)
-        try:
-            service = None
-            match self.__driver_type.lower():
-                case "edge":
-                    service = EdgeService(executable_path=self.__driver_path)
-                    self.__driver = webdriver.Edge(service=service, options=driver_options)
-                case "chrome":
-                    service = ChromeService(executable_path=self.__driver_path)
-                    self.__driver = webdriver.Chrome(service=service, options=driver_options)
-                case "firefox":
-                    self._showTrace(f"Firefox 浏览器驱动初始化略慢, 请耐心等待...", no_log=True)
-                    service = FirefoxService(executable_path=self.__driver_path)
-                    self.__driver = webdriver.Firefox(service=service, options=driver_options)
-                case _: # actually will not happen, beacuse we have checked it at the initlization
-                    # of 'driver_options'
-                    raise Exception(f"不支持的浏览器驱动类型: {self.__driver_type} !")
-            self.__driver.implicitly_wait(1)
-            self.__driver.execute_script(
-                "Object.defineProperty(navigator, 'webdriver', {get: () => undefined})"
-            )
-        except Exception as e:
-            self._showTrace(f"浏览器驱动初始化失败: {e}", self.TraceLevel.ERROR)
-            return False
-        self._showTrace(f"浏览器驱动已初始化, 类型: {self.__driver_type}, 路径: {self.__driver_path}")
-        return True
-
-
-    def __initLibOperators(
-        self
-    ):
-
-        if not self.__driver:
-            self._showTrace(f"浏览器驱动未初始化, 请先初始化浏览器驱动 !", self.TraceLevel.WARNING)
-            return
-        self.__lib_checker = LibChecker(self._input_queue, self._output_queue, self.__driver)
-        self.__lib_login = LibLogin(self._input_queue, self._output_queue, self.__driver)
-        self.__lib_logout = LibLogout(self._input_queue, self._output_queue, self.__driver)
-        self.__lib_reserve = LibReserve(self._input_queue, self._output_queue, self.__driver)
-        self.__lib_checkin = LibCheckin(self._input_queue, self._output_queue, self.__driver)
-        self.__lib_renew = LibRenew(self._input_queue, self._output_queue, self.__driver)
-
-
-    def __waitResponseLoad(
-        self
-    ) -> bool:
-
-        # wait for page load
-        try:
-            WebDriverWait(self.__driver, 2).until( # title contains "首页"
-                EC.title_contains("首页")
-            )
-            WebDriverWait(self.__driver, 2).until( # username field presence
-                EC.presence_of_element_located((By.NAME, "username"))
-            )
-            WebDriverWait(self.__driver, 2).until( # password field presence
-                EC.presence_of_element_located((By.NAME, "password"))
-            )
-            WebDriverWait(self.__driver, 2).until( # captcha field presence
-                EC.presence_of_element_located((By.NAME, "answer"))
-            )
-            WebDriverWait(self.__driver, 2).until( # captcha image presence
-                EC.presence_of_element_located((By.ID, "loadImgId"))
-            )
-            return True
-        except:
-            self._showTrace(f"登录页面加载失败 !", self.TraceLevel.ERROR)
-            return False
-
-
-    def __initDriverUrl(
-        self,
-    ) -> bool:
-
-        lib_config = self.__run_config.get("library", None)
-        if not lib_config:
-            self._showTrace("未配置图书馆参数 !", self.TraceLevel.ERROR)
-            return False
-        url = lib_config.get("host_url") + lib_config.get("login_url")
-        self.__driver.set_page_load_timeout(5)
-        try:
-            self.__driver.get(url)
-        except TimeoutException:
-            self.__driver.execute_script("window.stop();")
-            self._showTrace(
-                 f"图书馆登录页面加载超时 ! 请检查网络环境是否正常", self.TraceLevel.ERROR
-            )
-            return False
-        if not self.__waitResponseLoad():
-            return False
-        return True
-
-
-    def __run(
-        self,
-        username: str,
-        password: str,
-        login_config: dict,
-        run_mode_config: dict,
-        reserve_info: dict
-    ) -> int:
-
-        # result : -1 - terminate, 0 - success, 1 - failed, 2 - passed
-        result = 2
-
-        # login
-        if not self.__lib_login.login(
-            username,
-            password,
-            login_config.get("max_attempt", 3),
-            login_config.get("auto_captcha", True),
-        ):
-            return 1
-        # Here, we collect the run mode from the run config.
-        run_mode = run_mode_config.get("run_mode", 0)
-        run_mode = {
-            "auto_reserve": run_mode&0x1,
-            "auto_checkin": run_mode&0x2,
-            "auto_renewal": run_mode&0x4,
-        }
-        # reserve
-        if run_mode["auto_reserve"]:
-            if self.__lib_checker.canReserve(reserve_info.get("date")):
-                if self.__lib_reserve.reserve(username, reserve_info):
-                    result = 0
-                else:
-                    result = 1
-            else:
-                self._showTrace(f"用户 {username} 无法预约, 已跳过")
-                result = 2
-
-        # checkin
-        last_result = result
-        if run_mode["auto_checkin"] and last_result != 1:
-            if self.__lib_checker.canCheckin():
-                if self.__lib_checkin.checkin(username):
-                    result = 0
-                else:
-                    result = 1
-            else:
-                self._showTrace(f"用户 {username} 无法签到, 已跳过")
-                result = 2
-        if last_result == 0: # partly success
-            result = 0
-
-        # renewal
-        last_result = result
-        if run_mode["auto_renewal"] and last_result != 1:
-            can_renew, record = self.__lib_checker.canRenew()
-            if can_renew:
-                if self.__lib_renew.renew(username, record, reserve_info):
-                    if self.__lib_checker.postRenewCheck(record):
-                        self._showTrace(f"用户 {username} 续约成功 !")
-                        result = 0
-                    else:
-                        if result != 1: # partly success
-                            result = 0
-                        else:
-                            result = 1
-                else:
-                    result = 1
-            else:
-                self._showTrace(f"用户 {username} 无法续约, 已跳过")
-                result = 2
-        if last_result == 0: # partly success
-            result = 0
-
-        # logout
-        if not self.__lib_logout.logout(
-            username
-        ):
-            # if logout is failed, we must make sure the host to be reloaded
-            # otherwise, the next login may fail
-            if not self.__initDriverUrl():
-                return -1
-        return result
-
-
-    def run(
-        self,
-        user_config: dict
-    ):
-
-        self.__user_config = user_config
-
-        user_counter = {"current": 0, "success": 0, "failed": 0, "passed": 0}
-        users = self.__user_config["users"]
-        self._showTrace(f"共发现 {len(users)} 个用户")
-        for user in users:
-            user_counter["current"] += 1
-            self._showTrace(
-                f"正在处理第 {user_counter["current"]}/{len(users)} 个用户: {user["username"]}......",
-                no_log=True
-            )
-            if not user["enabled"]:
-                self._showTrace(f"用户 {user["username"]} 已跳过")
-                user_counter["passed"] += 1
-                continue
-            r = self.__run(
-                username=user["username"],
-                password=user["password"],
-                login_config=self.__run_config["login"],
-                run_mode_config=self.__run_config["mode"],
-                reserve_info=user["reserve_info"],
-            )
-            if r == -1:
-                self._showTrace(
-                    f"用户 {user["username"]} 处理过程中页面发生异常, 无法继续操作, 任务已终止 !",
-                    self.TraceLevel.WARNING
-                )
-                break
-            elif r == 0:
-                user_counter["success"] += 1
-            elif r == 1:
-                user_counter["failed"] += 1
-            elif r == 2:
-                user_counter["passed"] += 1
-        self._showTrace(f"处理完成, 共计 {user_counter["current"]} 个用户, "\
-            f"成功 {user_counter["success"]} 个用户, "\
-            f"失败 {user_counter["failed"]} 个用户, "\
-            f"跳过 {user_counter["passed"]} 个用户"
-        )
-        return
-
-
-    def close(
-        self
-    ) -> bool:
-
-        if self.__driver:
-            if self.__driver_type.lower() == "firefox":
-                self._showTrace(
-                    f"Firefox 浏览器驱动关闭略慢, 请耐心等待...",
-                    no_log=True
-                )
-            self.__driver.quit()
-            self.__driver = None
-            self._showTrace(f"浏览器驱动已关闭")
-            return True
-        else:
-            self._showTrace(f"浏览器驱动未初始化, 无需关闭", no_log=True)
-            return False

src/operators/LibChecker.py

@@ -1,377 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Copyright (c) 2025 - 2026 KenanZhu.
-All rights reserved.
-
-This software is provided "as is", without any warranty of any kind.
-You may use, modify, and distribute this file under the terms of the MIT License.
-See the LICENSE file for details.
-"""
-import re
-import time
-import queue
-
-from datetime import datetime, timedelta
-from selenium.webdriver.common.by import By
-from selenium.webdriver.chrome.webdriver import WebDriver
-from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.support import expected_conditions as EC
-
-from base.LibOperator import LibOperator
-
-
-class LibChecker(LibOperator):
-
-    def __init__(
-        self,
-        input_queue: queue.Queue,
-        output_queue: queue.Queue,
-        driver: WebDriver
-    ):
-
-        super().__init__(input_queue, output_queue)
-
-        self.__driver = driver
-
-
-    def _waitResponseLoad(
-        self
-    ) -> bool:
-
-        pass
-
-    @staticmethod
-    def __formatDiffTime(
-        seconds: float
-    ) -> str:
-
-        hours = int(seconds//3600)
-        minutes = int(seconds%3600//60)
-        seconds = int(seconds%60)
-        return f"{hours} 时 {minutes} 分 {seconds} 秒"
-
-
-    def __navigateToReserveRecordPage(
-        self
-    ) -> bool:
-
-        try:
-            WebDriverWait(self.__driver, 2).until(
-                EC.element_to_be_clickable((By.XPATH, "//a[@href='/history?type=SEAT']"))
-            ).click()
-            WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_element_located((By.CLASS_NAME, "myReserveList"))
-            )
-        except:
-            self._showTrace("加载预约记录页面失败 !", self.TraceLevel.ERROR)
-            return False
-        return True
-
-
-    def __decodeReserveTime(
-        self,
-        time_element
-    ) -> dict:
-
-        time_str = time_element.text.strip()
-        today = datetime.now().date()
-        if "明天" in time_str:
-            target_date = today + timedelta(days=1)
-            date = target_date.strftime("%Y-%m-%d")
-        elif "今天" in time_str:
-            target_date = today
-            date = target_date.strftime("%Y-%m-%d")
-        elif "昨天" in time_str:
-            target_date = today - timedelta(days=1)
-            date = target_date.strftime("%Y-%m-%d")
-        else:
-            date_match = re.search(r"(\d{4}-\d{1,2}-\d{1,2})", time_str)
-            if date_match:
-                date = date_match.group(1)
-            else:
-                date = ""
-        time_match = re.search(r"(\d{1,2}:\d{2}) -- (\d{1,2}:\d{2})", time_str)
-        if time_match:
-            begin_time = time_match.group(1)
-            end_time = time_match.group(2)
-        else:
-            begin_time = ""
-            end_time = ""
-        return {
-            "date": date,
-            "time": {
-                "begin": begin_time,
-                "end": end_time
-            }
-        }
-
-
-    def __decodeReserveInfo(
-        self,
-        info_elements
-    ) -> str:
-
-        location = ""
-        status = ""
-        for info in info_elements:
-            if "已预约" in info.text:
-                status = "已预约"
-            elif "使用中" in info.text:
-                status = "使用中"
-            elif "已完成" in info.text:
-                status = "已完成"
-            elif "已结束使用" in info.text:
-                status = "已结束使用"
-            elif "已取消" in info.text:
-                status = "已取消"
-            elif "失约" in info.text:
-                status = "失约"
-            elif "图书馆" in info.text:
-                location = info.text.strip()
-        return {
-            "location": location,
-            "status": status,
-        }
-
-
-    def __decodeReserveRecord(
-        self,
-        reservation
-    ) -> dict:
-
-        try:
-            time_element = reservation.find_element(
-                By.CSS_SELECTOR, "dt"
-            )
-            info_elements = reservation.find_elements(
-                By.CSS_SELECTOR, "a"
-            )
-        except:
-            return {
-                "date": "",
-                "time": {"begin": "", "end": ""},
-                "info": {"location": "", "status": ""}
-            }
-        time = self.__decodeReserveTime(time_element)
-        info = self.__decodeReserveInfo(info_elements)
-        return {
-            "date": time["date"],
-            "time": time["time"],
-            "info": info
-        }
-
-
-    def __loadReserveRecords(
-        self
-    ) -> list:
-        try:
-            # check if there's any reservation on the date
-            WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_element_located((By.CSS_SELECTOR, ".myReserveList > dl"))
-            )
-            reservations = self.__driver.find_elements(
-                By.CSS_SELECTOR, ".myReserveList > dl:not(#moreBlock)"
-            )
-            return reservations
-        except:
-            self._showTrace("加载预约记录失败 !", self.TraceLevel.ERROR)
-            return None
-
-
-    def __showMoreReserveRecords(
-        self
-    ) -> bool:
-
-        # load new reservations if still not sure
-        try:
-            WebDriverWait(self.__driver, 0.1).until(
-                EC.element_to_be_clickable((By.ID, "moreBtn"))
-            )
-        except:
-            # the reservation is the last one
-            return False
-        try:
-            more_btn = self.__driver.find_element(By.ID, "moreBtn")
-            if more_btn.is_displayed() and more_btn.is_enabled():
-                self.__driver.execute_script("arguments[0].scrollIntoView(true);", more_btn)
-                self.__driver.execute_script("arguments[0].click();", more_btn)
-                return True
-            else:
-                self._showTrace("用户无法加载更多预约记录", self.TraceLevel.WARNING)
-                return False
-        except:
-            self._showTrace("加载更多预约记录失败 !", self.TraceLevel.ERROR)
-            return False
-
-
-    def __getReserveRecord(
-        self,
-        wanted_date: str,
-        wanted_status: str
-    ) -> dict:
-
-        if wanted_date is None:
-            self._showTrace("日期未指定, 无法检查当前预约状态", self.TraceLevel.WARNING)
-            return None
-        self._showTrace(f"正在检查用户在 {wanted_date} 是否有预约状态为 {wanted_status} 的预约记录......", no_log=True)
-
-        checked_count = 0
-        max_check_times = 6 # we only check (4*(6-1)=)20 reservations, the last time cant be checked
-
-        if not self.__navigateToReserveRecordPage():
-            return None
-        for _ in range(max_check_times):
-            reservations = self.__loadReserveRecords()
-            if reservations is None:
-                return None
-            for reservation in reservations[checked_count:]:
-                record = self.__decodeReserveRecord(reservation)
-                checked_count += 1
-                if record is None:
-                    continue
-                if record["date"] == "":
-                    continue
-                if record["time"] == {"begin": "", "end": ""}:
-                    continue
-                # record date is later than the given date, check the next one
-                if datetime.strptime(record["date"], "%Y-%m-%d").date() >\
-                   datetime.strptime(wanted_date, "%Y-%m-%d").date():
-                    continue
-                # record date is earlier than the given date, so there is no wanted record
-                if datetime.strptime(record["date"], "%Y-%m-%d").date() <\
-                   datetime.strptime(wanted_date, "%Y-%m-%d").date():
-                    return None
-                if record["info"]["status"] == wanted_status:
-                    self._showTrace(
-                        f"寻找到用户第 {checked_count} 条状态为 {wanted_status} 的预约记录, "
-                        f"详细信息: {record["date"]} "
-                        f"{record["time"]["begin"]} - {record["time"]["end"]} {record["info"]["location"]}",
-                        no_log=True
-                    )
-                    return record
-            if not self.__showMoreReserveRecords():
-                break
-        return None
-
-
-    def canReserve(
-        self,
-        date: str
-    ) -> bool:
-
-        # no reserved or using record in the given date
-        # then can reserve
-        if self.__getReserveRecord(date, "已预约") is None:
-            if self.__getReserveRecord(date, "使用中") is None:
-                self._showTrace(f"用户在 {date} 可以预约")
-                return True
-            self._showTrace(f"用户在 {date} 有使用中的预约, 无法预约")
-            return False
-        self._showTrace(f"用户在 {date} 已存在有效预约, 无法预约")
-        return False
-
-
-    def canCheckin(
-        self
-    ) -> bool:
-
-        # only check the current date
-        date = time.strftime("%Y-%m-%d", time.localtime())
-        record = self.__getReserveRecord(date, "已预约")
-        if record is not None:
-            begin_time = record["time"]["begin"]
-            begin_time = datetime.strptime(f"{date} {begin_time}", "%Y-%m-%d %H:%M")
-            time_diff = datetime.now() - begin_time
-            time_diff_seconds = time_diff.total_seconds()
-            # before 30 minutes, cant checkin
-            if time_diff_seconds < -30*60:
-                self._showTrace(
-                    f"用户在 {date} 的预约开始时间为 {begin_time}, "
-                    f"当前距离预约开始时间还有 {self.__formatDiffTime(abs(time_diff_seconds))}, 无法签到"
-                )
-                return False
-            # before in 30 minutes, can checkin
-            elif -30*60 <= time_diff_seconds < 0:
-                self._showTrace(
-                    f"用户在 {date} 的预约开始时间为 {begin_time}, "
-                    f"当前距离预约开始时间还有 {self.__formatDiffTime(abs(time_diff_seconds))}, 可以签到"
-                )
-                return True
-            # past less than 30 minutes, can checkin
-            elif 0 <= time_diff_seconds < 30*60 - 5: # spare 5 seconds for the checkin process
-                self._showTrace(
-                    f"用户在 {date} 的预约开始时间为 {begin_time}, "
-                    f"当前距离预约开始时间已经过去 {self.__formatDiffTime(abs(time_diff_seconds))}, 可以签到"
-                )
-                return True
-        self._showTrace(f"用户在 {date} 没有有效预约记录, 无法签到")
-        return False
-
-
-    def canRenew(
-        self
-    ) -> tuple[bool, dict]:
-
-        # only check the current date
-        date = time.strftime("%Y-%m-%d", time.localtime())
-        record = self.__getReserveRecord(date, "使用中")
-        if record is not None:
-            end_time = record["time"]["end"]
-            end_time = datetime.strptime(f"{date} {end_time}", "%Y-%m-%d %H:%M")
-            time_diff = end_time - datetime.now()
-            time_diff_seconds = time_diff.total_seconds()
-            # a using record is definitely after the begin time
-            trace_msg = (
-                f"用户在 {date} 的预约结束时间为 {end_time}, "
-                f"当前距离预约结束时间还有 {self.__formatDiffTime(abs(time_diff_seconds))}"
-            )
-            if abs(time_diff_seconds) < 120*60:
-                self._showTrace(f"{trace_msg}, 可以续约")
-                return True, record
-            else:
-                self._showTrace(f"{trace_msg}, 无法续约")
-                return False, None # we do not need to return the record, because if current
-                # time is not available for renewal, the record is not required
-        self._showTrace(f"用户在 {date} 没有有效预约记录, 无法续约")
-        return False, None
-
-
-    def postRenewCheck(
-        self,
-        record: dict
-    ) -> bool:
-        """
-            Check if the renew operation is successful
-
-            Args:
-                record (dict): The expected record after renewal
-
-            Returns:
-                bool: True if the renew operation is successful, False otherwise
-        """
-        # because the special circumstance that the renew operation
-        # do not show the success message or anything else,
-        # we need to check the record data to make sure the renew operation is successful.
-
-        # only check the given record date
-        date = record["date"]
-        act_record = self.__getReserveRecord(date, "使用中")
-        if act_record is not None:
-            if act_record["time"]["begin"] == record["time"]["begin"] and\
-               act_record["time"]["end"] == record["time"]["end"]:
-                self._showTrace(f"\n"\
-                    f"      续约成功 !\n"\
-                    f"          日 期 ：{date}\n"\
-                    f"          时 间 ：{act_record["time"]["begin"]} - {act_record["time"]["end"]}\n"\
-                    f"          位 置 ：{act_record["info"]["location"]}\n"
-                    f"          状 态 ：{act_record["info"]["status"]}"
-                )
-                return True
-            else:
-                self._showTrace(f"\n"\
-                    f"      续约失败 !\n"\
-                    f"          续约后结束时间为 {act_record["time"]["end"]},与预期结束时间 {record["time"]["end"]} 不符 !"
-                )
-                return False
-        self._showTrace(f"用户在 {date} 没有有效预约记录, 无法检查续约结果")
-        return False

src/operators/LibCheckin.py

@@ -1,142 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Copyright (c) 2025 - 2026 KenanZhu.
-All rights reserved.
-
-This software is provided "as is", without any warranty of any kind.
-You may use, modify, and distribute this file under the terms of the MIT License.
-See the LICENSE file for details.
-"""
-import time
-import queue
-
-from selenium.webdriver.common.by import By
-from selenium.webdriver.chrome.webdriver import WebDriver
-from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.support import expected_conditions as EC
-
-from base.LibOperator import LibOperator
-
-
-class LibCheckin(LibOperator):
-
-    def __init__(
-        self,
-        input_queue: queue.Queue,
-        output_queue: queue.Queue,
-        driver: WebDriver
-    ):
-
-        super().__init__(input_queue, output_queue)
-
-        self.__driver = driver
-
-
-    def _waitResponseLoad(
-        self
-    ) -> bool:
-
-        try:
-            WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_element_located((By.CLASS_NAME, "ui_dialog"))
-            )
-            WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_element_located((By.CLASS_NAME, "resultMessage"))
-            )
-            WebDriverWait(self.__driver, 2).until(
-                EC.element_to_be_clickable((By.CLASS_NAME, "btnOK"))
-            )
-            result_message_element = self.__driver.find_element(
-                By.CLASS_NAME, "resultMessage"
-            )
-            ok_btn = self.__driver.find_element(By.CLASS_NAME, "btnOK")
-        except:
-            self._showTrace("签到时发生未知错误 !", self.TraceLevel.ERROR)
-            return False
-        result_message = result_message_element.text
-        if "签到成功" in result_message:
-            try:
-                detail_elements = self.__driver.find_elements(
-                    By.CSS_SELECTOR, ".resultMessage dd"
-                )
-            except:
-                pass
-            if detail_elements:
-                details = [element.text for element in detail_elements if element.text.strip()]
-                if len(details) >= 5:
-                    self._showTrace(f"\n"\
-                        f"      签到成功 !\n"\
-                        f"          {details[1]}\n"\
-                        f"          {details[2]}\n"\
-                        f"          {details[3]}\n"\
-                        f"          {details[4]}"
-                    )
-            else:
-                self._showTrace(f"\n"\
-                         "      签到成功 !\n"\
-                         "          未获取到签到详情 !"
-                    )
-            ok_btn.click()
-            return True
-        else:
-            failure_reason = result_message.replace("签到失败", "").strip()
-            self._showTrace(f"\n"\
-                "      签到失败 !\n"\
-                f"          {failure_reason}"
-                )
-            ok_btn.click()
-            return False
-
-
-    def __enableCheckinBtn(
-        self
-    ) -> bool:
-
-        script = """
-        try {
-            var checkin_btn = document.getElementById('btnCheckIn');
-            if (checkin_btn) {
-                checkin_btn.classList.remove('disabled');
-                return true;
-            }
-            return false;
-        } catch (e) {
-            return false;
-        }
-        """
-        result = self.__driver.execute_script(script)
-        time.sleep(0.1)
-        if result:
-            self._showTrace("签到按钮已启用", no_log=True)
-        else:
-            self._showTrace("签到按钮启用失败", self.TraceLevel.WARNING)
-        return result
-
-
-    def checkin(
-        self,
-        username: str
-    ) -> bool:
-
-        if self.__driver is None:
-            self._showTrace("未提供有效 WebDriver 实例 !", self.TraceLevel.WARNING)
-            return False
-        try:
-            checkin_btn = WebDriverWait(self.__driver, 2).until(
-                EC.element_to_be_clickable((By.ID, "btnCheckIn"))
-            )
-        except:
-            self._showTrace(f"用户 {username} 签到界面加载失败 !", self.TraceLevel.ERROR)
-            return False
-        if "disabled" in checkin_btn.get_attribute("class"):
-            self._showTrace("签到按钮不可用, 可能不在场馆内, 正在尝试启用......", no_log=True)
-            if not self.__enableCheckinBtn():
-                self._showTrace(f"签到按钮启用失败 !", self.TraceLevel.ERROR)
-                return False
-        checkin_btn.click()
-        if self._waitResponseLoad():
-            self._showTrace(f"用户 {username} 签到成功 !", no_log=True)
-            return True
-        else:
-            self._showTrace(f"用户 {username} 签到失败 !", self.TraceLevel.ERROR)
-        return False

src/operators/LibCheckout.py

@@ -1,41 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Copyright (c) 2025 - 2026 KenanZhu.
-All rights reserved.
-
-This software is provided "as is", without any warranty of any kind.
-You may use, modify, and distribute this file under the terms of the MIT License.
-See the LICENSE file for details.
-"""
-import re
-import time
-import queue
-
-from datetime import datetime, timedelta
-from selenium.webdriver.common.by import By
-from selenium.webdriver.chrome.webdriver import WebDriver
-from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.support import expected_conditions as EC
-
-from base.LibOperator import LibOperator
-
-
-class LibCheckout(LibOperator):
-
-    def __init__(
-        self,
-        input_queue: queue.Queue,
-        output_queue: queue.Queue,
-        driver: WebDriver
-    ):
-
-        super().__init__(input_queue, output_queue)
-
-        self.__driver = driver
-
-
-    def _waitResponseLoad(
-        self
-    ) -> bool:
-
-        pass

src/operators/LibLogin.py

@@ -1,215 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Copyright (c) 2025 - 2026 KenanZhu.
-All rights reserved.
-
-This software is provided "as is", without any warranty of any kind.
-You may use, modify, and distribute this file under the terms of the MIT License.
-See the LICENSE file for details.
-"""
-import queue
-import base64
-
-import ddddocr
-
-from selenium.webdriver.common.by import By
-from selenium.webdriver.chrome.webdriver import WebDriver
-from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.support import expected_conditions as EC
-
-from base.LibOperator import LibOperator
-
-
-class LibLogin(LibOperator):
-
-    def __init__(
-        self,
-        input_queue: queue.Queue,
-        output_queue: queue.Queue,
-        driver: WebDriver
-    ):
-
-        super().__init__(input_queue, output_queue)
-
-        self.__driver = driver
-        self.__ddddocr = ddddocr.DdddOcr()
-
-
-    def _waitResponseLoad(
-        self
-    ) -> bool:
-
-        # wait to verify login success
-        try:
-            WebDriverWait(self.__driver, 2).until( # title contains "自选座位 :: 座位预约系统"
-                EC.title_contains("自选座位 :: 座位预约系统")
-            )
-            WebDriverWait(self.__driver, 2).until( # search button presence
-                EC.presence_of_element_located((By.ID, "search"))
-            )
-            WebDriverWait(self.__driver, 2).until( # select content presence
-                EC.presence_of_element_located((By.CLASS_NAME, "selectContent"))
-            )
-            return True
-        except:
-            self._showTrace(
-                f"登录页面加载失败 ! : 用户账号或者密码错误/验证码错误, 具体以页面提示为准",
-                self.TraceLevel.ERROR
-            )
-            return False
-
-
-    def __fillLogInElements(
-        self,
-        username: str,
-        password: str
-    ) -> bool:
-
-        # ensure elements presence and fill them
-        try:
-            username_element = self.__driver.find_element(By.NAME, "username")
-            username_element.clear()
-            username_element.send_keys(username)
-            password_element = self.__driver.find_element(By.NAME, "password")
-            password_element.clear()
-            password_element.send_keys(password)
-        except Exception as e:
-            self._showTrace(f"用户名或密码填写失败 ! : {e}", self.TraceLevel.ERROR)
-            return False
-        return True
-
-
-    def __autoRecognizeCaptcha(
-        self
-    ) -> str:
-
-        # auto recognize captcha
-        try:
-            captcha_img = self.__driver.find_element(By.ID, "loadImgId")
-            img_src = captcha_img.get_attribute("src")
-            base64_str = img_src.split(',', 1)[1]
-            captcha_img = base64.b64decode(base64_str)
-            captcha_text = self.__ddddocr.classification(captcha_img)
-            captcha_text = ''.join(filter(str.isalnum, captcha_text)).lower()
-            self._showTrace(f"识别到验证码为 : '{captcha_text}'", no_log=True)
-            if len(captcha_text) != 4:
-                self._showLog("识别到的验证码长度不等于 4 个字符 !", self.TraceLevel.WARNING)
-                raise Exception("识别到的验证码长度不等于 4 个字符 !")
-            return captcha_text
-        except Exception as e:
-            self._showTrace(f"验证码识别失败 ! : {e}", self.TraceLevel.ERROR)
-            return ""
-
-
-    def __manualRecognizeCaptcha(
-        self
-    ) -> str:
-
-        # manual recognize captcha
-        try:
-            self._showMsg("请输入验证码:")
-            captcha_text = self._waitMsg(timeout=15)
-            self._showTrace(f"输入的验证码为 : '{captcha_text}'", no_log=True)
-            if len(captcha_text) != 4:
-                self._showLog("输入的验证码长度不等于 4 个字符 !", self.TraceLevel.WARNING)
-                raise Exception("输入的验证码长度不等于 4 个字符 !")
-            return captcha_text
-        except Exception as e:
-            self._showTrace(f"输入验证码失败 ! : {e}", self.TraceLevel.ERROR)
-            return ""
-
-
-    def __refreshCaptcha(
-        self
-    ):
-
-        # refresh captcha
-        try:
-            self._showTrace("刷新验证码......", no_log=True)
-            self.__driver.find_element(
-                By.ID, "loadImgId"
-            ).click()
-            return True
-        except Exception as e:
-            self._showTrace(f"刷新验证码失败 ! : {e}", self.TraceLevel.ERROR)
-            return False
-
-
-    def __solveCaptcha(
-        self,
-        auto_captcha: bool = True
-    ) -> str:
-
-        max_attempts = 3 # the possibility of 3 times failed is less than (10%^3)
-        for _ in range(max_attempts):
-            if auto_captcha:
-                captcha_text = self.__autoRecognizeCaptcha()
-            else:
-                self._showTrace(f"用户未配置自动识别验证码, 请手动输入验证码 !", no_log=True)
-                captcha_text = self.__manualRecognizeCaptcha()
-            if captcha_text:
-                return captcha_text
-            else:
-                if not self.__refreshCaptcha():
-                    return ""
-        self._showTrace(
-            f"验证码识别失败 {max_attempts} 次, 达到最大尝试次数 !",
-              self.TraceLevel.WARNING
-        )
-        return ""
-
-
-    def __fillCaptchaElement(
-        self,
-        captcha_text: str
-    ) -> bool:
-
-        try:
-            captcha_element = self.__driver.find_element(By.NAME, "answer")
-            captcha_element.clear()
-            captcha_element.send_keys(captcha_text)
-            return True
-        except Exception as e:
-            self._showTrace(f"验证码填写失败 ! : {e}", self.TraceLevel.ERROR)
-            return False
-
-
-    def login(
-        self,
-        username: str,
-        password: str,
-        max_attempts: int = 5,
-        auto_captcha: bool = True
-    ) -> bool:
-
-        if self.__driver is None:
-            self._showTrace("未提供有效 WebDriver 实例 !", self.TraceLevel.WARNING)
-            return False
-        # begin login process
-        for attempt in range(max_attempts):
-            self._showTrace(f"用户 {username} 第 {attempt + 1} 次尝试登录......", no_log=True)
-            if not self.__fillLogInElements(
-                username,
-                password,
-            ):
-                continue
-            captcha_text = self.__solveCaptcha(auto_captcha)
-            if not captcha_text:
-                continue
-            if not self.__fillCaptchaElement(captcha_text):
-                continue
-            self._showTrace("尝试登录...", no_log=True)
-            try:
-                self.__driver.find_element(
-                    By.XPATH,
-                    "//input[@type='button' and @value='登录']"
-                ).click()
-            except Exception as e:
-                self._showTrace(f"尝试登录失败 ! : {e}")
-                continue
-            if self._waitResponseLoad():
-                self._showTrace(f"用户 {username} 第 {attempt + 1} 次登录成功 !")
-                return True
-            else:
-                self._showTrace(f"用户 {username} 第 {attempt + 1} 次登录失败 !",self.TraceLevel.WARNING)
-        return False

src/operators/LibLogout.py

@@ -1,55 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Copyright (c) 2025 - 2026 KenanZhu.
-All rights reserved.
-
-This software is provided "as is", without any warranty of any kind.
-You may use, modify, and distribute this file under the terms of the MIT License.
-See the LICENSE file for details.
-"""
-import queue
-
-from selenium.webdriver.common.by import By
-from selenium.webdriver.chrome.webdriver import WebDriver
-
-from base.LibOperator import LibOperator
-
-
-class LibLogout(LibOperator):
-
-    def __init__(
-        self,
-        input_queue: queue.Queue,
-        output_queue: queue.Queue,
-        driver: WebDriver
-    ):
-
-        super().__init__(input_queue, output_queue)
-
-        self.__driver = driver
-
-
-    def _waitResponseLoad(
-        self
-    ) -> bool:
-
-        return True
-
-
-    def logout(
-        self,
-        username: str
-    ) -> bool:
-
-        if self.__driver is None:
-            self._showTrace("未提供有效 WebDriver 实例 !", self.TraceLevel.WARNING)
-            return False
-        try:
-            self.__driver.find_element(
-                By.XPATH, "//a[@href='/logout']"
-            ).click()
-            self._showTrace(f"用户 {username} 注销成功 !")
-            return True
-        except Exception as e:
-            self._showTrace(f"用户 {username} 注销失败 ! : {e}", self.TraceLevel.ERROR)
-            return False

src/operators/LibRenew.py

@@ -1,205 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Copyright (c) 2025 - 2026 KenanZhu.
-All rights reserved.
-
-This software is provided "as is", without any warranty of any kind.
-You may use, modify, and distribute this file under the terms of the MIT License.
-See the LICENSE file for details.
-"""
-import queue
-
-from selenium.webdriver.common.by import By
-from selenium.webdriver.chrome.webdriver import WebDriver
-from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.support import expected_conditions as EC
-
-from base.LibTimeSelector import LibTimeSelector
-
-
-class LibRenew(LibTimeSelector):
-
-    def __init__(
-        self,
-        input_queue: queue.Queue,
-        output_queue: queue.Queue,
-        driver: WebDriver
-    ):
-
-        super().__init__(input_queue, output_queue)
-
-        self.__driver = driver
-
-
-    def _waitResponseLoad(
-        self
-    ) -> bool:
-
-        self.__driver.refresh()
-        return True
-
-
-    def __waitRenewDialog(
-        self
-    ) -> bool:
-
-        try:
-            WebDriverWait(self.__driver, 2).until(
-                EC.visibility_of_element_located((By.ID, "extendDiv"))
-            )
-            head_message = WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_element_located((By.CSS_SELECTOR, "#extendDiv p.messageHead"))
-            )
-            result_message = WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_element_located((By.CSS_SELECTOR, "#extendDiv div.resultMessage"))
-            )
-        except:
-            self._showTrace("续约时间选择界面加载失败 !", self.TraceLevel.ERROR)
-            return False
-        head_message = head_message.text.strip()
-        if "警告" in head_message:
-            result_message = result_message.text.strip()
-            self._showTrace(f"\n"\
-                f"      续约失败 !\n"\
-                f"          {result_message}", no_log=True)
-            return False
-        try:
-            WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_all_elements_located(
-                    (By.CSS_SELECTOR, "#extendDiv .renewal_List li")
-                )
-            )
-            WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_element_located((By.CSS_SELECTOR, "#extendDiv .btnOK"))
-            )
-        except:
-            self._showTrace("续约时间选择界面加载失败 !", self.TraceLevel.ERROR)
-            return False
-        return True
-
-
-    def __selectNearestTime(
-        self,
-        record: dict,
-        reserve_info: dict
-    ) -> bool:
-
-        """
-            Select the nearest available renewal time.
-        """
-        end_time = record["time"]["end"]
-        renew_info = reserve_info["renew_time"]
-        max_diff = renew_info["max_diff"]
-        prefer_earlier = renew_info["prefer_early"]
-        target_renew_mins = self._timeStrToMins(end_time) + renew_info["expect_duration"]*60
-
-        # Validate and adjust target renew time to library closing time
-        if not self.__validateAndAdjustRenewTime(end_time, target_renew_mins):
-            return False
-        renew_ok_btn = self.__driver.find_element(By.CSS_SELECTOR, "#extendDiv .btnOK")
-        renew_time_opts = self.__driver.find_elements(By.CSS_SELECTOR, "#extendDiv .renewal_List li")
-        if not renew_time_opts:
-            self._showTrace("当前未查询到可用续约时间 !", self.TraceLevel.WARNING)
-            return False
-
-        # Find best renewal time option
-        best_opt, best_text, actual_diff, free_times = self._findBestTimeOption(
-            renew_time_opts, target_renew_mins, max_diff, prefer_earlier, is_reserve=False
-        )
-        if best_opt is not None:
-            return self.__confirmRenewal(best_opt, best_text, actual_diff, record, renew_ok_btn)
-        self._showTrace(
-            "无法选择最近的可用续约时间 ! "
-            f"所有可选时间与目标时间相差都超过了 {max_diff} 分钟 !",
-            self.TraceLevel.WARNING
-        )
-        self._showTrace(f"当前可供续约的时间有: {free_times}")
-        return False
-
-
-    def __validateAndAdjustRenewTime(
-        self,
-        end_time: str,
-        target_renew_mins: int
-    ) -> bool:
-
-        """
-            Validate and adjust renewal time to library closing time if needed.
-        """
-        LIBRARY_CLOSE_TIME = 1410  # 23:30 in minutes
-        if target_renew_mins > LIBRARY_CLOSE_TIME:
-            actual_renew_duration = LIBRARY_CLOSE_TIME - self._timeStrToMins(end_time)
-            if actual_renew_duration <= 0:
-                self._showTrace(f"当前结束时间 {end_time} 已接近闭馆时间,无法续约 !", self.TraceLevel.ERROR)
-                return False
-            self._showTrace(
-                f"续约时间已调整至闭馆时间 {self._minsToTimeStr(LIBRARY_CLOSE_TIME)},"
-                f"实际续约时长为 {actual_renew_duration//60} 小时 {actual_renew_duration%60} 分钟"
-            )
-            return True
-        return True
-
-
-    def __confirmRenewal(
-        self,
-        best_opt,
-        best_text: str,
-        actual_diff: int,
-        record: dict,
-        ok_btn
-    ) -> bool:
-
-        """
-            Confirm the selected renewal time.
-        """
-        try:
-            best_opt.click()
-            abs_diff = abs(actual_diff)
-            time_relation = self._formatTimeRelation(abs_diff, actual_diff, "续约时间")
-            self._showTrace(
-                f"选择距离期望续约时间最近的 {best_text}, "
-                f"与期望续约时间相比 {time_relation}"
-            )
-            record["time"]["end"] = best_text.strip()
-            ok_btn.click()
-            return True
-        except:
-            self._showTrace("确认续约时发生错误 !", self.TraceLevel.ERROR)
-            return False
-
-
-    def renew(
-        self,
-        username: str,
-        record: dict,
-        reserve_info: dict
-    ) -> bool:
-
-        if self.__driver is None:
-            self._showTrace("未提供有效 WebDriver 实例 !", self.TraceLevel.WARNING)
-            return False
-        try:
-            renew_btn = WebDriverWait(self.__driver, 2).until(
-                EC.element_to_be_clickable((By.ID, "btnExtend"))
-            )
-        except:
-            self._showTrace(f"用户 {username} 续约界面加载失败 !", self.TraceLevel.ERROR)
-            return False
-        if "disabled" in renew_btn.get_attribute("class"):
-            self._showLog(f"用户 {username} 续约按钮不可用, 可能不在场馆内")
-            self._showTrace(f"用户 {username} 续约按钮不可用, 可能不在场馆内, 请连接图书馆网络后重试", no_log=True)
-            return False
-        renew_btn.click()
-        if not self.__waitRenewDialog():
-            self._showTrace(f"用户 {username} 续约失败 !", self.TraceLevel.ERROR)
-
-            # After the renewal, the webpage will display a mask overlay,
-            # so we need to refresh the page for subsequent operations.
-            self.__driver.refresh()
-            return False
-        if not self.__selectNearestTime(record, reserve_info):
-            self._showTrace(f"用户 {username} 续约失败 !", self.TraceLevel.ERROR)
-            self.__driver.refresh()
-            return False
-        if self._waitResponseLoad():
-            return True

src/operators/LibReserve.py

@@ -1,693 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Copyright (c) 2025 - 2026 KenanZhu.
-All rights reserved.
-
-This software is provided "as is", without any warranty of any kind.
-You may use, modify, and distribute this file under the terms of the MIT License.
-See the LICENSE file for details.
-"""
-import time
-import queue
-
-from selenium.webdriver.common.by import By
-from selenium.webdriver.chrome.webdriver import WebDriver
-from selenium.webdriver.support.ui import WebDriverWait
-from selenium.webdriver.support import expected_conditions as EC
-
-from base.LibTimeSelector import LibTimeSelector
-
-
-class LibReserve(LibTimeSelector):
-
-    def __init__(
-        self,
-        input_queue: queue.Queue,
-        output_queue: queue.Queue,
-        driver: WebDriver
-    ):
-
-        super().__init__(input_queue, output_queue)
-
-        self.__driver = driver
-        # library floor and room mapping in website
-        self.__floor_map = {
-            "2": "二层",
-            "3": "三层",
-            "4": "四层",
-            "5": "五层"
-        }
-        self.__room_map = {
-            "1": "二层内环",
-            "2": "二层西区",
-            "3": "三层内环",
-            "4": "三层外环",
-            "5": "四层内环",
-            "6": "四层外环",
-            "7": "四层期刊",
-            "8": "五层考研"
-        }
-
-
-    def _waitResponseLoad(
-        self,
-    ) -> bool:
-
-        try:
-            WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_element_located((By.CLASS_NAME, "layoutSeat"))
-            )
-            title_elements = []
-            # reserve failed without title elements, so we need to try
-            try:
-                WebDriverWait(self.__driver, 2).until(
-                    EC.presence_of_element_located((By.CSS_SELECTOR, ".layoutSeat dt"))
-                )
-                title_elements = self.__driver.find_elements(
-                    By.CSS_SELECTOR, ".layoutSeat dt"
-                )
-            except:
-                pass
-            content_elements = self.__driver.find_elements(
-                By.CSS_SELECTOR, ".layoutSeat dd"
-            )
-            if not content_elements:
-                 self._showTrace("未找到预约结果", self.TraceLevel.WARNING)
-                 raise
-            title = title_elements[0].text if title_elements else ""
-            contents = [element.text for element in content_elements if element.text.strip()]
-            for message in contents:
-               if "预约失败" in message or "已有1个有效预约" in message:
-                   self._showTrace(f"预约失败 - {"".join(contents)}", self.TraceLevel.ERROR)
-                   raise
-            if "预定好了" in title or "预约成功" in title or "操作成功" in title:
-                if len(contents) >= 6:
-                    self._showTrace(f"\n"\
-                        f"      预约成功 !\n"\
-                        f"          {contents[1]}\n"\
-                        f"          {contents[2]}\n"\
-                        f"          {contents[3]}\n"\
-                        f"          签到时间 ：{contents[5]}"
-                    )
-                else:
-                    self._showTrace("\n"\
-                        "      预约成功 !\n"\
-                        "          未找获取到详细信息"
-                    )
-            return True
-        except:
-            self._showTrace(f"预约结果加载失败 !", self.TraceLevel.ERROR)
-            return False
-
-
-    def __containRequiredInfo(
-        self,
-        reserve_info: dict
-    ) -> bool:
-
-        try:
-            # must contain the required infomation
-            # key 'place' is no need to check
-            # because 'place' is only has one possible value '1' or '图书馆'
-            if reserve_info.get("floor") is None: # if existence ?
-                raise ValueError("未指定楼层")
-            if reserve_info["floor"] not in self.__floor_map: # if in the mao ?
-                raise ValueError(f"该楼层 '{reserve_info['floor']}' 不存在")
-            if reserve_info.get("room") is None:
-                raise ValueError("未指定房间")
-            if reserve_info["room"] not in self.__room_map:
-                raise ValueError(f"该房间 '{reserve_info['room']}' 不存在")
-            if reserve_info.get("seat_id") is None:
-                raise ValueError("未指定座位")
-            if reserve_info["seat_id"] == "":
-                raise ValueError("未指定座位号")
-            return True
-        except ValueError as e:
-            self._showTrace(
-                f"预约信息错误 ! : {e}, "\
-                f"由于缺少必要的预约信息, 无法开始预约流程",
-                self.TraceLevel.ERROR
-            )
-            self._showTrace(
-                f"预约信息错误 ! : {e}, "\
-                f"由于缺少必要的预约信息, 无法开始预约流程, 请检查预约信息是否完整",
-                no_log=True
-            )
-            return False
-
-
-    def __isValidDate(
-        self,
-        reserve_info: dict
-    ) -> bool:
-
-        cur_date_str = time.strftime("%Y-%m-%d", time.localtime())
-        cur_timestamp = time.mktime(time.strptime(cur_date_str, "%Y-%m-%d"))
-        if reserve_info.get("date") is None:
-            reserve_info["date"] = cur_date_str
-            self._showTrace(f"预约日期未指定, 自动设置为当前日期: {cur_date_str}")
-        else:
-            res_timestamp = time.mktime(time.strptime(reserve_info["date"], "%Y-%m-%d"))
-            if res_timestamp < cur_timestamp:
-                self._showTrace(
-                    f"预约日期错误 ! :"\
-                    f"{reserve_info['date']} 早于当前日期 {cur_date_str}, 自动设置为当前日期",
-                    self.TraceLevel.WARNING
-                )
-                reserve_info["date"] = cur_date_str
-        return True
-
-
-    def __isValidBeginTime(
-        self,
-        reserve_info: dict
-    ) -> bool:
-
-        cur_time = time.strftime("%H:%M", time.localtime())
-        if reserve_info.get("begin_time") is None:
-            reserve_info["begin_time"] = {}
-        if "time" not in reserve_info["begin_time"]:
-            reserve_info["begin_time"]["time"] = cur_time
-            self._showTrace(f"开始时间未指定, 自动设置为当前时间: {cur_time}")
-        if "max_diff" not in reserve_info["begin_time"]:
-            reserve_info["begin_time"]["max_diff"] = 30
-            self._showTrace(f"开始时间最大时间差未指定, 自动设置为 30 分钟")
-        if "prefer_early" not in reserve_info["begin_time"]:
-            reserve_info["begin_time"]["prefer_early"] = True
-            self._showTrace(f"是否优先选择更早开始时间未指定, 自动设置为 True")
-        return True
-
-
-    def __isValidExpectDuration(
-        self,
-        reserve_info: dict
-    ) -> bool:
-
-        if reserve_info.get("satisfy_duration") is None:
-            reserve_info["satisfy_duration"] = True
-            self._showTrace("预约满足时长要求未指定, 默认满足")
-        if reserve_info["satisfy_duration"]:
-            if reserve_info.get("expect_duration") is None:
-                reserve_info["expect_duration"] = 4
-                self._showTrace("需要满足预约持续时间, 但未指定, 使用默认时长为 4 小时")
-        return True
-
-
-    def __isValidEndTime(
-        self,
-        reserve_info: dict
-    ) -> bool:
-
-        if reserve_info.get("end_time") is None:
-            reserve_info["end_time"] = {}
-        if "time" not in reserve_info["end_time"]:
-            # here we add the expect duration to the begin time first,
-            # the edge case that the end time is later than 23:30 will
-            # be handled in __finalCheck. so no need to concern about it.
-            end_mins = self._timeStrToMins(reserve_info["begin_time"]["time"])
-            end_mins = end_mins + int(reserve_info["expect_duration"]*60)
-            reserve_info["end_time"] = {
-                "time": self._minsToTimeStr(end_mins),
-                "max_diff": 30,
-                "prefer_early": False
-            }
-            self._showTrace(
-                f"结束时间未指定, 自动设置为开始时间加上期望时长: {reserve_info['end_time']['time']}"
-            )
-        if "max_diff" not in reserve_info["end_time"]:
-            reserve_info["end_time"]["max_diff"] = 30
-            self._showTrace(f"结束时间最大时间差未指定, 自动设置为 30 分钟")
-        if "prefer_early" not in reserve_info["end_time"]:
-            reserve_info["end_time"]["prefer_early"] = False
-            self._showTrace(f"是否优先选择较晚结束时间未指定, 自动设置为 True")
-        return True
-
-
-    def __finalCheck(
-        self,
-        reserve_info: dict
-    ):
-
-        begin_time, end_time = reserve_info["begin_time"], reserve_info["end_time"]
-        begin_mins = self._timeStrToMins(begin_time["time"])
-        end_mins = self._timeStrToMins(end_time["time"])
-
-        # if end time is earlier than begin_time, exchange them
-        # except that the user has set the satisfy_duration to True
-        if end_mins < begin_mins and reserve_info["satisfy_duration"] is False:
-            self._showTrace(
-                f"结束时间 {end_time['time']} 早于开始时间 {begin_time['time']}, 尝试交换时间",
-                self.TraceLevel.WARNING
-            )
-            reserve_info["end_time"], reserve_info["begin_time"] = begin_time, end_time
-            begin_time, end_time = end_time, begin_time
-            begin_mins = self._timeStrToMins(begin_time["time"])
-            end_mins = self._timeStrToMins(end_time["time"])
-
-        # ensure the end time is not later than 23:30
-        max_end_mins = self._timeStrToMins("23:30")
-        if end_mins > max_end_mins:
-            self._showTrace(
-                f"结束时间 {end_time['time']} 晚于 23:30, 自动设置为 23:30",
-                self.TraceLevel.WARNING
-            )
-            reserve_info["end_time"]["time"] = "23:30"
-            end_mins = max_end_mins
-
-        # ensure the duration is not longer than 8 hours
-        if reserve_info["satisfy_duration"]:
-            if reserve_info["expect_duration"] > 8:
-                self._showTrace(
-                    f"该用户设置了优先满足时长要求, 但是预约期望持续时间 "
-                    f"{reserve_info['expect_duration']} 小时 "
-                    f"超出最大时长 8 小时, 自动设置为 8 小时",
-                    self.TraceLevel.WARNING
-                )
-                reserve_info["expect_duration"] = 8
-        else:
-            if end_mins - begin_mins > 8*60:
-                self._showTrace(
-                    f"该用户未设置优先满足时长要求, 但是检查到预约持续时间 "
-                    f"{float((end_mins - begin_mins)/60)} 小时 "
-                    f"超出最大时长 8 小时, 自动设置为 8 小时",
-                    self.TraceLevel.WARNING
-                )
-                reserve_info["end_time"]["time"] = self._minsToTimeStr(begin_mins + 8*60)
-        return True
-
-
-    def __checkReserveInfo(
-        self,
-        reserve_info: dict
-    ) -> bool:
-
-        if not self.__containRequiredInfo(reserve_info):
-            return False
-        if not self.__isValidDate(reserve_info):
-            return False
-        if not self.__isValidBeginTime(reserve_info):
-            return False
-        if not self.__isValidExpectDuration(reserve_info):
-            return False
-        if not self.__isValidEndTime(reserve_info):
-            return False
-        if not self.__finalCheck(reserve_info):
-            return False
-        self._showTrace(
-            f"预约信息检查完成, 准备预约 "
-            f"{reserve_info['date']} "
-            f"{reserve_info['begin_time']['time']} - "
-            f"{reserve_info['end_time']['time']} "
-            f"图书馆 "
-            f"{self.__floor_map[reserve_info['floor']]} "
-            f"{self.__room_map[reserve_info['room']]} "
-            f"的座位 {reserve_info['seat_id']}"
-        )
-        return True
-
-
-    def __clickElement(
-        self,
-        trigger_locator: tuple,
-        fail_msg: str,
-        success_msg: str,
-        option_locator: tuple = None
-    ) -> bool:
-
-        try:
-            # click the trigger element
-            WebDriverWait(self.__driver, 2).until(
-                EC.element_to_be_clickable(trigger_locator)
-            ).click()
-            if option_locator:
-                # select the option element if specified
-                WebDriverWait(self.__driver, 2).until(
-                    EC.element_to_be_clickable(option_locator)
-                ).click()
-            self._showTrace(success_msg)
-            return True
-        except:
-            self._showTrace(fail_msg)
-            return False
-
-
-    def __clickElementByJS(
-        self,
-        trigger_locator_id: str,
-        option_query_selector: str,
-        fail_msg: str,
-        success_msg: str,
-    ) -> bool:
-
-        script = f"""
-        try {{
-            var trigger = document.getElementById('{trigger_locator_id}');
-            if (trigger) {{
-                trigger.click();
-                var option = document.querySelector("{option_query_selector}");
-                if (option) {{
-                    option.click();
-                    return true;
-                }}
-                return false;
-            }}
-            return false;
-        }} catch (e) {{
-            return false;
-        }}
-        """
-        result = self.__driver.execute_script(script)
-        time.sleep(0.1)
-        if result:
-            self._showTrace(success_msg)
-        else:
-            self._showTrace(fail_msg)
-        return result
-
-
-    def __selectDate(
-        self,
-        date_str: str
-    ) -> bool:
-
-        if self.__clickElementByJS(
-            trigger_locator_id="onDate_select",
-            option_query_selector=f"p#options_onDate a[value='{date_str}']",
-            success_msg=f"日期 {date_str} 选择成功 !",
-            fail_msg=f"选择日期失败 ! : {date_str} 不可用"
-        ):
-            return True
-        return self.__clickElement(
-            trigger_locator=(By.ID, "onDate_select"),
-            option_locator=(By.XPATH, f"//p[@id='options_onDate']/a[@value='{date_str}']"),
-            success_msg=f"日期 {date_str} 选择成功 !",
-            fail_msg=f"选择日期失败 ! : {date_str} 不可用"
-        )
-
-
-    def __selectPlace(
-        self,
-        place: str
-    ) -> bool:
-
-        place = "1" # the library only have this place :)
-        display_place = "图书馆"
-        if self.__clickElementByJS(
-            trigger_locator_id="display_building",
-            option_query_selector=f"p#options_building a[value='{place}']",
-            success_msg=f"预约场所 {display_place} 选择成功 !",
-            fail_msg=f"选择预约场所失败 ! : {display_place} 不可用"
-        ):
-            return True
-        return self.__clickElement(
-            trigger_locator=(By.ID, "display_building"),
-            option_locator=(By.XPATH, f"//p[@id='options_building']/a[@value='{place}']"),
-            success_msg=f"预约场所 {display_place} 选择成功 !",
-            fail_msg=f"选择预约场所失败 ! : {display_place} 不可用"
-        )
-
-
-    def __selectFloor(
-        self,
-        floor: str
-    ) -> bool:
-
-        display_floor = self.__floor_map.get(floor)
-        if self.__clickElementByJS(
-            trigger_locator_id="floor_select",
-            option_query_selector=f"p#options_floor a[value='{floor}']",
-            success_msg=f"楼层 {display_floor} 选择成功 !",
-            fail_msg=f"选择楼层失败 ! : {display_floor} 不可用"
-        ):
-            return True
-        return self.__clickElement(
-            trigger_locator=(By.ID, "floor_select"),
-            option_locator=(By.XPATH, f"//p[@id='options_floor']/a[@value='{floor}']"),
-            success_msg=f"楼层 {display_floor} 选择成功 !",
-            fail_msg=f"选择楼层失败 ! : {display_floor} 不可用"
-        )
-
-
-    def __selectRoom(
-        self,
-        room: str
-    ) -> bool:
-
-        display_room = self.__room_map.get(room)
-        # find room
-        try:
-            WebDriverWait(self.__driver, 2).until(
-                EC.element_to_be_clickable((By.ID, "findRoom"))
-            ).click()
-        except:
-            self._showTrace("加载房间/区域失败 !", self.TraceLevel.ERROR)
-            return False
-        # select room
-        try:
-            WebDriverWait(self.__driver, 2).until(
-                EC.element_to_be_clickable((By.ID, f"room_{room}"))
-            ).click()
-            self._showTrace(f"房间 {display_room} 选择成功 !")
-            return True
-        except:
-            self._showTrace(f"选择房间失败 ! : {display_room} 不可用", self.TraceLevel.ERROR)
-            return False
-
-
-    def __selectSeat(
-        self,
-        seat_id: str
-    ) -> bool:
-
-        try:
-            # wait fot seat layout element to load
-            WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_element_located((By.ID, "seatLayout"))
-            )
-            WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_all_elements_located((By.CSS_SELECTOR, "li[id^='seat_']"))
-            )
-        except:
-            self._showTrace(f"座位加载失败 !", self.TraceLevel.ERROR)
-            return False
-        try:
-            all_seats = self.__driver.find_elements(
-                By.CSS_SELECTOR, "li[id^='seat_']"
-            )
-            seat_id_upper = seat_id.lstrip('0').upper()
-            for seat in all_seats:
-                if not seat_id_upper == seat.text.lstrip('0'):
-                    continue
-                seat_link = seat.find_element(By.TAG_NAME, "a")
-                WebDriverWait(self.__driver, 2).until(
-                    EC.element_to_be_clickable(seat_link)
-                )
-                seat_link.click()
-                seat_status = seat_link.get_attribute("title")
-                self._showTrace(f"座位 {seat_id} 选择成功 ! : 当前状态 - '{seat_status}'")
-                return True
-            self._showLog(f"座位 {seat_id} 在该楼层区域中不存在", self.TraceLevel.WARNING)
-            self._showTrace(f"座位 {seat_id} 在该楼层区域中不存在, 请检查座位号是否正确", no_log=True)
-        except:
-            self._showTrace(f"座位选择失败 !", self.TraceLevel.ERROR)
-            return False
-
-
-    def __selectNearestTime(
-        self,
-        time_id: str,
-        time_type: str,
-        target_time: int,
-        max_time_diff: int = 30,
-        prefer_earlier: bool = True
-    ) -> int:
-
-        """
-            Select the nearest available time option.
-
-            Returns:
-                int: The actual selected time value in minutes.
-        """
-        # Wait for time options to load
-        try:
-            WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_all_elements_located(
-                    (By.CSS_SELECTOR, f"#{time_id} ul li a")
-                )
-            )
-        except:
-            self._showTrace(f"{time_type} 选择失败 ! : 当前未查询到可用时间", self.TraceLevel.ERROR)
-            return -1
-
-        # Find best time option
-        all_time_opts = self.__driver.find_elements(
-            By.CSS_SELECTOR,
-            f"#{time_id} ul li a"
-        )
-        if not all_time_opts:
-            self._showTrace(f"{time_type} 选择失败 ! : 当前未查询到可用时间", self.TraceLevel.ERROR)
-            return -1
-        best_opt, best_text, actual_diff, free_times = self._findBestTimeOption(
-            all_time_opts, target_time, max_time_diff, prefer_earlier, is_reserve=True
-        )
-        if best_opt is not None:
-            best_opt.click()
-            abs_diff = abs(actual_diff)
-            time_relation = self._formatTimeRelation(abs_diff, actual_diff, time_type)
-            target_time += actual_diff
-            self._showTrace(
-                f"选择距离期望 {time_type} 最近的 {best_text}, "
-                f"与期望 {time_type} 相比 {time_relation}"
-            )
-            return target_time
-        self._showTrace(
-            f"无法选择最近的 {time_type} {self._minsToTimeStr(target_time)}, "
-            f"所有可选时间与目标时间相差都超过 {max_time_diff} 分钟", self.TraceLevel.WARNING
-        )
-        self._showTrace(f"当前可供预约的 {time_type} 有: {free_times}")
-        return -1
-
-
-    def __selectSeatTime(
-        self,
-        begin_time: dict,
-        end_time: dict,
-        expect_duration: int = 4,
-        satisfy_duration: bool = True
-    ) -> bool:
-
-        """
-            Select seat begin and end time.
-        """
-        exp_beg_tm_str = begin_time["time"]
-        exp_end_tm_str = end_time["time"]
-        # Initialize actual time strings for logging
-        act_beg_tm_str = exp_beg_tm_str
-        act_end_tm_str = exp_end_tm_str
-        exp_beg_mins = self._timeStrToMins(exp_beg_tm_str)
-        act_beg_mins = exp_beg_mins
-        exp_end_mins = self._timeStrToMins(exp_end_tm_str)
-        act_end_mins = exp_end_mins
-
-        # Select begin time
-        act_beg_mins = self.__selectNearestTime(
-            time_id="startTime",
-            time_type="开始时间",
-            target_time=exp_beg_mins,
-            max_time_diff=begin_time["max_diff"],
-            prefer_earlier=begin_time["prefer_early"]
-        )
-        if act_beg_mins == -1:
-            return False
-        act_beg_tm_str = self._minsToTimeStr(act_beg_mins)
-
-        # If 'satisfy_duration' is True, select end time based on actual begin time
-        if satisfy_duration:
-            exp_end_mins = int(self.validateAndAdjustEndTime(act_beg_mins, expect_duration))
-            exp_end_tm_str = self._minsToTimeStr(exp_end_mins)
-            self._showTrace(
-                f"需要满足期望预约持续时间: {expect_duration} 小时, "
-                f"根据开始时间 {act_beg_tm_str} 计算结束时间: {exp_end_tm_str}"
-            )
-
-        # Select end time
-        act_end_mins = self.__selectNearestTime(
-            time_id="endTime",
-            time_type="结束时间",
-            target_time=exp_end_mins,
-            max_time_diff=end_time["max_diff"],
-            prefer_earlier=end_time["prefer_early"]
-        )
-        if act_end_mins == -1:
-            return False
-        act_end_tm_str = self._minsToTimeStr(act_end_mins)
-        self._showTrace(
-            f"期望预约时间段: {exp_beg_tm_str} - {exp_end_tm_str}, "
-            f"实际预约时间段: {act_beg_tm_str} - {act_end_tm_str}"
-        )
-        return True
-
-
-    def validateAndAdjustEndTime(
-        self,
-        begin_mins: int,
-        duration: int
-    ) -> int:
-
-        """
-            Validate and adjust reserve end time to library closing time if needed.
-        """
-        LIBRARY_CLOSE_TIME = self._timeStrToMins("23:30")
-        expect_end_mins = int(begin_mins + duration*60)
-        if expect_end_mins > LIBRARY_CLOSE_TIME:
-            expect_end_mins = LIBRARY_CLOSE_TIME
-            self._showTrace(
-                f"预约持续时间 {duration} 小时, 超过最大预约时间 23:30, 自动调整为 23:30",
-                self.TraceLevel.WARNING
-            )
-        return expect_end_mins
-
-
-    def reserve(
-        self,
-        username: str,
-        reserve_info: dict
-    ) -> bool:
-
-        submit_reserve = False
-        reserve_success = False
-        have_hover_on_page = False
-
-        # reserve info
-        if not self.__checkReserveInfo(reserve_info):
-            return False
-        # map page
-        try:
-            WebDriverWait(self.__driver, 2).until(
-                EC.element_to_be_clickable((By.XPATH, "//a[@href='/map']"))
-            ).click()
-            WebDriverWait(self.__driver, 2).until(
-                EC.presence_of_element_located((By.ID, "seatLayout"))
-            )
-        except:
-            self._showTrace(f"加载预约选座页面失败 !", self.TraceLevel.ERROR)
-            return False
-        # date, place, floor, room
-        if not self.__selectDate(reserve_info["date"]):
-            return False
-        if not self.__selectPlace(reserve_info["place"]):
-            return False
-        if not self.__selectFloor(reserve_info["floor"]):
-            return False
-        if not self.__selectRoom(reserve_info["room"]):
-            return False
-        else:
-            have_hover_on_page = True
-        # seat selections
-        if not self.__selectSeat(reserve_info["seat_id"]):
-            pass
-        elif not self.__selectSeatTime(
-            begin_time=reserve_info["begin_time"],
-            end_time=reserve_info["end_time"],
-            expect_duration=reserve_info["expect_duration"],
-            satisfy_duration=reserve_info["satisfy_duration"]
-        ):
-            pass
-        else:
-            try:
-                WebDriverWait(self.__driver, 2).until(
-                    EC.element_to_be_clickable((By.ID, "reserveBtn"))
-                ).click()
-                submit_reserve = True
-                if not self._waitResponseLoad():
-                    raise
-                reserve_success = True
-            except:
-                self._showTrace(f"预约提交失败 !", self.TraceLevel.ERROR)
-        if not submit_reserve and have_hover_on_page:
-            self.__driver.refresh()
-        if reserve_success:
-            self._showTrace(f"用户 {username} 预约成功 !")
-        else:
-            self._showTrace(f"用户 {username} 预约失败 !", self.TraceLevel.ERROR)
-        return reserve_success

src/operators/__init__.py

@@ -1,13 +0,0 @@
-"""
-    Operators module for the AutoLibrary project.
-
-    Here are the classes and modules in this package:
-    - AutoLib: AutoLibrary operator.
-    - LibLogin: Library operator for logging in.
-    - LibLogout: Library operator for logging out.
-    - LibReserve: Library operator for reserving seat.
-    - LibCheckin: Library operator for checking in seat.
-    - LibCheckout: Library operator for checking out seat.
-    - LibChecker: Library operator for checking record status.
-    - LibRenew: Library operator for renewing seat.
-"""

src/pages/AutoLib.py

@@ -0,0 +1,396 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2025 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+import os
+import queue
+from selenium import webdriver
+from selenium.webdriver.remote.webdriver import WebDriver
+from selenium.common.exceptions import (
+    TimeoutException,
+    WebDriverException,
+)
+from selenium.webdriver.edge.service import Service as EdgeService
+from selenium.webdriver.chrome.service import Service as ChromeService
+from selenium.webdriver.firefox.service import Service as FirefoxService
+
+from base.MsgBase import MsgBase
+from pages.LoginPage import LoginPage
+from pages.MainShell import MainShell
+from pages.flows.ReserveFlow import ReserveFlow, ReserveContext
+from pages.flows.CheckinFlow import CheckinFlow
+from pages.flows.RenewFlow import RenewFlow
+from pages.services.CaptchaSolver import CaptchaSolver
+from pages.services.ReserveChecker import ReserveChecker
+from pages.services.RecordChecker import RecordChecker
+
+
+class AutoLib(MsgBase):
+
+    def __init__(
+        self,
+        input_queue: queue.Queue,
+        output_queue: queue.Queue,
+        run_config: dict,
+    ) -> None:
+
+        super().__init__(input_queue, output_queue)
+        self.__run_config: dict = run_config
+        self.__user_config: dict | None = None
+        self.__driver: WebDriver | None = None
+        self.__driver_type: str = ""
+        self.__driver_path: str = ""
+        self.__login_page: LoginPage = None
+        self.__shell: MainShell = None
+        self.__captcha_solver: CaptchaSolver = None
+        self.__record_checker: RecordChecker = None
+        self.__reserve_checker: ReserveChecker = None
+        self.__reserve_flow: ReserveFlow = None
+        self.__checkin_flow: CheckinFlow = None
+        self.__renew_flow: RenewFlow = None
+
+        if not self.__initBrowserDriver():
+            raise Exception("浏览器驱动初始化失败 !")
+        else:
+            if not self.__initDriverUrl():
+                self.close()
+                raise Exception("浏览器驱动 URL 初始化失败 !")
+            self.__initPagesServices()
+            self.__initPagesFlows()
+
+    def __initBrowserDriver(
+        self,
+    ) -> bool:
+
+        self._showTrace("正在初始化浏览器驱动......", no_log=True)
+        driver_config: dict = self.__run_config.get("web_driver", None)
+        self.__driver_type = driver_config.get("driver_type", "none")
+        self.__driver_type = self.__driver_type.lower()
+        match self.__driver_type:
+            case "edge":
+                driver_options = webdriver.EdgeOptions()
+            case "chrome":
+                driver_options = webdriver.ChromeOptions()
+            case "firefox":
+                driver_options = webdriver.FirefoxOptions()
+            case _:
+                self._showTrace(
+                    f"不支持的浏览器驱动类型: {self.__driver_type} !",
+                    self.TraceLevel.WARNING,
+                )
+                return False
+        if not driver_config:
+            self._showTrace("未配置浏览器驱动参数 !", self.TraceLevel.ERROR)
+            return False
+        if driver_config.get("headless", False):
+            driver_options.add_argument("--headless")
+            driver_options.add_argument("--disable-gpu")
+            driver_options.add_argument("--no-sandbox")
+            driver_options.add_argument("--disable-dev-shm-usage")
+
+        # must be 1920x1080, otherwise the page will cause some elements not accessible
+        driver_options.add_argument("--window-size=1920,1080")
+
+        # omit ssl errors and verbose log level
+        driver_options.add_argument("--ignore-certificate-errors")
+        driver_options.add_argument("--ignore-ssl-errors")
+        driver_options.add_argument("--log-level=OFF")
+        driver_options.add_argument("--silent")
+
+        # set options for chrome and edge
+        if self.__driver_type.lower() in ["edge", "chrome"]:
+            driver_options.add_argument("--remote-allow-origins=*")
+            driver_options.add_experimental_option("excludeSwitches", ["enable-automation"])
+            driver_options.add_experimental_option("useAutomationExtension", False)
+            driver_options.add_argument("--disable-blink-features=AutomationControlled")
+            user_agent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "\
+                         "AppleWebKit/537.36 (KHTML, like Gecko) "\
+                         "Chrome/120.0.0.0 "\
+                         "Safari/537.36"
+            if self.__driver_type == "edge":
+                user_agent += " Edg/120.0.0.0"
+
+        # set options for firefox
+        elif self.__driver_type == "firefox":
+            driver_options.set_preference("dom.webdriver.enabled", False)
+            driver_options.set_preference("useAutomationExtension", False)
+            user_agent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:120.0) "\
+                         "Gecko/20100101 Firefox/120.0"
+        driver_options.add_argument(f"user-agent={user_agent}")
+
+        # init browser driver
+        self.__driver_path = driver_config.get("driver_path", "")
+        if not self.__driver_path:
+            self._showTrace("未配置浏览器驱动路径 !", self.TraceLevel.WARNING)
+            return False
+        try:
+            self.__driver_path = os.path.abspath(self.__driver_path)
+            service = None
+            match self.__driver_type:
+                case "edge":
+                    service = EdgeService(executable_path=self.__driver_path)
+                    self.__driver = webdriver.Edge(service=service, options=driver_options)
+                case "chrome":
+                    service = ChromeService(executable_path=self.__driver_path)
+                    self.__driver = webdriver.Chrome(service=service, options=driver_options)
+                case "firefox":
+                    self._showTrace("Firefox 浏览器驱动初始化略慢, 请耐心等待...", no_log=True)
+                    service = FirefoxService(executable_path=self.__driver_path)
+                    self.__driver = webdriver.Firefox(service=service, options=driver_options)
+                case _:
+                    raise Exception(f"不支持的浏览器驱动类型: {self.__driver_type} !")
+            self.__driver.implicitly_wait(1)
+            self.__driver.execute_script(
+                "Object.defineProperty(navigator, 'webdriver', {get: () => undefined})"
+            )
+        except WebDriverException as e:
+            self._showTrace(f"浏览器驱动初始化失败: {e}", self.TraceLevel.ERROR)
+            return False
+        self._showTrace(f"浏览器驱动已初始化, 类型: {self.__driver_type}, 路径: {self.__driver_path}")
+        return True
+
+    def __initDriverUrl(
+        self,
+    ) -> bool:
+
+        lib_config: dict = self.__run_config.get("library", None)
+        if not lib_config:
+            self._showTrace("未配置图书馆参数 !", self.TraceLevel.ERROR)
+            return False
+        url: str = lib_config.get("host_url") + lib_config.get("login_url")
+        self.__login_page = LoginPage(self._input_queue, self._output_queue, self.__driver)
+        self.__driver.set_page_load_timeout(5)
+        try:
+            self.__driver.get(url)
+        except TimeoutException:
+            self.__login_page.stopPageLoad()
+            self._showTrace(
+                "图书馆登录页面加载超时 ! 请检查网络环境是否正常", self.TraceLevel.ERROR
+            )
+            return False
+        except WebDriverException as e:
+            self._showTrace(f"图书馆页面加载失败: {e}", self.TraceLevel.ERROR)
+            return False
+        if not self.__login_page.waitUntilLoaded():
+            return False
+        return True
+
+    def __initPagesServices(
+        self,
+    ) -> None:
+
+        if not self.__driver:
+            self._showTrace("浏览器驱动未初始化, 请先初始化浏览器驱动 !", self.TraceLevel.WARNING)
+            return
+        self.__shell = MainShell(self.__driver)
+        self.__captcha_solver = CaptchaSolver(
+            input_queue=self._input_queue,
+            output_queue=self._output_queue,
+        )
+        self.__record_checker = RecordChecker(
+            input_queue=self._input_queue,
+            output_queue=self._output_queue,
+        )
+        self.__reserve_checker = ReserveChecker(
+            input_queue=self._input_queue,
+            output_queue=self._output_queue,
+        )
+
+    def __initPagesFlows(
+        self,
+    ) -> None:
+
+        self.__reserve_flow = ReserveFlow(
+            input_queue=self._input_queue,
+            output_queue=self._output_queue,
+            driver=self.__driver,
+            shell=self.__shell,
+        )
+        self.__checkin_flow = CheckinFlow(
+            input_queue=self._input_queue,
+            output_queue=self._output_queue,
+            driver=self.__driver,
+            shell=self.__shell,
+        )
+        self.__renew_flow = RenewFlow(
+            input_queue=self._input_queue,
+            output_queue=self._output_queue,
+            driver=self.__driver,
+            shell=self.__shell,
+        )
+
+    def __run(
+        self,
+        username: str,
+        password: str,
+        login_config: dict,
+        run_mode_config: dict,
+        reserve_info: dict,
+    ) -> int:
+
+        # result : -1 - terminate, 0 - success, 1 - failed, 2 - passed
+        result: int = 2
+
+        # login
+        auto_captcha: bool = login_config.get("auto_captcha", True)
+        if not self.__login_page.login(
+            username,
+            password,
+            captcha_solver=self.__captcha_solver.solveCaptcha,
+            auto_captcha=auto_captcha,
+            max_attempts=login_config.get("max_attempt", 3),
+        ):
+            return 1
+        run_mode_raw: int = run_mode_config.get("run_mode", 0)
+        run_mode: dict[str, bool] = {
+            "auto_reserve": run_mode_raw & 0x1,
+            "auto_checkin": run_mode_raw & 0x2,
+            "auto_renewal": run_mode_raw & 0x4,
+        }
+
+        # reserve
+        if run_mode["auto_reserve"]:
+            if self.__reserve_checker.check(reserve_info):
+                if self.__record_checker.canReserve(self.__shell, reserve_info["date"]):
+                    ctx = ReserveContext(
+                        username=username,
+                        date=reserve_info["date"],
+                        floor=reserve_info["floor"],
+                        room=reserve_info["room"],
+                        seat_id=reserve_info["seat_id"],
+                        begin_time=reserve_info["begin_time"]["time"],
+                        end_time=reserve_info["end_time"]["time"],
+                        begin_max_diff=reserve_info["begin_time"]["max_diff"],
+                        end_max_diff=reserve_info["end_time"]["max_diff"],
+                        begin_prefer_early=reserve_info["begin_time"]["prefer_early"],
+                        end_prefer_early=reserve_info["end_time"]["prefer_early"],
+                        expect_duration=reserve_info["expect_duration"],
+                        satisfy_duration=reserve_info["satisfy_duration"],
+                    )
+                    if self.__reserve_flow.execute(ctx):
+                        result = 0
+                    else:
+                        result = 1
+                else:
+                    self._showTrace(f"用户 {username} 无法预约, 已跳过")
+                    result = 2
+            else:
+                result = 1
+
+        # checkin
+        last_result: int = result
+        if run_mode["auto_checkin"] and last_result != 1:
+            if self.__record_checker.canCheckin(self.__shell):
+                if self.__checkin_flow.execute(username):
+                    result = 0
+                else:
+                    result = 1
+            else:
+                self._showTrace(f"用户 {username} 无法签到, 已跳过")
+                result = 2
+        if last_result == 0:  # partly success
+            result = 0
+
+        # renewal
+        last_result = result
+        if run_mode["auto_renewal"] and last_result != 1:
+            can_renew, record = self.__record_checker.canRenew(self.__shell)
+            if can_renew:
+                renew_info: dict = reserve_info.get("renew_time", {})
+                if self.__renew_flow.execute(username, record, renew_info):
+                    if self.__record_checker.postRenewCheck(self.__shell, record):
+                        self._showTrace(f"用户 {username} 续约成功 !")
+                        result = 0
+                    else:
+                        if result != 1:  # partly success
+                            result = 0
+                        else:
+                            result = 1
+                else:
+                    result = 1
+            else:
+                self._showTrace(f"用户 {username} 无法续约, 已跳过")
+                result = 2
+        if last_result == 0:  # partly success
+            result = 0
+
+        # logout
+        if not self.__shell.logout():
+            self._showTrace(f"用户 {username} 退出登录失败, 尝试直接重载页面")
+            if not self.__initDriverUrl():
+                self._showTrace(f"用户 {username} 重载页面失败, 无法继续操作, 该任务已终止 !")
+                return -1
+        self._showTrace(f"用户 {username} 已退出登录")
+        return result
+
+    def run(
+        self,
+        user_config: dict,
+    ) -> None:
+
+        self.__user_config = user_config
+        user_counter: dict[str, int] = {"current": 0, "success": 0, "failed": 0, "passed": 0}
+        users: list = self.__user_config.get("users", [])
+        self._showTrace(f"共发现 {len(users)} 个用户")
+        for user in users:
+            user_counter["current"] += 1
+            self._showTrace(
+                f"正在处理第 {user_counter["current"]}/{len(users)} 个用户: {user.get("username", "未知")}......",
+                no_log=True,
+            )
+            if not user.get("enabled", False):
+                self._showTrace(f"用户 {user.get("username", "未知")} 已跳过")
+                user_counter["passed"] += 1
+                continue
+            r: int = self.__run(
+                username=user.get("username", ""),
+                password=user.get("password", ""),
+                login_config=self.__run_config.get("login", {}),
+                run_mode_config=self.__run_config.get("mode", {}),
+                reserve_info=user.get("reserve_info", {}),
+            )
+            if r == -1:
+                self._showTrace(
+                    f"用户 {user.get("username", "未知")} 处理过程中页面发生异常, 无法继续操作, 任务已终止 !",
+                    self.TraceLevel.WARNING,
+                )
+                break
+            elif r == 0:
+                user_counter["success"] += 1
+            elif r == 1:
+                user_counter["failed"] += 1
+            elif r == 2:
+                user_counter["passed"] += 1
+        self._showTrace(
+            f"处理完成, 共计 {user_counter["current"]} 个用户, "
+            f"成功 {user_counter["success"]} 个用户, "
+            f"失败 {user_counter["failed"]} 个用户, "
+            f"跳过 {user_counter["passed"]} 个用户"
+        )
+        return
+
+    def close(
+        self,
+    ) -> bool:
+
+        if self.__driver:
+            if self.__driver_type.lower() == "firefox":
+                self._showTrace(
+                    "Firefox 浏览器驱动关闭略慢, 请耐心等待...",
+                    no_log=True,
+                )
+            try:
+                self.__driver.quit()
+            except WebDriverException as e:
+                self._showTrace(f"浏览器驱动关闭时发生异常: {e}", self.TraceLevel.WARNING)
+            self.__driver = None
+            self._showTrace("浏览器驱动已关闭")
+            return True
+        else:
+            self._showTrace("浏览器驱动未初始化, 无需关闭", no_log=True)
+            return False

src/pages/LoginPage.py

@@ -0,0 +1,205 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+import queue
+from typing import Callable
+
+from selenium.common.exceptions import (
+    ElementNotInteractableException,
+    NoSuchElementException,
+    TimeoutException,
+)
+from selenium.webdriver.common.by import By
+from selenium.webdriver.remote.webdriver import WebDriver
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+
+from base.MsgBase import MsgBase
+
+
+class LoginPage(MsgBase):
+
+    USERNAME_INPUT   = (By.NAME, "username")
+    PASSWORD_INPUT   = (By.NAME, "password")
+    CAPTCHA_INPUT    = (By.NAME, "answer")
+    CAPTCHA_IMG      = (By.ID,   "loadImgId")
+    LOGIN_BUTTON     = (By.XPATH, "//input[@type='button' and @value='登录']")
+
+    SUCCESS_INDICATOR_SEARCH  = (By.ID,        "search")
+    SUCCESS_INDICATOR_CONTENT = (By.CLASS_NAME, "selectContent")
+    SUCCESS_TITLE_KEYWORD     = "自选座位 :: 座位预约系统"
+
+    PAGE_LOAD_TIMEOUT = 5
+
+    def __init__(
+        self,
+        input_queue: queue.Queue,
+        output_queue: queue.Queue,
+        driver: WebDriver,
+    ) -> None:
+
+        super().__init__(input_queue, output_queue)
+        self._driver: WebDriver = driver
+
+    def navigate(
+        self,
+        url: str,
+    ) -> bool:
+
+        self._driver.set_page_load_timeout(self.PAGE_LOAD_TIMEOUT)
+        self._driver.get(url)
+        if not self.waitUntilLoaded():
+            return False
+        return True
+
+    def waitUntilLoaded(
+        self,
+    ) -> bool:
+
+        try:
+            WebDriverWait(self._driver, 2).until(
+                EC.title_contains("首页")
+            )
+            WebDriverWait(self._driver, 2).until(
+                EC.presence_of_element_located(self.USERNAME_INPUT)
+            )
+            WebDriverWait(self._driver, 2).until(
+                EC.presence_of_element_located(self.PASSWORD_INPUT)
+            )
+            WebDriverWait(self._driver, 2).until(
+                EC.presence_of_element_located(self.CAPTCHA_INPUT)
+            )
+            WebDriverWait(self._driver, 2).until(
+                EC.presence_of_element_located(self.CAPTCHA_IMG)
+            )
+            return True
+        except TimeoutException:
+            return False
+
+    def fillCredentials(
+        self,
+        username: str,
+        password: str,
+    ) -> bool:
+
+        try:
+            el = self._driver.find_element(*self.USERNAME_INPUT)
+            el.clear()
+            el.send_keys(username)
+            el = self._driver.find_element(*self.PASSWORD_INPUT)
+            el.clear()
+            el.send_keys(password)
+            return True
+        except (NoSuchElementException, ElementNotInteractableException):
+            return False
+
+    def getCaptchaImageSrc(
+        self,
+    ) -> str | None:
+
+        # return 'None' if captcha image element is not found.
+        # But the 'get_attribute("src")' also return 'None' if there's no attribute with
+        # that name, which is not what we want.
+        try:
+            captcha_el = self._driver.find_element(*self.CAPTCHA_IMG)
+            return captcha_el.get_attribute("src")
+        except NoSuchElementException:
+            return None
+
+    def refreshCaptcha(
+        self,
+    ) -> bool:
+
+        try:
+            self._driver.find_element(*self.CAPTCHA_IMG).click()
+            return True
+        except (NoSuchElementException, ElementNotInteractableException):
+            return False
+
+    def fillCaptcha(
+        self,
+        captcha_text: str,
+    ) -> bool:
+
+        try:
+            el = self._driver.find_element(*self.CAPTCHA_INPUT)
+            el.clear()
+            el.send_keys(captcha_text)
+            return True
+        except (NoSuchElementException, ElementNotInteractableException):
+            return False
+
+    def clickLogin(
+        self,
+    ) -> bool:
+
+        try:
+            self._driver.find_element(*self.LOGIN_BUTTON).click()
+            return True
+        except (NoSuchElementException, ElementNotInteractableException):
+            return False
+
+    def waitLoginSuccess(
+        self,
+    ) -> bool:
+
+        try:
+            WebDriverWait(self._driver, 2).until(
+                EC.title_contains(self.SUCCESS_TITLE_KEYWORD)
+            )
+            WebDriverWait(self._driver, 2).until(
+                EC.presence_of_element_located(self.SUCCESS_INDICATOR_SEARCH)
+            )
+            WebDriverWait(self._driver, 2).until(
+                EC.presence_of_element_located(self.SUCCESS_INDICATOR_CONTENT)
+            )
+            return True
+        except TimeoutException:
+            return False
+
+    def stopPageLoad(
+        self,
+    ) -> None:
+
+        self._driver.execute_script("window.stop();")
+
+    def login(
+        self,
+        username: str,
+        password: str,
+        captcha_solver: Callable[["LoginPage", bool], str],
+        auto_captcha: bool,
+        max_attempts: int = 5,
+    ) -> bool:
+
+        for attempt in range(max_attempts):
+            self._showTrace(
+                f"用户 {username} 第 {attempt + 1} 次尝试登录......",
+                no_log=True,
+            )
+            if not self.fillCredentials(username, password):
+                continue
+            captcha_text = captcha_solver(self, auto_captcha)
+            if not captcha_text:
+                continue
+            if not self.fillCaptcha(captcha_text):
+                continue
+            self._showTrace("尝试登录...", no_log=True)
+            if not self.clickLogin():
+                continue
+            if self.waitLoginSuccess():
+                self._showTrace(f"用户 {username} 第 {attempt + 1} 次登录成功 !")
+                return True
+            else:
+                self._showTrace(
+                    "登录页面加载失败 ! : "
+                    "用户账号或者密码错误/验证码错误, 具体以页面提示为准",
+                    level=self.TraceLevel.ERROR,
+                )
+        return False

src/pages/MainShell.py

@@ -0,0 +1,177 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+import time
+
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.remote.webdriver import WebDriver
+from selenium.common.exceptions import (
+    ElementNotInteractableException,
+    NoSuchElementException,
+    TimeoutException,
+    WebDriverException,
+)
+
+from pages.ReserveView import ReserveView
+from pages.RecordsView import RecordsView
+
+
+class MainShell:
+
+    TAB_RESERVE  = (By.XPATH, "//a[@href='/map']")
+    TAB_HISTORY  = (By.XPATH, "//a[@href='/history?type=SEAT']")
+    TAB_LOGOUT   = (By.XPATH, "//a[@href='/logout']")
+
+    BTN_CHECKIN  = (By.ID, "btnCheckIn")
+    BTN_EXTEND   = (By.ID, "btnExtend")
+
+    def __init__(
+        self,
+        driver: WebDriver,
+    ) -> None:
+
+        self._driver = driver
+
+    def _clickTab(
+        self,
+        locator: tuple,
+    ) -> None:
+
+        WebDriverWait(self._driver, 2).until(
+            EC.element_to_be_clickable(locator)
+        ).click()
+
+    def gotoReserveView(
+        self,
+    ) -> ReserveView:
+
+        self._clickTab(self.TAB_RESERVE)
+        WebDriverWait(self._driver, 2).until(
+            EC.presence_of_element_located((By.ID, "seatLayout"))
+        )
+        return ReserveView(self._driver)
+
+    def gotoRecordsView(
+        self,
+    ) -> RecordsView:
+
+        self._clickTab(self.TAB_HISTORY)
+        WebDriverWait(self._driver, 2).until(
+            EC.presence_of_element_located((By.CLASS_NAME, "myReserveList"))
+        )
+        return RecordsView(self._driver)
+
+    def logout(
+        self,
+    ) -> bool:
+
+        try:
+            self._driver.find_element(*self.TAB_LOGOUT).click()
+            return True
+        except (NoSuchElementException, ElementNotInteractableException):
+            return False
+
+    def waitCheckinButton(
+        self,
+    ) -> bool:
+
+        try:
+            WebDriverWait(self._driver, 2).until(
+                EC.element_to_be_clickable(self.BTN_CHECKIN)
+            )
+            return True
+        except TimeoutException:
+            return False
+
+    def waitExtendButton(
+        self,
+    ) -> bool:
+
+        try:
+            WebDriverWait(self._driver, 2).until(
+                EC.element_to_be_clickable(self.BTN_EXTEND)
+            )
+            return True
+        except TimeoutException:
+            return False
+
+    def isCheckinButtonDisabled(
+        self,
+    ) -> bool:
+
+        try:
+            btn = self._driver.find_element(*self.BTN_CHECKIN)
+            return "disabled" in btn.get_attribute("class")
+        except NoSuchElementException:
+            return True
+
+    def isExtendButtonDisabled(
+        self,
+    ) -> bool:
+
+        try:
+            btn = self._driver.find_element(*self.BTN_EXTEND)
+            return "disabled" in btn.get_attribute("class")
+        except NoSuchElementException:
+            return True
+
+    def clickCheckinButton(
+        self,
+    ) -> None:
+
+        try:
+            btn = WebDriverWait(self._driver, 2).until(
+                EC.element_to_be_clickable(self.BTN_CHECKIN)
+            )
+            btn.click()
+        except (TimeoutException, ElementNotInteractableException):
+            return
+
+    def clickExtendButton(
+        self,
+    ) -> None:
+
+        try:
+            btn = WebDriverWait(self._driver, 2).until(
+                EC.element_to_be_clickable(self.BTN_EXTEND)
+            )
+            btn.click()
+        except (TimeoutException, ElementNotInteractableException):
+            return
+
+    def enableCheckinButtonByJS(
+        self,
+    ) -> bool:
+
+        script = """
+        try {
+            var checkin_btn = document.getElementById('btnCheckIn');
+            if (checkin_btn) {
+                checkin_btn.classList.remove('disabled');
+                return true;
+            }
+            return false;
+        } catch (e) {
+            return false;
+        }
+        """
+        result = self._driver.execute_script(script)
+        time.sleep(0.1)
+        return result
+
+    def refresh(
+        self,
+    ) -> None:
+
+        try:
+            self._driver.refresh()
+        except (TimeoutException, WebDriverException):
+            return

src/pages/RecordsView.py

@@ -0,0 +1,87 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.remote.webdriver import WebDriver
+from selenium.webdriver.remote.webelement import WebElement
+from selenium.common.exceptions import (
+    NoSuchElementException,
+    StaleElementReferenceException,
+    TimeoutException,
+)
+
+
+class RecordsView:
+
+    RECORDS_LIST = (By.CSS_SELECTOR, ".myReserveList > dl:not(#moreBlock)")
+    MORE_BTN     = (By.ID, "moreBtn")
+    RECORD_TIME  = (By.CSS_SELECTOR, "dt")
+    RECORD_INFO  = (By.CSS_SELECTOR, "a")
+
+    def __init__(
+        self,
+        driver: WebDriver,
+    ) -> None:
+
+        self._driver = driver
+
+    def loadRecords(
+        self,
+    ) -> list | None:
+
+        try:
+            WebDriverWait(self._driver, 2).until(
+                EC.presence_of_element_located(self.RECORDS_LIST)
+            )
+            return self._driver.find_elements(*self.RECORDS_LIST)
+        except TimeoutException:
+            return None
+
+    def getRecordTimeElement(
+        self,
+        record: WebElement,
+    ) -> WebElement:
+
+        return record.find_element(*self.RECORD_TIME)
+
+    def getRecordInfoElements(
+        self,
+        record: WebElement,
+    ) -> list[WebElement]:
+
+        return record.find_elements(*self.RECORD_INFO)
+
+    def showMoreRecords(
+        self,
+    ) -> bool:
+
+        try:
+            WebDriverWait(self._driver, 2).until(
+                EC.element_to_be_clickable(self.MORE_BTN)
+            )
+        except TimeoutException:
+            return False
+        try:
+            more_btn = self._driver.find_element(*self.MORE_BTN)
+            if more_btn.is_displayed() and more_btn.is_enabled():
+                self._driver.execute_script("arguments[0].scrollIntoView(true);", more_btn)
+                self._driver.execute_script("arguments[0].click();", more_btn)
+                return True
+            return False
+        except (NoSuchElementException, StaleElementReferenceException):
+            return False
+
+    def getRecordText(
+        self,
+        record: WebElement,
+    ) -> str:
+
+        return record.text.strip()

src/pages/ReserveView.py

@@ -0,0 +1,186 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+import time
+
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+from selenium.webdriver.remote.webdriver import WebDriver
+from selenium.common.exceptions import (
+    ElementNotInteractableException,
+    TimeoutException,
+)
+
+from pages.components.SeatMapDialog import SeatMapDialog
+
+
+class ReserveView:
+
+    DATE_SELECT     = (By.ID, "onDate_select")
+    DATE_OPTION_FMT = "p#options_onDate a[value='{value}']"
+    DATE_XPATH_FMT  = "//p[@id='options_onDate']/a[@value='{value}']"
+
+    PLACE_SELECT     = (By.ID, "display_building")
+    PLACE_OPTION_FMT = "p#options_building a[value='{value}']"
+    PLACE_XPATH_FMT  = "//p[@id='options_building']/a[@value='{value}']"
+
+    FLOOR_SELECT     = (By.ID, "floor_select")
+    FLOOR_OPTION_FMT = "p#options_floor a[value='{value}']"
+    FLOOR_XPATH_FMT  = "//p[@id='options_floor']/a[@value='{value}']"
+
+    FIND_ROOM_BTN = (By.ID, "findRoom")
+    ROOM_BTN_FMT  = "room_{room}"
+
+    RESERVE_BTN    = (By.ID, "reserveBtn")
+
+    FLOOR_MAP = {"2": "二层", "3": "三层", "4": "四层", "5": "五层"}
+    ROOM_MAP = {
+        "1": "二层内环", "2": "二层西区", "3": "三层内环", "4": "三层外环",
+        "5": "四层内环", "6": "四层外环", "7": "四层期刊", "8": "五层考研",
+    }
+
+    def __init__(
+        self,
+        driver: WebDriver,
+    ) -> None:
+
+        self._driver = driver
+
+    def _clickOptionByJS(
+        self,
+        trigger_id: str,
+        option_css: str,
+    ) -> bool:
+
+        script = f"""
+        try {{
+            var trigger = document.getElementById('{trigger_id}');
+            if (trigger) {{
+                trigger.click();
+                var option = document.querySelector("{option_css}");
+                if (option) {{
+                    option.click();
+                    return true;
+                }}
+                return false;
+            }}
+            return false;
+        }} catch (e) {{
+            return false;
+        }}
+        """
+        result = self._driver.execute_script(script)
+        time.sleep(0.1)
+        return result
+
+    def _clickOption(
+        self,
+        trigger: tuple,
+        option: tuple,
+    ) -> bool:
+
+        try:
+            WebDriverWait(self._driver, 2).until(
+                EC.element_to_be_clickable(trigger)
+            ).click()
+            WebDriverWait(self._driver, 2).until(
+                EC.element_to_be_clickable(option)
+            ).click()
+            return True
+        except (TimeoutException, ElementNotInteractableException):
+            return False
+
+    def selectDate(
+        self,
+        date_str: str,
+    ) -> bool:
+
+        if self._clickOptionByJS(
+            trigger_id="onDate_select",
+            option_css=self.DATE_OPTION_FMT.format(value=date_str),
+        ):
+            return True
+        return self._clickOption(
+            trigger=self.DATE_SELECT,
+            option=(By.XPATH, self.DATE_XPATH_FMT.format(value=date_str)),
+        )
+
+    def selectPlace(
+        self,
+        place: str = "1",
+    ) -> bool:
+
+        if self._clickOptionByJS(
+            trigger_id="display_building",
+            option_css=self.PLACE_OPTION_FMT.format(value=place),
+        ):
+            return True
+        return self._clickOption(
+            trigger=self.PLACE_SELECT,
+            option=(By.XPATH, self.PLACE_XPATH_FMT.format(value=place)),
+        )
+
+    def selectFloor(
+        self,
+        floor: str,
+    ) -> bool:
+
+        if self._clickOptionByJS(
+            trigger_id="floor_select",
+            option_css=self.FLOOR_OPTION_FMT.format(value=floor),
+        ):
+            return True
+        return self._clickOption(
+            trigger=self.FLOOR_SELECT,
+            option=(By.XPATH, self.FLOOR_XPATH_FMT.format(value=floor)),
+        )
+
+    def selectRoom(
+        self,
+        room: str,
+    ) -> SeatMapDialog | None:
+
+        try:
+            WebDriverWait(self._driver, 2).until(
+                EC.element_to_be_clickable(self.FIND_ROOM_BTN)
+            ).click()
+        except (TimeoutException, ElementNotInteractableException):
+            return None
+        try:
+            WebDriverWait(self._driver, 2).until(
+                EC.element_to_be_clickable((By.ID, self.ROOM_BTN_FMT.format(room=room)))
+            ).click()
+        except (TimeoutException, ElementNotInteractableException):
+            return None
+        try:
+            return SeatMapDialog(self._driver)
+        except TimeoutException:
+            return None
+
+    def submitReserve(
+        self,
+    ) -> bool:
+
+        try:
+            WebDriverWait(self._driver, 2).until(
+                EC.element_to_be_clickable(self.RESERVE_BTN)
+            ).click()
+            return True
+        except (TimeoutException, ElementNotInteractableException):
+            return False
+
+    def refresh(
+        self,
+    ) -> None:
+
+        try:
+            self._driver.refresh()
+        except TimeoutException:
+            return

src/pages/__init__.py

@@ -0,0 +1,19 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from .AutoLib import AutoLib
+from .LoginPage import LoginPage
+from .MainShell import MainShell
+from .ReserveView import ReserveView
+from .RecordsView import RecordsView
+from .components.SeatMapDialog import SeatMapDialog
+from .components.TimeSelectDialog import TimeSelectDialog
+from .components.ReserveResultDialog import ReserveResultDialog
+from .components.CheckinResultDialog import CheckinResultDialog
+from .components.RenewDialog import RenewDialog

src/pages/components/CheckinResultDialog.py

@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from selenium.common.exceptions import (
+    ElementNotInteractableException,
+    NoSuchElementException,
+    StaleElementReferenceException,
+    TimeoutException,
+)
+from selenium.webdriver.common.by import By
+from selenium.webdriver.remote.webdriver import WebDriver
+
+from pages.components.Dialog import Dialog
+
+
+class CheckinResultDialog(Dialog):
+    """
+        Check-in result dialog.
+    """
+
+    ROOT = (By.CLASS_NAME, "ui_dialog")
+
+    RESULT_MSG = (By.CLASS_NAME, "resultMessage")
+    OK_BTN     = (By.CLASS_NAME, "btnOK")
+    DETAIL_DD  = (By.CSS_SELECTOR, ".resultMessage dd")
+
+    def __init__(
+        self,
+        driver: WebDriver,
+    ) -> None:
+
+        super().__init__(driver, self.ROOT, auto_close_on_exit=False)
+
+    def getResultMessage(
+        self,
+    ) -> str:
+
+        try:
+            self._waitPresence(self.RESULT_MSG)
+            el = self._find(*self.RESULT_MSG)
+            return el.text
+        except (TimeoutException, NoSuchElementException,
+                StaleElementReferenceException):
+            return ""
+
+    def getDetails(
+        self,
+    ) -> list[str]:
+
+        try:
+            elements = self._findAll(*self.DETAIL_DD)
+            return [el.text for el in elements if el.text.strip()]
+        except (NoSuchElementException, StaleElementReferenceException):
+            return []
+
+    def clickOk(
+        self,
+    ) -> bool:
+
+        try:
+            self._waitClickable(self.OK_BTN).click()
+            return True
+        except (TimeoutException, ElementNotInteractableException):
+            return False

src/pages/components/Dialog.py

@@ -0,0 +1,114 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from selenium.webdriver.remote.webdriver import WebDriver
+from selenium.webdriver.remote.webelement import WebElement
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+
+
+class Dialog:
+    """
+        Context-managed overlay / modal / dialog on a page.
+
+        The constructor verifies that the root element is visible — if not,
+        the dialog is not on screen and a :exc:`TimeoutException` is raised.
+
+        Automates the lifecycle: wait for appearance on enter,
+        optionally wait for disappearance on exit.
+    """
+
+    def __init__(
+        self,
+        driver: WebDriver,
+        root_locator: tuple,
+        auto_close_on_exit: bool = True,
+        wait_timeout: float = 3.0,
+    ) -> None:
+
+        self._driver: WebDriver = driver
+        self._root_locator: tuple = root_locator
+        self._auto_close: bool = auto_close_on_exit
+        self._timeout: float = wait_timeout
+
+        WebDriverWait(self._driver, self._timeout).until(
+            EC.visibility_of_element_located(self._root_locator)
+        )
+
+    def __enter__(
+        self,
+    ) -> "Dialog":
+
+        return self
+
+    def __exit__(
+        self,
+        *args: object,
+    ) -> None:
+
+        if self._auto_close:
+            WebDriverWait(self._driver, self._timeout).until(
+                EC.invisibility_of_element_located(self._root_locator)
+            )
+
+    def _find(
+        self,
+        by: str,
+        value: str,
+    ) -> WebElement:
+
+        return self._driver.find_element(by, value)
+
+    def _findAll(
+        self,
+        by: str,
+        value: str,
+    ) -> list[WebElement]:
+
+        return self._driver.find_elements(by, value)
+
+    def _waitClickable(
+        self,
+        locator: tuple,
+        timeout: float = 2.0,
+    ) -> WebElement:
+
+        return WebDriverWait(self._driver, timeout).until(
+            EC.element_to_be_clickable(locator)
+        )
+
+    def _waitPresence(
+        self,
+        locator: tuple,
+        timeout: float = 2.0,
+    ) -> WebElement:
+
+        return WebDriverWait(self._driver, timeout).until(
+            EC.presence_of_element_located(locator)
+        )
+
+    def _waitVisible(
+        self,
+        locator: tuple,
+        timeout: float = 2.0,
+    ) -> WebElement:
+
+        return WebDriverWait(self._driver, timeout).until(
+            EC.visibility_of_element_located(locator)
+        )
+
+    def _waitAllPresence(
+        self,
+        locator: tuple,
+        timeout: float = 2.0,
+    ) -> list[WebElement]:
+
+        return WebDriverWait(self._driver, timeout).until(
+            EC.presence_of_all_elements_located(locator)
+        )

src/pages/components/RenewDialog.py

@@ -0,0 +1,127 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from selenium.common.exceptions import (
+    ElementNotInteractableException,
+    NoSuchElementException,
+    StaleElementReferenceException,
+    TimeoutException,
+)
+from selenium.webdriver.common.by import By
+from selenium.webdriver.remote.webdriver import WebDriver
+from selenium.webdriver.remote.webelement import WebElement
+
+from pages.components.Dialog import Dialog
+from pages.strategies.TimeSelectMaker import (
+    TimeSelectionResult,
+    TimeSelectMaker,
+)
+
+
+class RenewDialog(Dialog):
+    """
+        Renewal time selection dialog.
+    """
+
+    ROOT = (By.ID, "extendDiv")
+
+    MESSAGE_HEAD = (By.CSS_SELECTOR, "#extendDiv p.messageHead")
+    RESULT_MSG   = (By.CSS_SELECTOR, "#extendDiv div.resultMessage")
+    TIME_OPTS    = (By.CSS_SELECTOR, "#extendDiv .renewal_List li")
+    OK_BTN       = (By.CSS_SELECTOR, "#extendDiv .btnOK")
+
+    def __init__(
+        self,
+        driver: WebDriver,
+    ) -> None:
+
+        super().__init__(driver, self.ROOT, auto_close_on_exit=False)
+
+    def waitUntilReady(
+        self,
+    ) -> bool:
+
+        try:
+            self._waitVisible(self.ROOT)
+            self._waitPresence(self.MESSAGE_HEAD)
+            self._waitPresence(self.RESULT_MSG)
+        except TimeoutException:
+            return False
+        head_msg = self._find(*self.MESSAGE_HEAD).text.strip()
+        if "警告" in head_msg:
+            return False
+        try:
+            self._waitAllPresence(self.TIME_OPTS)
+            self._waitPresence(self.OK_BTN)
+        except TimeoutException:
+            return False
+        return True
+
+    def getHeadMessage(
+        self,
+    ) -> str:
+
+        try:
+            return self._find(*self.MESSAGE_HEAD).text.strip()
+        except (NoSuchElementException, StaleElementReferenceException):
+            return ""
+
+    def getResultMessage(
+        self,
+    ) -> str:
+
+        try:
+            return self._find(*self.RESULT_MSG).text.strip()
+        except (NoSuchElementException, StaleElementReferenceException):
+            return ""
+
+    def getTimeOptions(
+        self,
+    ) -> list[WebElement]:
+
+        return self._findAll(*self.TIME_OPTS)
+
+    def selectBestTime(
+        self,
+        target_time: int,
+        max_time_diff: int,
+        prefer_earlier: bool,
+    ) -> TimeSelectionResult:
+
+        all_time_opts = self.getTimeOptions()
+        if not all_time_opts:
+            return TimeSelectionResult()
+        result = TimeSelectMaker.forRenew().decide(
+            all_time_opts,
+            target_time,
+            max_time_diff,
+            prefer_earlier,
+        )
+        if result.selected_index >= 0:
+            try:
+                all_time_opts[result.selected_index].click()
+            except (ElementNotInteractableException, StaleElementReferenceException):
+                return TimeSelectionResult(free_times=result.free_times)
+        return result
+
+    def getOkButton(
+        self,
+    ) -> WebElement:
+
+        return self._find(*self.OK_BTN)
+
+    def clickOk(
+        self,
+    ) -> bool:
+
+        try:
+            self._find(*self.OK_BTN).click()
+            return True
+        except (NoSuchElementException, ElementNotInteractableException):
+            return False

src/pages/components/ReserveResultDialog.py

@@ -0,0 +1,77 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from selenium.common.exceptions import (
+    NoSuchElementException,
+    StaleElementReferenceException,
+)
+from selenium.webdriver.common.by import By
+from selenium.webdriver.remote.webdriver import WebDriver
+
+from pages.components.Dialog import Dialog
+
+
+class ReserveResultDialog(Dialog):
+    """
+        Reservation result dialog shown after submitting a reserve request.
+    """
+
+    ROOT = (By.CLASS_NAME, "layoutSeat")
+
+    def __init__(
+        self,
+        driver: WebDriver,
+    ) -> None:
+
+        super().__init__(driver, self.ROOT, auto_close_on_exit=False)
+
+    def _titleLocator(
+        self,
+    ) -> tuple:
+
+        return (By.CSS_SELECTOR, ".layoutSeat dt")
+
+    def getTitle(
+        self,
+    ) -> str:
+
+        try:
+            return self._find(*self._titleLocator()).text
+        except (NoSuchElementException, StaleElementReferenceException):
+            return ""
+
+    def isSuccess(
+        self,
+    ) -> bool:
+
+        title = self.getTitle()
+        return any(
+            kw in title
+            for kw in ("预定好了", "预约成功", "操作成功")
+        )
+
+    def isFailure(
+        self,
+    ) -> bool:
+
+        contents = self.getDetailTexts()
+        return any(
+            "预约失败" in msg or "已有1个有效预约" in msg
+            for msg in contents
+        )
+
+    def getDetailTexts(
+        self,
+    ) -> list[str]:
+
+        try:
+            elements = self._findAll(By.CSS_SELECTOR, ".layoutSeat dd")
+            return [el.text for el in elements if el.text.strip()]
+        except (NoSuchElementException, StaleElementReferenceException):
+            return []

src/pages/components/SeatMapDialog.py

@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from selenium.common.exceptions import (
+    ElementNotInteractableException,
+    NoSuchElementException,
+    StaleElementReferenceException,
+    TimeoutException,
+)
+from selenium.webdriver.common.by import By
+from selenium.webdriver.remote.webdriver import WebDriver
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+
+from pages.components.Dialog import Dialog
+
+
+class SeatMapDialog(Dialog):
+    """
+        Seat selection overlay that opens after choosing a floor and room.
+    """
+
+    ROOT       = (By.ID, "seatLayout")
+    SEAT_ITEMS = (By.CSS_SELECTOR, "li[id^='seat_']")
+
+    def __init__(
+        self,
+        driver: WebDriver,
+    ) -> None:
+
+        super().__init__(driver, self.ROOT)
+
+    def selectSeat(
+        self,
+        seat_id: str,
+    ) -> str | None:
+
+        try:
+            self._waitAllPresence(self.SEAT_ITEMS)
+        except TimeoutException:
+            return None
+        try:
+            seat_el = self._find(By.ID, f"seat_{int(seat_id):03d}")
+            seat_link = seat_el.find_element(By.TAG_NAME, "a")
+            WebDriverWait(self._driver, 2).until(
+                EC.element_to_be_clickable(seat_link)
+            )
+            seat_link.click()
+            return seat_link.get_attribute("title")
+        except (NoSuchElementException, ValueError, TimeoutException,
+                ElementNotInteractableException, StaleElementReferenceException):
+            pass
+        try:
+            all_seats = self._findAll(*self.SEAT_ITEMS)
+            seat_id_upper = seat_id.lstrip('0').upper()
+            for seat in all_seats:
+                if not seat_id_upper == seat.text.lstrip('0'):
+                    continue
+                seat_link = seat.find_element(By.TAG_NAME, "a")
+                WebDriverWait(self._driver, 2).until(
+                    EC.element_to_be_clickable(seat_link)
+                )
+                seat_link.click()
+                return seat_link.get_attribute("title")
+            return None
+        except (NoSuchElementException, TimeoutException,
+                ElementNotInteractableException, StaleElementReferenceException):
+            return None

src/pages/components/TimeSelectDialog.py

@@ -0,0 +1,234 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Callable, Optional
+
+from selenium.common.exceptions import (
+    ElementNotInteractableException,
+    StaleElementReferenceException,
+    TimeoutException,
+)
+from selenium.webdriver.common.by import By
+from selenium.webdriver.remote.webdriver import WebDriver
+from selenium.webdriver.remote.webelement import WebElement
+
+from pages.components.Dialog import Dialog
+from pages.strategies.TimeSelectMaker import (
+    TimeRangeResult,
+    TimeSelectionResult,
+    TimeSelectMaker,
+    minsToTimeStr,
+    timeStrToMins,
+)
+
+if TYPE_CHECKING:
+    from pages.flows.ReserveFlow import ReserveContext
+
+
+class TimeSelectDialog(Dialog):
+    """
+        Time selection panel that appears after selecting a seat.
+
+        Contains start-time and end-time option lists.
+        Does NOT auto-close — the reserve submission handles cleanup.
+    """
+
+    ROOT = (By.CSS_SELECTOR, "#startTime ul")
+
+    def __init__(
+        self,
+        driver: WebDriver,
+        tracer: Optional[Callable[[str, int], None]] = None,
+    ) -> None:
+
+        super().__init__(driver, self.ROOT, auto_close_on_exit=False)
+        self._tracer = tracer
+
+    def _trace(
+        self,
+        msg: str,
+        level: int = logging.INFO,
+    ) -> None:
+
+        if self._tracer is not None:
+            self._tracer(msg, level)
+
+    def _logTimeStep(
+        self,
+        time_type: str,
+        target_mins: int,
+        max_diff: int,
+        step_result: TimeSelectionResult,
+    ) -> bool:
+
+        if step_result.selected_index >= 0:
+            abs_diff = abs(step_result.actual_diff)
+            if step_result.actual_diff < 0:
+                relation = f"早了 {abs_diff} 分钟"
+            elif step_result.actual_diff > 0:
+                relation = f"晚了 {abs_diff} 分钟"
+            else:
+                relation = f"正好等于 {time_type}"
+            self._trace(
+                f"选择距离期望 {time_type} 最近的 {step_result.display_text}, "
+                f"与期望 {time_type} 相比 {relation}"
+            )
+            return True
+        if not step_result.free_times:
+            self._trace(
+                f"{time_type} 选择失败 ! : 当前未查询到可用时间",
+                logging.ERROR,
+            )
+        else:
+            target_str = minsToTimeStr(target_mins)
+            self._trace(
+                f"无法选择最近的 {time_type} {target_str}, "
+                f"所有可选时间与目标时间相差都超过 {max_diff} 分钟",
+                logging.WARNING,
+            )
+            self._trace(f"当前可供预约的 {time_type} 有: {step_result.free_times}")
+        return False
+
+    def getTimeOptions(
+        self,
+        time_id: str,
+    ) -> list[WebElement]:
+
+        try:
+            self._waitAllPresence(
+                (By.CSS_SELECTOR, f"#{time_id} ul li a")
+            )
+        except TimeoutException:
+            return []
+        return self._findAll(
+            By.CSS_SELECTOR,
+            f"#{time_id} ul li a",
+        )
+
+    def selectNearestTime(
+        self,
+        time_id: str,
+        target_time: int,
+        max_time_diff: int,
+        prefer_earlier: bool,
+    ) -> TimeSelectionResult:
+
+        all_time_opts = self.getTimeOptions(time_id)
+        if not all_time_opts:
+            return TimeSelectionResult()
+        result = TimeSelectMaker.forReserve().decide(
+            all_time_opts,
+            target_time,
+            max_time_diff,
+            prefer_earlier,
+        )
+        if result.selected_index >= 0:
+            try:
+                all_time_opts[result.selected_index].click()
+            except (ElementNotInteractableException, StaleElementReferenceException):
+                return TimeSelectionResult(free_times=result.free_times)
+        return result
+
+    def selectTimeRange(
+        self,
+        begin_target: int,
+        end_target: int,
+        begin_max_diff: int = 30,
+        end_max_diff: int = 30,
+        begin_prefer_early: bool = True,
+        end_prefer_early: bool = False,
+        satisfy_duration: bool = True,
+        expect_duration: int = 4,
+        library_close_mins: int = TimeSelectMaker.LIBRARY_CLOSE_MINS,
+    ) -> TimeRangeResult:
+
+        begin_result = self.selectNearestTime(
+            "startTime",
+            begin_target,
+            begin_max_diff,
+            begin_prefer_early,
+        )
+        if begin_result.selected_index < 0:
+            return TimeRangeResult(begin_result=begin_result)
+        actual_begin = begin_result.selected_value
+        if satisfy_duration:
+            end_target = TimeSelectMaker.calcEndTime(
+                actual_begin,
+                expect_duration,
+                library_close_mins,
+            )
+        end_result = self.selectNearestTime(
+            "endTime",
+            end_target,
+            end_max_diff,
+            end_prefer_early,
+        )
+        if end_result.selected_index < 0:
+            return TimeRangeResult(
+                begin_result=begin_result,
+                actual_begin_mins=actual_begin,
+                end_result=end_result,
+                expect_end_mins=end_target,
+            )
+        return TimeRangeResult(
+            begin_result=begin_result,
+            end_result=end_result,
+            actual_begin_mins=actual_begin,
+            actual_end_mins=end_result.selected_value,
+            expect_end_mins=end_target,
+        )
+
+    def selectSeatTime(
+        self,
+        ctx: ReserveContext,
+        library_close_mins: int = TimeSelectMaker.LIBRARY_CLOSE_MINS,
+    ) -> bool:
+
+        exp_beg_mins = timeStrToMins(ctx.begin_time)
+        exp_end_mins = timeStrToMins(ctx.end_time)
+        result = self.selectTimeRange(
+            begin_target=exp_beg_mins,
+            end_target=exp_end_mins,
+            begin_max_diff=ctx.begin_max_diff,
+            end_max_diff=ctx.end_max_diff,
+            begin_prefer_early=ctx.begin_prefer_early,
+            end_prefer_early=ctx.end_prefer_early,
+            satisfy_duration=ctx.satisfy_duration,
+            expect_duration=ctx.expect_duration,
+            library_close_mins=library_close_mins,
+        )
+        if not self._logTimeStep("开始时间", exp_beg_mins, ctx.begin_max_diff, result.begin_result):
+            return False
+        if ctx.satisfy_duration:
+            unclipped = result.actual_begin_mins + ctx.expect_duration*60
+            if unclipped > library_close_mins:
+                self._trace(
+                    f"预约持续时间 {ctx.expect_duration} 小时, 超过最大预约时间 {minsToTimeStr(library_close_mins)}, "
+                    f"自动调整为 {minsToTimeStr(library_close_mins)}",
+                    logging.WARNING,
+                )
+            act_beg_str = minsToTimeStr(result.actual_begin_mins)
+            exp_end_str = minsToTimeStr(result.expect_end_mins)
+            self._trace(
+                f"需要满足期望预约持续时间: {ctx.expect_duration} 小时, "
+                f"根据开始时间 {act_beg_str} 计算结束时间: {exp_end_str}"
+            )
+        if not self._logTimeStep("结束时间", result.expect_end_mins, ctx.end_max_diff, result.end_result):
+            return False
+        act_beg_str = minsToTimeStr(result.actual_begin_mins)
+        act_end_str = minsToTimeStr(result.actual_end_mins)
+        exp_end_str = minsToTimeStr(result.expect_end_mins)
+        self._trace(
+            f"期望预约时间段: {ctx.begin_time} - {exp_end_str}, "
+            f"实际预约时间段: {act_beg_str} - {act_end_str}"
+        )
+        return True

src/pages/components/__init__.py

@@ -0,0 +1,14 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from .SeatMapDialog import SeatMapDialog
+from .TimeSelectDialog import TimeSelectDialog
+from .ReserveResultDialog import ReserveResultDialog
+from .CheckinResultDialog import CheckinResultDialog
+from .RenewDialog import RenewDialog

src/pages/flows/CheckinFlow.py

@@ -0,0 +1,105 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+import queue
+
+from selenium.common.exceptions import (
+    ElementNotInteractableException,
+    NoSuchElementException,
+    TimeoutException,
+)
+from selenium.webdriver.remote.webdriver import WebDriver
+
+from base.MsgBase import MsgBase
+from pages.MainShell import MainShell
+from pages.components.CheckinResultDialog import CheckinResultDialog
+
+
+class CheckinFlow(MsgBase):
+
+    def __init__(
+        self,
+        input_queue: queue.Queue,
+        output_queue: queue.Queue,
+        driver: WebDriver,
+        shell: MainShell,
+    ) -> None:
+
+        super().__init__(input_queue, output_queue)
+        self._driver: WebDriver = driver
+        self._shell: MainShell = shell
+
+    def _ensureCheckinButton(
+        self,
+        username: str,
+    ) -> bool:
+
+        if not self._shell.waitCheckinButton():
+            self._showTrace(f"用户 {username} 签到界面加载失败 !", self.TraceLevel.ERROR)
+            return False
+        if self._shell.isCheckinButtonDisabled():
+            self._showTrace("签到按钮不可用, 可能不在场馆内, 正在尝试启用......")
+            if not self._shell.enableCheckinButtonByJS():
+                self._showTrace(f"签到按钮启用失败 !", self.TraceLevel.ERROR)
+                return False
+            self._showTrace("签到按钮已启用")
+        return True
+
+    def _processCheckinDialog(
+        self,
+        username: str,
+    ) -> bool:
+
+        try:
+            with CheckinResultDialog(self._driver) as dialog:
+                result_msg = dialog.getResultMessage()
+                if "签到成功" in result_msg:
+                    details = dialog.getDetails()
+                    if details:
+                        if len(details) >= 5:
+                            self._showTrace(
+                                f"\n"
+                                f"      签到成功 !\n"
+                                f"          {details[1]}\n"
+                                f"          {details[2]}\n"
+                                f"          {details[3]}\n"
+                                f"          {details[4]}"
+                            )
+                    else:
+                        self._showTrace(
+                            "\n"
+                            "      签到成功 !\n"
+                            "          未获取到签到详情 !"
+                        )
+                    dialog.clickOk()
+                    self._showTrace(f"用户 {username} 签到成功 !")
+                    return True
+                else:
+                    failure_reason = result_msg.replace("签到失败", "").strip()
+                    self._showTrace(
+                        f"\n"
+                        "      签到失败 !\n"
+                        f"          {failure_reason}"
+                    )
+                    dialog.clickOk()
+                    self._showTrace(f"用户 {username} 签到失败 !", self.TraceLevel.ERROR)
+                    return False
+        except (TimeoutException, NoSuchElementException, ElementNotInteractableException):
+            self._showTrace("签到时发生未知错误 !", self.TraceLevel.ERROR)
+            return False
+
+    def execute(
+        self,
+        username: str,
+    ) -> bool:
+
+        if not self._ensureCheckinButton(username):
+            return False
+        self._shell.clickCheckinButton()
+        return self._processCheckinDialog(username)

src/pages/flows/RenewFlow.py

@@ -0,0 +1,167 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+import queue
+
+from selenium.common.exceptions import (
+    ElementNotInteractableException,
+    NoSuchElementException,
+    TimeoutException,
+)
+from selenium.webdriver.remote.webdriver import WebDriver
+
+from base.MsgBase import MsgBase
+from pages.MainShell import MainShell
+from pages.components.RenewDialog import RenewDialog
+from pages.flows._helpers import timeStrToMins, minsToTimeStr
+from pages.strategies.TimeSelectMaker import TimeSelectMaker
+
+
+class RenewFlow(MsgBase):
+
+    LIBRARY_CLOSE_MINS = TimeSelectMaker.LIBRARY_CLOSE_MINS
+
+    def __init__(
+        self,
+        input_queue: queue.Queue,
+        output_queue: queue.Queue,
+        driver: WebDriver,
+        shell: MainShell,
+    ) -> None:
+
+        super().__init__(input_queue, output_queue)
+        self._driver: WebDriver = driver
+        self._shell: MainShell = shell
+
+    def _validateRenewTime(
+        self,
+        end_time: str,
+        target_renew_mins: int,
+    ) -> bool:
+
+        if target_renew_mins > self.LIBRARY_CLOSE_MINS:
+            actual_renew_duration = self.LIBRARY_CLOSE_MINS - timeStrToMins(end_time)
+            if actual_renew_duration <= 0:
+                self._showTrace(
+                    f"当前结束时间 {end_time} 已接近闭馆时间,无法续约 !", self.TraceLevel.ERROR
+                )
+                return False
+            self._showTrace(
+                f"续约时间已调整至闭馆时间 "
+                f"{minsToTimeStr(self.LIBRARY_CLOSE_MINS)},"
+                f"实际续约时长为 "
+                f"{actual_renew_duration // 60} 小时 "
+                f"{actual_renew_duration % 60} 分钟"
+            )
+        return True
+
+    def _computeRenewTarget(
+        self,
+        record: dict,
+        renew_info: dict,
+    ):
+
+        end_time = record["time"]["end"]
+        target_renew_mins = timeStrToMins(end_time) + renew_info.get("expect_duration", 2) * 60
+        if not self._validateRenewTime(end_time, target_renew_mins):
+            return None
+        return target_renew_mins
+
+    def _ensureExtendButton(
+        self,
+        username: str,
+    ) -> bool:
+
+        if not self._shell.waitExtendButton():
+            self._showTrace(f"用户 {username} 续约界面加载失败 !", self.TraceLevel.ERROR)
+            return False
+        if self._shell.isExtendButtonDisabled():
+            self._showTrace(
+                f"用户 {username} 续约按钮不可用, 可能不在场馆内, "
+                f"请连接图书馆网络后重试"
+            )
+            return False
+        return True
+
+    def _processRenewDialog(
+        self,
+        username: str,
+        record: dict,
+        target_renew_mins: int,
+        max_diff: int,
+        prefer_earlier: bool,
+    ) -> bool:
+
+        try:
+            with RenewDialog(self._driver) as dialog:
+                if not dialog.waitUntilReady():
+                    result_msg = dialog.getResultMessage()
+                    self._showTrace(
+                        f"\n"
+                        f"      续约失败 !\n"
+                        f"          {result_msg}"
+                    )
+                    self._shell.refresh()
+                    self._showTrace(f"用户 {username} 续约失败 !", self.TraceLevel.ERROR)
+                    return False
+                result = dialog.selectBestTime(
+                    target_renew_mins,
+                    max_diff,
+                    prefer_earlier,
+                )
+                if result.selected_index >= 0:
+                    abs_diff = abs(result.actual_diff)
+                    if result.actual_diff < 0:
+                        relation = f"早了 {abs_diff} 分钟"
+                    elif result.actual_diff > 0:
+                        relation = f"晚了 {abs_diff} 分钟"
+                    else:
+                        relation = "正好等于 续约时间"
+                    self._showTrace(
+                        f"选择距离期望续约时间最近的 {result.display_text}, "
+                        f"与期望续约时间相比 {relation}"
+                    )
+                    record["time"]["end"] = result.display_text.strip()
+                    dialog.clickOk()
+                    self._shell.refresh()
+                    return True
+                if not result.free_times:
+                    self._showTrace("当前未查询到可用续约时间 !", self.TraceLevel.WARNING)
+                else:
+                    self._showTrace(
+                        "无法选择最近的可用续约时间 ! "
+                        f"所有可选时间与目标时间相差都超过了 {max_diff} 分钟 !",
+                        self.TraceLevel.WARNING,
+                    )
+                    self._showTrace(f"当前可供续约的时间有: {result.free_times}")
+                self._shell.refresh()
+                return False
+        except (NoSuchElementException, TimeoutException, ElementNotInteractableException) as e:
+            self._showTrace(f"用户 {username} 续约失败 ! : {e}", self.TraceLevel.ERROR)
+            self._shell.refresh()
+            return False
+
+    def execute(
+        self,
+        username: str,
+        record: dict,
+        renew_info: dict,
+    ) -> bool:
+
+        max_diff = renew_info.get("max_diff", 30)
+        prefer_earlier = renew_info.get("prefer_early", True)
+        target_renew_mins = self._computeRenewTarget(record, renew_info)
+        if target_renew_mins is None:
+            return False
+        if not self._ensureExtendButton(username):
+            return False
+        self._shell.clickExtendButton()
+        return self._processRenewDialog(
+            username, record, target_renew_mins, max_diff, prefer_earlier,
+        )

src/pages/flows/ReserveFlow.py

@@ -0,0 +1,213 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+import queue
+from dataclasses import dataclass
+
+from selenium.common.exceptions import (
+    ElementNotInteractableException,
+    TimeoutException,
+)
+from selenium.webdriver.remote.webdriver import WebDriver
+
+from base.MsgBase import MsgBase
+from pages.MainShell import MainShell
+from pages.strategies.TimeSelectMaker import TimeSelectMaker
+from pages.ReserveView import ReserveView
+from pages.components.ReserveResultDialog import ReserveResultDialog
+from pages.components.TimeSelectDialog import TimeSelectDialog
+
+
+@dataclass
+class ReserveContext:
+
+    username: str
+    date: str
+    floor: str
+    room: str
+    seat_id: str
+    begin_time: str
+    end_time: str
+    begin_max_diff: int = 30
+    end_max_diff: int = 30
+    begin_prefer_early: bool = True
+    end_prefer_early: bool = False
+    expect_duration: int = 4
+    satisfy_duration: bool = True
+
+
+class ReserveFlow(MsgBase):
+
+    LIBRARY_CLOSE_MINS = TimeSelectMaker.LIBRARY_CLOSE_MINS
+
+    def __init__(
+        self,
+        input_queue: queue.Queue,
+        output_queue: queue.Queue,
+        driver: WebDriver,
+        shell: MainShell,
+    ) -> None:
+
+        super().__init__(input_queue, output_queue)
+        self._driver: WebDriver = driver
+        self._shell: MainShell = shell
+
+    def _loadReserveView(
+        self,
+    ) -> ReserveView | None:
+
+        try:
+            return self._shell.gotoReserveView()
+        except (TimeoutException, ElementNotInteractableException) as e:
+            self._showTrace(f"加载预约选座页面失败 ! : {e}", self.TraceLevel.ERROR)
+            return None
+
+    def _selectDate(
+        self,
+        view: ReserveView,
+        ctx: ReserveContext,
+    ) -> bool:
+
+        if not view.selectDate(ctx.date):
+            self._showTrace(f"选择日期失败 ! : {ctx.date} 不可用", self.TraceLevel.ERROR)
+            return False
+        self._showTrace(f"日期 {ctx.date} 选择成功 !")
+        return True
+
+    def _selectPlace(
+        self,
+        view: ReserveView,
+    ) -> bool:
+
+        if not view.selectPlace("1"):
+            self._showTrace("选择预约场所失败 ! : 图书馆 不可用", self.TraceLevel.ERROR)
+            return False
+        self._showTrace("预约场所 图书馆 选择成功 !")
+        return True
+
+    def _selectFloor(
+        self,
+        view: ReserveView,
+        ctx: ReserveContext,
+    ) -> bool:
+
+        if not view.selectFloor(ctx.floor):
+            display_floor = ReserveView.FLOOR_MAP.get(ctx.floor, ctx.floor)
+            self._showTrace(f"选择楼层失败 ! : {display_floor} 不可用", self.TraceLevel.ERROR)
+            return False
+        self._showTrace(f"楼层 {ReserveView.FLOOR_MAP.get(ctx.floor)} 选择成功 !")
+        return True
+
+    def _selectRoom(
+        self,
+        view: ReserveView,
+        ctx: ReserveContext,
+    ):
+
+        seat_map = view.selectRoom(ctx.room)
+        if seat_map is None:
+            display_room = ReserveView.ROOM_MAP.get(ctx.room, ctx.room)
+            self._showTrace(f"选择房间失败 ! : {display_room} 不可用", self.TraceLevel.ERROR)
+            return None
+        self._showTrace(f"房间 {ReserveView.ROOM_MAP.get(ctx.room)} 选择成功 !")
+        return seat_map
+
+    def _processReserveResult(
+        self,
+    ) -> bool:
+
+        with ReserveResultDialog(self._driver) as result:
+            if result.isFailure():
+                self._showTrace("预约失败", self.TraceLevel.ERROR)
+            elif result.isSuccess():
+                details = result.getDetailTexts()
+                if len(details) >= 6:
+                    self._showTrace(
+                        f"\n"
+                        f"      预约成功 !\n"
+                        f"          {details[1]}\n"
+                        f"          {details[2]}\n"
+                        f"          {details[3]}\n"
+                        f"          签到时间 ：{details[5]}"
+                    )
+                else:
+                    self._showTrace(
+                        "\n"
+                        "      预约成功 !\n"
+                        "          未找获取到详细信息"
+                    )
+                return True
+            else:
+                self._showTrace("预约结果加载失败 !", self.TraceLevel.ERROR)
+        return False
+
+    def _selectSeatAndSubmit(
+        self,
+        view: ReserveView,
+        seat_map,
+        ctx: ReserveContext,
+    ) -> tuple[bool, bool]:
+
+        submit_reserve = False
+        reserve_success = False
+
+        seat_status = seat_map.selectSeat(ctx.seat_id)
+        if seat_status is None:
+            self._showTrace(
+                f"座位 {ctx.seat_id} 在该楼层区域中不存在, 请检查座位号是否正确",
+                self.TraceLevel.WARNING,
+            )
+        else:
+            self._showTrace(f"座位 {ctx.seat_id} 选择成功 ! : 当前状态 - '{seat_status}'")
+            try:
+                time_dialog = TimeSelectDialog(self._driver, tracer=self._showTrace)
+            except TimeoutException:
+                self._showTrace("时间选择面板未出现 !", self.TraceLevel.ERROR)
+            else:
+                if not time_dialog.selectSeatTime(ctx):
+                    self._showTrace("选择时间失败 !", self.TraceLevel.ERROR)
+                else:
+                    try:
+                        view.submitReserve()
+                        submit_reserve = True
+                        reserve_success = self._processReserveResult()
+                    except (TimeoutException, ElementNotInteractableException):
+                        self._showTrace("预约提交失败 !", self.TraceLevel.ERROR)
+        return submit_reserve, reserve_success
+
+    def execute(
+        self,
+        ctx: ReserveContext,
+    ) -> bool:
+
+        # reserve flow pipeline:
+        #   date > place > floor > room > seat (begin/end time) > submit > result
+        view = self._loadReserveView()
+        if view is None:
+            return False
+        if not self._selectDate(view, ctx):
+            return False
+        if not self._selectPlace(view):
+            return False
+        if not self._selectFloor(view, ctx):
+            return False
+        seat_map = self._selectRoom(view, ctx)
+        if seat_map is None:
+            return False
+        have_hover_on_page = True
+        submit_reserve, reserve_success = self._selectSeatAndSubmit(
+            view, seat_map, ctx,
+        )
+        if not submit_reserve and have_hover_on_page:
+            view.refresh()
+        if reserve_success:
+            self._showTrace(f"用户 {ctx.username} 预约成功 !")
+        else:
+            self._showTrace(f"用户 {ctx.username} 预约失败 !", self.TraceLevel.ERROR)
+        return reserve_success

src/pages/flows/__init__.py

@@ -0,0 +1,12 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from .ReserveFlow import ReserveFlow
+from .CheckinFlow import CheckinFlow
+from .RenewFlow import RenewFlow

src/pages/flows/_helpers.py

@@ -0,0 +1,13 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from pages.strategies.TimeSelectMaker import (
+    minsToTimeStr,
+    timeStrToMins,
+)

src/pages/services/CaptchaSolver.py

@@ -0,0 +1,86 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+import base64
+import queue
+
+import ddddocr
+from base.MsgBase import MsgBase
+from pages.LoginPage import LoginPage
+
+
+class CaptchaSolver(MsgBase):
+
+    def __init__(
+        self,
+        input_queue: queue.Queue,
+        output_queue: queue.Queue,
+    ) -> None:
+
+        super().__init__(input_queue, output_queue)
+        self._ocr = ddddocr.DdddOcr()
+
+    def _autoRecognize(
+        self,
+        login_page: LoginPage,
+    ) -> str:
+
+        try:
+            img_src = login_page.getCaptchaImageSrc()
+            if img_src is None:
+                self._showTrace("验证码图片元素定位时发生错误 !", self.TraceLevel.ERROR)
+                return ""
+            base64_str = img_src.split(',', 1)[1]
+            captcha_img = base64.b64decode(base64_str)
+            captcha_text = self._ocr.classification(captcha_img)
+            captcha_text = ''.join(filter(str.isalnum, captcha_text)).lower()
+            self._showTrace(f"识别到验证码为 : '{captcha_text}'", 20, no_log=True)
+            if len(captcha_text) != 4:
+                self._showLog("识别到的验证码长度不等于 4 个字符 !", self.TraceLevel.WARNING)
+                return ""
+            return captcha_text
+        except ValueError as e:
+            self._showTrace(f"验证码识别失败 ! : {e}", self.TraceLevel.ERROR)
+            return ""
+
+    def _manualRecognize(
+        self,
+    ) -> str:
+
+        self._showMsg("请输入验证码:")
+        captcha_text = self._waitMsg(timeout=15)
+        self._showTrace(f"输入的验证码为 : '{captcha_text}'", 20, no_log=True)
+        if len(captcha_text) != 4:
+            self._showLog("输入的验证码长度不等于 4 个字符 !", self.TraceLevel.WARNING)
+            return ""
+        return captcha_text
+
+    def solveCaptcha(
+        self,
+        login_page: LoginPage,
+        auto_captcha: bool = True,
+    ) -> str:
+
+        max_attempts = 3
+        for _ in range(max_attempts):
+            if auto_captcha:
+                captcha_text = self._autoRecognize(login_page)
+            else:
+                self._showTrace("用户未配置自动识别验证码, 请手动输入验证码 !", 20, no_log=True)
+                captcha_text = self._manualRecognize()
+            if captcha_text:
+                return captcha_text
+            else:
+                if not login_page.refreshCaptcha():
+                    return ""
+        self._showTrace(
+            f"验证码识别失败 {max_attempts} 次, 达到最大尝试次数 !",
+            self.TraceLevel.WARNING,
+        )
+        return ""

src/pages/services/RecordChecker.py

@@ -0,0 +1,309 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+import queue
+import re
+import time
+from datetime import datetime, timedelta
+
+from selenium.common.exceptions import (
+    NoSuchElementException,
+    StaleElementReferenceException,
+    TimeoutException,
+)
+
+from base.MsgBase import MsgBase
+from pages.MainShell import MainShell
+from pages.RecordsView import RecordsView
+
+
+class RecordChecker(MsgBase):
+
+    def __init__(
+        self,
+        input_queue: queue.Queue,
+        output_queue: queue.Queue,
+    ) -> None:
+
+        super().__init__(input_queue, output_queue)
+
+    @staticmethod
+    def _formatDiffTime(
+        seconds: float,
+    ) -> str:
+
+        hours = int(seconds//3600)
+        minutes = int(seconds%3600//60)
+        seconds = int(seconds%60)
+        return f"{hours} 时 {minutes} 分 {seconds} 秒"
+
+    def _decodeReserveTime(
+        self,
+        time_element,
+    ) -> dict:
+
+        time_str = time_element.text.strip()
+        today = datetime.now().date()
+        if "明天" in time_str:
+            target_date = today + timedelta(days=1)
+            date = target_date.strftime("%Y-%m-%d")
+        elif "今天" in time_str:
+            target_date = today
+            date = target_date.strftime("%Y-%m-%d")
+        elif "昨天" in time_str:
+            target_date = today - timedelta(days=1)
+            date = target_date.strftime("%Y-%m-%d")
+        else:
+            date_match = re.search(r"(\d{4}-\d{1,2}-\d{1,2})", time_str)
+            if date_match:
+                date = date_match.group(1)
+            else:
+                date = ""
+        time_match = re.search(
+            r"(\d{1,2}:\d{2}) -- (\d{1,2}:\d{2})", time_str
+        )
+        if time_match:
+            begin_time = time_match.group(1)
+            end_time = time_match.group(2)
+        else:
+            begin_time = ""
+            end_time = ""
+        return {
+            "date": date,
+            "time": {"begin": begin_time, "end": end_time},
+        }
+
+    def _decodeReserveInfo(
+        self,
+        info_elements,
+    ) -> dict:
+
+        location = ""
+        status = ""
+        for info in info_elements:
+            if "已预约" in info.text:
+                status = "已预约"
+            elif "使用中" in info.text:
+                status = "使用中"
+            elif "已完成" in info.text:
+                status = "已完成"
+            elif "已结束使用" in info.text:
+                status = "已结束使用"
+            elif "已取消" in info.text:
+                status = "已取消"
+            elif "失约" in info.text:
+                status = "失约"
+            elif "图书馆" in info.text:
+                location = info.text.strip()
+        return {"location": location, "status": status}
+
+    def _decodeReserveRecord(
+        self,
+        reservation,
+        records_view: RecordsView,
+    ) -> dict:
+
+        try:
+            time_element = records_view.getRecordTimeElement(reservation)
+            info_elements = records_view.getRecordInfoElements(reservation)
+        except (NoSuchElementException, StaleElementReferenceException):
+            return {
+                "date": "",
+                "time": {"begin": "", "end": ""},
+                "info": {"location": "", "status": ""},
+            }
+        try:
+            time_data = self._decodeReserveTime(time_element)
+            info_data = self._decodeReserveInfo(info_elements)
+        except StaleElementReferenceException:
+            return {
+                "date": "",
+                "time": {"begin": "", "end": ""},
+                "info": {"location": "", "status": ""},
+            }
+        return {
+            "date": time_data["date"],
+            "time": time_data["time"],
+            "info": info_data,
+        }
+
+    def _getReserveRecord(
+        self,
+        shell: MainShell,
+        wanted_date: str,
+        wanted_status: str,
+    ) -> dict | None:
+
+        if wanted_date is None:
+            self._showTrace("日期未指定, 无法检查当前预约状态", self.TraceLevel.WARNING)
+            return None
+        self._showTrace(
+            f"正在检查用户在 {wanted_date} 是否有预约状态为 "
+            f"{wanted_status} 的预约记录......", 20, no_log=True
+        )
+
+        checked_count = 0
+        max_check_times = 6
+
+        records_view = shell.gotoRecordsView()
+        for _ in range(max_check_times):
+            try:
+                reservations = records_view.loadRecords()
+            except TimeoutException:
+                reservations = None
+            if reservations is None:
+                return None
+            for reservation in reservations[checked_count:]:
+                record = self._decodeReserveRecord(reservation, records_view)
+                checked_count += 1
+                if record is None:
+                    continue
+                if record["date"] == "":
+                    continue
+                if record["time"] == {"begin": "", "end": ""}:
+                    continue
+                if (
+                    datetime.strptime(record["date"], "%Y-%m-%d").date()
+                    > datetime.strptime(wanted_date, "%Y-%m-%d").date()
+                ):
+                    continue
+                if (
+                    datetime.strptime(record["date"], "%Y-%m-%d").date()
+                    < datetime.strptime(wanted_date, "%Y-%m-%d").date()
+                ):
+                    return None
+                if record["info"]["status"] == wanted_status:
+                    self._showTrace(
+                        f"寻找到用户第 {checked_count} 条状态为 "
+                        f"{wanted_status} 的预约记录, "
+                        f"详细信息: {record["date"]} "
+                        f"{record["time"]["begin"]} - "
+                        f"{record["time"]["end"]} "
+                        f"{record["info"]["location"]}",
+                        20, no_log=True,
+                    )
+                    return record
+            if not records_view.showMoreRecords():
+                break
+        return None
+
+    def canReserve(
+        self,
+        shell: MainShell,
+        date: str,
+    ) -> bool:
+
+        if self._getReserveRecord(shell, date, "已预约") is None:
+            if self._getReserveRecord(shell, date, "使用中") is None:
+                self._showTrace(f"用户在 {date} 可以预约")
+                return True
+            self._showTrace(f"用户在 {date} 有使用中的预约, 无法预约")
+            return False
+        self._showTrace(f"用户在 {date} 已存在有效预约, 无法预约")
+        return False
+
+    def canCheckin(
+        self,
+        shell: MainShell,
+    ) -> bool:
+
+        date = time.strftime("%Y-%m-%d", time.localtime())
+        record = self._getReserveRecord(shell, date, "已预约")
+        if record is not None:
+            begin_time = record["time"]["begin"]
+            begin_time = datetime.strptime(
+                f"{date} {begin_time}", "%Y-%m-%d %H:%M"
+            )
+            time_diff = datetime.now() - begin_time
+            time_diff_seconds = time_diff.total_seconds()
+            if time_diff_seconds < -30 * 60:
+                self._showTrace(
+                    f"用户在 {date} 的预约开始时间为 {begin_time}, "
+                    f"当前距离预约开始时间还有 "
+                    f"{self._formatDiffTime(abs(time_diff_seconds))}, 无法签到"
+                )
+                return False
+            elif -30 * 60 <= time_diff_seconds < 0:
+                self._showTrace(
+                    f"用户在 {date} 的预约开始时间为 {begin_time}, "
+                    f"当前距离预约开始时间还有 "
+                    f"{self._formatDiffTime(abs(time_diff_seconds))}, 可以签到"
+                )
+                return True
+            elif 0 <= time_diff_seconds < 30*60 - 5:
+                self._showTrace(
+                    f"用户在 {date} 的预约开始时间为 {begin_time}, "
+                    f"当前距离预约开始时间已经过去 "
+                    f"{self._formatDiffTime(abs(time_diff_seconds))}, 可以签到"
+                )
+                return True
+        self._showTrace(f"用户在 {date} 没有有效预约记录, 无法签到")
+        return False
+
+    def canRenew(
+        self,
+        shell: MainShell,
+    ) -> tuple[bool, dict]:
+
+        date = time.strftime("%Y-%m-%d", time.localtime())
+        record = self._getReserveRecord(shell, date, "使用中")
+        if record is not None:
+            end_time = record["time"]["end"]
+            end_time = datetime.strptime(
+                f"{date} {end_time}", "%Y-%m-%d %H:%M"
+            )
+            time_diff = end_time - datetime.now()
+            time_diff_seconds = time_diff.total_seconds()
+            trace_msg = (
+                f"用户在 {date} 的预约结束时间为 {end_time}, "
+                f"当前距离预约结束时间还有 "
+                f"{self._formatDiffTime(abs(time_diff_seconds))}"
+            )
+            if abs(time_diff_seconds) < 120 * 60:
+                self._showTrace(f"{trace_msg}, 可以续约")
+                return True, record
+            else:
+                self._showTrace(f"{trace_msg}, 无法续约")
+                return False, None
+        self._showTrace(f"用户在 {date} 没有有效预约记录, 无法续约")
+        return False, None
+
+    def postRenewCheck(
+        self,
+        shell: MainShell,
+        record: dict,
+    ) -> bool:
+
+        date = record["date"]
+        act_record = self._getReserveRecord(shell, date, "使用中")
+        if act_record is not None:
+            if (
+                act_record["time"]["begin"] == record["time"]["begin"]
+                and act_record["time"]["end"] == record["time"]["end"]
+            ):
+                self._showTrace(
+                    f"\n"
+                    f"      续约成功 !\n"
+                    f"          日 期 ：{date}\n"
+                    f"          时 间 ：{act_record["time"]["begin"]}"
+                    f" - {act_record["time"]["end"]}\n"
+                    f"          位 置 ：{act_record["info"]["location"]}\n"
+                    f"          状 态 ：{act_record["info"]["status"]}"
+                )
+                return True
+            else:
+                self._showTrace(
+                    f"\n"
+                    f"      续约失败 !\n"
+                    f"          续约后结束时间为 {act_record["time"]["end"]},"
+                    f"与预期结束时间 {record["time"]["end"]} 不符 !"
+                )
+                return False
+        self._showTrace(f"用户在 {date} 没有有效预约记录, 无法检查续约结果")
+        return False