dsh-deepseek-balance-plus

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

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

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

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

# dsh-deepseek-balance-plus

> A DeepSeek Harness (DSH) third-party plugin: shows your DeepSeek API account
> balance in the **left sidebar footer**, auto-refreshes, and offers a
> one-click jump to the official top-up page.

[简体中文](README.zh.md) · English

## Features

- **Persistent balance pill** in the sidebar footer: `¥ 余额 ¥xx.xx` — the same
  account balance as the [usage page](https://platform.deepseek.com/usage).
  Collapses to a compact ¥ badge when the sidebar shrinks to the 56px rail.
- **Auto refresh** every 5 minutes against the official endpoint
  `GET https://api.deepseek.com/user/balance`
- **Detail panel** on click: total / granted amounts per currency, key source,
  last update time, manual refresh
- **One-click top-up**: the panel's `充值` button opens the official
  `https://platform.deepseek.com/top_up` page in your default browser
- **Zero-config key reuse**: prefers the DSH-managed `DEEPSEEK_API_KEY`
  credential — no key input needed. Falls back to a paste box (kept in host
  memory only) when no configured key exists.

## Install

```sh
dsh plugin --profile web add dsh-deepseek-balance-plus
```

Requires a DSH web/desktop build with the `dsh.client` client-module system
(the same era as `dshmarket` / `dsh-better-sidebar`).

## Security

- Reads the official balance endpoint only; the plugin never stores or uploads
  secrets, and its host routes never return key material.
- Reuses DSH's own configured credential, or an in-memory manual key.
- The top-up button opens the official URL in your browser; no third-party hop.

## Build / develop

Zero runtime dependencies (peer `@deepseek-ai/cordis` only); nothing to install.

```sh
node scripts/build.mjs   # mirrors src/ -> lib/ (host half); client/client.js is the final bundle
npm pack                 # publishable tarball (runs prepack)
```

Layout:

- `src/balance-core.js` — host balance core (credential resolution / subprocess+curl / summary)
- `src/index.js` — host Cordis plugin entry (registers `/dsh-balance/*` webServer routes)
- `client/client.js` — browser bundle (`__ModuleLoader__.load` format) registering the
  widget into the client slot system (`sidebar.footer.action`)

Host routes (same-origin, no secrets returned):

| Method | Path                  | Purpose                              |
| ------ | --------------------- | ------------------------------------ |
| GET    | `/dsh-balance/state`  | cached snapshot (also warms a fetch) |
| POST   | `/dsh-balance/refresh`| re-query the official balance API    |
| POST   | `/dsh-balance/key`    | store an in-memory manual API key    |
| POST   | `/dsh-balance/topup`  | open the official top-up page        |

## Publish to the community market

1. Publish the npm package (`npm publish` — needs your npm account). Verify the
   name is free first: `npm view dsh-deepseek-balance-plus version`; pick a unique
   name (optionally under your scope) if it is taken.
2. Submit it to the [awesome-dsh-plugin](https://awesome-dsh-plugin.com) curated
   list (GitHub: `awesome-dsh-plugin/awesome-dsh-plugin`), category `usage ·
   用量与计费`.
3. Once listed, dshmarket users can one-click install it.

> Caveat: any marketplace that asks you to paste your DeepSeek API key is a
> phishing pattern. This plugin only ever reads the DSH-managed credential.

## License

[MIT](LICENSE)