@sumomok/dsh-balance

Configuration

Every key is validated at load and changeable from cordis.yml. The bundle patch ships the full default block; a profile patch targeting the balance id replaces that whole block, so restate every key you want to keep.

Key	Default	Meaning
refreshMs	60000	How long a successful balance read is served. Minimum 5000.
retryMs	15000	How long a failed read suppresses further attempts. Minimum 1000.
timeoutMs	8000	Wall-clock budget for one balance request. Minimum 1000.
currency	[CNY, USD]	Currency codes in descending preference. One list serves two decisions: which balance row to show when the account holds several, and which price list to spend against before the account's own currency is known.
lowBalance	10	Warning tint below this total.
criticalBalance	1	Critical tint below this total. Must not exceed lowBalance.
ledgerDays	400	Days of ledger rows kept; older rows are dropped and the file rewritten at startup.
timezone	''	IANA zone the day and month spend boundaries are taken in. Empty means the zone the host process runs in.
root	''	Directory the ledger is written into. Empty means $DSH_HOME/dsh-balance.
surfaces.footer	true	Put up the sidebar-footer chip.
surfaces.sessionSpend	true	Put up the per-session spend line.
prices	DeepSeek's published CNY and USD rates	The price lists, one per currency. See below.

The provider connection is not configured here: the endpoint and the API-key reference are read from the llm-deepseek settings section, exactly as that provider resolves them (baseURL, then $DEEPSEEK_BASE_URL, then https://api.deepseek.com; apiKeyEnv, defaulting to DEEPSEEK_API_KEY). Point the provider somewhere else and this plugin follows.