pi-cc-extensions 0.8.70 → 0.8.72

package/README.en.md

@@ -43,6 +43,7 @@ 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
@@ -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,6 +43,7 @@ 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`                                        |
 
 ## 配置
@@ -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

@@ -64,6 +64,7 @@ export type Config = {
 	enableAgentSummary: boolean;
 	enableWorkingMessage: boolean;
 	enableAliases: boolean;
+	enableCustomFooter: boolean;
 };
 
 const AGENT_DIR = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
@@ -125,6 +126,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 +225,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 +279,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(" · ");
 }
 

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,413 @@
+/**
+ * 自定义底栏：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 { 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;
+
+async function getPiUsage(): Promise<any | null> {
+	if (piUsageMod !== undefined) return piUsageMod;
+	try {
+		const spec = "@narumitw/pi-usage";
+		piUsageMod = await import(spec);
+	} catch {
+		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);