DeepSeek Harness plugin

dsh-ocg-billing

OpenCode Go billing layer: cached official pricing, bill computation, and a composer bill line.

Jump to install

Source facts

Repository
hiro-nikaitou/dsh-ocg-billing
Latest update
Aug 16, 2026
Category
Usage & Billing
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/hiro-nikaitou/dsh-ocg-billing
Plugin: dsh-ocg-billing
Author: hiro-nikaitou

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

dsh-ocg-billing

中文 | English

OpenCode Go billing layer for DeepSeek Harness (dsh).

This plugin adds a billing layer on top of dsh's existing usage tracking (per-session TokenUsage recorded in session logs). It fetches the official OpenCode Go pricing docs once, caches the price table to disk, and re-checks it proactively — billing always runs against the cache, never against a live fetch. It also calls the default model to analyze the bill, and shows a resident bill line under the web composer.

> This is a community plugin, not affiliated with DeepSeek AI or OpenCode. Prices are estimates computed from the official docs; actual charges come from your OpenCode Go subscription statement.

Features

  • Resident bill line (web UI) — under the composer card (conversation.composer.dock): global 7-day cost, monthly limit progress, current-session cost, top models, price-source freshness. Auto-refreshes every 60s; click to refresh instantly.
  • Cached official pricing — ocg_pricing_check re-fetches opencode.ai/docs/go, diffs against the cache, and updates the cache only when the table changed (force: true forces a refresh). A 24h background check runs automatically. Billing never re-queries the website.
  • Bill computation — ocg_bill: global (all sessions in the last N days) or per-session (scope=session + sessionId), broken down by model and by session. Uses the official per-1M-token rates including Cached Read / Cached Write, and tiered rates (GPT 5.6 Luna 272K, Qwen3.7/3.6 Plus 256K). Unknown models are listed at zero cost.
  • Default-model analysis — ocg_bill_analyze computes the bill and asks the default model (the agent-default-model selection, e.g. opencode-go/deepseek-v4-flash) for a summary, anomalies, top cost drivers, and saving recommendations.

Install

Prerelease note: DeepSeek Harness is in developer preview; peer ranges follow the installed 0.1.0-rc.6 mainline.

# from a profile dsh plugin --profile web add <path-to-this-repo> # or link:/absolute/path # or overlay-style in ~/.dsh/config.yaml # - insert: # - id: ocg-billing # name: '@hiro-nikaitou/dsh-ocg-billing'

Restart dsh web. The bill line appears under the composer once the plugin loads (browser half activates after approval).

Tools (model-visible)

ToolPurpose
ocg_pricing_statusCached price table, source, fetch time, cache health. Never fetches.
ocg_pricing_checkProactively re-fetch the official docs and diff against the cache; updates only on change (or force).
ocg_billBill computation: global or per-session, by model and by session.
ocg_bill_analyzeBill + default-model analysis (summary, anomalies, savings).

How it works

  • Price cache: D:\appdata\dsh\ocg-billing\pricing.json (first run seeds from the built-in snapshot of the official docs; seed flag in status). Model list: 20 docs models + extra seed entries for models configured but not listed in the docs (source tagged models.dev/unknown).
  • Usage source: relies on dsh's existing usage records — request/header + assistant/message events in each session log (the same data live-stats reads). Global scope aggregates sessions created within the window; session scope prices one sessionId.
  • Fetch channel: ctx.subprocess + curl.exe (the bash/shell seam is unavailable on Windows); falls back to ctx.shell elsewhere.
  • RPC: client polls GET /api/ocg-billing/panel?sessionId=... (registered via ctx.webServer); the host caches the global aggregation for 5 minutes.

Pricing rules

  • cacheRead billed at the official cache-read rate (fallback: input rate); cacheWrite at the official rate (fallback: output rate).
  • Tiered models pick the tier by per-request input tokens.
  • Unknown models are priced at 0 and reported in unknownModels.
  • Subscription fee ($10/month) is shown as reference, not added to usage cost.

License

[MIT](LICENSE)

Disclaimer

Prices are parsed from the official docs page and may lag or mis-parse after upstream layout changes — run ocg_pricing_check to refresh. This plugin is not affiliated with DeepSeek AI or OpenCode.