pi-cc-extensions 0.8.71 → 0.9.0

package/README.en.md

@@ -43,11 +43,12 @@ Run `/reload` after installation.
 | Settings panel              | `Style / Diff / Thinking / UI / Feature` tabs                                             | `/ccstyle`                                      |
 | Context inspection          | Usage breakdown and previews for the system prompt, memory, skills, tools definition, and messages | `/context`                                      |
 | Session/Subagent references | Search and inject effective context from previous Sessions or existing SubAgents          | `@`                                             |
+| Status bar                  | Two-line chips: model, context, cache, cost, git; requires a Nerd Font                    | `/ccstyle` Feature                              |
 | Theme                       | Bundled CC Dark and CC Light themes                                                       | `/theme`                                        |
 
 ## Configuration
 
-`/ccstyle` behavior is configured through `~/.pi/agent/claude-code-style.json`:
+`/ccstyle` behavior is configured through `~/.pi/agent/pi-cc-extensions.json`:
 
 ```js
 {
@@ -82,7 +83,8 @@ Run `/reload` after installation.
   "enableContextCommand": true,            // /context usage check
   "enableAgentSummary": true,              // per-turn tool summary
   "enableWorkingMessage": true,            // Working... bottom token/elapsed
-  "enableAliases": true                    // /clear, /exit aliases
+  "enableAliases": true,                   // /clear, /exit aliases
+  "enableCustomFooter": true               // two-line chips status bar (needs a Nerd Font)
 }
 ```
 

package/README.md

@@ -43,11 +43,12 @@ pi install git:github.com/minuque/pi-cc-extensions
 | 配置面板              | `Style / Diff / Thinking / UI / Feature` 五页签                                 | `/ccstyle`                                      |
 | 上下文检查            | 查看上下文占用，并预览 System prompt、Memory、Skills、Tools definition 和消息内容 | `/context`                                      |
 | Session/Subagent 引用 | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                             | `@`                                             |
+| 状态栏                | 两行 chips：模型、上下文、缓存、费用、git；需要 Nerd Font                       | `/ccstyle` Feature                              |
 | 主题                  | 随包提供内置 CC Dark、CC Light 主题                                             | `/theme`                                        |
 
 ## 配置
 
-`/ccstyle` 的行为由 `~/.pi/agent/claude-code-style.json` 配置：
+`/ccstyle` 的行为由 `~/.pi/agent/pi-cc-extensions.json` 配置：
 
 ```js
 {
@@ -82,7 +83,8 @@ pi install git:github.com/minuque/pi-cc-extensions
   "enableContextCommand": true,            // /context 上下文检查
   "enableAgentSummary": true,              // 每回合工具摘要
   "enableWorkingMessage": true,            // Working... 底部 token/耗时
-  "enableAliases": true                    // /clear、/exit 别名
+  "enableAliases": true,                   // /clear、/exit 别名
+  "enableCustomFooter": true               // 两行 chips 状态栏（需 Nerd Font）
 }
 ```
 

package/extensions/config/config.ts

@@ -1,5 +1,5 @@
 import type { CompactThinkingConfig } from "../feature/compact-thinking.ts";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
@@ -64,10 +64,12 @@ export type Config = {
 	enableAgentSummary: boolean;
 	enableWorkingMessage: boolean;
 	enableAliases: boolean;
+	enableCustomFooter: boolean;
 };
 
 const AGENT_DIR = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
-const CONFIG_PATH = join(AGENT_DIR, "claude-code-style.json");
+export const CONFIG_PATH = join(AGENT_DIR, "pi-cc-extensions.json");
+const LEGACY_CONFIG_PATH = join(AGENT_DIR, "claude-code-style.json");
 
 export const DIFF_VIEW_MODES: DiffViewMode[] = ["auto", "split", "unified"];
 export const DIFF_INDICATOR_MODES: DiffIndicatorMode[] = ["bars", "classic", "none"];
@@ -125,6 +127,7 @@ export const DEFAULT_CONFIG: Config = {
 	enableAgentSummary: true,
 	enableWorkingMessage: true,
 	enableAliases: true,
+	enableCustomFooter: true,
 };
 
 function pickEnum<T extends string>(value: unknown, allowed: readonly T[], fallback: T): T {
@@ -223,6 +226,7 @@ export function normalizeConfig(input: unknown): Config {
 		enableAgentSummary: source.enableAgentSummary !== false,
 		enableWorkingMessage: source.enableWorkingMessage !== false,
 		enableAliases: source.enableAliases !== false,
+		enableCustomFooter: source.enableCustomFooter !== false,
 	};
 }
 
@@ -276,6 +280,7 @@ export function formatConfigStatus(source: Config = config): string {
 		`agentSummary=${source.enableAgentSummary ? "on" : "off"}`,
 		`workingMsg=${source.enableWorkingMessage ? "on" : "off"}`,
 		`aliases=${source.enableAliases ? "on" : "off"}`,
+		`footer=${source.enableCustomFooter ? "on" : "off"}`,
 	].join(" · ");
 }
 
@@ -284,10 +289,21 @@ export const config: Config = loadConfig();
 
 function loadConfig(): Config {
 	try {
-		const source = existsSync(CONFIG_PATH)
-			? (JSON.parse(readFileSync(CONFIG_PATH, "utf8")) as Record<string, unknown>)
+		const fromLegacy = !existsSync(CONFIG_PATH) && existsSync(LEGACY_CONFIG_PATH);
+		const rawPath = existsSync(CONFIG_PATH) ? CONFIG_PATH : fromLegacy ? LEGACY_CONFIG_PATH : null;
+		const source = rawPath
+			? (JSON.parse(readFileSync(rawPath, "utf8")) as Record<string, unknown>)
 			: {};
-		return normalizeConfig(source);
+		const next = normalizeConfig(source);
+		if (fromLegacy) {
+			try {
+				writeFileSync(CONFIG_PATH, JSON.stringify(next, null, 2));
+				rmSync(LEGACY_CONFIG_PATH, { force: true });
+			} catch {
+				// 新路径写失败时仍使用已读到的旧配置，旧文件保留。
+			}
+		}
+		return next;
 	} catch {
 		// Ignore bad config and fall back to defaults.
 	}

package/extensions/config/panel.ts

@@ -7,6 +7,7 @@
 import { getSettingsListTheme } from "@earendil-works/pi-coding-agent";
 import { Input, SettingsList, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
 import type { CompactThinkingController } from "../feature/compact-thinking.ts";
+import { applyCustomFooter } from "../feature/shell/footer.ts";
 import { applyStartupHeader } from "../feature/shell/startup-header.ts";
 import type { ToolGroupingHooks } from "../renderer/tool/grouping.ts";
 import {
@@ -455,6 +456,13 @@ export async function showCcstylePanel(
 			"Aliases disabled.",
 			config.enableAliases,
 		);
+		const customFooterToggle = featureToggleSetting(
+			"enableCustomFooter",
+			"Status bar",
+			"Two-line chips status bar with model, context, git, and usage. Applies immediately. Needs a Nerd Font.",
+			"Pi native footer restored.",
+			config.enableCustomFooter,
+		);
 		const featureToggles: Record<string, { apply: (on: boolean) => void }> = {
 			enableSessionReference: sessionReferenceToggle,
 			enableSubagentAutocomplete: subagentAutocompleteToggle,
@@ -465,6 +473,13 @@ export async function showCcstylePanel(
 		};
 
 		const onSettingChange = (id: string, value: string) => {
+			if (id === "enableCustomFooter") {
+				updateConfig({ enableCustomFooter: value === "on" });
+				customFooterToggle.apply(value === "on");
+				applyCustomFooter(ctx);
+				ctx.ui.notify(`Updated ${id}: ${value}`, "info");
+				return;
+			}
 			// 额外功能开关：字段名与配置布尔字段一一对应，切换后重启生效。
 			const featureToggle = featureToggles[id];
 			if (featureToggle) {
@@ -658,6 +673,7 @@ export async function showCcstylePanel(
 					agentSummaryToggle.setting,
 					workingMessageToggle.setting,
 					aliasesToggle.setting,
+					customFooterToggle.setting,
 				],
 			},
 		];

package/extensions/feature/shell/footer.ts

@@ -0,0 +1,429 @@
+/**
+ * 自定义底栏：chips + zentui 图标/句子
+ *
+ * 第一行：model  thinking · ██████░░░░ 45%/200k · 󰆼 42% · $0.01 · 用量
+ * 第二行：cwd in session on  branch (+16 −1) · 其他扩展状态
+ *
+ *  - 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";
+
+const GIT_REFRESH_INTERVAL_MS = 10_000;
+const USAGE_REFRESH_INTERVAL_MS = 5 * 60 * 1000;
+const USAGE_TIMEOUT_MS = 15_000;
+// zentui NERD_DEFAULT_ICONS：git / cacheHit
+const ICON_GIT = "";
+const ICON_CACHE = "󰆼";
+
+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 classifyStatus(key: string): "usage" | "skip" | "other" {
+	if (key === "model") return "skip"; // line1 已有供应商/模型
+	if (/usage|quota|balance/i.test(key)) return "usage";
+	return "other";
+}
+
+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;
+}
+
+export function pickFooterUsageText(
+	pluginUsage: string | undefined,
+	localChip: string | undefined,
+): string | undefined {
+	const plugin = pluginUsage?.trim();
+	if (plugin && !/^checking$/i.test(plugin)) return plugin;
+	const local = localChip?.trim();
+	return local || undefined;
+}
+
+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;
+
+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?.();
+
+		// 分支变化时同步更新分支名和相对 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);
+
+			const otherStatuses: string[] = [];
+			const usageStatuses: string[] = [];
+			for (const [key, raw] of Array.from(
+				footerData.getExtensionStatuses().entries() as Iterable<[string, string]>,
+			).sort(([a], [b]) => a.localeCompare(b))) {
+				const t = raw.replace(/[\r\n\t]+/g, " ").trim();
+				if (!t) continue;
+				const kind = classifyStatus(key);
+				if (kind === "skip") continue;
+				if (kind === "usage") {
+					usageStatuses.push(stripAnsi(t));
+				} else {
+					otherStatuses.push(theme.fg("dim", stripAnsi(t)));
+				}
+			}
+
+			const usageText = pickFooterUsageText(usageStatuses[0], localUsageChip);
+
+			const pctLabel = percent === null || percent === undefined ? "?" : `${Math.floor(percent)}%`;
+			const cachePct = getCachePct();
+			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)}`),
+				cachePct > 0 ? theme.fg("dim", `${ICON_CACHE} ${Math.floor(cachePct)}%`) : "",
+				costChip,
+				usageText ? colorUsageChip(theme, usageText) : "",
+			]);
+
+			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", ")")
+						: "";
+				place += theme.fg("muted", " on ") + gitColor(`${ICON_GIT} ${branch}`) + stats;
+			}
+			const line2 = joinChips([place, ...otherStatuses]);
+
+			return [truncateToWidth(line1, width), ...(line2 ? [truncateToWidth(line2, width)] : [])];
+		};
+
+		return {
+			render,
+			invalidate(): void {
+				tui.requestRender();
+			},
+			dispose(): void {
+				disposed = true;
+				usageAbort?.abort();
+				usageAbort = undefined;
+				clearInterval(gitRefreshTimer);
+				clearInterval(usageRefreshTimer);
+				unsubBranch();
+				if (currentTui === tui) {
+					currentTui = undefined;
+					refreshCurrentGitStats = undefined;
+					refreshCurrentUsage = undefined;
+				}
+			},
+		};
+	};
+
+/**
+ * 按配置应用底栏：on → 自定义 footer；off → 恢复官方默认 footer。
+ * 导出供 /ccstyle 面板在切换开关时实时重应用。
+ */
+export function applyCustomFooter(ctx: ExtensionContext): void {
+	if (!ctx?.hasUI || typeof ctx.ui?.setFooter !== "function") return;
+	if (!config.enableCustomFooter) {
+		ctx.ui.setFooter(undefined);
+		return;
+	}
+	try {
+		ctx.ui.setFooter(createCustomFooterFactory(ctx));
+	} catch (err) {
+		ctx.ui.notify(`footer error: ${err instanceof Error ? err.message : String(err)}`, "error");
+	}
+}
+
+export default function (pi: ExtensionAPI) {
+	// 模型/思考级别变化时强制重渲染（自定义 footer 不会被内置 invalidate() 触达）
+	pi.on("model_select", () => {
+		currentTui?.requestRender();
+		refreshCurrentUsage?.();
+	});
+	pi.on("thinking_level_select", () => currentTui?.requestRender());
+	// 工具执行完成后立即刷新；定时器只负责兜底捕获外部文件变化。
+	pi.on("tool_execution_end", () => refreshCurrentGitStats?.());
+
+	// 启动 / /reload / 新建会话 时按配置恢复
+	pi.on("session_start", (_event, ctx) => {
+		applyCustomFooter(ctx);
+	});
+}

package/extensions/index.ts

@@ -4,6 +4,7 @@ import { config } from "./config/config.ts";
 // shell
 import piAliases from "./feature/shell/aliases.ts";
 import { installFlushDockedBash } from "./feature/shell/flush-docked-bash.ts";
+import customFooter from "./feature/shell/footer.ts";
 import piStartupHeader from "./feature/shell/startup-header.ts";
 import workingMessage from "./feature/shell/working-message.ts";
 
@@ -24,6 +25,7 @@ export default function (pi: ExtensionAPI): void {
 	installFlushDockedBash();
 	piStartupHeader(pi);
 	if (config.enableWorkingMessage) workingMessage(pi);
+	customFooter(pi);
 
 	// render stack：thinking controller 直接交给 style 作 query
 	markdownEnhance(pi);

package/extensions/renderer/compact-mode.ts

@@ -327,6 +327,7 @@ function layoutExpandedToolCard(
 	theme: any,
 	children: any[],
 	width: number,
+	paints?: string[][],
 ): { lines: string[]; hits: Array<{ child: any; start: number; end: number }> } {
 	const slot = "userMessageBg";
 	const toolBgAnsi = darkenBgAnsi(theme, slot);
@@ -337,8 +338,10 @@ function layoutExpandedToolCard(
 	lines.push(paddedBackgroundRow(theme, slot, "", width));
 	// 展开不再显示摘要行：跳过第一个 child 的首行空白，避免白占一行
 	let skipLeadingBlank = true;
-	for (const child of children) {
-		const childLines = child.render(innerWidth);
+	for (let childIndex = 0; childIndex < children.length; childIndex++) {
+		const child = children[childIndex];
+		const painted = paints?.[childIndex];
+		const childLines = Array.isArray(painted) ? painted : child.render(innerWidth);
 		// 展开的 thinking 与 tool 一样走嵌套深色卡，避免贴在外卡同色底上看不见。
 		const nest = child.__ccToolCard || (isThinkingPreview(child) && child.expanded === true);
 		if (!nest) {
@@ -401,21 +404,56 @@ function compactRoundCard(
 			});
 		}
 	}
+	let paint:
+		| {
+				width: number;
+				theme: unknown;
+				paints: unknown[];
+				lines: string[];
+				hits: Array<{ child: any; start: number; end: number }>;
+		  }
+		| undefined;
+	const layout = (width: number) => {
+		const theme = themeOf();
+		const innerWidth = Math.max(0, width - 2);
+		const paints = children.map((child) => {
+			const lines = child.render?.(innerWidth);
+			return Array.isArray(lines) ? lines : [];
+		});
+		if (
+			paint &&
+			paint.width === width &&
+			paint.theme === theme &&
+			paint.paints.length === paints.length &&
+			paint.paints.every((item, index) => item === paints[index])
+		) {
+			return paint;
+		}
+		const laid = layoutExpandedToolCard(theme, children, width, paints);
+		paint = {
+			width,
+			theme,
+			paints,
+			lines: ["", ...laid.lines],
+			hits: laid.hits,
+		};
+		return paint;
+	};
 	return {
 		children,
 		render(width: number): string[] {
-			return ["", ...layoutExpandedToolCard(themeOf(), children, width).lines];
+			return layout(width).lines;
 		},
 		childAtRow(localRow: number, width: number) {
 			if (localRow < 1) return null;
 			const row = localRow - 1;
-			const { hits } = layoutExpandedToolCard(themeOf(), children, width);
-			for (const hit of hits) {
+			for (const hit of layout(width).hits) {
 				if (row >= hit.start && row < hit.end) return hit.child;
 			}
 			return null;
 		},
 		invalidate() {
+			paint = undefined;
 			for (const child of children) child.invalidate?.();
 		},
 	};
@@ -553,14 +591,77 @@ const compactRichDiffCache = new WeakMap<
 	{ result: unknown; collapsed?: unknown; expanded?: unknown }
 >();
 
+type CompactEditPaintHit = {
+	width: number;
+	theme: unknown;
+	expanded: boolean;
+	result: unknown;
+	isPartial: boolean;
+	args: unknown;
+	hover: boolean;
+	ioHover: unknown;
+	lines: string[];
+};
+const compactEditPaintCache = new WeakMap<object, CompactEditPaintHit>();
+
+function compactEditIoHover(component: any): unknown {
+	const view = component?.resultRendererComponent;
+	return typeof view?.getHoveredSection === "function" ? view.getHoveredSection() : null;
+}
+
 /**
  * compact edit/write：标题行 + mode=on 同一套 rich diff。
  * 折叠/展开都走 `renderRichToolResult`，limits 不另开一套。
+ * 已完成的结果跨帧复用行；pending 不缓存，避免 loader 动画冻住。
  */
 function compactEditWriteLines(
 	component: any,
 	width: number,
 	writeMetadata?: WriteExecutionMetadataStore,
+): string[] {
+	const expanded = component.expanded === true;
+	const isPartial = component.isPartial === true;
+	const pending = !component.result || isPartial;
+	const hover = isToolCallHovered(component.toolCallId);
+	const ioHover = compactEditIoHover(component);
+	const theme = themeOf();
+	if (!pending) {
+		const hit = compactEditPaintCache.get(component);
+		if (
+			hit &&
+			hit.width === width &&
+			hit.theme === theme &&
+			hit.expanded === expanded &&
+			hit.result === component.result &&
+			hit.isPartial === isPartial &&
+			hit.args === component.args &&
+			hit.hover === hover &&
+			hit.ioHover === ioHover
+		) {
+			return hit.lines;
+		}
+	}
+	const lines = paintCompactEditWrite(component, width, writeMetadata);
+	if (!pending) {
+		compactEditPaintCache.set(component, {
+			width,
+			theme,
+			expanded,
+			result: component.result,
+			isPartial,
+			args: component.args,
+			hover,
+			ioHover: compactEditIoHover(component),
+			lines,
+		});
+	}
+	return lines;
+}
+
+function paintCompactEditWrite(
+	component: any,
+	width: number,
+	writeMetadata?: WriteExecutionMetadataStore,
 ): string[] {
 	const theme = themeOf();
 	const result = component.result;
@@ -656,15 +757,45 @@ function compactAssistantLineComponent(
 	options: { hint?: boolean; leadingBlank?: boolean; pad?: number } = {},
 ): any {
 	const self = component as any;
+	let paint:
+		| {
+				width: number;
+				theme: unknown;
+				resolved: string;
+				hover: boolean;
+				hint: boolean;
+				pad: number;
+				frame: number;
+				leadingBlank: boolean;
+				lines: string[];
+		  }
+		| undefined;
 	return {
 		render(width: number): string[] {
 			const theme = themeOf();
 			const pad = Math.max(0, options.pad ?? (Number(self.outputPad) || 0));
 			const available = Math.max(0, width - pad);
-			const hintText = options.hint === false ? "" : ` • ${showMoreHintText()}`;
+			const hint = options.hint !== false;
+			const hintText = hint ? ` • ${showMoreHintText()}` : "";
 			const summaryWidth = Math.max(0, available - visibleWidth(hintText));
 			const resolved = typeof summary === "function" ? summary() : summary;
 			const runningActive = resolved.startsWith("Running...");
+			const hover = hoveredAssistantComponent === component;
+			const frame = runningActive ? (query?.getThinkingAnimationFrame?.() ?? 0) : 0;
+			const leadingBlank = options.leadingBlank !== false;
+			if (
+				paint &&
+				paint.width === width &&
+				paint.theme === theme &&
+				paint.resolved === resolved &&
+				paint.hover === hover &&
+				paint.hint === hint &&
+				paint.pad === pad &&
+				paint.frame === frame &&
+				paint.leadingBlank === leadingBlank
+			) {
+				return paint.lines;
+			}
 			const plainText = truncateToWidth(resolved, summaryWidth, "…");
 			let text = theme.fg("muted", plainText);
 			if (runningActive || plainText.startsWith("Ran for ")) {
@@ -684,12 +815,26 @@ function compactAssistantLineComponent(
 					text = `${styleCompactThinkingText(heading, theme)}${theme.fg("muted", tools)}`;
 				}
 			}
-			const hintColor = hoveredAssistantComponent === component ? "text" : "dim";
+			const hintColor = hover ? "text" : "dim";
 			const line = `${text}${hintText ? theme.fg(hintColor, hintText) : ""}`;
 			const rendered = `${" ".repeat(pad)}${truncateToWidth(line, available, "")}`;
-			return options.leadingBlank === false ? [rendered] : ["", rendered];
+			const lines = leadingBlank ? ["", rendered] : [rendered];
+			paint = {
+				width,
+				theme,
+				resolved,
+				hover,
+				hint,
+				pad,
+				frame,
+				leadingBlank,
+				lines,
+			};
+			return lines;
+		},
+		invalidate() {
+			paint = undefined;
 		},
-		invalidate() {},
 	};
 }
 

package/extensions/renderer/default-mode.ts

@@ -58,6 +58,17 @@ type ToolRenderMethods = {
 	getResultRenderer: (...args: any[]) => any;
 };
 
+type ToolPaintHit = {
+	width: number;
+	expanded: boolean;
+	isPartial: boolean;
+	result: unknown;
+	args: unknown;
+	callHover: boolean;
+	ioHover: string | null;
+	lines: string[];
+};
+
 type GlobalToolRenderPatch = {
 	version: 2;
 	prototype: any;
@@ -68,6 +79,11 @@ type GlobalToolRenderPatch = {
 	byName: Map<string, any>;
 	downstream: ToolRenderMethods;
 	installed: ToolRenderMethods;
+	originalRender?: (width: number) => string[];
+	originalInvalidate?: () => void;
+	renderPaint?: (width: number) => string[];
+	invalidatePaint?: () => void;
+	paintCache?: WeakMap<object, ToolPaintHit>;
 };
 
 type ToolExpandedBackgroundPatch = {
@@ -478,12 +494,38 @@ function disconnectGlobalToolRenderPatch(patch: GlobalToolRenderPatch | undefine
 	patch.byName.clear();
 }
 
+function ioHoverOf(tool: any): string | null {
+	const view = tool?.resultRendererComponent;
+	if (!view || typeof view.getHoveredSection !== "function") return null;
+	return view.getHoveredSection();
+}
+
+function toolPaintMatches(hit: ToolPaintHit, tool: any, width: number): boolean {
+	return (
+		hit.width === width &&
+		hit.expanded === Boolean(tool.expanded) &&
+		hit.isPartial === Boolean(tool.isPartial) &&
+		hit.result === tool.result &&
+		hit.args === tool.args &&
+		hit.callHover === isToolCallHovered(tool.toolCallId) &&
+		hit.ioHover === ioHoverOf(tool)
+	);
+}
+
 function installGlobalToolRendering(
 	writeExecutionMetadata: WriteExecutionMetadataStore,
 ): GlobalToolRenderPatch {
 	const prototype = (ToolExecutionComponent as any).prototype;
 	const previous = patchRegistry.get<GlobalToolRenderPatch>(GLOBAL_TOOL_RENDER_PATCH);
 	const downstream = downstreamForGlobalToolInstall(prototype, previous);
+	const originalRender =
+		previous?.originalRender && prototype.render === previous.renderPaint
+			? previous.originalRender
+			: prototype.render;
+	const originalInvalidate =
+		previous?.originalInvalidate && prototype.invalidate === previous.invalidatePaint
+			? previous.originalInvalidate
+			: prototype.invalidate;
 	if (isOwnershipAwarePatch(previous)) disconnectGlobalToolRenderPatch(previous);
 
 	const patch: GlobalToolRenderPatch = {
@@ -496,6 +538,9 @@ function installGlobalToolRendering(
 		byName: new Map(),
 		downstream,
 		installed: undefined as any,
+		originalRender,
+		originalInvalidate,
+		paintCache: new WeakMap(),
 	};
 
 	patch.installed = {
@@ -532,6 +577,33 @@ function installGlobalToolRendering(
 	prototype.getRenderShell = patch.installed.getRenderShell;
 	prototype.getCallRenderer = patch.installed.getCallRenderer;
 	prototype.getResultRenderer = patch.installed.getResultRenderer;
+	// fullscreen 滚动/选区每帧整树 render；内容未变时复用上一帧行，避免重做 diff/Box。
+	patch.renderPaint = function (this: any, width: number): string[] {
+		if (!patch.active || patch.mode() === "off") {
+			return originalRender.call(this, width);
+		}
+		const cache = patch.paintCache;
+		const hit = cache?.get(this);
+		if (hit && toolPaintMatches(hit, this, width)) return hit.lines;
+		const lines = originalRender.call(this, width);
+		cache?.set(this, {
+			width,
+			expanded: Boolean(this.expanded),
+			isPartial: Boolean(this.isPartial),
+			result: this.result,
+			args: this.args,
+			callHover: isToolCallHovered(this.toolCallId),
+			ioHover: ioHoverOf(this),
+			lines,
+		});
+		return lines;
+	};
+	patch.invalidatePaint = function (this: any): void {
+		patch.paintCache?.delete(this);
+		originalInvalidate.call(this);
+	};
+	prototype.render = patch.renderPaint;
+	prototype.invalidate = patch.invalidatePaint;
 	patchRegistry.install(GLOBAL_TOOL_RENDER_PATCH, patch);
 	return patch;
 }
@@ -552,6 +624,16 @@ function deactivateGlobalToolRendering(patch: GlobalToolRenderPatch): void {
 	if (prototype.getResultRenderer === patch.installed.getResultRenderer) {
 		prototype.getResultRenderer = patch.downstream.getResultRenderer;
 	}
+	if (patch.renderPaint && prototype.render === patch.renderPaint && patch.originalRender) {
+		prototype.render = patch.originalRender;
+	}
+	if (
+		patch.invalidatePaint &&
+		prototype.invalidate === patch.invalidatePaint &&
+		patch.originalInvalidate
+	) {
+		prototype.invalidate = patch.originalInvalidate;
+	}
 }
 
 /** 展开面板背景统一为 user message 背景色；折叠行保持原生状态色。

package/extensions/renderer/mouse/interaction.ts

@@ -18,6 +18,7 @@ import {
 import {
 	collectToolComponents,
 	extractToolFramePlacements,
+	isSgrIdleMotion,
 	isSgrLeftPress,
 	isSgrLeftRelease,
 	isToolExecutionComponent,
@@ -138,7 +139,7 @@ function tryOpenToolIoShowMore(region: InteractionRegion): boolean {
 }
 
 function updateToolSummaryHover(tui: any, packet: SgrMousePacket): void {
-	if ((packet.code & 32) === 0 || packet.final !== "M") return;
+	if (!isSgrIdleMotion(packet)) return;
 	const region = interactionRegionAt(packet);
 	const nextScrollButtonHovered = region?.kind === "scroll-bottom";
 	const scrollButtonChanged = setScrollButtonHovered(nextScrollButtonHovered);
@@ -404,7 +405,7 @@ function handleFullscreenToolClick(tui: any, packet: SgrMousePacket): boolean {
  * expanded 卡截断头 show-more、回到底部按钮。motion 不 consume，官方链照常。
  */
 function handleFullscreenToolHover(tui: any, packet: SgrMousePacket): void {
-	if (packet.final !== "M") return;
+	if (!isSgrIdleMotion(packet)) return;
 	const layout = tui.currentLayout;
 	if (!layout?.root) return;
 	const x = packet.col - 1;
@@ -502,7 +503,8 @@ function patchFullscreenViewportInput(tui: any): void {
 					if (isSgrLeftPress(packet) && handleFullscreenToolClick(tui, packet)) {
 						return { consume: true };
 					}
-					if ((packet.code & 32) !== 0 && packet.final === "M") {
+					// 仅无按键移动走 hover；左键拖动（文本多选）放行官方选区，避免每像素命中+重绘。
+					if (isSgrIdleMotion(packet)) {
 						handleFullscreenToolHover(tui, packet);
 					}
 				}

package/extensions/renderer/mouse/packets.ts

@@ -8,6 +8,7 @@ export {
 	parseSgrMousePackets,
 	isSgrLeftPress,
 	isSgrLeftRelease,
+	isSgrIdleMotion,
 	type SgrMousePacket,
 } from "../../utils/sgr-mouse.ts";
 

package/extensions/renderer/tool/grouping.ts

@@ -173,6 +173,15 @@ type SettledGroupCache = {
 	lines: string[];
 };
 
+type ExpandedGroupCache = {
+	width: number;
+	hover: boolean;
+	theme: unknown;
+	fullscreen: boolean;
+	paints: readonly unknown[];
+	lines: string[];
+};
+
 export class ToolGroupComponent extends Container {
 	readonly toolCallId = `ccstyle-tool-group-${nextGroupId++}`;
 	readonly toolName = "Tool group";
@@ -183,8 +192,10 @@ export class ToolGroupComponent extends Container {
 	}
 	private hintHovered = false;
 	private readonly patch: Patch;
-	/** 仅缓存已完成且折叠的分组；pending / expanded 每帧现算。 */
+	/** 仅缓存已完成且折叠的分组；pending 每帧现算。 */
 	private settledCache: SettledGroupCache | undefined;
+	/** 展开分组：子工具 paint 引用未变则复用整卡行。 */
+	private expandedPaintCache: ExpandedGroupCache | undefined;
 
 	constructor(patch: Patch) {
 		super();
@@ -192,14 +203,19 @@ export class ToolGroupComponent extends Container {
 		patch.groups.add(this);
 	}
 
-	addTool(tool: any): void {
+	private clearPaintCache(): void {
 		this.settledCache = undefined;
+		this.expandedPaintCache = undefined;
+	}
+
+	addTool(tool: any): void {
+		this.clearPaintCache();
 		this.children.push(tool);
 		tool[PARENT_KEY] = this;
 	}
 
 	releaseTools(): any[] {
-		this.settledCache = undefined;
+		this.clearPaintCache();
 		const tools = [...this.children];
 		this.children.length = 0;
 		this.patch.groups.delete(this);
@@ -207,21 +223,21 @@ export class ToolGroupComponent extends Container {
 	}
 
 	removeTool(tool: any): void {
-		this.settledCache = undefined;
+		this.clearPaintCache();
 		const index = this.children.indexOf(tool);
 		if (index >= 0) this.children.splice(index, 1);
 		if (tool?.[PARENT_KEY] === this) delete tool[PARENT_KEY];
 	}
 
 	setExpanded(expanded: boolean): void {
-		if (this._expanded !== expanded) this.settledCache = undefined;
+		if (this._expanded !== expanded) this.clearPaintCache();
 		this._expanded = expanded;
 		for (const tool of this.children)
 			(tool as Component & { setExpanded?: (expanded: boolean) => void }).setExpanded?.(expanded);
 	}
 
 	setHintHovered(hovered: boolean): void {
-		if (this.hintHovered !== hovered) this.settledCache = undefined;
+		if (this.hintHovered !== hovered) this.clearPaintCache();
 		this.hintHovered = hovered;
 	}
 
@@ -250,7 +266,7 @@ export class ToolGroupComponent extends Container {
 	}
 
 	invalidate(): void {
-		this.settledCache = undefined;
+		this.clearPaintCache();
 		for (const tool of this.children) tool.invalidate?.();
 	}
 
@@ -330,6 +346,23 @@ export class ToolGroupComponent extends Container {
 			),
 		];
 		const total = this.children.length;
+		const childPaints = this._expanded
+			? (this.children as any[]).map((tool) => tool.render?.(Math.max(1, width - 2)))
+			: undefined;
+		if (this._expanded && childPaints) {
+			const expandedHit = this.expandedPaintCache;
+			if (
+				expandedHit &&
+				expandedHit.width === width &&
+				expandedHit.hover === this.hintHovered &&
+				expandedHit.theme === this.patch.theme &&
+				expandedHit.fullscreen === isToolTuiFullscreen() &&
+				expandedHit.paints.length === childPaints.length &&
+				expandedHit.paints.every((paint, index) => paint === childPaints[index])
+			) {
+				return expandedHit.lines;
+			}
+		}
 		const expandedLines: string[] = [];
 		for (let index = 0; index < total; index++) {
 			const tool = this.children[index];
@@ -351,7 +384,7 @@ export class ToolGroupComponent extends Container {
 				);
 				continue;
 			}
-			const rendered = visibleLines(tool.render(Math.max(1, width - 2)));
+			const rendered = visibleLines(Array.isArray(childPaints?.[index]) ? childPaints[index] : []);
 			if (rendered.length) {
 				rendered[0] = stripLeadingStatusIcon(rendered[0])
 					.replace(/^ +/, "")
@@ -376,6 +409,14 @@ export class ToolGroupComponent extends Container {
 				lines.push(paddedBackgroundRow(theme, backgroundSlot, line, width));
 			}
 			lines.push(paddedBackgroundRow(theme, backgroundSlot, "", width));
+			this.expandedPaintCache = {
+				width,
+				hover: this.hintHovered,
+				theme: this.patch.theme,
+				fullscreen: isToolTuiFullscreen(),
+				paints: childPaints ?? [],
+				lines,
+			};
 		} else if (counts.pending === 0) {
 			this.storeSettledCache(width, lines);
 		}

package/extensions/renderer/tool/result.ts

@@ -11,13 +11,13 @@ export function toolViewportWidth(width: number): number {
 	return Math.max(1, Math.floor(width * TOOL_VIEWPORT_WIDTH_RATIO));
 }
 
-/** 与默认工具结果相同的一级缩进包装。 */
+/** 与默认工具结果相同的一级缩进包装。子组件只扣始终加上的 1 列；↳ 行多出的 2 列由 truncateToWidth 吃掉。 */
 export function insetComponent(component: any): any {
 	return {
 		render: (width: number) =>
 			component.render(Math.max(1, width - 1)).map((line: string) => {
 				const nestedMarker = line.replace(/^((?:\x1b\[[0-?]*[ -/]*[@-~])*)↳/, "$1  ↳");
-				return ` ${nestedMarker}`;
+				return truncateToWidth(` ${nestedMarker}`, Math.max(0, width), "");
 			}),
 		invalidate: () => component.invalidate?.(),
 	};
@@ -309,6 +309,10 @@ export class ExpandedToolIoView {
 		this.invalidate();
 	}
 
+	getHoveredSection(): ToolIoSection | null {
+		return this.hoveredSection;
+	}
+
 	/** True when the plain truncation footer carries show-more. Input 续行带 │，Output 不带。 */
 	matchShowMoreLine(plainLine: string): ToolIoSection | null {
 		const line = plainLine.replace(/\x1b\[[0-9;]*m/g, "");

package/extensions/utils/sgr-mouse.ts

@@ -59,6 +59,11 @@ export function isSgrLeftRelease(packet: SgrMousePacket): boolean {
 	return packet.final === "m" && baseButton === 0 && (packet.code & 32) === 0;
 }
 
+/** 无按键按住的指针移动（DECSET 1003 的 35）。左键拖动（32，文本选区）不是 hover。 */
+export function isSgrIdleMotion(packet: SgrMousePacket): boolean {
+	return packet.final === "M" && (packet.code & 32) !== 0 && mouseBaseButton(packet.code) === 3;
+}
+
 /** 剥离修饰键位（4/8/16/32：shift/meta/ctrl/motion），得到基础按键码。 */
 export function mouseBaseButton(code: number): number {
 	return code & ~(4 | 8 | 16 | 32);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-cc-extensions",
-	"version": "0.8.71",
+	"version": "0.9.0",
 	"license": "MIT",
 	"description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
 	"type": "module",