dsh-green-meter

Green DSH Desktop

给 DeepSeek Harness（DSH）做的开源桌面应用：一边用 AI 干活，一边看清这次对话花了多少电、排了多少碳、省了多少钱。

无论你跑本地模型，还是接云端 API（DeepSeek / OpenRouter / 自建中转站…），它都能把每一次请求的能耗、碳排和费用算清楚、亮出来，并在烧钱烧碳的时候提醒你。

English · 中文

它能做什么

1. 开箱即用的 DSH 桌面版

• 自带 Node.js 24 运行时和完整 DSH 发行版，装完即用，不需要 Node / pnpm / Python；
• 完整的 DSH 对话体验：模型管理、会话、工具调用、技能、子代理、工作流都在；
• Windows 安装包 + 便携版（zip 解压即用）。

2. 能耗 / 碳排控制台（主窗口）

页面 · 你能看到什么 控制台 · 本地碳排、本地能耗（估算与实测并列）、云端碳排（公开系数估算）、已省 API 费用；近 30 天碳排和按任务轮次碳排两张柱状图；硬件实时环图 会话 · 每个会话的 token、能耗、碳排、电费、省 API 费用 硬件监测 · NVIDIA 显卡全量遥测（显存 / 使用率 / 温度 / 功耗，多卡支持）；核显作为扩展监测；CPU / 内存曲线 预警 · 超支和异常提醒，见下 数据源 · 接入 OpenRouter 或自有中转站，拉取真实花费与 token 用量 参考数据 · 每个系数的出处与年份，全部可查证 碳台账 · 每一步的 JSONL 明细、实测能耗列、一键导出 CSV 日志 / 设置 · harness 输出、碳强度 / 电价 / API 价格等基线设置

3. 两条计量路径（核心设计）

• 本地模型 → 实测：检测到 NVIDIA 显卡后，持续采样功耗并积分，得到真实能耗，并按时间归属到每个请求步骤；需要每个模型自己的系数时，一键标定出本机的 J/token；
• 云端 API → 公开系数估算：云端只能看到 token，因此 token→能耗一律用公开权威系数（不用本地标定去推演云端）。

4. 预警：在烧钱烧碳时提醒你

• 阈值类：单会话能耗 / 费用、近 1 小时 / 24 小时费用、中转站日均花费；
• 异常类：单步能耗离群（稳健 z 分数）、上下文重读（输入:输出比过高，反复重读上下文的无效消耗）、空转 / 重试循环（连续多步几乎没有产出）、缓存命中率偏低；
• 严重级预警同时弹桌面通知。

5. 对话内嵌仪表盘

聊天窗口右上角常驻碳排卡片：本会话碳排 / 能耗 / 电费、已省 API 费用、本地 vs 云端对比、每轮能耗柱状图、全部会话累计。

6. 本地小模型开箱支持

自带 Qwen2.5-0.5B（CPU 推理）的接入脚本和 provider 配置，一条命令起服务，即刻体验"本地模型 + 实测计量"的完整闭环；换更大的模型只需改一行模型路径。

截图

控制台总览 · 对话内嵌仪表盘 ·

硬件监测（NVIDIA 多卡） · 预警 ·

会话明细 · 数据源（中转站） ·

参考数据（系数与出处） · 碳台账明细 ·

下载安装

从 Releases 下载：

文件 · 说明 Green DSH Desktop Setup x.x.x.exe · Windows 安装包（可选安装目录，桌面快捷方式） Green DSH Desktop-x.x.x-win.zip · 便携版，解压即用

安装包未做代码签名，首次启动 Windows SmartScreen 会拦截一下：更多信息 → 仍要运行。

升级直接运行新版安装包，会话 / 凭据 / 台账 / 设置自动保留。

快速上手（三步）

1. 装好打开 → 首次会提示配置模型（DSH 设置页里填 API Key，或用本地模型）；
2. 点「打开对话」干活 → 正常聊天、写代码，什么都不用改；
3. 回到控制台 → 碳排、能耗、费用、轮次图、硬件曲线都在实时刷新；在「设置」里调好电价 / API 价格 / 碳强度，数字就是你的真实口径。

想试本地模型：

powershell -ExecutionPolicy Bypass -File scripts\start-local-model.ps1

然后在应用里选「本地 llama.cpp（Qwen2.5-0.5B）」即可（需先下载模型，见脚本内注释）。

数据与方法（简述）

• 本地：token 用量 → 标定系数 → 能耗（有 NVIDIA 时以实测为准）→ 电网碳强度 → 碳排；
• 云端：token 用量 → 公开系数 → 能耗 → 碳排；
• 费用：API 牌价 vs 本地电费。

所有系数都标注来源与年份：

类别 · 数值 · 来源 中国电网 · 0.5777 kgCO₂e/kWh（2024） · 生态环境部《2024 年电力碳足迹因子》 美国电网 · 0.3497 kgCO₂e/kWh · US EPA eGRID 2023 云端 per-token · 0.0006 Wh / 输出 token · Epoch AI 2025 云端 per-request · 0.24 Wh / 0.03 gCO₂e · Google Cloud 2025-08-21 本地标定 · H20 请求级拟合（R² ≥ 0.998） · 本项目实验

边界说明（诚实优先）：无 GPU 实测时的本地数值是 token-profile 估算而非硬件实测；云端数值是基于公开系数的估算，不是厂商实测；碳排 = 能耗 × 电网碳强度，属工程估算，非认证核算。

从源码构建

git clone <本仓库>
cd green-dsh-desktop
npm install

# 1) 打包 green-meter / 仪表盘插件（需要 DSH 源码 checkout，可用 DSH_CHECKOUT 指定路径）
npm run vendor:plugins

# 2) 组装内置 harness（npm 安装 DSH 发行版 + 本地插件）
npm run pack:harness

# 3) 放入 Node 运行时（复制本机 node.exe 到 resources/runtime/）

# 4) 运行 / 打包
npm start
npm run dist

局限与说明

• 目前主要在 Windows 上开发验证；Electron 跨平台，macOS / Linux 构建路径未验证；
• 本地实测依赖 nvidia-smi（NVIDIA 显卡）；无 NVIDIA 时本地数值退化为估算，核显仅作扩展监测（只有使用率）；
• 对话数据（会话 / 凭据 / 台账）保存在安装目录的 resources/harness/dsh-home，卸载前请先备份（升级会自动保留）。

致谢

• DeepSeek Harness 与 Cordis —— 本应用是 DSH 的插件化桌面发行版；
• green-meter（本项目作者的能耗计量插件）提供 token-profile 标定；
• llama.cpp —— 本地推理；
• Electron —— 桌面壳；
• 能耗 / 碳排参考数据来自生态环境部、US EPA eGRID、Epoch AI、Google Cloud 的公开披露。

License

MIT