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
Maintainers
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必须成对提供,输出该项超标倍数(实测-标准)/标准与达标与否,汇总输出达标率与最大超标项。
典型场景
- 空气质量日报/实时报:把当期六项浓度喂给
calc_aqi,拿到 AQI、级别颜色、首要污染物与逐项分指数,直接对接发布格式(HJ 633—2026 表 4/表 5)。 - 断面水质定类:
water_grade一次给全各项浓度,输出单因子定类与综合类别;设定目标类别(如 III 类考核)即得超标倍数清单与达标率。 - 企业排放核算:
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;本插件只做核算链,不内置任何系数。
