feat(desktop-client): 阶段4-6 Electron EXE 客户端（登录/课表/作业/通知/成绩/设置 + Socket.IO 实时 + IndexedDB 离线缓存与自动同步 + electron-builder 打包）

packages/desktop-client/src/renderer/cache/index.ts

@@ -0,0 +1,54 @@
+import { cacheGet, cacheSet, type CacheStore } from './db.js';
+
+export interface CachedFetchResult<T> {
+  data: T;
+  /** true 表示本次数据来自本地缓存（网络失败或未联网） */
+  fromCache: boolean;
+  /** 缓存写入时间（来自缓存时有效） */
+  updatedAt: number | null;
+  /** 网络失败原因（成功时为 null） */
+  error: string | null;
+}
+
+/**
+ * 带离线回退的取数：
+ * 1) 先请求网络，成功则写入缓存并返回
+ * 2) 网络失败则读取缓存；缓存缺失时返回调用方提供的兜底值
+ *
+ * 「联网后自动同步」由调用方在重连事件里再次调用本函数完成。
+ */
+export async function fetchWithCache<T>(
+  store: CacheStore,
+  key: string,
+  loader: () => Promise<T>,
+  fallback: T,
+): Promise<CachedFetchResult<T>> {
+  try {
+    const data = await loader();
+    await cacheSet(store, key, data);
+    return { data, fromCache: false, updatedAt: Date.now(), error: null };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const cached = await cacheGet<T>(store, key).catch(() => null);
+    if (cached) {
+      return { data: cached.value, fromCache: true, updatedAt: cached.updatedAt, error: message };
+    }
+    return { data: fallback, fromCache: false, updatedAt: null, error: message };
+  }
+}
+
+/** 只读缓存（不再发请求），用于启动时先渲染旧数据 */
+export async function readCache<T>(
+  store: CacheStore,
+  key: string,
+  fallback: T,
+): Promise<CachedFetchResult<T>> {
+  const cached = await cacheGet<T>(store, key).catch(() => null);
+  if (cached) return { data: cached.value, fromCache: true, updatedAt: cached.updatedAt, error: null };
+  return { data: fallback, fromCache: false, updatedAt: null, error: null };
+}
+
+/** 把实时推送的数据直接写入缓存，保证离线时看到的是最新内容 */
+export async function writeCache<T>(store: CacheStore, key: string, value: T): Promise<void> {
+  await cacheSet(store, key, value);
+}