koishi-plugin-deepseek-usage

在 Koishi 中查询 DeepSeek 余额与花费统计（支持柱状 + 折线统计图）。

指令

• deepseek余额：查询余额
  • -r：输出原始 JSON
• deepseek统计 [days]：查询本月花费统计图（默认全月，最多 60 天）
  • days：只看最近 N 天
  • -t：仅输出文字（不发图）

配置

在 Koishi 控制台插件配置中填写：

| 字段 | 必填 | 说明 | |---|---:|---| | token | 是 | DeepSeek API Key（sk-...），用于查询余额 | | platformToken | 否 | 用于拉取平台“真实花费”。从浏览器打开 platform.deepseek.com（已登录）→ F12 → Application → Local Storage → userToken。如果你拿到的是 {\"value\":\"...\"} 这种 JSON，插件会自动取 value | | platformCookie | 否 | 可选辅助项。若 platformToken 偶发失效，可从浏览器 Network 任意请求的 Request Headers 复制 Cookie |

可选自定义：

| 字段 | 默认 | 说明 | |---|---|---| | commandName | deepseek余额 | 余额指令名 | | statsCommandName | deepseek统计 | 统计指令名 | | allowPrivate | true | 是否允许私聊使用指令 | | autoRecordInterval | 60 | 自动记录余额间隔（分钟），0 表示关闭（用于本地估算花费的 fallback 数据） | | replyTemplate |（内置）| 余额回复模板：支持 {currency} {total_balance} {granted_balance} {topped_up_balance} | | statsReplyTemplate |（内置）| 统计文字模板：支持 {year} {month} {total} {currency} {model_summary} | | chartTitleTemplate |（内置）| 统计图片标题模板：支持 {year} {month} {total} {currency} |

说明

• platformToken / platformCookie 属于敏感信息，不要发到群里或公开。