dsh-dsbal

Dsbal

DSH Web 侧边栏的 DeepSeek API 余额组件——在“设置”上方显示人民币余额，每 30 秒自动刷新，点击可手动刷新，悬停查看余额详情卡片，余额低于阈值时显示警告边框，文本跟随界面语言。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:flyingfishzxf/dsh-dsbal#64333c5db2c9c9a77f254cad3f434c7e5c55d88b

兼容性与来源证明

Dsbal 以 dsh-dsbal 发布，当前版本为 0.4.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: github
Registry 更新时间: 2026/9/24

版本

0.4.1stable

2026/9/24

0.4.0stable

2026/9/20

0.3.1stable

2026/8/27

README

dsh-dsbal

中文

A minimal, single-purpose DeepSeek API balance widget for the DSH web sidebar — it shows one number and nothing else.

Shows your CNY balance on a button in the sidebar footer, above Settings (wallet icon on the left, ¥xx.xx on the right), aligned with the Settings button.
30s auto refresh; click the button to refresh immediately and reset the cycle.
Hover opens a usage-notes card: the current balance in large type (¥xx.xx) at the top, then the balance warning legend (< 50 yellow · < 30 orange · < 10 red → dashed border on the button), the peak/off-peak billing rule (two rows: peak/off-peak hours), and a merged refresh rule + refresh time on one line, with the plugin version (dsh-dsbal v0.4.1) right-aligned at the bottom. The card tracks the button width: as wide as the button column when the sidebar is expanded (capped at 360px), a fixed 240px when collapsed, following live while the sidebar animates.
Collapsed sidebar: the button shrinks to a 36px circle with no room for the amount or the badge, so peak/off-peak moves onto the icon colour (red #e5484d during peak, brand blue #4d6bfe off-peak) and the exact amount is read from the top of the hover card. Expanded, the icon stays neutral and the 梁文峰/梁文谷 pill alone carries the state.
Peak/off-peak pricing hint: periods are defined in Beijing time (peak is Monday–Friday 09:00-12:00 & 14:00-18:00; every other hour, weekends in full (including make-up workdays) and Chinese statutory holidays in full are off-peak at half the peak price). A hollow badge sits at the right of the balance — red 「梁文峰」 during peak, brand-blue 「梁文谷」 off-peak (right-aligned, never wider than the sidebar). The holiday table is fetched silently in the browser from holiday-cn (jsDelivr, then GitHub raw), cached in localStorage for 24h, and falls back to the bundled 2025/2026 table when offline or not yet fetched.
Balance warning borders: < 10 → red, < 30 → orange, < 50 → yellow, ≥ 50 → normal (dashed border of the tier colour; orange/yellow are kept visually distinct).
UI language aware: all texts follow the DSH language setting (zh / en), switching live.

Install

Install directly from GitHub (currently recommended):

dsh plugin --profile web add github:flyingfishzxf/dsh-dsbal

Or, after the package is published to npm:

dsh plugin --profile web add dsh-dsbal

For local development, you can install from a local path:

dsh plugin --profile web add file:/path/to/dsh-dsbal

After installing, restart dsh web and hard-refresh the browser so the new bundle is loaded.

How it works

The host half registers a dsBalance Remote service. fetch resolves the DeepSeek API key through the credential seam (DEEPSEEK_API_KEY by default) and calls GET {baseURL}/user/balance through the shell — the web.fetch seam cannot carry an Authorization header:
- POSIX: curl with ${DEEPSEEK_API_KEY} expansion.
- Windows: node -e (OpenSSL-based fetch). The sandboxed PowerShell shell cannot complete any schannel TLS (curl and .NET both fail with SEC_E_NO_CREDENTIALS), while Node's fetch is unaffected. The request explicitly runs unconfined (danger-full-access): the Windows ACL sandbox runner breaks for wide deployment workspaces (e.g. starting dsh web from a home directory), which would otherwise make balance fetching depend on the host's start directory. The command is fixed and plugin-authored (URL from settings, key from credentials), so this is safe; POSIX stays confined.
- The key and URL ride the shell spec's explicit env layer, so the secret never appears in the command string or logs.
The client half mounts the Remote, renders the sidebar button and the hover card, and owns the refresh loop.

Configuration

The plugin honours the llm-deepseek settings section, exactly like the DeepSeek model adapter:

apiKeyEnv — credential reference (default DEEPSEEK_API_KEY).
baseURL — API base (default https://api.deepseek.com).

Requirements

POSIX: curl on the host. Windows: node on the host.
A configured DeepSeek API key in DSH credentials.
DSH host compatibility: the host half uses the current shell.execute(...).result() execution surface and the settings.describe() section lookup, and falls back to the pre-0.1.7 shell.run() / settings.get() APIs, so one bundle keeps working across that host update.

Limitations

Shows only the DeepSeek API balance — the account behind the configured key (DEEPSEEK_API_KEY by default), queried via GET /user/balance. It does not show other providers' or other accounts' balances, and it cannot combine or convert between accounts.
Read-only: it displays the balance and nothing else. No top-up, key management, or billing operations.
The refresh interval is fixed at 30 seconds and is not configurable.
The balance is displayed in CNY, which is how the DeepSeek API reports it.
Host dependencies: curl on POSIX, node on Windows (see Requirements).

Publish to the plugin market

Not listed yet. The list is maintained in awesome-dsh-plugin as one YAML file per plugin.

To add this plugin:

Make sure the repository meets the requirements:
- at least 1 day old,
- 10 or more commits,
- the dsh-plugin topic added on GitHub (repo Settings → General → Topics; CI checks it).
Fork awesome-dsh-plugin.

Add data/plugins/flyingfishzxf__dsh-dsbal.yml:

url: https://github.com/flyingfishzxf/dsh-dsbal
name: flyingfishzxf/dsh-dsbal
category: usage
description:
  en: 'Shows the DeepSeek API account balance in the DSH Web sidebar with 30s auto-refresh, click-to-refresh, hover details, and low-balance threshold warnings.'
  zh: '在 DSH Web 侧边栏显示 DeepSeek API 账户余额：30 秒自动刷新、点击刷新、悬停查看明细、余额不足阈值告警。'

The market description must state what the plugin does without superlatives (they get sent back) — the "minimal" positioning lives in this README, not in the market entry.

Regenerate the READMEs and commit them along with the YAML file:
```
npm ci
node scripts/generate-readme.mjs
```
Open a pull request.

The market (dshmarket) picks it up automatically after the PR is merged.

License

MIT

README

dsh-dsbal

中文

A minimal, single-purpose DeepSeek API balance widget for the DSH web sidebar — it shows one number and nothing else.

Shows your CNY balance on a button in the sidebar footer, above Settings (wallet icon on the left, ¥xx.xx on the right), aligned with the Settings button.
30s auto refresh; click the button to refresh immediately and reset the cycle.
Hover opens a usage-notes card: the current balance in large type (¥xx.xx) at the top, then the balance warning legend (< 50 yellow · < 30 orange · < 10 red → dashed border on the button), the peak/off-peak billing rule (two rows: peak/off-peak hours), and a merged refresh rule + refresh time on one line, with the plugin version (dsh-dsbal v0.4.1) right-aligned at the bottom. The card tracks the button width: as wide as the button column when the sidebar is expanded (capped at 360px), a fixed 240px when collapsed, following live while the sidebar animates.
Collapsed sidebar: the button shrinks to a 36px circle with no room for the amount or the badge, so peak/off-peak moves onto the icon colour (red #e5484d during peak, brand blue #4d6bfe off-peak) and the exact amount is read from the top of the hover card. Expanded, the icon stays neutral and the 梁文峰/梁文谷 pill alone carries the state.
Peak/off-peak pricing hint: periods are defined in Beijing time (peak is Monday–Friday 09:00-12:00 & 14:00-18:00; every other hour, weekends in full (including make-up workdays) and Chinese statutory holidays in full are off-peak at half the peak price). A hollow badge sits at the right of the balance — red 「梁文峰」 during peak, brand-blue 「梁文谷」 off-peak (right-aligned, never wider than the sidebar). The holiday table is fetched silently in the browser from holiday-cn (jsDelivr, then GitHub raw), cached in localStorage for 24h, and falls back to the bundled 2025/2026 table when offline or not yet fetched.
Balance warning borders: < 10 → red, < 30 → orange, < 50 → yellow, ≥ 50 → normal (dashed border of the tier colour; orange/yellow are kept visually distinct).
UI language aware: all texts follow the DSH language setting (zh / en), switching live.

Install

Install directly from GitHub (currently recommended):

dsh plugin --profile web add github:flyingfishzxf/dsh-dsbal

Or, after the package is published to npm:

dsh plugin --profile web add dsh-dsbal

For local development, you can install from a local path:

dsh plugin --profile web add file:/path/to/dsh-dsbal

After installing, restart dsh web and hard-refresh the browser so the new bundle is loaded.

How it works

The host half registers a dsBalance Remote service. fetch resolves the DeepSeek API key through the credential seam (DEEPSEEK_API_KEY by default) and calls GET {baseURL}/user/balance through the shell — the web.fetch seam cannot carry an Authorization header:
- POSIX: curl with ${DEEPSEEK_API_KEY} expansion.
- Windows: node -e (OpenSSL-based fetch). The sandboxed PowerShell shell cannot complete any schannel TLS (curl and .NET both fail with SEC_E_NO_CREDENTIALS), while Node's fetch is unaffected. The request explicitly runs unconfined (danger-full-access): the Windows ACL sandbox runner breaks for wide deployment workspaces (e.g. starting dsh web from a home directory), which would otherwise make balance fetching depend on the host's start directory. The command is fixed and plugin-authored (URL from settings, key from credentials), so this is safe; POSIX stays confined.
- The key and URL ride the shell spec's explicit env layer, so the secret never appears in the command string or logs.
The client half mounts the Remote, renders the sidebar button and the hover card, and owns the refresh loop.

Configuration

The plugin honours the llm-deepseek settings section, exactly like the DeepSeek model adapter:

apiKeyEnv — credential reference (default DEEPSEEK_API_KEY).
baseURL — API base (default https://api.deepseek.com).

Requirements

POSIX: curl on the host. Windows: node on the host.
A configured DeepSeek API key in DSH credentials.
DSH host compatibility: the host half uses the current shell.execute(...).result() execution surface and the settings.describe() section lookup, and falls back to the pre-0.1.7 shell.run() / settings.get() APIs, so one bundle keeps working across that host update.

Limitations

Shows only the DeepSeek API balance — the account behind the configured key (DEEPSEEK_API_KEY by default), queried via GET /user/balance. It does not show other providers' or other accounts' balances, and it cannot combine or convert between accounts.
Read-only: it displays the balance and nothing else. No top-up, key management, or billing operations.
The refresh interval is fixed at 30 seconds and is not configurable.
The balance is displayed in CNY, which is how the DeepSeek API reports it.
Host dependencies: curl on POSIX, node on Windows (see Requirements).

Publish to the plugin market

Not listed yet. The list is maintained in awesome-dsh-plugin as one YAML file per plugin.

To add this plugin:

Make sure the repository meets the requirements:
- at least 1 day old,
- 10 or more commits,
- the dsh-plugin topic added on GitHub (repo Settings → General → Topics; CI checks it).
Fork awesome-dsh-plugin.

Add data/plugins/flyingfishzxf__dsh-dsbal.yml:

url: https://github.com/flyingfishzxf/dsh-dsbal
name: flyingfishzxf/dsh-dsbal
category: usage
description:
  en: 'Shows the DeepSeek API account balance in the DSH Web sidebar with 30s auto-refresh, click-to-refresh, hover details, and low-balance threshold warnings.'
  zh: '在 DSH Web 侧边栏显示 DeepSeek API 账户余额：30 秒自动刷新、点击刷新、悬停查看明细、余额不足阈值告警。'

The market description must state what the plugin does without superlatives (they get sent back) — the "minimal" positioning lives in this README, not in the market entry.

Regenerate the READMEs and commit them along with the YAML file:
```
npm ci
node scripts/generate-readme.mjs
```
Open a pull request.

The market (dshmarket) picks it up automatically after the PR is merged.

License

MIT

Dsbal

兼容性与来源证明

版本

相关插件

Dsbal

README

dsh-dsbal

Install

How it works

Configuration

Requirements

Limitations

Publish to the plugin market

License

兼容性与来源证明

版本

相关插件

相关插件

README

dsh-dsbal

Install

How it works

Configuration

Requirements

Limitations

Publish to the plugin market

License

相关插件