dsh-green-meter

Energy & carbon metering for DeepSeek Harness — see what your agentic sessions cost.

A dsh-plugin that turns every model call into energy (J/kWh), carbon footprint (g CO2e) and electricity cost (CNY) — estimated from token accounting, so it works with any API-backed provider (DeepSeek API, OpenAI-compatible endpoints, local vLLM) without touching hardware.

Install it, chat as usual, and watch your session's energy bill in real time.

✨ Features

🚀 Quick start

# 1. Install into your dsh profile
cd ~/.dsh/profiles/web          # (Windows: %USERPROFILE%\.dsh\profiles\web)
pnpm add dsh-green-meter dsh-client-ui-green-meter

# 2. Mount the plugins in your profile's cordis.patch.yml (see examples/)

- insert:
    - id: green-meter
      name: 'dsh-green-meter'

    - id: ui-green-meter
      name: 'dsh-client-ui-green-meter'
      config:
        panelPlacement: popover   # popover = zero-config; sidebar = optional patch

Restart dsh web, refresh, and the readout appears under the composer. Type /green anytime.

Full experience: sidebar panel (optional)

panelPlacement: sidebar renders the detail panel inside the sidebar's blank space. Apply the provided patch and rebuild one DSH package:

cd /path/to/deepseek-harness
git apply /path/to/dsh-green-meter/patches/ui-sidebar-sidebar-energy.patch
pnpm --filter @deepseek-ai/dsh-client-ui-sidebar bundle

⚙️ Configuration

Environment fallbacks: DSH_GREEN_PROFILE, DSH_GREEN_CARBON_FACTOR, DSH_GREEN_PRICE_CNY, DSH_GREEN_DIR, DSH_GREEN_BUDGET_J.

📌 Method notes

• Estimate, not measurement — energy is modeled from token accounting with calibrated per-model profiles; carbon and cost are energy × configurable factors.
• GPU operational energy only — CPU, memory, cooling and embodied carbon are out of scope.
• Cache savings are counterfactual — cached tokens that would otherwise be recomputed.

💎 thebestai

thebestai is our AI platform. 欢迎大家通过反馈意见可以使用我们的 AI Greentoken 系列服务。

Development

pnpm install
pnpm test

License

MIT