@deepseek-ai/dsh-api-cost

🔑 配置 API Key（可选）

余额查询需要 DeepSeek API Key，二选一：

## 📖 使用指南

- **侧边栏徽章**：左下角两行「余额 ¥X / 花费 ¥Y」；生成中会在花费后面显示 `+¥Z` 实时增量。
- **悬停徽章**：弹出完整详情——余额、本对话 / 今日 / 本月、Token 详情（分模型 + 总计）、
  7 日趋势（双模型，金额/Token 切换）、最近调用、外观模式与账单管理。
- **点击徽章**：直接跳转到设置页「用量与消耗」。
- **设置页「用量与消耗」**（也可点侧边栏齿轮进入）：完整仪表盘——余额、今日/本月费用、
  各模型今日消耗 Token 与消耗金额、今日 Token 详情、7 日趋势、外观模式、账单管理。
- **CSV 对账**：点「核对官方 CSV」选官方导出的 `amount-*.csv`。本地金额会先按 CSV 里的
  官方单价重算，再与官方金额对比（避免本地价表与扣费单价不同造成的假偏差），并同时展示
  官方/本地 Token 与请求数。「按官方价格校准」可把官方单价写入本地价表。
- **导出 / 重置**：一键导出本地账本 CSV；重置会清空全部累计记录（有确认提示）。

---

## ⚙️ 配置

配置写在 profile 用户层 `$DSH_HOME/profiles/web/cordis.patch.yml`，按行 id 覆盖、与内置默认值**合并**，只写要改的字段即可：

```yaml
- id: api-cost
  config:
    # 覆盖/新增模型价格（¥/百万 token：input=缓存未命中 / cacheRead=缓存命中 / cacheWrite / output）
    prices:
      my-model:
        input: 3.0
        cacheRead: 0.1
        cacheWrite: 3.0
        output: 9.0

    # 峰谷计费（默认关闭；北京时间高峰 9:00–12:00、14:00–18:00，谷时段半价）
    peak:
      enabled: true
      peakHours: [[9, 12], [14, 18]]
      peakMultiplier: 1.0
      offpeakMultiplier: 0.5

    # 月度预算告警（0 = 关闭；超限可选 webhook 通知一次）
    budget:
      monthlyLimit: 50
      webhookUrl: 'https://example.com/hook'

    # 余额校准（expected = initialBalance − 本地累计；偏差超阈值提示）
    calibration:
      enabled: true
      initialBalance: 100
      deviationThreshold: 0.05

内置默认价表（¥/百万 token）

模型	input（缓存未命中）	cacheRead（缓存命中）	cacheWrite	output
deepseek-v4-flash	3.0	0.10	3.0	9.0
deepseek-v4-pro	9.0	0.30	9.0	27.0

官方定价可能随时调整：实际扣费单价以 官方定价页 为准；对账时会自动按你导入 CSV 里的官方单价重算，不依赖这张表。

---