@rexvane/piweb 0.3.20 → 0.3.22

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

@@ -4,6 +4,7 @@
  * 中央状态：会话列表轮询、当前会话 SSE 订阅、事件折叠（快照→增量）、命令发送。
  */
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { pollEventStream, usesEventPolling } from "@/lib/chat/event-stream";
 import { createEventBatcher, type EventBatcher } from "@/lib/event-batcher";
 import type {
 	GrowthConsentRequest,
@@ -75,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 都是一次全表遍历
@@ -194,6 +199,9 @@ export const foldPiWebEvent = (state: PiWebState, evt: WebEvent): PiWebState =>
 				tools: { active: evt.active, all: evt.all.map((n) => ({ name: n })) },
 			};
 			return s;
+		case "context_breakdown":
+			if (s.snapshot) s.snapshot = { ...s.snapshot, contextBreakdown: evt.breakdown };
+			return s;
 		case "resources":
 			if (s.snapshot) {
 				s.snapshot = {
@@ -247,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;
@@ -350,7 +364,7 @@ export function usePiWeb() {
 	const [orderBy, setOrderByState] = useState<"updated" | "manual">("updated");
 	const [resyncNonce, setResyncNonce] = useState(0);
 	const [snapshotEpoch, setSnapshotEpoch] = useState(0);
-	const esRef = useRef<EventSource | null>(null);
+	const esRef = useRef<{ close(): void } | null>(null);
 	const promptRequestsRef = useRef(new Set<string>());
 	const presetRestoreAttemptRef = useRef<string | null>(null);
 	const presetRestorePromiseRef = useRef<Promise<void> | null>(null);
@@ -674,38 +688,21 @@ export function usePiWeb() {
 			? { ...current, connected: false }
 			: { ...emptyState(savedToolPreset()), connected: false });
 		let retryDelayMs = 2000;
+		const eventsUrl = `/api/agent/${currentId}/events`;
 		const connect = () => {
-			const es = new EventSource(`/api/agent/${currentId}/events`);
-			esRef.current = es;
-			es.onopen = () => {
-				retryDelayMs = 2000;
-				setState((s) => ({ ...s, connected: true }));
-			};
-			es.onerror = () => {
-				setState((s) => ({ ...s, connected: false }));
-				if (esRef.current !== es) return;
-				// 网络断开时浏览器自己会重连，并带上 Last-Event-ID 让服务端从环形缓冲续放
-				// （只补漏掉的几条事件）。这时手动重建就等于丢掉续传、每次都拉一份全量快照。
-				if (es.readyState !== EventSource.CLOSED) return;
-				// 浏览器对非 200 响应会永久放弃自动重连：这里手动兜底，关掉后延迟重建，
-				// 重建时会拿到全新快照。
-				es.close();
-				esRef.current = null;
-				const delay = retryDelayMs;
-				retryDelayMs = Math.min(retryDelayMs * 2, 30_000);
-				retryTimer = setTimeout(() => {
-					if (esRef.current === null) connect();
-				}, delay);
-			};
 			// 流式事件按帧合并：token 速率再高也只每 16ms 渲染一次（见 event-batcher）
 			const batcher = createEventBatcher<WebEvent>({
 				flush: (events) => setState((s) => events.reduce((acc, evt) => foldPiWebEvent(acc, evt), s)),
 			});
 			batcherRef.current = batcher;
-			es.onmessage = (e) => {
+			const onOpen = () => {
+				retryDelayMs = 2000;
+				setState((s) => ({ ...s, connected: true }));
+			};
+			const onMessage = (data: string) => {
 				let parsed: any;
 				try {
-					parsed = JSON.parse(e.data);
+					parsed = JSON.parse(data);
 				} catch {
 					// 单帧损坏（代理截断等）只丢弃该帧，不能让 EventSource 回调抛异常
 					return;
@@ -737,6 +734,36 @@ export function usePiWeb() {
 					batcher.push(parsed as WebEvent);
 				}
 			};
+			// Cloudflare 快速隧道不支持 SSE（流被攒成 128KB 一块，快照永远收不全）：改用长轮询，
+			// 失败退避、Last-Event-ID 续传都在 pollEventStream 里
+			if (usesEventPolling(window.location.hostname)) {
+				esRef.current = pollEventStream(eventsUrl, {
+					onOpen,
+					onMessage,
+					onError: () => setState((s) => ({ ...s, connected: false })),
+				});
+				return;
+			}
+			const es = new EventSource(eventsUrl);
+			esRef.current = es;
+			es.onopen = onOpen;
+			es.onerror = () => {
+				setState((s) => ({ ...s, connected: false }));
+				if (esRef.current !== es) return;
+				// 网络断开时浏览器自己会重连，并带上 Last-Event-ID 让服务端从环形缓冲续放
+				// （只补漏掉的几条事件）。这时手动重建就等于丢掉续传、每次都拉一份全量快照。
+				if (es.readyState !== EventSource.CLOSED) return;
+				// 浏览器对非 200 响应会永久放弃自动重连：这里手动兜底，关掉后延迟重建，
+				// 重建时会拿到全新快照。
+				es.close();
+				esRef.current = null;
+				const delay = retryDelayMs;
+				retryDelayMs = Math.min(retryDelayMs * 2, 30_000);
+				retryTimer = setTimeout(() => {
+					if (esRef.current === null) connect();
+				}, delay);
+			};
+			es.onmessage = (e) => onMessage(e.data);
 		};
 		let retryTimer: ReturnType<typeof setTimeout> | undefined;
 		connect();
@@ -792,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: "工具",
@@ -323,6 +356,23 @@ const zh = {
 	contextCompacted: "Compacted Data",
 	contextAutoCompactBuffer: "Auto-Compact Buffer",
 	contextFreeSpace: "Free Space",
+	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: "工具调用",
@@ -331,6 +381,8 @@ const zh = {
 	cacheHits: "缓存命中",
 	statsCounts: "{turns} 轮 · {steps} 步",
 	ttftAverage: "首 token 平均",
+	statsMeasuredSteps: "实时测量 {n} 步",
+	statsTimedCoverage: "{n}/{total} 条有计时",
 	inputTokens: "输入",
 	outputTokens: "输出",
 	// 视图
@@ -504,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: "创建提供方",
@@ -532,9 +588,9 @@ const zh = {
 	trustAlways: "总是信任",
 	trustNever: "从不信任",
 	versionPiweb: "PiWeb 版本",
-	versionPiwebDesc: "本 Web 应用的版本，点击打开仓库",
+	versionPiwebDesc: "本 Web 应用的版本；启动时自动检查，有新版本在这里直接更新（点版本号打开仓库）",
 	versionPi: "Pi 版本",
-	versionPiDesc: "pi 智能体内核的版本，点击打开仓库",
+	versionPiDesc: "pi 智能体内核的版本；启动时自动检查，有新版本在这里直接更新（点版本号打开仓库）",
 	checkUpdate: "检查更新",
 	checkingUpdate: "检查中…",
 	upToDate: "已是最新",
@@ -543,6 +599,18 @@ const zh = {
 	updatedTo: "已更新到 {v}，重启 PiWeb 后生效",
 	updateFailed: "更新失败",
 	updateManualHint: "先停止 piweb，再执行上面的命令（Windows 无法替换运行中的安装目录）",
+	updateCopied: "已复制",
+	updateBusy: "有会话正在运行，等它结束再更新",
+	updateCommits: "main 新增 {n} 个提交",
+	updateNoticeTitle: "有新版本",
+	updateNoticeUpdatingTitle: "正在更新…",
+	updateNoticeDoneTitle: "更新完成",
+	updateNoticeUpdate: "更新",
+	updateNoticeLater: "稍后",
+	updateNoticeOk: "知道了",
+	updateNoticeUpdated: "已更新到 {v}",
+	updateRunCommandHint: "先停掉 piweb，再在终端运行：",
+	updateRestartHint: "重启 PiWeb 后生效：在运行 piweb 的终端按 Ctrl+C，再重新运行 piweb",
 	skillsDesc: "关闭后技能不会出现在系统提示中，仅可通过 /skill:名称 手动调用",
 	confirmDeleteSkill: "确定删除技能“{name}”吗？将删除其所在技能目录，不可恢复。",
 	deleteSkillHint: "删除技能目录",
@@ -653,6 +721,26 @@ const zh = {
 	viewerNotInSnapshot: "此文件不在快照里（超过 1MB 或被排除），显示磁盘上的当前内容",
 	viewerLoadFailed: "加载失败",
 	viewerEmpty: "从左侧树里选择一个文件",
+	// 流式输出
+	streamStyleTitle: "流式输出样式",
+	streamStyleDesc: "回答逐字出现的方式；改完立刻生效，正在流出的回答也一并换",
+	streamStyleSmooth: "平滑",
+	streamStyleSmoothDesc: "匀速长出，不跳字",
+	streamStyleTypewriter: "打字机",
+	streamStyleTypewriterDesc: "固定节奏逐字敲出",
+	streamStyleFade: "渐显",
+	streamStyleFadeDesc: "整词推进，段落柔和淡入",
+	streamStyleInstant: "即时",
+	streamStyleInstantDesc: "立即显示，不做平滑",
+	streamSpeedTitle: "推进速度",
+	streamSpeedDesc: "平滑 / 打字机 / 渐显的节奏快慢；即时样式不受影响",
+	streamSpeed1: "慢",
+	streamSpeed2: "较慢",
+	streamSpeed3: "标准",
+	streamSpeed4: "快",
+	streamSpeed5: "极快",
+	streamCaretTitle: "打字光标",
+	streamCaretDesc: "流式期间在文字末尾显示闪烁光标",
 } as const;
 
 type Dict = { [K in keyof typeof zh]: string };
@@ -688,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",
@@ -777,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",
@@ -933,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",
@@ -971,6 +1092,23 @@ const en: Dict = {
 	contextCompacted: "Compacted Data",
 	contextAutoCompactBuffer: "Auto-Compact Buffer",
 	contextFreeSpace: "Free Space",
+	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",
@@ -978,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",
@@ -1147,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",
@@ -1175,9 +1319,9 @@ const en: Dict = {
 	trustAlways: "Always trust",
 	trustNever: "Never trust",
 	versionPiweb: "PiWeb version",
-	versionPiwebDesc: "Version of this web app; click to open the repo",
+	versionPiwebDesc: "Version of this web app; checked at startup and updatable right here (click the version to open the repo)",
 	versionPi: "Pi version",
-	versionPiDesc: "Version of the pi agent engine; click to open the repo",
+	versionPiDesc: "Version of the pi agent engine; checked at startup and updatable right here (click the version to open the repo)",
 	checkUpdate: "Check for updates",
 	checkingUpdate: "Checking…",
 	upToDate: "Up to date",
@@ -1186,6 +1330,18 @@ const en: Dict = {
 	updatedTo: "Updated to {v}; restart PiWeb to apply",
 	updateFailed: "Update failed",
 	updateManualHint: "Stop piweb, then run the command above (Windows cannot replace a running installation)",
+	updateCopied: "Copied",
+	updateBusy: "A session is running; update after it finishes",
+	updateCommits: "{n} new commits on main",
+	updateNoticeTitle: "Update available",
+	updateNoticeUpdatingTitle: "Updating…",
+	updateNoticeDoneTitle: "Update installed",
+	updateNoticeUpdate: "Update",
+	updateNoticeLater: "Later",
+	updateNoticeOk: "Got it",
+	updateNoticeUpdated: "Updated to {v}",
+	updateRunCommandHint: "Stop piweb, then run in a terminal:",
+	updateRestartHint: "Restart PiWeb to apply: press Ctrl+C in the terminal running piweb, then run piweb again",
 	skillsDesc: "Disabled skills are hidden from the system prompt and only callable via /skill:name",
 	confirmDeleteSkill: "Delete skill \"{name}\"? Its skill directory will be removed and cannot be recovered.",
 	deleteSkillHint: "Delete the skill directory",
@@ -1295,6 +1451,26 @@ const en: Dict = {
 	viewerNotInSnapshot: "Not in the snapshot (over 1MB or excluded); showing the current content from disk",
 	viewerLoadFailed: "Failed to load",
 	viewerEmpty: "Pick a file from the tree on the left",
+	// Streaming text
+	streamStyleTitle: "Streaming text",
+	streamStyleDesc: "How the answer appears while it arrives; applies to the stream already running",
+	streamStyleSmooth: "Smooth",
+	streamStyleSmoothDesc: "Even pace, no jumps",
+	streamStyleTypewriter: "Typewriter",
+	streamStyleTypewriterDesc: "Fixed cadence, character by character",
+	streamStyleFade: "Fade in",
+	streamStyleFadeDesc: "Whole words, paragraphs fade in",
+	streamStyleInstant: "Instant",
+	streamStyleInstantDesc: "Show immediately, no smoothing",
+	streamSpeedTitle: "Streaming speed",
+	streamSpeedDesc: "Cadence for Smooth / Typewriter / Fade in; Instant ignores it",
+	streamSpeed1: "Slow",
+	streamSpeed2: "Relaxed",
+	streamSpeed3: "Standard",
+	streamSpeed4: "Fast",
+	streamSpeed5: "Fastest",
+	streamCaretTitle: "Typing caret",
+	streamCaretDesc: "Blinking caret at the end of the text while streaming",
 };
 
 const dicts: Record<string, Dict> = { zh, en };

package/src/instrumentation-node.ts

@@ -12,6 +12,9 @@ export async function registerNode() {
 	const { authEnabled } = await import("./lib/web-auth");
 	if (authEnabled()) (await import("./lib/web-launch-token")).publishLaunchToken();
 
+	// 每次启动检查一次 PiWeb / pi 有没有新版本：不等结果，查到了在终端打一行，页面右下角也会提醒
+	void (await import("./lib/update/startup-check")).ensureStartupCheck().catch(() => {});
+
 	const { remoteBlocked, remoteLanEnabled, startLan } = await import("./lib/remote/supervisor");
 	if (!remoteLanEnabled()) return;