dsh-deepseek-balance-widget

dsh-deepseek-balance-widget

English | 中文

A multi-provider AI balance widget for the dsh web sidebar. DeepSeek is built in; add MiMo (Xiaomi) from the popover. Auto-refreshes every 30 seconds.

Features

Sidebar entry

• Live Balance / Today Spend / Today Tokens for the current provider, auto-refresh every 30 s
• Values follow the provider selected in the popover

Detail popover

• Header shows the current provider: a "Switch" menu lets you change to another added provider, and "×" removes it (with confirmation)
• "+ Add" button (top right): add MiMo or DeepSeek
• DeepSeek details: balance, cumulative spend, today spend, today tokens, monthly usage (monthly spend / tokens)
• MiMo details: balance, cumulative spend, today spend / today tokens, monthly usage, and a daily usage table (date / tokens / requests / spend)
• DeepSeek shows a peak / off-peak badge (GMT+8: weekdays 09-12 / 14-18 are peak, weekends off-peak all day)

Usage stats

• DeepSeek: optional DEEPSEEK_PLATFORM_TOKEN (just tell your AI "help me configure usage stats"); balance-only otherwise
• MiMo: balance and usage both come from the login cookie; spend is computed at official unit prices

AI-guided setup

• One click in the popover copies a prompt; the AI reads the local guide file and walks you through capturing and writing credentials
• MiMo supports two paths: an AI wizard (open balance page → copy prompt), or pasting the Cookie / cURL manually (Cookie auto-extracted)
• Everything stays on your machine; nothing is uploaded

Version & updates

• The footer shows the current version; when a newer one exists it reads vX → vY Update with one-click auto-update
• On update failure an error panel shows the details (copyable) and points you to GitHub for a manual install
• UI follows dsh's language setting (中文 / EN)

Skin & third-party plugin compatibility (since v2.4.3)

• Coexists safely with skins like maid-atelier that rebuild the sidebar DOM — the balance entry stays visible
• Inserts use a "safe insert" strategy: when the anchor is moved by the skin / React, it falls back to appending; it never throws and never breaks the retry loop
• After placement, a next-frame check re-places the entry if it was moved away
• Recognizes common skin markers (e.g. [data-maid-sidebar-footer]) as fallback sidebar anchors

Install

Requires: dsh installed (with dsh web working).

dsh plugin --profile web add dsh-deepseek-balance-widget@2.4.3

Installed from npm and auto-registered by dsh. Restart dsh web and the balance button appears in the sidebar.

Always pin the version @2.4.3 (the current latest stable). Do not use @latest — local pnpm/npm cache or a mirror registry can resolve it to an outdated release. When a newer version is released, bump the number here.

Or just tell your AI:

Install the dsh-deepseek-balance-widget plugin for me via npm: run dsh plugin --profile web add dsh-deepseek-balance-widget@2.4.3.

Configuration

On first use the plugin creates a DeepSeek entry and reads your local DEEPSEEK_API_KEY.

To add MiMo, open the popover, click "+ Add", then "AI Configure", and send the copied prompt to your AI. Or just tell your AI:

Configure dsh-deepseek-balance-widget for me.

The AI takes care of everything: asks for your API key / guides you through getting the platform cookie → writes the local config → reminds you to restart dsh web.

Credentials are stored locally in ~/.dsh/ai-balances.json; nothing is shipped with the plugin and nothing is uploaded.

Update

Upgrade to the latest stable release on npm regardless of which older version you currently have.

Method 1: One-click from the popover (recommended for installed users)

1. Open the balance popover; the footer shows the version. When a newer one exists it reads vX → vY Update (where vY is the highest semver version on npm).
2. Click "Update". The plugin pulls and installs the highest semver version from npm automatically.
3. After install you must fully restart dsh web (stop the dsh web process / quit the desktop app and reopen — refreshing the browser tab is not enough) for the new version to load.

The popover's "Update" skips the latest tag and installs the highest semver version on npm, so it still reaches latest even if someone lowers the latest tag.

Method 2: Force update from the command line (most reliable if stuck)

dsh plugin --profile web add dsh-deepseek-balance-widget@2.4.3

Pinning @2.4.3 bypasses local cache / mirror desync / a stale latest resolution in one step. Then fully restart dsh web.

Method 3: Manual update (fallback when the command-line update fails)

cd ~/.dsh/profiles/web
npm install dsh-deepseek-balance-widget@2.4.3   # use `pnpm add` if a pnpm-lock.yaml exists in this dir
# verify the on-disk version actually changed
cat node_modules/dsh-deepseek-balance-widget/package.json | grep '"version"'

Once it prints 2.4.3, fully restart dsh web.

If the popover / command-line update keeps failing (version never changes), an agent host (e.g. WorkBuddy) is likely injecting a file-deletion guard via NODE_OPTIONS, which makes pnpm/npm abort during updates. Run the command in a plain terminal (not through the agent), or unset NODE_OPTIONS first (PowerShell: set NODE_OPTIONS=) and retry.

Changelog

v2.4.3

• Fixed: the balance card not showing at all (with constant Uncaught NotFoundError: insertBefore in the console) when running alongside skins such as maid-atelier
• Sidebar / toolbar insertion now goes through a safe-insert helper: it verifies the anchor is still a connected child of the target and falls back to appendChild otherwise — it never throws
• tryPlace() is fully guarded, so a single failure no longer kills retries; a next-frame check re-places the entry if the skin / React moved it in the same tick
• sidebarRoot() gained a [data-maid-sidebar-footer] skin-marker fallback
• Thanks to user「朱鹭咲泽」for the detailed root-cause analysis and fix patch

v2.4.2 and earlier

See GitHub Releases.

Uninstall

dsh plugin --profile web rm dsh-deepseek-balance-widget

Or just tell your AI:

Uninstall the dsh-deepseek-balance-widget plugin for me via npm.

Contact

Questions or suggestions? Feel free to reach out:

• Email: crazy_l118@icloud.com

Sponsor

If this plugin helped you, consider buying me a ham sausage for dinner 🍗

License

MIT