chore(release): v1.1.0 [auto release commit]

fix(Main, ALConfigWidget): 修复配置文件初始化问题
ci(workflows): 修复 build.yml 中 Generate 'Main.spec' 步骤中的 name 参数
2026-06-18 07:23:03 +08:00 · 2026-02-26 15:04:42 +00:00 · 2026-02-26 22:59:26 +08:00 · 2026-02-26 21:27:35 +08:00 · 2026-02-26 21:18:18 +08:00 · 2026-02-24 17:39:49 +08:00
63 changed files with 5626 additions and 1458 deletions
@@ -0,0 +1,232 @@
+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'.
+#
+# It is triggered when called by the release workflow.
+
+on:
+  workflow_call:
+    inputs:
+      version:
+        description: 'Version number'
+        required: true
+        type: string
+      tag_name:
+        description: 'Tag name'
+        required: true
+        type: string
+    outputs:
+      version:
+        description: 'The version number'
+        value: ${{ jobs.build-windows.outputs.version }}
+      tag_name:
+        description: 'The tag name'
+        value: ${{ jobs.build-windows.outputs.tag_name }}
+
+#
+# Build Windows
+#
+
+jobs:
+  build-windows:
+    runs-on: windows-latest
+    outputs:
+      version: ${{ steps.get_version.outputs.VERSION }}
+      tag_name: ${{ steps.get_version.outputs.TAG_NAME }}
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        ref: main
+
+    # here we download the build version of ALVersionInfo.py from artifacts
+    # and replace the committed version
+    - name: Download build version of ALVersionInfo.py
+      uses: actions/download-artifact@v4
+      with:
+        name: updated-version-info-for-build
+        path: src/gui/
+
+    - name: Get version info
+      id: get_version
+      run: |
+        $version = "${{ inputs.version }}"
+        $tagName = "${{ inputs.tag_name }}"
+
+        echo "TAG_NAME=$tagName" >> $env:GITHUB_OUTPUT
+        echo "VERSION=$version" >> $env:GITHUB_OUTPUT
+        Write-Host "✓ Tag: $tagName"
+        Write-Host "✓ Version: $version"
+      shell: pwsh
+
+    - name: Verify 'ALVersionInfo.py' was updated
+      run: |
+        $versionInfoFile = "src/gui/ALVersionInfo.py"
+        Write-Host "Verifying $versionInfoFile content:"
+        Write-Host "=================================="
+        Get-Content $versionInfoFile | Write-Host
+        Write-Host "=================================="
+      shell: pwsh
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.13'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirement.txt
+
+    - name: Solve ddddocr compatibility and copy model files
+      run: |
+        $ddddocrPath = python -c "import ddddocr, os; print(os.path.dirname(ddddocr.__file__))"
+        Write-Host "ddddocr package location: $ddddocrPath"
+
+        $initFile = Join-Path $ddddocrPath "__init__.py"
+        if (Test-Path $initFile) {
+          Write-Host "Fixing ddddocr compatibility in: $initFile"
+          (Get-Content $initFile) -replace 'Image\.ANTIALIAS', 'Image.Resampling.LANCZOS' | Set-Content $initFile
+          Write-Host "✓ Fixed: Image.ANTIALIAS -> Image.Resampling.LANCZOS"
+        } else {
+          Write-Error "✗ ddddocr __init__.py not found"
+          exit 1
+        }
+
+        if (-not (Test-Path "models")) {
+          New-Item -ItemType Directory -Path "models" | Out-Null
+          Write-Host "✓ Created models directory"
+        }
+
+        $onnxSource = Join-Path $ddddocrPath "common.onnx"
+        $onnxDest = "models/common.onnx"
+        if (Test-Path $onnxSource) {
+          Copy-Item $onnxSource $onnxDest -Force
+          Write-Host "✓ Copied ONNX model from: $onnxSource"
+          Write-Host "✓ ONNX model copied to: $onnxDest"
+        } else {
+          Write-Error "✗ ONNX model not found in ddddocr package: $onnxSource"
+          exit 1
+        }
+
+        if (Test-Path $onnxDest) {
+          $fileSize = (Get-Item $onnxDest).Length / 1MB
+          Write-Host "✓ Model file verified: $onnxDest (Size: $([math]::Round($fileSize, 2)) MB)"
+        } else {
+          Write-Error "✗ Failed to copy model file"
+          exit 1
+        }
+      shell: pwsh
+
+    - name: Compile Qt Resource files
+      run: |
+        cd batchs
+        ./compile_rc.bat
+      shell: cmd
+
+    - name: Compile Qt UI files
+      run: |
+        cd batchs
+        ./compile_ui.bat
+      shell: cmd
+
+    - name: Generate 'Main.spec'
+      run: |
+        $version = "${{ steps.get_version.outputs.VERSION }}"
+        $exeName = "AutoLibrary-$version"
+
+        Write-Host "Generating Main.spec for version: $version"
+        Write-Host "Executable name: $exeName"
+
+        $specLines = @(
+          "# -*- mode: python ; coding: utf-8 -*-"
+          ""
+          ""
+          "a = Analysis("
+          "    ['src\\Main.py'],"
+          "    pathex=[],"
+          "    binaries=[],"
+          "    datas=["
+          "        ('models\\common.onnx', 'ddddocr'),"
+          "        ('src\\gui\\resources\\icons\\AutoLibrary_32x32.ico', 'gui\\resources\\icons'),"
+          "    ],"
+          "    hiddenimports=[],"
+          "    hookspath=[],"
+          "    hooksconfig={},"
+          "    runtime_hooks=[],"
+          "    excludes=[],"
+          "    noarchive=False,"
+          "    optimize=0,"
+          ")"
+          "pyz = PYZ(a.pure)"
+          ""
+          "exe = EXE("
+          "    pyz,"
+          "    a.scripts,"
+          "    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_32x32.ico'],"
+          ")"
+          ""
+          "coll = COLLECT("
+          "    exe,"
+          "    a.binaries,"
+          "    a.datas,"
+          "    strip=False,"
+          "    upx=True,"
+          "    upx_exclude=[],"
+          "    name='$exeName'"
+          ")"
+        )
+        $specLines | Out-File -FilePath "Main.spec" -Encoding UTF8
+
+        Write-Host "✓ Main.spec (non-single file) generated successfully"
+        Write-Host "`nGenerated Main.spec ============"
+        Get-Content "Main.spec" | Write-Host
+        Write-Host "==================================`n"
+      shell: pwsh
+
+    - name: Build with PyInstaller
+      run: |
+        pyinstaller Main.spec
+
+    - name: Zip windows release
+      id: zip_release
+      run: |
+        $tagName = "${{ steps.get_version.outputs.TAG_NAME }}"
+        $version = "${{ steps.get_version.outputs.VERSION }}"
+        $distDir = "dist/AutoLibrary-$version"
+        $zipName = "AutoLibrary.$tagName-windows-x86_64.zip"
+
+        echo "ZIP_PATH=$zipName" >> $env:GITHUB_OUTPUT
+
+        Write-Host "Looking for distribution directory: $distDir"
+        if (Test-Path $distDir) {
+          Compress-Archive -Path "$distDir/*" -DestinationPath $zipName
+          Write-Host "✓ Created release archive (directory mode): $zipName"
+        } else {
+          Write-Error "✗ Distribution directory not found: $distDir"
+          Write-Host "Files in dist directory:"
+          Get-ChildItem "dist" | ForEach-Object { Write-Host "  - $($_.Name)" }
+          exit 1
+        }
+      shell: pwsh
+
+    - name: Archive artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: AutoLibrary.${{ steps.get_version.outputs.TAG_NAME }}-windows-x86_64
+        path: |
+          ${{ steps.zip_release.outputs.ZIP_PATH }}
@@ -0,0 +1,109 @@
+name: Commit Release
+
+# This workflow commits version changes in 'ALVersionInfo.py' (get from artifacts) and
+# moves the release tag to this new release commit.
+#
+# It is triggered when called by the release workflow.
+
+on:
+  workflow_call:
+    inputs:
+      tag_name:
+        description: 'Tag name to move (e.g., v1.0.0)'
+        required: true
+        type: string
+      version:
+        description: 'Version number for commit message'
+        required: true
+        type: string
+      file_path:
+        description: 'File path to commit'
+        required: true
+        type: string
+    outputs:
+      new_commit_sha:
+        description: 'The new commit SHA after moving the tag'
+        value: ${{ jobs.commit-release.outputs.new_commit_sha }}
+
+jobs:
+  commit-release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      new_commit_sha: ${{ steps.commit_info.outputs.commit_sha }}
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        ref: main
+        fetch-depth: 0
+
+    # here we download the commit version of ALVersionInfo.py from artifacts
+    # and replace the original file with it.
+    - name: Download commit version of ALVersionInfo.py
+      uses: actions/download-artifact@v4
+      with:
+        name: updated-version-info-for-commit
+        path: downloaded-file/
+
+    - name: Replace file with updated version
+      run: |
+        FILE_PATH="${{ inputs.file_path }}"
+        FILE_NAME=$(basename "$FILE_PATH")
+        TARGET_DIR=$(dirname "$FILE_PATH")
+
+        mkdir -p "$TARGET_DIR"
+        cp "downloaded-file/$FILE_NAME" "$FILE_PATH"
+
+        echo "✓ File replaced: $FILE_PATH"
+        echo ""
+        echo "Updated file content ==================="
+        cat  "$FILE_PATH"
+        echo "========================================"
+
+    - name: Commit changes
+      id: commit_changes
+      run: |
+        git config --local user.email "github-actions[bot]@users.noreply.github.com"
+        git config --local user.name "github-actions[bot]"
+
+        FILE_PATH="${{ inputs.file_path }}"
+        VERSION="${{ inputs.version }}"
+
+        if [ ! -f "$FILE_PATH" ]; then
+          echo "✗ Error: File $FILE_PATH not found"
+          exit 1
+        fi
+
+        git add "$FILE_PATH"
+        git commit -m "chore(release): v${VERSION} [auto release commit]"
+        echo "✓ Changes committed"
+
+    - name: Push to main branch
+      run: |
+        MAIN_BRANCH=$(git remote show origin | grep 'HEAD branch' | cut -d' ' -f5)
+        if [ -z "$MAIN_BRANCH" ]; then
+          MAIN_BRANCH="main"
+        fi
+
+        echo "Pushing to branch: ${MAIN_BRANCH}"
+        git push origin HEAD:${MAIN_BRANCH}
+        echo "✓ Changes pushed to ${MAIN_BRANCH}"
+
+    - name: Move tag to new release commit
+      run: |
+        TAG_NAME="${{ inputs.tag_name }}"
+
+        echo "Moving tag ${TAG_NAME} to the new commit..."
+        git tag -f ${TAG_NAME}
+        git push origin ${TAG_NAME} --force
+        echo "✓ Tag ${TAG_NAME} moved to commit $(git rev-parse --short HEAD)"
+
+    - name: Output commit info
+      id: commit_info
+      run: |
+        COMMIT_SHA=$(git rev-parse --short HEAD)
+        echo "commit_sha=$COMMIT_SHA" >> $GITHUB_OUTPUT
+        echo "✓ New commit SHA: $COMMIT_SHA"
@@ -0,0 +1,144 @@
+name: Release
+
+# This workflow automates the complete release process for AutoLibrary application
+# It is triggered when a new version tag (vX.Y.Z) is pushed to the repository
+#
+# Workflow Steps:
+# START >
+
+# 1. Update Version:
+#       Updates version information in 'ALVersionInfo.py' with build metadata and archives
+#       the updated version file as an artifact.
+#
+#       for more information, please refer to the comment in the workflow 'update-version.yml'
+
+# 2. Commit Release:
+#       Commits version changes and moves the release tag to this new release commit.
+
+# 3. Build:
+#       Compiles the application for Windows platform using PyInstaller, and
+#       archives the built artifacts as 'AutoLibrary.<tag_name>-windows-x86_64.zip'.
+
+# 4. Release:
+#       Creates GitHub release with generated artifacts and release notes
+
+# < END
+#
+# The workflow ensures version consistency between source code, built artifacts, and GitHub releases
+# while maintaining proper commit history and tag management.
+
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+
+jobs:
+  #
+  # Start :
+  #   virtual job that indacates the start of the release process
+  #
+
+  start:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Start release
+      run: |
+        echo "✓ Starting release"
+
+  #
+  # Update version :
+  #   this job updates the version in the file 'ALVersionInfo.py'
+  #
+
+  update-version:
+    needs:
+      - start
+    uses: ./.github/workflows/update-version.yml
+    permissions:
+      contents: write
+    with:
+      tag_name: ${{ github.ref_name }}
+      ref: ${{ github.ref }}
+
+  #
+  # Commit release :
+  #   this job commits the updated version file and move the release
+  #   tag to this new commit
+  #
+
+  commit-release:
+    needs:
+      - update-version
+    if: ${{ needs.update-version.outputs.has_changes == 'true' }}
+    uses: ./.github/workflows/commit-release.yml
+    permissions:
+      contents: write
+    with:
+      tag_name: ${{ needs.update-version.outputs.tag_name }}
+      version: ${{ needs.update-version.outputs.version }}
+      file_path: src/gui/ALVersionInfo.py
+
+  #
+  # Build :
+  #   this job builds the application artifacts and archives them
+
+  build:
+    needs:
+      - update-version
+      - commit-release
+    if: always() && needs.update-version.result == 'success' && needs.commit-release.result == 'success'
+    uses: ./.github/workflows/build.yml
+    permissions:
+      contents: write
+    with:
+      version: ${{ needs.update-version.outputs.version }}
+      tag_name: ${{ needs.update-version.outputs.tag_name }}
+
+  #
+  # Release :
+  #   this job creates a GitHub release and uploads the archive files
+
+  release:
+    runs-on: ubuntu-latest
+    needs:
+      - build
+    if: always() && needs.build.result == 'success'
+    permissions:
+      contents: write
+
+    steps:
+    - name: Download artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: AutoLibrary.${{ needs.build.outputs.tag_name }}-windows-x86_64
+        path: artifacts/
+
+    - name: Create release
+      id: create_release
+      uses: softprops/action-gh-release@v2
+      with:
+        tag_name: ${{ needs.build.outputs.tag_name }}
+        name: AutoLibrary ${{ needs.build.outputs.tag_name }}
+        files: |
+          artifacts/AutoLibrary.${{ needs.build.outputs.tag_name }}-windows-x86_64.zip
+        draft: false
+        prerelease: false
+        generate_release_notes: true
+        body: |
+          ---
+          **完整更新日志见下方自动生成的 Release Notes**
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  # End :
+  #   virtual job that indacates the end of the release process
+  #
+
+  end:
+    needs:
+      - release
+    runs-on: ubuntu-latest
+    steps:
+    - name: End release
+      run: |
+        echo "✓ Ending release"
@@ -0,0 +1,163 @@
+name: Update Version
+
+# This workflow updates version information in 'ALVersionInfo.py' with build metadata.
+# In progress, it will generate two version files, the first one is locate in 'src/gui/ALVersionInfo.py',
+# and the second one is locate in 'src/gui/temp/ALVersionInfo.py'. The first one is use
+# in the release process, it only update the version and tag name. The commit and build infomation
+# is 'local' or 'null'. All of them will finally archive as artifacts.
+#
+# It is triggered when called by the release workflow.
+
+on:
+  workflow_call:
+    inputs:
+      tag_name:
+        description: 'Tag name'
+        required: true
+        type: string
+      ref:
+        description: 'Git ref to checkout'
+        required: true
+        type: string
+    outputs:
+      tag_name:
+        description: 'The tag name'
+        value: ${{ jobs.update-version.outputs.tag_name }}
+      version:
+        description: 'The version number'
+        value: ${{ jobs.update-version.outputs.version }}
+      has_changes:
+        description: 'Whether ALVersionInfo.py was modified'
+        value: ${{ jobs.update-version.outputs.has_changes }}
+
+jobs:
+  update-version:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      tag_name: ${{ steps.get_version.outputs.TAG_NAME }}
+      version: ${{ steps.get_version.outputs.VERSION }}
+      has_changes: ${{ steps.check_changes.outputs.has_changes }}
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        ref: ${{ inputs.ref }}
+        fetch-depth: 0
+
+    - name: Get tag name and version
+      id: get_version
+      env:
+        TZ: UTC
+      run: |
+        TAG_NAME="${{ inputs.tag_name }}"
+        VERSION="${TAG_NAME#v}"
+        COMMIT_SHA="${GITHUB_SHA:0:7}"
+        COMMIT_DATE=$(TZ=UTC git log -1 --format=%cd --date=format-local:'%Y-%m-%d %H:%M:%S UTC')
+
+        echo "TAG_NAME=$TAG_NAME" >> $GITHUB_OUTPUT
+        echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
+        echo "COMMIT_SHA=$COMMIT_SHA" >> $GITHUB_OUTPUT
+        echo "COMMIT_DATE=$COMMIT_DATE" >> $GITHUB_OUTPUT
+
+        echo "✓ Tag: $TAG_NAME"
+        echo "✓ Version: $VERSION"
+        echo "✓ Commit SHA: $COMMIT_SHA"
+        echo "✓ Commit Date: $COMMIT_DATE"
+
+    - name: Create 'temp' directory
+      run: |
+        echo "Creating temp directory..."
+        mkdir -p "src/gui/temp"
+        echo "✓ temp directory created successfully"
+
+    - name: Update ALVersionInfo.py with version info
+      run: |
+        VERSION="${{ steps.get_version.outputs.VERSION }}"
+        TAG_NAME="${{ steps.get_version.outputs.TAG_NAME }}"
+        COMMIT_SHA="${{ steps.get_version.outputs.COMMIT_SHA }}"
+        COMMIT_DATE="${{ steps.get_version.outputs.COMMIT_DATE }}"
+        VER_INFO_BUILDFILE="src/gui/temp/ALVersionInfo.py"
+        VER_INFO_COMMITFILE="src/gui/ALVersionInfo.py"
+        BUILD_DATE=$(date -u '+%Y-%m-%d %H:%M:%S UTC')
+
+        echo "Updating ALVersionInfo.py files with build information..."
+        {
+          echo '# -*- coding: utf-8 -*-'
+          echo ''
+          echo '"""'
+          echo '    The contents of this file will automatically be updated by the'
+          echo '    workflow process. Do not edit manually.'
+          echo ''
+          echo '    This file is auto-generated during the workflow process.'
+          echo "    Last updated: ${BUILD_DATE}"
+          echo '"""'
+          echo ''
+          echo "AL_VERSION = \"${VERSION}\""
+          echo "AL_TAG = \"${TAG_NAME}\""
+          echo "AL_COMMIT_SHA = \"${COMMIT_SHA}\""
+          echo "AL_COMMIT_DATE = \"${COMMIT_DATE}\"  # time zone : UTC"
+          echo "AL_BUILD_DATE = \"${BUILD_DATE}\"  # time zone : UTC"
+          echo 'AL_VERSION_FULL = f"{AL_VERSION} ({AL_COMMIT_SHA})"'
+        } > "$VER_INFO_BUILDFILE"
+
+        echo "Updating ALVersionInfo.py for release commit..."
+        {
+          echo '# -*- coding: utf-8 -*-'
+          echo ''
+          echo '"""'
+          echo '    The contents of this file will automatically be updated by the'
+          echo '    workflow process. Do not edit manually.'
+          echo ''
+          echo '    This file is auto-generated during the workflow process.'
+          echo "    Last updated: ${BUILD_DATE}"
+          echo '"""'
+          echo ''
+          echo "AL_VERSION = \"${VERSION}\""
+          echo "AL_TAG = \"${TAG_NAME}\""
+          echo "AL_COMMIT_SHA = \"local\""
+          echo "AL_COMMIT_DATE = \"null\"  # time zone : UTC"
+          echo "AL_BUILD_DATE = \"null\"  # time zone : UTC"
+          echo 'AL_VERSION_FULL = f"{AL_VERSION} ({AL_COMMIT_SHA})"'
+        } > "$VER_INFO_COMMITFILE"
+
+        echo "✓ ALVersionInfo.py files updated successfully"
+        echo ""
+        echo "Build version file location: $VER_INFO_BUILDFILE"
+        echo "Commit version file location: $VER_INFO_COMMITFILE"
+        echo ""
+        echo "Build version ALVersionInfo.py content ="
+        cat "$VER_INFO_BUILDFILE"
+        echo ""
+        echo "Commit version ALVersionInfo.py content "
+        cat "$VER_INFO_COMMITFILE"
+        echo "========================================"
+
+    - name: Check if ALVersionInfo.py was modified
+      id: check_changes
+      run: |
+        if git diff --quiet src/gui/ALVersionInfo.py; then
+          echo "has_changes=false" >> $GITHUB_OUTPUT
+          echo "! No changes detected in ALVersionInfo.py"
+        else
+          echo "has_changes=true" >> $GITHUB_OUTPUT
+          echo "✓ ALVersionInfo.py has been modified"
+        fi
+
+    - name: Upload modified ALVersionInfo.py ready for build
+      if: steps.check_changes.outputs.has_changes == 'true'
+      uses: actions/upload-artifact@v4
+      with:
+        name: updated-version-info-for-build
+        path: src/gui/temp/ALVersionInfo.py
+        retention-days: 1
+
+    - name: Upload modified ALVersionInfo.py ready for commit
+      if: steps.check_changes.outputs.has_changes == 'true'
+      uses: actions/upload-artifact@v4
+      with:
+        name: updated-version-info-for-commit
+        path: src/gui/ALVersionInfo.py
+        retention-days: 1
@@ -6,12 +6,16 @@
 __pycache__/
 build/
 dist/
-model/*.onnx
-driver/*.exe
-src/gui/configs/*.json
-src/gui/translators/qtbase_zh_CN.qm
-src/gui/AutoLibraryResources.py
-src/gui/AutoLibraryResource.py
-src/gui/Ui_ALMainWindow.py
-src/gui/Ui_ALConfigWidget.py
-Main.spec
+
+models/*.*
+drivers/*.*
+!models/*.md
+!drivers/*.md
+!templates/*.md
+!templates/configs/*.md
+
+src/gui/resources/ui/Ui_*.py
+src/gui/resources/translators/qtbase_zh_CN.qm
+src/gui/resources/ALResource.py
+
+Main.spec
@@ -0,0 +1,61 @@
+@echo off
+chcp 65001 >nul
+setlocal enabledelayedexpansion
+
+cd /d "%~dp0.."
+cd src/gui/resources
+
+echo [AutoLibrary compile] 检查翻译文件...
+if exist translators (
+    cd translators
+    set ts_count=0
+    for %%f in (*.ts) do set /a ts_count+=1
+
+    if !ts_count! gtr 0 (
+        echo [AutoLibrary compile] 找到 !ts_count! 个 .ts 文件，开始编译翻译文件...
+        for %%f in (*.ts) do (
+            set "qm_filename=%%~nf.qm"
+            echo [AutoLibrary compile] 正在编译翻译文件: "%%f" -> "!qm_filename!"
+
+            pyside6-lrelease "%%f"
+            if !errorlevel! equ 0 (
+                echo [AutoLibrary compile] 翻译文件 "%%f" 编译成功，输出文件: "!qm_filename!"
+            ) else (
+                echo [AutoLibrary compile] 翻译文件 "%%f" 编译失败
+            )
+        )
+    ) else (
+        echo [AutoLibrary compile] 未找到任何 .ts 翻译文件
+    )
+    cd ..
+) else (
+    echo [AutoLibrary compile] 未找到 translators 目录
+)
+echo.
+
+set count=0
+for %%f in (*.qrc) do set /a count+=1
+
+if %count% equ 0 (
+    echo [AutoLibrary compile] 错误: 未找到任何 .qrc 文件
+    pause
+    exit /b 1
+)
+
+echo [AutoLibrary compile] 找到 %count% 个 .qrc 文件，开始编译...
+echo.
+
+for %%f in (*.qrc) do (
+    set "filename=%%~nf"
+    set "output_file=!filename!.py"
+    echo [AutoLibrary compile] 正在编译: "%%f" -> "!output_file!"
+
+    pyside6-rcc "%%f" -o "!output_file!"
+    if !errorlevel! equ 0 (
+        echo [AutoLibrary compile] 文件 "%%f" 编译成功，输出文件: "!output_file!"
+    ) else (
+        echo [AutoLibrary compile] 文件 "%%f" 编译失败
+    )
+)
+
+echo [AutoLibrary compile] 所有操作完成。
@@ -0,0 +1,60 @@
+#!/bin/bash
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PRJECT_DIR="$SCRIPT_DIR/.."
+
+cd "$PRJECT_DIR/src/gui/resources"
+
+echo "[AutoLibrary compile] 检查翻译文件..."
+if [ -d "translators" ]; then
+    cd translators
+    ts_files=(*.ts)
+    ts_count=${#ts_files[@]}
+
+    if [ "$ts_count" -eq 1 ] && [ "${ts_files[0]}" = "*.ts" ]; then
+        ts_count=0
+    fi
+
+    if [ $ts_count -gt 0 ]; then
+        echo "[AutoLibrary compile] 找到 $ts_count 个 .ts 文件，开始编译翻译文件..."
+        for file in *.ts; do
+            base_name=$(basename "$file" .ts)
+            qm_file="${base_name}.qm"
+            echo "[AutoLibrary compile] 正在编译翻译文件: \"$file\" -> \"$qm_file\""
+
+            if pyside6-lrelease "$file"; then
+                echo "[AutoLibrary compile] 翻译文件 \"$file\" 编译成功，输出文件: \"$qm_file\""
+            else
+                echo "[AutoLibrary compile] 翻译文件 \"$file\" 编译失败"
+            fi
+        done
+    else
+        echo "[AutoLibrary compile] 未找到任何 .ts 翻译文件"
+    fi
+    cd ..
+else
+    echo "[AutoLibrary compile] 未找到 translators 目录"
+fi
+
+file_count=$(ls *.qrc 2>/dev/null | wc -l)
+
+if [ $file_count -eq 0 ]; then
+    echo "[AutoLibrary compile] 错误: 未找到任何 .qrc 文件"
+    exit 1
+fi
+
+echo "[AutoLibrary compile] 找到 $file_count 个 .qrc 文件，开始编译..."
+
+for file in *.qrc; do
+    base_name=$(basename "$file" .qrc)
+    output_file="${base_name}.py"
+    echo "[AutoLibrary compile] 正在编译: \"$file\" -> \"$output_file\""
+
+    if pyside6-rcc "$file" -o "$output_file"; then
+        echo "[AutoLibrary compile] 文件 \"$file\" 编译成功，输出文件: \"$output_file\""
+    else
+        echo "[AutoLibrary compile] 文件 \"$file\" 编译失败"
+    fi
+done
+
+echo "[AutoLibrary compile] 所有操作完成。"
@@ -0,0 +1,33 @@
+@echo off
+chcp 65001 >nul
+setlocal enabledelayedexpansion
+
+cd /d "%~dp0.."
+cd src/gui/resources/ui
+
+set count=0
+for %%f in (*.ui) do set /a count+=1
+
+if %count% equ 0 (
+    echo [AutoLibrary compile] 错误: 未找到任何 .ui 文件
+    pause
+    exit /b 1
+)
+
+echo [AutoLibrary compile] 找到 %count% 个 .ui 文件，开始编译...
+echo.
+
+for %%f in (*.ui) do (
+    set "filename=%%~nf"
+    set "output_file=Ui_!filename!.py"
+    echo [AutoLibrary compile] 正在编译: "%%f" -> "!output_file!"
+
+    pyside6-uic "%%f" -o "!output_file!"
+    if !errorlevel! equ 0 (
+        echo [AutoLibrary compile] 文件 "%%f" 编译成功，输出文件: "!output_file!"
+    ) else (
+        echo [AutoLibrary compile] 文件 "%%f" 编译失败
+    )
+)
+
+echo [AutoLibrary compile] 所有操作完成。
@@ -0,0 +1,29 @@
+#!/bin/bash
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PRJECT_DIR="$SCRIPT_DIR/.."
+
+cd "$PRJECT_DIR/src/gui/resources/ui"
+
+file_count=$(ls *.ui 2>/dev/null | wc -l)
+
+if [ $file_count -eq 0 ]; then
+    echo "[AutoLibrary compile] 错误: 未找到任何 .ui 文件"
+    exit 1
+fi
+
+echo "[AutoLibrary compile] 找到 $file_count 个 .ui 文件，开始编译..."
+
+for file in *.ui; do
+    base_name=$(basename "$file" .ui)
+    output_file="Ui_${base_name}.py"
+    echo "[AutoLibrary compile] 正在编译: \"$file\" -> \"$output_file\""
+
+    if pyside6-uic "$file" -o "$output_file"; then
+        echo "[AutoLibrary compile] 文件 \"$file\" 编译成功，输出文件: \"$output_file\""
+    else
+        echo "[AutoLibrary compile] 文件 \"$file\" 编译失败"
+    fi
+done
+
+echo "[AutoLibrary compile] 所有操作完成。"
@@ -0,0 +1 @@
+This folder is used to store the batch scripts.
@@ -1 +0,0 @@
-For more infomation, please visit our website: https://www.autolibrary.cv
@@ -1 +0,0 @@
-This folder is used to store the browser driver using by selenium.
@@ -0,0 +1 @@
+This folder is used to store the browser drivers using by selenium.
@@ -1,4 +1,4 @@
-Copyright 2025 KenanZhu
+Copyright 2025 - 2026 KenanZhu

 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:

@@ -0,0 +1,3 @@
+This folder is used to store the manuals.
+
+Our manuals are available at https://www.autolibrary.top/manuals
@@ -1 +0,0 @@
-This folder is used to store the model using by ddddocr.
@@ -0,0 +1 @@
+This folder is used to store the models using by ddddocr.
@@ -1,5 +1,120 @@

 # AutoLibrary
+---

-请访问[AutoLibrary 网站](http://autolibrary.cv)\
-Please access the [AutoLibrary Website](http://autolibrary.cv)
+![AutoLibrary Logo](./src/gui/resources/icons/AutoLibrary_128x128.ico)
+
+[![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)
+[![Build](https://img.shields.io/github/actions/workflow/status/KenanZhu/AutoLibrary/release.yml?label=release&logo=github-actions&logoColor=white)](https://github.com/KenanZhu/AutoLibrary/actions/workflows/release.yml)
+[![Release](https://img.shields.io/github/v/release/KenanZhu/AutoLibrary?label=latest&logo=github&logoColor=white)](https://github.com/KenanZhu/AutoLibrary/releases/latest)
+![Downloads](https://img.shields.io/github/downloads/KenanZhu/AutoLibrary/total?label=downloads)
+
+了解更多请访问 [_AutoLibrary 网站_](http://www.autolibrary.top)
+
+---
+
+### 功能
+
+1. 自动预约 - 支持自动预约
+2. 自动续约 - 支持自动续约
+3. 自动签到 - 支持自动签到
+4. 批量操作 - 支持同时预约多个用户，可以指定当前需要跳过的用户，并将用户分成多个组
+5. 定时任务 - 使用内置定时任务管理，添加定时任务，指定时间后按当前预约信息自动运行
+
+*1,2,3 的具体操作方法和注意事项请访问我们的 [帮助手册](https://www.autolibrary.top/manuals)*
+
+### 如何使用
+
+1. 下载最新版本的 [AutoLibrary 压缩包](https://github.com/KenanZhu/AutoLibrary/releases/latest)。
+2. 解压下载的文件到任意目录。
+3. 下载对应浏览器类型和版本（具体操作请参考适用软件版本的 [帮助手册](https://www.autolibrary.top/manuals)）的驱动文件，并在配置界面的运行配置选项卡对应位置选择你下载好的浏览器驱动。
+4. 运行 `AutoLibrary-[主版本号].[次版本号].[修订版本号].Z.exe` 文件 （如 `AutoLibrary-1.0.0.exe`）。
+5. 点击 [配置] 按钮，在配置界面填写好预约信息和运行配置后，点击 [确认] 按钮。
+6. 点击 [启动脚本] 按钮，即可开始自动预约、续约、签到等操作。
+
+*注意 1*: 关于浏览器驱动的下载和其它相关问题，请参考我们的 [帮助手册](https://www.autolibrary.top/manuals) 中对应软件版本的内容。
+
+#### 平台支持 & 编译步骤
+
+本工具目前仅支持 Windows 平台，由于使用 PySide6 库开发，理论上是可以自行编译并在 Linux 和 macOS 上运行，这里提供简单的编译步骤：
+
+1. 确保系统安装了 Python 3.13 版本 （推荐，过低或高版本会导致兼容问题）。
+2. 安装 pyside6 selenium ddddocr 库，命令为 `pip install pyside6 selenium ddddocr`。
+3. 在 `batchs` 目录下运行 `compile_ui.bat` （linux 和 macOS 系统使用 `compile_ui.sh`） 文件来编译 Qt 的 UI 文件。
+4. 在上一步相同目录内运行 `compile_rc.bat` （linux 和 macOS 系统使用 `compile_rc.sh`） 文件来编译 Qt 的资源文件。
+5. 待上述步骤完成后，运行 `src/Main.py` 文件即可。
+
+*注意 1*：如果 python 使用的是虚拟环境，请在虚拟环境安装依赖后，在激活的虚拟环境终端中使用 `cd src/gui/batchs` 命令切换到 `batchs` 目录下，再运行编译脚本。否则会提示缺少必要的 Qt PySide 依赖库。
+
+*注意 2*：由于 ddddocr 的代码版本问题，其中 `__init__.py` 文件中的函数 `def classification(self, img: bytes):` 中的 `image.resize` 方法传入了不符合当前 pillow 版本的 `resample` 参数 `Image.ANTIALIAS`，该重采样常量已经在 10.0.0 版中删除 [1](@ref)。请将 `image.resize` 方法中的参数替换为 `resample=Image.Resampling.LANCZOS`，具体函数如下：
+```python
+def classification(self, img: bytes):
+        image = Image.open(io.BytesIO(img))
+        image = image.resize((int(image.size[0]*(64/image.size[1])), 64), Image.ANTIALIAS).convert('L')
+                                                                              ^^^^^
+                                                                     请将上述参数替换为 `Image.Resampling.LANCZOS`
+
+        ...
+```
+
+[1](@ref)：[pillow 中已经删除或已经弃用的常量](https://pillow.ac.cn/en/stable/deprecations.html#constants)
+
+### 注意事项
+
+#### 关于预约等操作
+
+工具会自动处理登录过程的验证码识别过程，正常情况下单次识别准确率在 90% 以上，如遇验证码识别错误，大概率是校园网网络环境不佳导致的。
+
+只要确保处于校园网网络环境内，工具都是可以正常运行的。操作处理速度基本上取决于校园网的网络环境，一般情况下在 3-4 秒（不考虑硬件差异）左右即可完成一个用户的操作，完全满足正常使用需求。
+
+> [!NOTE]
+> 工具仅作为正常的预约，签到和续约的图书馆辅助工具，请勿干扰图书馆的正常运行（如故意预约多个座位，或同时预约大量的用户等，对此影响图书馆正常运行本工具概不负责，请在善用工具方便自己的情况下尽量不用影响其他同学的使用）。
+
+#### 关于批量操作
+
+批量操作时，建议将需要操作的用户分成多个组，每个组的用户数量不要超过 4 人（即一整张桌子的数量），否则会影响操作效率，大量用户同时预约会一定程度上增加图书馆服务器的压力，影响正常使用。根据需要在用户管理界面中可以勾选本次操作是否跳过该用户，以提高运行效率。
+
+#### 关于定时任务
+
+定时任务会在指定的时间自动运行，运行时会根据当前预约信息进行操作。一般情况下不建议设置两个运行开始时间比较接近的定时任务，否则后一个任务会等待前一个任务完成后才会运行，按照队列的顺序执行。
+
+### Q&A
+
+#### 为什么开发这个工具？
+
+当前图书馆的座位预约系统在使用中确实会遇到一些不便。例如，系统登录界面较为陈旧，在输入验证码时，若出现错误常常需要全部重新填写，过程繁琐。尤其在网络环境不稳定的情况下，登录和加载速度缓慢，让人难以快速完成当天的签到或预约次日座位。
+此外，当朋友需要帮忙预约座位时，手动操作也会分散自己学习和工作的注意力。
+因此，很希望有一个便捷的工具能自动处理这些预约、续约和签到等操作，从而让自己从这些琐碎事务中解脱出来，更专注于手头的重要事项。
+
+#### 工具后续会收费吗？
+
+不会，本工具完全免费使用，也不会有任何额外收费项。如果你觉工具对你很有帮助，可以为我捐助一瓶饮料的价格，以用于 AutoLibrary 网站的维护和软件的稳定更新。
+
+<a href="https://afdian.com/a/autolibrary" style="display:inline-block;padding:10px 30px;background:linear-gradient(135deg,#946CE6,#946CE6);color:white;text-decoration:none;border-radius:6px;font-weight:bold;">❤ 支持作者</a>
+
+#### 会有手机端的版本吗？
+
+暂时没有考虑，而且也没有足够的时间和能力开发多平台的版本并测试维护，所以暂时只提供 Windows 版本。
+
+#### 后续会有哪些功能？
+
+当前版本的功能对于正常使用已经足够，不过后续会着重完善预约时的使用体验，暂时有以下构想：
+
+- 引入交互预约面板功能，预约时直接在座位分布图中选择可用座位，并按用户分配，无需事先配置预约信息。
+- 优化定时任务管理功能，用户可以在定时任务管理界面设置重复运行的定时任务，如每日预约、每周预约等。
+- 软件的自动更新以及公告栏功能，用户可以自动更新最新版本并获取最新公告事项。
+
+不过由于本人的时间和能力有限，也需要考虑到图书馆的正常运行，所以后续功能会有所取舍，但也许会进行一些小的功能验证。
+
+#### 其他功能建议？
+
+如果你有其他功能建议，或者遇到了什么功能性，操作上的问题，欢迎提交 Issue 到本项目。
+如果你有足够的开发能力，欢迎为本项目提交 PR，也可以 Fork 本项目，根据自己的需求进行修改和完善。
+
+### 联系我
+
+- 项目维护：[KenanZhu (Nanoki)](https://github.com/KenanZhu)
+- 电子邮箱：<nanoki_zh@163.com>
+
+_**Free to use** —— AutoLibrary 是一个基于 MIT 协议免费开源的工具_
@@ -1,20 +1,31 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+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 sys

-from PySide6.QtCore import QTranslator
+from PySide6.QtCore import QTranslator, QStandardPaths, QDir
 from PySide6.QtWidgets import QApplication

 from gui.ALMainWindow import ALMainWindow
-from gui import AutoLibraryResource
+from gui.resources import ALResource

+from utils.ConfigManager import instance
+
+
+def initializeConfigManager():
+
+    app_dir = QStandardPaths.writableLocation(QStandardPaths.StandardLocation.AppDataLocation)
+    config_dir = os.path.join(app_dir, "config")
+    if not QDir(config_dir).exists():
+        QDir().mkpath(config_dir)
+    instance(config_dir)

 def main():

@@ -23,6 +34,8 @@ def main():
    if translator.load(":/res/trans/translators/qtbase_zh_CN.ts"):
        app.installTranslator(translator)
    app.setStyle('Fusion')
+    app.setApplicationName("AutoLibrary")
+    initializeConfigManager()
    window = ALMainWindow()
    window.show()
    sys.exit(app.exec_())
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+Copyright (c) 2025 - 2026 KenanZhu.
 All rights reserved.

 This software is provided "as is", without any warranty of any kind.
@@ -13,6 +13,13 @@ 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,
@@ -1,17 +1,33 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+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
+import datetime


 class MsgBase:
+    """
+        Base class for message and trace abilities (thread-safe).
+
+        This class provides the foundation for message handling and tracing
+        abilities based on the provided input and output queues. It enables
+        thread-safe communication between components using queue-based messaging.
+
+        Args:
+            input_queue (queue.Queue): The input queue for receiving messages.
+            output_queue (queue.Queue): The output queue for sending messages.
+
+        Usage:
+            This class must be initialized with input and output queues. The queue
+            provider (the caller of this class or its subclasses) must explicitly
+            implement queue polling to retrieve and process messages.
+    """

    def __init__(
        self,
@@ -29,7 +45,7 @@ class MsgBase:
        msg: str
    ):

-        self._output_queue.put(f"[{self._class_name:<12}] >>> : {msg}")
+        self._output_queue.put(f"[{self._class_name:<15}] >>> : {msg}")


    def _showTrace(
@@ -37,8 +53,8 @@ class MsgBase:
        msg: str
    ):

-        timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
-        self._output_queue.put(f"{timestamp}-[{self._class_name:<12}] : {msg}")
+        timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S.%f")[:-3]
+        self._output_queue.put(f"{timestamp}-[{self._class_name:<15}] : {msg}")


    def _waitMsg(
@@ -51,15 +67,3 @@ class MsgBase:
            return msg
        except queue.Empty:
            return None
-
-
-    def _inputMsg(
-        self,
-        timeout: float = 1.0
-    ) -> bool:
-
-        try:
-            self._input_queue.get(timeout=timeout)
-            return True
-        except queue.Empty:
-            return False
@@ -0,0 +1,147 @@
+# -*- 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 platform
+
+from PySide6.QtGui import (
+    QIcon, QFont
+)
+from PySide6.QtWidgets import (
+    QDialog, QApplication
+)
+from PySide6.QtCore import (
+    QTimer, Qt
+)
+
+from gui.ALVersionInfo import (
+    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
+
+
+class ALAboutDialog(QDialog, Ui_ALAboutDialog):
+
+    def __init__(
+        self,
+        parent = None
+    ):
+        super().__init__(parent)
+
+        self.setupUi(self)
+        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)
+
+
+    def connectSignals(
+        self
+    ):
+
+        self.CopyButton.clicked.connect(self.copyAboutInfo)
+
+
+    def generateAboutText(
+        self
+    ) -> str:
+
+        os_info = self.getOSInfo()
+        about_text = f"""
+<h4>Version Information:</h4>
+Version: {AL_VERSION}<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>
+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.top" style="text-decoration: none;">https://www.autolibrary.top</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>
+"""
+        return about_text
+
+
+    def getOSInfo(
+        self
+    ):
+
+        system = platform.system()
+        version = platform.version()
+        architecture = platform.architecture()[0]
+
+        if system == "Windows":
+            try:
+                version = platform.win32_ver()[1]
+            except:
+                pass
+        elif system == "Darwin":
+            try:
+                version = platform.mac_ver()[0]
+            except:
+                pass
+        elif system == "Linux":
+            try:
+                import distro # try to get Linux distro info
+                version = f"{distro.name()} {distro.version()}"
+            except ImportError:
+                pass
+
+        return {
+            'system': system,
+            'version': version,
+            'architecture': architecture
+        }
+
+
+    def getQtVersion(
+        self
+    ):
+
+        try:
+            from PySide6.QtCore import qVersion
+            return qVersion()
+        except:
+            return "Unknown"
+
+
+    def copyAboutInfo(
+        self
+    ):
+
+        about_text = self.AboutInfoBrowser.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))
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+Copyright (c) 2025 - 2026 KenanZhu.
 All rights reserved.

 This software is provided "as is", without any warranty of any kind.
@@ -8,148 +8,153 @@ You may use, modify, and distribute this file under the terms of the MIT License
 See the LICENSE file for details.
 """
 import os
-import sys
-import time
 import queue

 from PySide6.QtCore import (
-    Qt, Signal, Slot, QDir, QFileInfo, QTimer, QThread
+    Qt, Signal, Slot, QTimer, QDir, QUrl,
 )
 from PySide6.QtWidgets import (
-    QMainWindow, QMenu
+    QMainWindow, QMenu, QSystemTrayIcon, QMessageBox
 )
 from PySide6.QtGui import (
-    QTextCursor, QCloseEvent, QFont, QIcon
+    QTextCursor, QCloseEvent, QFont, QIcon, QDesktopServices
 )

-from .Ui_ALMainWindow import Ui_ALMainWindow
-from .ALConfigWidget import ALConfigWidget
+from base.MsgBase import MsgBase

-from . import AutoLibraryResource
+from utils.ConfigManager import ConfigType, instance
+from utils.ConfigManager import getValidateAutomationConfigPaths

-from operators.AutoLib import AutoLib
-from utils.ConfigReader import ConfigReader
+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


-class AutoLibWorker(QThread):
+class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):

-    finishedSignal = Signal()
-    showTraceSignal = Signal(str)
-    showMsgSignal = Signal(str)
-
-    def __init__(
-        self,
-        input_queue: queue.Queue,
-        output_queue: queue.Queue,
-        config_paths: dict
-    ):
-
-        super().__init__()
-
-        self.__input_queue = input_queue
-        self.__output_queue = output_queue
-        self.__config_paths = config_paths
-        self.__stopped = False
-
-
-    def checkTimeAvailable(
-        self,
-    ) -> bool:
-
-        current_time = time.strftime("%H:%M", time.localtime())
-        if current_time >= "23:30" or current_time <= "07:30":
-            return False
-        return True
-
-
-    def checkConfigPaths(
-        self,
-    ) -> bool:
-
-        if not all(
-            os.path.exists(path) for path in self.__config_paths.values()
-        ):
-            self.showTraceSignal.emit(
-                "配置文件路径不存在, 请检查配置文件路径是否正确。"
-            )
-            return False
-        return True
-
-
-    def run(
-        self
-    ):
-
-        auto_lib = None
-        try:
-            if not self.checkTimeAvailable():
-                self.showTraceSignal.emit(
-                    "当前时间不在图书馆开放时间内。\n"\
-                    "    请在 07:30 - 23:30 之间尝试"
-                )
-                return
-            if not self.checkConfigPaths():
-                return
-            self.showTraceSignal.emit("AutoLibrary 开始运行")
-            auto_lib = AutoLib(
-                self.__input_queue,
-                self.__output_queue,
-            )
-            auto_lib.run(
-                ConfigReader(self.__config_paths["system"]),
-                ConfigReader(self.__config_paths["users"]),
-            )
-        except Exception as e:
-            self.showTraceSignal.emit(
-                f"AutoLibrary 运行时发生异常 : {e}"
-            )
-        finally:
-            if auto_lib:
-                auto_lib.close()
-            self.showTraceSignal.emit("AutoLibrary 运行结束")
-            self.finishedSignal.emit()
-
-
-    def stop(
-        self
-    ):
-
-        self.__stopped = True
-
-
-class ALMainWindow(QMainWindow, Ui_ALMainWindow):
+    # signal : timer task
+    timerTaskIsRunning = Signal(dict)
+    timerTaskIsExecuted = Signal(dict)
+    timerTaskIsError = Signal(dict)

    def __init__(
        self
    ):

-        super().__init__()
-        self.__class_name = self.__class__.__name__
-
-        self.setupUi(self)
-        self.__input_queue = queue.Queue()
-        self.__output_queue = queue.Queue()
-        script_path = sys.executable
-        script_dir = QFileInfo(script_path).absoluteDir()
-        self.__config_paths = {
-            "system":   QDir.toNativeSeparators(script_dir.absoluteFilePath("system.json")),
-            "users": QDir.toNativeSeparators(script_dir.absoluteFilePath("users.json")),
-        }
+        MsgBase.__init__(self, queue.Queue(), queue.Queue())
+        QMainWindow.__init__(self)
+        self.__cfg_mgr = instance()
+        self.__timer_task_queue = queue.Queue()
+        self.__config_paths = getValidateAutomationConfigPaths()
+        self.__alTimerTaskManageWidget = None
        self.__alConfigWidget = None
        self.__auto_lib_thread = None
+        self.__current_timer_task_thread = None
+        self.__is_running_timer_task = False

+        self.setupUi(self)
        self.modifyUi()
+        self.setupTray()
        self.connectSignals()
        self.startMsgPolling()
+        self.startTimerTaskPolling()


    def modifyUi(
        self
    ):

-        icon = QIcon(":/res/icon/icons/AutoLibrary.ico")
-        self.setWindowIcon(icon)
+        self.icon = QIcon(":/res/icon/icons/AutoLibrary_32x32.ico")
+        self.setWindowIcon(self.icon)
        self.MessageIOTextEdit.setFont(QFont("Courier New", 10))
+        self.ManualAction.triggered.connect(self.onManualActionTriggered)
+        self.AboutAction.triggered.connect(self.onAboutActionTriggered)
+
+        # initialize timer task widget, but not show it
+        try:
+            self.__alTimerTaskManageWidget = ALTimerTaskManageWidget(self)
+        except Exception as e:
+            QMessageBox.critical(
+                self,
+                "错误 - AutoLibrary",
+                f"初始化定时任务功能失败: \n{e}"
+            )
+            self.__alTimerTaskManageWidget = None
+            self.TimerTaskManageWidgetButton.setEnabled(False)
+            self.TimerTaskManageWidgetButton.setToolTip("定时任务功能初始化失败, 请检查配置文件。")
+            return
+        self.timerTaskIsRunning.connect(self.__alTimerTaskManageWidget.onTimerTaskIsRunning)
+        self.timerTaskIsExecuted.connect(self.__alTimerTaskManageWidget.onTimerTaskIsExecuted)
+        self.timerTaskIsError.connect(self.__alTimerTaskManageWidget.onTimerTaskIsError)
+        self.__alTimerTaskManageWidget.timerTaskIsReady.connect(self.onTimerTaskIsReady)
+        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()
+
+
+    def onManualActionTriggered(
+        self
+    ):
+
+        url = QUrl("https://www.autolibrary.top/manuals")
+        QDesktopServices.openUrl(url)
+
+
+    def setupTray(
+        self
+    ):
+
+        if not QSystemTrayIcon.isSystemTrayAvailable():
+            self.showTraceSignal.emit(
+                "系统不支持系统托盘功能, 无法创建系统托盘图标。"
+            )
+            return
+        self.TrayIcon = QSystemTrayIcon(self.icon, self)
+        self.TrayIcon.setToolTip("AutoLibrary")
+
+        self.TrayMenu = QMenu()
+        self.TrayMenu.addAction("显示主窗口", self.showNormal)
+        self.TrayMenu.addAction("显示定时窗口", self.onTimerTaskManageWidgetButtonClicked)
+        self.TrayMenu.addAction("最小化到托盘", self.hideToTray)
+        self.TrayMenu.addSeparator()
+        self.TrayMenu.addAction("退出", self.close)
+        self.TrayIcon.setContextMenu(self.TrayMenu)
+
+        self.TrayIcon.setContextMenu(self.TrayMenu)
+        self.TrayIcon.activated.connect(self.onTrayIconActivated)
+        self.TrayIcon.show()
+
+
+    def hideToTray(
+        self
+    ):
+
+        self.hide()
+        self.TrayIcon.showMessage(
+            "AutoLibrary",
+            "\n已最小化到托盘",
+            QSystemTrayIcon.MessageIcon.Information,
+            2000
+        )
+
+
+    def onTrayIconActivated(
+        self,
+        reason: QSystemTrayIcon.ActivationReason
+    ):
+
+        if reason == QSystemTrayIcon.DoubleClick:
+            self.showNormal()


    def connectSignals(
@@ -157,6 +162,7 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
    ):

        self.ConfigButton.clicked.connect(self.onConfigButtonClicked)
+        self.TimerTaskManageWidgetButton.clicked.connect(self.onTimerTaskManageWidgetButtonClicked)
        self.StartButton.clicked.connect(self.onStartButtonClicked)
        self.StopButton.clicked.connect(self.onStopButtonClicked)
        self.SendButton.clicked.connect(self.onSendButtonClicked)
@@ -168,10 +174,19 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
        event: QCloseEvent
    ):

-        if self.__timer and self.__timer.isActive():
-            self.__timer.stop()
+        if self.__msg_queue_timer and self.__msg_queue_timer.isActive():
+            self.__msg_queue_timer.stop()
+        if self.__timer_task_timer and self.__timer_task_timer.isActive():
+            self.__timer_task_timer.stop()
+        if self.__is_running_timer_task:
+            self.__current_timer_task_thread.wait(2000)
+            self.__current_timer_task_thread.deleteLater()
+        if self.__alTimerTaskManageWidget:
+            self.__alTimerTaskManageWidget.close()
+            self.__alTimerTaskManageWidget.deleteLater()
        if self.__alConfigWidget:
            self.__alConfigWidget.close()
+            # the config widget is already deleted in the 'self.onConfigWidgetClosed'
        super().closeEvent(event)


@@ -193,38 +208,68 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
        self
    ):

-        self.__timer = QTimer()
-        self.__timer.timeout.connect(self.pollMsgQueue)
-        self.__timer.start(100)
+        self.__msg_queue_timer = QTimer()
+        self.__msg_queue_timer.timeout.connect(self.pollMsgQueue)
+        self.__msg_queue_timer.start(100)
+
+
+    def startTimerTaskPolling(
+        self
+    ):
+
+        self.__timer_task_timer = QTimer()
+        self.__timer_task_timer.timeout.connect(self.pollTimerTaskQueue)
+        self.__timer_task_timer.start(500)
+
+
+    def pollTimerTaskQueue(
+        self
+    ):
+
+        if self.__is_running_timer_task:
+            return
+        try:
+            while not self.__is_running_timer_task:
+                timer_task = self.__timer_task_queue.get_nowait()
+                self.timerTaskIsRunning.emit(timer_task)
+                self.__timer_task_timer.stop()
+                self.__is_running_timer_task = True
+                self.setControlButtons(None, True, False)
+                if not timer_task["silent"]:
+                    self.TrayIcon.showMessage(
+                        "定时任务 - AutoLibrary",
+                        f"\n已开始执行定时任务: \n{timer_task['name']}",
+                        QSystemTrayIcon.MessageIcon.Information,
+                        1000
+                    )
+                    self.showNormal()
+                self.__current_timer_task_thread = TimerTaskWorker(
+                    timer_task,
+                    self._input_queue,
+                    self._output_queue,
+                    self.__config_paths
+                )
+                self.__current_timer_task_thread.timerTaskWorkerIsFinished.connect(self.onTimerTaskFinished)
+                self.__current_timer_task_thread.start()
+        except queue.Empty:
+            self.__is_running_timer_task = False
+            pass


    def setControlButtons(
        self,
        config_button_enabled: bool,
-        start_button_enabled: bool,
-        stop_button_enabled: bool
+        stop_button_enabled: bool,
+        start_button_enabled: bool
    ):

-        self.ConfigButton.setEnabled(config_button_enabled)
-        self.StartButton.setEnabled(start_button_enabled)
-        self.StopButton.setEnabled(stop_button_enabled)
-
-    @Slot()
-    def showMsg(
-        self,
-        msg: str
-    ):
-
-        self.appendToTextEdit(f"[{self.__class_name:<12}] >>> : {msg}")
-
-    @Slot()
-    def showTrace(
-        self,
-        msg: str
-    ):
-
-        timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
-        self.appendToTextEdit(f"{timestamp}-[{self.__class_name:<12}] : {msg}")
+        # if the enable is None, then keep the original state
+        if config_button_enabled is not None:
+            self.ConfigButton.setEnabled(config_button_enabled)
+        if stop_button_enabled is not None:
+            self.StopButton.setEnabled(stop_button_enabled)
+        if start_button_enabled is not None:
+            self.StartButton.setEnabled(start_button_enabled)

    @Slot()
    def pollMsgQueue(
@@ -233,25 +278,75 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):

        try:
            while True:
-                msg = self.__output_queue.get_nowait()
+                msg = self._output_queue.get_nowait()
                self.appendToTextEdit(msg)
        except queue.Empty:
            pass

+    @Slot()
+    def onTimerTaskManageWidgetClosed(
+        self
+    ):
+
+        self.TimerTaskManageWidgetButton.setEnabled(True)
+
    @Slot(dict)
    def onConfigWidgetClosed(
-        self,
-        config_paths: dict
+        self
    ):

        if self.__alConfigWidget:
-            self.__alConfigWidget.configWidgetCloseSingal.disconnect(self.onConfigWidgetClosed)
+            self.__alConfigWidget.configWidgetIsClosed.disconnect(self.onConfigWidgetClosed)
            self.__alConfigWidget.deleteLater()
            self.__alConfigWidget = None
-        self.ConfigButton.setEnabled(True)
-        self.StartButton.setEnabled(True)
-        self.StopButton.setEnabled(False)
-        self.__config_paths = config_paths
+        self.setControlButtons(True, None, None)
+
+    @Slot(dict)
+    def onTimerTaskIsReady(
+        self,
+        timer_task: dict
+    ):
+
+        self.__timer_task_queue.put(timer_task)
+
+    @Slot(dict)
+    def onTimerTaskFinished(
+        self,
+        is_error: bool,
+        timer_task: dict
+    ):
+
+        self.__current_timer_task_thread.wait(1000)
+        self.__current_timer_task_thread.timerTaskWorkerIsFinished.disconnect(self.onTimerTaskFinished)
+        self.__current_timer_task_thread.deleteLater()
+        self.__current_timer_task_thread = None
+        self.setControlButtons(None, False, True)
+        self.__is_running_timer_task = False
+        self.__timer_task_timer.start(500)
+        timer_task["executed"] = True
+        self.TrayIcon.showMessage(
+            "定时任务 - AutoLibrary",
+            f"\n定时任务 '{timer_task['name']}' 执行{'失败' if is_error else '完成'}",
+            QSystemTrayIcon.MessageIcon.Information,
+            1000
+        )
+        self._showTrace(
+            f"定时任务 {timer_task['name']} 执行{'失败' if is_error else '完成'}, uuid: {timer_task['task_uuid']}"
+        )
+        if not is_error:
+            self.timerTaskIsExecuted.emit(timer_task)
+        else:
+            self.timerTaskIsError.emit(timer_task)
+
+    @Slot()
+    def onTimerTaskManageWidgetButtonClicked(
+        self
+    ):
+
+        self.__alTimerTaskManageWidget.show()
+        self.__alTimerTaskManageWidget.raise_()
+        self.__alTimerTaskManageWidget.activateWindow()
+        self.TimerTaskManageWidgetButton.setEnabled(False)

    @Slot()
    def onConfigButtonClicked(
@@ -259,13 +354,8 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
    ):

        if self.__alConfigWidget is None:
-            self.__alConfigWidget = ALConfigWidget(
-                self,
-                self.__config_paths
-            )
-            self.__alConfigWidget.configWidgetCloseSingal.connect(self.onConfigWidgetClosed)
-        self.__alConfigWidget.setWindowFlags(Qt.Window)
-        self.__alConfigWidget.setWindowModality(Qt.ApplicationModal)
+            self.__alConfigWidget = ALConfigWidget(self)
+            self.__alConfigWidget.configWidgetIsClosed.connect(self.onConfigWidgetClosed)
        self.__alConfigWidget.show()
        self.__alConfigWidget.raise_()
        self.__alConfigWidget.activateWindow()
@@ -276,16 +366,15 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
        self
    ):

-        self.setControlButtons(False, False, True)
+        self.setControlButtons(None, True, False)
        if self.__auto_lib_thread is None:
            self.__auto_lib_thread = AutoLibWorker(
-                self.__input_queue,
-                self.__output_queue,
-                self.__config_paths,
+                self._input_queue,
+                self._output_queue,
+                self.__config_paths
            )
-            self.__auto_lib_thread.finishedSignal.connect(self.onStopButtonClicked)
-            self.__auto_lib_thread.showMsgSignal.connect(self.showMsg)
-            self.__auto_lib_thread.showTraceSignal.connect(self.showTrace)
+            self.__auto_lib_thread.autoLibWorkerIsFinished.connect(self.onStopButtonClicked)
+            self.__auto_lib_thread.autoLibWorkerFinishedWithError.connect(self.onStopButtonClicked)
        self.__auto_lib_thread.start()

    @Slot()
@@ -294,16 +383,14 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
    ):

        if self.__auto_lib_thread:
-            self.showTrace("正在停止操作......")
-            self.__auto_lib_thread.stop()
-            self.__auto_lib_thread.wait()
-            self.showTrace("操作已停止")
-            self.__auto_lib_thread.showMsgSignal.disconnect(self.showMsg)
-            self.__auto_lib_thread.showTraceSignal.disconnect(self.showTrace)
-            self.__auto_lib_thread.finishedSignal.disconnect(self.onStopButtonClicked)
+            self._showTrace("正在停止操作......")
+            self.__auto_lib_thread.wait(2000)
+            self._showTrace("操作已停止")
+            self.__auto_lib_thread.autoLibWorkerIsFinished.disconnect(self.onStopButtonClicked)
+            self.__auto_lib_thread.autoLibWorkerFinishedWithError.disconnect(self.onStopButtonClicked)
            self.__auto_lib_thread.deleteLater()
            self.__auto_lib_thread = None
-        self.setControlButtons(True, True, False)
+        self.setControlButtons(None, False, True)

    @Slot()
    def onSendButtonClicked(
@@ -313,5 +400,6 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
        msg = self.MessageEdit.text().strip()
        if not msg:
            return
-        self.showMsg(msg)
+        self._showMsg(msg)
+        self._input_queue.put(msg) # put message to input queue
        self.MessageEdit.clear()
@@ -0,0 +1,166 @@
+# -*- 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 time
+import queue
+
+from PySide6.QtCore import (
+    Slot, Signal, QThread
+)
+
+from base.MsgBase import MsgBase
+from operators.AutoLib import AutoLib
+from utils.JSONReader import JSONReader
+
+
+class AutoLibWorker(MsgBase, QThread):
+
+    autoLibWorkerIsFinished = Signal()
+    autoLibWorkerFinishedWithError = Signal()
+
+    def __init__(
+        self,
+        input_queue: queue.Queue,
+        output_queue: queue.Queue,
+        config_paths: dict
+    ):
+
+        MsgBase.__init__(self, input_queue, output_queue)
+        QThread.__init__(self)
+        self.__config_paths = config_paths
+
+
+    def checkTimeAvailable(
+        self,
+    ) -> bool:
+
+        current_time = time.strftime("%H:%M", time.localtime())
+        if current_time >= "23:30" or current_time <= "07:30":
+            self._showTrace(
+                "当前时间不在图书馆开放时间内, 请在 07:30 - 23:30 之间尝试"
+            )
+            return False
+        return True
+
+
+    def checkConfigPaths(
+        self,
+    ) -> bool:
+
+        if not all(
+            os.path.exists(path) for path in self.__config_paths.values()
+        ):
+            self._showTrace("配置文件路径不存在, 请检查配置文件路径是否正确")
+            return False
+        return True
+
+
+    def loadConfigs(
+        self
+    ) -> bool:
+
+        self._showTrace(
+            f"正在加载配置文件, 运行配置文件路径: {self.__config_paths["run"]}"
+        )
+        self.__run_config = JSONReader(self.__config_paths["run"]).data()
+        self._showTrace(
+            f"正在加载配置文件, 用户配置文件路径: {self.__config_paths["user"]}"
+        )
+        self.__user_config = JSONReader(self.__config_paths["user"]).data()
+        if self.__run_config is None or self.__user_config is None:
+            self._showTrace("配置文件加载失败, 请检查配置文件是否正确")
+            self._showTrace("配置文件加载失败, 请检查配置文件是否正确")
+            return False
+        if not self.__user_config.get("groups"):
+            self._showTrace(
+                "用户配置文件中无有效任务组, 请检查用户配置文件是否正确"
+            )
+            return False
+        return True
+
+
+    def run(
+        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
+        else:
+            try:
+                if not self.loadConfigs():
+                    raise Exception("配置文件加载失败")
+                auto_lib = AutoLib(
+                    self._input_queue,
+                    self._output_queue,
+                    self.__run_config
+                )
+                groups = self.__user_config.get("groups")
+                for group in groups:
+                    if not group["enabled"]:
+                        self._showTrace(f"任务组 {group["name"]} 已跳过")
+                        continue
+                    self._showTrace(f"正在运行任务组 {group["name"]}")
+                    auto_lib.run(
+                        { "users": group.get("users", []) }
+                    )
+            except Exception as e:
+                self._showTrace(f"AutoLibrary 运行时发生异常 : {e}")
+                self.autoLibWorkerFinishedWithError.emit()
+                return
+        if auto_lib:
+            auto_lib.close()
+        self._showTrace("AutoLibrary 运行结束")
+        self.autoLibWorkerIsFinished.emit()
+
+
+class TimerTaskWorker(AutoLibWorker):
+
+    timerTaskWorkerIsFinished = Signal(bool, dict)
+
+    def __init__(
+        self,
+        timer_task: dict,
+        input_queue: queue.Queue,
+        output_queue: queue.Queue,
+        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 run(
+        self
+    ):
+
+        self._showTrace(f"定时任务 {self.__timer_task['name']} 开始运行")
+        super().run()
+
+    @Slot()
+    def onTimerTaskFinishedWithError(
+        self
+    ):
+
+        self._showTrace(f"定时任务 {self.__timer_task['name']} 运行时发生异常")
+        self.timerTaskWorkerIsFinished.emit(True, self.__timer_task)
+
+    @Slot()
+    def onTimerTaskIsFinished(
+        self
+    ):
+
+        self._showTrace(f"定时任务 {self.__timer_task['name']} 运行结束")
+        self.timerTaskWorkerIsFinished.emit(False, self.__timer_task)
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+Copyright (c) 2025 - 2026 KenanZhu.
 All rights reserved.

 This software is provided "as is", without any warranty of any kind.
@@ -15,22 +15,23 @@ from PySide6.QtWidgets import (
 )


-class SeatFrame(QFrame):
+class ALSeatFrame(QFrame):

    clicked = Signal(str)

    def __init__(
        self,
        seat_number,
-        parent=None
+        parent = None
    ):

        super().__init__(parent)
        self.__seat_number = seat_number
        self.__is_selected = False
-        self.setUpUi()

-    def setUpUi(
+        self.setupUi()
+
+    def setupUi(
        self
    ):

@@ -39,18 +40,19 @@ class SeatFrame(QFrame):
        self.setLineWidth(2)
        self.setStyleSheet("""
            QFrame {
-                background-color: #4196EB;
-                border: 2px solid #4196EB;
+                background-color: #2294FF;
+                border: 2px solid #2294FF;
                border-radius: 5px;
            }
            QLabel {
-                color: #F0F0F0;
+                color: #FFFFFF;
                font-weight: bold;
            }
        """)
-        self.label = QLabel(self.__seat_number, self)
-        self.label.setAlignment(Qt.AlignCenter)
-        self.label.setGeometry(0, 0, 60, 40)
+        self.setCursor(Qt.CursorShape.PointingHandCursor)
+        self.Label = QLabel(self.__seat_number, self)
+        self.Label.setAlignment(Qt.AlignCenter)
+        self.Label.setGeometry(0, 0, 60, 40)

    def mousePressEvent(
        self,
@@ -76,24 +78,24 @@ class SeatFrame(QFrame):
            self.setStyleSheet("""
                QFrame {
                    background-color: #4CAF50;
-                    border: 2px solid #388E3C;
+                    border: 2px solid #4CAF50;
                    border-radius: 5px;
                    color: white;
                }
                QLabel {
-                    color: #F0F0F0;
+                    color: #FFFFFF;
                    font-weight: bold;
                }
            """)
        else:
            self.setStyleSheet("""
                QFrame {
-                    background-color: #4196EB;
-                    border: 2px solid #4196EB;
+                    background-color: #2294FF;
+                    border: 2px solid #2294FF;
                    border-radius: 5px;
                }
                QLabel {
-                    color: #F0F0F0;
+                    color: #FFFFFF;
                    font-weight: bold;
                }
            """)
@@ -0,0 +1,178 @@
+# -*- 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.
+"""
+from PySide6.QtCore import (
+    Qt, Slot, Signal
+)
+from PySide6.QtWidgets import (
+    QDialog, QLabel, QHBoxLayout, QVBoxLayout,
+    QPushButton,
+)
+from PySide6.QtGui import (
+    QCloseEvent
+)
+
+from gui.ALSeatMapView import ALSeatMapView
+
+
+class ALSeatMapSelectDialog(QDialog):
+
+    seatMapSelectDialogIsClosed = Signal(list)
+
+    def __init__(
+        self,
+        parent: QDialog = None,
+        floor: str = "",
+        room: str = "",
+        seats_data: str = ""
+    ):
+
+        super().__init__(parent)
+        self.__floor = floor
+        self.__room = room
+        self.__seats_data = seats_data
+        self.__confirmed = False
+
+        self.setupUi()
+        self.connectSignals()
+
+
+    def setupUi(
+        self
+    ):
+
+        self.setModal(True)
+        self.setMinimumSize(800, 600)
+        self.resize(800, 600)
+        self.setWindowTitle(f"选择楼层座位 - AutoLibrary")
+
+        self.SeatMapWidgetMainLayout = QVBoxLayout(self)
+        self.SeatMapWidgetMainLayout.setContentsMargins(5, 5, 5, 5)
+        self.SeatMapWidgetMainLayout.setSpacing(5)
+        self.TitleLabel = QLabel(f"楼层座位分布图: {self.__floor}-{self.__room}")
+        self.TitleLabel.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        self.TitleLabel.setStyleSheet("font-size: 16px; font-weight: bold; margin: 10px;")
+        self.SeatMapWidgetMainLayout.addWidget(self.TitleLabel)
+
+        self.SeatMapGraphicsView = ALSeatMapView(None, self.__seats_data)
+        self.SeatMapWidgetMainLayout.addWidget(self.SeatMapGraphicsView)
+
+        self.TipsLabel = QLabel(
+            "  点击座位进行选择/取消选择, 最多选择1个座位 \n"
+            "  [操作方法: Ctrl+鼠标滚轮缩放 | 滚轮/拖拽/方向键 移动]"
+        )
+        self.TipsLabel.setAlignment(Qt.AlignmentFlag.AlignLeft)
+        self.TipsLabel.setStyleSheet("color: #666; margin: 5px;")
+        self.SeatMapWidgetMainLayout.addWidget(self.TipsLabel)
+
+        self.ConfirmButton = QPushButton("确认")
+        self.ConfirmButton.setFixedSize(80, 25)
+        self.ConfirmButton.setAutoDefault(True)
+        self.ConfirmButton.setDefault(True)
+        self.CancelButton = QPushButton("取消")
+        self.CancelButton.setFixedSize(80, 25)
+        self.SeatMapWidgetControlLayout = QHBoxLayout()
+        self.SeatMapWidgetControlLayout.setContentsMargins(0, 0, 0, 0)
+        self.SeatMapWidgetControlLayout.setSpacing(5)
+        self.SeatMapWidgetControlLayout.setAlignment(Qt.AlignmentFlag.AlignRight)
+        self.SeatMapWidgetControlLayout.addWidget(self.CancelButton)
+        self.SeatMapWidgetControlLayout.addWidget(self.ConfirmButton)
+        self.SeatMapWidgetMainLayout.addLayout(self.SeatMapWidgetControlLayout)
+
+
+    def connectSignals(
+        self
+    ):
+
+        self.ConfirmButton.clicked.connect(self.onConfirmButtonClicked)
+        self.CancelButton.clicked.connect(self.onCancelButtonClicked)
+
+
+    def showEvent(
+        self,
+        event
+    ):
+
+        result = super().showEvent(event)
+
+        screen_rect = self.screen().geometry()
+        target_pos = self.parent().geometry().center()
+        target_pos.setX(target_pos.x() - self.width()//2)
+        target_pos.setY(target_pos.y() - self.height()//2)
+        if target_pos.x() < 0:
+            target_pos.setX(0)
+        if target_pos.x() + self.width() > screen_rect.width():
+            target_pos.setX(screen_rect.width() - self.width())
+        if target_pos.y() < 0:
+            target_pos.setY(0)
+        if target_pos.y() + self.height() > screen_rect.height():
+            target_pos.setY(screen_rect.height() - self.height())
+        self.move(target_pos)
+
+        return result
+
+
+    def closeEvent(
+        self,
+        event: QCloseEvent
+    ):
+
+        if not self.__confirmed:
+            self.clearSelections()
+            self.reject()
+        else:
+            self.accept()
+        self.seatMapSelectDialogIsClosed.emit(self.getSelectedSeats())
+        super().closeEvent(event)
+
+
+    def selectSeat(
+        self,
+        seat_number: str
+    ):
+
+        self.SeatMapGraphicsView.selectSeat(seat_number)
+
+
+    def selectSeats(
+        self,
+        seat_numbers: list[str]
+    ) -> bool:
+
+        return self.SeatMapGraphicsView.selectSeats(seat_numbers)
+
+
+    def getSelectedSeats(
+        self
+    ) -> list[str]:
+
+        return self.SeatMapGraphicsView.getSelectedSeats()
+
+
+    def clearSelections(
+        self
+    ):
+
+        self.SeatMapGraphicsView.clearSelections()
+
+    @Slot()
+    def onConfirmButtonClicked(
+        self
+    ):
+
+        self.__confirmed = True
+        self.accept()
+
+    @Slot()
+    def onCancelButtonClicked(
+        self
+    ):
+
+        self.__confirmed = False
+        self.reject()
@@ -1,4 +1,4 @@
-seats_maps = {
+ALSeatMapTable = {
    "2": {
        "1": """
 ,,,,,,,,,,,039A,039B,,040A,040B,,041A,041B,,042A,042B,,043A,043B,,044A,044B,,,,,,,,,
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+Copyright (c) 2025 - 2026 KenanZhu.
 All rights reserved.

 This software is provided "as is", without any warranty of any kind.
@@ -8,40 +8,32 @@ 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, QEvent
+    Qt, Slot, QEvent
 )
 from PySide6.QtWidgets import (
-    QFrame, QWidget, QLabel, QHBoxLayout, QVBoxLayout,
-    QGridLayout, QGraphicsView, QGraphicsScene, QGraphicsItem,
-    QPushButton,
+    QFrame, QWidget,
+    QGridLayout, QGraphicsView, QGraphicsScene, QGraphicsItem
 )
 from PySide6.QtGui import (
-    QPainter, QWheelEvent, QCloseEvent
+    QPainter, QWheelEvent
 )
-from gui.SeatFrame import SeatFrame
+
+from gui.ALSeatFrame import ALSeatFrame


-class SeatMapWidget(QWidget):
-
-    seatMapWidgetClosed = Signal(list)
+class ALSeatMapView(QGraphicsView):

    def __init__(
        self,
        parent: QWidget = None,
-        floor: str = "",
-        room: str = "",
        seats_data: dict = {},
    ):
-
        super().__init__(parent)
-
-        self.__floor = floor
-        self.__room = room
        self.__seats_data = seats_data
        self.__selected_seats = []
        self.__seat_frames = {}
-        self.setUpUi()
-        self.connectSignals()
+
+        self.setupUi()

    @staticmethod
    def formatSeatNumber(
@@ -55,82 +47,13 @@ class SeatMapWidget(QWidget):
        return seat_number.zfill(3)


-    def setUpUi(
-        self
-    ):
-
-        self.setWindowFlags(Qt.WindowType.Window)
-        self.setWindowModality(Qt.WindowModality.ApplicationModal)
-        self.setMinimumSize(800, 600)
-        self.resize(800, 600)
-        self.setWindowTitle(f"选择楼层座位 - AutoLibrary")
-
-        self.SeatMapWidgetMainLayout = QVBoxLayout(self)
-        self.TitleLabel = QLabel(f"楼层座位分布图: {self.__floor}-{self.__room}")
-        self.TitleLabel.setAlignment(Qt.AlignmentFlag.AlignCenter)
-        self.TitleLabel.setStyleSheet("font-size: 16px; font-weight: bold; margin: 10px;")
-        self.SeatMapWidgetMainLayout.addWidget(self.TitleLabel)
-
-        self.SeatMapGraphicsView = QGraphicsView(self)
-        self.SeatMapGraphicsScene = QGraphicsScene(self)
-        self.SeatMapGraphicsView.setScene(self.SeatMapGraphicsScene)
-        self.SeatMapGraphicsView.setRenderHint(QPainter.RenderHint.LosslessImageRendering)
-        self.SeatMapGraphicsView.setDragMode(QGraphicsView.DragMode.ScrollHandDrag)
-        self.SeatMapGraphicsView.setVerticalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAsNeeded)
-        self.SeatMapGraphicsView.setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAsNeeded)
-        self.SeatMapGraphicsView.viewport().installEventFilter(self)
-
-        self.SeatsContainerWidget = QWidget()
-        self.SeatsContainerLayout = QGridLayout(self.SeatsContainerWidget)
-        self.createSeatMap()
-
-        self.ContainerProxy = self.SeatMapGraphicsScene.addWidget(self.SeatsContainerWidget)
-        self.ContainerProxy.setFlag(QGraphicsItem.GraphicsItemFlag.ItemIsSelectable, False)
-        self.SeatMapWidgetMainLayout.addWidget(self.SeatMapGraphicsView)
-
-        self.TipsLabel = QLabel(
-            "  点击座位进行选择/取消选择, 最多选择1个座位 \n"
-            "  [操作方法: Ctrl+鼠标滚轮缩放 | 滚轮/拖拽/方向键 移动]"
-        )
-        self.TipsLabel.setAlignment(Qt.AlignmentFlag.AlignLeft)
-        self.TipsLabel.setStyleSheet("color: #666; margin: 5px;")
-        self.SeatMapWidgetMainLayout.addWidget(self.TipsLabel)
-
-        self.ConfirmButton = QPushButton("确认")
-        self.ConfirmButton.setFixedSize(80, 25)
-        self.CancelButton = QPushButton("取消")
-        self.CancelButton.setFixedSize(80, 25)
-        self.SeatMapWidgetControlLayout = QHBoxLayout()
-        self.SeatMapWidgetControlLayout.setAlignment(Qt.AlignmentFlag.AlignRight)
-        self.SeatMapWidgetControlLayout.addWidget(self.CancelButton)
-        self.SeatMapWidgetControlLayout.addWidget(self.ConfirmButton)
-        self.SeatMapWidgetMainLayout.addLayout(self.SeatMapWidgetControlLayout)
-
-
-    def connectSignals(
-        self
-    ):
-
-        self.ConfirmButton.clicked.connect(self.onConfirmButtonClicked)
-        self.CancelButton.clicked.connect(self.onCancelButtonClicked)
-
-
-    def closeEvent(
-        self,
-        event: QCloseEvent
-    ):
-
-        self.seatMapWidgetClosed.emit(self.__selected_seats)
-        super().closeEvent(event)
-
-
    def eventFilter(
        self,
        watched,
        event
    ):

-        if (watched is self.SeatMapGraphicsView.viewport() and
+        if (watched is self.viewport() and
            event.type() == QEvent.Type.Wheel and
            event.modifiers() == Qt.KeyboardModifier.ControlModifier
        ):
@@ -145,12 +68,40 @@ class SeatMapWidget(QWidget):
    ):

        delta = event.angleDelta().y()
+        min_scale = 0.1
+        max_scale = 4.0
+        current_scale = self.transform().m11()
        zoom_factor = 1.2 if delta > 0 else 1/1.2
-        self.SeatMapGraphicsView.setTransformationAnchor(QGraphicsView.ViewportAnchor.AnchorUnderMouse)
-        self.SeatMapGraphicsView.scale(zoom_factor, zoom_factor)
+        target_scale = current_scale*zoom_factor
+        if target_scale < min_scale and delta < 0:
+            return
+        if target_scale > max_scale and delta > 0:
+            return
+        self.setTransformationAnchor(QGraphicsView.ViewportAnchor.AnchorUnderMouse)
+        self.scale(zoom_factor, zoom_factor)


-    def createSeatMap(
+    def setupUi(
+        self
+    ):
+
+        self.SeatMapGraphicsScene = QGraphicsScene(self)
+        self.setScene(self.SeatMapGraphicsScene)
+        self.setRenderHint(QPainter.RenderHint.LosslessImageRendering)
+        self.setDragMode(QGraphicsView.DragMode.ScrollHandDrag)
+        self.setVerticalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAsNeeded)
+        self.setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAsNeeded)
+        self.viewport().installEventFilter(self)
+
+        self.SeatsContainerWidget = QWidget()
+        self.SeatsContainerLayout = QGridLayout(self.SeatsContainerWidget)
+        self.setupSeatMap()
+
+        self.ContainerProxy = self.SeatMapGraphicsScene.addWidget(self.SeatsContainerWidget)
+        self.ContainerProxy.setFlag(QGraphicsItem.GraphicsItemFlag.ItemIsSelectable, False)
+
+
+    def setupSeatMap(
        self
    ):

@@ -160,7 +111,7 @@ class SeatMapWidget(QWidget):
            seats_number = [seat.strip() for seat in row.split(",")]
            for seat_number in seats_number:
                if seat_number:
-                    seat_widget = SeatFrame(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
@@ -234,19 +185,4 @@ class SeatMapWidget(QWidget):
            if len(self.__selected_seats) < 1:
                self.__selected_seats.append(seat_number)
            else:
-                self.__seat_frames[seat_number].toggleSelection()
-
-    @Slot()
-    def onConfirmButtonClicked(
-        self
-    ):
-
-        self.close()
-
-    @Slot()
-    def onCancelButtonClicked(
-        self
-    ):
-
-        self.clearSelections()
-        self.close()
+                self.__seat_frames[seat_number].toggleSelection()
@@ -0,0 +1,143 @@
+# -*- 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 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 gui.resources.ui.Ui_ALTimerTaskAddDialog import Ui_ALTimerTaskAddDialog
+
+
+class ALTimerTaskStatus(Enum):
+
+    PENDING = "等待中"
+    READY = "已就绪"
+    RUNNING = "执行中"
+    EXECUTED = "已执行"
+    ERROR = "执行失败"
+    OUTDATED = "已过期"
+
+
+class ALTimerTaskAddDialog(QDialog, Ui_ALTimerTaskAddDialog):
+
+    def __init__(
+        self,
+        parent = None
+    ):
+
+        super().__init__(parent)
+
+        self.setupUi(self)
+        self.connectSignals()
+        self.modifyUi()
+
+
+    def modifyUi(
+        self
+    ):
+
+        self.TimerTypeComboBox.setCurrentIndex(0)
+        self.SpecificTimerWidget = QWidget()
+        self.SpecificTimerLayout = QHBoxLayout(self.SpecificTimerWidget)
+        self.SpecificTimerLayout.addWidget(QLabel("定时时间："))
+        self.SpecificDateTimeEdit = QDateTimeEdit()
+        self.SpecificDateTimeEdit.setCalendarPopup(True)
+        self.SpecificDateTimeEdit.setDisplayFormat("yyyy-MM-dd HH:mm:ss")
+        self.SpecificDateTimeEdit.setMinimumDateTime(QDateTime.currentDateTime())
+        self.SpecificDateTimeEdit.setDateTime(QDateTime.currentDateTime().addSecs(60))
+        self.SpecificTimerLayout.addWidget(self.SpecificDateTimeEdit)
+        self.TimerConfigLayout.addWidget(self.SpecificTimerWidget)
+
+        self.RelativeTimerWidget = QWidget()
+        self.RelativeTimerLayout = QGridLayout(self.RelativeTimerWidget)
+        self.RelativeTimerLayout.addWidget(QLabel("相对时间："), 0, 0)
+        self.RelativeDaySpinBox = QSpinBox()
+        self.RelativeDaySpinBox.setMinimum(0)
+        self.RelativeDaySpinBox.setMaximum(365)
+        self.RelativeDaySpinBox.setSuffix("天")
+        self.RelativeTimerLayout.addWidget(self.RelativeDaySpinBox, 1, 0)
+        self.RelativeHourSpinBox = QSpinBox()
+        self.RelativeHourSpinBox.setMinimum(0)
+        self.RelativeHourSpinBox.setMaximum(23)
+        self.RelativeHourSpinBox.setSuffix("时")
+        self.RelativeTimerLayout.addWidget(self.RelativeHourSpinBox, 1, 1)
+        self.RelativeMinuteSpinBox = QSpinBox()
+        self.RelativeMinuteSpinBox.setMinimum(0)
+        self.RelativeMinuteSpinBox.setMaximum(59)
+        self.RelativeMinuteSpinBox.setSuffix("分")
+        self.RelativeTimerLayout.addWidget(self.RelativeMinuteSpinBox, 1, 2)
+        self.RelativeSecondSpinBox = QSpinBox()
+        self.RelativeSecondSpinBox.setMinimum(0)
+        self.RelativeSecondSpinBox.setMaximum(59)
+        self.RelativeSecondSpinBox.setSuffix("秒")
+        self.RelativeTimerLayout.addWidget(self.RelativeSecondSpinBox, 1, 3)
+        self.TimerConfigLayout.addWidget(self.RelativeTimerWidget)
+        self.RelativeTimerWidget.setVisible(False)
+
+
+    def connectSignals(
+        self
+    ):
+
+        self.CancelButton.clicked.connect(self.reject)
+        self.ConfirmButton.clicked.connect(self.accept)
+        self.TimerTypeComboBox.currentIndexChanged.connect(self.onTimerTypeComboBoxIndexChanged)
+
+
+    def getTimerTask(
+        self
+    ) -> dict:
+
+        added_time = datetime.now()
+        if not self.TaskNameLineEdit.text():
+            name = f"未命名任务-{added_time.strftime("%Y%m%d%H%M%S")}"
+        else:
+            name = self.TaskNameLineEdit.text()
+        timer_type_index = self.TimerTypeComboBox.currentIndex()
+        silent = not self.ShowBeforeRunRadioButton.isChecked()
+        if timer_type_index == 0:
+            execute_time = self.SpecificDateTimeEdit.dateTime()
+            tmp_time_str = execute_time.toString("yyyy-MM-dd HH:mm:ss")
+            execute_time = datetime.strptime(tmp_time_str, "%Y-%m-%d %H:%M:%S")
+        else:
+            execute_time = datetime.now() + timedelta(
+                days = self.RelativeDaySpinBox.value(),
+                hours = self.RelativeHourSpinBox.value(),
+                minutes = self.RelativeMinuteSpinBox.value(),
+                seconds = self.RelativeSecondSpinBox.value()
+            )
+        return {
+            "name": name,
+            "task_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,
+            "add_time": added_time,
+            "status": ALTimerTaskStatus.PENDING,
+            "executed": False
+        }
+
+
+    @Slot(int)
+    def onTimerTypeComboBoxIndexChanged(
+        self,
+        index: int
+    ):
+
+        self.SpecificTimerWidget.setVisible(index == 0)
+        self.RelativeTimerWidget.setVisible(index == 1)
@@ -0,0 +1,486 @@
+# -*- 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 sys
+import copy
+
+from enum import Enum
+from datetime import datetime, timedelta
+
+from PySide6.QtCore import (
+    Qt, Signal, Slot, QTimer, QFileInfo, QDir
+)
+from PySide6.QtWidgets import (
+    QDialog, QWidget, QListWidgetItem, QMessageBox,
+    QHBoxLayout, QVBoxLayout, QLabel, QPushButton
+)
+from PySide6.QtGui import (
+    QCloseEvent
+)
+
+from utils.ConfigManager import ConfigType, instance
+
+from gui.resources.ui.Ui_ALTimerTaskManageWidget import Ui_ALTimerTaskManageWidget
+from gui.ALTimerTaskAddDialog import ALTimerTaskAddDialog, ALTimerTaskStatus
+
+
+class ALTimerTaskItemWidget(QWidget):
+
+    def __init__(
+        self,
+        parent = None,
+        timer_task: dict = None
+    ):
+
+        super().__init__(parent)
+        self.__timer_task = timer_task
+
+        self.modifyUi()
+
+
+    def modifyUi(
+        self
+    ):
+
+        self.ItemWidgetLayout = QHBoxLayout(self)
+        self.ItemWidgetLayout.setSpacing(10)
+        self.ItemWidgetLayout.setContentsMargins(10, 5, 10, 5)
+
+        self.TaskInfoLayout = QVBoxLayout()
+        self.TaskInfoLayout.setSpacing(5)
+        TaskNameLabel = QLabel(self.__timer_task["name"])
+        TaskNameLabelFont = TaskNameLabel.font()
+        TaskNameLabelFont.setBold(True)
+        TaskNameLabel.setFont(TaskNameLabelFont)
+        TaskNameLabel.setFixedHeight(25)
+        self.TaskInfoLayout.addWidget(TaskNameLabel)
+
+        ExecuteTimeStr = self.__timer_task["execute_time"].strftime("%Y-%m-%d %H:%M:%S")
+        ExecuteTimeLabel = QLabel(f"执行时间: {ExecuteTimeStr}")
+        ExecuteTimeLabel.setStyleSheet("color: #969696;")
+        ExecuteTimeLabel.setFixedHeight(20)
+        self.TaskInfoLayout.addWidget(ExecuteTimeLabel)
+
+        self.ItemWidgetLayout.addLayout(self.TaskInfoLayout)
+        self.ItemWidgetLayout.addStretch()
+
+        match self.__timer_task["status"]:
+            case ALTimerTaskStatus.PENDING:
+                TaskStatusText = "等待中"
+                TaskStatusColor = "#FF9800"
+            case ALTimerTaskStatus.READY:
+                TaskStatusText = "已就绪"
+                TaskStatusColor = "#316BFF"
+            case ALTimerTaskStatus.RUNNING:
+                TaskStatusText = "执行中"
+                TaskStatusColor = "#2294FF"
+            case ALTimerTaskStatus.EXECUTED:
+                TaskStatusText = "已执行"
+                TaskStatusColor = "#4CAF50"
+            case ALTimerTaskStatus.ERROR:
+                TaskStatusText = "执行失败"
+                TaskStatusColor = "#DC0000"
+            case ALTimerTaskStatus.OUTDATED:
+                TaskStatusText = "已过期"
+                TaskStatusColor = "#DC0000"
+        TaskStatusLabel = QLabel(TaskStatusText)
+        TaskStatusLabel.setStyleSheet(f"""
+            QLabel {{
+                background-color: {TaskStatusColor};
+                color: #FFFFFF;
+                border-radius: 5px;
+                font-weight: bold;
+            }}
+        """)
+        TaskStatusLabel.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        TaskStatusLabel.setFixedSize(80, 25)
+        self.ItemWidgetLayout.addWidget(TaskStatusLabel)
+
+        TaskModeText = "静默" if self.__timer_task["silent"] else "显示"
+        TaskModeColor = "#6325FF" if self.__timer_task["silent"] else "#2294FF"
+        TaskModeLabel = QLabel(TaskModeText)
+        TaskModeLabel.setStyleSheet(f"""
+            QLabel {{
+                background-color: {TaskModeColor};
+                color: #FFFFFF;
+                border-radius: 5px;
+                font-weight: bold;
+            }}
+        """)
+        TaskModeLabel.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        TaskModeLabel.setFixedSize(60, 25)
+        self.ItemWidgetLayout.addWidget(TaskModeLabel)
+
+        self.DeleteButton = QPushButton("删除")
+        self.DeleteButton.setFixedSize(80, 25)
+        self.ItemWidgetLayout.addWidget(self.DeleteButton)
+        if self.__timer_task["status"] == ALTimerTaskStatus.READY\
+        or self.__timer_task["status"] == ALTimerTaskStatus.RUNNING:
+            self.DeleteButton.setEnabled(False)
+        self.setFixedHeight(55)
+
+
+class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
+
+    class SortPolicy(Enum):
+
+        BY_NAME = "按名称"
+        BY_ADD_TIME = "按添加时间"
+        BY_EXECUTE_TIME = "按执行时间"
+
+    timerTaskIsReady = Signal(dict)
+    timerTasksChanged = Signal()
+    timerTaskManageWidgetIsClosed = Signal()
+
+    def __init__(
+        self,
+        parent = None
+    ):
+
+        super().__init__(parent)
+        self.__cfg_mgr = instance()
+        self.__timer_tasks = []
+        self.__check_timer = None
+        self.__sort_policy = self.SortPolicy.BY_EXECUTE_TIME
+        self.__sort_order = Qt.SortOrder.AscendingOrder
+
+        self.setupUi(self)
+        self.connectSignals()
+        self.setupTimer()
+        if not self.initializeTimerTasks():
+            raise Exception("定时任务配置文件初始化失败 !")
+
+
+    def connectSignals(
+        self
+    ):
+
+        self.AddTimerTaskButton.clicked.connect(self.addTask)
+        self.ClearAllTimerTasksButton.clicked.connect(self.clearAllTasks)
+        self.TimerTaskSortTypeComboBox.currentIndexChanged.connect(self.onSortPolicyComboBoxChanged)
+        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)
+
+
+    def initializeTimerTasks(
+        self
+    ) -> bool:
+
+        timer_tasks = self.getTimerTasks()
+        if timer_tasks is not None:
+            self.__timer_tasks = timer_tasks
+            self.timerTasksChanged.emit()
+            return True
+        timer_tasks = []
+        if self.setTimerTasks(copy.deepcopy(timer_tasks)):
+            self.__timer_tasks = timer_tasks
+            return True
+        return False
+
+
+    def getTimerTasks(
+        self
+    ) -> list:
+
+        try:
+            timer_tasks = self.__cfg_mgr.get(ConfigType.TIMERTASK)
+            if timer_tasks and "timer_tasks" in timer_tasks:
+                for task in timer_tasks["timer_tasks"]:
+                    task["add_time"] = datetime.strptime(task["add_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"])
+                return timer_tasks["timer_tasks"]
+            raise Exception("定时任务配置文件格式错误")
+        except Exception as e:
+            QMessageBox.warning(
+                self,
+                "警告 - AutoLibrary",
+                f"加载定时任务配置发生错误 ! : \n{e}"
+            )
+            return None
+
+
+    def setTimerTasks(
+        self,
+        timer_tasks: list
+    ) -> bool:
+
+        try:
+            for task in timer_tasks:
+                task["add_time"] = task["add_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
+            self.__cfg_mgr.set(ConfigType.TIMERTASK, "", { "timer_tasks": timer_tasks })
+            return True
+        except Exception as e:
+            QMessageBox.warning(
+                self,
+                "警告 - AutoLibrary",
+                f"保存定时任务配置发生错误 ! : \n{e}"
+            )
+            return False
+
+
+    def showEvent(
+        self,
+        event
+    ):
+
+        result = super().showEvent(event)
+
+        screen_rect = self.screen().geometry()
+        target_pos = self.parent().geometry().center()
+        target_pos.setX(target_pos.x() - self.width()//2)
+        target_pos.setY(target_pos.y() - self.height()//2)
+        if target_pos.x() < 0:
+            target_pos.setX(0)
+        if target_pos.x() + self.width() > screen_rect.width():
+            target_pos.setX(screen_rect.width() - self.width())
+        if target_pos.y() < 0:
+            target_pos.setY(0)
+        if target_pos.y() + self.height() > screen_rect.height():
+            target_pos.setY(screen_rect.height() - self.height())
+        self.move(target_pos)
+
+        return result
+
+
+    def closeEvent(
+        self,
+        event: QCloseEvent
+    ):
+
+        self.hide()
+        self.timerTaskManageWidgetIsClosed.emit()
+        event.ignore()
+
+
+    def sortTimerTasks(
+        self,
+        policy: SortPolicy = SortPolicy.BY_EXECUTE_TIME,
+        order: Qt.SortOrder = Qt.SortOrder.AscendingOrder
+    ):
+
+        if policy == self.SortPolicy.BY_NAME:
+            self.__timer_tasks.sort(
+                key = lambda x: x["name"],
+                reverse = order is Qt.SortOrder.DescendingOrder
+            )
+        elif policy == self.SortPolicy.BY_ADD_TIME:
+            self.__timer_tasks.sort(
+                key = lambda x: x["add_time"],
+                reverse = order is Qt.SortOrder.DescendingOrder
+            )
+        elif policy == self.SortPolicy.BY_EXECUTE_TIME:
+            self.__timer_tasks.sort(
+                key = lambda x: x["execute_time"],
+                reverse = order is Qt.SortOrder.DescendingOrder
+            )
+
+
+    def updateStat(
+        self
+    ):
+
+        pending = 0
+        in_queue = 0
+        executed = 0
+        invalid = 0
+        total = len(self.__timer_tasks)
+        for timer_task in self.__timer_tasks:
+            if timer_task["status"] == ALTimerTaskStatus.PENDING:
+                pending += 1
+            elif timer_task["status"] == ALTimerTaskStatus.READY\
+            or timer_task["status"] == ALTimerTaskStatus.RUNNING:
+                in_queue += 1
+            elif timer_task["status"] == ALTimerTaskStatus.EXECUTED:
+                executed += 1
+            elif timer_task["status"] == ALTimerTaskStatus.ERROR\
+            or timer_task["status"] == ALTimerTaskStatus.OUTDATED:
+                invalid += 1
+        self.TotalTaskLabel.setText(f"总任务：{total}")
+        self.PendingTaskLabel.setText(f"待执行：{pending}")
+        self.InQueueTaskLabel.setText(f"队列中：{in_queue}")
+        self.ExecutedTaskLabel.setText(f"已执行：{executed}")
+        self.InvalidTaskLabel.setText(f"无效的：{invalid}")
+
+
+    def updateTimerTaskList(
+        self
+    ):
+
+        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(
+                lambda _, uuid = timer_task["task_uuid"]: self.deleteTask(uuid)
+            )
+            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()
+            self.__timer_tasks.append(timer_task)
+            self.timerTasksChanged.emit()
+
+
+    def deleteTask(
+        self,
+        task_uuid: str
+    ):
+
+        self.__timer_tasks = [
+            x for x in self.__timer_tasks
+            if x["task_uuid"] != task_uuid
+        ]
+        self.timerTasksChanged.emit()
+
+
+    def clearAllTasks(
+        self
+    ):
+
+        if not self.__timer_tasks:
+            return
+        result = QMessageBox.question(
+            self,
+            "确认 - AutoLibrary",
+            "是否要清除所有定时任务 ?",
+            QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No
+        )
+        if result is QMessageBox.StandardButton.No:
+            return
+        in_queue_tasks = [
+            x for x in self.__timer_tasks
+            if x["status"] == ALTimerTaskStatus.READY
+            or x["status"] == ALTimerTaskStatus.RUNNING
+        ]
+        in_queue_count = len(in_queue_tasks)
+        if in_queue_count > 0:
+            QMessageBox.warning(
+                self,
+                "警告 - AutoLibrary",
+                "存在正在执行或已就绪的队列任务，无法清除所有定时任务 !"
+            )
+        self.__timer_tasks = in_queue_tasks
+        self.timerTasksChanged.emit()
+
+
+    def checkTasks(
+        self
+    ):
+
+        need_update = False
+
+        now = datetime.now()
+        for timer_task in self.__timer_tasks:
+            if timer_task["execute_time"] > now:
+                continue
+            if timer_task["status"] is not ALTimerTaskStatus.PENDING:
+                continue
+            if timer_task["execute_time"] <= now + timedelta(seconds = -5):
+                timer_task["status"] = ALTimerTaskStatus.OUTDATED
+                need_update = True
+            else:
+                timer_task["status"] = ALTimerTaskStatus.READY
+                self.timerTaskIsReady.emit(timer_task)
+                need_update = True
+        if need_update:
+            self.timerTasksChanged.emit()
+
+    @Slot(int)
+    def onSortPolicyComboBoxChanged(
+        self,
+        policy: int
+    ):
+
+        mapping = {
+            0: self.SortPolicy.BY_NAME,
+            1: self.SortPolicy.BY_ADD_TIME,
+            2: self.SortPolicy.BY_EXECUTE_TIME
+        }
+        self.__sort_policy = mapping[policy]
+        self.updateTimerTaskList()
+
+    @Slot()
+    def onSortOrderToggleButtonClicked(
+        self
+    ):
+
+        self.__sort_order = Qt.SortOrder.AscendingOrder\
+            if self.__sort_order is Qt.SortOrder.DescendingOrder\
+            else Qt.SortOrder.DescendingOrder
+        self.TimerTaskSortOrderToggleButton.setText(
+            "↑" if self.__sort_order is Qt.SortOrder.AscendingOrder else "↓"
+        )
+        self.updateTimerTaskList()
+
+    @Slot()
+    def onTimerTasksChanged(
+        self
+    ):
+
+        self.setTimerTasks(copy.deepcopy(self.__timer_tasks))
+        self.updateTimerTaskList()
+        self.updateStat()
+
+
+    @Slot(dict)
+    def onTimerTaskIsRunning(
+        self,
+        timer_task: dict
+    ):
+
+        for task in self.__timer_tasks:
+            if task["task_uuid"] == timer_task["task_uuid"]:
+                task["status"] = ALTimerTaskStatus.RUNNING
+        self.timerTasksChanged.emit()
+
+
+    @Slot(dict)
+    def onTimerTaskIsExecuted(
+        self,
+        timer_task: dict
+    ):
+
+        for task in self.__timer_tasks:
+            if task["task_uuid"] == timer_task["task_uuid"]:
+                task["status"] = ALTimerTaskStatus.EXECUTED
+        self.timerTasksChanged.emit()
+
+    @Slot(dict)
+    def onTimerTaskIsError(
+        self,
+        timer_task: dict
+    ):
+
+        for task in self.__timer_tasks:
+            if task["task_uuid"] == timer_task["task_uuid"]:
+                task["status"] = ALTimerTaskStatus.ERROR
+        self.timerTasksChanged.emit()
@@ -0,0 +1,149 @@
+# -*- 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.
+"""
+from enum import Enum
+
+from PySide6.QtCore import (
+    Qt, QSize, QCoreApplication, QRect, QPoint
+)
+from PySide6.QtWidgets import (
+    QAbstractScrollArea, QAbstractItemView,
+    QTreeWidget, QTreeWidgetItem
+)
+from PySide6.QtGui import (
+     QDragEnterEvent, QDragMoveEvent, QDropEvent
+)
+
+
+class ALUserTreeItemType(Enum):
+
+    GROUP = 0
+    USER = 1
+
+
+class ALUserTreeWidget(QTreeWidget):
+
+    def __init__(
+        self,
+        parent = None
+    ):
+
+        super().__init__(parent)
+
+        self.setupUi()
+        self.translateUi()
+
+
+    def setupUi(
+        self
+    ):
+
+        __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))
+        self.setSizeAdjustPolicy(QAbstractScrollArea.SizeAdjustPolicy.AdjustIgnored)
+        self.setTabKeyNavigation(True)
+        self.setDragEnabled(True)
+        self.setAcceptDrops(True)
+        self.setDropIndicatorShown(True)
+        self.setDragDropMode(QAbstractItemView.DragDropMode.InternalMove)
+        self.setDefaultDropAction(Qt.DropAction.IgnoreAction)
+        self.setAlternatingRowColors(True)
+        self.setSortingEnabled(True)
+        self.sortByColumn(0, Qt.SortOrder.AscendingOrder)
+        self.setAnimated(True)
+        self.setAllColumnsShowFocus(False)
+        self.setHeaderHidden(False)
+        self.setColumnCount(2)
+        self.setColumnWidth(0, 150)
+        self.setColumnWidth(1, 20)
+        self.header().setCascadingSectionResizes(False)
+        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));
+
+
+    @staticmethod
+    def isDragPositionValid(
+        target_rect: QRect,
+        drag_pos: QPoint,
+    ) -> bool:
+
+        y_offset = drag_pos.y() - target_rect.top()
+        valid = (y_offset > target_rect.height()*0.2 and
+            y_offset < target_rect.height()*0.8)
+        return valid
+
+
+    def dragEnterEvent(
+        self,
+        event: QDragEnterEvent
+    ):
+
+        super().dragEnterEvent(event)
+
+
+    def dragMoveEvent(
+        self,
+        event: QDragMoveEvent
+    ):
+
+        super().dragMoveEvent(event)
+
+        source_item = self.currentItem()
+        target_item = self.itemAt(event.position().toPoint())
+        if source_item is None:
+            event.ignore()
+            return
+        if source_item.type() == ALUserTreeItemType.GROUP.value:
+            if target_item is not None:
+                event.ignore()
+                return
+        elif source_item.type() == ALUserTreeItemType.USER.value:
+            if target_item is None:
+                event.ignore()
+                return
+            if target_item.type() != ALUserTreeItemType.GROUP.value:
+                event.ignore()
+                return
+            if target_item.checkState(1) == Qt.CheckState.Unchecked:
+                event.ignore()
+                return
+            if not self.isDragPositionValid(
+                self.visualItemRect(target_item),
+                event.position().toPoint()
+            ):
+                event.ignore()
+                return
+        else:
+            event.ignore()
+            return
+        event.acceptProposedAction()
+
+
+    def dropEvent(
+        self,
+        event: QDropEvent
+    ):
+
+        super().dropEvent(event)
+
+        for item_index in range(self.topLevelItemCount()):
+            self.topLevelItem(item_index).setExpanded(True)
+        self.setCurrentItem(None)
@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+
+"""
+    The contents of this file will automatically be updated by the
+    workflow process. Do not edit manually.
+
+    This file is auto-generated during the workflow process.
+    Last updated: 2026-02-26 15:04:28 UTC
+"""
+
+AL_VERSION = "1.1.0"
+AL_TAG = "v1.1.0"
+AL_COMMIT_SHA = "local"
+AL_COMMIT_DATE = "null"  # time zone : UTC
+AL_BUILD_DATE = "null"  # time zone : UTC
+AL_VERSION_FULL = f"{AL_VERSION} ({AL_COMMIT_SHA})"
@@ -1 +0,0 @@
-this folder is used to store the config files.
@@ -1,6 +1,6 @@
 <RCC>
    <qresource prefix="/res/icon">
-        <file>icons/AutoLibrary.ico</file>
+        <file>icons/AutoLibrary_32x32.ico</file>
    </qresource>
    <qresource prefix="/res/trans">
        <file>translators/qtbase_zh_CN.qm</file>
@@ -0,0 +1,178 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>ALAboutDialog</class>
+ <widget class="QDialog" name="ALAboutDialog">
+  <property name="geometry">
+   <rect>
+    <x>0</x>
+    <y>0</y>
+    <width>400</width>
+    <height>400</height>
+   </rect>
+  </property>
+  <property name="minimumSize">
+   <size>
+    <width>400</width>
+    <height>400</height>
+   </size>
+  </property>
+  <property name="maximumSize">
+   <size>
+    <width>800</width>
+    <height>400</height>
+   </size>
+  </property>
+  <property name="windowTitle">
+   <string>关于 - AutoLibrary</string>
+  </property>
+  <property name="sizeGripEnabled">
+   <bool>false</bool>
+  </property>
+  <layout class="QVBoxLayout" name="ALAboutDialogLayout">
+   <property name="spacing">
+    <number>5</number>
+   </property>
+   <property name="leftMargin">
+    <number>5</number>
+   </property>
+   <property name="topMargin">
+    <number>5</number>
+   </property>
+   <property name="rightMargin">
+    <number>5</number>
+   </property>
+   <property name="bottomMargin">
+    <number>5</number>
+   </property>
+   <item>
+    <layout class="QHBoxLayout" name="LogoLayout">
+     <property name="spacing">
+      <number>5</number>
+     </property>
+     <item>
+      <widget class="QLabel" name="LogoIconLabel">
+       <property name="minimumSize">
+        <size>
+         <width>56</width>
+         <height>56</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>56</width>
+         <height>56</height>
+        </size>
+       </property>
+       <property name="text">
+        <string/>
+       </property>
+       <property name="scaledContents">
+        <bool>true</bool>
+       </property>
+       <property name="indent">
+        <number>0</number>
+       </property>
+      </widget>
+     </item>
+     <item>
+      <widget class="QLabel" name="LogoTextLabel">
+       <property name="font">
+        <font>
+         <pointsize>24</pointsize>
+         <bold>true</bold>
+        </font>
+       </property>
+       <property name="lineWidth">
+        <number>0</number>
+       </property>
+       <property name="text">
+        <string>AutoLibrary</string>
+       </property>
+       <property name="margin">
+        <number>0</number>
+       </property>
+       <property name="indent">
+        <number>0</number>
+       </property>
+      </widget>
+     </item>
+    </layout>
+   </item>
+   <item>
+    <layout class="QHBoxLayout" name="AboutInfoLayout">
+     <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>
+    <widget class="QPushButton" name="CopyButton">
+     <property name="minimumSize">
+      <size>
+       <width>80</width>
+       <height>25</height>
+      </size>
+     </property>
+     <property name="maximumSize">
+      <size>
+       <width>80</width>
+       <height>25</height>
+      </size>
+     </property>
+     <property name="text">
+      <string>复制</string>
+     </property>
+    </widget>
+   </item>
+  </layout>
+ </widget>
+ <resources/>
+ <connections/>
+</ui>
@@ -34,13 +34,13 @@
     <number>5</number>
    </property>
    <property name="leftMargin">
-     <number>3</number>
+     <number>5</number>
    </property>
    <property name="topMargin">
     <number>0</number>
    </property>
    <property name="rightMargin">
-     <number>3</number>
+     <number>5</number>
    </property>
    <property name="bottomMargin">
     <number>0</number>
@@ -50,11 +50,33 @@
      <property name="spacing">
       <number>5</number>
      </property>
+      <item>
+       <widget class="QPushButton" name="TimerTaskManageWidgetButton">
+        <property name="minimumSize">
+         <size>
+          <width>25</width>
+          <height>25</height>
+         </size>
+        </property>
+        <property name="maximumSize">
+         <size>
+          <width>25</width>
+          <height>25</height>
+         </size>
+        </property>
+        <property name="text">
+         <string/>
+        </property>
+        <property name="icon">
+         <iconset theme="document-open-recent"/>
+        </property>
+       </widget>
+      </item>
      <item>
       <widget class="QFrame" name="ControlSpaceFrame">
        <property name="minimumSize">
         <size>
-          <width>1280</width>
+          <width>1000</width>
          <height>0</height>
         </size>
        </property>
@@ -134,11 +156,9 @@
         <string>&lt;html&gt;&lt;head/&gt;&lt;body&gt;&lt;p&gt;&lt;br/&gt;&lt;/p&gt;&lt;/body&gt;&lt;/html&gt;</string>
        </property>
        <property name="styleSheet">
-         <string notr="true">background-color: rgb(10, 170, 10);
-font: 12pt &quot;Microsoft YaHei UI&quot;;
-color: rgb(255, 255, 255);
-font: 9pt &quot;Segoe UI&quot;;
-font: 700 9pt &quot;Microsoft YaHei UI&quot;;</string>
+         <string notr="true">background-color: #0AAA0A;
+color: #FFFFFF;
+font: 700 9pt;</string>
        </property>
        <property name="text">
         <string>启动脚本</string>
@@ -237,6 +257,9 @@ font: 700 9pt &quot;Microsoft YaHei UI&quot;;</string>
        <property name="text">
         <string>发送</string>
        </property>
+        <property name="icon">
+         <iconset theme="document-send"/>
+        </property>
       </widget>
      </item>
     </layout>
@@ -245,7 +268,7 @@ font: 700 9pt &quot;Microsoft YaHei UI&quot;;</string>
  </widget>
  <widget class="QMenuBar" name="MenuBar">
   <property name="enabled">
-    <bool>false</bool>
+    <bool>true</bool>
   </property>
   <property name="geometry">
    <rect>
@@ -258,12 +281,33 @@ font: 700 9pt &quot;Microsoft YaHei UI&quot;;</string>
   <property name="nativeMenuBar">
    <bool>true</bool>
   </property>
+   <widget class="QMenu" name="HelpMenu">
+    <property name="mouseTracking">
+     <bool>true</bool>
+    </property>
+    <property name="title">
+     <string>帮助</string>
+    </property>
+    <addaction name="ManualAction"/>
+    <addaction name="AboutAction"/>
+   </widget>
+   <addaction name="HelpMenu"/>
  </widget>
  <widget class="QStatusBar" name="StatusBar">
   <property name="enabled">
    <bool>false</bool>
   </property>
  </widget>
+  <action name="ManualAction">
+   <property name="text">
+    <string>在线手册</string>
+   </property>
+  </action>
+  <action name="AboutAction">
+   <property name="text">
+    <string>关于</string>
+   </property>
+  </action>
 </widget>
 <resources/>
 <connections/>
@@ -0,0 +1,249 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>ALTimerTaskAddDialog</class>
+ <widget class="QDialog" name="ALTimerTaskAddDialog">
+  <property name="geometry">
+   <rect>
+    <x>0</x>
+    <y>0</y>
+    <width>300</width>
+    <height>300</height>
+   </rect>
+  </property>
+  <property name="minimumSize">
+   <size>
+    <width>0</width>
+    <height>300</height>
+   </size>
+  </property>
+  <property name="maximumSize">
+   <size>
+    <width>500</width>
+    <height>300</height>
+   </size>
+  </property>
+  <property name="windowTitle">
+   <string>添加定时任务 - AutoLibrary</string>
+  </property>
+  <property name="sizeGripEnabled">
+   <bool>true</bool>
+  </property>
+  <property name="modal">
+   <bool>true</bool>
+  </property>
+  <layout class="QVBoxLayout" name="ALAddTimerTaskLayout">
+   <property name="spacing">
+    <number>5</number>
+   </property>
+   <property name="leftMargin">
+    <number>5</number>
+   </property>
+   <property name="topMargin">
+    <number>5</number>
+   </property>
+   <property name="rightMargin">
+    <number>5</number>
+   </property>
+   <property name="bottomMargin">
+    <number>5</number>
+   </property>
+   <item>
+    <layout class="QHBoxLayout" name="TaskNameLayout">
+     <property name="spacing">
+      <number>5</number>
+     </property>
+     <item>
+      <widget class="QLabel" name="TaskNameLabel">
+       <property name="minimumSize">
+        <size>
+         <width>60</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>16777215</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="text">
+        <string>任务名称：</string>
+       </property>
+      </widget>
+     </item>
+     <item>
+      <widget class="QLineEdit" name="TaskNameLineEdit"/>
+     </item>
+    </layout>
+   </item>
+   <item>
+    <widget class="QGroupBox" name="TimerConfigGroupBox">
+     <property name="title">
+      <string>定时设置</string>
+     </property>
+     <layout class="QVBoxLayout" name="TimerConfigLayout">
+      <property name="spacing">
+       <number>5</number>
+      </property>
+      <property name="leftMargin">
+       <number>3</number>
+      </property>
+      <property name="topMargin">
+       <number>3</number>
+      </property>
+      <property name="rightMargin">
+       <number>3</number>
+      </property>
+      <property name="bottomMargin">
+       <number>3</number>
+      </property>
+      <item>
+       <layout class="QHBoxLayout" name="TimerTypeSelectLayout">
+        <property name="spacing">
+         <number>5</number>
+        </property>
+        <item>
+         <widget class="QLabel" name="TimerTypeLabel">
+          <property name="text">
+           <string>定时类型：</string>
+          </property>
+         </widget>
+        </item>
+        <item>
+         <widget class="QComboBox" name="TimerTypeComboBox">
+          <item>
+           <property name="text">
+            <string>特定时间</string>
+           </property>
+          </item>
+          <item>
+           <property name="text">
+            <string>相对时间</string>
+           </property>
+          </item>
+         </widget>
+        </item>
+       </layout>
+      </item>
+     </layout>
+    </widget>
+   </item>
+   <item>
+    <widget class="QGroupBox" name="TaskConfigGroupBox">
+     <property name="title">
+      <string>运行设置</string>
+     </property>
+     <layout class="QGridLayout" name="TaskConfigLayout">
+      <property name="leftMargin">
+       <number>3</number>
+      </property>
+      <property name="topMargin">
+       <number>3</number>
+      </property>
+      <property name="rightMargin">
+       <number>3</number>
+      </property>
+      <property name="bottomMargin">
+       <number>3</number>
+      </property>
+      <property name="spacing">
+       <number>5</number>
+      </property>
+      <item row="0" column="0">
+       <widget class="QRadioButton" name="SilentlyRunRadioButton">
+        <property name="text">
+         <string>静默运行</string>
+        </property>
+        <property name="checkable">
+         <bool>true</bool>
+        </property>
+        <property name="checked">
+         <bool>true</bool>
+        </property>
+        <property name="autoRepeat">
+         <bool>false</bool>
+        </property>
+        <property name="autoExclusive">
+         <bool>true</bool>
+        </property>
+       </widget>
+      </item>
+      <item row="1" column="0">
+       <widget class="QRadioButton" name="ShowBeforeRunRadioButton">
+        <property name="text">
+         <string>运行前提示</string>
+        </property>
+       </widget>
+      </item>
+     </layout>
+    </widget>
+   </item>
+   <item>
+    <layout class="QHBoxLayout" name="ControLayout">
+     <property name="spacing">
+      <number>5</number>
+     </property>
+     <item>
+      <widget class="QFrame" name="ControlSpaceFrame">
+       <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="QPushButton" name="CancelButton">
+       <property name="minimumSize">
+        <size>
+         <width>80</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>80</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="text">
+        <string>取消</string>
+       </property>
+      </widget>
+     </item>
+     <item>
+      <widget class="QPushButton" name="ConfirmButton">
+       <property name="minimumSize">
+        <size>
+         <width>80</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>80</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="text">
+        <string>添加</string>
+       </property>
+       <property name="autoDefault">
+        <bool>true</bool>
+       </property>
+       <property name="default">
+        <bool>true</bool>
+       </property>
+      </widget>
+     </item>
+    </layout>
+   </item>
+  </layout>
+ </widget>
+ <resources/>
+ <connections/>
+</ui>
@@ -0,0 +1,358 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>ALTimerTaskManageWidget</class>
+ <widget class="QWidget" name="ALTimerTaskManageWidget">
+  <property name="geometry">
+   <rect>
+    <x>0</x>
+    <y>0</y>
+    <width>400</width>
+    <height>400</height>
+   </rect>
+  </property>
+  <property name="minimumSize">
+   <size>
+    <width>400</width>
+    <height>400</height>
+   </size>
+  </property>
+  <property name="maximumSize">
+   <size>
+    <width>600</width>
+    <height>400</height>
+   </size>
+  </property>
+  <property name="windowTitle">
+   <string>定时任务管理 - AutoLibrary</string>
+  </property>
+  <layout class="QVBoxLayout" name="ALTimerTaskManageWidgetLayout">
+   <property name="spacing">
+    <number>5</number>
+   </property>
+   <property name="leftMargin">
+    <number>5</number>
+   </property>
+   <property name="topMargin">
+    <number>5</number>
+   </property>
+   <property name="rightMargin">
+    <number>5</number>
+   </property>
+   <property name="bottomMargin">
+    <number>5</number>
+   </property>
+   <item>
+    <layout class="QHBoxLayout" name="TimerTaskStatusLayout">
+     <property name="spacing">
+      <number>5</number>
+     </property>
+     <item>
+      <widget class="QLabel" name="TotalTaskLabel">
+       <property name="minimumSize">
+        <size>
+         <width>70</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>70</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="text">
+        <string>总任务：0</string>
+       </property>
+      </widget>
+     </item>
+     <item>
+      <widget class="QLabel" name="PendingTaskLabel">
+       <property name="minimumSize">
+        <size>
+         <width>70</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>70</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="styleSheet">
+        <string notr="true">QLabel {
+	color: #FF9800
+}</string>
+       </property>
+       <property name="text">
+        <string>待执行：0</string>
+       </property>
+      </widget>
+     </item>
+     <item>
+      <widget class="QLabel" name="InQueueTaskLabel">
+       <property name="minimumSize">
+        <size>
+         <width>70</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>70</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="styleSheet">
+        <string notr="true">QLabel {
+	color: #2294FF
+}</string>
+       </property>
+       <property name="text">
+        <string>队列中：0</string>
+       </property>
+      </widget>
+     </item>
+     <item>
+      <widget class="QLabel" name="ExecutedTaskLabel">
+       <property name="minimumSize">
+        <size>
+         <width>70</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>70</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="styleSheet">
+        <string notr="true">QLabel {
+	color: #4CAF50
+}</string>
+       </property>
+       <property name="text">
+        <string>已执行：0</string>
+       </property>
+      </widget>
+     </item>
+     <item>
+      <widget class="QLabel" name="InvalidTaskLabel">
+       <property name="minimumSize">
+        <size>
+         <width>70</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>25</width>
+         <height>70</height>
+        </size>
+       </property>
+       <property name="styleSheet">
+        <string notr="true">QLabel {
+	color: #DC0000
+}</string>
+       </property>
+       <property name="text">
+        <string>无效的：0</string>
+       </property>
+      </widget>
+     </item>
+     <item>
+      <widget class="QFrame" name="TimerTaskSpaceFrame">
+       <property name="minimumSize">
+        <size>
+         <width>0</width>
+         <height>0</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>600</width>
+         <height>16777215</height>
+        </size>
+       </property>
+       <property name="frameShape">
+        <enum>QFrame::Shape::NoFrame</enum>
+       </property>
+       <property name="frameShadow">
+        <enum>QFrame::Shadow::Plain</enum>
+       </property>
+      </widget>
+     </item>
+    </layout>
+   </item>
+   <item>
+    <layout class="QHBoxLayout" name="TimerTaskSortLayout">
+     <property name="spacing">
+      <number>0</number>
+     </property>
+     <item>
+      <widget class="QFrame" name="TimerTaskSortSpaceFrame">
+       <property name="maximumSize">
+        <size>
+         <width>16777215</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="QLabel" name="TimerTaskSortLabel">
+       <property name="minimumSize">
+        <size>
+         <width>40</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>40</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="text">
+        <string>排序：</string>
+       </property>
+      </widget>
+     </item>
+     <item>
+      <widget class="QComboBox" name="TimerTaskSortTypeComboBox">
+       <property name="minimumSize">
+        <size>
+         <width>90</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>90</width>
+         <height>25</height>
+        </size>
+       </property>
+       <item>
+        <property name="text">
+         <string>按名称</string>
+        </property>
+       </item>
+       <item>
+        <property name="text">
+         <string>按添加时间</string>
+        </property>
+       </item>
+       <item>
+        <property name="text">
+         <string>按执行时间</string>
+        </property>
+       </item>
+      </widget>
+     </item>
+     <item>
+      <widget class="QPushButton" name="TimerTaskSortOrderToggleButton">
+       <property name="minimumSize">
+        <size>
+         <width>25</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>25</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="text">
+        <string>↑</string>
+       </property>
+      </widget>
+     </item>
+    </layout>
+   </item>
+   <item>
+    <widget class="QListWidget" name="TimerTasksListWidget">
+     <property name="enabled">
+      <bool>true</bool>
+     </property>
+    </widget>
+   </item>
+   <item>
+    <layout class="QHBoxLayout" name="TimerTaskEditLayout">
+     <property name="spacing">
+      <number>5</number>
+     </property>
+     <item>
+      <widget class="QPushButton" name="ClearAllTimerTasksButton">
+       <property name="minimumSize">
+        <size>
+         <width>80</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>80</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="text">
+        <string>清除全部</string>
+       </property>
+      </widget>
+     </item>
+     <item>
+      <widget class="QPushButton" name="AddTimerTaskButton">
+       <property name="minimumSize">
+        <size>
+         <width>80</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="maximumSize">
+        <size>
+         <width>80</width>
+         <height>25</height>
+        </size>
+       </property>
+       <property name="text">
+        <string>添加任务</string>
+       </property>
+      </widget>
+     </item>
+     <item>
+      <widget class="QFrame" name="TimerTaskEditSpaceFrame">
+       <property name="maximumSize">
+        <size>
+         <width>16777215</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>
+    </layout>
+   </item>
+  </layout>
+ </widget>
+ <resources/>
+ <connections/>
+</ui>
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+Copyright (c) 2025 - 2026 KenanZhu.
 All rights reserved.

 This software is provided "as is", without any warranty of any kind.
@@ -11,10 +11,13 @@ 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
+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
@@ -22,8 +25,7 @@ from operators.LibLogin import LibLogin
 from operators.LibLogout import LibLogout
 from operators.LibReserve import LibReserve
 from operators.LibCheckin import LibCheckin
-
-from utils.ConfigReader import ConfigReader
+from operators.LibRenew import LibRenew


 class AutoLib(MsgBase):
@@ -31,13 +33,21 @@ class AutoLib(MsgBase):
    def __init__(
        self,
        input_queue: queue.Queue,
-        output_queue: queue.Queue
+        output_queue: queue.Queue,
+        run_config: dict
    ):
        super().__init__(input_queue, output_queue)

-        self.__system_config_reader = None
-        self.__users_config_reader = None
+        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(
@@ -45,51 +55,79 @@ class AutoLib(MsgBase):
    ) -> bool:

        self._showTrace("正在初始化浏览器驱动......")
-        edge_options = webdriver.EdgeOptions()

-        if self.__system_config_reader.get("web_driver/headless"):
-            edge_options.add_argument("--headless")
-            edge_options.add_argument("--disable-gpu")
-            edge_options.add_argument("--no-sandbox")
-            edge_options.add_argument("--disable-dev-shm-usage")
+        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} !")
+                return False
+
+        if not web_driver_config:
+            self._showTrace("未配置浏览器驱动参数 !")
+            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
-        edge_options.add_argument("--window-size=1920,1080")
-        edge_options.add_argument("--remote-allow-origins=*")
+        driver_options.add_argument("--window-size=1920,1080")

        # omit ssl errors and verbose log level
-        edge_options.add_argument("--ignore-certificate-errors")
-        edge_options.add_argument("--ignore-ssl-errors")
-        edge_options.add_argument("--log-level=OFF")
-        edge_options.add_argument("--silent")
+        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")

-        edge_options.add_experimental_option("excludeSwitches", ["enable-automation"])
-        edge_options.add_experimental_option("useAutomationExtension", False)
-        edge_options.add_argument("--disable-blink-features=AutomationControlled")
-        edge_options.add_argument(
-            "--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 "\
-            "Edg/120.0.0.0"
-        )
+        # 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 = self.__system_config_reader.get("web_driver/driver_path")
-        self.__driver_type = self.__system_config_reader.get("web_driver/driver_type")
+        self.__driver_path = web_driver_config.get("driver_path")
+        if not self.__driver_path:
+            self._showTrace("未配置浏览器驱动路径 !")
+            return False
        self.__driver_path = os.path.abspath(self.__driver_path)
        try:
            service = None
-            if self.__driver_path:
-                service = Service(executable_path=self.__driver_path)
            match self.__driver_type.lower():
                case "edge":
-                    self.__driver = webdriver.Edge(service=service, options=edge_options)
+                    service = EdgeService(executable_path=self.__driver_path)
+                    self.__driver = webdriver.Edge(service=service, options=driver_options)
                case "chrome":
-                    self.__driver = webdriver.Chrome(service=service, options=edge_options)
+                    service = ChromeService(executable_path=self.__driver_path)
+                    self.__driver = webdriver.Chrome(service=service, options=driver_options)
                case "firefox":
-                    self.__driver = webdriver.Firefox(service=service, options=edge_options)
-                case _:
+                    self._showTrace(f"Firefox 浏览器驱动初始化略慢, 请耐心等待...")
+                    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(
@@ -114,6 +152,7 @@ class AutoLib(MsgBase):
        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(
@@ -147,9 +186,18 @@ class AutoLib(MsgBase):
        self,
    ) -> bool:

-        url = self.__system_config_reader.get("library/host_url")
-        url += self.__system_config_reader.get("library/login_url")
-        self.__driver.get(url)
+        lib_config = self.__run_config.get("library", None)
+        if not lib_config:
+            self._showTrace("未配置图书馆参数 !")
+            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"图书馆登录页面加载超时 ! 请检查网络环境是否正常")
+            return False
        if not self.__waitResponseLoad():
            return False
        return True
@@ -159,24 +207,24 @@ class AutoLib(MsgBase):
        self,
        username: str,
        password: str,
+        login_config: dict,
+        run_mode_config: dict,
        reserve_info: dict
    ) -> int:

-        # result : 0 - success, 1 - failed, 2 - passed
+        # result : -1 - terminate, 0 - success, 1 - failed, 2 - passed
        result = 2

        # login
        if not self.__lib_login.login(
            username,
            password,
-            self.__system_config_reader.get("login/max_attempt", 5),
-            self.__system_config_reader.get("login/auto_captcha", True),
+            login_config.get("max_attempt", 3),
+            login_config.get("auto_captcha", True),
        ):
            return 1
-        """
-            Here, we collect the run mode from the config file.
-        """
-        run_mode = self.__system_config_reader.get("mode/run_mode", 0)
+        # 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,
@@ -185,77 +233,80 @@ class AutoLib(MsgBase):
        # reserve
        if run_mode["auto_reserve"]:
            if self.__lib_checker.canReserve(reserve_info.get("date")):
-                if self.__lib_reserve.reserve(reserve_info):
-                    self._showTrace(f"用户 {username} 预约成功 !")
+                if self.__lib_reserve.reserve(username, reserve_info):
                    result = 0
                else:
-                    self._showTrace(f"用户 {username} 预约失败 !")
                    result = 1
            else:
                self._showTrace(f"用户 {username} 无法预约，已跳过")
                result = 2
        # checkin
        if run_mode["auto_checkin"] and result == 2:
-            if self.__lib_checker.canCheckin(reserve_info.get("date")):
+            if self.__lib_checker.canCheckin():
                if self.__lib_checkin.checkin(username):
-                    self._showTrace(f"用户 {username} 签到成功 !")
                    result = 0
                else:
-                    self._showTrace(f"用户 {username} 签到失败 !")
                    result = 1
            else:
                self._showTrace(f"用户 {username} 无法签到，已跳过")
                result = 2
        # renewal
        if run_mode["auto_renewal"] and result == 2:
-            if self.__lib_checker.canRenew(reserve_info.get("date")):
-                pass
+            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):
+                        result = 0
+                    else:
+                        result = 1
+                else:
+                    result = 1
            else:
                self._showTrace(f"用户 {username} 无法续约，已跳过")
                result = 2
        # logout
        if not self.__lib_logout.logout(
-            username,
+            username
        ):
            # if logout is failed, we must make sure the host to be reloaded
            # otherwise, the next login may fail
-            self.__driver.get(self.__system_config_reader.get("library/host_url"))
-            return 1
+            if not self.__initDriverUrl():
+                return -1
        return result


    def run(
        self,
-        system_config_reader: ConfigReader,
-        users_config_reader: ConfigReader
+        user_config: dict
    ):

-        self.__system_config_reader = system_config_reader
-        self.__users_config_reader = users_config_reader
-        if not self.__initBrowserDriver():
-            return
-        else:
-            if not self.__initDriverUrl():
-                return
-            self.__initLibOperators()
+        self.__user_config = user_config

        user_counter = {"current": 0, "success": 0, "failed": 0, "passed": 0}
-        users = self.__users_config_reader.get("users")
-        self._showTrace(
-            f"共发现 {len(users)} 个用户, "\
-            f"用户配置文件路径: {self.__users_config_reader.configPath()}"
-        )
+        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']}......"
+                f"正在处理第 {user_counter["current"]}/{len(users)} 个用户: {user["username"]}......"
            )
+            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 == 0:
+            if r == -1:
+                self._showTrace(
+                    f"用户 {user["username"]} 处理过程中页面发生异常，无法继续操作, 任务已终止 !"
+                )
+                break
+            elif r == 0:
                user_counter["success"] += 1
            elif r == 1:
                user_counter["failed"] += 1
@@ -274,6 +325,8 @@ class AutoLib(MsgBase):
    ) -> bool:

        if self.__driver:
+            if self.__driver_type.lower() == "firefox":
+                self._showTrace(f"Firefox 浏览器驱动关闭略慢, 请耐心等待...")
            self.__driver.quit()
            self.__driver = None
            self._showTrace(f"浏览器驱动已关闭")
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+Copyright (c) 2025 - 2026 KenanZhu.
 All rights reserved.

 This software is provided "as is", without any warranty of any kind.
@@ -13,6 +13,7 @@ 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

@@ -25,7 +26,7 @@ class LibChecker(LibOperator):
        self,
        input_queue: queue.Queue,
        output_queue: queue.Queue,
-        driver: any
+        driver: WebDriver
    ):

        super().__init__(input_queue, output_queue)
@@ -308,7 +309,7 @@ class LibChecker(LibOperator):

    def canRenew(
        self
-    ):
+    ) -> tuple[bool, dict]:

        # only check the current date
        date = time.strftime("%Y-%m-%d", time.localtime())
@@ -325,9 +326,51 @@ class LibChecker(LibOperator):
            )
            if abs(time_diff_seconds) < 120*60:
                self._showTrace(f"{trace_msg}, 可以续约")
-                return record
+                return True, record
            else:
                self._showTrace(f"{trace_msg}, 无法续约")
-                return None
+                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 None
+        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
@@ -1,18 +1,17 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+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

@@ -25,7 +24,7 @@ class LibCheckin(LibOperator):
        self,
        input_queue: queue.Queue,
        output_queue: queue.Queue,
-        driver: any
+        driver: WebDriver
    ):

        super().__init__(input_queue, output_queue)
@@ -54,7 +53,6 @@ class LibCheckin(LibOperator):
        except:
            self._showTrace("签到时发生未知错误 !")
            return False
-        print(result_message_element)
        result_message = result_message_element.text
        if "签到成功" in result_message:
            try:
@@ -71,16 +69,21 @@ class LibCheckin(LibOperator):
                        f"          {details[1]}\n"\
                        f"          {details[2]}\n"\
                        f"          {details[3]}\n"\
-                        f"          {details[4]}")
+                        f"          {details[4]}"
+                    )
            else:
-                self._showTrace(
+                self._showTrace(f"\n"\
                         "      签到成功 !\n"\
-                         "          未获取到签到详情 !")
+                         "          未获取到签到详情 !"
+                    )
            ok_btn.click()
            return True
        else:
            failure_reason = result_message.replace("签到失败", "").strip()
-            self._showTrace(f"签到失败: {failure_reason}")
+            self._showTrace(f"\n"\
+                "      签到失败 !\n"\
+                f"          {failure_reason}"
+                )
            ok_btn.click()
            return False

@@ -104,4 +107,9 @@ class LibCheckin(LibOperator):
            self._showTrace("签到按钮不可用, 可能不在场馆内, 请连接图书馆网络后重试")
            return False
        checkin_btn.click()
-        return self._waitResponseLoad()
+        if self._waitResponseLoad():
+            self._showTrace(f"用户 {username} 签到成功 !")
+            return True
+        else:
+            self._showTrace(f"用户 {username} 签到失败 !")
+        return False
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+Copyright (c) 2025 - 2026 KenanZhu.
 All rights reserved.

 This software is provided "as is", without any warranty of any kind.
@@ -13,6 +13,7 @@ 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

@@ -25,7 +26,7 @@ class LibCheckout(LibOperator):
        self,
        input_queue: queue.Queue,
        output_queue: queue.Queue,
-        driver: any
+        driver: WebDriver
    ):

        super().__init__(input_queue, output_queue)
@@ -1,19 +1,19 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+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
 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

@@ -26,7 +26,7 @@ class LibLogin(LibOperator):
        self,
        input_queue: queue.Queue,
        output_queue: queue.Queue,
-        driver: any
+        driver: WebDriver
    ):

        super().__init__(input_queue, output_queue)
@@ -88,13 +88,12 @@ class LibLogin(LibOperator):
            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}'.")
+            self._showTrace(f"识别到验证码为 : '{captcha_text}'")
            if len(captcha_text) != 4:
                raise Exception("识别到的验证码长度不等于 4 个字符 !")
            return captcha_text
        except Exception as e:
            self._showTrace(f"验证码识别失败 ! : {e}")
-            self.__refreshCaptcha()
            return ""


@@ -104,15 +103,14 @@ class LibLogin(LibOperator):

        # manual recognize captcha
        try:
-            self._show_msg("请输入验证码:")
-            captcha_text = self._wait_msg(timeout=15)
-            self._showTrace(f"输入的验证码为 : '{captcha_text}'.")
+            self._showMsg("请输入验证码:")
+            captcha_text = self._waitMsg(timeout=15)
+            self._showTrace(f"输入的验证码为 : '{captcha_text}'")
            if len(captcha_text) != 4:
                raise Exception("输入的验证码长度不等于 4 个字符 !")
            return captcha_text
        except Exception as e:
            self._showTrace(f"输入验证码失败 ! : {e}")
-            self.__refreshCaptcha()
            return ""


@@ -126,11 +124,9 @@ class LibLogin(LibOperator):
            self.__driver.find_element(
                By.ID, "loadImgId"
            ).click()
-            time.sleep(1)
            return True
        except Exception as e:
            self._showTrace(f"刷新验证码失败 ! : {e}")
-            self.__refreshCaptcha()
            return False


@@ -139,8 +135,7 @@ class LibLogin(LibOperator):
        auto_captcha: bool = True
    ) -> str:

-        max_attempts = 5
-
+        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()
@@ -149,7 +144,10 @@ class LibLogin(LibOperator):
                captcha_text = self.__manualRecognizeCaptcha()
            if captcha_text:
                return captcha_text
-        self._showTrace(f"验证码识别失败 {max_attempts} 次, 请检查验证码是否正确 !")
+            else:
+                if not self.__refreshCaptcha():
+                    return ""
+        self._showTrace(f"验证码识别失败 {max_attempts} 次, 达到最大尝试次数 !")
        return ""


@@ -165,7 +163,6 @@ class LibLogin(LibOperator):
            return True
        except Exception as e:
            self._showTrace(f"验证码填写失败 ! : {e}")
-            self.__refreshCaptcha()
            return False


@@ -200,7 +197,7 @@ class LibLogin(LibOperator):
                    "//input[@type='button' and @value='登录']"
                ).click()
            except Exception as e:
-                self._showTrace(f"登录失败 ! : {e}")
+                self._showTrace(f"尝试登录失败 ! : {e}")
                continue
            if self._waitResponseLoad():
                self._showTrace(f"用户 {username} 第 {attempt + 1} 次登录成功 !")
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+Copyright (c) 2025 - 2026 KenanZhu.
 All rights reserved.

 This software is provided "as is", without any warranty of any kind.
@@ -10,8 +10,7 @@ See the LICENSE file for details.
 import queue

 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.chrome.webdriver import WebDriver

 from base.LibOperator import LibOperator

@@ -22,7 +21,7 @@ class LibLogout(LibOperator):
        self,
        input_queue: queue.Queue,
        output_queue: queue.Queue,
-        driver: any
+        driver: WebDriver
    ):

        super().__init__(input_queue, output_queue)
@@ -1,18 +1,16 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+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 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

@@ -25,7 +23,7 @@ class LibRenew(LibOperator):
        self,
        input_queue: queue.Queue,
        output_queue: queue.Queue,
-        driver: any
+        driver: WebDriver
    ):

        super().__init__(input_queue, output_queue)
@@ -37,4 +35,178 @@ class LibRenew(LibOperator):
        self
    ) -> bool:

-        pass
+        self.__driver.refresh()
+        return True
+
+    @staticmethod
+    def __timeToMins(
+        time_str: str
+    ) -> int:
+
+        hour, minute = map(int, time_str.split(":"))
+        return hour*60 + minute
+
+    @staticmethod
+    def __minsToTime(
+        mins: int
+    ) -> str:
+
+        hour, minute = divmod(mins, 60)
+        return f"{hour:02d}:{minute:02d}"
+
+
+    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("续约时间选择界面加载失败 !")
+            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}")
+            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("续约时间选择界面加载失败 !")
+            return False
+        return True
+
+
+    def __selectNearstTime(
+        self,
+        record: dict,
+        reserve_info: dict
+    ) -> bool:
+
+        """
+            TODO : this function is too long and too ugly
+
+            we need to refactor it to make it more readable.
+            but may be it is not a good idea to refactor it. :) who knows...
+        """
+
+        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.__timeToMins(end_time) + renew_info["expect_duration"]*60
+        renew_ok_btn = self.__driver.find_element(
+            By.CSS_SELECTOR, "#extendDiv .btnOK"
+        )
+        try:
+            renew_time_opts = self.__driver.find_elements(
+                By.CSS_SELECTOR, "#extendDiv .renewal_List li"
+            )
+            free_times = []
+            best_time_diff = max_diff
+            best_actual_diff = None
+            best_time_opt = None
+
+            if not renew_time_opts:
+                self._showTrace("当前未查询到可用续约时间 !")
+                return False
+            for time_opt in renew_time_opts:
+                time_attr = time_opt.get_attribute("id")
+                if time_attr and time_attr.isdigit():
+                    time_val = int(time_attr)
+                    free_times.append(time_opt.text.strip())
+                else:
+                    continue
+                actual_diff = time_val - target_renew_mins
+                abs_diff = abs(actual_diff)
+                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:
+                best_time_opt.click()
+                abs_time_diff = abs(best_actual_diff)
+                if best_actual_diff < 0:
+                    time_relation = f"早了 {abs_time_diff} 分钟"
+                elif best_actual_diff > 0:
+                    time_relation = f"晚了 {abs_time_diff} 分钟"
+                else:
+                    time_relation = f"正好等于续约时间"
+                self._showTrace(
+                    f"选择距离期望续约时间最近的 {best_time_opt.text}, "\
+                    f"与期望续约时间相比 {time_relation}"
+                )
+                # update the actual renew end time
+                record["time"]["end"] = best_time_opt.text.strip()
+                renew_ok_btn.click()
+                return True
+            self._showTrace(
+                "无法选择最近的可用续约时间 !" \
+                f"所有可选时间与目标时间相差都超过了 {max_diff} 分钟 !"
+            )
+            self._showTrace(
+                f"当前可供续约的时间有: {free_times}"
+            )
+            return False
+        except:
+            self._showTrace("查询可用续约时间时发生未知错误 !")
+            return False
+
+
+    def renew(
+        self,
+        username: str,
+        record: dict,
+        reserve_info: dict
+    ) -> bool:
+
+        if self.__driver is None:
+            self._showTrace("未提供有效 WebDriver 实例 !")
+            return False
+        try:
+            renew_btn = WebDriverWait(self.__driver, 2).until(
+                EC.element_to_be_clickable((By.ID, "btnExtend"))
+            )
+        except:
+            self._showTrace(f"用户 {username} 续约界面加载失败 !")
+            return False
+        if "disabled" in renew_btn.get_attribute("class"):
+            self._showTrace(f"用户 {username} 续约按钮不可用, 可能不在场馆内, 请连接图书馆网络后重试")
+            return False
+        renew_btn.click()
+        if not self.__waitRenewDialog():
+            self._showTrace(f"用户 {username} 续约失败 !")
+
+            # 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.__selectNearstTime(record, reserve_info):
+            self._showTrace(f"用户 {username} 续约失败 !")
+            self.__driver.refresh()
+            return False
+        if self._waitResponseLoad():
+            return True
@@ -1,18 +1,18 @@
 # -*- coding: utf-8 -*-
 """
-Copyright (c) 2025 KenanZhu.
+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 datetime import datetime
 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

@@ -25,7 +25,7 @@ class LibReserve(LibOperator):
        self,
        input_queue: queue.Queue,
        output_queue: queue.Queue,
-        driver: any
+        driver: WebDriver
    ):

        super().__init__(input_queue, output_queue)
@@ -40,12 +40,12 @@ class LibReserve(LibOperator):
        }
        self.__room_map = {
            "1": "二层内环",
-            "2": "二层外环",
+            "2": "二层西区",
            "3": "三层内环",
            "4": "三层外环",
            "5": "四层内环",
            "6": "四层外环",
-            "7": "四层期刊区",
+            "7": "四层期刊",
            "8": "五层考研"
        }

@@ -88,11 +88,13 @@ class LibReserve(LibOperator):
                        f"          {contents[1]}\n"\
                        f"          {contents[2]}\n"\
                        f"          {contents[3]}\n"\
-                        f"          签到时间 ：{contents[5]}")
+                        f"          签到时间 ：{contents[5]}"
+                    )
                else:
-                    self._showTrace(f"\n"\
-                        f"      预约成功 !\n"\
-                        f"          未找获取到详细信息")
+                    self._showTrace("\n"\
+                        "      预约成功 !\n"\
+                        "          未找获取到详细信息"
+                    )
            return True
        except:
            self._showTrace(f"预约结果加载失败 !")
@@ -187,12 +189,13 @@ class LibReserve(LibOperator):
        reserve_info: dict
    ) -> bool:

-        if reserve_info.get("expect_duration") is None:
-            reserve_info["expect_duration"] = 4
-            self._showTrace("预约持续时间未指定, 使用默认时长为 4 小时")
        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


@@ -234,7 +237,7 @@ class LibReserve(LibOperator):
        # if end time is earlier than begin_time, exchange them
        if end_mins < begin_mins:
            self._showTrace(
-                f"结束时间 {end_time['time']} 早于开始时间 {begin_time['time']}, 自动交换"
+                f"结束时间 {end_time['time']} 早于开始时间 {begin_time['time']}, 尝试交换时间"
            )
            reserve_info["end_time"] = begin_time
            reserve_info["begin_time"] = end_time
@@ -261,10 +264,9 @@ class LibReserve(LibOperator):
            if end_mins - begin_mins > 8*60:
                self._showTrace(
                    f"该用户未设置优先满足时长要求, 但是检查到预约持续时间 "
-                    f"{int((end_mins - begin_mins)/60)} 小时 "
+                    f"{float((end_mins - begin_mins)/60)} 小时 "
                    f"超出最大时长 8 小时, 自动设置为 8 小时"
                )
-                reserve_info["expect_duration"] = 8
                reserve_info["end_time"]["time"] = self.__minsToTime(begin_mins + 8*60)
        return True

@@ -577,6 +579,7 @@ class LibReserve(LibOperator):
        expect_begin_time = actual_begin_time = begin_time["time"]
        expect_end_time = actual_end_time = end_time["time"]
        expect_begin_mins = self.__timeToMins(expect_begin_time)
+        actual_begin_mins = expect_begin_mins
        expect_end_mins = self.__timeToMins(expect_end_time)

        # select the begin time
@@ -590,11 +593,18 @@ class LibReserve(LibOperator):
            return False
        else:
            actual_begin_time = self.__minsToTime(expect_begin_mins)
+            actual_begin_mins = self.__timeToMins(actual_begin_time)
        # if 'satisfy_duration' is True.
        # select the end time based on the begin time
        # (because it may be changed under the 'max time diff' strategy) and expect duration.
        if satisfy_duration:
-            expect_end_mins = int(expect_begin_mins + expct_duration*60)
+            expect_end_mins = int(actual_begin_mins + expct_duration*60)
+            if expect_end_mins > self.__timeToMins("23:30"):
+                expect_end_mins = self.__timeToMins("23:30")
+                self._showTrace(
+                    f"预约持续时间 {expct_duration} 小时, 超过最大预约时间 23:30, 自动调整为 23:30"
+                )
+            expect_end_time = self.__minsToTime(expect_end_mins)
            self._showTrace(
                f"需要满足期望预约持续时间: {expct_duration} 小时, "\
                f"根据开始时间 {actual_begin_time} 计算结束时间: {self.__minsToTime(expect_end_mins)}"
@@ -619,6 +629,7 @@ class LibReserve(LibOperator):

    def reserve(
        self,
+        username: str,
        reserve_info: dict
    ) -> bool:

@@ -674,4 +685,8 @@ class LibReserve(LibOperator):
                self._showTrace(f"预约提交失败 !")
        if not submit_reserve and have_hover_on_page:
            self.__driver.refresh()
+        if reserve_success:
+            self._showTrace(f"用户 {username} 预约成功 !")
+        else:
+            self._showTrace(f"用户 {username} 预约失败 !")
        return reserve_success
@@ -8,5 +8,6 @@
    - 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.
 """
@@ -0,0 +1,233 @@
+# -*- 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 threading
+
+from enum import Enum
+from typing import Any, Optional
+
+from utils.JSONReader import JSONReader
+from utils.JSONWriter import JSONWriter
+
+
+# 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.
+    """
+
+    def __init__(
+        self,
+        config_type: ConfigType
+    ):
+
+        self.__config_type = config_type
+
+
+    def template(
+        self
+    ) -> dict:
+        """
+            Get config template.
+
+            Returns:
+                dict: Config template.
+        """
+        match self.__config_type:
+            case ConfigType.GLOBAL:
+                return {
+                    "automation": {
+                        "run_path": {
+                            "current": 0,
+                            "paths": []
+                        },
+                        "user_path": {
+                            "current": 0,
+                            "paths": []
+                        }
+                    }
+                }
+            case ConfigType.BULLETIN:
+                return {
+                    "bulletin": [],
+                    "last_sync_time": None
+                }
+            case ConfigType.TIMERTASK:
+                return {
+                    "timer_tasks": []
+                }
+            case _:
+                return {}
+
+
+class ConfigManager:
+
+    def __init__(
+        self,
+        config_dir: str
+    ):
+
+        self.__config_dir = os.path.abspath(config_dir)
+        self.__config_lock = threading.Lock()
+        self.__config_data = {}
+
+        self.initialize()
+
+
+    def initialize(
+        self
+    ):
+
+        for config_type in ConfigType:
+            self.load(config_type)
+
+
+    def load(
+        self,
+        config_type: ConfigType
+    ):
+
+        config_path = os.path.join(self.__config_dir, config_type.value)
+        if os.path.exists(config_path):
+            try:
+                config_data = JSONReader(config_path).data()
+                self.__config_data[config_type.value] = config_data
+                return
+            except:
+                pass
+        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 = "",
+        default: Optional[Any] = None
+    ) -> Any:
+
+        with self.__config_lock:
+            config_data = self.__config_data[config_type.value]
+            if key == "":
+                return config_data
+            keys = 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 = "",
+        value: Any = None
+    ):
+
+        with self.__config_lock:
+            root_data = self.__config_data[config_type.value]
+            if key == "":
+                self.__config_data[config_type.value] = value
+            else:
+                keys = 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)
+
+
+    def save(
+        self,
+        config_type: ConfigType
+    ):
+
+        config_path = os.path.join(self.__config_dir, config_type.value)
+        JSONWriter(config_path, self.__config_data[config_type.value])
+
+
+    def appDir(
+        self
+    ) -> str:
+
+        return self.__config_dir
+
+
+_config_manager_instance = None
+
+# Utility function to get config data (thread-safe and validated) from ConfigManager instance.
+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.appDir(), 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
+
+def getBaseConfigDir(
+) -> str:
+
+    return _config_manager_instance.appDir()
+
+# Singleton instance of ConfigManager.
+_instance_lock = threading.Lock()
+def instance(
+    config_dir: str = ""
+) -> ConfigManager:
+    """
+        Initialize ConfigManager singleton instance.
+
+        Args:
+            config_dir (str): Config directory.
+    """
+    global _config_manager_instance
+    with _instance_lock:
+        if _config_manager_instance is None:
+            _config_manager_instance = ConfigManager(config_dir)
+        else:
+            if config_dir == "":
+                return _config_manager_instance
+            if _config_manager_instance.appDir() != config_dir:
+                raise ValueError(
+                    "ConfigManager 的实例已初始化，不能使用不同的配置目录。")
+    return _config_manager_instance
@@ -1,89 +0,0 @@
-# -*- 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 json
-
-
-class ConfigReader:
-
-    def __init__(
-        self,
-        config_path: str
-    ):
-
-        self._config_path = config_path
-        self._config_data = {}
-        if not self.__readConfig():
-            return None
-
-
-    def __readConfig(
-        self
-    ) -> bool:
-
-        try:
-            with open(self._config_path, 'r', encoding='utf-8') as file:
-                self._config_data = json.load(file)
-            return True
-        except Exception as e:
-            print(f"Error reading config file: {e}")
-            return False
-
-
-    def getConfigs(
-        self
-    ) -> dict:
-
-        return self._config_data.copy()
-
-
-    def getConfig(
-        self,
-        key: str
-    ) -> dict:
-
-        return self._config_data.get(key, {})
-
-
-    def get(
-        self,
-        key: str,
-        default: any = None
-    ) -> any:
-
-        keys = key.split('/')
-        current = self._config_data
-        for k in keys:
-            if isinstance(current, dict) and k in current:
-                current = current[k]
-            else:
-                return default
-        return current
-
-
-    def hasConfig(
-        self,
-        key: str
-    ) -> bool:
-
-        return self.getConfig(key) != {}
-
-
-    def reReadConfig(
-        self
-    ) -> bool:
-
-        return self.__readConfig()
-
-
-    def configPath(
-        self
-    ) -> str:
-
-        return self._config_path
@@ -1,87 +0,0 @@
-# -*- 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 json
-
-
-class ConfigWriter:
-
-    def __init__(
-        self,
-        config_path: str,
-        config_data: dict
-    ):
-
-        self.__config_path = config_path
-        self.__config_data = config_data if config_data is not None else {}
-        if config_data is None:
-            return None
-        if not self.__writeConfig():
-            return None
-
-
-    def __writeConfig(
-        self
-    ) -> bool:
-
-        try:
-            with open(self.__config_path, "w") as f:
-                json.dump(self.__config_data, f, indent=4, sort_keys=False)
-            return True
-        except:
-            return False
-
-
-    def setConfigs(
-        self,
-        configs: dict
-    ) -> bool:
-
-        self.__config_data = configs
-        return self.__writeConfig()
-
-
-    def setConfig(
-        self,
-        key: str,
-        value: dict
-    ) -> bool:
-
-        self.__config_data[key] = value
-        return self.__writeConfig()
-
-
-    def set(
-        self,
-        key: str,
-        value: dict
-    ) -> bool:
-
-        keys = key.replace("\\", "/").split("/")
-        current = self.__config_data
-        for k in keys[:-1]:
-            if k not in current or not isinstance(current[k], dict):
-                current[k] = {}
-            current = current[k]
-        current[keys[-1]] = value
-        return self.__writeConfig()
-
-
-    def reWriteConfig(
-        self
-    ) -> bool:
-
-        return self.__writeConfig()
-
-
-    def configPath(
-        self
-    ) -> str:
-
-        return self.__config_path
@@ -0,0 +1,85 @@
+# -*- 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 json
+
+
+class JSONReader:
+    """
+        JSON reader class.
+
+        This class is used to read JSON file.
+
+        Args:
+            json_path (str): The path of JSON file.
+
+        Examples:
+            >>>  print(open("config.json", "r", encoding="utf-8").read())
+            {
+                "key1": {
+                    "key2": "value1"
+                }
+            }
+            >>> json_reader = JSONReader("config.json")
+            >>> data = json_reader.data()
+            >>> data["key1"]["key2"]
+            "value1"
+    """
+
+    def __init__(
+        self,
+        json_path: str
+    ):
+
+        self.__json_path = os.path.abspath(json_path)
+        self.__json_data = None
+        self.__read()
+
+
+    def __read(
+        self
+    ):
+
+        try:
+            with open(self.__json_path, 'r', encoding='utf-8') as file:
+                self.__json_data = json.load(file)
+        except FileNotFoundError as e:
+            raise Exception(f"文件不存在: {self.__json_path}") from e
+        except PermissionError as e:
+            raise Exception(f"没有足够的权限读取文件: {self.__json_path}") from e
+        except json.JSONDecodeError as e:
+            raise Exception(f"JSON 解析错误: {self.__json_path}") from e
+        except Exception as e:
+            raise Exception(f"读取文件时发生未知错误: {e}") from e
+
+
+    def read(
+        self
+    ) -> bool:
+
+        try:
+            self.__read()
+        except:
+            return False
+        return True
+
+
+    def data(
+        self
+    ) -> dict:
+
+        return self.__json_data.copy()
+
+
+    def path(
+        self
+    ) -> str:
+
+        return self.__json_path
@@ -0,0 +1,82 @@
+# -*- 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 json
+
+
+class JSONWriter:
+    """
+        JSON writer class.
+
+        This class is used to write JSON file.
+
+        Args:
+            json_path (str): The path of JSON file.
+            json_data (dict): The JSON data to be written.
+
+        Examples:
+            >>> json_data = {
+            ...     "key1": {
+            ...         "key2": "value1"
+            ...     }
+            ... }
+            >>> json_writer = JSONWriter("config.json", json_data)
+            >>> print(open("config.json", "r", encoding="utf-8").read())
+            {
+                "key1": {
+                    "key2": "value1"
+                }
+            }
+    """
+
+    def __init__(
+        self,
+        json_path: str,
+        json_data: dict
+    ):
+
+        self.__json_path = os.path.abspath(json_path)
+        self.__json_data = json_data.copy() if json_data is not None else {}
+        self.__write()
+
+
+    def __write(
+        self
+    ):
+
+        try:
+            with open(self.__json_path, "w", encoding="utf-8") as f:
+                json.dump(self.__json_data, f, indent=4, sort_keys=False)
+        except PermissionError as e:
+            raise Exception(f"没有足够的权限写入文件: {self.__json_path}") from e
+        except IOError as e:
+            raise Exception(f"写入文件时发生 IO 错误: {self.__json_path}") from e
+        except TypeError as e:
+            raise Exception(f"JSON 数据包含无法 JSON 序列化的类型: {e}") from e
+        except Exception as e:
+            raise Exception(f"写入文件时发生未知错误: {e}") from e
+
+
+    def write(
+        self
+    ) -> bool:
+
+        try:
+            self.__write()
+        except:
+            return False
+        return True
+
+
+    def path(
+        self
+    ) -> str:
+
+        return self.__json_path
@@ -2,6 +2,7 @@
    Utils module for the AutoLibrary project.

    Here are the classes and modules in this package:
-    - ConfigReader: Configuration reader class for the AutoLibrary project.
-    - ConfigWriter: Configuration writer class for the AutoLibrary project.
+    - ConfigManager: Configuration manager class for the AutoLibrary project.
+    - JSONReader: JSON reader class for the AutoLibrary project.
+    - JSONWriter: JSON writer class for the AutoLibrary project.
 """
@@ -0,0 +1 @@
+This folder is used to store the template config files.
@@ -0,0 +1,18 @@
+{
+    "library": {
+        "host_url": "http://10.1.20.7",
+        "login_url": "/login"
+    },
+    "login": {
+        "auto_captcha": true,
+        "max_attempt": 3
+    },
+    "web_driver": {
+        "driver_type": "edge",
+        "driver_path": "",
+        "headless": false
+    },
+    "mode": {
+        "run_mode": 1
+    }
+}
@@ -0,0 +1,3 @@
+{
+    "groups": []
+}
@@ -0,0 +1,6 @@
+This folder is used to store the template files.
+
+Directory structure:
+
+    templates
+    |─── configs // template config files
Author	SHA1	Message	Date
github-actions[bot]	95a3ae2a24	chore(release): v1.1.0 [auto release commit]	2026-02-26 15:04:42 +00:00
KenanZhu	896242a1e3	fix(Main, ALConfigWidget): 修复配置文件初始化问题	2026-02-26 22:59:26 +08:00
KenanZhu	fd96fc235e	ci(workflows): 修复 build.yml 中 Generate 'Main.spec' 步骤中的 name 参数	2026-02-26 21:27:35 +08:00
KenanZhu	25aab588a8	feat(utils): 添加 ConfigManager 与 JSON 配置读写，替换旧实现 add: - src/utils/ConfigManager.py - src/utils/JSONReader.py - src/utils/JSONWriter.py remove: - src/utils/ConfigReader.py - src/utils/ConfigWriter.py refactor: - 更新调用方以使用 ConfigManager / JSONReader / JSONWriter（见 ALConfigWidget.py、ALMainWindow.py、ALTimerTaskManageWidget.py、ALMainWorkers.py 等） - 统一方法命名（initlize* -> initialize*）、改进错误提示与配置路径管理 BREAKING CHANGE: 删除 ConfigReader/ConfigWriter，外部调用需改为 JSONReader/JSONWriter 或通过 ConfigManager 访问配置	2026-02-26 21:18:18 +08:00
KenanZhu	6e1b8e6b10	ci(workflows): 修改 build.yml 中 PyInstaller 打包参数，发布压缩包修改为为文件夹模式	2026-02-24 17:39:49 +08:00
KenanZhu	5f2327cf61	style(gui.*): 修改一些 import 顺序和格式	2026-02-23 22:26:52 +08:00
KenanZhu	96e7adabb0	docs(readme): 修改自述文件	2026-02-23 00:07:58 +08:00
KenanZhu	42afbbe694	docs(readme): 修改自述文件	2026-02-22 23:19:42 +08:00
KenanZhu	3777970332	docs(readme): 修改自述文件，完善使用说明	2026-02-22 00:24:47 +08:00
KenanZhu	9fb28e1368	ci(release.yml): 修改 release.yml 中发布说明的默认内容	2026-02-21 23:32:19 +08:00
KenanZhu	4aeca08ce8	chore(ALMainWindow, ALMainWorkers): 修改统一部分函数和变量的命名	2026-02-21 23:18:17 +08:00
KenanZhu	a1ff85256a	refactor(ALConfigWidget, ALTimerTaskManageWidget): 优化界面的错误异常处理	2026-02-21 15:38:56 +08:00
KenanZhu	169de92d5b	chore(ALConfigWidget): 删除了未使用的方法 def defaultGroup() 和 def defaultUsers()	2026-02-21 15:10:36 +08:00
KenanZhu	5ca4a14a14	chore(*): 更改一些界面类方法，局部变量和信号的命名： (ALConfigWidget): def initlizeDefaultConfigPaths() 中 script_path 和 script_dir 分别改为 executable_path 和 executable_dir def fillUserTree() 更改为 def setUsersToTreeWidget() def collectUserFromUserInfoWidget() 更改为 def collectUserFromWidget() def collectUserConfigFromUserTreeWidget 更改为 def collectUsersFromTreeWidget() 交换了一些方法的位置 (ALSeatMapSelectDialog): 信号 seatMapSelectDialogClosed 改为 seatMapSelectDialogIsClosed (ALTimerTaskManageWidget): 信号 timerTaskManageWidgetClosed 改为 timerTaskManageWidgetIsClosed (ALMainWindow): def __init__() 中 script_path 和 script_dir 分别改为 executable_path 和 executable_dir 更改 ALSeatMapSelectDialog 和 ALTimerTaskManageWidget 中相关的信号命名	2026-02-21 14:26:54 +08:00
KenanZhu	155b3fe3ca	style(LibRenew): 删除多余注释，修改部分注释的格式	2026-02-19 17:09:15 +08:00
KenanZhu	99d454a566	refactor(LibChecker, AutoLib): 重构 LibChecker 类中 canRenew 方法的返回值类型：将 canRenew 方法的返回值类型指定为 tuple(bool, dict)，并随之修改返回值以及调用模块的调用逻辑。	2026-02-19 17:05:42 +08:00
github-actions[bot]	3963b3f2e6	chore(release): v1.0.5 [auto release commit]	2026-02-16 07:04:57 +00:00
KenanZhu	f2a05809bd	ci(batchs): 修复编译脚本中的路径问题	2026-02-16 15:00:35 +08:00
KenanZhu	b55a0c06a5	refactor(ALConfigWidget, ALTimerTaskManageWidget): 重构配置和定时器任务管理窗口的配置显式初始化修改后配置文件的初始化将不再通过 QMessageBox 提示用户，界面将只在初始化失败时显示错误信息。	2026-02-16 14:17:58 +08:00
KenanZhu	2496c4e367	fix(ALMainWindow): 修复配置按钮状态问题	2026-02-16 13:02:40 +08:00
KenanZhu	de30559af1	chore(ALTimerTaskManageWidget): 更改信号函数命名	2026-02-16 13:02:01 +08:00
KenanZhu	e1c2efc8c0	chore(utils): 配置文件读写器异常改为中文	2026-02-16 13:01:34 +08:00
KenanZhu	26a70cdceb	ci(batchs): 修复 *.sh 编译脚本中项目路径问题	2026-02-11 20:17:04 +08:00
KenanZhu	ce14be2555	chore(*): 重构项目文件目录结构 - 将 src/gui 目录下的 Qt 资源文件移动到 src/gui/resources 目录下 - 将 src/gui 目录下的 Qt UI 设计文件移动到 src/gui/resources/ui 目录下 - 将 src/gui/icons 目录下的图标文件移动到 src/gui/resources/icons 目录下 - 将 src/gui/translators 目录下移动到 src/gui/resources/translators 目录下 - 将 src/gui/configs 目录移动到 templates 目录下 - 将 document， driver， model 目录重命名为 manuals， drivers， models - 由于上述目录移动和重命名，相应的更改了代码和批处理脚本中的文件路径	2026-02-11 20:00:51 +08:00
KenanZhu	eda16f01f1	refactor(gui): chore(gui): 对部分界面类进行重构，将 ALSeatMapView 提取到单独文件，将 ALSeatMapWidget 重替换为 ALSeatMapSelectDialog : 对文件名进行重命名，以更贴近各自功能，ALTimerTaskWidget 重命名为 ALTimerTaskManageWidget；ALAddTimerTaskDialog 重命名为 ALTimerTaskAddDialog	2026-02-03 15:03:33 +08:00
KenanZhu	22f806bfb0	chore(*): 更新有关帮助手册的链接	2026-01-30 22:10:00 +08:00
KenanZhu	d26852eaaf	chore(*): 更新网站地址为 www.autolibrary.top	2026-01-30 22:04:29 +08:00
KenanZhu	2ffe620532	optimize(AutoLib): 优化图书馆登录页面加载超时处理逻辑	2026-01-26 16:11:26 +08:00
KenanZhu	fe42d3cd98	fix(AutoLib): 修复浏览器驱动初始化的异常控制	2026-01-26 16:10:15 +08:00
KenanZhu	0795939aa3	docs(readme): 交换使用方法与注意事项的顺序	2026-01-23 17:57:41 +08:00
KenanZhu	8b6baf9b6a	refactor(ALMainWindow): 重构主窗口类的消息队列能力，修改为直接从 MsgBase 继承	2026-01-20 17:45:32 +08:00
KenanZhu	7098d7075f	refactor(ALMainWorkers): 重构主工作线程的父类初始化方式	2026-01-20 17:43:52 +08:00
KenanZhu	be3942ea2f	optimize(MsgBase): 优化消息队列能力基类，增加小数秒精度时间戳，移除无用方法 '_inputMsg'	2026-01-20 17:41:34 +08:00
KenanZhu	7e3a089e21	refactor(gui.ALSeatMapWidget): 重构座位选图控件将座位图提取为 ALSeatMapView 类，并添加缩放限制	2026-01-18 13:50:48 +08:00
github-actions[bot]	f3d68c40cb	chore(release): v1.0.4 [auto release commit]	2026-01-17 18:18:22 +00:00
KenanZhu	0ceff677e4	docs(readme): 更新自述文档内容	2026-01-18 02:14:01 +08:00
KenanZhu	6f6b415bff	refactor(ALMainWindow, ALMainWorkers): 重构 Qt 信号函数的命名	2026-01-18 02:08:12 +08:00
KenanZhu	735f31830d	refactor(gui.*): 统一界面控件颜色风格	2026-01-18 02:08:12 +08:00
KenanZhu	7be5afeae1	style(gui.ALSeatFrame): 一些格式问题	2026-01-18 02:08:12 +08:00
KenanZhu	3d6978c9c2	optimize(gui.*): 优化界面组件的布局和样式	2026-01-18 02:08:12 +08:00
github-actions[bot]	db7a868598	chore(release): v1.0.3 [auto release commit]	2026-01-17 17:52:03 +00:00
KenanZhu	f1e0334ce3	docs(MsgBase, LibOperator): 添加并完善类文档注释	2026-01-16 23:41:25 +08:00
KenanZhu	b9411261ea	style(ALMainWorkers): 一些格式更改	2026-01-16 23:25:42 +08:00
KenanZhu	fa737711d4	optimize(ConfigReader, ConfigWriter): 优化配置文件读写类逻辑，完善异常处理，添加注释文档	2026-01-16 23:23:03 +08:00
KenanZhu	79e2128fca	style(operators.*): 显式指定浏览器驱动类型为 WebDriver	2026-01-16 23:21:36 +08:00
KenanZhu	128c8e7a83	style(*): 移除未使用的 import 语句	2026-01-16 22:37:26 +08:00
KenanZhu	6474f6e3bb	style(*): 格式化一些界面类的构造函数	2026-01-16 22:33:01 +08:00
KenanZhu	ba60a5d884	style(comment): 修改一些注释格式	2026-01-15 17:08:54 +08:00
KenanZhu	4d8f8130dc	chore(operators.__init__): 添加 LibChecker 类的简介	2026-01-13 22:40:45 +08:00
KenanZhu	eba99cab9f	fix(ALSeatMapWidget): 修复座位图选择的确定取消逻辑	2026-01-13 22:01:16 +08:00
KenanZhu	aa7a806ff7	fix(gui): 修复一些界面问题	2026-01-12 14:22:20 +08:00
KenanZhu	bb180f8c8e	fix(ALConfigWidget, LibReserve): 修改二楼楼层区域名称将二层外环改为二层西区	2026-01-09 14:06:36 +08:00
KenanZhu	107ed41b58	chore(*): 更新 license 和版权信息为 2025 - 2026 年	2026-01-09 14:00:25 +08:00
github-actions[bot]	43b87db4eb	chore(release): v1.0.2 [auto release commit]	2026-01-05 04:05:04 +00:00
KenanZhu	ae23f65e5a	fix(AutoLib): 修复并完善对不同浏览器驱动的支持，目前支持的浏览器驱动为 Edge、Chrome、Firefox 之前的代码只支持 Edge 浏览器驱动，现在完善了对 Chrome、Firefox 浏览器驱动的支持	2026-01-05 11:59:33 +08:00
KenanZhu	a7b9c340ae	refactor(ALConfigWidget): 初始化的默认浏览器驱动路径改为空	2026-01-05 11:58:15 +08:00
KenanZhu	96d733d2ed	fix(ALConfigWidget): 修复配置界面错误字符	2026-01-05 11:43:16 +08:00
KenanZhu	65cb951ada	ci(workflow): 优化 update-version.yml 中的版本信息更新逻辑对 ALVersionInfo.py 文件的更新逻辑进行差异化处理，分别为 commit-release 和 build 阶段生成不同的 artifact： * 针对 commit-release 阶段：将所有与构建（build）相关的字段值设置为 'local' 或 'null' * 针对 build 阶段：保留完整的版本信息字段这种差异化处理确保其后续提交的 release commit 不会包含构建相关的版本信息。	2026-01-04 10:05:57 +08:00
KenanZhu	94ce3433a3	ci(workflows): 重构 CI/CD 工作流执行配置	2026-01-03 14:33:49 +08:00
github-actions[bot]	dd48c8a01c	chore(release): v1.0.1 [auto release commit]	2026-01-02 16:39:02 +00:00
KenanZhu	924db3bdcc	ci(workflows): 新增基于 Github Actions 的 CI/CD 工作流控制	2026-01-03 00:35:16 +08:00
KenanZhu	1e5452d411	refactor(ALAboutDialog): 更改关于对话框的显示内容主要包括版本号，提交信息，构建时间等。为 CI/CD 流程添加相关信息占位。	2026-01-03 00:33:01 +08:00
KenanZhu	1b378e5aaa	fix(LibLogin): 修复优化验证码处理逻辑，避免无效请求。并完善手动输入验证码功能。	2026-01-02 17:37:17 +08:00
KenanZhu	e069efb2ea	fix(ALConfigWidget): 修复用户配置列表中，选中用户项时禁用该用户所在用户组时，该用户项未同步禁用状态仍保持被选中的问题	2026-01-02 00:44:24 +08:00
KenanZhu	407d25570a	fix(ALMainWorkers): 修复 AutoLibWorker 中基础检查未通过时，运行线程错误返回导致结束信号未发送的问题	2026-01-02 00:30:37 +08:00
KenanZhu	bfcb65f56a	fix(gui.ALMainWindow): 修改了 setControlButtons 方法，防止按钮状态的意外更改	2025-12-31 10:15:57 +08:00
KenanZhu	cde1e966e7	chore(gui.batchs): 将编译脚本的错误命名 complie_.bat/sh 修改为 compile_.bat/sh	2025-12-27 23:12:37 +08:00
KenanZhu	8c4f463889	docs(readme): 修改一些文档的不通顺不准确描述，新增捐助链接	2025-12-27 21:57:38 +08:00
KenanZhu	39867cc20c	docs(readme): 修改文档的歧义和其它不准确描述	2025-12-27 15:43:25 +08:00
KenanZhu	149910d628	chore(release): v1.0.0	2025-12-22 15:24:31 +08:00
KenanZhu	2a7ed099bf	docs(readme.md): 更新 readme 文档	2025-12-22 15:23:56 +08:00
KenanZhu	473f32ca29	chore(batchs): 新增界面资源和应用资源的编译脚本	2025-12-22 15:23:47 +08:00
KenanZhu	580052f1e3	chore(icons): 添加多种图标格式，将当前的图标尺寸从 1024x1024 调整为 32x32	2025-12-22 11:55:33 +08:00
KenanZhu	6abf530307	optimize(ALTimerTaskWidget, ALConfigWidget): 优化定时器和用户设置的任务列表排序	2025-12-22 11:53:45 +08:00
KenanZhu	577c651ef8	feat(ALMainWindow): 引入对新增定时器任务状态 - 执行失败的处理支持 (#18ae949) 同时，为了统一消息处理，我们将 ALMainWorkers 中的原信号槽处理的消息逻辑更改为使用继承的 MsgBase 类的 showTrace 方法	2025-12-13 14:27:46 +08:00
KenanZhu	18ae949900	feat(ALTimerTaskWidget): 新增定时器任务状态 - 执行失败	2025-12-13 14:22:28 +08:00
KenanZhu	ca9059d1db	refactor(AutoLib): 初始化 AutoLib 时，发生错误则抛出异常	2025-12-13 14:21:26 +08:00
KenanZhu	ad4deae0c6	fix(ALMainWindow): 修复停止时的按钮状态重置问题函数更改于(#9255eec)	2025-12-13 14:15:28 +08:00
KenanZhu	55ae4d0d96	feat(ALConfigWidget): 大更新 - 用户树状列表和其它 1. 在这个 commit 中，我们思考了许久，最终决定将现有的用户管理列表转为树状列表，以解决用户数量增多时，用户的选择性管理，分组等问题。 2. 同时因为该更改需要重构很多内容，我们也在该 commit 中决定将所有‘系统配置’更换为‘运行配置’，同时文件名称和内容变量也相应变为‘run’和‘user’。 3. 重构 AutoLib 和 ALMainWorkers 中的配置相关代码，以适应新的用户树状列表。当前迭代更新至 v1.0.0-beta.4，同时，在该版本的 rc 阶段前，我们计划不再发布 beta 阶段相关的 release	2025-12-13 00:07:33 +08:00
KenanZhu	7dcd72939b	fix(ALMainWindow): fix the wrong use of function 'setControlButtons'	2025-12-12 23:51:54 +08:00
KenanZhu	bfce61f4b4	fix(ALTimerTaskWidget): fix timer tasks list is 'NoneType' when init config file	2025-12-12 23:41:30 +08:00
KenanZhu	60a5699822	refactor(ALConfigWidget): ALConfigWidget is changed into non-modal dialog	2025-12-12 18:59:25 +08:00
KenanZhu	aab9565012	fix(*): always show the child window on the center of the parent window and do not overflow the screen	2025-12-09 08:54:45 +08:00
KenanZhu	9255eec9f1	style(ALMainWindow): rename some variables and functions	2025-12-09 08:51:14 +08:00
KenanZhu	cff6fd8fc0	feat(ALTimerTaskWidget): timer tasks' data persistence and perpetuation	2025-12-09 08:49:44 +08:00
KenanZhu	b129f47b48	chore(ALSeat*): rename SeatFrame, SeatMapTable, SeatMapWidget to ALSeatFrame, ALSeatMapTable, ALSeatMapWidget	2025-12-09 08:46:51 +08:00
KenanZhu	069429be71	refactor(ALAboutDialog): replace hide/show methods with 'exec()' for dialog modal handling	2025-12-09 08:19:25 +08:00
KenanZhu	7d064fc8e7	refactor(ALMainWindow): extract the worker threads to a separate file : ALMainWorkers.py	2025-12-09 08:17:39 +08:00
KenanZhu	1b172ad396	style(*): some small style changes	2025-11-30 18:46:12 +08:00
KenanZhu	05c9d433f4	hotfix(LibRenew): fix the serious bug that the renew process always failed in this hotfix, we fix the renew bug because we do not refresh the page after renew the seat, this will make the subsequent operators, such as logout ... unable to in progress.	2025-11-30 18:42:20 +08:00
KenanZhu	65ca40438d	fix(ALMainWindow.ui): fix the convert error of ALMainWindow.ui we fix the convert error of ALMainWindow.ui by using pyside6-uic to convert the ui file to python code	2025-11-29 22:31:18 +08:00
KenanZhu	0a8763add5	feat(gui): breaking changes - Timer Task Management 1. we add menu actions 'manual' and 'about', so you can click actions to open manual and about dialog. 2. we introduce timer task management feature, so you can add, delete timer tasks to auto run task. 3. other style improvement in gui...	2025-11-29 20:03:45 +08:00
KenanZhu	c5e589f3d1	fix(ALConfigWidget): optimize the logic when delete user list item	2025-11-29 19:52:22 +08:00
KenanZhu	5e5deba773	fix(LibReserve): fix the mistakely passed parameter 'reserve_info' we forget to pass the username because the 'reserve_info' do not contain the username	2025-11-28 15:15:39 +08:00
KenanZhu	842fb434f4	feat(AutoLib): new feature 'Auto Renew'	2025-11-28 15:03:51 +08:00
KenanZhu	6cabddf0cd	fix(operators): optimized the reserve information pre-check and more readable output	2025-11-28 15:00:09 +08:00
KenanZhu	0322558339	fix(operators): the operations's result message only show in their output queue	2025-11-28 14:58:13 +08:00
				`@@ -0,0 +1 @@`
				`This folder is used to store the batch scripts.`
				`@@ -1 +0,0 @@`
				`For more infomation, please visit our website: https://www.autolibrary.cv`
				`@@ -1 +0,0 @@`
				`This folder is used to store the browser driver using by selenium.`
				`@@ -1 +0,0 @@`
				`This folder is used to store the model using by ddddocr.`
				`@@ -0,0 +1 @@`
				`This folder is used to store the models using by ddddocr.`
				`@@ -1 +0,0 @@`
				`this folder is used to store the config files.`
				`@@ -0,0 +1 @@`
				`This folder is used to store the template config files.`