@local/dsh-deepseek-usage-monitor

LIMITATIONS

Known limitations

**官方不提供（因此不实现、也不模拟）** - **用量统计 / 账单明细 / 按模型用量 API**：DeepSeek 公开 API 参考只有 Chat Completions、Responses、FIM、List Models、Get User Balance、Files、Search & Fetch，**没有** usage/billing 端点。插件不抓取控制台、不做模拟登录、不伪造数据；用量只能来自本地观测，账户级消费只能由余额差值推导。因此「按模型、按调用次数」的官方统计并不存在，相关指标一律标注 `harness-observed`。 **接口验证边界（诚实说明）** - `GET /user/balance`：字段与行为按官方文档核对，成功/失败/401/429 **由 Mock 覆盖**；开发环境没有可用 API Key，故**未对生产端点做成功调用**。 - `ctx.deepseekAccount.getBalance()`：**已在真实环境实测成功**（具体金额不在文档中复述）。 - `llm/stream` 的 `usage` chunk：**已在本机实测**，输入/输出/缓存读取均为真实返回值。 - 面板的**像素级外观未逐项验收**：已确认浏览器半加载、两个槽位注册成功、组件树在真实 Host 快照下无异常渲染；滚动、深色模式等需目视确认。 **其它** - 无 Cordis `Config` schema（原因见[配置](#配置)），Plugins 页面没有表单。 - 峰谷定价未排除中国法定节假日（会高估）。 - 单进程作用域：多实例 DSH 各自独立存储，无跨进程同步。 - 插件停用期间的调用不会补记。 - 自定义范围上限 366 天；任何聚合的分桶上限 400。 - 告警无桌面通知通道，默认落日志 / 面板 / 工具结果。 **后续方向** - 接入 DSH 统一通知接口，把 `monitor.subscribe()` 接到桌面通知。 - 若官方开放 usage/billing API，在 `lib/deepseek-api.js` 旁新增 provider，并把 `sources.usage.kind` 从 `official-unavailable` 切为 `official`。 - 价格表增加节假日日历；增量清理与压缩历史。