opencode-visual-cache 1.6.1 → 1.7.0-beta.0

package/dist/v2/commands.d.ts

@@ -0,0 +1,10 @@
+import type { Context, KeymapCommand } from "./types";
+import type { PanelApi, PanelSignals } from "../panel/panel-api";
+import { type BalanceProvider } from "../balance-providers";
+/** V2 版 findOpencodeKey：从 V2 provider list 找 OpenCode 已认证的 key（对齐 V1 api.state.provider）。
+ *  导出供 index.tsx 的余额轮询复用。 */
+export declare function findOpencodeKeyV2(context: Context, provider: BalanceProvider): string;
+/** V2 斜杠命令（对齐 V1 10 个命令的完整行为）。
+ *  keymap.layer 必须在组件渲染上下文调用，因此本函数只构建命令数组，
+ *  由渲染组件内 layer(() => ({ commands })) 注册。 */
+export declare function makeCommands(context: Context, api: PanelApi, signals: PanelSignals): KeymapCommand[];

package/dist/v2/commands.js

@@ -0,0 +1,490 @@
+import { CURRENCIES, DEFAULT_RATES, visualPadEnd } from "../core";
+import { balanceProviders, getBalanceProvider } from "../balance-providers";
+import { LANG_META, createT } from "../i18n";
+const KV_PREFIX = "cache_panel";
+// ---------------------------------------------------------------------------
+// V2 helpers（对齐 V1 index.tsx 内嵌辅助；API 形态从 V1 组件式切换为 V2 Promise 式）
+// ---------------------------------------------------------------------------
+/** V2 无 api.state.part API——从消息 content 数组提取 tool parts（V2 Tool part 形状）。 */
+function extractToolParts(msg) {
+    if (!Array.isArray(msg?.content))
+        return [];
+    return msg.content.filter((p) => p?.type === "tool");
+}
+/** V2 版 findOpencodeKey：从 V2 provider list 找 OpenCode 已认证的 key（对齐 V1 api.state.provider）。
+ *  导出供 index.tsx 的余额轮询复用。 */
+export function findOpencodeKeyV2(context, provider) {
+    try {
+        const provs = context.data.location.provider.list();
+        const id = provider.id.toLowerCase();
+        const hit = provs.find((p) => String(p.id ?? "").toLowerCase() === id)
+            ?? provs.find((p) => String(p.id ?? "").toLowerCase().startsWith(id));
+        if (!hit)
+            return "";
+        const k = typeof hit.key === "string" ? hit.key : "";
+        if (k)
+            return k;
+        return typeof hit.options?.apiKey === "string" ? hit.options.apiKey : "";
+    }
+    catch {
+        return "";
+    }
+}
+/** 当前路由 sessionID（V2 ui.router.current()；Route = { type: "session", sessionID }）。 */
+function currentSessionID(context) {
+    try {
+        const rt = context.ui.router.current();
+        if (rt?.type === "session" && rt.sessionID)
+            return String(rt.sessionID);
+    }
+    catch { }
+    return "";
+}
+/** V2 斜杠命令（对齐 V1 10 个命令的完整行为）。
+ *  keymap.layer 必须在组件渲染上下文调用，因此本函数只构建命令数组，
+ *  由渲染组件内 layer(() => ({ commands })) 注册。 */
+export function makeCommands(context, api, signals) {
+    const t = () => createT(() => signals.langCode());
+    /** 菜单中 provider 选项标题：标注 key 来源（手动配置 / OpenCode 自动复用 / 未配置）。 */
+    const providerOptionTitle = (p, current) => {
+        const hasManual = !!api.kv.get(`${KV_PREFIX}.balance.${p.id}.key`, "");
+        const hasAuto = !hasManual && !!findOpencodeKeyV2(context, p);
+        const mark = hasManual
+            ? t()("keyUser")
+            : hasAuto
+                ? t()("keyOpenCode")
+                : t()("keyNotSet");
+        return p.name + mark + (current && p.id === current ? " *" : "");
+    };
+    /** 弹出指定 provider 的 API Key 输入框（空清除 / 含 * 保留原 key / 新 key 实时刷新）。 */
+    const promptBalanceKey = async (provider) => {
+        const current = api.kv.get(`${KV_PREFIX}.balance.${provider.id}.key`, "") ?? "";
+        const val = await context.ui.dialog.prompt({
+            title: provider.name,
+            message: t()("balKeyPrompt", { p: provider.name }),
+            placeholder: provider.keyPlaceholder ?? "sk-...",
+        });
+        if (val === undefined)
+            return; // 取消
+        const input = val.trim();
+        let key;
+        if (input === "") {
+            key = "";
+        }
+        else if (input.includes("*")) {
+            key = current;
+        }
+        else {
+            key = input;
+        }
+        await api.kv.set(`${KV_PREFIX}.balance.${provider.id}.key`, key);
+        signals.setBalanceRefresh(signals.balanceRefresh() + 1);
+        context.ui.toast.show({ message: key ? t()("keySaved") : t()("keyCleared") });
+    };
+    return [
+        // ── /cache-currency 切换货币 ──
+        {
+            id: "opencode-visual-cache.cache.currency",
+            title: "Cache: Set Currency",
+            description: "Change the currency unit for cost display",
+            group: "Cache",
+            palette: true,
+            slash: { name: "cache-currency" },
+            run: async () => {
+                const opt = await context.ui.dialog.select({
+                    title: "Select Currency",
+                    options: Object.entries(CURRENCIES).map(([code, sym]) => ({
+                        title: `${code}  (${sym})`,
+                        value: code,
+                    })),
+                });
+                if (!opt)
+                    return;
+                const sym = CURRENCIES[opt] ?? "$";
+                const defRate = DEFAULT_RATES[opt] ?? 1;
+                await api.kv.set(`${KV_PREFIX}.currency`, sym);
+                await api.kv.set(`${KV_PREFIX}.rate`, defRate);
+                // 同步余额显示币种偏好：CNY/USD 原生直显，其余币种按汇率换算
+                await api.kv.set(`${KV_PREFIX}.balance_currency`, opt);
+                signals.setBalanceCurrency(opt);
+                signals.setCurrencySymbol(sym);
+                signals.setExchangeRate(defRate);
+                context.ui.toast.show({ message: t()("currencySet", { v: opt, s: sym, r: defRate }) });
+            },
+        },
+        // ── /cache-rate 调整汇率 ──
+        {
+            id: "opencode-visual-cache.cache.rate",
+            title: "Cache: Set Exchange Rate",
+            description: "Set the exchange rate multiplier for the selected currency",
+            group: "Cache",
+            palette: true,
+            slash: { name: "cache-rate" },
+            run: async () => {
+                const val = await context.ui.dialog.prompt({
+                    title: "Exchange Rate",
+                    message: "Enter the exchange rate from USD to your currency (e.g. 7.2 for CNY)",
+                    placeholder: "1.0",
+                });
+                if (val === undefined)
+                    return;
+                const n = parseFloat(val);
+                if (n > 0) {
+                    await api.kv.set(`${KV_PREFIX}.rate`, n);
+                    signals.setExchangeRate(n);
+                    context.ui.toast.show({ message: t()("rateSet", { r: n }) });
+                }
+            },
+        },
+        // ── /cache-section 开关区块与边框 ──
+        {
+            id: "opencode-visual-cache.cache.section",
+            title: "Cache: Toggle Section",
+            description: "Show or hide a sidebar section",
+            group: "Cache",
+            palette: true,
+            slash: { name: "cache-section" },
+            run: async () => {
+                const detailOn = Boolean(api.kv.get(`${KV_PREFIX}.section.detail`, true));
+                const modelOn = Boolean(api.kv.get(`${KV_PREFIX}.section.model`, true));
+                const distOn = Boolean(api.kv.get(`${KV_PREFIX}.section.dist`, true));
+                const skillsOn = Boolean(api.kv.get(`${KV_PREFIX}.section.skills`, true));
+                const balanceOn = Boolean(api.kv.get(`${KV_PREFIX}.section.balance`, true));
+                const bottomOn = Boolean(api.kv.get(`${KV_PREFIX}.section.bottom`, true));
+                const borderOn = Boolean(api.kv.get(`${KV_PREFIX}.border`, true));
+                const labels = {
+                    detail: t()("secDetail"),
+                    model: t()("secModel"),
+                    dist: t()("distTitle"),
+                    skills: t()("secSkills"),
+                    balance: t()("secBalance"),
+                    bottom: t()("secBottom"),
+                    border: t()("secBorder"),
+                };
+                const optTitle = (label, on) => `${visualPadEnd(label, 15)}[${on ? "ON" : "OFF"}]`;
+                const opt = await context.ui.dialog.select({
+                    title: t()("secToggle"),
+                    options: [
+                        { title: optTitle(labels.detail, detailOn), value: "detail" },
+                        { title: optTitle(labels.model, modelOn), value: "model" },
+                        { title: optTitle(labels.dist, distOn), value: "dist" },
+                        { title: optTitle(labels.skills, skillsOn), value: "skills" },
+                        { title: optTitle(labels.balance, balanceOn), value: "balance" },
+                        { title: optTitle(labels.bottom, bottomOn), value: "bottom" },
+                        { title: optTitle(labels.border, borderOn), value: "border" },
+                    ],
+                });
+                if (!opt)
+                    return;
+                if (opt === "border") {
+                    const cur = Boolean(api.kv.get(`${KV_PREFIX}.border`, true));
+                    await api.kv.set(`${KV_PREFIX}.border`, !cur);
+                    signals.setBorderVisible(!cur);
+                    context.ui.toast.show({ message: !cur ? t()("borderShown") : t()("borderHidden") });
+                }
+                else {
+                    const key = `${KV_PREFIX}.section.${opt}`;
+                    const cur = Boolean(api.kv.get(key, true));
+                    await api.kv.set(key, !cur);
+                    if (opt === "detail")
+                        signals.setSectionDetail(!cur);
+                    if (opt === "model")
+                        signals.setSectionModel(!cur);
+                    if (opt === "dist")
+                        signals.setSectionDist(!cur);
+                    if (opt === "skills")
+                        signals.setSectionSkills(!cur);
+                    if (opt === "balance")
+                        signals.setSectionBalance(!cur);
+                    if (opt === "bottom")
+                        signals.setSectionBottom(!cur);
+                    const name = labels[opt] ?? opt;
+                    context.ui.toast.show({ message: t()(!cur ? "sectionShown" : "sectionHidden", { s: name }) });
+                }
+            },
+        },
+        // ── /cache-config 查看当前配置 ──
+        {
+            id: "opencode-visual-cache.cache.config",
+            title: "Cache: Show Config",
+            description: "Display the current plugin configuration",
+            group: "Cache",
+            palette: true,
+            slash: { name: "cache-config" },
+            run: () => {
+                const sym = api.kv.get(`${KV_PREFIX}.currency`) ?? "$";
+                const rate = api.kv.get(`${KV_PREFIX}.rate`) ?? 1;
+                const detail = Boolean(api.kv.get(`${KV_PREFIX}.section.detail`, true));
+                const model = Boolean(api.kv.get(`${KV_PREFIX}.section.model`, true));
+                const dist = Boolean(api.kv.get(`${KV_PREFIX}.section.dist`, true));
+                const skills = Boolean(api.kv.get(`${KV_PREFIX}.section.skills`, true));
+                const balance = Boolean(api.kv.get(`${KV_PREFIX}.section.balance`, true));
+                const bottom = Boolean(api.kv.get(`${KV_PREFIX}.section.bottom`, true));
+                const on = (v) => v ? "ON" : "OFF";
+                context.ui.toast.show({
+                    title: t()("panelConfigTitle"),
+                    message: t()("panelConfigMsg", {
+                        c: sym, r: rate,
+                        d: on(detail), m: on(model),
+                        t: on(dist), k: on(skills),
+                        b: on(balance), f: on(bottom),
+                    }),
+                });
+            },
+        },
+        // ── /cache-lang 切换显示语言 ──
+        {
+            id: "opencode-visual-cache.cache.lang",
+            title: "Cache: Switch Language",
+            description: "Switch display language (Chinese / English / 日本語 / 한국어)",
+            group: "Cache",
+            palette: true,
+            slash: { name: "cache-lang" },
+            run: async () => {
+                const cur = signals.langCode();
+                const opt = await context.ui.dialog.select({
+                    title: t()("langTitle"),
+                    options: LANG_META.map((m) => ({
+                        title: `${visualPadEnd(m.label, 9)}${cur === m.code ? "\u2713" : ""}`,
+                        value: m.code,
+                    })),
+                });
+                if (!opt)
+                    return;
+                await api.kv.set(`${KV_PREFIX}.lang`, opt);
+                signals.setLangCode(opt);
+                context.ui.toast.show({ message: t()("langSwitched") });
+            },
+        },
+        // ── /cache-balance 切换余额提供商 / 自动切换 ──
+        {
+            id: "opencode-visual-cache.cache.balance",
+            title: "Cache: Switch Balance Provider",
+            description: "切换余额提供商 / 自动切换当前会话提供商 | Switch balance provider / auto-switch session provider",
+            group: "Cache",
+            palette: true,
+            slash: { name: "cache-balance" },
+            run: async () => {
+                const current = signals.balanceProviderId();
+                const auto = signals.autoBalance();
+                const autoLabel = `${t()("autoSwitchOpt")} [${auto ? "ON" : "OFF"}]`;
+                const opt = await context.ui.dialog.select({
+                    title: t()("balProvTitle"),
+                    options: [
+                        { title: autoLabel, value: "__auto__" },
+                        ...balanceProviders.map((p) => ({
+                            title: providerOptionTitle(p, current),
+                            value: p.id,
+                        })),
+                    ],
+                });
+                if (!opt)
+                    return;
+                if (opt === "__auto__") {
+                    const next = !auto;
+                    await api.kv.set(`${KV_PREFIX}.balance.auto`, next);
+                    signals.setAutoBalance(next);
+                    context.ui.toast.show({ message: next ? t()("autoSwitchOn") : t()("autoSwitchOff") });
+                }
+                else {
+                    const provider = getBalanceProvider(opt);
+                    // 手动切换会关闭自动切换
+                    await api.kv.set(`${KV_PREFIX}.balance.provider`, provider.id);
+                    await api.kv.set(`${KV_PREFIX}.balance.auto`, false);
+                    signals.setBalanceProviderId(provider.id);
+                    signals.setAutoBalance(false);
+                    signals.setBalanceUnsupported(false);
+                    // 切换后立即按新 provider 刷新显示（无 key 时显示 idle，避免残留上一 provider 余额）
+                    signals.setBalanceRefresh(signals.balanceRefresh() + 1);
+                    const hasKey = !!api.kv.get(`${KV_PREFIX}.balance.${provider.id}.key`, "");
+                    if (!hasKey) {
+                        // 未配置 key → 进入设置流程（对话框保持打开等待输入）
+                        await promptBalanceKey(provider);
+                    }
+                    else {
+                        context.ui.toast.show({ message: t()("providerManual", { p: provider.name }) });
+                    }
+                }
+            },
+        },
+        // ── /cache-balance-key 设置余额 API Key（两步：选 provider → 输 key）──
+        {
+            id: "opencode-visual-cache.cache.balance.key",
+            title: "Cache: Set Balance API Key",
+            description: "Select a provider and set its API key for balance display",
+            group: "Cache",
+            palette: true,
+            slash: { name: "cache-balance-key" },
+            run: async () => {
+                // 步骤 1：选择 provider
+                const opt = await context.ui.dialog.select({
+                    title: t()("balSelectTitle"),
+                    options: balanceProviders.map((p) => ({
+                        title: providerOptionTitle(p),
+                        value: p.id,
+                    })),
+                });
+                if (!opt)
+                    return;
+                const provider = getBalanceProvider(opt);
+                // 手动指定 provider 会关闭自动切换
+                await api.kv.set(`${KV_PREFIX}.balance.provider`, provider.id);
+                await api.kv.set(`${KV_PREFIX}.balance.auto`, false);
+                signals.setBalanceProviderId(provider.id);
+                signals.setAutoBalance(false);
+                // 切换后立即刷新显示（防止取消输入时残留上一 provider 的余额）
+                signals.setBalanceRefresh(signals.balanceRefresh() + 1);
+                // 步骤 2：输入 key
+                await promptBalanceKey(provider);
+            },
+        },
+        // ── /cache-debug-skills 技能检测调试 ──
+        {
+            id: "opencode-visual-cache.cache.debug-skills",
+            title: "Cache: Debug Skills Detection",
+            description: "Dump all tool parts found in the current session for skill detection debugging",
+            group: "Cache",
+            palette: true,
+            slash: { name: "cache-debug-skills" },
+            run: () => {
+                const sid = currentSessionID(context);
+                if (!sid) {
+                    context.ui.toast.show({ message: t()("runInSession"), variant: "warning" });
+                    return;
+                }
+                const msgs = api.state.session.messages(sid);
+                const byTool = {};
+                const skillParts = [];
+                for (const msg of msgs) {
+                    if (msg.role !== "assistant")
+                        continue;
+                    for (const p of extractToolParts(msg)) {
+                        const tool = String(p.tool ?? "?");
+                        byTool[tool] = (byTool[tool] ?? 0) + 1;
+                        if (tool === "skill") {
+                            const meta = p.state?.metadata;
+                            const rootMeta = p.metadata;
+                            skillParts.push(`state.metadata=${JSON.stringify(meta)} | root.metadata=${JSON.stringify(rootMeta)} | state.title="${p.state?.title}" | state.output[:80]="${String(p.state?.output ?? "").slice(0, 80)}"`);
+                        }
+                    }
+                }
+                const summary = Object.entries(byTool).map(([k, v]) => `${k}: ${v}`).join(" | ");
+                const extra = skillParts.length > 0
+                    ? "\n\nSkill parts:\n" + skillParts.join("\n")
+                    : "\n\n⚠ No skill tool parts found — AI may be reading SKILL.md instead. Try: 'Use the skill tool to load karpathy-guidelines'";
+                context.ui.toast.show({
+                    title: `Tool Summary (${Object.keys(byTool).length} types)`,
+                    message: summary + extra,
+                });
+            },
+        },
+        // ── /cache-session 子代理缓存统计 ──
+        {
+            id: "opencode-visual-cache.cache.session",
+            title: "Cache: Sub-Agent Stats",
+            description: "View token cache statistics for a sub-agent by session ID",
+            group: "Cache",
+            palette: true,
+            slash: { name: "cache-session" },
+            run: async () => {
+                // ── 扫描当前主 session 的子代理 session ID 列表 ──
+                const parentSid = currentSessionID(context);
+                const SUBAGENT_TOOLS = new Set(["task", "delegate", "call_omo_agent"]);
+                const children = [];
+                if (parentSid) {
+                    try {
+                        const msgs = api.state.session.messages(parentSid);
+                        for (const msg of msgs) {
+                            if (msg.role !== "assistant")
+                                continue;
+                            for (const p of extractToolParts(msg)) {
+                                const tool = String(p.tool ?? "");
+                                if (!SUBAGENT_TOOLS.has(tool))
+                                    continue;
+                                const st = p.state;
+                                const stMeta = st?.metadata;
+                                const subSid = stMeta?.session_id ?? stMeta?.sessionId;
+                                if (!subSid)
+                                    continue;
+                                const sidStr = String(subSid);
+                                const input = st?.input;
+                                const agent = String(p.subagent_type ?? input?.subagent_type ?? input?.category ?? tool);
+                                const prompt = String(input?.prompt ?? "");
+                                const desc = input?.description ? String(input.description) : "";
+                                const title = desc || prompt.replace(/\n/g, " ").replace(/\s+/g, " ").trim().slice(0, 40) || agent;
+                                children.push({ title, value: sidStr, description: `${agent} · ${sidStr.slice(0, 24)}…` });
+                            }
+                        }
+                    }
+                    catch { }
+                }
+                // 去重
+                const seen = new Set();
+                const unique = children.filter(c => { if (seen.has(c.value))
+                    return false; seen.add(c.value); return true; });
+                if (unique.length > 0) {
+                    // ── 有子代理 → DialogSelect 列表选择 ──
+                    const currentSid = signals.overrideSessionId() ?? api.kv.get(`${KV_PREFIX}.session`, "");
+                    const options = unique.map((c, i) => ({
+                        title: `${i + 1}. ${c.title}`,
+                        value: c.value,
+                        description: c.description,
+                    }));
+                    // 首尾各放一个"回到主会话"，长列表时顶部底部均可直达
+                    const backValue = "__main__";
+                    const backTitle = `\u2500 ${t()("backToMainTitle")}`;
+                    options.unshift({ title: backTitle, value: backValue, description: "" });
+                    options.push({ title: backTitle, value: backValue, description: "" });
+                    const currentIdx = currentSid ? options.findIndex(o => o.value === currentSid) : -1;
+                    const opt = await context.ui.dialog.select({
+                        title: t()("subSelectTitle"),
+                        options,
+                        current: currentIdx >= 0 ? options[currentIdx].value : undefined,
+                    });
+                    if (!opt)
+                        return;
+                    if (opt === backValue) {
+                        signals.setOverrideSessionId(undefined);
+                        await api.kv.set(`${KV_PREFIX}.session`, "");
+                        context.ui.toast.show({ message: t()("backToMain") });
+                    }
+                    else {
+                        signals.setOverrideSessionId(opt);
+                        await api.kv.set(`${KV_PREFIX}.session`, opt);
+                        context.ui.toast.show({ message: t()("subAgentSwitched", { s: opt.slice(0, 24) + "\u2026" }) });
+                    }
+                }
+                else {
+                    // ── 无子代理 → DialogPrompt 手动粘贴 ──
+                    const val = await context.ui.dialog.prompt({
+                        title: signals.overrideSessionId() ? t()("subSwitchTitle") : t()("subViewTitle"),
+                        message: t()("subNoFound"),
+                        placeholder: "ses_...",
+                    });
+                    if (val === undefined)
+                        return;
+                    const sid = val.trim();
+                    if (sid) {
+                        signals.setOverrideSessionId(sid);
+                        await api.kv.set(`${KV_PREFIX}.session`, sid);
+                        context.ui.toast.show({ message: t()("subAgentSwitched", { s: sid.slice(0, 24) + "\u2026" }) });
+                    }
+                }
+            },
+        },
+        // ── /cache-session-back 返回主会话 ──
+        {
+            id: "opencode-visual-cache.cache.session.back",
+            title: "Cache: Back to Main",
+            description: "Return to main session stats",
+            group: "Cache",
+            palette: true,
+            slash: { name: "cache-session-back" },
+            run: async () => {
+                signals.setOverrideSessionId(undefined);
+                await api.kv.set(`${KV_PREFIX}.session`, "");
+                context.ui.toast.show({ message: t()("backToMain") });
+            },
+        },
+    ];
+}

package/dist/v2/data.d.ts

@@ -0,0 +1,27 @@
+import type { Context, MessageInfo } from "./types";
+/** 汇总一个会话的 token 用量与费用（V2 adapter → 同构模型）。 */
+export interface SessionStats {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    reasoning: number;
+    cost: number;
+    hasData: boolean;
+}
+/** 从 messages 汇总 token：统计全部 assistant 消息的 API 精确值。 */
+export declare function collectSessionStats(context: Context, sessionID: string): SessionStats;
+/** 缓存命中率（0–100）：缓存读 /（新鲜输入 + 缓存读 + 缓存写），与 V1 口径一致。 */
+export declare function hitRate(stats: SessionStats): number;
+/** 输入侧总量（底部栏口径，不含输出）。 */
+export declare function inputTotal(stats: SessionStats): number;
+/** 单条命中率（V1 底部栏口径）：最后一条有 token 的 assistant 消息，
+ *  分母含缓存写 read/(input+read+write)；prevHitRate 为上一条（趋势用）。 */
+export declare function collectLastHitRate(context: Context, sessionID: string): {
+    hitRate: number;
+    prevHitRate: number;
+    input: number;
+    read: number;
+    write: number;
+};
+export type { MessageInfo };

package/dist/v2/data.js

@@ -0,0 +1,103 @@
+import { num } from "../core";
+/** 从 messages 汇总 token：统计全部 assistant 消息的 API 精确值。 */
+export function collectSessionStats(context, sessionID) {
+    const msgs = context.data.session.message.list(sessionID) ?? [];
+    let input = 0;
+    let output = 0;
+    let cacheRead = 0;
+    let cacheWrite = 0;
+    let reasoning = 0;
+    let cost = 0;
+    let hasData = false;
+    for (const m of msgs) {
+        if (m.type !== "assistant")
+            continue;
+        const t = m.tokens;
+        if (!t)
+            continue;
+        input += num(t.input);
+        output += num(t.output);
+        reasoning += num(t.reasoning);
+        cacheRead += num(t.cache?.read);
+        cacheWrite += num(t.cache?.write);
+        hasData = true;
+    }
+    // 会话级费用优先（V2 提供 cost()），消息级 cost 兜底（结构未知，宽松读取）
+    const sessionCost = context.data.session.cost(sessionID);
+    if (Number.isFinite(sessionCost) && sessionCost > 0)
+        cost = sessionCost;
+    else {
+        for (const m of msgs) {
+            if (m.type !== "assistant" || m.cost == null)
+                continue;
+            const c = m.cost;
+            if (typeof c === "number" && Number.isFinite(c))
+                cost += c;
+            else {
+                const amt = c.amount;
+                if (typeof amt === "number" && Number.isFinite(amt))
+                    cost += amt;
+                else if (typeof amt === "string") {
+                    const n = parseFloat(amt);
+                    if (Number.isFinite(n))
+                        cost += n;
+                }
+            }
+        }
+    }
+    return { input, output, cacheRead, cacheWrite, reasoning, cost, hasData };
+}
+/** 缓存命中率（0–100）：缓存读 /（新鲜输入 + 缓存读 + 缓存写），与 V1 口径一致。 */
+export function hitRate(stats) {
+    const denom = stats.input + stats.cacheRead + stats.cacheWrite;
+    if (denom <= 0)
+        return 0;
+    return (stats.cacheRead / denom) * 100;
+}
+/** 输入侧总量（底部栏口径，不含输出）。 */
+export function inputTotal(stats) {
+    return stats.input + stats.cacheRead + stats.cacheWrite;
+}
+/** 单条命中率（V1 底部栏口径）：最后一条有 token 的 assistant 消息，
+ *  分母含缓存写 read/(input+read+write)；prevHitRate 为上一条（趋势用）。 */
+export function collectLastHitRate(context, sessionID) {
+    const msgs = context.data.session.message.list(sessionID) ?? [];
+    const session = context.data.session.get(sessionID);
+    let input = num(session?.tokens?.input);
+    let read = num(session?.tokens?.cache?.read);
+    let write = num(session?.tokens?.cache?.write);
+    // 无 session 聚合字段 → 遍历消息累加（与 V1 fallback 一致）
+    if (session?.tokens == null) {
+        for (const m of msgs) {
+            if (m.type !== "assistant")
+                continue;
+            const t = m.tokens;
+            if (!t)
+                continue;
+            input += num(t.input);
+            read += num(t.cache?.read);
+            write += num(t.cache?.write);
+        }
+    }
+    let hitRate = -1, prevHitRate = -1;
+    for (let i = msgs.length - 1; i >= 0; i--) {
+        const m = msgs[i];
+        if (m.type !== "assistant")
+            continue;
+        const tk = m.tokens;
+        if (!tk)
+            continue;
+        const mit = num(tk.input) + num(tk.cache?.read) + num(tk.cache?.write);
+        const mrt = num(tk.cache?.read);
+        if (mit <= 0)
+            continue;
+        const rate = (mrt / mit) * 100;
+        if (hitRate < 0) {
+            hitRate = rate;
+            continue;
+        }
+        prevHitRate = rate;
+        break;
+    }
+    return { hitRate, prevHitRate, input, read, write };
+}

package/dist/v2/index.d.ts

@@ -0,0 +1,4 @@
+/** @jsxImportSource @opentui/solid */
+import type { PluginModule } from "./types";
+declare const mod: PluginModule;
+export default mod;