前言¶
DeepSeek Harness（DSH）采用插件化架构，允许开发者扩展功能。在 DSH 设置面板中直接查看 DeepSeek 平台的余额与用量，或管理 OpenCode Go 配额，通常需要打开浏览器或编写脚本。dsh-account-usage 插件在 DSH 的设置面板新增了「账户」页，提供一站式查看 DeepSeek 平台余额/用量与 OpenCode Go 配额的能力。该插件由 Ycet 维护，采用 MIT 许可证。
功能特性¶
- DeepSeek 平台概览：展示充值余额、赠送余额、累计消费金额、本月消费金额及本月 Tokens。
- 每日柱状图：提供消费金额与 Token 消耗的双图表，支持 SVG 渲染与鼠标悬停查看每日明细。
- 时间维度切换：支持今天、近 7 天、近 30 天、近 90 天、本月、上月，以及自定义时间区间。
- 按模型明细表：展示所选区间内各模型的请求次数、输入/缓存/输出 Tokens 与费用。
- OpenCode Go 配额：展示 5 小时滚动、每周、每月三个窗口的用量百分比、下次重置时间及限额参考。
- 自动刷新：页面挂载期间每 60 秒自动轮询最新数据。
- 双语言界面：支持完整的中英文切换。
安装与启用¶
安装前请确保已安装 DSH CLI。
- 执行以下命令安装插件：
dsh plugin --profile web add github:Ycet/dsh-account-usage
- 安装完成后，重启网页应用：
dsh web
- 打开设置面板，刷新页面，即可看到新增的「账户」页。
配置说明¶
DeepSeek 平台令牌¶
DeepSeek 平台用量接口为未公开的私有接口，需要你的平台登录令牌：
- 登录 https://platform.deepseek.com。
- 打开浏览器 DevTools → Console，执行：
JSON.parse(localStorage.getItem('userToken')).value
- 在插件「账户」页的令牌输入框粘贴并保存。令牌仅写入本机凭据库（
~/.dsh/.credentials.yaml的DEEPSEEK_PLATFORM_TOKEN字段），不发送至任何外部位置。
OpenCode Go Key¶
通常无需手动配置，插件会按以下顺序自动查找：
- DSH 凭据
OPENCODE_GO_API_KEY（通常在「设置 → 模型」中配置）。 - OpenCode 自身的
~/.local/share/opencode/auth.json（opencode-go条目，type 为api）。
使用说明¶
- 在设置面板「账户」页顶部切换 deepseek 或 opencode go 标签查看对应数据。
- DeepSeek 页：点击时间维度（今天、近 7 天等）或选择「自定义区间」后点击「应用」。柱状图支持鼠标悬停查看每日明细；模型明细表展示请求次数、Tokens 与费用。
- OpenCode Go 页：展示三个配额窗口的用量进度条、重置时间与限额参考。页面挂载期间每 60 秒自动刷新。点击「跳转」按钮可前往 opencode.ai，点击「刷新」按钮可手动更新数据。
- 点击「打开配置文件」按钮可直接定位本机 DSH 凭据文件。
注意事项¶
- 接口稳定性：DeepSeek 平台用量接口为私有接口，字段可能随平台升级变化。插件对响应做防御式解析，字段缺失时显示「—」而非报错。
- 字段估算：公开文档未包含「累计消费金额」和「API 请求次数」。插件通过命名启发式在概要响应中搜索累计消费（找不到显示「—」），并读取模型条目上的
count/requests/request_count/req_count/calls字段获取请求次数。 - 限额参考：OpenCode Go 的限额（\(12/\)30/$60）为套餐参考值，端点未返回限额。套餐调整时以 opencode.ai 页面为准。
- 网络访问：服务绑定
0.0.0.0时本插件路由对局域网可达（与 DSH 其他本地插件相同的既有限制，默认127.0.0.1无此问题）。 - 本地安全：令牌仅存储在本机凭据库，浏览器与网络请求均不携带它往返上游以外的任何位置。
