@cnife/pi-footer 0.1.0

package/README.md

@@ -0,0 +1,26 @@
+# @cnife/pi-footer
+
+个人专属 pi footer。两行布局，全 dim，仅 ASCII + Unicode（无 nerd font），无配置。
+
+> 个人扩展。安装：`pi install npm:@cnife/pi-footer`
+
+## 布局
+
+```text
+<目录> · <分支> ↑<ahead> ↓<behind> *<未提交数> · <会话名>
+<provider>/<model_id> · <思考强度> · <已用>/<总量> (<百分比>) · $<花费>
+```
+
+- 各项 ` · ` 分隔，空值自动省略（无 git 段、无会话名、cost=0 等均不显示）
+- git：`main ↑1 ↓2 *3`，ahead/behind/未提交数为 0 时隐藏
+- cost：`<0.01` 用 3 位小数，否则 2 位；为 0 时整项隐藏
+- token：`<1000` 原值，`<1M` 用 `X.XK`，`≥1M` 用 `X.XM`
+
+## 刷新
+
+- git 状态：10s 定时器 + `tool_result`（agent 工具执行后即时）+ `user_bash`（`!`/`!!` 命令后 1.5s debounce）+ `onBranchChange`
+- 其余字段随 pi 内部状态自动重渲染
+
+## 字符约束
+
+仅 ASCII + Unicode 基本平面字符（`· ↑ ↓ *`），不依赖 nerd font。

package/extensions/cnife-footer.ts

@@ -0,0 +1,206 @@
+/**
+ * cnife-footer - 个人专属 pi footer。
+ * 两行：第一行工作区（目录 · git分支 ↑ahead ↓behind *未提交 · 会话名），
+ *       第二行模型（provider/id · thinking · ctx · $cost）。
+ * 全 dim，仅 ASCII + Unicode，无 nerd font，无配置。
+ */
+
+import { basename } from "node:path";
+import type { AssistantMessage } from "@earendil-works/pi-ai";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth } from "@earendil-works/pi-tui";
+
+interface GitState {
+  branch: string | null;
+  ahead: number;
+  behind: number;
+  dirty: number;
+}
+
+const SEP = " · ";
+const GIT_INTERVAL_MS = 10_000;
+const BASH_REFRESH_DELAY_MS = 1500;
+
+function fmt(n: number): string {
+  if (n < 1000) return String(n);
+  if (n < 1_000_000) return `${(n / 1000).toFixed(1)}K`;
+  return `${(n / 1_000_000).toFixed(1)}M`;
+}
+
+function fmtCost(c: number): string {
+  return c < 0.01 ? `$${c.toFixed(3)}` : `$${c.toFixed(2)}`;
+}
+
+/** Parse `git status -b --porcelain` output into branch/ahead/behind/dirty. */
+function parseGitStatus(stdout: string): GitState {
+  const lines = stdout.split("\n");
+  const header = lines[0] ?? "";
+  let branch: string | null = null;
+  let ahead = 0;
+  let behind = 0;
+
+  // Header forms:
+  //   ## main
+  //   ## main...origin/main
+  //   ## main...origin/main [ahead 1]
+  //   ## main...origin/main [ahead 1, behind 2]
+  //   ## main...origin/main [gone]
+  //   ## HEAD (no branch)            -> detached
+  //   ## No commits yet on main
+  const m = header.match(
+    /^## (?:HEAD \(no branch\)|No commits yet on (\S+)|(.+?)(?:\.\.\.\S+)?(?: \[(.+)\])?)$/,
+  );
+  if (m) {
+    branch = m[1] ?? m[2] ?? null;
+    const bracket = m[3];
+    if (bracket) {
+      const a = bracket.match(/ahead (\d+)/);
+      const b = bracket.match(/behind (\d+)/);
+      if (a) ahead = Number(a[1]);
+      if (b) behind = Number(b[1]);
+    }
+  }
+
+  let dirty = 0;
+  for (let i = 1; i < lines.length; i++) {
+    const l = lines[i];
+    if (l && !l.startsWith("##")) dirty++;
+  }
+
+  return { branch, ahead, behind, dirty };
+}
+
+export default function (pi: ExtensionAPI) {
+  let gitState: GitState = { branch: null, ahead: 0, behind: 0, dirty: 0 };
+  let activeTui: { requestRender(): void } | undefined;
+  let timer: ReturnType<typeof setInterval> | undefined;
+  let bashRefreshTimer: ReturnType<typeof setTimeout> | undefined;
+  let refreshing = false;
+  let cwd = "";
+
+  const refreshGit = async () => {
+    if (refreshing) return;
+    refreshing = true;
+    try {
+      const result = await pi
+        .exec("git", ["status", "-b", "--porcelain"], { cwd })
+        .catch(() => undefined);
+      if (result === undefined) {
+        gitState = { branch: null, ahead: 0, behind: 0, dirty: 0 };
+      } else {
+        gitState = parseGitStatus(result.stdout);
+      }
+      activeTui?.requestRender();
+    } finally {
+      refreshing = false;
+    }
+  };
+
+  pi.on("session_start", async (_event, ctx) => {
+    cwd = ctx.cwd;
+    gitState = { branch: null, ahead: 0, behind: 0, dirty: 0 };
+
+    ctx.ui.setFooter((tui, theme, footerData) => {
+      activeTui = tui;
+      const unsub = footerData.onBranchChange(() => {
+        void refreshGit();
+      });
+
+      const renderLine = (parts: string[], width: number): string => {
+        const joined = parts.filter((p) => p.length > 0).join(SEP);
+        return truncateToWidth(
+          theme.fg("dim", joined),
+          width,
+          theme.fg("dim", "..."),
+        );
+      };
+
+      return {
+        dispose() {
+          unsub();
+        },
+        invalidate() {},
+        render(width: number): string[] {
+          try {
+            // Line 1: dir · [branch ↑a ↓b *d] · session
+            const dir = basename(cwd) || cwd;
+            const gitParts: string[] = [];
+            if (gitState.branch) {
+              gitParts.push(gitState.branch);
+              if (gitState.ahead > 0) gitParts.push(`↑${gitState.ahead}`);
+              if (gitState.behind > 0) gitParts.push(`↓${gitState.behind}`);
+              if (gitState.dirty > 0) gitParts.push(`*${gitState.dirty}`);
+            }
+            const gitStr = gitParts.join(" ");
+            const session = pi.getSessionName() ?? "";
+            const line1 = renderLine([dir, gitStr, session], width);
+
+            // Line 2: provider/id · thinking · ctx · $cost (cost=0 隐藏)
+            const model = ctx.model
+              ? `${ctx.model.provider}/${ctx.model.id}`
+              : "no-model";
+            const thinking = pi.getThinkingLevel();
+
+            let cost = 0;
+            for (const e of ctx.sessionManager.getEntries()) {
+              if (e.type === "message" && e.message.role === "assistant") {
+                cost += (e.message as AssistantMessage).usage.cost.total;
+              }
+            }
+
+            const usage = ctx.getContextUsage();
+            let ctxStr: string;
+            if (usage?.contextWindow) {
+              const used = usage.tokens ?? 0;
+              const pctStr =
+                usage.percent !== null && usage.percent !== undefined
+                  ? `${usage.percent.toFixed(1)}%`
+                  : "?";
+              ctxStr = `${fmt(used)}/${fmt(usage.contextWindow)} (${pctStr})`;
+            } else {
+              ctxStr = "?";
+            }
+
+            const costStr = cost > 0 ? fmtCost(cost) : "";
+            const line2 = renderLine([model, thinking, ctxStr, costStr], width);
+
+            return [line1, line2];
+          } catch {
+            return [theme.fg("dim", "footer error")];
+          }
+        },
+      };
+    });
+
+    void refreshGit();
+    timer = setInterval(() => {
+      void refreshGit();
+    }, GIT_INTERVAL_MS);
+  });
+
+  // agent 工具执行后立即刷新 git
+  pi.on("tool_result", async () => {
+    void refreshGit();
+  });
+
+  // `!`/`!!` 命令执行后延迟刷新（debounce，等命令执行完）
+  pi.on("user_bash", () => {
+    if (bashRefreshTimer) clearTimeout(bashRefreshTimer);
+    bashRefreshTimer = setTimeout(() => {
+      bashRefreshTimer = undefined;
+      void refreshGit();
+    }, BASH_REFRESH_DELAY_MS);
+  });
+
+  pi.on("session_shutdown", () => {
+    if (timer) {
+      clearInterval(timer);
+      timer = undefined;
+    }
+    if (bashRefreshTimer) {
+      clearTimeout(bashRefreshTimer);
+      bashRefreshTimer = undefined;
+    }
+    activeTui = undefined;
+  });
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@cnife/pi-footer",
+  "version": "0.1.0",
+  "private": false,
+  "keywords": [
+    "pi-package"
+  ],
+  "description": "个人专属 pi footer：两行工作区/模型状态，全 dim，仅 ASCII+Unicode",
+  "homepage": "https://github.com/CNife/pi-extensions#readme",
+  "bugs": {
+    "url": "https://github.com/CNife/pi-extensions/issues"
+  },
+  "license": "MIT",
+  "author": "CNife <CNife@vip.qq.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CNife/pi-extensions.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  }
+}