dsh-green-meter

Energy & carbon estimation for agentic sessions in DeepSeek Harness. The plugin observes every model call, converts its token accounting into energy (J/kWh), carbon (g CO2e) and electricity cost (CNY) with calibrated per-model profiles, records everything in a JSONL ledger, and exposes the /green command, the green_meter tool, and the live Web readout.

Works with any API-backed provider — no hardware access needed.

Surfaces

• /green — session report: tokens, energy, carbon, cost, per-turn breakdown, cache-savings counterfactual.
• green_meter tool — the model can query its own session's energy, carbon, cost and budget.
• greenMeter session projection + dsh-client-ui-green-meter — the always-visible energy/carbon readout in the composer dock.
• Energy budget — budgetJ > 0 rejects new steps once the session estimate exceeds the budget and injects one warning.
• Ledger — one JSONL row per accounted model call (/green-meter/ledger.jsonl, schema dsh-green-meter.step.v1).

Configuration

Key	Default	Meaning
profile	proxy	calibration profile (proxy, qwen-h20-*, gemma-h20-*, qwen3-4b-*)
carbonFactorKgPerKwh	0.5777	grid carbon intensity
electricityPriceCnyPerKwh	0.56	electricity price (CNY/kWh)
dir	/green-meter	ledger directory
budgetJ	0 (off)	session energy budget in joules

Environment fallbacks: , , , , .