前言¶
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
