@linxin666/dsh-usage 0.4.10 → 0.4.12

package/src/client/locales.ts

@@ -16,9 +16,9 @@ export const zh = {
   'usage.refresh': '刷新',
   'usage.refreshing': '刷新中…',
   'usage.updated': '更新于 {time}',
-  'usage.loading': '正在加载用量数据…',
+  'usage.loading': '正在读取用量…',
   'usage.error': '加载失败：{error}',
-  'usage.disabled': '插件已停用：勾选下方「启用插件」即可恢复统计。',
+  'usage.disabled': '已停用，打开开关继续统计。',
   'usage.current': '当前',
   'usage.today': '今日用量',
   'usage.today.cost': '今日消费（估算）',
@@ -42,28 +42,26 @@ export const zh = {
   'usage.tokens.cacheRead': '缓存读',
   'usage.tokens.cacheWrite': '缓存写',
   'usage.trend': '近 30 天',
-  'usage.noData': '暂无用量数据（统计自插件启用起）',
+  'usage.noData': '还没有用量，插件启用后开始统计。',
   'usage.balance': '余额',
-  'usage.balance.unsupported': '暂不支持余额查询',
+  'usage.balance.unsupported': '不支持查询余额',
   'usage.balance.noCredential': '未配置凭据',
-  'usage.balance.noneConfigured': '没有已配置的提供方',
-  'usage.oauth': 'OAuth 凭据，不做余额查询',
+  'usage.balance.noneConfigured': '还没有配置提供方',
+  'usage.oauth': 'OAuth 凭据，不查余额',
   'usage.plan.reset': '{date} 重置',
-  'usage.plan.noPlan': '未检测到套餐数据',
-  'usage.plan.noneConfigured': '没有已配置的套餐类 provider（如 Kimi、GLM、OpenCode Go、MiniMax、Codex 订阅）',
+  'usage.plan.noPlan': '没有读到套餐数据',
+  'usage.plan.noneConfigured': '没有配置套餐类提供方，例如 Kimi、GLM、OpenCode Go、MiniMax、Codex 订阅。',
   'usage.plan.windows.5h': '5 小时',
   'usage.plan.windows.week': '每周',
   'usage.plan.windows.month': '每月',
   'usage.provider.error': '查询失败：{error}',
   'usage.errorListSeparator': '；',
   'usage.config.title': '设置',
-  'usage.config.enabled': '启用插件',
   'usage.config.pollIntervalSec': '轮询间隔（秒）',
-  'usage.config.spendCurrency': '消费显示货币',
-  'usage.config.cnyPerUsd': '汇率（1 美元兑人民币）',
-  'usage.config.saveFailed': '保存失败：设置未被接受。',
+  'usage.config.spendCurrency': '货币',
+  'usage.config.cnyPerUsd': '汇率',
   'usage.bank.title': '鲸元券',
-  'usage.bank.hint': '所有模型每消耗 100 万 tokens 铸造 1 鲸元；保存或分享这张票券。',
+  'usage.bank.hint': '每用掉 100 万 tokens 铸造 1 鲸元，可以保存或分享这张票券。',
   'usage.bank.noUsage': '暂无用量数据',
   'usage.bank.minted': '累计铸造 {minted} 鲸元（{tokens} tokens）',
   'usage.bank.spend.observed': '官方余额实测花费 {cost}（自 {since} 起）',
@@ -78,6 +76,19 @@ export const zh = {
   'usage.foot.open': '打开使用统计设置',
   'usage.foot.collapse': '收起用量卡片',
   'usage.foot.expand': '展开用量卡片',
+  'usage.description': '各提供方的用量、余额与套餐额度。',
+  'usage.config.pollIntervalHint': '多久查一次余额与套餐。',
+  'usage.config.spendCurrencyHint': '消费金额用这种货币显示。',
+  'usage.config.cnyPerUsdHint': '1 美元折合多少人民币。',
+  'settings.collapse': '收起',
+  'settings.expand': '展开',
+  'settings.notExposed': '这个版本的 DSH 没有开放使用统计的设置。',
+  'settings.readOnly': '设置只读。',
+  'settings.saveFailed': '没有保存成功。',
+  'settings.inherit': '默认',
+  'settings.overridden': '已修改',
+  'settings.reset': '恢复默认',
+  'settings.invalidNumber': '填一个数字，留空用默认值。',
 }
 
 /** English mirror; every zh key present. */
@@ -89,9 +100,9 @@ export const en: Record<UsageKey, string> = {
   'usage.refresh': 'Refresh',
   'usage.refreshing': 'Refreshing…',
   'usage.updated': 'Updated {time}',
-  'usage.loading': 'Loading usage data…',
+  'usage.loading': 'Reading usage…',
   'usage.error': 'Failed to load: {error}',
-  'usage.disabled': 'Plugin disabled. Tick "Enable plugin" below to resume statistics.',
+  'usage.disabled': 'Turned off; flip the switch to resume.',
   'usage.current': 'Current',
   'usage.today': 'Today',
   'usage.today.cost': 'Today spend (estimated)',
@@ -115,28 +126,26 @@ export const en: Record<UsageKey, string> = {
   'usage.tokens.cacheRead': 'Cache read',
   'usage.tokens.cacheWrite': 'Cache write',
   'usage.trend': 'Last 30 days',
-  'usage.noData': 'No usage data yet (counting starts when the plugin is enabled)',
+  'usage.noData': 'No usage yet; counting starts once the plugin is on.',
   'usage.balance': 'Balance',
-  'usage.balance.unsupported': 'Balance query not supported',
+  'usage.balance.unsupported': 'No balance query',
   'usage.balance.noCredential': 'No credential configured',
   'usage.balance.noneConfigured': 'No providers configured',
   'usage.oauth': 'OAuth credential, no balance query',
   'usage.plan.reset': 'resets {date}',
-  'usage.plan.noPlan': 'No plan data detected',
-  'usage.plan.noneConfigured': 'No plan-capable provider configured (such as Kimi, GLM, OpenCode Go, MiniMax, Codex subscription)',
+  'usage.plan.noPlan': 'No plan data',
+  'usage.plan.noneConfigured': 'No plan provider configured, such as Kimi, GLM, OpenCode Go, MiniMax or a Codex subscription.',
   'usage.plan.windows.5h': '5 hours',
   'usage.plan.windows.week': 'Weekly',
   'usage.plan.windows.month': 'Monthly',
   'usage.provider.error': 'Query failed: {error}',
   'usage.errorListSeparator': '; ',
   'usage.config.title': 'Settings',
-  'usage.config.enabled': 'Enable plugin',
   'usage.config.pollIntervalSec': 'Poll interval (seconds)',
-  'usage.config.spendCurrency': 'Spend display currency',
-  'usage.config.cnyPerUsd': 'Exchange rate (CNY per USD)',
-  'usage.config.saveFailed': 'Save failed: the deployment did not accept the setting.',
+  'usage.config.spendCurrency': 'Currency',
+  'usage.config.cnyPerUsd': 'Exchange rate',
   'usage.bank.title': 'Whale-yuan voucher',
-  'usage.bank.hint': 'Every 1,000,000 tokens spent across all models mint one whale yuan; save or share the note.',
+  'usage.bank.hint': 'Every million tokens mints one whale yuan; save or share the note.',
   'usage.bank.noUsage': 'No usage data yet',
   'usage.bank.minted': 'Minted {minted} whale yuan ({tokens} tokens)',
   'usage.bank.spend.observed': 'Spent {cost} observed on the official balance (watching since {since})',
@@ -151,6 +160,19 @@ export const en: Record<UsageKey, string> = {
   'usage.foot.open': 'Open usage statistics settings',
   'usage.foot.collapse': 'Collapse the usage card',
   'usage.foot.expand': 'Expand the usage card',
+  'usage.description': 'Usage, balances and plan quotas for each provider.',
+  'usage.config.pollIntervalHint': 'How often balances and plans are read.',
+  'usage.config.spendCurrencyHint': 'Spend figures show in this currency.',
+  'usage.config.cnyPerUsdHint': 'Yuan per US dollar.',
+  'settings.collapse': 'Collapse',
+  'settings.expand': 'Expand',
+  'settings.notExposed': 'This DSH version does not open the usage settings.',
+  'settings.readOnly': 'Settings are read-only.',
+  'settings.saveFailed': 'Not saved.',
+  'settings.inherit': 'Default',
+  'settings.overridden': 'Changed',
+  'settings.reset': 'Reset',
+  'settings.invalidNumber': 'Enter a number, or leave it empty for the default.',
 }
 
 export type UsageKey = keyof typeof zh

package/src/client/section-integration.ts

@@ -0,0 +1,88 @@
+/**
+ * Optional integration with the family Web Extensions parent.
+ *
+ * The parent service owns page mounting; this module contributes one page
+ * contract and keeps the original first-level section as the standalone
+ * fallback. Deep links still resolve the parent service first.
+ */
+
+import { openUsageSettings, settingsShellStore, type SlotSeatReader } from './foot-card-mount.tsx'
+import { t } from './locales.ts'
+import { installWebExtensionPage, type WebExtensionPageContext } from './web-extension-page.ts'
+
+/** The original first-level settings seat and its usage entry id. */
+export const USAGE_SETTINGS_SEAT = 'settings.section'
+export const USAGE_SECTION_ID = 'dsh-usage'
+
+/** The family section's keyed extension seat. */
+export const WEB_UI_EXTENSION_SEAT = 'web-ui.extension'
+
+/** Optional navigation contract published by the family extensions plugin. */
+export interface WebUiExtensionsService {
+  sectionId: 'web-ui-plugins'
+  label(): string
+  open(id: string): boolean
+}
+
+/** The context slice needed by the migrating section registration. */
+export type UsageSectionContext = WebExtensionPageContext
+
+/** The context slice needed by the foot card's settings navigation. */
+export interface UsageNavigationContext {
+  get?(name: string): unknown
+  slots: SlotSeatReader
+}
+
+/** The usage card contribution, independent of the seat that owns it. */
+export interface UsageSectionRegistration {
+  order: number
+  locale: string
+  label(): string
+  inject(): object
+  component: unknown
+}
+
+/** Read the optional service without assuming a particular cordis test double. */
+export function getWebUiExtensions(ctx: { get?(name: string): unknown }): WebUiExtensionsService | undefined {
+  if (typeof ctx.get !== 'function') return undefined
+  try {
+    const service = ctx.get('webUiExtensions') as Partial<WebUiExtensionsService> | undefined
+    return service?.sectionId === 'web-ui-plugins'
+      && typeof service.label === 'function'
+      && typeof service.open === 'function'
+      ? service as WebUiExtensionsService
+      : undefined
+  } catch {
+    return undefined
+  }
+}
+
+/** Register the one usage page; disposal is owned by the calling plugin fiber. */
+export function installUsageSection(
+  ctx: UsageSectionContext,
+  registration: UsageSectionRegistration,
+): () => void {
+  return installWebExtensionPage(ctx, {
+    key: USAGE_SECTION_ID,
+    order: registration.order,
+    locale: registration.locale,
+    label: registration.label,
+    inject: registration.inject,
+    component: registration.component,
+  })
+}
+
+/**
+ * Open usage through the family service first. If it declines, fall back to the
+ * native settings shell on the family section (or on the original usage row
+ * when the service is absent), preserving the matching localized nav label.
+ */
+export function openIntegratedUsageSettings(ctx: UsageNavigationContext): void {
+  const service = getWebUiExtensions(ctx)
+  if (service?.open(USAGE_SECTION_ID) === true) return
+  openUsageSettings({
+    id: service?.sectionId ?? USAGE_SECTION_ID,
+    label: service === undefined ? () => t('usage.title') : () => service.label(),
+    store: settingsShellStore(ctx.slots),
+  })
+}