@loommii/dsh-provider-usage 0.10.0 → 0.11.0

package/README.md

@@ -1,6 +1,6 @@
 # dsh-provider-usage — DSH「用量中心」
 
-> 当前版本 **v0.10.0** · npm `@loommii/dsh-provider-usage` · [更新历史](docs/CHANGELOG.md)
+> 当前版本 **v0.11.0** · npm `@loommii/dsh-provider-usage` · [更新历史](docs/CHANGELOG.md)
 
 DSH Web GUI 插件 **「用量中心」**：一个常驻右下角的用量卡片，实时显示你的 AI 服务用量 / 余额，不用再打开网页查；附带本地 Token 统计页，不联网也能看自己今天用了多少。
 
@@ -85,7 +85,8 @@ dsh plugin --profile web remove @loommii/dsh-provider-usage
   新添加的提供方默认启用。暂停后该实例**不再轮询查询**（卡片 30s 自动刷新跳过它），
   卡片切换菜单里也**不可选**；暂停的若是当前卡片实例会自动切到其他启用实例，全部暂停时卡片隐藏。
   启用/暂停只影响查询与卡片选择，编辑 / 删除 / Key 配置都原样保留
-- 设置页有两个标签：「提供方」管理实例，「用量统计」查看本地 Token 统计
+- 设置页有三个标签：「提供方」管理实例，「用量统计」查看本地 Token 统计，「卡片设置」自定义卡片显示
+- **卡片设置**：可分别开关卡片上的信息模块（主数字 / 副行信息 / 窗口进度条 / 状态 chip / 提供方名称），也可整体「显示卡片」开关隐藏整卡；隐藏后不再轮询查询。全部模块关闭时卡片视为隐藏，并提供「恢复默认」一键还原
 - 设置保存在本机浏览器中；删掉实例不会上传或泄露任何 Key
 - 卡片拖动后的位置会自动保存，下次打开还是老位置
 

package/docs/CHANGELOG.md

@@ -1,6 +1,23 @@
 # Changelog
 
-## v0.10.0（未发布）
+## v0.11.0（未发布）
+
+### 新功能：卡片设置（用量中心第三页）
+
+- **新增「卡片设置」页**（用量中心二级菜单变为「提供方 / 用量统计 / 卡片设置」三页）：
+  5 个开关分别控制卡片信息模块——主数字、副行信息、窗口进度条、状态 chip、提供方名称；
+  另有「显示卡片」总开关隐藏整卡；改动即时生效并持久化到 localStorage
+- **隐藏即停轮询**：`visible=false` 或全部信息模块关闭时卡片完全隐藏（不再渲染空壳），
+  30s 自动刷新与查询请求随之停止，重新显示后立即恢复
+- **持久化健壮性**：设置版本升 v6，v3~v5 旧配置自动迁移；card 子项逐项布尔归一化，
+  脏数据/非布尔值回落默认（杜绝开关显示与实际渲染分裂）；新增跨页签 `storage` 同步，
+  避免多页签 last-write-wins 覆盖丢配置；localStorage 写入失败时设置页内联提示（4s 自动消失）
+- **恢复默认**：卡片设置页新增两段式确认「恢复默认」按钮，一键还原全部开关并重新显示卡片
+- **全关空态引导**：所有模块关闭时，设置页提供方/卡片设置页显示「卡片已隐藏」提示
+- **可访问性修正**：设置开关行由 `label` 包裹 `button` 改为语义化 `div + role="switch"` 结构
+- README 使用说明同步更新（两个标签 → 三个标签，补充卡片设置说明）
+
+## v0.10.0（2026-09-09）
 
 - **新增提供方 AMD Radeon Cloud (中国)（余额+配额卡）**：实测端点 `GET {baseUrl}/usage`（`https://developer.amd.com.cn/radeon/api/v1/usage`，Bearer API Key）——今日剩余 pts 为主数字（3 位小数向下取整百分比）、副行已用/限额 + 剩余（pts）、单日窗口进度条 + 重置倒计时；透传今日/近24h/近30天/累计时间段汇总与按模型拆分（`by_model`）、单次调用明细（`recent`）
 - **无周/月窗口**：AMD 只按日限额计（`daily_cost_limit/used/remaining_usd`），接口无 weekly/monthly 字段；适配器只画「今日」一行进度条

package/lib/client.js

@@ -20,7 +20,37 @@ window.__ModuleLoader__.load({
 
     const inject = ['slots'];
     const SETTINGS_KEY = 'dsh-provider-usage.settings';
-    const DEFAULT_SETTINGS = { visible: true, refreshMs: 30000, providerId: 'opencode-go', right: 16, bottom: 16, settingsVersion: 5 };
+    const SETTINGS_VERSION = 6;
+    // 卡片信息模块显示开关：单一数据源（渲染门控、设置面板、迁移归一化共用）。
+    // 默认全开；新增模块只需在此加一项并同步 zh 文案。
+    const CARD_MODULES = [
+      { key: 'showMainNumber', default: true },
+      { key: 'showSubRow', default: true },
+      { key: 'showWindowBars', default: true },
+      { key: 'showChip', default: true },
+      { key: 'showProviderName', default: true },
+    ];
+    function defaultCard() {
+      var out = {};
+      for (var i = 0; i < CARD_MODULES.length; i++) out[CARD_MODULES[i].key] = CARD_MODULES[i].default;
+      return out;
+    }
+    function normalizeCard(raw) {
+      var out = defaultCard();
+      if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+        for (var i = 0; i < CARD_MODULES.length; i++) {
+          var k = CARD_MODULES[i].key;
+          if (typeof raw[k] === 'boolean') out[k] = raw[k];
+        }
+      }
+      return out;
+    }
+    function cardModuleOn(card, key) {
+      return (card && card[key]) !== false;
+    }
+    const DEFAULT_SETTINGS = { visible: true, refreshMs: 30000, providerId: 'opencode-go', right: 16, bottom: 16, settingsVersion: SETTINGS_VERSION,
+      card: defaultCard(),
+    };
     // 卡片常驻 body 顶层（z-index 与 dsh-pet 同值，≈int32 上限）
     const Z_INDEX = 2147483000;
     // 适配器元数据（与 host ADAPTERS 对应；logo 与显示名用于设置页/菜单）
@@ -73,6 +103,27 @@ window.__ModuleLoader__.load({
       used: '已用',
       errorTitle: '无法获取用量',
       nav: '用量中心',
+      // 卡片设置页
+      cardSettings: '卡片设置',
+      cardSettingsDesc: '自定义卡片上显示的信息模块。',
+      showCard: '显示卡片',
+      showCardHint: '关闭后卡片完全隐藏（设置页仍可正常管理提供方与用量统计）。',
+      showMainNumber: '主数字',
+      showMainNumberHint: '卡片核心数值（剩余额度或剩余百分比）。',
+      showSubRow: '副行信息',
+      showSubRowHint: '已用/总额 + 剩余额度（Command Code / AMD 等百分比卡）。',
+      showWindowBars: '窗口进度条',
+      showWindowBarsHint: '5小时滚动/7天/每月（或 AMD 今日）用量进度条。',
+      showChip: '状态 chip',
+      showChipHint: '卡片右上角状态标签（正常/查询中/未更新/注意）。',
+      showProviderName: '提供方名称',
+      showProviderNameHint: '卡片头部提供方名称与切换菜单。',
+      allModulesOff: '所有信息模块已关闭，卡片已隐藏（可在这里重新开启）。',
+      saveFailed: '设置保存失败：浏览器本地存储不可用，本次修改刷新后将丢失。',
+      resetCard: '恢复默认',
+      resetCardConfirm: '再次点击确认恢复默认',
+      // 用量中心副标题（随标签数量变化）
+      navDesc: '管理提供方、查看本地用量统计，并自定义卡片显示。',
     };
 
     var styleId = 'dsh-provider-usage/styles.css';
@@ -108,7 +159,7 @@ window.__ModuleLoader__.load({
         '.dsh-pu-menu-item.active{background:rgba(255,179,198,.14);color:#FFB3C6}',
         '.dsh-pu-menu-item .mini-logo{width:22px;height:22px;border-radius:6px;flex:none;display:flex;align-items:center;justify-content:center;overflow:hidden}',
         '.dsh-pu-menu-item .check{margin-left:auto;color:#FFB3C6;font-size:12px}',
-        '.dsh-pu-card-title{font-size:14px;font-weight:600;color:#EFE0E5;flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+        '.dsh-pu-card-title{font-size:14px;font-weight:600;color:#EFE0E5;flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical}',
         '.dsh-pu-chip{display:inline-flex;align-items:center;gap:5px;border-radius:999px;padding:2px 8px;font-size:10px;font-weight:600;flex:none}',
         '.dsh-pu-chip.ok{background:rgba(102,187,106,.14);color:#7ED68A}',
         '.dsh-pu-chip.warn{background:rgba(255,167,38,.15);color:#FFC46B}',
@@ -150,6 +201,10 @@ window.__ModuleLoader__.load({
         '.zGbnIq_rowNameDim{color:var(--dsw-alias-label-tertiary)}',
         '.zGbnIq_rowCard .zGbnIq_credentialDot.dsh-pu-dot-paused{background:var(--dsw-alias-label-tertiary,#8b93a7)}',
         '.zGbnIq_rowPaused .zGbnIq_rowIdentity .zGbnIq_rowName{color:var(--dsw-alias-label-tertiary)}',
+        // ── 卡片设置页：开关行文本弹性（label 语义、flex 排布见 CardSettingsPanel）──
+        '.dsh-pu-switchRowText{flex-direction:column;gap:2px;min-width:0;flex:1;display:flex}',
+        '.dsh-pu-switchRowText .zGbnIq_advancedHint{margin:0}',
+        '.dsh-pu-cardEmpty{border:1px dashed var(--dsw-alias-border-l3);border-radius:10px;margin:2px 0 10px;padding:8px 10px;color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px}',
       ].join('');
       var tag = document.createElement('style');
       tag.dataset.plugin = 'dsh-provider-usage';
@@ -163,10 +218,11 @@ window.__ModuleLoader__.load({
       try {
         var s = JSON.parse(window.localStorage.getItem(SETTINGS_KEY) || 'null');
         if (s && typeof s === 'object' &&
-            (s.settingsVersion === DEFAULT_SETTINGS.settingsVersion || s.settingsVersion === 3 || s.settingsVersion === 4)) {
-          // v3→v4 新增 providerId（默认 opencode-go），其余偏好保留
+            (s.settingsVersion === SETTINGS_VERSION || s.settingsVersion === 3 || s.settingsVersion === 4 || s.settingsVersion === 5)) {
+          // v5→v6 新增 card 显示开关（默认全开；仅布尔值生效），其余偏好保留
           return Object.assign({}, DEFAULT_SETTINGS, s, {
             providerId: typeof s.providerId === 'string' ? s.providerId : DEFAULT_SETTINGS.providerId,
+            card: normalizeCard(s.card),
           });
         }
         // 设置结构升级：v2→v3 移除用户可配置的 zIndex（固定与 dsh-pet 一致），其余偏好保留
@@ -181,14 +237,21 @@ window.__ModuleLoader__.load({
     }
     var settingsState = loadSettings();
     var settingsListeners = new Set();
+    // 保存失败时通知（先广播 onPersistFailed，再广播常规刷新）：
+    // 订阅者根据回调结果展示“无法保存”提示；卡片渲染不依赖持久化结果，避免闪烁。
     function saveSettings() {
-      try { window.localStorage.setItem(SETTINGS_KEY, JSON.stringify(settingsState)); } catch (e) { /* ignore */ }
+      var ok = true;
+      try { window.localStorage.setItem(SETTINGS_KEY, JSON.stringify(settingsState)); }
+      catch (e) { ok = false; }
+      return ok;
     }
     function getSettings() { return settingsState; }
     function setSettings(patch) {
-      settingsState = Object.assign({}, settingsState, patch);
-      saveSettings();
-      settingsListeners.forEach(function (fn) { fn(); });
+      settingsState = Object.assign({}, settingsState, typeof patch === 'function' ? patch(settingsState) : patch);
+      var ok = saveSettings();
+      settingsListeners.forEach(function (fn) {
+        try { fn(ok ? null : new Error('settings persist failed')); } catch (e) { /* ignore */ }
+      });
     }
     function subscribeSettings(fn) {
       settingsListeners.add(fn);
@@ -199,6 +262,16 @@ window.__ModuleLoader__.load({
       useEffect(function () { return subscribeSettings(function () { setS(getSettings()); }); }, []);
       return s;
     }
+    // 跨页签同步：其它页签写入后重读并广播（消除 last-write-wins 覆盖丢配置）
+    if (typeof window !== 'undefined' && window.addEventListener) {
+      window.addEventListener('storage', function (e) {
+        if (e.key !== SETTINGS_KEY) return;
+        settingsState = loadSettings();
+        settingsListeners.forEach(function (fn) {
+          try { fn(null); } catch (err) { /* ignore */ }
+        });
+      });
+    }
 
     // ── 供应商实例清单（v0.8.0：host 端 providers.json 为单一事实源，localStorage 只是写穿透缓存）──
     // 修复「重启后提供方清单被静默重建」：此前清单只存 localStorage，存储 key 一旦丢失
@@ -347,6 +420,9 @@ window.__ModuleLoader__.load({
     // ── 用量卡片（布局借鉴 Rainytoken 小组件卡片，常驻右下角）──────────
     function UsageCard() {
       var s = useSettings();
+      var card = s.card || {};
+      function cardOn(key) { return cardModuleOn(card, key); }
+      var allModulesOff = !cardOn('showMainNumber') && !cardOn('showSubRow') && !cardOn('showWindowBars') && !cardOn('showChip') && !cardOn('showProviderName');
       var providers = useProviders();
       var [data, setData] = useState(null);
       var [loading, setLoading] = useState(false);
@@ -432,11 +508,14 @@ window.__ModuleLoader__.load({
           .finally(function () { setLoading(false); });
       }, [curKey]);
 
+      // 仅在卡片实际可见时轮询：s.visible=false 或全部模块关闭（空壳隐藏）时不发起请求
+      var pollActive = s.visible && !allModulesOff;
       useEffect(function () {
+        if (!pollActive) return undefined;
         load();
         var timer = window.setInterval(load, s.refreshMs || 30000);
         return function () { window.clearInterval(timer); };
-      }, [load, s.refreshMs]);
+      }, [load, pollActive, s.refreshMs]);
 
       // 点击卡片外部关闭菜单
       useEffect(function () {
@@ -449,7 +528,7 @@ window.__ModuleLoader__.load({
         return function () { document.removeEventListener('mousedown', onDoc); };
       }, [menuOpen]);
 
-      if (!s.visible || !current) return null;
+      if (!s.visible || allModulesOff || !current) return null;
 
       // 状态语义：请求中=呼吸绿“查询中”（优先于旧数据状态）；正常/注意（stale 或余额不足）/错误
       var loadingCls = loading ? ' dsh-pu-chip-loading' : '';
@@ -528,12 +607,12 @@ window.__ModuleLoader__.load({
         // 窗口行/主值/警告条已覆盖全部信息，extra 全文不再展示（保持卡片干净）
         var extra = null;
         body = React.createElement('div', null,
-          React.createElement('div', { className: 'dsh-pu-remain' },
+          cardOn('showMainNumber') ? React.createElement('div', { className: 'dsh-pu-remain' },
             React.createElement('span', { className: 'dsh-pu-remain-big' }, (isCommandCode || isAmd) ? (remainPct === null ? '--' : remainPct.toFixed(3) + '%') : main),
-            React.createElement('span', { className: 'dsh-pu-remain-label' }, (isCommandCode || isAmd) ? ' ' + zh.remaining + '（' + (isAmd ? zh.daily : zh.monthly) + '）' : ' ' + mainLabel)),
+            React.createElement('span', { className: 'dsh-pu-remain-label' }, (isCommandCode || isAmd) ? ' ' + zh.remaining + '（' + (isAmd ? zh.daily : zh.monthly) + '）' : ' ' + mainLabel)) : null,
           warn,
-          cc,
-          winRows,
+          cardOn('showSubRow') ? cc : null,
+          cardOn('showWindowBars') ? winRows : null,
           extra);
       }
 
@@ -571,9 +650,9 @@ window.__ModuleLoader__.load({
             onClick: function (e) { if (draggedRef.current) { draggedRef.current = false; return; } e.stopPropagation(); if (multiple) setMenuOpen(!menuOpen); },
           },
             React.createElement('span', { className: 'dsh-pu-logo ' + logoClass }, logoEl),
-            React.createElement('span', { className: 'dsh-pu-card-title' }, title),
+            cardOn('showProviderName') ? React.createElement('span', { className: 'dsh-pu-card-title' }, title) : null,
             multiple ? React.createElement('span', { className: 'caret' }, menuOpen ? '▴' : '▾') : null),
-          React.createElement('span', { className: 'dsh-pu-chip ' + level + loadingCls }, React.createElement('i', null), chipText)),
+          cardOn('showChip') ? React.createElement('span', { className: 'dsh-pu-chip ' + level + loadingCls }, React.createElement('i', null), chipText) : null),
         menu,
         body,
         React.createElement('div', { className: 'dsh-pu-card-foot' },
@@ -861,6 +940,95 @@ window.__ModuleLoader__.load({
       }
       return { level: 'err',     label: '查询失败' + (qs.err ? '：' + qs.err : ''), clickable: true,  detailKind: 'err',  dotCls: ' zGbnIq_credentialDotMissing', detailText: '查询失败：' + (qs.err || '未知错误') };
     }
+    // 卡片设置页：5 个开关控制卡片信息模块显示；即时生效 + 保存失败反馈 + 恢复默认
+    function CardSettingsPanel() {
+      var s = useSettings();
+      var card = s.card || {};
+      // 持久化失败提示（setSettings 回调收到非空 err 时显示；下次成功自动清除）
+      var [persistFailed, setPersistFailed] = useState(false);
+      var persistErrTimer = useRef(null);
+      useEffect(function () {
+        var dispose = subscribeSettings(function (err) {
+          if (err) {
+            setPersistFailed(true);
+            window.clearTimeout(persistErrTimer.current);
+            persistErrTimer.current = window.setTimeout(function () { setPersistFailed(false); }, 4000);
+          } else {
+            setPersistFailed(false);
+          }
+        });
+        return function () {
+          dispose();
+          window.clearTimeout(persistErrTimer.current);
+        };
+      }, []);
+      var [resetArm, setResetArm] = useState(false);
+      var resetTimer = useRef(null);
+      useEffect(function () {
+        return function () { window.clearTimeout(resetTimer.current); };
+      }, []);
+      function armReset() {
+        setResetArm(true);
+        window.clearTimeout(resetTimer.current);
+        resetTimer.current = window.setTimeout(function () { setResetArm(false); }, 4000);
+      }
+      function doReset() {
+        setResetArm(false);
+        window.clearTimeout(resetTimer.current);
+        setSettings({ visible: true, card: defaultCard() });
+      }
+      function toggle(key) {
+        setSettings(function (prev) {
+          var cur = (prev && prev.card) || {};
+          var next = Object.assign({}, cur);
+          next[key] = !cardModuleOn(cur, key);
+          return { card: next };
+        });
+      }
+      var rows = [
+        { key: 'showMainNumber', label: zh.showMainNumber, hint: zh.showMainNumberHint },
+        { key: 'showSubRow', label: zh.showSubRow, hint: zh.showSubRowHint },
+        { key: 'showWindowBars', label: zh.showWindowBars, hint: zh.showWindowBarsHint },
+        { key: 'showChip', label: zh.showChip, hint: zh.showChipHint },
+        { key: 'showProviderName', label: zh.showProviderName, hint: zh.showProviderNameHint },
+      ];
+      var cardOn = s.visible !== false;
+      var allOff = !rows.some(function (r) { return cardModuleOn(card, r.key); });
+      function switchRow(id, on, ariaLabel, text, hint, onChange) {
+        return React.createElement('div', { className: 'zGbnIq_rowCard' },
+          React.createElement('div', { className: 'zGbnIq_editorSwitchRow', style: { justifyContent: 'space-between' } },
+            React.createElement('div', { className: 'dsh-pu-switchRowText' },
+              React.createElement('span', { className: 'dsh-pu-switchText' }, text),
+              React.createElement('span', { className: 'zGbnIq_advancedHint' }, hint)),
+            React.createElement('button', {
+              type: 'button', role: 'switch', id: id,
+              'aria-checked': on ? 'true' : 'false',
+              'aria-label': ariaLabel,
+              className: 'dsh-pu-switch' + (on ? ' dsh-pu-switch-on' : ''),
+              onClick: onChange,
+            }, React.createElement('span', { className: 'dsh-pu-switch-thumb' }))));
+      }
+      return React.createElement('div', { className: 'zGbnIq_section' },
+        React.createElement('h2', { className: 'zGbnIq_title' }, zh.cardSettings),
+        React.createElement('p', { className: 'zGbnIq_intro' }, zh.cardSettingsDesc),
+        persistFailed ? React.createElement('p', { className: 'zGbnIq_error' }, zh.saveFailed) : null,
+        React.createElement('div', { className: 'zGbnIq_rows' },
+          switchRow('pu-switch-visible', cardOn, zh.showCard, zh.showCard, zh.showCardHint,
+            function () { setSettings({ visible: !cardOn }); }),
+          allOff ? React.createElement('p', { className: 'zGbnIq_advancedHint', style: { margin: '0' } }, zh.allModulesOff) : null,
+          rows.map(function (r) {
+            return switchRow('pu-switch-' + r.key, cardModuleOn(card, r.key), r.label, r.label, r.hint,
+              function () { toggle(r.key); });
+          })),
+        React.createElement('div', { className: 'zGbnIq_editorActions', style: { marginTop: '4px' } },
+          React.createElement('button', {
+            type: 'button',
+            className: 'zGbnIq_secondaryButton',
+            'data-arm': resetArm ? 'true' : undefined,
+            'aria-label': resetArm ? zh.resetCardConfirm : zh.resetCard,
+            onClick: resetArm ? doReset : armReset,
+          }, resetArm ? zh.resetCardConfirm : zh.resetCard)));
+    }
     function SettingsCard() {
       var s = useSettings();
       var providers = useProviders();
@@ -1212,12 +1380,15 @@ window.__ModuleLoader__.load({
             React.createElement('button', { type: 'button', className: 'zGbnIq_primaryButton', disabled: busy, onClick: saveEdit }, '保存')));
       }
 
-      // 插件页同款二级菜单（官方 dsh-client-ui-settings-plugins 结构）：提供方设置 / 用量统计 两个互不影响的分页
+      // 插件页同款二级菜单（官方 dsh-client-ui-settings-plugins 结构）：提供方设置 / 用量统计 / 卡片设置 三个互不影响的分页
       var tabsList = [
         { id: 'providers', label: '提供方设置' },
         { id: 'usage', label: '用量统计' },
+        { id: 'card-settings', label: zh.cardSettings },
       ];
       var [tab, setTab] = useState('providers');
+      // 卡片因 visible=false 或全部模块关闭而隐藏时，在提供方页顶部给出可恢复的提示（卡片设置 tab 有恢复入口）
+      var cardHidden = !s.visible || !CARD_MODULES.some(function (m) { return cardModuleOn(s.card, m.key); });
       var tabsRef = useRef([]);
       function onTabKey(e, idx) {
         var len = tabsList.length;
@@ -1238,6 +1409,7 @@ window.__ModuleLoader__.load({
       var providersPanel = React.createElement('div', { className: 'zGbnIq_section' },
           React.createElement('h2', { className: 'zGbnIq_title' }, '提供方'),
           React.createElement('p', { className: 'zGbnIq_intro' }, '填入各供应方的 Key 引用即可查询其用量与余额。'),
+          cardHidden ? React.createElement('p', { className: 'dsh-pu-cardEmpty' }, zh.allModulesOff) : null,
           React.createElement('ul', { className: 'zGbnIq_rows' },
             providers.length === 0
               ? React.createElement('li', { className: 'zGbnIq_rowCard' },
@@ -1268,6 +1440,9 @@ window.__ModuleLoader__.load({
       var usagePanel = React.createElement('div', { className: 'pbvGtq_panel', role: 'tabpanel', id: 'pu-tab-usage', 'aria-labelledby': 'pu-tab-btn-usage', hidden: tab !== 'usage' },
         React.createElement(UsageStatsPage, { active: tab === 'usage' }));
 
+      // 页面 3：卡片设置（卡片信息模块显示开关）
+      var cardSettingsPanel = React.createElement('div', { className: 'pbvGtq_panel', role: 'tabpanel', id: 'pu-tab-card-settings', 'aria-labelledby': 'pu-tab-btn-card-settings', hidden: tab !== 'card-settings' },
+        React.createElement(CardSettingsPanel));
       // 二级菜单（插件页同款：下划线高亮 + 方向键切换）
       var tabsBar = React.createElement('div', { className: 'pbvGtq_tabs', role: 'tablist', 'aria-label': '用量中心视图' },
         tabsList.map(function (t, idx) {
@@ -1288,10 +1463,11 @@ window.__ModuleLoader__.load({
 
       return React.createElement('div', { className: 'pbvGtq_section' },
         React.createElement('h2', { className: 'pbvGtq_heading' }, '用量中心'),
-        React.createElement('p', { className: 'pbvGtq_intro' }, '管理提供方并查看本地用量统计。'),
+        React.createElement('p', { className: 'pbvGtq_intro' }, zh.navDesc),
         tabsBar,
         React.createElement('div', { className: 'pbvGtq_panel', role: 'tabpanel', id: 'pu-tab-providers', 'aria-labelledby': 'pu-tab-btn-providers', hidden: tab !== 'providers' }, providersPanel),
-        usagePanel);
+        usagePanel,
+        cardSettingsPanel);
     }
     // 提供方单行：状态点 + 名称 + 编辑/删除 + 展开详情
     // 状态判定全部交给 statusOf；本组件只做渲染；启用/暂停开关在编辑弹层里管理

package/lib/index.js

@@ -21,8 +21,8 @@ export const name = 'provider-usage'
 
 /** 插件版本单一来源：package.json（UA 标识用；bundle 内嵌等读不到时回退字面量）。 */
 const PLUGIN_VERSION = (() => {
-  try { return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version || '0.10.0' }
-  catch { return '0.10.0' }
+  try { return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version || '0.11.0' }
+  catch { return '0.11.0' }
 })()
 const USER_AGENT = 'dsh-provider-usage/' + PLUGIN_VERSION
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loommii/dsh-provider-usage",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "DSH 插件（用量中心）：常驻用量卡片 · 多提供方用量/余额查询（OpenCode Go 订阅 + DeepSeek 余额 + Command Code 订阅/余额，对齐 cc-switch 查询语义）",
   "type": "module",
   "main": "lib/index.js",