Files
PolyWeather/frontend/components/dashboard/scan-terminal/use-ai-city-forecast.ts
T
2569718930@qq.com 59e099a56d 修复 AI 报文解读缓存未在首帧生效的问题
此前 useState 初始化为 idle,useEffect 异步读缓存后才切到 ready,
导致重新打开城市卡片时先闪烁"等待 AI 解读..."再跳转到缓存数据。
现在用 lazy initializer 在首帧同步读取缓存,命中则直接渲染 ready
状态,零闪烁。
2026-05-06 16:34:19 +08:00

134 lines
3.4 KiB
TypeScript

"use client";
import { useCallback, useEffect, useMemo, useState } from "react";
import { scanTerminalClient } from "@/components/dashboard/scan-terminal/scan-terminal-client";
import type { AiCityForecastState } from "@/components/dashboard/scan-terminal/types";
import type { CityDetail } from "@/lib/dashboard-types";
import {
buildAiCityErrorForecastState,
buildAiCityForecastCacheKey,
buildAiCityForecastKey,
buildAiCityForecastRequestKey,
buildAiCityLoadingForecastState,
buildAiCityProgressForecastState,
buildAiCityReadyForecastState,
readReadyCachedAiForecastState,
} from "./ai-city-forecast-stream-state";
export function useAiCityForecast({
detail,
detailCityName,
isEn,
locale,
report,
enabled = true,
}: {
detail: CityDetail | null;
detailCityName: string;
enabled?: boolean;
isEn: boolean;
locale: string;
report: string;
}) {
const [aiRefreshToken, setAiRefreshToken] = useState(0);
const aiForecastKey = useMemo(
() => buildAiCityForecastKey({ detail, detailCityName, locale, report }),
[detail, detailCityName, locale, report],
);
const [aiForecast, setAiForecast] = useState<AiCityForecastState>(() => {
if (!enabled || !aiForecastKey) return { status: "idle" };
const cacheKey = buildAiCityForecastCacheKey(aiForecastKey);
const cached = readReadyCachedAiForecastState(cacheKey, 0);
if (cached) return cached;
return { status: "idle" };
});
useEffect(() => {
if (!enabled || !aiForecastKey) {
setAiForecast({ status: "idle" });
return;
}
let cancelled = false;
const cacheKey = buildAiCityForecastCacheKey(aiForecastKey);
const requestKey = buildAiCityForecastRequestKey(cacheKey, aiRefreshToken);
// If cache was loaded into initial state and no force refresh, skip
if (aiRefreshToken === 0) {
const cached = readReadyCachedAiForecastState(cacheKey, 0);
if (cached) {
setAiForecast(cached);
return () => { cancelled = true; };
}
}
const loadingState = buildAiCityLoadingForecastState({
cacheKey,
detail,
isEn,
report,
});
setAiForecast(loadingState);
void scanTerminalClient.streamAiCityRead({
city: detailCityName,
forceRefresh: aiRefreshToken > 0,
locale,
onProgress: (progress) => {
if (cancelled) return;
setAiForecast((current) =>
buildAiCityProgressForecastState({
cacheKey,
current,
isEn,
progress,
}) ?? current,
);
},
requestKey,
})
.then((payload) => {
if (!payload) return;
const readyState = buildAiCityReadyForecastState({
cacheKey,
detail,
isEn,
payload,
report,
});
if (!cancelled) {
setAiForecast(readyState);
}
})
.catch((error) => {
const errorState = buildAiCityErrorForecastState({
cacheKey,
detail,
error,
isEn,
report,
});
if (!cancelled) {
setAiForecast(errorState);
}
});
return () => {
cancelled = true;
};
}, [
aiForecastKey,
aiRefreshToken,
detail,
detailCityName,
enabled,
isEn,
locale,
report,
]);
const refreshAiForecast = useCallback(() => {
setAiRefreshToken((current) => current + 1);
}, []);
return { aiForecast, refreshAiForecast };
}