npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-env-index

v0.1.0

Published

Environmental index toolkit for DeepSeek Harness (zero runtime deps, fully offline): AQI calculation with per-pollutant IAQI piecewise interpolation and primary pollutant determination per HJ 633-2026 Table 3 breakpoints, surface water single-factor gradi

Readme

dsh-env-index

生态环境指数工具箱:空气质量指数(AQI)计算与首要污染物判定、地表水单因子评价定类、超标倍数与达标率、产排污系数法核算排放量。零运行时依赖,完全离线;标准断点表与限值表均以带出处的数据表内置并支持外部注入替换。

功能一览

| 工具 | 功能 | | --- | --- | | calc_aqi | AQI 计算:六项污染物浓度按 HJ 633—2026 表 3 断点分段线性插值求 IAQI(向上进位取整),AQI 取最大 IAQI,输出级别/类别/颜色、首要污染物(并列并列)、逐项插值段与出处;支持 daily(日报)与 hourly(实时报)两种口径 | | water_grade | 地表水单因子评价:按 GB 3838-2002 表 1 限值逐项定类(I~V/劣V,总磷区分河流与湖、库口径),综合类别取最差单项;可选目标类别输出各项超标倍数与达标率 | | calc_emission | 产排污系数法:产生量=活动水平×产污系数,排放量=产生量×(1-收集效率×治理去除率×投运率)×(1-废水回用率);可选实测浓度/标准限值对标输出超标倍数与达标率 |

安装

在 DeepSeek Harness 的插件目录下引入本包并按 cordis.patch.yml 注册(与其他 dsh 插件一致)。

使用说明

calc_aqi

参数:

  • pollutants:JSON 对象字符串,键可选 so2、no2、co、o3、pm10、pm2.5,值为浓度(so2/no2/o3/pm 单位 μg/m³,co 单位 mg/m³)。
  • period:daily(日报口径:SO2/NO2/CO 日平均、O3 日最大 8 小时平均、PM10/PM2.5 日平均断点)或 hourly(实时报口径:1 小时平均断点;PM10/PM2.5 1 小时平均取日平均断点,HJ 633—2026 式 1 注)。
  • breakpoints(可选):外部断点表 JSON 字符串,同名覆盖内置表。

计算口径(HJ 633—2026):

  • IAQI 分段线性插值:IAQI = (IAQI_Hi - IAQI_Lo)/(BP_Hi - BP_Lo) × (C - BP_Lo) + IAQI_Lo;
  • 计算结果全部向上进位取整数(4.2.6);AQI = MAX(IAQI);
  • 首要污染物:AQI > 50 时 IAQI 最大的污染物,并列时全部输出(4.3.1);
  • 封顶规则(表 3 脚注):SO2 1 小时 >800 μg/m³ 按 IAQI 200 计;O3 8 小时 >800 μg/m³ 按 IAQI 300 计;
  • 浓度超出表 3 最高档断点时 IAQI 按 500 计并在输出中标注。

water_grade

参数:

  • samples:JSON 对象字符串,键为项目名(支持中文名与常用缩写:pH、溶解氧、高锰酸盐指数、化学需氧量(COD)、五日生化需氧量(BOD5)、氨氮、总磷、总氮),值为浓度(mg/L,pH 无量纲)。
  • water_type:river(河流)或 lake(湖、库)——影响总磷/总氮限值口径。
  • target_class(可选):目标水质类别(I~V),提供时输出各项超标倍数 (实测-标准)/标准 与达标率。
  • standards(可选):外部限值 JSON 字符串,同名覆盖内置表,可注入自定义项目(结构 {项目键: {label, type: le|ge|range, grades|range, lake_grades?, unit, basis?}})。
  • exclude(可选):不参与评价的项目键 JSON 数组,默认排除总氮(行业惯例:水温、总氮、粪大肠菌群不参与评价,水利部珠江委通报口径)。

单因子评价:各项独立定类(≤型逐档比对、DO 为≥型、pH 为 6~9 区间型),综合水质类别取最差单项(就高不就低);pH 超出 6~9 记"劣V"并注明。

calc_emission

参数 sources(JSON 数组字符串,最多 200 项),每项:

{
  "name": "锅炉废气",
  "activity": 1000,
  "factor": 2.5,
  "factor_unit": "kg/t产品",
  "removal_rate": 0.9,
  "collection_efficiency": 0.95,
  "operation_rate": 0.9,
  "reuse_rate": 0.3,
  "measured": 45,
  "limit": 50
}
  • 产生量 = activity × factor;有效去除 = collection_efficiency × removal_rate × operation_rate;排放量 = 产生量 × (1-有效去除) × (1-reuse_rate)。
  • 缺省效率项不参与折减并在输出中标注(本插件不内置任何默认系数)。
  • measured 与 limit 必须成对提供,输出该项超标倍数 (实测-标准)/标准 与达标与否,汇总输出达标率与最大超标项。

典型场景

  1. 空气质量日报/实时报:把当期六项浓度喂给 calc_aqi,拿到 AQI、级别颜色、首要污染物与逐项分指数,直接对接发布格式(HJ 633—2026 表 4/表 5)。
  2. 断面水质定类:water_grade 一次给全各项浓度,输出单因子定类与综合类别;设定目标类别(如 III 类考核)即得超标倍数清单与达标率。
  3. 企业排放核算:calc_emission 按产污系数与治理设施参数核算产生/排放量,同时对标排放标准给出超标倍数与达标率,用于排污许可执行报告与执法初筛。

安全边界与限制(必读)

  • 数据表版本与出处:
    • AQI 断点表:《环境空气质量指数(AQI)技术规定》HJ 633—2026(生态环境部 2026-02-14 批准、2026-03-01 实施,替代并废止 HJ 633—2012 试行版)表 3,断点逐格核验自生态环境部官方发布文本;分级与类别取自表 1。
    • 地表水限值表:《地表水环境质量标准》GB 3838-2002 表 1 基本项目(内置 pH、溶解氧、高锰酸盐指数、COD、BOD5、氨氮、总磷、总氮 8 项常用项;溶解氧 I 类按"饱和率 90%(或 7.5)"取 7.5 口径)。其余 13 项(汞、镉、铅等)未内置,可经 standards 注入。
    • 产排污系数口径:生态环境部《产排污系数手册》核算框架及地方 VOCs 核算办法(×(1-收集效率×去除率×投运率))。
  • 版本差异提示:HJ 633—2012(试行)已废止;仍在使用旧版断点或 API 口径的系统,须经 breakpoints 显式注入旧表并注意 SO2/O3 封顶与向上进位取整的口径差异。地方补充标准(如地方大气污染物标准、流域补充项目)须经 breakpoints/standards 注入替换,不得直接沿用内置值。
  • 系数零默认值:产污系数、治理效率、投运率随行业/工艺/设施变化,本插件不内置任何默认系数,未提供的效率项不参与折减并明确标注,防止默认值误核量。
  • 口径边界:AQI 按 HJ 633 计算与发布;环境空气质量达标状况评价须依据 GB 3095 与 HJ 663(HJ 633—2026 第 6.1/6.2 条),本插件输出不替代达标判定。地表水为单因子评价法,与综合污染指数法结论可能不同。
  • 未内置项:空气污染物年评价、首要污染物的健康指引(表 2 敏感人群)、数据完整性规则(5.3 缺数处理)与发布格式(表 4/表 5)不在 v0.1 范围;水质的水温、粪大肠菌群、金属类等项目未内置。
  • 输出数字保留 2 位小数(比率 4 位);大规模核算(>200 项)请分批调用。

出处

  • HJ 633—2026《环境空气质量指数(AQI)技术规定》表 1/表 3、4.2(计算方法)、4.3(首要污染物)、6.1/6.2(引用 GB 3095、HJ 663)。
  • GB 3095《环境空气质量标准》、HJ 663《环境空气质量评价技术规范》(达标评价与统计口径引用)。
  • GB 3838-2002《地表水环境质量标准》表 1 基本项目标准限值;水利部珠江水利委员会水环境质量通报(21 项参与评价惯例)。
  • 生态环境部《产排污系数手册》系列(行业系数核算框架与治理效率修正);地方 VOCs 排污权核算办法(收集效率×去除率×投运率口径)。

其他插件集成说明

  • 与 dsh-series-qc(监测时序质检)上下游配合:质检判定数据有效后,再由本插件算指数/定类。
  • 与 dsh-stats-toolkit 互补:stats 做通用统计,本插件做标准分级判定(领域规范口径)。
  • 纯函数 calcAqi / gradeWater / calcEmission / calcIaqi 已导出,可被其他插件直接 import 复用(遵循"领域层不重写底座层算法"约定)。

RoadMap

  • v0.1:AQI 六项分指数与综合指数(双口径+封顶规则)、地表水单因子定类(8 项常用+注入)、产排污系数核算与浓度对标。
  • v0.2 计划:补齐 GB 3838 金属类/特定项目完整限值表;增加空气质量年评价(优良天数比例、综合指数)与 HJ 663 达标判定;数据完整性校验(HJ 633—2026 5.3)。

FAQ

Q:为什么和天气 App 的 AQI 有时不一致?
A:请先确认口径:日报用 24h/8h 断点、实时报用 1h 断点(PM 除外,PM 1 小时用日均断点),两者结果本就不同;另外本插件按 HJ 633—2026(2026-03-01 起实施)计算,旧版系统可能仍用 HJ 633—2012 口径。

Q:AQI 算出来是小数吗?
A:不是。HJ 633—2026 4.2.6 规定计算结果全部向上进位取整数,本插件逐项 IAQI 与最终 AQI 均为整数。

Q:浓度超过断点表最高档怎么办?
A:IAQI 按 500 计并在输出中标注"超出表 3 最高档限值";如当地需要 IAQI>500 的续算口径,请经 breakpoints 注入扩展断点表。

Q:总磷为什么河流和湖库结果不同?
A:GB 3838-2002 对总磷(及总氮)区分河流与湖、库两套限值(如 III 类:河流 0.2、湖库 0.05 mg/L),请按水体类型正确传入 water_type。

Q:产污系数去哪里查?
A:按行业查生态环境部《产排污系数手册》对应分册(或排污许可证申请与核发技术规范附录),把系数与治理设施参数传入 sources;本插件只做核算链,不内置任何系数。