dsh-account-usage

dsh-account-usage

DeepSeek Harness（DSH）网页界面插件：在设置面板新增「账户」页，一站式查看 DeepSeek 平台余额/用量与 OpenCode Go 配额。

---

📑 目录

• 📸 界面预览
• ✨ 功能特性
• 🚀 快速开始
• ⚙️ 配置说明
• 📖 使用说明
• 🔧 工作原理
• 🧰 环境变量
• ⚠️ 已知限制
• 🛠️ 开发
• 🤝 贡献
• 📄 许可证

---

📸 界面预览

DeepSeek 平台页：余额概览、时间维度与自定义区间、每日消费/Token 柱状图、按模型明细表。

OpenCode Go 配额页：5 小时滚动 / 每周 / 每月三个窗口的用量进度条、重置时间与限额参考。

---

✨ 功能特性

功能	说明
DeepSeek 平台概览	充值余额、赠送余额、累计消费金额、本月消费金额、本月 Tokens
每日柱状图	消费金额与 Token 消耗双图表，SVG 渲染，鼠标悬停查看每日明细
时间维度切换	今天 / 近 7 天 / 近 30 天 / 近 90 天 / 本月 / 上月 / 自定义区间
按模型明细表	deepseek-v4-flash / deepseek-v4-pro / 其他：请求次数、输入/缓存/输出 Tokens、费用
OpenCode Go 配额	5 小时滚动 / 每周 / 每月三个窗口的用量百分比与下次重置时间
自动刷新	页面挂载期间每 60 秒自动轮询最新数据
双语言界面	完整的中英文切换支持
官方账户页共存	使用独立的设置分区 ID，兼容桌面端官方「账号与余额」入口

[!NOTE] 0.1.26 修复了桌面端设置入口 ID 冲突。升级后重启 DSH，自制「账户」页与官方「账号与余额」页可同时出现；官方入口仍按 DSH 的账户登录状态显示。已在 DSH 桌面端 0.2.0-rc.2 验证。

---

🚀 快速开始

前提条件

• 已安装 DSH CLI 与 pnpm（dsh plugin 内部转发到 pnpm）

安装

## ⚙️ 配置说明

### DeepSeek 平台令牌（必需，仅影响 DeepSeek 面板）

用量接口是平台控制台的私有接口，需要你的平台登录令牌：

1. 登录 https://platform.deepseek.com
2. 打开 DevTools → Console，执行：

   ```js
   JSON.parse(localStorage.getItem('userToken')).value

3. 在插件「账户」页的令牌输入框直接粘贴并保存（写入 ~/.dsh/.credentials.yaml 的 DEEPSEEK_PLATFORM_TOKEN）

手动写入凭据文件（可选）

### OpenCode Go Key（通常无需配置）

插件按以下顺序自动查找：

1. DSH 凭据 `OPENCODE_GO_API_KEY`（`~/.dsh/.credentials.yaml`，在「设置 → 模型」配置 opencode-go 时通常已存在）；
2. OpenCode 自身的 `~/.local/share/opencode/auth.json`（`opencode-go` 条目，type 为 `api`）。

---

## 📖 使用说明

- 在设置面板「账户」页顶部切换 **deepseek / opencode go** 两个标签查看对应数据；
- DeepSeek 页可切换时间维度（今天 / 近 7 天 / 近 30 天 / 近 90 天 / 本月 / 上月），或选择「自定义区间」后点击「应用」；
- 柱状图支持鼠标悬停查看每日明细；模型明细表展示所选区间内各模型的请求次数、Tokens 与费用；
- OpenCode Go 页展示三个配额窗口的用量百分比、下次重置时间与限额参考，可一键「跳转」到 opencode.ai 或「刷新」；
- 页面挂载期间每 60 秒自动刷新；「打开配置文件」按钮可直接定位本机 DSH 凭据文件。

---