feat(workbench): add manual task refresh

src/features/workbench/hooks/use-workbench-sync.ts

@@ -20,6 +20,7 @@ export type WorkbenchSyncState = {
   status: "connecting" | "live" | "reconnecting";
   error: string | null;
   acknowledgeEventsThrough: (eventSequence: number) => void;
+  refresh: () => Promise<void>;
 };
 
 export function useWorkbenchSync(getAccessToken?: AccessTokenProvider): WorkbenchSyncState {
@@ -30,9 +31,15 @@ export function useWorkbenchSync(getAccessToken?: AccessTokenProvider): Workbenc
   const cursorRef = useRef(0);
   const statusRef = useRef<WorkbenchSyncState["status"]>("connecting");
   const runtimeRefreshRef = useRef<number | undefined>(undefined);
+  const refreshSnapshotRef = useRef<(() => Promise<void>) | null>(null);
   const acknowledgeEventsThrough = useCallback((eventSequence: number) => {
     setEvents((current) => current.filter((event) => event.event_seq > eventSequence));
   }, []);
+  const refresh = useCallback(async () => {
+    const refreshSnapshot = refreshSnapshotRef.current;
+    if (!refreshSnapshot) throw new Error("工作台同步尚未就绪");
+    await refreshSnapshot();
+  }, []);
 
   useEffect(() => {
     const controller = new AbortController();
@@ -49,6 +56,7 @@ export function useWorkbenchSync(getAccessToken?: AccessTokenProvider): Workbenc
       setError(null);
       initialized = true;
     };
+    refreshSnapshotRef.current = loadSnapshot;
 
     const connect = async () => {
       try {
@@ -101,11 +109,12 @@ export function useWorkbenchSync(getAccessToken?: AccessTokenProvider): Workbenc
     }, RECONCILE_INTERVAL_MS);
     return () => {
       controller.abort();
+      refreshSnapshotRef.current = null;
       if (reconnectTimer !== undefined) window.clearTimeout(reconnectTimer);
       if (reconcileTimer !== undefined) window.clearInterval(reconcileTimer);
       if (runtimeRefreshRef.current !== undefined) window.clearTimeout(runtimeRefreshRef.current);
     };
   }, [getAccessToken]);
 
-  return { snapshot, events, status, error, acknowledgeEventsThrough };
+  return { snapshot, events, status, error, acknowledgeEventsThrough, refresh };
 }