feat(usage): NewAPI 订阅额度行 + 修复配置面板错误百分比（v0.8.4）

- NewAPI 用量查询新增 /api/subscription/self：订阅额度占比作为独立一行展示，
  与钱包余额（/api/user/self）分开——两者是互相独立的账本
- 多订阅全部展示；订阅行 unit=% 自动参与预警阈值
- 老版本站点（无订阅接口 404）或无订阅时静默降级，行为与 v0.8.3 一致
- 修复配置面板「测试查询」对金额行错算百分比（曾把钱包余额显示为「已用 29%」）；
  抽出 isMoneyRow/isPlanRow/percentOf 到 usage-display.ts 与卡片共用
- models.dev 快照同步至 2026-10-15（8,876 模型 / 230 供应商）
- 测试：Rust 205（+5）、前端 150（+4），tsc 零错误

CHANGELOG.md

@@ -6,9 +6,18 @@
 
 ---
 
-## Unreleased
+## v0.8.4 (2026-10-15)
 
+用量查询增强：NewAPI 中转站现在同时展示**订阅额度占比**与**钱包余额**两套数据，并修掉配置面板把钱包金额误算成百分比的问题。
+
+- **NewAPI 订阅额度行（新增）**：此前只查询 `/api/user/self`（钱包），订阅套餐的额度完全看不到；现在同时查询 `/api/subscription/self`，把订阅作为独立一行展示（如 `⚡ 订阅 · 41% 已使用 · 16d 后重置`），与钱包行（`💰 余额 500`）分开——两者是互相独立的账本
+- **多个活跃订阅全部展示**：站点返回多个订阅时逐行列出
+- **订阅行参与预警阈值**：订阅是配额占比行，达到阈值时同样高亮提醒
+- **修掉配置面板的错误百分比**：此前对「金额行」也无条件拼 `used/total%`，把钱包余额算成「已用 29%」这类无意义的累计消耗率；现在只有真正的配额行才显示百分比（与卡片口径统一）
+- **老版本 NewAPI 兼容**：站点无 `/api/subscription/self` 接口（404）或无订阅时静默降级，只显示钱包行，行为与之前完全一致
+- models.dev 快照同步至 2026-10-15（8,876 模型 / 230 供应商）
 - **Windows 安装包改为以 NSIS（`.exe`）为主，MSI 不再主动发布**：CI 的 Windows 构建由 `--bundles msi` 改为 `--bundles nsis`，`tauri.conf.json` 默认打包目标同步改为仅 `nsis`；应用内「检查更新」优先下载 NSIS 安装包（无 exe 的历史版本自动回落 `.msi`）。历史版本的 `.msi` 仍可下载，需要 MSI 可本地 `npx tauri build --bundles msi` 自行构建
+- 测试：前端 150 项（新增 4 项）、Rust 205 项（新增 5 项）
 
 ## v0.8.3 (2026-10-15)
 

docs/release-notes/release-notes-v0.8.4.md

@@ -0,0 +1,41 @@
+# KimiSwitch v0.8.4
+
+用量查询增强：NewAPI 中转站现在同时展示**订阅额度占比**与**钱包余额**两套数据，并修掉配置面板把钱包金额误算成百分比的问题。
+
+## NewAPI 订阅额度（新增）
+
+- **订阅与钱包分开展示**：NewAPI 站点有两套互相独立的账本——**钱包余额**（`/api/user/self`）与**订阅套餐额度**（`/api/subscription/self`）。此前只查询前者，订阅额度完全看不到；现在两者各占一行：
+
+  ```
+  ⚡ 订阅 · 41% 已使用   16d 后重置     ← 订阅额度占比（本周期）
+  💰 余额 500                            ← 钱包余额
+  ```
+
+- **多个活跃订阅全部展示**：站点返回多个订阅时逐行列出，不隐藏
+- **订阅行参与预警阈值**：订阅是配额占比行，达到配置面板设定的阈值时会高亮提醒
+- **重置时间**：显示订阅的下一次重置倒计时（如「16d 后重置」）
+
+## 修复
+
+- **配置面板的错误百分比**：此前「测试查询」结果对各行**无条件**拼接 `used/total%`，会把钱包余额算成「已用 29%」这类无意义的累计消耗率（`used_quota / (quota + used_quota)`，没有业务含义）。现在只有真正的配额行才显示百分比，与供应商卡片口径完全一致
+
+## 兼容性
+
+- **老版本 NewAPI 站点无影响**：站点没有 `/api/subscription/self` 接口（404）或账号无订阅时静默降级，只显示钱包行，行为与 v0.8.3 完全一致
+- **不改配置格式**：仅调整用量查询实现与界面渲染，`config.toml`、IPC 契约、`UsageData` 结构均无变化
+
+## 其他
+
+- models.dev 快照同步至 2026-10-15（8,876 模型 / 230 供应商）
+- **Windows 安装包改为以 NSIS（`.exe`）为主，MSI 不再主动发布**：应用内「检查更新」优先下载 NSIS 安装包（无 exe 的历史版本自动回落 `.msi`）；历史版本的 `.msi` 仍可下载
+
+## 测试
+
+- 前端 150 项（新增 4 项：行判定 / 百分比计算 / 订阅标签）
+- Rust 205 项（新增 5 项：订阅解析、多订阅、空订阅、零额度不除零、超额钳制）
+- 已用真实 NewAPI 站点实测：订阅占比与站点网页控制台、API 原始数据三方一致
+
+## 下载
+
+- **Windows**：`.exe`（NSIS 安装包）
+- **macOS / Linux**：见 [Releases](https://github.com/billowliu2/KimiSwitch/releases)（由 CI 构建）

package.json

@@ -1,7 +1,7 @@
 {
   "name": "kimiswitch",
   "private": true,
-  "version": "0.8.3",
+  "version": "0.8.4",
   "type": "module",
   "scripts": {
     "dev": "vite",

src-tauri/Cargo.lock

@@ -1978,7 +1978,7 @@ dependencies = [
 
 [[package]]
 name = "kimiswitch"
-version = "0.8.3"
+version = "0.8.4"
 dependencies = [
  "anyhow",
  "chrono",

src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "kimiswitch"
-version = "0.8.3"
+version = "0.8.4"
 description = "Kimi Switch - model config manager"
 authors = ["codingplan.site"]
 edition = "2021"

src-tauri/src/services/balance.rs

@@ -14,6 +14,7 @@
 //! HTTP 调用与 JSON→UsageData 解析拆成纯函数，便于无 mock 单元测试。
 
 use super::usage_types::{UsageData, UsageResult};
+use super::coding_plan;
 use std::time::Duration;
 
 pub(crate) const REQUEST_TIMEOUT: Duration = Duration::from_secs(8);
@@ -467,11 +468,95 @@ pub async fn query_newapi(
 
     let (quota_per_unit, symbol) = fetch_newapi_status(base_url, timeout).await;
     Ok(match parse_newapi(&body, quota_per_unit, &symbol) {
-        Ok(data) => UsageResult::ok(data),
+        Ok(wallet) => {
+            // 订阅额度是决策主信息（钱包余额独立于它），前置到钱包行之前；
+            // compact 卡片只取 data[0]，所以顺序决定了卡片主摘要显示什么。
+            let subs = fetch_newapi_subscriptions(&client, base, access_token, user_id, quota_per_unit).await;
+            let mut data = subs;
+            data.extend(wallet);
+            UsageResult::ok(data)
+        }
         Err(err) => err,
     })
 }
 
+/// 拉取用户的订阅套餐额度（NewAPI `GET /api/subscription/self`）。这是 NewAPI
+/// 较新的特性：站点无此接口（404）、无订阅、网络失败或解析失败一律返回空
+/// Vec——订阅是钱包余额之外的附加信息，任何失败都不能拖垮整个用量查询。
+///
+/// 与 `/api/user/self` 同源同凭据（Bearer access token + New-Api-User）。
+async fn fetch_newapi_subscriptions(
+    client: &reqwest::Client,
+    base: &str,
+    access_token: &str,
+    user_id: &str,
+    quota_per_unit: f64,
+) -> Vec<UsageData> {
+    let url = format!("{base}/api/subscription/self");
+    let Ok(resp) = client
+        .get(&url)
+        .header("Accept", "application/json")
+        .header("Authorization", format!("Bearer {access_token}"))
+        .header("New-Api-User", user_id)
+        .send()
+        .await
+    else {
+        return Vec::new();
+    };
+    if !resp.status().is_success() {
+        return Vec::new();
+    }
+    let Ok(raw) = resp.bytes().await else {
+        return Vec::new();
+    };
+    let Ok(body) = serde_json::from_slice::<serde_json::Value>(&raw) else {
+        return Vec::new();
+    };
+    parse_newapi_subscriptions(&body, quota_per_unit)
+}
+
+/// 解析订阅自查响应。每项形如 `{ subscription: { amount_total, amount_used,
+/// next_reset_time, ... } }`；金额是 int64 原始配额单位，需除以站点
+/// `quota_per_unit` 才是钱数。产出百分比行（`unit="%"`，与 plan tier 同形态，
+/// 因此自动参与预警阈值判定）。
+///
+/// `amount_total` 为 0（站点未设额度）时百分比记为 0，不做除法。
+fn parse_newapi_subscriptions(body: &serde_json::Value, quota_per_unit: f64) -> Vec<UsageData> {
+    let Some(subs) = body
+        .get("data")
+        .and_then(|d| d.get("subscriptions"))
+        .and_then(|s| s.as_array())
+    else {
+        return Vec::new();
+    };
+
+    let mut out = Vec::new();
+    for entry in subs {
+        // SubscriptionSummary 把实际字段包在 `subscription` 里；兼容站点直接
+        // 平铺字段的情况（取 entry 本身作回退）。
+        let sub = entry.get("subscription").unwrap_or(entry);
+        let total_raw = parse_f64_field(sub, "amount_total").unwrap_or(0.0);
+        let used_raw = parse_f64_field(sub, "amount_used").unwrap_or(0.0);
+        let total = total_raw / quota_per_unit;
+        let used = used_raw / quota_per_unit;
+        let percent = if total > 0.0 {
+            (used / total * 100.0).clamp(0.0, 100.0)
+        } else {
+            0.0
+        };
+        out.push(UsageData {
+            plan_name: Some("subscription".to_string()),
+            remaining: Some((100.0 - percent).max(0.0)),
+            total: Some(100.0),
+            used: Some(percent),
+            unit: Some("%".to_string()),
+            is_valid: Some(percent < 100.0),
+            resets_at: sub.get("next_reset_time").and_then(coding_plan::extract_reset_time),
+        });
+    }
+    out
+}
+
 fn parse_newapi(
     body: &serde_json::Value,
     quota_per_unit: f64,
@@ -842,6 +927,91 @@ mod tests {
         assert_eq!(data[0].used, Some(0.2));
     }
 
+    #[test]
+    fn newapi_subscription_maps_to_percent_row() {
+        // 用户实测站点的数值：总额度 $500、已用 $206.17 → 41.234% 已用
+        // （amount_* 是 int64 原始配额，quota_per_unit=500000 换算成钱）。
+        let body = json!({
+            "success": true,
+            "data": {
+                "subscriptions": [{
+                    "subscription": {
+                        "id": 9,
+                        "amount_total": 250_000_000,
+                        "amount_used": 103_085_000,
+                        "next_reset_time": 1_793_491_200,
+                        "end_time": 2_106_105_600,
+                        "status": "active"
+                    }
+                }],
+                "all_subscriptions": []
+            }
+        });
+        let data = parse_newapi_subscriptions(&body, 500_000.0);
+        assert_eq!(data.len(), 1);
+        assert_eq!(data[0].plan_name.as_deref(), Some("subscription"));
+        assert_eq!(data[0].unit.as_deref(), Some("%"));
+        assert_eq!(data[0].total, Some(100.0));
+        // 41.234% 已用 → 剩余 58.766
+        assert!((data[0].used.unwrap() - 41.234).abs() < 0.01);
+        assert!((data[0].remaining.unwrap() - 58.766).abs() < 0.01);
+        assert_eq!(data[0].is_valid, Some(true));
+        assert!(data[0].resets_at.is_some(), "next_reset_time must map to ISO");
+    }
+
+    #[test]
+    fn newapi_subscription_multiple_all_returned() {
+        let body = json!({
+            "success": true,
+            "data": {
+                "subscriptions": [
+                    { "subscription": { "amount_total": 100_000_000, "amount_used": 90_000_000 } },
+                    { "subscription": { "amount_total": 200_000_000, "amount_used": 20_000_000 } }
+                ]
+            }
+        });
+        let data = parse_newapi_subscriptions(&body, 500_000.0);
+        assert_eq!(data.len(), 2);
+        assert!((data[0].used.unwrap() - 90.0).abs() < 0.01);
+        assert!((data[1].used.unwrap() - 10.0).abs() < 0.01);
+    }
+
+    #[test]
+    fn newapi_subscription_empty_or_missing_yields_nothing() {
+        // 站点无订阅 → 空数组
+        let empty = json!({ "success": true, "data": { "subscriptions": [] } });
+        assert!(parse_newapi_subscriptions(&empty, 500_000.0).is_empty());
+        // 老版本无此接口/字段缺失 → 也必须是空，不 panic
+        let no_field = json!({ "success": true, "data": {} });
+        assert!(parse_newapi_subscriptions(&no_field, 500_000.0).is_empty());
+    }
+
+    #[test]
+    fn newapi_subscription_zero_total_does_not_divide_by_zero() {
+        let body = json!({
+            "success": true,
+            "data": { "subscriptions": [{ "subscription": { "amount_total": 0, "amount_used": 0 } }] }
+        });
+        let data = parse_newapi_subscriptions(&body, 500_000.0);
+        assert_eq!(data.len(), 1);
+        assert_eq!(data[0].used, Some(0.0));
+        assert_eq!(data[0].remaining, Some(100.0));
+        assert_eq!(data[0].is_valid, Some(true));
+    }
+
+    #[test]
+    fn newapi_subscription_used_over_total_is_clamped() {
+        // 防御：站点数据异常（已用 > 总额）时百分比钳到 100，不出现负数剩余。
+        let body = json!({
+            "success": true,
+            "data": { "subscriptions": [{ "subscription": { "amount_total": 100, "amount_used": 300 } }] }
+        });
+        let data = parse_newapi_subscriptions(&body, 1.0);
+        assert_eq!(data[0].used, Some(100.0));
+        assert_eq!(data[0].remaining, Some(0.0));
+        assert_eq!(data[0].is_valid, Some(false));
+    }
+
     #[test]
     fn sub2api_site_root_strips_v1_and_slash() {
         assert_eq!(sub2api_site_root("https://x.com"), "https://x.com");

src-tauri/src/services/coding_plan.rs

@@ -53,7 +53,7 @@ fn millis_to_iso8601(ms: i64) -> Option<String> {
 /// 从 JSON 值提取重置时间，兼容字符串和数字格式：
 /// - 字符串：直接返回（视为 ISO 8601）
 /// - 数字：自动判断秒/毫秒并转为 ISO 8601；0/负值视为无重置时间
-fn extract_reset_time(value: &serde_json::Value) -> Option<String> {
+pub(crate) fn extract_reset_time(value: &serde_json::Value) -> Option<String> {
     if let Some(s) = value.as_str() {
         return Some(s.to_string());
     }

src-tauri/tauri.conf.json

@@ -1,6 +1,6 @@
 {
   "productName": "Kimi Switch",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "identifier": "com.kimiswitch.app",
   "build": {
     "beforeDevCommand": "npm run dev",

src/components/UsageConfigModal.tsx

@@ -4,7 +4,7 @@ import { invoke } from "@tauri-apps/api/core";
 import { ArrowLeft, Eye, EyeOff, Loader2, Play } from "lucide-react";
 import { useTranslation } from "../i18n";
 import type { TranslationKey } from "../i18n/zh";
-import { formatAmount, localizeUsageError, planLabel } from "../lib/usage-display";
+import { formatAmount, isPlanRow, localizeUsageError, percentOf, planLabel } from "../lib/usage-display";
 import type { Agent, Provider, UsageConfig } from "../types";
 
 interface UsageResult {
@@ -131,13 +131,18 @@ export function UsageConfigModal({ open, agent, provider, onClose, onSave }: Usa
       });
       if (result.success) {
         setTestOk(true);
+        // 与卡片 UsageFooter 同一套行判定：金额行（NewAPI 钱包 / 加力钱包）只显示
+        // 金额——其 used/total 是钱数，算成「百分比」是误导（曾把钱包余额误显示为
+        // 「已用 29%」）。只有真正的配额行才追加百分比。
         const summary = (result.data ?? [])
           .map((d) => {
             const parts: string[] = [];
             if (d.planName) parts.push(planLabel(d.planName, t));
             if (d.remaining != null) parts.push(`${t("usageRemaining")} ${formatAmount(d.remaining, d.unit)}`);
-            if (d.used != null && d.total != null && d.total > 0)
-              parts.push(`${Math.round((d.used / d.total) * 100)}%`);
+            if (isPlanRow(d)) {
+              const pct = percentOf(d);
+              if (pct != null) parts.push(`${Math.round(pct)}%`);
+            }
             return parts.join(" ");
           })
           .filter(Boolean)

src/components/UsageFooter.tsx

@@ -2,13 +2,14 @@ import { useEffect, useState } from "react";
 import { Loader2, RefreshCw } from "lucide-react";
 import { useTranslation } from "../i18n";
 import {
-  BOOSTER_WALLET_PLAN,
   formatAmount,
+  isPlanRow,
   localizeUsageError,
+  percentOf,
   planLabel,
 } from "../lib/usage-display";
 import { isAlertTier } from "../hooks/useUsageQuery";
-import type { UsageData, UsageQueryState } from "../hooks/useUsageQuery";
+import type { UsageQueryState } from "../hooks/useUsageQuery";
 
 interface UsageFooterProps {
   /** Query state lifted to the provider card via useUsageQuery. Both the
@@ -21,18 +22,15 @@ interface UsageFooterProps {
 }
 
 /**
- * 金额行 vs 配额行：NewAPI 与 Kimi 加力钱包（booster_wallet）只报金额，其
- * used/total 是钱数而不是配额比例，必须走 formatAmount 渲染路径。判定只能看
+ * 金额行 vs 配额行：NewAPI 的钱包行与 Kimi 加力钱包（booster_wallet）只报金额，
+ * 其 used/total 是钱数而不是配额比例，必须走 formatAmount 渲染路径。判定只能看
  * planName —— sub2api 的 USD 行 unit 同样不是 "%"，但语义仍是「额度用了百分之
  * 多少」，按 unit 判定会把它误渲染成余额。
+ *
+ * NewAPI 站点可同时返回钱包行（planName "NewAPI"，金额）与订阅行
+ * （planName "subscription"，`unit="%"` 的配额占比）；后者不属于金额行，走
+ * 百分比渲染路径。判定逻辑与 usage-display.ts 共用，避免与配置面板再次分叉。
  */
-function isMoneyRow(d: UsageData): boolean {
-  return d.planName === "NewAPI" || d.planName === BOOSTER_WALLET_PLAN;
-}
-
-function isPlanRow(d: UsageData): boolean {
-  return !!d.planName && !isMoneyRow(d) && (d.total != null || d.used != null);
-}
 
 export function UsageFooter({ usage, variant = "detail" }: UsageFooterProps) {
   const { t } = useTranslation();
@@ -48,14 +46,6 @@ export function UsageFooter({ usage, variant = "detail" }: UsageFooterProps) {
 
   if (!supported || status === "idle") return null;
 
-  const percentOf = (d: UsageData): number | null => {
-    if (d.used != null && d.total != null && d.total > 0)
-      return (d.used / d.total) * 100;
-    if (d.remaining != null && d.total != null && d.total > 0)
-      return (1 - d.remaining / d.total) * 100;
-    return null;
-  };
-
   const formatReset = (resetsAt?: string | null): string | null => {
     if (!resetsAt) return null;
     const ms = new Date(resetsAt).getTime() - now;

src/i18n/en.ts

@@ -514,6 +514,7 @@ export const enTranslations: Record<TranslationKey, string> = {
   usageTierMonthly: "Monthly",
   usageTierMonthCode: "Monthly (code)",
   usageTierBoosterWallet: "Booster",
+  usageTierSubscription: "Subscription",
   usageThreshold: "Alert threshold",
   usageThresholdHint: "Highlight any window that reaches this percentage; 0 = off",
   usageThresholdAlert: "Threshold reached",

src/i18n/zh.ts

@@ -503,6 +503,7 @@ export const zhTranslations = {
   usageTierMonthly: "30天",
   usageTierMonthCode: "30天（代码）",
   usageTierBoosterWallet: "加力钱包",
+  usageTierSubscription: "订阅",
   usageThreshold: "预警阈值",
   usageThresholdHint: "任一用量窗口达到该百分比时高亮提醒，0 为关闭",
   usageThresholdAlert: "已达预警阈值",

src/lib/usage-display.test.ts

@@ -1,5 +1,12 @@
 import { describe, expect, it } from "vitest";
-import { formatAmount, localizeUsageError, planLabel } from "./usage-display";
+import {
+  formatAmount,
+  isMoneyRow,
+  isPlanRow,
+  localizeUsageError,
+  percentOf,
+  planLabel,
+} from "./usage-display";
 
 // Minimal TranslateFn: return the key itself so assertions read the key.
 const t = (key: string) => key;
@@ -60,11 +67,51 @@ describe("planLabel", () => {
     expect(planLabel("weekly_limit", t)).toBe("usageTierWeekly");
     expect(planLabel("monthly_limit", t)).toBe("usageTierMonthly");
     expect(planLabel("booster_wallet", t)).toBe("usageTierBoosterWallet");
+    expect(planLabel("subscription", t)).toBe("usageTierSubscription");
     expect(planLabel("NewAPI", t)).toBe("NewAPI");
     expect(planLabel("¥", t)).toBe("¥");
   });
 });
 
+describe("isMoneyRow / isPlanRow", () => {
+  it("treats the NewAPI wallet and booster wallet as money rows", () => {
+    // NewAPI 钱包行只报金额，其 used/total 是钱数，不能当百分比渲染。
+    expect(isMoneyRow({ planName: "NewAPI" })).toBe(true);
+    expect(isMoneyRow({ planName: "booster_wallet" })).toBe(true);
+    expect(isMoneyRow({ planName: "subscription" })).toBe(false);
+    expect(isMoneyRow({ planName: "weekly_limit" })).toBe(false);
+  });
+
+  it("classifies quota rows by planName, not unit", () => {
+    // NewAPI 订阅行：unit="%" → 配额行
+    expect(
+      isPlanRow({ planName: "subscription", total: 100, used: 41 })
+    ).toBe(true);
+    // sub2api 订阅窗口：unit 是 USD，但语义仍是配额占比 → 仍算配额行
+    expect(
+      isPlanRow({ planName: "weekly_limit", total: 50, used: 10 })
+    ).toBe(true);
+    // 钱包行永远不是配额行，即使带了 total/used
+    expect(isPlanRow({ planName: "NewAPI", total: 704, used: 204 })).toBe(false);
+    // 无 planName 或无数值 → 非配额行
+    expect(isPlanRow({ planName: null, total: 100, used: 1 })).toBe(false);
+    expect(isPlanRow({ planName: "x" })).toBe(false);
+  });
+});
+
+describe("percentOf", () => {
+  it("prefers used/total and falls back to remaining/total", () => {
+    expect(percentOf({ used: 41, total: 100 })).toBe(41);
+    expect(percentOf({ remaining: 59, total: 100 })).toBe(41);
+  });
+
+  it("returns null when total is missing or non-positive", () => {
+    expect(percentOf({ used: 41 })).toBeNull();
+    expect(percentOf({ used: 41, total: 0 })).toBeNull();
+    expect(percentOf({})).toBeNull();
+  });
+});
+
 describe("formatAmount", () => {
   it("maps CNY and USD to ¥/$ with two decimals", () => {
     expect(formatAmount(1.5, "CNY")).toBe("¥1.50");

src/lib/usage-display.ts

@@ -12,6 +12,44 @@ type TranslateFn = (
  */
 export const BOOSTER_WALLET_PLAN = "booster_wallet";
 
+/**
+ * 金额行 vs 配额行：NewAPI 的钱包行与 Kimi 加力钱包（booster_wallet）只报金额，
+ * 其 used/total 是钱数而不是配额比例，必须走 formatAmount 渲染路径。
+ *
+ * 注意 NewAPI 站点同时有钱包与订阅两套账：钱包行的 planName 是 "NewAPI"（金额），
+ * 订阅行是 "subscription"（`unit="%"` 的配额占比），后者不在此列表内，正常走
+ * 百分比渲染。判定只能看 planName —— sub2api 的 USD 行 unit 同样不是 "%"，但语义
+ * 仍是「额度用了百分之多少」，按 unit 判定会把它误渲染成余额。
+ */
+export function isMoneyRow(d: { planName?: string | null }): boolean {
+  return d.planName === "NewAPI" || d.planName === BOOSTER_WALLET_PLAN;
+}
+
+/** 额度/配额行：有 planName、非金额行，且报了 total 或 used。 */
+export function isPlanRow(d: {
+  planName?: string | null;
+  total?: number | null;
+  used?: number | null;
+}): boolean {
+  return !!d.planName && !isMoneyRow(d) && (d.total != null || d.used != null);
+}
+
+/**
+ * 配额行的「已用百分比」。优先 used/total，其次由 remaining/total 反推；
+ * total 缺失或 ≤0（无法算比例）返回 null。金额行不应调用此函数。
+ */
+export function percentOf(d: {
+  used?: number | null;
+  total?: number | null;
+  remaining?: number | null;
+}): number | null {
+  if (d.used != null && d.total != null && d.total > 0)
+    return (d.used / d.total) * 100;
+  if (d.remaining != null && d.total != null && d.total > 0)
+    return (1 - d.remaining / d.total) * 100;
+  return null;
+}
+
 /**
  * Map a raw Rust plan/tier name to a localized label. Unknown names (proper
  * nouns like "OpenRouter", "NewAPI", currency codes) pass through unchanged.
@@ -19,9 +57,10 @@ export const BOOSTER_WALLET_PLAN = "booster_wallet";
  * Coverage note: ALL plan-type (套餐) queries flow through
  * src-tauri/src/services/coding_plan.rs::percent_tier, whose names come only
  * from TIER_FIVE_HOUR / TIER_WEEKLY_LIMIT / TIER_MONTHLY_LIMIT /
- * TIER_MONTH_CODE — so this mapping covers every current and future plan
- * provider automatically. If a new tier id is ever added there, add a case
- * here too.
+ * TIER_MONTH_CODE — so the fixed tiers are covered here. The other cases come
+ * from src-tauri/src/services/balance.rs: `booster_wallet` (Kimi 加力钱包) and
+ * `subscription` (NewAPI 订阅套餐额度行). If a new tier id is added anywhere,
+ * add a case here too.
  */
 export function planLabel(name: string, t: TranslateFn): string {
   switch (name) {
@@ -37,6 +76,8 @@ export function planLabel(name: string, t: TranslateFn): string {
       return t("usageTierMonthCode");
     case BOOSTER_WALLET_PLAN:
       return t("usageTierBoosterWallet");
+    case "subscription":
+      return t("usageTierSubscription");
     default:
       return name;
   }