docs(readme): 更新 “后续会有哪些功能？” 部分，可重复性定时任务功能已完成

- feat(LibCheckin): 支持校园网环境下图书馆远程签到 
- feat(TimerUtils): 新增重复任务时间计算工具 
- feat(TimerTask): 新增任务执行历史对话框 
- feat(TimerTaskAddDialog): 添加重复任务 UI 支持 
- feat(TimerTaskManageWidget): 实现重复任务执行与历史记录 
- fix(ALTimerTaskAddDialog): 修改添加定时任务对话框的重复选项的 Label 描述和布局
- fix(ALTimerTaskAddDialog): 修改定时任务时间类型中相对时间控件的布局样式 
- fix(ALTimerTaskAddDialog): 删除定时任务数据中多余的字段 ‘repeat_records’
- fix(ALTimerTaskAddDialog): 修改添加定时任务对话框的重复选项的 Label 描述和布局 
- style(ALTimerTaskManageWidget): 统一 import 语句的格式 
- refactor(ALTimerTaskItemWidget): 一些变量重构
- optimze(gui): 优化删除按钮样式，使其更加醒目；优化 ALTimerTaskManageWidget 的宽度 
- optimize(gui): 优化定时任务管理功能 
- fix(ALTimerTaskManageWidget): 修复删除任务的信号槽参数传递问题

.github/workflows/build-test.yml

@@ -0,0 +1,221 @@
+name: Build Test
+
+# This workflow builds the application for testing purposes.
+# It is triggered when a pull request is opened, synchronized, or reopened against the main branch.
+
+on:
+  push:
+    branches:
+      - main
+
+  pull_request:
+    branches:
+      - main
+    types:
+      - opened
+      - synchronize
+      - reopened
+  # Allow manual trigger for testing
+  workflow_dispatch:
+
+#
+# Build Windows
+#
+
+jobs:
+  build-windows:
+    runs-on: windows-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v6
+      with:
+        ref: ${{ github.ref }}
+
+    - name: Get version info
+      id: get_version
+      run: |
+        $version = "pr-test"
+        $tagName = "pr-test"
+
+        Write-Host "✓ Mode: Pull Request Test Build"
+        Write-Host "✓ Tag: $tagName"
+        Write-Host "✓ Version: $version"
+
+        "VERSION=$version" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
+        "TAG_NAME=$tagName" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
+      shell: pwsh
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      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_NAME=$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@v6
+      with:
+        name: AutoLibrary.${{ steps.get_version.outputs.TAG_NAME }}-windows-x86_64
+        path: |
+          ${{ steps.zip_release.outputs.ZIP_NAME }}
+        retention-days: 7
+
+    - name: Upload build summary
+      run: |
+        Write-Host "## Build Test Summary" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8
+        Write-Host "" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        Write-Host "✓ Pull request build test completed successfully!" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        Write-Host "- Version: ${{ steps.get_version.outputs.VERSION }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        Write-Host "- Tag: ${{ steps.get_version.outputs.TAG_NAME }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        Write-Host "- Pull Request #${{ github.event.pull_request.number }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        Write-Host "- Branch: ${{ github.event.pull_request.head.ref }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        Write-Host "- Event: ${{ github.event_name }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+      shell: pwsh

.github/workflows/build.yml

@@ -8,21 +8,19 @@ name: Build
 on:
   workflow_call:
     inputs:
-      version:
-        description: 'Version number'
-        required: true
-        type: string
       tag_name:
         description: 'Tag name'
-        required: true
+        required: false
         type: string
-    outputs:
       version:
-        description: 'The version number'
+        description: 'Version number'
-        value: ${{ jobs.build-windows.outputs.version }}
+        required: false
-      tag_name:
+        type: string
-        description: 'The tag name'
+      is_test:
-        value: ${{ jobs.build-windows.outputs.tag_name }}
+        description: 'Whether this is a test build (not a release)'
+        required: false
+        type: string
+        default: 'true'
 
 #
 # Build Windows
@@ -32,18 +30,18 @@ jobs:
   build-windows:
     runs-on: windows-latest
     outputs:
-      version: ${{ steps.get_version.outputs.VERSION }}
       tag_name: ${{ steps.get_version.outputs.TAG_NAME }}
+      version: ${{ steps.get_version.outputs.VERSION }}
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
-        ref: main
+        ref: ${{ github.ref }}
 
     # 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
+      uses: actions/download-artifact@v6
       with:
         name: updated-version-info-for-build
         path: src/gui/
@@ -51,13 +49,27 @@ jobs:
     - name: Get version info
       id: get_version
       run: |
-        $version = "${{ inputs.version }}"
+        $isTest = "${{ inputs.is_test }}"
-        $tagName = "${{ inputs.tag_name }}"
+        if ($isTest -eq "true") {
+          $version = "test"
+          $tagName = "test"
+          Write-Host "✓ Mode: Test Build"
+        } else {
+          $version = "${{ inputs.version }}"
+          $tagName = "${{ inputs.tag_name }}"
+
+          if ([string]::IsNullOrEmpty($version)) {
+            $version = "test"
+            $tagName = "test"
+            Write-Host "✓ Mode: Independent Build (No inputs provided)"
+          }
+        }
 
-        echo "TAG_NAME=$tagName" >> $env:GITHUB_OUTPUT
-        echo "VERSION=$version" >> $env:GITHUB_OUTPUT
         Write-Host "✓ Tag: $tagName"
         Write-Host "✓ Version: $version"
+
+        "VERSION=$version" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
+        "TAG_NAME=$tagName" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
       shell: pwsh
 
     - name: Verify 'ALVersionInfo.py' was updated
@@ -70,7 +82,7 @@ jobs:
       shell: pwsh
 
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v6
       with:
         python-version: '3.13'
 
@@ -94,13 +106,13 @@ jobs:
           exit 1
         }
 
-        if (-not (Test-Path "model")) {
+        if (-not (Test-Path "models")) {
-          New-Item -ItemType Directory -Path "model" | Out-Null
+          New-Item -ItemType Directory -Path "models" | Out-Null
-          Write-Host "✓ Created model directory"
+          Write-Host "✓ Created models directory"
         }
 
         $onnxSource = Join-Path $ddddocrPath "common.onnx"
-        $onnxDest = "model/common.onnx"
+        $onnxDest = "models/common.onnx"
         if (Test-Path $onnxSource) {
           Copy-Item $onnxSource $onnxDest -Force
           Write-Host "✓ Copied ONNX model from: $onnxSource"
@@ -119,18 +131,18 @@ jobs:
         }
       shell: pwsh
 
-    - name: Compile Qt UI files
-      run: |
-        cd src/gui/batchs
-        ./compile_ui.bat
-      shell: cmd
-
     - name: Compile Qt Resource files
       run: |
-        cd src/gui/batchs
+        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 }}"
@@ -148,8 +160,8 @@ jobs:
           "    pathex=[],"
           "    binaries=[],"
           "    datas=["
-          "        ('model\\common.onnx', 'ddddocr'),"
+          "        ('models\\common.onnx', 'ddddocr'),"
-          "        ('src\\gui\\icons\\AutoLibrary_32x32.ico', 'gui\\icons'),"
+          "        ('src\\gui\\resources\\icons\\AutoLibrary_32x32.ico', 'gui\\resources\\icons'),"
           "    ],"
           "    hiddenimports=[],"
           "    hookspath=[],"
@@ -164,10 +176,7 @@ jobs:
           "exe = EXE("
           "    pyz,"
           "    a.scripts,"
-          "    a.binaries,"
+          "    name='AutoLibrary',"
-          "    a.datas,"
-          "    [],"
-          "    name='$exeName',"
           "    debug=False,"
           "    bootloader_ignore_signals=False,"
           "    strip=False,"
@@ -180,12 +189,22 @@ jobs:
           "    target_arch=None,"
           "    codesign_identity=None,"
           "    entitlements_file=None,"
-          "    icon=['src\\gui\\icons\\AutoLibrary_32x32.ico'],"
+          "    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 generated successfully"
+        Write-Host "✓ Main.spec (non-single file) generated successfully"
         Write-Host "`nGenerated Main.spec ============"
         Get-Content "Main.spec" | Write-Host
         Write-Host "==================================`n"
@@ -200,17 +219,17 @@ jobs:
       run: |
         $tagName = "${{ steps.get_version.outputs.TAG_NAME }}"
         $version = "${{ steps.get_version.outputs.VERSION }}"
-        $exeName = "AutoLibrary-$version.exe"
+        $distDir = "dist/AutoLibrary-$version"
         $zipName = "AutoLibrary.$tagName-windows-x86_64.zip"
 
-        echo "ZIP_PATH=$zipName" >> $env:GITHUB_OUTPUT
+        echo "ZIP_NAME=$zipName" >> $env:GITHUB_OUTPUT
 
-        Write-Host "Looking for executable: dist/$exeName"
+        Write-Host "Looking for distribution directory: $distDir"
-        if (Test-Path "dist/$exeName") {
+        if (Test-Path $distDir) {
-          Compress-Archive -Path "dist/$exeName" -DestinationPath $zipName
+          Compress-Archive -Path "$distDir/*" -DestinationPath $zipName
-          Write-Host "✓ Created release archive: $zipName"
+          Write-Host "✓ Created release archive (directory mode): $zipName"
         } else {
-          Write-Error "✗ Executable not found: dist/$exeName"
+          Write-Error "✗ Distribution directory not found: $distDir"
           Write-Host "Files in dist directory:"
           Get-ChildItem "dist" | ForEach-Object { Write-Host "  - $($_.Name)" }
           exit 1
@@ -218,8 +237,21 @@ jobs:
       shell: pwsh
 
     - name: Archive artifacts
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v6
       with:
         name: AutoLibrary.${{ steps.get_version.outputs.TAG_NAME }}-windows-x86_64
         path: |
-          ${{ steps.zip_release.outputs.ZIP_PATH }}
+          ${{ steps.zip_release.outputs.ZIP_NAME }}
+        retention-days: ${{ github.event_name != 'workflow_call' && 7 || 90 }}
+
+    - name: Upload build summary
+      if: ${{ github.event_name != 'workflow_call' }}
+      run: |
+        Write-Host "## Build Summary" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8
+        Write-Host "" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        Write-Host "✓ Build test completed successfully!" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        Write-Host "- Version: ${{ steps.get_version.outputs.VERSION }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        Write-Host "- Tag: ${{ steps.get_version.outputs.TAG_NAME }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        Write-Host "- Event: ${{ github.event_name }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+        Write-Host "- Ref: ${{ github.ref }}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Encoding utf8 -Append
+      shell: pwsh

.github/workflows/commit-release.yml

@@ -1,7 +1,7 @@
 name: Commit Release
 
 # This workflow commits version changes in 'ALVersionInfo.py' (get from artifacts) and
-# moves the release tag to this new release commit.
+# creates/moves the release tag to this new release commit.
 #
 # It is triggered when called by the release workflow.
 
@@ -9,7 +9,7 @@ on:
   workflow_call:
     inputs:
       tag_name:
-        description: 'Tag name to move (e.g., v1.0.0)'
+        description: 'Tag name to create/move (e.g., v1.0.0 or v1.0.0-rc1)'
         required: true
         type: string
       version:
@@ -20,10 +20,33 @@ on:
         description: 'File path to commit'
         required: true
         type: string
+      create_tag:
+        description: 'Whether to create new tag (true) or move existing tag (false)'
+        required: false
+        type: string
+        default: 'false'
+      is_rc:
+        description: 'Whether this is a release candidate (pre-release)'
+        required: false
+        type: string
+        default: 'false'
+      ref:
+        description: 'Git ref to checkout (release branch)'
+        required: true
+        type: string
     outputs:
+      tag_name:
+        description: 'The tag name created/moved'
+        value: ${{ inputs.tag_name }}
+      version:
+        description: 'Version number for commit message'
+        value: ${{ inputs.version }}
       new_commit_sha:
-        description: 'The new commit SHA after moving the tag'
+        description: 'The new commit SHA after creating/moving the tag'
         value: ${{ jobs.commit-release.outputs.new_commit_sha }}
+      branch_name:
+        description: 'The branch name where the commit was made'
+        value: ${{ jobs.commit-release.outputs.branch_name }}
 
 jobs:
   commit-release:
@@ -32,18 +55,19 @@ jobs:
       contents: write
     outputs:
       new_commit_sha: ${{ steps.commit_info.outputs.commit_sha }}
+      branch_name: ${{ steps.push_release.outputs.branch_name }}
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
-        ref: main
+        ref: ${{ inputs.ref }}
         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
+      uses: actions/download-artifact@v6
       with:
         name: updated-version-info-for-commit
         path: downloaded-file/
@@ -81,18 +105,38 @@ jobs:
         git commit -m "chore(release): v${VERSION} [auto release commit]"
         echo "✓ Changes committed"
 
-    - name: Push to main branch
+    - name: Push to release branch
+      id: push_release
       run: |
-        MAIN_BRANCH=$(git remote show origin | grep 'HEAD branch' | cut -d' ' -f5)
+        # Get the release branch name from the input ref
-        if [ -z "$MAIN_BRANCH" ]; then
+        BRANCH_NAME=$(echo "${{ inputs.ref }}" | sed 's|refs/heads/||')
-          MAIN_BRANCH="main"
+
+        if [ -z "$BRANCH_NAME" ]; then
+          echo "✗ Error: Could not determine branch name from ref: ${{ inputs.ref }}"
+          exit 1
         fi
 
-        echo "Pushing to branch: ${MAIN_BRANCH}"
+        echo "Pushing to branch: ${BRANCH_NAME}"
-        git push origin HEAD:${MAIN_BRANCH}
+        git push origin HEAD:${BRANCH_NAME}
-        echo "✓ Changes pushed to ${MAIN_BRANCH}"
+        echo "✓ Changes pushed to ${BRANCH_NAME}"
+
+        # Output branch name for downstream jobs
+        echo "branch_name=$BRANCH_NAME" >> $GITHUB_OUTPUT
+
+    - name: Create tag for release
+      if: ${{ inputs.create_tag == 'true' }}
+      run: |
+        TAG_NAME="${{ inputs.tag_name }}"
+        IS_RC="${{ inputs.is_rc }}"
+
+        echo "Creating new tag ${TAG_NAME} at this commit..."
+        echo "Release type: $([ "$IS_RC" = "true" ] && echo "Release Candidate (Pre-release)" || echo "Stable Release")"
+        git tag ${TAG_NAME}
+        git push origin ${TAG_NAME}
+        echo "✓ Tag ${TAG_NAME} created at commit $(git rev-parse --short HEAD)"
 
     - name: Move tag to new release commit
+      if: ${{ inputs.create_tag != 'true' }}
       run: |
         TAG_NAME="${{ inputs.tag_name }}"
 

.github/workflows/release.yml

@@ -1,36 +1,48 @@
 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
+# It is triggered when a new release branch is created (release/vX.Y.Z or release/vX.Y.Z-rc*)
 #
 # Workflow Steps:
 # START >
 
-# 1. Update Version:
+# 1. Extract Version:
+#       Extracts version number from branch name:
+#       - release/v1.0.0 -> v1.0.0 (stable release)
+#       - release/v1.0.0-rc1 -> v1.0.0 (release candidate)
+
+# 2. 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:
+# 3. Commit Release:
-#       Commits version changes and moves the release tag to this new release commit.
+#       Commits version changes to release branch and creates the release tag.
 
-# 3. Build:
+# 4. Build:
 #       Compiles the application for Windows platform using PyInstaller, and
 #       archives the built artifacts as 'AutoLibrary.<tag_name>-windows-x86_64.zip'.
 
-# 4. Release:
+# 5. Release:
 #       Creates GitHub release with generated artifacts and release notes
 
 # < END
 #
+# 6. Merge back:
+#       Merges release branch back to main branch, and clean/delete the release branch
+#
 # The workflow ensures version consistency between source code, built artifacts, and GitHub releases
 # while maintaining proper commit history and tag management.
+#
+# IMPORTANT: This workflow only triggers on branch CREATION, not on pushes to release branches.
+# If you need to fix issues on a release branch, delete the tag, merge fixes to main,
+# and create a new release branch.
 
 on:
   push:
-    tags:
+    branches:
-      - 'v[0-9]+.[0-9]+.[0-9]+'
+      - 'release/v*'
 
 jobs:
   #
@@ -44,6 +56,62 @@ jobs:
     - name: Start release
       run: |
         echo "✓ Starting release"
+        echo "Branch: ${{ github.ref_name }}"
+        echo "Ref: ${{ github.ref }}"
+
+  #
+  # Extract version :
+  #   this job extracts version from branch name
+  #
+
+  extract-version:
+    needs:
+      - start
+    runs-on: ubuntu-latest
+    outputs:
+      tag_name: ${{ steps.extract.outputs.tag_name }}
+      version: ${{ steps.extract.outputs.version }}
+      is_rc: ${{ steps.extract.outputs.is_rc }}
+    steps:
+    - name: Extract version from branch name
+      id: extract
+      run: |
+        BRANCH_NAME="${{ github.ref_name }}"
+
+        # Validate branch name starts with 'release/v'
+        if ! echo "$BRANCH_NAME" | grep -qE '^release/v'; then
+          echo "✗ Error: Branch '$BRANCH_NAME' does not start with 'release/v'"
+          echo "✗ This workflow should only be triggered by release branches"
+          exit 1
+        fi
+
+        # Extract version from branch name:
+        # - release/v1.0.0 -> v1.0.0 (stable)
+        # - release/v1.0.0-rc1 -> v1.0.0 (release candidate)
+        # - release/v1.0.0-alpha.1 -> v1.0.0-alpha.1 (pre-release)
+        if echo "$BRANCH_NAME" | grep -qE '^release/v[0-9]+\.[0-9]+\.[0-9]+$'; then
+          # Stable release: release/v1.0.0 -> v1.0.0
+          TAG_NAME=$(echo "$BRANCH_NAME" | sed -E 's|^release/(v[0-9]+\.[0-9]+\.[0-9]+)$|\1|')
+          IS_RC=false
+        elif echo "$BRANCH_NAME" | grep -qE '^release/v[0-9]+\.[0-9]+\.[0-9]+-'; then
+          # Pre-release: release/v1.0.0-rc1 -> v1.0.0-rc1
+          TAG_NAME=$(echo "$BRANCH_NAME" | sed -E 's|^release/(v[0-9]+\.[0-9]+\.[0-9]+-.*)$|\1|')
+          IS_RC=true
+        else
+          echo "✗ Error: Branch '$BRANCH_NAME' does not match expected format"
+          echo "✗ Expected format: release/vX.Y.Z or release/vX.Y.Z-rcX"
+          exit 1
+        fi
+        VERSION="${TAG_NAME#v}"
+
+        echo "TAG_NAME=$TAG_NAME" >> $GITHUB_OUTPUT
+        echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
+        echo "IS_RC=$IS_RC" >> $GITHUB_OUTPUT
+
+        echo "✓ Branch: $BRANCH_NAME"
+        echo "✓ Tag: $TAG_NAME"
+        echo "✓ Version: $VERSION"
+        echo "✓ Is RC: $IS_RC"
 
   #
   # Update version :
@@ -52,31 +120,35 @@ jobs:
 
   update-version:
     needs:
-      - start
+      - extract-version
     uses: ./.github/workflows/update-version.yml
     permissions:
       contents: write
     with:
-      tag_name: ${{ github.ref_name }}
+      tag_name: ${{ needs.extract-version.outputs.tag_name }}
       ref: ${{ github.ref }}
 
   #
   # Commit release :
-  #   this job commits the updated version file and move the release
+  #   this job commits the updated version file to main and creates
-  #   tag to this new commit
+  #   the release tag (not moving an existing tag)
   #
 
   commit-release:
     needs:
+      - extract-version
       - 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 }}
+      tag_name: ${{ needs.extract-version.outputs.tag_name }}
-      version: ${{ needs.update-version.outputs.version }}
+      version: ${{ needs.extract-version.outputs.version }}
       file_path: src/gui/ALVersionInfo.py
+      create_tag: 'true'
+      is_rc: ${{ needs.extract-version.outputs.is_rc }}
+      ref: ${{ github.ref }}
 
   #
   # Build :
@@ -91,8 +163,9 @@ jobs:
     permissions:
       contents: write
     with:
-      version: ${{ needs.update-version.outputs.version }}
       tag_name: ${{ needs.update-version.outputs.tag_name }}
+      version: ${{ needs.update-version.outputs.version }}
+      is_test: 'false'
 
   #
   # Release :
@@ -102,41 +175,30 @@ jobs:
     runs-on: ubuntu-latest
     needs:
       - build
+      - extract-version
     if: always() && needs.build.result == 'success'
     permissions:
       contents: write
 
     steps:
     - name: Download artifacts
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v6
       with:
-        name: AutoLibrary.${{ needs.build.outputs.tag_name }}-windows-x86_64
+        name: AutoLibrary.${{ needs.extract-version.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 }}
+        tag_name: ${{ needs.extract-version.outputs.tag_name }}
-        name: AutoLibrary ${{ needs.build.outputs.tag_name }}
+        name: AutoLibrary ${{ needs.extract-version.outputs.tag_name }}
         files: |
-          artifacts/AutoLibrary.${{ needs.build.outputs.tag_name }}-windows-x86_64.zip
+          artifacts/AutoLibrary.${{ needs.extract-version.outputs.tag_name }}-windows-x86_64.zip
         draft: false
-        prerelease: false
+        prerelease: ${{ needs.extract-version.outputs.is_rc == 'true' }}
         generate_release_notes: true
         body: |
-          ### 下载获取
-          - **Windows x86_64**: `AutoLibrary.${{ needs.build.outputs.tag_name }}-windows-x86_64.zip`
-
-          ### 如何使用
-          1. 下载 `AutoLibrary.${{ needs.build.outputs.tag_name }}-windows-x86_64.zip` 文件
-          2. 解压到任意目录
-          3. 下载对应浏览器的驱动文件
-          4. 运行 `AutoLibrary-${{ needs.build.outputs.version }}.exe` (首次运行会初始化配置文件)
-          5. 按照提示操作即可
-
-          更多详情请访问 [AutoLibrary 网站](http://autolibrary.cv) 和查看 [帮助手册](https://autolibrary.cv/docs/manual_lists.html)
-
           ---
           **完整更新日志见下方自动生成的 Release Notes**
       env:
@@ -154,3 +216,107 @@ jobs:
     - name: End release
       run: |
         echo "✓ Ending release"
+
+  #
+  # Merge Back :
+  #   this job merges the release branch to main after successful release
+  #
+
+  merge-back:
+    needs:
+      - release
+      - extract-version
+      - commit-release
+    if: ${{ needs.release.result == 'success' && needs.commit-release.result == 'success' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v6
+      with:
+        fetch-depth: 0
+
+    - name: Merge release branch to main
+      run: |
+        git config user.name "github-actions[bot]"
+        git config user.email "github-actions[bot]@users.noreply.github.com"
+
+        # Use the release branch name from the original trigger
+        BRANCH_NAME="${{ needs.extract-version.outputs.tag_name }}"
+        # Extract branch name: v1.0.0 -> release/v1.0.0
+        if [[ ! "$BRANCH_NAME" =~ ^release/ ]]; then
+          BRANCH_NAME="release/${BRANCH_NAME}"
+        fi
+
+        MAIN_BRANCH=$(git remote show origin | grep 'HEAD branch' | cut -d' ' -f5)
+
+        if [ -z "$MAIN_BRANCH" ]; then
+          MAIN_BRANCH="main"
+        fi
+
+        echo "Merging ${BRANCH_NAME} to ${MAIN_BRANCH}..."
+        echo "Current commit info:"
+        git log --oneline -3
+
+        # Fetch all branches including the release branch
+        git fetch origin ${BRANCH_NAME}
+        git fetch origin ${MAIN_BRANCH}
+
+        # Checkout main branch
+        git checkout ${MAIN_BRANCH}
+
+        # Show branch status before merge
+        echo "=== Branch status before merge ==="
+        git log --oneline --graph --all -5
+        echo "=== Diff between ${MAIN_BRANCH} and origin/${BRANCH_NAME} ==="
+        git diff ${MAIN_BRANCH} origin/${BRANCH_NAME} --stat || echo "No differences found"
+
+        # Force create a merge commit even if there are no changes
+        # This ensures the release history is properly recorded
+        git merge origin/${BRANCH_NAME} \
+          --no-ff \
+          -m "chore(release): merge ${BRANCH_NAME} to ${MAIN_BRANCH} [auto release commit]"
+
+        # Show merge result
+        echo "=== Merge result ==="
+        git log --oneline --graph -3
+
+        # Push to main
+        git push origin ${MAIN_BRANCH}
+
+        echo "✓ Successfully merged ${BRANCH_NAME} to ${MAIN_BRANCH}"
+
+    - name: Delete release branch
+      run: |
+        BRANCH_NAME="${{ needs.extract-version.outputs.tag_name }}"
+        # Extract branch name: v1.0.0 -> release/v1.0.0
+        if [[ ! "$BRANCH_NAME" =~ ^release/ ]]; then
+          BRANCH_NAME="release/${BRANCH_NAME}"
+        fi
+
+        echo "Deleting release branch: ${BRANCH_NAME}"
+        git push origin --delete ${BRANCH_NAME}
+        echo "✓ Deleted branch ${BRANCH_NAME}"
+
+    - name: Release cleanup summary
+      run: |
+        BRANCH_NAME="${{ github.ref_name }}"
+        TAG_NAME="${{ needs.extract-version.outputs.tag_name }}"
+        MAIN_BRANCH=$(git remote show origin | grep 'HEAD branch' | cut -d' ' -f5)
+        if [ -z "$MAIN_BRANCH" ]; then
+          MAIN_BRANCH="main"
+        fi
+
+        echo "## Release Cleanup Summary" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "✓ Release completed successfully!" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### Actions Performed:" >> $GITHUB_STEP_SUMMARY
+        echo "- Merged \`${BRANCH_NAME}\` to \`${MAIN_BRANCH}\`" >> $GITHUB_STEP_SUMMARY
+        echo "- Deleted release branch \`${BRANCH_NAME}\`" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### Release Details:" >> $GITHUB_STEP_SUMMARY
+        echo "- Tag: \`${TAG_NAME}\`" >> $GITHUB_STEP_SUMMARY
+        echo "- Version: \`${{ needs.extract-version.outputs.version }}\`" >> $GITHUB_STEP_SUMMARY
+        echo "- Release Type: $([ "${{ needs.extract-version.outputs.is_rc }}" = "true" ] && echo "Release Candidate" || echo "Stable Release")" >> $GITHUB_STEP_SUMMARY

.github/workflows/update-version.yml

@@ -42,7 +42,7 @@ jobs:
 
     steps:
     - name: Checkout code
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
         ref: ${{ inputs.ref }}
         fetch-depth: 0
@@ -148,7 +148,7 @@ jobs:
 
     - name: Upload modified ALVersionInfo.py ready for build
       if: steps.check_changes.outputs.has_changes == 'true'
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v6
       with:
         name: updated-version-info-for-build
         path: src/gui/temp/ALVersionInfo.py
@@ -156,7 +156,7 @@ jobs:
 
     - name: Upload modified ALVersionInfo.py ready for commit
       if: steps.check_changes.outputs.has_changes == 'true'
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v6
       with:
         name: updated-version-info-for-commit
         path: src/gui/ALVersionInfo.py

.gitignore

@@ -6,16 +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
-src/gui/Ui_ALTimerTaskWidget.py
-src/gui/Ui_ALAddTimerTaskDialog.py
-src/gui/Ui_ALAboutDialog.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

batchs/compile_rc.bat

@@ -3,6 +3,7 @@ chcp 65001 >nul
 setlocal enabledelayedexpansion
 
 cd /d "%~dp0.."
+cd src/gui/resources
 
 echo [AutoLibrary compile] 检查翻译文件...
 if exist translators (
@@ -18,12 +19,11 @@ if exist translators (
 
             pyside6-lrelease "%%f"
             if !errorlevel! equ 0 (
-                echo [AutoLibrary compile] 翻译文件 "%%f" ✓ 编译成功，输出文件: "!qm_filename!"
+                echo [AutoLibrary compile] 翻译文件 "%%f" 编译成功，输出文件: "!qm_filename!"
             ) else (
-                echo [AutoLibrary compile] 翻译文件 "%%f" ✗ 编译失败
+                echo [AutoLibrary compile] 翻译文件 "%%f" 编译失败
             )
         )
-        echo.
     ) else (
         echo [AutoLibrary compile] 未找到任何 .ts 翻译文件
     )
@@ -52,11 +52,10 @@ for %%f in (*.qrc) do (
 
     pyside6-rcc "%%f" -o "!output_file!"
     if !errorlevel! equ 0 (
-        echo [AutoLibrary compile] 文件 "%%f" ✓ 编译成功，输出文件: "!output_file!"
+        echo [AutoLibrary compile] 文件 "%%f" 编译成功，输出文件: "!output_file!"
     ) else (
-        echo [AutoLibrary compile] 文件 "%%f" ✗ 编译失败
+        echo [AutoLibrary compile] 文件 "%%f" 编译失败
     )
-    echo.
 )
 
 echo [AutoLibrary compile] 所有操作完成。

batchs/compile_rc.sh

@@ -1,8 +1,9 @@
 #!/bin/bash
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PARENT_DIR="$(dirname "$SCRIPT_DIR")"
+PRJECT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR"
+
+cd "$PRJECT_DIR/src/gui/resources"
 
 echo "[AutoLibrary compile] 检查翻译文件..."
 if [ -d "translators" ]; then
@@ -10,7 +11,6 @@ if [ -d "translators" ]; then
     ts_files=(*.ts)
     ts_count=${#ts_files[@]}
 
-    # 如果第一个元素是"*.ts"（表示没有匹配），则数量为0
     if [ "$ts_count" -eq 1 ] && [ "${ts_files[0]}" = "*.ts" ]; then
         ts_count=0
     fi
@@ -23,12 +23,11 @@ if [ -d "translators" ]; then
             echo "[AutoLibrary compile] 正在编译翻译文件: \"$file\" -> \"$qm_file\""
 
             if pyside6-lrelease "$file"; then
-                echo "[AutoLibrary compile] 翻译文件 \"$file\" ✓ 编译成功，输出文件: \"$qm_file\""
+                echo "[AutoLibrary compile] 翻译文件 \"$file\" 编译成功，输出文件: \"$qm_file\""
             else
-                echo "[AutoLibrary compile] 翻译文件 \"$file\" ✗ 编译失败"
+                echo "[AutoLibrary compile] 翻译文件 \"$file\" 编译失败"
             fi
         done
-        echo
     else
         echo "[AutoLibrary compile] 未找到任何 .ts 翻译文件"
     fi
@@ -36,7 +35,6 @@ if [ -d "translators" ]; then
 else
     echo "[AutoLibrary compile] 未找到 translators 目录"
 fi
-echo
 
 file_count=$(ls *.qrc 2>/dev/null | wc -l)
 
@@ -46,7 +44,6 @@ if [ $file_count -eq 0 ]; then
 fi
 
 echo "[AutoLibrary compile] 找到 $file_count 个 .qrc 文件，开始编译..."
-echo
 
 for file in *.qrc; do
     base_name=$(basename "$file" .qrc)
@@ -54,11 +51,10 @@ for file in *.qrc; do
     echo "[AutoLibrary compile] 正在编译: \"$file\" -> \"$output_file\""
 
     if pyside6-rcc "$file" -o "$output_file"; then
-        echo "[AutoLibrary compile] 文件 \"$file\" ✓ 编译成功，输出文件: \"$output_file\""
+        echo "[AutoLibrary compile] 文件 \"$file\" 编译成功，输出文件: \"$output_file\""
     else
-        echo "[AutoLibrary compile] 文件 \"$file\" ✗ 编译失败"
+        echo "[AutoLibrary compile] 文件 \"$file\" 编译失败"
     fi
-    echo
 done
 
 echo "[AutoLibrary compile] 所有操作完成。"

batchs/compile_ui.bat

@@ -3,6 +3,7 @@ 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
@@ -23,11 +24,10 @@ for %%f in (*.ui) do (
 
     pyside6-uic "%%f" -o "!output_file!"
     if !errorlevel! equ 0 (
-        echo [AutoLibrary compile] 文件 "%%f" ✓ 编译成功，输出文件: "!output_file!"
+        echo [AutoLibrary compile] 文件 "%%f" 编译成功，输出文件: "!output_file!"
     ) else (
-        echo [AutoLibrary compile] 文件 "%%f" ✗ 编译失败
+        echo [AutoLibrary compile] 文件 "%%f" 编译失败
     )
-    echo.
 )
 
 echo [AutoLibrary compile] 所有操作完成。

batchs/compile_ui.sh

@@ -1,8 +1,9 @@
 #!/bin/bash
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PARENT_DIR="$(dirname "$SCRIPT_DIR")"
+PRJECT_DIR="$SCRIPT_DIR/.."
-cd "$PARENT_DIR"
+
+cd "$PRJECT_DIR/src/gui/resources/ui"
 
 file_count=$(ls *.ui 2>/dev/null | wc -l)
 
@@ -12,7 +13,6 @@ if [ $file_count -eq 0 ]; then
 fi
 
 echo "[AutoLibrary compile] 找到 $file_count 个 .ui 文件，开始编译..."
-echo
 
 for file in *.ui; do
     base_name=$(basename "$file" .ui)
@@ -20,11 +20,10 @@ for file in *.ui; do
     echo "[AutoLibrary compile] 正在编译: \"$file\" -> \"$output_file\""
 
     if pyside6-uic "$file" -o "$output_file"; then
-        echo "[AutoLibrary compile] 文件 \"$file\" ✓ 编译成功，输出文件: \"$output_file\""
+        echo "[AutoLibrary compile] 文件 \"$file\" 编译成功，输出文件: \"$output_file\""
     else
-        echo "[AutoLibrary compile] 文件 \"$file\" ✗ 编译失败"
+        echo "[AutoLibrary compile] 文件 \"$file\" 编译失败"
     fi
-    echo
 done
 
 echo "[AutoLibrary compile] 所有操作完成。"

batchs/readme.md

@@ -0,0 +1 @@
+This folder is used to store the batch scripts.

document/readme.md

@@ -1 +0,0 @@
-For more infomation, please visit our website: https://www.autolibrary.cv

driver/readme.md

@@ -1 +0,0 @@
-This folder is used to store the browser driver using by selenium.

drivers/readme.md

@@ -0,0 +1 @@
+This folder is used to store the browser drivers using by selenium.

license

@@ -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:
 

manuals/readme.md

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

model/readme.md

@@ -1 +0,0 @@
-This folder is used to store the model using by ddddocr.

models/readme.md

@@ -0,0 +1 @@
+This folder is used to store the models using by ddddocr.

readme.md

@@ -2,14 +2,16 @@
 # AutoLibrary
 ---
 
-![AutoLibrary Logo](./src/gui/icons/AutoLibrary_128x128.ico)
+![AutoLibrary Logo](./src/gui/resources/icons/AutoLibrary_128x128.ico)
 
-![License](https://img.shields.io/github/license/KenanZhu/AutoLibrary)
+[![GitHub stars](https://img.shields.io/github/stars/KenanZhu/AutoLibrary.svg?style=social&label=Star)](https://github.com/KenanZhu/AutoLibrary)
-![Issue](https://img.shields.io/github/issues/KenanZhu/AutoLibrary)
+![License](https://img.shields.io/github/license/KenanZhu/AutoLibrary?label=license)
-![Release](https://img.shields.io/github/v/release/KenanZhu/AutoLibrary)
+[![Build](https://img.shields.io/github/actions/workflow/status/KenanZhu/AutoLibrary/build-test.yml?label=build-test&logo=github-actions&logoColor=white)](https://github.com/KenanZhu/AutoLibrary/actions/workflows/build-test.yml)
-![Download](https://img.shields.io/github/downloads/KenanZhu/AutoLibrary/total)
+[![Release](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://autolibrary.cv)
+了解更多请访问 [_AutoLibrary 网站_](http://www.autolibrary.kenanzhu.com)
 
 ---
 
@@ -21,36 +23,18 @@
 4. 批量操作 - 支持同时预约多个用户，可以指定当前需要跳过的用户，并将用户分成多个组
 5. 定时任务 - 使用内置定时任务管理，添加定时任务，指定时间后按当前预约信息自动运行
 
-*1,2,3 的具体操作方法和注意事项请访问我们的 [帮助手册](https://autolibrary.cv/docs/manual_lists.html)*
+*1,2,3 的具体操作方法和注意事项请访问我们的 [帮助手册](https://www.autolibrary.kenanzhu.com/manuals)*
-
-### 特点
-
-#### 关于预约等操作的注意事项
-
-工具会自动处理登录过程的验证码识别过程，正常情况下单次识别准确率在 90% 以上，如遇验证码识别错误，大概率是校园网网络环境不佳导致的。
-
-只要确保处于校园网网络环境内，工具都是可以正常运行的。操作处理速度基本上取决于校园网的网络环境，一般情况下在 3-4 秒（不考虑硬件差异）左右即可完成一个用户的操作，完全满足正常使用需求。
-
-> [!NOTE]
-> 工具仅作为正常的预约，签到和续约的图书馆辅助工具，请勿干扰图书馆的正常运行（如故意预约多个座位，或同时预约大量的用户等，对此影响图书馆正常运行本工具概不负责，请在善用工具方便自己的情况下尽量不用影响其他同学的使用）。
-
-#### 关于批量操作的注意事项
-
-批量操作时，建议将需要操作的用户分成多个组，每个组的用户数量不要超过 4 人（即一整张桌子的数量），否则会影响操作效率，大量用户同时预约会一定程度上增加图书馆服务器的压力，影响正常使用。根据需要在用户管理界面中可以勾选本次操作是否跳过该用户，以提高运行效率。
-
-#### 关于定时任务的注意事项
-
-定时任务会在指定的时间自动运行，运行时会根据当前预约信息进行操作。一般情况下不建议设置两个运行开始时间比较接近的定时任务，否则后一个任务会等待前一个任务完成后才会运行，按照队列的顺序执行。
 
 ### 如何使用
 
-1. 下载最新版本的 [AutoLibrary 压缩包](https://github.com/KenanZhu/AutoLibrary/releases)。
+1. 下载最新版本的 [AutoLibrary 压缩包](https://github.com/KenanZhu/AutoLibrary/releases/latest)。
 2. 解压下载的文件到任意目录。
-3. 下载对应浏览器的驱动文件，并在配置界面的运行配置选项卡对应位置选择你下载好的浏览器驱动
+3. 下载对应浏览器类型和版本（具体操作请参考适用软件版本的 [帮助手册](https://www.autolibrary.kenanzhu.com/manuals)）的驱动文件，并在配置界面的运行配置选项卡对应位置选择你下载好的浏览器驱动。
-4. 运行 `AutoLibrary.exe` 文件。
+4. 运行 `AutoLibrary-[主版本号].[次版本号].[修订版本号].Z.exe` 文件 （如 `AutoLibrary-1.0.0.exe`）。
-5. 按照提示操作即可。
+5. 点击 [配置] 按钮，在配置界面填写好预约信息和运行配置后，点击 [确认] 按钮。
+6. 点击 [启动脚本] 按钮，即可开始自动预约、续约、签到等操作。
 
-*注意 1*: 关于浏览器驱动的下载和其它相关问题，请参考我们的 [帮助手册](https://autolibrary.cv/docs/manual_lists.html) 中对应软件版本的内容。
+*注意 1*: 关于浏览器驱动的下载和其它相关问题，请参考我们的 [帮助手册](https://www.autolibrary.kenanzhu.com/manuals) 中对应软件版本的内容。
 
 #### 平台支持 & 编译步骤
 
@@ -58,7 +42,7 @@
 
 1. 确保系统安装了 Python 3.13 版本 （推荐，过低或高版本会导致兼容问题）。
 2. 安装 pyside6 selenium ddddocr 库，命令为 `pip install pyside6 selenium ddddocr`。
-3. 在 `src/gui/batchs` 目录下运行 `compile_ui.bat` （linux 和 macOS 系统使用 `compile_ui.sh`） 文件来编译 Qt 的 UI 文件。
+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` 文件即可。
 
@@ -77,6 +61,25 @@ def classification(self, img: bytes):
 
 [1](@ref)：[pillow 中已经删除或已经弃用的常量](https://pillow.ac.cn/en/stable/deprecations.html#constants)
 
+### 注意事项
+
+#### 关于预约等操作
+
+工具会自动处理登录过程的验证码识别过程，正常情况下单次识别准确率在 90% 以上，如遇验证码识别错误，大概率是校园网网络环境不佳导致的。
+
+只要确保处于校园网网络环境内，工具都是可以正常运行的。操作处理速度基本上取决于校园网的网络环境，一般情况下在 3-4 秒（不考虑硬件差异）左右即可完成一个用户的操作，完全满足正常使用需求。
+
+> [!NOTE]
+> 工具仅作为正常的预约，签到和续约的图书馆辅助工具，请勿干扰图书馆的正常运行（如故意预约多个座位，或同时预约大量的用户等，对此影响图书馆正常运行本工具概不负责，请在善用工具方便自己的情况下尽量不用影响其他同学的使用）。
+
+#### 关于批量操作
+
+批量操作时，建议将需要操作的用户分成多个组，每个组的用户数量不要超过 4 人（即一整张桌子的数量），否则会影响操作效率，大量用户同时预约会一定程度上增加图书馆服务器的压力，影响正常使用。根据需要在用户管理界面中可以勾选本次操作是否跳过该用户，以提高运行效率。
+
+#### 关于定时任务
+
+定时任务会在指定的时间自动运行，运行时会根据当前预约信息进行操作。一般情况下不建议设置两个运行开始时间比较接近的定时任务，否则后一个任务会等待前一个任务完成后才会运行，按照队列的顺序执行。
+
 ### Q&A
 
 #### 为什么开发这个工具？
@@ -97,11 +100,11 @@ def classification(self, img: bytes):
 
 #### 后续会有哪些功能？
 
-当前 v1.0.0 版本的功能对于正常使用已经足够，不过后续会着重考虑完善 2-4 人预约时的使用体验，暂时有以下构想：
+当前版本的功能对于正常使用已经足够，不过后续会着重完善预约时的使用体验，暂时有以下构想：
 
-1. 2-4 人一起预约时，往往会偏向于预约并排或对面的整个空座位，这时候工具会按照一定策略查询搜索符合条件的座位，并预约并排或对面的整个座位，而不是各自独立预约。
+- 引入交互预约面板功能，预约时直接在座位分布图中选择可用座位，并按用户分配，无需事先配置预约信息。
-2. 预约时会考虑到组内用户的预约时间是否冲突，若冲突则会提示用户是否继续预约，若用户选择继续预约，则会按需要调整预约时间，再进行预约。
+- ~~优化定时任务管理功能，用户可以在定时任务管理界面设置重复运行的定时任务，如每日预约、每周预约等。~~ (已完成)
-3. 对于比较固定的用户，会考虑在定时任务管理中添加如 ‘每日任务’ ‘每周任务’ 等选项，用户可以根据需要设置定时任务重复的日期范围，自动完成预约，签到，续约等操作。
+- 软件的自动更新以及公告栏功能，用户可以自动更新最新版本并获取最新公告事项。
 
 不过由于本人的时间和能力有限，也需要考虑到图书馆的正常运行，所以后续功能会有所取舍，但也许会进行一些小的功能验证。
 

src/Main.py

@@ -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_())

src/base/LibOperator.py

@@ -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,

src/base/LibTimeSelector.py

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

src/base/MsgBase.py

@@ -1,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,
@@ -37,7 +53,7 @@ class MsgBase:
         msg: str
     ):
 
-        timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
+        timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S.%f")[:-3]
         self._output_queue.put(f"{timestamp}-[{self._class_name:<15}] : {msg}")
 
 
@@ -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

src/gui/ALAboutDialog.py

@@ -1,17 +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 sys
 import platform
 
 from PySide6.QtGui import (
-    QIcon
+    QIcon, QFont
 )
 from PySide6.QtWidgets import (
     QDialog, QApplication
@@ -23,9 +22,8 @@ from PySide6.QtCore import (
 from gui.ALVersionInfo import (
     AL_VERSION, AL_COMMIT_SHA, AL_COMMIT_DATE, AL_BUILD_DATE
 )
-from gui.Ui_ALAboutDialog import Ui_ALAboutDialog
+from gui.resources.ui.Ui_ALAboutDialog import Ui_ALAboutDialog
-
+from gui.resources import ALResource
-from gui import AutoLibraryResource
 
 
 class ALAboutDialog(QDialog, Ui_ALAboutDialog):
@@ -47,8 +45,11 @@ class ALAboutDialog(QDialog, Ui_ALAboutDialog):
 
         self.LogoIconLabel.setPixmap(QIcon(":/res/icon/icons/AutoLibrary_32x32.ico").pixmap(48, 48))
         info_text = self.generateAboutText()
-        self.AboutInfoEdit.setHtml(info_text)
+        self.AboutInfoBrowser.setHtml(info_text)
-        self.AboutInfoEdit.setTextInteractionFlags(Qt.TextBrowserInteraction)
+        browser_font = self.AboutInfoBrowser.font()
+        browser_font.setFamily("Courier New")
+        self.AboutInfoBrowser.setFont(browser_font)
+        self.AboutInfoBrowser.setTextInteractionFlags(Qt.TextBrowserInteraction)
 
 
     def connectSignals(
@@ -60,7 +61,7 @@ class ALAboutDialog(QDialog, Ui_ALAboutDialog):
 
     def generateAboutText(
         self
-    ):
+    ) -> str:
 
         os_info = self.getOSInfo()
         about_text = f"""
@@ -81,7 +82,7 @@ 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.cv/" style="text-decoration: none;">https://www.autolibrary.cv/</a><br>
+Project website: <a href="https://www.autolibrary.kenanzhu.com" style="text-decoration: none;">https://www.autolibrary.kenanzhu.com</a><br>
 
 <h4>Author Information:</h4>
 Developer: KenanZhu<br>
@@ -138,7 +139,7 @@ GitHub: <a href="https://www.github.com/KenanZhu" style="text-decoration: none;"
         self
     ):
 
-        about_text = self.AboutInfoEdit.toPlainText()
+        about_text = self.AboutInfoBrowser.toPlainText()
         clipboard = QApplication.clipboard()
         clipboard.setText(about_text)
         original_text = self.CopyButton.text()

src/gui/ALAddTimerTaskDialog.ui

@@ -1,249 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<ui version="4.0">
- <class>ALAddTimerTaskDialog</class>
- <widget class="QDialog" name="ALAddTimerTaskDialog">
-  <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>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="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>5</number>
-      </property>
-      <property name="topMargin">
-       <number>5</number>
-      </property>
-      <property name="rightMargin">
-       <number>5</number>
-      </property>
-      <property name="bottomMargin">
-       <number>5</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>

src/gui/ALConfigWidget.py

@@ -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.
@@ -14,48 +14,42 @@ from PySide6.QtCore import (
     Qt, Signal, Slot, QTime, QDate, QDir, QFileInfo
 )
 from PySide6.QtWidgets import (
-    QWidget, QLineEdit, QMessageBox, QFileDialog,
+    QDialog, QWidget, QLineEdit, QMessageBox, QFileDialog,
     QTreeWidgetItem, QMenu, QInputDialog
 )
 from PySide6.QtGui import (
      QCloseEvent, QAction
 )
 
-from gui.Ui_ALConfigWidget import Ui_ALConfigWidget
+import utils.ConfigManager as ConfigManager
-from gui.ALSeatMapWidget import ALSeatMapWidget
-from gui.ALSeatMapTable import seats_maps
-from gui.ALUserTreeWidget import TreeItemType
-from gui.ALUserTreeWidget import ALUserTreeWidget
 
-from utils.ConfigReader import ConfigReader
+from utils.JSONReader import JSONReader
-from utils.ConfigWriter import ConfigWriter
+from utils.JSONWriter import JSONWriter
+
+from gui.resources.ui.Ui_ALConfigWidget import Ui_ALConfigWidget
+from gui.ALSeatMapSelectDialog import ALSeatMapSelectDialog
+from gui.ALSeatMapTable import ALSeatMapTable
+from gui.ALUserTreeWidget import ALUserTreeWidget, ALUserTreeItemType
 
 
 class ALConfigWidget(QWidget, Ui_ALConfigWidget):
 
-    configWidgetCloseSingal = Signal(dict)
+    configWidgetIsClosed = Signal()
 
     def __init__(
         self,
         parent = None,
-        config_paths = {
-            "run": "",
-            "user": ""
-        }
     ):
 
         super().__init__(parent)
+        self.__cfg_mgr = ConfigManager.instance()
+        self.__config_paths = ConfigManager.getValidateAutomationConfigPaths()
+        self.__config_data = {"run": {}, "user": {}}
 
         self.setupUi(self)
-        self.__config_paths = config_paths
-        self.__config_data = {"run": {}, "user": {}}
-        self.__seat_map_widget = None
-
         self.modifyUi()
         self.connectSignals()
-        self.initlizeFloorRoomMap()
+        if not self.initializeConfigs():
-        self.initlizeDefaultConfigPaths()
-        if not self.initlizeConfigs():
             self.close()
 
 
@@ -71,8 +65,8 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         self.UserListLayout.insertWidget(0, self.UserTreeWidget)
         self.UserTreeWidget.setContextMenuPolicy(Qt.ContextMenuPolicy.CustomContextMenu)
         self.UserTreeWidget.customContextMenuRequested.connect(self.onUserTreeWidgetContextMenu)
-        self.initlizeFloorRoomMap()
+        self.initializeFloorRoomMap()
-        self.initilizeUserInfoWidget()
+        self.initializeUserInfoWidget()
 
 
     def connectSignals(
@@ -127,11 +121,11 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         event: QCloseEvent
     ):
 
-        self.configWidgetCloseSingal.emit(self.__config_paths)
+        self.configWidgetIsClosed.emit()
         super().closeEvent(event)
 
 
-    def initlizeFloorRoomMap(
+    def initializeFloorRoomMap(
         self
     ):
 
@@ -143,12 +137,12 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         }
         self.__room_map = {
             "1": "二层内环",
-            "2": "二层外环",
+            "2": "二层西区",
             "3": "三层内环",
             "4": "三层外环",
             "5": "四层内环",
             "6": "四层外环",
-            "7": "四层期刊区",
+            "7": "四层期刊",
             "8": "五层考研"
         }
         self.__floor_rmap = {
@@ -158,26 +152,14 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             v: k for k, v in self.__room_map.items()
         }
         self.__floor_room_map = {
-            "二层": ["二层内环", "二层外环"],
+            "二层": ["二层内环", "二层西区"],
             "三层": ["三层内环", "三层外环"],
-            "四层": ["四层内环", "四层外环", "四层期刊区"],
+            "四层": ["四层内环", "四层外环", "四层期刊"],
             "五层": ["五层考研"]
         }
 
 
-    def initlizeDefaultConfigPaths(
+    def initializeConfigToWidget(
-        self
-    ):
-
-        script_path = sys.executable
-        script_dir = QFileInfo(script_path).absoluteDir()
-        self.__default_config_paths = {
-            "user": QDir.toNativeSeparators(script_dir.absoluteFilePath("user.json")),
-            "run": QDir.toNativeSeparators(script_dir.absoluteFilePath("run.json"))
-        }
-
-
-    def initlizeConfigToWidget(
         self,
         which: str,
         config_data: dict
@@ -187,23 +169,22 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             self.setRunConfigToWidget(config_data)
             self.CurrentRunConfigEdit.setText(self.__config_paths["run"])
         elif which == "user":
-            self.initilizeUserInfoWidget()
+            self.initializeUserInfoWidget()
-            self.fillUserTree(config_data)
+            self.setUsersToTreeWidget(config_data)
             self.CurrentUserConfigEdit.setText(self.__config_paths["user"])
 
 
-    def initlizeConfig(
+    def initializeConfig(
         self,
         which: str
     ) -> bool:
 
-        msg = ""
+        msg = "" # no use for now
         is_success = True
         if which == "run":
             run_config_path = self.__config_paths[which]
             if not os.path.exists(run_config_path):
                 self.__config_data[which] = self.defaultRunConfig()
-                self.__config_paths[which] = self.__default_config_paths[which]
                 if self.saveRunConfig(self.__config_paths[which], self.__config_data[which]):
                     msg += f"运行配置文件已初始化, 文件路径: \n{self.__config_paths[which]}\n"
                 else:
@@ -216,7 +197,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             user_config_path = self.__config_paths[which]
             if not os.path.exists(user_config_path):
                 self.__config_data[which] = self.defaultUserConfig()
-                self.__config_paths[which] = self.__default_config_paths[which]
                 if self.saveUserConfig(self.__config_paths[which], self.__config_data[which]):
                     msg += f"用户配置文件已初始化, 文件路径: \n{self.__config_paths[which]}\n"
                 else:
@@ -225,27 +205,19 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                 self.__config_data[which] = self.loadUserConfig(user_config_path)
                 if self.__config_data[which] is None:
                     is_success = False
-        if msg:
-            QMessageBox.information(
-                self,
-                "提示 - AutoLibrary",
-                f"配置文件初始化完成: \n{msg}"
-            )
         return is_success
 
 
-    def initlizeConfigs(
+    def initializeConfigs(
         self
     ) -> bool:
 
         is_success = True
         for which in ["run", "user"]:
-            if not self.__config_paths[which]:
+            if not self.initializeConfig(which):
-                self.__config_paths[which] = self.__default_config_paths[which]
-            if not self.initlizeConfig(which):
                 is_success = False
                 break
-            self.initlizeConfigToWidget(which, self.__config_data[which])
+            self.initializeConfigToWidget(which, self.__config_data[which])
         return is_success
 
 
@@ -278,27 +250,8 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
     ) -> dict:
 
         return {
-            "groups": []
+            "groups": [
-        }
+            ]
-
-
-    def defaultGroup(
-        self
-    ) -> dict:
-
-        return {
-            "name": "默认分组",
-            "enabled": True,
-            "users": []
-        }
-
-
-    def defaultUsers(
-        self
-    ) -> dict:
-
-        return {
-            "users": []
         }
 
 
@@ -329,24 +282,41 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         run_config: dict
     ):
 
-        self.HostUrlEdit.setText(run_config["library"]["host_url"])
+        try:
-        self.LoginUrlEdit.setText(run_config["library"]["login_url"])
+            self.HostUrlEdit.setText(run_config["library"]["host_url"])
-        self.AutoCaptchaCheckBox.setChecked(run_config["login"]["auto_captcha"])
+            self.LoginUrlEdit.setText(run_config["library"]["login_url"])
-        self.LoginAttemptSpinBox.setValue(run_config["login"]["max_attempt"])
+            self.AutoCaptchaCheckBox.setChecked(run_config["login"]["auto_captcha"])
-        self.BrowserTypeComboBox.setCurrentText(run_config["web_driver"]["driver_type"])
+            self.LoginAttemptSpinBox.setValue(run_config["login"]["max_attempt"])
-        if run_config["web_driver"]["driver_path"]:
+            self.BrowserTypeComboBox.setCurrentText(run_config["web_driver"]["driver_type"])
-            driver_path = os.path.abspath(run_config["web_driver"]["driver_path"])
+            if run_config["web_driver"]["driver_path"]:
-        else:
+                driver_path = os.path.abspath(run_config["web_driver"]["driver_path"])
-            driver_path = ""
+            else:
-        self.BrowseBrowserDriverEdit.setText(QDir.toNativeSeparators(driver_path))
+                driver_path = ""
-        self.HeadlessCheckBox.setChecked(run_config["web_driver"]["headless"])
+            self.BrowseBrowserDriverEdit.setText(QDir.toNativeSeparators(driver_path))
-        run_mode = run_config["mode"]["run_mode"]
+            self.HeadlessCheckBox.setChecked(run_config["web_driver"]["headless"])
-        self.AutoReserveCheckBox.setChecked(run_mode&0x01)
+            run_mode = run_config["mode"]["run_mode"]
-        self.AutoCheckinCheckBox.setChecked(run_mode&0x02)
+            self.AutoReserveCheckBox.setChecked(run_mode&0x01)
-        self.AutoRenewalCheckBox.setChecked(run_mode&0x04)
+            self.AutoCheckinCheckBox.setChecked(run_mode&0x02)
+            self.AutoRenewalCheckBox.setChecked(run_mode&0x04)
+        except KeyError as e:
+            QMessageBox.warning(
+                self,
+                "警告 - AutoLibrary",
+                f"运行配置文件读取键 '{e}' 时发生错误 ! :\n"
+                f"文件路径: {self.__config_paths['run']}\n"
+                "文件可能被意外修改或已经损坏\n"
+            )
+        except Exception as e:
+            QMessageBox.warning(
+                self,
+                "警告 - AutoLibrary",
+                f"运行配置文件读取键 '{e}' 时发生未知错误 ! :\n"
+                f"文件路径: {self.__config_paths['run']}\n"
+                "文件可能被意外修改或已经损坏\n"
+            )
 
 
-    def initilizeUserInfoWidget(
+    def initializeUserInfoWidget(
         self
     ):
 
@@ -371,7 +341,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         self.PreferLateRenewTimeCheckBox.setChecked(False)
 
 
-    def collectUserFromUserInfoWidget(
+    def collectUserFromWidget(
         self
     ) -> dict:
 
@@ -404,7 +374,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         return user
 
 
-    def collectUserConfigFromUserTreeWidget(
+    def collectUsersFromTreeWidget(
         self
     ) -> dict:
 
@@ -451,13 +421,64 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             self.ExpectRenewDurationSpinBox.setValue(user["reserve_info"]["renew_time"]["expect_duration"])
             self.MaxRenewTimeDiffSpinBox.setValue(user["reserve_info"]["renew_time"]["max_diff"])
             self.PreferLateRenewTimeCheckBox.setChecked(not user["reserve_info"]["renew_time"]["prefer_early"])
-        except:
+        except KeyError as e:
             QMessageBox.warning(
                 self,
                 "警告 - AutoLibrary",
-                "用户配置文件读取发生错误 !\n"\
+                f"用户配置文件读取键 '{e}' 时发生错误 ! :\n"
-                f"用户: {user['username']} 配置文件可能已损坏"
+                f"文件路径: {self.__config_paths['user']}\n"
+                "文件可能被意外修改或已经损坏\n"
             )
+        except Exception as e:
+            QMessageBox.warning(
+                self,
+                "警告 - AutoLibrary",
+                f"用户配置文件读取键 '{e}' 时发生未知错误 ! :\n"
+                f"文件路径: {self.__config_paths['user']}\n"
+                "文件可能被意外修改或已经损坏\n"
+            )
+
+
+    def setUsersToTreeWidget(
+        self,
+        users: dict
+    ):
+
+        self.UserTreeWidget.clear()
+        self.UserTreeWidget.itemChanged.disconnect(self.onUserTreeWidgetItemChanged)
+        try:
+            if "groups" in users:
+                for group_config in users["groups"]:
+                    group_item = QTreeWidgetItem(self.UserTreeWidget, ALUserTreeItemType.GROUP.value)
+                    group_item.setText(0, group_config["name"])
+                    group_item.setFlags(group_item.flags() | Qt.ItemIsEditable)
+                    group_item.setCheckState(1, Qt.Checked if group_config.get("enabled", True) else Qt.Unchecked)
+                    for user_config in group_config["users"]:
+                        user_item = QTreeWidgetItem(group_item, ALUserTreeItemType.USER.value)
+                        user_item.setText(0, user_config["username"])
+                        user_item.setText(1, "" if user_config.get("enabled", True) else "跳过")
+                        user_item.setData(0, Qt.UserRole, user_config)
+                        user_item.setCheckState(1, Qt.Checked if user_config.get("enabled", True) else Qt.Unchecked)
+                        user_item.setDisabled(not group_config.get("enabled", True))
+                    group_item.setExpanded(True)
+        except KeyError as e:
+            QMessageBox.warning(
+                self,
+                "警告 - AutoLibrary",
+                f"用户配置文件读取键 '{e}' 时发生错误 ! :\n"
+                f"文件路径: {self.__config_paths['user']}\n"
+                "文件可能被意外修改或已经损坏\n"
+            )
+        except Exception as e:
+            QMessageBox.warning(
+                self,
+                "警告 - AutoLibrary",
+                f"用户配置文件读取键 '{e}' 时发生未知错误 ! :\n"
+                f"文件路径: {self.__config_paths['user']}\n"
+                "文件可能被意外修改或已经损坏\n"
+            )
+        finally:
+            self.UserTreeWidget.itemChanged.connect(self.onUserTreeWidgetItemChanged)
 
 
     def loadRunConfig(
@@ -468,18 +489,18 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         try:
             if not run_config_path or not os.path.exists(run_config_path):
                 raise Exception("文件路径不存在")
-            run_config = ConfigReader(run_config_path).getConfigs()
+            run_config = JSONReader(run_config_path).data()
             if run_config and "library" in run_config\
                 and "web_driver" in run_config\
                 and "login" in run_config:
                 return run_config
-            return None
+            else:
+                return None
         except Exception as e:
             QMessageBox.warning(
                 self,
                 "警告 - AutoLibrary",
-                f"运行配置文件读取发生错误 ! : {e}\n"\
+                f"运行配置文件读取发生错误 ! :\n{e}"
-                f"文件路径: {run_config_path}"
             )
             return None
 
@@ -495,14 +516,13 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                 raise Exception("文件路径为空")
             if not run_config_data or not isinstance(run_config_data, dict):
                 raise Exception("运行配置数据为空或类型错误")
-            ConfigWriter(run_config_path, run_config_data)
+            JSONWriter(run_config_path, run_config_data)
             return True
         except Exception as e:
             QMessageBox.warning(
                 self,
                 "警告 - AutoLibrary",
-                f"配置文件写入发生错误 ! : {e}\n"\
+                f"配置文件写入发生错误 ! : \n{e}"
-                f"文件路径: {run_config_path}"
             )
             return False
 
@@ -515,11 +535,11 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         try:
             if not user_config_path or not os.path.exists(user_config_path):
                 raise Exception("文件路径不存在")
-            user_config = ConfigReader(user_config_path).getConfigs()
+            user_config = JSONReader(user_config_path).data()
             if user_config and "groups" in user_config:
                 return user_config
             # compatibility with old version config format
-            if user_config and "users" in user_config:
+            elif user_config and "users" in user_config:
                 user_config = {
                     "groups": [
                         {
@@ -530,13 +550,13 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                     ]
                 }
                 return user_config
-            return None
+            else:
+                return None
         except Exception as e:
             QMessageBox.warning(
                 self,
                 "警告 - AutoLibrary",
-                f"用户配置文件读取发生错误 ! : {e}\n"\
+                f"用户配置文件读取发生错误 ! :\n{e}"
-                f"文件路径: {user_config_path}"
             )
             return None
 
@@ -552,14 +572,13 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                 raise Exception("文件路径为空")
             if not user_config_data or not isinstance(user_config_data, dict):
                 raise Exception("用户配置数据为空或类型错误")
-            ConfigWriter(user_config_path, user_config_data)
+            JSONWriter(user_config_path, user_config_data)
             return True
         except Exception as e:
             QMessageBox.warning(
                 self,
                 "警告 - AutoLibrary",
-                f"用户配置文件写入发生错误 ! : {e}\n"\
+                f"用户配置文件写入发生错误 ! :\n{e}"
-                f"文件路径: \n{user_config_path}"
             )
             return False
 
@@ -571,7 +590,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
     ) -> bool:
 
         if user_config_path:
-            self.__config_data["user"] = self.collectUserConfigFromUserTreeWidget()
+            self.__config_data["user"] = self.collectUsersFromTreeWidget()
             if not self.saveUserConfig(
                 user_config_path,
                 self.__config_data["user"]
@@ -610,45 +629,19 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                 return True
             if user_config is not None:
                 self.__config_data["user"].update(user_config)
-                self.fillUserTree(self.__config_data["user"])
+                self.setUsersToTreeWidget(self.__config_data["user"])
                 return True
         except:
             return False
 
 
-    def fillUserTree(
-        self,
-        user_config_data: dict
-    ):
-
-        self.UserTreeWidget.clear()
-        self.UserTreeWidget.itemChanged.disconnect(self.onUserTreeWidgetItemChanged)
-        try:
-            if "groups" in user_config_data:
-                for group_config in user_config_data["groups"]:
-                    group_item = QTreeWidgetItem(self.UserTreeWidget, TreeItemType.GROUP.value)
-                    group_item.setText(0, group_config["name"])
-                    group_item.setFlags(group_item.flags() | Qt.ItemIsEditable)
-                    group_item.setCheckState(1, Qt.Checked if group_config.get("enabled", True) else Qt.Unchecked)
-                    for user_config in group_config["users"]:
-                        user_item = QTreeWidgetItem(group_item, TreeItemType.USER.value)
-                        user_item.setText(0, user_config["username"])
-                        user_item.setText(1, "" if user_config.get("enabled", True) else "跳过")
-                        user_item.setData(0, Qt.UserRole, user_config)
-                        user_item.setCheckState(1, Qt.Checked if user_config.get("enabled", True) else Qt.Unchecked)
-                        user_item.setDisabled(not group_config.get("enabled", True))
-                    group_item.setExpanded(True)
-        finally:
-            self.UserTreeWidget.itemChanged.connect(self.onUserTreeWidgetItemChanged)
-
-
     def addGroup(
         self,
         group_name: str = ""
     ) -> QTreeWidgetItem:
 
         self.UserTreeWidget.itemChanged.disconnect(self.onUserTreeWidgetItemChanged)
-        group_item = QTreeWidgetItem(self.UserTreeWidget, TreeItemType.GROUP.value)
+        group_item = QTreeWidgetItem(self.UserTreeWidget, ALUserTreeItemType.GROUP.value)
         if not group_name:
             group_name = f"新分组-{self.UserTreeWidget.topLevelItemCount()}"
         group_item.setText(0, group_name)
@@ -659,6 +652,19 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         return group_item
 
 
+    def delGroup(
+        self,
+        group_item: QTreeWidgetItem = None
+    ):
+
+        if group_item is None:
+            return
+        if group_item.type() != ALUserTreeItemType.GROUP.value:
+            return
+        index = self.UserTreeWidget.indexOfTopLevelItem(group_item)
+        self.UserTreeWidget.takeTopLevelItem(index)
+
+
     def addUser(
         self,
         group_item: QTreeWidgetItem = None
@@ -668,7 +674,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             current_item = self.UserTreeWidget.currentItem()
             if current_item is None:
                 group_item = self.addGroup()
-        if group_item.type() == TreeItemType.USER.value:
+        if group_item.type() == ALUserTreeItemType.USER.value:
             group_item = group_item.parent()
         if group_item.checkState(1) == Qt.CheckState.Unchecked:
             return None
@@ -702,7 +708,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             }
         }
         self.UserTreeWidget.itemChanged.disconnect(self.onUserTreeWidgetItemChanged)
-        user_item = QTreeWidgetItem(group_item, TreeItemType.USER.value)
+        user_item = QTreeWidgetItem(group_item, ALUserTreeItemType.USER.value)
         user_item.setText(0, new_user["username"])
         user_item.setText(1, "")
         user_item.setData(0, Qt.UserRole, new_user)
@@ -721,7 +727,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
 
         if user_item is None:
             return
-        if user_item.type() != TreeItemType.USER.value:
+        if user_item.type() != ALUserTreeItemType.USER.value:
             return
         parent_item = user_item.parent()
         index = parent_item.indexOfChild(user_item)
@@ -730,19 +736,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             self.UserTreeWidget.setCurrentItem(None)
 
 
-    def delGroup(
-        self,
-        group_item: QTreeWidgetItem = None
-    ):
-
-        if group_item is None:
-            return
-        if group_item.type() != TreeItemType.GROUP.value:
-            return
-        index = self.UserTreeWidget.indexOfTopLevelItem(group_item)
-        self.UserTreeWidget.takeTopLevelItem(index)
-
-
     def renameItem(
         self,
         item: QTreeWidgetItem,
@@ -762,7 +755,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         if not ok or not new_name:
             return
         item.setText(0, new_name)
-        if item.type() == TreeItemType.GROUP.value:
+        if item.type() == ALUserTreeItemType.GROUP.value:
             item.setText(0, new_name)
         else:
             user = item.data(0, Qt.UserRole)
@@ -771,7 +764,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             item.setData(0, Qt.UserRole, user)
             self.setUserToWidget(user)
 
-
     @Slot()
     def onShowPasswordCheckBoxChecked(
         self,
@@ -793,19 +785,6 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         self.RoomComboBox.addItems(self.__floor_room_map[floor])
         self.RoomComboBox.setCurrentIndex(0)
 
-    @Slot()
-    def onSeatMapWidgetClosed(
-        self,
-        selected_seats: list[str]
-    ):
-
-        self.__seat_map_widget.seatMapWidgetClosed.disconnect(self.onSeatMapWidgetClosed)
-        self.__seat_map_widget.deleteLater()
-        self.__seat_map_widget = None
-        if len(selected_seats) == 0:
-            return
-        self.SeatIDEdit.setText(",".join(selected_seats))
-
     @Slot()
     def onSelectSeatsButtonClicked(
         self
@@ -815,18 +794,19 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         room = self.RoomComboBox.currentText()
         floor_idx = self.__floor_rmap[floor]
         room_idx = self.__room_rmap[room]
-        if self.__seat_map_widget is None:
+        dialog = ALSeatMapSelectDialog(
-            self.__seat_map_widget = ALSeatMapWidget(
+            self,
-                self,
+            floor,
-                floor,
+            room,
-                room,
+            ALSeatMapTable[floor_idx][room_idx]
-                seats_maps[floor_idx][room_idx]
+        )
-            )
+        dialog.selectSeats(self.SeatIDEdit.text().split(","))
-            self.__seat_map_widget.seatMapWidgetClosed.connect(self.onSeatMapWidgetClosed)
+        if dialog.exec() == QDialog.DialogCode.Accepted:
-        self.__seat_map_widget.show()
+            selected_seats = dialog.getSelectedSeats()
-        self.__seat_map_widget.raise_()
+            if len(selected_seats) == 0:
-        self.__seat_map_widget.activateWindow()
+                self.SeatIDEdit.clear()
-        self.__seat_map_widget.selectSeats(self.SeatIDEdit.text().split(","))
+                return
+            self.SeatIDEdit.setText(",".join(dialog.getSelectedSeats()))
 
     @Slot()
     def onUserTreeWidgetCurrentItemChanged(
@@ -838,8 +818,8 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         # cant effectively update the data of each user, due to the
         # possiblity of frequency edit. we just let the QListWidget
         # help us.
-        if previous and previous.type() == TreeItemType.USER.value:
+        if previous and previous.type() == ALUserTreeItemType.USER.value:
-            user = self.collectUserFromUserInfoWidget()
+            user = self.collectUserFromWidget()
             if user:
                 self.UsernameEdit.textEdited.disconnect()
                 user["enabled"] = previous.checkState(1) == Qt.Checked
@@ -847,15 +827,15 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
                 previous.setText(1, "" if user.get("enabled", True) else "跳过")
                 previous.setData(0, Qt.UserRole, user)
         if current is None:
-            self.initilizeUserInfoWidget()
+            self.initializeUserInfoWidget()
             return
-        if current.type() == TreeItemType.USER.value:
+        if current.type() == ALUserTreeItemType.USER.value:
             user = current.data(0, Qt.UserRole)
             if user:
                 self.setUserToWidget(user)
                 self.UsernameEdit.textEdited.connect(lambda text: current.setText(0, text))
         else:
-            self.initilizeUserInfoWidget()
+            self.initializeUserInfoWidget()
 
     @Slot()
     def onUserTreeWidgetItemChanged(
@@ -868,7 +848,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             return
         if column != 1:
             return
-        if item.type() == TreeItemType.GROUP.value:
+        if item.type() == ALUserTreeItemType.GROUP.value:
             is_checked = item.checkState(1) == Qt.CheckState.Checked
             for i in range(item.childCount()):
                 child = item.child(i)
@@ -933,7 +913,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         menu = QMenu(self.UserTreeWidget)
         if current_item is None:
             self.showTreeMenu(menu)
-        elif current_item.type() == TreeItemType.GROUP.value:
+        elif current_item.type() == ALUserTreeItemType.GROUP.value:
             self.showGroupMenu(menu, current_item)
         else:
             self.showUserMenu(menu, current_item)
@@ -982,9 +962,27 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         )[0]
         if run_config_path:
             run_config_path = QDir.toNativeSeparators(run_config_path)
-            if self.loadConfig(run_config_path):
+            data = self.loadRunConfig(run_config_path)
+            if data is not None:
+                self.__config_data["run"].update(data)
+                self.setRunConfigToWidget(data)
                 self.__config_paths["run"] = run_config_path
                 self.CurrentRunConfigEdit.setText(run_config_path)
+                paths = self.__cfg_mgr.get(ConfigManager.ConfigType.GLOBAL, "automation.run_path.paths", [])
+                if run_config_path not in paths:
+                    paths.append(run_config_path)
+                    index = len(paths) - 1
+                else:
+                    index = paths.index(run_config_path)
+                self.__cfg_mgr.set(ConfigManager.ConfigType.GLOBAL, "automation.run_path", {"current": index, "paths": paths})
+            else:
+                QMessageBox.warning(
+                    self,
+                    "警告 - AutoLibrary",
+                    "运行配置文件读取发生错误 ! :\n"\
+                    "无法从选择的运行配置文件中加载数据 ! :\n"\
+                    "可能选择了错误的配置文件类型"
+                )
 
     @Slot()
     def onBrowseCurrentUserConfigButtonClicked(
@@ -999,9 +997,27 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         )[0]
         if user_config_path:
             user_config_path = QDir.toNativeSeparators(user_config_path)
-            if self.loadConfig(user_config_path):
+            data = self.loadUserConfig(user_config_path)
+            if data is not None:
+                self.__config_data["user"].update(data)
+                self.setUsersToTreeWidget(data)
                 self.__config_paths["user"] = user_config_path
                 self.CurrentUserConfigEdit.setText(user_config_path)
+                paths = self.__cfg_mgr.get(ConfigManager.ConfigType.GLOBAL, "automation.user_path.paths", [])
+                if user_config_path not in paths:
+                    paths.append(user_config_path)
+                    index = len(paths) - 1
+                else:
+                    index = paths.index(user_config_path)
+                self.__cfg_mgr.set(ConfigManager.ConfigType.GLOBAL, "automation.user_path", {"current": index, "paths": paths})
+            else:
+                QMessageBox.warning(
+                    self,
+                    "警告 - AutoLibrary",
+                    "用户配置文件读取发生错误 ! :\n"\
+                    "无法从选择的用户配置文件中加载数据 ! :\n"\
+                    "可能选择了错误的配置文件类型"
+                )
 
     @Slot()
     def onBrowseExportRunConfigButtonClicked(
@@ -1088,9 +1104,9 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
         if run_exists or user_exists:
             exist_files = []
             if run_exists:
-                exist_files.append(run_config_path)
+                exist_files.append(f"运行配置文件: \n{run_config_path}")
             if user_exists:
-                exist_files.append(user_config_path)
+                exist_files.append(f"用户配置文件: \n{user_config_path}")
             reply = QMessageBox.information(
                 self,
                 "提示 - AutoLibrary",
@@ -1106,8 +1122,8 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             "run": run_config_path,
             "user": user_config_path
         }
-        self.initlizeConfigToWidget("run", self.__config_data["run"])
+        self.initializeConfigToWidget("run", self.__config_data["run"])
-        self.initlizeConfigToWidget("user", self.__config_data["user"])
+        self.initializeConfigToWidget("user", self.__config_data["user"])
 
     @Slot()
     def onConfirmButtonClicked(
@@ -1115,7 +1131,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
     ):
 
         current_item = self.UserTreeWidget.currentItem()
-        if current_item and current_item.type() == TreeItemType.USER.value:
+        if current_item and current_item.type() == ALUserTreeItemType.USER.value:
             self.UserTreeWidget.setCurrentItem(None)
         if self.saveConfigs(
             self.__config_paths["run"],
@@ -1124,7 +1140,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             QMessageBox.information(
                 self,
                 "提示 - AutoLibrary",
-                "配置文件保存成功 !\n"
+                "配置文件保存成功 ! :\n"
                 f"运行配置文件路径: \n{self.__config_paths['run']}\n"\
                 f"用户配置文件路径: \n{self.__config_paths['user']}"
             )
@@ -1132,7 +1148,7 @@ class ALConfigWidget(QWidget, Ui_ALConfigWidget):
             QMessageBox.warning(
                 self,
                 "警告 - AutoLibrary",
-                "配置文件保存失败, 请检查文件路径权限"
+                "配置文件保存失败 !\n"
             )
         self.close()
 

src/gui/ALMainWindow.py

@@ -1,41 +1,39 @@
 # -*- 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
-import time
 import queue
 
 from PySide6.QtCore import (
-    Qt, Signal, Slot, QDir, QFileInfo, QTimer, QUrl,
+    Qt, Signal, Slot, QTimer, QUrl,
 )
 from PySide6.QtWidgets import (
-    QMainWindow, QMenu, QSystemTrayIcon
+    QMainWindow, QMenu, QSystemTrayIcon, QMessageBox
 )
 from PySide6.QtGui import (
     QTextCursor, QCloseEvent, QFont, QIcon, QDesktopServices
 )
 
-from gui.Ui_ALMainWindow import Ui_ALMainWindow
+import utils.ConfigManager as ConfigManager
+
+from base.MsgBase import MsgBase
+
+from gui.resources.ui.Ui_ALMainWindow import Ui_ALMainWindow
+from gui.resources import ALResource
 from gui.ALConfigWidget import ALConfigWidget
-from gui.ALTimerTaskWidget import ALTimerTaskWidget
+from gui.ALTimerTaskManageWidget import ALTimerTaskManageWidget
 from gui.ALAboutDialog import ALAboutDialog
 from gui.ALMainWorkers import TimerTaskWorker, AutoLibWorker
 
-from gui import AutoLibraryResource
 
-from utils.ConfigReader import ConfigReader
+class ALMainWindow(MsgBase, QMainWindow, Ui_ALMainWindow):
-from utils.ConfigWriter import ConfigWriter
-
-
-class ALMainWindow(QMainWindow, Ui_ALMainWindow):
 
+    # signal : timer task
     timerTaskIsRunning = Signal(dict)
     timerTaskIsExecuted = Signal(dict)
     timerTaskIsError = Signal(dict)
@@ -44,26 +42,18 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
         self
     ):
 
-        super().__init__()
+        MsgBase.__init__(self, queue.Queue(), queue.Queue())
-        self.__class_name = self.__class__.__name__
+        QMainWindow.__init__(self)
-
+        self.__cfg_mgr = ConfigManager.instance()
-        self.setupUi(self)
-        self.__input_queue = queue.Queue()
-        self.__output_queue = queue.Queue()
         self.__timer_task_queue = queue.Queue()
-        script_path = sys.executable
+        self.__config_paths = ConfigManager.getValidateAutomationConfigPaths()
-        script_dir = QFileInfo(script_path).absoluteDir()
+        self.__alTimerTaskManageWidget = None
-        self.__config_paths = {
-            "run":   QDir.toNativeSeparators(script_dir.absoluteFilePath("run.json")),
-            "user": QDir.toNativeSeparators(script_dir.absoluteFilePath("user.json")),
-            "timer_task": QDir.toNativeSeparators(script_dir.absoluteFilePath("timer_task.json")),
-        }
-        self.__alTimerTaskWidget = 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()
@@ -82,13 +72,24 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
         self.AboutAction.triggered.connect(self.onAboutActionTriggered)
 
         # initialize timer task widget, but not show it
-        self.__alTimerTaskWidget = ALTimerTaskWidget(self, self.__config_paths["timer_task"])
+        try:
-        self.timerTaskIsRunning.connect(self.__alTimerTaskWidget.onTimerTaskIsRunning)
+            self.__alTimerTaskManageWidget = ALTimerTaskManageWidget(self)
-        self.timerTaskIsExecuted.connect(self.__alTimerTaskWidget.onTimerTaskIsExecuted)
+        except Exception as e:
-        self.timerTaskIsError.connect(self.__alTimerTaskWidget.onTimerTaskIsError)
+            QMessageBox.critical(
-        self.__alTimerTaskWidget.timerTaskIsReady.connect(self.onTimerTaskIsReady)
+                self,
-        self.__alTimerTaskWidget.timerTaskWidgetClosed.connect(self.onTimerTaskWidgetClosed)
+                "错误 - AutoLibrary",
-        self.__alTimerTaskWidget.setWindowFlags(Qt.WindowType.Window|Qt.WindowType.WindowCloseButtonHint)
+                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(
@@ -103,7 +104,7 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
         self
     ):
 
-        url = QUrl("https://www.autolibrary.cv/docs/manual_lists.html")
+        url = QUrl("https://www.autolibrary.kenanzhu.com/manuals")
         QDesktopServices.openUrl(url)
 
 
@@ -112,22 +113,19 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
     ):
 
         if not QSystemTrayIcon.isSystemTrayAvailable():
-            self.showTraceSignal.emit(
+            self._showTrace("操作系统不支持系统托盘功能, 无法创建系统托盘图标")
-                "系统不支持系统托盘功能, 无法创建系统托盘图标。"
-            )
             return
         self.TrayIcon = QSystemTrayIcon(self.icon, self)
         self.TrayIcon.setToolTip("AutoLibrary")
 
         self.TrayMenu = QMenu()
         self.TrayMenu.addAction("显示主窗口", self.showNormal)
-        self.TrayMenu.addAction("显示定时窗口", self.onTimerTaskWidgetButtonClicked)
+        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()
 
@@ -159,7 +157,7 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
     ):
 
         self.ConfigButton.clicked.connect(self.onConfigButtonClicked)
-        self.TimerTaskWidgetButton.clicked.connect(self.onTimerTaskWidgetButtonClicked)
+        self.TimerTaskManageWidgetButton.clicked.connect(self.onTimerTaskManageWidgetButtonClicked)
         self.StartButton.clicked.connect(self.onStartButtonClicked)
         self.StopButton.clicked.connect(self.onStopButtonClicked)
         self.SendButton.clicked.connect(self.onSendButtonClicked)
@@ -171,6 +169,10 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
         event: QCloseEvent
     ):
 
+        if not self.isVisible():
+            self.showNormal()
+            event.ignore()
+            return
         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():
@@ -178,13 +180,13 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
         if self.__is_running_timer_task:
             self.__current_timer_task_thread.wait(2000)
             self.__current_timer_task_thread.deleteLater()
-        if self.__alTimerTaskWidget:
+        if self.__alTimerTaskManageWidget:
-            self.__alTimerTaskWidget.close()
+            self.__alTimerTaskManageWidget.close()
-            self.__alTimerTaskWidget.deleteLater()
+            self.__alTimerTaskManageWidget.deleteLater()
         if self.__alConfigWidget:
             self.__alConfigWidget.close()
             # the config widget is already deleted in the 'self.onConfigWidgetClosed'
-        super().closeEvent(event)
+        QMainWindow.closeEvent(self, event)
 
 
     def appendToTextEdit(
@@ -231,7 +233,7 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
                 self.timerTaskIsRunning.emit(timer_task)
                 self.__timer_task_timer.stop()
                 self.__is_running_timer_task = True
-                self.setControlButtons(True, True, False)
+                self.setControlButtons(None, True, False)
                 if not timer_task["silent"]:
                     self.TrayIcon.showMessage(
                         "定时任务 - AutoLibrary",
@@ -242,11 +244,11 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
                     self.showNormal()
                 self.__current_timer_task_thread = TimerTaskWorker(
                     timer_task,
-                    self.__input_queue,
+                    self._input_queue,
-                    self.__output_queue,
+                    self._output_queue,
                     self.__config_paths
                 )
-                self.__current_timer_task_thread.finishedSignal_TimerWorker.connect(self.onTimerTaskFinished)
+                self.__current_timer_task_thread.timerTaskWorkerIsFinished.connect(self.onTimerTaskFinished)
                 self.__current_timer_task_thread.start()
         except queue.Empty:
             self.__is_running_timer_task = False
@@ -268,23 +270,6 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
         if start_button_enabled is not None:
             self.StartButton.setEnabled(start_button_enabled)
 
-    @Slot()
-    def showMsg(
-        self,
-        msg: str
-    ):
-
-        self.__output_queue.put(f"[{self.__class_name:<15}] >>> : {msg}")
-
-    @Slot()
-    def showTrace(
-        self,
-        msg: str
-    ):
-
-        timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
-        self.__output_queue.put(f"{timestamp}-[{self.__class_name:<15}] : {msg}")
-
     @Slot()
     def pollMsgQueue(
         self
@@ -292,30 +277,28 @@ 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 onTimerTaskWidgetClosed(
+    def onTimerTaskManageWidgetClosed(
         self
     ):
 
-        self.TimerTaskWidgetButton.setEnabled(True)
+        self.TimerTaskManageWidgetButton.setEnabled(True)
 
     @Slot(dict)
     def onConfigWidgetClosed(
-        self,
+        self
-        config_paths: dict
     ):
 
         if self.__alConfigWidget:
-            self.__alConfigWidget.configWidgetCloseSingal.disconnect(self.onConfigWidgetClosed)
+            self.__alConfigWidget.configWidgetIsClosed.disconnect(self.onConfigWidgetClosed)
             self.__alConfigWidget.deleteLater()
             self.__alConfigWidget = None
         self.setControlButtons(True, None, None)
-        self.__config_paths = config_paths
 
     @Slot(dict)
     def onTimerTaskIsReady(
@@ -333,7 +316,7 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
     ):
 
         self.__current_timer_task_thread.wait(1000)
-        self.__current_timer_task_thread.finishedSignal_TimerWorker.disconnect(self.onTimerTaskFinished)
+        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)
@@ -343,10 +326,10 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
         self.TrayIcon.showMessage(
             "定时任务 - AutoLibrary",
             f"\n定时任务 '{timer_task['name']}' 执行{'失败' if is_error else '完成'}",
-            QSystemTrayIcon.MessageIcon.Information,
+            QSystemTrayIcon.MessageIcon.Warning if is_error else QSystemTrayIcon.MessageIcon.Information,
             1000
         )
-        self.showTrace(
+        self._showTrace(
             f"定时任务 {timer_task['name']} 执行{'失败' if is_error else '完成'}, uuid: {timer_task['task_uuid']}"
         )
         if not is_error:
@@ -355,14 +338,14 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
             self.timerTaskIsError.emit(timer_task)
 
     @Slot()
-    def onTimerTaskWidgetButtonClicked(
+    def onTimerTaskManageWidgetButtonClicked(
         self
     ):
 
-        self.__alTimerTaskWidget.show()
+        self.__alTimerTaskManageWidget.show()
-        self.__alTimerTaskWidget.raise_()
+        self.__alTimerTaskManageWidget.raise_()
-        self.__alTimerTaskWidget.activateWindow()
+        self.__alTimerTaskManageWidget.activateWindow()
-        self.TimerTaskWidgetButton.setEnabled(False)
+        self.TimerTaskManageWidgetButton.setEnabled(False)
 
     @Slot()
     def onConfigButtonClicked(
@@ -370,11 +353,8 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
     ):
 
         if self.__alConfigWidget is None:
-            self.__alConfigWidget = ALConfigWidget(
+            self.__alConfigWidget = ALConfigWidget(self)
-                self,
+            self.__alConfigWidget.configWidgetIsClosed.connect(self.onConfigWidgetClosed)
-                self.__config_paths
-            )
-            self.__alConfigWidget.configWidgetCloseSingal.connect(self.onConfigWidgetClosed)
         self.__alConfigWidget.show()
         self.__alConfigWidget.raise_()
         self.__alConfigWidget.activateWindow()
@@ -388,12 +368,12 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
         self.setControlButtons(None, True, False)
         if self.__auto_lib_thread is None:
             self.__auto_lib_thread = AutoLibWorker(
-                self.__input_queue,
+                self._input_queue,
-                self.__output_queue,
+                self._output_queue,
                 self.__config_paths
             )
-            self.__auto_lib_thread.finishedSignal.connect(self.onStopButtonClicked)
+            self.__auto_lib_thread.autoLibWorkerIsFinished.connect(self.onStopButtonClicked)
-            self.__auto_lib_thread.finishedWithErrorSignal.connect(self.onStopButtonClicked)
+            self.__auto_lib_thread.autoLibWorkerFinishedWithError.connect(self.onStopButtonClicked)
         self.__auto_lib_thread.start()
 
     @Slot()
@@ -402,11 +382,11 @@ class ALMainWindow(QMainWindow, Ui_ALMainWindow):
     ):
 
         if self.__auto_lib_thread:
-            self.showTrace("正在停止操作......")
+            self._showTrace("正在停止操作......")
             self.__auto_lib_thread.wait(2000)
-            self.showTrace("操作已停止")
+            self._showTrace("操作已停止")
-            self.__auto_lib_thread.finishedSignal.disconnect(self.onStopButtonClicked)
+            self.__auto_lib_thread.autoLibWorkerIsFinished.disconnect(self.onStopButtonClicked)
-            self.__auto_lib_thread.finishedWithErrorSignal.disconnect(self.onStopButtonClicked)
+            self.__auto_lib_thread.autoLibWorkerFinishedWithError.disconnect(self.onStopButtonClicked)
             self.__auto_lib_thread.deleteLater()
             self.__auto_lib_thread = None
         self.setControlButtons(None, False, True)
@@ -419,6 +399,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._input_queue.put(msg) # put message to input queue
         self.MessageEdit.clear()

src/gui/ALMainWorkers.py

@@ -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.
@@ -17,13 +17,13 @@ from PySide6.QtCore import (
 
 from base.MsgBase import MsgBase
 from operators.AutoLib import AutoLib
-from utils.ConfigReader import ConfigReader
+from utils.JSONReader import JSONReader
 
 
-class AutoLibWorker(QThread, MsgBase):
+class AutoLibWorker(MsgBase, QThread):
 
-    finishedSignal = Signal()
+    autoLibWorkerIsFinished = Signal()
-    finishedWithErrorSignal = Signal()
+    autoLibWorkerFinishedWithError = Signal()
 
     def __init__(
         self,
@@ -32,8 +32,8 @@ class AutoLibWorker(QThread, MsgBase):
         config_paths: dict
     ):
 
-        super().__init__(input_queue = input_queue, output_queue = output_queue)
+        MsgBase.__init__(self, input_queue, output_queue)
-
+        QThread.__init__(self)
         self.__config_paths = config_paths
 
 
@@ -69,15 +69,11 @@ class AutoLibWorker(QThread, MsgBase):
         self._showTrace(
             f"正在加载配置文件, 运行配置文件路径: {self.__config_paths["run"]}"
         )
-        self.__run_config = ConfigReader(
+        self.__run_config = JSONReader(self.__config_paths["run"]).data()
-            self.__config_paths["run"]
-        ).getConfigs()
         self._showTrace(
             f"正在加载配置文件, 用户配置文件路径: {self.__config_paths["user"]}"
         )
-        self.__user_config = ConfigReader(
+        self.__user_config = JSONReader(self.__config_paths["user"]).data()
-            self.__config_paths["user"]
-        ).getConfigs()
         if self.__run_config is None or self.__user_config is None:
             self._showTrace("配置文件加载失败, 请检查配置文件是否正确")
             self._showTrace("配置文件加载失败, 请检查配置文件是否正确")
@@ -120,17 +116,17 @@ class AutoLibWorker(QThread, MsgBase):
                     )
             except Exception as e:
                 self._showTrace(f"AutoLibrary 运行时发生异常 : {e}")
-                self.finishedWithErrorSignal.emit()
+                self.autoLibWorkerFinishedWithError.emit()
                 return
         if auto_lib:
             auto_lib.close()
         self._showTrace("AutoLibrary 运行结束")
-        self.finishedSignal.emit()
+        self.autoLibWorkerIsFinished.emit()
 
 
 class TimerTaskWorker(AutoLibWorker):
 
-    finishedSignal_TimerWorker = Signal(bool, dict)
+    timerTaskWorkerIsFinished = Signal(bool, dict)
 
     def __init__(
         self,
@@ -141,10 +137,10 @@ class TimerTaskWorker(AutoLibWorker):
     ):
 
         super().__init__(input_queue, output_queue, config_paths)
-
         self.__timer_task = timer_task
-        self.finishedSignal.connect(self.onTimerTaskIsFinished)
+
-        self.finishedWithErrorSignal.connect(self.onTimerTaskIsError)
+        self.autoLibWorkerIsFinished.connect(self.onTimerTaskIsFinished)
+        self.autoLibWorkerFinishedWithError.connect(self.onTimerTaskFinishedWithError)
 
     def run(
         self
@@ -153,18 +149,18 @@ class TimerTaskWorker(AutoLibWorker):
         self._showTrace(f"定时任务 {self.__timer_task['name']} 开始运行")
         super().run()
 
-    @Slot(dict)
+    @Slot()
-    def onTimerTaskIsError(
+    def onTimerTaskFinishedWithError(
         self
     ):
 
         self._showTrace(f"定时任务 {self.__timer_task['name']} 运行时发生异常")
-        self.finishedSignal_TimerWorker.emit(True, self.__timer_task)
+        self.timerTaskWorkerIsFinished.emit(True, self.__timer_task)
 
-    @Slot(dict)
+    @Slot()
     def onTimerTaskIsFinished(
         self
     ):
 
         self._showTrace(f"定时任务 {self.__timer_task['name']} 运行结束")
-        self.finishedSignal_TimerWorker.emit(False, self.__timer_task)
+        self.timerTaskWorkerIsFinished.emit(False, self.__timer_task)

src/gui/ALSeatFrame.py

@@ -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.
@@ -22,12 +22,13 @@ class ALSeatFrame(QFrame):
     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(
@@ -39,18 +40,19 @@ class ALSeatFrame(QFrame):
         self.setLineWidth(2)
         self.setStyleSheet("""
             QFrame {
-                background-color: #4196EB;
+                background-color: #2294FF;
-                border: 2px solid #4196EB;
+                border: 2px solid #2294FF;
                 border-radius: 5px;
             }
             QLabel {
-                color: #F0F0F0;
+                color: #FFFFFF;
                 font-weight: bold;
             }
         """)
-        self.label = QLabel(self.__seat_number, self)
+        self.setCursor(Qt.CursorShape.PointingHandCursor)
-        self.label.setAlignment(Qt.AlignCenter)
+        self.Label = QLabel(self.__seat_number, self)
-        self.label.setGeometry(0, 0, 60, 40)
+        self.Label.setAlignment(Qt.AlignCenter)
+        self.Label.setGeometry(0, 0, 60, 40)
 
     def mousePressEvent(
         self,
@@ -76,24 +78,24 @@ class ALSeatFrame(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;
+                    background-color: #2294FF;
-                    border: 2px solid #4196EB;
+                    border: 2px solid #2294FF;
                     border-radius: 5px;
                 }
                 QLabel {
-                    color: #F0F0F0;
+                    color: #FFFFFF;
                     font-weight: bold;
                 }
             """)

src/gui/ALSeatMapSelectDialog.py

@@ -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()

src/gui/ALSeatMapTable.py

@@ -1,4 +1,4 @@
-seats_maps = {
+ALSeatMapTable = {
     "2": {
         "1": """
 ,,,,,,,,,,,039A,039B,,040A,040B,,041A,041B,,042A,042B,,043A,043B,,044A,044B,,,,,,,,,

src/gui/ALSeatMapView.py

@@ -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,
+    QFrame, QWidget,
-    QGridLayout, QGraphicsView, QGraphicsScene, QGraphicsItem,
+    QGridLayout, QGraphicsView, QGraphicsScene, QGraphicsItem
-    QPushButton,
 )
 from PySide6.QtGui import (
-    QPainter, QWheelEvent, QCloseEvent
+    QPainter, QWheelEvent
 )
+
 from gui.ALSeatFrame import ALSeatFrame
 
 
-class ALSeatMapWidget(QWidget):
+class ALSeatMapView(QGraphicsView):
-
-    seatMapWidgetClosed = Signal(list)
 
     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()
 
     @staticmethod
     def formatSeatNumber(
@@ -55,106 +47,13 @@ class ALSeatMapWidget(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 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.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
         ):
@@ -169,12 +68,40 @@ class ALSeatMapWidget(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)
+        target_scale = current_scale*zoom_factor
-        self.SeatMapGraphicsView.scale(zoom_factor, 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
     ):
 
@@ -258,19 +185,4 @@ class ALSeatMapWidget(QWidget):
             if len(self.__selected_seats) < 1:
                 self.__selected_seats.append(seat_number)
             else:
-                self.__seat_frames[seat_number].toggleSelection()
+                self.__seat_frames[seat_number].toggleSelection()
-
-    @Slot()
-    def onConfirmButtonClicked(
-        self
-    ):
-
-        self.close()
-
-    @Slot()
-    def onCancelButtonClicked(
-        self
-    ):
-
-        self.clearSelections()
-        self.close()

src/gui/ALTimerTaskAddDialog.py

@@ -1,36 +1,25 @@
 # -*- 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
-import time
 import uuid
-import queue
 
 from enum import Enum
 from datetime import datetime, timedelta
 
-from PySide6.QtCore import (
+from PySide6.QtCore import Slot, QDateTime
-    Qt, Signal, Slot, QDateTime
+from PySide6.QtWidgets import QLabel, QDialog, QWidget, QSpinBox, QHBoxLayout, QGridLayout, QDateTimeEdit
-)
-from PySide6.QtWidgets import (
-    QLabel, QDialog, QWidget, QSpinBox, QVBoxLayout,
-    QHBoxLayout, QGridLayout, QDateTimeEdit
-)
-from PySide6.QtGui import (
-    QCloseEvent
-)
 
-from gui.Ui_ALAddTimerTaskDialog import Ui_ALAddTimerTaskDialog
+from gui.resources.ui.Ui_ALTimerTaskAddDialog import Ui_ALTimerTaskAddDialog
+import utils.TimerUtils as TimerUtils
 
 
-class TimerTaskStatus(Enum):
+class ALTimerTaskStatus(Enum):
 
     PENDING = "等待中"
     READY = "已就绪"
@@ -38,9 +27,10 @@ class TimerTaskStatus(Enum):
     EXECUTED = "已执行"
     ERROR = "执行失败"
     OUTDATED = "已过期"
+    UNKNOWN = "未知"
 
 
-class ALAddTimerTaskWidget(QDialog, Ui_ALAddTimerTaskDialog):
+class ALTimerTaskAddDialog(QDialog, Ui_ALTimerTaskAddDialog):
 
     def __init__(
         self,
@@ -50,8 +40,8 @@ class ALAddTimerTaskWidget(QDialog, Ui_ALAddTimerTaskDialog):
         super().__init__(parent)
 
         self.setupUi(self)
-        self.connectSignals()
         self.modifyUi()
+        self.connectSignals()
 
 
     def modifyUi(
@@ -71,28 +61,28 @@ class ALAddTimerTaskWidget(QDialog, Ui_ALAddTimerTaskDialog):
         self.TimerConfigLayout.addWidget(self.SpecificTimerWidget)
 
         self.RelativeTimerWidget = QWidget()
-        self.RelativeTimerLayout = QGridLayout(self.RelativeTimerWidget)
+        self.RelativeTimerLayout = QHBoxLayout(self.RelativeTimerWidget)
-        self.RelativeTimerLayout.addWidget(QLabel("相对时间："), 0, 0)
+        self.RelativeTimerLayout.addWidget(QLabel("相对时间："))
         self.RelativeDaySpinBox = QSpinBox()
         self.RelativeDaySpinBox.setMinimum(0)
-        self.RelativeDaySpinBox.setMaximum(365)
+        self.RelativeDaySpinBox.setMaximum(364)
         self.RelativeDaySpinBox.setSuffix("天")
-        self.RelativeTimerLayout.addWidget(self.RelativeDaySpinBox, 1, 0)
+        self.RelativeTimerLayout.addWidget(self.RelativeDaySpinBox)
         self.RelativeHourSpinBox = QSpinBox()
         self.RelativeHourSpinBox.setMinimum(0)
         self.RelativeHourSpinBox.setMaximum(23)
         self.RelativeHourSpinBox.setSuffix("时")
-        self.RelativeTimerLayout.addWidget(self.RelativeHourSpinBox, 1, 1)
+        self.RelativeTimerLayout.addWidget(self.RelativeHourSpinBox)
         self.RelativeMinuteSpinBox = QSpinBox()
         self.RelativeMinuteSpinBox.setMinimum(0)
         self.RelativeMinuteSpinBox.setMaximum(59)
         self.RelativeMinuteSpinBox.setSuffix("分")
-        self.RelativeTimerLayout.addWidget(self.RelativeMinuteSpinBox, 1, 2)
+        self.RelativeTimerLayout.addWidget(self.RelativeMinuteSpinBox)
         self.RelativeSecondSpinBox = QSpinBox()
         self.RelativeSecondSpinBox.setMinimum(0)
         self.RelativeSecondSpinBox.setMaximum(59)
         self.RelativeSecondSpinBox.setSuffix("秒")
-        self.RelativeTimerLayout.addWidget(self.RelativeSecondSpinBox, 1, 3)
+        self.RelativeTimerLayout.addWidget(self.RelativeSecondSpinBox)
         self.TimerConfigLayout.addWidget(self.RelativeTimerWidget)
         self.RelativeTimerWidget.setVisible(False)
 
@@ -104,6 +94,7 @@ class ALAddTimerTaskWidget(QDialog, Ui_ALAddTimerTaskDialog):
         self.CancelButton.clicked.connect(self.reject)
         self.ConfirmButton.clicked.connect(self.accept)
         self.TimerTypeComboBox.currentIndexChanged.connect(self.onTimerTypeComboBoxIndexChanged)
+        self.RepeatCheckBox.toggled.connect(self.onRepeatCheckBoxToggled)
 
 
     def getTimerTask(
@@ -128,17 +119,47 @@ class ALAddTimerTaskWidget(QDialog, Ui_ALAddTimerTaskDialog):
                 minutes = self.RelativeMinuteSpinBox.value(),
                 seconds = self.RelativeSecondSpinBox.value()
             )
-        return {
+        task_data = {
             "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": TimerTaskStatus.PENDING,
+            "status": ALTimerTaskStatus.PENDING,
-            "executed": False
+            "executed": False,
+            "repeat": self.RepeatCheckBox.isChecked(),
         }
+        if task_data["repeat"]:
+            repeat_days = []
+            if self.MonCheckBox.isChecked():
+                repeat_days.append(0)
+            if self.TueCheckBox.isChecked():
+                repeat_days.append(1)
+            if self.WedCheckBox.isChecked():
+                repeat_days.append(2)
+            if self.ThuCheckBox.isChecked():
+                repeat_days.append(3)
+            if self.FriCheckBox.isChecked():
+                repeat_days.append(4)
+            if self.SatCheckBox.isChecked():
+                repeat_days.append(5)
+            if self.SunCheckBox.isChecked():
+                repeat_days.append(6)
+            if not repeat_days:
+                repeat_days = [0, 1, 2, 3, 4, 5, 6]
+            task_data["repeat_days"] = repeat_days
+            task_data["repeat_hour"] = execute_time.hour
+            task_data["repeat_minute"] = execute_time.minute
+            task_data["repeat_second"] = execute_time.second
+            task_data["execute_time"] = TimerUtils.calculateNextRepeatTime(
+                task_data["repeat_days"],
+                task_data["repeat_hour"],
+                task_data["repeat_minute"],
+                task_data["repeat_second"]
+            )
 
+        return task_data
 
     @Slot(int)
     def onTimerTypeComboBoxIndexChanged(
@@ -147,4 +168,18 @@ class ALAddTimerTaskWidget(QDialog, Ui_ALAddTimerTaskDialog):
     ):
 
         self.SpecificTimerWidget.setVisible(index == 0)
-        self.RelativeTimerWidget.setVisible(index == 1)
+        self.RelativeTimerWidget.setVisible(index == 1)
+
+    @Slot(bool)
+    def onRepeatCheckBoxToggled(
+        self,
+        checked: bool
+    ):
+
+        self.MonCheckBox.setEnabled(checked)
+        self.TueCheckBox.setEnabled(checked)
+        self.WedCheckBox.setEnabled(checked)
+        self.ThuCheckBox.setEnabled(checked)
+        self.FriCheckBox.setEnabled(checked)
+        self.SatCheckBox.setEnabled(checked)
+        self.SunCheckBox.setEnabled(checked)

src/gui/ALTimerTaskHistoryDialog.py

@@ -0,0 +1,147 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2026 KenanZhu.
+All rights reserved.
+
+This software is provided "as is", without any warranty of any kind.
+You may use, modify, and distribute this file under the terms of the MIT License.
+See the LICENSE file for details.
+"""
+from datetime import datetime
+
+from PySide6.QtCore import Slot, Qt
+from PySide6.QtWidgets import (
+    QDialog, QTableWidget, QTableWidgetItem,
+    QVBoxLayout, QHBoxLayout, QGridLayout,
+    QPushButton, QLabel, QHeaderView
+)
+
+from gui.ALTimerTaskAddDialog import ALTimerTaskStatus
+
+
+class ALTimerTaskHistoryDialog(QDialog):
+
+    def __init__(
+        self,
+        parent = None,
+        task_data: dict = None
+    ):
+
+        super().__init__(parent)
+
+        self.__task_data = task_data
+        self.__history = task_data.get("history", [])
+
+        self.modifyUi()
+        self.connectSignals()
+
+
+    def modifyUi(
+        self
+    ):
+
+        self.setWindowTitle("定时任务执行历史 - AutoLibrary")
+        self.setMinimumSize(300, 300)
+        self.setMaximumSize(500, 400)
+
+        MainLayout = QVBoxLayout(self)
+        InfoLayout = QGridLayout()
+        TaskNameLabel = QLabel(f"任务: {self.__task_data.get('name', '未命名')}")
+        TaskNameLabel.setStyleSheet("font-weight: bold; font-size: 14px;")
+        InfoLayout.addWidget(TaskNameLabel, 0, 0)
+        TaskUUIDLabel = QLabel(f"UUID: {self.__task_data.get('task_uuid', '未命名')}")
+        TaskUUIDLabel.setStyleSheet("font-size: 10px;")
+        InfoLayout.addWidget(TaskUUIDLabel, 1, 0)
+        InfoLayout.setColumnStretch(0, 1)
+
+        if self.__task_data.get("repeat", False):
+            RepeatLabel = QLabel("重复任务")
+            RepeatLabel.setStyleSheet("color: #2294FF; font-weight: bold; font-size: 12px;")
+            InfoLayout.addWidget(RepeatLabel, 0, 1)
+        MainLayout.addLayout(InfoLayout)
+        self.HistoryTableWidget = QTableWidget()
+        self.HistoryTableWidget.setColumnCount(3)
+        self.HistoryTableWidget.setHorizontalHeaderLabels(["执行时间", "结果", "耗时（秒/s）"])
+        self.HistoryTableWidget.horizontalHeader().setSectionResizeMode(0, QHeaderView.ResizeMode.Stretch)
+        self.HistoryTableWidget.horizontalHeader().setSectionResizeMode(1, QHeaderView.ResizeMode.ResizeToContents)
+        self.HistoryTableWidget.horizontalHeader().setSectionResizeMode(2, QHeaderView.ResizeMode.Stretch)
+        self.HistoryTableWidget.verticalHeader().setVisible(False)
+        self.HistoryTableWidget.setEditTriggers(QTableWidget.EditTrigger.NoEditTriggers)
+        self.HistoryTableWidget.setSelectionBehavior(QTableWidget.SelectionBehavior.SelectRows)
+        self.loadHistory()
+        MainLayout.addWidget(self.HistoryTableWidget)
+
+        ButtonLayout = QHBoxLayout()
+        ButtonLayout.addStretch()
+        self.CloseButton = QPushButton("关闭")
+        self.CloseButton.setFixedSize(80, 25)
+        self.CloseButton.setDefault(True)
+        self.ClearHistoryButton = QPushButton("清空历史")
+        self.ClearHistoryButton.setFixedSize(80, 25)
+        self.ClearHistoryButton.setStyleSheet("color: #DC0000;")
+        ButtonLayout.addWidget(self.ClearHistoryButton)
+        ButtonLayout.addWidget(self.CloseButton)
+        MainLayout.addLayout(ButtonLayout)
+
+
+    def connectSignals(
+        self
+    ):
+
+        self.CloseButton.clicked.connect(self.accept)
+        self.ClearHistoryButton.clicked.connect(self.onClearHistoryButtonClicked)
+
+
+    def loadHistory(
+        self
+    ):
+
+        self.HistoryTableWidget.setRowCount(len(self.__history))
+        for row, record in enumerate(self.__history):
+            self.addHistoryRow(row, record)
+
+
+    def addHistoryRow(
+        self,
+        row: int,
+        record: dict
+    ):
+
+        execute_time = record.get("execute_time", "")
+        result = record.get("result", ALTimerTaskStatus.UNKNOWN)
+        duration = record.get("duration", 0)
+        ExecuteTimeItem = QTableWidgetItem(execute_time)
+        ExecuteTimeItem.setTextAlignment(Qt.AlignmentFlag.AlignCenter)
+        self.HistoryTableWidget.setItem(row, 0, ExecuteTimeItem)
+        ResultItem = QTableWidgetItem(result.value)
+        ResultItem.setTextAlignment(Qt.AlignmentFlag.AlignCenter)
+        match result:
+            case ALTimerTaskStatus.EXECUTED:
+                ResultItem.setForeground(Qt.GlobalColor.green)
+            case ALTimerTaskStatus.ERROR:
+                ResultItem.setForeground(Qt.GlobalColor.red)
+            case ALTimerTaskStatus.OUTDATED:
+                ResultItem.setForeground(Qt.GlobalColor.red)
+            case _:
+                ResultItem.setForeground(Qt.GlobalColor.black)
+        self.HistoryTableWidget.setItem(row, 1, ResultItem)
+        DurationItem = QTableWidgetItem(f"{duration:.2f}")
+        DurationItem.setTextAlignment(Qt.AlignmentFlag.AlignCenter)
+        self.HistoryTableWidget.setItem(row, 2, DurationItem)
+        self.HistoryTableWidget.setRowHeight(row, 25)
+
+    @Slot()
+    def onClearHistoryButtonClicked(
+        self
+    ):
+
+        self.__history.clear()
+        self.HistoryTableWidget.setRowCount(0)
+        self.__task_data["history"] = self.__history
+
+
+    def getHistory(
+        self
+    ) -> list:
+
+        return self.__history

src/gui/ALTimerTaskManageWidget.py

@@ -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.
@@ -9,9 +9,7 @@ See the LICENSE file for details.
 """
 import os
 import sys
-import time
 import copy
-import queue
 
 from enum import Enum
 from datetime import datetime, timedelta
@@ -24,24 +22,18 @@ from PySide6.QtWidgets import (
     QHBoxLayout, QVBoxLayout, QLabel, QPushButton
 )
 from PySide6.QtGui import (
-    QCloseEvent, QScreen
+    QCloseEvent
 )
 
-from gui.Ui_ALTimerTaskWidget import Ui_ALTimerTaskWidget
+import utils.ConfigManager as ConfigManager
-from gui.ALAddTimerTaskDialog import ALAddTimerTaskWidget, TimerTaskStatus
+import utils.TimerUtils as TimerUtils
 
-from utils.ConfigReader import ConfigReader
+from gui.resources.ui.Ui_ALTimerTaskManageWidget import Ui_ALTimerTaskManageWidget
-from utils.ConfigWriter import ConfigWriter
+from gui.ALTimerTaskAddDialog import ALTimerTaskAddDialog, ALTimerTaskStatus
+from gui.ALTimerTaskHistoryDialog import ALTimerTaskHistoryDialog
 
 
-class SortPolicy(Enum):
+class ALTimerTaskItemWidget(QWidget):
-
-    BY_NAME = "按名称"
-    BY_ADD_TIME = "按添加时间"
-    BY_EXECUTE_TIME = "按执行时间"
-
-
-class TimerTaskItemWidget(QWidget):
 
     def __init__(
         self,
@@ -50,8 +42,8 @@ class TimerTaskItemWidget(QWidget):
     ):
 
         super().__init__(parent)
-
         self.__timer_task = timer_task
+
         self.modifyUi()
 
 
@@ -71,40 +63,52 @@ class TimerTaskItemWidget(QWidget):
         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}")
+        if self.__timer_task.get("repeat", False):
-        ExecuteTimeLabel.setStyleSheet("color: gray;")
+            repeat_days = self.__timer_task.get("repeat_days", [])
+            repeat_hour = self.__timer_task.get("repeat_hour", 0)
+            repeat_minute = self.__timer_task.get("repeat_minute", 0)
+            repeat_second = self.__timer_task.get("repeat_second", 0)
+            if len(repeat_days) == 7:
+                time_str = f"{repeat_hour:02d}:{repeat_minute:02d}:{repeat_second:02d}"
+                ExecuteTimeLabel = QLabel(f"下次执行时间: {ExecuteTimeStr} (每日 {time_str})")
+            else:
+                day_names = ["周一", "周二", "周三", "周四", "周五", "周六", "周日"]
+                selected_days = [day_names[d] for d in repeat_days]
+                time_str = f"{repeat_hour:02d}:{repeat_minute:02d}:{repeat_second:02d}"
+                ExecuteTimeLabel = QLabel(f"下次执行时间: {ExecuteTimeStr} (每{','.join(selected_days)} {time_str})")
+        else:
+            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 TimerTaskStatus.PENDING:
+            case ALTimerTaskStatus.PENDING:
                 TaskStatusText = "等待中"
                 TaskStatusColor = "#FF9800"
-            case TimerTaskStatus.READY:
+            case ALTimerTaskStatus.READY:
                 TaskStatusText = "已就绪"
                 TaskStatusColor = "#316BFF"
-            case TimerTaskStatus.RUNNING:
+            case ALTimerTaskStatus.RUNNING:
                 TaskStatusText = "执行中"
                 TaskStatusColor = "#2294FF"
-            case TimerTaskStatus.EXECUTED:
+            case ALTimerTaskStatus.EXECUTED:
                 TaskStatusText = "已执行"
                 TaskStatusColor = "#4CAF50"
-            case TimerTaskStatus.ERROR:
+            case ALTimerTaskStatus.ERROR:
                 TaskStatusText = "执行失败"
-                TaskStatusColor = "#FF5722"
+                TaskStatusColor = "#DC0000"
-            case TimerTaskStatus.OUTDATED:
+            case ALTimerTaskStatus.OUTDATED:
                 TaskStatusText = "已过期"
-                TaskStatusColor = "#FF5722"
+                TaskStatusColor = "#DC0000"
         TaskStatusLabel = QLabel(TaskStatusText)
         TaskStatusLabel.setStyleSheet(f"""
             QLabel {{
                 background-color: {TaskStatusColor};
-                color: white;
+                color: #FFFFFF;
                 border-radius: 5px;
                 font-weight: bold;
             }}
@@ -119,7 +123,7 @@ class TimerTaskItemWidget(QWidget):
         TaskModeLabel.setStyleSheet(f"""
             QLabel {{
                 background-color: {TaskModeColor};
-                color: white;
+                color: #FFFFFF;
                 border-radius: 5px;
                 font-weight: bold;
             }}
@@ -128,40 +132,49 @@ class TimerTaskItemWidget(QWidget):
         TaskModeLabel.setFixedSize(60, 25)
         self.ItemWidgetLayout.addWidget(TaskModeLabel)
 
+        if self.__timer_task.get("repeat", False):
+            self.HistoryButton = QPushButton("历史")
+            self.HistoryButton.setFixedSize(80, 25)
+            self.ItemWidgetLayout.addWidget(self.HistoryButton)
         self.DeleteButton = QPushButton("删除")
         self.DeleteButton.setFixedSize(80, 25)
+        self.DeleteButton.setStyleSheet("color: #DC0000;")
         self.ItemWidgetLayout.addWidget(self.DeleteButton)
-        if self.__timer_task["status"] == TimerTaskStatus.READY\
+        if self.__timer_task["status"] == ALTimerTaskStatus.READY\
-        or self.__timer_task["status"] == TimerTaskStatus.RUNNING:
+        or self.__timer_task["status"] == ALTimerTaskStatus.RUNNING:
             self.DeleteButton.setEnabled(False)
         self.setFixedHeight(55)
 
 
-class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
+class ALTimerTaskManageWidget(QWidget, Ui_ALTimerTaskManageWidget):
+
+    class SortPolicy(Enum):
+
+        BY_NAME = "按名称"
+        BY_ADD_TIME = "按添加时间"
+        BY_EXECUTE_TIME = "按执行时间"
 
-    timerTasksChanged = Signal()
     timerTaskIsReady = Signal(dict)
-    timerTaskWidgetClosed = Signal()
+    timerTasksChanged = Signal()
+    timerTaskManageWidgetIsClosed = Signal()
 
     def __init__(
         self,
-        parent = None,
+        parent = None
-        timer_tasks_config_path: str = ""
     ):
 
         super().__init__(parent)
-
+        self.__cfg_mgr = ConfigManager.instance()
         self.__timer_tasks = []
         self.__check_timer = None
-        self.__sort_policy = SortPolicy.BY_EXECUTE_TIME
+        self.__sort_policy = self.SortPolicy.BY_EXECUTE_TIME
         self.__sort_order = Qt.SortOrder.AscendingOrder
-        self.__timer_tasks_config_path = timer_tasks_config_path
 
         self.setupUi(self)
         self.connectSignals()
         self.setupTimer()
         if not self.initializeTimerTasks():
-            return
+            raise Exception("定时任务配置文件初始化失败 !")
 
 
     def connectSignals(
@@ -188,74 +201,63 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
         self
     ) -> bool:
 
-        timer_tasks = self.loadTimerTasks(self.__timer_tasks_config_path)
+        timer_tasks = self.getTimerTasks()
         if timer_tasks is not None:
             self.__timer_tasks = timer_tasks
             self.timerTasksChanged.emit()
             return True
         timer_tasks = []
-        if self.saveTimerTasks(self.__timer_tasks_config_path, copy.deepcopy(timer_tasks)):
+        if self.setTimerTasks(copy.deepcopy(timer_tasks)):
-            QMessageBox.information(
-                self,
-                "信息 - AutoLibrary",
-                f"定时任务配置文件初始化完成: \n{self.__timer_tasks_config_path}"
-            )
             self.__timer_tasks = timer_tasks
-            self.updateTimerTaskList()
             return True
         return False
 
 
-    def loadTimerTasks(
+    def getTimerTasks(
-        self,
+        self
-        timer_tasks_config_path: str
     ) -> list:
 
         try:
-            if not timer_tasks_config_path or not os.path.exists(timer_tasks_config_path):
+            timer_tasks = self.__cfg_mgr.get(ConfigManager.ConfigType.TIMERTASK)
-                raise Exception("定时任务配置文件不存在")
-            timer_tasks = ConfigReader(timer_tasks_config_path).getConfigs()
             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"] = TimerTaskStatus(task["status"])
+                    task["status"] = ALTimerTaskStatus(task["status"])
+                    if "history" in task:
+                        for item in task["history"]:
+                            item["result"] = ALTimerTaskStatus(item["result"])
                 return timer_tasks["timer_tasks"]
             raise Exception("定时任务配置文件格式错误")
         except Exception as e:
             QMessageBox.warning(
                 self,
                 "警告 - AutoLibrary",
-                f"加载定时任务配置发生错误 ! : {e}\n"\
+                f"加载定时任务配置发生错误 ! : \n{e}"
-                f"文件路径: {timer_tasks_config_path}"
             )
             return None
 
 
-    def saveTimerTasks(
+    def setTimerTasks(
         self,
-        timer_tasks_config_path: str,
         timer_tasks: list
     ) -> bool:
 
         try:
-            if not timer_tasks_config_path:
-                raise Exception("配置文件路径为空")
             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
-            ConfigWriter(
+                if "history" in task:
-                timer_tasks_config_path,
+                    for item in task["history"]:
-                { "timer_tasks": timer_tasks }
+                        item["result"] = item["result"].value
-            )
+            self.__cfg_mgr.set(ConfigManager.ConfigType.TIMERTASK, "", { "timer_tasks": timer_tasks })
             return True
         except Exception as e:
             QMessageBox.warning(
                 self,
                 "警告 - AutoLibrary",
-                f"保存定时任务配置发生错误 ! : {e}\n"\
+                f"保存定时任务配置发生错误 ! : \n{e}"
-                f"文件路径: {timer_tasks_config_path}"
             )
             return False
 
@@ -290,7 +292,7 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
     ):
 
         self.hide()
-        self.timerTaskWidgetClosed.emit()
+        self.timerTaskManageWidgetIsClosed.emit()
         event.ignore()
 
 
@@ -300,17 +302,17 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
         order: Qt.SortOrder = Qt.SortOrder.AscendingOrder
     ):
 
-        if policy == SortPolicy.BY_NAME:
+        if policy == self.SortPolicy.BY_NAME:
             self.__timer_tasks.sort(
                 key = lambda x: x["name"],
                 reverse = order is Qt.SortOrder.DescendingOrder
             )
-        elif policy == SortPolicy.BY_ADD_TIME:
+        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 == SortPolicy.BY_EXECUTE_TIME:
+        elif policy == self.SortPolicy.BY_EXECUTE_TIME:
             self.__timer_tasks.sort(
                 key = lambda x: x["execute_time"],
                 reverse = order is Qt.SortOrder.DescendingOrder
@@ -327,15 +329,15 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
         invalid = 0
         total = len(self.__timer_tasks)
         for timer_task in self.__timer_tasks:
-            if timer_task["status"] == TimerTaskStatus.PENDING:
+            if timer_task["status"] == ALTimerTaskStatus.PENDING:
                 pending += 1
-            elif timer_task["status"] == TimerTaskStatus.READY\
+            elif timer_task["status"] == ALTimerTaskStatus.READY\
-            or timer_task["status"] == TimerTaskStatus.RUNNING:
+            or timer_task["status"] == ALTimerTaskStatus.RUNNING:
                 in_queue += 1
-            elif timer_task["status"] == TimerTaskStatus.EXECUTED:
+            elif timer_task["status"] == ALTimerTaskStatus.EXECUTED:
                 executed += 1
-            elif timer_task["status"] == TimerTaskStatus.ERROR\
+            elif timer_task["status"] == ALTimerTaskStatus.ERROR\
-            or timer_task["status"] == TimerTaskStatus.OUTDATED:
+            or timer_task["status"] == ALTimerTaskStatus.OUTDATED:
                 invalid += 1
         self.TotalTaskLabel.setText(f"总任务：{total}")
         self.PendingTaskLabel.setText(f"待执行：{pending}")
@@ -353,10 +355,14 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
         for timer_task in self.__timer_tasks:
             item = QListWidgetItem()
             item.setData(Qt.UserRole, timer_task)
-            widget = TimerTaskItemWidget(self, timer_task)
+            widget = ALTimerTaskItemWidget(self, timer_task)
             widget.DeleteButton.clicked.connect(
-                lambda _, uuid = timer_task["task_uuid"]: self.deleteTask(uuid)
+                lambda _, task = timer_task: self.deleteTask(task)
             )
+            if timer_task.get("repeat", False) and hasattr(widget, "HistoryButton"):
+                widget.HistoryButton.clicked.connect(
+                    lambda _, task = timer_task: self.showTaskHistory(task)
+                )
             item.setSizeHint(widget.size())
             self.TimerTasksListWidget.addItem(item)
             self.TimerTasksListWidget.setItemWidget(item, widget)
@@ -366,18 +372,49 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
         self
     ):
 
-        dialog = ALAddTimerTaskWidget(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(
+    @staticmethod
-        self,
+    def getTimerTaskDetailMessage(
-        task_uuid: str
+        timer_task: dict
     ):
 
+        return (
+            f"任务名称：{timer_task["name"]}\n"
+            f"添加时间：{timer_task["add_time"]}\n"
+            f"当前状态：{timer_task["status"].value}\n"
+            f"下次执行时间：{datetime.strftime(timer_task["execute_time"], "%Y-%m-%d %H:%M:%S")}\n"
+            f"已执行次数：{len(timer_task['history'] if 'history' in timer_task else 0)}"
+        )
+
+
+    def deleteTask(
+        self,
+        timer_task: dict
+    ):
+
+        if timer_task["repeat"]: # when delete a repeat task
+            msgbox = QMessageBox(self)
+            msgbox.setIcon(QMessageBox.Icon.Question)
+            msgbox.setWindowTitle("警告 - AutoLibrary")
+            msgbox.setStandardButtons(
+                QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No
+            )
+            msgbox.setText("删除可重复性任务将同时删除所有已执行的记录 !\n是否继续 ?")
+            msgbox.setDetailedText(
+                "以下可重复性任务将被删除：\n"\
+                "\n"
+                f"{self.getTimerTaskDetailMessage(timer_task)}"
+            )
+            result = msgbox.exec()
+            if result != QMessageBox.StandardButton.Yes:
+                return
+        task_uuid = timer_task["task_uuid"]
         self.__timer_tasks = [
             x for x in self.__timer_tasks
             if x["task_uuid"] != task_uuid
@@ -397,24 +434,66 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
             "是否要清除所有定时任务 ?",
             QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No
         )
-        if result is QMessageBox.StandardButton.No:
+        if result == QMessageBox.StandardButton.No:
             return
+        # READY and RUNNING tasks cannot be cleared
         in_queue_tasks = [
             x for x in self.__timer_tasks
-            if x["status"] == TimerTaskStatus.READY
+            if x["status"] == ALTimerTaskStatus.READY
-            or x["status"] == TimerTaskStatus.RUNNING
+            or x["status"] == ALTimerTaskStatus.RUNNING
         ]
         in_queue_count = len(in_queue_tasks)
         if in_queue_count > 0:
             QMessageBox.warning(
                 self,
                 "警告 - AutoLibrary",
-                "存在正在执行或已就绪的队列任务，无法清除所有定时任务 !"
+                f"存在 {in_queue_count} 个正在执行或已就绪的队列任务，无法清除所有定时任务 !"
             )
-        self.__timer_tasks = in_queue_tasks
+            return
+        # repeat tasks ask before clear
+        repeat_tasks = [
+            x for x in self.__timer_tasks
+            if x.get("repeat", False)
+        ]
+        repeat_tasks_count = len(repeat_tasks)
+        if repeat_tasks_count > 0:
+            msgbox = QMessageBox(self)
+            msgbox.setIcon(QMessageBox.Icon.Question)
+            msgbox.setWindowTitle("警告 - AutoLibrary")
+            msgbox.setStandardButtons(
+                QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No
+            )
+            msgbox.setText(
+                f"存在 {repeat_tasks_count} 个可重复性任务，\n"
+                "删除可重复性任务将同时删除所有已执行的记录 !\n"
+                "是否继续 ?"
+            )
+            delete_msgs = [
+                self.getTimerTaskDetailMessage(x) for x in repeat_tasks
+            ]
+            msgbox.setDetailedText(
+                "以下可重复性任务将被删除：\n"\
+                "\n"
+                f"{"\n\n".join(delete_msgs)}"
+            )
+            result = msgbox.exec()
+            if result != QMessageBox.StandardButton.Yes:
+                return
+        # clear all tasks
+        self.__timer_tasks.clear()
         self.timerTasksChanged.emit()
 
 
+    def showTaskHistory(
+        self,
+        task: dict
+    ):
+
+        dialog = ALTimerTaskHistoryDialog(self, task)
+        if dialog.exec() == QDialog.DialogCode.Accepted:
+            self.timerTasksChanged.emit()
+
+
     def checkTasks(
         self
     ):
@@ -425,13 +504,16 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
         for timer_task in self.__timer_tasks:
             if timer_task["execute_time"] > now:
                 continue
-            if timer_task["status"] is not TimerTaskStatus.PENDING:
+            if timer_task["status"] is not ALTimerTaskStatus.PENDING:
                 continue
             if timer_task["execute_time"] <= now + timedelta(seconds = -5):
-                timer_task["status"] = TimerTaskStatus.OUTDATED
+                if timer_task.get("repeat", False):
+                    self.onRepeatTimerTaskIs(ALTimerTaskStatus.OUTDATED, timer_task)
+                else:
+                    timer_task["status"] = ALTimerTaskStatus.OUTDATED
                 need_update = True
             else:
-                timer_task["status"] = TimerTaskStatus.READY
+                timer_task["status"] = ALTimerTaskStatus.READY
                 self.timerTaskIsReady.emit(timer_task)
                 need_update = True
         if need_update:
@@ -444,9 +526,9 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
     ):
 
         mapping = {
-            0: SortPolicy.BY_NAME,
+            0: self.SortPolicy.BY_NAME,
-            1: SortPolicy.BY_ADD_TIME,
+            1: self.SortPolicy.BY_ADD_TIME,
-            2: SortPolicy.BY_EXECUTE_TIME
+            2: self.SortPolicy.BY_EXECUTE_TIME
         }
         self.__sort_policy = mapping[policy]
         self.updateTimerTaskList()
@@ -469,7 +551,7 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
         self
     ):
 
-        self.saveTimerTasks(self.__timer_tasks_config_path, copy.deepcopy(self.__timer_tasks))
+        self.setTimerTasks(copy.deepcopy(self.__timer_tasks))
         self.updateTimerTaskList()
         self.updateStat()
 
@@ -482,10 +564,41 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
 
         for task in self.__timer_tasks:
             if task["task_uuid"] == timer_task["task_uuid"]:
-                task["status"] = TimerTaskStatus.RUNNING
+                task["status"] = ALTimerTaskStatus.RUNNING
+                break
         self.timerTasksChanged.emit()
 
 
+    def onRepeatTimerTaskIs(
+        self,
+        status: ALTimerTaskStatus,
+        timer_task: dict
+    ) -> dict:
+
+        if "history" not in timer_task:
+            timer_task["history"] = []
+        executed_time = datetime.now()
+        duration = (executed_time - timer_task["execute_time"]).total_seconds()
+        timer_task["history"].append({
+            "execute_time": timer_task["execute_time"].strftime("%Y-%m-%d %H:%M:%S"),
+            "executed_time": executed_time.strftime("%Y-%m-%d %H:%M:%S"),
+            "result": status,
+            "duration": duration if status is ALTimerTaskStatus.EXECUTED else 0,
+            "uuid": timer_task["task_uuid"]
+        })
+        next_time = TimerUtils.calculateNextRepeatTime(
+            timer_task["repeat_days"],
+            timer_task["repeat_hour"],
+            timer_task["repeat_minute"],
+            timer_task["repeat_second"]
+        )
+        if next_time:
+            timer_task["execute_time"] = next_time
+            timer_task["status"] = ALTimerTaskStatus.PENDING
+            timer_task["executed"] = False
+        else:
+            timer_task["status"] = status
+
     @Slot(dict)
     def onTimerTaskIsExecuted(
         self,
@@ -494,7 +607,11 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
 
         for task in self.__timer_tasks:
             if task["task_uuid"] == timer_task["task_uuid"]:
-                task["status"] = TimerTaskStatus.EXECUTED
+                if task.get("repeat", False):
+                    self.onRepeatTimerTaskIs(ALTimerTaskStatus.EXECUTED, task)
+                else:
+                    task["status"] = ALTimerTaskStatus.EXECUTED
+                break
         self.timerTasksChanged.emit()
 
     @Slot(dict)
@@ -505,5 +622,9 @@ class ALTimerTaskWidget(QWidget, Ui_ALTimerTaskWidget):
 
         for task in self.__timer_tasks:
             if task["task_uuid"] == timer_task["task_uuid"]:
-                task["status"] = TimerTaskStatus.ERROR
+                if task.get("repeat", False):
+                    self.onRepeatTimerTaskIs(ALTimerTaskStatus.ERROR, task)
+                else:
+                    task["status"] = ALTimerTaskStatus.ERROR
+                break
         self.timerTasksChanged.emit()

src/gui/ALUserTreeWidget.py

@@ -1,13 +1,12 @@
 # -*- 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.
 """
-
 from enum import Enum
 
 from PySide6.QtCore import (
@@ -22,7 +21,7 @@ from PySide6.QtGui import (
 )
 
 
-class TreeItemType(Enum):
+class ALUserTreeItemType(Enum):
 
     GROUP = 0
     USER = 1
@@ -112,15 +111,15 @@ class ALUserTreeWidget(QTreeWidget):
         if source_item is None:
             event.ignore()
             return
-        if source_item.type() == TreeItemType.GROUP.value:
+        if source_item.type() == ALUserTreeItemType.GROUP.value:
             if target_item is not None:
                 event.ignore()
                 return
-        elif source_item.type() == TreeItemType.USER.value:
+        elif source_item.type() == ALUserTreeItemType.USER.value:
             if target_item is None:
                 event.ignore()
                 return
-            if target_item.type() != TreeItemType.GROUP.value:
+            if target_item.type() != ALUserTreeItemType.GROUP.value:
                 event.ignore()
                 return
             if target_item.checkState(1) == Qt.CheckState.Unchecked:

src/gui/ALVersionInfo.py

@@ -5,11 +5,11 @@
     workflow process. Do not edit manually.
 
     This file is auto-generated during the workflow process.
-    Last updated: 2026-01-05 04:04:54 UTC
+    Last updated: 2026-02-26 15:04:28 UTC
 """
 
-AL_VERSION = "1.0.2"
+AL_VERSION = "1.1.0"
-AL_TAG = "v1.0.2"
+AL_TAG = "v1.1.0"
 AL_COMMIT_SHA = "local"
 AL_COMMIT_DATE = "null"  # time zone : UTC
 AL_BUILD_DATE = "null"  # time zone : UTC

src/gui/batchs/readme.md

@@ -1 +0,0 @@
-this folder is used to store the batch scripts.

src/gui/configs/readme.md

@@ -1 +0,0 @@
-this folder is used to store the config files.

src/gui/resources/ui/ALAboutDialog.ui

@@ -104,7 +104,7 @@
       <number>0</number>
      </property>
      <item>
-      <widget class="QFrame" name="frame">
+      <widget class="QFrame" name="AboutInfoSpaceFrame">
        <property name="minimumSize">
         <size>
          <width>56</width>
@@ -129,21 +129,24 @@
       </widget>
      </item>
      <item>
-      <widget class="QTextEdit" name="AboutInfoEdit">
+      <widget class="QTextBrowser" name="AboutInfoBrowser">
-       <property name="font">
+       <property name="frameShadow">
-        <font>
+        <enum>QFrame::Shadow::Plain</enum>
-         <family>Courier New</family>
+       </property>
-         <bold>false</bold>
+       <property name="verticalScrollBarPolicy">
-        </font>
+        <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="readOnly">
+       <property name="openExternalLinks">
         <bool>true</bool>
        </property>
-       <property name="textInteractionFlags">
+       <property name="openLinks">
-        <set>Qt::TextInteractionFlag::TextBrowserInteraction</set>
+        <bool>true</bool>
        </property>
       </widget>
      </item>

src/gui/resources/ui/ALConfigWidget.ui

@@ -94,19 +94,19 @@
          </property>
          <layout class="QVBoxLayout" name="UserListLayout">
           <property name="spacing">
-           <number>0</number>
+           <number>5</number>
           </property>
           <property name="leftMargin">
-           <number>5</number>
+           <number>3</number>
           </property>
           <property name="topMargin">
-           <number>5</number>
+           <number>3</number>
           </property>
           <property name="rightMargin">
-           <number>5</number>
+           <number>3</number>
           </property>
           <property name="bottomMargin">
-           <number>5</number>
+           <number>3</number>
           </property>
           <item>
            <widget class="QTreeWidget" name="UserTreeWidget">
@@ -178,6 +178,9 @@
           </item>
           <item>
            <layout class="QHBoxLayout" name="UserListControlLayout">
+            <property name="spacing">
+             <number>5</number>
+            </property>
             <item>
              <widget class="QPushButton" name="DelUserButton">
               <property name="minimumSize">
@@ -192,6 +195,11 @@
                 <height>25</height>
                </size>
               </property>
+              <property name="styleSheet">
+               <string notr="true">QPushButton {
+	color: #DC0000;
+}</string>
+              </property>
               <property name="text">
                <string>删除用户</string>
               </property>
@@ -309,7 +317,7 @@
              <item row="2" column="1">
               <layout class="QHBoxLayout" name="PasswordLayout">
                <property name="spacing">
-                <number>0</number>
+                <number>5</number>
                </property>
                <item>
                 <widget class="QLineEdit" name="PasswordEdit">
@@ -546,7 +554,7 @@
              <item row="4" column="4">
               <layout class="QHBoxLayout" name="SeatIDLayout">
                <property name="spacing">
-                <number>0</number>
+                <number>5</number>
                </property>
                <item>
                 <widget class="QLineEdit" name="SeatIDEdit">
@@ -703,7 +711,7 @@
              <item row="10" column="4">
               <layout class="QHBoxLayout" name="EndTimeDiffLayout">
                <property name="spacing">
-                <number>0</number>
+                <number>5</number>
                </property>
                <item>
                 <widget class="QSpinBox" name="MaxEndTimeDiffSpinBox">
@@ -899,13 +907,13 @@
              <item row="7" column="4">
               <layout class="QHBoxLayout" name="BeginTimeDiffLayout">
                <property name="spacing">
-                <number>0</number>
+                <number>5</number>
                </property>
                <item>
                 <widget class="QSpinBox" name="MaxBeginTimeDiffSpinBox">
                  <property name="minimumSize">
                   <size>
-                   <width>65</width>
+                   <width>55</width>
                    <height>25</height>
                   </size>
                  </property>
@@ -1049,10 +1057,23 @@
              <item row="15" column="4">
               <layout class="QHBoxLayout" name="RenewTimeDiffLayout">
                <property name="spacing">
-                <number>0</number>
+                <number>5</number>
                </property>
                <item>
-                <widget class="QSpinBox" name="MaxRenewTimeDiffSpinBox"/>
+                <widget class="QSpinBox" name="MaxRenewTimeDiffSpinBox">
+                 <property name="minimumSize">
+                  <size>
+                   <width>55</width>
+                   <height>25</height>
+                  </size>
+                 </property>
+                 <property name="maximumSize">
+                  <size>
+                   <width>16777215</width>
+                   <height>25</height>
+                  </size>
+                 </property>
+                </widget>
                </item>
                <item>
                 <widget class="QCheckBox" name="PreferLateRenewTimeCheckBox">
@@ -1079,7 +1100,7 @@
               </layout>
              </item>
              <item row="15" column="1">
-              <widget class="QLabel" name="label">
+              <widget class="QLabel" name="MaxRenewTimeDiffLabel">
                <property name="minimumSize">
                 <size>
                  <width>80</width>
@@ -1140,10 +1161,10 @@
           <property name="rightMargin">
            <number>3</number>
           </property>
-          <property name="horizontalSpacing">
+          <property name="bottomMargin">
            <number>3</number>
           </property>
-          <property name="verticalSpacing">
+          <property name="spacing">
            <number>5</number>
           </property>
           <item row="0" column="0" colspan="2">
@@ -1340,7 +1361,7 @@
                </size>
               </property>
               <property name="toolTip">
-               <string>&lt;html&gt;&lt;head/&gt;&lt;body&gt;&lt;p&gt;详情请参阅 &lt;a href=&quot;https://www.autolibrary.cv/docs/manual_lists.html&quot;&gt;&lt;span style=&quot; text-decoration: underline; color:#69fcff;&quot;&gt;用户手册&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;&lt;/body&gt;&lt;/html&gt;</string>
+               <string>&lt;html&gt;&lt;head/&gt;&lt;body&gt;&lt;p&gt;详情请参阅 &lt;a href=&quot;https://www.autolibrary.kenanzhu.com/manuals&quot;&gt;&lt;span style=&quot; text-decoration: underline; color:#69fcff;&quot;&gt;用户手册&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;&lt;/body&gt;&lt;/html&gt;</string>
               </property>
               <property name="whatsThis">
                <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>
@@ -1636,6 +1657,21 @@
           <string>当前配置</string>
          </property>
          <layout class="QGridLayout" name="CurrentConfigLayout">
+          <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="1" column="0">
            <widget class="QLineEdit" name="CurrentRunConfigEdit">
             <property name="minimumSize">
@@ -1762,6 +1798,21 @@
           <string>导出路径</string>
          </property>
          <layout class="QGridLayout" name="ExportConfigLayout">
+          <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="3" column="0">
            <widget class="QLineEdit" name="ExportUserConfigEdit">
             <property name="minimumSize">

src/gui/resources/ui/ALMainWindow.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>
@@ -51,7 +51,7 @@
        <number>5</number>
       </property>
       <item>
-       <widget class="QPushButton" name="TimerTaskWidgetButton">
+       <widget class="QPushButton" name="TimerTaskManageWidgetButton">
         <property name="minimumSize">
          <size>
           <width>25</width>
@@ -156,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);
+         <string notr="true">background-color: #0AAA0A;
-font: 12pt &quot;Microsoft YaHei UI&quot;;
+color: #FFFFFF;
-color: rgb(255, 255, 255);
+font: 700 9pt;</string>
-font: 9pt &quot;Segoe UI&quot;;
-font: 700 9pt &quot;Microsoft YaHei UI&quot;;</string>
         </property>
         <property name="text">
          <string>启动脚本</string>

src/gui/resources/ui/ALTimerTaskAddDialog.ui

@@ -0,0 +1,496 @@
+<?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>350</width>
+    <height>400</height>
+   </rect>
+  </property>
+  <property name="minimumSize">
+   <size>
+    <width>350</width>
+    <height>400</height>
+   </size>
+  </property>
+  <property name="maximumSize">
+   <size>
+    <width>350</width>
+    <height>500</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="1" column="0">
+       <widget class="QRadioButton" name="SilentlyRunRadioButton">
+        <property name="minimumSize">
+         <size>
+          <width>0</width>
+          <height>25</height>
+         </size>
+        </property>
+        <property name="maximumSize">
+         <size>
+          <width>16777215</width>
+          <height>25</height>
+         </size>
+        </property>
+        <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="2" column="0">
+       <widget class="QRadioButton" name="ShowBeforeRunRadioButton">
+        <property name="minimumSize">
+         <size>
+          <width>0</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 row="0" column="0">
+       <widget class="QGroupBox" name="RepeatConfigGroupBox">
+        <property name="title">
+         <string>重复运行</string>
+        </property>
+        <layout class="QVBoxLayout" name="RepeatConfigLayout" stretch="1,1,1">
+         <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>
+          <widget class="QCheckBox" name="RepeatCheckBox">
+           <property name="minimumSize">
+            <size>
+             <width>0</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="QLabel" name="label">
+           <property name="minimumSize">
+            <size>
+             <width>0</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>
+          <layout class="QGridLayout" name="RepeatCheckBoxLayout" rowstretch="10,10" columnstretch="0,0,0,0" rowminimumheight="25,25">
+           <property name="spacing">
+            <number>0</number>
+           </property>
+           <item row="0" column="3">
+            <widget class="QCheckBox" name="ThuCheckBox">
+             <property name="enabled">
+              <bool>false</bool>
+             </property>
+             <property name="minimumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="maximumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="text">
+              <string>周四</string>
+             </property>
+            </widget>
+           </item>
+           <item row="0" column="2">
+            <widget class="QCheckBox" name="WedCheckBox">
+             <property name="enabled">
+              <bool>false</bool>
+             </property>
+             <property name="minimumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="maximumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="text">
+              <string>周三</string>
+             </property>
+            </widget>
+           </item>
+           <item row="0" column="0">
+            <widget class="QCheckBox" name="MonCheckBox">
+             <property name="enabled">
+              <bool>false</bool>
+             </property>
+             <property name="minimumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="maximumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="text">
+              <string>周一</string>
+             </property>
+            </widget>
+           </item>
+           <item row="0" column="1">
+            <widget class="QCheckBox" name="TueCheckBox">
+             <property name="enabled">
+              <bool>false</bool>
+             </property>
+             <property name="minimumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="maximumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="text">
+              <string>周二</string>
+             </property>
+            </widget>
+           </item>
+           <item row="1" column="0">
+            <widget class="QCheckBox" name="FriCheckBox">
+             <property name="enabled">
+              <bool>false</bool>
+             </property>
+             <property name="minimumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="maximumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="text">
+              <string>周五</string>
+             </property>
+            </widget>
+           </item>
+           <item row="1" column="1">
+            <widget class="QCheckBox" name="SatCheckBox">
+             <property name="enabled">
+              <bool>false</bool>
+             </property>
+             <property name="minimumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="maximumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="text">
+              <string>周六</string>
+             </property>
+            </widget>
+           </item>
+           <item row="1" column="2">
+            <widget class="QCheckBox" name="SunCheckBox">
+             <property name="enabled">
+              <bool>false</bool>
+             </property>
+             <property name="minimumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="maximumSize">
+              <size>
+               <width>50</width>
+               <height>25</height>
+              </size>
+             </property>
+             <property name="text">
+              <string>周日</string>
+             </property>
+            </widget>
+           </item>
+          </layout>
+         </item>
+        </layout>
+       </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>

src/gui/resources/ui/ALTimerTaskManageWidget.ui

@@ -1,31 +1,31 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <ui version="4.0">
- <class>ALTimerTaskWidget</class>
+ <class>ALTimerTaskManageWidget</class>
- <widget class="QWidget" name="ALTimerTaskWidget">
+ <widget class="QWidget" name="ALTimerTaskManageWidget">
   <property name="geometry">
    <rect>
     <x>0</x>
     <y>0</y>
-    <width>400</width>
+    <width>500</width>
     <height>400</height>
    </rect>
   </property>
   <property name="minimumSize">
    <size>
-    <width>400</width>
+    <width>500</width>
     <height>400</height>
    </size>
   </property>
   <property name="maximumSize">
    <size>
-    <width>600</width>
+    <width>800</width>
     <height>400</height>
    </size>
   </property>
   <property name="windowTitle">
-   <string>定时任务 - AutoLibrary</string>
+   <string>定时任务管理 - AutoLibrary</string>
   </property>
-  <layout class="QVBoxLayout" name="ALTimerTaskWidgetLayout">
+  <layout class="QVBoxLayout" name="ALTimerTaskManageWidgetLayout">
    <property name="spacing">
     <number>5</number>
    </property>
@@ -153,7 +153,7 @@
        </property>
        <property name="styleSheet">
         <string notr="true">QLabel {
-	color: #FF5722
+	color: #DC0000
 }</string>
        </property>
        <property name="text">
@@ -306,6 +306,11 @@
          <height>25</height>
         </size>
        </property>
+       <property name="styleSheet">
+        <string notr="true">QPushButton {
+	color: #DC0000;
+}</string>
+       </property>
        <property name="text">
         <string>清除全部</string>
        </property>

src/operators/AutoLib.py

@@ -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,6 +11,7 @@ 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
@@ -26,8 +27,6 @@ from operators.LibReserve import LibReserve
 from operators.LibCheckin import LibCheckin
 from operators.LibRenew import LibRenew
 
-from utils.ConfigReader import ConfigReader
-
 
 class AutoLib(MsgBase):
 
@@ -43,10 +42,11 @@ class AutoLib(MsgBase):
         self.__user_config = None
         self.__driver = None
         if not self.__initBrowserDriver():
-            raise Exception("浏览器驱动初始化失败")
+            raise Exception("浏览器驱动初始化失败 !")
         else:
             if not self.__initDriverUrl():
-                raise Exception("浏览器驱动URL初始化失败")
+                self.close()
+                raise Exception("浏览器驱动URL初始化失败 !")
             self.__initLibOperators()
 
 
@@ -66,7 +66,8 @@ class AutoLib(MsgBase):
             case "firefox":
                 driver_options = webdriver.FirefoxOptions()
             case _:
-                raise Exception(f"不支持的浏览器驱动类型: {self.__driver_type} !")
+                self._showTrace(f"不支持的浏览器驱动类型: {self.__driver_type} !")
+                return False
 
         if not web_driver_config:
             self._showTrace("未配置浏览器驱动参数 !")
@@ -109,7 +110,8 @@ class AutoLib(MsgBase):
         # init browser driver
         self.__driver_path = web_driver_config.get("driver_path")
         if not self.__driver_path:
-            raise Exception(f"未配置浏览器驱动路径 !")
+            self._showTrace("未配置浏览器驱动路径 !")
+            return False
         self.__driver_path = os.path.abspath(self.__driver_path)
         try:
             service = None
@@ -124,7 +126,8 @@ class AutoLib(MsgBase):
                     self._showTrace(f"Firefox 浏览器驱动初始化略慢, 请耐心等待...")
                     service = FirefoxService(executable_path=self.__driver_path)
                     self.__driver = webdriver.Firefox(service=service, options=driver_options)
-                case _:
+                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(
@@ -185,10 +188,16 @@ class AutoLib(MsgBase):
 
         lib_config = self.__run_config.get("library", None)
         if not lib_config:
-            self._showError("未配置图书馆参数 !")
+            self._showTrace("未配置图书馆参数 !")
             return False
         url = lib_config.get("host_url") + lib_config.get("login_url")
-        self.__driver.get(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
@@ -214,9 +223,7 @@ class AutoLib(MsgBase):
             login_config.get("auto_captcha", True),
         ):
             return 1
-        """
+        # Here, we collect the run mode from the run config.
-            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,
@@ -234,7 +241,7 @@ class AutoLib(MsgBase):
                 self._showTrace(f"用户 {username} 无法预约，已跳过")
                 result = 2
         # checkin
-        if run_mode["auto_checkin"] and result == 2:
+        if run_mode["auto_checkin"] and result != 1:
             if self.__lib_checker.canCheckin():
                 if self.__lib_checkin.checkin(username):
                     result = 0
@@ -244,8 +251,9 @@ class AutoLib(MsgBase):
                 self._showTrace(f"用户 {username} 无法签到，已跳过")
                 result = 2
         # renewal
-        if run_mode["auto_renewal"] and result == 2:
+        if run_mode["auto_renewal"] and result != 1:
-            if record := self.__lib_checker.canRenew():
+            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

src/operators/LibChecker.py

@@ -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,26 +326,27 @@ 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
+            Check if the renew operation is successful
 
-        Args:
+            Args:
-            record (dict): The expected record after renewal
+                record (dict): The expected record after renewal
 
-        Returns:
+            Returns:
-            bool: True if the renew operation is successful, False otherwise
+                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,

src/operators/LibCheckin.py

@@ -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)
@@ -89,6 +88,31 @@ class LibCheckin(LibOperator):
             return False
 
 
+    def __enableCheckinBtn(
+        self
+    ) -> bool:
+
+        script = """
+        try {
+            var checkin_btn = document.getElementById('btnCheckIn');
+            if (checkin_btn) {
+                checkin_btn.classList.remove('disabled');
+                return true;
+            }
+            return false;
+        } catch (e) {
+            return false;
+        }
+        """
+        result = self.__driver.execute_script(script)
+        time.sleep(0.1)
+        if result:
+            self._showTrace("签到按钮已启用")
+        else:
+            self._showTrace("签到按钮启用失败")
+        return result
+
+
     def checkin(
         self,
         username: str
@@ -105,8 +129,10 @@ class LibCheckin(LibOperator):
             self._showTrace(f"用户 {username} 签到界面加载失败 !")
             return False
         if "disabled" in checkin_btn.get_attribute("class"):
-            self._showTrace("签到按钮不可用, 可能不在场馆内, 请连接图书馆网络后重试")
+            self._showTrace("签到按钮不可用, 可能不在场馆内, 正在尝试启用......")
-            return False
+            if not self.__enableCheckinBtn():
+                self._showTrace(f"签到按钮启用失败 !")
+                return False
         checkin_btn.click()
         if self._waitResponseLoad():
             self._showTrace(f"用户 {username} 签到成功 !")

src/operators/LibCheckout.py

@@ -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)

src/operators/LibLogin.py

@@ -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)

src/operators/LibLogout.py

@@ -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.chrome.webdriver import WebDriver
-from selenium.webdriver.support import expected_conditions as EC
 
 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)

src/operators/LibRenew.py

@@ -1,31 +1,29 @@
 # -*- 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
 
-from base.LibOperator import LibOperator
+from base.LibTimeSelector import LibTimeSelector
 
 
-class LibRenew(LibOperator):
+class LibRenew(LibTimeSelector):
 
     def __init__(
         self,
         input_queue: queue.Queue,
         output_queue: queue.Queue,
-        driver: any
+        driver: WebDriver
     ):
 
         super().__init__(input_queue, output_queue)
@@ -40,22 +38,6 @@ class LibRenew(LibOperator):
         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
@@ -96,87 +78,92 @@ class LibRenew(LibOperator):
         return True
 
 
-    def __selectNearstTime(
+    def __selectNearestTime(
         self,
         record: dict,
         reserve_info: dict
     ) -> bool:
 
         """
-            TODO : this function is too long and too ugly
+            Select the nearest available renewal time.
-
-            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
+        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:
+        # Validate and adjust target renew time to library closing time
-                self._showTrace("当前未查询到可用续约时间 !")
+        if not self.__validateAndAdjustRenewTime(end_time, target_renew_mins):
-                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
+        renew_ok_btn = self.__driver.find_element(By.CSS_SELECTOR, "#extendDiv .btnOK")
+        renew_time_opts = self.__driver.find_elements(By.CSS_SELECTOR, "#extendDiv .renewal_List li")
+        if not renew_time_opts:
+            self._showTrace("当前未查询到可用续约时间 !")
+            return False
+
+        # Find best renewal time option
+        best_opt, best_text, actual_diff, free_times = self._findBestTimeOption(
+            renew_time_opts, target_renew_mins, max_diff, prefer_earlier, is_reserve=False
+        )
+        if best_opt is not None:
+            return self.__confirmRenewal(best_opt, best_text, actual_diff, record, renew_ok_btn)
+        self._showTrace(
+            "无法选择最近的可用续约时间 ! "
+            f"所有可选时间与目标时间相差都超过了 {max_diff} 分钟 !"
+        )
+        self._showTrace(f"当前可供续约的时间有: {free_times}")
+        return False
+
+
+    def __validateAndAdjustRenewTime(
+        self,
+        end_time: str,
+        target_renew_mins: int
+    ) -> bool:
+
+        """
+            Validate and adjust renewal time to library closing time if needed.
+        """
+        LIBRARY_CLOSE_TIME = 1410  # 23:30 in minutes
+        if target_renew_mins > LIBRARY_CLOSE_TIME:
+            actual_renew_duration = LIBRARY_CLOSE_TIME - self._timeToMins(end_time)
+            if actual_renew_duration <= 0:
+                self._showTrace(f"当前结束时间 {end_time} 已接近闭馆时间，无法续约 !")
+                return False
+            self._showTrace(
+                f"续约时间已调整至闭馆时间 {self._minsToTime(LIBRARY_CLOSE_TIME)}，"
+                f"实际续约时长为 {actual_renew_duration//60} 小时 {actual_renew_duration%60} 分钟"
+            )
+            return True
+        return True
+
+
+    def __confirmRenewal(
+        self,
+        best_opt,
+        best_text: str,
+        actual_diff: int,
+        record: dict,
+        ok_btn
+    ) -> bool:
+
+        """
+            Confirm the selected renewal time.
+        """
+        try:
+            best_opt.click()
+            abs_diff = abs(actual_diff)
+            time_relation = self._formatTimeRelation(abs_diff, actual_diff, "续约时间")
+            self._showTrace(
+                f"选择距离期望续约时间最近的 {best_text}, "
+                f"与期望续约时间相比 {time_relation}"
+            )
+            record["time"]["end"] = best_text.strip()
+            ok_btn.click()
+            return True
         except:
-            self._showTrace("查询可用续约时间时发生未知错误 !")
+            self._showTrace("确认续约时发生错误 !")
             return False
 
 
@@ -205,10 +192,10 @@ class LibRenew(LibOperator):
             self._showTrace(f"用户 {username} 续约失败 !")
 
             # After the renewal, the webpage will display a mask overlay,
-            #  so we need to refresh the page for subsequent operations.
+            # so we need to refresh the page for subsequent operations.
             self.__driver.refresh()
             return False
-        if not self.__selectNearstTime(record, reserve_info):
+        if not self.__selectNearestTime(record, reserve_info):
             self._showTrace(f"用户 {username} 续约失败 !")
             self.__driver.refresh()
             return False

src/operators/LibReserve.py

@@ -1,31 +1,30 @@
 # -*- 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
 
-from base.LibOperator import LibOperator
+from base.LibTimeSelector import LibTimeSelector
 
 
-class LibReserve(LibOperator):
+class LibReserve(LibTimeSelector):
 
     def __init__(
         self,
         input_queue: queue.Queue,
         output_queue: queue.Queue,
-        driver: any
+        driver: WebDriver
     ):
 
         super().__init__(input_queue, output_queue)
@@ -40,12 +39,12 @@ class LibReserve(LibOperator):
         }
         self.__room_map = {
             "1": "二层内环",
-            "2": "二层外环",
+            "2": "二层西区",
             "3": "三层内环",
             "4": "三层外环",
             "5": "四层内环",
             "6": "四层外环",
-            "7": "四层期刊区",
+            "7": "四层期刊",
             "8": "五层考研"
         }
 
@@ -100,22 +99,6 @@ class LibReserve(LibOperator):
             self._showTrace(f"预约结果加载失败 !")
             return False
 
-    @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 __containRequiredInfo(
         self,
@@ -207,10 +190,10 @@ class LibReserve(LibOperator):
         if reserve_info.get("end_time") is None:
             reserve_info["end_time"] = {}
         if "time" not in reserve_info["end_time"]:
-            end_mins = self.__timeToMins(reserve_info["begin_time"]["time"])
+            end_mins = self._timeToMins(reserve_info["begin_time"]["time"])
             end_mins = end_mins + int(reserve_info["expect_duration"]*60)
             reserve_info["end_time"] = {
-                "time": self.__minsToTime(end_mins),
+                "time": self._minsToTime(end_mins),
                 "max_diff": 30,
                 "prefer_early": False
             }
@@ -232,8 +215,8 @@ class LibReserve(LibOperator):
     ):
 
         begin_time, end_time = reserve_info["begin_time"], reserve_info["end_time"]
-        begin_mins = self.__timeToMins(begin_time["time"])
+        begin_mins = self._timeToMins(begin_time["time"])
-        end_mins = self.__timeToMins(end_time["time"])
+        end_mins = self._timeToMins(end_time["time"])
         # if end time is earlier than begin_time, exchange them
         if end_mins < begin_mins:
             self._showTrace(
@@ -242,15 +225,15 @@ class LibReserve(LibOperator):
             reserve_info["end_time"] = begin_time
             reserve_info["begin_time"] = end_time
             begin_time, end_time = reserve_info["begin_time"], reserve_info["end_time"]
-            begin_mins = self.__timeToMins(begin_time["time"])
+            begin_mins = self._timeToMins(begin_time["time"])
-            end_mins = self.__timeToMins(end_time["time"])
+            end_mins = self._timeToMins(end_time["time"])
         # ensure the end time is not later than 23:30
-        if end_mins > self.__timeToMins("23:30"):
+        if end_mins > self._timeToMins("23:30"):
             self._showTrace(
                 f"结束时间 {end_time['time']} 晚于 23:30, 自动设置为 23:30"
             )
             reserve_info["end_time"]["time"] = "23:30"
-            end_mins = self.__timeToMins("23:30")
+            end_mins = self._timeToMins("23:30")
         # ensure the duration is not longer than 8 hours
         if reserve_info["satisfy_duration"]:
             if reserve_info["expect_duration"] > 8:
@@ -267,7 +250,7 @@ class LibReserve(LibOperator):
                     f"{float((end_mins - begin_mins)/60)} 小时 "
                     f"超出最大时长 8 小时, 自动设置为 8 小时"
                 )
-                reserve_info["end_time"]["time"] = self.__minsToTime(begin_mins + 8*60)
+                reserve_info["end_time"]["time"] = self._minsToTime(begin_mins + 8*60)
         return True
 
 
@@ -496,6 +479,10 @@ class LibReserve(LibOperator):
         prefer_earlier: bool = True
     ) -> int:
 
+        """
+            Select the nearest available time option.
+        """
+        # Wait for time options to load
         try:
             WebDriverWait(self.__driver, 2).until(
                 EC.presence_of_all_elements_located(
@@ -505,67 +492,34 @@ class LibReserve(LibOperator):
         except:
             self._showTrace(f"{time_type} 选择失败 ! : 当前未查询到可用时间")
             return -1
-        try:
-            all_time_opts = self.__driver.find_elements(
-                By.CSS_SELECTOR,
-                f"#{time_id} ul li a"
-            )
-            free_times = []
-            best_time_diff = max_time_diff
-            best_actual_diff = None
-            best_time_opt = None
 
-            if not all_time_opts:
+        # Find best time option
-                self._showTrace(f"{time_type} 选择失败 ! : 当前未查询到可用时间")
+        all_time_opts = self.__driver.find_elements(
-                return -1
+            By.CSS_SELECTOR,
-            for time_opt in all_time_opts:
+            f"#{time_id} ul li a"
-                time_attr = time_opt.get_attribute("time")
+        )
-                if time_attr == "now":
+        if not all_time_opts:
-                    now = datetime.now()
+            self._showTrace(f"{time_type} 选择失败 ! : 当前未查询到可用时间")
-                    time_val = int(now.hour*60 + now.minute)
+            return -1
-                elif time_attr and time_attr.isdigit():
+        best_opt, best_text, actual_diff, free_times = self._findBestTimeOption(
-                    time_val = int(time_attr)
+            all_time_opts, target_time, max_time_diff, prefer_earlier, is_reserve=True
-                else:
+        )
-                    continue
+        if best_opt is not None:
-                free_times.append(self.__minsToTime(time_val))
+            best_opt.click()
-                actual_diff = time_val - target_time
+            abs_diff = abs(actual_diff)
-                abs_diff = abs(actual_diff)
+            time_relation = self._formatTimeRelation(abs_diff, actual_diff, time_type)
-                if abs_diff < best_time_diff or (
+            target_time += actual_diff
-                    abs_diff == best_time_diff and (
-                        # prefer earlier time
-                        (prefer_earlier and actual_diff <= 0) or
-                        # prefer later time
-                        (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"正好等于 {time_type}"
-                target_time += best_actual_diff
-                self._showTrace(
-                    f"选择距离期望 {time_type} 最近的 {best_time_opt.text}, "\
-                    f"与期望 {time_type} 相比 {time_relation}"
-                )
-                return target_time
             self._showTrace(
-                f"无法选择最近的 {time_type} {self.__minsToTime(target_time)}, "\
+                f"选择距离期望 {time_type} 最近的 {best_text}, "
-                f"所有可选时间与目标时间相差都超过 {max_time_diff} 分钟"
+                f"与期望 {time_type} 相比 {time_relation}"
             )
-            self._showTrace(f"当前可供预约的 {time_type} 有: {free_times}")
+            return target_time
-            return -1
+        self._showTrace(
-        except:
+            f"无法选择最近的 {time_type} {self._minsToTime(target_time)}, "
-            self._showTrace(f"{time_type} {self.__minsToTime(target_time)} 选择失败 !")
+            f"所有可选时间与目标时间相差都超过 {max_time_diff} 分钟"
-            return -1
+        )
+        self._showTrace(f"当前可供预约的 {time_type} 有: {free_times}")
+        return -1
 
 
     def __selectSeatTime(
@@ -576,40 +530,35 @@ class LibReserve(LibOperator):
         satisfy_duration: bool = True
     ) -> bool:
 
+        """Select seat begin and end time."""
         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)
+        expect_begin_mins = self._timeToMins(expect_begin_time)
         actual_begin_mins = expect_begin_mins
-        expect_end_mins = self.__timeToMins(expect_end_time)
+        expect_end_mins = self._timeToMins(expect_end_time)
 
-        # select the begin time
+        # Select begin time
         if self.__selectNearestTime(
-            time_id="startTime", # dont change into begin, this is the element in the page
+            time_id="startTime",
             time_type="开始时间",
             target_time=expect_begin_mins,
             max_time_diff=begin_time["max_diff"],
             prefer_earlier=begin_time["prefer_early"]
         ) == -1:
             return False
-        else:
+        actual_begin_time = self._minsToTime(expect_begin_mins)
-            actual_begin_time = self.__minsToTime(expect_begin_mins)
+        actual_begin_mins = self._timeToMins(actual_begin_time)
-            actual_begin_mins = self.__timeToMins(actual_begin_time)
+
-        # if 'satisfy_duration' is True.
+        # If 'satisfy_duration' is True, select end time based on actual begin time
-        # 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(actual_begin_mins + expct_duration*60)
+            expect_end_mins = self.validateAndAdjustEndTime(actual_begin_mins, expct_duration)
-            if expect_end_mins > self.__timeToMins("23:30"):
+            expect_end_time = self._minsToTime(expect_end_mins)
-                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"需要满足期望预约持续时间: {expct_duration} 小时, "
-                f"根据开始时间 {actual_begin_time} 计算结束时间: {self.__minsToTime(expect_end_mins)}"
+                f"根据开始时间 {actual_begin_time} 计算结束时间: {expect_end_time}"
             )
-        # select the end time
+
+        # Select end time
         if self.__selectNearestTime(
             time_id="endTime",
             time_type="结束时间",
@@ -618,8 +567,7 @@ class LibReserve(LibOperator):
             prefer_earlier=end_time["prefer_early"]
         ) == -1:
             return False
-        else:
+        actual_end_time = self._minsToTime(expect_end_mins)
-            actual_end_time = self.__minsToTime(expect_end_mins)
         self._showTrace(
             f"期望预约时间段: {expect_begin_time} - {expect_end_time}, "
             f"实际预约时间段: {actual_begin_time} - {actual_end_time}"
@@ -627,6 +575,25 @@ class LibReserve(LibOperator):
         return True
 
 
+    def validateAndAdjustEndTime(
+        self,
+        begin_mins: int,
+        duration: int
+    ) -> int:
+
+        """
+            Validate and adjust reserve end time to library closing time if needed.
+        """
+        LIBRARY_CLOSE_TIME = self._timeToMins("23:30")
+        expect_end_mins = begin_mins + duration * 60
+        if expect_end_mins > LIBRARY_CLOSE_TIME:
+            expect_end_mins = LIBRARY_CLOSE_TIME
+            self._showTrace(
+                f"预约持续时间 {duration} 小时, 超过最大预约时间 23:30, 自动调整为 23:30"
+            )
+        return expect_end_mins
+
+
     def reserve(
         self,
         username: str,

src/operators/__init__.py

@@ -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.
 """

src/utils/ConfigManager.py

@@ -0,0 +1,244 @@
+# -*- 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 configDir(
+        self
+    ) -> str:
+
+        return self.__config_dir
+
+
+# ConfigManager singleton instance.
+_config_manager_instance = None
+
+# Utility functions.
+#
+# Utility function to get validated automation config paths.
+def getValidateAutomationConfigPaths(
+) -> dict:
+    """
+        Get validated automation config paths from ConfigManager instance.
+        These function will validate the config paths and return the validated paths in a dict.
+
+        Returns:
+            dict: Validated automation config paths.
+    """
+    config_paths = {"run": "", "user": ""}
+    auto_config = _config_manager_instance.get(ConfigType.GLOBAL, "automation", {})
+    for cfg_type in ["run", "user"]:
+            paths = auto_config.get(f"{cfg_type}_path", {}).get("paths", [])
+            index = auto_config.get(f"{cfg_type}_path", {}).get("current", 0)
+            if paths == []:
+                paths.append(os.path.join(_config_manager_instance.configDir(), f"{cfg_type}.json"))
+            if index < 0:
+                index = 0
+            if index >= len(paths):
+                index = len(paths) - 1
+            config_paths[cfg_type] = paths[index]
+            data = {"current": index, "paths": paths}
+            auto_config[f"{cfg_type}_path"] = data
+    _config_manager_instance.set(ConfigType.GLOBAL, "automation", auto_config)
+    return config_paths
+
+# Utility function to get base config directory.
+def getBaseConfigDir(
+) -> str:
+    """
+        Get base config directory, on Windows, it is usually at :
+            'C:\\Users\\<username>\\AppData\\Local\\AutoLibrary\\config'.
+
+        Returns:
+            str: Base config directory.
+    """
+
+    return _config_manager_instance.configDir()
+
+# 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 getBaseConfigDir() != config_dir:
+                raise ValueError(
+                    "ConfigManager 的实例已初始化，不能使用不同的配置目录。")
+    return _config_manager_instance

src/utils/ConfigReader.py

@@ -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

src/utils/ConfigWriter.py

@@ -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

src/utils/JSONReader.py

@@ -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

src/utils/JSONWriter.py

@@ -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

src/utils/TimerUtils.py

@@ -0,0 +1,50 @@
+# -*- 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 datetime import datetime, timedelta
+
+
+def calculateNextRepeatTime(
+    repeat_days: list,
+    hour: int,
+    minute: int,
+    second: int
+) -> datetime:
+    """
+        Calculate the next repeat time based on repeat days and target time.
+
+        This function calculates the next execution time for a repeatable task.
+        If the current day is in repeat_days and the target time has not passed,
+        it returns today's target time. Otherwise, it finds the next matching day.
+
+        Args:
+            repeat_days (list): List of weekdays to repeat (0=Monday, 6=Sunday).
+            hour (int): Target hour (0-23).
+            minute (int): Target minute (0-59).
+            second (int): Target second (0-59).
+
+        Returns:
+            datetime: The next repeat execution time.
+    """
+
+    current_time = datetime.now()
+    current_weekday = current_time.weekday()
+    target_time = current_time.replace(hour=hour, minute=minute, second=second, microsecond=0)
+    if current_weekday in repeat_days:
+        if target_time > current_time:
+            return target_time
+    repeat_days_sorted = sorted(repeat_days)
+    for day in repeat_days_sorted:
+        if day > current_weekday:
+            days_until = day - current_weekday
+            next_time = target_time + timedelta(days=days_until)
+            return next_time
+    days_until = 7 - current_weekday + repeat_days_sorted[0]
+    next_time = target_time + timedelta(days=days_until)
+    return next_time

src/utils/__init__.py

@@ -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.
+    - ConfigManager: Configuration manager class for the AutoLibrary project.
-    - ConfigWriter: Configuration writer class for the AutoLibrary project.
+    - JSONReader: JSON reader class for the AutoLibrary project.
+    - JSONWriter: JSON writer class for the AutoLibrary project.
 """

templates/configs/readme.md

@@ -0,0 +1 @@
+This folder is used to store the template config files.

templates/configs/run.json

@@ -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
+    }
+}

templates/configs/user.json

@@ -0,0 +1,3 @@
+{
+    "groups": []
+}

templates/readme.md

@@ -0,0 +1,6 @@
+This folder is used to store the template files.
+
+Directory structure:
+
+    templates
+    |─── configs // template config files