@yalieny/pi-better-cost-display-footer 1.0.0

package/README.md

@@ -0,0 +1,62 @@
+# @yalieny/pi-better-cost-display-footer
+
+pi 扩展:峰谷动态计价 + footer 增强。
+
+- **动态计价**:按配置时区与峰谷窗口,在 `session_start` 和每次发送消息时重注册 provider 的 `cost`(仅影响 pi 本地用量统计)。
+- **档位标签**:价格后紧跟峰值/谷值标签(如 `¥0.047(梁文峰)`),文案与颜色可配置。
+- **CH 精度**:footer 缓存命中率小数位可配(默认 1 位)。
+- **货币符号**:计费金额符号可配(默认 `$`)。
+
+## 安装
+
+```bash
+pi install npm:@yalieny/pi-better-cost-display-footer
+```
+
+或本地加载:`pi -e npm:@yalieny/pi-better-cost-display-footer`
+
+## 配置
+
+扩展读取 `<configDir>/pi-better-cost-display-footer.json`(configDir 默认 `~/.pi/agent`,可用 `PI_CODING_AGENT_DIR` 覆盖)。**配置文件不存在时自动生成默认配置并落盘**(DeepSeek 官方价目,开箱即用,生成后可直接编辑);配置文件存在时按字段覆盖默认值(provider/model 三级深合并)。
+
+```json
+{
+  "timezone": "Asia/Shanghai",
+  "effectiveFrom": "2026-08-17T00:00:00+08:00",
+  "cacheHitRatePrecision": 3,
+  "currencySymbol": "¥",
+  "peakWindows": [
+    { "start": "09:00", "end": "12:00" },
+    { "start": "14:00", "end": "18:00" }
+  ],
+  "labels": {
+    "peak": { "text": "（梁文峰）", "color": "error" },
+    "offPeak": { "text": "（梁文谷）", "color": "success" }
+  },
+  "providers": {
+    "deepseek": {
+      "models": {
+        "deepseek-v4-flash": {
+          "offPeak": { "input": 1.5, "output": 4.5, "cacheRead": 0.05, "cacheWrite": 0 },
+          "peak": { "input": 3.0, "output": 9.0, "cacheRead": 0.1, "cacheWrite": 0 }
+        }
+      }
+    }
+  }
+}
+```
+
+价格单位:每百万 tokens(元),与 pi 的 `calculateCost` 约定一致。窗口含起点不含终点。`effectiveFrom`(含)之前不做任何事。
+
+## 一键更新官方定价
+
+```bash
+/deepseek-pricing-update
+```
+
+该命令把抓取官方价目页、解析价格、更新配置文件的完整任务交给 agent 执行(自然语言指令,无需手动维护价格表)。命令会告知 agent 配置文件位置与 JSON 格式;agent 抓取 [DeepSeek 官方价目页](https://api-docs.deepseek.com/zh-cn/quick_start/pricing) 后更新 `providers.deepseek.models` 下各模型的 offPeak/peak 价格,其余字段不动。
+
+## 说明
+
+- provider 必须在 `models.json` 中有定义;未列出的模型保持原价。
+- cost 仅影响 pi 本地用量统计,不影响 API 实际账单。

package/extensions/pi-better-cost-display-footer.ts

@@ -0,0 +1,493 @@
+// pi-better-cost-display-footer — 峰谷动态计价 + footer 增强扩展（原 pi-dynamic-cost / pi-better-footer）
+// namespace: @YalienY
+//
+// 配置驱动：读取 <configDir>/pi-better-cost-display-footer.json（configDir 默认 ~/.pi/agent，
+// 可用 PI_CODING_AGENT_DIR 覆盖）。配置文件不存在时自动生成默认配置（内置 DeepSeek 官方价目）落盘。
+// 在 session_start 和每次发送消息（input 事件）时，
+// 按配置时区与峰谷窗口计算当前档位并重注册 provider 的 cost。
+// 跨时段边界的请求按发送时刻计费。effectiveFrom（含）之前不做任何事。
+//
+// 生效范围：
+// - 动态计价与档位标签：所有在 providers 中配置了计价模型的 provider 生效
+//   （不再限定 deepseek 官方，其余 provider 同样适用）。
+// - 自定义 footer 与 CH 精度：所有 provider 适用。
+//
+// 配置结构（pi-better-cost-display-footer.json）：
+// {
+//   "timezone": "Asia/Shanghai",                      // 计费时区，默认 Asia/Shanghai
+//   "effectiveFrom": "2026-08-17T00:00:00+08:00",     // 可选，生效时间（含）
+//   "cacheHitRatePrecision": 3,                       // 可选，footer CH 命中率小数位，默认 1
+//   "currencySymbol": "¥",                            // 可选，计费金额货币符号，默认 $
+//   "peakWindows": [                                   // 高峰窗口，含起点不含终点
+//     { "start": "09:00", "end": "12:00" },
+//     { "start": "14:00", "end": "18:00" }
+//   ],
+//   "labels": {                                        // 可选，档位标签文案与颜色
+//     "peak":    { "text": "（梁文峰）", "color": "error" },   // color: ThemeColor 名或 #rrggbb
+//     "offPeak": { "text": "（梁文谷）", "color": "success" }
+//   },
+//   "providers": {                                     // 每个 key 都是一个 provider id
+//     "deepseek": {
+//       "models": {
+//         "<modelId>": {
+//           "offPeak": { "input": 1.5, "output": 4.5, "cacheRead": 0.05, "cacheWrite": 0 },
+//           "peak":    { "input": 3.0, "output": 9.0, "cacheRead": 0.1, "cacheWrite": 0 }
+//         }
+//       }
+//     },
+//     "agent-plan": { "models": { ... } }              // 同样生效
+//   }
+// }
+// 价格单位：每百万 tokens（元），与 pi 的 calculateCost 约定一致（rate/1e6 × tokens），
+// 即官方价格表原值直接填入：如输入谷值 1.5 元/M → "input": 1.5。
+//
+// 计费显示：用 ctx.ui.setFooter 替换内置 footer（升级安全，扩展代码不随 pi 更新）。
+// 复刻内置 footer 渲染（footer.js），并加两处增强：
+//   1. 激活模型所属 provider 有动态计价配置时，价格后紧跟档位标签：
+//      峰值 →（梁文峰）默认红色，谷值 →（梁文谷）默认绿色，如 ¥0.047（梁文峰）。
+//      文案与颜色可由 labels 配置覆盖（color 支持主题色名或 #rrggbb）。
+//   2. CH 缓存命中率小数位由 cacheHitRatePrecision 控制（内置硬编码 1 位），所有 provider 适用。
+//   3. 计费金额符号由 currencySymbol 控制（内置硬编码 $）。
+//
+// 注意：
+// - provider 必须在 models.json 中有定义：扩展读取其完整模型定义，仅替换 cost 后整体重注册
+//   （registerProvider 的 models 是整体替换语义）。未列出的模型保持原价。
+// - cost 仅影响 pi 本地用量统计，不影响 API 实际账单。
+// - ponytail: 自定义 footer 是内置 modes/interactive/components/footer.js 的复刻，
+//   全部数据来自公开 API（ctx.sessionManager / ctx.getContextUsage / ctx.model /
+//   footerData），内置的 xp 实验标记与 auto-compact 开关状态未复刻。
+//   若 pi 调整 footer 布局需对照同步；上限 = 内置无"统计段追加"扩展点，
+//   升级路径 = 给内置 footer 增加 stats 追加 hook。
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join, relative, resolve, sep, isAbsolute } from "node:path";
+import { homedir } from "node:os";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import type {
+  ExtensionAPI,
+  ExtensionContext,
+  ProviderConfig,
+  Theme,
+  ThemeColor,
+} from "@earendil-works/pi-coding-agent";
+
+const CONFIG_DIR = process.env.PI_CODING_AGENT_DIR || join(homedir(), ".pi", "agent");
+const CONFIG_FILE = join(CONFIG_DIR, "pi-better-cost-display-footer.json");
+
+/** 档位标签默认文案/颜色（labels 未配置时兜底） */
+const DEFAULT_LABELS: Record<Tier, TierLabel> = {
+  peak: { text: "（梁文峰）", color: "error" },
+  offPeak: { text: "（梁文谷）", color: "success" },
+};
+
+/** 内置默认配置：配置文件缺失/损坏时的兜底，开箱即用（DeepSeek 官方价目，2026-08 抓取） */
+const DEFAULT_CONFIG: DynamicConfig = {
+  timezone: "Asia/Shanghai",
+  cacheHitRatePrecision: 1,
+  currencySymbol: "¥",
+  peakWindows: [
+    { start: "09:00", end: "12:00" },
+    { start: "14:00", end: "18:00" },
+  ],
+  labels: DEFAULT_LABELS,
+  providers: {
+    deepseek: {
+      models: {
+        "deepseek-v4-flash": {
+          offPeak: { input: 1.5, output: 4.5, cacheRead: 0.05, cacheWrite: 0 },
+          peak: { input: 3.0, output: 9.0, cacheRead: 0.1, cacheWrite: 0 },
+        },
+        "deepseek-v4-pro": {
+          offPeak: { input: 4.5, output: 13.5, cacheRead: 0.15, cacheWrite: 0 },
+          peak: { input: 9.0, output: 27.0, cacheRead: 0.3, cacheWrite: 0 },
+        },
+      },
+    },
+  },
+};
+
+/** 深合并：文件配置覆盖内置默认（顶层 + provider + model 三级），部分配置文件也能生效 */
+function mergeConfig(base: DynamicConfig, override: DynamicConfig): DynamicConfig {
+  const merged: DynamicConfig = { ...base, ...override };
+  const providers = { ...base.providers };
+  for (const [pid, pc] of Object.entries(override.providers || {})) {
+    const models = { ...providers[pid]?.models };
+    for (const [mid, rates] of Object.entries(pc.models || {})) {
+      models[mid] = { ...models[mid], ...rates };
+    }
+    providers[pid] = { ...providers[pid], ...pc, models };
+  }
+  merged.providers = providers;
+  return merged;
+}
+
+interface TierRates {
+  input: number;
+  output: number;
+  cacheRead: number;
+  cacheWrite: number;
+}
+
+interface TierLabel {
+  text: string;
+  /** ThemeColor 主题色名（如 "error"）或 #rrggbb 十六进制 */
+  color: string;
+}
+
+interface ProviderPricing {
+  models: Record<string, { offPeak: TierRates; peak: TierRates }>;
+}
+
+interface DynamicConfig {
+  timezone?: string;
+  effectiveFrom?: string;
+  cacheHitRatePrecision?: number;
+  currencySymbol?: string;
+  peakWindows?: { start: string; end: string }[];
+  labels?: { peak?: TierLabel; offPeak?: TierLabel };
+  providers?: Record<string, ProviderPricing>;
+}
+
+type Tier = "peak" | "offPeak";
+
+interface FooterLabel {
+  text: string;
+  color: string;
+}
+
+let lastAppliedKey: string | null = null;
+/** 最近一次事件的 ctx，footer 闭包读取；随 input/model_select 事件刷新 */
+let activeCtx: ExtensionContext | null = null;
+/** 当前生效配置，apply() 时刷新，footer 每帧直接读，避免频繁读盘 */
+let currentCfg: DynamicConfig | null = null;
+/** 当前档位标签（null = 不显示），apply() 时刷新 */
+let footerLabel: FooterLabel | null = null;
+
+export function loadDynamicConfig(): DynamicConfig | null {
+  try {
+    if (!existsSync(CONFIG_FILE)) {
+      // 首次运行：把内置默认配置落盘，用户可直接编辑；写入失败则内存兜底
+      mkdirSync(CONFIG_DIR, { recursive: true });
+      writeFileSync(CONFIG_FILE, JSON.stringify(DEFAULT_CONFIG, null, 2) + "\n");
+      console.log(`[pi-better-cost-display-footer] 未找到配置文件，已生成默认配置 ${CONFIG_FILE}`);
+      return DEFAULT_CONFIG;
+    }
+    const fileCfg = JSON.parse(readFileSync(CONFIG_FILE, "utf8")) as DynamicConfig;
+    return mergeConfig(DEFAULT_CONFIG, fileCfg);
+  } catch (err) {
+    console.error(
+      `[pi-better-cost-display-footer] 配置读取失败: ${err instanceof Error ? err.message : String(err)}，回退内置默认配置`,
+    );
+    return DEFAULT_CONFIG;
+  }
+}
+
+/** 当前时刻（配置时区）的 { hour, minute }，date 参数仅供测试 */
+export function nowClock(timezone: string, date: Date = new Date()): { hour: number; minute: number } {
+  const parts = new Intl.DateTimeFormat("en-US", {
+    timeZone: timezone,
+    hour: "2-digit",
+    minute: "2-digit",
+    hourCycle: "h23",
+  }).formatToParts(date);
+  const get = (t: Intl.DateTimeFormatPartTypes): string =>
+    parts.find((p) => p.type === t)?.value ?? "00";
+  return { hour: Number(get("hour")), minute: Number(get("minute")) };
+}
+
+/** 窗口含起点不含终点，如 { start: "09:00", end: "12:00" } */
+export function inWindow(
+  clock: { hour: number; minute: number },
+  win: { start: string; end: string },
+): boolean {
+  const [sh, sm] = win.start.split(":").map(Number);
+  const [eh, em] = win.end.split(":").map(Number);
+  const t = clock.hour * 60 + clock.minute;
+  return t >= sh * 60 + sm && t < eh * 60 + em;
+}
+
+/** 命中任一高峰窗口返回 "peak"，否则 "offPeak" */
+export function currentTier(cfg: DynamicConfig, clock: { hour: number; minute: number }): Tier {
+  const windows = cfg.peakWindows || [];
+  return windows.some((w) => inWindow(clock, w)) ? "peak" : "offPeak";
+}
+
+export function isEffective(cfg: DynamicConfig, date: Date = new Date()): boolean {
+  if (!cfg.effectiveFrom) return true;
+  return date.getTime() >= Date.parse(cfg.effectiveFrom);
+}
+
+/** 读取 models.json 中该 provider 的完整配置，仅替换配置中列出的模型 cost */
+function patchProviderConfig(
+  cfg: DynamicConfig,
+  providerId: string,
+  tier: Tier,
+): ProviderConfig | null {
+  const root = JSON.parse(readFileSync(join(CONFIG_DIR, "models.json"), "utf8")) as {
+    providers?: Record<string, ProviderConfig>;
+  };
+  const provider = root.providers?.[providerId];
+  if (!provider?.models?.length) {
+    console.error(`[pi-better-cost-display-footer] models.json 中没有 provider "${providerId}"，跳过`);
+    return null;
+  }
+  const rates = cfg.providers?.[providerId]?.models || {};
+  const models = provider.models.map((m) => {
+    const rate = rates[m.id]?.[tier];
+    return rate ? { ...m, cost: rate } : m;
+  });
+  return { ...provider, models };
+}
+
+// ---------- 自定义 footer：复刻内置 footer.js + 档位标签 + CH 精度 ----------
+
+function formatTokens(count: number): string {
+  if (count < 1000) return count.toString();
+  if (count < 10000) return `${(count / 1000).toFixed(1)}k`;
+  if (count < 1000000) return `${Math.round(count / 1000)}k`;
+  if (count < 10000000) return `${(count / 1000000).toFixed(1)}M`;
+  return `${Math.round(count / 1000000)}M`;
+}
+
+function formatCwdForFooter(cwd: string, home: string | undefined): string {
+  if (!home) return cwd;
+  const rel = relative(resolve(home), resolve(cwd));
+  const inside =
+    rel === "" || (rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel));
+  return inside ? (rel === "" ? "~" : `~${sep}${rel}`) : cwd;
+}
+
+function sanitizeStatusText(text: string): string {
+  return text.replace(/[\r\n\t]/g, " ").replace(/ +/g, " ").trim();
+}
+
+/** 标签着色：ThemeColor 名走主题，#rrggbb 走 truecolor 直出（SGR 38;2;r;g;b） */
+export function colorize(theme: Theme, color: string, text: string): string {
+  const hex = /^#([0-9a-f]{6})$/i.exec(color);
+  if (hex) {
+    const n = parseInt(hex[1], 16);
+    return `\x1b[38;2;${(n >> 16) & 255};${(n >> 8) & 255};${n & 255}m${text}\x1b[39m`;
+  }
+  return theme.fg(color as ThemeColor, text);
+}
+
+/** 整段包 dim，但跳过 marker（档位标签）保持原色；未找到 marker 时整段 dim */
+function dimSkip(text: string, marker: string, theme: Theme): string {
+  if (!marker) return theme.fg("dim", text);
+  const idx = text.indexOf(marker);
+  if (idx < 0) return theme.fg("dim", text);
+  return (
+    theme.fg("dim", text.slice(0, idx)) +
+    "\x1b[22m" + // 重置亮度，标签不被 dim 压暗
+    marker +
+    theme.fg("dim", text.slice(idx + marker.length))
+  );
+}
+
+/** 计算档位标签；当前 provider 无动态计价配置 / 配置缺失 / 未生效 → null */
+function computeFooterLabel(cfg: DynamicConfig | null, ctx: ExtensionContext | null): FooterLabel | null {
+  if (!cfg || !isEffective(cfg)) return null;
+  const providerId = ctx?.model?.provider;
+  if (!providerId || !cfg.providers?.[providerId]) return null;
+  const tier = currentTier(cfg, nowClock(cfg.timezone || "Asia/Shanghai"));
+  return cfg.labels?.[tier] ?? DEFAULT_LABELS[tier];
+}
+
+function installCustomFooter(ctx: ExtensionContext): void {
+  if (ctx.mode !== "tui") return; // 非 TUI（rpc/json）无 footer 可替换
+  ctx.ui.setFooter((_tui, theme, footerData) => ({
+    invalidate() {},
+    render(width: number) {
+      const c = activeCtx;
+      const sm = c?.sessionManager;
+      // 累计用量：镜像内置 addUsageToTotals 的入口（assistant / toolResult / 摘要与压缩）
+      const totals = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 };
+      let latestCacheHitRate: number | undefined;
+      for (const entry of sm?.getEntries() ?? []) {
+        let usage;
+        if (entry.type === "message" && entry.message.role === "assistant") {
+          usage = entry.message.usage;
+          const promptTokens = usage.input + usage.cacheRead + usage.cacheWrite;
+          latestCacheHitRate =
+            promptTokens > 0 ? (usage.cacheRead / promptTokens) * 100 : undefined;
+        } else if (entry.type === "message" && entry.message.role === "toolResult" && entry.message.usage) {
+          usage = entry.message.usage;
+        } else if ((entry.type === "branch_summary" || entry.type === "compaction") && entry.usage) {
+          usage = entry.usage;
+        }
+        if (!usage) continue;
+        totals.input += usage.input;
+        totals.output += usage.output;
+        totals.cacheRead += usage.cacheRead;
+        totals.cacheWrite += usage.cacheWrite;
+        totals.cost += usage.cost.total;
+      }
+      // 上下文占用（内置逻辑：压缩后 tokens 未知 → "?"）
+      const contextUsage = c?.getContextUsage();
+      const contextWindow = contextUsage?.contextWindow ?? c?.model?.contextWindow ?? 0;
+      const contextPercentValue = contextUsage?.percent ?? 0;
+      const contextPercent =
+        contextUsage?.percent == null ? "?" : contextPercentValue.toFixed(1);
+      const autoIndicator = " (auto)"; // ponytail: 内置 auto-compact 关闭时此处仍显示
+      const contextPercentDisplay =
+        contextPercent === "?"
+          ? `?/${formatTokens(contextWindow)}${autoIndicator}`
+          : `${contextPercent}%/${formatTokens(contextWindow)}${autoIndicator}`;
+      let contextPercentStr: string;
+      if (contextPercentValue > 90) contextPercentStr = theme.fg("error", contextPercentDisplay);
+      else if (contextPercentValue > 70) contextPercentStr = theme.fg("warning", contextPercentDisplay);
+      else contextPercentStr = contextPercentDisplay;
+      // pwd + git 分支 + 会话名
+      let pwd = formatCwdForFooter(sm?.getCwd() ?? "", process.env.HOME || process.env.USERPROFILE);
+      const branch = footerData.getGitBranch();
+      if (branch) pwd = `${pwd} (${branch})`;
+      const sessionName = sm?.getSessionName();
+      if (sessionName) pwd = `${pwd} • ${sessionName}`;
+      // 统计段
+      const statsParts: string[] = [];
+      if (totals.input) statsParts.push(`↑${formatTokens(totals.input)}`);
+      if (totals.output) statsParts.push(`↓${formatTokens(totals.output)}`);
+      if (totals.cacheRead) statsParts.push(`R${formatTokens(totals.cacheRead)}`);
+      if (totals.cacheWrite) statsParts.push(`W${formatTokens(totals.cacheWrite)}`);
+      if ((totals.cacheRead > 0 || totals.cacheWrite > 0) && latestCacheHitRate !== undefined) {
+        const precision = currentCfg?.cacheHitRatePrecision ?? 1;
+        statsParts.push(`CH${latestCacheHitRate.toFixed(precision)}%`);
+      }
+      // 订阅制 provider 无法从扩展读取 modelRuntime，退化为内置的特例
+      const usingSubscription = c?.model?.provider === "kimi-coding";
+      // 档位标签紧跟价格之后：峰值红（梁文峰）/ 谷值绿（梁文谷），如 ¥0.047（梁文峰）
+      const labelInfo = footerLabel;
+      const labelStr = labelInfo ? colorize(theme, labelInfo.color, labelInfo.text) : "";
+      if (totals.cost || usingSubscription) {
+        const symbol = currentCfg?.currencySymbol ?? "$";
+        const costStr = `${symbol}${totals.cost.toFixed(3)}${usingSubscription ? " (sub)" : ""}`;
+        statsParts.push(costStr + labelStr);
+      }
+      statsParts.push(contextPercentStr);
+      // 兜底：无计费段时标签置于统计段末尾
+      if (!(totals.cost || usingSubscription) && labelStr) statsParts.push(labelStr);
+      let statsLeft = statsParts.join(" ");
+      // 右侧：模型名 + thinking 档位 + 多 provider 前缀
+      const modelName = c?.model?.id || "no-model";
+      let statsLeftWidth = visibleWidth(statsLeft);
+      if (statsLeftWidth > width) {
+        statsLeft = truncateToWidth(statsLeft, width, "...");
+        statsLeftWidth = visibleWidth(statsLeft);
+      }
+      const minPadding = 2;
+      let rightSide: string = modelName;
+      if (c?.model?.reasoning) {
+        const thinkingLevel = c.thinkingLevel || "off";
+        rightSide =
+          thinkingLevel === "off" ? `${modelName} • thinking off` : `${modelName} • ${thinkingLevel}`;
+      }
+      if (footerData.getAvailableProviderCount() > 1 && c?.model) {
+        const withProvider = `(${c.model.provider}) ${rightSide}`;
+        if (statsLeftWidth + minPadding + visibleWidth(withProvider) <= width) rightSide = withProvider;
+      }
+      const rightSideWidth = visibleWidth(rightSide);
+      let statsLine: string;
+      if (statsLeftWidth + minPadding + rightSideWidth <= width) {
+        const padding = " ".repeat(width - statsLeftWidth - rightSideWidth);
+        statsLine = statsLeft + padding + rightSide;
+      } else {
+        const availableForRight = width - statsLeftWidth - minPadding;
+        if (availableForRight > 0) {
+          const truncatedRight = truncateToWidth(rightSide, availableForRight, "");
+          const padding = " ".repeat(Math.max(0, width - statsLeftWidth - visibleWidth(truncatedRight)));
+          statsLine = statsLeft + padding + truncatedRight;
+        } else {
+          statsLine = statsLeft;
+        }
+      }
+      // 弱化：与内置一致，统计段与右侧分别包 dim；标签段用 \x1b[22m 退出 dim 保持原色
+      // ponytail: 依赖 SGR 22 重置亮度，若主题实现变化需同步
+      const dimStatsLeft = dimSkip(statsLeft, labelStr, theme);
+      const remainder = statsLine.slice(statsLeft.length);
+      const dimRemainder = theme.fg("dim", remainder);
+      const statsLineFinal = dimStatsLeft + dimRemainder;
+      const pwdLine = truncateToWidth(theme.fg("dim", pwd), width, theme.fg("dim", "..."));
+      const lines = [pwdLine, statsLineFinal];
+      // 扩展状态行（MCP 等），按键名排序
+      const extensionStatuses = footerData.getExtensionStatuses();
+      if (extensionStatuses.size > 0) {
+        const statusLine = Array.from(extensionStatuses.entries())
+          .sort(([a], [b]) => a.localeCompare(b))
+          .map(([, text]) => sanitizeStatusText(text))
+          .join(" ");
+        lines.push(truncateToWidth(statusLine, width, theme.fg("dim", "...")));
+      }
+      return lines;
+    },
+  }));
+}
+
+function apply(pi: ExtensionAPI, ctx: ExtensionContext): void {
+  activeCtx = ctx;
+  const cfg = loadDynamicConfig();
+  currentCfg = cfg;
+  footerLabel = computeFooterLabel(cfg, ctx);
+  if (!cfg || !isEffective(cfg)) return;
+  const tier = currentTier(cfg, nowClock(cfg.timezone || "Asia/Shanghai"));
+  const key = `${tier}|${JSON.stringify(cfg)}`;
+  if (key === lastAppliedKey) return;
+  // 动态计价对所有配置了 providers 的模型生效（不限定 deepseek）
+  for (const providerId of Object.keys(cfg.providers || {})) {
+    try {
+      const config = patchProviderConfig(cfg, providerId, tier);
+      if (!config) continue;
+      pi.registerProvider(providerId, config);
+      console.log(`[pi-better-cost-display-footer] ${providerId} → ${tier}`);
+    } catch (err) {
+      console.error(
+        `[pi-better-cost-display-footer] ${providerId} 注册失败: ${err instanceof Error ? err.message : String(err)}`,
+      );
+    }
+  }
+  lastAppliedKey = key;
+}
+
+export default function (pi: ExtensionAPI): void {
+  // 一键更新 DeepSeek 官方定价：发自然语言任务给 agent，由 agent 抓价目页并更新配置文件
+  pi.registerCommand("deepseek-pricing-update", {
+    description: "抓取 DeepSeek 官方价目页，更新 pi-better-cost-display-footer 配置中的模型价格",
+    handler: async (_args, ctx) => {
+      ctx.ui.notify("已排队：更新 DeepSeek 官方定价…", "info");
+      pi.sendUserMessage(
+        `任务：更新 DeepSeek 官方计价配置。
+1. 抓取 https://api-docs.deepseek.com/zh-cn/quick_start/pricing ，读取"模型 & 价格"表格中的模型价格（单位为 元/百万tokens）。
+2. 配置文件位置：${CONFIG_FILE} 。
+3. 配置 JSON 格式（只动 providers 部分）：
+   {
+     "timezone": "Asia/Shanghai",
+     "peakWindows": [{ "start": "09:00", "end": "12:00" }, { "start": "14:00", "end": "18:00" }],
+     "labels": { "peak": { "text": "（梁文峰）", "color": "error" }, "offPeak": { "text": "（梁文谷）", "color": "success" } },
+     "providers": {
+       "<providerId>": {
+         "models": {
+           "<modelId>": {
+             "offPeak": { "input": 1.5, "output": 4.5, "cacheRead": 0.05, "cacheWrite": 0 },
+             "peak":    { "input": 3.0, "output": 9.0, "cacheRead": 0.10, "cacheWrite": 0 }
+           }
+         }
+       }
+     }
+   }
+   价格单位：元/百万tokens；cacheWrite 恒为 0。页面"空闲时段"价格 → offPeak，"高峰时段"价格 → peak。
+4. 页面未列出的模型保持原样；配置文件中其他所有字段（timezone/peakWindows/labels/cacheHitRatePrecision/currencySymbol 及其他 provider）一律不动。
+5. 若配置文件不存在：扩展在启动时会自动生成默认配置文件，一般不会出现该情况；若确实不存在，按默认格式新建一份即可。
+6. 用 edit 精确修改，不要整体重写文件；完成后核对一遍数字与官方页面一致，并简要报告改了什么。
+7. 峰谷价取消处理（两种情况）：
+   a. 官方页取消峰谷价（不再区分空闲/高峰时段，只有单一价格）→ 各模型 offPeak 与 peak 填相同价格，cacheWrite 仍为 0，并把 peakWindows 清空为 []（扩展恒按 offPeak 计价 = 平价格，配置结构保持有效）。
+   b. 用户要求彻底取消动态计价 → 直接删除该 provider 的整个 providers.<providerId> 配置项（扩展会回退 models.json 原始 cost，且不显示档位标签）。`,
+        { deliverAs: "followUp" },
+      );
+    },
+  });
+  pi.on("session_start", (_e, ctx) => {
+    installCustomFooter(ctx);
+    apply(pi, ctx);
+  });
+  pi.on("input", (_e, ctx) => apply(pi, ctx));
+  // 切换模型时刷新档位标签（深色/深绿 ⇄ 其他模型）
+  pi.on("model_select", (_e, ctx) => apply(pi, ctx));
+}

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@yalieny/pi-better-cost-display-footer",
+  "version": "1.0.0",
+  "description": "pi extension: peak/off-peak dynamic pricing per provider with an enhanced footer (tier label, cache-hit-rate precision, custom currency symbol)",
+  "keywords": ["pi-package", "pi-extension"],
+  "license": "MIT",
+  "type": "module",
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "files": ["extensions", "README.md"],
+  "pi": {
+    "extensions": ["./extensions"]
+  }
+}