From f2cb2e796d803c58bfc58eed8ec82099c4c79dcc Mon Sep 17 00:00:00 2001 From: fallensigh Date: Sun, 23 Aug 2026 21:43:36 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E5=89=8D=E7=AB=AF=E5=85=85=E5=80=BC?= =?UTF-8?q?=E4=BF=A1=E6=81=AF=E5=B1=95=E7=A4=BA=20+=20=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 表格新增充值电量列, 汇总卡新增充值统计 - README 更新精确计算说明与 XF_PRICE 配置 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus --- go/README.md | 11 +++++++++++ go/static/app.js | 12 +++++++++--- go/static/index.html | 5 ++++- 3 files changed, 24 insertions(+), 4 deletions(-) diff --git a/go/README.md b/go/README.md index 03b819a..e539470 100644 --- a/go/README.md +++ b/go/README.md @@ -124,6 +124,7 @@ LZU_USERNAME=学号 LZU_PASSWORD=密码 ./electric-monitor | `XF_YM_APPID` | `1810181825222034` | 一码通应用 ID | | `LZU_AES_KEY` | — | AES 加密密钥（16字节，由环境注入）**必填** | | `LZU_MD5_KEY` | — | MD5 签名密钥（由环境注入）**必填** | +| `XF_PRICE` | `0.535` | 电价（元/度），用于充值金额→电量换算 | | `CACHE_FILE` | `data/electric_cache.json` | 会话缓存路径 | | `HISTORY_FILE` | `data/electric_history.json` | 历史记录路径 | | `XF_CACHE_TTL` | `518400` (6天) | 会话缓存有效期（秒）| @@ -196,6 +197,15 @@ GET /api/history?month=2026-08 # 指定月份 (YYYY-MM) **跨月基线**：指定月份时，月内第一天的耗电以上月末记录为基线计算（跨月衔接正确）。 +### 精确耗电计算（含充值修正） + +- **电价**：默认 `0.535 元/度`（由余额接口反推，可用 `XF_PRICE` 覆盖） +- **充值记录接口**：`POST /app/electric/queryISIMSRoomBuyRecord`（areaId/buildingCode/floorCode/roomCode/mdtype=room） +- **日耗电公式**：`日耗电 = (昨天剩余 - 今天剩余) + 当天充值电量`（充值金额 × 1/电价） +- 充值当天不再归零：如充值 ¥30 → 56.07 度，该日耗电 = 剩余变化 + 56.07 +- 月度汇总新增：`recharge_days`（充值次数）、`recharge_kwh`（充值电量）、`recharge_money`（充值金额） +- 充值记录 10 分钟缓存，接口失败时降级为无充值计算（余额回升归零） + ## 定时任务说明 - **触发时机**：每天 00:00-00:05 窗口内（Asia/Shanghai 时区） @@ -303,3 +313,4 @@ A: 自动重试 5 次 + 次日补记。若持续失败，检查账号是否到 - **v1.0** (2026-08-23): Go 版完整实现，Docker 部署，实时监控 + 每日耗电统计 - **v1.0.1** (2026-08-23): 内存/稳定性优化——HTTP Server 超时、出站请求 context 超时、修复 debugMain 编译问题；补充内存分析文档 - **v1.1** (2026-08-23): **按月查询**——月份选择器导航、月度汇总（总耗电/日均/疑似充值/月初月末电量）、跨月耗电基线衔接 +- **v1.2** (2026-08-23): **精确耗电计算**——接入充值记录接口 `queryISIMSRoomBuyRecord`、电价 0.535 元/度换算、充值当天耗电精确修正、月度汇总增加充值字段 diff --git a/go/static/app.js b/go/static/app.js index 93cb5cf..e8dee78 100644 --- a/go/static/app.js +++ b/go/static/app.js @@ -49,7 +49,7 @@ async function fetchCurrent() { function renderSummary(s) { if (!s || !s.record_count) { const empty = "--"; - ["sRecordCount", "sTotalUsage", "sAvgUsage", "sRecharge", "sStartSurplus", "sEndSurplus"].forEach((id) => { + ["sRecordCount", "sTotalUsage", "sAvgUsage", "sRecharge", "sRechargeKwh", "sRechargeMoney", "sStartSurplus", "sEndSurplus"].forEach((id) => { $(id).textContent = empty; }); return; @@ -57,7 +57,9 @@ function renderSummary(s) { $("sRecordCount").textContent = s.record_count + " 天"; $("sTotalUsage").textContent = s.total_usage != null ? s.total_usage.toFixed(2) : "--"; $("sAvgUsage").textContent = s.avg_usage != null ? s.avg_usage.toFixed(2) : "--"; - $("sRecharge").textContent = s.recharge_days; + $("sRecharge").textContent = s.recharge_days != null ? s.recharge_days + " 次" : "--"; + $("sRechargeKwh").textContent = s.recharge_kwh != null ? s.recharge_kwh.toFixed(2) : "--"; + $("sRechargeMoney").textContent = s.recharge_money != null ? s.recharge_money.toFixed(2) : "--"; $("sStartSurplus").textContent = s.start_surplus != null ? s.start_surplus.toFixed(2) : "--"; $("sEndSurplus").textContent = s.end_surplus != null ? s.end_surplus.toFixed(2) : "--"; } @@ -127,7 +129,7 @@ function renderChart(daily) { function renderHistory(daily) { const body = $("historyBody"); if (!daily.length) { - body.innerHTML = '暂无记录'; + body.innerHTML = '暂无记录'; return; } // daily 是升序，表格显示降序（新→旧） @@ -135,10 +137,14 @@ function renderHistory(daily) { body.innerHTML = rows .map((d) => { const usageTxt = d.usage != null && d.usage >= 0 ? d.usage.toFixed(2) : "--"; + const rechargeTxt = d.recharge != null && d.recharge > 0 + ? `+${d.recharge.toFixed(2)}` + : "--"; return ` ${formatDateStr(d.date)} ${d.surplus.toFixed(2)} ${usageTxt} + ${rechargeTxt} 自动 `; }) diff --git a/go/static/index.html b/go/static/index.html index 52239fa..f15b6e9 100644 --- a/go/static/index.html +++ b/go/static/index.html @@ -42,7 +42,9 @@
--
记录天数
--
月总耗电(度)
--
日均耗电(度)
-
--
疑似充值(天)
+
--
充值(次)
+
--
充值电量(度)
+
--
充值金额(元)
--
月初电量(度)
--
月末电量(度)
@@ -60,6 +62,7 @@ 日期 剩余电量(度) 日耗电(度) + 充值电量(度) 记录方式