dsh-ghg
Verifieddsh-ghg · v0.1.0-alpha.18 · Apache-2.0
Electricity activity ingest, location-based GHG calculation, row verification, workpaper and partial ESRS pack.
Install
dsh plugin add dsh-ghg Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Readme
dsh-ghg
Official repository. The only official repository of this package, maintained by PerryLink. Same-name repositories under other accounts are not affiliated. Apache-2.0.
Electricity activity ingest, location-based GHG calculation, row verification, workpaper and partial ESRS pack.
Status: alpha / public-synthetic / partial / not counted / not GA. No customer evidence, customer data, or production-readiness claim.
Maintenance status: ✅ Active
Active since 2026-11-01: feature work, hardening and fresh evidence are in progress.
English · 简体中文 · Español · Português · हिन्दी
dsh plugin --profile <profile> add dsh-ghg
⭐ If this helps, a star makes it easier for the next person to find it. Nothing is gated behind it.
Workflow: local input → plugin → local output. No model call is required.
Install
Install and verify:
dsh plugin --profile <profile> add dsh-ghg
dsh --profile <profile> --dump-config | grep dsh-ghg
Uninstall:
dsh plugin --profile <profile> remove dsh-ghg
Install channels
npm is the recommended channel; the others are for pinning or offline use.
- npm (recommended):
dsh plugin --profile <profile> add dsh-ghg - git channel:
dsh plugin --profile <profile> add github:PerryLink/dsh-ghg - tarball:
pnpm packthendsh plugin --profile <profile> add ./dsh-ghg-<version>.tgz - 1024 store:
npm i -g dsh1024thendsh1024 plugin --profile <profile> add dsh-ghg
What it does
Electricity activity ingest, location-based GHG calculation, row verification, workpaper and partial ESRS pack. Runs locally on DeepSeek Harness. The table below is the exact tool surface; the examples use the real command surface.
Input and output stay local; nothing is uploaded.
Tools
Tool names and descriptions are kept in English to match the runtime output.
| Tool | Purpose | Risk |
|---|---|---|
ghg.facility_import |
Import facility boundary metadata | R1 local write |
ghg.ingest |
Ingest electricity CSV (date/month,kwh); reject MWh/unit mismatch |
R1 local write |
ghg.ingest_pdf |
Extract date/kWh rows from a text-based PDF; no OCR or scanned PDF | R1 local write |
ghg.match_factor |
Return the electricity location factor and its public source | R0 |
ghg.factor_import |
Import a versioned public/synthetic factor | R1 local write |
ghg.scope_import |
Import public/synthetic Scope 1/3 values for the partial ESRS pack | R1 local write |
ghg.calculate |
Multiply kWh by a factor (default or imported) into tCO2e lines | R0 |
ghg.verify_row |
Recalculate all lines and return mismatches/diffs | R0 |
ghg.export_workpaper |
Export a 3-sheet xlsx: Facilities / Activities / Emissions | R1 local write |
ghg.export_esrs |
Export a partial ESRS E1 view; not assurance-grade | R1 local write |
ghg.export_esrs_pack |
Export a 4-sheet partial ESRS E1 workbook | R1 local write |
Quick start
dsh plugin --profile <profile> add dsh-ghg
dsh --profile <profile> --dump-config | grep dsh-ghg
Examples
Fixture-backed example
Input: fixtures/public/mit/energy_daily.csv
Command: pnpm test
Acceptance row:
| req_id | metric | threshold | actual | pass | source | counted |
|---|---|---|---|---|---|---|
| SKU-02-A01 | 电费活动行（30 行） | 30/30 | 30 | true | public/synthetic | false |
This is a fixture-backed acceptance row, not a customer run; no output is invented.
Limits
- Public/synthetic only; no customer data or customer evidence.
- Alpha/partial, not counted, no GA or production-readiness claim.
- No model or network call unless a tool explicitly says so.
- The exact per-tool boundaries are in the table and
ACCEPTANCE.csv.
Public sample
Public/synthetic fixtures live in fixtures/; ACCEPTANCE.csv records the public checks with counted=false.
Development
pnpm install --frozen-lockfile
pnpm build && pnpm lint && pnpm typecheck && pnpm test
Compatibility
| Surface | Status |
|---|---|
| Harness | dsh >=0.2.1-rc.3 <0.3.0 |
| Node | >=24.9.0 <25 |
| Platforms | All; local files only |
| Data | No network, no model call, no upload |
Permissions & data
- Runs locally; no network, no model call, no upload.
- Public/synthetic fixtures only; no customer data, no customer evidence.
- Alpha/partial; not counted, no GA or production-readiness claim.
- Actively maintained: new features and hardening land in alpha releases.
Related work
Sibling packages and family indexes: dsh-qms-capa · dsh-policy-ledger
Related checkers
Each entry is a separate package with its own rule pack and version; install only the ones you need.
| Package | Why it is relevant |
|---|---|
dsh-eia-guide-check |
Environmental assessment applicability and guideline sheet. |
dsh-soilwater-check |
Soil and groundwater monitoring register completeness and arithmetic. |
Family
DSH domain plugin family (15 packages + 2 suites)
Mainline family — 92 current install specs
License
Apache-2.0. See LICENSE, NOTICE, THIRD-PARTY-NOTICES.