dsh_ark_plan_usage

Developers who frequently use Volcano Ark Agent Plan used to switch to the terminal and run arkcli just to check their 5-hour, weekly, or monthly quota, which broke their flow and gave no visual progress cue. dsh_ark_plan_usage pins this usage data to the bottom of the DeepSeek Harness Web UI sidebar. Expanded, it shows a full card with a hexagonal status icon, a 5h progress bar, percentage, used/total figures, and window reset time, plus smaller weekly and monthly bars. Collapsed, it shrinks to a tiny hexagon with a percentage; hover reveals the details.

Data is fetched in real time from the local arkcli binary with a built-in 5-minute cache, staying in sync with the ark-5h-prompt terminal widget. Every failure scenario is handled gracefully: a missing arkcli triggers a red hint with install guidance; expired SSO tokens offer a one-click browser re-login button with a five-minute timeout and terminal fallback; call timeouts mark stale data; refresh failures keep whatever is already on screen so the card never goes blank.

The plugin is zero-build and zero-runtime-dependency. It injects a Node Typert Remote service via cordis.patch.yml, and the browser bundle is auto-discovered from package.json and mounted into the sidebar.footer.action slot out of the box. An environment variable lets you point to a custom arkcli path, covering Homebrew, manual, or PATH-based installs. Ideal for developers who call Volcano Ark Agent Plan daily and want a glanceable quota view right inside their web workspace.