@joekytc/dsh-swarm 0.1.2 → 0.2.0

package/skills/llm-wiki-skill/workbench/web/src/lib/appearance.ts

@@ -0,0 +1,114 @@
+export type ThemeMode = "light" | "dark";
+export type PaperMode = "clean" | "grid" | "laid";
+export type AccentMode = "terracotta" | "clay" | "amber" | "rose";
+export type UserBubbleMode = "soft" | "solid";
+export type HandMode = "on" | "off";
+export type DensityMode = "cozy" | "compact";
+
+export interface AppearancePrefs {
+	theme: ThemeMode;
+	paper: PaperMode;
+	accent: AccentMode;
+	userbubble: UserBubbleMode;
+	hand: HandMode;
+	density: DensityMode;
+}
+
+export const THEME_STORAGE_KEY = "llm-wiki-agent-theme";
+export const APPEARANCE_STORAGE_PREFIX = "llm-wiki-agent-appearance-";
+
+export const DEFAULT_APPEARANCE: AppearancePrefs = {
+	theme: "light",
+	paper: "clean",
+	accent: "terracotta",
+	userbubble: "soft",
+	hand: "on",
+	density: "cozy",
+};
+
+const fieldOptions = {
+	theme: ["light", "dark"],
+	paper: ["clean", "grid", "laid"],
+	accent: ["terracotta", "clay", "amber", "rose"],
+	userbubble: ["soft", "solid"],
+	hand: ["on", "off"],
+	density: ["cozy", "compact"],
+} satisfies Record<keyof AppearancePrefs, readonly string[]>;
+
+const appearanceStorageKeys = {
+	paper: `${APPEARANCE_STORAGE_PREFIX}paper`,
+	accent: `${APPEARANCE_STORAGE_PREFIX}accent`,
+	userbubble: `${APPEARANCE_STORAGE_PREFIX}userbubble`,
+	hand: `${APPEARANCE_STORAGE_PREFIX}hand`,
+	density: `${APPEARANCE_STORAGE_PREFIX}density`,
+} satisfies Record<Exclude<keyof AppearancePrefs, "theme">, string>;
+
+function isAppearanceValue<Key extends keyof AppearancePrefs>(
+	key: Key,
+	value: string | null | undefined,
+): value is AppearancePrefs[Key] {
+	return typeof value === "string" && fieldOptions[key].includes(value);
+}
+
+function readStorageValue(key: keyof AppearancePrefs, value: string | null | undefined): string | undefined {
+	return isAppearanceValue(key, value) ? value : undefined;
+}
+
+function getLocalStorage(): Storage | null {
+	if (typeof window === "undefined") return null;
+	try {
+		return window.localStorage;
+	} catch {
+		return null;
+	}
+}
+
+export function normalizeAppearancePrefs(input: Partial<Record<keyof AppearancePrefs, string | null | undefined>>): AppearancePrefs {
+	return {
+		theme: (readStorageValue("theme", input.theme) as ThemeMode | undefined) ?? DEFAULT_APPEARANCE.theme,
+		paper: (readStorageValue("paper", input.paper) as PaperMode | undefined) ?? DEFAULT_APPEARANCE.paper,
+		accent: (readStorageValue("accent", input.accent) as AccentMode | undefined) ?? DEFAULT_APPEARANCE.accent,
+		userbubble: (readStorageValue("userbubble", input.userbubble) as UserBubbleMode | undefined) ?? DEFAULT_APPEARANCE.userbubble,
+		hand: (readStorageValue("hand", input.hand) as HandMode | undefined) ?? DEFAULT_APPEARANCE.hand,
+		density: (readStorageValue("density", input.density) as DensityMode | undefined) ?? DEFAULT_APPEARANCE.density,
+	};
+}
+
+export function readAppearance(): AppearancePrefs {
+	const storage = getLocalStorage();
+	if (!storage) return DEFAULT_APPEARANCE;
+	return normalizeAppearancePrefs({
+		theme: storage.getItem(THEME_STORAGE_KEY),
+		paper: storage.getItem(appearanceStorageKeys.paper),
+		accent: storage.getItem(appearanceStorageKeys.accent),
+		userbubble: storage.getItem(appearanceStorageKeys.userbubble),
+		hand: storage.getItem(appearanceStorageKeys.hand),
+		density: storage.getItem(appearanceStorageKeys.density),
+	});
+}
+
+export function writeAppearance(prefs: AppearancePrefs): void {
+	const storage = getLocalStorage();
+	if (!storage) return;
+	storage.setItem(THEME_STORAGE_KEY, prefs.theme);
+	storage.setItem(appearanceStorageKeys.paper, prefs.paper);
+	storage.setItem(appearanceStorageKeys.accent, prefs.accent);
+	storage.setItem(appearanceStorageKeys.userbubble, prefs.userbubble);
+	storage.setItem(appearanceStorageKeys.hand, prefs.hand);
+	storage.setItem(appearanceStorageKeys.density, prefs.density);
+}
+
+export function applyAppearance(prefs: AppearancePrefs, root: HTMLElement | null = typeof document === "undefined" ? null : document.documentElement): void {
+	if (!root) return;
+	root.dataset.theme = prefs.theme;
+	root.dataset.paper = prefs.paper;
+	root.dataset.accent = prefs.accent;
+	root.dataset.userbubble = prefs.userbubble;
+	root.dataset.hand = prefs.hand;
+	root.dataset.density = prefs.density;
+	root.classList.toggle("dark", prefs.theme === "dark");
+}
+
+export function mergeAppearance(base: AppearancePrefs, patch: Partial<AppearancePrefs>): AppearancePrefs {
+	return normalizeAppearancePrefs({ ...base, ...patch });
+}

package/skills/llm-wiki-skill/workbench/web/src/lib/drawer-layout.ts

@@ -0,0 +1,41 @@
+export const DEFAULT_DRAWER_WIDTH = 420;
+export const MIN_DRAWER_WIDTH = 320;
+export const MIN_COMPOSER_WIDTH = 420;
+export const CHAT_INPUT_HORIZONTAL_PADDING = 32;
+export const MAX_DRAWER_RATIO = 0.7;
+export const DRAWER_OVERLAY_BREAKPOINT = 900;
+export const FULL_SIDEBAR_WIDTH = 252;
+export const COMPACT_SIDEBAR_WIDTH = 252;
+export const COLLAPSED_SIDEBAR_WIDTH = 52;
+export const COMPACT_BREAKPOINT = 1024;
+
+export function sidebarLayoutWidth(collapsed: boolean, viewportWidth: number): number {
+	if (collapsed) return COLLAPSED_SIDEBAR_WIDTH;
+	return viewportWidth <= COMPACT_BREAKPOINT ? COMPACT_SIDEBAR_WIDTH : FULL_SIDEBAR_WIDTH;
+}
+
+export function clampDrawerWidthForViewport(
+	width: number,
+	layout: {
+		viewportWidth: number;
+		sidebarWidth: number;
+	},
+): number {
+	const viewportWidth = Math.max(0, layout.viewportWidth);
+	const maxByViewport = Math.max(0, viewportWidth);
+	if (viewportWidth <= DRAWER_OVERLAY_BREAKPOINT) {
+		return clamp(width, Math.min(MIN_DRAWER_WIDTH, maxByViewport), maxByViewport);
+	}
+
+	const maxByRatio = Math.floor(viewportWidth * MAX_DRAWER_RATIO);
+	const reservedMainWidth = MIN_COMPOSER_WIDTH + CHAT_INPUT_HORIZONTAL_PADDING;
+	const maxByComposer = Math.max(0, viewportWidth - layout.sidebarWidth - reservedMainWidth);
+	const maxWidth = Math.max(0, Math.min(maxByRatio, maxByComposer));
+	const minWidth = Math.min(MIN_DRAWER_WIDTH, maxWidth);
+	return clamp(width, minWidth, maxWidth);
+}
+
+function clamp(value: number, min: number, max: number): number {
+	if (max <= min) return max;
+	return Math.min(Math.max(value, min), max);
+}

package/skills/llm-wiki-skill/workbench/web/src/lib/drawer-state.ts

@@ -0,0 +1,168 @@
+import type {
+	GraphCommunitySummaryPayload,
+	GraphExcludedObjectPayload,
+	GraphGlobalOverviewPayload,
+	GraphNodeSummaryPayload,
+	GraphOpenPagePayload,
+	GraphSearchResultsPayload,
+	GraphUnavailableObjectPayload,
+	Selection,
+} from "@llm-wiki/graph-engine";
+import type { ArtifactManifest } from "@/lib/api";
+
+interface PageState {
+	content?: string;
+	loading?: boolean;
+	error?: string | null;
+}
+
+export type DrawerState =
+	| { mode: "closed" }
+	| {
+			mode: "wiki";
+			path: string | null;
+			content: string;
+			loading: boolean;
+			error: string | null;
+		}
+	| {
+			mode: "artifacts";
+			artifacts: ArtifactManifest[];
+			activeArtifactId: string | null;
+		}
+	| {
+			mode: "graph-reader";
+			payload: GraphOpenPagePayload;
+			content: string;
+			loading: boolean;
+			error: string | null;
+		}
+		| {
+			mode: "graph-selection";
+			title: string;
+			selection: Selection;
+			freeText: string;
+		}
+		| {
+			mode: "graph-node-summary";
+			payload: GraphNodeSummaryPayload;
+		}
+		| {
+			mode: "graph-community-summary";
+			payload: GraphCommunitySummaryPayload;
+		}
+		| {
+			mode: "graph-search-results";
+			payload: GraphSearchResultsPayload;
+		}
+		| {
+			mode: "graph-excluded-object";
+			payload: GraphExcludedObjectPayload;
+		}
+		| {
+			mode: "graph-unavailable-object";
+			payload: GraphUnavailableObjectPayload;
+		}
+		| {
+			mode: "graph-global-overview";
+			payload: GraphGlobalOverviewPayload;
+		}
+		| {
+			mode: "graph-loading";
+			title: string;
+			message?: string;
+		}
+		| {
+			mode: "graph-empty";
+			title: string;
+			message: string;
+			reason: "missing-strong-relations" | "missing-neighbors" | "missing-community-summary" | "no-search-results";
+		}
+		| {
+			mode: "graph-error";
+			title: string;
+			message: string;
+		};
+
+export function closedDrawer(): DrawerState {
+	return { mode: "closed" };
+}
+
+export function wikiDrawer(path: string | null, state: PageState = {}): DrawerState {
+	return {
+		mode: "wiki",
+		path,
+		content: state.content ?? "",
+		loading: state.loading ?? false,
+		error: state.error ?? null,
+	};
+}
+
+export function artifactDrawer(artifacts: ArtifactManifest[], activeArtifactId: string | null): DrawerState {
+	return { mode: "artifacts", artifacts, activeArtifactId };
+}
+
+export function graphReaderDrawer(payload: GraphOpenPagePayload, state: PageState = {}): DrawerState {
+	return {
+		mode: "graph-reader",
+		payload,
+		content: state.content ?? "",
+		loading: state.loading ?? false,
+		error: state.error ?? null,
+	};
+}
+
+export function shouldApplyGraphReaderResult(current: DrawerState, payload: GraphOpenPagePayload): boolean {
+	return current.mode === "graph-reader"
+		&& current.payload.path === payload.path
+		&& current.payload.node.id === payload.node.id;
+}
+
+export function graphSelectionDrawer(selection: Selection, title: string, freeText = ""): DrawerState {
+	return {
+		mode: "graph-selection",
+		title,
+		selection,
+		freeText,
+	};
+}
+
+export function graphNodeSummaryDrawer(payload: GraphNodeSummaryPayload): DrawerState {
+	return { mode: "graph-node-summary", payload };
+}
+
+export function graphCommunitySummaryDrawer(payload: GraphCommunitySummaryPayload): DrawerState {
+	return { mode: "graph-community-summary", payload };
+}
+
+export function graphSearchResultsDrawer(payload: GraphSearchResultsPayload): DrawerState {
+	return { mode: "graph-search-results", payload };
+}
+
+export function graphExcludedObjectDrawer(payload: GraphExcludedObjectPayload): DrawerState {
+	return { mode: "graph-excluded-object", payload };
+}
+
+export function graphUnavailableObjectDrawer(payload: GraphUnavailableObjectPayload): DrawerState {
+	return { mode: "graph-unavailable-object", payload };
+}
+
+export function graphGlobalOverviewDrawer(payload: GraphGlobalOverviewPayload): DrawerState {
+	return { mode: "graph-global-overview", payload };
+}
+
+export function graphLoadingDrawer(title: string, message?: string): DrawerState {
+	return { mode: "graph-loading", title, message };
+}
+
+export function graphEmptyDrawer(
+	title: string,
+	reason: Extract<DrawerState, { mode: "graph-empty" }>["reason"],
+	message: string,
+): DrawerState {
+	return { mode: "graph-empty", title, reason, message };
+}
+
+export function graphErrorDrawer(title: string, message: string): DrawerState {
+	return { mode: "graph-error", title, message };
+}

package/skills/llm-wiki-skill/workbench/web/src/lib/graph-reader.ts

@@ -0,0 +1,25 @@
+import { pageReaderActions, type GraphOpenPagePayload, type PageReaderActionId } from "@llm-wiki/graph-engine";
+
+export type GraphReaderActionId = PageReaderActionId;
+
+export interface GraphReaderAction {
+	id: GraphReaderActionId;
+	label: string;
+}
+
+export function graphReaderMetaItems(payload: GraphOpenPagePayload): string[] {
+	const items = [payload.node.typeLabel];
+	if (payload.node.date) items.push(payload.node.date);
+	if (payload.node.source) items.push(payload.node.source);
+	if (payload.node.type === "source" && payload.node.sourcePath) items.push(payload.node.sourcePath);
+	return items;
+}
+
+export function graphReaderActions(): GraphReaderAction[] {
+	return pageReaderActions();
+}
+
+export function graphReaderActionLabels(payload: GraphOpenPagePayload): string[] {
+	void payload;
+	return graphReaderActions().map((action) => action.label);
+}

package/skills/llm-wiki-skill/workbench/web/src/lib/graph-selection-drawer.ts

@@ -0,0 +1,35 @@
+import type { Selection } from "@llm-wiki/graph-engine";
+
+export interface GraphSelectionFactView {
+	label: string;
+	value: number;
+}
+
+export interface GraphSelectionViewModel {
+	hint: string;
+	showFacts: boolean;
+	canExpandNeighbors: boolean;
+	facts: GraphSelectionFactView[];
+	actionLabels: string[];
+}
+
+export function graphSelectionViewModel(selection: Selection): GraphSelectionViewModel {
+	const showFacts = selection.nodeIds.length >= 2;
+	const facts: GraphSelectionFactView[] = showFacts
+		? [
+				{ label: "页", value: selection.facts.pageCount },
+				{ label: "链接", value: selection.facts.internalLinkCount },
+				{ label: "社区", value: selection.facts.communityCount },
+			]
+		: [];
+	if (showFacts && selection.facts.isolatedCount > 0) {
+		facts.push({ label: "孤立", value: selection.facts.isolatedCount });
+	}
+	return {
+		hint: "Shift+点击 增删节点",
+		showFacts,
+		canExpandNeighbors: selection.nodeIds.length === 1,
+		facts,
+		actionLabels: selection.actions?.map((action) => action.label) ?? [],
+	};
+}

package/skills/llm-wiki-skill/workbench/web/src/lib/graph-selection.ts

@@ -0,0 +1,96 @@
+import { wikiPathForGraphNode, type GraphData, type Selection, type SelectionAction } from "@llm-wiki/graph-engine";
+
+export interface SelectionPromptPayload {
+	selection: Selection;
+	action: SelectionAction | null;
+	freeText: string;
+	expandedText: string;
+	displayText: string;
+}
+
+interface SelectionNodeInfo {
+	id: string;
+	label: string;
+	path: string;
+	community: string;
+}
+
+interface SelectionEdgeInfo {
+	from: string;
+	to: string;
+	type: string;
+}
+
+export function buildSelectionPromptPayload(
+	data: GraphData,
+	selection: Selection,
+	action: SelectionAction | null,
+	freeText = "",
+): SelectionPromptPayload {
+	const nodes = selectionNodes(data, selection);
+	const edges = selectionEdges(data, selection);
+	const title = selectionTitle(data, selection);
+	const actionLine = action ? `动作：${action.label}` : "动作：自由提问";
+	const freeLine = freeText.trim() ? `补充要求：${freeText.trim()}` : "";
+	const expandedText = [
+		`@[选区:${title} · ${selection.facts.pageCount}页]`,
+		actionLine,
+		freeLine,
+		"",
+		"选区结构事实：",
+		`- 页数：${selection.facts.pageCount}`,
+		`- 内部链接数：${selection.facts.internalLinkCount}`,
+		`- 社区数：${selection.facts.communityCount}`,
+		`- 孤立数：${selection.facts.isolatedCount}`,
+		"",
+		"页面清单：",
+		...nodes.map((node, index) => `${index + 1}. [[${node.path}]] - ${node.label} - 社区 ${node.community}`),
+		"",
+		"链接关系：",
+		...(edges.length
+			? edges.map((edge) => `- ${edge.from} -> ${edge.to} (${edge.type})`)
+			: ["- 选区内没有直接链接"]),
+		"",
+		"请基于上面的选区信息回答；需要正文细节时，请按页面路径读取。"
+	].filter((line) => line !== undefined).join("\n");
+
+	return {
+		selection,
+		action,
+		freeText,
+		expandedText,
+		displayText: `@[选区:${title} · ${selection.facts.pageCount}页] ${action ? action.label : freeText.trim() || "自由提问"}`
+	};
+}
+
+export function selectionTitle(data: GraphData, selection: Selection): string {
+	if (selection.communityIds.length === 1) {
+		const community = data.learning?.communities?.find((item) => String(item.id) === selection.communityIds[0]);
+		if (community?.label) return community.label;
+	}
+	const firstNode = data.nodes.find((node) => selection.nodeIds.includes(node.id));
+	return firstNode?.label || selection.nodeIds[0] || "图谱";
+}
+
+function selectionNodes(data: GraphData, selection: Selection): SelectionNodeInfo[] {
+	const selected = new Set(selection.nodeIds);
+	return data.nodes
+		.filter((node) => selected.has(node.id))
+		.map((node) => ({
+			id: node.id,
+			label: node.label || node.id,
+			path: wikiPathForGraphNode(node),
+			community: String(node.community || "_none")
+		}));
+}
+
+function selectionEdges(data: GraphData, selection: Selection): SelectionEdgeInfo[] {
+	const selected = new Set(selection.nodeIds);
+	return data.edges
+		.filter((edge) => selected.has(edge.from) && selected.has(edge.to))
+		.map((edge) => ({
+			from: edge.from,
+			to: edge.to,
+			type: String(edge.type || "EXTRACTED")
+		}));
+}

package/skills/llm-wiki-skill/workbench/web/src/lib/graph-summary-actions.ts

@@ -0,0 +1,184 @@
+import {
+	graphNodeTypeLabel,
+	summarizeGraphCommunity,
+	summarizeGraphNode,
+	summarizeExcludedGraphObject,
+	summarizeUnavailableGraphObject,
+	wikiPathForGraphNode,
+	type GraphData,
+	type GraphOpenPagePayload,
+	type GraphSummaryCommand,
+	type GraphSummaryObjectRef,
+	type GraphSummaryOptions,
+	type GraphVisibilityState,
+	type Selection,
+} from "@llm-wiki/graph-engine";
+
+import {
+	graphCommunitySummaryDrawer,
+	graphExcludedObjectDrawer,
+	graphNodeSummaryDrawer,
+	graphSelectionDrawer,
+	graphUnavailableObjectDrawer,
+	type DrawerState,
+} from "./drawer-state";
+import { selectionTitle } from "./graph-selection";
+
+export type GraphSelectionCommand =
+	| { id: string; type: "clear" | "clear-selection" | "neighbors" | "enter-community" }
+	| { id: string; commandId?: string; nodeId: string; type: "enter-community-node" }
+	| { id: string; nodeId: string | null; type: "preview-node" }
+	| { id: string; nodeId: string; mode: "fix" | "unfix"; type: "set-fixed-position" }
+	| { id: string; object: GraphSummaryObjectRef; type: "show-temporary-object" }
+	| { id: string; type: "clear-temporary-object-display" };
+
+export function drawerForGraphSelection(
+	data: GraphData | null,
+	selection: Selection,
+	current: DrawerState,
+	options: GraphSummaryOptions = {},
+): DrawerState {
+	if (data && selection.nodeIds.length === 1) {
+		const summary = summarizeGraphNode(data, selection.nodeIds[0], {
+			...options,
+			selection: { kind: "node", id: selection.nodeIds[0] },
+		});
+		if (summary.kind === "node-summary") return graphNodeSummaryDrawer(summary);
+	}
+
+	if (data && selection.nodeIds.length > 1 && selection.communityIds.length === 1) {
+		const summary = summarizeGraphCommunity(data, selection.communityIds[0], {
+			...options,
+			selection: { kind: "community", id: selection.communityIds[0] },
+			searchResultIds: options.searchResultIds ?? [],
+		});
+		if (summary.kind === "community-summary") return graphCommunitySummaryDrawer(summary);
+	}
+
+	const freeText = current.mode === "graph-selection" ? current.freeText : "";
+	const title = data ? selectionTitle(data, selection) : "选区";
+	return graphSelectionDrawer(selection, title, freeText);
+}
+
+export function graphOpenPagePayloadForCommand(data: GraphData | null, command: GraphSummaryCommand): GraphOpenPagePayload | null {
+	if (command.kind !== "open-detail-read") return null;
+	if (!data) {
+		return fallbackPayloadForOpenDetail(command);
+	}
+	const node = data?.nodes.find((item) => item.id === command.nodeId) ?? null;
+	if (!node) {
+		return fallbackPayloadForOpenDetail(command);
+	}
+	const sourcePath = wikiPathForGraphNode(node);
+	return {
+		path: sourcePath,
+		node: {
+			id: node.id,
+			title: node.label || node.id,
+			type: node.type,
+			typeLabel: graphNodeTypeLabel(node.type),
+			sourcePath,
+			community: node.community ?? null,
+			date: typeof node.date === "string" ? node.date : null,
+			source: typeof node.source === "string" ? node.source : null,
+			isolated: isIsolatedNode(data, node.id),
+		},
+	};
+}
+
+export function graphSelectionCommandForOpenDetail(
+	data: GraphData | null,
+	command: GraphSummaryCommand,
+): Extract<GraphSelectionCommand, { type: "enter-community-node" }> | null {
+	if (command.kind !== "open-detail-read" || !data) return null;
+	const node = data.nodes.find((item) => item.id === command.nodeId);
+	if (!node?.community) return null;
+	return { id: node.community, nodeId: node.id, type: "enter-community-node" };
+}
+
+export function drawerForGraphSummaryNode(
+	data: GraphData | null,
+	nodeId: string,
+	current: DrawerState,
+	options: GraphSummaryOptions = {},
+): DrawerState {
+	if (!data) return current;
+	const summary = summarizeGraphNode(data, nodeId, {
+		...options,
+		selection: { kind: "node", id: nodeId },
+	});
+	if (summary.kind !== "node-summary") return current;
+	return graphNodeSummaryDrawer(summary);
+}
+
+export function drawerForGraphSummaryCommunity(
+	data: GraphData | null,
+	communityId: string,
+	current: DrawerState,
+	options: GraphSummaryOptions = {},
+): DrawerState {
+	if (!data) return current;
+	const summary = summarizeGraphCommunity(data, communityId, {
+		...options,
+		selection: { kind: "community", id: communityId },
+	});
+	if (summary.kind === "community-summary") return graphCommunitySummaryDrawer(summary);
+	return graphUnavailableObjectDrawer(summary);
+}
+
+export function drawerForExcludedGraphObject(
+	data: GraphData | null,
+	object: GraphSummaryObjectRef,
+	reason: "filter" | "aggregation" | "search" | "community-scope",
+	current: DrawerState,
+	options: GraphSummaryOptions = {},
+): DrawerState {
+	if (!data) return current;
+	const summary = summarizeExcludedGraphObject(data, object, reason, options);
+	return graphExcludedObjectDrawer(summary);
+}
+
+export function drawerForUnavailableGraphObject(
+	data: GraphData | null,
+	object: GraphSummaryObjectRef,
+	reason: "missing-node" | "missing-community" | "missing-aggregation",
+	current: DrawerState,
+	options: GraphSummaryOptions = {},
+): DrawerState {
+	if (!data) return current;
+	const summary = summarizeUnavailableGraphObject(data, object, reason, options);
+	return graphUnavailableObjectDrawer(summary);
+}
+
+export function graphObjectVisibilityReason(
+	data: GraphData | null,
+	state: GraphVisibilityState | null,
+	object: GraphSummaryObjectRef,
+): "filter" | "search" | "community-scope" | null {
+	if (!data || !state) return null;
+	const node = object.kind === "node" ? data.nodes.find((item) => item.id === object.nodeId) ?? null : null;
+	if (object.kind === "node" && node && state.typeFilters[node.type] === false) return "filter";
+	if (object.kind === "node" && state.searchQuery && !state.searchResultIds.includes(object.nodeId)) return "search";
+	return null;
+}
+
+function fallbackPayloadForOpenDetail(command: Extract<GraphSummaryCommand, { kind: "open-detail-read" }>): GraphOpenPagePayload {
+	return {
+		path: command.path,
+		node: {
+			id: command.nodeId,
+			title: command.nodeId,
+			type: "entity",
+			typeLabel: "实体",
+			sourcePath: command.path,
+			community: null,
+			date: null,
+			source: null,
+			isolated: true,
+		},
+	};
+}
+
+function isIsolatedNode(data: GraphData, id: string): boolean {
+	return data.edges.every((edge) => edge.from !== id && edge.to !== id);
+}