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

package/README.md

@@ -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 用官方余额 API、月之暗面（Kimi）用 Moonshot 余额接口**实时查询**；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,16 @@ 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
     }
   ]
 }
@@ -200,7 +206,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 +242,7 @@ npm publish --access public
 
 ## Known Limitations and Deferred Work
 
-- **余额查询仅接入 DeepSeek**：其他厂商一律显示「未配置」；扩展点在 `src/balance.ts`（按厂商余额 API 增加查询器）。
+- **余额查询已接入 DeepSeek / 月之暗面（Kimi）**：其他厂商因无公开余额 API 或需非 Bearer 鉴权，暂显示「未配置」；扩展点在 `src/balance.ts`（按厂商余额 API 增加查询器）。
 - **超支通知依赖浏览器 Notification**：权限被拒绝或平台不支持时只有界面红色脉冲兜底，没有宿主级通知通道；通知上限为每天一次。
 - **会话明细不可跳转**：点击会话行不会打开对应会话（跨插件导航需要宿主会话选择通道）；会话数封顶 100 行、面板只显示前 20 行。
 - **费用为目录价估算**：讯飞 / 商汤 / 小米等未公布按量单价的模型使用估算价（特性表脚注 ¹），正式定价以厂商账单为准。

package/lib/client.js

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

package/lib/index.js

@@ -927,15 +927,23 @@ 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";
 /** 数字归一化：接口返回的余额是字符串（如 `"110.00"`），统一转 number。 */
 function toNumber(value) {
 	if (typeof value === "number" && Number.isFinite(value)) return value;
@@ -945,22 +953,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 +982,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"
 		};
-		const data = await response.json();
-		const info = (Array.isArray(data.balance_infos) ? data.balance_infos : [])[0];
+		return parse(await response.json());
+	} catch {
+		return {
+			provider,
+			displayName,
+			error: "unreachable"
+		};
+	} 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 +1026,57 @@ 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",
+	route: "deepseek",
+	displayName: "deepseek",
 	querier: queryDeepSeek
+}, {
+	route: "moonshot",
+	displayName: "月之暗面",
+	querier: queryMoonshot
 }];
 /**
-* 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).
 */
-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 +1671,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 +1755,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

@@ -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

@@ -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.1",
   "publishConfig": {
     "access": "public"
   },