Harry-kp/uppcl-pro

GitHub: Harry-kp/uppcl-pro

UPPCL Pro 是一个基于逆向工程 API 的自托管智能电表分析仪表盘，帮助印度 UP 邦电力用户将电表数据可视化为余额、用电量和电费分析。

Stars: 1 | Forks: 0

# UPPCL Pro **你的 UPPCL 智能电表，终于看懂了。** UPPCL SMART 电度表的分析仪表盘 —— 支持*预付费*和后付费。
余额和剩余天数、带有官方 PDF 一键下载功能的月度账单、每日用电量和成本、电能质量及碳排放洞察。
[**立即体验**](https://uppcl-pro.vercel.app) · [截图](#screenshots) · [自托管](#self-host) · [工作原理](#how-it-works)
Live Privacy MIT

UPPCL Pro dashboard ## 你将获得的内容 仪表盘会根据电表类型自动调整 —— 预付费保留余额 + 剩余天数视图；后付费则切换为应付金额、账单周期和预测。 | | | |---|---| | **余额与账单** | 预付费：实时余额、耗尽前的剩余天数以及充值推荐。后付费：应付金额、账单周期环以及基于您的实际有效 ₹/kWh 进行的下次账单预测。 | | **应用内官方 PDF** | 无需离开仪表盘即可下载您真实的 UPPCL 账单、付款收据和欠费清单。 | | **每日用电量与成本** | 每日 kWh、峰值需求、视在电能、推导出的功率因数以及估算成本 —— 支持 CSV 导出。 | | **用电分析** | 每日和星期几的用电模式、年度用电概况、待机负载与活动负载的划分。 | | **异常检测** | 标记出高于 30 天平均值 1.5 个标准差以上的日期。 | | **电能质量与电表健康度** | 功率因数和峰值与批准负载对比表盘，用于标记附加费/最大需求量罚款风险，以及官方电表读数和身份信息。 | | **碳排放** | 根据您的用电量计算的 CO₂ 排放量，采用 UPPCL 自己的电网排放因子，因此数据与您的账单一致。 | | **支持** | 1912 投诉历史（包含 JE/AE/XEN 官员处理链）、账务室详细信息以及停电报告。支持英语 + हिन्दी。 |
## 截图
Usage analytics Usage analytics
Bills & cost Bills & cost
Recharges & runway Recharges
Meter health Meter health
1912 complaints Complaints

## 自托管 ``` git clone https://github.com/Harry-kp/uppcl-pro.git cd uppcl-pro bun install bun run dev ``` 打开 [localhost:3000](http://localhost:3000) 并使用您的 UPPCL SMART 凭证登录。 需要 Node 20+ 或 Bun 1.1+。
## 隐私 您的凭证会通过 HTTPS 经过服务器以连接到 UPPCL 的 API。**它们绝不会被存储、记录或共享。** 该服务器是一个无状态的 CORS 代理，没有数据库、没有追踪、也没有分析。 为了完全的隐私保护，请[自托管](#self-host) —— 您的凭证绝不会离开您的设备。 整个代码库是开源的。您可以亲自[阅读代理路由](src/app/api/uppcl/%5B...path%5D/route.ts)。
## 工作原理 ``` You This app UPPCL | | | |── credentials (HTTPS) ───>|── forwards to UPPCL ──────>| | | (never stores anything) | |<── dashboard data ────────|<── returns response ────────| | | | JWT stored in your browser Server forgets immediately ``` 服务器有两个路由： - `/api/uppcl/*` 和 `/api/bootstrap/*` —— 指向 `uppcl.sem.jio.com` 的 CORS 代理（您的数据仅作透传，绝不存储） - `/api/wss/*` —— 从 UPPCL 的账单门户获取您的官方账单/收据/欠费 PDF - `/api/complaints` —— 查询公共的 1912 投诉门户（不涉及凭证）
## 支持的 DISCOM | DISCOM | 区域 | 状态 | |--------|--------|--------| | **PVVNL** | 西部 UP | 已测试 | | MVVNL | 中部 UP | 相同 API，未经验证 | | PuVVNL | 东部 UP | 相同 API，未经验证 | | DVVNL | 南部 UP | 相同 API，未经验证 | | KESCo | 坎普尔 | 相同 API，未经验证 | 使用的是非 PVVNL 的 DISCOM？如果可以正常运行，请[告诉我们](https://github.com/Harry-kp/uppcl-pro/issues)。
## 许可证 [MIT](LICENSE)。与 UPPCL、任何 DISCOM 或 Reliance Jio 均无关联。
标签：MITM代理, 自动化攻击