@rexvane/piweb 0.3.24 → 0.3.26

package/src/components/composer/ComposerFiles.tsx

@@ -0,0 +1,224 @@
+"use client";
+
+/**
+ * 输入卡里上传的文件列表（多文件牌堆与竖直向上弧度展开）：
+ * - 不超过 COLLAPSE_AT 个：平铺文件 chip。
+ * - 超过时折叠成牌堆：第一张在最上，后面露 4 层边，显示「展开 N」；
+ * - 点「展开」沿竖直向上呈优美弧度扇开，每张都可以单独删除或悬停预览，
+ *   点击「收起」平滑收回牌堆；与图片牌堆/扇形拥有一致的动效与交互质感。
+ */
+import { useEffect, useRef, useState } from "react";
+import { IconFileOutline16 } from "@/components/icons";
+import { useI18n } from "@/i18n";
+import { fmtBytes } from "@/lib/format";
+
+export const COLLAPSE_AT = 4;
+const FILE_CARD_W = 196;
+const FILE_CARD_H = 32;
+const DECK_PEEK = 4;
+const DECK_LAYERS = 4;
+const FAN_SIDE = 6;
+
+export interface FileCardPose {
+	x: number;
+	y: number;
+	angle: number;
+	hidden?: boolean;
+}
+
+interface FileLayout {
+	cards: FileCardPose[];
+	width: number;
+	height: number;
+	gap: number;
+}
+
+const round = (value: number) => Math.round(value * 10) / 10;
+const fmtUploadSize = (bytes?: number) => (bytes ? fmtBytes(bytes) : "");
+
+export function fileDeckLayout(count: number): FileLayout {
+	const cards = Array.from({ length: count }, (_, i) => ({
+		x: Math.min(i, DECK_LAYERS) * DECK_PEEK,
+		y: 0,
+		angle: 0,
+		hidden: i >= DECK_LAYERS,
+	}));
+	return {
+		cards,
+		width: FILE_CARD_W + Math.min(Math.max(count - 1, 0), DECK_LAYERS) * DECK_PEEK,
+		height: FILE_CARD_H,
+		gap: DECK_PEEK,
+	};
+}
+
+export function fileFanLayout(count: number, width: number): FileLayout {
+	if (count <= 1) {
+		return { cards: [{ x: FAN_SIDE, y: 0, angle: 0 }], width: FILE_CARD_W + FAN_SIDE * 2, height: FILE_CARD_H, gap: 0 };
+	}
+	// 垂直每张抬升步长：自适应压窄，保证上方不顶出视口
+	const stepY = Math.min(32, Math.max(16, 220 / (count - 1)));
+	const spanY = (count - 1) * stepY;
+	const totalH = FILE_CARD_H + spanY + 14;
+	const cards = Array.from({ length: count }, (_, i) => {
+		const progress = i / (count - 1);
+		// y 轴：第 0 张在底部，最后一张在最上方
+		const y = round((totalH - FILE_CARD_H - 6) - i * stepY);
+		// x 轴：向上升起时呈优雅的弧度向右轻微弯出
+		const arcX = 18 * Math.sin(progress * Math.PI);
+		const x = round(FAN_SIDE + arcX + progress * 10);
+		// 角度：从下方的 -3° 顺滑过渡到上方的 +5°
+		const angle = round(-3 + progress * 8);
+		return { x, y, angle };
+	});
+	const maxX = Math.max(...cards.map((c) => c.x)) + FILE_CARD_W + FAN_SIDE;
+	return {
+		cards,
+		width: Math.min(width, Math.max(FILE_CARD_W + 32, Math.ceil(maxX))),
+		height: Math.ceil(totalH),
+		gap: round(stepY),
+	};
+}
+
+export interface UploadFileItem {
+	name: string;
+	path: string;
+	size?: number;
+}
+
+export function ComposerFiles({
+	files,
+	disabled,
+	onRemove,
+	onClear,
+}: {
+	files: UploadFileItem[];
+	disabled?: boolean;
+	onRemove: (index: number) => void;
+	onClear?: () => void;
+}) {
+	const { t } = useI18n();
+	const collapsible = files.length > COLLAPSE_AT;
+	const [expanded, setExpanded] = useState(false);
+	const fanned = collapsible && expanded;
+	const [lifted, setLifted] = useState<number | null>(null);
+	const railRef = useRef<HTMLDivElement>(null);
+	const [railWidth, setRailWidth] = useState(360);
+
+	useEffect(() => {
+		const rail = railRef.current;
+		if (!rail || !collapsible) return;
+		const measure = () => setRailWidth(Math.max(280, rail.clientWidth - 8));
+		measure();
+		if (typeof ResizeObserver === "undefined") return;
+		const observer = new ResizeObserver(measure);
+		observer.observe(rail);
+		return () => observer.disconnect();
+	}, [collapsible]);
+
+	const layout = fanned ? fileFanLayout(files.length, railWidth) : fileDeckLayout(files.length);
+
+	const renderFileCard = (f: UploadFileItem, i: number, pose?: FileCardPose, isDeck = false) => {
+		const up = fanned && lifted === i;
+		const delay = Math.min(fanned ? i * 14 : (files.length - 1 - i) * 10, 140);
+		const isHidden = !fanned && isDeck && i >= DECK_LAYERS;
+		if (isHidden) return null;
+
+		return (
+			<div
+				key={`${f.path}:${i}`}
+				className="pw-ref-chip group/ref pw-file-card"
+				title={f.path}
+				data-lifted={up || undefined}
+				style={
+					pose
+						? {
+								position: "absolute",
+								left: 0,
+								top: 0,
+								width: FILE_CARD_W,
+								height: FILE_CARD_H,
+								zIndex: up ? files.length + 2 : fanned ? i + 1 : files.length - i,
+								transform: `translate(${pose.x}px, ${pose.y - (up ? 4 : 0)}px) rotate(${pose.angle}deg) ${up ? "scale(1.04)" : ""}`,
+								transitionDelay: up || lifted !== null ? "0ms" : `${delay}ms`,
+						  }
+						: undefined
+				}
+				onMouseEnter={() => fanned && setLifted(i)}
+				onMouseLeave={() => setLifted((cur) => (cur === i ? null : cur))}
+				onFocus={() => fanned && setLifted(i)}
+				onBlur={(e) => {
+					if (!e.currentTarget.contains(e.relatedTarget as Node | null)) setLifted((cur) => (cur === i ? null : cur));
+				}}
+			>
+				<IconFileOutline16 size={12} style={{ flex: "none", color: "var(--dsw-label-tertiary)" }} />
+				<span className="max-w-[110px] truncate font-mono text-[12px]">{f.name}</span>
+				<span style={{ flex: "none", fontSize: 10.5, color: "var(--dsw-label-caption)" }}>{fmtUploadSize(f.size)}</span>
+				<button
+					type="button"
+					className="pw-ref-close"
+					disabled={disabled}
+					onClick={(e) => {
+						e.stopPropagation();
+						onRemove(i);
+						setLifted(null);
+					}}
+					aria-label={`${t.delete} ${f.name}`}
+				>
+					✕
+				</button>
+			</div>
+		);
+	};
+
+	return (
+		<div ref={railRef} className="pointer-events-auto flex flex-wrap items-end gap-2 px-1 pb-1" data-testid="composer-uploads">
+			{collapsible ? (
+				<div
+					className="pw-file-fan-container relative flex items-center gap-2"
+					style={{
+						position: "relative",
+						width: fanned ? layout.width : layout.width + 8,
+						height: layout.height,
+						transition: "width 320ms cubic-bezier(0.2, 0.8, 0.2, 1), height 320ms cubic-bezier(0.2, 0.8, 0.2, 1)",
+					}}
+				>
+					{files.map((f, i) => renderFileCard(f, i, layout.cards[i], true))}
+				</div>
+			) : (
+				files.map((f, i) => renderFileCard(f, i))
+			)}
+
+			<div className="flex items-center gap-1.5 self-end pb-0.5">
+				{collapsible && (
+					<button
+						type="button"
+						className="pw-deck-action-btn"
+						data-testid="uploads-toggle"
+						aria-expanded={expanded}
+						onClick={() => {
+							setExpanded((open) => !open);
+							setLifted(null);
+						}}
+					>
+						{expanded ? t.chipCollapse : t.chipExpandMore.replace("{n}", String(files.length - COLLAPSE_AT))}
+					</button>
+				)}
+
+				{files.length > 1 && onClear && (
+					<button
+						type="button"
+						className="pw-deck-action-btn pw-deck-action-clear"
+						data-testid="uploads-clear"
+						disabled={disabled}
+						onClick={() => {
+							onClear();
+							setLifted(null);
+						}}
+					>
+						{t.filesClearAll}
+					</button>
+				)}
+			</div>
+		</div>
+	);
+}

package/src/components/composer/ComposerImages.tsx

@@ -14,6 +14,7 @@
  */
 import { useEffect, useRef, useState } from "react";
 import { createPortal } from "react-dom";
+import { ImageViewer } from "@/components/ImageViewer";
 import { useI18n } from "@/i18n";
 import type { ImageAttachment } from "@/lib/types";
 
@@ -61,27 +62,35 @@ export function deckLayout(count: number): Layout {
 }
 
 /**
- * 扇形：卡片中心落在一段圆弧上（中间最高、两侧顺着弧下垂），每张转到切线方向；
- * 间距按可用宽度均分、不超过 FAN_GAP_MAX，从左边开始铺（离牌堆原来的位置最近）。
+ * 扇形：沿竖直向上逐级延伸呈弧度展开（与多文件完全同一套竖直向上延展体验）。
+ * 卡片从底部逐级向上攀升，每张卡片竖直排布并沿轻微弧线微幅偏转，悬停上浮高亮。
  */
 export function fanLayout(count: number, width: number): Layout {
-	const gap = count > 1 ? Math.min(FAN_GAP_MAX, Math.max(8, (width - CARD - FAN_SIDE * 2) / (count - 1))) : 0;
-	const step = gap / FAN_RADIUS;
-	const mid = (count - 1) / 2;
-	const edge = -mid * step;
-	// 正方形转过 θ 后比原来高出（也宽出）的那一截，最外侧两张最大
-	const corner = (CARD / 2) * (Math.abs(Math.sin(edge)) + Math.cos(edge) - 1);
-	const top = FAN_LIFT + corner;
+	if (count <= 1) {
+		return { cards: [{ x: FAN_SIDE, y: 0, angle: 0 }], width: CARD + FAN_SIDE * 2, height: CARD, gap: 0 };
+	}
+	// 竖直向上延伸：每张卡片向上抬升 stepY
+	const stepY = Math.min(36, Math.max(16, 210 / (count - 1)));
+	const spanY = (count - 1) * stepY;
+	const totalH = CARD + spanY + 14;
 	const cards = Array.from({ length: count }, (_, i) => {
-		const theta = (i - mid) * step;
-		return {
-			x: round(FAN_SIDE + FAN_RADIUS * (Math.sin(theta) - Math.sin(edge))),
-			y: round(top + FAN_RADIUS * (1 - Math.cos(theta))),
-			angle: round((theta * 180) / Math.PI),
-		};
+		const progress = i / (count - 1);
+		// y 轴：Card 0 在底部，Card count-1 在最上方（竖直向上延伸）
+		const y = round((totalH - CARD - 6) - i * stepY);
+		// x 轴：向上延伸的同时呈柔和弧线向右微弯再回收（优雅的 C 弧）
+		const arcX = 22 * Math.sin(progress * Math.PI);
+		const x = round(FAN_SIDE + arcX + progress * 8);
+		// 角度：从下方的 -4° 顺滑过渡到上方的 +6°
+		const angle = round(-4 + progress * 10);
+		return { x, y, angle };
 	});
-	const span = cards.length ? cards[cards.length - 1].x + CARD + FAN_SIDE : 0;
-	return { cards, width: Math.ceil(span), height: Math.ceil(top + FAN_RADIUS * (1 - Math.cos(edge)) + CARD + corner), gap: round(gap) };
+	const maxX = Math.max(...cards.map((c) => c.x)) + CARD + FAN_SIDE;
+	return {
+		cards,
+		width: Math.min(width, Math.max(CARD + 32, Math.ceil(maxX))),
+		height: Math.ceil(totalH),
+		gap: round(stepY),
+	};
 }
 
 /** 每张图一个稳定的 key：前几位 base64 对同格式的图几乎都一样（PNG 都是 iVBORw0KGgo…），不能拿来当 key */
@@ -140,7 +149,7 @@ export function ComposerImages({ images, disabled, onRemove, onClear }: { images
 
 	return (
 		<>
-			<div ref={railRef} className="pointer-events-auto flex flex-wrap items-center gap-2 px-1" data-testid="composer-images">
+			<div ref={railRef} className="pointer-events-auto flex flex-wrap items-end gap-2 px-1 pb-1" data-testid="composer-images">
 				{collapsible ? (
 					<div
 						className="pw-image-fan"
@@ -169,7 +178,7 @@ export function ComposerImages({ images, disabled, onRemove, onClear }: { images
 									data-lifted={up || undefined}
 									style={{
 										zIndex: up ? images.length + 1 : images.length - i,
-										transform: `translate(${pose.x}px, ${pose.y - (up ? FAN_LIFT : 0)}px) rotate(${pose.angle}deg)`,
+										transform: `translate(${pose.x}px, ${pose.y - (up ? FAN_LIFT : 0)}px) rotate(${pose.angle}deg) ${up ? "scale(1.05)" : ""}`,
 										transitionDelay: up || lifted !== null ? "0ms" : `${delay}ms`,
 									}}
 									onMouseEnter={() => fanned && setLifted(i)}
@@ -206,35 +215,37 @@ export function ComposerImages({ images, disabled, onRemove, onClear }: { images
 						</div>
 					))
 				)}
-				{images.length > 1 && onClear ? (
-					<button
-						type="button"
-						className="pw-chip"
-						data-testid="images-clear"
-						disabled={disabled}
-						onClick={() => {
-							onClear();
-							setLifted(null);
-							setPreview(null);
-						}}
-					>
-						{t.imageClearAll}
-					</button>
-				) : null}
-				{collapsible ? (
-					<button
-						type="button"
-						className="pw-chip"
-						data-testid="images-toggle"
-						aria-expanded={fanned}
-						onClick={() => {
-							setExpanded((open) => !open);
-							setLifted(null);
-						}}
-					>
-						{fanned ? t.chipCollapse : t.chipExpandMore.replace("{n}", String(images.length - 1))}
-					</button>
-				) : null}
+				<div className="flex items-center gap-1.5 self-end pb-0.5">
+					{collapsible ? (
+						<button
+							type="button"
+							className="pw-deck-action-btn"
+							data-testid="images-toggle"
+							aria-expanded={fanned}
+							onClick={() => {
+								setExpanded((open) => !open);
+								setLifted(null);
+							}}
+						>
+							{fanned ? t.chipCollapse : t.chipExpandMore.replace("{n}", String(images.length - 1))}
+						</button>
+					) : null}
+					{images.length > 1 && onClear ? (
+						<button
+							type="button"
+							className="pw-deck-action-btn pw-deck-action-clear"
+							data-testid="images-clear"
+							disabled={disabled}
+							onClick={() => {
+								onClear();
+								setLifted(null);
+								setPreview(null);
+							}}
+						>
+							{t.imageClearAll}
+						</button>
+					) : null}
+				</div>
 			</div>
 			{shown !== null
 				? createPortal(
@@ -245,82 +256,3 @@ export function ComposerImages({ images, disabled, onRemove, onClear }: { images
 		</>
 	);
 }
-
-/** 放大预览：手机上没法用本机程序打开图片，应用内看最实在 */
-function ImageViewer({
-	images,
-	index,
-	disabled,
-	onIndex,
-	onRemove,
-	onClose,
-}: {
-	images: ImageAttachment[];
-	index: number;
-	disabled?: boolean;
-	onIndex: (index: number) => void;
-	onRemove: (index: number) => void;
-	onClose: () => void;
-}) {
-	const { t } = useI18n();
-	const dialogRef = useRef<HTMLDivElement>(null);
-	const closeRef = useRef<HTMLButtonElement>(null);
-	const count = images.length;
-	const go = (delta: number) => onIndex((index + delta + count) % count);
-
-	// 打开时把焦点移进来，关掉时还给原来那个元素（还在页面上的话）
-	useEffect(() => {
-		const opener = document.activeElement instanceof HTMLElement ? document.activeElement : null;
-		closeRef.current?.focus();
-		return () => {
-			if (opener?.isConnected) opener.focus();
-		};
-	}, []);
-
-	// 捕获阶段处理：Esc / 方向键不再传给页面上其它监听 document 的面板；Tab 只在预览里转
-	useEffect(() => {
-		const onKey = (event: KeyboardEvent) => {
-			if (event.key === "Escape") onClose();
-			else if (event.key === "ArrowLeft" && count > 1) go(-1);
-			else if (event.key === "ArrowRight" && count > 1) go(1);
-			else if (event.key === "Tab") {
-				const focusable = [...(dialogRef.current?.querySelectorAll<HTMLElement>("button:not(:disabled)") ?? [])];
-				if (!focusable.length) return;
-				const at = focusable.indexOf(document.activeElement as HTMLElement);
-				const next = event.shiftKey ? (at <= 0 ? focusable.length - 1 : at - 1) : at === focusable.length - 1 ? 0 : at + 1;
-				focusable[next].focus();
-			} else return;
-			event.preventDefault();
-			event.stopPropagation();
-		};
-		document.addEventListener("keydown", onKey, true);
-		return () => document.removeEventListener("keydown", onKey, true);
-		// onClose / onIndex 来自父组件的 setState 包装，语义不变；只随张数和当前张重绑
-		// eslint-disable-next-line react-hooks/exhaustive-deps
-	}, [count, index]);
-
-	return (
-		<div ref={dialogRef} className="pw-lightbox" role="dialog" aria-modal="true" aria-label={t.imageViewer} onClick={onClose}>
-			<div className="pw-lightbox-bar" onClick={(event) => event.stopPropagation()}>
-				<span className="pw-lightbox-count">{count > 1 ? `${index + 1} / ${count}` : ""}</span>
-				<button type="button" className="pw-lightbox-btn" disabled={disabled} onClick={() => onRemove(index)}>
-					{t.delete}
-				</button>
-				<button ref={closeRef} type="button" className="pw-lightbox-btn" aria-label={t.close} onClick={onClose}>
-					✕
-				</button>
-			</div>
-			<img src={srcOf(images[index])} alt="" className="pw-lightbox-image" onClick={(event) => event.stopPropagation()} />
-			{count > 1 ? (
-				<>
-					<button type="button" className="pw-lightbox-nav" data-side="prev" aria-label={t.imagePrev} onClick={(event) => { event.stopPropagation(); go(-1); }}>
-						‹
-					</button>
-					<button type="button" className="pw-lightbox-nav" data-side="next" aria-label={t.imageNext} onClick={(event) => { event.stopPropagation(); go(1); }}>
-						›
-					</button>
-				</>
-			) : null}
-		</div>
-	);
-}

package/src/hooks/usePiWeb.ts

@@ -44,6 +44,17 @@ export interface ExtensionDialog {
 	ts: number;
 }
 
+/** 右下角的短通知：扩展 notify，或 PiWeb 自己的提示（带 code，渲染时按语言取文案） */
+export interface PiWebNotice {
+	id: string;
+	message: string;
+	type: "info" | "warning" | "error";
+	ts: number;
+	/** external_reload：终端写了这个会话，已从磁盘重载；external_write：正在跑时终端也在写 */
+	code?: "external_reload" | "external_write";
+	count?: number;
+}
+
 export interface PiWebState {
 	snapshot: WebSnapshot | null;
 	messages: WebMessage[];
@@ -57,7 +68,7 @@ export interface PiWebState {
 	/** 扩展对话框队列（按到达顺序，一次显示一个） */
 	extensionDialogs: ExtensionDialog[];
 	/** 扩展通知（notify），显示几秒后消失 */
-	extensionNotices: { id: string; message: string; type: "info" | "warning" | "error"; ts: number }[];
+	extensionNotices: PiWebNotice[];
 	/** 扩展设的页脚状态文本（setStatus） */
 	extensionStatuses: Record<string, string>;
 	/** 扩展覆盖的「工作中」文案（setWorkingMessage） */
@@ -176,6 +187,17 @@ export const foldPiWebEvent = (state: PiWebState, evt: WebEvent): PiWebState =>
 			return s;
 		case "compaction":
 			s.compaction = { phase: evt.phase, errorMessage: evt.errorMessage, ts: evt.ts };
+			if (evt.marker) {
+				// 已显示的消息全部保留；分隔卡插到保留下来的第一条前面，和刷新后的快照位置一致
+				const marker = evt.marker;
+				const msgs = s.messages.filter((message) => !(marker.id && message.id === marker.id));
+				const at = msgs.findIndex((message) =>
+					(!!evt.beforeId && message.id === evt.beforeId) ||
+					(!!evt.beforeStreamId && message.streamId === evt.beforeStreamId));
+				if (at >= 0) msgs.splice(at, 0, marker);
+				else msgs.push(marker);
+				s.messages = msgs;
+			}
 			return s;
 		case "traj": {
 			if (s.snapshot) {
@@ -236,6 +258,12 @@ export const foldPiWebEvent = (state: PiWebState, evt: WebEvent): PiWebState =>
 		case "extension_ui_resolved":
 			s.extensionDialogs = s.extensionDialogs.filter((dialog) => dialog.id !== evt.id);
 			return s;
+		case "external_write":
+			s.extensionNotices = [
+				...s.extensionNotices.filter((notice) => notice.code !== "external_write").slice(-4),
+				{ id: `external-write-${evt.ts}`, message: "", type: "warning", ts: evt.ts, code: "external_write", count: evt.entries },
+			];
+			return s;
 		case "status":
 			if (s.snapshot) s.snapshot = { ...s.snapshot, isStreaming: evt.isStreaming };
 			if (!evt.isStreaming) {
@@ -366,6 +394,7 @@ export function usePiWeb() {
 	const [snapshotEpoch, setSnapshotEpoch] = useState(0);
 	const esRef = useRef<{ close(): void } | null>(null);
 	const promptRequestsRef = useRef(new Set<string>());
+	const shownReloadsRef = useRef(new Set<string>());
 	const presetRestoreAttemptRef = useRef<string | null>(null);
 	const presetRestorePromiseRef = useRef<Promise<void> | null>(null);
 	const activeSessionRef = useRef(currentId);
@@ -689,6 +718,14 @@ export function usePiWeb() {
 			: { ...emptyState(savedToolPreset()), connected: false });
 		let retryDelayMs = 2000;
 		const eventsUrl = `/api/agent/${currentId}/events`;
+		// 同一次重载既有 external_reload 事件、又会出现在随后若干快照里：按重载时间只提示一次
+		const reloadNotice = (reload?: { entries: number; at: number }): PiWebNotice | null => {
+			if (!reload) return null;
+			const key = `${currentId}:${reload.at}`;
+			if (shownReloadsRef.current.has(key)) return null;
+			shownReloadsRef.current.add(key);
+			return { id: `external-reload-${reload.at}`, message: "", type: "info", ts: Date.now(), code: "external_reload", count: reload.entries };
+		};
 		const connect = () => {
 			// 流式事件按帧合并：token 速率再高也只每 16ms 渲染一次（见 event-batcher）
 			const batcher = createEventBatcher<WebEvent>({
@@ -707,11 +744,19 @@ export function usePiWeb() {
 					// 单帧损坏（代理截断等）只丢弃该帧，不能让 EventSource 回调抛异常
 					return;
 				}
+				if (parsed.type === "external_reload") {
+					// 服务端发现终端写过这个会话、已从磁盘重载，旧流随即关闭：不等 EventSource 2 秒后自己重连，马上换新连接拿快照
+					const notice = reloadNotice(parsed);
+					if (notice) setState((s) => ({ ...s, extensionNotices: [...s.extensionNotices.slice(-4), notice] }));
+					setResyncNonce((n) => n + 1);
+					return;
+				}
 				if (parsed.type === "snapshot" && parsed.snapshot) {
 					// 快照是权威状态：之前缓冲的增量已经过时，直接丢弃
 					batcher.cancel();
 					retryDelayMs = 2000;
 					const snap = parsed.snapshot as WebSnapshot;
+					const notice = reloadNotice(snap.externalReload);
 					setSnapshotEpoch((epoch) => epoch + 1);
 					setState((prev) => ({
 						snapshot: snap,
@@ -724,7 +769,7 @@ export function usePiWeb() {
 						retryNotice: null,
 						// 服务器当前 pending 集合是权威来源，刷新可恢复、已答请求不能复活。
 						extensionDialogs: extensionDialogsFromSnapshot(snap, prev.extensionDialogs),
-						extensionNotices: prev.extensionNotices,
+						extensionNotices: notice ? [...prev.extensionNotices.slice(-4), notice] : prev.extensionNotices,
 						extensionStatuses: snap.extensionStatuses ?? {},
 						workingMessage: null,
 						// 重连的快照不带生长账本；连接期间已收到的步保留，useGrowth 会按 seq 与拉取结果去重