@herbertgao/pi-extensions 2026.9.19 → 2026.10.0

package/node_modules/@herbertgao/pi-cc-extensions/extensions/feature/shell/footer.ts

@@ -0,0 +1,521 @@
+/**
+ * 自定义底栏：chips + zentui 图标/句子
+ *
+ * 第一行：model  thinking · ██████░░░░ 45%/200k · 󰆼 42% · $0.01 · 用户排到 line1 的插件芯片
+ * 第二行：cwd in session on  branch (+16 −1) · 用户排到 line2 的插件芯片
+ * 第三行：仅当 line3 有可见插件芯片时出现
+ *
+ *  - line1 短芯片，· 分隔；缓存用 zentui 󰆼，费用 success
+ *  - line2 用 zentui 句式 in / on + 
+ *  - 当前模型用量：优先 pi-usage 的 usage 状态；xAI 等不写 statusline 的供应商由本扩展补拉
+ *
+ * 模型/计费/思考级别变化时自动更新（pi.on 全局事件 + render 实时计算）
+ */
+
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth } from "@earendil-works/pi-tui";
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { config } from "../../config/config.ts";
+import { stripAnsi } from "../../utils/ansi-text.ts";
+import {
+	PI_USAGE_KEY,
+	isSkippedFooterStatusKey,
+	resolveFooterChipLayout,
+	visibleFooterPluginTexts,
+	type FooterChipLayout,
+} from "./footer-layout.ts";
+import { MCP_STATUS_KEY, buildMcpChip } from "./mcp-chip.ts";
+
+const GIT_REFRESH_INTERVAL_MS = 10_000;
+const USAGE_REFRESH_INTERVAL_MS = 5 * 60 * 1000;
+// 后台连接 MCP 服务器不会触发 footer 重绘，靠这个兜底轮询把芯片刷出来
+const MCP_REFRESH_INTERVAL_MS = 5_000;
+const USAGE_TIMEOUT_MS = 15_000;
+// zentui NERD_DEFAULT_ICONS：git / cacheHit。无 Nerd Font 时留空，只保留文字。
+export const FOOTER_NERD_ICON_GIT = "";
+export const FOOTER_NERD_ICON_CACHE = "󰆼";
+
+// md power-plug：MCP 服务器连接数
+export const FOOTER_NERD_ICON_MCP = "\u{f06a5}";
+
+export function footerGlyphs(nerdIcons: boolean): { git: string; cache: string; mcp: string } {
+	return nerdIcons
+		? { git: FOOTER_NERD_ICON_GIT, cache: FOOTER_NERD_ICON_CACHE, mcp: FOOTER_NERD_ICON_MCP }
+		: { git: "", cache: "", mcp: "" };
+}
+
+type GitStats = { add: number; del: number };
+
+type XaiFooterReport = {
+	buckets?: Array<{
+		id?: string;
+		unit?: string;
+		used?: number;
+		limit?: number;
+		remaining?: number;
+	}>;
+	metrics?: Array<{ id?: string; value?: unknown }>;
+};
+
+export function parseGitStats(stdout: string): GitStats {
+	let add = 0;
+	let del = 0;
+	for (const line of stdout.split("\n")) {
+		const match = line.match(/^(\d+)\s+(\d+)/);
+		if (match) {
+			add += Number(match[1]);
+			del += Number(match[2]);
+		}
+	}
+	return { add, del };
+}
+
+export function formatXaiFooterChip(report: XaiFooterReport): string | undefined {
+	const included = report.buckets?.find((b) => b.id === "included-allowance");
+	if (included?.unit === "percent" && typeof included.used === "number") {
+		return `xAI ${Math.round(included.used)}%`;
+	}
+	if (included && included.unit !== "percent") {
+		if (
+			typeof included.used === "number" &&
+			typeof included.limit === "number" &&
+			included.limit > 0
+		) {
+			return `xAI ${Math.round((included.used / included.limit) * 100)}%`;
+		}
+		if (typeof included.remaining === "number") {
+			return `xAI $${included.remaining.toFixed(2)}`;
+		}
+		if (typeof included.used === "number") {
+			return `xAI $${included.used.toFixed(2)}`;
+		}
+	}
+	const prepaid = report.metrics?.find((m) => m.id === "prepaid-balance");
+	if (typeof prepaid?.value === "number") {
+		return `xAI $${prepaid.value.toFixed(2)}`;
+	}
+	return undefined;
+}
+
+const cachedExtensionStatuses = new Map<string, string>();
+let cachedLocalUsageText = "";
+/** 本包推算的内置 MCP 芯片（含 nerd 图标）；空字符串表示不显示。 */
+let cachedMcpChip = "";
+
+/** 别的扩展（pi-mcp-adapter）自己写了 mcp 状态时不画，避免两个芯片。 */
+function ownMcpChip(): string {
+	return cachedMcpChip && !cachedExtensionStatuses.has(MCP_STATUS_KEY) ? cachedMcpChip : "";
+}
+
+/** 面板用：当前 setStatus 文案 + 本包 pi-usage / MCP（无文案时为空字符串）。 */
+export function getFooterStatusSnapshot(): Map<string, string> {
+	const out = new Map<string, string>();
+	for (const [key, text] of cachedExtensionStatuses) {
+		if (isSkippedFooterStatusKey(key)) continue;
+		out.set(key, text);
+	}
+	out.set(PI_USAGE_KEY, cachedLocalUsageText);
+	const mcpChip = ownMcpChip();
+	if (mcpChip) out.set(MCP_STATUS_KEY, mcpChip);
+	return out;
+}
+
+function rememberExtensionStatuses(entries: Iterable<[string, string]>): void {
+	cachedExtensionStatuses.clear();
+	for (const [key, raw] of entries) {
+		if (isSkippedFooterStatusKey(key)) continue;
+		const text = stripAnsi(raw.replace(/[\r\n\t]+/g, " ").trim());
+		if (text) cachedExtensionStatuses.set(key, text);
+	}
+}
+
+function pluginTextsForRender(localUsageChip: string): Map<string, string> {
+	cachedLocalUsageText = stripAnsi(localUsageChip.replace(/[\r\n\t]+/g, " ").trim());
+	const texts = new Map<string, string>(cachedExtensionStatuses);
+	if (cachedLocalUsageText) texts.set(PI_USAGE_KEY, cachedLocalUsageText);
+	else texts.delete(PI_USAGE_KEY);
+	return texts;
+}
+
+function layoutFromConfig(): FooterChipLayout {
+	return {
+		footerHiddenKeys: config.footerHiddenKeys,
+		footerLine1Keys: config.footerLine1Keys,
+		footerLine2Keys: config.footerLine2Keys,
+		footerLine3Keys: config.footerLine3Keys,
+	};
+}
+
+let piUsageMod: any | null | undefined;
+
+function piUsageImportSpecs(): string[] {
+	const agentDir = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
+	const dist = join(agentDir, "npm", "node_modules", "@narumitw", "pi-usage", "dist", "index.ts");
+	const specs: string[] = [];
+	if (existsSync(dist)) specs.push(pathToFileURL(dist).href);
+	specs.push("@narumitw/pi-usage");
+	return specs;
+}
+
+async function getPiUsage(): Promise<any | null> {
+	if (piUsageMod !== undefined) return piUsageMod;
+	for (const spec of piUsageImportSpecs()) {
+		try {
+			piUsageMod = await import(spec);
+			return piUsageMod;
+		} catch {
+			// 下一候选：本机 Pi npm 目录，或包名（与本包同 node_modules 时）
+		}
+	}
+	piUsageMod = null;
+	return piUsageMod;
+}
+
+function colorUsageChip(theme: any, text: string): string {
+	return theme.fg("dim", stripAnsi(text));
+}
+
+let currentTui: any = undefined;
+let refreshCurrentGitStats: (() => void) | undefined;
+let refreshCurrentUsage: (() => void) | undefined;
+let refreshCurrentMcpChip: (() => void) | undefined;
+/** 工具/命令列表在 pi API 上，而 footer 工厂只拿得到 ctx，加载时记下来。 */
+let extensionApi: Pick<ExtensionAPI, "getAllTools" | "getCommands"> | undefined;
+
+const createCustomFooterFactory =
+	(ctx: ExtensionContext) => (tui: any, theme: any, footerData: any) => {
+		currentTui = tui;
+		const sep = theme.fg("muted", " · ");
+		const joinChips = (parts: string[]) => parts.filter(Boolean).join(sep);
+		let gitStats: GitStats | undefined;
+		let gitRefreshRunning = false;
+		let localUsageChip = "";
+		let usageGeneration = 0;
+		let usageAbort: AbortController | undefined;
+		let disposed = false;
+
+		// 查询在 render 外执行，保留旧值；仅统计结果真正变化时重绘，避免周期性清零抖动。
+		const refreshGitStats = () => {
+			if (gitRefreshRunning || disposed) return;
+			gitRefreshRunning = true;
+			execFile(
+				"git",
+				["diff", "--numstat", "HEAD"],
+				{ cwd: ctx.cwd, timeout: 2000 },
+				(err, stdout) => {
+					gitRefreshRunning = false;
+					if (err || disposed) return;
+					const next = parseGitStats(stdout);
+					if (gitStats?.add === next.add && gitStats.del === next.del) return;
+					gitStats = next;
+					tui.requestRender();
+				},
+			);
+		};
+		refreshCurrentGitStats = refreshGitStats;
+		refreshGitStats();
+		const gitRefreshTimer = setInterval(refreshGitStats, GIT_REFRESH_INTERVAL_MS);
+		gitRefreshTimer.unref?.();
+
+		const refreshUsage = () => {
+			if (disposed) return;
+			const generation = ++usageGeneration;
+			usageAbort?.abort();
+			const controller = new AbortController();
+			usageAbort = controller;
+			const stale = () => disposed || generation !== usageGeneration || controller.signal.aborted;
+			void (async () => {
+				try {
+					const model = ctx.model;
+					const api = await getPiUsage();
+					if (stale()) return;
+					if (!api || !model) {
+						if (localUsageChip) {
+							localUsageChip = "";
+							tui.requestRender();
+						}
+						return;
+					}
+					const adapter = api.adapterForProvider?.(model.provider);
+					if (!adapter || adapter.publishesStatusline !== false) {
+						if (localUsageChip) {
+							localUsageChip = "";
+							tui.requestRender();
+						}
+						return;
+					}
+					const auth = await api.resolveUsageAuth(ctx, adapter);
+					if (stale()) return;
+					if (!auth) {
+						const next = `${adapter.displayName} ✗`;
+						if (localUsageChip !== next) {
+							localUsageChip = next;
+							tui.requestRender();
+						}
+						return;
+					}
+					const guard = async () => {
+						if (stale()) throw new Error("aborted");
+						const again = await api.resolveUsageAuth(ctx, adapter);
+						if (again?.fingerprint !== auth.fingerprint) {
+							throw new Error("aborted");
+						}
+					};
+					const report = await api.queryProviderUsage(
+						adapter,
+						auth,
+						controller.signal,
+						USAGE_TIMEOUT_MS,
+						guard,
+					);
+					if (stale()) return;
+					const next =
+						(adapter.id === "xai" ? formatXaiFooterChip(report) : undefined) ||
+						api.formatUsageStatusline?.(report, model) ||
+						`${adapter.displayName} ✗`;
+					if (localUsageChip !== next) {
+						localUsageChip = next;
+						tui.requestRender();
+					}
+				} catch {
+					if (stale()) return;
+					const name = ctx.model?.provider === "xai" ? "xAI" : "usage";
+					const next = `${name} ✗`;
+					if (localUsageChip !== next) {
+						localUsageChip = next;
+						tui.requestRender();
+					}
+				} finally {
+					if (usageAbort === controller) usageAbort = undefined;
+				}
+			})();
+		};
+		refreshCurrentUsage = refreshUsage;
+		refreshUsage();
+		const usageRefreshTimer = setInterval(refreshUsage, USAGE_REFRESH_INTERVAL_MS);
+		usageRefreshTimer.unref?.();
+
+		// 内置 MCP 的状态不经 setStatus 暴露，只能轮询 pi API 与 mcp.json 推算
+		const refreshMcp = () => {
+			if (disposed) return;
+			const chip = buildMcpChip(ctx, extensionApi);
+			const glyph = footerGlyphs(config.footerNerdIcons).mcp;
+			const next = chip ? `${glyph ? `${glyph} ` : ""}${chip}` : "";
+			if (cachedMcpChip === next) return;
+			cachedMcpChip = next;
+			tui.requestRender();
+		};
+		refreshCurrentMcpChip = refreshMcp;
+		refreshMcp();
+		const mcpRefreshTimer = setInterval(refreshMcp, MCP_REFRESH_INTERVAL_MS);
+		mcpRefreshTimer.unref?.();
+
+		// 分支变化时同步更新分支名和相对 HEAD 的统计。
+		const unsubBranch = footerData.onBranchChange(() => {
+			refreshGitStats();
+			tui.requestRender();
+		});
+
+		const fmt = (n: number): string => {
+			if (n < 1000) return `${n}`;
+			if (n < 10000) return `${(n / 1000).toFixed(1)}k`;
+			if (n < 1000000) return `${Math.round(n / 1000)}k`;
+			if (n < 10000000) return `${(n / 1000000).toFixed(1)}M`;
+			return `${Math.round(n / 1000000)}M`;
+		};
+
+		// ---- pi-cc-status 风格：上下文条形图 ----
+		const BAR_WIDTH = 10;
+		const BAR_WARNING = 80; // >= 80% 转 warning 色
+		const BAR_ERROR = 95; // >= 95% 转 error 色
+		const barGauge = (pct: number): string => {
+			const clamped = Math.max(0, Math.min(100, pct));
+			const filled = Math.round((clamped / 100) * BAR_WIDTH);
+			const color = clamped >= BAR_ERROR ? "error" : clamped >= BAR_WARNING ? "warning" : "accent";
+			return theme.fg(color, "█".repeat(filled)) + theme.fg("dim", "░".repeat(BAR_WIDTH - filled));
+		};
+
+		// pi-cc-status showCachePercent：最近一条助手消息的 cacheRead 占比
+		const getCachePct = (): number => {
+			const branch = ctx.sessionManager.getBranch();
+			for (let i = branch.length - 1; i >= 0; i--) {
+				const e = branch[i];
+				if (e.type !== "message" || e.message.role !== "assistant") continue;
+				const u = e.message.usage;
+				if (!u) return 0;
+				const total = u.input + u.cacheWrite + u.cacheRead;
+				return total > 0 ? (u.cacheRead * 100) / total : 0;
+			}
+			return 0;
+		};
+
+		const render = (width: number): string[] => {
+			const model = ctx.model;
+			const contextUsage = ctx.getContextUsage();
+			const contextWindow = contextUsage?.contextWindow ?? model?.contextWindow ?? 0;
+			const percent = contextUsage?.percent;
+
+			let cost = 0;
+			for (const entry of ctx.sessionManager.getEntries()) {
+				if (entry.type === "message") {
+					const m = entry.message;
+					if (m.role === "assistant") cost += m.usage?.cost?.total || 0;
+					else if (m.role === "toolResult" && m.usage) cost += m.usage.cost?.total || 0;
+				} else if (
+					(entry.type === "branch_summary" || entry.type === "compaction") &&
+					entry.usage
+				) {
+					cost += entry.usage.cost?.total || 0;
+				}
+			}
+
+			// cwd 默认只显示最底层路径（根目录时回退完整路径）
+			const cwdLabel = ctx.cwd.split(/[\\/]/).filter(Boolean).pop() || ctx.cwd;
+
+			const usingSubscription =
+				!!model &&
+				["kimi-coding", "xai", "github-copilot", "openai"].includes(model.provider || "");
+			const modelLabel = model
+				? model.id.includes("/")
+					? model.id
+					: `${model.provider}/${model.id}`
+				: "no-model";
+
+			const thinkingLevelStr = ctx.thinkingLevel || "off";
+			const thinkingColor = theme.getThinkingBorderColor(thinkingLevelStr);
+
+			rememberExtensionStatuses(
+				footerData.getExtensionStatuses().entries() as Iterable<[string, string]>,
+			);
+			const pluginTexts = pluginTextsForRender(localUsageChip);
+			const mcpChip = ownMcpChip();
+			if (mcpChip) pluginTexts.set(MCP_STATUS_KEY, mcpChip);
+			const layout = resolveFooterChipLayout(layoutFromConfig(), [...pluginTexts.keys()]);
+			const dimPlugin = (text: string) => colorUsageChip(theme, text);
+			const line1Plugins = visibleFooterPluginTexts(
+				layout.footerLine1Keys,
+				layout.footerHiddenKeys,
+				pluginTexts,
+			).map(dimPlugin);
+			const line2Plugins = visibleFooterPluginTexts(
+				layout.footerLine2Keys,
+				layout.footerHiddenKeys,
+				pluginTexts,
+			).map(dimPlugin);
+			const line3Plugins = visibleFooterPluginTexts(
+				layout.footerLine3Keys,
+				layout.footerHiddenKeys,
+				pluginTexts,
+			).map(dimPlugin);
+
+			const pctLabel = percent === null || percent === undefined ? "?" : `${Math.floor(percent)}%`;
+			const cachePct = getCachePct();
+			const glyphs = footerGlyphs(config.footerNerdIcons);
+			const cacheLabel =
+				cachePct > 0 ? `${glyphs.cache ? `${glyphs.cache} ` : ""}${Math.floor(cachePct)}%` : "";
+			const costChip =
+				cost || usingSubscription
+					? theme.fg("dim", `$${cost.toFixed(2)}`) +
+						(usingSubscription ? theme.fg("warning", " sub") : "")
+					: "";
+			const line1 = joinChips([
+				theme.fg("accent", modelLabel),
+				model?.reasoning ? thinkingColor(thinkingLevelStr) : "",
+				barGauge(percent ?? 0) + theme.fg("dim", ` ${pctLabel}/${fmt(contextWindow)}`),
+				cacheLabel ? theme.fg("dim", cacheLabel) : "",
+				costChip,
+				...line1Plugins,
+			]);
+
+			const gitColor = theme.getThinkingBorderColor("medium");
+			let place = theme.fg("accent", cwdLabel);
+			const sessionName = ctx.sessionManager.getSessionName();
+			if (sessionName) {
+				place += theme.fg("muted", " in ") + theme.fg("success", sessionName);
+			}
+			const branch = footerData.getGitBranch();
+			if (branch) {
+				const stats =
+					gitStats && (gitStats.add || gitStats.del)
+						? theme.fg("dim", " (") +
+							theme.fg("success", `+${gitStats.add}`) +
+							" " +
+							theme.fg("error", `−${gitStats.del}`) +
+							theme.fg("dim", ")")
+						: "";
+				const gitLabel = glyphs.git ? `${glyphs.git} ${branch}` : branch;
+				place += theme.fg("muted", " on ") + gitColor(gitLabel) + stats;
+			}
+			const line2 = joinChips([place, ...line2Plugins]);
+			const line3 = joinChips(line3Plugins);
+
+			return [
+				truncateToWidth(line1, width),
+				...(line2 ? [truncateToWidth(line2, width)] : []),
+				...(line3 ? [truncateToWidth(line3, width)] : []),
+			];
+		};
+
+		return {
+			render,
+			invalidate(): void {
+				tui.requestRender();
+			},
+			dispose(): void {
+				disposed = true;
+				usageAbort?.abort();
+				usageAbort = undefined;
+				clearInterval(gitRefreshTimer);
+				clearInterval(usageRefreshTimer);
+				clearInterval(mcpRefreshTimer);
+				unsubBranch();
+				if (currentTui === tui) {
+					currentTui = undefined;
+					refreshCurrentGitStats = undefined;
+					refreshCurrentUsage = undefined;
+					refreshCurrentMcpChip = undefined;
+				}
+			},
+		};
+	};
+
+/** Apply the configured custom footer without disturbing another extension's footer when disabled. */
+export function applyCustomFooter(ctx: ExtensionContext): void {
+	if (!ctx?.hasUI || typeof ctx.ui?.setFooter !== "function" || !config.enableCustomFooter) return;
+	try {
+		ctx.ui.setFooter(createCustomFooterFactory(ctx));
+	} catch (err) {
+		ctx.ui.notify(`footer error: ${err instanceof Error ? err.message : String(err)}`, "error");
+	}
+}
+
+/** Restore Pi's native footer when the user explicitly disables this extension's active footer. */
+export function clearCustomFooter(ctx: ExtensionContext): void {
+	if (!ctx?.hasUI || typeof ctx.ui?.setFooter !== "function") return;
+	ctx.ui.setFooter(undefined);
+}
+
+export default function (pi: ExtensionAPI) {
+	extensionApi = pi;
+	// 模型/思考级别变化时强制重渲染（自定义 footer 不会被内置 invalidate() 触达）
+	pi.on("model_select", () => {
+		currentTui?.requestRender();
+		refreshCurrentUsage?.();
+	});
+	pi.on("thinking_level_select", () => currentTui?.requestRender());
+	// 工具执行完成后立即刷新；定时器只负责兜底捕获外部文件变化。
+	pi.on("tool_execution_end", () => {
+		refreshCurrentGitStats?.();
+		// 懒连接的 MCP 服务器可能刚被调用过
+		refreshCurrentMcpChip?.();
+	});
+
+	// 启动 / /reload / 新建会话 时按配置恢复
+	pi.on("session_start", (_event, ctx) => {
+		applyCustomFooter(ctx);
+	});
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/feature/shell/mcp-chip.ts

@@ -0,0 +1,136 @@
+/**
+ * 内置 MCP 的状态栏芯片。
+ *
+ * pi 的内置 MCP 不写 setStatus：连接状态只在 `/mcp` 菜单里，扩展读不到。这里用公开数据推算
+ * 「已连接/已配置」，并在别的扩展接管 `/mcp` 时让位（pi-mcp-adapter 这类扩展自己会写 "mcp" 状态）。
+ *
+ * - 已连接：`pi.getAllTools()` 里来源是 builtin:mcp、曝光非 hidden 的工具，按 namespace 去重。
+ *   断线后工具仍在、0 个工具的服务器连上也看不见，needs-auth / failed 与 connecting 也分不开，
+ *   所以这只是近似值。
+ * - 已配置：mcp.json 里 enabled !== false 的条目（项目级要已 trust）。
+ */
+
+import { readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+/** 与 pi-mcp-adapter 共用同一个 status key；它写了 key 时本扩展不画。 */
+export const MCP_STATUS_KEY = "mcp";
+/** 内置 MCP 扩展的资源路径。 */
+export const BUILTIN_MCP_SOURCE = "builtin:mcp";
+const MCP_NAMESPACE_PREFIX = "mcp__";
+
+type McpConfigCacheEntry = { mtimeMs: number; names: string[] };
+
+const configCache = new Map<string, McpConfigCacheEntry>();
+
+export function mcpAgentDir(): string {
+	return process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
+}
+
+/** pi 把 `-` 与 `_` 视作同一个服务器名（`mcpNamespace` 只把 `-` 换成 `_`）。 */
+export function normalizeMcpServerName(name: string): string {
+	return name.trim().replace(/-/g, "_");
+}
+
+/** `mcp__<server>` → `<server>`；不是 MCP 命名空间返回 undefined。 */
+export function mcpNamespaceServer(namespace: string): string | undefined {
+	if (!namespace.startsWith(MCP_NAMESPACE_PREFIX)) return undefined;
+	const server = namespace.slice(MCP_NAMESPACE_PREFIX.length);
+	return server || undefined;
+}
+
+/** 已连接的服务器名（按 namespace 去重，返回规范化名字）。 */
+export function connectedMcpServers(tools: readonly any[]): string[] {
+	const fromBuiltin = new Set<string>();
+	const fromNamespace = new Set<string>();
+	for (const tool of tools ?? []) {
+		if (tool?.exposure === "hidden") continue;
+		const server = mcpNamespaceServer(String(tool?.namespace?.name ?? ""));
+		if (!server) continue;
+		const name = normalizeMcpServerName(server);
+		if (tool?.sourceInfo?.path === BUILTIN_MCP_SOURCE) fromBuiltin.add(name);
+		else fromNamespace.add(name);
+	}
+	// 版本漂移兜底：来源路径对不上时按 namespace 认（接管 /mcp 的扩展已在此之前排除）
+	return [...(fromBuiltin.size > 0 ? fromBuiltin : fromNamespace)];
+}
+
+/** `MCP 2/3`：已连接/（已连接 ∪ 已配置）。两边都空时不显示。 */
+export function formatMcpChip(
+	connected: readonly string[],
+	configured: readonly string[],
+): string | undefined {
+	const connectedNames = new Set(connected.map(normalizeMcpServerName).filter(Boolean));
+	const configuredNames = new Set(configured.map(normalizeMcpServerName).filter(Boolean));
+	const total = new Set([...connectedNames, ...configuredNames]).size;
+	if (total === 0) return undefined;
+	return `MCP ${connectedNames.size}/${total}`;
+}
+
+/** 读一个 mcp.json 里启用中的服务器名；文件缺失或损坏返回 undefined。 */
+function readMcpConfigNames(path: string): string[] | undefined {
+	try {
+		const { mtimeMs } = statSync(path);
+		const cached = configCache.get(path);
+		if (cached && cached.mtimeMs === mtimeMs) return cached.names;
+		const parsed = JSON.parse(readFileSync(path, "utf8")) as { mcpServers?: unknown };
+		const servers = parsed?.mcpServers;
+		const names: string[] = [];
+		if (servers && typeof servers === "object" && !Array.isArray(servers)) {
+			for (const [name, entry] of Object.entries(servers as Record<string, unknown>)) {
+				if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+				if ((entry as { enabled?: unknown }).enabled === false) continue;
+				names.push(name);
+			}
+		}
+		configCache.set(path, { mtimeMs, names });
+		return names;
+	} catch {
+		configCache.delete(path);
+		return undefined;
+	}
+}
+
+/** mcp.json 里启用中的服务器名：用户级，加上已信任时的项目级（同名以项目为准，计数时去重）。 */
+export function configuredMcpServers(options: {
+	agentDir: string;
+	cwd: string;
+	projectTrusted: boolean;
+}): string[] {
+	const names = [...(readMcpConfigNames(join(options.agentDir, "mcp.json")) ?? [])];
+	if (options.projectTrusted) {
+		names.push(...(readMcpConfigNames(join(options.cwd, ".pi", "mcp.json")) ?? []));
+	}
+	return names;
+}
+
+/** 注册了 `/mcp` 的都是内置 MCP；别的扩展接管时它自己会写状态芯片。 */
+export function builtinMcpOwnsCommand(commands: readonly any[]): boolean {
+	const mcpCommands = (commands ?? []).filter((command) => command?.name === MCP_STATUS_KEY);
+	return (
+		mcpCommands.length > 0 &&
+		mcpCommands.every((command) => command?.sourceInfo?.path === BUILTIN_MCP_SOURCE)
+	);
+}
+
+/** footer 渲染用：当前芯片文案（不含 nerd 图标），不适用时返回 undefined。 */
+export function buildMcpChip(ctx: any, api: any): string | undefined {
+	try {
+		// 工具与命令列表在 pi API 上，ctx 只提供 cwd / trust
+		if (!builtinMcpOwnsCommand(api?.getCommands?.() ?? [])) return undefined;
+		const tools = api?.getAllTools?.();
+		if (!Array.isArray(tools)) return undefined;
+		return formatMcpChip(
+			connectedMcpServers(tools),
+			configuredMcpServers({
+				agentDir: mcpAgentDir(),
+				cwd: String(ctx?.cwd ?? process.cwd()),
+				projectTrusted: ctx?.isProjectTrusted?.() === true,
+			}),
+		);
+	} catch {
+		// footer 不能因为读配置或读工具列表失败而中断渲染
+		return undefined;
+	}
+}