opencode-visual-cache 1.4.0 → 1.6.0

package/README.md

@@ -48,11 +48,13 @@
 - **颜色自适应**：命中率 ≥85% 绿 · ≥70% 橙 · <70% 红，颜色从主题色自动去饱和
 - **Token 分布**：按角色（系统提示 / 用户 / Agent 指令 / Tool 调用 / Tool 结果）展示估算 Token 占比
 - **折叠记忆**：折叠状态持久化，重启后保持
-- **语言适配**：自动检测系统语言，支持 `/cache-lang` 运行时切换中/英文，偏好持久化
+- **语言适配**：支持 中文 / English / 日本語 / 한국어，自动检测系统语言，`/cache-lang` 运行时切换，偏好持久化优先
 - **多币种**：通过 `/cache-currency` 切换货币，费用和节省同步换算
+- **余额查询**：查询多家 AI 提供商的账户余额，支持自动切换跟随当前会话提供商
 - **斜杠命令**：`/cache-session` `/cache-session-back` `/cache-rate` `/cache-section` `/cache-config` `/cache-lang` 动态配置面板
 - **子代理缓存查看**：`/cache-session` 自动扫描并列出子代理，选择一个即可切换面板显示其缓存统计，支持 `/cache-session-back` 返回主会话
 - **已加载技能**：检测 session 中 LLM 调用 `skill` tool 的记录，展示已加载技能名及估算 Token 占用
+- **底部状态栏**：输入框提示行单行显示 命中率（含趋势）· Tokens · 余额，关闭侧边栏也能随时看到缓存统计，可经 `/cache-section` 隐藏
 
 ---
 
@@ -105,9 +107,11 @@ npm install -g opencode-visual-cache@latest
 | `/cache-session-back` | 返回主会话统计 | 从子代理缓存视图切回主会话 |
 | `/cache-currency` | 切换货币单位 | 从列表选择货币（USD / CNY / EUR / JPY / GBP / KRW），自动填入默认汇率 |
 | `/cache-rate` | 调整汇率乘数 | 输入自定义汇率（如 `7.2`），用于费用换算 |
-| `/cache-section` | 开关区块与边框 | 独立控制 Token 明细 / 模型与定价 / 估算 Token 分布 / 已加载技能 / 面板边框的显隐 |
+| `/cache-section` | 开关区块与边框 | 独立控制 Token 明细 / 模型与定价 / 估算 Token 分布 / 已加载技能 / 余额 / 底部状态栏 / 面板边框的显隐 |
 | `/cache-config` | 查看当前配置 | 弹出当前货币、汇率、区块可见性状态 |
 | `/cache-lang` | 切换显示语言 | 从列表选择中文或 English，界面即时切换，无需重启 |
+| `/cache-balance` | 余额查询设置 | 选择余额提供商（菜单标注 Key 来源：用户 key / OpenCode / 未配置）/ 开关自动切换 |
+| `/cache-balance-key` | 设置余额 API Key | 两步流程：选择提供商 → 输入 API Key |
 
 <div align="center">
   <img src="https://raw.githubusercontent.com/Hotakus/opencode-visual-cache/master/assets/splash_cmd.png" alt="斜杠命令" width="49%"></img>
@@ -141,11 +145,40 @@ npm install -g opencode-visual-cache@latest
 - **模型与定价**：费用 / 提供商 / 模型名 / 单价
 - **估算 Token 分布**：按角色拆分的 Token 估算
 - **已加载技能**：session 中 LLM 实际调用过的 Skill 名及估算 Token 占用
+- **余额**：当前提供商账户余额（多提供商 + 自动切换）
+- **底部状态栏**：输入框提示行的 命中率 · Tokens · 余额 单行统计
 
 通过 `/cache-section` 切换后即时生效，无需重启。此外，该命令还可以开关面板的**外边框**——关闭后内容会顶格显示，释放额外空间。
 
 > **关于 Token 分布数值**：分布面板中"总计"为最后一次 API 调用的精确 token 数，"系统提示"/"用户"等分项为字符级 BPE 估算值。分项之和通常小于总计，差值主要来自 OpenCode 运行时注入的系统提示组成部分，包括环境信息、Skill 目录、工具 Schema 定义等（详见 [`system.ts`](https://github.com/anomalyco/opencode/blob/dev/packages/opencode/src/session/system.ts)、[`tools.ts`](https://github.com/anomalyco/opencode/blob/dev/packages/opencode/src/session/tools.ts)）。这些内容不在 agent 配置的 `prompt` 字段中，因此插件无法估算，属于预期行为。
 
+### 4.4 余额查询
+
+面板支持显示多家 AI 提供商的账户余额。开启**自动切换**后，余额查询会跟随当前会话正在使用的模型提供商自动切换。
+
+已支持余额查询的提供商：
+
+| 提供商 | 余额查询端点 | 币种 | Key 前缀 | 状态 |
+|--------|-------------|------|---------|------|
+| DeepSeek | `https://api.deepseek.com/user/balance` | CNY / USD | `sk-` | ✅ 已支持 |
+| SiliconFlow | `https://api.siliconflow.cn/v1/user/info` | CNY | `sk-` | ✅ 已支持 |
+| OpenRouter | `https://openrouter.ai/api/v1/credits` | USD | `sk-or-` | ✅ 已支持 |
+| Moonshot | `https://api.moonshot.cn/v1/users/me/balance` | CNY | `sk-` | ✅ 已支持 |
+| 智谱 GLM | 待接入（社区逆向端点，非官方） | CNY | — | ⏳ 希望支持 |
+| xAI | 待接入（需 Management Key + Team ID） | USD | — | ⏳ 希望支持 |
+
+> **Key 来源**：优先使用 `/cache-balance-key` 手动配置的 Key；未手动配置时自动复用 OpenCode 已认证的凭据（`/connect` 配置的 provider）。两者都没有的提供商无法查询余额。
+>
+> **Key 存储**：手动配置的 API Key 明文保存于插件持久化 KV，请勿在共享设备上使用。
+>
+> **自动切换**：默认开启；手动选择提供商后自动关闭，可在 `/cache-balance` 中重新开启。自动切换按当前会话的模型提供商匹配，未配置 Key 的提供商被选中时显示「未配置」提示。
+>
+> **希望支持**：已调研确认具备可行性的候选提供商，尚未实现。智谱 GLM 仅有社区逆向的非官方端点（无稳定性保障）。
+>
+> **统计口径**：命中率 = 缓存读 /（新鲜输入 + 缓存读 + 缓存写），与业界（OpenAI / Anthropic / Bedrock）口径一致；明细中「未命中」= 新鲜输入 + 缓存写。底部栏的 Tokens 为输入侧总量（不含输出）。未单独报告缓存写的提供商（如 DeepSeek）自动退化为 hit/miss 口径。
+>
+> **余额显示**：侧边栏与底部栏共享同一份余额数据，两处显示一致。当前提供商不支持余额查询时，侧边栏显示提示、底部栏隐藏余额项。
+
 ---
 
 ## 5. 更新
@@ -180,11 +213,11 @@ rm -rf ~/.cache/opencode/packages/opencode-visual-cache@latest
 
 ### 6.1 运行时切换（推荐）
 
-在 TUI 中输入 `/cache-lang`，从弹窗选择「中文」或「English」即可即时切换，无需重启。偏好会自动持久化，下次启动自动恢复。
+在 TUI 中输入 `/cache-lang`，从弹窗选择 中文 / English / 日本語 / 한국어 即可即时切换，无需重启。偏好会自动持久化，下次启动优先恢复用户选择。
 
 ### 6.2 环境变量覆盖
 
-启动前设置 `CACHE_TUI_LANG` 环境变量可强制指定语言：
+启动前设置 `CACHE_TUI_LANG` 环境变量可强制指定语言（`zh` / `en` / `ja` / `ko`）：
 
 ```powershell
 # Windows PowerShell

package/README_EN.md

@@ -48,11 +48,13 @@ Interested in sub-agent monitoring? Check out [opencode-subagent-magazine](https
 - **Adaptive Colors**: ≥85% green · ≥70% orange · <70% red, auto-desaturated from current theme
 - **Token Distribution**: Per-role (system / user / agent instr / tool call / tool result) estimated token breakdown
 - **Persistent State**: Fold preferences and config remembered across restarts via api.kv
-- **Language**: Auto-detects system locale, with `/cache-lang` for runtime switching between Chinese and English — preference persisted across restarts
+- **Language**: Chinese / English / 日本語 / 한국어, auto-detects system locale, with `/cache-lang` for runtime switching — user preference takes priority over auto-detection
 - **Multi-currency**: Switch via `/cache-currency` — costs, savings, and per-million rates convert in real time
+- **Balance Query**: Query account balance across multiple AI providers, with auto-switch following the current session's provider
 - **Slash Commands**: `/cache-session` `/cache-session-back` `/cache-rate` `/cache-section` `/cache-config` `/cache-lang` for live panel configuration
 - **Sub-Agent Cache View**: `/cache-session` auto-scans and lists sub-agents; select one to switch the panel stats. Use `/cache-session-back` to return to the main session
 - **Loaded Skills**: Detects `skill` tool calls in the session and displays loaded skill names with estimated token footprint
+- **Bottom Status Bar**: single-line hit rate (with trend) · Tokens · Balance in the prompt hint row — visible even with the sidebar closed; hide it anytime via `/cache-section`
 
 ---
 
@@ -105,9 +107,11 @@ The plugin supports slash commands and command palette (`Ctrl + P`) for runtime
 | `/cache-session-back` | Return to main session | Switch back to main session from sub-agent cache view |
 | `/cache-currency` | Switch currency | Pick from a list (USD / CNY / EUR / JPY / GBP / KRW); default exchange rate auto-filled |
 | `/cache-rate` | Adjust exchange rate | Enter a custom rate (e.g. `7.2` for CNY) |
-| `/cache-section` | Toggle sections & border | Independently show/hide Detail, Model & Pricing, Token Distribution, Loaded Skills, or the panel border |
+| `/cache-section` | Toggle sections & border | Independently show/hide Detail, Model & Pricing, Token Distribution, Loaded Skills, Balance, Bottom Bar, or the panel border |
 | `/cache-config` | View current config | Displays currency, rate, and section visibility |
 | `/cache-lang` | Switch display language | Pick Chinese or English from the dialog — takes effect immediately, no restart needed |
+| `/cache-balance` | Balance query settings | Pick a balance provider (menu shows key source: user key / OpenCode / not set) / toggle auto-switch |
+| `/cache-balance-key` | Set balance API key | Two-step flow: pick a provider → enter the API key |
 
 <div align="center">
   <img src="https://raw.githubusercontent.com/Hotakus/opencode-visual-cache/master/assets/splash_cmd.png" alt="Slash command" width="49%"></img>
@@ -141,9 +145,38 @@ Three sub-sections can be toggled independently to save sidebar space:
 - **Model & Pricing**: cost / provider / model name / per-million rates
 - **Estimated Token Dist.**: per-role token breakdown
 - **Loaded Skills**: skill names the LLM actually loaded via the `skill` tool, with estimated token counts
+- **Balance**: the selected provider's account balance (multi-provider with auto-switch)
+- **Bottom Status Bar**: the single-line hit rate · Tokens · Balance stats in the prompt hint row
 
 Toggled via `/cache-section` — takes effect instantly, no restart required. The same command also toggles the panel **border**; turning it off removes the outline and padding so content fills the full width.
 
+### 4.4 Balance Query
+
+The panel can display account balance from multiple AI providers. With **auto-switch** enabled, the balance query follows the model provider of the current session automatically.
+
+Supported balance providers:
+
+| Provider | Balance endpoint | Currency | Key prefix | Status |
+|----------|-----------------|----------|------------|--------|
+| DeepSeek | `https://api.deepseek.com/user/balance` | CNY / USD | `sk-` | ✅ Supported |
+| SiliconFlow | `https://api.siliconflow.cn/v1/user/info` | CNY | `sk-` | ✅ Supported |
+| OpenRouter | `https://openrouter.ai/api/v1/credits` | USD | `sk-or-` | ✅ Supported |
+| Moonshot | `https://api.moonshot.cn/v1/users/me/balance` | CNY | `sk-` | ✅ Supported |
+| Zhipu GLM | Pending (community-reversed endpoint, unofficial) | CNY | — | ⏳ Planned |
+| xAI | Pending (requires Management Key + Team ID) | USD | — | ⏳ Planned |
+
+> **Key source**: a key set manually via `/cache-balance-key` takes priority; otherwise the plugin reuses the credential OpenCode already authenticated (`/connect`-configured providers). Providers with neither cannot show a balance.
+>
+> **Key storage**: manually configured API keys are stored in plaintext in the plugin's persistent KV — avoid using on shared devices.
+>
+> **Auto-switch**: enabled by default; picking a provider manually disables it — re-enable anytime via `/cache-balance`. Auto-switch matches the current session's model provider; a provider without a key shows a "not set" hint when selected.
+>
+> **Planned**: candidates confirmed feasible by research, not yet implemented. Zhipu GLM only has a community-reversed unofficial endpoint (no stability guarantee).
+>
+> **Metric semantics**: hit rate = cache read / (fresh input + cache read + cache write), consistent with the industry (OpenAI / Anthropic / Bedrock). "Miss" in the detail view = fresh input + cache write. The bottom-bar Tokens is the input-side total (output excluded). Providers that do not report cache writes separately (e.g. DeepSeek) automatically fall back to the hit/miss formula.
+>
+> **Balance display**: the sidebar and bottom bar share the same balance data, so both show identical values. When the current provider has no balance adapter, the sidebar shows a hint and the bottom bar hides the balance segment.
+
 ---
 
 ## 5. Update
@@ -178,11 +211,11 @@ The plugin provides three ways to control the display language, listed by priori
 
 ### 6.1 Runtime Switching (recommended)
 
-Type `/cache-lang` in the TUI and select **Chinese** or **English** from the dialog. The panel switches immediately without restarting, and your preference is persisted automatically for the next session.
+Type `/cache-lang` in the TUI and select Chinese / English / 日本語 / 한국어 from the dialog. The panel switches immediately without restarting. Your preference is persisted and takes priority over auto-detection on the next launch.
 
 ### 6.2 Environment Variable Override
 
-Set the `CACHE_TUI_LANG` environment variable before launching to force a specific language:
+Set the `CACHE_TUI_LANG` environment variable before launching to force a specific language (`zh` / `en` / `ja` / `ko`):
 
 ```powershell
 # Windows PowerShell

package/dist/_version.d.ts

@@ -1 +1 @@
-export declare const PLUGIN_VERSION = "1.4.0";
+export declare const PLUGIN_VERSION = "1.6.0";

package/dist/_version.js

@@ -1,2 +1,2 @@
 // auto-generated
-export const PLUGIN_VERSION = "1.4.0";
+export const PLUGIN_VERSION = "1.6.0";

package/dist/balance-providers.d.ts

@@ -0,0 +1,27 @@
+/** 归一化后的余额条目——显示层与具体 provider 解耦。 */
+export interface BalanceEntry {
+    currency: string;
+    total: string;
+}
+/** provider 统一错误：message 即错误码（401/403/EMPTY/…），显示层直接展示。 */
+export declare class BalanceError extends Error {
+}
+/** 可插拔的余额 provider 适配器。 */
+export interface BalanceProvider {
+    id: string;
+    name: string;
+    keyPlaceholder?: string;
+    fetchBalance(apiKey: string, signal?: AbortSignal): Promise<BalanceEntry[]>;
+}
+/** 已注册的 provider 列表（按需追加新适配器）。 */
+export declare const balanceProviders: BalanceProvider[];
+/** 按 id 取 provider；未知 id 回退到第一个。 */
+export declare function getBalanceProvider(id: string): BalanceProvider;
+/**
+ * 按 OpenCode providerID 匹配余额 provider。
+ * 先精确匹配，再按前缀匹配（如 moonshotai-cn → moonshot）；未命中返回 undefined。
+ * 比较不区分大小写，容忍 providerID 的大小写变体。
+ */
+export declare function matchBalanceProvider(providerId: string): BalanceProvider | undefined;
+/** key 脱敏：保留头 5 尾 5 字符，中间用 * 填充。 */
+export declare function maskKey(k: string): string;

package/dist/balance-providers.js

@@ -0,0 +1,131 @@
+// ---------------------------------------------------------------------------
+// Balance providers — pluggable account-balance query adapters.
+// ---------------------------------------------------------------------------
+/** provider 统一错误：message 即错误码（401/403/EMPTY/…），显示层直接展示。 */
+export class BalanceError extends Error {
+}
+const siliconflowProvider = {
+    id: "siliconflow",
+    name: "SiliconFlow",
+    keyPlaceholder: "sk-...",
+    async fetchBalance(apiKey, signal) {
+        // 国内站 api.siliconflow.cn（CNY）；国际站为 api.siliconflow.com（USD）
+        const res = await fetch("https://api.siliconflow.cn/v1/user/info", {
+            headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+            signal,
+        });
+        if (!res.ok) {
+            if (res.status === 401)
+                throw new BalanceError("401");
+            if (res.status === 403)
+                throw new BalanceError("403");
+            throw new BalanceError(String(res.status));
+        }
+        const json = await res.json();
+        // totalBalance 为总余额（含充值+赠送），缺失时回退 balance
+        const total = json.data?.totalBalance ?? json.data?.balance;
+        if (typeof total === "undefined" || total === null)
+            throw new BalanceError("EMPTY");
+        return [{ currency: "CNY", total: String(total) }];
+    },
+};
+const deepseekProvider = {
+    id: "deepseek",
+    name: "DeepSeek",
+    keyPlaceholder: "sk-...",
+    async fetchBalance(apiKey, signal) {
+        const res = await fetch("https://api.deepseek.com/user/balance", {
+            headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+            signal,
+        });
+        if (!res.ok) {
+            if (res.status === 401)
+                throw new BalanceError("401");
+            if (res.status === 402 || res.status === 403)
+                throw new BalanceError("403");
+            throw new BalanceError(String(res.status));
+        }
+        const json = await res.json();
+        const infos = json.balance_infos ?? [];
+        if (infos.length === 0)
+            throw new BalanceError("EMPTY");
+        return infos.map((info) => ({
+            currency: info.currency ?? "CNY",
+            total: info.total_balance ?? "0",
+        }));
+    },
+};
+const openrouterProvider = {
+    id: "openrouter",
+    name: "OpenRouter",
+    keyPlaceholder: "sk-or-...",
+    async fetchBalance(apiKey, signal) {
+        // 官方文档标注需 Management key，实测普通 API key 亦可查询账户余额
+        const res = await fetch("https://openrouter.ai/api/v1/credits", {
+            headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+            signal,
+        });
+        if (!res.ok) {
+            if (res.status === 401 || res.status === 403)
+                throw new BalanceError("403");
+            throw new BalanceError(String(res.status));
+        }
+        const json = await res.json();
+        const credits = json.data?.total_credits;
+        const usage = json.data?.total_usage;
+        if (typeof credits !== "number" || typeof usage !== "number")
+            throw new BalanceError("EMPTY");
+        // 剩余额度 = 充值总额 - 已用
+        return [{ currency: "USD", total: (credits - usage).toFixed(2) }];
+    },
+};
+const moonshotProvider = {
+    id: "moonshot",
+    name: "Moonshot",
+    keyPlaceholder: "sk-...",
+    async fetchBalance(apiKey, signal) {
+        // 国内站 api.moonshot.cn（CNY）；国际站 api.moonshot.ai（USD）
+        const res = await fetch("https://api.moonshot.cn/v1/users/me/balance", {
+            headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+            signal,
+        });
+        if (!res.ok) {
+            if (res.status === 401)
+                throw new BalanceError("401");
+            if (res.status === 403)
+                throw new BalanceError("403");
+            throw new BalanceError(String(res.status));
+        }
+        const json = await res.json();
+        const balance = json.data?.available_balance;
+        if (typeof balance === "undefined" || balance === null)
+            throw new BalanceError("EMPTY");
+        return [{ currency: "CNY", total: String(balance) }];
+    },
+};
+/** 已注册的 provider 列表（按需追加新适配器）。 */
+export const balanceProviders = [deepseekProvider, siliconflowProvider, openrouterProvider, moonshotProvider];
+/** 按 id 取 provider；未知 id 回退到第一个。 */
+export function getBalanceProvider(id) {
+    return balanceProviders.find((p) => p.id === id) ?? balanceProviders[0] ?? deepseekProvider;
+}
+/**
+ * 按 OpenCode providerID 匹配余额 provider。
+ * 先精确匹配，再按前缀匹配（如 moonshotai-cn → moonshot）；未命中返回 undefined。
+ * 比较不区分大小写，容忍 providerID 的大小写变体。
+ */
+export function matchBalanceProvider(providerId) {
+    const id = providerId.toLowerCase();
+    const exact = balanceProviders.find((p) => p.id.toLowerCase() === id);
+    if (exact)
+        return exact;
+    return balanceProviders.find((p) => id.startsWith(p.id.toLowerCase()));
+}
+/** key 脱敏：保留头 5 尾 5 字符，中间用 * 填充。 */
+export function maskKey(k) {
+    if (!k)
+        return "";
+    if (k.length <= 10)
+        return k.slice(0, 5) + "*".repeat(Math.max(3, k.length - 5));
+    return k.slice(0, 5) + "*".repeat(Math.max(3, k.length - 10)) + k.slice(-5);
+}

package/dist/i18n.d.ts

@@ -0,0 +1,102 @@
+export type LangCode = "zh" | "en" | "ja" | "ko";
+declare const ZH_T: {
+    readonly title: "缓存统计";
+    readonly hit: "命中率";
+    readonly totalHit: "总命中:";
+    readonly read: "缓存读:";
+    readonly write: "缓存写:";
+    readonly miss: "未命中:";
+    readonly out: "输出:";
+    readonly cost: "费用:";
+    readonly saved: "累计节省:";
+    readonly model: "模型:";
+    readonly provider: "提供商:";
+    readonly rate: "单价:";
+    readonly hitFolded: "命中";
+    readonly inputRate: "输入";
+    readonly cacheRate: "缓存";
+    readonly writeRate: "写入";
+    readonly noData: "等待缓存数据...";
+    readonly tok: "tok";
+    readonly distTitle: "估算 Token 分布";
+    readonly distSys: "系统提示:";
+    readonly distUser: "用户:";
+    readonly distAgent: "Agent 指令:";
+    readonly distTool: "Tool 调用:";
+    readonly distRes: "Tool 结果:";
+    readonly distTotal: "总计:";
+    readonly distOut: "输出:";
+    readonly secDetail: "明细";
+    readonly secModel: "模型";
+    readonly secSkills: "已加载技能";
+    readonly balTotal: "总余额:";
+    readonly balNoKey: "未配置 {p} API Key";
+    readonly balLoading: "查询中...";
+    readonly balError: "查询失败";
+    readonly balErr401: "API Key 无效";
+    readonly balErr403: "余额查询被拒绝";
+    readonly balErrEmpty: "未获取到余额数据";
+    readonly balErrTimeout: "查询超时";
+    readonly balUnsupported: "当前提供商不支持余额查询";
+    readonly barHit: "命中率";
+    readonly barBal: "余额";
+    readonly barTok: "Tokens";
+    readonly secToggle: "切换区块";
+    readonly secBalance: "余额";
+    readonly secBottom: "底部状态栏";
+    readonly secBorder: "面板边框";
+    readonly keySaved: "API Key 已保存，正在查询余额...";
+    readonly keyCleared: "API Key 已清除";
+    readonly currencySet: "币种: {v} ({s}), 汇率: {r}";
+    readonly rateSet: "汇率已设为 {r}";
+    readonly panelConfigTitle: "缓存面板配置";
+    readonly panelConfigMsg: "币种: {c} | 汇率: {r} | 明细: {d} | 模型: {m} | 分布: {t} | 技能: {k} | 余额: {b} | 底部: {f}";
+    readonly borderShown: "面板边框 已显示";
+    readonly borderHidden: "面板边框 已隐藏";
+    readonly sectionShown: "{s} 已显示";
+    readonly sectionHidden: "{s} 已隐藏";
+    readonly langSwitched: "语言已切换为中文";
+    readonly autoSwitchOn: "自动切换余额提供商: 开";
+    readonly autoSwitchOff: "自动切换余额提供商: 关";
+    readonly providerManual: "余额提供商: {p}（自动切换已关闭）";
+    readonly runInSession: "请在会话内运行此命令";
+    readonly backToMain: "已切回主会话";
+    readonly subAgentSwitched: "已切换至子代理: {s}";
+    readonly langTitle: "显示语言";
+    readonly subPrefix: "子代理: ";
+    readonly keyUser: "（用户 key）";
+    readonly keyOpenCode: "（OpenCode）";
+    readonly keyNotSet: "（未配置）";
+    readonly balKeyPrompt: "输入 {p} API Key 以显示账户余额（留空清除）";
+    readonly balProvTitle: "余额提供商 / 自动切换";
+    readonly autoSwitchOpt: "自动切换提供商";
+    readonly balSelectTitle: "选择余额提供商";
+    readonly backToMainTitle: "回到主会话";
+    readonly subSelectTitle: "选择子代理";
+    readonly subSwitchTitle: "切换子代理";
+    readonly subViewTitle: "查看子代理缓存";
+    readonly subNoFound: "未找到子代理，请手动粘贴 Session ID";
+};
+/** 结构约束：值放宽为 string，键集合来自中文表（新增语言缺 key 会编译报错）。 */
+export type Translation = {
+    [K in keyof typeof ZH_T]: string;
+};
+export declare const LANGS: Record<LangCode, Translation>;
+/** 语言元数据：/cache-lang 选项与自动检测共用。 */
+export declare const LANG_META: {
+    code: LangCode;
+    label: string;
+}[];
+/**
+ * 模板参数替换：`{key}` 占位符统一在此处理。
+ * 未提供的参数保留原占位符，避免静默丢失。
+ */
+export declare function applyParams(tpl: string, params?: Record<string, string | number>): string;
+/**
+ * 翻译查找函数工厂：`t("key")` 返回当前语言的文本，`t("key", { p })` 附带模板参数。
+ * `getCode` 读取语言信号——在 SolidJS 渲染/memo 上下文中调用时自动建立响应式依赖。
+ */
+export declare function createT(getCode: () => LangCode): (key: keyof Translation, params?: Record<string, string | number>) => string;
+/** 按系统 locale 自动检测语言（zh → 中文，ja → 日语，ko → 韩语，其余 → 英文）。 */
+export declare function detectLang(): LangCode;
+export {};