@joekytc/dsh-swarm 0.1.2 → 0.2.0

package/skills/llm-wiki-skill/workbench/web/test/right-drawer-graph-summary.test.tsx

@@ -0,0 +1,287 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import React from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+
+import { RightDrawer } from "../src/components/RightDrawer";
+import {
+	graphCommunitySummaryDrawer,
+	graphEmptyDrawer,
+	graphErrorDrawer,
+	graphExcludedObjectDrawer,
+	graphLoadingDrawer,
+	graphNodeSummaryDrawer,
+	graphReaderDrawer,
+	graphUnavailableObjectDrawer,
+	type DrawerState,
+} from "../src/lib/drawer-state";
+import type {
+	GraphCommunitySummaryPayload,
+	GraphExcludedObjectPayload,
+	GraphNodeSummaryPayload,
+	GraphUnavailableObjectPayload,
+} from "@llm-wiki/graph-engine";
+
+describe("RightDrawer graph lightweight summaries", () => {
+	it("renders node summary fields and actions without full reader markdown", () => {
+		const html = renderDrawer(graphNodeSummaryDrawer(nodeSummaryFixture()));
+
+		assert.match(html, /data-testid="graph-node-summary"/);
+		assert.match(html, /Alpha node/);
+		assert.match(html, /节点/);
+		assert.match(html, /连接/);
+		assert.match(html, /graph-summary-community-chip/);
+		assert.match(html, /graph-summary-relation-pill/);
+		assert.match(html, /打开详情/);
+		assert.match(html, /固定位置/);
+		assert.doesNotMatch(html, /full markdown body should stay out of summaries/);
+		assert.doesNotMatch(html, /graph-reader-drawer/);
+		assert.doesNotMatch(html, /summary-left-rail|ai-slop|border-left/);
+	});
+
+	it("renders community summary with different fields and actions", () => {
+		const html = renderDrawer(graphCommunitySummaryDrawer(communitySummaryFixture()));
+
+		assert.match(html, /data-testid="graph-community-summary"/);
+		assert.match(html, /Alpha community/);
+		assert.match(html, /社区/);
+		assert.match(html, /graph-summary-community-chip/);
+		assert.match(html, /核心节点/);
+		assert.match(html, /查看全部/);
+		assert.match(html, /alpha-node/);
+		assert.match(html, /搜索命中/);
+		assert.match(html, /beta-node/);
+		assert.match(html, /固定节点/);
+		assert.match(html, /gamma-node/);
+		assert.match(html, /进入社区/);
+		assert.doesNotMatch(html, /打开详情/);
+		assert.doesNotMatch(html, /graph-reader-drawer/);
+	});
+
+	it("renders graph empty, excluded, and unavailable states", () => {
+		const empty = renderDrawer(graphEmptyDrawer("没有搜索结果", "no-search-results", "暂无搜索结果"));
+		const missingNeighbors = renderDrawer(graphEmptyDrawer("没有邻居", "missing-neighbors", "暂无邻居"));
+		const missingCommunity = renderDrawer(graphEmptyDrawer("没有社区摘要", "missing-community-summary", "暂无社区摘要"));
+		const missingStrongRelations = renderDrawer(graphEmptyDrawer("没有强关系", "missing-strong-relations", "暂无强关系"));
+		const excluded = renderDrawer(graphExcludedObjectDrawer(excludedFixture()));
+		const unavailable = renderDrawer(graphUnavailableObjectDrawer(unavailableFixture()));
+
+		assert.match(empty, /没有搜索结果/);
+		assert.match(empty, /暂无搜索结果/);
+		assert.match(missingNeighbors, /暂无邻居/);
+		assert.match(missingCommunity, /暂无社区摘要/);
+		assert.match(missingStrongRelations, /暂无强关系/);
+		assert.match(excluded, /data-testid="graph-excluded-object"/);
+		assert.match(excluded, /暂不可见/);
+		assert.match(excluded, /当前筛选暂时隐藏了这个对象/);
+		assert.match(excluded, /显示这个对象/);
+		assert.match(excluded, /清除临时显示/);
+		assert.match(unavailable, /data-testid="graph-unavailable-object"/);
+		assert.match(unavailable, /missing-node/);
+		assert.match(unavailable, /这个节点当前不可用/);
+	});
+
+	it("renders loading, reader loading, reader error, and hard error states honestly", () => {
+		const loading = renderDrawer(graphLoadingDrawer("整理图谱摘要", "正在整理当前对象"));
+		const readerLoading = renderDrawer(graphReaderDrawer(graphPayload(), { loading: true }));
+		const readerError = renderDrawer(graphReaderDrawer(graphPayload(), { error: "读取失败" }));
+		const hardError = renderDrawer(graphErrorDrawer("图谱错误", "图谱服务暂时不可用"));
+
+		assert.match(loading, /data-testid="graph-simple-state"/);
+		assert.match(loading, /整理图谱摘要/);
+		assert.match(loading, /正在整理当前对象/);
+		assert.match(readerLoading, /graph-reader-drawer/);
+		assert.match(readerLoading, /加载中/);
+		assert.doesNotMatch(readerLoading, /完整正文内容/);
+		assert.match(readerError, /读取失败/);
+		assert.doesNotMatch(readerError, /完整正文内容/);
+		assert.match(hardError, /图谱错误/);
+		assert.match(hardError, /图谱服务暂时不可用/);
+		assert.doesNotMatch(`${loading}${readerLoading}${readerError}${hardError}`, /推荐阅读|猜你喜欢|建议你打开/);
+	});
+
+	it("keeps drawer actions as tabbable buttons", () => {
+		const node = renderDrawer(graphNodeSummaryDrawer(nodeSummaryFixture()));
+		const community = renderDrawer(graphCommunitySummaryDrawer(communitySummaryFixture()));
+		const excluded = renderDrawer(graphExcludedObjectDrawer(excludedFixture()));
+
+		assert.match(node, /<button[^>]*class="graph-summary-action"[^>]*>打开详情<\/button>/);
+		assert.match(node, /<button[^>]*class="graph-summary-action"[^>]*>固定位置<\/button>/);
+		assert.match(community, /<button[^>]*class="graph-summary-inline-action"[^>]*>查看全部<\/button>/);
+		assert.match(community, /<button[^>]*class="graph-summary-action"[^>]*>进入社区<\/button>/);
+		assert.match(excluded, /<button[^>]*class="graph-summary-action"[^>]*>显示这个对象<\/button>/);
+		assert.doesNotMatch(`${node}${community}${excluded}`, /tabindex="-1"/i);
+	});
+
+	it("keeps the Paper summary styling contract", () => {
+		const css = readFileSync(resolve(import.meta.dirname, "../src/index.css"), "utf8");
+
+		assert.match(css, /\.graph-summary-drawer[\s\S]*border-radius:\s*16px/);
+		assert.match(css, /\.graph-summary-drawer[\s\S]*var\(--paper-grain\)/);
+		assert.match(css, /\.graph-summary-drawer[\s\S]*box-shadow:\s*var\(--shadow-lg\)/);
+		assert.match(css, /\.graph-summary-community-chip::before[\s\S]*width:\s*7px/);
+		assert.match(css, /\.graph-summary-relation-pill[\s\S]*border-radius:\s*999px/);
+		assert.match(css, /\.graph-summary-action[\s\S]*box-shadow:\s*var\(--shadow\)/);
+		assert.doesNotMatch(css, /--app-shadow-color/);
+		assert.doesNotMatch(css, /summary-left-rail|ai-slop/);
+	});
+});
+
+function renderDrawer(drawer: DrawerState): string {
+	return renderToStaticMarkup(
+		React.createElement(RightDrawer, {
+			drawer,
+			fullscreen: false,
+			width: 420,
+			defaultWidth: 420,
+			onSelectArtifact: noopString,
+			onOpenPage: noopString,
+			onWikiLinkSeen: noopString,
+			onGraphReaderAction: noopString,
+			onGraphSummaryCommand: noopCommand,
+			onGraphSummaryNodePreview: noopPreviewNode,
+			onGraphSelectionTextChange: noopString,
+			onGraphSelectionNeighbors: noop,
+			onGraphSelectionAsk: noopSelectionAsk,
+			onResize: noopNumber,
+			onToggleFullscreen: noop,
+			onClose: noopClose,
+		}),
+	);
+}
+
+function nodeSummaryFixture(): GraphNodeSummaryPayload {
+	return {
+		kind: "node-summary",
+		object: { kind: "node", nodeId: "alpha-node" },
+		nodeId: "alpha-node",
+		label: "Alpha node",
+		type: "topic",
+		communityId: "alpha",
+		sourcePath: "wiki/alpha.md",
+		summary: "short excerpt only",
+		connectionCount: 3,
+		searchHit: true,
+		pinHint: { nodeId: "alpha-node", wikiPath: "wiki/alpha.md", pinned: false, position: null },
+		selection: {
+			input: { kind: "node", id: "alpha-node" },
+			selectionId: "node:alpha-node",
+			selectedNodeIds: ["alpha-node"],
+			selectedCommunityIds: ["alpha"],
+			containsCurrentObject: true,
+		},
+		strongestRelations: [
+			{
+				edgeId: "alpha-beta",
+				fromNodeId: "alpha-node",
+				toNodeId: "beta-node",
+				relationType: "依赖",
+				confidence: "EXTRACTED",
+				weight: 1,
+				bridge: false,
+			},
+		],
+		bridgeRelations: [],
+		aggregationMarkers: [],
+		commands: [
+			{ kind: "open-detail-read", nodeId: "alpha-node", path: "wiki/alpha.md", label: "打开详情" },
+			{ kind: "set-fixed-position", mode: "fix", nodeId: "alpha-node", wikiPath: "wiki/alpha.md", label: "固定位置" },
+		],
+	};
+}
+
+function graphPayload() {
+	return {
+		path: "wiki/alpha.md",
+		node: {
+			id: "alpha-node",
+			title: "Alpha node",
+			type: "topic",
+			typeLabel: "主题",
+			sourcePath: "wiki/alpha.md",
+			community: "alpha",
+			date: "2026-06-18",
+			source: "fixture",
+			isolated: false,
+		},
+	};
+}
+
+function communitySummaryFixture(): GraphCommunitySummaryPayload {
+	return {
+		kind: "community-summary",
+		object: { kind: "community", communityId: "alpha" },
+		communityId: "alpha",
+		label: "Alpha community",
+		nodeCount: 12,
+		coreNodeIds: ["alpha-node", "beta-node", "gamma-node", "delta-node"],
+		searchResultIds: ["beta-node"],
+		pinHints: [
+			{ nodeId: "gamma-node", wikiPath: "wiki/gamma.md", pinned: true, position: { x: 12, y: 18, coordinateSpace: "world" } },
+		],
+		selection: {
+			input: { kind: "community", id: "alpha" },
+			selectionId: "community:alpha",
+			selectedNodeIds: ["alpha-node", "beta-node"],
+			selectedCommunityIds: ["alpha"],
+			containsCurrentObject: true,
+		},
+		strongestRelations: [],
+		bridgeRelations: [],
+		aggregationMarkers: [],
+		commands: [
+			{ kind: "enter-community", communityId: "alpha", label: "进入社区" },
+		],
+	};
+}
+
+function unavailableFixture(): GraphUnavailableObjectPayload {
+	return {
+		kind: "unavailable-object",
+		object: { kind: "node", nodeId: "missing-node" },
+		reason: "missing-node",
+		selection: {
+			input: null,
+			selectionId: null,
+			selectedNodeIds: [],
+			selectedCommunityIds: [],
+			containsCurrentObject: false,
+		},
+		searchResultIds: [],
+		pinHints: [],
+		aggregationMarkers: [],
+		commands: [],
+	};
+}
+
+function excludedFixture(): GraphExcludedObjectPayload {
+	return {
+		kind: "excluded-object",
+		object: { kind: "node", nodeId: "filtered-node" },
+		reason: "filter",
+		selection: {
+			input: { kind: "node", id: "filtered-node" },
+			selectionId: "node:filtered-node",
+			selectedNodeIds: ["filtered-node"],
+			selectedCommunityIds: ["alpha"],
+			containsCurrentObject: true,
+		},
+		searchResultIds: [],
+		pinHints: [],
+		aggregationMarkers: [],
+		commands: [
+			{ kind: "show-this-object", object: { kind: "node", nodeId: "filtered-node" }, label: "显示这个对象" },
+			{ kind: "clear-temporary-object-display", label: "清除临时显示" },
+		],
+	};
+}
+
+function noop() {}
+function noopString() {}
+function noopNumber() {}
+function noopCommand() {}
+function noopPreviewNode() {}
+function noopSelectionAsk() {}
+function noopClose() {}

package/skills/llm-wiki-skill/workbench/web/test/right-drawer-interactions.test.tsx

@@ -0,0 +1,182 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import React from "react";
+import { fireEvent } from "@testing-library/react";
+
+import { RightDrawer } from "../src/components/RightDrawer";
+import { SearchPanel } from "../src/components/SearchPanel";
+import { artifactDrawer, wikiDrawer, type DrawerState } from "../src/lib/drawer-state";
+import type { ArtifactManifest } from "../src/lib/api";
+import { click, pressKey, render, screen } from "./render";
+
+describe("RightDrawer interactions", () => {
+	it("marks the drawer as open for shell layout", () => {
+		renderDrawer(wikiDrawer("wiki/paper.md", { content: "Paper body" }));
+
+		const drawer = document.querySelector(".drawer-panel-open");
+		assert.ok(drawer);
+		assert.equal(drawer?.getAttribute("data-drawer-open"), "true");
+	});
+
+	it("resizes by dragging, keyboard shortcuts, and double click reset", async () => {
+		const resizeCalls: number[] = [];
+		renderDrawer(wikiDrawer("wiki/paper.md", { content: "Paper body" }), {
+			width: 420,
+			defaultWidth: 480,
+			onResize: (width) => resizeCalls.push(width),
+		});
+
+		const handle = screen.getByRole("separator", { name: "调整预览区宽度" });
+		stubPointerCapture(handle);
+
+		fireEvent.pointerDown(handle, { clientX: 900, pointerId: 1 });
+		assert.equal(document.body.classList.contains("drawer-resizing"), true);
+		fireEvent.pointerMove(handle, { clientX: 852, pointerId: 1 });
+		fireEvent.pointerUp(handle, { pointerId: 1 });
+		assert.equal(document.body.classList.contains("drawer-resizing"), false);
+
+		await pressKey(handle, "ArrowLeft");
+		await pressKey(handle, "ArrowRight");
+		await pressKey(handle, "Home");
+		fireEvent.doubleClick(handle);
+
+		assert.deepEqual(resizeCalls, [468, 444, 396, 480, 480]);
+	});
+
+	it("hides the resize handle while fullscreen and keeps the fullscreen toggle wired", async () => {
+		const fullscreenCalls: string[] = [];
+		const { rerender } = renderDrawer(wikiDrawer("wiki/paper.md", { content: "Paper body" }), {
+			fullscreen: false,
+			onToggleFullscreen: () => fullscreenCalls.push("toggle"),
+		});
+
+		assert.ok(screen.getByRole("separator", { name: "调整预览区宽度" }));
+		await click(screen.getByRole("button", { name: "全屏" }));
+		assert.deepEqual(fullscreenCalls, ["toggle"]);
+
+		rerender(drawerElement(wikiDrawer("wiki/paper.md", { content: "Paper body" }), {
+			fullscreen: true,
+			onToggleFullscreen: () => fullscreenCalls.push("toggle"),
+		}));
+
+		assert.equal(document.querySelector(".drawer-panel-fullscreen") !== null, true);
+		assert.equal(screen.queryByRole("separator", { name: "调整预览区宽度" }), null);
+		await click(screen.getByRole("button", { name: "退出全屏" }));
+		assert.deepEqual(fullscreenCalls, ["toggle", "toggle"]);
+	});
+
+	it("closes from the header button and Escape key", async () => {
+		const closeReasons: string[] = [];
+		renderDrawer(wikiDrawer("wiki/paper.md", { content: "Paper body" }), {
+			onClose: (reason) => closeReasons.push(reason),
+		});
+
+		await click(screen.getByRole("button", { name: "关闭" }));
+		await pressKey(document, "Escape");
+
+		assert.deepEqual(closeReasons, ["button", "escape"]);
+	});
+
+	it("does not close the drawer when Escape closes search above it", async () => {
+		const closeReasons: string[] = [];
+		const searchCloses: string[] = [];
+		render(
+			<React.Fragment>
+				{drawerElement(wikiDrawer("wiki/paper.md", { content: "Paper body" }), {
+					onClose: (reason) => closeReasons.push(reason),
+				})}
+				<SearchPanel
+					open
+					refs={[{ path: "wiki/paper.md", name: "paper", title: "Paper", category: "entities" }]}
+					knowledgeBaseName="AI学习知识库"
+					onOpenPage={noopString}
+					onClose={() => searchCloses.push("search")}
+				/>
+			</React.Fragment>,
+		);
+
+		await pressKey(screen.getByLabelText("搜索当前库页面"), "Escape");
+
+		assert.deepEqual(searchCloses, ["search"]);
+		assert.deepEqual(closeReasons, []);
+	});
+
+	it("switches artifact tabs without losing the active tab class", async () => {
+		const selectedIds: string[] = [];
+		renderDrawer(artifactDrawer([artifact("art-html", "Paper HTML", "html"), artifact("art-pdf", "Paper PDF", "pdf")], "art-html"), {
+			onSelectArtifact: (id) => selectedIds.push(id),
+		});
+
+		const first = screen.getByRole("button", { name: /Paper HTML/ });
+		const second = screen.getByRole("button", { name: /Paper PDF/ });
+		assert.equal(first.classList.contains("drawer-tab-active"), true);
+		assert.equal(second.classList.contains("drawer-tab-active"), false);
+
+		await click(second);
+
+		assert.deepEqual(selectedIds, ["art-pdf"]);
+	});
+});
+
+function renderDrawer(drawer: DrawerState, props: Partial<RightDrawerProps> = {}) {
+	return render(drawerElement(drawer, props));
+}
+
+function drawerElement(drawer: DrawerState, props: Partial<RightDrawerProps> = {}) {
+	return (
+		<RightDrawer
+			drawer={drawer}
+			fullscreen={props.fullscreen ?? false}
+			width={props.width ?? 420}
+			defaultWidth={props.defaultWidth ?? 420}
+			onSelectArtifact={props.onSelectArtifact ?? noopString}
+			onOpenPage={noopString}
+			onWikiLinkSeen={noopString}
+			onGraphReaderAction={noopString}
+			onGraphSummaryCommand={() => {}}
+			onGraphSummaryNodePreview={noopPreviewNode}
+			onGraphSelectionTextChange={noopString}
+			onGraphSelectionNeighbors={noop}
+			onGraphSelectionAsk={noopSelectionAsk}
+			onResize={props.onResize ?? noopNumber}
+			onToggleFullscreen={props.onToggleFullscreen ?? noop}
+			onClose={props.onClose ?? noopClose}
+		/>
+	);
+}
+
+type RightDrawerProps = React.ComponentProps<typeof RightDrawer>;
+
+function stubPointerCapture(element: Element) {
+	Object.defineProperties(element, {
+		setPointerCapture: { configurable: true, value: () => {} },
+		hasPointerCapture: { configurable: true, value: () => true },
+		releasePointerCapture: { configurable: true, value: () => {} },
+	});
+}
+
+function artifact(id: string, title: string, kind: ArtifactManifest["kind"]): ArtifactManifest {
+	const extension = kind === "html" ? "html" : kind;
+	return {
+		id,
+		kind,
+		renderer: kind === "html" ? "iframe" : "download-only",
+		metadata: {
+			title,
+			createdAt: "2026-06-20T00:00:00.000Z",
+			sourceConversationId: "conversation-1",
+			sourceKbPath: "/kb",
+			sourceSkill: "paper",
+			sizeBytes: 128,
+		},
+		files: [{ name: `artifact.${extension}`, sizeBytes: 128, mimeType: "text/plain" }],
+		primaryFile: `artifact.${extension}`,
+	};
+}
+
+function noop() {}
+function noopString() {}
+function noopNumber() {}
+function noopClose() {}
+function noopPreviewNode() {}
+function noopSelectionAsk() {}

package/skills/llm-wiki-skill/workbench/web/test/search-filter.test.ts

@@ -0,0 +1,65 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+
+import type { PageRef } from "../src/lib/api";
+import { filterPageRefs } from "../src/lib/search-filter";
+
+describe("search filter", () => {
+	it("returns a bounded default slice for empty queries", () => {
+		const refs = makeRefs(1000);
+		const results = filterPageRefs(refs, "", 20);
+
+		assert.equal(results.length, 20);
+		assert.equal(results[0]?.ref.path, "wiki/page-0.md");
+		assert.equal(results.at(-1)?.ref.path, "wiki/page-19.md");
+	});
+
+	it("searches 1k refs by title, path, and CJK content", () => {
+		const refs = makeRefs(1000);
+		refs.push(ref("wiki/研究/注意力机制.md", "注意力机制", "AI 注意力机制"));
+		refs.push(ref("wiki/paper-ui-port.md", "paper-ui-port", "Paper UI 移植"));
+
+		assert.equal(filterPageRefs(refs, "注意力")[0]?.ref.path, "wiki/研究/注意力机制.md");
+		assert.equal(filterPageRefs(refs, "paper-ui")[0]?.ref.path, "wiki/paper-ui-port.md");
+		assert.equal(filterPageRefs(refs, "page-900")[0]?.ref.path, "wiki/page-900.md");
+	});
+
+	it("keeps strong title and prefix matches above unrelated fuzzy-looking refs", () => {
+		const refs = [
+			ref("wiki/other/papr.md", "papr", "Archived note"),
+			ref("wiki/paper-ui.md", "paper-ui", "Paper UI"),
+			ref("wiki/a-deep-paper-ui-analysis.md", "deep-paper-ui-analysis", "Deep note"),
+		];
+
+		const results = filterPageRefs(refs, "paper", 3);
+
+		assert.deepEqual(results.map((item) => item.ref.path), [
+			"wiki/paper-ui.md",
+			"wiki/a-deep-paper-ui-analysis.md",
+		]);
+	});
+
+	it("handles 5k refs without dropping late exact matches", () => {
+		const refs = makeRefs(5000);
+		refs.push(ref("wiki/final/local-search.md", "local-search", "Current Library Search"));
+
+		const results = filterPageRefs(refs, "current library search", 10);
+
+		assert.equal(results[0]?.ref.path, "wiki/final/local-search.md");
+		assert.ok(results.length <= 10);
+	});
+
+	it("returns an empty list when there are no matches", () => {
+		assert.deepEqual(filterPageRefs(makeRefs(100), "zzzz-no-hit"), []);
+	});
+});
+
+function makeRefs(count: number): PageRef[] {
+	return Array.from({ length: count }, (_, index) =>
+		ref(`wiki/page-${index}.md`, `page-${index}`, `Page ${index}`),
+	);
+}
+
+function ref(path: string, name: string, title: string): PageRef {
+	return { path, name, title, category: path.startsWith("wiki/") ? "wiki" : "raw" };
+}

package/skills/llm-wiki-skill/workbench/web/test/search-panel.test.tsx

@@ -0,0 +1,155 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import React from "react";
+
+import { SearchPanel } from "../src/components/SearchPanel";
+import type { PageRef } from "../src/lib/api";
+import { changeText, click, pressKey, render, screen } from "./render";
+
+describe("SearchPanel", () => {
+	it("filters current library refs and opens the selected result with keyboard", async () => {
+		const opened: string[] = [];
+		const closed: string[] = [];
+		render(
+			<SearchPanel
+				open
+				refs={[
+					ref("wiki/alpha.md", "alpha", "Alpha Notes"),
+					ref("wiki/paper-ui.md", "paper-ui", "Paper UI 移植"),
+					ref("raw/source.md", "source", "Source Material"),
+				]}
+				knowledgeBaseName="AI学习知识库"
+				onOpenPage={(path) => opened.push(path)}
+				onClose={() => closed.push("closed")}
+			/>,
+		);
+
+		await changeText(screen.getByLabelText("搜索当前库页面"), "paper");
+		assert.equal(searchResultPaths(), "wiki/paper-ui.md");
+
+		await pressKey(screen.getByLabelText("搜索当前库页面"), "Enter");
+
+		assert.deepEqual(opened, ["wiki/paper-ui.md"]);
+		assert.deepEqual(closed, ["closed"]);
+	});
+
+	it("supports arrow selection, click open, and insert reference actions", async () => {
+		const opened: string[] = [];
+		const inserted: string[] = [];
+		const closed: string[] = [];
+		const first = render(
+			<SearchPanel
+				open
+				refs={[
+					ref("wiki/alpha.md", "alpha", "Alpha Notes"),
+					ref("wiki/beta.md", "beta", "Beta Notes"),
+				]}
+				knowledgeBaseName="AI学习知识库"
+				onOpenPage={(path) => opened.push(path)}
+				onInsertRef={(path) => inserted.push(path)}
+				onClose={() => closed.push("closed")}
+			/>,
+		);
+
+		await pressKey(screen.getByLabelText("搜索当前库页面"), "ArrowDown");
+		await pressKey(screen.getByLabelText("搜索当前库页面"), "Enter");
+		assert.deepEqual(opened, ["wiki/beta.md"]);
+		assert.deepEqual(closed, ["closed"]);
+		first.unmount();
+
+		const second = render(
+			<SearchPanel
+				open
+				refs={[
+					ref("wiki/alpha.md", "alpha", "Alpha Notes"),
+					ref("wiki/beta.md", "beta", "Beta Notes"),
+				]}
+				knowledgeBaseName="AI学习知识库"
+				onOpenPage={(path) => opened.push(path)}
+				onInsertRef={(path) => inserted.push(path)}
+				onClose={() => closed.push("closed")}
+			/>,
+		);
+
+		await click(screen.getByRole("button", { name: /Alpha Notes/ }));
+		assert.deepEqual(opened, ["wiki/beta.md", "wiki/alpha.md"]);
+		second.unmount();
+
+		render(
+			<SearchPanel
+				open
+				refs={[
+					ref("wiki/alpha.md", "alpha", "Alpha Notes"),
+					ref("wiki/beta.md", "beta", "Beta Notes"),
+				]}
+				knowledgeBaseName="AI学习知识库"
+				onOpenPage={(path) => opened.push(path)}
+				onInsertRef={(path) => inserted.push(path)}
+				onClose={() => closed.push("closed")}
+			/>,
+		);
+
+		await click(screen.getAllByRole("button", { name: "插入" })[1]!);
+		assert.deepEqual(inserted, ["wiki/beta.md"]);
+	});
+
+	it("renders loading, error, no library, and empty-result states", async () => {
+		const loading = render(
+			<SearchPanel
+				open
+				refs={[]}
+				loading
+				knowledgeBaseName="AI学习知识库"
+				onOpenPage={noop}
+				onClose={noop}
+			/>,
+		);
+		assert.equal(searchState(), "正在加载当前库页面...");
+		loading.unmount();
+
+		const error = render(
+			<SearchPanel
+				open
+				refs={[]}
+				error="接口失败"
+				knowledgeBaseName="AI学习知识库"
+				onOpenPage={noop}
+				onClose={noop}
+			/>,
+		);
+		assert.equal(searchState(), "接口失败");
+		error.unmount();
+
+		const noLibrary = render(<SearchPanel open refs={[]} onOpenPage={noop} onClose={noop} />);
+		assert.equal(searchState(), "请先选择知识库");
+		noLibrary.unmount();
+
+		render(
+			<SearchPanel
+				open
+				refs={[ref("wiki/alpha.md", "alpha", "Alpha Notes")]}
+				knowledgeBaseName="AI学习知识库"
+				onOpenPage={noop}
+				onClose={noop}
+			/>,
+		);
+		await changeText(screen.getByLabelText("搜索当前库页面"), "zzzz-no-hit");
+		assert.equal(searchState(), "没有匹配结果");
+	});
+});
+
+function searchResultPaths(): string {
+	return Array.from(document.querySelectorAll(".search-result-path"))
+		.map((node) => node.textContent ?? "")
+		.join("|");
+}
+
+function searchState(): string {
+	return document.querySelector(".search-state")?.textContent ?? "";
+}
+
+function ref(path: string, name: string, title: string): PageRef {
+	return { path, name, title, category: path.startsWith("wiki/") ? "wiki" : "raw" };
+}
+
+function noop() {}