⚡️ perf(driver-manager): 优化驱动状态缓存与加载协调

- 抽离驱动状态快照注册、恢复和请求收尾逻辑
- 避免过期请求覆盖最新目录状态或持续占用加载态
- 补充缓存恢复与请求竞态回归测试

frontend/src/utils/driverImportGuidance.test.ts

@@ -1,5 +1,6 @@
 import { describe, expect, it } from 'vitest';
 
+import { resolveDriverErrorMessageText } from '../components/DriverManagerModal';
 import { t as catalogT } from '../i18n/catalog';
 import { t } from '../i18n';
 import {
@@ -68,8 +69,6 @@ describe('driver import guidance', () => {
     backendWrapperKeys,
     expected,
   }) => {
-    const { resolveDriverErrorMessageText } = await import('../components/DriverManagerModal');
-
     expect(resolveDriverErrorMessageText(
       rawMessage,
       fallbackMessage,

frontend/src/utils/driverManagerRequestState.ts

@@ -0,0 +1,96 @@
+export type DriverStatusSnapshot<TRow> = {
+  rows: TRow[];
+  downloadDir: string;
+  cachedAt: number;
+  intentSequence: number;
+};
+
+export type DriverNetworkSnapshot<TStatus> = {
+  status: TStatus;
+  cachedAt: number;
+};
+
+const DEFAULT_DRIVER_STATUS_REQUEST_KEY = '<default>';
+
+export const normalizeDriverStatusRequestKey = (downloadDir: string): string => (
+  String(downloadDir || '').trim() || DEFAULT_DRIVER_STATUS_REQUEST_KEY
+);
+
+export const createDriverStatusSnapshotRegistry = <TRow>() => {
+  const snapshots = new Map<string, DriverStatusSnapshot<TRow>>();
+  const latestIntentByKey = new Map<string, number>();
+  let preferredRequestKey = DEFAULT_DRIVER_STATUS_REQUEST_KEY;
+
+  return {
+    beginRequest(downloadDir: string, intentSequence: number): string {
+      const requestKey = normalizeDriverStatusRequestKey(downloadDir);
+      preferredRequestKey = requestKey;
+      latestIntentByKey.set(requestKey, intentSequence);
+      return requestKey;
+    },
+
+    getPreferred(): DriverStatusSnapshot<TRow> | null {
+      return snapshots.get(preferredRequestKey) || null;
+    },
+
+    write(requestKey: string, snapshot: DriverStatusSnapshot<TRow>): boolean {
+      const normalizedRequestKey = normalizeDriverStatusRequestKey(requestKey);
+      const latestIntentForKey = latestIntentByKey.get(normalizedRequestKey) || 0;
+      const cachedSnapshot = snapshots.get(normalizedRequestKey);
+      if (
+        snapshot.intentSequence < latestIntentForKey
+        || snapshot.intentSequence < (cachedSnapshot?.intentSequence || 0)
+      ) {
+        return false;
+      }
+      snapshots.set(normalizedRequestKey, snapshot);
+      return true;
+    },
+  };
+};
+
+export const settleLatestDriverRequest = (
+  requestGeneration: number,
+  latestRequestGeneration: number,
+  setLoading: (loading: boolean) => void,
+): boolean => {
+  if (requestGeneration !== latestRequestGeneration) {
+    return false;
+  }
+  setLoading(false);
+  return true;
+};
+
+export const restoreDriverStatusSnapshot = <TRow>(
+  snapshot: DriverStatusSnapshot<TRow> | null,
+  callbacks: {
+    setRows: (rows: TRow[]) => void;
+    setLoading: (loading: boolean) => void;
+    setDownloadDir: (downloadDir: string) => void;
+  },
+): boolean => {
+  if (!snapshot) {
+    return false;
+  }
+  callbacks.setRows(snapshot.rows);
+  callbacks.setLoading(false);
+  if (snapshot.downloadDir) {
+    callbacks.setDownloadDir(snapshot.downloadDir);
+  }
+  return true;
+};
+
+export const restoreDriverNetworkSnapshot = <TStatus>(
+  snapshot: DriverNetworkSnapshot<TStatus> | null,
+  callbacks: {
+    setStatus: (status: TStatus) => void;
+    setLoading: (loading: boolean) => void;
+  },
+): boolean => {
+  if (!snapshot) {
+    return false;
+  }
+  callbacks.setStatus(snapshot.status);
+  callbacks.setLoading(false);
+  return true;
+};