shsr07/dsh-go-usage1

dsh-go-usage

DSH 的 OpenCode GO 订阅用量角标组件:显示滚动/每周/每月用量百分比与重置倒计时,可收起至右侧边缘标签页。

AI 分析

核心用途是实时监控 OpenCode GO 套餐的使用额度。适合拥有 OpenCode GO 订阅并希望在 DSH 界面直观查看用量和倒计时的用户。

套件
dsh-go-usage
版本
0.1.0
授權
MIT
最近更新
2026年8月15日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:shsr07/dsh-go-usage

dsh-go-usage

English | 中文

dsh-go-usage is a DeepSeek Harness (DSH) web plugin that shows your OpenCode GO subscription usage as a bottom-right corner widget: rolling / weekly / monthly usage percentages with reset countdowns, collapsible to a right-edge vertical tab.

dsh-go-usageDeepSeek Harness (DSH) 的 Web 插件:在页面右下角以角标组件显示你的 OpenCode GO 套餐用量——滚动 / 每周 / 每月用量百分比与重置倒计时,可收起为右边缘竖条标签。

Features

  • Three usage buckets — rolling / weekly / monthly, matching the OpenCode console page.
  • Progress bars — color shifts to amber at 80% and red at 100% (rate-limited).
  • Live countdowns — "Resets in X days X hours / X hours X minutes" ticking every 15 seconds.
  • Auto refresh — re-fetches every 60 seconds; the ↻ button refreshes manually.
  • Collapsible — the » button collapses the card into a slim right-edge tab; click the tab to expand.
  • Theme-aware — follows the DSH theme: pure white in light mode, pure black in dark mode.
  • Bilingual — copy follows the DSH locale setting: Chinese (滚动用量 / 重置于 X 天 X 小时) or English (Rolling usage / Resets in X days X hours), switching live.

Requirements

  • Windows only (usage data is fetched via powershell.exe).
  • Node.js >= 24, pnpm.

Installation

Prerequisites

  • DeepSeek Harness (dsh) installed — npm install -g @deepseek-ai/dsh
  • An OpenCode account with an active GO subscription
  • The opencode-go API key present in the local opencode auth file (set up by the OpenCode CLI): %USERPROFILE%\.local\share\opencode\auth.json

From npm

dsh plugin --profile web add dsh-go-usage

From source / GitHub

git clone https://github.com/shsr07/dsh-go-usage.git
cd dsh-go-usage
pnpm install
pnpm build
dsh plugin --profile web add link:

link: points at the local checkout — after editing, re-run pnpm build and restart the web service. You can also install straight from a git host: dsh plugin --profile web add github:shsr07/dsh-go-usage# (the package ships a prepare script that builds from source; allow the build when pnpm asks).

After installation

Restart the web service (dsh web), then look at the bottom-right corner of the page.

How it works

  • The host half registers a fenced JSON route /go-usage/api/usage on the DSH web server. Each request runs one powershell.exe invocation: it reads the opencode-go API key from the local opencode auth.json, calls https://opencode.ai/zen/go/v1/usage, and returns the parsed buckets. TLS 1.2 is enabled explicitly because Windows PowerShell 5.1 defaults to older TLS.
  • The browser half registers the corner widget into the frame overlay (shell.overlay) and fetches the same-origin route every 60 seconds.
  • The route is protected by the same trust fence as the DSH /api gateway (loopback Host header or the connection row's trustedHosts), so a cross-site page cannot reach it.

Privacy

  • The API key stays on your machine: it is read from your local auth.json by the host process and never leaves it.
  • Only the three usage percentages and reset timestamps are displayed; nothing is sent anywhere except the request to opencode.ai itself.

License

MIT