OCG 餘量查詢

DeepSeek Harness 用戶需要同時監控 DeepSeek 官方餘額與 OpenCode Go 的 5 小時/周/月用量。直接查看控制台或多個界面效率低下。該插件將這兩項數據合併到一個懸浮膠囊中，位於主界面旁。

這是一個 DeepSeek Harness 客戶端插件，由 verneuil 維護。它在一個浮窗中同時顯示 DeepSeek 官方餘額與 OpenCode Go 的 5h/w/m 用量。它包含一個同名設置頁，用於調整刷新行爲和界面選項。

功能概覽¶

• 一屏兩套數據：在同一個懸浮膠囊中顯示 DeepSeek 官方餘額（以 ¥ 計）和 OpenCode Go 的 5h/w/m 用量。點擊浮窗即可刷新（一側失敗不影響另一側）。
• 三顆圓環：用圓環顯示百分比（默認顯示“剩餘”，可在設置中切換爲“已使用”）。顏色編碼：剩餘 > 20% 爲綠色，≤ 20% 爲琥珀色，≤ 5% 爲紅色。底盤爲 32% 透明度的同色。
• 細光軌反饋：更新時，一條細光沿膠囊周長等弧長勻速跑圈。完成後，它收束成整圈“封環”。如果失敗，則顯示紅色。
• 拖動吸附：鬆手時，浮窗自動吸附到最近的參考線（輸入框卡片邊 / 窗口邊）。尺寸變化或窗口調整時，它會跟隨錨線，不會跑位。
• 長寬恆定：浮窗在任何狀態下尺寸都不變（反饋層是絕對定位疊加層，不參與佈局）。
• 零依賴：純原生 JS，無構建步驟，無第三方運行時依賴。
• 中英雙語：所有界面文案跟隨 DSH 語言設置即時切換（浮窗、設置頁、菜單名與操作提示）。
• 主題自適應：顏色只取宿主主題令牌（--dsw-alias-*），明暗主題自動跟隨。開關、按鈕、輸入框、徽章照抄宿主組件樣式。

安裝¶

DeepSeek Harness 桌面版自帶 node / pnpm，無需額外安裝。

在 DSH 中打開插件管理頁 → 「安裝插件」對話框，粘貼以下任一 spec 並安裝（對話框會調用 pnpm，一次只能裝一個）：

# GitHub 直裝（推薦）
github:verneuil/dsh-opencode-go-usage

# 固定版本
github:verneuil/dsh-opencode-go-usage#v2.10.0

命令行等價寫法：

dsh plugin --profile web add github:verneuil/dsh-opencode-go-usage

注意：插件管理頁拒絕沒有 bundle patch 的依賴，本包自帶 cordis.patch.yml。安裝後按頁面提示刷新。

使用方法¶

• 點擊浮窗：立即刷新余額與用量。
• 拖動浮窗：移動位置，鬆手自動吸附。
• 設置頁路徑：設置 → 插件 → OCG 餘量查詢。
• 調整口徑：在設置頁切換“已使用” / “剩餘”顯示模式。
• 手動操作：在設置頁手動刷新、調整自動刷新間隔、開關餘額顯示、重置位置。

設計與兼容性¶

• 席位佔用：只佔官方 shell.overlay 席位（replaceRisk=none），不遮蔽官方 UI。
• 樣式原則：樣式只用主題令牌，無陰影、無模糊、無字面色值。
• 技術棧：不引入任何 Harness 客戶端包，控件全部自寫。宿主半側負責拉取與解析，客戶端只讀配置投影。
• 升級：升級需卸載後重裝，不支持直接覆蓋安裝。