fix(i18n): localize provider usage details in Simplified Chinese (#3084)

Co-authored-by: Peter Steinberger <steipete@gmail.com>

Author: haixing23

Sources/CodexBar/MenuCardView+ModelHelpers.swift

@@ -194,6 +194,9 @@ extension UsageMenuCardView.Model {
             presentation.resetText = regen.resetText
             Self.apply(regen.pace, to: &presentation)
         }
+        if input.provider == .deepseek, let detail = presentation.detailText {
+            presentation.detailText = Self.localizedDeepSeekBalanceDescription(detail)
+        }
         if policy.movesPrimaryDetailToStatus(snapshot: input.snapshot) {
             presentation.statusText = presentation.detailText
             presentation.detailText = nil

Sources/CodexBar/MenuCardView+ProviderDetailLocalization.swift

@@ -0,0 +1,94 @@
+import CodexBarCore
+import Foundation
+
+extension UsageMenuCardView.Model {
+    static func localizedProviderDetails(
+        _ details: [ProviderDetailSection],
+        provider: UsageProvider) -> [ProviderDetailSection]
+    {
+        details.compactMap { section in
+            let rows = section.rows.compactMap { row in
+                try? ProviderDetailSection.Row(
+                    label: L(row.label),
+                    value: self.localizedProviderDetailValue(row.value, provider: provider),
+                    secondaryValue: row.secondaryValue.map {
+                        self.localizedProviderDetailValue($0, provider: provider)
+                    })
+            }
+            let chart = section.chart.flatMap { chart in
+                try? ProviderDetailSection.Chart(
+                    kind: chart.kind,
+                    title: chart.title.map(L),
+                    unit: chart.unit.map(L),
+                    points: chart.points)
+            }
+            return try? ProviderDetailSection(
+                title: section.title.map(L),
+                rows: rows,
+                chart: chart)
+        }
+    }
+
+    static func localizedDeepSeekBalanceDescription(_ description: String) -> String {
+        let paidSeparator = " (Paid: "
+        let grantedSeparator = " / Granted: "
+        guard let paidRange = description.range(of: paidSeparator),
+              let grantedRange = description.range(
+                  of: grantedSeparator,
+                  range: paidRange.upperBound..<description.endIndex),
+              description.last == ")"
+        else {
+            return description
+        }
+
+        let total = String(description[..<paidRange.lowerBound])
+        let paid = String(description[paidRange.upperBound..<grantedRange.lowerBound])
+        let granted = String(description[grantedRange.upperBound..<description.index(before: description.endIndex)])
+        return L("%@ (Paid: %@ / Granted: %@)", total, paid, granted)
+    }
+
+    static func localizedZaiPeriodicResetText(_ window: RateWindow) -> String? {
+        guard window.resetsAt == nil,
+              window.resetDescription?.trimmingCharacters(in: .whitespacesAndNewlines) == "5-hour"
+        else {
+            return nil
+        }
+        return L("Resets every 5 hours")
+    }
+
+    private static func localizedProviderDetailValue(_ value: String, provider: UsageProvider) -> String {
+        switch provider {
+        case .deepseek:
+            self.localizedTokenSuffix(value)
+        case .zai:
+            self.localizedZaiValue(value)
+        default:
+            value
+        }
+    }
+
+    private static func localizedTokenSuffix(_ value: String) -> String {
+        let suffix = " tokens"
+        guard value.hasSuffix(suffix) else { return value }
+        return L("%@ tokens", String(value.dropLast(suffix.count)))
+    }
+
+    private static func localizedZaiValue(_ value: String) -> String {
+        let usedSuffix = " used"
+        if value.hasSuffix(usedSuffix) {
+            return L("%@ used", String(value.dropLast(usedSuffix.count)))
+        }
+
+        let limitSeparator = " limit · "
+        let remainingSuffix = " remaining"
+        guard let limitRange = value.range(of: limitSeparator),
+              value.hasSuffix(remainingSuffix)
+        else {
+            return value
+        }
+        let limit = String(value[..<limitRange.lowerBound])
+        let remainingEnd = value.index(value.endIndex, offsetBy: -remainingSuffix.count)
+        let remaining = String(value[limitRange.upperBound..<remainingEnd])
+        return L("%@ limit · %@ remaining", limit, remaining)
+    }
+}

Sources/CodexBar/MenuCardView.swift

@@ -1059,6 +1059,7 @@ extension UsageMenuCardView.Model {
         if input.provider == .sub2api {
             details = Self.sub2APILocalizedDetails(details)
         }
+        details = Self.localizedProviderDetails(details, provider: input.provider)
         guard input.hidePersonalInfo else { return details }
         return details.compactMap { section in
             let rows = section.rows.compactMap { row in
@@ -1397,6 +1398,9 @@ extension UsageMenuCardView.Model {
             Self.applyPrimaryPacePresentation(&presentation, input: input, primary: primary)
         }
         Self.applyPrimaryFinalOverrides(&presentation, input: input, primary: primary)
+        if input.provider == .zai, let resetText = Self.localizedZaiPeriodicResetText(primary) {
+            presentation.resetText = resetText
+        }
         if let bindingProjection {
             let resetWindow = RateWindow(
                 usedPercent: bindingProjection.usedPercent,

Sources/CodexBar/Resources/zh-Hans.lproj/Localizable.strings

@@ -1500,3 +1500,20 @@
 "menu_bar_layout_conditional_default_session_spent" = "会话即将用尽";
 "menu_bar_layout_conditional_default_either_high" = "会话或每周用量偏高";
 "menu_bar_layout_conditional_default_scoped_weekly" = "模型专属每周已用超过 60%";
+
+/* Provider usage details */
+"Detailed usage" = "用量明细";
+"Cache-hit input" = "缓存命中输入";
+"Cache-miss input" = "缓存未命中输入";
+"Daily tokens" = "每日 token";
+"Quota details" = "配额详情";
+"Token quota" = "Token 配额";
+"Credit quota" = "额度配额";
+"Session token quota" = "会话 Token 配额";
+"Session credit quota" = "会话额度配额";
+"MCP quota" = "MCP 配额";
+"Hourly tokens" = "每小时 token";
+"%@ used" = "已使用 %@";
+"%@ limit · %@ remaining" = "上限 %@ · 剩余 %@";
+"%@ (Paid: %@ / Granted: %@)" = "%@（付费：%@ / 赠送：%@）";
+"Resets every 5 hours" = "每 5 小时重置";

Tests/CodexBarTests/MenuCardDeepSeekTests.swift

@@ -152,6 +152,84 @@ struct MenuCardDeepSeekTests {
         #expect(details.rows.first { $0.label == "This month" }?.value == "¥0.0456 · 456 tokens")
     }
 
+    @Test
+    func `model localizes deepseek usage details in simplified chinese`() throws {
+        let now = Date()
+        let metadata = try #require(ProviderDefaults.metadata[.deepseek])
+        let snapshot = Self.makeSnapshot(now: now, usageSummary: Self.sampleDeepSeekSummary(now: now))
+
+        let model = CodexBarLocalizationOverride.$appLanguage.withValue("zh-Hans") {
+            UsageMenuCardView.Model.make(.init(
+                provider: .deepseek,
+                metadata: metadata,
+                snapshot: snapshot,
+                credits: nil,
+                creditsError: nil,
+                dashboard: nil,
+                dashboardError: nil,
+                tokenSnapshot: nil,
+                tokenError: nil,
+                account: AccountInfo(email: nil, plan: nil),
+                isRefreshing: false,
+                lastError: nil,
+                usageBarsShowUsed: false,
+                resetTimeDisplayStyle: .countdown,
+                tokenCostUsageEnabled: true,
+                showOptionalCreditsAndExtraUsage: true,
+                hidePersonalInfo: false,
+                now: now))
+        }
+
+        let details = try #require(model.providerDetails.first)
+        #expect(details.title == "用量明细")
+        #expect(details.rows.map(\.label) == [
+            "今日",
+            "本月",
+            "请求",
+            "最常用模型",
+            "缓存命中输入",
+            "缓存未命中输入",
+            "输出",
+        ])
+        #expect(details.rows[0].value == "¥0.0123 · 123 token 用量")
+        #expect(details.rows[1].value == "¥0.0456 · 456 token 用量")
+        #expect(details.rows[3].value == "deepseek-chat")
+        #expect(details.chart?.title == "每日 token")
+        #expect(details.chart?.unit == "token")
+    }
+
+    @Test
+    func `model localizes deepseek balance components in simplified chinese`() throws {
+        let now = Date()
+        let metadata = try #require(ProviderDefaults.metadata[.deepseek])
+        let snapshot = Self.makeSnapshot(now: now)
+
+        let model = CodexBarLocalizationOverride.$appLanguage.withValue("zh-Hans") {
+            UsageMenuCardView.Model.make(.init(
+                provider: .deepseek,
+                metadata: metadata,
+                snapshot: snapshot,
+                credits: nil,
+                creditsError: nil,
+                dashboard: nil,
+                dashboardError: nil,
+                tokenSnapshot: nil,
+                tokenError: nil,
+                account: AccountInfo(email: nil, plan: nil),
+                isRefreshing: false,
+                lastError: nil,
+                usageBarsShowUsed: false,
+                resetTimeDisplayStyle: .countdown,
+                tokenCostUsageEnabled: false,
+                showOptionalCreditsAndExtraUsage: true,
+                hidePersonalInfo: false,
+                now: now))
+        }
+
+        let balance = try #require(model.metrics.first)
+        #expect(balance.statusText == "$9.32（付费：$9.32 / 赠送：$0.00）")
+    }
+
     @Test
     func `model explains unavailable deepseek usage when cost summary is enabled`() throws {
         let now = Date()

Tests/CodexBarTests/UserFacingLocalizationCoverageTests.swift

@@ -1,3 +1,4 @@
+import CodexBarCore
 import Foundation
 import Testing
 @testable import CodexBar
@@ -117,6 +118,35 @@ struct UserFacingLocalizationCoverageTests {
             "Raw user-facing localization markers remain:\n\(violations.joined(separator: "\n"))")
     }
 
+    @Test
+    func `provider detail localization preserves technical identifiers`() throws {
+        let details = try [
+            ProviderDetailSection(
+                title: "Usage",
+                rows: [
+                    .init(label: "Balance", value: "$12.34"),
+                    .init(label: "Top model", value: "deepseek-v4-flash"),
+                ],
+                chart: .init(
+                    kind: .bars,
+                    title: "Usage",
+                    unit: "tokens",
+                    points: [.init(label: "2026-08-20", value: 42)])),
+        ]
+
+        let localized = CodexBarLocalizationOverride.$appLanguage.withValue("zh-Hans") {
+            UsageMenuCardView.Model.localizedProviderDetails(details, provider: .groq)
+        }
+
+        let section = try #require(localized.first)
+        #expect(section.title == "用量")
+        #expect(section.rows.map(\.label) == ["余额", "最常用模型"])
+        #expect(section.rows.map(\.value) == ["$12.34", "deepseek-v4-flash"])
+        #expect(section.chart?.title == "用量")
+        #expect(section.chart?.unit == "token")
+        #expect(section.chart?.points.first?.label == "2026-08-20")
+    }
+
     @Test
     func `spend dashboard model breakdown state stays precise and localized`() throws {
         let root = URL(fileURLWithPath: #filePath)

Tests/CodexBarTests/ZaiMenuCardTests.swift

@@ -78,6 +78,83 @@ struct ZaiMenuCardTests {
         #expect(mcp.secondaryValue == "100 limit · 50 remaining")
     }
 
+    @MainActor
+    @Test
+    func `model localizes zai usage sections in simplified chinese`() throws {
+        let model = try CodexBarLocalizationOverride.$appLanguage.withValue("zh-Hans") {
+            try Self.costSummaryModel(style: .inlineSummary)
+        }
+
+        #expect(model.providerDetails.map(\.title) == ["配额详情", "每小时 token", "每日 token"])
+        #expect(model.providerDetails[0].rows[0].label == "Token 配额")
+        #expect(model.providerDetails[0].rows[0].value == "已使用 3%")
+        #expect(model.providerDetails[1].rows[0].label == "GLM-5.3")
+        #expect(model.providerDetails[1].chart?.title == "每小时 token")
+        #expect(model.providerDetails[1].chart?.unit == "token")
+    }
+
+    @Test
+    func `model localizes zai quota values and periodic reset in simplified chinese`() throws {
+        let now = Date()
+        let details = try ProviderDetailSection(title: "Quota details", rows: [
+            .init(label: "Token quota", value: "45% used"),
+            .init(label: "Session token quota", value: "0% used"),
+            .init(label: "MCP quota", value: "6.4% used", secondaryValue: "1000 limit · 936 remaining"),
+            .init(label: "search-prime", value: "64"),
+        ])
+        let snapshot = UsageSnapshot(
+            primary: RateWindow(usedPercent: 0, windowMinutes: 300, resetsAt: nil, resetDescription: "5-hour"),
+            secondary: RateWindow(
+                usedPercent: 45,
+                windowMinutes: 10080,
+                resetsAt: now.addingTimeInterval(3 * 24 * 60 * 60),
+                resetDescription: nil),
+            extraRateWindows: [NamedRateWindow(
+                id: "zai-mcp",
+                title: "MCP",
+                window: RateWindow(usedPercent: 6.4, windowMinutes: nil, resetsAt: nil, resetDescription: "MCP"))],
+            details: [details],
+            updatedAt: now,
+            identity: ProviderIdentitySnapshot(
+                providerID: .zai,
+                accountEmail: nil,
+                accountOrganization: nil,
+                loginMethod: "Pro"))
+        let metadata = try #require(ProviderDefaults.metadata[.zai])
+
+        let model = CodexBarLocalizationOverride.$appLanguage.withValue("zh-Hans") {
+            UsageMenuCardView.Model.make(.init(
+                provider: .zai,
+                metadata: metadata,
+                snapshot: snapshot,
+                credits: nil,
+                creditsError: nil,
+                dashboard: nil,
+                dashboardError: nil,
+                tokenSnapshot: nil,
+                tokenError: nil,
+                account: AccountInfo(email: nil, plan: nil),
+                isRefreshing: false,
+                lastError: nil,
+                usageBarsShowUsed: false,
+                resetTimeDisplayStyle: .countdown,
+                tokenCostUsageEnabled: false,
+                showOptionalCreditsAndExtraUsage: true,
+                hidePersonalInfo: false,
+                now: now))
+        }
+
+        #expect(model.metrics.first?.resetText == "每 5 小时重置")
+        let rows = try #require(model.providerDetails.first?.rows)
+        #expect(rows[0].value == "已使用 45%")
+        #expect(rows[1].label == "会话 Token 配额")
+        #expect(rows[1].value == "已使用 0%")
+        #expect(rows[2].label == "MCP 配额")
+        #expect(rows[2].value == "已使用 6.4%")
+        #expect(rows[2].secondaryValue == "上限 1000 · 剩余 936")
+        #expect(rows[3].label == "search-prime")
+    }
+
     @MainActor
     private static func costSummaryModel(style: CostSummaryDisplayStyle) throws -> UsageMenuCardView.Model {
         let settings = testSettingsStore(suiteName: "ZaiMenuCardTests-cost-summary-\(style.rawValue)")