@zhushanwen/pi-statusline 0.1.1 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-statusline",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Pi statusline extension — shows context usage, token speed, and provider quota in the footer.",
   "type": "module",
   "main": "src/index.ts",
@@ -21,8 +21,21 @@
     "src/",
     "index.ts"
   ],
+  "dependencies": {
+    "@zhushanwen/pi-quota-providers": "0.1.1"
+  },
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "*"
+    "@mariozechner/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "@earendil-works/pi-ai": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-tui": {
+      "optional": true
+    },
+    "@earendil-works/pi-ai": {
+      "optional": true
+    }
   },
   "scripts": {
     "typecheck": "npx tsc --noEmit"

package/src/index.ts

@@ -14,15 +14,25 @@
 import type { AssistantMessage } from "@mariozechner/pi-ai";
 import type { ExtensionAPI, ExtensionContext, ReadonlyFooterDataProvider, Theme } from "@mariozechner/pi-coding-agent";
 import { truncateToWidth } from "@mariozechner/pi-tui";
+
+// ── 本地事件类型 ───────────────────────────────────────
+// Pi SDK 将 ContextEvent 定义为 any，此处用具体接口替代
+interface PiMessageEvent {
+  message: { role: string } & Record<string, unknown>;
+}
+
+interface PiThinkingLevelEvent {
+  level: string;
+}
 import {
 	readCache,
 	triggerUpdate,
 	trackSpeed,
+	PROVIDERS,
 	type CacheData,
 	type SpeedData,
-} from "./cache.js";
-import { PROVIDERS } from "./providers/index.js";
-import type { QuotaWindow } from "./providers/types.js";
+	type QuotaWindow,
+} from "@zhushanwen/pi-quota-providers";
 // ── 常量 ───────────────────────────────────────────────
 
 const SEP = "│";
@@ -33,21 +43,18 @@ const RUN_UPDATE_MS = 5000;
 /** 标题列宽（按最长 "opencode-go"=11, +4 空格余量） */
 const TITLE_COL_W = 15;
 
-// ── ANSI ──────────────────────────────────────────────
-
-const R = "\x1b[0m";
+// ── Bar rendering (no ANSI) ──────────────────────────
 
-function bgBar(pct: number, w = 6): string {
+/** Render a usage bar with Unicode block chars and semantic fg tokens. */
+function barSegment(pct: number, theme: Theme, w = 6): string {
 	const p = Math.max(0, Math.min(100, Math.round(pct)));
-	if (p <= 0 && w <= 6) return `${R}${"\x1b[48;5;239m"}${" ".repeat(w)}${R}`;
 	const filled = Math.floor((p * w) / 100);
-	const fillBg =
-		p >= 80 ? "\x1b[48;5;196m"
-			: p >= 60 ? "\x1b[48;5;208m"
-			: p >= 40 ? "\x1b[48;5;220m"
-			: "\x1b[48;5;114m";
-	const emptyBg = "\x1b[48;5;239m";
-	return `${fillBg}${" ".repeat(filled)}${emptyBg}${" ".repeat(w - filled)}${R}`;
+	const fillToken =
+		p >= 80 ? "error"
+			: p >= 60 ? "warning"
+			: p >= 40 ? "accent"
+			: "success";
+	return theme.fg(fillToken, "█".repeat(filled)) + theme.fg("muted", "░".repeat(w - filled));
 }
 
 /** 构建一个窗口列，所有单元格 data 区域固定可见宽度。 */
@@ -58,10 +65,10 @@ function winCol(
 	wide: boolean,
 	d: (s: string) => string,
 	v: (s: string) => string,
+	theme: Theme,
 ): string {
 	const l = d(label);
 	if (pct === null) {
-		// infinite: 占位宽度 = 正常列 data 宽
 		const dataW = wide ? 20 : 12;
 		return `${l}  ${v(padCenter("∞", dataW))}`;
 	}
@@ -70,11 +77,9 @@ function winCol(
 	const rtStr = rtRaw.padEnd(6);
 
 	if (wide) {
-		const bar = bgBar(pct, 6); // ANSI: 6 个空格带背景色
-		// pct(4) + 2空格 + bar(6 可见) + 2空格 + reset(6) = 20 可见
+		const bar = barSegment(pct, theme, 6);
 		return `${l}  ${v(pctStr)}  ${bar}  ${v(rtStr)}`;
 	}
-	// pct(4) + 2空格 + reset(6) = 12 可见
 	return `${l}  ${v(pctStr)}  ${v(rtStr)}`;
 }
 
@@ -184,7 +189,7 @@ export default function (pi: ExtensionAPI) {
 
 	let tui: { requestRender(): void } | null = null;
 
-	pi.on("session_start", async (_event: any, ctx: ExtensionContext) => {
+	pi.on("session_start", async (_event: unknown, ctx: ExtensionContext) => {
 		state.sessionStart = Date.now();
 		state.lastLlmTime = 0;
 		state.speed = { current: 0, day: 0, d7: 0, d30: 0 };
@@ -192,6 +197,7 @@ export default function (pi: ExtensionAPI) {
 		state.thinkingLevel = pi.getThinkingLevel();
 		refreshTotals(state, ctx);
 
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any — SDK ExtensionContext.ui 类型缺失 setFooter
 		(ctx.ui as any).setFooter((t: { requestRender(): void }, theme: Theme, footerData: ReadonlyFooterDataProvider) => {
 			tui = t;
 			const unsub = footerData.onBranchChange(() => t.requestRender());
@@ -207,14 +213,14 @@ export default function (pi: ExtensionAPI) {
 		triggerUpdate();
 	});
 
-	pi.on("message_start", async (event: any) => {
+	pi.on("message_start", async (event: PiMessageEvent) => {
 		if (event.message.role === "assistant") {
 			state.assistantStart = Date.now();
 			state.isAgentBusy = true;
 		}
 	});
 
-	pi.on("message_end", async (event: any, ctx: ExtensionContext) => {
+	pi.on("message_end", async (event: PiMessageEvent, ctx: ExtensionContext) => {
 		if (event.message.role === "assistant") {
 			const msg = event.message as AssistantMessage;
 			if (!msg.usage) return;
@@ -249,7 +255,7 @@ export default function (pi: ExtensionAPI) {
 		state.thinkingLevel = pi.getThinkingLevel();
 		tui?.requestRender();
 	});
-	pi.on("thinking_level_select", async (event: any) => {
+	pi.on("thinking_level_select", async (event: PiThinkingLevelEvent) => {
 		state.thinkingLevel = event.level;
 		if (!state.isAgentBusy) tui?.requestRender();
 	});
@@ -367,7 +373,7 @@ function buildLines(
 			? `${d("ctx")} ${v(fmtTokens(st.contextTokens))}/${v(fmtTokens(st.contextWindow))}`
 			: `${d("ctx")} ${v(`${st.usedPct}%`)}`;
 	const ctxBarStr = wide
-		? `${bgBar(st.usedPct)} ${v(`${st.usedPct}%`)}`
+		? `${barSegment(st.usedPct, theme)} ${v(`${st.usedPct}%`)}`
 		: `${v(`${st.usedPct}%`)}`;
 
 	const line2Parts: string[] = [`${ctxSizeStr} ${ctxBarStr}`];
@@ -379,7 +385,7 @@ function buildLines(
 		const treeDisplayPct = treePct === 0 && st.treeTokens > 0 ? "<1" : `${treePct}`;
 		const treeSizeStr = `${d("tree")} ${v(fmtTokens(st.treeTokens))}/${v(fmtTokens(st.contextWindow))}`;
 		const treeBarStr = wide
-			? `${bgBar(treePct || 1)} ${v(`${treeDisplayPct}%`)}`
+			? `${barSegment(treePct || 1, theme)} ${v(`${treeDisplayPct}%`)}`
 			: `${v(`${treeDisplayPct}%`)}`;
 		line2Parts.push(`${treeSizeStr} ${treeBarStr}`);
 	}
@@ -406,7 +412,7 @@ function buildLines(
 		const title = d(row.name.padEnd(TITLE_COL_W));
 		const cells = COLS.map((col, i) => {
 			const win = row.wins[i]!;
-			return winCol(col.label, win.pct, win.resetSec, wide, d, v);
+			return winCol(col.label, win.pct, win.resetSec, wide, d, v, theme);
 		});
 		lines.push(title + cells.join(` ${DOT} `));
 	}

package/src/cache.ts

@@ -1,190 +0,0 @@
-/**
- * Statusline 数据缓存层
- *
- * 架构（重构后）：
- *   - 各 provider 单独实现在 providers/*.ts，通过 PROVIDERS 注册表管理
- *   - cache.ts 只负责：TTL 缓存、并发控制、Promise.allSettled 拉取、磁盘持久化
- *   - 新增 provider：实现 QuotaProvider 接口 → 在 PROVIDERS 注册（零改动 cache.ts）
- */
-
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { PROVIDERS } from "./providers/index.js";
-
-// ── Paths ──────────────────────────────────────────────
-const HOME = homedir();
-const PI_DIR = join(HOME, ".pi");
-const CACHE_PATH = join(PI_DIR, "statusline_cache.json");
-const SPEED_DIR = join(PI_DIR, "token-stats");
-const CACHE_TTL_MS = 300_000; // 5 分钟：套餐用量刷新间隔
-
-// ── CacheData（动态 schema，无需手动维护字段）───────
-// provider 数据以 provider.id 为 key 存储，类型安全由 provider normalize 保证。
-export interface CacheData {
-	updatedAt: number;
-	[providerId: string]: unknown;
-}
-
-const EMPTY_CACHE: CacheData = { updatedAt: 0 };
-
-export interface SpeedData {
-	current: number;
-	day: number;
-	d7: number;
-	d30: number;
-}
-
-// ── Cache 公共 API ─────────────────────────────────────
-
-export function readCache(): CacheData {
-	const cached = readCacheSync();
-	if (Date.now() - cached.updatedAt > CACHE_TTL_MS) triggerUpdate();
-	return cached;
-}
-
-let updating = false;
-let lastUpdateAt = 0; // 上次实际发起网络请求的时间
-
-export function triggerUpdate(): void {
-	if (updating) return;
-	// 距上次实际请求不足 TTL 一半时跳过，避免 message_end 高频触发
-	if (Date.now() - lastUpdateAt < CACHE_TTL_MS / 2) return;
-	updating = true;
-	lastUpdateAt = Date.now();
-	doUpdate()
-		.finally(() => {
-			updating = false;
-		})
-		.catch(() => {});
-}
-
-async function doUpdate(): Promise<void> {
-	const old = readCacheSync();
-	const results = await Promise.allSettled(PROVIDERS.map((p) => p.fetch()));
-
-	const cache: Record<string, unknown> = { updatedAt: Date.now() };
-	for (let i = 0; i < PROVIDERS.length; i++) {
-		const p = PROVIDERS[i]!;
-		const r = results[i]!;
-		const oldVal = (old as Record<string, unknown>)[p.id] ?? null;
-		if (r.status === "rejected") {
-			// 记录到 stderr 方便排查，不持久化
-			console.error(`[statusline] ${p.id} fetch failed:`, r.reason?.message ?? r.reason);
-		}
-		cache[p.id] =
-			r.status === "fulfilled" && r.value !== null ? r.value : oldVal;
-	}
-
-	// 原子写入：先写临时文件再 rename，防止半写损坏
-	try {
-		mkdirSync(PI_DIR, { recursive: true });
-		const tmpPath = `${CACHE_PATH}.tmp`;
-		writeFileSync(tmpPath, JSON.stringify(cache, null, 2), "utf-8");
-		renameSync(tmpPath, CACHE_PATH);
-	} catch {
-		// 写入失败不影响下次读取（保留旧缓存）
-	}
-}
-
-function readCacheSync(): CacheData {
-	try {
-		const parsed = JSON.parse(readFileSync(CACHE_PATH, "utf-8"));
-		if (typeof parsed !== "object" || parsed === null) return { ...EMPTY_CACHE };
-		// 确保 updatedAt 存在，其余字段原样保留（由 provider 动态管理）
-		return { ...parsed, updatedAt: parsed.updatedAt ?? 0 };
-	} catch {
-		return { ...EMPTY_CACHE };
-	}
-}
-
-// ── Token Speed（与 provider 无关，保留在此）──────────────
-
-// 每条记录存储 [outputTokens, durationMs]，用于正确计算加权平均速度
-type SpeedRecord = [number, number];
-
-export function trackSpeed(
-	outputTokens: number,
-	durationMs: number,
-	model: string,
-): SpeedData {
-	const current =
-		durationMs > 0 ? Math.round((outputTokens / durationMs) * 1000) : 0;
-	if (!model || current <= 0) return { current, day: 0, d7: 0, d30: 0 };
-
-	const safeName = model.replace(/[/\\\s:]/g, "_");
-	const filePath = join(SPEED_DIR, `${safeName}.json`);
-	const today = new Date().toISOString().slice(0, 10);
-
-	const records: Record<string, SpeedRecord[]> = {};
-	try {
-		if (existsSync(filePath)) {
-			const raw = JSON.parse(readFileSync(filePath, "utf-8"));
-			for (const [date, entries] of Object.entries(raw)) {
-				// 跳过旧格式（number[]）或混合格式
-				if (!Array.isArray(entries)) continue;
-				if (entries.length > 0 && !Array.isArray(entries[0])) continue;
-				// 过滤掉同日期内混入的旧格式纯数字
-				records[date] = entries.filter(
-					(e): e is SpeedRecord => Array.isArray(e) && e.length >= 2,
-				);
-			}
-		}
-	} catch {
-		/* istanbul ignore next — 文件损坏时回退到空记录 */
-	}
-
-	if (!records[today]) records[today] = [];
-	records[today].push([outputTokens, durationMs]);
-
-	// 清理 30 天前的数据
-	const cutoff = new Date(Date.now() - 30 * 86_400_000)
-		.toISOString()
-		.slice(0, 10);
-	for (const d of Object.keys(records)) {
-		if (d < cutoff) delete records[d];
-	}
-
-	try {
-		mkdirSync(SPEED_DIR, { recursive: true });
-		writeFileSync(filePath, JSON.stringify(records));
-	} catch {
-		/* istanbul ignore next — 写入失败不影响功能 */
-	}
-
-	// 加权平均：sum(tokens) / sum(duration) * 1000
-	const avgSpeed = (entries: SpeedRecord[]): number => {
-		let totalTokens = 0;
-		let totalDuration = 0;
-		for (const entry of entries) {
-			if (!Array.isArray(entry) || entry.length < 2) continue;
-			totalTokens += entry[0];
-			totalDuration += entry[1];
-		}
-		return totalDuration > 0
-			? Math.round((totalTokens / totalDuration) * 1000)
-			: 0;
-	};
-
-	const dayEntries: SpeedRecord[] = [];
-	const d7Entries: SpeedRecord[] = [];
-	const d30Entries: SpeedRecord[] = [];
-	const now = Date.now();
-
-	for (const [date, entries] of Object.entries(records)) {
-		d30Entries.push(...entries);
-		if ((now - new Date(date).getTime()) / 86_400_000 < 7) {
-			d7Entries.push(...entries);
-		}
-		if (date === today) {
-			dayEntries.push(...entries);
-		}
-	}
-
-	return {
-		current,
-		day: avgSpeed(dayEntries),
-		d7: avgSpeed(d7Entries),
-		d30: avgSpeed(d30Entries),
-	};
-}

package/src/providers/index.ts

@@ -1,33 +0,0 @@
-/**
- * Provider 注册表
- *
- * 新增 provider 流程：
- *   1. 在 providers/ 下新建 xxx.ts，实现 QuotaProvider 接口
- *   2. 在下面追加一行 import + PROVIDERS.push(...)
- *   3. 在 cache.ts 的 CacheData interface 和 readCacheSync 里加一个字段（兼容老缓存）
- *   4. 如果 provider 需要被特殊显示（如 tavily 在 line 2），在 index.ts 加引用
- */
-
-import { kimiCodingProvider } from "./kimi-coding.js";
-import { minimaxProvider } from "./minimax.js";
-import { opencodeGoProvider } from "./opencode-go.js";
-import type { QuotaProvider } from "./types.js";
-import { tavilyProvider } from "./tavily.js";
-import { zhipuProvider } from "./zhipu.js";
-
-/**
- * 注册顺序即 statusline 显示顺序。
- * 显示在套餐用量行的 provider（normalize 不返回 null）。
- * tavily 也在列表里但 normalize 返回 null，由 index.ts 单独从 cache 读取 available/total。
- */
-export const PROVIDERS: QuotaProvider[] = [
-	zhipuProvider,
-	opencodeGoProvider,
-	kimiCodingProvider,
-	minimaxProvider,
-	tavilyProvider,
-];
-
-/** 通过 id 查 provider（渲染层备用） */
-export const providerById = (id: string): QuotaProvider | undefined =>
-	PROVIDERS.find((p) => p.id === id);

package/src/providers/kimi-coding.ts

@@ -1,131 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import {
-	INFINITE_WIN,
-	type NormalizedQuotaRow,
-	type QuotaProvider,
-} from "./types.js";
-
-const HOME = homedir();
-const SECRETS_DIR = join(HOME, ".pi", "agent", "secrets");
-const KIMI_API_KEY_PATH = join(SECRETS_DIR, "kimi-coding-api-key.txt");
-
-export interface KimiCodingWindow {
-	limit: number;
-	remaining: number;
-	usedPct: number;
-	resetTime: string;
-}
-
-interface KimiLimitDetail {
-	limit?: number;
-	remaining?: number;
-	resetTime?: string;
-}
-
-interface KimiLimit {
-	detail?: KimiLimitDetail;
-}
-
-interface KimiUsage {
-	limit?: number;
-	used?: number;
-	resetTime?: string;
-}
-
-interface KimiApiResponse {
-	limits?: KimiLimit[];
-	usage?: KimiUsage;
-}
-export interface KimiCodingData {
-	rollingWindow: KimiCodingWindow;
-	dailyLimit: number;
-	dailyUsed: number;
-	dailyResetTime: string;
-}
-
-async function fetchKimiCoding(): Promise<KimiCodingData | null> {
-	let apiKey = process.env.KIMI_API_KEY ?? "";
-	if (!apiKey && existsSync(KIMI_API_KEY_PATH)) {
-		apiKey = readFileSync(KIMI_API_KEY_PATH, "utf-8").trim();
-	}
-	if (!apiKey) return null;
-
-	try {
-		const resp = await fetch("https://api.kimi.com/coding/v1/usages", {
-			headers: {
-				authorization: `Bearer ${apiKey}`,
-				"content-type": "application/json",
-			},
-			signal: AbortSignal.timeout(5000),
-		});
-		if (!resp.ok) return null;
-	const data = (await resp.json()) as KimiApiResponse;
-
-		const win = (data?.limits ?? [])[0];
-		const winLimit = Number(win?.detail?.limit ?? 0);
-		const winRemaining = Number(win?.detail?.remaining ?? 0);
-		const dailyLimit = Number(data?.usage?.limit ?? 0);
-		const dailyUsed = Number(data?.usage?.used ?? 0);
-
-		return {
-			rollingWindow: {
-				limit: winLimit,
-				remaining: winRemaining,
-				usedPct:
-					winLimit > 0
-						? Math.round(((winLimit - winRemaining) / winLimit) * 100)
-						: 0,
-				resetTime: win?.detail?.resetTime ?? "",
-			},
-			dailyLimit,
-			dailyUsed,
-			dailyResetTime: data?.usage?.resetTime ?? "",
-		};
-	} catch {
-		return null;
-	}
-}
-
-export const kimiCodingProvider: QuotaProvider<KimiCodingData> = {
-	id: "kimiCoding",
-	label: "kimi-coding",
-	fetch: fetchKimiCoding,
-	normalize(raw): NormalizedQuotaRow | null {
-		if (!raw?.rollingWindow) return null;
-		const rw = raw.rollingWindow;
-		const ki5h =
-			rw.limit > 0
-				? {
-						pct: rw.usedPct,
-						resetSec: rw.resetTime
-							? isoResetRemaining(rw.resetTime)
-							: null,
-					}
-				: INFINITE_WIN;
-
-		const kiWk =
-			raw.dailyLimit > 0
-				? {
-						pct: Math.round((raw.dailyUsed / raw.dailyLimit) * 100),
-						resetSec: raw.dailyResetTime
-							? isoResetRemaining(raw.dailyResetTime)
-							: null,
-					}
-				: INFINITE_WIN;
-
-		return {
-			label: "kimi-coding",
-			wins: [ki5h, kiWk, INFINITE_WIN],
-		};
-	},
-};
-
-/** ISO 时间戳 → 剩余秒 */
-function isoResetRemaining(iso: string): number {
-	return Math.max(
-		0,
-		Math.floor((new Date(iso).getTime() - Date.now()) / 1000),
-	);
-}

package/src/providers/minimax.ts

@@ -1,130 +0,0 @@
-/**
- * MiniMax (MiniMax) Token Plan 用量 provider
- *
- * API: GET https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains
- * Auth: Bearer <MINIMAX_API_KEY>
- *
- * 响应字段（实测）：
- *   model_remains[].model_name                    "general" | "video" | ...
- *   model_remains[].current_interval_remaining_percent   5h 剩余百分比 (0-100)
- *   model_remains[].current_interval_status             1=订阅  3=未订阅
- *   model_remains[].remains_time                        5h 窗口剩余毫秒
- *   model_remains[].current_weekly_remaining_percent    周剩余百分比
- *   model_remains[].current_weekly_status
- *   model_remains[].weekly_remains_time                 周窗口剩余毫秒
- *
- * 注：国内 api.minimaxi.com 端点实测稳定可用，不需要 UA 伪装。
- * 国外 www.minimax.io 端点需要 UA 伪装且当前 key 会被拒。
- */
-
-import {
-	INFINITE_WIN,
-	type NormalizedQuotaRow,
-	type QuotaProvider,
-} from "./types.js";
-
-const API_URL =
-	"https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains";
-
-interface MinimaxBaseResp {
-	status_code?: number;
-}
-
-interface MinimaxApiResponse {
-	base_resp?: MinimaxBaseResp;
-	model_remains?: MinimaxModelRemains[];
-}
-export interface MinimaxModelRemains {
-	model_name: string;
-	current_interval_remaining_percent: number;
-	current_interval_status: number;
-	remains_time: number;
-	current_weekly_remaining_percent: number;
-	current_weekly_status: number;
-	weekly_remains_time: number;
-	// 一些 API 版本还带的字段（保留以防 schema 变化）
-	current_interval_total_count?: number;
-	current_weekly_total_count?: number;
-	[key: string]: unknown;
-}
-
-export interface MinimaxData {
-	models: MinimaxModelRemains[];
-	raw: unknown; // 原始响应，便于未来排错
-}
-
-async function fetchMinimax(): Promise<MinimaxData | null> {
-	const token = process.env.MINIMAX_API_KEY ?? "";
-	if (!token) return null;
-
-	try {
-		const resp = await fetch(API_URL, {
-			headers: {
-				authorization: `Bearer ${token}`,
-				"content-type": "application/json",
-				accept: "application/json",
-			},
-			signal: AbortSignal.timeout(5000),
-		});
-		if (!resp.ok) return null;
-	const data = (await resp.json()) as MinimaxApiResponse;
-
-		if (data?.base_resp?.status_code !== 0) return null;
-		const models = (data?.model_remains ?? []) as MinimaxModelRemains[];
-		if (models.length === 0) return null;
-
-		return { models, raw: data };
-	} catch {
-		return null;
-	}
-}
-
-/** status 字段语义：1=正常订阅；其他值（3=未订阅，0/2=异常）→ 当作无限 */
-const isActive = (s: number | undefined) => s === 1;
-
-export const minimaxProvider: QuotaProvider<MinimaxData> = {
-	id: "minimax",
-	label: "minimax-token",
-	fetch: fetchMinimax,
-	normalize(raw): NormalizedQuotaRow | null {
-		// 关注 model_name === "general"（文本/LLM 用量），过滤掉 video 等无关项
-		if (!raw?.models) return null;
-		const general = raw.models.find((m) => m.model_name === "general");
-		if (!general) return null;
-
-		const win5h = toWindow(
-			general.current_interval_remaining_percent,
-			general.current_interval_status,
-			general.remains_time,
-		);
-		const winWk = toWindow(
-			general.current_weekly_remaining_percent,
-			general.current_weekly_status,
-			general.weekly_remains_time,
-		);
-
-		return {
-			label: "minimax-token",
-			wins: [win5h, winWk, INFINITE_WIN], // 此 API 不提供月维度
-		};
-	},
-};
-
-/**
- * 把 API 的"剩余百分比"反转为"已用百分比"，并判断是否无限/未订阅。
- *  - status != 1: 当作无限
- *  - total=0 且 percent=100: 也当作无限（典型未订阅状态）
- */
-function toWindow(
-	remainingPercent: number | undefined,
-	status: number | undefined,
-	remainsMs: number | undefined,
-): { pct: number | null; resetSec: number | null } {
-	if (!isActive(status)) return INFINITE_WIN;
-	const rem = Number(remainingPercent ?? 0);
-	// 已用百分比 = 100 - 剩余
-	const used = Math.max(0, Math.min(100, 100 - rem));
-	const resetSec =
-		remainsMs && remainsMs > 0 ? Math.ceil(remainsMs / 1000) : null;
-	return { pct: used, resetSec };
-}

package/src/providers/opencode-go.ts

@@ -1,115 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import {
-	type NormalizedQuotaRow,
-	type QuotaProvider,
-} from "./types.js";
-
-const HOME = homedir();
-const SECRETS_DIR = join(HOME, ".pi", "agent", "secrets");
-const OPENCODE_COOKIE_PATH = join(SECRETS_DIR, "opencode-cookie.txt");
-const OPENCODE_WORKSPACE_URL =
-	"https://opencode.ai/workspace/wrk_01KM5Q3EEQEHZJ3V5PXF5JCR62/go";
-
-export interface OpenCodeGoUsage {
-	status: "ok" | "rate-limited" | "unknown";
-	usagePercent: number;
-	resetInSec: number;
-}
-
-export interface OpenCodeGoData {
-	rolling: OpenCodeGoUsage;
-	weekly: OpenCodeGoUsage;
-	monthly: OpenCodeGoUsage;
-}
-
-async function fetchOpenCodeGo(): Promise<OpenCodeGoData | null> {
-	let cookie = process.env.OPENCODE_COOKIE ?? "";
-	if (!cookie && existsSync(OPENCODE_COOKIE_PATH)) {
-		cookie = readFileSync(OPENCODE_COOKIE_PATH, "utf-8").trim();
-	}
-	if (!cookie) return null;
-
-	try {
-		const resp = await fetch(OPENCODE_WORKSPACE_URL, {
-			headers: {
-				accept: "text/html",
-				cookie,
-				"user-agent": "Mozilla/5.0",
-			},
-			signal: AbortSignal.timeout(8000),
-			redirect: "manual",
-		});
-		// 需要 cookie 才能获取数据，302 说明 cookie 过期
-		if (resp.status !== 200) return null;
-		const html = await resp.text();
-		return parseOpenCodeGo(html);
-	} catch {
-		return null;
-	}
-}
-
-function parseOpenCodeGo(html: string): OpenCodeGoData | null {
-	// SSR HTML 中嵌入了数据：rollingUsage/weeklyUsage/monthlyUsage
-	// 格式：rollingUsage:$R[N]={status:"ok",resetInSec:18000,usagePercent:0}
-	const extract = (
-		name: string,
-	): { status: string; resetInSec: number; usagePercent: number } | null => {
-		const re = new RegExp(
-			`${name}:\\$R\\[\\d+\\]=\\{([^}]+)\\}`,
-		);
-		const m = html.match(re);
-		if (!m) return null;
-		const obj = m[1]!;
-		const statusM = obj.match(/status:"([^"]+)"/);
-		const resetM = obj.match(/resetInSec:(\d+)/);
-		const pctM = obj.match(/usagePercent:(\d+)/);
-		if (!statusM || !resetM || !pctM) return null;
-		return {
-			status: statusM[1],
-			resetInSec: Number(resetM[1]),
-			usagePercent: Number(pctM[1]),
-		};
-	};
-
-	const rolling = extract("rollingUsage");
-	const weekly = extract("weeklyUsage");
-	const monthly = extract("monthlyUsage");
-	if (!rolling || !weekly || !monthly) return null;
-
-	return {
-		rolling: {
-			status: rolling.status as OpenCodeGoUsage["status"],
-			usagePercent: rolling.usagePercent,
-			resetInSec: rolling.resetInSec,
-		},
-		weekly: {
-			status: weekly.status as OpenCodeGoUsage["status"],
-			usagePercent: weekly.usagePercent,
-			resetInSec: weekly.resetInSec,
-		},
-		monthly: {
-			status: monthly.status as OpenCodeGoUsage["status"],
-			usagePercent: monthly.usagePercent,
-			resetInSec: monthly.resetInSec,
-		},
-	};
-}
-
-export const opencodeGoProvider: QuotaProvider<OpenCodeGoData> = {
-	id: "opencodeGo",
-	label: "opencode-go",
-	fetch: fetchOpenCodeGo,
-	normalize(raw): NormalizedQuotaRow | null {
-		if (!raw?.rolling || !raw?.weekly || !raw?.monthly) return null;
-		const toWin = (u: { usagePercent: number; resetInSec: number }) => ({
-			pct: u.usagePercent,
-			resetSec: u.resetInSec > 0 ? u.resetInSec : null,
-		});
-		return {
-			label: "opencode-go",
-			wins: [toWin(raw.rolling), toWin(raw.weekly), toWin(raw.monthly)],
-		};
-	},
-};

package/src/providers/tavily.ts

@@ -1,101 +0,0 @@
-import { readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import {
-	type NormalizedQuotaRow,
-	type QuotaProvider,
-} from "./types.js";
-
-const HOME = homedir();
-
-
-interface TavilyUsageEntry {
-	credits: number;
-	requests: number;
-}
-
-interface TavilyApiUsageEntry {
-	plan_usage: number;
-	plan_limit: number;
-	key_usage: number;
-	key_limit: number;
-	plan_name: string;
-}
-
-interface TavilyState {
-	usage: Record<string, TavilyUsageEntry>;
-	exhausted?: Record<string, unknown>;
-	api_usage?: Record<string, TavilyApiUsageEntry>;
-}
-export interface TavilyData {
-	available: number;
-	total: number;
-	planUsage: number;
-	planLimit: number;
-	planName: string;
-	keyUsage: number;
-	keyLimit: number;
-	credits: number;
-	requests: number;
-}
-
-async function readTavily(): Promise<TavilyData | null> {
-	const stateFile = join(HOME, ".tavily", "state.json");
-	try {
-		const data = JSON.parse(readFileSync(stateFile, "utf-8")) as TavilyState;
-		if (!data?.usage) return null;
-
-		const total = Object.keys(data.usage).length;
-		const exhausted = Object.keys(data.exhausted ?? {}).length;
-		const entries = Object.values(data.usage) as TavilyUsageEntry[];
-		const credits = entries.reduce(
-			(s, v) => s + (v.credits ?? 0),
-			0,
-		);
-		const requests = entries.reduce(
-			(s, v) => s + (v.requests ?? 0),
-			0,
-		);
-
-		const apiEntries = Object.values(data.api_usage ?? {}) as TavilyApiUsageEntry[];
-		let planUsage = 0;
-		let planLimit = 0;
-		let keyUsage = 0;
-		let keyLimit = 0;
-		let planName = "";
-		for (const v of apiEntries) {
-			planUsage += v.plan_usage ?? 0;
-			planLimit += v.plan_limit ?? 0;
-			keyUsage += v.key_usage ?? 0;
-			keyLimit += v.key_limit ?? 0;
-			if (!planName) planName = v.plan_name ?? "";
-		}
-
-		return {
-			available: total - exhausted,
-			total,
-			planUsage,
-			planLimit,
-			planName,
-			keyUsage,
-			keyLimit,
-			credits,
-			requests,
-		};
-	} catch {
-		return null;
-	}
-}
-
-/**
- * Tavily 不参与 3 窗口套餐显示（它在 line 2 的 "tavily X/Y" 单独展示）。
- * 这里仍然注册一个 provider 用于统一数据获取，但 normalize 返回 null（不显示行）。
- */
-export const tavilyProvider: QuotaProvider<TavilyData> = {
-	id: "tavily",
-	label: "tavily",
-	fetch: readTavily,
-	normalize(_raw): NormalizedQuotaRow | null {
-		return null; // 渲染层从 cache.tavily 单独取 available/total
-	},
-};

package/src/providers/types.ts

@@ -1,41 +0,0 @@
-/**
- * Provider 抽象契约
- *
- * 设计要点：
- * - 每个 provider 自带 fetch + normalize，自包含；新增 provider 只需新建文件 + 注册
- * - normalize 返回归一化行（含 label 和三窗口），label 可基于 raw 数据动态生成
- * - fetch 失败 / 无 token 返回 null，框架会保留旧值（Promise.allSettled 模式）
- */
-
-/** 归一化的配额窗口。pct=null 表示无限/未订阅。resetSec=null 表示无限。 */
-export interface QuotaWindow {
-	pct: number | null;
-	resetSec: number | null;
-}
-
-export const INFINITE_WIN: QuotaWindow = { pct: null, resetSec: null };
-
-/** 三个窗口的位置：5h、week、month。 */
-export type QuotaWins = [QuotaWindow, QuotaWindow, QuotaWindow];
-
-/** 归一化结果：可直接渲染的一行。 */
-export interface NormalizedQuotaRow {
-	/** 实际显示名（可由 raw 数据动态生成，如 Z.ai-pro） */
-	label: string;
-	wins: QuotaWins;
-}
-
-/**
- * Provider 实现需要遵守的契约。
- *
- * - `id`: 在 CacheData 上的 key，**新增字段后须更新 readCacheSync 的旧值兼容**。
- * - `label`: 默认显示名（fallback）；normalize 返回的对象里若带 label 则优先使用。
- * - `fetch()`: 拉取原始数据。失败/无凭证返回 null。
- * - `normalize(raw)`: 把原始数据归一化为单行。无法解析返回 null（不显示该行）。
- */
-export interface QuotaProvider<T = unknown> {
-	id: string;
-	label: string;
-	fetch(): Promise<T | null>;
-	normalize(raw: T): NormalizedQuotaRow | null;
-}

package/src/providers/zhipu.ts

@@ -1,147 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import {
-	INFINITE_WIN,
-	type NormalizedQuotaRow,
-	type QuotaProvider,
-} from "./types.js";
-
-const HOME = homedir();
-
-export interface ZhipuData {
-	label: string;
-	tokensPct: number;
-	timePct: number;
-	timeCurrent: number;
-	resetTime: string;
-}
-
-
-interface ZhipuLimit {
-	type: string;
-	percentage?: number;
-	currentValue?: number;
-	nextResetTime?: string;
-}
-
-interface ZhipuApiData {
-	level?: string;
-	limits?: ZhipuLimit[];
-}
-
-interface ZhipuApiResponse {
-	success?: boolean;
-	data?: ZhipuApiData;
-}
-
-async function fetchZhipu(): Promise<ZhipuData | null> {
-	// 优先环境变量，兼容文件
-	let token = process.env.ZAI_AUTH_TOKEN ?? "";
-	if (!token) {
-		const tokenPaths = [
-			join(HOME, ".pi", ".zhipu_auth_token"),
-			join(HOME, ".claude", ".zhipu_auth_token"),
-		];
-		for (const p of tokenPaths) {
-			if (existsSync(p)) {
-				token = readFileSync(p, "utf-8").trim();
-				break;
-			}
-		}
-	}
-	if (!token) return null;
-
-	try {
-		const resp = await fetch(
-			"https://bigmodel.cn/api/monitor/usage/quota/limit",
-			{
-				headers: {
-					accept: "application/json, text/plain, */*",
-					authorization: token,
-					"bigmodel-organization":
-						"org-8F82302F73594F44B2bdCc5A57BCfD1f",
-					"bigmodel-project":
-						"proj_8E86D38C8211410Baa4852408071D1F2",
-					referer:
-						"https://bigmodel.cn/usercenter/glm-coding/usage",
-					"user-agent": "Mozilla/5.0",
-				},
-				signal: AbortSignal.timeout(5000),
-			},
-		);
-		if (!resp.ok) return null;
-		const data = await resp.json() as ZhipuApiResponse;
-		return processZhipu(data);
-	} catch {
-		return null;
-	}
-}
-
-function processZhipu(data: ZhipuApiResponse): ZhipuData | null {
-	if (!data?.success) return null;
-	const d = data.data;
-	const label = d?.level ? `Z.ai-${d.level}` : "Z.ai";
-
-	let tokensPct = 0;
-	let timePct = 0;
-	let timeCurrent = 0;
-	let resetMs = 0;
-
-	for (const lim of d?.limits ?? []) {
-		if (lim.type === "TOKENS_LIMIT") {
-			tokensPct = lim.percentage ?? 0;
-			if (lim.nextResetTime) resetMs = Number(lim.nextResetTime);
-		} else if (lim.type === "TIME_LIMIT") {
-			timePct = lim.percentage ?? 0;
-			timeCurrent = lim.currentValue ?? 0;
-			if (!resetMs && lim.nextResetTime)
-				resetMs = Number(lim.nextResetTime);
-		}
-	}
-
-	let resetTime = "";
-	if (resetMs) {
-		const rem =
-			Math.floor(resetMs / 1000) - Math.floor(Date.now() / 1000);
-		if (rem > 0) {
-			const days = Math.floor(rem / 86400);
-			const hrs = Math.floor((rem % 86400) / 3600);
-			const mins = Math.floor((rem % 3600) / 60);
-			if (days > 0) resetTime = `${days}d${hrs}h`;
-			else if (hrs > 0) resetTime = `${hrs}h${mins}m`;
-			else resetTime = `${mins}m`;
-		}
-	}
-
-	return { label, tokensPct, timePct, timeCurrent, resetTime };
-}
-
-export const zhipuProvider: QuotaProvider<ZhipuData> = {
-	id: "zhipu",
-	label: "Z.ai", // fallback；实际显示来自 raw.label（Z.ai-pro 等）
-	fetch: fetchZhipu,
-	normalize(raw): NormalizedQuotaRow | null {
-		const resetSec = raw.resetTime ? parseZaiResetSec(raw.resetTime) : null;
-		return {
-			label: raw.label || "Z.ai",
-			wins: [
-				{ pct: raw.tokensPct, resetSec },
-				INFINITE_WIN,
-				INFINITE_WIN,
-			],
-		};
-	},
-};
-
-/** 把 ZAI 的 resetTime（如 "4h11m"/"3d20h"）转成剩余秒 */
-function parseZaiResetSec(label: string): number {
-	const dM = label.match(/(\d+)d/);
-	const hM = label.match(/(\d+)h/);
-	const mM = label.match(/(\d+)m/);
-	let sec = 0;
-	if (dM) sec += Number(dM[1]) * 86400;
-	if (hM) sec += Number(hM[1]) * 3600;
-	if (mM) sec += Number(mM[1]) * 60;
-	return sec;
-}