@rexvane/piweb 0.3.21 → 0.3.22

package/src/components/composer/ComposerImages.tsx

@@ -0,0 +1,306 @@
+"use client";
+
+/**
+ * 输入卡里待发送的图片。
+ * - 不超过 COLLAPSE_AT 张：平铺缩略图（不裁切），右上角删除。
+ * - 更多时折叠成牌堆：正面那张在最上，后面最多露 4 层 4px 的右边缘；点「展开 N」沿一条向上拱的弧线扇开。
+ *   两种状态是同一批卡片换 transform，所以有从牌堆扇开 / 收拢的动画；扇形按容器实测宽度铺开。
+ *   层级始终是左压右（和牌堆同一个顺序，展开时不会闪一下换层），每张露出来的是右侧那条，
+ *   删除按钮就在那条的右上角——不用悬停也点得到，触屏同样能删；张数多、条带窄到按钮会挤成一排时，
+ *   只在悬停 / 聚焦的那张上显示（触屏点开预览里删）。悬停 / 聚焦的那张抬起来、整张露出。
+ *   牌堆里后面几张只露空白的卡边（不露图），看起来是一叠；扇开时图再淡入。
+ * - 点任意一张进预览：大图、← → 切换、删除当前张（删完自动看下一张）；Esc / 点背景 / 关闭按钮退出，焦点回到原处。
+ *   预览挂到 body 上（祖先的 backdrop-filter 会让 fixed 只盖住输入卡），按键在捕获阶段拦下，不会再关掉页面上的其它面板。
+ */
+import { useEffect, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+import { useI18n } from "@/i18n";
+import type { ImageAttachment } from "@/lib/types";
+
+/** 超过这个数量就折叠（引用 chip 用同一个阈值） */
+export const COLLAPSE_AT = 4;
+/** 牌堆 / 扇形里卡片的边长 */
+const CARD = 96;
+/** 牌堆里后面每层露出的右边缘、最多露几层（再多的叠在最后一层下面、不显示） */
+const DECK_PEEK = 4;
+const DECK_LAYERS = 4;
+/** 扇形所在圆弧的半径（越大弧越平）、相邻两张中心的最大间距（再大就散成一排，不像一手牌了） */
+const FAN_RADIUS = 520;
+const FAN_GAP_MAX = 76;
+/** 悬停 / 聚焦时那张往上抬多少；左右给旋转后探出去的角留的余量 */
+const FAN_LIFT = 12;
+const FAN_SIDE = 8;
+/** 量不到宽度时（首帧、测试环境）按这个宽度排扇形 */
+const FALLBACK_WIDTH = 360;
+
+export interface CardPose {
+	x: number;
+	y: number;
+	angle: number;
+	/** 牌堆里压在最后一层下面、看不见的 */
+	hidden?: boolean;
+}
+
+interface Layout {
+	cards: CardPose[];
+	width: number;
+	height: number;
+	/** 相邻两张露出来的宽度；太窄时删除按钮会挤成一排，只在悬停 / 聚焦那张上显示 */
+	gap: number;
+}
+
+/** 露出的条带至少这么宽，每张的删除按钮才常驻（按钮 22px + 一点间隔） */
+const ROOMY_GAP = 30;
+
+const round = (value: number) => Math.round(value * 10) / 10;
+
+/** 牌堆：只做横向错位，最多露 DECK_LAYERS 层 */
+export function deckLayout(count: number): Layout {
+	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: CARD + Math.min(Math.max(count - 1, 0), DECK_LAYERS) * DECK_PEEK, height: CARD, gap: DECK_PEEK };
+}
+
+/**
+ * 扇形：卡片中心落在一段圆弧上（中间最高、两侧顺着弧下垂），每张转到切线方向；
+ * 间距按可用宽度均分、不超过 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;
+	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 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) };
+}
+
+/** 每张图一个稳定的 key：前几位 base64 对同格式的图几乎都一样（PNG 都是 iVBORw0KGgo…），不能拿来当 key */
+const imageKeys = new WeakMap<ImageAttachment, string>();
+let nextImageKey = 0;
+function keyOf(image: ImageAttachment): string {
+	let key = imageKeys.get(image);
+	if (!key) {
+		nextImageKey += 1;
+		key = `image-${nextImageKey}`;
+		imageKeys.set(image, key);
+	}
+	return key;
+}
+
+const srcOf = (image: ImageAttachment) => `data:${image.mimeType};base64,${image.data}`;
+
+export function ComposerImages({ images, disabled, onRemove }: { images: ImageAttachment[]; disabled?: boolean; onRemove: (index: number) => void }) {
+	const { t } = useI18n();
+	const collapsible = images.length > COLLAPSE_AT;
+	const [expanded, setExpanded] = useState(false);
+	const fanned = collapsible && expanded;
+	/** 扇形里悬停 / 聚焦的那张：抬起来、放到最上层 */
+	const [lifted, setLifted] = useState<number | null>(null);
+	const [preview, setPreview] = useState<number | null>(null);
+	const railRef = useRef<HTMLDivElement>(null);
+	const [railWidth, setRailWidth] = useState(0);
+
+	useEffect(() => {
+		const rail = railRef.current;
+		if (!rail || !collapsible) return;
+		// 量的是整条附件轨的内容宽度（去掉左右 4px 内边距）：扇形展开后占满这一行
+		const measure = () => setRailWidth(Math.max(0, rail.clientWidth - 8));
+		measure();
+		if (typeof ResizeObserver === "undefined") return;
+		const observer = new ResizeObserver(measure);
+		observer.observe(rail);
+		return () => observer.disconnect();
+	}, [collapsible]);
+
+	const remove = (index: number) => {
+		onRemove(index);
+		setLifted(null);
+		// 预览里删的：还有图就接着看下一张（删的是最后一张就看前一张）
+		setPreview((current) => (current === null ? null : images.length <= 1 ? null : Math.min(current, images.length - 2)));
+	};
+
+	const deleteButton = (index: number) => (
+		<button type="button" className="pw-image-delete" disabled={disabled} aria-label={`${t.delete} ${index + 1}`} onClick={() => remove(index)}>
+			✕
+		</button>
+	);
+
+	const layout = fanned ? fanLayout(images.length, railWidth || FALLBACK_WIDTH) : deckLayout(images.length);
+	const shown = preview !== null && images[preview] ? preview : null;
+
+	return (
+		<>
+			<div ref={railRef} className="mb-2 flex flex-wrap items-center gap-2 px-1" data-testid="composer-images">
+				{collapsible ? (
+					<div
+						className="pw-image-fan"
+						data-testid="image-fan"
+						data-expanded={fanned}
+						data-crowded={fanned && layout.gap < ROOMY_GAP ? true : undefined}
+						style={{ width: fanned ? "100%" : layout.width, height: layout.height }}
+					>
+						{images.map((image, i) => {
+							const pose = layout.cards[i];
+							const up = fanned && lifted === i;
+							// 牌堆里只有正面那张能点、能删；后面那几张只是露个边，不进 Tab 顺序
+							const reachable = fanned || i === 0;
+							// 展开从左往右依次扇出，收起反过来；错开的总时长封顶，张数多也不拖沓
+							const delay = Math.min(fanned ? i * 14 : (images.length - 1 - i) * 10, 140);
+							return (
+								<div
+									key={keyOf(image)}
+									className="pw-image-card"
+									data-hidden={pose.hidden || undefined}
+									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)`,
+										transitionDelay: up || lifted !== null ? "0ms" : `${delay}ms`,
+									}}
+									onMouseEnter={() => fanned && setLifted(i)}
+									onMouseLeave={() => setLifted((current) => (current === i ? null : current))}
+									onFocus={() => fanned && setLifted(i)}
+									onBlur={(event) => {
+										// 焦点从图片挪到同一张的删除按钮不算离开
+										if (!event.currentTarget.contains(event.relatedTarget as Node | null)) setLifted((current) => (current === i ? null : current));
+									}}
+								>
+									<button
+										type="button"
+										className="pw-image-face"
+										tabIndex={reachable ? undefined : -1}
+										aria-hidden={reachable ? undefined : true}
+										title={t.imagePreview}
+										aria-label={t.imagePreview}
+										onClick={() => setPreview(i)}
+									>
+										<img src={srcOf(image)} alt="" className="h-full w-full object-contain" draggable={false} />
+									</button>
+									{reachable ? deleteButton(i) : null}
+								</div>
+							);
+						})}
+					</div>
+				) : (
+					images.map((image, i) => (
+						<div key={keyOf(image)} className="pw-image-thumb">
+							<button type="button" className="block" title={t.imagePreview} aria-label={t.imagePreview} onClick={() => setPreview(i)}>
+								<img src={srcOf(image)} alt="" className="max-h-24 max-w-32 rounded-[10px] object-contain" draggable={false} />
+							</button>
+							{deleteButton(i)}
+						</div>
+					))
+				)}
+				{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>
+			{shown !== null
+				? createPortal(
+					<ImageViewer images={images} index={shown} disabled={disabled} onIndex={setPreview} onRemove={remove} onClose={() => setPreview(null)} />,
+					document.body,
+				)
+				: null}
+		</>
+	);
+}
+
+/** 放大预览：手机上没法用本机程序打开图片，应用内看最实在 */
+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-viewer" role="dialog" aria-modal="true" aria-label={t.imageViewer} onClick={onClose}>
+			<div className="pw-viewer-bar" onClick={(event) => event.stopPropagation()}>
+				<span className="pw-viewer-count">{count > 1 ? `${index + 1} / ${count}` : ""}</span>
+				<button type="button" className="pw-viewer-btn" disabled={disabled} onClick={() => onRemove(index)}>
+					{t.delete}
+				</button>
+				<button ref={closeRef} type="button" className="pw-viewer-btn" aria-label={t.close} onClick={onClose}>
+					✕
+				</button>
+			</div>
+			<img src={srcOf(images[index])} alt="" className="pw-viewer-image" onClick={(event) => event.stopPropagation()} />
+			{count > 1 ? (
+				<>
+					<button type="button" className="pw-viewer-nav" data-side="prev" aria-label={t.imagePrev} onClick={(event) => { event.stopPropagation(); go(-1); }}>
+						‹
+					</button>
+					<button type="button" className="pw-viewer-nav" data-side="next" aria-label={t.imageNext} onClick={(event) => { event.stopPropagation(); go(1); }}>
+						›
+					</button>
+				</>
+			) : null}
+		</div>
+	);
+}

package/src/hooks/useGrowth.ts

@@ -39,6 +39,8 @@ export interface GrowthApi {
 	range: { from: string; to: string } | null;
 	/** 所选范围的变更 */
 	changes: GrowthChange[];
+	/** 当前范围的完整 diff 已读取；加载或失败时不能将 [] 当成零改动。 */
+	changesReady?: boolean;
 	tree: TreeNode;
 	/** 所选轮的全部文件路径（快速打开用） */
 	filePaths: string[];
@@ -618,6 +620,7 @@ export function useGrowth({
 		scope,
 		range,
 		changes,
+		changesReady: inlineChanges !== null || Boolean(range && rangeChanges?.key === `${key}|${range.from}..${range.to}` && !rangeChanges.error),
 		tree,
 		filePaths,
 		expanded,

package/src/hooks/usePiWeb.ts

@@ -76,6 +76,10 @@ export const foldPiWebEvent = (state: PiWebState, evt: WebEvent): PiWebState =>
 	const s = { ...state };
 	switch (evt.type) {
 		case "delta": {
+			// 又开始出 token 了：不管有没有收到重试结束事件，重试行都收掉。
+			// 只靠 retry_end 不够——SDK 换了事件名、某条路径没发结束事件、旧服务端压根不发，
+			// 界面就会挂着「重试 1/5」而模型其实早在正常输出了（用户已反馈两次）。
+			s.retryNotice = null;
 			// 新服务端按稳定流 ID 定位；旧协议仍按最近 pending 消息兼容。
 			const msgs = [...s.messages];
 			// 从尾部找：增量几乎总是落在最后一条消息上，长会话里从头扫每个 token 都是一次全表遍历
@@ -251,11 +255,17 @@ export const foldPiWebEvent = (state: PiWebState, evt: WebEvent): PiWebState =>
 			s.growth = { ...s.growth, consent: evt.request };
 			return s;
 		case "retry":
-			// 只保留最后一次尝试：重试过程在界面上是「重试 3/5」这一条，而不是五行报错
+			// 只保留最后一次尝试:重试过程在界面上是「重试 3/5」这一条,而不是五行报错
 			s.retryNotice = evt.maxAttempts
 				? `重试 ${evt.attempt}/${evt.maxAttempts}${evt.message ? `：${evt.message}` : ""}`
 				: `重试 ${evt.attempt}${evt.message ? `：${evt.message}` : ""}`;
 			return s;
+		case "retry_end":
+			// 重试区间结束(SDK auto_retry_end):立刻收掉重试行。
+			// 重试常发生在下一轮 agent 开始之前,而那段间隙不会发 status:isStreaming=false,
+			// 所以不能只等 agent_settled —— 否则用户会一直看到「重试 1/5 terminated」。
+			s.retryNotice = null;
+			return s;
 		case "error":
 			// 旧服务端把自动重试塞在 error 里：同样按通知处理，不占错误条
 			if (/^(自动重试|重试)/.test(evt.message)) s.retryNotice = evt.message;
@@ -809,7 +819,7 @@ export function usePiWeb() {
 				const id = idOf(p);
 				// 工具预设取通用设置的持久化选择；模型/思考级别由 Hero 页显式下发
 				const setup: Record<string, unknown>[] = [{ cmd: "setToolPreset", preset: savedToolPreset() }];
-				if (overrides.provider && overrides.modelId) setup.push({ cmd: "setModel", provider: overrides.provider, modelId: overrides.modelId });
+				if (overrides.provider && overrides.modelId) setup.push({ cmd: "setModel", provider: overrides.provider, modelId: overrides.modelId, fresh: true });
 				if (overrides.thinking) setup.push({ cmd: "setThinkingLevel", level: overrides.thinking });
 				for (const command of setup) {
 					const configured = await sendCommand(command, id);

package/src/hooks/useWorkspaceFiles.ts

@@ -0,0 +1,93 @@
+"use client";
+
+/**
+ * @ 引用的候选文件：打开候选菜单时拉一次全量清单，之后每个字符都在本地匹配。
+ * 按工作区缓存（含 in-flight 去重），过期后**先用手上的旧清单渲染、再后台刷新**——
+ * 打字过程中绝不能因为一次刷新把候选列表清空。
+ */
+import { useEffect, useRef, useState } from "react";
+import { buildCandidates, dirsOfPaths, type PathCandidate } from "@/lib/workspace-index";
+
+export interface WorkspaceFiles {
+	status: "idle" | "loading" | "ready" | "error";
+	candidates: PathCandidate[];
+	source: "git" | "disk" | null;
+	truncated: boolean;
+	error: string | null;
+}
+
+/** 清单多久算过期：agent 刚写出来的新文件也要能被引用到，所以不能一直用内存里那份 */
+const TTL_MS = 30_000;
+
+interface CachedIndex {
+	at: number;
+	candidates: PathCandidate[];
+	source: "git" | "disk";
+	truncated: boolean;
+}
+
+const cache = new Map<string, CachedIndex>();
+const inflight = new Map<string, Promise<CachedIndex>>();
+
+async function fetchIndex(cwd: string): Promise<CachedIndex> {
+	const response = await fetch(`/api/files?index=1&cwd=${encodeURIComponent(cwd)}`, { cache: "no-store" });
+	const payload = await response.json();
+	if (!response.ok || !payload.success) throw new Error(payload.error || `request failed (${response.status})`);
+	const data = payload.data as { files: string[]; source: "git" | "disk"; truncated: boolean };
+	const entry: CachedIndex = {
+		at: Date.now(),
+		candidates: buildCandidates(data.files, dirsOfPaths(data.files)),
+		source: data.source,
+		truncated: data.truncated,
+	};
+	cache.set(cwd, entry);
+	return entry;
+}
+
+/**
+ * 同一工作区并发只发一次请求；失败不进缓存（下次打开会重试）。
+ * 共享的请求不挂任何一方的 AbortSignal：先打开的输入框关了（中止），后来的还在等同一个结果，
+ * 不能让它跟着收到 AbortError。各方用完就不理结果，请求本身让它跑完、顺手填进缓存。
+ */
+function loadIndex(cwd: string): Promise<CachedIndex> {
+	const running = inflight.get(cwd);
+	if (running) return running;
+	const promise = fetchIndex(cwd).finally(() => inflight.delete(cwd));
+	inflight.set(cwd, promise);
+	return promise;
+}
+
+export function useWorkspaceFiles(cwd: string, enabled: boolean): WorkspaceFiles {
+	const [state, setState] = useState<WorkspaceFiles>({ status: "idle", candidates: [], source: null, truncated: false, error: null });
+	const scope = useRef<{ cwd: string; controller: AbortController }>({ cwd: "", controller: new AbortController() });
+
+	useEffect(() => {
+		if (!enabled || !cwd) return;
+		const controller = new AbortController();
+		scope.current = { cwd, controller };
+		const isCurrent = () => scope.current.controller === controller && !controller.signal.aborted;
+
+		const cached = cache.get(cwd);
+		if (cached) {
+			// 有旧清单就先显示（旧的总比空白好），过期只在后台补
+			setState({ status: "ready", candidates: cached.candidates, source: cached.source, truncated: cached.truncated, error: null });
+			if (Date.now() - cached.at < TTL_MS) return () => controller.abort();
+		} else {
+			setState({ status: "loading", candidates: [], source: null, truncated: false, error: null });
+		}
+
+		void loadIndex(cwd).then(
+			(entry) => {
+				if (isCurrent()) setState({ status: "ready", candidates: entry.candidates, source: entry.source, truncated: entry.truncated, error: null });
+			},
+			(error: unknown) => {
+				// 有旧清单时忽略这次失败：刷新失败不该把可用候选变成错误页
+				if (!isCurrent() || cache.has(cwd)) return;
+				setState({ status: "error", candidates: [], source: null, truncated: false, error: error instanceof Error ? error.message : String(error) });
+			},
+		);
+		return () => controller.abort();
+	}, [cwd, enabled]);
+
+	return state;
+}

package/src/i18n.tsx

@@ -38,13 +38,37 @@ const zh = {
 	capacityFields: "容量",
 	contextWindowLabel: "上下文窗口",
 	maxTokensLabel: "最大输出",
-	capacityHint: "留空用默认 · 支持 256K / 2M 写法",
+	capacityHint: "留空按 pi 缺省（128K / 16K）· 支持 256K / 2M 写法",
+	// 模型能力（视觉）与配置体检
+	visionLabel: "视觉",
+	visionHint: "该模型能否接收图片。未声明时 pi 按纯文本处理：你贴的截图会被换成一行占位文字（提示语还会说成「模型不支持图像」）",
+	visionUnset: "未声明",
+	visionOn: "有视觉",
+	visionOff: "纯文本",
+	imagePreview: "点击放大预览",
+	imageViewer: "图片预览",
+	imagePrev: "上一张",
+	imageNext: "下一张",
+	chipExpandMore: "展开 {n}",
+	chipCollapse: "收起",
+	modelAuditTitle: "{n} 个模型没写能力字段",
+	modelAuditDesc: "没写的字段，pi 会按上下文 {ctx}、输出上限 {out}、纯文本处理。端点没报的值不会替你猜：照模型的真实规格填上（支持 256K / 1M 写法），保存时只补空着的格子，已写的值不改。",
+	modelAuditColModel: "模型",
+	modelAuditColContext: "上下文",
+	modelAuditColOutput: "输出上限",
+	modelAuditColVision: "视觉",
+	modelAuditVisionQuick: "视觉一起设：",
+	modelAuditVisionOn: "都有视觉",
+	modelAuditVisionOff: "都是纯文本",
+	modelAuditSave: "保存 {n} 个模型",
+	modelAuditSaveIdle: "填好后保存",
 	capacityInvalid: "第 {n} 行：容量需为数字（可用 K/M）",
 	discoverEmpty: "远端没有返回可识别的模型",
 	candidateTitle: "发现 {count} 个模型，勾选要添加的",
 	candidateAll: "全选",
 	candidatePicked: "已选 {n} 个",
 	candidateAdopt: "添加 {n} 个",
+	candidateInCatalog: "已在目录中",
 	runningTool: "Running {name}…",
 	thinkingLive: "Thinking",
 	stepRunning: "Running",
@@ -127,6 +151,10 @@ const zh = {
 	gitNoChanges: "工作区干净，没有变更",
 	gitStatusUnknown: "Git 状态读取失败，无法确认是否有变更",
 	gitRecentCommits: "最近提交",
+	gitStagingArea: "暂存区",
+	gitWorkingTree: "工作区",
+	gitGithubAccount: "GitHub 账号",
+	gitGithubUnknown: "未识别到 GitHub 账号",
 	toolNoOutput: "无输出",
 	toolFailed: "失败",
 	thinkingClamped: "当前模型不支持「{requested}」，已改为「{level}」",
@@ -285,6 +313,11 @@ const zh = {
 	extensionStatus: "扩展状态",
 	contextUsed: "上下文已用",
 	contextUnknown: "上下文用量未知",
+	contextEstimated: "上下文估算",
+	contextApiInput: "最近请求输入（API）",
+	contextCharacterBreakdown: "内容分类（字符数）",
+	contextCharacterHint: "按当前文本统计，图片不计。API 未提供分类 token 用量。",
+	contextChars: "字符",
 	contextSystem: "系统提示词",
 	contextMessages: "对话消息",
 	contextTools: "工具",
@@ -326,6 +359,20 @@ const zh = {
 	contextColdHint: "会话还没启动，System Prompt 和工具定义要启动后才算得出",
 	contextCountNow: "现在统计",
 	contextCounting: "统计中…",
+	contextWindowEdit: "修改",
+	contextWindowBuiltin: "pi 内置目录：{value}",
+	contextWindowUseBuiltin: "填入",
+	contextWindowScope: "改的是这个模型的全局配置（models.json），pi 终端和其它会话一起生效",
+	contextWindowOverBuiltin: "比内置目录大：超过模型实际上限时，请求会被上游拒绝（400）",
+	contextWindowNoBuiltin: "填模型实际支持的上限；填大了，请求会被上游拒绝（400）",
+	contextWindowInvalid: "填正整数，可带 K / M（如 200K）",
+	// @ 文件引用（输入 @ 弹候选）
+	mentionFiles: "@ 引用文件 / 文件夹",
+	mentionHint: "↑↓ 选择 · Enter 引用 · Esc 关闭",
+	mentionNoMatch: "没有匹配的文件",
+	mentionTruncated: "候选已截断",
+	mentionDiskSource: "目录遍历",
+	mentionDiskSourceHint: "当前工作区不是 git 仓库（或没装 git）：候选来自目录遍历，会跳过 node_modules、构建产物等目录；列为 git 仓库后候选会自动按 .gitignore 过滤",
 	// 统计条
 	turns: "轮次",
 	toolCalls: "工具调用",
@@ -334,6 +381,8 @@ const zh = {
 	cacheHits: "缓存命中",
 	statsCounts: "{turns} 轮 · {steps} 步",
 	ttftAverage: "首 token 平均",
+	statsMeasuredSteps: "实时测量 {n} 步",
+	statsTimedCoverage: "{n}/{total} 条有计时",
 	inputTokens: "输入",
 	outputTokens: "输出",
 	// 视图
@@ -507,10 +556,14 @@ const zh = {
 	allowPrivateDiscovery: "允许本机/私网",
 	allowPrivateHint: "模型地址指向本机或私有网络（如 Ollama、LM Studio、one-api 本地网关）时勾选，本次探测放行；发消息不受此限制",
 	discoveringModels: "获取中...",
+	autoDiscovering: "正在自动识别模型…",
+	autoDiscovered: "已自动识别 {n} 个模型（端点报了容量与视觉的已一并填好）",
+	autoDiscoverFailed: "自动识别失败，可点「获取可用模型」重试",
 	usingDefaultModels: "正在使用 Pi SDK 默认模型 · {count} 个",
 	customModelsRequired: "至少添加一个可发送的模型 ID",
 	modelCatalogEmptyBuiltin: "未添加覆盖模型；模型选择器会继续实时使用 Pi SDK 的官方模型目录。",
 	modelCatalogEmptyCustom: "模型选择器中将不显示任何模型；请至少添加一个模型 ID。",
+	catalogOverrideHint: "与内置目录同 ID 的行只覆盖填写的字段，推理、价格、思考档位等沿用内置值。",
 	addModel: "添加模型",
 	modelId: "模型 ID",
 	createProvider: "创建提供方",
@@ -723,13 +776,37 @@ const en: Dict = {
 	capacityFields: "Capacities",
 	contextWindowLabel: "Context window",
 	maxTokensLabel: "Max output",
-	capacityHint: "blank = default · 256K / 2M accepted",
+	capacityHint: "blank = pi default (128K / 16K) · 256K / 2M accepted",
+	// model capability (vision) and config checkup
+	visionLabel: "Vision",
+	visionHint: "Whether this model accepts images. Left unset, pi treats it as text-only and replaces pasted screenshots with a placeholder line.",
+	visionUnset: "Not declared",
+	visionOn: "Vision",
+	visionOff: "Text only",
+	imagePreview: "Click to preview",
+	imageViewer: "Image preview",
+	imagePrev: "Previous image",
+	imageNext: "Next image",
+	chipExpandMore: "Show {n} more",
+	chipCollapse: "Collapse",
+	modelAuditTitle: "{n} models don't declare their capabilities",
+	modelAuditDesc: "For fields left out, pi assumes a {ctx} context window, {out} max output and text-only input. Values the endpoint didn't report are never guessed: fill in the model's real limits (256K / 1M accepted). Saving only fills empty cells and never changes values already set.",
+	modelAuditColModel: "Model",
+	modelAuditColContext: "Context",
+	modelAuditColOutput: "Max output",
+	modelAuditColVision: "Vision",
+	modelAuditVisionQuick: "Set vision for all:",
+	modelAuditVisionOn: "All vision",
+	modelAuditVisionOff: "All text only",
+	modelAuditSave: "Save {n} models",
+	modelAuditSaveIdle: "Fill in, then save",
 	capacityInvalid: "Row {n}: capacity must be a number (K/M ok)",
 	discoverEmpty: "No recognizable models returned",
 	candidateTitle: "Found {count} models — pick ones to add",
 	candidateAll: "Select all",
 	candidatePicked: "{n} selected",
 	candidateAdopt: "Add {n}",
+	candidateInCatalog: "Already in catalog",
 	runningTool: "Running {name}…",
 	thinkingLive: "Thinking",
 	stepRunning: "Running",
@@ -812,6 +889,10 @@ const en: Dict = {
 	gitNoChanges: "Working tree clean",
 	gitStatusUnknown: "Git status unavailable; changes could not be determined",
 	gitRecentCommits: "Recent commits",
+	gitStagingArea: "Staging area",
+	gitWorkingTree: "Working tree",
+	gitGithubAccount: "GitHub account",
+	gitGithubUnknown: "No GitHub account detected",
 	toolNoOutput: "no output",
 	toolFailed: "failed",
 	thinkingClamped: "This model does not support \"{requested}\"; using \"{level}\" instead",
@@ -968,6 +1049,11 @@ const en: Dict = {
 	extensionStatus: "Extension status",
 	contextUsed: "context used",
 	contextUnknown: "Context usage unknown",
+	contextEstimated: "estimated context usage",
+	contextApiInput: "Last request input (API)",
+	contextCharacterBreakdown: "Content breakdown (characters)",
+	contextCharacterHint: "Counts current text; excludes images. The API does not report tokens by category.",
+	contextChars: "chars",
 	contextSystem: "System prompt",
 	contextMessages: "Messages",
 	contextTools: "Tools",
@@ -1009,6 +1095,20 @@ const en: Dict = {
 	contextColdHint: "Session not started yet — System Prompt and tool definitions are counted once it starts",
 	contextCountNow: "Count now",
 	contextCounting: "Counting…",
+	contextWindowEdit: "Edit",
+	contextWindowBuiltin: "pi built-in catalog: {value}",
+	contextWindowUseBuiltin: "Use",
+	contextWindowScope: "Changes this model's global config (models.json); the pi terminal and other sessions use it too",
+	contextWindowOverBuiltin: "Larger than the built-in catalog: requests past the model's real limit are rejected upstream (400)",
+	contextWindowNoBuiltin: "Enter the model's real limit; a larger value gets requests rejected upstream (400)",
+	contextWindowInvalid: "Enter a positive integer; K / M allowed (e.g. 200K)",
+	// @ file references (type @ to open the picker)
+	mentionFiles: "@ reference files / folders",
+	mentionHint: "↑↓ select · Enter reference · Esc close",
+	mentionNoMatch: "No matching files",
+	mentionTruncated: "list truncated",
+	mentionDiskSource: "directory scan",
+	mentionDiskSourceHint: "This workspace is not a git repository (or git is missing): candidates come from a directory scan that skips node_modules and build output; in a git repository they follow .gitignore automatically",
 	turns: "turns",
 	toolCalls: "tool calls",
 	cost: "cost",
@@ -1016,6 +1116,8 @@ const en: Dict = {
 	cacheHits: "cache hits",
 	statsCounts: "{turns} turns · {steps} steps",
 	ttftAverage: "TTFT avg",
+	statsMeasuredSteps: "{n} steps measured live",
+	statsTimedCoverage: "{n}/{total} entries timed",
 	inputTokens: "Input",
 	outputTokens: "Output",
 	tabChat: "Chat",
@@ -1185,10 +1287,14 @@ const en: Dict = {
 	allowPrivateDiscovery: "Allow local/private",
 	allowPrivateHint: "Check this when the model address points to loopback or a private network (Ollama, LM Studio, one-api gateways) to allow this probe; chat requests are not affected",
 	discoveringModels: "Fetching...",
+	autoDiscovering: "Detecting models…",
+	autoDiscovered: "Detected {n} models (capacity and vision filled in where the endpoint reports them)",
+	autoDiscoverFailed: "Automatic detection failed — use the button to retry",
 	usingDefaultModels: "Using Pi SDK default models · {count}",
 	customModelsRequired: "Add at least one model ID that can be sent",
 	modelCatalogEmptyBuiltin: "No model overrides. The model selector will continue using Pi SDK's live official catalog.",
 	modelCatalogEmptyCustom: "No models will appear in the selector. Add at least one model ID.",
+	catalogOverrideHint: "Rows matching a built-in model ID only override the fields you fill in; reasoning, pricing and thinking levels stay built-in.",
 	addModel: "Add model",
 	modelId: "Model ID",
 	createProvider: "Create provider",