@kenz1117/dsh-ui-usage-billing 0.6.0 → 0.8.0

package/README.md

@@ -12,7 +12,11 @@ DeepSeek Harness 计费仪表盘插件。从持久化会话日志实时聚合模
 
 - **侧边栏入口**：设置按钮上方的玻璃拟态渐变触发卡，显示**当月费用 + 今日费用**，hover 光晕上浮；折叠栏自动切换为渐变徽章图标。
 - **计费仪表盘（分区 Tab）**：弹窗按 **概览 / 趋势 / 明细 / 统计 / 费率** 五个分区组织——概览（Hero 本月大数字 + 本年 / 今日环比 / **本月预计** + 预算条 + KPI×4 + 用量热力图）、趋势（每日费用趋势图 7/30 天 + 每轮费用）、明细（厂商计费与订阅）、统计（工作区 + 会话明细）、费率（模型单价表）。渐变描边卡片 + 毛玻璃遮罩 + 进入动画，全部用设计令牌派生渐变色，深色/浅色主题自适应。
-- **即时代费用条**：会话输入框下方常驻一行「本轮 ¥x · 会话 ¥y」，30 秒轮询刷新，无需打开仪表盘。
+- **即时代费用条**：会话输入框下方常驻一行「本轮 ¥x · 会话 ¥y」，30 秒轮询刷新；同时显示**峰谷当前档位与切换倒计时**（峰时 / 平价 + 距下次切档时间），以及订阅套餐低额度预警 chips（剩余 ≤20% 时浮现，≤10% 变红），无需打开仪表盘。
+- **峰/谷切换提醒**：距进入下一计费档（北京时间高峰 9-12 / 14-18）不足 2 分钟时系统通知一次（同一切换点只提醒一次，`lastTierSwitchAt` 持久化），文案区分「即将进峰时 ×2 可稍等」/「即将进平价 价格减半」。
+- **价格目录抓取（models.dev）**：费率表不再只靠内置目录——启动时抓取 models.dev 公开目录（pi-ai 预制提供方的上游数据源，USD / 1M tokens），**所有有价模型都纳入**费率表，探测到的系统预制模型据此对标定价。定价失败自动降级内置目录。
+- **探活模型对标**：费率表按宿主 `llm.models` 探活到的「系统设置里实际配置/预制的模型」补齐——有价的显示价格（内置目录 / models.dev），无价的标注「未收录」，不参与计价（不误估）。
+- **自定义 Provider 余额**：除内置 DeepSeek / Kimi / 阶跃星辰外，可经 config `customBalances` 配置任意 HTTP 端点查询余额，`extract` 规则支持常量 / 点路径 / add-subtract / divide（适配 NewApi、LiteLLM 等 quota 端点），请求头 `{{ENV_NAME}}` 占位符经凭据 seam 解析，独立厂商组展示。
 - **月度预算**：仪表盘内置预算条——开关控制显隐、金额可直接编辑（已用 / 总额 / 百分比进度，≥80% 转琥珀、超支转红并脉冲提示），偏好持久化在浏览器本地；宿主配置 `monthlyBudget` 可作为默认金额。
 - **分档提醒**：跨过预算 50% / 80% / 100% 时各弹一次系统通知（每档每天最多一次，一次跨多档只发最高档）；通知不可用时进度条分档变色兜底。余额不足告警独立：任一厂商余额（折算人民币）低于阈值时每天提醒一次，阈值经宿主配置 `lowBalanceThreshold` 下发（默认 50 元）。
 - **会话明细**：统计 Tab 内按费用倒序列出每个会话的花费（标题 / 项目 / 调用数 / 费用 / 最后活跃），直接回答「钱花在哪」。
@@ -27,7 +31,7 @@ DeepSeek Harness 计费仪表盘插件。从持久化会话日志实时聚合模
 - **更新时间**：模型计费明细表头显示最近一次统计的更新时间，精确到时分秒。
 - **北京时间统一**：统计聚合与仪表盘日期一律按北京时间归天，跨零点不漂移。
 - **精确时段计费**：每笔调用的费用按实际发生时刻（北京时间）精确判定高峰 / 低谷档，替代固定比例混合——凌晨调用不再被按高峰价估算。
-- **订阅套餐额度**：自动识别你在 dsh `llm-pi-ai` 设置里配置的订阅类 provider（kimi-coding、zai-coding-cn、opencode、qwen/xiaomi/火山 token-plan、百度/GLM 等 coding/agent plan），只显示识别到的套餐；有额度 API 的（Kimi / Z.ai / OpenCode Go）实时显示剩余百分比与重置时间，无公开额度接口的标注「额度接口未接入」。API Key 复用 `llm-pi-ai` 的 `apiKeyEnv` 引用经凭据 seam 解析，无需额外配置。面板默认展开，打开即见。
+- **订阅套餐额度**：自动识别你在 dsh `llm-pi-ai` 设置里配置的订阅类 provider（kimi-coding、zai-coding-cn、opencode、qwen/xiaomi/火山 token-plan、百度/GLM 等 coding/agent plan），只显示识别到的套餐；有额度 API 的（Kimi / Z.ai / OpenCode Go）实时显示剩余百分比与重置时间，无公开额度接口的标注「额度接口未接入」。进度条按**已用**比例填充（与预算条同语义）：已用 ≥80% 转琥珀、**用尽满格红 +「已用尽」**（窗口恒可见，不再因剩余 0% 消失）。面板默认展开，打开即见。
 - **厂商计费与订阅（按厂商聚合）**：模型计费明细与订阅套餐合并为**单一容器**，按厂商作为一级分组——同厂商的非订阅按量模型（显示实际费用）与订阅套餐（显示额度卡片）落在同一组，避免散乱；余额与健康圆点只在厂商组头部显示一次（**余额是厂商的余额**，不再随每行重复）。订阅 provider 通过内置别名归并到对应模型厂商（如 `kimi-coding` → 月之暗面），无模型厂商的跨厂商通道（如 opencode）按自身名独立成组。
 - **模型可用数按模型统计**：侧边栏入口右上角「N 模型可用」按**模型数量**统计（各厂商成功接入的模型之和），而非厂商数量，口径与文案一致。
 - **用量热力图**：当月日历热力图（本月 1 号到今天每天一格，周日开头 7 列），按日费用分 5 档色阶，悬停显示日期与金额。概览 Tab 常驻。
@@ -44,11 +48,15 @@ DeepSeek Harness 计费仪表盘插件。从持久化会话日志实时聚合模
 
 ## 截图
 
-![计费仪表盘（概览 Tab）](screenshots/dashboard1.png)
+![概览：本月费用 Hero、预算进度、KPI 与用量热力图](screenshots/1.png)
 
-![计费仪表盘（费率 Tab）](screenshots/dashboard2.png)
+![趋势：每日费用趋势、每轮费用与峰谷时段占比](screenshots/2.png)
 
-![侧边栏入口](screenshots/trigger.png)
+![明细：厂商计费与订阅（余额、套餐额度、模型用量）](screenshots/3.png)
+
+![统计：导出、费用构成、工作区与会话明细](screenshots/4.png)
+
+![费率：模型单价表（峰谷分时与实时汇率）](screenshots/5.png)
 
 ## 快速开始