@freespace8/dsh-deepseek-balance
用于 DeepSeek Harness Web GUI 会话标头的官方 DeepSeek API 余额胶囊，支持点击/定时刷新，并在使用非官方模型时自动隐藏。官方 DeepSeek API 余额胶囊。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @freespace8/dsh-deepseek-balance@0.1.2Deepseek Balance 以 @freespace8/dsh-deepseek-balance 发布，当前版本为 0.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DeepSeek Harness plugin that shows your official DeepSeek API balance as a pill in the Web GUI session header (left of the Session log). It is shown only when the current session model is an official DeepSeek model and auto-hides for third-party relay/proxy models.
English · 简体中文
¥xx.xx (no currency suffix) in
the session header;deepseek-official, i.e. api.deepseek.com) — third-party
relay/proxy models hide it automatically;The pill as it appears in the session header (left of the Session log):
DeepSeek official balance pill previewVisibility: the pill appears only when the session's current model is an official DeepSeek model (provider
deepseek-official, i.e.api.deepseek.com). If you switch to a non-official DeepSeek relay/proxy model the pill hides; it reappears when you switch back to an official model.
web profile;DEEPSEEK_API_KEY in
~/.dsh/.credentials.yaml (or the same-name environment variable).Published on npm — install with a single command (target profile web):
dsh plugin --profile web add @freespace8/dsh-deepseek-balance
After installing, restart the web profile (dsh plugin add only updates
the manifest and dependencies; a running instance does not hot-load a new
bundle). To uninstall:
dsh plugin --profile web remove @freespace8/dsh-deepseek-balance
Override any field in the profile's cordis.patch.yml by id (the config
block is replaced wholesale):
- id: deepseek-balance
config:
apiKeyEnv: DEEPSEEK_API_KEY # credential name used for the balance request
refreshIntervalMs: 300000 # auto-refresh interval (milliseconds)
order: -1 # pill order in the session header (lower = earlier)
shellTimeoutMs: 8000 # total shell timeout for fetching the balance (ms)
src/index.js): resolves the API key via ctx.credentials,
runs curl https://api.deepseek.com/user/balance through ctx.shell, and
registers the HTTP route /plugins/dsh-deepseek-balance/balance to deliver
the result (including the refresh-interval config) to the browser;lib/client.js): registers a
conversation.session.header.utilities slot entry; reads the session's
current model via ctx.modelDirectories to decide visibility; fetches the
balance route to render the pill.Balance data always comes from the official DeepSeek endpoint (using the stored official key), regardless of which provider the model traffic goes through; visibility depends only on whether the session's current model is an official DeepSeek model.
npm run check # artifact gate: syntax, export shapes, exports/files, patch line, client id
Real-behavior verification (after installing into a profile): restart the web profile → open an existing session → the balance pill appears in the header; switch the model to a third-party relay model → the pill disappears; switch back to official DeepSeek → the pill returns.
MIT — see LICENSE. This is an original work and contains no third-party code.