dsh-deepseek-usage

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

dsh-deepseek-usage

在 DSH 设置页查看 DeepSeek 余额与用量。

## 功能

| 功能        | 说明                                                               |
| --------- | ---------------------------------------------------------------- |
| 账户余额      | 官方 `GET /user/balance`，多币种（总余额 / 充值 / 赠送）+ 可用状态灯（绿/黄/红/灰）        |
| 用量统计      | 今日 / 本月 token、消费、请求次数（今日按北京时间 0 点起算），以及缓存命中 / 未命中 / 输出的 token 构成 |
| 分模型拆分     | 每个模型的 token 用量与消费                                                |
| 分 API Key | 按 `api_key_name` 筛选单个 key 的用量（对应官方页面的「按 API 筛选」）                 |
| 总消费       | 全部历史累计消费（逐月汇总）                                                   |
| 自动刷新      | 可勾选「每 60 秒自动刷新」，偏好持久化                                            |

## 截图

![主界面](screenshot-main.png)

![用量与分模型](screenshot-details.png)

## 细节说明

### 数据来源

| 数据        | 接口                                                             | 认证            |
| --------- | -------------------------------------------------------------- | ------------- |
| 余额        | `api.deepseek.com/user/balance`（官方公开）                          | API Key       |
| 本月用量 / 消费 | `platform.deepseek.com/api/v0/usage/amount`、`usage/cost`（网页接口） | 登录态 userToken |
| 今日用量 / 消费 | `platform.deepseek.com/api/v0/usage/export`（北京时间窗口）            | 登录态 userToken |

> 今日按北京时间（本地时区）0 点起算：平台月接口按 UTC 切分日数据，今日口径按 `usage/export` 窗口统计。

> 用量 / 消费接口是 platform.deepseek.com 的私有接口，非官方公开 API，可能随时变更。

### 凭据

| 凭据        | 存放                                         | 说明            |
| --------- | ------------------------------------------ | ------------- |
| API Key   | DSH 凭据服务 `DEEPSEEK_API_KEY`（与调用 LLM 共用，只读） | 在 DSH 模型设置中更改 |
| userToken | `~/.dsh/ds-balance.json`                   | 自动尝试失败时需手动粘贴  |

## 安全设计

- 凭据服务端保存：API Key 走 DSH 凭据服务，userToken 存 `~/.dsh/ds-balance.json`（0600），浏览器只读掩码。
- Node 原生 `fetch` 直连：无 shell / 子进程中间层，凭据只在进程内存流转。
- 回环 + 同源守卫：所有路由仅接受 127.0.0.1 回环与同源请求，内置 DNS-rebinding 防护。
- 稳定错误码 + 最小日志：日志只记录 `{code, status}`。

## 安装

正式使用（从 GitHub 安装）：

```bash
dsh plugin --profile web add github:AzureHalcyon/dsh-deepseek-usage#main
```

本地开发（link 安装）：

```bash
dsh plugin --profile web add link:<本仓库绝对路径>
```

装完重启 DSH。

## 使用

1. 打开 **设置 → DeepSeek 用量**；
2. API Key 自动复用 DSH 的 `DEEPSEEK_API_KEY`（只读展示，无需额外配置）；
3. userToken 自动读取浏览器已登录的 `platform.deepseek.com` 会话；读不到时按提示手动粘贴（登录Deepseek开放平台后浏览器控制台执行 `localStorage.getItem("userToken")`）；
4. 点「立即同步」。

## 插件管理

已装插件建议用 plugin-registry 的薄控制台管理（浏览器面板）：管理 profile 插件安装态（bundle 层栈 + insert 行 + 启停），无需手改配置。安装：

```bash
dsh plugin --profile web add "github:vlln/plugin-registry#main&path:/packages/plugin/console"
```