dsh-codegraph-visualizer 0.3.0 → 0.3.1

package/dist/client/index.esm.js

@@ -2049,7 +2049,7 @@ function resetLoggerListeners() {
 
 //#endregion
 //#region src/client/cache/IndexedDBCache.ts
-const log$45 = scoped("indexeddb-cache");
+const log$46 = scoped("indexeddb-cache");
 const DB_PREFIX = "codegraph-cache-";
 const CLUSTER_STORE = "cluster-cache";
 const DIAGRAM_STORE = "diagram-cache";
@@ -2100,7 +2100,7 @@ var IndexedDBCache = class {
 	}
 	getDB() {
 		if (!this.dbPromise) this.dbPromise = openDB(this.repoId).catch((err) => {
-			log$45.warn("failed to open IndexedDB", {
+			log$46.warn("failed to open IndexedDB", {
 				repoId: this.repoId,
 				error: err
 			});
@@ -2131,7 +2131,7 @@ var IndexedDBCache = class {
 				tx.onerror = () => reject(tx.error);
 			});
 		} catch (e) {
-			log$45.warn("IndexedDB invalidateCluster failed", { error: e });
+			log$46.warn("IndexedDB invalidateCluster failed", { error: e });
 		}
 	}
 	async invalidateDiagram(viewMode) {
@@ -2158,7 +2158,7 @@ var IndexedDBCache = class {
 				tx.onerror = () => reject(tx.error);
 			});
 		} catch (e) {
-			log$45.warn("IndexedDB invalidateDiagram failed", {
+			log$46.warn("IndexedDB invalidateDiagram failed", {
 				viewMode,
 				error: e
 			});
@@ -2185,7 +2185,7 @@ var IndexedDBCache = class {
 	async setMany(storeName, entries) {
 		if (entries.length === 0) return;
 		if (entries.length > INDEXED_DB.BATCH.MAX_ENTRIES) {
-			log$45.warn("setMany batch exceeds limit, splitting", {
+			log$46.warn("setMany batch exceeds limit, splitting", {
 				count: entries.length,
 				limit: INDEXED_DB.BATCH.MAX_ENTRIES
 			});
@@ -2211,7 +2211,7 @@ var IndexedDBCache = class {
 				tx.onerror = () => reject(tx.error);
 			});
 		} catch (e) {
-			log$45.warn(`IndexedDB setMany(${storeName}) failed`, {
+			log$46.warn(`IndexedDB setMany(${storeName}) failed`, {
 				count: entries.length,
 				error: e
 			});
@@ -2227,7 +2227,7 @@ var IndexedDBCache = class {
 				usageRatio: quota > 0 ? usage / quota : 0
 			};
 		} catch (e) {
-			log$45.warn("storage.estimate() failed", { error: e });
+			log$46.warn("storage.estimate() failed", { error: e });
 			return null;
 		}
 	}
@@ -2239,7 +2239,7 @@ var IndexedDBCache = class {
 	async purgeExpired() {
 		let totalPurged = 0;
 		for (const storeName of ALL_STORES) totalPurged += await this.purgeExpiredStore(storeName);
-		if (totalPurged > 0) log$45.info("purged expired entries", { count: totalPurged });
+		if (totalPurged > 0) log$46.info("purged expired entries", { count: totalPurged });
 		return totalPurged;
 	}
 	async purgeExpiredStore(storeName) {
@@ -2271,7 +2271,7 @@ var IndexedDBCache = class {
 			});
 			return expiredKeys.length;
 		} catch (e) {
-			log$45.warn(`purgeExpiredStore(${storeName}) failed`, { error: e });
+			log$46.warn(`purgeExpiredStore(${storeName}) failed`, { error: e });
 			return 0;
 		}
 	}
@@ -2294,7 +2294,7 @@ var IndexedDBCache = class {
 			}
 			return raw;
 		} catch (e) {
-			log$45.warn(`IndexedDB getFromStore(${storeName}) failed`, {
+			log$46.warn(`IndexedDB getFromStore(${storeName}) failed`, {
 				key,
 				error: e
 			});
@@ -2317,7 +2317,7 @@ var IndexedDBCache = class {
 				tx.onerror = () => reject(tx.error);
 			});
 		} catch (e) {
-			log$45.warn(`IndexedDB setToStore(${storeName}) failed`, {
+			log$46.warn(`IndexedDB setToStore(${storeName}) failed`, {
 				key,
 				error: e
 			});
@@ -2333,7 +2333,7 @@ var IndexedDBCache = class {
 				tx.onerror = () => reject(tx.error);
 			});
 		} catch (e) {
-			log$45.warn(`IndexedDB deleteFromStore(${storeName}) failed`, {
+			log$46.warn(`IndexedDB deleteFromStore(${storeName}) failed`, {
 				key,
 				error: e
 			});
@@ -2349,7 +2349,7 @@ var IndexedDBCache = class {
 
 //#endregion
 //#region src/client/cache/DiagramCache.ts
-const log$44 = scoped("cache");
+const log$45 = scoped("cache");
 function computeDataHash(nodes, edges) {
 	let nodeHash = 2166136261;
 	for (const n of nodes) {
@@ -2441,7 +2441,7 @@ var DiagramCache = class {
 				return diagram;
 			}
 		} catch (e) {
-			log$44.warn("IndexedDB diagram getAsync failed", e);
+			log$45.warn("IndexedDB diagram getAsync failed", e);
 		}
 		return null;
 	}
@@ -2453,13 +2453,13 @@ var DiagramCache = class {
 			if (firstKey) this.cache.delete(firstKey);
 		}
 		this.cache.set(key, diagram);
-		if (this.idbCache) this.idbCache.setDiagram(key, diagram).catch((e) => log$44.warn("IndexedDB diagram set failed", e));
+		if (this.idbCache) this.idbCache.setDiagram(key, diagram).catch((e) => log$45.warn("IndexedDB diagram set failed", e));
 	}
 	invalidate(viewMode) {
 		if (viewMode) {
 			for (const key of this.cache.keys()) if (key.startsWith(`${viewMode}:`)) this.cache.delete(key);
 		} else this.cache.clear();
-		if (this.idbCache) this.idbCache.invalidateDiagram(viewMode).catch((e) => log$44.warn("IndexedDB diagram invalidate failed", e));
+		if (this.idbCache) this.idbCache.invalidateDiagram(viewMode).catch((e) => log$45.warn("IndexedDB diagram invalidate failed", e));
 	}
 	size() {
 		return this.cache.size;
@@ -2504,7 +2504,7 @@ var ClusterCache = class {
 				return result;
 			}
 		} catch (e) {
-			log$44.warn("IndexedDB cluster getAsync failed", e);
+			log$45.warn("IndexedDB cluster getAsync failed", e);
 		}
 		return null;
 	}
@@ -2516,11 +2516,11 @@ var ClusterCache = class {
 			if (firstKey) this.cache.delete(firstKey);
 		}
 		this.cache.set(key, result);
-		if (this.idbCache) this.idbCache.setCluster(key, result).catch((e) => log$44.warn("IndexedDB cluster set failed", e));
+		if (this.idbCache) this.idbCache.setCluster(key, result).catch((e) => log$45.warn("IndexedDB cluster set failed", e));
 	}
 	invalidate() {
 		this.cache.clear();
-		if (this.idbCache) this.idbCache.invalidateCluster().catch((e) => log$44.warn("IndexedDB cluster invalidate failed", e));
+		if (this.idbCache) this.idbCache.invalidateCluster().catch((e) => log$45.warn("IndexedDB cluster invalidate failed", e));
 	}
 	size() {
 		return this.cache.size;
@@ -4174,6 +4174,25 @@ function buildStylesheet(theme, nodeCount = 0) {
 				"border-color": successColor
 			}
 		},
+		{
+			selector: "node.multi-selected",
+			style: {
+				"border-width": 3,
+				"border-color": accentColor,
+				"background-color": accentColor,
+				"background-opacity": .35,
+				"z-index": 26
+			}
+		},
+		{
+			selector: "node.canvas-focused",
+			style: {
+				"border-width": 2,
+				"border-color": accentColor,
+				"border-style": "dashed",
+				"z-index": 24
+			}
+		},
 		{
 			selector: ".call-chain",
 			style: {
@@ -5502,7 +5521,7 @@ var CallChainAggregator = class {
 
 //#endregion
 //#region src/shared/PerformanceMonitor.ts
-const log$43 = scoped("perf");
+const log$44 = scoped("perf");
 const MAX_HISTORY = 100;
 const measurements = [];
 const thresholds = new Map();
@@ -5604,8 +5623,8 @@ function recordMeasurement(name$1, durationMs) {
 	if (measurements.length > MAX_HISTORY) measurements.shift();
 	const threshold = thresholds.get(name$1);
 	if (threshold) {
-		if (threshold.degradeMs !== void 0 && durationMs >= threshold.degradeMs && threshold.degradationKey) log$43.warn(`${name$1} exceeded degrade threshold: ${durationMs.toFixed(1)}ms >= ${threshold.degradeMs}ms`);
-		else if (threshold.warnMs !== void 0 && durationMs >= threshold.warnMs) log$43.info(`${name$1} exceeded warn threshold: ${durationMs.toFixed(1)}ms >= ${threshold.warnMs}ms`);
+		if (threshold.degradeMs !== void 0 && durationMs >= threshold.degradeMs && threshold.degradationKey) log$44.warn(`${name$1} exceeded degrade threshold: ${durationMs.toFixed(1)}ms >= ${threshold.degradeMs}ms`);
+		else if (threshold.warnMs !== void 0 && durationMs >= threshold.warnMs) log$44.info(`${name$1} exceeded warn threshold: ${durationMs.toFixed(1)}ms >= ${threshold.warnMs}ms`);
 	}
 }
 function getMeasurements(name$1) {
@@ -5615,7 +5634,7 @@ function getMeasurements(name$1) {
 
 //#endregion
 //#region src/client/store/internals.ts
-const log$42 = scoped("store");
+const log$43 = scoped("store");
 const diagramCache = new DiagramCache(10);
 const clusterCache = new ClusterCache(20);
 const callChainAggregator = new CallChainAggregator();
@@ -5733,7 +5752,7 @@ function mergeAndRecluster(newNodes, newEdges, set$1, logLabel, logDetail) {
 		nodes: result.nodes,
 		edges: result.edges
 	});
-	log$42.info(logLabel, {
+	log$43.info(logLabel, {
 		...logDetail,
 		newNodes: filteredNodes.length,
 		newEdges: filteredEdges.length
@@ -5905,7 +5924,7 @@ function normalizeEdgeType(type) {
 
 //#endregion
 //#region src/shared/GraphValidator.ts
-const log$41 = scoped("validator");
+const log$42 = scoped("validator");
 function coerceNode(raw, i$1) {
 	if (!raw || typeof raw !== "object") return null;
 	const o = raw;
@@ -7165,6 +7184,7 @@ const en = {
 	"canvasControls.shortcutZoomIn": "+ Zoom in",
 	"canvasControls.shortcutZoomOut": "- Zoom out",
 	"canvasControls.shortcutFit": "F Fit to view",
+	"canvasControls.shortcutBoxSelect": "Shift+Drag Box-select nodes",
 	"canvasControls.multiSelect": "Multi-select mode",
 	"micro.closeView": "Close micro view",
 	"micro.functionBar": "Micro view toolbar",
@@ -7328,6 +7348,12 @@ const en = {
 	"contextMenu.findPath": "Find Path From Here",
 	"contextMenu.showAll": "Show All Hidden Nodes",
 	"contextMenu.openSource": "Open Source",
+	"contextMenu.expandHere": "Expand From Here",
+	"contextMenu.collapseHere": "Collapse To Here",
+	"contextMenu.pinNode": "Pin Node",
+	"contextMenu.unpinNode": "Unpin Node",
+	"contextMenu.copyId": "Copy Symbol ID",
+	"contextMenu.copied": "Copied",
 	"a11y.graphContainer": "Code graph interactive area",
 	"a11y.graphContainerStats": "Code graph interactive area: {viewMode}, {nodeCount} nodes, {edgeCount} edges",
 	"a11y.selectedNode": "Selected node",
@@ -7509,7 +7535,17 @@ const en = {
 	"views.srcAuto": "Collected by host",
 	"views.srcQuery": "Provided by caller",
 	"views.srcDuration": "{ms}ms",
-	"views.srcTruncated": "truncated"
+	"views.srcTruncated": "truncated",
+	"batchbar.ariaLabel": "Batch actions",
+	"batchbar.count": "{count} selected",
+	"batchbar.expand": "Expand",
+	"batchbar.expandAria": "Expand all selected nodes",
+	"batchbar.collapse": "Collapse",
+	"batchbar.collapseAria": "Collapse all selected nodes",
+	"batchbar.export": "Export JSON",
+	"batchbar.exportAria": "Export selected nodes as JSON",
+	"batchbar.clear": "Clear",
+	"batchbar.clearAria": "Clear multi-selection"
 };
 
 //#endregion
@@ -7997,6 +8033,7 @@ const zh = {
 	"canvasControls.shortcutZoomIn": "+ 放大",
 	"canvasControls.shortcutZoomOut": "- 缩小",
 	"canvasControls.shortcutFit": "F 适应窗口",
+	"canvasControls.shortcutBoxSelect": "Shift+拖拽 框选节点",
 	"canvasControls.multiSelect": "多选模式",
 	"micro.closeView": "关闭微观视图",
 	"micro.functionBar": "微观视图工具栏",
@@ -8160,6 +8197,12 @@ const zh = {
 	"contextMenu.findPath": "从此节点查找路径",
 	"contextMenu.showAll": "显示所有隐藏节点",
 	"contextMenu.openSource": "打开源码",
+	"contextMenu.expandHere": "从此展开",
+	"contextMenu.collapseHere": "收起到这里",
+	"contextMenu.pinNode": "固定节点",
+	"contextMenu.unpinNode": "取消固定",
+	"contextMenu.copyId": "复制符号 ID",
+	"contextMenu.copied": "已复制",
 	"a11y.graphContainer": "代码图谱交互区域",
 	"a11y.graphContainerStats": "代码图谱交互区域: {viewMode}, {nodeCount} 节点, {edgeCount} 边",
 	"a11y.selectedNode": "已选中节点",
@@ -8341,7 +8384,17 @@ const zh = {
 	"views.srcAuto": "宿主自动采集",
 	"views.srcQuery": "调用方传入",
 	"views.srcDuration": "耗时 {ms}ms",
-	"views.srcTruncated": "已截断"
+	"views.srcTruncated": "已截断",
+	"batchbar.ariaLabel": "批量操作条",
+	"batchbar.count": "已选 {count} 个",
+	"batchbar.expand": "展开",
+	"batchbar.expandAria": "批量展开选中的节点",
+	"batchbar.collapse": "收起",
+	"batchbar.collapseAria": "批量收起选中的节点",
+	"batchbar.export": "导出 JSON",
+	"batchbar.exportAria": "导出选中节点为 JSON 文件",
+	"batchbar.clear": "清除",
+	"batchbar.clearAria": "清除多选"
 };
 
 //#endregion
@@ -9349,14 +9402,14 @@ function etagKeyForEdges(fromId, scope, cursor, limit$1, detail) {
 
 //#endregion
 //#region src/client/api/requestCore.ts
-const log$40 = scoped("client");
+const log$41 = scoped("client");
 const DEFAULT_TIMEOUT = API.DEFAULT_TIMEOUT_MS;
 async function withAbortGuard(name$1, run$3, fallback, logContext) {
 	try {
 		return await run$3();
 	} catch (e) {
 		if (e instanceof DOMException && e.name === "AbortError") return fallback;
-		log$40.warn(`${name$1} failed`, {
+		log$41.warn(`${name$1} failed`, {
 			...logContext,
 			error: e instanceof Error ? e.message : String(e)
 		});
@@ -9689,7 +9742,7 @@ async function fetchPathEnumerate(source, target, options = {}) {
 
 //#endregion
 //#region src/client/api/index.ts
-const log$39 = scoped("client");
+const log$40 = scoped("client");
 /** 构造一个空 sink；调用方先建后传，取数函数负责填充。 */
 function createEtagSink() {
 	return {
@@ -9890,7 +9943,7 @@ async function fetchGraphDataIncremental(clientEtag, scopeRepoId) {
 		const data$2 = coerceGraphData(await res.json());
 		if (!data$2) return null;
 		if (isForeignRepo(data$2.metadata.repoId, scopeRepoId)) {
-			log$39.info("incremental graph fetch ignored for another workspace", {
+			log$40.info("incremental graph fetch ignored for another workspace", {
 				repoId: data$2.metadata.repoId,
 				activeRepoId: scopeRepoId
 			});
@@ -10031,7 +10084,7 @@ async function fetchEdges(fromId, scope = "file", cursor, limit$1, signal, works
 
 //#endregion
 //#region src/client/diagram/index.ts
-const log$38 = scoped("diagram");
+const log$39 = scoped("diagram");
 const macroAssemblerRegistry = new Map([
 	["inheritance", new InheritanceAssembler()],
 	["callgraph", new CallGraphAssembler()],
@@ -10231,7 +10284,7 @@ async function assembleMicroDiagram(viewMode, filePath, functionName, workspace)
 			body: JSON.stringify({ filePath })
 		});
 	} catch (e) {
-		log$38.warn("AST fetch failed", e);
+		log$39.warn("AST fetch failed", e);
 		throw new Error(`Network error: unable to reach AST endpoint`);
 	}
 	if (!response.ok) {
@@ -10246,7 +10299,7 @@ async function assembleMicroDiagram(viewMode, filePath, functionName, workspace)
 				const parsed = JSON.parse(errorBody);
 				serverMsg = parsed.error || "";
 			} catch (e) {
-				log$38.warn("AST error body parse failed", e);
+				log$39.warn("AST error body parse failed", e);
 				serverMsg = errorBody;
 			}
 			throw new Error(serverMsg || `AST parsing failed for "${filePath}"`);
@@ -10381,7 +10434,7 @@ function createEdgeSlice(_set, _get) {
 								nodeEdgeTotals: totals$1,
 								nodeEdgeCursors: cursors$1
 							});
-							log$42.info("node edges loaded (cache)", {
+							log$43.info("node edges loaded (cache)", {
 								nodeId,
 								scope,
 								edges: data$3.edges.length
@@ -10394,7 +10447,7 @@ function createEdgeSlice(_set, _get) {
 				const data$2 = await fetchEdges(nodeId, scope, cursor, EDGE_DETAIL.PAGE_SIZE, controller.signal, _get().currentWorkspace, detail, sink);
 				if (!isCurrent() || gen !== internals.expandGeneration) return;
 				if (sink.notModified) {
-					log$42.info("node edges not modified (304)", {
+					log$43.info("node edges not modified (304)", {
 						nodeId,
 						scope,
 						cursor,
@@ -10403,7 +10456,7 @@ function createEdgeSlice(_set, _get) {
 					return;
 				}
 				if (!data$2) {
-					log$42.warn("loadNodeEdges: no response", {
+					log$43.warn("loadNodeEdges: no response", {
 						nodeId,
 						scope,
 						cursor,
@@ -10430,7 +10483,7 @@ function createEdgeSlice(_set, _get) {
 					edges: merged,
 					total: data$2.total
 				});
-				log$42.info("node edges loaded", {
+				log$43.info("node edges loaded", {
 					nodeId,
 					scope,
 					detail,
@@ -10441,7 +10494,7 @@ function createEdgeSlice(_set, _get) {
 				});
 				commitEtag(sink);
 			} catch (err) {
-				if (!(err instanceof DOMException && err.name === "AbortError")) log$42.warn("loadNodeEdges failed", {
+				if (!(err instanceof DOMException && err.name === "AbortError")) log$43.warn("loadNodeEdges failed", {
 					nodeId,
 					scope,
 					err
@@ -10564,7 +10617,7 @@ function createGraphDataSlice(_set, _get) {
 					...emptyDiffState()
 				});
 			} catch (err) {
-				log$42.error("setGraphData failed", { err });
+				log$43.error("setGraphData failed", { err });
 				_set({
 					error: err instanceof Error ? err.message : String(err),
 					isLoading: false
@@ -10633,12 +10686,12 @@ function createGraphDataSlice(_set, _get) {
 					...emptyEdgeState(),
 					...emptyDiffState()
 				});
-				log$42.info("bootstrap data set", {
+				log$43.info("bootstrap data set", {
 					rootNodes: sanitized.nodes.length,
 					totalNodeCount: metadata.totalNodeCount
 				});
 			} catch (err) {
-				log$42.error("setBootstrapData failed", { err });
+				log$43.error("setBootstrapData failed", { err });
 				_set({
 					error: err instanceof Error ? err.message : String(err),
 					isLoading: false
@@ -10681,7 +10734,7 @@ function createGraphDataSlice(_set, _get) {
 				nodes: rawNodes,
 				edges: rawEdges
 			}, delta, { minRetainRatio: GRAPH_DELTA_SHRINK.MIN_RETAIN_RATIO })) {
-				log$42.info("applyGraphDelta refused: delta does not match the current revision or would shrink the graph", {
+				log$43.info("applyGraphDelta refused: delta does not match the current revision or would shrink the graph", {
 					storedNodes: rawNodes.length,
 					storedEdges: rawEdges.length,
 					...graphDeltaSize(delta)
@@ -10743,7 +10796,7 @@ function createGraphDataSlice(_set, _get) {
 					...emptyEdgeState(),
 					...emptyDiffState()
 				});
-				log$42.info("applied graph delta", {
+				log$43.info("applied graph delta", {
 					addedNodes: delta.addedNodes.length,
 					removedNodes: delta.removedNodes.length,
 					modifiedNodes: delta.modifiedNodes.length,
@@ -10753,7 +10806,7 @@ function createGraphDataSlice(_set, _get) {
 				});
 				return true;
 			} catch (err) {
-				log$42.error("applyGraphDelta failed", { err });
+				log$43.error("applyGraphDelta failed", { err });
 				_set({
 					error: err instanceof Error ? err.message : String(err),
 					isLoading: false
@@ -11099,7 +11152,7 @@ function createSessionSlice(_set, _get) {
 
 //#endregion
 //#region src/client/utils/urlState.ts
-const log$37 = scoped("url-state");
+const log$38 = scoped("url-state");
 const PREFIX_DIR = "d:";
 const PREFIX_FILE = "f:";
 const PREFIX_SYMBOL = "s:";
@@ -11156,7 +11209,7 @@ function updateUrlExpand(expandedNodeIds) {
 	if (urlString.length > URL_STATE.MAX_LENGTH) {
 		const trimmed = expandParam.split(",").filter((p$1) => !p$1.startsWith(PREFIX_SYMBOL));
 		url.searchParams.set("expand", trimmed.join(","));
-		log$37.warn("URL too long, trimmed symbol-level expansions");
+		log$38.warn("URL too long, trimmed symbol-level expansions");
 	}
 	window.history.replaceState(null, "", url.toString());
 }
@@ -11251,7 +11304,7 @@ async function loadFunctionBodyAst(nodeId, signal, gen, _set, _get, cursor = 0)
 		const data$2 = await measureAsync("ast-fetch", () => fetchSymbolAST(nodeId, signal, _get().currentWorkspace, cursor, sink));
 		if (gen !== internals.expandGeneration || !isCurrent()) return;
 		if (sink.notModified) {
-			log$42.info("symbol AST not modified (304)", {
+			log$43.info("symbol AST not modified (304)", {
 				nodeId,
 				cursor
 			});
@@ -11259,7 +11312,7 @@ async function loadFunctionBodyAst(nodeId, signal, gen, _set, _get, cursor = 0)
 		}
 		if (!data$2) return;
 		const { astNodes: truncatedAstNodes, astEdges: truncatedAstEdges, sourceLines: truncatedSourceLines } = truncateAstData(data$2);
-		if (truncatedAstNodes.length < data$2.astNodes.length) log$42.warn("symbol AST truncated", {
+		if (truncatedAstNodes.length < data$2.astNodes.length) log$43.warn("symbol AST truncated", {
 			nodeId,
 			original: data$2.astNodes.length,
 			truncated: truncatedAstNodes.length
@@ -11279,7 +11332,7 @@ async function loadFunctionBodyAst(nodeId, signal, gen, _set, _get, cursor = 0)
 		if (internals.persistentCache && !data$2.hasMore && cursor === 0) await internals.persistentCache.setAST(nodeId, data$2);
 		commitEtag(sink);
 	} catch (err) {
-		log$42.warn("expandNode: fetchSymbolAST failed", {
+		log$43.warn("expandNode: fetchSymbolAST failed", {
 			nodeId,
 			err
 		});
@@ -11306,7 +11359,7 @@ function createExpandSlice(_set, _get) {
 			if (expandingFunctionBody) enforceFunctionBodyBudget(effectiveExpanded, rawNodes, FUNCTION_BODY.MAX_EXPANDED - 1, pinnedIds);
 			effectiveExpanded.add(nodeId);
 			collapseExcessClusters(nodes, effectiveExpanded, maxVisible, cost, pinnedIds);
-			if (cost > CLUSTER.EXPAND_BUDGET_SINGLE) log$42.warn("expand budget exceeded", {
+			if (cost > CLUSTER.EXPAND_BUDGET_SINGLE) log$43.warn("expand budget exceeded", {
 				nodeId,
 				cost,
 				budget: CLUSTER.EXPAND_BUDGET_SINGLE
@@ -11321,7 +11374,7 @@ function createExpandSlice(_set, _get) {
 				const expandController = replaceController(internals.expandAbortControllers, nodeId);
 				_get().loadNodeChildren(nodeId, { signal: expandController.signal }).catch((err) => {
 					if (err instanceof DOMException && err.name === "AbortError") return;
-					log$42.warn("expandNode: loadNodeChildren failed", {
+					log$43.warn("expandNode: loadNodeChildren failed", {
 						nodeId,
 						err
 					});
@@ -11343,7 +11396,7 @@ function createExpandSlice(_set, _get) {
 					fetchFileOutline(nodeId, expandController.signal, _get().currentWorkspace, sink).then(async (data$2) => {
 						if (gen !== internals.expandGeneration) return;
 						if (sink.notModified) {
-							log$42.info("file outline not modified (304)", { nodeId });
+							log$43.info("file outline not modified (304)", { nodeId });
 							return;
 						}
 						if (data$2 && data$2.symbols.length > 0) {
@@ -11352,7 +11405,7 @@ function createExpandSlice(_set, _get) {
 							commitEtag(sink);
 						}
 					}).catch((err) => {
-						log$42.warn("expandNode: fetchFileOutline failed", {
+						log$43.warn("expandNode: fetchFileOutline failed", {
 							nodeId,
 							err
 						});
@@ -11390,7 +11443,7 @@ function createExpandSlice(_set, _get) {
 						loadedChildrenByNodeId: newLoaded$1,
 						pendingRequests: clearedPending$1
 					});
-					log$42.info("node children not modified (304)", { nodeId });
+					log$43.info("node children not modified (304)", { nodeId });
 					return;
 				}
 				if (!data$2 || data$2.nodes.length === 0) {
@@ -11439,7 +11492,7 @@ function createExpandSlice(_set, _get) {
 					loadedChildrenByNodeId: newLoaded,
 					pendingRequests: clearedPending
 				});
-				log$42.info("node children loaded", {
+				log$43.info("node children loaded", {
 					nodeId,
 					newNodes: newNodes.length,
 					newEdges: newEdges.length
@@ -11458,7 +11511,7 @@ function createExpandSlice(_set, _get) {
 					pendingRequests: clearedPending,
 					loadErrorsByNodeId: newErrors
 				});
-				log$42.warn("loadNodeChildren failed", {
+				log$43.warn("loadNodeChildren failed", {
 					nodeId,
 					err
 				});
@@ -11469,7 +11522,7 @@ function createExpandSlice(_set, _get) {
 				const ws = _get().currentWorkspace;
 				const data$2 = await fetchBootstrap(void 0, ws);
 				if (!data$2) {
-					log$42.info("bootstrap returned no payload, falling back to full load");
+					log$43.info("bootstrap returned no payload, falling back to full load");
 					return false;
 				}
 				_get().setIndexStatus(data$2.indexStatus);
@@ -11480,11 +11533,11 @@ function createExpandSlice(_set, _get) {
 						timestamp: data$2.metadata.timestamp,
 						graphLayer: data$2.metadata.graphLayer
 					});
-					log$42.info("bootstrap: index building, empty skeleton installed", { repoId: data$2.metadata.repoId });
+					log$43.info("bootstrap: index building, empty skeleton installed", { repoId: data$2.metadata.repoId });
 					return true;
 				}
 				if (data$2.topLevelNodes.length === 0) {
-					log$42.info("bootstrap returned empty, falling back to full load");
+					log$43.info("bootstrap returned empty, falling back to full load");
 					return false;
 				}
 				const state = _get();
@@ -11494,14 +11547,14 @@ function createExpandSlice(_set, _get) {
 					timestamp: data$2.metadata.timestamp,
 					graphLayer: data$2.metadata.graphLayer
 				});
-				log$42.info("bootstrap loaded", {
+				log$43.info("bootstrap loaded", {
 					rootNodes: data$2.topLevelNodes.length,
 					totalNodeCount: data$2.metadata.totalNodeCount,
 					indexStatus: data$2.indexStatus
 				});
 				return true;
 			} catch (err) {
-				log$42.warn("loadBootstrap failed, falling back to full load", { err });
+				log$43.warn("loadBootstrap failed, falling back to full load", { err });
 				return false;
 			}
 		},
@@ -11661,7 +11714,7 @@ function createExpandSlice(_set, _get) {
 				if (!exists) {
 					const parentId = nodeId.includes("/") ? nodeId.substring(0, nodeId.lastIndexOf("/")) : null;
 					if (parentId && !state.loadedChildrenByNodeId.has(parentId)) await state.loadNodeChildren(parentId, { signal: restoreController.signal }).catch((err) => {
-						if (!(err instanceof DOMException && err.name === "AbortError")) log$42.warn("restoreFromUrl: loadNodeChildren failed", {
+						if (!(err instanceof DOMException && err.name === "AbortError")) log$43.warn("restoreFromUrl: loadNodeChildren failed", {
 							parentId,
 							err
 						});
@@ -11686,7 +11739,7 @@ function createExpandSlice(_set, _get) {
 			}
 			internals.restoreTimeoutHandle = null;
 			_set({ urlRestored: true });
-			log$42.info("URL restore completed", { restoredCount: sortedIds.length });
+			log$43.info("URL restore completed", { restoredCount: sortedIds.length });
 		}
 	};
 }
@@ -11868,7 +11921,7 @@ function createAnalysisSlice(_set, _get) {
 					isLoading: false
 				});
 			} catch (e) {
-				log$42.warn("assembleMultiFunction failed", e);
+				log$43.warn("assembleMultiFunction failed", e);
 				_set({
 					error: t("error.callChainFailed"),
 					isLoading: false
@@ -11954,7 +12007,7 @@ function createPanelLodSlice(_set, _get) {
 
 //#endregion
 //#region src/client/api/keywordQuery.ts
-const log$36 = scoped("client");
+const log$37 = scoped("client");
 /**
 
 * 条件请求的请求键（与宿主 `computeQueryEtag` 的**参数域**对齐）。
@@ -12013,7 +12066,7 @@ async function fetchKeywordQuery(params, signal) {
 		res = await fetchWithTimeout(`/api/v1/codegraph/query?${search.toString()}`, options);
 	} catch (e) {
 		const aborted = e instanceof DOMException && e.name === "AbortError";
-		log$36.warn("fetchKeywordQuery failed", {
+		log$37.warn("fetchKeywordQuery failed", {
 			aborted,
 			externalAborted: signal?.aborted === true,
 			error: e instanceof Error ? e.message : String(e)
@@ -12030,7 +12083,7 @@ async function fetchKeywordQuery(params, signal) {
 	try {
 		payload = await res.json();
 	} catch (e) {
-		log$36.warn("fetchKeywordQuery: non-JSON body", { error: e instanceof Error ? e.message : String(e) });
+		log$37.warn("fetchKeywordQuery: non-JSON body", { error: e instanceof Error ? e.message : String(e) });
 		return {
 			kind: "failed",
 			status: res.status
@@ -12168,7 +12221,7 @@ function createKeywordQuerySlice(_set, _get) {
 			});
 			if (seq !== _get().keywordQuerySeq) return false;
 			if (outcome.kind === "not-modified") {
-				log$42.info("keyword query not modified (304)", { q: trimmed });
+				log$43.info("keyword query not modified (304)", { q: trimmed });
 				const previous = _get().keywordQueryResult;
 				_set({
 					keywordQueryStatus: previous ? "ready" : "idle",
@@ -12217,7 +12270,7 @@ function createKeywordQuerySlice(_set, _get) {
 			const state = _get();
 			const exists = state.rawNodes.some((node) => node.id === nodeId);
 			if (!exists) {
-				log$42.warn("selectKeywordSeed: node not in current graph", { nodeId });
+				log$43.warn("selectKeywordSeed: node not in current graph", { nodeId });
 				return;
 			}
 			_set({
@@ -12239,7 +12292,7 @@ function createKeywordQuerySlice(_set, _get) {
 				...workspace && workspace !== "." ? { workspace } : {}
 			});
 			if (outcome.kind !== "data") {
-				log$42.warn("revealRemoteNode: query failed", {
+				log$43.warn("revealRemoteNode: query failed", {
 					nodeId,
 					kind: outcome.kind
 				});
@@ -12247,12 +12300,12 @@ function createKeywordQuerySlice(_set, _get) {
 			}
 			const target = outcome.data.nodes.find((n) => n.id === nodeId);
 			if (!target) {
-				log$42.warn("revealRemoteNode: payload does not contain the requested node", { nodeId });
+				log$43.warn("revealRemoteNode: payload does not contain the requested node", { nodeId });
 				return false;
 			}
 			mergeAndRecluster(outcome.data.nodes, outcome.data.edges, _set, "remote search hit merged", { nodeId });
 			if (!_get().rawNodes.some((node) => node.id === nodeId)) {
-				log$42.warn("revealRemoteNode: node still absent after merge", { nodeId });
+				log$43.warn("revealRemoteNode: node still absent after merge", { nodeId });
 				return false;
 			}
 			_set({
@@ -12302,7 +12355,7 @@ function truncationReasonKey(reason) {
 
 //#endregion
 //#region src/client/api/pathPattern.ts
-const log$35 = scoped("client");
+const log$36 = scoped("client");
 /**
 * 把宿主响应归一成 `PathPatternData`。
 *
@@ -12362,7 +12415,7 @@ async function fetchPathsByPattern(params, signal) {
 		res = await fetchWithTimeout(`/api/v1/codegraph/paths?${search.toString()}`, options);
 	} catch (e) {
 		const aborted = e instanceof DOMException && e.name === "AbortError";
-		log$35.warn("fetchPathsByPattern failed", {
+		log$36.warn("fetchPathsByPattern failed", {
 			aborted,
 			externalAborted: signal?.aborted === true,
 			error: e instanceof Error ? e.message : String(e)
@@ -12383,7 +12436,7 @@ async function fetchPathsByPattern(params, signal) {
 		const record$1 = body && typeof body === "object" ? body : {};
 		const errorCode = typeof record$1.error === "string" ? record$1.error : "invalid-pattern";
 		const diagnostic = typeof record$1.diagnostic === "string" ? record$1.diagnostic : typeof record$1.message === "string" ? record$1.message : "";
-		log$35.warn("fetchPathsByPattern: invalid pattern", {
+		log$36.warn("fetchPathsByPattern: invalid pattern", {
 			errorCode,
 			diagnostic
 		});
@@ -12401,7 +12454,7 @@ async function fetchPathsByPattern(params, signal) {
 	try {
 		payload = await res.json();
 	} catch (e) {
-		log$35.warn("fetchPathsByPattern: non-JSON body", { error: e instanceof Error ? e.message : String(e) });
+		log$36.warn("fetchPathsByPattern: non-JSON body", { error: e instanceof Error ? e.message : String(e) });
 		return {
 			kind: "failed",
 			status: res.status
@@ -12430,7 +12483,7 @@ async function fetchPathPatternSyntax(pattern, signal) {
 		res = await fetchWithTimeout(`/api/v1/codegraph/path-pattern/syntax?${search.toString()}`, options);
 	} catch (e) {
 		const aborted = e instanceof DOMException && e.name === "AbortError";
-		log$35.warn("fetchPathPatternSyntax failed", {
+		log$36.warn("fetchPathPatternSyntax failed", {
 			aborted,
 			externalAborted: signal?.aborted === true,
 			error: e instanceof Error ? e.message : String(e)
@@ -12453,7 +12506,7 @@ async function fetchPathPatternSyntax(pattern, signal) {
 	try {
 		payload = await res.json();
 	} catch (e) {
-		log$35.warn("fetchPathPatternSyntax: non-JSON body", { error: e instanceof Error ? e.message : String(e) });
+		log$36.warn("fetchPathPatternSyntax: non-JSON body", { error: e instanceof Error ? e.message : String(e) });
 		return {
 			ok: false,
 			kind: "failed",
@@ -12539,7 +12592,7 @@ function applyOutcome(outcome, pattern, workspace, basePaths, set$1) {
 		return false;
 	}
 	if (outcome.kind === "invalid") {
-		log$42.warn("ρ pattern rejected (invalid syntax)", {
+		log$43.warn("ρ pattern rejected (invalid syntax)", {
 			pattern,
 			diagnostic: outcome.diagnostic
 		});
@@ -12676,9 +12729,76 @@ function summarizePathPatternResult(result) {
 	};
 }
 
+//#endregion
+//#region src/client/store/slices/multiSelectSlice.ts
+/**
+* 多选链路的**消费面**（cycle-149）。
+*
+* cycle-141 D 在渲染器侧交付了 Shift+Click 多选（`InteractionController.multiSelectedIds`
+* + `multi-selected` class + `onSelectionToggle` 回调），但该回调在全仓**零消费方**——
+* 多选集合只活在渲染器内部，store/UI 全都看不到。本切片把这条链路接完：
+*
+* - `multiSelectedIds` 是渲染器多选集合的**镜像**（单一事实源仍是渲染器，
+*   store 只做镜像 + 批量动作的消费面；两边经 `syncMultiSelection`/`clearMultiSelection`
+*   同步，避免双集合各自演化后漂移）。
+* - `batchExpandSelected` 复用 expandSlice 的 `batchExpandNodes`（函数体预算 / pinned
+*   语义不重写——两处实现必然漂移，CLAUDE.md「Two data paths for the same semantics
+*   must share ONE implementation」）。
+* - `batchCollapseSelected` 与 expandSlice `collapseAll` 同形：**单次** recluster
+*   （逐个 collapseNode 会 N 次重聚类），pinned 节点不收（与 `collapseNode` 语义一致）。
+* - `exportSelectedNodes` 从 `rawNodes` 过滤导出；**聚合节点（cluster）不在 rawNodes 里**，
+*   选中聚合节点时该 id 被静默跳过——这是有意的诚实缺口（渲染器合并态 store 不可见），
+*   UI 侧以「导出 N 个」计数如实呈现，不伪造。
+*
+* `multiSelectedIds` **不持久化**：画布选区是会话瞬时态，reload 后节点可能已变
+* （与 `xuanjiSignal` 同判据）；`partialize` 白名单不收录即天然排除。
+*/
+function createMultiSelectSlice(_set, _get) {
+	return {
+		multiSelectedIds: new Set(),
+		syncMultiSelection: (ids) => {
+			const current$2 = _get().multiSelectedIds;
+			if (current$2.size === ids.length && [...ids].every((id) => current$2.has(id))) return;
+			_set({ multiSelectedIds: new Set(ids) });
+		},
+		clearMultiSelection: () => {
+			if (_get().multiSelectedIds.size === 0) return;
+			_set({ multiSelectedIds: new Set() });
+		},
+		batchExpandSelected: () => {
+			const ids = [..._get().multiSelectedIds];
+			if (ids.length === 0) return 0;
+			_get().batchExpandNodes(ids);
+			return ids.length;
+		},
+		batchCollapseSelected: () => {
+			const { multiSelectedIds, expandedNodeIds, expandedNodeIdsByViewMode, viewMode, pinnedIds } = _get();
+			if (multiSelectedIds.size === 0) return 0;
+			const newExpanded = new Set(expandedNodeIds);
+			let collapsed = 0;
+			for (const id of multiSelectedIds) {
+				if (pinnedIds.has(id)) continue;
+				if (newExpanded.delete(id)) collapsed++;
+			}
+			if (collapsed === 0) return 0;
+			const newExpandedByViewMode = {
+				...expandedNodeIdsByViewMode,
+				[viewMode]: newExpanded
+			};
+			reclusterWith(_get, _set, newExpanded, newExpandedByViewMode);
+			return collapsed;
+		},
+		exportSelectedNodes: () => {
+			const { multiSelectedIds, rawNodes } = _get();
+			if (multiSelectedIds.size === 0) return [];
+			return rawNodes.filter((n) => multiSelectedIds.has(n.id));
+		}
+	};
+}
+
 //#endregion
 //#region src/client/utils/safeStorage.ts
-const log$34 = scoped("client");
+const log$35 = scoped("client");
 /** 纯内存实现：同一页面的多次读写一致，刷新即丢。 */
 function createMemoryStorage() {
 	const map$1 = new Map();
@@ -12736,7 +12856,7 @@ function getSafeStorage(label = "generic") {
 			try {
 				return local.getItem(name$1);
 			} catch (e) {
-				log$34.debug("safeStorage.getItem failed", {
+				log$35.debug("safeStorage.getItem failed", {
 					label,
 					error: e
 				});
@@ -12747,7 +12867,7 @@ function getSafeStorage(label = "generic") {
 			try {
 				local.setItem(name$1, value);
 			} catch (e) {
-				log$34.debug("safeStorage.setItem failed", {
+				log$35.debug("safeStorage.setItem failed", {
 					label,
 					error: e
 				});
@@ -12757,7 +12877,7 @@ function getSafeStorage(label = "generic") {
 			try {
 				local.removeItem(name$1);
 			} catch (e) {
-				log$34.debug("safeStorage.removeItem failed", {
+				log$35.debug("safeStorage.removeItem failed", {
 					label,
 					error: e
 				});
@@ -12766,7 +12886,7 @@ function getSafeStorage(label = "generic") {
 	};
 	const session = isStorageUsable(() => window.sessionStorage);
 	if (session) {
-		log$34.info("localStorage unavailable, falling back to sessionStorage", { label });
+		log$35.info("localStorage unavailable, falling back to sessionStorage", { label });
 		return {
 			getItem: (name$1) => {
 				try {
@@ -12787,7 +12907,7 @@ function getSafeStorage(label = "generic") {
 			}
 		};
 	}
-	log$34.info("no Web Storage available, falling back to in-memory storage", { label });
+	log$35.info("no Web Storage available, falling back to in-memory storage", { label });
 	return createMemoryStorage();
 }
 /**
@@ -12848,7 +12968,8 @@ function disposeStore() {
 		nodeEdgeTotals: new Map(),
 		nodeEdgeCursors: new Map(),
 		loadingEdgeNodeIds: new Set(),
-		detailEdgeNodeIds: new Set()
+		detailEdgeNodeIds: new Set(),
+		multiSelectedIds: new Set()
 	});
 	if (internals.restoreTimeoutHandle !== null) {
 		clearTimeout(internals.restoreTimeoutHandle);
@@ -12887,7 +13008,8 @@ const useGraphStore = create$1()(persist((set$1, get$3) => {
 		...createAnalysisSlice(set$1, get$3),
 		...createPanelLodSlice(set$1, get$3),
 		...createKeywordQuerySlice(set$1, get$3),
-		...createPathPatternSlice(set$1, get$3)
+		...createPathPatternSlice(set$1, get$3),
+		...createMultiSelectSlice(set$1, get$3)
 	};
 	registerStoreGetter(get$3);
 	return store;
@@ -58347,7 +58469,7 @@ var OverlapRemover = class {
 
 //#endregion
 //#region src/client/renderer/LayoutController.ts
-const log$33 = scoped("layout");
+const log$34 = scoped("layout");
 var LayoutController = class {
 	cy;
 	layoutRaf = null;
@@ -58390,17 +58512,17 @@ var LayoutController = class {
 					this.worker?.terminate();
 					this.worker = null;
 					this.workerInitFailed = true;
-					log$33.warn("layout worker error — falling back to main-thread layout");
+					log$34.warn("layout worker error — falling back to main-thread layout");
 					this.failPendingLayout();
 					this.retryWorkerInit();
 				};
 			} else {
 				this.workerInitFailed = true;
-				log$33.warn("layout worker not available — using main-thread layout");
+				log$34.warn("layout worker not available — using main-thread layout");
 			}
 		} catch (e) {
 			this.workerInitFailed = true;
-			log$33.warn("layout worker init failed — using main-thread layout", e);
+			log$34.warn("layout worker init failed — using main-thread layout", e);
 		}
 	}
 	/** Resolve an in-flight worker layout with no positions, so the caller falls back immediately. */
@@ -58426,7 +58548,7 @@ var LayoutController = class {
 		if (this.workerGaveUp) return;
 		if (this.workerRetryCount >= RENDERER.WORKER_MAX_INIT_RETRIES) {
 			this.workerGaveUp = true;
-			log$33.warn(`layout worker unavailable after ${RENDERER.WORKER_MAX_INIT_RETRIES} retries — main-thread layout for the rest of this session`);
+			log$34.warn(`layout worker unavailable after ${RENDERER.WORKER_MAX_INIT_RETRIES} retries — main-thread layout for the rest of this session`);
 			return;
 		}
 		this.workerRetryCount++;
@@ -58447,13 +58569,13 @@ var LayoutController = class {
 		const timeoutMs = this.workerReady ? RENDERER.LAYOUT_TIMEOUT_MS : RENDERER.WORKER_HANDSHAKE_TIMEOUT_MS;
 		return new Promise((resolve) => {
 			this.workerTimeout = setTimeout(() => {
-				log$33.warn("layout worker timeout — falling back to main-thread layout");
+				log$34.warn("layout worker timeout — falling back to main-thread layout");
 				this.failPendingLayout();
 				if (this.worker) {
 					this.worker.terminate();
 					this.worker = null;
 					this.workerInitFailed = true;
-					log$33.warn("layout worker terminated due to timeout — retrying within the retry budget");
+					log$34.warn("layout worker terminated due to timeout — retrying within the retry budget");
 					this.retryWorkerInit();
 				}
 			}, timeoutMs);
@@ -58527,7 +58649,7 @@ var LayoutController = class {
 			try {
 				this.runIncrementalLayout(layout$2, newNodeIds);
 			} catch (e) {
-				log$33.warn("incremental layout failed — keeping the previous positions", e);
+				log$34.warn("incremental layout failed — keeping the previous positions", e);
 			} finally {
 				this.layoutRaf = null;
 			}
@@ -59291,7 +59413,7 @@ function detectCyclesDFS(adjacency, maxCycles = MAX_CYCLES_DEFAULT) {
 
 //#endregion
 //#region src/client/renderer/CycleDetector.ts
-const log$32 = scoped("cycle-detector");
+const log$33 = scoped("cycle-detector");
 var CycleDetector = class {
 	cy;
 	adjacencyCache;
@@ -59333,7 +59455,7 @@ var CycleDetector = class {
 		const cycles = new Set();
 		const nodeCount = this.cy.nodes().length;
 		if (nodeCount > CYCLE_DETECTION.MAX_NODES_FOR_DETECTION) {
-			log$32.warn("cycle detection skipped: graph too large", { nodeCount });
+			log$33.warn("cycle detection skipped: graph too large", { nodeCount });
 			return cycles;
 		}
 		const adjacencySet = this.getForwardAdjacency();
@@ -59346,7 +59468,7 @@ var CycleDetector = class {
 	detectCyclesDetailed() {
 		const nodeCount = this.cy.nodes().length;
 		if (nodeCount > CYCLE_DETECTION.MAX_NODES_FOR_DETECTION) {
-			log$32.warn("detailed cycle detection skipped: graph too large", { nodeCount });
+			log$33.warn("detailed cycle detection skipped: graph too large", { nodeCount });
 			return [];
 		}
 		const adjacencySet = this.getForwardAdjacency();
@@ -59910,7 +60032,7 @@ function pushId(map$1, key, edgeId) {
 
 //#endregion
 //#region src/client/renderer/DataController.ts
-const log$31 = scoped("data-controller");
+const log$32 = scoped("data-controller");
 /** 缺省结果：任何未表态路径都必须回到「必须失效」的安全方向。 */
 const DIRTY = { kind: "dirty" };
 var DataController = class {
@@ -60168,7 +60290,7 @@ var DataController = class {
 				expectedVersion: cache$1.getVersion()
 			};
 		} catch (err) {
-			log$31.warn("adjacency reconcile failed — invalidating cache", { err: String(err) });
+			log$32.warn("adjacency reconcile failed — invalidating cache", { err: String(err) });
 			cache$1.invalidate();
 			return DIRTY;
 		}
@@ -60234,7 +60356,7 @@ var DataController = class {
 	}
 	addEdge(e) {
 		if (this.cy.getElementById(e.source).empty() || this.cy.getElementById(e.target).empty()) {
-			log$31.warn("edge dropped: missing endpoint", {
+			log$32.warn("edge dropped: missing endpoint", {
 				edgeId: e.id,
 				source: e.source,
 				target: e.target
@@ -60397,7 +60519,7 @@ var DataController = class {
 
 //#endregion
 //#region src/client/renderer/FilterController.ts
-const log$30 = scoped("filter");
+const log$31 = scoped("filter");
 var FilterController = class {
 	cy;
 	fanInCache = null;
@@ -60554,7 +60676,7 @@ var FilterController = class {
 			if (/(\+|\*|\{)\{/.test(pattern)) return null;
 			return new RegExp(pattern);
 		} catch (e) {
-			log$30.warn("invalid regex pattern", e);
+			log$31.warn("invalid regex pattern", e);
 			return null;
 		}
 	}
@@ -60722,7 +60844,7 @@ var Trie = class {
 
 //#endregion
 //#region src/client/renderer/SearchController.ts
-const log$29 = scoped("search");
+const log$30 = scoped("search");
 const BUILD_CHUNK_SIZE = 200;
 const BUILD_CHUNK_DELAY = 16;
 function requestIdleCallbackCompat(cb) {
@@ -60764,7 +60886,7 @@ var SearchController = class {
 				this.trieBuilt = true;
 				this.indexBuilding = false;
 				this.buildHandle = null;
-				log$29.info(`Trie index built: ${entries.length} nodes`);
+				log$30.info(`Trie index built: ${entries.length} nodes`);
 			}
 		};
 		processChunk();
@@ -61535,10 +61657,7 @@ var InteractionController = class InteractionController {
 				this.callbacks.onSelectionToggle?.(id, selected, [...this.multiSelectedIds]);
 				this.callbacks.onNodeTap?.(id);
 			} else {
-				if (this.multiSelectedIds.size > 0) {
-					this.multiSelectedIds.clear();
-					this.cy.nodes().removeClass("multi-selected");
-				}
+				this.clearMultiSelect();
 				this.callbacks.onNodeTap?.(id);
 			}
 			this.focusNodeId = id;
@@ -61589,6 +61708,14 @@ var InteractionController = class InteractionController {
 				y: pos.y
 			});
 		});
+		this.cy.on("boxend", () => {
+			const ids = this.cy.$(":selected").nodes().map((n) => n.id());
+			for (const id of ids) this.multiSelectedIds.add(id);
+			this.cy.nodes().forEach((n) => {
+				if (this.multiSelectedIds.has(n.id())) n.addClass("multi-selected");
+			});
+			this.callbacks.onSelectionToggle?.(ids[0] ?? "", ids.length > 0, [...this.multiSelectedIds]);
+		});
 	}
 	/**
 	* 绑定画布容器上的键盘 / 焦点事件。
@@ -61737,6 +61864,20 @@ var InteractionController = class InteractionController {
 		this.callbacks = callbacks;
 	}
 	/**
+	* 清空多选集合（cycle-149）：集合 + `multi-selected` class + 通知消费方一体完成。
+	*
+	* 两个触发方共用本方法（单一实现，防漂移）：普通点击的静默清空、
+	* 批量操作条「清除」按钮经渲染器 `clearMultiSelect` 的显式清空。
+	* `onSelectionClear` 让 store 镜像同步——缺了它消费方留下幽灵计数
+	* （「画布无高亮但 BatchActionBar 还在」）。
+	*/
+	clearMultiSelect() {
+		if (this.multiSelectedIds.size === 0) return;
+		this.multiSelectedIds.clear();
+		this.cy.nodes().removeClass("multi-selected");
+		this.callbacks.onSelectionClear?.();
+	}
+	/**
 	* 切换节点 / 边标签的可见性（cycle-141 / D）。
 	*
 	* 实现放在本控制器而不是 `StyleController`：标签显隐是**交互态**而非主题态，
@@ -61768,6 +61909,7 @@ var InteractionController = class InteractionController {
 		this.cy.off("mouseover", "edge");
 		this.cy.off("mouseout", "edge");
 		this.cy.off("cxttap", "node");
+		this.cy.off("boxend");
 	}
 };
 
@@ -62265,7 +62407,7 @@ var VirtualViewportController = class {
 
 //#endregion
 //#region src/client/renderer/CytoscapeRenderer.ts
-const log$28 = scoped("cytoscape-renderer");
+const log$29 = scoped("cytoscape-renderer");
 function ensureExtensionsRegistered() {
 	const cy = cytoscape$1;
 	if (!cy.__dagreRegistered) {
@@ -62300,7 +62442,7 @@ var CytoscapeRenderer = class {
 		try {
 			return fn$7();
 		} catch (err) {
-			log$28.error(`${name$1} failed`, err);
+			log$29.error(`${name$1} failed`, err);
 			this.lastError = err instanceof Error ? err : new Error(String(err));
 			return fallback;
 		}
@@ -62309,7 +62451,7 @@ var CytoscapeRenderer = class {
 		try {
 			fn$7();
 		} catch (err) {
-			log$28.error(`${name$1} failed`, err);
+			log$29.error(`${name$1} failed`, err);
 			this.lastError = err instanceof Error ? err : new Error(String(err));
 		}
 	}
@@ -62356,7 +62498,9 @@ var CytoscapeRenderer = class {
 				onNodeHoverOut: this.options.onNodeHoverOut ?? (() => {}),
 				onEdgeHover: this.options.onEdgeHover ?? (() => {}),
 				onEdgeHoverOut: this.options.onEdgeHoverOut ?? (() => {}),
-				...this.options.onNodeContextTap ? { onNodeContextTap: this.options.onNodeContextTap } : {}
+				...this.options.onNodeContextTap ? { onNodeContextTap: this.options.onNodeContextTap } : {},
+				onSelectionToggle: this.options.onSelectionToggle ?? (() => {}),
+				onSelectionClear: this.options.onSelectionClear
 			});
 			this.pathFinder = new PathFinder(cy, this.adjacencyCache);
 			this.virtualViewportCtrl = new VirtualViewportController(cy);
@@ -62435,27 +62579,16 @@ var CytoscapeRenderer = class {
 		this.layoutCtrl?.applyWorkerLayout(positions);
 	}
 	/**
-	
 	* 开启虚拟视口（视口外的节点不渲染）。
-	
 	*
-	
 	* 这里额外往容器上写一个 `data-cg-virtual-scroll` 标记，原因是这个特性在 DOM 上
-	
 	* **完全不可观测**：它只改 cytoscape 内部的 `display` 状态，元素还在、canvas 还在，
-	
 	* 任何「元素可见」类断言在开启与未开启时结果相同。cycle-93 之前 E2E 的 J35
-	
 	* 因此只能断言「容器可见」，零鉴别力。
-	
 	*
-	
 	* 标记沿用本仓库既有的 `data-cg-*` 集成标记约定（`useGraphDerivedValues.ts:71` 的
-	
 	* `data-cg-integration`）。写成「只有真的启用成功才标记」，避免
-	
 	* `virtualViewportCtrl` 为 null 时留下一个骗人的标记。
-	
 	*/
 	enableVirtualScroll() {
 		this.virtualViewportCtrl?.enable();
@@ -62502,17 +62635,11 @@ var CytoscapeRenderer = class {
 		this.viewportCtrl?.focusOnNode(nodeId);
 	}
 	/**
-	
 	* Bring a node the user explicitly asked for (a search hit, a host symbol link) into view even
-	
 	* when it is currently hidden, then centre the viewport on it. Returns `false` when the node is
-	
 	* not in the rendered graph at all, or when it is excluded by an active type/connection filter —
-	
 	* silently panning to an element the filter keeps invisible is what made "search a hidden node"
-	
 	* look like a no-op.
-	
 	*/
 	revealNode(nodeId) {
 		return this.safeCall("revealNode", () => {
@@ -62536,15 +62663,10 @@ var CytoscapeRenderer = class {
 		return el.data("typeFiltered") === true || el.data("connectionFiltered") === true;
 	}
 	/**
-	
 	* Viewport-space position used to anchor the context menu when the user opens it without a
-	
 	* pointer. Cytoscape keeps reporting the last computed position for `display: none` elements,
-	
 	* and the menu clamps itself into the viewport, so only a node that is really absent returns
-	
 	* `null`. Cytoscape 的渲染坐标相对画布容器，这里叠加容器原点换算成视口坐标。
-	
 	*/
 	getNodeRenderedPosition(nodeId) {
 		return this.safeCall("getNodeRenderedPosition", () => {
@@ -62595,6 +62717,10 @@ var CytoscapeRenderer = class {
 	focusNeighborhood(nodeId) {
 		this.safeCallVoid("focusNeighborhood", () => this.viewportCtrl?.focusNeighborhood(nodeId));
 	}
+	/** 清空多选集合（cycle-149）：委托 InteractionController（集合+class+回调一体）。 */
+	clearMultiSelect() {
+		this.safeCallVoid("clearMultiSelect", () => this.interactionCtrl?.clearMultiSelect());
+	}
 	getThumbnail() {
 		return this.viewportCtrl?.getThumbnail() ?? null;
 	}
@@ -62664,7 +62790,7 @@ var CytoscapeRenderer = class {
 			try {
 				fn$7();
 			} catch (err) {
-				log$28.warn(`destroy: ${label} cleanup failed`, err);
+				log$29.warn(`destroy: ${label} cleanup failed`, err);
 			}
 		};
 		safeDestroy("interactionCtrl", () => this.interactionCtrl?.destroy());
@@ -62758,21 +62884,13 @@ var CytoscapeRenderer = class {
 		});
 	}
 	/**
-	
 	* diff 标记的渲染器入口（研究报告 §六 #13）。
-	
 	*
-	
 	* 实现全部委托给 `HighlightController`：它已经持有 `cy` 并且是「视图态 class」的归属地，
-	
 	* 把标记逻辑写两份必然漂移（`markDeadCode` 就是直接写在这里的，代价是它没有复用任何
-	
 	* 控制器设施）。渲染器本身只做 `safeCall` 包裹与「控制器不存在时给空统计」的兜底——
-	
 	* 后者很重要：控制器为 `null` 时若返回 `undefined`，调用方读 `.counts.added` 会抛错，
-	
 	* 而这条路径在「渲染器尚未完成 init」时是真实可达的。
-	
 	*/
 	applyDiffMarkers(index) {
 		const empty = {
@@ -62796,7 +62914,7 @@ var CytoscapeRenderer = class {
 			this.cy.nodes().stop();
 			this.cy.edges().stop();
 		} catch (e) {
-			log$28.warn("pauseAnimations failed", e);
+			log$29.warn("pauseAnimations failed", e);
 		}
 	}
 	resumeAnimations() {
@@ -62804,7 +62922,7 @@ var CytoscapeRenderer = class {
 		try {
 			this.cy.resize();
 		} catch (e) {
-			log$28.warn("resumeAnimations failed", e);
+			log$29.warn("resumeAnimations failed", e);
 		}
 	}
 	/** 缩放画布：factor > 1 放大，factor < 1 缩小。带 200ms 动画过渡。 */
@@ -62843,7 +62961,7 @@ var CytoscapeRenderer = class {
 
 //#endregion
 //#region src/client/hooks/useGraphRenderer.ts
-const log$27 = scoped("renderer-hook");
+const log$28 = scoped("renderer-hook");
 function useGraphRenderer(config) {
 	const { data: data$2, display, interaction, filters, analysis, callbacks, showCallChainRef } = config;
 	const { nodes, edges, rawNodes, repoId } = data$2;
@@ -62885,17 +63003,19 @@ function useGraphRenderer(config) {
 						onNodeHoverOut: () => callbacksRef.current.onNodeHoverOut(),
 						onEdgeTap: (edgeId, pos) => callbacksRef.current.onEdgeTap(edgeId, pos),
 						onEdgeHover: (edgeId, pos) => callbacksRef.current.onEdgeHover(edgeId, pos),
-						onEdgeHoverOut: () => callbacksRef.current.onEdgeHoverOut()
+						onEdgeHoverOut: () => callbacksRef.current.onEdgeHoverOut(),
+						onSelectionToggle: (nodeId, selected, selectedIds) => callbacksRef.current.onSelectionToggle?.(nodeId, selected, selectedIds),
+						onSelectionClear: () => callbacksRef.current.onSelectionClear?.()
 					});
 					renderer$1.init();
 					rendererRef.current = renderer$1;
-					log$27.info("renderer initialized", {
+					log$28.info("renderer initialized", {
 						theme,
 						w,
 						h
 					});
 				} catch (err) {
-					log$27.error("renderer init failed", { err });
+					log$28.error("renderer init failed", { err });
 					renderer$1?.destroy();
 					renderer$1 = null;
 					useGraphStore.getState().setError(err instanceof Error ? err.message : String(err));
@@ -63143,7 +63263,7 @@ function useGraphRenderer(config) {
 			a.download = `codegraph-${Date.now()}.${extension$1}`;
 			a.click();
 			setTimeout(() => URL.revokeObjectURL(url), UI.URL_REVOKE_DELAY_MS);
-			log$27.info(`exported ${format}`);
+			log$28.info(`exported ${format}`);
 		}
 	}, [theme]);
 	const updateTheme = useCallback((newTheme) => {
@@ -63279,7 +63399,7 @@ function useFocusMode(opts) {
 
 //#endregion
 //#region src/client/hooks/useNodeInteraction.ts
-const log$26 = scoped("panel");
+const log$27 = scoped("panel");
 function useNodeInteraction(opts) {
 	const { setSelectedNode, setSelectedNodeData, getDataRef, adjacencyMap, setTooltip, expandedNodeIds, collapseNode, expandNode, handleSelectFunction, setFocusNodeId, handleNodeDoubleTapRef } = opts;
 	const handleNodeTap = useCallback((id) => {
@@ -63288,7 +63408,7 @@ function useNodeInteraction(opts) {
 			const data$2 = getDataRef.current?.getNodeData(id) ?? null;
 			setSelectedNodeData(data$2);
 		} catch (err) {
-			log$26.error("handleNodeTap failed", {
+			log$27.error("handleNodeTap failed", {
 				id,
 				err
 			});
@@ -63320,7 +63440,7 @@ function useNodeInteraction(opts) {
 				});
 			}
 		} catch (err) {
-			log$26.error("handleNodeHover failed", {
+			log$27.error("handleNodeHover failed", {
 				nodeId,
 				err
 			});
@@ -63371,7 +63491,7 @@ function useNodeInteraction(opts) {
 				});
 			}
 		} catch (err) {
-			log$26.error("handleEdgeTap failed", {
+			log$27.error("handleEdgeTap failed", {
 				edgeId,
 				err
 			});
@@ -63398,7 +63518,7 @@ function useNodeInteraction(opts) {
 					return nodeId;
 				});
 			} catch (err) {
-				log$26.error("handleNodeDoubleTap failed", {
+				log$27.error("handleNodeDoubleTap failed", {
 					nodeId,
 					err
 				});
@@ -63764,7 +63884,7 @@ function useDeadCodeMarker({ showDeadCode, deadCodeResult, rendererRef }) {
 
 //#endregion
 //#region src/client/hooks/useDiffComparison.ts
-const log$25 = scoped("diff");
+const log$26 = scoped("diff");
 /**
 
 * 版本对比的编排层（研究报告 §六 #13）。
@@ -63857,7 +63977,7 @@ function useDiffComparison(params) {
 			return next$1;
 		} catch (e) {
 			if (!aliveRef.current || gen !== generationRef.current) return null;
-			log$25.warn("diff comparison failed", e);
+			log$26.warn("diff comparison failed", e);
 			setError(e instanceof Error ? e.message : String(e));
 			setIsComparing(false);
 			return null;
@@ -64364,19 +64484,12 @@ const KEYBOARD_SHORTCUTS = [
 	}
 ];
 /**
-
 * 画布级快捷键（cycle-141 / D）。
-
 *
-
 * 与 `KEYBOARD_SHORTCUTS` 分开声明，**不注册全局监听**：面板级快捷键挂在
-
 * `document` 上、任何焦点下都生效；画布级只在 `.cg-graph-container` 聚焦时由
-
 * `InteractionController` 接管。此处仅作为键盘提示浮层与文档的元数据，
-
 * 避免方向键劫持页面滚动、也避免 `usePanelKeyboard` 的测试长度断言被悄悄改变。
-
 */
 const CANVAS_KEYBOARD_SHORTCUTS = [
 	{
@@ -64414,6 +64527,10 @@ const CANVAS_KEYBOARD_SHORTCUTS = [
 	{
 		key: "F",
 		descKey: "canvasControls.shortcutFit"
+	},
+	{
+		key: "Shift+Drag",
+		descKey: "canvasControls.shortcutBoxSelect"
 	}
 ];
 function formatShortcutKey(s) {
@@ -64477,7 +64594,7 @@ function usePanelKeyboard(layout$2, setLayout, rendererRef, handlers) {
 
 //#endregion
 //#region src/client/hooks/useViewMode.ts
-const log$24 = scoped("viewMode");
+const log$25 = scoped("viewMode");
 const MICRO_MODES = [
 	"cfg",
 	"flowchart",
@@ -64520,7 +64637,7 @@ function useViewMode(viewMode, currentWorkspace, depsFetchAbortRef) {
 				if (controller.signal.aborted) return;
 				if (!data$2.nodes || data$2.nodes.length === 0) return;
 				if (isForeignRepo(data$2.metadata?.repoId, requestedWorkspace)) {
-					log$24.info("dependency graph ignored for another workspace", {
+					log$25.info("dependency graph ignored for another workspace", {
 						repoId: data$2.metadata?.repoId,
 						requestedWorkspace,
 						activeWorkspace: currentWorkspace
@@ -64545,7 +64662,7 @@ function useViewMode(viewMode, currentWorkspace, depsFetchAbortRef) {
 				else setError(t$1("error.loadGraphData"));
 				setLoading(false);
 			}).catch((e) => {
-				log$24.warn("loadBootstrap failed", e);
+				log$25.warn("loadBootstrap failed", e);
 				setError(t$1("error.loadGraph"));
 				setLoading(false);
 			});
@@ -64574,7 +64691,7 @@ function useViewMode(viewMode, currentWorkspace, depsFetchAbortRef) {
 			}).then((data$2) => {
 				if (controller.signal.aborted) return;
 				if (isForeignRepo(data$2.metadata?.repoId, requestedWorkspace)) {
-					log$24.info("macro view graph ignored for another workspace", {
+					log$25.info("macro view graph ignored for another workspace", {
 						repoId: data$2.metadata?.repoId,
 						requestedWorkspace,
 						activeWorkspace: currentWorkspace
@@ -64582,7 +64699,7 @@ function useViewMode(viewMode, currentWorkspace, depsFetchAbortRef) {
 					return;
 				}
 				if (!data$2.nodes || data$2.nodes.length === 0) return;
-				log$24.info("macro view data loaded", {
+				log$25.info("macro view data loaded", {
 					viewMode: newMode,
 					nodes: data$2.nodes.length,
 					edges: data$2.edges?.length ?? 0,
@@ -66629,7 +66746,7 @@ function useWorkspaceCache(opts) {
 
 //#endregion
 //#region src/client/hooks/useSymbolSelectListener.ts
-const log$23 = scoped("symbol-select");
+const log$24 = scoped("symbol-select");
 function useSymbolSelectListener(opts) {
 	useEffect(() => {
 		const symbolHandler = (e) => {
@@ -66641,7 +66758,7 @@ function useSymbolSelectListener(opts) {
 			if (!match$1) return;
 			store.setSelectedNode(NodeId(match$1.id));
 			const revealed = opts.rendererRef.current?.revealNode(match$1.id) ?? false;
-			if (!revealed) log$23.warn("symbol match is not revealable in the rendered graph", {
+			if (!revealed) log$24.warn("symbol match is not revealable in the rendered graph", {
 				id: match$1.id,
 				symbol: sym
 			});
@@ -66737,7 +66854,7 @@ function useMiniMapSync(opts) {
 
 //#endregion
 //#region src/client/hooks/useAutoBootstrap.ts
-const log$22 = scoped("auto-bootstrap");
+const log$23 = scoped("auto-bootstrap");
 function useAutoBootstrap(opts) {
 	const hasAutoScannedRef = useRef(false);
 	useEffect(() => {
@@ -66747,10 +66864,10 @@ function useAutoBootstrap(opts) {
 		if (!opts.codegraphReady) return;
 		if (!opts.currentWorkspace) return;
 		hasAutoScannedRef.current = true;
-		log$22.info("auto-fill: triggering bootstrap on first open", { path: opts.currentWorkspace });
+		log$23.info("auto-fill: triggering bootstrap on first open", { path: opts.currentWorkspace });
 		useGraphStore.getState().loadBootstrap().then((ok) => {
 			if (!ok) {
-				log$22.info("auto-fill: bootstrap failed, falling back to scan", { path: opts.currentWorkspace });
+				log$23.info("auto-fill: bootstrap failed, falling back to scan", { path: opts.currentWorkspace });
 				opts.handleScanWorkspace();
 			}
 		});
@@ -67005,7 +67122,7 @@ function useViewModePanelGuard(opts) {
 
 //#endregion
 //#region src/client/hooks/useSearchInteraction.ts
-const log$21 = scoped("panel");
+const log$22 = scoped("panel");
 function useSearchInteraction(opts) {
 	const { searchQuery, rawNodes, setSelectedNode, setSelectedNodeData, getDataRef, setShowSearch, isRemoteHit } = opts;
 	const debouncedSearch = useDebounce(searchQuery, UI.SEARCH_DEBOUNCE_MS);
@@ -67057,7 +67174,7 @@ function useSearchInteraction(opts) {
 				setShowSearch(false);
 				const hitLabel = mergedResults.find((r) => r.id === id)?.label ?? id;
 				getDataRef.current.revealRemoteNode(id, hitLabel).then((ok) => {
-					if (!ok) log$21.warn("remote search hit could not be revealed", { id });
+					if (!ok) log$22.warn("remote search hit could not be revealed", { id });
 				});
 				return;
 			}
@@ -67065,10 +67182,10 @@ function useSearchInteraction(opts) {
 			const data$2 = getDataRef.current?.getNodeData(NodeId(id)) ?? null;
 			setSelectedNodeData(data$2);
 			const revealed = getDataRef.current?.revealNode(id) ?? false;
-			if (!revealed) log$21.warn("search result is not revealable in the rendered graph", { id });
+			if (!revealed) log$22.warn("search result is not revealable in the rendered graph", { id });
 			setShowSearch(false);
 		} catch (err) {
-			log$21.error("handleSelectSearchResult failed", {
+			log$22.error("handleSelectSearchResult failed", {
 				id,
 				err
 			});
@@ -67090,7 +67207,7 @@ function useSearchInteraction(opts) {
 
 //#endregion
 //#region src/client/components/ErrorBoundary.tsx
-const log$20 = scoped("boundary");
+const log$21 = scoped("boundary");
 function ErrorFallback({ error: error$1, onRetry }) {
 	const t$1 = useT();
 	return /* @__PURE__ */ jsxs("div", {
@@ -67133,7 +67250,7 @@ var GraphErrorBoundary = class extends Component {
 	}
 	componentDidCatch(error$1, errorInfo) {
 		this.props.onError?.(error$1, errorInfo);
-		log$20.error("render error caught by boundary", {
+		log$21.error("render error caught by boundary", {
 			error: error$1,
 			componentStack: errorInfo.componentStack
 		});
@@ -69146,6 +69263,10 @@ const ContextMenu = memo(function ContextMenu$1(props) {
 	const menuRef = useRef(null);
 	const [focusedIndex, setFocusedIndex] = useState(0);
 	const triggerRef = useRef(null);
+	const isPinned = useGraphStore((s) => s.pinnedIds.has(props.nodeId));
+	const pinNode = useGraphStore((s) => s.pinNode);
+	const unpinNode = useGraphStore((s) => s.unpinNode);
+	const [copyState, setCopyState] = useState("idle");
 	const onCloseRef = useRef(props.onClose);
 	onCloseRef.current = props.onClose;
 	const handleClose = useCallback(() => {
@@ -69304,6 +69425,43 @@ const ContextMenu = memo(function ContextMenu$1(props) {
 			handleClose();
 		}
 	});
+	actions.push({
+		id: "pinNode",
+		label: t$1(isPinned ? "contextMenu.unpinNode" : "contextMenu.pinNode"),
+		onClick: () => {
+			if (isPinned) unpinNode(props.nodeId);
+			else pinNode(props.nodeId);
+			handleClose();
+		}
+	});
+	actions.push({
+		id: "copyId",
+		label: copyState === "copied" ? t$1("contextMenu.copied") : t$1("contextMenu.copyId"),
+		onClick: () => {
+			try {
+				navigator.clipboard?.writeText(props.nodeId);
+				setCopyState("copied");
+				window.setTimeout(() => setCopyState("idle"), 1500);
+			} catch {}
+		}
+	});
+	actions.push({
+		id: "expandHere",
+		label: t$1("contextMenu.expandHere"),
+		onClick: () => {
+			props.onExpandNode(props.nodeId);
+			handleClose();
+		},
+		separatorAfter: true
+	});
+	actions.push({
+		id: "collapseHere",
+		label: t$1("contextMenu.collapseHere"),
+		onClick: () => {
+			props.onCollapseNode(props.nodeId);
+			handleClose();
+		}
+	});
 	const menuStyle = {
 		position: "fixed",
 		left: `${props.position.x}px`,
@@ -69317,6 +69475,7 @@ const ContextMenu = memo(function ContextMenu$1(props) {
 		children: actions.map((action) => /* @__PURE__ */ jsxs(React.Fragment, { children: [/* @__PURE__ */ jsxs("button", {
 			className: "cg-context-menu-item",
 			role: "menuitem",
+			"data-action-id": action.id,
 			disabled: action.disabled,
 			onClick: action.onClick,
 			children: [action.icon && /* @__PURE__ */ jsx("span", {
@@ -69331,6 +69490,87 @@ const ContextMenu = memo(function ContextMenu$1(props) {
 	}) });
 });
 
+//#endregion
+//#region src/client/components/BatchActionBar.tsx
+const log$20 = scoped("batch-bar");
+function BatchActionBar({ onClearSelection }) {
+	const t$1 = useT();
+	const multiSelectedIds = useGraphStore((s) => s.multiSelectedIds);
+	const batchExpandSelected = useGraphStore((s) => s.batchExpandSelected);
+	const batchCollapseSelected = useGraphStore((s) => s.batchCollapseSelected);
+	const exportSelectedNodes = useGraphStore((s) => s.exportSelectedNodes);
+	const clearMultiSelection = useGraphStore((s) => s.clearMultiSelection);
+	if (multiSelectedIds.size === 0) return null;
+	const handleClear = () => {
+		if (onClearSelection) onClearSelection();
+		else clearMultiSelection();
+	};
+	const handleExport = () => {
+		try {
+			const nodes = exportSelectedNodes();
+			const payload = {
+				exportedAt: new Date().toISOString(),
+				selectedCount: multiSelectedIds.size,
+				exportedCount: nodes.length,
+				nodes
+			};
+			const blob = new Blob([JSON.stringify(payload, null, 2)], { type: "application/json" });
+			const url = URL.createObjectURL(blob);
+			const a = document.createElement("a");
+			a.href = url;
+			a.download = `codegraph-selection-${Date.now()}.json`;
+			a.click();
+			URL.revokeObjectURL(url);
+		} catch (err) {
+			log$20.error("export selection failed", { err });
+		}
+	};
+	return /* @__PURE__ */ jsxs("div", {
+		className: "cg-batch-bar",
+		role: "toolbar",
+		"aria-label": t$1("batchbar.ariaLabel"),
+		children: [
+			/* @__PURE__ */ jsx("span", {
+				className: "cg-batch-bar-count",
+				"aria-live": "polite",
+				children: t$1("batchbar.count", { count: multiSelectedIds.size })
+			}),
+			/* @__PURE__ */ jsx("button", {
+				type: "button",
+				className: "cg-batch-bar-btn",
+				onClick: () => {
+					batchExpandSelected();
+				},
+				"aria-label": t$1("batchbar.expandAria"),
+				children: t$1("batchbar.expand")
+			}),
+			/* @__PURE__ */ jsx("button", {
+				type: "button",
+				className: "cg-batch-bar-btn",
+				onClick: () => {
+					batchCollapseSelected();
+				},
+				"aria-label": t$1("batchbar.collapseAria"),
+				children: t$1("batchbar.collapse")
+			}),
+			/* @__PURE__ */ jsx("button", {
+				type: "button",
+				className: "cg-batch-bar-btn",
+				onClick: handleExport,
+				"aria-label": t$1("batchbar.exportAria"),
+				children: t$1("batchbar.export")
+			}),
+			/* @__PURE__ */ jsx("button", {
+				type: "button",
+				className: "cg-batch-bar-btn cg-batch-bar-btn-clear",
+				onClick: handleClear,
+				"aria-label": t$1("batchbar.clearAria"),
+				children: t$1("batchbar.clear")
+			})
+		]
+	});
+}
+
 //#endregion
 //#region src/client/components/LoadingOverlay.tsx
 const LoadingOverlay = memo(function LoadingOverlay$1({ visible }) {
@@ -69728,7 +69968,7 @@ const StatusBar = memo(function StatusBar$1({ error: error$1, isLoading, lastUpd
 	const statusText = error$1 ? t$1("state.error") : isLoading ? t$1("state.loading") : t$1("state.ready");
 	const wsName = workspaceName ? deriveWorkspaceName(workspaceName) : "";
 	const hasDegradations = performanceDegradations && performanceDegradations.length > 0;
-	const degradationLabels = hasDegradations ? performanceDegradations.map((key) => DEGRADATION_KEYS[key] ? t$1(DEGRADATION_KEYS[key]) : key).join(", ") : "";
+	const degradationLabels = hasDegradations && performanceDegradations ? performanceDegradations.map((key) => DEGRADATION_KEYS[key] ? t$1(DEGRADATION_KEYS[key]) : key).join(", ") : "";
 	const degradedRules = xuanjiSignal?.degradedRules ?? [];
 	const violatedRules = xuanjiSignal?.invariantViolations ?? [];
 	const showXuanji = xuanjiSignal?.applied === true;
@@ -77174,8 +77414,8 @@ function InteractiveMiniMap({ thumbnail, viewportInfo, onFocusArea, nodePosition
 					whiteSpace: "nowrap",
 					background: "var(--cg-bg-elevated)",
 					color: "var(--cg-text)",
-					border: "1px solid var(--cg-border-strong))",
-					boxShadow: "var(--cg-shadow-sm))",
+					border: "1px solid var(--cg-border-strong)",
+					boxShadow: "var(--cg-shadow-sm)",
 					pointerEvents: "none"
 				},
 				children: t$1("canvasControls.minimapFocusHint")
@@ -77206,8 +77446,8 @@ function KeyboardHintOverlay({ onClose }) {
 			padding: "10px 12px",
 			borderRadius: "var(--cg-radius-sm)",
 			background: "var(--cg-surface)",
-			border: "1px solid var(--cg-border-strong))",
-			boxShadow: "var(--cg-shadow))",
+			border: "1px solid var(--cg-border-strong)",
+			boxShadow: "var(--cg-shadow)",
 			pointerEvents: "auto"
 		},
 		children: [/* @__PURE__ */ jsxs("div", {
@@ -77721,7 +77961,9 @@ function GraphPanelInner({ className = "", sessionId, useSessions }) {
 			onNodeContextTap: (nodeId, pos) => setContextMenu({
 				nodeId,
 				position: pos
-			})
+			}),
+			onSelectionToggle: (_nodeId, _selected, selectedIds) => useGraphStore.getState().syncMultiSelection(selectedIds),
+			onSelectionClear: () => useGraphStore.getState().clearMultiSelection()
 		},
 		showCallChainRef
 	});
@@ -78334,6 +78576,7 @@ function GraphPanelInner({ className = "", sessionId, useSessions }) {
 				}
 			}),
 			tooltip && /* @__PURE__ */ jsx(GraphTooltip, { data: tooltip }),
+			/* @__PURE__ */ jsx(BatchActionBar, { onClearSelection: () => renderer$1.rendererRef.current?.clearMultiSelect() }),
 			/* @__PURE__ */ jsx(KeyboardHelp, {
 				visible: showHelp,
 				onClose: () => setShowHelp(false)
@@ -78364,7 +78607,7 @@ function GraphPanel(props) {
 
 //#endregion
 //#region src/generated/version.ts
-const PLUGIN_VERSION = "0.3.0";
+const PLUGIN_VERSION = "0.3.1";
 
 //#endregion
 //#region src/client/utils/safeCheck.ts