hj633-aqi 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yujiale
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# hj633-aqi
+
+[![npm](https://img.shields.io/npm/v/hj633-aqi)](https://www.npmjs.com/package/hj633-aqi)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+Claude Code skill：按中国生态环境标准 **HJ 633—2026《环境空气质量指数（AQI）技术规定（试行）》**（2026-02-14 发布，2026-03-01 实施，代替 HJ 633—2012）计算、核对与解释 AQI / IAQI / 首要污染物 / 级别与颜色。
+
+核心是零依赖的 Python 脚本 `scripts/hj633.py`：官方表 3 全部断点、分段线性插值（式 1）、**向上进位取整**（4.2.6）、日报/实时报两种口径（4.2.2 / 4.2.3）、SO₂ 1h 与 O₃ 8h 封顶注 b/c、缺项发布规则（5.3.1）、IAQI 反推浓度、2012 版对照。自带 4875 项审计用例全部通过（`scripts/accuracy_audit.py`）。
+
+## 安装（一键）
+
+```bash
+npm install -g hj633-aqi
+```
+
+postinstall 会自动把 skill 复制到 `~/.claude/skills/hj633-aqi/`（若设置了 `CLAUDE_CONFIG_DIR` 则装到 `$CLAUDE_CONFIG_DIR/skills/`）。重启 Claude Code 会话后生效。
+
+不想全局安装也可以：
+
+```bash
+npx hj633-aqi            # 安装
+npx hj633-aqi uninstall  # 移除
+```
+
+或手动安装：
+
+```bash
+git clone https://github.com/jialeyu0888-code/hj633-aqi ~/.claude/skills/hj633-aqi
+```
+
+## 使用
+
+在 Claude Code 里直接问即可自动触发，例如：
+
+- 「PM2.5 日均 75 μg/m³ 对应 IAQI 多少？」
+- 「日报口径：PM2.5 55、PM10 90、O₃ 日最大 8h 160、SO₂ 12、NO₂ 35、CO 0.8，算 AQI 和首要污染物」
+- 「IAQI=100 时各污染物的浓度限值是多少？」
+- 「2026 版和 2012 版断点差在哪？」
+
+skill 会强制走脚本计算，不口算、不套用 2012 断点。
+
+也可以直接用命令行（无需 Claude）：
+
+```bash
+# 单污染物 IAQI
+python ~/.claude/skills/hj633-aqi/scripts/hj633.py iaqi --pollutant PM2.5 --conc 75 --avg 24h
+
+# 日报 AQI + 首要污染物
+python ~/.claude/skills/hj633-aqi/scripts/hj633.py aqi --mode daily \
+  --pm25 55 --pm10 90 --o3 160 --so2 12 --no2 35 --co 0.8 --assume-complete
+
+# 实时报（O₃ 为 1h；颗粒物 1h 浓度仍查 24h 断点）
+python ~/.claude/skills/hj633-aqi/scripts/hj633.py aqi --mode realtime --pm25 55 --o3 188 --no2 90 --assume-complete
+
+# 由 IAQI 反推浓度 / 全表限值 / 级别 / 敏感人群 / 2012 对照
+python ~/.claude/skills/hj633-aqi/scripts/hj633.py reverse --pollutant PM2.5 --iaqi 100 --avg 24h
+python ~/.claude/skills/hj633-aqi/scripts/hj633.py limits
+python ~/.claude/skills/hj633-aqi/scripts/hj633.py category --aqi 165
+python ~/.claude/skills/hj633-aqi/scripts/hj633.py sensitive --pollutant O3
+python ~/.claude/skills/hj633-aqi/scripts/hj633.py compare-2012 --pollutant PM2.5 --conc 75 --avg 24h
+```
+
+所有子命令支持 `--json`。
+
+## 2026 版相对 2012 版的关键变化
+
+| 项目 | 2012 | 2026 |
+|------|------|------|
+| PM₂.₅ 24h，IAQI=100 | 75 μg/m³ | **60** μg/m³ |
+| PM₁₀ 24h，IAQI=100 | 150 μg/m³ | **120** μg/m³ |
+| 取整 | GB/T 8170 修约 | **向上进位** |
+| 实时报颗粒物 | 部分实现混用 1h 断点 | 明确用 **24h 断点** |
+| 敏感人群 | 无独立表 | 新增表 2 |
+| 超标污染物 | 有定义 | **删除** |
+
+其余气态污染物断点与 2012 相同；SO₂ 1h > 800 μg/m³ 时 IAQI 按 200 计（注 b），O₃ 8h > 800 μg/m³ 时按 300 计（注 c）。
+
+## 目录结构
+
+```
+├── SKILL.md              # skill 定义（Claude Code 的入口）
+├── references/
+│   ├── standard.md       # 标准完整条文摘录
+│   └── breakpoints.json  # 表 3 断点（机器可读）
+├── scripts/
+│   ├── hj633.py          # 计算 CLI（标准库，零依赖）
+│   ├── test_hj633.py     # 单元测试
+│   ├── accuracy_audit.py # 全表准确率审计（可 --compare-iaqi 对照外部实现）
+│   └── batch_csv_aqi.py  # CSV 批量计算
+├── evals/evals.json      # skill 触发与正确性评测用例
+└── bin/install.js        # npm 安装器
+```
+
+## 验证
+
+```bash
+npm test    # 即 python scripts/accuracy_audit.py，4875 项用例
+```
+
+## License
+
+[MIT](LICENSE)
+
+## Disclaimer
+
+本工具按公开发布的标准文本实现，仅供技术参考；正式发布空气质量指数请以生态环境主管部门口径为准。

package/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: hj633-aqi
+description: >
+  在计算、核对、解释或实现中国环境空气质量指数时必须使用。触发词包括 AQI、IAQI、
+  空气质量指数、空气质量分指数、首要污染物、HJ 633、HJ633、HJ 633—2026、HJ 633—2012、
+  优/良/轻度污染/中度污染/重度污染/严重污染、PM2.5/PM10/O3/SO2/NO2/CO 与 AQI 换算、
+  日报/实时报/预报 AQI、分指数浓度限值、IAQI 断点、合川/hechuan 空气质量指数。
+  即使用户只说「这个浓度对应多少 AQI」「谁是首要污染物」「IAQI=100 时 PM2.5 是多少」
+  也要使用本技能，不要口算、不要套用 2012 断点。
+---
+
+# HJ 633—2026 环境空气质量指数（AQI）
+
+生态环境部 2026-02-14 发布、2026-03-01 实施，代替 HJ 633—2012。
+原文 PDF 可在生态环境部官网（mee.gov.cn）检索「HJ 633—2026」获取。
+
+**数字一律跑脚本，禁止口算。** 市面上不少实现沿用 2012 断点或抄错高段限值，以本技能脚本为准。
+
+## 先跑计算
+
+脚本：`scripts/hj633.py`（标准库，无第三方依赖）。
+
+```bash
+# 单污染物 IAQI
+python "<skill>/scripts/hj633.py" iaqi --pollutant PM2.5 --conc 75 --avg 24h
+
+# 日报 AQI + 首要污染物（O3 为日最大 8h）
+python "<skill>/scripts/hj633.py" aqi --mode daily --pm25 55 --pm10 90 --o3 160 --so2 12 --no2 35 --co 0.8 --assume-complete
+
+# 实时报（O3 为 1h；颗粒物 1h 浓度仍用 24h 断点）
+python "<skill>/scripts/hj633.py" aqi --mode realtime --pm25 55 --o3 188 --no2 90 --assume-complete
+
+# 由 IAQI 反推浓度（「IAQI=100 时各污染物限值」）
+python "<skill>/scripts/hj633.py" reverse --pollutant PM2.5 --iaqi 100 --avg 24h
+
+# 表 3 全表 / 级别颜色 / 敏感人群 / 2012 对照
+python "<skill>/scripts/hj633.py" limits
+python "<skill>/scripts/hj633.py" category --aqi 165
+python "<skill>/scripts/hj633.py" sensitive --pollutant O3
+python "<skill>/scripts/hj633.py" compare-2012 --pollutant PM2.5 --conc 75 --avg 24h
+```
+
+加 `--json` 便于引用。完整条文见 [references/standard.md](references/standard.md)。
+
+## 核心规则（写代码或解释时必须遵守）
+
+1. **式(1)** 分段线性插值：
+   \(IAQI_P = \dfrac{IAQI_{Hi}-IAQI_{Lo}}{BP_{Hi}-BP_{Lo}}(C_P-BP_{Lo})+IAQI_{Lo}\)
+2. **式(2)** \(AQI=\max(IAQI_P)\)，对已参与计算的污染物取最大分指数。
+3. **4.2.6** IAQI 与 AQI **全部向上进位取整**（`math.ceil`），不是四舍五入，也不是银行家修约。浓度本身按 GB/T 8170 修约（气态/颗粒物整数 μg/m³，CO 一位小数 mg/m³）。
+4. **日报 4.2.2**：SO₂/NO₂/CO/PM₁₀/PM₂.₅ 用 **24h 平均**，O₃ 用 **日最大 8h 平均**。
+5. **实时报 4.2.3**：六项都用 **1h 平均浓度**；但 **PM₁₀、PM₂.₅ 的 1h 浓度仍查表 3 的 24h 断点**（式(1) 说明）。SO₂/NO₂/CO/O₃ 的 1h 断点仅用于实时报（表 3 注 a）。
+6. **预报 4.2.5**：逐日同日报，逐时同实时报。
+7. **首要污染物 4.3.1**：仅当 **AQI > 50** 时报告；取 IAQI 最大者；并列则全部列出。AQI≤50 不报首要污染物。2026 版已删除「超标污染物」术语。
+8. **表 3 注 b**：SO₂ 1h **> 800 μg/m³ → IAQI = 200**（没有 300/400/500 档）。
+9. **表 3 注 c**：O₃ 8h **> 800 μg/m³ → IAQI = 300**（没有 400/500 档）。
+10. **5.3.1 缺项发布**：缺测时先用其余项算 AQI。**AQI>100 仍发布**；**AQI≤100 则 AQI 标 NA**，只发单项浓度和分指数。缺测填 NA，方案未开展填 `/`。
+11. **5.3.2**：方案未监测某项，且连续三年未出现以其为首要污染物的轻度及以上污染，可不影响 AQI 发布。
+12. 点位/县/城市浓度统计按 **HJ 663**（城市是站点浓度均值再算 AQI，不是站点 AQI 的平均）。达标评价按 **GB 3095** 和 HJ 663，不用本标准替代。
+
+## 2026 相对 2012 的变化
+
+| 项目 | 2012 | 2026 |
+|------|------|------|
+| PM₂.₅ 24h，IAQI=100 | 75 μg/m³ | **60** μg/m³ |
+| PM₁₀ 24h，IAQI=100 | 150 μg/m³ | **120** μg/m³ |
+| 取整 | GB/T 8170 修约 | **向上进位** |
+| 实时报颗粒物 | 部分实现混用 1h 断点 | 明确用 **24h 断点** |
+| 敏感人群 | 无独立表 | 新增表 2 |
+| 超标污染物 | 有定义 | **删除** |
+
+其余气态污染物断点与 2012 相同。IAQI=50 档 PM₂.₅ 仍为 **35**（征求意见稿曾写 30，正式稿未采纳）。
+
+## 表 3 速查（IAQI → 浓度）
+
+单位：CO 为 mg/m³，其余 μg/m³。`—` 表示该档不定义。
+
+| IAQI | SO₂ 24h | SO₂ 1h | NO₂ 24h | NO₂ 1h | CO 24h | CO 1h | O₃ 8h | O₃ 1h | PM₁₀ 24h | PM₂.₅ 24h |
+|------|--------|--------|--------|--------|--------|-------|-------|-------|---------|----------|
+| 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+| 50 | 50 | 150 | 40 | 100 | 2 | 5 | 100 | 160 | 50 | 35 |
+| 100 | 150 | 500 | 80 | 200 | 4 | 10 | 160 | 200 | **120** | **60** |
+| 150 | 475 | 650 | 180 | 700 | 14 | 35 | 215 | 300 | 250 | 115 |
+| 200 | 800 | 800 | 280 | 1200 | 24 | 60 | 265 | 400 | 350 | 150 |
+| 300 | 1600 | — | 565 | 2340 | 36 | 90 | 800 | 800 | 420 | 250 |
+| 400 | 2100 | — | 750 | 3090 | 48 | 120 | — | 1000 | 500 | 350 |
+| 500 | 2620 | — | 940 | 3840 | 60 | 150 | — | 1200 | 600 | 500 |
+
+反推「某 IAQI 对应浓度」用 `reverse`；不要把实时报 SO₂ 的 100 档写成 475（那是 24h 档）。
+
+## 级别、颜色、健康指引（表 1 + 附录 A）
+
+| AQI | 级别 | 类别 | RGB | 对健康影响（摘要） | 建议措施（摘要） |
+|-----|------|------|-----|-------------------|------------------|
+| 0–50 | 一级 | 优 | 0,228,0 | 基本无污染 | 正常活动 |
+| 51–100 | 二级 | 良 | 255,255,0 | 极少数异常敏感者可能有较弱影响 | 该人群减少户外活动 |
+| 101–150 | 三级 | 轻度污染 | 255,126,0 | 易感人群症状轻度加剧，健康人刺激症状 | 儿童、老人、心肺疾病患者减少长时间高强度户外锻炼 |
+| 151–200 | 四级 | 中度污染 | 255,0,0 | 易感症状加剧，可能影响健康人心肺 | 上述人群避免长时间高强度户外锻炼，一般人群适量减少 |
+| 201–300 | 五级 | 重度污染 | 153,0,76 | 心肺疾病患者显著加剧，健康人普遍出现症状 | 敏感人群留室内停止户外运动，一般人群减少 |
+| 301–500 | 六级 | 严重污染 | 126,0,35 | 健康人耐受力降低，强烈症状 | 儿童老人病人留室内，一般人群避免户外活动 |
+
+完整措辞以脚本 `category` 或 [references/standard.md](references/standard.md) 表 1 为准。CMYK 见附录 A。
+
+IAQI>100 时的敏感人群（表 2）：SO₂ 哮喘/儿童/老人；NO₂ 呼吸系统疾病/儿童/老人；CO 心血管病；O₃ 呼吸系统疾病/儿童/户外活动频繁者/老人；PM₁₀ 与 PM₂.₅ 心血管或呼吸系统疾病/儿童/户外活动频繁者/老人。
+
+## 回答结构
+
+计算类问题按这个顺序写，避免只丢一个整数：
+
+1. 口径（日报 / 实时报 / 预报）与平均时段
+2. 各污染物浓度 → IAQI（注明向上进位）
+3. AQI = max(IAQI)
+4. 首要污染物（AQI>50 才报；并列全部列出）
+5. 级别 / 类别 / 颜色
+6. 若 IAQI>100：点名该污染物的敏感人群
+7. 若有缺测：说明 5.3.1 是否把 AQI 标成 NA
+
+## 常见实现错误
+
+- 日报与实时报断点不同，不要用一份 1h 表打所有口径。
+- 一些旧实现把 SO₂ 1h 的 100 档写成 475（那是 24h 档值）、O₃ 1h 的 400 档封成 1200，**与表 3 不符**。以本技能表 3 为准。
+- 官方发布序列在新标准实施初期仍可能按 2012 断点出数；对账时用 `compare-2012` 并写明口径。
+- 城市 AQI 不是各站 AQI 的平均。
+
+## 发布时效（第 5 章）
+
+- 日报：自然日，次日 **12:00** 前
+- 实时报：整点后发布上一小时，滞后不超过 **1 小时**
+- 预报：至少未来 **3 日**（不含当日），每日 **20:00** 前
+- 发布主体：地级及以上城市生态环境主管部门或其授权机构

package/bin/install.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * hj633-aqi skill 安装器。
+ * `npm install -g hj633-aqi` 后由 postinstall 自动执行；也可手动运行：
+ *   npx hj633-aqi             安装 / 更新到最新已下载版本
+ *   npx hj633-aqi uninstall   移除已安装的 skill
+ * 目标目录：$CLAUDE_CONFIG_DIR/skills/hj633-aqi（未设置时为 ~/.claude/skills/hj633-aqi）
+ */
+"use strict";
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const SKILL_NAME = "hj633-aqi";
+const COPY_ITEMS = ["SKILL.md", "references", "scripts", "evals"];
+const EXCLUDES = [/^__pycache__$/, /\.pyc$/];
+
+function install() {
+  const src = path.resolve(__dirname, "..");
+  const claudeDir =
+    process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), ".claude");
+  const dest = path.join(claudeDir, "skills", SKILL_NAME);
+
+  // 在本仓库内开发时源即目标，跳过
+  if (path.relative(src, dest) === "") {
+    console.log("[hj633-aqi] 源目录即目标目录（本仓库内开发），跳过安装。");
+    return;
+  }
+
+  for (const item of COPY_ITEMS) {
+    const s = path.join(src, item);
+    if (!fs.existsSync(s)) continue;
+    const d = path.join(dest, item);
+    fs.rmSync(d, { recursive: true, force: true });
+    fs.mkdirSync(path.dirname(d), { recursive: true });
+    if (fs.statSync(s).isDirectory()) copyDir(s, d);
+    else fs.copyFileSync(s, d);
+  }
+  console.log(`[hj633-aqi] skill 已安装到 ${dest}`);
+  console.log("[hj633-aqi] 重启 Claude Code 会话后生效，试试问一个 AQI 计算问题。");
+}
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (EXCLUDES.some((re) => re.test(entry.name))) continue;
+    const s = path.join(src, entry.name);
+    const d = path.join(dest, entry.name);
+    if (entry.isDirectory()) copyDir(s, d);
+    else fs.copyFileSync(s, d);
+  }
+}
+
+function uninstall() {
+  const claudeDir =
+    process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), ".claude");
+  const dest = path.join(claudeDir, "skills", SKILL_NAME);
+  if (!fs.existsSync(dest)) {
+    console.log(`[hj633-aqi] 未发现已安装的 skill（${dest}）。`);
+    return;
+  }
+  fs.rmSync(dest, { recursive: true, force: true });
+  console.log(`[hj633-aqi] 已移除 ${dest}`);
+}
+
+const cmd = process.argv[2];
+if (cmd === "uninstall" || cmd === "--uninstall") uninstall();
+else install();

package/evals/evals.json

@@ -0,0 +1,42 @@
+{
+  "skill_name": "hj633-aqi",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "某监测站今天 PM2.5 日均 75 μg/m³，PM10 日均 90，O3 日最大 8 小时 140，SO2 12，NO2 28，CO 0.7。按 HJ 633—2026 算日报 AQI、各项 IAQI 和首要污染物，并说明和 2012 版差在哪。",
+      "expected_output": "使用 hj633.py 计算。PM2.5=75 → IAQI 114（向上进位）；AQI=114；首要污染物 PM2.5；2012 版同一浓度 PM2.5 IAQI=100。",
+      "files": [],
+      "expectations": [
+        "PM2.5 日均 75 的 IAQI 为 114 而不是 100 或 113",
+        "AQI 等于最大 IAQI 114",
+        "首要污染物为 PM2.5（或 PM₂.₅）",
+        "说明 2026 的 IAQI=100 档 PM2.5 为 60 而非 75",
+        "取整方式为向上进位"
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "实时报：SO2 一小时 900 μg/m³，其他五项都很低。SO2 的 IAQI 是多少？能不能报 300 以上？",
+      "expected_output": "表 3 注 b：SO2 1h >800 时 IAQI 按 200 计，没有 300/400/500 档。",
+      "files": [],
+      "expectations": [
+        "SO2 1h 900 的 IAQI 为 200",
+        "引用表 3 注 b 或「高于 800 按 200 计」",
+        "不使用 24h 断点把 900 插到 150–200 以上"
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "列出 IAQI=50、100、150、200 时 PM2.5、PM10、O3 8h、NO2 1h 的浓度限值。AQI=48 要不要报首要污染物？PM2.5 和 PM10 分指数都是 120 怎么报？",
+      "expected_output": "限值来自表 3；AQI≤50 不报首要污染物；并列时全部列出。",
+      "files": [],
+      "expectations": [
+        "PM2.5 在 IAQI 100 为 60 μg/m³",
+        "PM10 在 IAQI 100 为 120 μg/m³",
+        "O3 8h 在 IAQI 100 为 160 μg/m³",
+        "明确 AQI 不大于 50 时不报告首要污染物",
+        "IAQI 并列最大时并列为首要污染物"
+      ]
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "hj633-aqi",
+  "version": "1.0.0",
+  "description": "Claude Code skill for China HJ 633—2026 air quality index (AQI/IAQI): official breakpoints, piecewise interpolation, ceil rounding, categories and primary pollutant.",
+  "bin": {
+    "hj633-aqi": "bin/install.js"
+  },
+  "files": [
+    "SKILL.md",
+    "references/",
+    "scripts/",
+    "evals/",
+    "bin/"
+  ],
+  "scripts": {
+    "postinstall": "node bin/install.js",
+    "prepack": "node -e \"require('fs').rmSync('scripts/__pycache__',{recursive:true,force:true})\"",
+    "test": "python scripts/accuracy_audit.py"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "skill",
+    "agent-skills",
+    "aqi",
+    "iaqi",
+    "hj633",
+    "air-quality",
+    "china",
+    "环境空气质量指数"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jialeyu0888-code/hj633-aqi.git"
+  },
+  "engines": {
+    "node": ">=16.7"
+  }
+}

package/references/breakpoints.json

@@ -0,0 +1,47 @@
+{
+  "standard": "HJ 633—2026",
+  "iaqi_nodes": [0, 50, 100, 150, 200, 300, 400, 500],
+  "units": {
+    "SO2": "ug/m3",
+    "NO2": "ug/m3",
+    "O3": "ug/m3",
+    "PM10": "ug/m3",
+    "PM2.5": "ug/m3",
+    "CO": "mg/m3"
+  },
+  "breakpoints": {
+    "SO2": {
+      "24h": [0, 50, 150, 475, 800, 1600, 2100, 2620],
+      "1h": [0, 150, 500, 650, 800, null, null, null]
+    },
+    "NO2": {
+      "24h": [0, 40, 80, 180, 280, 565, 750, 940],
+      "1h": [0, 100, 200, 700, 1200, 2340, 3090, 3840]
+    },
+    "CO": {
+      "24h": [0, 2, 4, 14, 24, 36, 48, 60],
+      "1h": [0, 5, 10, 35, 60, 90, 120, 150]
+    },
+    "O3": {
+      "8h": [0, 100, 160, 215, 265, 800, null, null],
+      "1h": [0, 160, 200, 300, 400, 800, 1000, 1200]
+    },
+    "PM10": {
+      "24h": [0, 50, 120, 250, 350, 420, 500, 600]
+    },
+    "PM2.5": {
+      "24h": [0, 35, 60, 115, 150, 250, 350, 500]
+    }
+  },
+  "caps": {
+    "SO2_1h_above_800": 200,
+    "O3_8h_above_800": 300
+  },
+  "pm_realtime_uses_24h_breakpoints": true,
+  "rounding": "ceil",
+  "primary_pollutant_when_aqi_gt": 50,
+  "changes_from_2012": {
+    "PM2.5_24h_iaqi_100": {"from": 75, "to": 60},
+    "PM10_24h_iaqi_100": {"from": 150, "to": 120}
+  }
+}

package/references/standard.md

@@ -0,0 +1,207 @@
+# HJ 633—2026 环境空气质量指数（AQI）技术规定（转录）
+
+> 据生态环境部正式文本转录，供技能检索。计算以 `scripts/hj633.py` 为准。
+> 发布：2026-02-14；实施：2026-03-01；代替 HJ 633—2012。
+> ICS 13.040；CCS Z 04。英文名：Technical specifications on ambient air quality index.
+
+## 前言
+
+为贯彻《中华人民共和国环境保护法》《中华人民共和国大气污染防治法》，保护生态环境，保障公众健康，规范环境空气质量指数发布工作，制定本标准。
+
+本标准规定了环境空气质量指数的分级方案、计算方法、级别与类别，以及日报、实时报和预报的发布内容、格式和其他要求。
+
+本标准首次发布于 2012 年。本次为第一次修订，主要变化：
+
+- 调整空气质量分指数对应的可吸入颗粒物（PM₁₀）和细颗粒物（PM₂.₅）浓度限值及说明；
+- 增加空气污染物的敏感人群；
+- 调整日报和实时报指标，调整实时报中颗粒物空气质量分指数的计算方法；
+- 删除超标污染物的定义和确定方法；
+- 调整发布要求，增加数据完整性要求。
+
+附录 A 为规范性附录。
+
+本标准由生态环境部大气环境司、法规与标准司组织制订。
+
+起草单位：中国环境监测总站、中国环境科学研究院、上海市环境监测中心。
+
+本标准由生态环境部 2026 年 2 月 14 日批准，自 2026 年 3 月 1 日起实施。自实施之日起，《环境空气质量指数（AQI）技术规定（试行）》（HJ 633—2012）废止。
+
+本标准由生态环境部解释。
+
+## 1 适用范围
+
+本标准规定了环境空气质量指数的分级方案、计算方法、级别与类别，还规定了空气质量指数日报、实时报和预报的发布内容、发布格式和其他相关要求。
+
+本标准适用于点位、县（市、区、旗）、城市环境空气质量指数日报、实时报和预报工作，用于向公众提供健康指引，并支撑环境管理。
+
+## 2 规范性引用文件
+
+下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
+
+- GB 3095 环境空气质量标准
+- GB/T 8170 数值修约规则与极限数值的表示和判定
+- HJ 663 环境空气质量评价技术规范
+- HJ 664 环境空气质量监测点位布设技术规范
+
+## 3 术语和定义
+
+GB 3095、HJ 663、HJ 664 界定的以及下列术语和定义适用于本文件。
+
+### 3.1 空气质量指数 air quality index（AQI）
+
+定量描述空气质量状况的无量纲指数。
+
+### 3.2 空气质量分指数 individual air quality index（IAQI）
+
+单项污染物的空气质量指数。
+
+### 3.3 首要污染物 primary pollutant
+
+空气质量指数大于 50 时，空气质量分指数最大的空气污染物。
+
+## 4 空气质量指数计算方法
+
+### 4.1 空气质量指数分级
+
+**4.1.1** 空气质量指数的范围为 1—500，划分为 6 个级别和类别。不同级别空气质量指数的表示颜色、对健康影响情况和建议采取的措施见表 1，空气污染物的敏感人群见表 2。
+
+**表 1 空气质量指数及相关信息**
+
+| 空气质量指数 | 级别 | 类别及表示颜色 | 对健康影响情况 | 建议采取的措施 |
+|---|---|---|---|---|
+| 0–50 | 一级 | 优，绿色 | 空气质量令人满意，基本无空气污染 | 各类人群可正常活动 |
+| 51–100 | 二级 | 良，黄色 | 空气质量可接受，但某些污染物可能对极少数异常敏感人群健康有较弱影响 | 极少数异常敏感人群应减少户外活动 |
+| 101–150 | 三级 | 轻度污染，橙色 | 易感人群症状有轻度加剧，健康人群出现刺激症状 | 儿童、老年人及心脏病、呼吸系统疾病患者应减少长时间、高强度的户外锻炼 |
+| 151–200 | 四级 | 中度污染，红色 | 进一步加剧易感人群症状，可能对健康人群心脏、呼吸系统有影响 | 儿童、老年人及心脏病、呼吸系统疾病患者避免长时间、高强度的户外锻炼，一般人群适量减少户外运动 |
+| 201–300 | 五级 | 重度污染，紫色 | 心脏病和肺病患者症状显著加剧，运动耐受力降低，健康人群普遍出现症状 | 儿童、老年人和心脏病、肺病患者应停留在室内，停止户外运动，一般人群减少户外运动 |
+| 301–500 | 六级 | 严重污染，褐红色 | 健康人群运动耐受力降低，有明显强烈症状，提前出现某些疾病 | 儿童、老年人和病人应当留在室内，避免体力消耗，一般人群应避免户外活动 |
+
+说明：正文 4.1.1 写范围为 1—500；表 1 优档从 0 起算。AQI=0 时按优/一级处理。
+
+**表 2 空气污染物的敏感人群**
+
+| IAQI 超过 100 的污染物 | 建议采取措施的敏感人群 |
+|---|---|
+| 二氧化硫（SO₂） | 患有哮喘的人、儿童（包括青少年）以及老年人 |
+| 二氧化氮（NO₂） | 患有呼吸系统疾病（如哮喘）的人、儿童（包括青少年）以及老年人 |
+| 一氧化碳（CO） | 患有心血管系统疾病的人 |
+| 臭氧（O₃） | 患有呼吸系统疾病（如哮喘）的人、儿童（包括青少年）、户外活动频繁的人以及老年人 |
+| 可吸入颗粒物（PM₁₀）、细颗粒物（PM₂.₅） | 患有心血管系统疾病或呼吸系统疾病（如哮喘）的人、儿童（包括青少年）、户外活动频繁的人以及老年人 |
+
+### 4.2 空气质量指数计算
+
+**4.2.1** 空气质量指数可按照点位、县（市、区、旗）、城市分别计算，按统计时段分为日报、实时报和预报。
+
+**4.2.2 日报指标** 包括 SO₂、NO₂、CO、PM₁₀、PM₂.₅ 的 24 小时平均以及 O₃ 日最大 8 小时平均，共 6 项。统计时段为自然日。点位、县（市、区、旗）、城市的 6 项污染物浓度依据 HJ 663 相关要求计算。SO₂、NO₂、O₃、PM₁₀、PM₂.₅ 单位为 μg/m³，按 GB/T 8170 修约到整数；CO 单位为 mg/m³，修约到 1 位小数。
+
+**4.2.3 实时报指标** 包括 SO₂、NO₂、CO、O₃、PM₁₀ 和 PM₂.₅ 的 1 小时平均，共 6 项。统计时段为当前 1 小时平均。浓度单位和修约要求同 4.2.2。
+
+**4.2.4** 日报和实时报中，污染物项目 P 的空气质量分指数按式 (1) 和表 3 计算，空气质量指数按式 (2) 计算：
+
+$$IAQI_P = \frac{IAQI_{Hi}-IAQI_{Lo}}{BP_{Hi}-BP_{Lo}}(C_P-BP_{Lo})+IAQI_{Lo} \tag{1}$$
+
+式中：
+
+- \(IAQI_P\) —— 污染物项目 P 的空气质量分指数；
+- \(C_P\) —— 污染物项目 P 的质量浓度值；
+- \(BP_{Hi}\) —— 表 3 中与 \(C_P\) 相近的污染物浓度限值的高位值；当 \(C_P\) 为 PM₁₀ 或 PM₂.₅ 的 1 小时平均时，取表 3 中 24 小时平均的高位值；
+- \(BP_{Lo}\) —— 表 3 中与 \(C_P\) 相近的污染物浓度限值的低位值；当 \(C_P\) 为 PM₁₀ 或 PM₂.₅ 的 1 小时平均时，取表 3 中 24 小时平均的低位值；
+- \(IAQI_{Hi}\) —— 表 3 中与 \(BP_{Hi}\) 对应的空气质量分指数；
+- \(IAQI_{Lo}\) —— 表 3 中与 \(BP_{Lo}\) 对应的空气质量分指数。
+
+$$AQI = \max \{ IAQI_P \} \tag{2}$$
+
+**4.2.5** 预报的统计时段分为逐日预报和逐时预报。逐日预报的计算方法同 4.2.2 和 4.2.4；逐时预报的计算方法同 4.2.3 和 4.2.4。
+
+**4.2.6** 环境空气质量指数及空气质量分指数的计算结果应全部向上进位取整数，不保留小数。
+
+**表 3 空气质量分指数及对应的污染物项目浓度限值**
+
+| IAQI | SO₂ 24h | SO₂ 1hᵃ | NO₂ 24h | NO₂ 1hᵃ | CO 24h | CO 1hᵃ | O₃ 8h | O₃ 1hᵃ | PM₁₀ 24h | PM₂.₅ 24h |
+|------|---------|---------|---------|---------|--------|--------|-------|--------|----------|-----------|
+| 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
+| 50 | 50 | 150 | 40 | 100 | 2 | 5 | 100 | 160 | 50 | 35 |
+| 100 | 150 | 500 | 80 | 200 | 4 | 10 | 160 | 200 | 120 | 60 |
+| 150 | 475 | 650 | 180 | 700 | 14 | 35 | 215 | 300 | 250 | 115 |
+| 200 | 800 | 800 | 280 | 1200 | 24 | 60 | 265 | 400 | 350 | 150 |
+| 300 | 1600 | —ᵇ | 565 | 2340 | 36 | 90 | 800 | 800 | 420 | 250 |
+| 400 | 2100 | —ᵇ | 750 | 3090 | 48 | 120 | —ᶜ | 1000 | 500 | 350 |
+| 500 | 2620 | —ᵇ | 940 | 3840 | 60 | 150 | —ᶜ | 1200 | 600 | 500 |
+
+单位：SO₂、NO₂、O₃、PM₁₀、PM₂.₅ 为 μg/m³；CO 为 mg/m³。
+
+- 注 a：SO₂、NO₂、CO 和 O₃ 的 1 小时平均浓度限值仅用于实时报。
+- 注 b：SO₂ 1 小时平均浓度高于 800 μg/m³ 的，IAQI 按照 200 计。
+- 注 c：O₃ 8 小时平均浓度高于 800 μg/m³ 的，IAQI 按照 300 计。
+
+相对 HJ 633—2012：仅 PM₁₀、PM₂.₅ 的 IAQI=100 档由 150→120、75→60；其余断点不变。IAQI=50 档 PM₂.₅ 仍为 35（征求意见稿曾出现 30，正式稿未采纳）。
+
+### 4.3 首要污染物的确定
+
+**4.3.1** 当 AQI 大于 50 时，IAQI 最大的污染物为首要污染物。若 IAQI 最大的污染物为两项或两项以上时，并列为首要污染物。
+
+（2012 版中的「超标污染物」定义及判定方法已删除，不得再按旧标准输出「超标污染物」字段作为本标准要求。）
+
+## 5 空气质量指数发布要求
+
+### 5.1 发布内容和主体
+
+**5.1.1** 日报、实时报的发布内容包括：评价时段、地理位置、各污染物的浓度及空气质量分指数、空气质量指数、首要污染物、空气质量指数级别、类别和表示颜色；报告时应说明监测指标和缺测指标。发布内容参考表 4、表 5。预报的发布内容至少包括空气质量指数、首要污染物、空气质量指数级别、类别和表示颜色。
+
+**5.1.2** 日报、实时报和预报由各地级及以上城市生态环境主管部门或其授权的机构发布。
+
+### 5.2 发布时效性要求
+
+**5.2.1** 日报时间周期为 24 小时，时段为自然日，当日日报应于次日 12 时前向公众发布。
+
+**5.2.2** 实时报时间周期为 1 小时，每一整点时刻后即可发布上一小时的实时报，滞后时间不应超过 1 小时。
+
+**5.2.3** 预报时效至少覆盖未来 3 日（不含当日），应于每日 20 时前向公众发布。
+
+### 5.3 数据完整性要求
+
+**5.3.1** 日报和实时报中某污染物缺数或数据无效时，首先利用其他污染物监测数据计算空气质量指数、首要污染物、级别和类别等信息。当 AQI 大于 100 时仍继续发布；否则仅发布单项污染物浓度及分指数，空气质量指数等信息以 NA 标识。
+
+缺测指标的浓度及分指数均使用 **NA** 标识；监测方案未开展某污染物监测的，使用 **/** 标识。
+
+**5.3.2** 因点位、县（市、区、旗）、城市监测方案未开展某项污染物监测导致缺数，且经评估或实测表明连续三年内未出现以其为首要污染物的轻度及以上污染时，不影响空气质量指数信息发布；否则仍按照 5.3.1 执行。
+
+### 表 4 日报数据格式（字段）
+
+时间（自然日）；点位/县（市、区、旗）/城市名称；下列各项的浓度与分指数：
+
+- SO₂ 24 小时平均，μg/m³
+- NO₂ 24 小时平均，μg/m³
+- CO 24 小时平均，mg/m³
+- O₃ 日最大 8 小时平均，μg/m³
+- PM₁₀ 24 小时平均，μg/m³
+- PM₂.₅ 24 小时平均，μg/m³
+
+以及：AQI、首要污染物、空气质量指数级别、类别、颜色。
+
+### 表 5 实时报数据格式（字段）
+
+时间（年-月-日-时）；点位/县（市、区、旗）/城市名称；下列各项的 **1 小时平均** 浓度与分指数：SO₂、NO₂、CO、O₃、PM₁₀、PM₂.₅（CO 为 mg/m³，其余 μg/m³）。以及 AQI、首要污染物、级别、类别、颜色。
+
+## 6 其他要求
+
+**6.1** 本标准未明确的其他浓度统计方法和数据统计有效性规定，按 GB 3095 和 HJ 663 的要求执行。
+
+**6.2** 评价环境空气质量达标状况时，应依据 GB 3095 和 HJ 663 的规定进行（不得用 AQI 代替达标评价）。
+
+## 附录 A（规范性）空气质量指数类别的表示颜色
+
+空气质量指数类别的表示颜色应符合表 A.1。
+
+**表 A.1 RGB 及 CMYK 配色方案**
+
+| 颜色 | R | G | B | C | M | Y | K | 对应类别 |
+|------|---|---|---|---|---|---|---|---------|
+| 绿 | 0 | 228 | 0 | 40 | 0 | 100 | 0 | 优 |
+| 黄 | 255 | 255 | 0 | 0 | 0 | 100 | 0 | 良 |
+| 橙 | 255 | 126 | 0 | 0 | 52 | 100 | 0 | 轻度污染 |
+| 红 | 255 | 0 | 0 | 0 | 100 | 100 | 0 | 中度污染 |
+| 紫 | 153 | 0 | 76 | 10 | 100 | 40 | 30 | 重度污染 |
+| 褐红 | 126 | 0 | 35 | 30 | 100 | 100 | 30 | 严重污染 |
+
+注：RGB 为电脑屏幕显示色彩，CMYK 为印刷色彩模式。