Skip to content

World's first open-source enterprise world model.

A burst of graph events refetches the graph once, not once per event (#263)

WaylandYang75e63bfa08df
diff --git a/web/src/useKbEvents.ts b/web/src/useKbEvents.ts
index c1d72f2b..29d2469d 100644
--- a/web/src/useKbEvents.ts
+++ b/web/src/useKbEvents.ts
@@ -1,35 +1,50 @@
// KB 事件流订阅:收到事件只做 react-query 失效重取(事件不带业务数据,天然幂等)。
// EventSource 断线自动重连;替代 Library/Review 的轮询。
+//
+// **失效是合并着做的。** 一篇文档抽取时每落一条事实就发一个 graph 事件,
+// 从前每个事件各失效一次,图谱页在那几秒里把 overview 重取了十几遍——
+// 每次都是同一张图,最后一次才算数。所以事件只把 key 记下来,停顿一小会
+// 再一次性失效:一阵事件只换来一次重取,最后那次一定包含之前所有的变化。
+// 幂等性没变,只是把「每条都刷」变成「刷最后一条」。
import { useEffect } from "react";
-import { useQueryClient } from "@tanstack/react-query";
+import { useQueryClient, type QueryKey } from "@tanstack/react-query";
+
+/** 一阵事件之间的静默期。抽取落事实的间隔远小于它,人眼看不出这点延迟 */
+const SETTLE_MS = 300;
export function useKbEvents(kbId: string | undefined) {
const queryClient = useQueryClient();
useEffect(() => {
if (!kbId) return;
+ const pending = new Map<string, QueryKey>();
+ let timer: ReturnType<typeof setTimeout> | null = null;
+ const flush = () => {
+ timer = null;
+ const keys = [...pending.values()];
+ pending.clear();
+ for (const key of keys) queryClient.invalidateQueries({ queryKey: key });
+ };
+ const invalidate = (...keys: QueryKey[]) => {
+ for (const key of keys) pending.set(JSON.stringify(key), key);
+ if (timer === null) timer = setTimeout(flush, SETTLE_MS);
+ };
+
const es = new EventSource(`/api/v1/kbs/${kbId}/events`);
- es.addEventListener("document", () => {
- queryClient.invalidateQueries({ queryKey: ["documents", kbId] });
- queryClient.invalidateQueries({ queryKey: ["graph"] });
- });
- es.addEventListener("graph", () => {
- queryClient.invalidateQueries({ queryKey: ["graph"] });
- });
- es.addEventListener("review", () => {
- queryClient.invalidateQueries({ queryKey: ["review", kbId] });
- // 映射探索跑完发的也是 review:Pending 那一栏得跟着刷新
- queryClient.invalidateQueries({ queryKey: ["mappings", kbId] });
- });
+ es.addEventListener("document", () => invalidate(["documents", kbId], ["graph"]));
+ es.addEventListener("graph", () => invalidate(["graph"]));
+ // 映射探索跑完发的也是 review:Pending 那一栏得跟着刷新
+ es.addEventListener("review", () => invalidate(["review", kbId], ["mappings", kbId]));
// 一句记忆抽出了等人点头的事实(0015):对话里那张确认卡跟着长出来
- es.addEventListener("pending", () => {
- queryClient.invalidateQueries({ queryKey: ["pending", kbId] });
- queryClient.invalidateQueries({ queryKey: ["review", kbId] });
- });
- es.addEventListener("source", () => {
- queryClient.invalidateQueries({ queryKey: ["sources", kbId] });
- queryClient.invalidateQueries({ queryKey: ["documents", kbId] });
- });
- return () => es.close();
+ es.addEventListener("pending", () => invalidate(["pending", kbId], ["review", kbId]));
+ es.addEventListener("source", () => invalidate(["sources", kbId], ["documents", kbId]));
+ return () => {
+ es.close();
+ // 卸载时把攒着的刷掉而不是丢掉:换页回来看到的必须是新数据
+ if (timer !== null) {
+ clearTimeout(timer);
+ flush();
+ }
+ };
}, [kbId, queryClient]);
}