Introduction¶
DeepSeek Harness (DSH) relies on its plugin ecosystem to extend functionality. Among them, dsh-agy provides a low-level channel for direct access to Google’s internal API. However, in the native interface, the model list for dsh-agy is often filled with internal ghost models and lacks intuitive quota display.
dsh-agy-ui is a companion UI enhancement plugin for dsh-agy. It does not intervene in low-level network communication, streaming parsing, or Tool dispatch; it focuses only on purifying and enhancing the frontend interaction layer.
Plugin Positioning¶
This plugin is maintained by Erick0412-dev and follows the MIT license.
Its core responsibilities include:
* Model list purification: Filter internal debug models, standardize Tiered model naming, and sort models in scientific descending order.
* Quota visualization: Provide a real-time quota badge in the top bar and display full-window quota details in a popup.
* Compatibility: Maintain an independent namespace and coexist with other plugins such as dsh-agy-link.
Core Features¶
Intelligent Model List Purification¶
The native dsh-agy model list can be cluttered. This plugin automatically performs the following operations:
1. Filter ghost models: Automatically remove internal debug or code-completion-dedicated models such as chat_23310 and tab_flash_lite_preview.
2. Collapse thinking tiers: Fold thinking-tier variants such as -low, -medium, and -high under the root model and inject standard declarations to invoke DSH’s native thinking selector.
3. Standardize naming: Format Tiered models (such as gemini-3.8-flash-tiered) into readable brand names.
4. Scientific sorting: Sort by descending priority to ensure primary models (such as the Gemini Flash series) are displayed first.
Top Bar Real-Time Quota Badge¶
Continuously display quota status in the conversation top bar:
* Persistent display: Show the currently tightest quota tier (for example, AGY · 55%).
* Rate lock: Include a built-in 120-second rate lock to avoid frequent requests that may trigger Google 429 throttling.
* Visual feedback: Feature a dynamic breathing animation. Green indicates normal status, yellow indicates cooling/throttling, and gray indicates no available account.
Lightweight Frosted-Glass Quota Detail Popup¶
Click or hover over the top bar badge to reveal quota details:
* Full-window display: Show quotas grouped by upstream for the 5-hour / day / week / month windows.
* Special handling: Display windows not returned as — with a gray empty bar, rather than 0%, to distinguish “unknown” from “exhausted.”
* Interaction support: Support “pinning” for persistent display; hovering with the mouse can also reveal the popup.
Mobile Bottom-Drawer Card Adaptation¶
On devices with a screen width of 640px or less, the popup automatically converts into an iOS/Android-style bottom drawer, with a semi-transparent mask and optimized touch-to-close behavior.
Namespace Isolation¶
All styles are scoped within the agy-ui-* namespace to prevent global CSS pollution. If reading from the low-level RPC channel fails, the plugin automatically falls back to the legacy HTTP channel.
Installation and Enabling¶
Prerequisites¶
Ensure that the underlying Provider dsh-agy has been installed and configured.
Installation Steps¶
- Open a terminal and run the official installation command:
dsh plugin --profile web add dsh-agy-ui
- Start or restart DSH Web:
dsh web
- Refresh the browser page at
http://127.0.0.1:3080to see the top bar badge and the purified model list.
Notes¶
- Pure UI companion: This plugin does not handle any network requests or data flows. All low-level logic remains handled by
dsh-agy. - Account configuration: If the top bar badge shows a gray dot, add a Google account in DSH Settings → Antigravity and complete login.
- RPC fallback: When the RPC channel is unavailable, the plugin automatically attempts to use the legacy HTTP channel, so functionality is not completely lost.
Links¶
- GitHub repository: Erick0412-dev/dsh-agy-ui
- Official catalog: DSH Plugin Catalog