Goben1623/aqi-liberator
GitHub: Goben1623/aqi-liberator
一个用于从 aqicn.org 批量解码并导出十余年历史空气质量数据的命令行工具,将 AQI、PM2.5 等指标转换为 CSV 或 JSON 格式以便本地分析和存档。
Stars: 0 | Forks: 0
# 🧩 aqi-liberator - 释放你的 AQI 历史数据
[](https://github.com/Goben1623/aqi-liberator)
## 🌬️ 这个应用能做什么
aqi-liberator 帮助你解码来自 aqicn.org 的历史 AQI 数据,并将其转换为你可以在自己电脑上使用的普通文件。
在以下情况下使用它:
- 从 aqicn.org 提取过去的空气质量数据
- 处理 AQI、PM2.5 和污染记录
- 以更易于阅读的格式保存数据
- 保留数据的本地副本供自己使用
它在一个简单的命令行窗口中运行,但你不需要深厚的技术功底即可上手
## 📥 在 Windows 上下载并安装
使用此链接访问项目主页并获取文件:
https://github.com/Goben1623/aqi-liberator
### 需要查找的内容
在项目主页上,查找以下内容之一:
- Windows 下载文件
- 发布文件
- 可以保存到电脑的 ZIP 文件
如果你看到 ZIP 文件,请将其保存到 Downloads 或 Desktop 等文件夹中,然后打开并解压内容
### 如果你获得了一个 Windows 应用文件
如果下载提供的是 `.exe` 文件,请执行以下操作:
1. 双击该文件
2. 按照屏幕上的步骤操作
3. 如果 Windows 请求权限,请选择“是”
4. 安装完成后打开应用
### 如果你获得了一个 ZIP 文件
如果下载提供的是 `.zip` 文件,请执行以下操作:
1. 右键点击该 ZIP 文件
2. 选择“全部解压”
3. 选择一个你以后能找到的文件夹
4. 打开解压后的文件夹
5. 运行里面的程序文件
## 🖥️ 运行前准备
为获得最佳效果,请在装有 Windows 10 或 Windows 11 的电脑上使用:
- 正常工作的互联网连接
- 足够的数据文件可用磁盘空间
- 在你有权访问的文件夹中保存文件的权限
- 如果项目使用基于脚本的安装设置,则需要最新版本的 Python
如果你不确定该用什么,请从项目主页上的下载文件开始,并按照随附的说明进行操作
## 🚀 首次运行
打开应用或命令窗口后,你通常需要选择要解码的数据以及保存位置
常见的首次运行步骤如下:
1. 打开应用或命令提示符
2. 将其指向 AQI 数据源
3. 选择你想要的日期范围或位置
4. 开始解码过程
5. 等待输出文件完成
如果应用要求提供文件夹,请选择一个空文件夹,以便轻松找到输出内容
## 🧭 如何使用该工具
aqi-liberator 专为处理历史 AQI 数据而构建。标准工作流程如下:
1. 选择你想要的 aqicn.org 数据
2. 将数据解码为可读文件
3. 在文本编辑器或电子表格中查看结果
4. 保存文件以备后用
你可以将输出用于:
- 检查过去的空气质量趋势
- 比较不同日期的 PM2.5 水平
- 制作图表
- 保存污染数据的本地存档
## 📁 预期输出
应用可能会创建以下文件:
- 用于电子表格的 `.csv` 文件
- 用于结构化数据的 `.json` 文件
- 用于纯文本输出的 `.txt` 文件
- 包含已解码 AQI 记录的文件夹
如果你在 Excel、Google Sheets 或文本编辑器中打开输出内容,应该无需额外工具即可检查数据
## 🛠️ 常见安装路径
你可能会在项目主页上看到以下安装方式之一:
### 选项 1:可直接运行的 Windows 文件
下载文件并直接运行
### 选项 2:ZIP 压缩包
解压 ZIP 文件并运行其中的文件
### 选项 3:基于 Python 的安装设置
如果项目提供源文件,请先安装 Python,然后从命令窗口运行脚本
对于基于 Python 的安装设置,通常的步骤是:
1. 从 Python 官方网站安装 Python
2. 下载或克隆此代码仓库
3. 打开项目文件夹
4. 运行主脚本
5. 按照窗口中的提示操作
## 🧪 故障排除
### 文件无法打开
请尝试以下操作:
- 右键点击该文件并选择“以管理员身份运行”
- 检查文件是否已下载完成
- 确保文件没有还留在 ZIP 压缩包中
- 将文件移动到 Downloads 等简单文件夹中
### Windows 提示已阻止该文件
如果 Windows 显示安全提示,如果你信任该来源,请选择允许你打开该文件的选项
### 应用立即关闭
尝试从命令提示符运行它,以便你能看到屏幕上的消息
### 没有出现输出文件
请检查以下几点:
- 输出文件夹是否存在
- 你是否有权限写入该文件夹
- 源数据路径是否正确
- 日期范围内是否包含数据
### 数据看起来有问题
首先尝试缩小日期范围。然后检查:
- 时区设置
- 源文件格式
- 国家或站点选择
- 数据是否被解码成了正确的字段顺序
## 🧰 使用数据的有效方法
获得输出后,你可以:
- 按日期对 AQI 值进行排序
- 筛选 PM2.5 读数
- 比较不同地区的站点数据
- 在 Excel 中制作简单的图表
- 备份空气质量历史记录
## 📌 项目主题
该项目符合以下主题:
- 空气质量
- AQI
- aqicn
- CLI
- 数据释放
- 开放数据
- pm25
- 污染
- Python
- 逆向工程
## 🔗 项目主页
在此访问项目主页:
https://github.com/Goben1623/aqi-liberator
## 🧭 接下来你应该做什么
1. 打开项目主页
2. 获取 Windows 文件或 ZIP 压缩包
3. 将其保存到你的电脑
4. 如果需要,将其解压
5. 运行应用并解码你的 AQI 数据
标签:AQI, aqicn.org, CSV, JSON, PM2.5, Python, 二进制发布, 代码示例, 历史数据, 开源工具, 数据分析, 数据导出, 数据提取, 数据转换, 文档结构分析, 无后门, 本地存储, 环境保护, 空气质量指数, 逆向工具