Bottom Info Bar English | 中文 The best-adapted bottom info bar for DeepSeek Harness, and a drop-in replacement for the native stats row under the composer. It shows live balance and subscription quota (ChatGPT & OpenCode Go) at a glance, alongside provider & model, peak/off-peak pricing, and real spend — smart and concise, conflict-free, and native in look and feel: it auto-detects the billing mode, replaces the native row instead of duplicating it, and matches the model switcher exactly. Install once; it activates automatically on every launch. ## Preview From top to bottom, the combined screenshot shows ChatGPT subscription, DeepSeek API, and OpenCode Go subscription. Each account is shown in full view followed by compact view. ## Features - Dual-mode billing bar — Auto-detects whether the active provider is subscription-based (Codex / OpenCode Go) or balance-based. The two modes replace each other, never overlap; balance mode stays exactly as before. - Subscription quota display (ChatGPT & OpenCode Go) — When the active provider is a subscription service, the bar shows the subscription service + model (e.g. OpenCode Go · V4 Flash), the 5-hour / weekly / monthly quota remaining per window (remaining = 100 − used, bold and color-coded: green when >20% remaining, amber when ≤20%), and a countdown to the next reset (e.g. 距重置 1d 21h). In compact mode the shortest-duration window is shown (5-hour preferred; falls back to weekly/monthly if unavailable); in full mode all three windows appear. A ⚠ alert appears when any window drops to 20% or less remaining. Quota is pulled from two subscription sources: - ChatGPT / Codex — reads your ChatGPT subscription quota (Plus / Pro / Team / Enterprise) read-only from ~/.codex/auth.json. Binding, token refresh and the openai-codex model route are not part of this plugin — install the companion plugin dsh-chatgpt-subscription (separate repo) to bind your ChatGPT account; this bar only reads the token to display quota. Missing/expired token → "not bound / re-bind" hint instead of an error. Hover over "⚠ refresh failed" for details on auto-retry behavior. - OpenCode Go — reads quota from opencode.ai/zen/go/v1/usage via OPENCODE_GO_API_KEY (Settings → Models) or the opencode CLI login (~/.local/share/opencode/auth.json); missing key → "not configured" hint instead of an error. Both sources show the remaining quota and the reset time for each of the 5-hour / weekly / monthly windows, so you always know when your quota renews. Quota and countdown always match — both come from the same window. - Drop-in replacement — Replaces the native stats row while keeping its core original information (turns/steps, LLM latency, tool calls, cache hit rate, in/out tokens) with a native-consistent layout. Speed metrics (TTFT, tok/s) move to the hover tooltip so the row stays on a single line. - Provider & model detection — Shows the provider and model names exactly as in the model switcher (from the DSH LLM catalog, e.g. DeepSeek-V4-Flash); the provider name is bold, and is omitted when it is already a prefix of the model name. - Live balance — Fetches real balance from DeepSeek's /user/balance API, auto-refreshes every 60 s, and keeps the last known snapshot on failure so usage is never interrupted. - Peak / off-peak pricing — Shows peak (amber, bold) and off-peak (green, bold) prices with a countdown to the next switch; hidden automatically for providers without tiered pricing. - Real spend tracking — Records every llm/stream request (usage × unit price) and aggregates precisely by this conversation / today / this month / all time. Records are persisted to disk — nothing is lost on restart. - Bold numbers — Balance, countdown, spend, and all stats are rendered with bold numerals for instant readability. - Full / compact toggle — Click the bar to switch between two strict modes (debounced). - Low-balance alert — Shows ⚠ when the balance drops below ¥20. ## Requirements - DeepSeek Harness (dsh CLI) installed and used via the web interface (dsh web) - pnpm (used by dsh plugin) ## Installation ### Option 1 — One-command script (recommended) bash git clone https://github.com/songoao25/dsh-bottom-info-bar.git cd dsh-bottom-info-bar ./install.sh # installs to the "web" profile; use --profile <name> to override ### Option 2 — dsh plugin command bash git clone https://github.com/songoao25/dsh-bottom-info-bar.git dsh plugin --profile web add /path/to/dsh-bottom-info-bar/plugin > Restart dsh web after installing. Plugins are composed when the host process starts; a page refresh alone is not enough. For detailed installation, troubleshooting, and upgrade instructions, see docs/INSTALL.md. ## Usage - Hover the bar for details: balance, per-token pricing, next price-switch time, and this-conversation spend (today / this month / all time). - Click the bar to toggle between full and compact modes. ## Configuration - API key: configure the DeepSeek API key under Settings → Models (environment variable DEEPSEEK_API_KEY). Without it, the plugin shows a hint and every other feature keeps working. - Data scope: peak hours are 09:00–12:00 and 14:00–18:00 (Beijing time). Built-in pricing covers DeepSeek V4 models plus OpenAI reference prices; models not in the table are excluded from spend statistics. - Mode: the bar switches automatically between balance mode and subscription mode based on the active provider (codex / chatgpt / opencode-go / opencode / openai-codex → subscription; everything else → balance). An internal billingMode: 'auto' | 'balance' | 'subscription' setting (default auto) allows forcing a mode. - Subscription sources: - ChatGPT (Codex): install the companion plugin dsh-chatgpt-subscription (separate repo) and bind your ChatGPT account once — it maintains the token in ~/.codex/auth.json (mode 0600) and registers the ChatGPT models. This bar only reads that token to fetch quota (chatgpt.com/backend-api/wham/usage); it never refreshes, writes back, or injects credentials. Without a token the bar shows a "not bound — install dsh-chatgpt-subscription to authorize" hint; an expired token shows a "re-bind" hint. - OpenCode Go: set OPENCODE_GO_API_KEY under Settings → Models, or log in with the opencode CLI (writes the opencode-go entry in ~/.local/share/opencode/auth.json). Without a key the bar shows a "not configured" hint instead of an error. #### ChatGPT subscription: known limitations - The chatgpt.com backend is an undocumented interface — it may change or stop working at any time; failures degrade gracefully (last snapshot kept, auto-retry), never a crash. - Available models depend on your subscription plan; model access is provided by the companion plugin dsh-chatgpt-subscription. ### Data storage (plugin-owned directory) All spend data lives in the plugin's own data directory, isolated from other plugins and DSH configuration: ~/.dsh/dsh-bottom-info-bar/ └── usage-records.json # per-request usage ledger (persisted across restarts) - Location: ~/.dsh/dsh-bottom-info-bar/ (directory mode 0700, file mode 0600 — readable only by the current user). - Override: set the environment variable DSH_BOTTOM_INFO_BAR_DATA_DIR to relocate the whole data directory (e.g. an external drive or a synced folder). - Contents: one entry per llm/stream request (ts / model / provider / sessionId / input / cacheRead / cacheWrite / output). No conversation content and no API keys are ever stored. - Retention: capped at 3,000 entries (oldest first). - Spend scope: aggregated in the active provider's currency (CNY for DeepSeek, USD for the OpenAI reference prices); records in other currencies are not mixed in. Models absent from the pricing table are excluded. - Reset: delete the file to clear all statistics. Uninstalling the plugin does not delete your data. ## Uninstall bash cd dsh-bottom-info-bar ./uninstall.sh # remove the plugin only # or: dsh plugin --profile web remove dsh-bottom-info-bar ChatGPT subscription (binding & token maintenance) is owned by the separate plugin dsh-chatgpt-subscription; uninstalling this info bar does not touch it. After restarting, the native stats row returns automatically with no residue (the ledger file under ~/.dsh/dsh-bottom-info-bar/ is your data and is kept; remove it manually if you want to reset the statistics). ## FAQ | Symptom | Fix | |---|---| | Bar does not appear after a page refresh | Restart dsh web (the host process loads plugins) | | Balance shows "DEEPSEEK_API_KEY not configured" | Add the key under Settings → Models | | Balance shows "⚠ refresh failed, showing last snapshot" | Transient network/key issue; retries automatically after 60 s. The last successful data is kept so the bar never goes blank. Hover over the warning for a detailed explanation and retry timing. | | Shows "OpenCode Go not configured" | Add OPENCODE_GO_API_KEY under Settings → Models, or configure OpenCode Go in the opencode CLI | | How do I bind my ChatGPT subscription? | Install the companion plugin dsh-chatgpt-subscription and authorize on the official page — it maintains the token this bar reads for quota display | | ChatGPT quotas look wrong or empty | The wham endpoint is undocumented and may change; failures keep the last snapshot and retry every 60 s. Hover over "⚠ refresh failed" to see the retry explanation. | | Why does compact mode show a different window? | Compact mode prioritizes the shortest-duration window (5-hour > weekly > monthly) because it refreshes fastest. If the 5-hour window is unavailable, it falls back to weekly or monthly. Quota and countdown always match — both come from the same window. | | Why is the model's reasoning process not shown? | DSH does not render the model's internal reasoning in the UI — a DSH interface-layer limitation, not the plugin's | | Want the original stats row back | Uninstall the plugin and restart | ## Development - Source: plugin/src/host.js (host) + plugin/src/client-bundle.js (client) - Build: cd plugin && npm run build (generates lib/) - Test: node tests/run-all.mjs ## License MIT © 2026 songoao25