Merge branch 'hicccc77:main' into main

.github/scripts/release-utils.sh

@@ -0,0 +1,212 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+retry_cmd() {
+  local attempts="$1"
+  local delay_seconds="$2"
+  shift 2
+
+  local i
+  local exit_code
+  for ((i = 1; i <= attempts; i++)); do
+    if "$@"; then
+      return 0
+    fi
+    exit_code=$?
+    if [ "$i" -lt "$attempts" ]; then
+      echo "Command failed (attempt $i/$attempts, exit=$exit_code): $*" >&2
+      echo "Retrying in ${delay_seconds}s..." >&2
+      sleep "$delay_seconds"
+    fi
+  done
+
+  echo "Command failed after $attempts attempts: $*" >&2
+  return "$exit_code"
+}
+
+capture_cmd_with_retry() {
+  local result_var="$1"
+  local attempts="$2"
+  local delay_seconds="$3"
+  shift 3
+
+  local i
+  local output=""
+  local exit_code=1
+  for ((i = 1; i <= attempts; i++)); do
+    if output="$("$@" 2>/dev/null)"; then
+      printf -v "$result_var" "%s" "$output"
+      return 0
+    fi
+    exit_code=$?
+    if [ "$i" -lt "$attempts" ]; then
+      echo "Capture command failed (attempt $i/$attempts, exit=$exit_code): $*" >&2
+      echo "Retrying in ${delay_seconds}s..." >&2
+      sleep "$delay_seconds"
+    fi
+  done
+
+  echo "Capture command failed after $attempts attempts: $*" >&2
+  return "$exit_code"
+}
+
+wait_for_release_id() {
+  local repo="$1"
+  local tag="$2"
+  local attempts="${3:-12}"
+  local delay_seconds="${4:-2}"
+
+  local i
+  local release_id
+  for ((i = 1; i <= attempts; i++)); do
+    release_id="$(gh api "repos/$repo/releases/tags/$tag" --jq '.id' 2>/dev/null || true)"
+    if [[ "$release_id" =~ ^[0-9]+$ ]]; then
+      echo "$release_id"
+      return 0
+    fi
+    if [ "$i" -lt "$attempts" ]; then
+      echo "Release id for tag '$tag' is not ready yet (attempt $i/$attempts), retrying in ${delay_seconds}s..." >&2
+      sleep "$delay_seconds"
+    fi
+  done
+
+  echo "Unable to fetch release id for tag '$tag' after $attempts attempts." >&2
+  gh api "repos/$repo/releases/tags/$tag" --jq '{draft: .draft, prerelease: .prerelease, url: .html_url}' 2>/dev/null || true
+  return 1
+}
+
+settle_release_state() {
+  local repo="$1"
+  local release_id="$2"
+  local tag="$3"
+  local attempts="${4:-12}"
+  local delay_seconds="${5:-2}"
+  local endpoint="repos/$repo/releases/tags/$tag"
+
+  local i
+  local draft_state
+  local prerelease_state
+  for ((i = 1; i <= attempts; i++)); do
+    gh api --method PATCH "repos/$repo/releases/$release_id" -F draft=false -F prerelease=true >/dev/null 2>&1 || true
+    draft_state="$(gh api "$endpoint" --jq '.draft' 2>/dev/null || echo true)"
+    prerelease_state="$(gh api "$endpoint" --jq '.prerelease' 2>/dev/null || echo false)"
+    if [ "$draft_state" = "false" ] && [ "$prerelease_state" = "true" ]; then
+      return 0
+    fi
+    if [ "$i" -lt "$attempts" ]; then
+      echo "Release '$tag' state not settled yet (attempt $i/$attempts), retrying in ${delay_seconds}s..." >&2
+      sleep "$delay_seconds"
+    fi
+  done
+
+  echo "Failed to settle release state for tag '$tag'." >&2
+  gh api "$endpoint" --jq '{draft: .draft, prerelease: .prerelease, url: .html_url}' 2>/dev/null || true
+  return 1
+}
+
+wait_for_release_absent() {
+  local repo="$1"
+  local tag="$2"
+  local attempts="${3:-12}"
+  local delay_seconds="${4:-2}"
+
+  local i
+  for ((i = 1; i <= attempts; i++)); do
+    if gh release view "$tag" --repo "$repo" >/dev/null 2>&1; then
+      if [ "$i" -lt "$attempts" ]; then
+        echo "Release '$tag' still exists (attempt $i/$attempts), waiting ${delay_seconds}s..." >&2
+        sleep "$delay_seconds"
+      fi
+      continue
+    fi
+    return 0
+  done
+
+  echo "Release '$tag' still exists after waiting." >&2
+  gh release view "$tag" --repo "$repo" --json url,isDraft,isPrerelease 2>/dev/null || true
+  return 1
+}
+
+wait_for_git_tag_absent() {
+  local repo="$1"
+  local tag="$2"
+  local attempts="${3:-12}"
+  local delay_seconds="${4:-2}"
+
+  local i
+  for ((i = 1; i <= attempts; i++)); do
+    if gh api "repos/$repo/git/ref/tags/$tag" >/dev/null 2>&1; then
+      if [ "$i" -lt "$attempts" ]; then
+        echo "Git tag '$tag' still exists (attempt $i/$attempts), waiting ${delay_seconds}s..." >&2
+        sleep "$delay_seconds"
+      fi
+      continue
+    fi
+    return 0
+  done
+
+  echo "Git tag '$tag' still exists after waiting." >&2
+  gh api "repos/$repo/git/ref/tags/$tag" --jq '{ref: .ref, object: .object.sha}' 2>/dev/null || true
+  return 1
+}
+
+recreate_fixed_prerelease() {
+  local repo="$1"
+  local tag="$2"
+  local target_branch="$3"
+  local release_title="$4"
+  local release_notes="$5"
+
+  if gh release view "$tag" --repo "$repo" >/dev/null 2>&1; then
+    retry_cmd 5 3 gh release delete "$tag" --repo "$repo" --yes --cleanup-tag
+  fi
+
+  wait_for_release_absent "$repo" "$tag" 12 2
+
+  if gh api "repos/$repo/git/ref/tags/$tag" >/dev/null 2>&1; then
+    retry_cmd 5 2 gh api --method DELETE "repos/$repo/git/refs/tags/$tag"
+  fi
+
+  wait_for_git_tag_absent "$repo" "$tag" 12 2
+
+  local created="false"
+  local i
+  for ((i = 1; i <= 6; i++)); do
+    if gh release create "$tag" --repo "$repo" --title "$release_title" --notes "$release_notes" --prerelease --target "$target_branch"; then
+      created="true"
+      break
+    fi
+    if gh release view "$tag" --repo "$repo" >/dev/null 2>&1; then
+      echo "Release '$tag' appears to exist after create failure; continue to settle state." >&2
+      created="true"
+      break
+    fi
+    if [ "$i" -lt 6 ]; then
+      echo "Create release '$tag' failed (attempt $i/6), retrying in 3s..." >&2
+      sleep 3
+    fi
+  done
+
+  if [ "$created" != "true" ]; then
+    echo "Failed to create release '$tag'." >&2
+    return 1
+  fi
+
+  local release_id
+  release_id="$(wait_for_release_id "$repo" "$tag" 12 2)"
+  settle_release_state "$repo" "$release_id" "$tag" 12 2
+}
+
+upload_release_assets_with_retry() {
+  local repo="$1"
+  local tag="$2"
+  shift 2
+
+  if [ "$#" -eq 0 ]; then
+    echo "No release assets provided for upload." >&2
+    return 1
+  fi
+
+  wait_for_release_id "$repo" "$tag" 12 2 >/dev/null
+  retry_cmd 5 3 gh release upload "$tag" "$@" --repo "$repo" --clobber
+}

.github/workflows/dev-daily-fixed.yml

@@ -55,28 +55,8 @@ jobs:
         shell: bash
         run: |
           set -euo pipefail
-          if gh release view "$FIXED_DEV_TAG" --repo "$GITHUB_REPOSITORY" >/dev/null 2>&1; then
+          source .github/scripts/release-utils.sh
-            gh release delete "$FIXED_DEV_TAG" --repo "$GITHUB_REPOSITORY" --yes --cleanup-tag
+          recreate_fixed_prerelease "$GITHUB_REPOSITORY" "$FIXED_DEV_TAG" "$TARGET_BRANCH" "Daily Dev Build" "开发版发布页"
-          fi
-          gh release create "$FIXED_DEV_TAG" --repo "$GITHUB_REPOSITORY" --title "Daily Dev Build" --notes "开发版发布页" --prerelease --target "$TARGET_BRANCH"
-          RELEASE_REST_ID="$(gh api "repos/$GITHUB_REPOSITORY/releases/tags/$FIXED_DEV_TAG" --jq '.id')"
-          RELEASE_ENDPOINT="repos/$GITHUB_REPOSITORY/releases/tags/$FIXED_DEV_TAG"
-          settled="false"
-          for i in 1 2 3 4 5; do
-            gh api --method PATCH "repos/$GITHUB_REPOSITORY/releases/$RELEASE_REST_ID" -F draft=false -F prerelease=true >/dev/null 2>&1 || true
-            DRAFT_STATE="$(gh api "$RELEASE_ENDPOINT" --jq '.draft' 2>/dev/null || echo true)"
-            PRERELEASE_STATE="$(gh api "$RELEASE_ENDPOINT" --jq '.prerelease' 2>/dev/null || echo false)"
-            if [ "$DRAFT_STATE" = "false" ] && [ "$PRERELEASE_STATE" = "true" ]; then
-              settled="true"
-              break
-            fi
-            sleep 2
-          done
-          if [ "$settled" != "true" ]; then
-            echo "Failed to settle release state after create:"
-            gh api "$RELEASE_ENDPOINT" --jq '{draft: .draft, prerelease: .prerelease, url: .html_url}'
-            exit 1
-          fi
 
   dev-mac-arm64:
     needs: prepare
@@ -93,7 +73,6 @@ jobs:
         with:
           node-version: 24
           cache: "npm"
-
       - name: Install Dependencies
         run: npm install
 
@@ -135,6 +114,8 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           assets=()
           while IFS= read -r file; do
             assets+=("$file")
@@ -143,7 +124,7 @@ jobs:
             echo "No release files found in ./release"
             exit 1
           fi
-          gh release upload "$FIXED_DEV_TAG" "${assets[@]}" --repo "$GITHUB_REPOSITORY" --clobber
+          upload_release_assets_with_retry "$GITHUB_REPOSITORY" "$FIXED_DEV_TAG" "${assets[@]}"
 
   dev-linux:
     needs: prepare
@@ -160,7 +141,6 @@ jobs:
         with:
           node-version: 24
           cache: "npm"
-
       - name: Install Dependencies
         run: npm install
 
@@ -183,6 +163,8 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           assets=()
           while IFS= read -r file; do
             assets+=("$file")
@@ -191,7 +173,7 @@ jobs:
             echo "No release files found in ./release"
             exit 1
           fi
-          gh release upload "$FIXED_DEV_TAG" "${assets[@]}" --repo "$GITHUB_REPOSITORY" --clobber
+          upload_release_assets_with_retry "$GITHUB_REPOSITORY" "$FIXED_DEV_TAG" "${assets[@]}"
 
   dev-win-x64:
     needs: prepare
@@ -208,7 +190,6 @@ jobs:
         with:
           node-version: 24
           cache: "npm"
-
       - name: Install Dependencies
         run: npm install
 
@@ -231,6 +212,8 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           assets=()
           while IFS= read -r file; do
             assets+=("$file")
@@ -239,7 +222,7 @@ jobs:
             echo "No release files found in ./release"
             exit 1
           fi
-          gh release upload "$FIXED_DEV_TAG" "${assets[@]}" --repo "$GITHUB_REPOSITORY" --clobber
+          upload_release_assets_with_retry "$GITHUB_REPOSITORY" "$FIXED_DEV_TAG" "${assets[@]}"
 
   dev-win-arm64:
     needs: prepare
@@ -256,7 +239,6 @@ jobs:
         with:
           node-version: 24
           cache: "npm"
-
       - name: Install Dependencies
         run: npm install
 
@@ -279,6 +261,8 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           assets=()
           while IFS= read -r file; do
             assets+=("$file")
@@ -287,7 +271,7 @@ jobs:
             echo "No release files found in ./release"
             exit 1
           fi
-          gh release upload "$FIXED_DEV_TAG" "${assets[@]}" --repo "$GITHUB_REPOSITORY" --clobber
+          upload_release_assets_with_retry "$GITHUB_REPOSITORY" "$FIXED_DEV_TAG" "${assets[@]}"
 
   update-dev-release-notes:
     needs:
@@ -386,22 +370,7 @@ jobs:
           }
 
           update_release_notes
-          RELEASE_REST_ID="$(gh api "repos/$REPO/releases/tags/$TAG" --jq '.id')"
+          source .github/scripts/release-utils.sh
-          RELEASE_ENDPOINT="repos/$REPO/releases/tags/$TAG"
+          RELEASE_REST_ID="$(wait_for_release_id "$REPO" "$TAG" 12 2)"
-          settled="false"
+          settle_release_state "$REPO" "$RELEASE_REST_ID" "$TAG" 12 2
-          for i in 1 2 3 4 5; do
-            gh api --method PATCH "repos/$REPO/releases/$RELEASE_REST_ID" -F draft=false -F prerelease=true >/dev/null 2>&1 || true
-            DRAFT_STATE="$(gh api "$RELEASE_ENDPOINT" --jq '.draft' 2>/dev/null || echo true)"
-            PRERELEASE_STATE="$(gh api "$RELEASE_ENDPOINT" --jq '.prerelease' 2>/dev/null || echo false)"
-            if [ "$DRAFT_STATE" = "false" ] && [ "$PRERELEASE_STATE" = "true" ]; then
-              settled="true"
-              break
-            fi
-            sleep 2
-          done
-          if [ "$settled" != "true" ]; then
-            echo "Failed to settle release state after notes update:"
-            gh api "$RELEASE_ENDPOINT" --jq '{draft: .draft, prerelease: .prerelease, url: .html_url}'
-            exit 1
-          fi
           gh api "repos/$REPO/releases/tags/$TAG" --jq '{isDraft: .draft, isPrerelease: .prerelease, url: .html_url}'

.github/workflows/preview-nightly-main.yml

@@ -81,28 +81,8 @@ jobs:
         shell: bash
         run: |
           set -euo pipefail
-          if gh release view "$FIXED_PREVIEW_TAG" --repo "$GITHUB_REPOSITORY" >/dev/null 2>&1; then
+          source .github/scripts/release-utils.sh
-            gh release delete "$FIXED_PREVIEW_TAG" --repo "$GITHUB_REPOSITORY" --yes --cleanup-tag
+          recreate_fixed_prerelease "$GITHUB_REPOSITORY" "$FIXED_PREVIEW_TAG" "$TARGET_BRANCH" "Preview Nightly Build" "预览版发布页"
-          fi
-          gh release create "$FIXED_PREVIEW_TAG" --repo "$GITHUB_REPOSITORY" --title "Preview Nightly Build" --notes "预览版发布页" --prerelease --target "$TARGET_BRANCH"
-          RELEASE_REST_ID="$(gh api "repos/$GITHUB_REPOSITORY/releases/tags/$FIXED_PREVIEW_TAG" --jq '.id')"
-          RELEASE_ENDPOINT="repos/$GITHUB_REPOSITORY/releases/tags/$FIXED_PREVIEW_TAG"
-          settled="false"
-          for i in 1 2 3 4 5; do
-            gh api --method PATCH "repos/$GITHUB_REPOSITORY/releases/$RELEASE_REST_ID" -F draft=false -F prerelease=true >/dev/null 2>&1 || true
-            DRAFT_STATE="$(gh api "$RELEASE_ENDPOINT" --jq '.draft' 2>/dev/null || echo true)"
-            PRERELEASE_STATE="$(gh api "$RELEASE_ENDPOINT" --jq '.prerelease' 2>/dev/null || echo false)"
-            if [ "$DRAFT_STATE" = "false" ] && [ "$PRERELEASE_STATE" = "true" ]; then
-              settled="true"
-              break
-            fi
-            sleep 2
-          done
-          if [ "$settled" != "true" ]; then
-            echo "Failed to settle release state after create:"
-            gh api "$RELEASE_ENDPOINT" --jq '{draft: .draft, prerelease: .prerelease, url: .html_url}'
-            exit 1
-          fi
 
   preview-mac-arm64:
     needs: prepare
@@ -120,7 +100,6 @@ jobs:
         with:
           node-version: 24
           cache: "npm"
-
       - name: Install Dependencies
         run: npm install
 
@@ -164,6 +143,8 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           assets=()
           while IFS= read -r file; do
             assets+=("$file")
@@ -172,7 +153,7 @@ jobs:
             echo "No release files found in ./release"
             exit 1
           fi
-          gh release upload "$FIXED_PREVIEW_TAG" "${assets[@]}" --repo "$GITHUB_REPOSITORY" --clobber
+          upload_release_assets_with_retry "$GITHUB_REPOSITORY" "$FIXED_PREVIEW_TAG" "${assets[@]}"
 
   preview-linux:
     needs: prepare
@@ -190,7 +171,6 @@ jobs:
         with:
           node-version: 24
           cache: "npm"
-
       - name: Install Dependencies
         run: npm install
 
@@ -216,6 +196,8 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           assets=()
           while IFS= read -r file; do
             assets+=("$file")
@@ -224,7 +206,7 @@ jobs:
             echo "No release files found in ./release"
             exit 1
           fi
-          gh release upload "$FIXED_PREVIEW_TAG" "${assets[@]}" --repo "$GITHUB_REPOSITORY" --clobber
+          upload_release_assets_with_retry "$GITHUB_REPOSITORY" "$FIXED_PREVIEW_TAG" "${assets[@]}"
 
   preview-win-x64:
     needs: prepare
@@ -242,7 +224,6 @@ jobs:
         with:
           node-version: 24
           cache: "npm"
-
       - name: Install Dependencies
         run: npm install
 
@@ -268,6 +249,8 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           assets=()
           while IFS= read -r file; do
             assets+=("$file")
@@ -276,7 +259,7 @@ jobs:
             echo "No release files found in ./release"
             exit 1
           fi
-          gh release upload "$FIXED_PREVIEW_TAG" "${assets[@]}" --repo "$GITHUB_REPOSITORY" --clobber
+          upload_release_assets_with_retry "$GITHUB_REPOSITORY" "$FIXED_PREVIEW_TAG" "${assets[@]}"
 
   preview-win-arm64:
     needs: prepare
@@ -294,7 +277,6 @@ jobs:
         with:
           node-version: 24
           cache: "npm"
-
       - name: Install Dependencies
         run: npm install
 
@@ -320,6 +302,8 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           assets=()
           while IFS= read -r file; do
             assets+=("$file")
@@ -328,7 +312,7 @@ jobs:
             echo "No release files found in ./release"
             exit 1
           fi
-          gh release upload "$FIXED_PREVIEW_TAG" "${assets[@]}" --repo "$GITHUB_REPOSITORY" --clobber
+          upload_release_assets_with_retry "$GITHUB_REPOSITORY" "$FIXED_PREVIEW_TAG" "${assets[@]}"
 
   update-preview-release-notes:
     needs:
@@ -429,22 +413,7 @@ jobs:
           }
 
           update_release_notes
-          RELEASE_REST_ID="$(gh api "repos/$REPO/releases/tags/$TAG" --jq '.id')"
+          source .github/scripts/release-utils.sh
-          RELEASE_ENDPOINT="repos/$REPO/releases/tags/$TAG"
+          RELEASE_REST_ID="$(wait_for_release_id "$REPO" "$TAG" 12 2)"
-          settled="false"
+          settle_release_state "$REPO" "$RELEASE_REST_ID" "$TAG" 12 2
-          for i in 1 2 3 4 5; do
-            gh api --method PATCH "repos/$REPO/releases/$RELEASE_REST_ID" -F draft=false -F prerelease=true >/dev/null 2>&1 || true
-            DRAFT_STATE="$(gh api "$RELEASE_ENDPOINT" --jq '.draft' 2>/dev/null || echo true)"
-            PRERELEASE_STATE="$(gh api "$RELEASE_ENDPOINT" --jq '.prerelease' 2>/dev/null || echo false)"
-            if [ "$DRAFT_STATE" = "false" ] && [ "$PRERELEASE_STATE" = "true" ]; then
-              settled="true"
-              break
-            fi
-            sleep 2
-          done
-          if [ "$settled" != "true" ]; then
-            echo "Failed to settle release state after notes update:"
-            gh api "$RELEASE_ENDPOINT" --jq '{draft: .draft, prerelease: .prerelease, url: .html_url}'
-            exit 1
-          fi
           gh api "repos/$REPO/releases/tags/$TAG" --jq '{isDraft: .draft, isPrerelease: .prerelease, url: .html_url}'

.github/workflows/release.yml

@@ -27,7 +27,6 @@ jobs:
         with:
           node-version: 24
           cache: "npm"
-
       - name: Install Dependencies
         run: npm install
 
@@ -59,15 +58,21 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           TAG=${GITHUB_REF_NAME}
           REPO=${{ github.repository }}
           MINIMUM_VERSION="4.1.7"
+          wait_for_release_id "$REPO" "$TAG" 12 2 >/dev/null
           for YML_FILE in latest-mac.yml latest-arm64-mac.yml; do
-            gh release download "$TAG" --repo "$REPO" --pattern "$YML_FILE" --output "/tmp/$YML_FILE" 2>/dev/null || continue
+            if ! retry_cmd 5 3 gh release download "$TAG" --repo "$REPO" --pattern "$YML_FILE" --output "/tmp/$YML_FILE"; then
+              echo "Skip $YML_FILE because download failed after retries."
+              continue
+            fi
             if ! grep -q 'minimumVersion' "/tmp/$YML_FILE"; then
               echo "minimumVersion: $MINIMUM_VERSION" >> "/tmp/$YML_FILE"
             fi
-            gh release upload "$TAG" --repo "$REPO" "/tmp/$YML_FILE" --clobber
+            retry_cmd 5 3 gh release upload "$TAG" --repo "$REPO" "/tmp/$YML_FILE" --clobber
           done
 
   release-linux:
@@ -84,7 +89,6 @@ jobs:
         with:
           node-version: 24
           cache: "npm"
-
       - name: Install Dependencies
         run: npm install
 
@@ -117,13 +121,16 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           TAG=${GITHUB_REF_NAME}
           REPO=${{ github.repository }}
           MINIMUM_VERSION="4.1.7"
-          gh release download "$TAG" --repo "$REPO" --pattern "latest-linux.yml" --output "/tmp/latest-linux.yml" 2>/dev/null || true
+          wait_for_release_id "$REPO" "$TAG" 12 2 >/dev/null
+          retry_cmd 5 3 gh release download "$TAG" --repo "$REPO" --pattern "latest-linux.yml" --output "/tmp/latest-linux.yml" || true
           if [ -f /tmp/latest-linux.yml ] && ! grep -q 'minimumVersion' /tmp/latest-linux.yml; then
             echo "minimumVersion: $MINIMUM_VERSION" >> /tmp/latest-linux.yml
-            gh release upload "$TAG" --repo "$REPO" /tmp/latest-linux.yml --clobber
+            retry_cmd 5 3 gh release upload "$TAG" --repo "$REPO" /tmp/latest-linux.yml --clobber
           fi
 
   release:
@@ -140,7 +147,6 @@ jobs:
         with:
           node-version: 24
           cache: 'npm'
-
       - name: Install Dependencies
         run: npm install
 
@@ -168,13 +174,16 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           TAG=${GITHUB_REF_NAME}
           REPO=${{ github.repository }}
           MINIMUM_VERSION="4.1.7"
-          gh release download "$TAG" --repo "$REPO" --pattern "latest.yml" --output "/tmp/latest.yml" 2>/dev/null || true
+          wait_for_release_id "$REPO" "$TAG" 12 2 >/dev/null
+          retry_cmd 5 3 gh release download "$TAG" --repo "$REPO" --pattern "latest.yml" --output "/tmp/latest.yml" || true
           if [ -f /tmp/latest.yml ] && ! grep -q 'minimumVersion' /tmp/latest.yml; then
             echo "minimumVersion: $MINIMUM_VERSION" >> /tmp/latest.yml
-            gh release upload "$TAG" --repo "$REPO" /tmp/latest.yml --clobber
+            retry_cmd 5 3 gh release upload "$TAG" --repo "$REPO" /tmp/latest.yml --clobber
           fi
 
   release-windows-arm64:
@@ -191,7 +200,6 @@ jobs:
         with:
           node-version: 24
           cache: 'npm'
-
       - name: Install Dependencies
         run: npm install
 
@@ -219,13 +227,16 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         shell: bash
         run: |
+          set -euo pipefail
+          source .github/scripts/release-utils.sh
           TAG=${GITHUB_REF_NAME}
           REPO=${{ github.repository }}
           MINIMUM_VERSION="4.1.7"
-          gh release download "$TAG" --repo "$REPO" --pattern "latest-arm64.yml" --output "/tmp/latest-arm64.yml" 2>/dev/null || true
+          wait_for_release_id "$REPO" "$TAG" 12 2 >/dev/null
+          retry_cmd 5 3 gh release download "$TAG" --repo "$REPO" --pattern "latest-arm64.yml" --output "/tmp/latest-arm64.yml" || true
           if [ -f /tmp/latest-arm64.yml ] && ! grep -q 'minimumVersion' /tmp/latest-arm64.yml; then
             echo "minimumVersion: $MINIMUM_VERSION" >> /tmp/latest-arm64.yml
-            gh release upload "$TAG" --repo "$REPO" /tmp/latest-arm64.yml --clobber
+            retry_cmd 5 3 gh release upload "$TAG" --repo "$REPO" /tmp/latest-arm64.yml --clobber
           fi
 
   update-release-notes:
@@ -243,12 +254,14 @@ jobs:
         shell: bash
         run: |
           set -euo pipefail
+          source .github/scripts/release-utils.sh
 
           TAG="$GITHUB_REF_NAME"
           REPO="$GITHUB_REPOSITORY"
           RELEASE_PAGE="https://github.com/$REPO/releases/tag/$TAG"
+          wait_for_release_id "$REPO" "$TAG" 12 2 >/dev/null
 
-          ASSETS_JSON="$(gh release view "$TAG" --repo "$REPO" --json assets)"
+          capture_cmd_with_retry ASSETS_JSON 8 3 gh release view "$TAG" --repo "$REPO" --json assets
 
           pick_asset() {
             local pattern="$1"
@@ -299,7 +312,7 @@ jobs:
           > 如果某个平台链接暂时未生成，可进入[完整发布页]($RELEASE_PAGE)查看全部资源
           EOF
 
-          gh release edit "$TAG" --repo "$REPO" --notes-file release_notes.md
+          retry_cmd 5 3 gh release edit "$TAG" --repo "$REPO" --notes-file release_notes.md
 
   deploy-aur:
       runs-on: ubuntu-latest

.gitignore

@@ -75,4 +75,4 @@ pnpm-lock.yaml
 wechat-research-site
 .codex
 weflow-web-offical
-Insight
+/Wedecrypt

electron/main.ts

@@ -372,6 +372,7 @@ if (process.platform === 'darwin') {
 let mainWindowReady = false
 let shouldShowMain = true
 let isAppQuitting = false
+let shutdownPromise: Promise<void> | null = null
 let tray: Tray | null = null
 let isClosePromptVisible = false
 const chatHistoryPayloadStore = new Map<string, { sessionId: string; title?: string; recordList: any[] }>()
@@ -2663,15 +2664,30 @@ function registerIpcHandlers() {
   // 私聊克隆
 
 
-  ipcMain.handle('image:decrypt', async (_, payload: { sessionId?: string; imageMd5?: string; imageDatName?: string; force?: boolean }) => {
+  ipcMain.handle('image:decrypt', async (_, payload: {
+    sessionId?: string
+    imageMd5?: string
+    imageDatName?: string
+    createTime?: number
+    force?: boolean
+    preferFilePath?: boolean
+    hardlinkOnly?: boolean
+    disableUpdateCheck?: boolean
+    allowCacheIndex?: boolean
+    suppressEvents?: boolean
+  }) => {
     return imageDecryptService.decryptImage(payload)
   })
   ipcMain.handle('image:resolveCache', async (_, payload: {
     sessionId?: string
     imageMd5?: string
     imageDatName?: string
+    createTime?: number
+    preferFilePath?: boolean
+    hardlinkOnly?: boolean
     disableUpdateCheck?: boolean
     allowCacheIndex?: boolean
+    suppressEvents?: boolean
   }) => {
     return imageDecryptService.resolveCachedImage(payload)
   })
@@ -2679,17 +2695,84 @@ function registerIpcHandlers() {
     'image:resolveCacheBatch',
     async (
       _,
-      payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string }>,
+      payloads: Array<{
-      options?: { disableUpdateCheck?: boolean; allowCacheIndex?: boolean }
+        sessionId?: string
+        imageMd5?: string
+        imageDatName?: string
+        createTime?: number
+        preferFilePath?: boolean
+        hardlinkOnly?: boolean
+        suppressEvents?: boolean
+      }>,
+      options?: { disableUpdateCheck?: boolean; allowCacheIndex?: boolean; preferFilePath?: boolean; hardlinkOnly?: boolean; suppressEvents?: boolean }
     ) => {
       const list = Array.isArray(payloads) ? payloads : []
-      const rows = await Promise.all(list.map(async (payload) => {
+      if (list.length === 0) return { success: true, rows: [] }
-        return imageDecryptService.resolveCachedImage({
+
+      const maxConcurrentRaw = Number(process.env.WEFLOW_IMAGE_RESOLVE_BATCH_CONCURRENCY || 10)
+      const maxConcurrent = Number.isFinite(maxConcurrentRaw)
+        ? Math.max(1, Math.min(Math.floor(maxConcurrentRaw), 48))
+        : 10
+      const workerCount = Math.min(maxConcurrent, list.length)
+
+      const rows: Array<{ success: boolean; localPath?: string; hasUpdate?: boolean; error?: string }> = new Array(list.length)
+      let cursor = 0
+      const dedupe = new Map<string, Promise<{ success: boolean; localPath?: string; hasUpdate?: boolean; error?: string }>>()
+
+      const makeDedupeKey = (payload: typeof list[number]): string => {
+        const sessionId = String(payload.sessionId || '').trim().toLowerCase()
+        const imageMd5 = String(payload.imageMd5 || '').trim().toLowerCase()
+        const imageDatName = String(payload.imageDatName || '').trim().toLowerCase()
+        const createTime = Number(payload.createTime || 0) || 0
+        const preferFilePath = payload.preferFilePath ?? options?.preferFilePath === true
+        const hardlinkOnly = payload.hardlinkOnly ?? options?.hardlinkOnly === true
+        const allowCacheIndex = options?.allowCacheIndex !== false
+        const disableUpdateCheck = options?.disableUpdateCheck === true
+        const suppressEvents = payload.suppressEvents ?? options?.suppressEvents === true
+        return [
+          sessionId,
+          imageMd5,
+          imageDatName,
+          String(createTime),
+          preferFilePath ? 'pf1' : 'pf0',
+          hardlinkOnly ? 'hl1' : 'hl0',
+          allowCacheIndex ? 'ci1' : 'ci0',
+          disableUpdateCheck ? 'du1' : 'du0',
+          suppressEvents ? 'se1' : 'se0'
+        ].join('|')
+      }
+
+      const resolveOne = (payload: typeof list[number]) => imageDecryptService.resolveCachedImage({
         ...payload,
+        preferFilePath: payload.preferFilePath ?? options?.preferFilePath === true,
+        hardlinkOnly: payload.hardlinkOnly ?? options?.hardlinkOnly === true,
         disableUpdateCheck: options?.disableUpdateCheck === true,
-          allowCacheIndex: options?.allowCacheIndex !== false
+        allowCacheIndex: options?.allowCacheIndex !== false,
+        suppressEvents: payload.suppressEvents ?? options?.suppressEvents === true
       })
+
+      const worker = async () => {
+        while (true) {
+          const index = cursor
+          cursor += 1
+          if (index >= list.length) return
+          const payload = list[index]
+          const key = makeDedupeKey(payload)
+          const existing = dedupe.get(key)
+          if (existing) {
+            rows[index] = await existing
+            continue
+          }
+          const task = resolveOne(payload).catch((error) => ({
+            success: false,
+            error: String(error)
           }))
+          dedupe.set(key, task)
+          rows[index] = await task
+        }
+      }
+
+      await Promise.all(Array.from({ length: workerCount }, () => worker()))
       return { success: true, rows }
     }
   )
@@ -2697,12 +2780,19 @@ function registerIpcHandlers() {
     'image:preload',
     async (
       _,
-      payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string }>,
+      payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string; createTime?: number }>,
       options?: { allowDecrypt?: boolean; allowCacheIndex?: boolean }
     ) => {
     imagePreloadService.enqueue(payloads || [], options)
     return true
   })
+  ipcMain.handle(
+    'image:preloadHardlinkMd5s',
+    async (_, md5List?: string[]) => {
+      await imageDecryptService.preloadImageHardlinkMd5s(Array.isArray(md5List) ? md5List : [])
+      return true
+    }
+  )
 
   // Windows Hello
   ipcMain.handle('auth:hello', async (event, message?: string) => {
@@ -3780,12 +3870,15 @@ app.whenReady().then(async () => {
   })
 })
 
-app.on('before-quit', async () => {
+const shutdownAppServices = async (): Promise<void> => {
+  if (shutdownPromise) return shutdownPromise
+  shutdownPromise = (async () => {
     isAppQuitting = true
     // 销毁 tray 图标
     if (tray) { try { tray.destroy() } catch {} tray = null }
     // 通知窗使用 hide 而非 close，退出时主动销毁，避免残留窗口阻塞进程退出。
     destroyNotificationWindow()
+    messagePushService.stop()
     insightService.stop()
     // 兜底：5秒后强制退出，防止某个异步任务卡住导致进程残留
     const forceExitTimer = setTimeout(() => {
@@ -3793,10 +3886,19 @@ app.on('before-quit', async () => {
       app.exit(0)
     }, 5000)
     forceExitTimer.unref()
+    try { await cloudControlService.stop() } catch {}
+    // 停止 chatService（内部会关闭 cursor 与 DB），避免退出阶段仍触发监控回调
+    try { chatService.close() } catch {}
     // 停止 HTTP 服务器，释放 TCP 端口占用，避免进程无法退出
     try { await httpService.stop() } catch {}
     // 终止 wcdb Worker 线程，避免线程阻止进程退出
     try { await wcdbService.shutdown() } catch {}
+  })()
+  return shutdownPromise
+}
+
+app.on('before-quit', () => {
+  void shutdownAppServices()
 })
 
 app.on('window-all-closed', () => {

electron/preload.ts

@@ -286,24 +286,41 @@ contextBridge.exposeInMainWorld('electronAPI', {
 
   // 图片解密
   image: {
-    decrypt: (payload: { sessionId?: string; imageMd5?: string; imageDatName?: string; force?: boolean }) =>
+    decrypt: (payload: {
+      sessionId?: string
+      imageMd5?: string
+      imageDatName?: string
+      createTime?: number
+      force?: boolean
+      preferFilePath?: boolean
+      hardlinkOnly?: boolean
+      disableUpdateCheck?: boolean
+      allowCacheIndex?: boolean
+      suppressEvents?: boolean
+    }) =>
       ipcRenderer.invoke('image:decrypt', payload),
     resolveCache: (payload: {
       sessionId?: string
       imageMd5?: string
       imageDatName?: string
+      createTime?: number
+      preferFilePath?: boolean
+      hardlinkOnly?: boolean
       disableUpdateCheck?: boolean
       allowCacheIndex?: boolean
+      suppressEvents?: boolean
     }) =>
       ipcRenderer.invoke('image:resolveCache', payload),
     resolveCacheBatch: (
-      payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string }>,
+      payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string; createTime?: number; preferFilePath?: boolean; hardlinkOnly?: boolean }>,
-      options?: { disableUpdateCheck?: boolean; allowCacheIndex?: boolean }
+      options?: { disableUpdateCheck?: boolean; allowCacheIndex?: boolean; preferFilePath?: boolean; hardlinkOnly?: boolean; suppressEvents?: boolean }
     ) => ipcRenderer.invoke('image:resolveCacheBatch', payloads, options),
     preload: (
-      payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string }>,
+      payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string; createTime?: number }>,
       options?: { allowDecrypt?: boolean; allowCacheIndex?: boolean }
     ) => ipcRenderer.invoke('image:preload', payloads, options),
+    preloadHardlinkMd5s: (md5List: string[]) =>
+      ipcRenderer.invoke('image:preloadHardlinkMd5s', md5List),
     onUpdateAvailable: (callback: (payload: { cacheKey: string; imageMd5?: string; imageDatName?: string }) => void) => {
       const listener = (_: unknown, payload: { cacheKey: string; imageMd5?: string; imageDatName?: string }) => callback(payload)
       ipcRenderer.on('image:updateAvailable', listener)

electron/services/chatService.ts

@@ -486,7 +486,7 @@ class ChatService {
     return Number.isFinite(parsed) ? parsed : null
   }
 
-  private toCodeOnlyMessage(rawMessage?: string, fallbackCode = -3999): string {
+  private toCodeOnlyMessage(rawMessage?: string | null, fallbackCode = -3999): string {
     const code = this.extractErrorCode(rawMessage) ?? fallbackCode
     return `错误码: ${code}`
   }
@@ -7105,13 +7105,23 @@ class ChatService {
         return { success: false, error: '未找到消息' }
       }
       const msg = msgResult.message
+      const rawImageInfo = msg.rawContent ? this.parseImageInfo(msg.rawContent) : {}
+      const imageMd5 = msg.imageMd5 || rawImageInfo.md5
+      const imageDatName = msg.imageDatName
 
-      // 2. 使用 imageDecryptService 解密图片
+      if (!imageMd5 && !imageDatName) {
+        return { success: false, error: '图片缺少 md5/datName，无法定位原文件' }
+      }
+
+      // 2. 使用 imageDecryptService 解密图片（仅使用真实图片标识）
       const result = await this.imageDecryptService.decryptImage({
         sessionId,
-        imageMd5: msg.imageMd5,
+        imageMd5,
-        imageDatName: msg.imageDatName || String(msg.localId),
+        imageDatName,
-        force: false
+        createTime: msg.createTime,
+        force: false,
+        preferFilePath: true,
+        hardlinkOnly: true
       })
 
       if (!result.success || !result.localPath) {
@@ -8358,7 +8368,6 @@ class ChatService {
         if (normalized.length === 0) return []
 
         // 规避 native options_json 可能存在的固定缓冲上限：按 payload 字节安全分块。
-        // 这不是降级或裁剪范围，而是完整遍历所有群并做结果合并。
         const maxBytesRaw = Number(process.env.WEFLOW_MY_FOOTPRINT_GROUP_OPTIONS_MAX_BYTES || 900)
         const maxBytes = Number.isFinite(maxBytesRaw) && maxBytesRaw >= 512
           ? Math.floor(maxBytesRaw)
@@ -9325,7 +9334,7 @@ class ChatService {
       latest_ts: this.toSafeInt(item?.latest_ts, 0),
       anchor_local_id: this.toSafeInt(item?.anchor_local_id, 0),
       anchor_create_time: this.toSafeInt(item?.anchor_create_time, 0)
-    })).filter((item) => item.session_id)
+    })).filter((item: MyFootprintPrivateSession) => item.session_id)
 
     const private_segments: MyFootprintPrivateSegment[] = privateSegmentsRaw.map((item: any) => ({
       session_id: String(item?.session_id || '').trim(),
@@ -9344,7 +9353,7 @@ class ChatService {
       anchor_create_time: this.toSafeInt(item?.anchor_create_time, 0),
       displayName: String(item?.displayName || '').trim() || undefined,
       avatarUrl: String(item?.avatarUrl || '').trim() || undefined
-    })).filter((item) => item.session_id && item.start_ts > 0)
+    })).filter((item: MyFootprintPrivateSegment) => item.session_id && item.start_ts > 0)
 
     const mentions: MyFootprintMentionItem[] = mentionsRaw.map((item: any) => ({
       session_id: String(item?.session_id || '').trim(),
@@ -9353,13 +9362,13 @@ class ChatService {
       sender_username: String(item?.sender_username || '').trim(),
       message_content: String(item?.message_content || ''),
       source: String(item?.source || '')
-    })).filter((item) => item.session_id)
+    })).filter((item: MyFootprintMentionItem) => item.session_id)
 
     const mention_groups: MyFootprintMentionGroup[] = mentionGroupsRaw.map((item: any) => ({
       session_id: String(item?.session_id || '').trim(),
       count: this.toSafeInt(item?.count, 0),
       latest_ts: this.toSafeInt(item?.latest_ts, 0)
-    })).filter((item) => item.session_id)
+    })).filter((item: MyFootprintMentionGroup) => item.session_id)
 
     const diagnostics: MyFootprintDiagnostics = {
       truncated: Boolean(diagnosticsRaw.truncated),

electron/services/cloudControlService.ts

@@ -218,7 +218,7 @@ class CloudControlService {
     this.pages.add(pageName)
   }
 
-  stop() {
+  async stop(): Promise<void> {
     if (this.timer) {
       clearTimeout(this.timer)
       this.timer = null
@@ -230,7 +230,13 @@ class CloudControlService {
     this.circuitOpenedAt = 0
     this.nextDelayOverrideMs = null
     this.initialized = false
-    wcdbService.cloudStop()
+    if (wcdbService.isReady()) {
+      try {
+        await wcdbService.cloudStop()
+      } catch {
+        // 忽略停止失败，避免阻塞主进程退出
+      }
+    }
   }
 
   async getLogs() {

electron/services/config.ts

@@ -2,6 +2,7 @@
 import { app, safeStorage } from 'electron'
 import crypto from 'crypto'
 import Store from 'electron-store'
+import { expandHomePath } from '../utils/pathUtils'
 
 // 加密前缀标记
 const SAFE_PREFIX = 'safe:'  // safeStorage 加密（普通模式）
@@ -42,7 +43,6 @@ interface ConfigSchema {
   autoTranscribeVoice: boolean
   transcribeLanguages: string[]
   exportDefaultConcurrency: number
-  exportDefaultImageDeepSearchOnMiss: boolean
   analyticsExcludedUsernames: string[]
 
   // 安全相关
@@ -168,7 +168,6 @@ export class ConfigService {
       autoTranscribeVoice: false,
       transcribeLanguages: ['zh'],
       exportDefaultConcurrency: 4,
-      exportDefaultImageDeepSearchOnMiss: true,
       analyticsExcludedUsernames: [],
       authEnabled: false,
       authPassword: '',
@@ -299,6 +298,10 @@ export class ConfigService {
       return this.decryptWxidConfigs(raw as any) as ConfigSchema[K]
     }
 
+    if (key === 'dbPath' && typeof raw === 'string') {
+      return expandHomePath(raw) as ConfigSchema[K]
+    }
+
     return raw
   }
 
@@ -306,6 +309,10 @@ export class ConfigService {
     let toStore = value
     const inLockMode = this.isLockMode() && this.unlockPassword
 
+    if (key === 'dbPath' && typeof value === 'string') {
+      toStore = expandHomePath(value) as ConfigSchema[K]
+    }
+
     if (ENCRYPTED_BOOL_KEYS.has(key)) {
       const boolValue = value === true || value === 'true'
       // `false` 不需要写入 keychain，避免无意义触发 macOS 钥匙串弹窗

electron/services/dbPathService.ts

@@ -2,6 +2,7 @@ import { join, basename } from 'path'
 import { existsSync, readdirSync, statSync, readFileSync } from 'fs'
 import { homedir } from 'os'
 import { createDecipheriv } from 'crypto'
+import { expandHomePath } from '../utils/pathUtils'
 
 export interface WxidInfo {
   wxid: string
@@ -139,13 +140,14 @@ export class DbPathService {
    * 查找账号目录（包含 db_storage 或图片目录）
    */
   findAccountDirs(rootPath: string): string[] {
+    const resolvedRootPath = expandHomePath(rootPath)
     const accounts: string[] = []
 
     try {
-      const entries = readdirSync(rootPath)
+      const entries = readdirSync(resolvedRootPath)
 
       for (const entry of entries) {
-        const entryPath = join(rootPath, entry)
+        const entryPath = join(resolvedRootPath, entry)
         let stat: ReturnType<typeof statSync>
         try {
           stat = statSync(entryPath)
@@ -216,13 +218,14 @@ export class DbPathService {
    * 扫描目录名候选（仅包含下划线的文件夹，排除 all_users）
    */
   scanWxidCandidates(rootPath: string): WxidInfo[] {
+    const resolvedRootPath = expandHomePath(rootPath)
     const wxids: WxidInfo[] = []
 
     try {
-      if (existsSync(rootPath)) {
+      if (existsSync(resolvedRootPath)) {
-        const entries = readdirSync(rootPath)
+        const entries = readdirSync(resolvedRootPath)
         for (const entry of entries) {
-          const entryPath = join(rootPath, entry)
+          const entryPath = join(resolvedRootPath, entry)
           let stat: ReturnType<typeof statSync>
           try { stat = statSync(entryPath) } catch { continue }
           if (!stat.isDirectory()) continue
@@ -235,9 +238,9 @@ export class DbPathService {
 
 
       if (wxids.length === 0) {
-        const rootName = basename(rootPath)
+        const rootName = basename(resolvedRootPath)
         if (rootName.includes('_') && rootName.toLowerCase() !== 'all_users') {
-          const rootStat = statSync(rootPath)
+          const rootStat = statSync(resolvedRootPath)
           wxids.push({ wxid: rootName, modifiedTime: rootStat.mtimeMs })
         }
       }
@@ -248,7 +251,7 @@ export class DbPathService {
       return a.wxid.localeCompare(b.wxid)
     });
 
-    const globalInfo = this.parseGlobalConfig(rootPath);
+    const globalInfo = this.parseGlobalConfig(resolvedRootPath);
     if (globalInfo) {
       for (const w of sorted) {
         if (w.wxid.startsWith(globalInfo.wxid) || sorted.length === 1) {
@@ -266,19 +269,20 @@ export class DbPathService {
    * 扫描 wxid 列表
    */
   scanWxids(rootPath: string): WxidInfo[] {
+    const resolvedRootPath = expandHomePath(rootPath)
     const wxids: WxidInfo[] = []
 
     try {
-      if (this.isAccountDir(rootPath)) {
+      if (this.isAccountDir(resolvedRootPath)) {
-        const wxid = basename(rootPath)
+        const wxid = basename(resolvedRootPath)
-        const modifiedTime = this.getAccountModifiedTime(rootPath)
+        const modifiedTime = this.getAccountModifiedTime(resolvedRootPath)
         return [{ wxid, modifiedTime }]
       }
 
-      const accounts = this.findAccountDirs(rootPath)
+      const accounts = this.findAccountDirs(resolvedRootPath)
 
       for (const account of accounts) {
-        const fullPath = join(rootPath, account)
+        const fullPath = join(resolvedRootPath, account)
         const modifiedTime = this.getAccountModifiedTime(fullPath)
         wxids.push({ wxid: account, modifiedTime })
       }
@@ -289,7 +293,7 @@ export class DbPathService {
       return a.wxid.localeCompare(b.wxid)
     });
 
-    const globalInfo = this.parseGlobalConfig(rootPath);
+    const globalInfo = this.parseGlobalConfig(resolvedRootPath);
     if (globalInfo) {
       for (const w of sorted) {
         if (w.wxid.startsWith(globalInfo.wxid) || sorted.length === 1) {

electron/services/exportService.ts

@@ -108,7 +108,6 @@ export interface ExportOptions {
   sessionNameWithTypePrefix?: boolean
   displayNamePreference?: 'group-nickname' | 'remark' | 'nickname'
   exportConcurrency?: number
-  imageDeepSearchOnMiss?: boolean
 }
 
 const TXT_COLUMN_DEFINITIONS: Array<{ id: string; label: string }> = [
@@ -443,8 +442,8 @@ class ExportService {
     let lastSessionId = ''
     let lastCollected = 0
     let lastExported = 0
-    const MIN_PROGRESS_EMIT_INTERVAL_MS = 250
+    const MIN_PROGRESS_EMIT_INTERVAL_MS = 400
-    const MESSAGE_PROGRESS_DELTA_THRESHOLD = 500
+    const MESSAGE_PROGRESS_DELTA_THRESHOLD = 1200
 
     const commit = (progress: ExportProgress) => {
       onProgress(progress)
@@ -1092,8 +1091,7 @@ class ExportService {
   private getImageMissingRunCacheKey(
     sessionId: string,
     imageMd5?: unknown,
-    imageDatName?: unknown,
+    imageDatName?: unknown
-    imageDeepSearchOnMiss = true
   ): string | null {
     const normalizedSessionId = String(sessionId || '').trim()
     const normalizedImageMd5 = String(imageMd5 || '').trim().toLowerCase()
@@ -1105,8 +1103,7 @@ class ExportService {
     const secondaryToken = normalizedImageMd5 && normalizedImageDatName && normalizedImageDatName !== normalizedImageMd5
       ? normalizedImageDatName
       : ''
-    const lookupMode = imageDeepSearchOnMiss ? 'deep' : 'hardlink'
+    return `${normalizedSessionId}\u001f${primaryToken}\u001f${secondaryToken}`
-    return `${lookupMode}\u001f${normalizedSessionId}\u001f${primaryToken}\u001f${secondaryToken}`
   }
 
   private normalizeEmojiMd5(value: unknown): string | undefined {
@@ -3583,7 +3580,6 @@ class ExportService {
       exportVoiceAsText?: boolean
       includeVideoPoster?: boolean
       includeVoiceWithTranscript?: boolean
-      imageDeepSearchOnMiss?: boolean
       dirCache?: Set<string>
     }
   ): Promise<MediaExportItem | null> {
@@ -3596,8 +3592,7 @@ class ExportService {
         sessionId,
         mediaRootDir,
         mediaRelativePrefix,
-        options.dirCache,
+        options.dirCache
-        options.imageDeepSearchOnMiss !== false
       )
       if (result) {
       }
@@ -3654,8 +3649,7 @@ class ExportService {
     sessionId: string,
     mediaRootDir: string,
     mediaRelativePrefix: string,
-    dirCache?: Set<string>,
+    dirCache?: Set<string>
-    imageDeepSearchOnMiss = true
   ): Promise<MediaExportItem | null> {
     try {
       const imagesDir = path.join(mediaRootDir, mediaRelativePrefix, 'images')
@@ -3675,8 +3669,7 @@ class ExportService {
       const missingRunCacheKey = this.getImageMissingRunCacheKey(
         sessionId,
         imageMd5,
-        imageDatName,
+        imageDatName
-        imageDeepSearchOnMiss
       )
       if (missingRunCacheKey && this.mediaRunMissingImageKeys.has(missingRunCacheKey)) {
         return null
@@ -3686,26 +3679,31 @@ class ExportService {
         sessionId,
         imageMd5,
         imageDatName,
+        createTime: msg.createTime,
         force: true,  // 导出优先高清，失败再回退缩略图
         preferFilePath: true,
-        hardlinkOnly: !imageDeepSearchOnMiss
+        hardlinkOnly: true,
+        disableUpdateCheck: true,
+        allowCacheIndex: !imageMd5,
+        suppressEvents: true
       })
 
       if (!result.success || !result.localPath) {
+        if (result.failureKind === 'decrypt_failed') {
           console.log(`[Export] 图片解密失败 (localId=${msg.localId}): imageMd5=${imageMd5}, imageDatName=${imageDatName}, error=${result.error || '未知'}`)
-        if (!imageDeepSearchOnMiss) {
+        } else {
-          console.log(`[Export] 未命中 hardlink（已关闭缺图深度搜索）→ 将显示 [图片] 占位符`)
+          console.log(`[Export] 图片本地无数据 (localId=${msg.localId}): imageMd5=${imageMd5}, imageDatName=${imageDatName}, error=${result.error || '未知'}`)
-          if (missingRunCacheKey) {
-            this.mediaRunMissingImageKeys.add(missingRunCacheKey)
-          }
-          return null
         }
         // 尝试获取缩略图
         const thumbResult = await imageDecryptService.resolveCachedImage({
           sessionId,
           imageMd5,
           imageDatName,
-          preferFilePath: true
+          createTime: msg.createTime,
+          preferFilePath: true,
+          disableUpdateCheck: true,
+          allowCacheIndex: !imageMd5,
+          suppressEvents: true
         })
         if (thumbResult.success && thumbResult.localPath) {
           console.log(`[Export] 使用缩略图替代 (localId=${msg.localId}): ${thumbResult.localPath}`)
@@ -5302,7 +5300,6 @@ class ExportService {
               maxFileSizeMb: options.maxFileSizeMb,
               exportVoiceAsText: options.exportVoiceAsText,
               includeVideoPoster: options.format === 'html',
-              imageDeepSearchOnMiss: options.imageDeepSearchOnMiss,
               dirCache: mediaDirCache
             })
             mediaCache.set(mediaKey, mediaItem)
@@ -5813,7 +5810,6 @@ class ExportService {
               maxFileSizeMb: options.maxFileSizeMb,
               exportVoiceAsText: options.exportVoiceAsText,
               includeVideoPoster: options.format === 'html',
-              imageDeepSearchOnMiss: options.imageDeepSearchOnMiss,
               dirCache: mediaDirCache
             })
             mediaCache.set(mediaKey, mediaItem)
@@ -6685,7 +6681,6 @@ class ExportService {
               maxFileSizeMb: options.maxFileSizeMb,
               exportVoiceAsText: options.exportVoiceAsText,
               includeVideoPoster: options.format === 'html',
-              imageDeepSearchOnMiss: options.imageDeepSearchOnMiss,
               dirCache: mediaDirCache
             })
             mediaCache.set(mediaKey, mediaItem)
@@ -7436,7 +7431,6 @@ class ExportService {
               maxFileSizeMb: options.maxFileSizeMb,
               exportVoiceAsText: options.exportVoiceAsText,
               includeVideoPoster: options.format === 'html',
-              imageDeepSearchOnMiss: options.imageDeepSearchOnMiss,
               dirCache: mediaDirCache
             })
             mediaCache.set(mediaKey, mediaItem)
@@ -7816,7 +7810,6 @@ class ExportService {
               maxFileSizeMb: options.maxFileSizeMb,
               exportVoiceAsText: options.exportVoiceAsText,
               includeVideoPoster: options.format === 'html',
-              imageDeepSearchOnMiss: options.imageDeepSearchOnMiss,
               dirCache: mediaDirCache
             })
             mediaCache.set(mediaKey, mediaItem)
@@ -8240,7 +8233,6 @@ class ExportService {
               includeVideoPoster: options.format === 'html',
               includeVoiceWithTranscript: true,
               exportVideos: options.exportVideos,
-              imageDeepSearchOnMiss: options.imageDeepSearchOnMiss,
               dirCache: mediaDirCache
             })
             mediaCache.set(mediaKey, mediaItem)

electron/services/httpService.ts

@@ -1208,6 +1208,30 @@ class HttpService {
     const sessionDir = path.join(this.getApiMediaExportPath(), this.sanitizeFileName(talker, 'session'))
     this.ensureDir(sessionDir)
 
+    // 预热图片 hardlink 索引，减少逐条导出时的查找开销
+    if (options.exportImages) {
+      const imageMd5Set = new Set<string>()
+      for (const msg of messages) {
+        if (msg.localType !== 3) continue
+        const imageMd5 = String(msg.imageMd5 || '').trim().toLowerCase()
+        if (imageMd5) {
+          imageMd5Set.add(imageMd5)
+          continue
+        }
+        const imageDatName = String(msg.imageDatName || '').trim().toLowerCase()
+        if (/^[a-f0-9]{32}$/i.test(imageDatName)) {
+          imageMd5Set.add(imageDatName)
+        }
+      }
+      if (imageMd5Set.size > 0) {
+        try {
+          await imageDecryptService.preloadImageHardlinkMd5s(Array.from(imageMd5Set))
+        } catch {
+          // ignore preload failures
+        }
+      }
+    }
+
     for (const msg of messages) {
       const exported = await this.exportMediaForMessage(msg, talker, sessionDir, options)
       if (exported) {
@@ -1230,13 +1254,39 @@ class HttpService {
           sessionId: talker,
           imageMd5: msg.imageMd5,
           imageDatName: msg.imageDatName,
-          force: true
+          createTime: msg.createTime,
+          force: true,
+          preferFilePath: true,
+          hardlinkOnly: true,
+          disableUpdateCheck: true,
+          suppressEvents: true
         })
-        if (result.success && result.localPath) {
+
-          let imagePath = result.localPath
+        let imagePath = result.success ? result.localPath : undefined
+        if (!imagePath) {
+          try {
+            const cached = await imageDecryptService.resolveCachedImage({
+              sessionId: talker,
+              imageMd5: msg.imageMd5,
+              imageDatName: msg.imageDatName,
+              createTime: msg.createTime,
+              preferFilePath: true,
+              hardlinkOnly: true,
+              disableUpdateCheck: true,
+              suppressEvents: true
+            })
+            if (cached.success && cached.localPath) {
+              imagePath = cached.localPath
+            }
+          } catch {
+            // ignore resolve failures
+          }
+        }
+
+        if (imagePath) {
           if (imagePath.startsWith('data:')) {
             const base64Match = imagePath.match(/^data:[^;]+;base64,(.+)$/)
-            if (base64Match) {
+            if (!base64Match) return null
             const imageBuffer = Buffer.from(base64Match[1], 'base64')
             const ext = this.detectImageExt(imageBuffer)
             const fileBase = this.sanitizeFileName(msg.imageMd5 || msg.imageDatName || `image_${msg.localId}`, `image_${msg.localId}`)
@@ -1250,7 +1300,8 @@ class HttpService {
             const relativePath = `${this.sanitizeFileName(talker, 'session')}/images/${fileName}`
             return { kind: 'image', fileName, fullPath, relativePath }
           }
-          } else if (fs.existsSync(imagePath)) {
+
+          if (fs.existsSync(imagePath)) {
             const imageBuffer = fs.readFileSync(imagePath)
             const ext = this.detectImageExt(imageBuffer)
             const fileBase = this.sanitizeFileName(msg.imageMd5 || msg.imageDatName || `image_${msg.localId}`, `image_${msg.localId}`)

electron/services/imagePreloadService.ts

@@ -4,6 +4,7 @@ type PreloadImagePayload = {
   sessionId?: string
   imageMd5?: string
   imageDatName?: string
+  createTime?: number
 }
 
 type PreloadOptions = {
@@ -74,15 +75,24 @@ export class ImagePreloadService {
         sessionId: task.sessionId,
         imageMd5: task.imageMd5,
         imageDatName: task.imageDatName,
+        createTime: task.createTime,
+        preferFilePath: true,
+        hardlinkOnly: true,
         disableUpdateCheck: !task.allowDecrypt,
-        allowCacheIndex: task.allowCacheIndex
+        allowCacheIndex: task.allowCacheIndex,
+        suppressEvents: true
       })
       if (cached.success) return
       if (!task.allowDecrypt) return
       await imageDecryptService.decryptImage({
         sessionId: task.sessionId,
         imageMd5: task.imageMd5,
-        imageDatName: task.imageDatName
+        imageDatName: task.imageDatName,
+        createTime: task.createTime,
+        preferFilePath: true,
+        hardlinkOnly: true,
+        disableUpdateCheck: true,
+        suppressEvents: true
       })
     } catch {
       // ignore preload failures

electron/services/keyServiceMac.ts

@@ -478,8 +478,6 @@ export class KeyServiceMac {
       'return "WF_ERR::" & errNum & "::" & errMsg & "::" & (pr as text)',
       'end try'
     ]
-    onStatus?.('已准备就绪，现在登录微信或退出登录后重新登录微信', 0)
-
     let stdout = ''
     try {
       const result = await execFileAsync('/usr/bin/osascript', scriptLines.flatMap(line => ['-e', line]), {

electron/services/messagePushService.ts

@@ -53,6 +53,13 @@ class MessagePushService {
     void this.refreshConfiguration('startup')
   }
 
+  stop(): void {
+    this.started = false
+    this.processing = false
+    this.rerunRequested = false
+    this.resetRuntimeState()
+  }
+
   handleDbMonitorChange(type: string, json: string): void {
     if (!this.started) return
     if (!this.isPushEnabled()) return

electron/services/nativeImageDecrypt.ts

@@ -0,0 +1,110 @@
+import { existsSync } from 'fs'
+import { join } from 'path'
+
+type NativeDecryptResult = {
+  data: Buffer
+  ext: string
+  isWxgf?: boolean
+  is_wxgf?: boolean
+}
+
+type NativeAddon = {
+  decryptDatNative: (inputPath: string, xorKey: number, aesKey?: string) => NativeDecryptResult
+}
+
+let cachedAddon: NativeAddon | null | undefined
+
+function shouldEnableNative(): boolean {
+  return process.env.WEFLOW_IMAGE_NATIVE !== '0'
+}
+
+function expandAsarCandidates(filePath: string): string[] {
+  if (!filePath.includes('app.asar') || filePath.includes('app.asar.unpacked')) {
+    return [filePath]
+  }
+  return [filePath.replace('app.asar', 'app.asar.unpacked'), filePath]
+}
+
+function getPlatformDir(): string {
+  if (process.platform === 'win32') return 'win32'
+  if (process.platform === 'darwin') return 'macos'
+  if (process.platform === 'linux') return 'linux'
+  return process.platform
+}
+
+function getArchDir(): string {
+  if (process.arch === 'x64') return 'x64'
+  if (process.arch === 'arm64') return 'arm64'
+  return process.arch
+}
+
+function getAddonCandidates(): string[] {
+  const platformDir = getPlatformDir()
+  const archDir = getArchDir()
+  const cwd = process.cwd()
+  const fileNames = [
+    `weflow-image-native-${platformDir}-${archDir}.node`
+  ]
+  const roots = [
+    join(cwd, 'resources', 'wedecrypt', platformDir, archDir),
+    ...(process.resourcesPath
+      ? [
+          join(process.resourcesPath, 'resources', 'wedecrypt', platformDir, archDir),
+          join(process.resourcesPath, 'wedecrypt', platformDir, archDir)
+        ]
+      : [])
+  ]
+  const candidates = roots.flatMap((root) => fileNames.map((name) => join(root, name)))
+  return Array.from(new Set(candidates.flatMap(expandAsarCandidates)))
+}
+
+function loadAddon(): NativeAddon | null {
+  if (!shouldEnableNative()) return null
+  if (cachedAddon !== undefined) return cachedAddon
+
+  for (const candidate of getAddonCandidates()) {
+    if (!existsSync(candidate)) continue
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const addon = require(candidate) as NativeAddon
+      if (addon && typeof addon.decryptDatNative === 'function') {
+        cachedAddon = addon
+        return addon
+      }
+    } catch {
+      // try next candidate
+    }
+  }
+
+  cachedAddon = null
+  return null
+}
+
+export function nativeAddonLocation(): string | null {
+  for (const candidate of getAddonCandidates()) {
+    if (existsSync(candidate)) return candidate
+  }
+  return null
+}
+
+export function decryptDatViaNative(
+  inputPath: string,
+  xorKey: number,
+  aesKey?: string
+): { data: Buffer; ext: string; isWxgf: boolean } | null {
+  const addon = loadAddon()
+  if (!addon) return null
+
+  try {
+    const result = addon.decryptDatNative(inputPath, xorKey, aesKey)
+    const isWxgf = Boolean(result?.isWxgf ?? result?.is_wxgf)
+    if (!result || !Buffer.isBuffer(result.data)) return null
+    const rawExt = typeof result.ext === 'string' && result.ext.trim()
+      ? result.ext.trim().toLowerCase()
+      : ''
+    const ext = rawExt ? (rawExt.startsWith('.') ? rawExt : `.${rawExt}`) : ''
+    return { data: result.data, ext, isWxgf }
+  } catch {
+    return null
+  }
+}

electron/services/wcdbCore.ts

@@ -2,6 +2,7 @@ import { join, dirname, basename } from 'path'
 import { appendFileSync, existsSync, mkdirSync, readdirSync, statSync, readFileSync } from 'fs'
 import { tmpdir } from 'os'
 import * as fzstd from 'fzstd'
+import { expandHomePath } from '../utils/pathUtils'
 
 //数据服务初始化错误信息，用于帮助用户诊断问题
 let lastDllInitError: string | null = null
@@ -481,7 +482,7 @@ export class WcdbCore {
 
   private resolveDbStoragePath(basePath: string, wxid: string): string | null {
     if (!basePath) return null
-    const normalized = basePath.replace(/[\\\\/]+$/, '')
+    const normalized = expandHomePath(basePath).replace(/[\\\\/]+$/, '')
     if (normalized.toLowerCase().endsWith('db_storage') && existsSync(normalized)) {
       return normalized
     }
@@ -1600,6 +1601,9 @@ export class WcdbCore {
    */
   close(): void {
     if (this.handle !== null || this.initialized) {
+      // 先停止监控与云控回调，避免 shutdown 后仍有 native 回调访问已释放资源。
+      try { this.stopMonitor() } catch {}
+      try { this.cloudStop() } catch {}
       try {
         // 不调用 closeAccount，直接 shutdown
         this.wcdbShutdown()

electron/utils/pathUtils.ts

@@ -0,0 +1,20 @@
+import { homedir } from 'os'
+
+/**
+ * Expand "~" prefix to current user's home directory.
+ * Examples:
+ * - "~" => "/Users/alex"
+ * - "~/Library/..." => "/Users/alex/Library/..."
+ */
+export function expandHomePath(inputPath: string): string {
+  const raw = String(inputPath || '').trim()
+  if (!raw) return raw
+
+  if (raw === '~') return homedir()
+  if (/^~[\\/]/.test(raw)) {
+    return `${homedir()}${raw.slice(1)}`
+  }
+
+  return raw
+}
+

package-lock.json

@@ -9,7 +9,6 @@
       "version": "4.3.0",
       "hasInstallScript": true,
       "dependencies": {
-        "@vscode/sudo-prompt": "^9.3.2",
         "echarts": "^6.0.0",
         "echarts-for-react": "^3.0.2",
         "electron-store": "^11.0.2",
@@ -28,8 +27,9 @@
         "react-router-dom": "^7.14.0",
         "react-virtuoso": "^4.18.1",
         "remark-gfm": "^4.0.1",
-        "sherpa-onnx-node": "^1.12.35",
+        "sherpa-onnx-node": "^1.10.38",
         "silk-wasm": "^3.7.1",
+        "sudo-prompt": "^9.2.1",
         "wechat-emojis": "^1.0.2",
         "zustand": "^5.0.2"
       },
@@ -40,11 +40,11 @@
         "@vitejs/plugin-react": "^4.3.4",
         "electron": "^41.1.1",
         "electron-builder": "^26.8.1",
-        "sass": "^1.99.0",
+        "sass": "^1.98.0",
         "sharp": "^0.34.5",
         "typescript": "^6.0.2",
-        "vite": "^7.3.2",
+        "vite": "^7.0.0",
-        "vite-plugin-electron": "^0.29.1",
+        "vite-plugin-electron": "^0.28.8",
         "vite-plugin-electron-renderer": "^0.14.6"
       }
     },
@@ -3050,12 +3050,6 @@
         "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0"
       }
     },
-    "node_modules/@vscode/sudo-prompt": {
-      "version": "9.3.2",
-      "resolved": "https://registry.npmjs.org/@vscode/sudo-prompt/-/sudo-prompt-9.3.2.tgz",
-      "integrity": "sha512-gcXoCN00METUNFeQOFJ+C9xUI0DKB+0EGMVg7wbVYRHBw2Eq3fKisDZOkRdOz3kqXRKOENMfShPOmypw1/8nOw==",
-      "license": "MIT"
-    },
     "node_modules/@xmldom/xmldom": {
       "version": "0.8.12",
       "resolved": "https://registry.npmjs.org/@xmldom/xmldom/-/xmldom-0.8.12.tgz",
@@ -9462,6 +9456,13 @@
         "inline-style-parser": "0.2.7"
       }
     },
+    "node_modules/sudo-prompt": {
+      "version": "9.2.1",
+      "resolved": "https://registry.npmjs.org/sudo-prompt/-/sudo-prompt-9.2.1.tgz",
+      "integrity": "sha512-Mu7R0g4ig9TUuGSxJavny5Rv0egCEtpZRNMrZaYS1vxkiIxGiGUwoezU3LazIQ+KE04hTrTfNPgxU5gzi7F5Pw==",
+      "deprecated": "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.",
+      "license": "MIT"
+    },
     "node_modules/sumchecker": {
       "version": "3.0.1",
       "resolved": "https://registry.npmjs.org/sumchecker/-/sumchecker-3.0.1.tgz",
@@ -10140,9 +10141,9 @@
       }
     },
     "node_modules/vite-plugin-electron": {
-      "version": "0.29.1",
+      "version": "0.28.8",
-      "resolved": "https://registry.npmjs.org/vite-plugin-electron/-/vite-plugin-electron-0.29.1.tgz",
+      "resolved": "https://registry.npmjs.org/vite-plugin-electron/-/vite-plugin-electron-0.28.8.tgz",
-      "integrity": "sha512-AejNed5BgHFnuw8h5puTa61C6vdP4ydbsbo/uVjH1fTdHAlCDz1+o6pDQ/scQj1udDrGvH01+vTbzQh/vMnR9w==",
+      "integrity": "sha512-ir+B21oSGK9j23OEvt4EXyco9xDCaF6OGFe0V/8Zc0yL2+HMyQ6mmNQEIhXsEsZCSfIowBpwQBeHH4wVsfraeg==",
       "dev": true,
       "license": "MIT",
       "peerDependencies": {

package.json

@@ -9,7 +9,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/Jasonzhu1207/WeFlow"
+    "url": "https://github.com/hicccc77/WeFlow"
   },
   "//": "二改不应改变此处的作者与应用信息",
   "scripts": {
@@ -77,7 +77,7 @@
     "appId": "com.WeFlow.app",
     "publish": {
       "provider": "github",
-      "owner": "Jasonzhu1207",
+      "owner": "hicccc77",
       "repo": "WeFlow",
       "releaseType": "release"
     },
@@ -96,7 +96,7 @@
       "gatekeeperAssess": false,
       "entitlements": "electron/entitlements.mac.plist",
       "entitlementsInherit": "electron/entitlements.mac.plist",
-      "icon": "resources/icon.icns"
+      "icon": "resources/icons/macos/icon.icns"
     },
     "win": {
       "target": [
@@ -105,19 +105,19 @@
       "icon": "public/icon.ico",
       "extraFiles": [
         {
-          "from": "resources/msvcp140.dll",
+          "from": "resources/runtime/win32/msvcp140.dll",
           "to": "."
         },
         {
-          "from": "resources/msvcp140_1.dll",
+          "from": "resources/runtime/win32/msvcp140_1.dll",
           "to": "."
         },
         {
-          "from": "resources/vcruntime140.dll",
+          "from": "resources/runtime/win32/vcruntime140.dll",
           "to": "."
         },
         {
-          "from": "resources/vcruntime140_1.dll",
+          "from": "resources/runtime/win32/vcruntime140_1.dll",
           "to": "."
         }
       ]
@@ -133,7 +133,7 @@
       "synopsis": "WeFlow for Linux",
       "extraFiles": [
         {
-          "from": "resources/linux/install.sh",
+          "from": "resources/installer/linux/install.sh",
           "to": "install.sh"
         }
       ]
@@ -186,9 +186,10 @@
       "node_modules/sherpa-onnx-node/**/*",
       "node_modules/sherpa-onnx-*/*",
       "node_modules/sherpa-onnx-*/**/*",
-      "node_modules/ffmpeg-static/**/*"
+      "node_modules/ffmpeg-static/**/*",
+      "resources/wedecrypt/**/*.node"
     ],
-    "icon": "resources/icon.icns"
+    "icon": "resources/icons/macos/icon.icns"
   },
   "overrides": {
     "picomatch": "^4.0.4",

src/App.tsx

@@ -39,8 +39,6 @@ import UpdateDialog from './components/UpdateDialog'
 import UpdateProgressCapsule from './components/UpdateProgressCapsule'
 import LockScreen from './components/LockScreen'
 import { GlobalSessionMonitor } from './components/GlobalSessionMonitor'
-import { BatchTranscribeGlobal } from './components/BatchTranscribeGlobal'
-import { BatchImageDecryptGlobal } from './components/BatchImageDecryptGlobal'
 import WindowCloseDialog from './components/WindowCloseDialog'
 
 function RouteStateRedirect({ to }: { to: string }) {
@@ -554,10 +552,6 @@ function App() {
       {/* 全局会话监听与通知 */}
       <GlobalSessionMonitor />
 
-      {/* 全局批量转写进度浮窗 */}
-      <BatchTranscribeGlobal />
-      <BatchImageDecryptGlobal />
-
       {/* 用户协议弹窗 */}
       {showAgreement && !agreementLoading && (
         <div className="agreement-overlay">

src/pages/ChatPage.tsx

@@ -29,6 +29,7 @@ import {
   onSingleExportDialogStatus,
   requestExportSessionStatus
 } from '../services/exportBridge'
+import '../styles/batchTranscribe.scss'
 import './ChatPage.scss'
 
 // 系统消息类型常量
@@ -154,6 +155,21 @@ function hasRenderableChatRecordName(value?: string): boolean {
   return value !== undefined && value !== null && String(value).length > 0
 }
 
+function toRenderableImageSrc(path?: string): string | undefined {
+  const raw = String(path || '').trim()
+  if (!raw) return undefined
+  if (/^(data:|blob:|https?:|file:)/i.test(raw)) return raw
+
+  const normalized = raw.replace(/\\/g, '/')
+  if (/^[a-zA-Z]:\//.test(normalized)) {
+    return encodeURI(`file:///${normalized}`)
+  }
+  if (normalized.startsWith('/')) {
+    return encodeURI(`file://${normalized}`)
+  }
+  return raw
+}
+
 function getChatRecordPreviewText(item: ChatRecordItem): string {
   const text = normalizeChatRecordText(item.datadesc) || normalizeChatRecordText(item.datatitle)
   if (item.datatype === 17) {
@@ -1355,34 +1371,30 @@ function ChatPage(props: ChatPageProps) {
   const {
     isBatchTranscribing,
     runningBatchVoiceTaskType,
-    batchTranscribeProgress,
     startTranscribe,
     updateProgress,
-    finishTranscribe,
+    updateTranscribeTaskStatus,
-    setShowBatchProgress
+    finishTranscribe
   } = useBatchTranscribeStore(useShallow((state) => ({
     isBatchTranscribing: state.isBatchTranscribing,
     runningBatchVoiceTaskType: state.taskType,
-    batchTranscribeProgress: state.progress,
     startTranscribe: state.startTranscribe,
     updateProgress: state.updateProgress,
-    finishTranscribe: state.finishTranscribe,
+    updateTranscribeTaskStatus: state.setTaskStatus,
-    setShowBatchProgress: state.setShowToast
+    finishTranscribe: state.finishTranscribe
   })))
   const {
     isBatchDecrypting,
-    batchDecryptProgress,
     startDecrypt,
     updateDecryptProgress,
-    finishDecrypt,
+    updateDecryptTaskStatus,
-    setShowBatchDecryptToast
+    finishDecrypt
   } = useBatchImageDecryptStore(useShallow((state) => ({
     isBatchDecrypting: state.isBatchDecrypting,
-    batchDecryptProgress: state.progress,
     startDecrypt: state.startDecrypt,
     updateDecryptProgress: state.updateProgress,
-    finishDecrypt: state.finishDecrypt,
+    updateDecryptTaskStatus: state.setTaskStatus,
-    setShowBatchDecryptToast: state.setShowToast
+    finishDecrypt: state.finishDecrypt
   })))
   const [showBatchConfirm, setShowBatchConfirm] = useState(false)
   const [batchVoiceCount, setBatchVoiceCount] = useState(0)
@@ -4853,7 +4865,7 @@ function ChatPage(props: ChatPageProps) {
     const candidates = [...head, ...tail]
     const queued = preloadImageKeysRef.current
     const seen = new Set<string>()
-    const payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string }> = []
+    const payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string; createTime?: number }> = []
     for (const msg of candidates) {
       if (payloads.length >= maxPreload) break
       if (msg.localType !== 3) continue
@@ -4867,11 +4879,14 @@ function ChatPage(props: ChatPageProps) {
       payloads.push({
         sessionId: currentSessionId,
         imageMd5: msg.imageMd5 || undefined,
-        imageDatName: msg.imageDatName
+        imageDatName: msg.imageDatName,
+        createTime: msg.createTime
       })
     }
     if (payloads.length > 0) {
-      window.electronAPI.image.preload(payloads).catch(() => { })
+      window.electronAPI.image.preload(payloads, {
+        allowCacheIndex: false
+      }).catch(() => { })
     }
   }, [currentSessionId, messages])
 
@@ -5712,22 +5727,74 @@ function ChatPage(props: ChatPageProps) {
     if (!session) return
 
     const taskType = batchVoiceTaskType
-    startTranscribe(voiceMessages.length, session.displayName || session.username, taskType)
+    const totalVoices = voiceMessages.length
-
+    const taskVerb = taskType === 'decrypt' ? '语音解密' : '语音转写'
-    if (taskType === 'transcribe') {
-      // 检查模型状态
-      const modelStatus = await window.electronAPI.whisper.getModelStatus()
-      if (!modelStatus?.exists) {
-        alert('SenseVoice 模型未下载，请先在设置中下载模型')
-        finishTranscribe(0, 0)
-        return
-      }
-    }
-
     let successCount = 0
     let failCount = 0
     let completedCount = 0
     const concurrency = taskType === 'decrypt' ? 12 : 10
+    const controlState = {
+      cancelRequested: false,
+      pauseRequested: false,
+      pauseAnnounced: false,
+      resumeWaiters: [] as Array<() => void>
+    }
+    const resolveResumeWaiters = () => {
+      const waiters = [...controlState.resumeWaiters]
+      controlState.resumeWaiters.length = 0
+      waiters.forEach(resolve => resolve())
+    }
+    const waitIfPaused = async () => {
+      while (controlState.pauseRequested && !controlState.cancelRequested) {
+        if (!controlState.pauseAnnounced) {
+          controlState.pauseAnnounced = true
+          updateTranscribeTaskStatus(
+            `${taskVerb}任务已中断，等待继续...`,
+            `${completedCount} / ${totalVoices}`,
+            'paused'
+          )
+        }
+        await new Promise<void>(resolve => {
+          controlState.resumeWaiters.push(resolve)
+        })
+      }
+      if (controlState.pauseAnnounced && !controlState.cancelRequested) {
+        controlState.pauseAnnounced = false
+        updateTranscribeTaskStatus(
+          `继续${taskVerb}（${completedCount}/${totalVoices}）`,
+          `${completedCount} / ${totalVoices}`,
+          'running'
+        )
+      }
+    }
+
+    startTranscribe(totalVoices, session.displayName || session.username, taskType, 'chat', {
+      cancelable: true,
+      resumable: true,
+      onPause: () => {
+        controlState.pauseRequested = true
+        updateTranscribeTaskStatus(
+          `${taskVerb}中断请求已发出，当前处理完成后暂停...`,
+          `${completedCount} / ${totalVoices}`,
+          'pause_requested'
+        )
+      },
+      onResume: () => {
+        controlState.pauseRequested = false
+        resolveResumeWaiters()
+      },
+      onCancel: () => {
+        controlState.cancelRequested = true
+        controlState.pauseRequested = false
+        resolveResumeWaiters()
+        updateTranscribeTaskStatus(
+          `${taskVerb}停止请求已发出，当前处理完成后结束...`,
+          `${completedCount} / ${totalVoices}`,
+          'cancel_requested'
+        )
+      }
+    })
+    updateTranscribeTaskStatus(`正在准备${taskVerb}任务...`, `0 / ${totalVoices}`, 'running')
 
     const runOne = async (msg: Message) => {
       try {
@@ -5751,20 +5818,74 @@ function ChatPage(props: ChatPageProps) {
       }
     }
 
-    for (let i = 0; i < voiceMessages.length; i += concurrency) {
+    try {
-      const batch = voiceMessages.slice(i, i + concurrency)
+      if (taskType === 'transcribe') {
-      const results = await Promise.all(batch.map(msg => runOne(msg)))
+        updateTranscribeTaskStatus('正在检查转写模型...', `0 / ${totalVoices}`)
+        const modelStatus = await window.electronAPI.whisper.getModelStatus()
+        if (!modelStatus?.exists) {
+          alert('SenseVoice 模型未下载，请先在设置中下载模型')
+          updateTranscribeTaskStatus('转写模型缺失，任务已停止', `0 / ${totalVoices}`)
+          finishTranscribe(0, totalVoices)
+          return
+        }
+      }
 
-      results.forEach(result => {
+      updateTranscribeTaskStatus(`正在${taskVerb}（0/${totalVoices}）`, `0 / ${totalVoices}`)
+      const pool = new Set<Promise<void>>()
+
+      const runOneTracked = async (msg: Message) => {
+        if (controlState.cancelRequested) return
+        const result = await runOne(msg)
         if (result.success) successCount++
         else failCount++
         completedCount++
-        updateProgress(completedCount, voiceMessages.length)
+        updateProgress(completedCount, totalVoices)
-      })
       }
 
-    finishTranscribe(successCount, failCount)
+      for (const msg of voiceMessages) {
-  }, [sessions, currentSessionId, batchSelectedDates, batchVoiceMessages, batchVoiceTaskType, startTranscribe, updateProgress, finishTranscribe])
+        if (controlState.cancelRequested) break
+        await waitIfPaused()
+        if (controlState.cancelRequested) break
+        if (pool.size >= concurrency) {
+          await Promise.race(pool)
+          if (controlState.cancelRequested) break
+          await waitIfPaused()
+          if (controlState.cancelRequested) break
+        }
+        let p: Promise<void> = Promise.resolve()
+        p = runOneTracked(msg).finally(() => {
+          pool.delete(p)
+        })
+        pool.add(p)
+      }
+
+      while (pool.size > 0) {
+        await Promise.race(pool)
+      }
+
+      if (controlState.cancelRequested) {
+        const remaining = Math.max(0, totalVoices - completedCount)
+        finishTranscribe(successCount, failCount, {
+          status: 'canceled',
+          detail: `${taskVerb}任务已中断：已完成 ${completedCount}/${totalVoices}（成功 ${successCount}，失败 ${failCount}，未处理 ${remaining}）`,
+          progressText: `${completedCount} / ${totalVoices}`
+        })
+        return
+      }
+
+      finishTranscribe(successCount, failCount, {
+        status: failCount > 0 ? 'failed' : 'completed'
+      })
+    } catch (error) {
+      const remaining = Math.max(0, totalVoices - completedCount)
+      failCount += remaining
+      updateTranscribeTaskStatus(`${taskVerb}过程中发生异常，正在结束任务...`, `${completedCount} / ${totalVoices}`)
+      finishTranscribe(successCount, failCount, {
+        status: 'failed'
+      })
+      alert(`批量${taskVerb}失败：${String(error)}`)
+    }
+  }, [sessions, currentSessionId, batchSelectedDates, batchVoiceMessages, batchVoiceTaskType, startTranscribe, updateTranscribeTaskStatus, updateProgress, finishTranscribe])
 
   // 批量转写：按日期的消息数量
   const batchCountByDate = useMemo(() => {
@@ -5827,45 +5948,175 @@ function ChatPage(props: ChatPageProps) {
     setBatchImageDates([])
     setBatchImageSelectedDates(new Set())
 
-    startDecrypt(images.length, session.displayName || session.username)
+    const totalImages = images.length
-
     let successCount = 0
     let failCount = 0
+    let notFoundCount = 0
+    let decryptFailedCount = 0
     let completed = 0
+    const controlState = {
+      cancelRequested: false,
+      pauseRequested: false,
+      pauseAnnounced: false,
+      resumeWaiters: [] as Array<() => void>
+    }
+    const resolveResumeWaiters = () => {
+      const waiters = [...controlState.resumeWaiters]
+      controlState.resumeWaiters.length = 0
+      waiters.forEach(resolve => resolve())
+    }
+    const waitIfPaused = async () => {
+      while (controlState.pauseRequested && !controlState.cancelRequested) {
+        if (!controlState.pauseAnnounced) {
+          controlState.pauseAnnounced = true
+          updateDecryptTaskStatus(
+            '图片批量解密任务已中断，等待继续...',
+            `${completed} / ${totalImages}`,
+            'paused'
+          )
+        }
+        await new Promise<void>(resolve => {
+          controlState.resumeWaiters.push(resolve)
+        })
+      }
+      if (controlState.pauseAnnounced && !controlState.cancelRequested) {
+        controlState.pauseAnnounced = false
+        updateDecryptTaskStatus(
+          `继续批量解密图片（${completed}/${totalImages}）`,
+          `${completed} / ${totalImages}`,
+          'running'
+        )
+      }
+    }
+
+    startDecrypt(totalImages, session.displayName || session.username, 'chat', {
+      cancelable: true,
+      resumable: true,
+      onPause: () => {
+        controlState.pauseRequested = true
+        updateDecryptTaskStatus(
+          '图片解密中断请求已发出，当前处理完成后暂停...',
+          `${completed} / ${totalImages}`,
+          'pause_requested'
+        )
+      },
+      onResume: () => {
+        controlState.pauseRequested = false
+        resolveResumeWaiters()
+      },
+      onCancel: () => {
+        controlState.cancelRequested = true
+        controlState.pauseRequested = false
+        resolveResumeWaiters()
+        updateDecryptTaskStatus(
+          '图片解密停止请求已发出，当前处理完成后结束...',
+          `${completed} / ${totalImages}`,
+          'cancel_requested'
+        )
+      }
+    })
+    updateDecryptTaskStatus('正在准备批量图片解密任务...', `0 / ${totalImages}`, 'running')
+
+    const hardlinkMd5Set = new Set<string>()
+    for (const img of images) {
+      const imageMd5 = String(img.imageMd5 || '').trim().toLowerCase()
+      if (imageMd5) {
+        hardlinkMd5Set.add(imageMd5)
+        continue
+      }
+      const imageDatName = String(img.imageDatName || '').trim().toLowerCase()
+      if (/^[a-f0-9]{32}$/i.test(imageDatName)) {
+        hardlinkMd5Set.add(imageDatName)
+      }
+    }
+    if (hardlinkMd5Set.size > 0) {
+      await waitIfPaused()
+      if (controlState.cancelRequested) {
+        const remaining = Math.max(0, totalImages - completed)
+        finishDecrypt(successCount, failCount, {
+          status: 'canceled',
+          detail: `图片批量解密已中断：已处理 ${completed}/${totalImages}（成功 ${successCount}，未找到 ${notFoundCount}，解密失败 ${decryptFailedCount}，未处理 ${remaining}）`,
+          progressText: `成功 ${successCount} / 未找到 ${notFoundCount} / 解密失败 ${decryptFailedCount}`
+        })
+        return
+      }
+      updateDecryptTaskStatus(
+        `正在预热图片索引（${hardlinkMd5Set.size} 个标识）...`,
+        `0 / ${totalImages}`
+      )
+      try {
+        await window.electronAPI.image.preloadHardlinkMd5s(Array.from(hardlinkMd5Set))
+      } catch {
+        // ignore preload failures and continue decrypt
+      }
+    }
+    updateDecryptTaskStatus(`开始批量解密图片（0/${totalImages}）`, `0 / ${totalImages}`)
+
     const concurrency = batchDecryptConcurrency
 
     const decryptOne = async (img: typeof images[0]) => {
+      if (controlState.cancelRequested) return
       try {
         const r = await window.electronAPI.image.decrypt({
           sessionId: session.username,
           imageMd5: img.imageMd5,
           imageDatName: img.imageDatName,
-          force: true
+          createTime: img.createTime,
+          force: true,
+          preferFilePath: true,
+          hardlinkOnly: true,
+          disableUpdateCheck: true,
+          suppressEvents: true
         })
         if (r?.success) successCount++
-        else failCount++
+        else {
+          failCount++
+          if (r?.failureKind === 'decrypt_failed') decryptFailedCount++
+          else notFoundCount++
+        }
       } catch {
         failCount++
+        notFoundCount++
       }
       completed++
-      updateDecryptProgress(completed, images.length)
+      updateDecryptProgress(completed, totalImages)
     }
 
-    // 并发池：同时跑 concurrency 个任务
     const pool = new Set<Promise<void>>()
     for (const img of images) {
-      const p = decryptOne(img).then(() => { pool.delete(p) })
+      if (controlState.cancelRequested) break
-      pool.add(p)
+      await waitIfPaused()
+      if (controlState.cancelRequested) break
       if (pool.size >= concurrency) {
         await Promise.race(pool)
+        if (controlState.cancelRequested) break
+        await waitIfPaused()
+        if (controlState.cancelRequested) break
       }
+      let p: Promise<void> = Promise.resolve()
+      p = decryptOne(img).then(() => { pool.delete(p) })
+      pool.add(p)
     }
-    if (pool.size > 0) {
+    while (pool.size > 0) {
-      await Promise.all(pool)
+      await Promise.race(pool)
     }
 
-    finishDecrypt(successCount, failCount)
+    if (controlState.cancelRequested) {
-  }, [batchImageMessages, batchImageSelectedDates, batchDecryptConcurrency, currentSessionId, finishDecrypt, sessions, startDecrypt, updateDecryptProgress])
+      const remaining = Math.max(0, totalImages - completed)
+      finishDecrypt(successCount, failCount, {
+        status: 'canceled',
+        detail: `图片批量解密已中断：已处理 ${completed}/${totalImages}（成功 ${successCount}，未找到 ${notFoundCount}，解密失败 ${decryptFailedCount}，未处理 ${remaining}）`,
+        progressText: `成功 ${successCount} / 未找到 ${notFoundCount} / 解密失败 ${decryptFailedCount}`
+      })
+      return
+    }
+
+    finishDecrypt(successCount, failCount, {
+      status: decryptFailedCount > 0 ? 'failed' : 'completed',
+      detail: `图片批量解密完成：成功 ${successCount}，未找到 ${notFoundCount}，解密失败 ${decryptFailedCount}`,
+      progressText: `成功 ${successCount} / 未找到 ${notFoundCount} / 解密失败 ${decryptFailedCount}`
+    })
+  }, [batchImageMessages, batchImageSelectedDates, batchDecryptConcurrency, currentSessionId, finishDecrypt, sessions, startDecrypt, updateDecryptTaskStatus, updateDecryptProgress])
 
   const batchImageCountByDate = useMemo(() => {
     const map = new Map<string, number>()
@@ -6600,16 +6851,10 @@ function ChatPage(props: ChatPageProps) {
                 {!standaloneSessionWindow && (
                   <button
                     className={`icon-btn batch-transcribe-btn${isBatchTranscribing ? ' transcribing' : ''}`}
-                    onClick={() => {
+                    onClick={handleBatchTranscribe}
-                      if (isBatchTranscribing) {
-                        setShowBatchProgress(true)
-                      } else {
-                        handleBatchTranscribe()
-                      }
-                    }}
                     disabled={!currentSessionId}
                     title={isBatchTranscribing
-                      ? `${runningBatchVoiceTaskType === 'decrypt' ? '批量语音解密' : '批量转写'}中 (${batchTranscribeProgress.current}/${batchTranscribeProgress.total})，点击查看进度`
+                      ? `${runningBatchVoiceTaskType === 'decrypt' ? '批量语音解密' : '批量转写'}中，可在导出页任务中心查看进度`
                       : '批量语音处理（解密/转文字）'}
                   >
                     {isBatchTranscribing ? (
@@ -6622,16 +6867,10 @@ function ChatPage(props: ChatPageProps) {
                 {!standaloneSessionWindow && (
                   <button
                     className={`icon-btn batch-decrypt-btn${isBatchDecrypting ? ' transcribing' : ''}`}
-                    onClick={() => {
+                    onClick={handleBatchDecrypt}
-                      if (isBatchDecrypting) {
-                        setShowBatchDecryptToast(true)
-                      } else {
-                        handleBatchDecrypt()
-                      }
-                    }}
                     disabled={!currentSessionId}
                     title={isBatchDecrypting
-                      ? `批量解密中 (${batchDecryptProgress.current}/${batchDecryptProgress.total})，点击查看进度`
+                      ? '批量解密中，可在导出页任务中心查看进度'
                       : '批量解密图片'}
                   >
                     {isBatchDecrypting ? (
@@ -7309,8 +7548,8 @@ function ChatPage(props: ChatPageProps) {
                 <AlertCircle size={16} />
                 <span>
                   {batchVoiceTaskType === 'decrypt'
-                    ? '批量解密会预先缓存语音数据，之后播放和转写会更快。解密过程中可以继续使用其他功能。'
+                    ? '批量解密会预先缓存语音数据，之后播放和转写会更快。解密过程中可以继续使用其他功能，进度会写入导出页任务中心。'
-                    : '批量转写可能需要较长时间，转写过程中可以继续使用其他功能。已转写过的语音会自动跳过。'}
+                    : '批量转写可能需要较长时间，转写过程中可以继续使用其他功能。已转写过的语音会自动跳过，进度会写入导出页任务中心。'}
                 </span>
               </div>
             </div>
@@ -7377,17 +7616,17 @@ function ChatPage(props: ChatPageProps) {
                       className={`batch-concurrency-trigger ${showConcurrencyDropdown ? 'open' : ''}`}
                       onClick={() => setShowConcurrencyDropdown(!showConcurrencyDropdown)}
                     >
-                      <span>{batchDecryptConcurrency === 1 ? '1（最慢，最稳）' : batchDecryptConcurrency === 6 ? '6（推荐）' : batchDecryptConcurrency === 20 ? '20（最快，可能卡顿）' : String(batchDecryptConcurrency)}</span>
+                      <span>{batchDecryptConcurrency === 1 ? '1' : batchDecryptConcurrency === 6 ? '6' : batchDecryptConcurrency === 20 ? '20' : String(batchDecryptConcurrency)}</span>
                       <ChevronDown size={14} />
                     </button>
                     {showConcurrencyDropdown && (
                       <div className="batch-concurrency-dropdown">
                         {[
-                          { value: 1, label: '1（最慢，最稳）' },
+                          { value: 1, label: '1' },
                           { value: 3, label: '3' },
-                          { value: 6, label: '6（推荐）' },
+                          { value: 6, label: '6' },
                           { value: 10, label: '10' },
-                          { value: 20, label: '20（最快，可能卡顿）' },
+                          { value: 20, label: '20' },
                         ].map(opt => (
                           <button
                             key={opt.value}
@@ -7405,7 +7644,7 @@ function ChatPage(props: ChatPageProps) {
               </div>
               <div className="batch-warning">
                 <AlertCircle size={16} />
-                <span>批量解密可能需要较长时间，进行中会在右下角显示非阻塞进度浮层。</span>
+                <span>批量解密可能需要较长时间，进度会自动写入导出页任务中心（含准备阶段状态）。</span>
               </div>
             </div>
             <div className="batch-modal-footer">
@@ -7768,7 +8007,13 @@ const emojiDataUrlCache = new Map<string, string>()
 const imageDataUrlCache = new Map<string, string>()
 const voiceDataUrlCache = new Map<string, string>()
 const voiceTranscriptCache = new Map<string, string>()
-type SharedImageDecryptResult = { success: boolean; localPath?: string; liveVideoPath?: string; error?: string }
+type SharedImageDecryptResult = {
+  success: boolean
+  localPath?: string
+  liveVideoPath?: string
+  error?: string
+  failureKind?: 'not_found' | 'decrypt_failed'
+}
 const imageDecryptInFlight = new Map<string, Promise<SharedImageDecryptResult>>()
 const senderAvatarCache = new Map<string, { avatarUrl?: string; displayName?: string }>()
 const senderAvatarLoading = new Map<string, Promise<{ avatarUrl?: string; displayName?: string } | null>>()
@@ -7882,7 +8127,7 @@ function MessageBubble({
   )
   const imageCacheKey = message.imageMd5 || message.imageDatName || `local:${message.localId}`
   const [imageLocalPath, setImageLocalPath] = useState<string | undefined>(
-    () => imageDataUrlCache.get(imageCacheKey)
+    () => toRenderableImageSrc(imageDataUrlCache.get(imageCacheKey))
   )
   const voiceIdentityKey = buildVoiceCacheIdentity(session.username, message)
   const voiceCacheKey = `voice:${voiceIdentityKey}`
@@ -7904,6 +8149,7 @@ function MessageBubble({
   const imageUpdateCheckedRef = useRef<string | null>(null)
   const imageClickTimerRef = useRef<number | null>(null)
   const imageContainerRef = useRef<HTMLDivElement>(null)
+  const imageElementRef = useRef<HTMLImageElement | null>(null)
   const emojiContainerRef = useRef<HTMLDivElement>(null)
   const imageResizeBaselineRef = useRef<number | null>(null)
   const emojiResizeBaselineRef = useRef<number | null>(null)
@@ -8260,19 +8506,27 @@ function MessageBubble({
             sessionId: session.username,
             imageMd5: message.imageMd5 || undefined,
             imageDatName: message.imageDatName,
-            force: forceUpdate
+            createTime: message.createTime,
+            force: forceUpdate,
+            preferFilePath: true,
+            hardlinkOnly: true
           }) as SharedImageDecryptResult
         })
         if (result.success && result.localPath) {
-          imageDataUrlCache.set(imageCacheKey, result.localPath)
+          const renderPath = toRenderableImageSrc(result.localPath)
-          if (imageLocalPath !== result.localPath) {
+          if (!renderPath) {
+            if (!silent) setImageError(true)
+            return { success: false }
+          }
+          imageDataUrlCache.set(imageCacheKey, renderPath)
+          if (imageLocalPath !== renderPath) {
             captureImageResizeBaseline()
             lockImageStageHeight()
           }
-          setImageLocalPath(result.localPath)
+          setImageLocalPath(renderPath)
           setImageHasUpdate(false)
           if (result.liveVideoPath) setImageLiveVideoPath(result.liveVideoPath)
-          return result
+          return { ...result, localPath: renderPath }
         }
       }
 
@@ -8297,7 +8551,7 @@ function MessageBubble({
       imageDecryptPendingRef.current = false
     }
     return { success: false }
-  }, [isImage, message.imageMd5, message.imageDatName, message.localId, session.username, imageCacheKey, detectImageMimeFromBase64, imageLocalPath, captureImageResizeBaseline, lockImageStageHeight])
+  }, [isImage, message.imageMd5, message.imageDatName, message.createTime, message.localId, session.username, imageCacheKey, detectImageMimeFromBase64, imageLocalPath, captureImageResizeBaseline, lockImageStageHeight])
 
   const triggerForceHd = useCallback(() => {
     if (!message.imageMd5 && !message.imageDatName) return
@@ -8352,24 +8606,29 @@ function MessageBubble({
         const resolved = await window.electronAPI.image.resolveCache({
           sessionId: session.username,
           imageMd5: message.imageMd5 || undefined,
-          imageDatName: message.imageDatName
+          imageDatName: message.imageDatName,
+          createTime: message.createTime,
+          preferFilePath: true,
+          hardlinkOnly: true
         })
         if (resolved?.success && resolved.localPath) {
-          finalImagePath = resolved.localPath
+          const renderPath = toRenderableImageSrc(resolved.localPath)
+          if (!renderPath) return
+          finalImagePath = renderPath
           finalLiveVideoPath = resolved.liveVideoPath || finalLiveVideoPath
-          imageDataUrlCache.set(imageCacheKey, resolved.localPath)
+          imageDataUrlCache.set(imageCacheKey, renderPath)
-          if (imageLocalPath !== resolved.localPath) {
+          if (imageLocalPath !== renderPath) {
             captureImageResizeBaseline()
             lockImageStageHeight()
           }
-          setImageLocalPath(resolved.localPath)
+          setImageLocalPath(renderPath)
           if (resolved.liveVideoPath) setImageLiveVideoPath(resolved.liveVideoPath)
           setImageHasUpdate(Boolean(resolved.hasUpdate))
         }
       } catch { }
     }
 
-    void window.electronAPI.window.openImageViewerWindow(finalImagePath, finalLiveVideoPath)
+    void window.electronAPI.window.openImageViewerWindow(toRenderableImageSrc(finalImagePath) || finalImagePath, finalLiveVideoPath)
   }, [
     imageLiveVideoPath,
     imageLocalPath,
@@ -8378,6 +8637,7 @@ function MessageBubble({
     lockImageStageHeight,
     message.imageDatName,
     message.imageMd5,
+    message.createTime,
     requestImageDecrypt,
     session.username
   ])
@@ -8391,8 +8651,19 @@ function MessageBubble({
   }, [])
 
   useEffect(() => {
+    if (!isImage) return
+    if (!imageLocalPath) {
       setImageLoaded(false)
-  }, [imageLocalPath])
+      return
+    }
+
+    // 某些 file:// 缓存图在 src 切换时可能不会稳定触发 onLoad，
+    // 这里用 complete/naturalWidth 做一次兜底，避免图片进入 pending 隐身态。
+    const img = imageElementRef.current
+    if (img && img.complete && img.naturalWidth > 0) {
+      setImageLoaded(true)
+    }
+  }, [isImage, imageLocalPath])
 
   useEffect(() => {
     if (imageLoading) return
@@ -8401,7 +8672,7 @@ function MessageBubble({
   }, [imageError, imageLoading, imageLocalPath])
 
   useEffect(() => {
-    if (!isImage || imageLoading) return
+    if (!isImage || imageLoading || !imageInView) return
     if (!message.imageMd5 && !message.imageDatName) return
     if (imageUpdateCheckedRef.current === imageCacheKey) return
     imageUpdateCheckedRef.current = imageCacheKey
@@ -8409,15 +8680,21 @@ function MessageBubble({
     window.electronAPI.image.resolveCache({
       sessionId: session.username,
       imageMd5: message.imageMd5 || undefined,
-      imageDatName: message.imageDatName
+      imageDatName: message.imageDatName,
+      createTime: message.createTime,
+      preferFilePath: true,
+      hardlinkOnly: true,
+      allowCacheIndex: false
     }).then((result: { success: boolean; localPath?: string; hasUpdate?: boolean; liveVideoPath?: string; error?: string }) => {
       if (cancelled) return
       if (result.success && result.localPath) {
-        imageDataUrlCache.set(imageCacheKey, result.localPath)
+        const renderPath = toRenderableImageSrc(result.localPath)
-        if (!imageLocalPath || imageLocalPath !== result.localPath) {
+        if (!renderPath) return
+        imageDataUrlCache.set(imageCacheKey, renderPath)
+        if (!imageLocalPath || imageLocalPath !== renderPath) {
           captureImageResizeBaseline()
           lockImageStageHeight()
-          setImageLocalPath(result.localPath)
+          setImageLocalPath(renderPath)
           setImageError(false)
         }
         if (result.liveVideoPath) setImageLiveVideoPath(result.liveVideoPath)
@@ -8427,7 +8704,7 @@ function MessageBubble({
     return () => {
       cancelled = true
     }
-  }, [isImage, imageLocalPath, imageLoading, message.imageMd5, message.imageDatName, imageCacheKey, session.username, captureImageResizeBaseline, lockImageStageHeight])
+  }, [isImage, imageInView, imageLocalPath, imageLoading, message.imageMd5, message.imageDatName, message.createTime, imageCacheKey, session.username, captureImageResizeBaseline, lockImageStageHeight])
 
   useEffect(() => {
     if (!isImage) return
@@ -8455,15 +8732,17 @@ function MessageBubble({
         (payload.imageMd5 && payload.imageMd5 === message.imageMd5) ||
         (payload.imageDatName && payload.imageDatName === message.imageDatName)
       if (matchesCacheKey) {
+        const renderPath = toRenderableImageSrc(payload.localPath)
+        if (!renderPath) return
         const cachedPath = imageDataUrlCache.get(imageCacheKey)
-        if (cachedPath !== payload.localPath) {
+        if (cachedPath !== renderPath) {
-          imageDataUrlCache.set(imageCacheKey, payload.localPath)
+          imageDataUrlCache.set(imageCacheKey, renderPath)
         }
-        if (imageLocalPath !== payload.localPath) {
+        if (imageLocalPath !== renderPath) {
           captureImageResizeBaseline()
           lockImageStageHeight()
         }
-        setImageLocalPath((prev) => (prev === payload.localPath ? prev : payload.localPath))
+        setImageLocalPath((prev) => (prev === renderPath ? prev : renderPath))
         setImageError(false)
       }
     })
@@ -9093,6 +9372,7 @@ function MessageBubble({
             <>
               <div className="image-message-wrapper">
                 <img
+                  ref={imageElementRef}
                   src={imageLocalPath}
                   alt="图片"
                   className={`image-message ${imageLoaded ? 'ready' : 'pending'}`}

src/pages/ExportPage.scss

@@ -410,6 +410,17 @@
     background: rgba(245, 158, 11, 0.14);
   }
 
+  &.status-pause_requested,
+  &.status-paused {
+    color: #b45309;
+    background: rgba(245, 158, 11, 0.14);
+  }
+
+  &.status-canceled {
+    color: #64748b;
+    background: rgba(148, 163, 184, 0.2);
+  }
+
   &.status-completed {
     color: #166534;
     background: rgba(34, 197, 94, 0.14);
@@ -5817,8 +5828,9 @@
   }
 }
 
-/* 终止时间选择器 */
+/* 首次触发/终止时间选择器 */
-.automation-stopat-picker {
+.automation-stopat-picker,
+.automation-first-trigger-picker {
   display: flex;
   align-items: center;
   gap: 8px;

src/pages/ExportPage.tsx

@@ -22,6 +22,8 @@ import {
   MessageSquare,
   MessageSquareText,
   Mic,
+  Pause,
+  Play,
   RefreshCw,
   Search,
   Square,
@@ -48,6 +50,8 @@ import {
 import {
   requestCancelBackgroundTask,
   requestCancelBackgroundTasks,
+  requestPauseBackgroundTask,
+  requestResumeBackgroundTask,
   subscribeBackgroundTasks
 } from '../services/backgroundTaskMonitor'
 import { useContactTypeCountsStore } from '../stores/contactTypeCountsStore'
@@ -105,7 +109,6 @@ interface ExportOptions {
   txtColumns: string[]
   displayNamePreference: DisplayNamePreference
   exportConcurrency: number
-  imageDeepSearchOnMiss: boolean
 }
 
 interface SessionRow extends AppChatSession {
@@ -209,6 +212,8 @@ interface AutomationTaskDraft {
   dateRangeConfig: ExportAutomationDateRangeConfig | string | null
   intervalDays: number
   intervalHours: number
+  firstTriggerAtEnabled: boolean
+  firstTriggerAtValue: string
   stopAtEnabled: boolean
   stopAtValue: string
   maxRunsEnabled: boolean
@@ -218,6 +223,7 @@ interface AutomationTaskDraft {
 const defaultTxtColumns = ['index', 'time', 'senderRole', 'messageType', 'content']
 const DETAIL_PRECISE_REFRESH_COOLDOWN_MS = 10 * 60 * 1000
 const TASK_PERFORMANCE_UPDATE_MIN_INTERVAL_MS = 900
+const EXPORT_PROGRESS_UI_FLUSH_INTERVAL_MS = 320
 const SESSION_MEDIA_METRIC_PREFETCH_ROWS = 10
 const SESSION_MEDIA_METRIC_BATCH_SIZE = 8
 const SESSION_MEDIA_METRIC_BACKGROUND_FEED_SIZE = 48
@@ -249,6 +255,8 @@ const backgroundTaskSourceLabels: Record<string, string> = {
 
 const backgroundTaskStatusLabels: Record<BackgroundTaskRecord['status'], string> = {
   running: '运行中',
+  pause_requested: '中断中',
+  paused: '已中断',
   cancel_requested: '停止中',
   completed: '已完成',
   failed: '失败',
@@ -322,6 +330,69 @@ const createEmptyProgress = (): TaskProgress => ({
   mediaBytesWritten: 0
 })
 
+const areStringArraysEqual = (left: string[], right: string[]): boolean => {
+  if (left === right) return true
+  if (left.length !== right.length) return false
+  for (let index = 0; index < left.length; index += 1) {
+    if (left[index] !== right[index]) return false
+  }
+  return true
+}
+
+const areTaskProgressEqual = (left: TaskProgress, right: TaskProgress): boolean => (
+  left.current === right.current &&
+  left.total === right.total &&
+  left.currentName === right.currentName &&
+  left.phase === right.phase &&
+  left.phaseLabel === right.phaseLabel &&
+  left.phaseProgress === right.phaseProgress &&
+  left.phaseTotal === right.phaseTotal &&
+  left.exportedMessages === right.exportedMessages &&
+  left.estimatedTotalMessages === right.estimatedTotalMessages &&
+  left.collectedMessages === right.collectedMessages &&
+  left.writtenFiles === right.writtenFiles &&
+  left.mediaDoneFiles === right.mediaDoneFiles &&
+  left.mediaCacheHitFiles === right.mediaCacheHitFiles &&
+  left.mediaCacheMissFiles === right.mediaCacheMissFiles &&
+  left.mediaCacheFillFiles === right.mediaCacheFillFiles &&
+  left.mediaDedupReuseFiles === right.mediaDedupReuseFiles &&
+  left.mediaBytesWritten === right.mediaBytesWritten
+)
+
+const normalizeProgressFloat = (value: unknown, digits = 3): number => {
+  const parsed = Number(value)
+  if (!Number.isFinite(parsed)) return 0
+  const factor = 10 ** digits
+  return Math.round(parsed * factor) / factor
+}
+
+const normalizeProgressInt = (value: unknown): number => {
+  const parsed = Number(value)
+  if (!Number.isFinite(parsed)) return 0
+  return Math.max(0, Math.floor(parsed))
+}
+
+const buildProgressPayloadSignature = (payload: ExportProgress): string => ([
+  String(payload.phase || ''),
+  String(payload.currentSessionId || ''),
+  String(payload.currentSession || ''),
+  String(payload.phaseLabel || ''),
+  normalizeProgressFloat(payload.current, 4),
+  normalizeProgressFloat(payload.total, 4),
+  normalizeProgressFloat(payload.phaseProgress, 2),
+  normalizeProgressFloat(payload.phaseTotal, 2),
+  normalizeProgressInt(payload.collectedMessages),
+  normalizeProgressInt(payload.exportedMessages),
+  normalizeProgressInt(payload.estimatedTotalMessages),
+  normalizeProgressInt(payload.writtenFiles),
+  normalizeProgressInt(payload.mediaDoneFiles),
+  normalizeProgressInt(payload.mediaCacheHitFiles),
+  normalizeProgressInt(payload.mediaCacheMissFiles),
+  normalizeProgressInt(payload.mediaCacheFillFiles),
+  normalizeProgressInt(payload.mediaDedupReuseFiles),
+  normalizeProgressInt(payload.mediaBytesWritten)
+].join('|'))
+
 const createEmptyTaskPerformance = (): TaskPerformance => ({
   stages: {
     collect: 0,
@@ -336,6 +407,15 @@ const isTextBatchTask = (task: ExportTask): boolean => (
   task.payload.scope === 'content' && task.payload.contentType === 'text'
 )
 
+const isImageExportTask = (task: ExportTask): boolean => {
+  if (task.payload.scope === 'sns') {
+    return Boolean(task.payload.snsOptions?.exportImages)
+  }
+  if (task.payload.scope !== 'content') return false
+  if (task.payload.contentType === 'image') return true
+  return Boolean(task.payload.options?.exportImages)
+}
+
 const resolvePerfStageByPhase = (phase?: ExportProgress['phase']): TaskPerfStage => {
   if (phase === 'preparing') return 'collect'
   if (phase === 'writing') return 'write'
@@ -500,6 +580,35 @@ const getTaskStatusLabel = (task: ExportTask): string => {
   return '失败'
 }
 
+const resolveBackgroundTaskCardClass = (status: BackgroundTaskRecord['status']): 'running' | 'paused' | 'stopped' | 'success' | 'error' => {
+  if (status === 'running') return 'running'
+  if (status === 'pause_requested' || status === 'paused') return 'paused'
+  if (status === 'cancel_requested' || status === 'canceled') return 'stopped'
+  if (status === 'completed') return 'success'
+  return 'error'
+}
+
+const parseBackgroundTaskProgress = (progressText?: string): { current: number; total: number; ratio: number | null } => {
+  const normalized = String(progressText || '').trim()
+  if (!normalized) {
+    return { current: 0, total: 0, ratio: null }
+  }
+  const match = normalized.match(/(\d+)\s*\/\s*(\d+)/)
+  if (!match) {
+    return { current: 0, total: 0, ratio: null }
+  }
+  const current = Math.max(0, Math.floor(Number(match[1]) || 0))
+  const total = Math.max(0, Math.floor(Number(match[2]) || 0))
+  if (total <= 0) {
+    return { current, total, ratio: null }
+  }
+  return {
+    current,
+    total,
+    ratio: Math.max(0, Math.min(1, current / total))
+  }
+}
+
 const formatAbsoluteDate = (timestamp: number): string => {
   const d = new Date(timestamp)
   const y = d.getFullYear()
@@ -635,6 +744,11 @@ type ContactsDataSource = 'cache' | 'network' | null
 
 const normalizeAutomationIntervalDays = (value: unknown): number => Math.max(0, Math.floor(Number(value) || 0))
 const normalizeAutomationIntervalHours = (value: unknown): number => Math.max(0, Math.min(23, Math.floor(Number(value) || 0)))
+const normalizeAutomationFirstTriggerAt = (value: unknown): number => {
+  const numeric = Math.floor(Number(value) || 0)
+  if (!Number.isFinite(numeric) || numeric <= 0) return 0
+  return numeric
+}
 
 const resolveAutomationIntervalMs = (schedule: ExportAutomationSchedule): number => {
   const days = normalizeAutomationIntervalDays(schedule.intervalDays)
@@ -644,6 +758,16 @@ const resolveAutomationIntervalMs = (schedule: ExportAutomationSchedule): number
   return totalHours * 60 * 60 * 1000
 }
 
+const resolveAutomationInitialTriggerAt = (task: ExportAutomationTask): number | null => {
+  const intervalMs = resolveAutomationIntervalMs(task.schedule)
+  if (intervalMs <= 0) return null
+  const firstTriggerAt = normalizeAutomationFirstTriggerAt(task.schedule.firstTriggerAt)
+  if (firstTriggerAt > 0) return firstTriggerAt
+  const createdAt = Math.max(0, Math.floor(Number(task.createdAt || 0)))
+  if (!createdAt) return null
+  return createdAt + intervalMs
+}
+
 const formatAutomationScheduleLabel = (schedule: ExportAutomationSchedule): string => {
   const days = normalizeAutomationIntervalDays(schedule.intervalDays)
   const hours = normalizeAutomationIntervalHours(schedule.intervalHours)
@@ -657,12 +781,60 @@ const resolveAutomationDueScheduleKey = (task: ExportAutomationTask, now: Date):
   const intervalMs = resolveAutomationIntervalMs(task.schedule)
   if (intervalMs <= 0) return null
   const nowMs = now.getTime()
-  const anchorAt = Math.max(
+  const lastTriggeredAt = Math.max(0, Math.floor(Number(task.runState?.lastTriggeredAt || 0)))
-    0,
+  if (lastTriggeredAt > 0) {
-    Number(task.runState?.lastTriggeredAt || 0) || Number(task.createdAt || 0)
+    if (nowMs < lastTriggeredAt + intervalMs) return null
-  )
+    return `interval:${lastTriggeredAt}:${Math.floor((nowMs - lastTriggeredAt) / intervalMs)}`
-  if (nowMs < anchorAt + intervalMs) return null
+  }
-  return `interval:${anchorAt}:${Math.floor((nowMs - anchorAt) / intervalMs)}`
+  const initialTriggerAt = resolveAutomationInitialTriggerAt(task)
+  if (!initialTriggerAt) return null
+  if (nowMs < initialTriggerAt) return null
+  return `first:${initialTriggerAt}`
+}
+
+const resolveAutomationFirstTriggerSummary = (task: ExportAutomationTask): string => {
+  const firstTriggerAt = normalizeAutomationFirstTriggerAt(task.schedule.firstTriggerAt)
+  if (firstTriggerAt <= 0) return '未指定（默认按创建时间+间隔）'
+  return new Date(firstTriggerAt).toLocaleString('zh-CN')
+}
+
+const buildAutomationSchedule = (
+  intervalDays: number,
+  intervalHours: number,
+  firstTriggerAt: number
+): ExportAutomationSchedule => ({
+  type: 'interval',
+  intervalDays,
+  intervalHours,
+  firstTriggerAt: firstTriggerAt > 0 ? firstTriggerAt : undefined
+})
+
+const buildAutomationDatePart = (timestamp: number): string => {
+  const date = new Date(timestamp)
+  if (Number.isNaN(date.getTime())) return ''
+  const year = date.getFullYear()
+  const month = `${date.getMonth() + 1}`.padStart(2, '0')
+  const day = `${date.getDate()}`.padStart(2, '0')
+  return `${year}-${month}-${day}`
+}
+
+const buildAutomationTodayDatePart = (): string => buildAutomationDatePart(Date.now())
+
+const normalizeAutomationDatePart = (value: string): string => {
+  const text = String(value || '').trim()
+  return /^\d{4}-\d{2}-\d{2}$/.test(text) ? text : ''
+}
+
+const normalizeAutomationTimePart = (value: string): string => {
+  const text = String(value || '').trim()
+  if (!/^\d{2}:\d{2}$/.test(text)) return '00:00'
+  const [hoursText, minutesText] = text.split(':')
+  const hours = Math.floor(Number(hoursText))
+  const minutes = Math.floor(Number(minutesText))
+  if (!Number.isFinite(hours) || !Number.isFinite(minutes)) return '00:00'
+  const safeHours = Math.min(23, Math.max(0, hours))
+  const safeMinutes = Math.min(59, Math.max(0, minutes))
+  return `${`${safeHours}`.padStart(2, '0')}:${`${safeMinutes}`.padStart(2, '0')}`
 }
 
 const toDateTimeLocalValue = (timestamp: number): string => {
@@ -803,9 +975,9 @@ const formatAutomationStopCondition = (task: ExportAutomationTask): string => {
 const resolveAutomationNextTriggerAt = (task: ExportAutomationTask): number | null => {
   const intervalMs = resolveAutomationIntervalMs(task.schedule)
   if (intervalMs <= 0) return null
-  const anchorAt = Math.max(0, Number(task.runState?.lastTriggeredAt || 0) || Number(task.createdAt || 0))
+  const lastTriggeredAt = Math.max(0, Math.floor(Number(task.runState?.lastTriggeredAt || 0)))
-  if (!anchorAt) return null
+  if (lastTriggeredAt > 0) return lastTriggeredAt + intervalMs
-  return anchorAt + intervalMs
+  return resolveAutomationInitialTriggerAt(task)
 }
 
 const formatAutomationCurrentState = (
@@ -1589,25 +1761,40 @@ const SectionInfoTooltip = memo(function SectionInfoTooltip({
 interface TaskCenterModalProps {
   isOpen: boolean
   tasks: ExportTask[]
+  chatBackgroundTasks: BackgroundTaskRecord[]
   taskRunningCount: number
   taskQueuedCount: number
   expandedPerfTaskId: string | null
   nowTick: number
   onClose: () => void
   onTogglePerfTask: (taskId: string) => void
+  onPauseBackgroundTask: (taskId: string) => void
+  onResumeBackgroundTask: (taskId: string) => void
+  onCancelBackgroundTask: (taskId: string) => void
 }
 
 const TaskCenterModal = memo(function TaskCenterModal({
   isOpen,
   tasks,
+  chatBackgroundTasks,
   taskRunningCount,
   taskQueuedCount,
   expandedPerfTaskId,
   nowTick,
   onClose,
-  onTogglePerfTask
+  onTogglePerfTask,
+  onPauseBackgroundTask,
+  onResumeBackgroundTask,
+  onCancelBackgroundTask
 }: TaskCenterModalProps) {
   if (!isOpen) return null
+  const chatActiveTaskCount = chatBackgroundTasks.filter(task => (
+    task.status === 'running' ||
+    task.status === 'pause_requested' ||
+    task.status === 'paused' ||
+    task.status === 'cancel_requested'
+  )).length
+  const totalTaskCount = tasks.length + chatBackgroundTasks.length
 
   return createPortal(
     <div
@@ -1624,7 +1811,7 @@ const TaskCenterModal = memo(function TaskCenterModal({
         <div className="task-center-modal-header">
           <div className="task-center-modal-title">
             <h3>任务中心</h3>
-            <span>进行中 {taskRunningCount} · 排队 {taskQueuedCount} · 总计 {tasks.length}</span>
+            <span>导出进行中 {taskRunningCount} · 排队 {taskQueuedCount} · 聊天后台 {chatActiveTaskCount} · 总计 {totalTaskCount}</span>
           </div>
           <button
             className="close-icon-btn"
@@ -1636,8 +1823,8 @@ const TaskCenterModal = memo(function TaskCenterModal({
           </button>
         </div>
         <div className="task-center-modal-body">
-          {tasks.length === 0 ? (
+          {totalTaskCount === 0 ? (
-            <div className="task-empty">暂无任务。点击会话导出或卡片导出后会在这里创建任务。</div>
+            <div className="task-empty">暂无任务。导出任务和聊天页批量语音/图片任务都会显示在这里。</div>
           ) : (
             <div className="task-list">
               {tasks.map(task => {
@@ -1705,6 +1892,24 @@ const TaskCenterModal = memo(function TaskCenterModal({
                 const currentSessionRatio = task.progress.phaseTotal > 0
                   ? Math.max(0, Math.min(1, task.progress.phaseProgress / task.progress.phaseTotal))
                   : null
+                const imageTask = isImageExportTask(task)
+                const imageTimingElapsedMs = imageTask
+                  ? Math.max(0, (
+                    typeof task.finishedAt === 'number'
+                      ? task.finishedAt
+                      : nowTick
+                  ) - (task.startedAt || task.createdAt))
+                  : 0
+                const imageTimingAvgMs = imageTask && mediaDoneFiles > 0
+                  ? Math.floor(imageTimingElapsedMs / Math.max(1, mediaDoneFiles))
+                  : 0
+                const imageTimingLabel = imageTask
+                  ? (
+                    mediaDoneFiles > 0
+                      ? `图片耗时 ${formatDurationMs(imageTimingElapsedMs)} · 平均 ${imageTimingAvgMs}ms/张`
+                      : `图片耗时 ${formatDurationMs(imageTimingElapsedMs)}`
+                  )
+                  : ''
                 return (
                   <div key={task.id} className={`task-card ${task.status}`}>
                     <div className="task-main">
@@ -1734,6 +1939,11 @@ const TaskCenterModal = memo(function TaskCenterModal({
                           </div>
                         </>
                       )}
+                      {imageTimingLabel && task.status !== 'queued' && (
+                        <div className="task-perf-summary">
+                          <span>{imageTimingLabel}</span>
+                        </div>
+                      )}
                       {canShowPerfDetail && stageTotals && (
                         <div className="task-perf-summary">
                           <span>累计耗时 {formatDurationMs(stageTotalMs)}</span>
@@ -1802,6 +2012,70 @@ const TaskCenterModal = memo(function TaskCenterModal({
                   </div>
                 )
               })}
+              {chatBackgroundTasks.map(task => {
+                const taskCardClass = resolveBackgroundTaskCardClass(task.status)
+                const progress = parseBackgroundTaskProgress(task.progressText)
+                const canPause = task.resumable && task.status === 'running'
+                const canResume = task.resumable && (task.status === 'paused' || task.status === 'pause_requested')
+                const canCancel = task.cancelable && (
+                  task.status === 'running' ||
+                  task.status === 'pause_requested' ||
+                  task.status === 'paused' ||
+                  task.status === 'cancel_requested'
+                )
+                return (
+                  <div key={task.id} className={`task-card ${taskCardClass}`}>
+                    <div className="task-main">
+                      <div className="task-title">{task.title}</div>
+                      <div className="task-meta">
+                        <span className={`task-status ${taskCardClass}`}>{backgroundTaskStatusLabels[task.status]}</span>
+                        <span>{backgroundTaskSourceLabels[task.sourcePage] || backgroundTaskSourceLabels.other}</span>
+                        <span>{new Date(task.startedAt).toLocaleString('zh-CN')}</span>
+                      </div>
+                      {progress.ratio !== null && (
+                        <div className="task-progress-bar">
+                          <div
+                            className="task-progress-fill"
+                            style={{ width: `${progress.ratio * 100}%` }}
+                          />
+                        </div>
+                      )}
+                      <div className="task-progress-text">
+                        {task.detail || '任务进行中'}
+                        {task.progressText ? ` · ${task.progressText}` : ''}
+                      </div>
+                    </div>
+                    <div className="task-actions">
+                      {canPause && (
+                        <button
+                          className="task-action-btn"
+                          type="button"
+                          onClick={() => onPauseBackgroundTask(task.id)}
+                        >
+                          <Pause size={14} /> 中断
+                        </button>
+                      )}
+                      {canResume && (
+                        <button
+                          className="task-action-btn primary"
+                          type="button"
+                          onClick={() => onResumeBackgroundTask(task.id)}
+                        >
+                          <Play size={14} /> 继续
+                        </button>
+                      )}
+                      <button
+                        className="task-action-btn danger"
+                        type="button"
+                        onClick={() => onCancelBackgroundTask(task.id)}
+                        disabled={!canCancel || task.status === 'cancel_requested'}
+                      >
+                        {task.status === 'cancel_requested' ? '停止中' : '停止'}
+                      </button>
+                    </div>
+                  </div>
+                )
+              })}
             </div>
           )}
         </div>
@@ -1903,7 +2177,6 @@ function ExportPage() {
   const [exportDefaultVoiceAsText, setExportDefaultVoiceAsText] = useState(false)
   const [exportDefaultExcelCompactColumns, setExportDefaultExcelCompactColumns] = useState(true)
   const [exportDefaultConcurrency, setExportDefaultConcurrency] = useState(2)
-  const [exportDefaultImageDeepSearchOnMiss, setExportDefaultImageDeepSearchOnMiss] = useState(true)
 
   const [options, setOptions] = useState<ExportOptions>({
     format: 'json',
@@ -1924,8 +2197,7 @@ function ExportPage() {
     excelCompactColumns: true,
     txtColumns: defaultTxtColumns,
     displayNamePreference: 'remark',
-    exportConcurrency: 2,
+    exportConcurrency: 2
-    imageDeepSearchOnMiss: true
   })
 
   const [exportDialog, setExportDialog] = useState<ExportDialogState>({
@@ -2622,7 +2894,7 @@ function ExportPage() {
     automationTasksReadyRef.current = false
     let isReady = true
     try {
-      const [savedPath, savedFormat, savedAvatars, savedMedia, savedVoiceAsText, savedExcelCompactColumns, savedTxtColumns, savedConcurrency, savedImageDeepSearchOnMiss, savedSessionMap, savedContentMap, savedSessionRecordMap, savedSnsPostCount, savedWriteLayout, savedSessionNameWithTypePrefix, savedDefaultDateRange, savedFileNamingMode, exportCacheScope] = await Promise.all([
+      const [savedPath, savedFormat, savedAvatars, savedMedia, savedVoiceAsText, savedExcelCompactColumns, savedTxtColumns, savedConcurrency, savedSessionMap, savedContentMap, savedSessionRecordMap, savedSnsPostCount, savedWriteLayout, savedSessionNameWithTypePrefix, savedDefaultDateRange, savedFileNamingMode, exportCacheScope] = await Promise.all([
         configService.getExportPath(),
         configService.getExportDefaultFormat(),
         configService.getExportDefaultAvatars(),
@@ -2631,7 +2903,6 @@ function ExportPage() {
         configService.getExportDefaultExcelCompactColumns(),
         configService.getExportDefaultTxtColumns(),
         configService.getExportDefaultConcurrency(),
-        configService.getExportDefaultImageDeepSearchOnMiss(),
         configService.getExportLastSessionRunMap(),
         configService.getExportLastContentRunMap(),
         configService.getExportSessionRecordMap(),
@@ -2671,7 +2942,6 @@ function ExportPage() {
       setExportDefaultVoiceAsText(savedVoiceAsText ?? false)
       setExportDefaultExcelCompactColumns(savedExcelCompactColumns ?? true)
       setExportDefaultConcurrency(savedConcurrency ?? 2)
-      setExportDefaultImageDeepSearchOnMiss(savedImageDeepSearchOnMiss ?? true)
       setExportDefaultFileNamingMode(savedFileNamingMode ?? 'classic')
       setAutomationTasks(automationTaskItem?.tasks || [])
       automationTasksReadyRef.current = true
@@ -2709,8 +2979,7 @@ function ExportPage() {
         exportVoiceAsText: savedVoiceAsText ?? prev.exportVoiceAsText,
         excelCompactColumns: savedExcelCompactColumns ?? prev.excelCompactColumns,
         txtColumns,
-        exportConcurrency: savedConcurrency ?? prev.exportConcurrency,
+        exportConcurrency: savedConcurrency ?? prev.exportConcurrency
-        imageDeepSearchOnMiss: savedImageDeepSearchOnMiss ?? prev.imageDeepSearchOnMiss
       }))
     } catch (error) {
       isReady = false
@@ -4491,8 +4760,7 @@ function ExportPage() {
         maxFileSizeMb: prev.maxFileSizeMb,
         exportVoiceAsText: exportDefaultVoiceAsText,
         excelCompactColumns: exportDefaultExcelCompactColumns,
-        exportConcurrency: exportDefaultConcurrency,
+        exportConcurrency: exportDefaultConcurrency
-        imageDeepSearchOnMiss: exportDefaultImageDeepSearchOnMiss
       }
 
       if (payload.scope === 'sns') {
@@ -4527,8 +4795,7 @@ function ExportPage() {
     exportDefaultAvatars,
     exportDefaultMedia,
     exportDefaultVoiceAsText,
-    exportDefaultConcurrency,
+    exportDefaultConcurrency
-    exportDefaultImageDeepSearchOnMiss
   ])
 
   const closeExportDialog = useCallback(() => {
@@ -4755,7 +5022,6 @@ function ExportPage() {
       txtColumns: options.txtColumns,
       displayNamePreference: options.displayNamePreference,
       exportConcurrency: options.exportConcurrency,
-      imageDeepSearchOnMiss: options.imageDeepSearchOnMiss,
       fileNamingMode: exportDefaultFileNamingMode,
       sessionLayout,
       sessionNameWithTypePrefix,
@@ -4834,6 +5100,7 @@ function ExportPage() {
 
   const openEditAutomationTaskDraft = useCallback((task: ExportAutomationTask) => {
     const schedule = task.schedule
+    const firstTriggerAt = normalizeAutomationFirstTriggerAt(schedule.firstTriggerAt)
     const stopAt = Number(task.stopCondition?.endAt || 0)
     const maxRuns = Number(task.stopCondition?.maxRuns || 0)
     const resolvedRange = resolveAutomationDateRangeSelection(task.template.dateRangeConfig as any, new Date())
@@ -4854,6 +5121,8 @@ function ExportPage() {
       dateRangeConfig: task.template.dateRangeConfig,
       intervalDays: normalizeAutomationIntervalDays(schedule.intervalDays),
       intervalHours: normalizeAutomationIntervalHours(schedule.intervalHours),
+      firstTriggerAtEnabled: firstTriggerAt > 0,
+      firstTriggerAtValue: firstTriggerAt > 0 ? toDateTimeLocalValue(firstTriggerAt) : '',
       stopAtEnabled: stopAt > 0,
       stopAtValue: stopAt > 0 ? toDateTimeLocalValue(stopAt) : '',
       maxRunsEnabled: maxRuns > 0,
@@ -4959,7 +5228,18 @@ function ExportPage() {
       window.alert('执行间隔不能为 0，请至少设置天数或小时')
       return
     }
-    const schedule: ExportAutomationSchedule = { type: 'interval', intervalDays, intervalHours }
+    const firstTriggerAtTimestamp = automationTaskDraft.firstTriggerAtEnabled
+      ? parseDateTimeLocalValue(automationTaskDraft.firstTriggerAtValue)
+      : null
+    if (automationTaskDraft.firstTriggerAtEnabled && !firstTriggerAtTimestamp) {
+      window.alert('请填写有效的首次触发时间')
+      return
+    }
+    const schedule = buildAutomationSchedule(
+      intervalDays,
+      intervalHours,
+      firstTriggerAtTimestamp && firstTriggerAtTimestamp > 0 ? firstTriggerAtTimestamp : 0
+    )
     const stopAtTimestamp = automationTaskDraft.stopAtEnabled
       ? parseDateTimeLocalValue(automationTaskDraft.stopAtValue)
       : null
@@ -5146,14 +5426,10 @@ function ExportPage() {
     const settledSessionIdsFromProgress = new Set<string>()
     const sessionMessageProgress = new Map<string, { exported: number; total: number; knownTotal: boolean }>()
     let queuedProgressPayload: ExportProgress | null = null
-    let queuedProgressRaf: number | null = null
+    let queuedProgressSignature = ''
     let queuedProgressTimer: number | null = null
 
     const clearQueuedProgress = () => {
-      if (queuedProgressRaf !== null) {
-        window.cancelAnimationFrame(queuedProgressRaf)
-        queuedProgressRaf = null
-      }
       if (queuedProgressTimer !== null) {
         window.clearTimeout(queuedProgressTimer)
         queuedProgressTimer = null
@@ -5205,6 +5481,7 @@ function ExportPage() {
       if (!queuedProgressPayload) return
       const payload = queuedProgressPayload
       queuedProgressPayload = null
+      queuedProgressSignature = ''
       const now = Date.now()
       const currentSessionId = String(payload.currentSessionId || '').trim()
       updateTask(next.id, task => {
@@ -5261,12 +5538,10 @@ function ExportPage() {
         const mediaBytesWritten = Number.isFinite(payload.mediaBytesWritten)
           ? Math.max(prevMediaBytesWritten, Math.max(0, Math.floor(Number(payload.mediaBytesWritten || 0))))
           : prevMediaBytesWritten
-        return {
+        const nextProgress: TaskProgress = {
-          ...task,
-          progress: {
           current: payload.current,
           total: payload.total,
-            currentName: payload.currentSession,
+          currentName: payload.currentSession || '',
           phase: payload.phase,
           phaseLabel: payload.phaseLabel || '',
           phaseProgress: payload.phaseProgress || 0,
@@ -5283,55 +5558,51 @@ function ExportPage() {
           mediaCacheFillFiles,
           mediaDedupReuseFiles,
           mediaBytesWritten
-          },
+        }
-          settledSessionIds: nextSettledSessionIds,
+        const hasSettledListChanged = !areStringArraysEqual(settledSessionIds, nextSettledSessionIds)
-          performance
+        const hasProgressChanged = !areTaskProgressEqual(task.progress, nextProgress)
+        const hasPerformanceChanged = performance !== task.performance
+        if (!hasSettledListChanged && !hasProgressChanged && !hasPerformanceChanged) {
+          return task
+        }
+        return {
+          ...task,
+          progress: hasProgressChanged ? nextProgress : task.progress,
+          settledSessionIds: hasSettledListChanged ? nextSettledSessionIds : settledSessionIds,
+          performance: hasPerformanceChanged ? performance : task.performance
         }
       })
     }
 
     const queueProgressUpdate = (payload: ExportProgress) => {
+      const signature = buildProgressPayloadSignature(payload)
+      if (queuedProgressPayload && signature === queuedProgressSignature) {
+        return
+      }
       queuedProgressPayload = payload
+      queuedProgressSignature = signature
       if (payload.phase === 'complete') {
         clearQueuedProgress()
         flushQueuedProgress()
         return
       }
-      if (queuedProgressRaf !== null || queuedProgressTimer !== null) return
+      if (queuedProgressTimer !== null) return
-      queuedProgressRaf = window.requestAnimationFrame(() => {
-        queuedProgressRaf = null
       queuedProgressTimer = window.setTimeout(() => {
         queuedProgressTimer = null
         flushQueuedProgress()
-        }, 180)
+      }, EXPORT_PROGRESS_UI_FLUSH_INTERVAL_MS)
-      })
     }
     if (next.payload.scope === 'sns') {
       progressUnsubscribeRef.current = window.electronAPI.sns.onExportProgress((payload) => {
-        updateTask(next.id, task => {
+        queueProgressUpdate({
-          if (task.status !== 'running') return task
+          current: Number(payload.current || 0),
-          return {
+          total: Number(payload.total || 0),
-            ...task,
+          currentSession: '',
-            progress: {
+          currentSessionId: '',
-              current: payload.current || 0,
-              total: payload.total || 0,
-              currentName: '',
           phase: 'exporting',
-              phaseLabel: payload.status || '',
+          phaseLabel: String(payload.status || ''),
-              phaseProgress: payload.total > 0 ? payload.current : 0,
+          phaseProgress: payload.total > 0 ? Number(payload.current || 0) : 0,
-              phaseTotal: payload.total || 0,
+          phaseTotal: Number(payload.total || 0)
-              exportedMessages: payload.total > 0 ? Math.max(0, Math.floor(payload.current || 0)) : task.progress.exportedMessages,
-              estimatedTotalMessages: payload.total > 0 ? Math.max(0, Math.floor(payload.total || 0)) : task.progress.estimatedTotalMessages,
-              collectedMessages: task.progress.collectedMessages,
-              writtenFiles: task.progress.writtenFiles,
-              mediaDoneFiles: task.progress.mediaDoneFiles,
-              mediaCacheHitFiles: task.progress.mediaCacheHitFiles,
-              mediaCacheMissFiles: task.progress.mediaCacheMissFiles,
-              mediaCacheFillFiles: task.progress.mediaCacheFillFiles,
-              mediaDedupReuseFiles: task.progress.mediaDedupReuseFiles,
-              mediaBytesWritten: task.progress.mediaBytesWritten
-            }
-          }
         })
       })
     } else {
@@ -5656,6 +5927,8 @@ function ExportPage() {
         dateRangeConfig: serializeExportDateRangeConfig(normalizedRangeSelection),
         intervalDays: 1,
         intervalHours: 0,
+        firstTriggerAtEnabled: false,
+        firstTriggerAtValue: '',
         stopAtEnabled: false,
         stopAtValue: '',
         maxRunsEnabled: false,
@@ -5691,8 +5964,6 @@ function ExportPage() {
     await configService.setExportDefaultExcelCompactColumns(options.excelCompactColumns)
     await configService.setExportDefaultTxtColumns(options.txtColumns)
     await configService.setExportDefaultConcurrency(options.exportConcurrency)
-    await configService.setExportDefaultImageDeepSearchOnMiss(options.imageDeepSearchOnMiss)
-    setExportDefaultImageDeepSearchOnMiss(options.imageDeepSearchOnMiss)
   }
 
   const openSingleExport = useCallback((session: SessionRow) => {
@@ -7336,11 +7607,23 @@ function ExportPage() {
   const handleCancelBackgroundTask = useCallback((taskId: string) => {
     requestCancelBackgroundTask(taskId)
   }, [])
+  const handlePauseBackgroundTask = useCallback((taskId: string) => {
+    requestPauseBackgroundTask(taskId)
+  }, [])
+  const handleResumeBackgroundTask = useCallback((taskId: string) => {
+    requestResumeBackgroundTask(taskId)
+  }, [])
   const handleCancelAllNonExportTasks = useCallback(() => {
     requestCancelBackgroundTasks(task => (
       task.sourcePage !== 'export' &&
+      task.sourcePage !== 'chat' &&
       task.cancelable &&
-      (task.status === 'running' || task.status === 'cancel_requested')
+      (
+        task.status === 'running' ||
+        task.status === 'pause_requested' ||
+        task.status === 'paused' ||
+        task.status === 'cancel_requested'
+      )
     ))
   }, [])
 
@@ -7393,14 +7676,6 @@ function ExportPage() {
   const useCollapsedSessionFormatSelector = isSessionScopeDialog || isContentTextDialog
   const shouldShowFormatSection = !isContentScopeDialog || isContentTextDialog
   const shouldShowMediaSection = !isContentScopeDialog
-  const shouldRenderImageDeepSearchToggle = exportDialog.scope !== 'sns' && (
-    isSessionScopeDialog ||
-    (isContentScopeDialog && exportDialog.contentType === 'image')
-  )
-  const shouldShowImageDeepSearchToggle = exportDialog.scope !== 'sns' && (
-    (isSessionScopeDialog && options.exportImages) ||
-    (isContentScopeDialog && exportDialog.contentType === 'image')
-  )
   const avatarExportStatusLabel = options.exportAvatars ? '已开启聊天消息导出带头像' : '已关闭聊天消息导出带头像'
   const contentTextDialogSummary = '此模式只导出聊天文本，不包含图片语音视频表情包等多媒体文件。'
   const activeDialogFormatLabel = exportDialog.scope === 'sns'
@@ -7496,7 +7771,18 @@ function ExportPage() {
   const isSnsCardStatsLoading = !hasSeededSnsStats
   const taskRunningCount = tasks.filter(task => task.status === 'running').length
   const taskQueuedCount = tasks.filter(task => task.status === 'queued').length
-  const taskCenterAlertCount = taskRunningCount + taskQueuedCount
+  const chatBackgroundTasks = useMemo(() => (
+    backgroundTasks.filter(task => task.sourcePage === 'chat')
+  ), [backgroundTasks])
+  const chatBackgroundActiveTaskCount = useMemo(() => (
+    chatBackgroundTasks.filter(task => (
+      task.status === 'running' ||
+      task.status === 'pause_requested' ||
+      task.status === 'paused' ||
+      task.status === 'cancel_requested'
+    )).length
+  ), [chatBackgroundTasks])
+  const taskCenterAlertCount = taskRunningCount + taskQueuedCount + chatBackgroundActiveTaskCount
   const hasFilteredContacts = filteredContacts.length > 0
   const optionalMetricColumnCount = (shouldShowSnsColumn ? 1 : 0) + (shouldShowMutualFriendsColumn ? 1 : 0)
   const contactsMetricColumnCount = 4 + optionalMetricColumnCount
@@ -7511,15 +7797,25 @@ function ExportPage() {
     width: `${Math.max(contactsHorizontalScrollMetrics.contentWidth, contactsHorizontalScrollMetrics.viewportWidth)}px`
   }), [contactsHorizontalScrollMetrics.contentWidth, contactsHorizontalScrollMetrics.viewportWidth])
   const nonExportBackgroundTasks = useMemo(() => (
-    backgroundTasks.filter(task => task.sourcePage !== 'export')
+    backgroundTasks.filter(task => task.sourcePage !== 'export' && task.sourcePage !== 'chat')
   ), [backgroundTasks])
   const runningNonExportTaskCount = useMemo(() => (
-    nonExportBackgroundTasks.filter(task => task.status === 'running' || task.status === 'cancel_requested').length
+    nonExportBackgroundTasks.filter(task => (
+      task.status === 'running' ||
+      task.status === 'pause_requested' ||
+      task.status === 'paused' ||
+      task.status === 'cancel_requested'
+    )).length
   ), [nonExportBackgroundTasks])
   const cancelableNonExportTaskCount = useMemo(() => (
     nonExportBackgroundTasks.filter(task => (
       task.cancelable &&
-      (task.status === 'running' || task.status === 'cancel_requested')
+      (
+        task.status === 'running' ||
+        task.status === 'pause_requested' ||
+        task.status === 'paused' ||
+        task.status === 'cancel_requested'
+      )
     )).length
   ), [nonExportBackgroundTasks])
   const nonExportBackgroundTasksUpdatedAt = useMemo(() => (
@@ -8139,12 +8435,16 @@ function ExportPage() {
       <TaskCenterModal
         isOpen={isTaskCenterOpen}
         tasks={tasks}
+        chatBackgroundTasks={chatBackgroundTasks}
         taskRunningCount={taskRunningCount}
         taskQueuedCount={taskQueuedCount}
         expandedPerfTaskId={expandedPerfTaskId}
         nowTick={nowTick}
         onClose={closeTaskCenter}
         onTogglePerfTask={toggleTaskPerfDetail}
+        onPauseBackgroundTask={handlePauseBackgroundTask}
+        onResumeBackgroundTask={handleResumeBackgroundTask}
+        onCancelBackgroundTask={handleCancelBackgroundTask}
       />
 
       {isAutomationModalOpen && createPortal(
@@ -8220,6 +8520,7 @@ function ExportPage() {
                             {queueState === 'queued' && <span className="automation-task-status queued">排队中</span>}
                           </div>
                           <p>{formatAutomationScheduleLabel(task.schedule)}</p>
+                          <p>首次触发：{resolveAutomationFirstTriggerSummary(task)}</p>
                           <p>时间范围：{formatAutomationRangeLabel(task.template.dateRangeConfig as any)}</p>
                           <p>会话范围：{task.sessionIds.length} 个</p>
                           <p>导出目录：{task.outputDir || `${exportFolder || '未设置'}（全局）`}</p>
@@ -8333,6 +8634,52 @@ function ExportPage() {
                 </label>
               </div>
 
+              <div className="automation-form-field">
+                <span>首次触发时间（可选）</span>
+                <label className="automation-inline-check">
+                  <input
+                    type="checkbox"
+                    checked={automationTaskDraft.firstTriggerAtEnabled}
+                    onChange={(event) => setAutomationTaskDraft((prev) => prev ? {
+                      ...prev,
+                      firstTriggerAtEnabled: event.target.checked
+                    } : prev)}
+                  />
+                  指定第一次触发时间
+                </label>
+                {automationTaskDraft.firstTriggerAtEnabled && (
+                  <div className="automation-first-trigger-picker">
+                    <input
+                      type="date"
+                      className="automation-stopat-date"
+                      value={automationTaskDraft.firstTriggerAtValue ? automationTaskDraft.firstTriggerAtValue.slice(0, 10) : ''}
+                      onChange={(event) => {
+                        const datePart = normalizeAutomationDatePart(event.target.value)
+                        const timePart = normalizeAutomationTimePart(automationTaskDraft.firstTriggerAtValue?.slice(11) || '00:00')
+                        setAutomationTaskDraft((prev) => prev ? {
+                          ...prev,
+                          firstTriggerAtValue: datePart ? `${datePart}T${timePart}` : ''
+                        } : prev)
+                      }}
+                    />
+                    <input
+                      type="time"
+                      className="automation-stopat-time"
+                      value={automationTaskDraft.firstTriggerAtValue ? normalizeAutomationTimePart(automationTaskDraft.firstTriggerAtValue.slice(11)) : '00:00'}
+                      onChange={(event) => {
+                        const timePart = normalizeAutomationTimePart(event.target.value)
+                        const datePart = normalizeAutomationDatePart(automationTaskDraft.firstTriggerAtValue?.slice(0, 10))
+                          || buildAutomationTodayDatePart()
+                        setAutomationTaskDraft((prev) => prev ? {
+                          ...prev,
+                          firstTriggerAtValue: `${datePart}T${timePart}`
+                        } : prev)
+                      }}
+                    />
+                  </div>
+                )}
+              </div>
+
               <div className="automation-form-field">
                 <span>导出时间范围（按触发时间动态计算）</span>
                 <div className="automation-segment-row">
@@ -8473,7 +8820,11 @@ function ExportPage() {
               </label>
 
               <div className="automation-draft-summary">
-                会话：{automationTaskDraft.sessionIds.length} 个 · 间隔：{automationTaskDraft.intervalDays} 天 {automationTaskDraft.intervalHours} 小时 · 时间：{formatAutomationRangeLabel(automationTaskDraft.dateRangeConfig as any, automationRangeSelection)} · 条件：有新消息才导出
+                会话：{automationTaskDraft.sessionIds.length} 个 · 间隔：{automationTaskDraft.intervalDays} 天 {automationTaskDraft.intervalHours} 小时 · 首次：{
+                  automationTaskDraft.firstTriggerAtEnabled
+                    ? (automationTaskDraft.firstTriggerAtValue ? automationTaskDraft.firstTriggerAtValue.replace('T', ' ') : '未设置')
+                    : '默认按创建时间+间隔'
+                } · 时间：{formatAutomationRangeLabel(automationTaskDraft.dateRangeConfig as any, automationRangeSelection)} · 条件：有新消息才导出
               </div>
             </div>
             <div className="automation-editor-actions">
@@ -8946,7 +9297,12 @@ function ExportPage() {
                               type="button"
                               className="session-load-detail-task-stop-btn"
                               onClick={() => handleCancelBackgroundTask(task.id)}
-                              disabled={!task.cancelable || (task.status !== 'running' && task.status !== 'cancel_requested')}
+                              disabled={!task.cancelable || (
+                                task.status !== 'running' &&
+                                task.status !== 'pause_requested' &&
+                                task.status !== 'paused' &&
+                                task.status !== 'cancel_requested'
+                              )}
                             >
                               停止
                             </button>
@@ -9710,30 +10066,6 @@ function ExportPage() {
                 </div>
               )}
 
-              {shouldRenderImageDeepSearchToggle && (
-                <div className={`dialog-collapse-slot ${shouldShowImageDeepSearchToggle ? 'open' : ''}`} aria-hidden={!shouldShowImageDeepSearchToggle}>
-                  <div className="dialog-collapse-inner">
-                    <div className="dialog-section">
-                      <div className="dialog-switch-row">
-                        <div className="dialog-switch-copy">
-                          <h4>缺图时深度搜索</h4>
-                          <div className="format-note">关闭后仅尝试 hardlink 命中，未命中将直接显示占位符，导出速度更快。</div>
-                        </div>
-                        <button
-                          type="button"
-                          className={`dialog-switch ${options.imageDeepSearchOnMiss ? 'on' : ''}`}
-                          aria-pressed={options.imageDeepSearchOnMiss}
-                          aria-label="切换缺图时深度搜索"
-                          onClick={() => setOptions(prev => ({ ...prev, imageDeepSearchOnMiss: !prev.imageDeepSearchOnMiss }))}
-                        >
-                          <span className="dialog-switch-thumb" />
-                        </button>
-                      </div>
-                    </div>
-                  </div>
-                </div>
-              )}
-
               {isSessionScopeDialog && (
                 <div className="dialog-section">
                   <div className="dialog-switch-row">

src/pages/ResourcesPage.tsx

@@ -44,6 +44,7 @@ const INITIAL_IMAGE_PRELOAD_END = 48
 const INITIAL_IMAGE_RESOLVE_END = 12
 const TASK_PROGRESS_UPDATE_MIN_INTERVAL_MS = 250
 const TASK_PROGRESS_UPDATE_MAX_STEPS = 100
+const BATCH_IMAGE_DECRYPT_CONCURRENCY = 8
 
 const GridList = forwardRef<HTMLDivElement, HTMLAttributes<HTMLDivElement>>(function GridList(props, ref) {
   const { className = '', ...rest } = props
@@ -71,6 +72,20 @@ function getRangeTimestampEnd(date: string): number | undefined {
   return Number.isFinite(n) ? n : undefined
 }
 
+function normalizeMediaToken(value?: string): string {
+  return String(value || '').trim().toLowerCase()
+}
+
+function getSafeImageDatName(item: Pick<MediaStreamItem, 'imageDatName' | 'imageMd5'>): string {
+  const datName = normalizeMediaToken(item.imageDatName)
+  if (!datName) return ''
+  return datName
+}
+
+function hasImageLocator(item: Pick<MediaStreamItem, 'imageDatName' | 'imageMd5'>): boolean {
+  return Boolean(normalizeMediaToken(item.imageMd5) || getSafeImageDatName(item))
+}
+
 function getItemKey(item: MediaStreamItem): string {
   const sessionId = String(item.sessionId || '').trim().toLowerCase()
   const localId = Number(item.localId || 0)
@@ -84,7 +99,7 @@ function getItemKey(item: MediaStreamItem): string {
   const mediaId = String(
     item.mediaType === 'video'
       ? (item.videoMd5 || '')
-      : (item.imageMd5 || item.imageDatName || '')
+      : (item.imageMd5 || getSafeImageDatName(item) || '')
   ).trim().toLowerCase()
   return `${sessionId}|${createTime}|${localType}|${serverId}|${mediaId}`
 }
@@ -658,19 +673,20 @@ function ResourcesPage() {
     const to = Math.min(displayItems.length - 1, end)
     if (to < from) return
     const now = Date.now()
-    const payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string }> = []
+    const payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string; createTime?: number }> = []
     const itemKeys: string[] = []
     for (let i = from; i <= to; i += 1) {
       const item = displayItems[i]
       if (!item || item.mediaType !== 'image') continue
       const itemKey = getItemKey(item)
       if (previewPathMapRef.current[itemKey] || previewPatchRef.current[itemKey]) continue
-      if (!item.imageMd5 && !item.imageDatName) continue
+      if (!hasImageLocator(item)) continue
       if ((imageCacheMissUntilRef.current[itemKey] || 0) > now) continue
       payloads.push({
         sessionId: item.sessionId,
-        imageMd5: item.imageMd5 || undefined,
+        imageMd5: normalizeMediaToken(item.imageMd5) || undefined,
-        imageDatName: item.imageDatName || undefined
+        imageDatName: getSafeImageDatName(item) || undefined,
+        createTime: Number(item.createTime || 0) || undefined
       })
       itemKeys.push(itemKey)
       if (payloads.length >= MAX_IMAGE_CACHE_RESOLVE_PER_TICK) break
@@ -686,7 +702,10 @@ function ResourcesPage() {
       try {
         const result = await window.electronAPI.image.resolveCacheBatch(payloads, {
           disableUpdateCheck: true,
-          allowCacheIndex: false
+          allowCacheIndex: true,
+          preferFilePath: true,
+          hardlinkOnly: true,
+          suppressEvents: true
         })
         const rows = Array.isArray(result?.rows) ? result.rows : []
         const pathPatch: Record<string, string> = {}
@@ -733,30 +752,31 @@ function ResourcesPage() {
     if (to < from) return
 
     const now = Date.now()
-    const payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string }> = []
+    const payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string; createTime?: number }> = []
     const dedup = new Set<string>()
     for (let i = from; i <= to; i += 1) {
       const item = displayItems[i]
       if (!item || item.mediaType !== 'image') continue
       const itemKey = getItemKey(item)
       if (previewPathMapRef.current[itemKey] || previewPatchRef.current[itemKey]) continue
-      if (!item.imageMd5 && !item.imageDatName) continue
+      if (!hasImageLocator(item)) continue
       if ((imagePreloadUntilRef.current[itemKey] || 0) > now) continue
-      const dedupKey = `${item.sessionId || ''}|${item.imageMd5 || ''}|${item.imageDatName || ''}`
+      const dedupKey = `${item.sessionId || ''}|${normalizeMediaToken(item.imageMd5)}|${getSafeImageDatName(item)}`
       if (dedup.has(dedupKey)) continue
       dedup.add(dedupKey)
       imagePreloadUntilRef.current[itemKey] = now + 12000
       payloads.push({
         sessionId: item.sessionId,
-        imageMd5: item.imageMd5 || undefined,
+        imageMd5: normalizeMediaToken(item.imageMd5) || undefined,
-        imageDatName: item.imageDatName || undefined
+        imageDatName: getSafeImageDatName(item) || undefined,
+        createTime: Number(item.createTime || 0) || undefined
       })
       if (payloads.length >= MAX_IMAGE_CACHE_PRELOAD_PER_TICK) break
     }
     if (payloads.length === 0) return
     void window.electronAPI.image.preload(payloads, {
       allowDecrypt: false,
-      allowCacheIndex: false
+      allowCacheIndex: true
     })
   }, [displayItems])
 
@@ -954,11 +974,14 @@ function ResourcesPage() {
     }, '批量删除确认')
   }, [batchBusy, selectedItems, showAlert, showConfirm])
 
-  const decryptImage = useCallback(async (item: MediaStreamItem): Promise<string | undefined> => {
+  const decryptImage = useCallback(async (
+    item: MediaStreamItem,
+    options?: { allowCacheIndex?: boolean }
+  ): Promise<string | undefined> => {
     if (item.mediaType !== 'image') return
 
     const key = getItemKey(item)
-    if (!item.imageMd5 && !item.imageDatName) {
+    if (!hasImageLocator(item)) {
       showAlert('当前图片缺少解密所需字段（imageMd5/imageDatName）', '无法解密')
       return
     }
@@ -972,12 +995,21 @@ function ResourcesPage() {
     try {
       const result = await window.electronAPI.image.decrypt({
         sessionId: item.sessionId,
-        imageMd5: item.imageMd5 || undefined,
+        imageMd5: normalizeMediaToken(item.imageMd5) || undefined,
-        imageDatName: item.imageDatName || undefined,
+        imageDatName: getSafeImageDatName(item) || undefined,
-        force: true
+        createTime: Number(item.createTime || 0) || undefined,
+        force: true,
+        preferFilePath: true,
+        hardlinkOnly: true,
+        allowCacheIndex: options?.allowCacheIndex ?? true,
+        suppressEvents: true
       })
       if (!result?.success) {
-        showAlert(`解密失败：${result?.error || '未知错误'}`, '解密失败')
+        if (result?.failureKind === 'decrypt_failed') {
+          showAlert(`解密失败：${result?.error || '解密后不是有效图片'}`, '解密失败')
+        } else {
+          showAlert(`本地无数据：${result?.error || '未找到原始 DAT 文件'}`, '未找到本地数据')
+        }
         return undefined
       }
 
@@ -991,8 +1023,13 @@ function ResourcesPage() {
       try {
         const resolved = await window.electronAPI.image.resolveCache({
           sessionId: item.sessionId,
-          imageMd5: item.imageMd5 || undefined,
+          imageMd5: normalizeMediaToken(item.imageMd5) || undefined,
-          imageDatName: item.imageDatName || undefined
+          imageDatName: getSafeImageDatName(item) || undefined,
+          createTime: Number(item.createTime || 0) || undefined,
+          preferFilePath: true,
+          hardlinkOnly: true,
+          allowCacheIndex: true,
+          suppressEvents: true
         })
         if (resolved?.success && resolved.localPath) {
           const localPath = resolved.localPath
@@ -1007,7 +1044,7 @@ function ResourcesPage() {
       setActionMessage('图片解密完成')
       return undefined
     } catch (e) {
-      showAlert(`解密失败：${String(e)}`, '解密失败')
+      showAlert(`本地无数据：${String(e)}`, '未找到本地数据')
       return undefined
     } finally {
       setDecryptingKeys((prev) => {
@@ -1027,8 +1064,13 @@ function ResourcesPage() {
       try {
         const resolved = await window.electronAPI.image.resolveCache({
           sessionId: item.sessionId,
-          imageMd5: item.imageMd5 || undefined,
+          imageMd5: normalizeMediaToken(item.imageMd5) || undefined,
-          imageDatName: item.imageDatName || undefined
+          imageDatName: getSafeImageDatName(item) || undefined,
+          createTime: Number(item.createTime || 0) || undefined,
+          preferFilePath: true,
+          hardlinkOnly: true,
+          allowCacheIndex: true,
+          suppressEvents: true
         })
         if (resolved?.success && resolved.localPath) {
           localPath = resolved.localPath
@@ -1046,8 +1088,13 @@ function ResourcesPage() {
     try {
       const resolved = await window.electronAPI.image.resolveCache({
         sessionId: item.sessionId,
-        imageMd5: item.imageMd5 || undefined,
+        imageMd5: normalizeMediaToken(item.imageMd5) || undefined,
-        imageDatName: item.imageDatName || undefined
+        imageDatName: getSafeImageDatName(item) || undefined,
+        createTime: Number(item.createTime || 0) || undefined,
+        preferFilePath: true,
+        hardlinkOnly: true,
+        allowCacheIndex: true,
+        suppressEvents: true
       })
       if (resolved?.success && resolved.localPath) {
         localPath = resolved.localPath
@@ -1077,7 +1124,8 @@ function ResourcesPage() {
 
     setBatchBusy(true)
     let success = 0
-    let failed = 0
+    let notFound = 0
+    let decryptFailed = 0
     const previewPatch: Record<string, string> = {}
     const updatePatch: Record<string, boolean> = {}
     const taskId = registerBackgroundTask({
@@ -1105,21 +1153,54 @@ function ResourcesPage() {
         lastProgressBucket = bucket
         lastProgressUpdateAt = now
       }
+      const hardlinkMd5Set = new Set<string>()
       for (const item of imageItems) {
-        if (!item.imageMd5 && !item.imageDatName) {
+        if (!hasImageLocator(item)) continue
-          failed += 1
+        const imageMd5 = normalizeMediaToken(item.imageMd5)
-          completed += 1
+        if (imageMd5) {
-          updateTaskProgress()
+          hardlinkMd5Set.add(imageMd5)
+          continue
+        }
+        const imageDatName = getSafeImageDatName(item)
+        if (/^[a-f0-9]{32}$/i.test(imageDatName)) {
+          hardlinkMd5Set.add(imageDatName)
+        }
+      }
+      if (hardlinkMd5Set.size > 0) {
+        try {
+          await window.electronAPI.image.preloadHardlinkMd5s(Array.from(hardlinkMd5Set))
+        } catch {
+          // ignore preload failures and continue decrypt
+        }
+      }
+
+      const concurrency = Math.max(1, Math.min(BATCH_IMAGE_DECRYPT_CONCURRENCY, imageItems.length))
+      let cursor = 0
+      const worker = async () => {
+        while (true) {
+          const index = cursor
+          cursor += 1
+          if (index >= imageItems.length) return
+          const item = imageItems[index]
+          try {
+            if (!hasImageLocator(item)) {
+              notFound += 1
               continue
             }
             const result = await window.electronAPI.image.decrypt({
               sessionId: item.sessionId,
-          imageMd5: item.imageMd5 || undefined,
+              imageMd5: normalizeMediaToken(item.imageMd5) || undefined,
-          imageDatName: item.imageDatName || undefined,
+              imageDatName: getSafeImageDatName(item) || undefined,
-          force: true
+              createTime: Number(item.createTime || 0) || undefined,
+              force: true,
+              preferFilePath: true,
+              hardlinkOnly: true,
+              allowCacheIndex: true,
+              suppressEvents: true
             })
             if (!result?.success) {
-          failed += 1
+              if (result?.failureKind === 'decrypt_failed') decryptFailed += 1
+              else notFound += 1
             } else {
               success += 1
               if (result.localPath) {
@@ -1128,9 +1209,15 @@ function ResourcesPage() {
                 updatePatch[key] = isLikelyThumbnailPreview(result.localPath)
               }
             }
+          } catch {
+            notFound += 1
+          } finally {
             completed += 1
             updateTaskProgress()
           }
+        }
+      }
+      await Promise.all(Array.from({ length: concurrency }, () => worker()))
       updateTaskProgress(true)
 
       if (Object.keys(previewPatch).length > 0) {
@@ -1139,11 +1226,11 @@ function ResourcesPage() {
       if (Object.keys(updatePatch).length > 0) {
         setPreviewUpdateMap((prev) => ({ ...prev, ...updatePatch }))
       }
-      setActionMessage(`批量解密完成：成功 ${success}，失败 ${failed}`)
+      setActionMessage(`批量解密完成：成功 ${success}，未找到 ${notFound}，解密失败 ${decryptFailed}`)
-      showAlert(`批量解密完成：成功 ${success}，失败 ${failed}`, '批量解密完成')
+      showAlert(`批量解密完成：成功 ${success}，未找到 ${notFound}，解密失败 ${decryptFailed}`, '批量解密完成')
-      finishBackgroundTask(taskId, success > 0 || failed === 0 ? 'completed' : 'failed', {
+      finishBackgroundTask(taskId, decryptFailed > 0 ? 'failed' : 'completed', {
-        detail: `资源页图片批量解密完成：成功 ${success}，失败 ${failed}`,
+        detail: `资源页图片批量解密完成：成功 ${success}，未找到 ${notFound}，解密失败 ${decryptFailed}`,
-        progressText: `成功 ${success} / 失败 ${failed}`
+        progressText: `成功 ${success} / 未找到 ${notFound} / 解密失败 ${decryptFailed}`
       })
     } catch (e) {
       finishBackgroundTask(taskId, 'failed', {

src/pages/WelcomePage.tsx

@@ -56,43 +56,28 @@ const normalizeDbKeyStatusMessage = (message: string): string => {
   return message
 }
 
-const isDbKeyReadyMessage = (message: string): boolean => (
+const isDbKeyReadyMessage = (message: string): boolean => {
-  message.includes('现在可以登录')
+  if (isWindows) {
+    return message.includes('现在可以登录')
       || message.includes('Hook安装成功')
       || message.includes('已准备就绪，现在登录微信或退出登录后重新登录微信')
-)
+  }
+  return message.includes('现在可以登录')
+}
 
-const pickWxidByAnchorTime = (
+const pickLatestWxid = (
-  wxids: Array<{ wxid: string; modifiedTime: number }>,
+  wxids: Array<{ wxid: string; modifiedTime: number }>
-  anchorTime?: number
 ): string => {
   if (!Array.isArray(wxids) || wxids.length === 0) return ''
   const fallbackWxid = wxids[0]?.wxid || ''
-  if (!anchorTime || !Number.isFinite(anchorTime)) return fallbackWxid
-
   const valid = wxids.filter(item => Number.isFinite(item.modifiedTime) && item.modifiedTime > 0)
   if (valid.length === 0) return fallbackWxid
 
-  const anchor = Number(anchorTime)
+  const latest = [...valid].sort((a, b) => {
-  const nearWindowMs = 10 * 60 * 1000
-
-  const near = valid
-    .filter(item => Math.abs(item.modifiedTime - anchor) <= nearWindowMs)
-    .sort((a, b) => {
-      const diffGap = Math.abs(a.modifiedTime - anchor) - Math.abs(b.modifiedTime - anchor)
-      if (diffGap !== 0) return diffGap
     if (b.modifiedTime !== a.modifiedTime) return b.modifiedTime - a.modifiedTime
     return a.wxid.localeCompare(b.wxid)
   })
-  if (near.length > 0) return near[0].wxid
+  return latest[0]?.wxid || fallbackWxid
-
-  const closest = valid.sort((a, b) => {
-    const diffGap = Math.abs(a.modifiedTime - anchor) - Math.abs(b.modifiedTime - anchor)
-    if (diffGap !== 0) return diffGap
-    if (b.modifiedTime !== a.modifiedTime) return b.modifiedTime - a.modifiedTime
-    return a.wxid.localeCompare(b.wxid)
-  })
-  return closest[0]?.wxid || fallbackWxid
 }
 
 function WelcomePage({ standalone = false }: WelcomePageProps) {
@@ -434,7 +419,7 @@ function WelcomePage({ standalone = false }: WelcomePageProps) {
     }
   }
 
-  const handleScanWxid = async (silent = false, anchorTime?: number) => {
+  const handleScanWxid = async (silent = false) => {
     if (!dbPath) {
       if (!silent) setError('请先选择数据库目录')
       return
@@ -446,9 +431,8 @@ function WelcomePage({ standalone = false }: WelcomePageProps) {
       const wxids = await window.electronAPI.dbPath.scanWxids(dbPath)
       setWxidOptions(wxids)
       if (wxids.length > 0) {
-        // 密钥成功后使用成功时刻作为锚点，自动选择最接近该时刻的活跃账号；
+        // 自动获取密钥后，始终优先选择最近活跃（modifiedTime 最新）的账号。
-        // 其余场景保持“时间最新”优先。
+        const selectedWxid = pickLatestWxid(wxids)
-        const selectedWxid = pickWxidByAnchorTime(wxids, anchorTime)
         setWxid(selectedWxid || wxids[0].wxid)
         if (!silent) setError('')
       } else {
@@ -501,8 +485,7 @@ function WelcomePage({ standalone = false }: WelcomePageProps) {
         setHasReacquiredDbKey(true)
         setDbKeyStatus('密钥获取成功')
         setError('')
-        const keySuccessAt = Date.now()
+        await handleScanWxid(true)
-        await handleScanWxid(true, keySuccessAt)
       } else {
         if (isAddAccountMode) {
           setHasReacquiredDbKey(false)

src/services/backgroundTaskMonitor.ts

@@ -9,10 +9,12 @@ type BackgroundTaskListener = (tasks: BackgroundTaskRecord[]) => void
 
 const tasks = new Map<string, BackgroundTaskRecord>()
 const cancelHandlers = new Map<string, () => void | Promise<void>>()
+const pauseHandlers = new Map<string, () => void | Promise<void>>()
+const resumeHandlers = new Map<string, () => void | Promise<void>>()
 const listeners = new Set<BackgroundTaskListener>()
 let taskSequence = 0
 
-const ACTIVE_STATUSES = new Set<BackgroundTaskStatus>(['running', 'cancel_requested'])
+const ACTIVE_STATUSES = new Set<BackgroundTaskStatus>(['running', 'pause_requested', 'paused', 'cancel_requested'])
 const MAX_SETTLED_TASKS = 24
 
 const buildTaskId = (): string => {
@@ -34,6 +36,9 @@ const pruneSettledTasks = () => {
 
   for (const staleTask of settledTasks.slice(MAX_SETTLED_TASKS)) {
     tasks.delete(staleTask.id)
+    cancelHandlers.delete(staleTask.id)
+    pauseHandlers.delete(staleTask.id)
+    resumeHandlers.delete(staleTask.id)
   }
 }
 
@@ -64,7 +69,9 @@ export const registerBackgroundTask = (input: BackgroundTaskInput): string => {
     detail: input.detail,
     progressText: input.progressText,
     cancelable: input.cancelable !== false,
+    resumable: input.resumable === true,
     cancelRequested: false,
+    pauseRequested: false,
     status: 'running',
     startedAt: now,
     updatedAt: now
@@ -72,6 +79,12 @@ export const registerBackgroundTask = (input: BackgroundTaskInput): string => {
   if (input.onCancel) {
     cancelHandlers.set(taskId, input.onCancel)
   }
+  if (input.onPause) {
+    pauseHandlers.set(taskId, input.onPause)
+  }
+  if (input.onResume) {
+    resumeHandlers.set(taskId, input.onResume)
+  }
   pruneSettledTasks()
   notifyListeners()
   return taskId
@@ -87,6 +100,9 @@ export const updateBackgroundTask = (taskId: string, patch: BackgroundTaskUpdate
     ...patch,
     status: nextStatus,
     updatedAt: nextUpdatedAt,
+    pauseRequested: nextStatus === 'paused' || nextStatus === 'pause_requested'
+      ? true
+      : (nextStatus === 'running' ? false : existing.pauseRequested),
     finishedAt: ACTIVE_STATUSES.has(nextStatus) ? undefined : (existing.finishedAt || nextUpdatedAt)
   })
   pruneSettledTasks()
@@ -107,9 +123,12 @@ export const finishBackgroundTask = (
     status,
     updatedAt: now,
     finishedAt: now,
-    cancelRequested: status === 'canceled' ? true : existing.cancelRequested
+    cancelRequested: status === 'canceled' ? true : existing.cancelRequested,
+    pauseRequested: false
   })
   cancelHandlers.delete(taskId)
+  pauseHandlers.delete(taskId)
+  resumeHandlers.delete(taskId)
   pruneSettledTasks()
   notifyListeners()
 }
@@ -121,6 +140,7 @@ export const requestCancelBackgroundTask = (taskId: string): boolean => {
     ...existing,
     status: 'cancel_requested',
     cancelRequested: true,
+    pauseRequested: false,
     detail: existing.detail || '停止请求已发出，当前查询完成后会结束后续加载',
     updatedAt: Date.now()
   })
@@ -132,6 +152,46 @@ export const requestCancelBackgroundTask = (taskId: string): boolean => {
   return true
 }
 
+export const requestPauseBackgroundTask = (taskId: string): boolean => {
+  const existing = tasks.get(taskId)
+  if (!existing || !existing.resumable) return false
+  if (existing.status !== 'running' && existing.status !== 'pause_requested') return false
+  tasks.set(taskId, {
+    ...existing,
+    status: 'pause_requested',
+    pauseRequested: true,
+    detail: existing.detail || '中断请求已发出，当前处理完成后会暂停',
+    updatedAt: Date.now()
+  })
+  const pauseHandler = pauseHandlers.get(taskId)
+  if (pauseHandler) {
+    void Promise.resolve(pauseHandler()).catch(() => {})
+  }
+  notifyListeners()
+  return true
+}
+
+export const requestResumeBackgroundTask = (taskId: string): boolean => {
+  const existing = tasks.get(taskId)
+  if (!existing || !existing.resumable) return false
+  if (existing.status !== 'paused' && existing.status !== 'pause_requested') return false
+  tasks.set(taskId, {
+    ...existing,
+    status: 'running',
+    cancelRequested: false,
+    pauseRequested: false,
+    detail: existing.detail || '任务已继续',
+    updatedAt: Date.now(),
+    finishedAt: undefined
+  })
+  const resumeHandler = resumeHandlers.get(taskId)
+  if (resumeHandler) {
+    void Promise.resolve(resumeHandler()).catch(() => {})
+  }
+  notifyListeners()
+  return true
+}
+
 export const requestCancelBackgroundTasks = (predicate: (task: BackgroundTaskRecord) => boolean): number => {
   let canceledCount = 0
   for (const task of tasks.values()) {
@@ -147,3 +207,8 @@ export const isBackgroundTaskCancelRequested = (taskId: string): boolean => {
   const task = tasks.get(taskId)
   return Boolean(task?.cancelRequested)
 }
+
+export const isBackgroundTaskPauseRequested = (taskId: string): boolean => {
+  const task = tasks.get(taskId)
+  return Boolean(task?.pauseRequested)
+}

src/services/config.ts

@@ -37,7 +37,6 @@ export const CONFIG_KEYS = {
   EXPORT_DEFAULT_EXCEL_COMPACT_COLUMNS: 'exportDefaultExcelCompactColumns',
   EXPORT_DEFAULT_TXT_COLUMNS: 'exportDefaultTxtColumns',
   EXPORT_DEFAULT_CONCURRENCY: 'exportDefaultConcurrency',
-  EXPORT_DEFAULT_IMAGE_DEEP_SEARCH_ON_MISS: 'exportDefaultImageDeepSearchOnMiss',
   EXPORT_WRITE_LAYOUT: 'exportWriteLayout',
   EXPORT_SESSION_NAME_PREFIX_ENABLED: 'exportSessionNamePrefixEnabled',
   EXPORT_LAST_SESSION_RUN_MAP: 'exportLastSessionRunMap',
@@ -559,18 +558,6 @@ export async function setExportDefaultConcurrency(concurrency: number): Promise<
   await config.set(CONFIG_KEYS.EXPORT_DEFAULT_CONCURRENCY, concurrency)
 }
 
-// 获取缺图时是否深度搜索（默认导出行为）
-export async function getExportDefaultImageDeepSearchOnMiss(): Promise<boolean | null> {
-  const value = await config.get(CONFIG_KEYS.EXPORT_DEFAULT_IMAGE_DEEP_SEARCH_ON_MISS)
-  if (typeof value === 'boolean') return value
-  return null
-}
-
-// 设置缺图时是否深度搜索（默认导出行为）
-export async function setExportDefaultImageDeepSearchOnMiss(enabled: boolean): Promise<void> {
-  await config.set(CONFIG_KEYS.EXPORT_DEFAULT_IMAGE_DEEP_SEARCH_ON_MISS, enabled)
-}
-
 export type ExportWriteLayout = 'A' | 'B' | 'C'
 
 export async function getExportWriteLayout(): Promise<ExportWriteLayout> {
@@ -713,11 +700,17 @@ const normalizeAutomationTask = (raw: unknown): ExportAutomationTask | null => {
   if (scheduleType === 'interval') {
     const rawDays = Math.max(0, normalizeAutomationNumeric(scheduleObj.intervalDays, 0))
     const rawHours = Math.max(0, normalizeAutomationNumeric(scheduleObj.intervalHours, 0))
+    const rawFirstTriggerAt = Math.max(0, normalizeAutomationNumeric(scheduleObj.firstTriggerAt, 0))
     const totalHours = (rawDays * 24) + rawHours
     if (totalHours <= 0) return null
     const intervalDays = Math.floor(totalHours / 24)
     const intervalHours = totalHours % 24
-    schedule = { type: 'interval', intervalDays, intervalHours }
+    schedule = {
+      type: 'interval',
+      intervalDays,
+      intervalHours,
+      firstTriggerAt: rawFirstTriggerAt > 0 ? rawFirstTriggerAt : undefined
+    }
   }
   if (!schedule) return null
 

src/stores/batchImageDecryptStore.ts

@@ -4,7 +4,21 @@ import {
   registerBackgroundTask,
   updateBackgroundTask
 } from '../services/backgroundTaskMonitor'
-import type { BackgroundTaskSourcePage } from '../types/backgroundTask'
+import type { BackgroundTaskSourcePage, BackgroundTaskStatus } from '../types/backgroundTask'
+
+interface BatchDecryptTaskControls {
+  cancelable?: boolean
+  resumable?: boolean
+  onCancel?: () => void | Promise<void>
+  onPause?: () => void | Promise<void>
+  onResume?: () => void | Promise<void>
+}
+
+interface BatchDecryptFinishOptions {
+  status?: Extract<BackgroundTaskStatus, 'completed' | 'failed' | 'canceled'>
+  detail?: string
+  progressText?: string
+}
 
 export interface BatchImageDecryptState {
   isBatchDecrypting: boolean
@@ -16,9 +30,15 @@ export interface BatchImageDecryptState {
   sessionName: string
   taskId: string | null
 
-  startDecrypt: (total: number, sessionName: string, sourcePage?: BackgroundTaskSourcePage) => void
+  startDecrypt: (
+    total: number,
+    sessionName: string,
+    sourcePage?: BackgroundTaskSourcePage,
+    controls?: BatchDecryptTaskControls
+  ) => void
   updateProgress: (current: number, total: number) => void
-  finishDecrypt: (success: number, fail: number) => void
+  setTaskStatus: (detail: string, progressText?: string, status?: BackgroundTaskStatus) => void
+  finishDecrypt: (success: number, fail: number, options?: BatchDecryptFinishOptions) => void
   setShowToast: (show: boolean) => void
   setShowResultToast: (show: boolean) => void
   reset: () => void
@@ -53,7 +73,7 @@ export const useBatchImageDecryptStore = create<BatchImageDecryptState>((set, ge
   sessionName: '',
   taskId: null,
 
-  startDecrypt: (total, sessionName, sourcePage = 'chat') => {
+  startDecrypt: (total, sessionName, sourcePage = 'chat', controls) => {
     const previousTaskId = get().taskId
     if (previousTaskId) {
       taskProgressUpdateMeta.delete(previousTaskId)
@@ -73,7 +93,11 @@ export const useBatchImageDecryptStore = create<BatchImageDecryptState>((set, ge
       title,
       detail: `正在解密图片（${normalizedProgress.current}/${normalizedProgress.total}）`,
       progressText: `${normalizedProgress.current} / ${normalizedProgress.total}`,
-      cancelable: false
+      cancelable: controls?.cancelable !== false,
+      resumable: controls?.resumable === true,
+      onCancel: controls?.onCancel,
+      onPause: controls?.onPause,
+      onResume: controls?.onResume
     })
     taskProgressUpdateMeta.set(taskId, {
       lastAt: Date.now(),
@@ -97,6 +121,7 @@ export const useBatchImageDecryptStore = create<BatchImageDecryptState>((set, ge
     const previousProgress = get().progress
     const normalizedProgress = clampProgress(current, total)
     const taskId = get().taskId
+    let shouldCommitUi = true
     if (taskId) {
       const now = Date.now()
       const meta = taskProgressUpdateMeta.get(taskId)
@@ -105,7 +130,9 @@ export const useBatchImageDecryptStore = create<BatchImageDecryptState>((set, ge
       const intervalReached = !meta || (now - meta.lastAt >= TASK_PROGRESS_UPDATE_MIN_INTERVAL_MS)
       const crossedBucket = !meta || bucket !== meta.lastBucket
       const isFinal = normalizedProgress.total > 0 && normalizedProgress.current >= normalizedProgress.total
-      if (crossedBucket || intervalReached || isFinal) {
+      const shouldPublish = crossedBucket || intervalReached || isFinal
+      shouldCommitUi = shouldPublish
+      if (shouldPublish) {
         updateBackgroundTask(taskId, {
           detail: `正在解密图片（${normalizedProgress.current}/${normalizedProgress.total}）`,
           progressText: `${normalizedProgress.current} / ${normalizedProgress.total}`
@@ -117,26 +144,38 @@ export const useBatchImageDecryptStore = create<BatchImageDecryptState>((set, ge
         })
       }
     }
-    if (
+    if (shouldCommitUi && (
       previousProgress.current !== normalizedProgress.current ||
       previousProgress.total !== normalizedProgress.total
-    ) {
+    )) {
       set({
         progress: normalizedProgress
       })
     }
   },
 
-  finishDecrypt: (success, fail) => {
+  setTaskStatus: (detail, progressText, status) => {
+    const taskId = get().taskId
+    if (!taskId) return
+    const normalizedDetail = String(detail || '').trim()
+    if (!normalizedDetail) return
+    updateBackgroundTask(taskId, {
+      detail: normalizedDetail,
+      progressText,
+      status
+    })
+  },
+
+  finishDecrypt: (success, fail, options) => {
     const taskId = get().taskId
     const normalizedSuccess = Number.isFinite(success) ? Math.max(0, Math.floor(success)) : 0
     const normalizedFail = Number.isFinite(fail) ? Math.max(0, Math.floor(fail)) : 0
     if (taskId) {
       taskProgressUpdateMeta.delete(taskId)
-      const status = normalizedSuccess > 0 || normalizedFail === 0 ? 'completed' : 'failed'
+      const status = options?.status || (normalizedSuccess > 0 || normalizedFail === 0 ? 'completed' : 'failed')
       finishBackgroundTask(taskId, status, {
-        detail: `图片批量解密完成：成功 ${normalizedSuccess}，失败 ${normalizedFail}`,
+        detail: options?.detail || `图片批量解密完成：成功 ${normalizedSuccess}，失败 ${normalizedFail}`,
-        progressText: `成功 ${normalizedSuccess} / 失败 ${normalizedFail}`
+        progressText: options?.progressText || `成功 ${normalizedSuccess} / 失败 ${normalizedFail}`
       })
     }
 

src/stores/batchTranscribeStore.ts

@@ -1,7 +1,27 @@
 import { create } from 'zustand'
+import {
+  finishBackgroundTask,
+  registerBackgroundTask,
+  updateBackgroundTask
+} from '../services/backgroundTaskMonitor'
+import type { BackgroundTaskSourcePage, BackgroundTaskStatus } from '../types/backgroundTask'
 
 export type BatchVoiceTaskType = 'transcribe' | 'decrypt'
 
+interface BatchVoiceTaskControls {
+  cancelable?: boolean
+  resumable?: boolean
+  onCancel?: () => void | Promise<void>
+  onPause?: () => void | Promise<void>
+  onResume?: () => void | Promise<void>
+}
+
+interface BatchVoiceTaskFinishOptions {
+  status?: Extract<BackgroundTaskStatus, 'completed' | 'failed' | 'canceled'>
+  detail?: string
+  progressText?: string
+}
+
 export interface BatchTranscribeState {
   /** 是否正在批量转写 */
   isBatchTranscribing: boolean
@@ -18,17 +38,44 @@ export interface BatchTranscribeState {
   /** 当前转写的会话名 */
   startTime: number
   sessionName: string
+  taskId: string | null
 
   // Actions
-  startTranscribe: (total: number, sessionName: string, taskType?: BatchVoiceTaskType) => void
+  startTranscribe: (
+    total: number,
+    sessionName: string,
+    taskType?: BatchVoiceTaskType,
+    sourcePage?: BackgroundTaskSourcePage,
+    controls?: BatchVoiceTaskControls
+  ) => void
   updateProgress: (current: number, total: number) => void
-  finishTranscribe: (success: number, fail: number) => void
+  setTaskStatus: (detail: string, progressText?: string, status?: BackgroundTaskStatus) => void
+  finishTranscribe: (success: number, fail: number, options?: BatchVoiceTaskFinishOptions) => void
   setShowToast: (show: boolean) => void
   setShowResult: (show: boolean) => void
   reset: () => void
 }
 
-export const useBatchTranscribeStore = create<BatchTranscribeState>((set) => ({
+const clampProgress = (current: number, total: number): { current: number; total: number } => {
+  const normalizedTotal = Number.isFinite(total) ? Math.max(0, Math.floor(total)) : 0
+  const normalizedCurrentRaw = Number.isFinite(current) ? Math.max(0, Math.floor(current)) : 0
+  const normalizedCurrent = normalizedTotal > 0
+    ? Math.min(normalizedCurrentRaw, normalizedTotal)
+    : normalizedCurrentRaw
+  return { current: normalizedCurrent, total: normalizedTotal }
+}
+
+const TASK_PROGRESS_UPDATE_MIN_INTERVAL_MS = 250
+const TASK_PROGRESS_UPDATE_MAX_STEPS = 100
+
+const taskProgressUpdateMeta = new Map<string, { lastAt: number; lastBucket: number; step: number }>()
+
+const calcProgressStep = (total: number): number => {
+  if (total <= 0) return 1
+  return Math.max(1, Math.floor(total / TASK_PROGRESS_UPDATE_MAX_STEPS))
+}
+
+export const useBatchTranscribeStore = create<BatchTranscribeState>((set, get) => ({
   isBatchTranscribing: false,
   taskType: 'transcribe',
   progress: { current: 0, total: 0 },
@@ -37,34 +84,142 @@ export const useBatchTranscribeStore = create<BatchTranscribeState>((set) => ({
   result: { success: 0, fail: 0 },
   sessionName: '',
   startTime: 0,
+  taskId: null,
 
-  startTranscribe: (total, sessionName, taskType = 'transcribe') => set({
+  startTranscribe: (total, sessionName, taskType = 'transcribe', sourcePage = 'chat', controls) => {
+    const previousTaskId = get().taskId
+    if (previousTaskId) {
+      taskProgressUpdateMeta.delete(previousTaskId)
+      finishBackgroundTask(previousTaskId, 'canceled', {
+        detail: '已被新的语音批量任务替换',
+        progressText: '已替换'
+      })
+    }
+
+    const normalizedProgress = clampProgress(0, total)
+    const normalizedSessionName = String(sessionName || '').trim()
+    const taskLabel = taskType === 'decrypt' ? '语音批量解密' : '语音批量转写'
+    const title = normalizedSessionName
+      ? `${taskLabel}（${normalizedSessionName}）`
+      : taskLabel
+    const taskId = registerBackgroundTask({
+      sourcePage,
+      title,
+      detail: `正在准备${taskType === 'decrypt' ? '语音解密' : '语音转写'}任务...`,
+      progressText: `${normalizedProgress.current} / ${normalizedProgress.total}`,
+      cancelable: controls?.cancelable !== false,
+      resumable: controls?.resumable === true,
+      onCancel: controls?.onCancel,
+      onPause: controls?.onPause,
+      onResume: controls?.onResume
+    })
+    taskProgressUpdateMeta.set(taskId, {
+      lastAt: Date.now(),
+      lastBucket: 0,
+      step: calcProgressStep(normalizedProgress.total)
+    })
+
+    set({
       isBatchTranscribing: true,
       taskType,
-    showToast: true,
+      showToast: false,
-    progress: { current: 0, total },
+      progress: normalizedProgress,
       showResult: false,
       result: { success: 0, fail: 0 },
-    sessionName,
+      sessionName: normalizedSessionName,
-    startTime: Date.now()
+      startTime: Date.now(),
-  }),
+      taskId
+    })
+  },
 
-  updateProgress: (current, total) => set({
+  updateProgress: (current, total) => {
-    progress: { current, total }
+    const previousProgress = get().progress
-  }),
+    const normalizedProgress = clampProgress(current, total)
+    const taskId = get().taskId
+    let shouldCommitUi = true
+    if (taskId) {
+      const now = Date.now()
+      const meta = taskProgressUpdateMeta.get(taskId)
+      const step = meta?.step || calcProgressStep(normalizedProgress.total)
+      const bucket = Math.floor(normalizedProgress.current / step)
+      const intervalReached = !meta || (now - meta.lastAt >= TASK_PROGRESS_UPDATE_MIN_INTERVAL_MS)
+      const crossedBucket = !meta || bucket !== meta.lastBucket
+      const isFinal = normalizedProgress.total > 0 && normalizedProgress.current >= normalizedProgress.total
+      const shouldPublish = crossedBucket || intervalReached || isFinal
+      shouldCommitUi = shouldPublish
+      if (shouldPublish) {
+        const taskVerb = get().taskType === 'decrypt' ? '解密语音' : '转写语音'
+        updateBackgroundTask(taskId, {
+          detail: `正在${taskVerb}（${normalizedProgress.current}/${normalizedProgress.total}）`,
+          progressText: `${normalizedProgress.current} / ${normalizedProgress.total}`
+        })
+        taskProgressUpdateMeta.set(taskId, {
+          lastAt: now,
+          lastBucket: bucket,
+          step
+        })
+      }
+    }
+    if (shouldCommitUi && (
+      previousProgress.current !== normalizedProgress.current ||
+      previousProgress.total !== normalizedProgress.total
+    )) {
+      set({
+        progress: normalizedProgress
+      })
+    }
+  },
 
-  finishTranscribe: (success, fail) => set({
+  setTaskStatus: (detail, progressText, status) => {
+    const taskId = get().taskId
+    if (!taskId) return
+    const normalizedDetail = String(detail || '').trim()
+    if (!normalizedDetail) return
+    updateBackgroundTask(taskId, {
+      detail: normalizedDetail,
+      progressText,
+      status
+    })
+  },
+
+  finishTranscribe: (success, fail, options) => {
+    const taskId = get().taskId
+    const normalizedSuccess = Number.isFinite(success) ? Math.max(0, Math.floor(success)) : 0
+    const normalizedFail = Number.isFinite(fail) ? Math.max(0, Math.floor(fail)) : 0
+    const taskType = get().taskType
+    if (taskId) {
+      taskProgressUpdateMeta.delete(taskId)
+      const status = options?.status || (normalizedSuccess > 0 || normalizedFail === 0 ? 'completed' : 'failed')
+      const taskLabel = taskType === 'decrypt' ? '语音批量解密' : '语音批量转写'
+      finishBackgroundTask(taskId, status, {
+        detail: options?.detail || `${taskLabel}完成：成功 ${normalizedSuccess}，失败 ${normalizedFail}`,
+        progressText: options?.progressText || `成功 ${normalizedSuccess} / 失败 ${normalizedFail}`
+      })
+    }
+
+    set({
       isBatchTranscribing: false,
       showToast: false,
-    showResult: true,
+      showResult: false,
-    result: { success, fail },
+      result: { success: normalizedSuccess, fail: normalizedFail },
-    startTime: 0
+      startTime: 0,
-  }),
+      taskId: null
+    })
+  },
 
   setShowToast: (show) => set({ showToast: show }),
   setShowResult: (show) => set({ showResult: show }),
 
-  reset: () => set({
+  reset: () => {
+    const taskId = get().taskId
+    if (taskId) {
+      taskProgressUpdateMeta.delete(taskId)
+      finishBackgroundTask(taskId, 'canceled', {
+        detail: '语音批量任务已重置',
+        progressText: '已停止'
+      })
+    }
+    set({
       isBatchTranscribing: false,
       taskType: 'transcribe',
       progress: { current: 0, total: 0 },
@@ -72,6 +227,8 @@ export const useBatchTranscribeStore = create<BatchTranscribeState>((set) => ({
       showResult: false,
       result: { success: 0, fail: 0 },
       sessionName: '',
-    startTime: 0
+      startTime: 0,
+      taskId: null
     })
+  }
 }))

src/types/backgroundTask.ts

@@ -9,6 +9,8 @@ export type BackgroundTaskSourcePage =
 
 export type BackgroundTaskStatus =
   | 'running'
+  | 'pause_requested'
+  | 'paused'
   | 'cancel_requested'
   | 'completed'
   | 'failed'
@@ -21,7 +23,9 @@ export interface BackgroundTaskRecord {
   detail?: string
   progressText?: string
   cancelable: boolean
+  resumable: boolean
   cancelRequested: boolean
+  pauseRequested: boolean
   status: BackgroundTaskStatus
   startedAt: number
   updatedAt: number
@@ -34,7 +38,10 @@ export interface BackgroundTaskInput {
   detail?: string
   progressText?: string
   cancelable?: boolean
+  resumable?: boolean
   onCancel?: () => void | Promise<void>
+  onPause?: () => void | Promise<void>
+  onResume?: () => void | Promise<void>
 }
 
 export interface BackgroundTaskUpdate {

src/types/electron.d.ts

@@ -505,26 +505,42 @@ export interface ElectronAPI {
   }
 
   image: {
-    decrypt: (payload: { sessionId?: string; imageMd5?: string; imageDatName?: string; force?: boolean }) => Promise<{ success: boolean; localPath?: string; liveVideoPath?: string; error?: string }>
+    decrypt: (payload: {
+      sessionId?: string
+      imageMd5?: string
+      imageDatName?: string
+      createTime?: number
+      force?: boolean
+      preferFilePath?: boolean
+      hardlinkOnly?: boolean
+      disableUpdateCheck?: boolean
+      allowCacheIndex?: boolean
+      suppressEvents?: boolean
+    }) => Promise<{ success: boolean; localPath?: string; liveVideoPath?: string; error?: string; failureKind?: 'not_found' | 'decrypt_failed' }>
     resolveCache: (payload: {
       sessionId?: string
       imageMd5?: string
       imageDatName?: string
+      createTime?: number
+      preferFilePath?: boolean
+      hardlinkOnly?: boolean
       disableUpdateCheck?: boolean
       allowCacheIndex?: boolean
-    }) => Promise<{ success: boolean; localPath?: string; hasUpdate?: boolean; liveVideoPath?: string; error?: string }>
+      suppressEvents?: boolean
+    }) => Promise<{ success: boolean; localPath?: string; hasUpdate?: boolean; liveVideoPath?: string; error?: string; failureKind?: 'not_found' | 'decrypt_failed' }>
     resolveCacheBatch: (
-      payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string }>,
+      payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string; createTime?: number; preferFilePath?: boolean; hardlinkOnly?: boolean }>,
-      options?: { disableUpdateCheck?: boolean; allowCacheIndex?: boolean }
+      options?: { disableUpdateCheck?: boolean; allowCacheIndex?: boolean; preferFilePath?: boolean; hardlinkOnly?: boolean; suppressEvents?: boolean }
     ) => Promise<{
       success: boolean
-      rows?: Array<{ success: boolean; localPath?: string; hasUpdate?: boolean; error?: string }>
+      rows?: Array<{ success: boolean; localPath?: string; hasUpdate?: boolean; error?: string; failureKind?: 'not_found' | 'decrypt_failed' }>
       error?: string
     }>
     preload: (
-      payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string }>,
+      payloads: Array<{ sessionId?: string; imageMd5?: string; imageDatName?: string; createTime?: number }>,
       options?: { allowDecrypt?: boolean; allowCacheIndex?: boolean }
     ) => Promise<boolean>
+    preloadHardlinkMd5s: (md5List: string[]) => Promise<boolean>
     onUpdateAvailable: (callback: (payload: { cacheKey: string; imageMd5?: string; imageDatName?: string }) => void) => () => void
     onCacheResolved: (callback: (payload: { cacheKey: string; imageMd5?: string; imageDatName?: string; localPath: string }) => void) => () => void
     onDecryptProgress: (callback: (payload: {
@@ -1135,7 +1151,6 @@ export interface ExportOptions {
   sessionNameWithTypePrefix?: boolean
   displayNamePreference?: 'group-nickname' | 'remark' | 'nickname'
   exportConcurrency?: number
-  imageDeepSearchOnMiss?: boolean
 }
 
 export interface ExportProgress {

src/types/exportAutomation.ts

@@ -8,6 +8,7 @@ export type ExportAutomationSchedule =
       type: 'interval'
       intervalDays: number
       intervalHours: number
+      firstTriggerAt?: number
     }
 
 export interface ExportAutomationCondition {