前言¶
DeepSeek Harness (DSH) 依賴插件生態擴展功能。其中，dsh-agy 提供了直連 Google 內部 API 的底層通道。但在原生界面中，dsh-agy 的模型列表往往充斥內部幽靈模型，且缺乏直觀的配額展示。
dsh-agy-ui 是一個面向 dsh-agy 的伴生 UI 增強插件。它不介入底層的網絡通信、流式解析與 Tool 調度，僅專注於前端交互層的淨化與增強。
插件定位¶
該插件由 Erick0412-dev 維護，遵循 MIT 許可證。
其核心職責包括：
* 模型列表淨化：過濾內部調試模型，規範 Tiered 模型命名，並對模型進行科學降序排列。
* 配額可視化：在頂欄提供實時配額徽章，並在彈窗中透視全窗口額度。
* 兼容性：保持獨立命名空間，與 dsh-agy-link 等其他插件共存。
核心功能¶
模型列表智能淨化¶
原生 dsh-agy 的模型列表較爲混亂。本插件會自動執行以下操作：
1. 過濾幽靈模型：自動移除 chat_23310、tab_flash_lite_preview 等內部調試或代碼補全專用模型。
2. 摺疊思考檔位：將 -low、-medium、-high 等思考檔位變體摺疊至根模型，並注入標準聲明，以調用 DSH 原生思考選擇器。
3. 規範命名：將 Tiered 模型（如 gemini-3.8-flash-tiered）格式化爲易讀的品牌名稱。
4. 科學排序：按照優先級降序排列，確保主力模型（如 Gemini Flash 系列）優先展示。
頂欄實時配額徽章¶
在會話頂欄常駐顯示配額狀態：
* 常駐顯示：展示當前最緊的那一檔配額（例如 AGY · 55%）。
* 頻率鎖：內置 120 秒頻率鎖，避免頻繁請求導致 Google 429 限流。
* 視覺反饋：具有動態呼吸微動效，綠色代表正常，黃色代表冷卻/限流，灰色代表無可用賬號。
輕量化毛玻璃配額透視彈窗¶
點擊或懸停頂欄徽章可呼出配額詳情：
* 全窗口展示：按上游分組展示 5小時 / 日 / 周 / 月 四個窗口的額度。
* 特殊處理：未返回的窗口顯示爲 — 與灰色空條，而非 0%，以區分“未知”與“已用盡”。
* 交互支持：支持點擊“釘選”常駐顯示，鼠標移入即可呼出。
移動端抽屜式卡片自適應¶
在屏幕寬度小於等於 640px 的設備上，彈窗自動轉換爲 iOS/Android 風格的底部抽屜，並配合半透明遮罩與觸控關閉優化。
命名空間隔離¶
所有樣式均限定在 agy-ui-* 命名空間內，防止全局 CSS 污染。底層 RPC 通道讀取失敗時，會自動降級回退舊版 HTTP 通道。
安裝與啓用¶
前置要求¶
確保已安裝並配置好底層 Provider dsh-agy。
安裝步驟¶
- 打開終端，執行官方安裝命令：
dsh plugin --profile web add dsh-agy-ui
- 啓動或重啓 DSH Web：
dsh web
- 刷新瀏覽器頁面
http://127.0.0.1:3080，即可看到頂欄徽章與淨化後的模型列表。
注意事項¶
- 純 UI 伴生：本插件不處理任何網絡請求或數據流，所有底層邏輯仍由
dsh-agy承擔。 - 賬號配置：如果頂欄徽章顯示灰色點，需在 DSH 設置 → Antigravity 中添加 Google 賬號並完成登錄。
- RPC 降級：當 RPC 通道不可用時，插件會自動嘗試使用舊版 HTTP 通道，不會導致功能完全失效。
鏈接¶
- GitHub 倉庫: Erick0412-dev/dsh-agy-ui
- 官方目錄: DSH Plugin Catalog
