dsh-system-control
A persistent DeepSeek Harness (DSH) web plugin that embeds a DeepSeek API balance readout and a full-shutdown button directly above the Settings entry in the left sidebar.
| |
|---|
| Balance | 余额 ¥0.69 — read from $DSH_HOME/.credentials.yaml, fetched live from https://api.deepseek.com/user/balance |
| Shutdown | Black minimalist line-art power button — flushes every session, then exits the whole Harness (web UI + child processes + main process) |
✨ Features
- Sidebar-embedded, not floating — registers into
sidebar.footer.action, rendered directly above the Settings button; no card chrome, no clipping, follows the active theme tokens.
- Live balance display — auto-refreshes after every model API call (via the
llm/stream event), polls every 25 s, and refreshes on click.
- Black minimalist shutdown — a pure line-art power icon (no circle, no fill, no border). A confirm dialog appears first; on confirm it:
- Flushes every live session (
sessions.flush) so all conversation data is durable;
- Gracefully exits the whole Harness (
appExit(0)) — the launcher disposes the tree (stops the web UI, terminates child processes) and exits the process;
- Hard fallback (
process.exit(0) after 1.5 s) so the web UI is guaranteed to go down even if the graceful controller stalls.
- Clean row — the official Cordis panel icon cell is hidden while this plugin is active, so the footer stays tidy.
- Collapsed rail friendly — on the 56px rail the confirm row switches to a compact
退出？ prompt.
- Failure-friendly — balance read errors show
获取失败 (fetch failed) instead of breaking the UI; click to retry.
📦 Install
From Git (available now)
dsh plugin --profile web add git+https://github.com/lnetrit-alt/dsh-system-control.git
From npm (pending)
The package is prepared for the npm registry (dsh-system-control); publishing is pending account 2FA setup. Once published:
dsh plugin --profile web add dsh-system-control
Local development
git clone https://github.com/lnetrit-alt/dsh-system-control.git
dsh plugin --profile web add ./dsh-system-control
Restart the Harness (or refresh the page — the client half hot-reloads via dsh-client-hmr; the host half loads at boot).
🖥️ Usage
- View balance: the footer row shows
余额 ¥0.69 (currency symbol mapped from the API: CNY → ¥, USD → $, EUR → €, GBP → £).
- Refresh manually: click the balance text.
- Refresh automatically: after every model API call and every 25 s.
- Shut down: click the power icon → confirm → all sessions are saved and the whole Harness process exits (web UI included).
🔧 How it works
- Host half (
lib/index.js): registers the /system-control/api route (same browser-trust fence as the official /api gateway — loopback or trustedHosts, same-origin only), serving balance and shutdown; listens to llm/stream to refresh the cached balance after each API call.
- Client half (
lib/client.js): a dsh.client bundle registering two sidebar.footer.action cells — one that replaces (hides) the official cordis-panel icon, and one that renders the balance + shutdown row.
- Shutdown sequence:
sessions.flush → appExit(0) (graceful tree disposal) → process.exit(0) hard fallback.
🤖 Model Experience
The plugin is a UI-only surface: it registers no model-visible tools and changes no agent behavior. The model does not need to know it exists.
⚠️ Known Limitations and Deferred Work
- Requires the DSH launcher's
appExit service (provided by dsh / dsh web); in an embedding host without it, shutdown reports an error instead of exiting.
- Balance currency symbol is mapped from the API response; multi-currency accounts show the first
balance_infos entry.
- The official Cordis plugin-panel icon is hidden from the sidebar footer while this plugin is active.
- npm publishing is pending account 2FA setup (see Install).
📄 License
MIT
