@rexvane/piweb 0.3.19 → 0.3.21

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,
@@ -194,6 +195,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 = {
@@ -350,7 +354,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 +678,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 +724,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();

package/src/i18n.tsx

@@ -199,7 +199,7 @@ const zh = {
 	webAuth: "访问认证",
 	webAuthTokenOn: "已启用（启动令牌）",
 	loginTokenTitle: "这个实例用启动令牌登录",
-	loginTokenDesc: "请打开启动 PiWeb 时终端里打印的登录链接（形如 …/?token=…）。令牌每次重启都会更换；打开一次后浏览器会记住 30 天。",
+	loginTokenDesc: "请打开启动 PiWeb 时终端里打印的登录链接（形如 …/?token=…），或在已登录的电脑上打开 设置 → 远程连接，复制带令牌的地址。令牌每次重启都会更换；打开一次后浏览器会记住 30 天。",
 	logout: "退出登录",
 	authMethodApiKey: "API 密钥",
 	oauthDevicePrompt: "请在浏览器中完成授权",
@@ -323,6 +323,9 @@ const zh = {
 	contextCompacted: "Compacted Data",
 	contextAutoCompactBuffer: "Auto-Compact Buffer",
 	contextFreeSpace: "Free Space",
+	contextColdHint: "会话还没启动，System Prompt 和工具定义要启动后才算得出",
+	contextCountNow: "现在统计",
+	contextCounting: "统计中…",
 	// 统计条
 	turns: "轮次",
 	toolCalls: "工具调用",
@@ -417,9 +420,10 @@ const zh = {
 	setRemote: "远程连接",
 	remoteBuiltin: "内置插件",
 	remoteLanTitle: "局域网入口",
-	remoteLanHint: "同一个 WiFi 下的设备直接打开下面地址即可，手机排版已适配。默认开启。",
+	remoteLanHint: "同一个 WiFi 下的设备直接打开下面地址即可，手机排版已适配。默认开启。链接带登录令牌：点「复制」发到手机，打开就直接登录；令牌即凭据，别发给别人。",
 	remotePublicTitle: "公网入口",
-	remotePublicHint: "开启后任何浏览器都能打开，无需安装客户端。地址由 Cloudflare 随机分配，每次启动都会变。",
+	remotePublicHint: "开启后任何浏览器都能打开，无需安装客户端。地址由 Cloudflare 随机分配，每次启动都会变。链接同样带登录令牌。",
+	remoteLinkCopied: "已复制（含令牌）",
 	remoteStart: "开启远程连接",
 	remoteStop: "关闭",
 	remoteWorking: "启动中…",
@@ -531,9 +535,9 @@ const zh = {
 	trustAlways: "总是信任",
 	trustNever: "从不信任",
 	versionPiweb: "PiWeb 版本",
-	versionPiwebDesc: "本 Web 应用的版本，点击打开仓库",
+	versionPiwebDesc: "本 Web 应用的版本；启动时自动检查，有新版本在这里直接更新（点版本号打开仓库）",
 	versionPi: "Pi 版本",
-	versionPiDesc: "pi 智能体内核的版本，点击打开仓库",
+	versionPiDesc: "pi 智能体内核的版本；启动时自动检查，有新版本在这里直接更新（点版本号打开仓库）",
 	checkUpdate: "检查更新",
 	checkingUpdate: "检查中…",
 	upToDate: "已是最新",
@@ -542,6 +546,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: "删除技能目录",
@@ -652,6 +668,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 };
@@ -848,7 +884,7 @@ const en: Dict = {
 	webAuth: "Access authentication",
 	webAuthTokenOn: "Enabled (launch token)",
 	loginTokenTitle: "This instance signs in with a launch token",
-	loginTokenDesc: "Open the login link printed in the terminal when PiWeb started (…/?token=…). The token changes on every restart; once opened, the browser remembers it for 30 days.",
+	loginTokenDesc: "Open the login link printed in the terminal when PiWeb started (…/?token=…), or copy a link from Settings → Remote access on a signed-in computer. The token changes on every restart; once opened, the browser remembers it for 30 days.",
 	logout: "Sign out",
 	authMethodApiKey: "API key",
 	oauthDevicePrompt: "Finish authorization in your browser",
@@ -970,6 +1006,9 @@ 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…",
 	turns: "turns",
 	toolCalls: "tool calls",
 	cost: "cost",
@@ -1059,9 +1098,10 @@ const en: Dict = {
 	setRemote: "Remote access",
 	remoteBuiltin: "Built-in plugin",
 	remoteLanTitle: "Local network",
-	remoteLanHint: "Devices on the same Wi-Fi can open the address below; the mobile layout is already applied. On by default.",
+	remoteLanHint: "Devices on the same Wi-Fi can open the address below; the mobile layout is already applied. On by default. Links carry the login token: copy one to your phone and it signs in directly. The token is a credential — don't share it.",
 	remotePublicTitle: "Public access",
-	remotePublicHint: "Once on, any browser can open it with nothing to install. Cloudflare assigns a random address that changes on every start.",
+	remotePublicHint: "Once on, any browser can open it with nothing to install. Cloudflare assigns a random address that changes on every start. The link carries the login token too.",
+	remoteLinkCopied: "Copied (with token)",
 	remoteStart: "Turn on",
 	remoteStop: "Turn off",
 	remoteWorking: "Starting…",
@@ -1173,9 +1213,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",
@@ -1184,6 +1224,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",
@@ -1293,6 +1345,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;
 

package/src/lib/agent-manager.ts

@@ -6,7 +6,7 @@ import { existsSync, readFileSync, statSync } from "node:fs";
 import { randomUUID } from "node:crypto";
 import path from "node:path";
 import type { AgentSession, AgentSessionEvent } from "@earendil-works/pi-coding-agent";
-import { generateUnifiedPatch } from "@earendil-works/pi-coding-agent";
+import { formatSkillsForPrompt, generateUnifiedPatch } from "@earendil-works/pi-coding-agent";
 import {
 	getResourceLoader,
 	createSessionResourceLoader,
@@ -63,6 +63,10 @@ interface Managed {
 	session: AgentSession | null;
 	creating: Promise<AgentSession> | null;
 	subscribers: Set<(seq: number, json: string) => void>;
+	/** 长轮询的浏览器在两次请求之间没有订阅，到这个时间点之前仍算有人在看（见 holdViewer） */
+	viewerGraceUntil?: number;
+	/** 本轮已排队推送上下文分项（publishContextBreakdown 合并同一轮的多次触发） */
+	breakdownQueued?: boolean;
 	buffer: { seq: number; json: string }[];
 	seq: number;
 	/**
@@ -579,6 +583,7 @@ function translate(m: Managed, evt: AgentSessionEvent): void {
 				ts: now,
 			});
 			publishUsage(m);
+			publishContextBreakdown(m);
 			if ((evt as any).reason === "manual") {
 				publish(m, { type: "status", isStreaming: isManagedBusy(m), state: isManagedBusy(m) ? "running" : "idle", ts: now });
 				if (m.resourceReloadPending) queueMicrotask(() => void reloadManagedResources(m));
@@ -733,45 +738,46 @@ function loadContextResources(cwd: string, loader: AgentSession["resourceLoader"
 	];
 }
 
+const SKILLS_SECTION_START = "The following skills provide specialized instructions";
+const SKILLS_SECTION_END = "</available_skills>";
+
 /**
  * 上下文占用的服务端估算分项。systemPrompt 是整段拼接（正文 + memory + skills + 工具列表），
  * 所以 Memory / Skills 从资源加载器与 systemPrompt 的资源段差分得出：
  * SDK 的拼接顺序固定为 正文 → context files → skills → 工具列表，按内容定位切块。
+ *
+ * 冷会话（只浏览历史、不冷启动 agent）拿不到组装后的 system prompt 和工具定义，这三项为 0、标 cold；
+ * Memory / Skills / Compacted / Buffer 不依赖 agent，照常从发现缓存、会话文件和设置里算，
+ * 不能因为没启动就整块归零（那样弹窗只剩消息几类）。
  */
-async function buildContextBreakdown(
-	cwd: string,
-	session: AgentSession | null,
-	resources: ContextResource[],
-): Promise<ContextBreakdown> {
+async function buildContextBreakdown(m: Managed, resources: ContextResource[]): Promise<ContextBreakdown> {
+	const session = m.session;
 	const breakdown: ContextBreakdown = {
 		systemPrompt: 0, systemTools: 0, customTools: 0, memory: 0, skills: 0, compacted: 0, autoCompactBuffer: 0,
+		...(session ? {} : { cold: true }),
 	};
-	if (!session) return breakdown;
-	try {
-		const prompt = session.systemPrompt ?? "";
-		// Memory：AGENTS.md 等注入文件（contextResources 的 project 部分）
-		const memoryText = resources.filter((r) => r.source === "project").map((r) => r.content).join("\n\n");
-		breakdown.memory = estimateTokensOf(memoryText);
-		// Skills：从资源加载器取技能清单，按 SDK 的 formatSkillsForPrompt 段落定位。
-		// 该段落没有 Markdown 标题（原文以 "The following skills provide specialized instructions…" 开头，
-		// 结尾是 </available_skills>），以前按 "## Skills" 找永远找不到，技能段一直是 0。
+	// Memory：AGENTS.md 等注入文件（contextResources 的 project 部分）
+	const memoryText = resources.filter((r) => r.source === "project").map((r) => r.content).join("\n\n");
+	breakdown.memory = estimateTokensOf(memoryText);
+	if (session) {
 		try {
-			const { skills } = session.resourceLoader.getSkills();
-			if (skills.length && prompt) {
-				const start = prompt.indexOf("The following skills provide specialized instructions");
-				const end = prompt.indexOf("</available_skills>");
-				if (start >= 0 && end > start) breakdown.skills = estimateTokensOf(prompt.slice(start, end + "</available_skills>".length));
+			const prompt = session.systemPrompt ?? "";
+			// Skills：按 SDK 的 formatSkillsForPrompt 段落定位。该段落没有 Markdown 标题（以
+			// "The following skills provide specialized instructions…" 开头、</available_skills> 结尾），
+			// 以前按 "## Skills" 找永远找不到，技能段一直是 0。
+			try {
+				if (session.resourceLoader.getSkills().skills.length && prompt) {
+					const start = prompt.indexOf(SKILLS_SECTION_START);
+					const end = prompt.indexOf(SKILLS_SECTION_END);
+					if (start >= 0 && end > start) breakdown.skills = estimateTokensOf(prompt.slice(start, end + SKILLS_SECTION_END.length));
+				}
+			} catch {
+				/* loader 不可用则跳过 */
 			}
-		} catch {
-			/* loader 不可用则跳过 */
-		}
-		// System Prompt 正文 = 全文减去资源段与 skills 段的近似差分，下限 0
-		const estimatedSections = breakdown.memory + breakdown.skills;
-		breakdown.systemPrompt = Math.max(0, estimateTokensOf(prompt) - estimatedSections);
-		// 工具：builtin 与扩展注册的分开统计（schema + description + guidelines 序列化估算）
-		try {
-			const tools = session.getAllTools();
-			for (const tool of tools) {
+			// System Prompt 正文 = 全文减去资源段与 skills 段的近似差分，下限 0
+			breakdown.systemPrompt = Math.max(0, estimateTokensOf(prompt) - breakdown.memory - breakdown.skills);
+			// 工具：builtin 与扩展注册的分开统计（schema + description + guidelines 序列化估算）
+			for (const tool of session.getAllTools()) {
 				const size = estimateTokensOf(JSON.stringify({
 					name: tool.name,
 					description: tool.description,
@@ -782,38 +788,61 @@ async function buildContextBreakdown(
 				else breakdown.customTools += size;
 			}
 		} catch {
-			/* getAllTools 不可用则跳过 */
+			/* systemPrompt / getAllTools 不可用则保持 0 */
 		}
-		// 最新一次压缩的摘要
+	} else {
+		// 冷会话：技能段用发现缓存里的清单按 SDK 同一个格式化函数估算（启动后改用实际 prompt 里的那段）
 		try {
-			const entries = m_smEntries(session);
-			for (let i = entries.length - 1; i >= 0; i -= 1) {
-				const entry = entries[i] as { type?: string; summary?: string };
-				if (entry?.type === "compaction" && typeof entry.summary === "string") {
-					breakdown.compacted = estimateTokensOf(entry.summary);
-					break;
-				}
-			}
+			const loader = peekResourceLoader(m.cwd) ?? getResourceLoader(m.cwd);
+			breakdown.skills = estimateTokensOf(formatSkillsForPrompt(loader.getSkills().skills).trim());
 		} catch {
-			/* entries 不可用则跳过 */
+			/* 发现缓存还没好则跳过 */
 		}
-		// auto-compact 预留 = compaction.reserveTokens（启用时）
-		try {
-			const settings = await getPiSettings();
-			if (settings.compaction.enabled) breakdown.autoCompactBuffer = settings.compaction.reserveTokens;
-		} catch {
-			/* 设置读取失败则保持 0 */
+	}
+	// 最新一次压缩的摘要（会话文件里就有，冷热都能算）
+	try {
+		const entries = m.sm.getEntries() as unknown as { type?: string; summary?: string }[];
+		for (let i = entries.length - 1; i >= 0; i -= 1) {
+			const entry = entries[i];
+			if (entry?.type === "compaction" && typeof entry.summary === "string") {
+				breakdown.compacted = estimateTokensOf(entry.summary);
+				break;
+			}
 		}
 	} catch {
-		/* systemPrompt 不可用则保持 0 */
+		/* entries 不可用则跳过 */
+	}
+	// auto-compact 预留 = compaction.reserveTokens（启用时）
+	try {
+		const settings = await getPiSettings();
+		if (settings.compaction.enabled) breakdown.autoCompactBuffer = settings.compaction.reserveTokens;
+	} catch {
+		/* 设置读取失败则保持 0 */
 	}
 	return breakdown;
 }
 
-/** SessionManager 的 getEntries 经由 session 暴露的形态（各版本字段名有差异，这里宽松取） */
-function m_smEntries(session: AgentSession): unknown[] {
-	const s = session as unknown as { sm?: { getEntries?: () => unknown[] }; sessionManager?: { getEntries?: () => unknown[] } };
-	return s.sm?.getEntries?.() ?? s.sessionManager?.getEntries?.() ?? [];
+/**
+ * 分项变了就推一次（会话启动、工具 / 资源重载、压缩之后）。分项以前只随快照下发：
+ * 打开冷会话时是 0，之后会话启动了弹窗也一直停在那份 0 上，直到刷新页面。
+ * 同一轮里多次触发（启动时 publishTools + publishResources）合并成一次。
+ */
+function publishContextBreakdown(m: Managed): void {
+	if (m.breakdownQueued || m.disposed) return;
+	m.breakdownQueued = true;
+	queueMicrotask(() => {
+		m.breakdownQueued = false;
+		if (m.disposed) return;
+		let resources: ContextResource[] = [];
+		try {
+			resources = loadContextResources(m.cwd, m.session?.resourceLoader);
+		} catch {
+			/* 读不到注入文件就按空算 Memory */
+		}
+		void buildContextBreakdown(m, resources).then((breakdown) => {
+			if (!m.disposed) publish(m, { type: "context_breakdown", breakdown, ts: Date.now() });
+		}, () => undefined);
+	});
 }
 
 /** resources 已经算过（快照）就传进来，免得资源发现结果再读一遍 */
@@ -877,7 +906,7 @@ export async function ensureSession(m: Managed): Promise<AgentSession> {
 			installSessionPolicy(m, session);
 			applyToolPolicy(m, session);
 			session.subscribe((evt) => { if (!m.disposed) translate(m, evt); });
-			const ui = createExtensionUiBridge({ publish: (evt) => publish(m, evt), hasViewers: () => !m.disposed && m.subscribers.size > 0 });
+			const ui = createExtensionUiBridge({ publish: (evt) => publish(m, evt), hasViewers: () => !m.disposed && hasViewers(m) });
 			m.ui = ui;
 			await session.bindExtensions({
 				mode: "rpc",
@@ -989,6 +1018,7 @@ function shutdownSession(session: AgentSession): Promise<void> {
 
 function publishTools(m: Managed, session: AgentSession): void {
 	publish(m, { type: "tools", active: listActiveTools(session), all: listAllToolNames(session), toolPreset: m.toolPreset, customActiveTools: m.customActiveTools ?? null, ts: Date.now() });
+	publishContextBreakdown(m);
 }
 
 /** SDK reload 自动启用扩展工具，注册新工具也会刷新全集；统一在激活边界收敛到服务端选择。 */
@@ -1086,13 +1116,13 @@ export async function disposeSessionPath(sessionPath: string): Promise<void> {
 export function reap(): void {
 	const now = Date.now();
 	for (const m of [...sessions.values()]) {
-		if (m.subscribers.size > 0 || now - m.lastActive <= IDLE_MS) continue;
+		if (hasViewers(m) || now - m.lastActive <= IDLE_MS) continue;
 		if (!m.creating && !isManagedBusy(m)) disposeSession(m);
 	}
 	const active = [...sessions.values()].filter((m) => m.session);
 	if (active.length > MAX_ACTIVE) {
 		const evictable = active
-			.filter((m) => !m.creating && !isManagedBusy(m) && m.subscribers.size === 0)
+			.filter((m) => !m.creating && !isManagedBusy(m) && !hasViewers(m))
 			.sort((a, b) => a.lastActive - b.lastActive);
 		for (const m of evictable.slice(0, active.length - MAX_ACTIVE)) disposeSession(m);
 	}
@@ -1166,6 +1196,7 @@ function collectResources(m: Managed): ResourceBundle {
 
 export function publishResources(m: Managed): void {
 	publish(m, { type: "resources", ...collectResources(m), ts: Date.now() });
+	publishContextBreakdown(m);
 }
 
 /**
@@ -1198,7 +1229,7 @@ export async function reloadSessionsForCwd(cwd?: string): Promise<number> {
 		if (cwd && key(m.cwd) !== key(cwd)) continue;
 		if (!m.session) {
 			// 冷会话没有扩展运行时可重建，但页面可能开着：把新清单（模板 / 技能 / 信任）推过去
-			if (m.subscribers.size > 0) publishResources(m);
+			if (hasViewers(m)) publishResources(m);
 			continue;
 		}
 		if (m.creating || isManagedBusy(m)) {
@@ -1359,7 +1390,7 @@ export async function buildSnapshot(m: Managed): Promise<WebSnapshot> {
 	// 服务端可得的上下文分项（估算；失败不影响快照）
 	let contextBreakdown: ContextBreakdown | undefined;
 	try {
-		contextBreakdown = await buildContextBreakdown(m.cwd, m.session, contextResources);
+		contextBreakdown = await buildContextBreakdown(m, contextResources);
 	} catch {
 		contextBreakdown = undefined;
 	}
@@ -1446,6 +1477,18 @@ export function unsubscribe(m: Managed, send: (seq: number, json: string) => voi
 	m.subscribers.delete(send);
 }
 
+/**
+ * 长轮询（快速隧道）的一次请求结束时调用：下一次请求到来前的这段空档仍算有人在看，
+ * 否则扩展弹窗会被当成无人值守直接取默认值，会话也可能被当成没人开着回收掉。
+ */
+export function holdViewer(m: Managed, ms: number): void {
+	m.viewerGraceUntil = Math.max(m.viewerGraceUntil ?? 0, Date.now() + ms);
+}
+
+function hasViewers(m: Managed): boolean {
+	return m.subscribers.size > 0 || (m.viewerGraceUntil ?? 0) > Date.now();
+}
+
 // ---------- 命令执行 ----------
 
 export interface CommandResult {