npm - @kenz1117/dsh-ui-usage-billing - Versions diffs - 0.4.0 → 0.4.2 - Mend

@kenz1117/dsh-ui-usage-billing 0.4.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md CHANGED Viewed

@@ -6,6 +6,7 @@ DeepSeek Harness 计费仪表盘插件。从持久化会话日志实时聚合模
 [![GitHub stars](https://img.shields.io/github/stars/kenz1117/dsh-ui-usage-billing)](https://github.com/kenz1117/dsh-ui-usage-billing)
 [![GitHub last commit](https://img.shields.io/github/last-commit/kenz1117/dsh-ui-usage-billing)](https://github.com/kenz1117/dsh-ui-usage-billing)
 [![npm version](https://img.shields.io/npm/v/@kenz1117/dsh-ui-usage-billing)](https://www.npmjs.com/package/@kenz1117/dsh-ui-usage-billing)
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 ## 特性
@@ -17,7 +18,7 @@ DeepSeek Harness 计费仪表盘插件。从持久化会话日志实时聚合模
 - **真实用量**：服务端从会话日志实时聚合，无需手工维护统计文件；增量缓存保证只有写过的日志会被重新折叠，重度使用下轮询依然轻量。
 - **模型健康探测**：模型行的圆点反映各厂商接入状态（正常绿 / 异常红 / 未接入灰）。
 - **订阅计划豁免**：走 coding / token plan / opencode 订阅通道的模型照常统计 token、费用记 0（按**通道**判定，同一模型走按量通道时正常计费）。
-- **余额查询**：厂商组头部显示该厂商余额（只显示一次，不再随每行重复），DeepSeek 通过官方余额 API 实时查询；未配置 / Key 无效 / 服务不可达均有状态提示，扩展点可接更多厂商。
+- **余额查询**：厂商组头部显示该厂商余额（只显示一次，不再随每行重复）。DeepSeek、月之暗面（Kimi）、阶跃星辰（StepFun）用官方余额接口**实时查询**；API Key 复用 `llm-pi-ai` 设置的 `apiKeyEnv`（DeepSeek 另有 `balanceApiKeyEnv` 特例），未配置 / Key 无效 / 服务不可达均有状态提示，扩展点可接更多厂商。
 - **可用天数估算**：余额列按最近 7 天日均消耗折算「约可撑 N 天」，剩余不足 3 天红色强调。
 - **余额不足告警**：任一厂商余额（折算人民币）低于阈值时每天弹一次系统通知；阈值经宿主配置 `lowBalanceThreshold`（人民币元）下发，未配置默认 50 元。
 - **未收录模型标注**：真实模型 id 不在计费目录时，明细行显示真实 id 并标注「未收录」，费用按兜底档估算；厂商可从模型 id 自动推断（如 `mi-mimo-2.5` → 小米），健康圆点据此点亮。
@@ -145,7 +146,7 @@ cost（CNY）= (missInput × p_input + cacheHit × p_cacheHit + output × p_outp
 ### `GET /api/billing/balance`
-各接入厂商账户余额（凭据 seam 按 `balanceApiKeyEnv` 取 key）：
+各接入厂商账户余额。API Key 复用 `llm-pi-ai` 设置的 `providers.<id>.apiKeyEnv`（DeepSeek 未在 llm-pi-ai 配置时回退到 `balanceApiKeyEnv`）：
 ```json
 {
@@ -153,11 +154,24 @@ cost（CNY）= (missInput × p_input + cacheHit × p_cacheHit + output × p_outp
     {
       "provider": "deepseek",
       "displayName": "DeepSeek",
-      "ok": true,
       "currency": "CNY",
-      "total": 12.34,
-      "available": 10.56,
-      "granted": 1.78
+      "totalBalance": 12.34
+    },
+    {
+      "provider": "月之暗面",
+      "displayName": "月之暗面",
+      "currency": "CNY",
+      "totalBalance": 49.59,
+      "grantedBalance": 46.59,
+      "toppedUpBalance": 3.0
+    },
+    {
+      "provider": "阶跃星辰",
+      "displayName": "阶跃星辰",
+      "currency": "CNY",
+      "totalBalance": 150.0,
+      "toppedUpBalance": 200.0,
+      "grantedBalance": 50.0
     }
   ]
 }
@@ -200,7 +214,7 @@ cost（CNY）= (missInput × p_input + cacheHit × p_cacheHit + output × p_outp
 | 字段                      | 默认                                   | 说明                                                                                                           |
 | ----------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
 | `statsPath`             | 未设置                                  | 回退统计文件 `.dsh-usage-stats.json` 的绝对路径（`sessionPersistence` 不可用时生效）                                            |
-| `balanceApiKeyEnv`      | `DEEPSEEK_API_KEY`                   | 余额查询使用的 DeepSeek 凭据引用（环境变量名），经 `ctx.credentials` 解析                                                          |
+| `balanceApiKeyEnv`      | `DEEPSEEK_API_KEY`                   | DeepSeek 余额查询的凭据引用；仅在 llm-pi-ai 未配置 deepseek 的 `apiKeyEnv` 时兜底使用                                                      |
 | `subscriptionProviders` | `kimi-coding`、`xiaomi-token-plan-cn` | 订阅制（coding / token 套餐）provider id 列表，照常统计 token、费用记 0                                                        |
 | `monthlyBudget`         | 未设置                                  | 月度预算默认金额（人民币元）；随 usage-stats 下发，作为仪表盘预算条的初始金额（用户在界面上的设置优先并本地持久化）                                             |
 | `lowBalanceThreshold`   | `50`                                 | 余额不足告警阈值（人民币元）；随 usage-stats 下发，任一厂商余额折算人民币低于此值时每天提醒一次                                                       |
@@ -236,7 +250,7 @@ npm publish --access public
 ## Known Limitations and Deferred Work
-- **余额查询仅接入 DeepSeek**：其他厂商一律显示「未配置」；扩展点在 `src/balance.ts`（按厂商余额 API 增加查询器）。
+- **余额查询已接入 DeepSeek / 月之暗面（Kimi）/ 阶跃星辰（StepFun）**：这三家用标准 Bearer API key 即可查询。其余厂商因无公开余额接口或需非 Bearer 鉴权（小米 MiMo 走控制台 Cookie、商汤走 AccessKey 签名、MiniMax/字节豆包走额度制或 AK/SK），暂显示「未配置」；扩展点在 `src/balance.ts`（按厂商余额 API 增加查询器）。
 - **超支通知依赖浏览器 Notification**：权限被拒绝或平台不支持时只有界面红色脉冲兜底，没有宿主级通知通道；通知上限为每天一次。
 - **会话明细不可跳转**：点击会话行不会打开对应会话（跨插件导航需要宿主会话选择通道）；会话数封顶 100 行、面板只显示前 20 行。
 - **费用为目录价估算**：讯飞 / 商汤 / 小米等未公布按量单价的模型使用估算价（特性表脚注 ¹），正式定价以厂商账单为准。

package/lib/client.js CHANGED Viewed

@@ -34,160 +34,160 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var UsageBilling_module_css_default = {
-			"providerGroupBalance": "VWh0dG_providerGroupBalance",
-			"chartCrosshair": "VWh0dG_chartCrosshair",
-			"panelHead": "VWh0dG_panelHead",
-			"triggerAmountSub": "VWh0dG_triggerAmountSub",
-			"heatmapCellEmpty": "VWh0dG_heatmapCellEmpty",
-			"subscriptionTrack": "VWh0dG_subscriptionTrack",
-			"numCol": "VWh0dG_numCol",
-			"rangeButton": "VWh0dG_rangeButton",
+			"rateBadge": "VWh0dG_rateBadge",
+			"balanceCell": "VWh0dG_balanceCell",
 			"healthOk": "VWh0dG_healthOk",
-			"chartLegendLine": "VWh0dG_chartLegendLine",
+			"railButton": "VWh0dG_railButton",
+			"trendPanel": "VWh0dG_trendPanel",
+			"pricingChevron": "VWh0dG_pricingChevron",
+			"dashboardTitle": "VWh0dG_dashboardTitle",
+			"modelProvider": "VWh0dG_modelProvider",
+			"bandPrice": "VWh0dG_bandPrice",
+			"triggerToday": "VWh0dG_triggerToday",
+			"panelTitle": "VWh0dG_panelTitle",
+			"modelName": "VWh0dG_modelName",
+			"triggerDivider": "VWh0dG_triggerDivider",
+			"kpiGreen": "VWh0dG_kpiGreen",
 			"switchOn": "VWh0dG_switchOn",
+			"chartEmpty": "VWh0dG_chartEmpty",
+			"subscriptionReset": "VWh0dG_subscriptionReset",
+			"costCol": "VWh0dG_costCol",
+			"budgetLabel": "VWh0dG_budgetLabel",
+			"roundsFlagBadge": "VWh0dG_roundsFlagBadge",
+			"budgetUnit": "VWh0dG_budgetUnit",
+			"budgetInput": "VWh0dG_budgetInput",
+			"subscriptionWindow": "VWh0dG_subscriptionWindow",
+			"heroSideItem": "VWh0dG_heroSideItem",
+			"subscriptionHead": "VWh0dG_subscriptionHead",
+			"roundsBarFlagged": "VWh0dG_roundsBarFlagged",
+			"currencyButton": "VWh0dG_currencyButton",
 			"rangeButtonActive": "VWh0dG_rangeButtonActive",
-			"rateBadgeBuiltin": "VWh0dG_rateBadgeBuiltin",
-			"flatTag": "VWh0dG_flatTag",
-			"balanceDays": "VWh0dG_balanceDays",
-			"triggerMeta": "VWh0dG_triggerMeta",
-			"kpiLabel": "VWh0dG_kpiLabel",
-			"bandPriceOff": "VWh0dG_bandPriceOff",
-			"triggerAmount": "VWh0dG_triggerAmount",
-			"budgetFillOver": "VWh0dG_budgetFillOver",
-			"bandTagOff": "VWh0dG_bandTagOff",
-			"subscriptionPlan": "VWh0dG_subscriptionPlan",
-			"rounds": "VWh0dG_rounds",
-			"dashboardHead": "VWh0dG_dashboardHead",
+			"heatmapCell": "VWh0dG_heatmapCell",
 			"chartSvg": "VWh0dG_chartSvg",
-			"pricingTable": "VWh0dG_pricingTable",
+			"roundsBarWrap": "VWh0dG_roundsBarWrap",
+			"providerGroupTitle": "VWh0dG_providerGroupTitle",
+			"chartTooltipSwatch": "VWh0dG_chartTooltipSwatch",
+			"budgetFill": "VWh0dG_budgetFill",
+			"chartStack": "VWh0dG_chartStack",
+			"currencyToggle": "VWh0dG_currencyToggle",
+			"subscriptionGrid": "VWh0dG_subscriptionGrid",
 			"pricingToggle": "VWh0dG_pricingToggle",
+			"chartLegendBar": "VWh0dG_chartLegendBar",
+			"balanceDaysLow": "VWh0dG_balanceDaysLow",
 			"modelTable": "VWh0dG_modelTable",
-			"kpiTile": "VWh0dG_kpiTile",
-			"budget": "VWh0dG_budget",
+			"dashboardBody": "VWh0dG_dashboardBody",
+			"roundsAxis": "VWh0dG_roundsAxis",
+			"dashboardSubtitle": "VWh0dG_dashboardSubtitle",
+			"trigger": "VWh0dG_trigger",
+			"chartBar": "VWh0dG_chartBar",
+			"chartLine": "VWh0dG_chartLine",
+			"roundsFlagMark": "VWh0dG_roundsFlagMark",
+			"kpiGrid": "VWh0dG_kpiGrid",
+			"modelTableScroll": "VWh0dG_modelTableScroll",
+			"bandTagOff": "VWh0dG_bandTagOff",
+			"closeButton": "VWh0dG_closeButton",
+			"headTitleRow": "VWh0dG_headTitleRow",
+			"chartWrap": "VWh0dG_chartWrap",
+			"chartGrid": "VWh0dG_chartGrid",
+			"rateBadgeBuiltin": "VWh0dG_rateBadgeBuiltin",
+			"uncataloguedTag": "VWh0dG_uncataloguedTag",
+			"subscriptionPct": "VWh0dG_subscriptionPct",
 			"hero": "VWh0dG_hero",
-			"subscriptionStatus": "VWh0dG_subscriptionStatus",
-			"dashboardRight": "VWh0dG_dashboardRight",
-			"kpiGreen": "VWh0dG_kpiGreen",
+			"providerGroupBalanceLabel": "VWh0dG_providerGroupBalanceLabel",
+			"heroMeta": "VWh0dG_heroMeta",
+			"balanceDays": "VWh0dG_balanceDays",
 			"emptyRow": "VWh0dG_emptyRow",
+			"subscriptionWindowLabel": "VWh0dG_subscriptionWindowLabel",
+			"subscriptionTrack": "VWh0dG_subscriptionTrack",
+			"panel": "VWh0dG_panel",
 			"heatmapLegend": "VWh0dG_heatmapLegend",
-			"chartAxisLabel": "VWh0dG_chartAxisLabel",
-			"providerGroupBalanceLabel": "VWh0dG_providerGroupBalanceLabel",
-			"budgetValue": "VWh0dG_budgetValue",
-			"deltaDown": "VWh0dG_deltaDown",
-			"currencyButton": "VWh0dG_currencyButton",
-			"pricingChevron": "VWh0dG_pricingChevron",
-			"rangeToggle": "VWh0dG_rangeToggle",
-			"budgetLabel": "VWh0dG_budgetLabel",
-			"budgetOverPulse": "VWh0dG_budgetOverPulse",
-			"pricingChevronOpen": "VWh0dG_pricingChevronOpen",
-			"heatmapFooter": "VWh0dG_heatmapFooter",
-			"triggerMonth": "VWh0dG_triggerMonth",
-			"heroMain": "VWh0dG_heroMain",
+			"heroSide": "VWh0dG_heroSide",
+			"roundsBarLabel": "VWh0dG_roundsBarLabel",
+			"budgetFillOver": "VWh0dG_budgetFillOver",
 			"budgetInputWrap": "VWh0dG_budgetInputWrap",
-			"modelProvider": "VWh0dG_modelProvider",
-			"dashboardTitle": "VWh0dG_dashboardTitle",
-			"kpiDetail": "VWh0dG_kpiDetail",
-			"chartTooltipRow": "VWh0dG_chartTooltipRow",
-			"currencyButtonActive": "VWh0dG_currencyButtonActive",
-			"closeButton": "VWh0dG_closeButton",
-			"deltaUp": "VWh0dG_deltaUp",
-			"chartTooltip": "VWh0dG_chartTooltip",
-			"subscriptionHead": "VWh0dG_subscriptionHead",
-			"roundsBarWrap": "VWh0dG_roundsBarWrap",
-			"costCol": "VWh0dG_costCol",
-			"healthDot": "VWh0dG_healthDot",
-			"headTitleRow": "VWh0dG_headTitleRow",
-			"roundsBarCol": "VWh0dG_roundsBarCol",
-			"healthBadgeBad": "VWh0dG_healthBadgeBad",
-			"chartEmpty": "VWh0dG_chartEmpty",
+			"triggerMonth": "VWh0dG_triggerMonth",
+			"rateBadgeLive": "VWh0dG_rateBadgeLive",
+			"heatmapHover": "VWh0dG_heatmapHover",
+			"healthBadgeOk": "VWh0dG_healthBadgeOk",
+			"healthBad": "VWh0dG_healthBad",
+			"bandTag": "VWh0dG_bandTag",
 			"heatmapGrid": "VWh0dG_heatmapGrid",
-			"subscriptionGrid": "VWh0dG_subscriptionGrid",
-			"subscriptionWindow": "VWh0dG_subscriptionWindow",
 			"chartLegend": "VWh0dG_chartLegend",
-			"subscriptionFill": "VWh0dG_subscriptionFill",
-			"panelTitle": "VWh0dG_panelTitle",
-			"roundsBarLabel": "VWh0dG_roundsBarLabel",
-			"heatmapCell": "VWh0dG_heatmapCell",
-			"heroLabel": "VWh0dG_heroLabel",
-			"heroValue": "VWh0dG_heroValue",
-			"heroSideItem": "VWh0dG_heroSideItem",
 			"modelDot": "VWh0dG_modelDot",
-			"providerGroupMeta": "VWh0dG_providerGroupMeta",
-			"healthBadgeOk": "VWh0dG_healthBadgeOk",
-			"triggerIcon": "VWh0dG_triggerIcon",
-			"healthBadge": "VWh0dG_healthBadge",
-			"budgetHead": "VWh0dG_budgetHead",
-			"balanceCell": "VWh0dG_balanceCell",
-			"heroSide": "VWh0dG_heroSide",
-			"currencyToggle": "VWh0dG_currencyToggle",
-			"railButton": "VWh0dG_railButton",
-			"roundsEmpty": "VWh0dG_roundsEmpty",
-			"heatmap": "VWh0dG_heatmap",
-			"subscriptionWindowLabel": "VWh0dG_subscriptionWindowLabel",
-			"chartTooltipSwatch": "VWh0dG_chartTooltipSwatch",
-			"chartBar": "VWh0dG_chartBar",
-			"subscriptionCard": "VWh0dG_subscriptionCard",
-			"heroSideLabel": "VWh0dG_heroSideLabel",
-			"modelTableScroll": "VWh0dG_modelTableScroll",
-			"trigger": "VWh0dG_trigger",
-			"chartTooltipDate": "VWh0dG_chartTooltipDate",
-			"bandPrice": "VWh0dG_bandPrice",
-			"trendPanel": "VWh0dG_trendPanel",
-			"panel": "VWh0dG_panel",
-			"providerGroupList": "VWh0dG_providerGroupList",
-			"roundsBars": "VWh0dG_roundsBars",
-			"dashboardSubtitle": "VWh0dG_dashboardSubtitle",
-			"healthIdle": "VWh0dG_healthIdle",
-			"roundsAxis": "VWh0dG_roundsAxis",
 			"budgetControls": "VWh0dG_budgetControls",
-			"chartLine": "VWh0dG_chartLine",
-			"balanceDaysLow": "VWh0dG_balanceDaysLow",
-			"providerGroupBadge": "VWh0dG_providerGroupBadge",
-			"heroSideValue": "VWh0dG_heroSideValue",
-			"pricingToggleText": "VWh0dG_pricingToggleText",
 			"panelHint": "VWh0dG_panelHint",
-			"chartWrap": "VWh0dG_chartWrap",
-			"bandTag": "VWh0dG_bandTag",
-			"triggerDivider": "VWh0dG_triggerDivider",
-			"heatmapHover": "VWh0dG_heatmapHover",
+			"dashboard": "VWh0dG_dashboard",
+			"currencyButtonActive": "VWh0dG_currencyButtonActive",
+			"tableScroll": "VWh0dG_tableScroll",
+			"bandPriceOff": "VWh0dG_bandPriceOff",
+			"pricingToggleText": "VWh0dG_pricingToggleText",
+			"modelCell": "VWh0dG_modelCell",
+			"pricingChevronOpen": "VWh0dG_pricingChevronOpen",
+			"providerGroupBalance": "VWh0dG_providerGroupBalance",
+			"roundsBars": "VWh0dG_roundsBars",
+			"heroSideLabel": "VWh0dG_heroSideLabel",
+			"roundsEmpty": "VWh0dG_roundsEmpty",
+			"deltaDown": "VWh0dG_deltaDown",
+			"subscriptionFill": "VWh0dG_subscriptionFill",
+			"rangeToggle": "VWh0dG_rangeToggle",
+			"chartCrosshair": "VWh0dG_chartCrosshair",
+			"chartTooltipRow": "VWh0dG_chartTooltipRow",
+			"numCol": "VWh0dG_numCol",
 			"kpiValue": "VWh0dG_kpiValue",
-			"budgetUnit": "VWh0dG_budgetUnit",
-			"chartLegendBar": "VWh0dG_chartLegendBar",
-			"switch": "VWh0dG_switch",
-			"modelName": "VWh0dG_modelName",
-			"chartStack": "VWh0dG_chartStack",
+			"chartTooltipDate": "VWh0dG_chartTooltipDate",
+			"triggerAmountSub": "VWh0dG_triggerAmountSub",
+			"providerGroupMeta": "VWh0dG_providerGroupMeta",
+			"triggerAmount": "VWh0dG_triggerAmount",
+			"dashboardModal": "VWh0dG_dashboardModal",
+			"kpiDetail": "VWh0dG_kpiDetail",
+			"kpiTile": "VWh0dG_kpiTile",
+			"subscriptionStatus": "VWh0dG_subscriptionStatus",
+			"budgetOverPulse": "VWh0dG_budgetOverPulse",
+			"subscriptionName": "VWh0dG_subscriptionName",
 			"roundsBar": "VWh0dG_roundsBar",
-			"budgetFill": "VWh0dG_budgetFill",
-			"roundsFlagMark": "VWh0dG_roundsFlagMark",
-			"dashboard": "VWh0dG_dashboard",
-			"budgetInput": "VWh0dG_budgetInput",
+			"budgetTrack": "VWh0dG_budgetTrack",
+			"switch": "VWh0dG_switch",
+			"roundsBarCol": "VWh0dG_roundsBarCol",
+			"chartLegendLine": "VWh0dG_chartLegendLine",
+			"healthIdle": "VWh0dG_healthIdle",
+			"deltaUp": "VWh0dG_deltaUp",
+			"panelHead": "VWh0dG_panelHead",
+			"dashboardRight": "VWh0dG_dashboardRight",
+			"providerGroupBadge": "VWh0dG_providerGroupBadge",
+			"pricingTable": "VWh0dG_pricingTable",
+			"triggerMeta": "VWh0dG_triggerMeta",
+			"chartAxisLabel": "VWh0dG_chartAxisLabel",
+			"rounds": "VWh0dG_rounds",
 			"na": "VWh0dG_na",
-			"uncataloguedTag": "VWh0dG_uncataloguedTag",
-			"subscriptionPct": "VWh0dG_subscriptionPct",
-			"providerGroupTitle": "VWh0dG_providerGroupTitle",
-			"dashboardModal": "VWh0dG_dashboardModal",
-			"dashboardBody": "VWh0dG_dashboardBody",
-			"heroMeta": "VWh0dG_heroMeta",
-			"triggerToday": "VWh0dG_triggerToday",
+			"heroValue": "VWh0dG_heroValue",
+			"chartDot": "VWh0dG_chartDot",
+			"healthBadge": "VWh0dG_healthBadge",
+			"rangeButton": "VWh0dG_rangeButton",
+			"heatmapCellEmpty": "VWh0dG_heatmapCellEmpty",
+			"heatmapFooter": "VWh0dG_heatmapFooter",
+			"providerGroupHead": "VWh0dG_providerGroupHead",
+			"chartTooltip": "VWh0dG_chartTooltip",
+			"healthBadgeBad": "VWh0dG_healthBadgeBad",
 			"delta": "VWh0dG_delta",
-			"planTag": "VWh0dG_planTag",
 			"providerGroup": "VWh0dG_providerGroup",
-			"modelCell": "VWh0dG_modelCell",
-			"tableScroll": "VWh0dG_tableScroll",
-			"subscriptionReset": "VWh0dG_subscriptionReset",
-			"providerGroupHead": "VWh0dG_providerGroupHead",
-			"chartDot": "VWh0dG_chartDot",
-			"budgetTrack": "VWh0dG_budgetTrack",
-			"kpiGrid": "VWh0dG_kpiGrid",
-			"rateBadge": "VWh0dG_rateBadge",
-			"chartGrid": "VWh0dG_chartGrid",
-			"providerGroupName": "VWh0dG_providerGroupName",
-			"roundsFlagBadge": "VWh0dG_roundsFlagBadge",
-			"healthBad": "VWh0dG_healthBad",
-			"roundsBarFlagged": "VWh0dG_roundsBarFlagged",
+			"heatmap": "VWh0dG_heatmap",
+			"triggerIcon": "VWh0dG_triggerIcon",
+			"dashboardHead": "VWh0dG_dashboardHead",
+			"heroSideValue": "VWh0dG_heroSideValue",
+			"heroMain": "VWh0dG_heroMain",
+			"budgetValue": "VWh0dG_budgetValue",
+			"healthDot": "VWh0dG_healthDot",
+			"subscriptionCard": "VWh0dG_subscriptionCard",
+			"budgetHead": "VWh0dG_budgetHead",
+			"planTag": "VWh0dG_planTag",
+			"heroLabel": "VWh0dG_heroLabel",
+			"budget": "VWh0dG_budget",
+			"kpiLabel": "VWh0dG_kpiLabel",
 			"switchKnob": "VWh0dG_switchKnob",
-			"rateBadgeLive": "VWh0dG_rateBadgeLive",
-			"subscriptionName": "VWh0dG_subscriptionName"
+			"subscriptionPlan": "VWh0dG_subscriptionPlan",
+			"flatTag": "VWh0dG_flatTag",
+			"providerGroupName": "VWh0dG_providerGroupName",
+			"providerGroupList": "VWh0dG_providerGroupList"
 		};
 		//#endregion
 		//#region src/client/pricing.ts

package/lib/index.js CHANGED Viewed

@@ -927,15 +927,25 @@ function createUsageAggregator(persistence, options = {}) {
 * Account-balance queries for the billing dashboard.
 *
 * Only providers with a public balance endpoint can report one. Today that is
-* DeepSeek (`GET https://api.deepseek.com/user/balance`, Bearer 鉴权); the
-* other mainstream providers (OpenAI, 智谱, 通义, Kimi…) expose no standard
-* balance API, so their rows in the model table show an unavailable state.
-* The lookup map below is the extension point for future providers.
+* DeepSeek (`GET https://api.deepseek.com/user/balance`) and Moonshot/Kimi
+* (`GET https://api.moonshot.cn/v1/users/me/balance`), both Bearer 鉴权 with a
+* documented JSON shape; the other mainstream providers expose no standard
+* balance API (or require a non-Bearer auth flow), so their rows in the model
+* table show an unavailable state. The lookup map below is the extension point
+* for future providers.
+*
+* API keys are read from the `llm-pi-ai` settings namespace (`providers.<id>.apiKeyEnv`),
+* the same source the subscription adapter uses, so a deployment configures a
+* provider's key once and every surface reuses it.
 */
 /** Abort a balance fetch when the upstream hangs beyond this budget. */
 const FETCH_TIMEOUT_MS$1 = 8e3;
 /** DeepSeek 官方余额接口（官方文档 api-docs.deepseek.com/api/get-user-balance）。 */
 const DEEPSEEK_BALANCE_URL = "https://api.deepseek.com/user/balance";
+/** Moonshot/Kimi 官方余额接口（platform.kimi.com/docs/api/balance）。 */
+const MOONSHOT_BALANCE_URL = "https://api.moonshot.cn/v1/users/me/balance";
+/** 阶跃星辰 StepFun 官方账户信息接口（platform.stepfun.com/docs/api-reference/accounts/get）。 */
+const STEPFUN_BALANCE_URL = "https://api.stepfun.com/v1/accounts";
 /** 数字归一化：接口返回的余额是字符串（如 `"110.00"`），统一转 number。 */
 function toNumber(value) {
 	if (typeof value === "number" && Number.isFinite(value)) return value;
@@ -945,22 +955,28 @@ function toNumber(value) {
 	}
 }
 /**
-* Query the DeepSeek account balance through the configured credential.
+* Fetch a Bearer-protected balance endpoint and normalize the HTTP outcome into
+* a shared {@link ProviderBalance} row. Each provider supplies its own
+* response parser for the success body.
 * @param ctx - host context carrying the credentials seam.
-* @param apiKeyEnv - credential reference resolving the DeepSeek API key.
+* @param url - the balance endpoint.
+* @param apiKeyEnv - credential reference resolving the API key.
+* @param provider - the provider id (matches the model-table vendor display name).
+* @param displayName - human-readable provider name.
+* @param parse - maps a success JSON body to the balance row fields.
 * @returns the balance row, or an error row when the key/endpoint misbehaves.
 */
-async function queryDeepSeek(ctx, apiKeyEnv) {
+async function queryBearerBalance(ctx, url, apiKeyEnv, provider, displayName, parse) {
 	const hit = await ctx.credentials.resolve(credentialRef(apiKeyEnv));
 	if (hit === void 0) return {
-		provider: "deepseek",
-		displayName: "DeepSeek",
+		provider,
+		displayName,
 		error: "unconfigured"
 	};
 	const controller = new AbortController();
 	const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS$1);
 	try {
-		const response = await fetch(DEEPSEEK_BALANCE_URL, {
+		const response = await fetch(url, {
 			headers: {
 				accept: "application/json",
 				authorization: `Bearer ${hit.value}`
@@ -968,22 +984,41 @@ async function queryDeepSeek(ctx, apiKeyEnv) {
 			signal: controller.signal
 		});
 		if (response.status === 401 || response.status === 403) return {
-			provider: "deepseek",
-			displayName: "DeepSeek",
+			provider,
+			displayName,
 			error: "unauthorized"
 		};
 		if (!response.ok) return {
-			provider: "deepseek",
-			displayName: "DeepSeek",
+			provider,
+			displayName,
+			error: "unreachable"
+		};
+		return parse(await response.json());
+	} catch {
+		return {
+			provider,
+			displayName,
 			error: "unreachable"
 		};
-		const data = await response.json();
-		const info = (Array.isArray(data.balance_infos) ? data.balance_infos : [])[0];
+	} finally {
+		clearTimeout(timer);
+	}
+}
+/**
+* Query the DeepSeek account balance.
+* @param ctx - host context carrying the credentials seam.
+* @param apiKeyEnv - credential reference resolving the DeepSeek API key.
+* @returns the balance row, or an error row when the key/endpoint misbehaves.
+*/
+function queryDeepSeek(ctx, apiKeyEnv) {
+	return queryBearerBalance(ctx, DEEPSEEK_BALANCE_URL, apiKeyEnv, "deepseek", "DeepSeek", (data) => {
+		const doc = data;
+		const info = (Array.isArray(doc.balance_infos) ? doc.balance_infos : [])[0];
 		const currency = typeof info?.currency === "string" ? info.currency : void 0;
 		const totalBalance = toNumber(info?.total_balance);
 		const grantedBalance = toNumber(info?.granted_balance);
 		const toppedUpBalance = toNumber(info?.topped_up_balance);
-		const isAvailable = typeof data.is_available === "boolean" ? data.is_available : void 0;
+		const isAvailable = typeof doc.is_available === "boolean" ? doc.is_available : void 0;
 		return {
 			provider: "deepseek",
 			displayName: "DeepSeek",
@@ -993,28 +1028,87 @@ async function queryDeepSeek(ctx, apiKeyEnv) {
 			...toppedUpBalance !== void 0 ? { toppedUpBalance } : {},
 			...isAvailable !== void 0 ? { isAvailable } : {}
 		};
-	} catch {
+	});
+}
+/**
+* Query the Moonshot/Kimi account balance.
+* @param ctx - host context carrying the credentials seam.
+* @param apiKeyEnv - credential reference resolving the Moonshot API key.
+* @returns the balance row, or an error row when the key/endpoint misbehaves.
+*/
+function queryMoonshot(ctx, apiKeyEnv) {
+	return queryBearerBalance(ctx, MOONSHOT_BALANCE_URL, apiKeyEnv, "月之暗面", "月之暗面", (data) => {
+		const doc = data;
+		const totalBalance = toNumber(doc.data?.available_balance);
+		const grantedBalance = toNumber(doc.data?.voucher_balance);
+		const toppedUpBalance = toNumber(doc.data?.cash_balance);
 		return {
-			provider: "deepseek",
-			displayName: "DeepSeek",
-			error: "unreachable"
+			provider: "月之暗面",
+			displayName: "月之暗面",
+			currency: "CNY",
+			...totalBalance !== void 0 ? { totalBalance } : {},
+			...grantedBalance !== void 0 ? { grantedBalance } : {},
+			...toppedUpBalance !== void 0 ? { toppedUpBalance } : {}
 		};
-	} finally {
-		clearTimeout(timer);
-	}
+	});
 }
-const QUERIERS = [{
-	provider: "deepseek",
-	querier: queryDeepSeek
-}];
 /**
-* Query every configured provider's account balance.
+* Query the StepFun (阶跃星辰) account balance.
+* @param ctx - host context carrying the credentials seam.
+* @param apiKeyEnv - credential reference resolving the StepFun API key.
+* @returns the balance row, or an error row when the key/endpoint misbehaves.
+*/
+function queryStepFun(ctx, apiKeyEnv) {
+	return queryBearerBalance(ctx, STEPFUN_BALANCE_URL, apiKeyEnv, "阶跃星辰", "阶跃星辰", (data) => {
+		const doc = data;
+		const totalBalance = toNumber(doc.balance);
+		const toppedUpBalance = toNumber(doc.total_cash_balance);
+		const grantedBalance = toNumber(doc.total_voucher_balance);
+		return {
+			provider: "阶跃星辰",
+			displayName: "阶跃星辰",
+			currency: "CNY",
+			...totalBalance !== void 0 ? { totalBalance } : {},
+			...toppedUpBalance !== void 0 ? { toppedUpBalance } : {},
+			...grantedBalance !== void 0 ? { grantedBalance } : {}
+		};
+	});
+}
+const QUERIERS = [
+	{
+		route: "deepseek",
+		displayName: "deepseek",
+		querier: queryDeepSeek
+	},
+	{
+		route: "moonshot",
+		displayName: "月之暗面",
+		querier: queryMoonshot
+	},
+	{
+		route: "stepfun",
+		displayName: "阶跃星辰",
+		querier: queryStepFun
+	}
+];
+/**
+* Query every configured provider's account balance. A provider is queried only
+* when its llm-pi-ai route has an `apiKeyEnv`; absent routes answer
+* `unconfigured` so the dashboard shows a stable state instead of dropping the row.
 * @param ctx - host context carrying the credentials seam.
-* @param balanceApiKeyEnv - credential reference for the DeepSeek key.
+* @param providers - the llm-pi-ai providers dict (`<route> → { apiKeyEnv? }`).
 * @returns the balance rows (one per provider).
 */
-async function queryBalances(ctx, balanceApiKeyEnv) {
-	return await Promise.all(QUERIERS.map(({ querier }) => querier(ctx, balanceApiKeyEnv)));
+async function queryBalances(ctx, providers) {
+	return await Promise.all(QUERIERS.map(({ route, querier, displayName }) => {
+		const env = providers[route]?.apiKeyEnv;
+		if (typeof env !== "string" || env === "") return Promise.resolve({
+			provider: displayName,
+			displayName,
+			error: "unconfigured"
+		});
+		return querier(ctx, env);
+	}));
 }
 //#endregion
 //#region lib/types/pricing-fetch.js
@@ -1609,6 +1703,19 @@ const SUBSCRIPTION_KEY_SOURCES = [
 	}
 ];
 /**
+* 读取 llm-pi-ai 设置的 `providers` 字典（`<route> → { apiKeyEnv? }`）。
+* 余额查询复用同一份来源：部署为某个 provider 配一次 key，多个 surface 共享。
+* @param settings - the settings service (reads the llm-pi-ai namespace).
+* @returns the providers dict; empty when the namespace is unreadable.
+*/
+async function readPiAiProviders(settings) {
+	try {
+		return (settings.describe({ redactSecrets: true }).find((descriptor) => descriptor.ns === "llm-pi-ai")?.value)?.providers ?? {};
+	} catch {
+		return {};
+	}
+}
+/**
 * 解析订阅适配器需要的 API Key：从 llm-pi-ai 设置的 `providers.<id>.apiKeyEnv`
 * 读引用（如 kimi-coding → KIMI_CODING_API_KEY），再经凭据 seam 解析成实际值。
 * 同时识别出用户配置了 key 的订阅套餐（供面板只显示已识别的）。
@@ -1680,7 +1787,9 @@ function apply(ctx, config = {}) {
 		path: "/api/billing/balance",
 		handler: async (_req, res) => {
 			res.writeHead(200, { "content-type": "application/json; charset=utf-8" });
-			const balances = await queryBalances(ctx, config.balanceApiKeyEnv ?? DEFAULT_BALANCE_API_KEY_ENV);
+			const providers = { ...await readPiAiProviders(ctx.settings) };
+			if (providers["deepseek"] === void 0) providers["deepseek"] = { apiKeyEnv: config.balanceApiKeyEnv ?? DEFAULT_BALANCE_API_KEY_ENV };
+			const balances = await queryBalances(ctx, providers);
 			res.end(JSON.stringify({ balances }));
 		}
 	}), "usage-billing: balance route");

package/lib/types/balance.d.ts CHANGED Viewed

@@ -2,18 +2,28 @@
  * Account-balance queries for the billing dashboard.
  *
  * Only providers with a public balance endpoint can report one. Today that is
- * DeepSeek (`GET https://api.deepseek.com/user/balance`, Bearer 鉴权); the
- * other mainstream providers (OpenAI, 智谱, 通义, Kimi…) expose no standard
- * balance API, so their rows in the model table show an unavailable state.
- * The lookup map below is the extension point for future providers.
+ * DeepSeek (`GET https://api.deepseek.com/user/balance`) and Moonshot/Kimi
+ * (`GET https://api.moonshot.cn/v1/users/me/balance`), both Bearer 鉴权 with a
+ * documented JSON shape; the other mainstream providers expose no standard
+ * balance API (or require a non-Bearer auth flow), so their rows in the model
+ * table show an unavailable state. The lookup map below is the extension point
+ * for future providers.
+ *
+ * API keys are read from the `llm-pi-ai` settings namespace (`providers.<id>.apiKeyEnv`),
+ * the same source the subscription adapter uses, so a deployment configures a
+ * provider's key once and every surface reuses it.
  */
 import type { Context } from '@deepseek-ai/cordis';
 import type { ProviderBalance } from './pricing-shared.ts';
 /**
- * Query every configured provider's account balance.
+ * Query every configured provider's account balance. A provider is queried only
+ * when its llm-pi-ai route has an `apiKeyEnv`; absent routes answer
+ * `unconfigured` so the dashboard shows a stable state instead of dropping the row.
  * @param ctx - host context carrying the credentials seam.
- * @param balanceApiKeyEnv - credential reference for the DeepSeek key.
+ * @param providers - the llm-pi-ai providers dict (`<route> → { apiKeyEnv? }`).
  * @returns the balance rows (one per provider).
  */
-export declare function queryBalances(ctx: Context, balanceApiKeyEnv: string): Promise<readonly ProviderBalance[]>;
+export declare function queryBalances(ctx: Context, providers: Readonly<Record<string, {
+    apiKeyEnv?: string;
+}>>): Promise<readonly ProviderBalance[]>;
 //# sourceMappingURL=balance.d.ts.map

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@kenz1117/dsh-ui-usage-billing",
   "description": "Usage billing dashboard for DeepSeek Harness: sidebar cost metrics plus a full dashboard modal, priced from a current multi-provider catalog with real usage aggregated from session logs.",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "publishConfig": {
     "access": "public"
   },