前言¶

在 DeepSeek Harness（DSH）裏跑 OpenCode Go 時，套餐餘量、token 消耗和花費分散在官方頁面或會話日誌裏，切換會話後也不容易對照「當前這次對話」到底用了多少。若要在 composer 輸入框旁持續看到配額與消耗，通常得手動查用量接口或翻日誌。

dsh-ocgo-lite 由 OK-wx 維護，是 DSH 的客戶端插件：在聊天輸入框下方（composer dock）常駐展開 OpenCode Go 套餐餘量圓環、token 與花費統計，並支持一鍵複製 API Key。數據直讀 DSH 會話事件與官方用量接口，零外部依賴。

這是什麼¶

dsh-ocgo-lite 面向使用 DSH web 界面、且本機已登錄 OpenCode Go 的開發者。插件在 composer dock 固定顯示一條狀態欄，彙總賬戶配額、token 明細與按模型估算的花費；點擊各區域可展開詳情卡片。分類爲客戶端插件，GitHub 倉庫 OK-wx/dsh-ocgo-lite 當前約 10 stars，許可證 MIT。

核心功能¶

賬戶與配額¶

狀態條左側爲 GO 賬戶入口。點擊彈出賬戶卡片：登錄狀態、套餐、配額概覽，以及 API Key 掩碼顯示與一鍵複製（複製成功有 toast 提示）。

配額區域展示官方配額百分比圓環，健康色爲藍、黃、紅三檔。點擊可查看滾動、周、月三個窗口的進度條與重置倒計時。配額數據來自官方接口 https://opencode.ai/zen/go/v1/usage，使用 ~/.local/share/opencode/auth.json 中的 Bearer key，口徑爲賬戶級（含其他設備或軟件），不受下方範圍切換影響。

統計範圍¶

點擊範圍控件可在三種口徑間切換：

1. 全部 — 所有 DSH 會話合計
2. 本次會話 — 僅當前聊天
3. 最近對話 — 最近活躍會話的最後一次任務執行消耗，按 turn 細分，含子代理與後臺任務

切到限定會話時，若只用過一個模型會自動選中該模型。每個會話的「範圍 + 模型」選擇會被獨立記憶，切到其他會話再切回會原樣恢復。

按模型聯動¶

模型選擇器在範圍等於「本次會話」時，只列出本次會話用過的模型。選中後，狀態條上的 token 與花費按「範圍 + 模型」雙層聯動顯示。

token 與花費明細¶

token 區域顯示完整數字；點擊展開詳情卡片，含輸入、輸出、推理、緩存讀、寫，以及按模型分組明細。標題隨範圍顯示「總消耗 token」或「本次會話總消耗」；選中模型時只顯示該模型口徑。

花費區域展示累計金額與按模型花費排行（佔比條 + 各模型官方定價），隨範圍與模型聯動。金額按官方定價表估算（per 1M tokens）；無官方定價的模型不計入累計，顯示「定價未知」。內置定價表在啓動時與每 24 小時自動從 opencode.ai/docs/go 抓取覆蓋，抓取失敗靜默回退內置表。

即時性與交互¶

token 與花費數據來自 DSH 會話事件中 assistant/message 的 usage，按 provider 分組統計，覆蓋 DSH 會話中的全部 provider（opencode-go、deepseek-official 及其他套餐，自動識別切換）。

Client 輪詢攜帶 ?live=<sessionId> 時，Host 增量直讀會話日誌文件（多幀 zstd 解壓 + JSONL 行解析），只重讀 mtime 變化的活躍會話，未變化條目用緩存。常規輪詢通常只處理 1～2 個文件，耗時幾十到幾百毫秒；全部範圍覆蓋所有會話，不按數量截斷。冷啓動全量掃描約 5 秒，之後 5 分鐘緩存加 in-flight 鎖防重複掃描。

其他交互：點擊頁面空白處關閉詳情卡片；30 秒自動刷新且無 loading 閃爍；切換會話立即顯示（前端共享緩存）。

安裝與啓用¶

推薦通過 DSH 官方 bundle 安裝，隨 dsh web 啓動自動加載：

# GitHub 直接安裝（推薦）
dsh plugin --profile web add github:OK-wx/dsh-ocgo-lite

# 或從源碼目錄安裝
dsh plugin --profile web add <本目錄>
dsh --profile web

等價手動操作：將 dsh-ocgo-lite 加入 profile package.json 的 dependencies（link:<本目錄>）與 dsh.profile.bundles，建立 node_modules junction，並應用 cordis.patch.yml。

運行時熱裝配（免重啓）可在 DSH 會話裏使用注入器：

dev_install_package {"dir": "<本目錄>", "profile": "web"}

也可從插件市場安裝：dsh.aitreez.com、YELEBAI 插件市場或 dsh-market（收錄後可在設置 → 插件市場一鍵安裝）。社區目錄頁：SkillHub。

典型用法¶

日常查看¶

啓動 dsh --profile web 後，composer 輸入框下方常駐條自動出現。無需額外配置即可查看配額圓環、token 總數與花費；點擊各區塊展開詳情，點擊空白處關閉。

切換範圍與模型¶

在狀態條上依次點擊範圍與模型控件，對照「全部 / 本次會話 / 最近對話」及單模型口徑。切到其他聊天再切回，該會話記住上次選擇。

複製 API Key¶

點擊 GO 賬戶區域，在卡片中一鍵複製完整 API Key（通過本機同源接口 GET /ocgo-lite/key）。

對話內查詢¶

插件註冊模型工具 opencode_go_usage，可在對話裏直接查詢用量聚合數據。

Host 提供的 HTTP 接口：

• GET /ocgo-lite/api — 聚合 JSON（配額 + DSH token/花費 + 按模型/按會話 + 賬戶掩碼）
• GET /ocgo-lite/api?live=<sessionId> — 即時通道，增量直讀變化的會話日誌
• GET /ocgo-lite/key — 完整 API Key（僅本機同源）

開發時修改 lib/ 後可執行 dev_reload_package {"packageName": "dsh-ocgo-lite"} 熱重載，或重啓 dsh web。

適用場景與注意¶

適合在 DSH web 中長期使用 OpenCode Go、需要 composer 旁持續對照配額與 token/花費的開發者。插件以當前 dsh 進程權限運行，安裝前應自行檢查 源碼 與 MIT 許可證。

環境要求：

• DeepSeek Harness（dsh web）
• 本機已登錄 OpenCode Go（~/.local/share/opencode/auth.json 含 opencode-go key）
• Node.js ≥ 22.5（依賴 fetch、node:sqlite）

DSH 生態理念是「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。

結尾¶

dsh-ocgo-lite 把 OpenCode Go 套餐餘量、token 消耗與花費估算收攏到 composer dock 一條常駐條裏，支持範圍與模型聯動、會話級配置記憶和秒級日誌增量更新。目錄頁見 SkillHub，源碼與安裝說明見 GitHub。