前言¶
在 DeepSeek Harness 裏用 OpenCode Go 或 Console 按量時，額度窗口、花費和 token 往往分散在多個接口或網頁控制台裏。要自己對照滾動 / 周 / 月窗口、算本週花了多少、猜月底會不會撞線，既費時間也容易漏看。下面介紹的 OpenCode 用量面板（dsh-opencode-usage-dashboard）是社區維護的 DSH 客戶端插件：把 OpenCode 官方數據收進側欄一張卡片，用量、額度、預測、趨勢和模型分佈在一處展示，並支持多賬戶切換、服務賬號篩選與中英雙語界面。
這是什麼¶
- 名稱：
dsh-opencode-usage-dashboard（npm 包名同插件 id） - 維護者：zhxmt-xm
- 分類：客戶端（側欄 UI）
- 許可證：MIT
- 兼容：DeepSeek Harness Desktop 0.2.x（README 註明開發環境爲
0.2.1-rc.5；Web profile 同理） - 數據來源：OpenCode 官方接口（README 標明爲第三方插件，非 DSH 內置）
插件在側欄「設置」按鈕上方插入卡片；側欄收起時退化爲一個小方塊（百分比或金額）。Key 仍在 DSH 的 provider 設置裏配置（設置 → Providers，llm-pi-ai），用量面板的設置頁對 Key 只讀。
核心功能¶
側欄卡片的五個分塊¶
分塊是否出現由接口返回的數據決定，不是單靠開關僞裝（見下文「賬戶形態」）。默認側欄只開「用量」和「額度重置時間」，其餘在 設置 → OpenCode 套餐 裏打開；順序、收起、限高均可配置。
- 用量：今日花費、請求數、tokens；有月度額度時頂部油表顯示本月剩餘百分比；並排彙總今日、本週、本月。
- 額度：滾動 5 小時、本週、本月三個窗口，進度條四檔變色，帶重置倒計時；無 Go 訂閱時整塊隱藏。
- 預測：按當前計費週期花費速度線性外推，標出 50% / 100% 預計日期；無月度額度或有效數據不足兩點時隱藏。
- 趨勢：7 天 / 24 小時，花費 / tokens / 請求數可切換；無數據時顯示空態。
- 模型：按花費排序的條形圖，最多四行；無按模型計費記錄時隱藏。
卡片還支持：分塊標題旁箭頭收成一行並顯示關鍵摘要；右上角整卡收起爲一行摘要；頂部拖拽條調整卡片限高；賬戶名入口切換組織與服務賬號；手動刷新與可配置的自動刷新間隔。
多賬戶與 Console / Go¶
- 同一組織的 Key 合併成一張卡，不同組織分開；可切換「當前」賬戶，花費可按服務賬號篩選。
- 僅有 Console 按量時：額度與預測隱藏，仍保留用量、趨勢、模型。
- Go 與 Console 並存時合併展示，與「只有 Go 訂閱」時分塊一致。
插件用 GET /inference/go/v1/usage 的 200/404 判斷是否存在 Go 訂閱；provider id 隻影響優先使用哪把 Key。完整規則見倉庫 開發與原理 → 賬戶形態。
設置與偏好¶
設置 → OpenCode 套餐 含三個面板：
- 賬戶：按組織分組、切換賬戶、服務賬號篩選、刷新間隔（30 秒 / 1 分鐘 / 5 分鐘 / 15 分鐘）。
- 顯示：左側色條開關與顏色、卡片限高、進度條四檔區間與顏色（可「恢復默認」爲 0–50 綠、50–75 黃、75–90 橙、90–100 紅）。
- 卡片展示：各分塊在側欄的開關與實時預覽、拖拽排序；用量塊可選「簡化版本」僅保留今日一行佈局。
界面跟隨 DSH 主題，中英雙語，README 寫明無外部 CDN，偏好只存在本機。
安裝與啓用¶
環境¶
- DeepSeek Harness 0.2.x。
- 具備 OpenCode Go 訂閱，或僅有 Console 用量的 OpenCode 賬戶。
- 本機可訪問
opencode.ai。
從 DSH 插件市場安裝（推薦）¶
- 打開 DSH → 設置 → 插件（或插件市場）。
- 搜索
dsh-opencode-usage-dashboard，或搜「OpenCode 額度」。 - 點擊 安裝；裝完側欄應出現卡片。
市場版本跟隨 npm 發佈；README 說明 1.2.0 及之後的功能（分塊收起、統一提示氣泡等）需要市場版本 ≥ 1.2.0。資料中 npm 包當前版本爲 1.2.1。
重要：插件在 host 側註冊了 /api/opencode-quota/* 路由，屬於 host 模塊，無法熱替換。首次安裝或升級後請點「重啓」，不要只「刷新頁面」——刷新可能報 import failed，重啓即可。
從 GitHub 安裝¶
Desktop profile：
dsh plugin --profile desktop add github:zhxmt-xm/dsh-opencode-usage-dashboard
Web profile：
dsh plugin --profile web add github:zhxmt-xm/dsh-opencode-usage-dashboard
github: 源需本機能連 github.com:443 的 git 協議。若連不上，可改用 npm，或使用帶 tag 的 codeload tarball，例如：
dsh plugin --profile web add https://codeload.github.com/zhxmt-xm/dsh-opencode-usage-dashboard/tar.gz/refs/tags/v1.2.1
從 npm 安裝¶
dsh plugin --profile desktop add dsh-opencode-usage-dashboard
從舊包名遷移¶
2026-10-30 之前包名爲 @local/dsh-opencode-quota（0.1.0），與現包不是同一個包。升級須先卸載再安裝，否則兩份並存、側欄仍是舊卡片：
dsh plugin --profile web remove @local/dsh-opencode-quota
dsh plugin --profile web add dsh-opencode-usage-dashboard
裝完同樣建議 重啓 DSH。
典型用法¶
經過上面的安裝並重啓後，日常可以按下面順序使用（均來自 README 描述的界面行爲）：
- 在 DSH 設置 → Providers 配置 OpenCode 相關 Key（
llm-pi-ai）。 - 展開側欄卡片，點頂部 賬戶名 在組織與服務賬號之間切換；需要即時數據時點 刷新。
- 在 設置 → OpenCode 套餐 → 賬戶 調整自動刷新間隔。
- 在 卡片展示 面板打開「趨勢」「模型」「預測」等分塊，拖拽排序；若側欄較窄，可對單個分塊點標題旁箭頭收成一行。
- 有 Go 訂閱時查看 額度 三窗口與 預測 曲線；僅 Console 時重點看 用量、趨勢 與 模型。
趨勢圖的 7 天 / 24 小時與指標切換在「卡片展示」右側預覽裏直接點，無單獨「趨勢圖」設置頁。
適用場景與注意¶
適合誰：長期在 DSH 裏調用 OpenCode、需要隨時對照額度窗口與花費、或管理多組織 / 多 Key 的開發者。
使用前請知悉：
- 插件以 當前 DSH 進程的權限 運行，會向 OpenCode 官方端點拉取用量數據；安裝前建議自行查看 GitHub 源碼 與 MIT 許可證。
- DSH 社區插件目錄（如 SkillHub 插件頁）爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；「一切皆插件」是 DSH 的產品思路，本面板屬於其中的第三方客戶端擴展。
- 數據準確性取決於 OpenCode 接口與賬戶形態；無 Go 訂閱時不要期望看到額度 / 預測分塊。
結尾¶
OpenCode 用量面板把 Go 訂閱額度、Console 花費、趨勢與月度預測收進 DSH 側欄，減少反覆打開網頁控制台或手算窗口重置時間。安裝優先走 DSH 插件市場或上述官方命令，裝完記得重啓進程。
