From 3fa6bb5de6babb695940e639559f7c40e2ff7b24 Mon Sep 17 00:00:00 2001 From: YANG JIANKUAN Date: Mon, 14 Sep 2026 17:10:21 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E4=BB=8A=E6=97=A5=E5=AE=9E=E6=97=B6=20?= =?UTF-8?q?0%=20=E7=94=BB=E7=AD=89=E5=8F=B7=EF=BC=8B=E9=87=91=E9=A2=9D?= =?UTF-8?q?=E5=B0=8F=E5=8F=B7=20=C2=A5/=E4=B8=87=EF=BC=8C=E6=95=B0?= =?UTF-8?q?=E5=80=BC=E4=B8=8E=E7=8A=B6=E6=80=81=E6=A0=8F=E6=95=B0=E5=AD=97?= =?UTF-8?q?=E5=8A=A0=E7=B2=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 环比/同比增长率恰为 0 时方向记 flat，三角位画等号（与用量行 pace 持平一致） - 金额拆为「¥ / 主数字 / 万」三段，¥ 与 万 用 F12 小号伪粗体、与 F24 主数字基线对齐；单量列不变 - 环比/同比数值、BTC 涨跌幅、顶部电量/温度/湿度数字改 F12 伪粗体（字号不变），占位 -- 不加粗 - 等号绘制抽为基类 _eq 供 pace 与环比/同比共用；网页版 flat 同样输出等号 Co-Authored-By: Claude Fable 5.1 --- CLAUDE.md | 10 +++++----- data.py | 22 +++++++++++--------- html_renderer.py | 3 ++- renderer.py | 51 ++++++++++++++++++++++++++++++++++++----------- renderer_e1002.py | 21 ++++++++++--------- 5 files changed, 71 insertions(+), 36 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 6aa31f3..9b9aa91 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -10,7 +10,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co > **分支 `feature/colorful`**：新设备在黑白外支持红色，本分支把渲染升级为黑/白/红三色。当前版式为**上中下三段**：A 大时钟+日期 / 天气（定位南京·江宁）；B **Claude Usage** 主角（5h/7d 用量进度条 + 时间维度对比 pace，用量吃紧转红预警）；C 橘喵今日实时三列。红作**语义强调**（用量预警、涨、定位、天气太阳/闪电），仍**无真灰阶、不抖动**，全图只三种纯色。近30天趋势图当前**隐藏**（`renderer._trend_chart` 及依赖保留、未调用，随时可挂回）。 -> **分支 `feature/reterminal-e1002`**（基于 `feature/colorful`）：新增第二个目标设备 **Seeed reTerminal E1002**（7.3 寸 **800×480**，E Ink **Spectra 6 原生六色**：黑/白/黄/红/绿/蓝，真机已验证六色量化干净）。该设备不接受局域网直推，而是由 **SenseCraft HMI** 云端的 **HTML 控件**按设备刷新间隔（最小 5 分钟）**每周期重新抓取**一个公网 HTTPS URL、无头浏览器截图后量化下发；不支持 ETag/304，内容不变也会整屏重绘（全刷约 17 秒）。**真机验证（2026-09）**：Image 控件只在填写 URL 时抓一次快照、此后不再更新；HTML 控件填同一 URL 则每周期重抓——所以对外只用 HTML 控件。当前主形态是 **`server.py` 动态服务**（部署公网 HTTPS；局域网地址/明文 HTTP 云端抓不到）：三条恒定 URL 并行供对比——方案一 `IMAGE_PATH`（默认 `/e1002.png`）每次请求**内存中现渲染 PNG**（Pillow 点阵版）；方案二 `HTML_PATH`（默认 `/e1002.html`）每次请求生成 **800×480 现代网页**（`html_renderer.py`，系统/网络字体 + 内联 SVG K 线，无 JS）由平台截图——**真机实拍：文字抗锯齿灰边被平台抖动成毛边、小字与复杂汉字发糊**；方案三 `HTML_PNG_PATH`（默认 `/e1002-web.png`）同一网页由**服务端无头 Chrome 截图后按最近色（不抖动）固化为六色 PNG**（`html_shot.py`），平台拿到纯色图无从抖动，需服务器装 Chrome。**结论（2026-09-10）：方案一为主力**——方案二/三的矢量字体在 125 PPI 下小字必然毛糙（抗锯齿灰边无论由平台还是我们二值化都只能变成锯齿/断笔，见 `output/e1002/font_compare.png`：矢量字体单色渲染 ≈ 抗锯齿后二值化，都不如点阵），Canvas 逐像素画也改变不了这点（Pillow 本身就是逐像素画）。方案二/三端点保留供对比，不再投入。宽版**只用点阵字体的整数倍字号 12/24/36/48/84**（`E1002Renderer.__init__` 把基类的 F13/F16/FPACE 都映射到 12px——用量行 标签常规字重、右对齐贴进度条（基类类属性 `LABEL_BOLD`/`LABEL_ALIGN`/`LABEL_GAP`），百分比与 pace 数字粗体；24px 试过被嫌大；另加 F84 给顶部大时钟），可用 `all(v % 12 == 0 for v in 字体尺寸)` 自查。天气/橘喵/BTC/设备遥测 走**服务端内存缓存 + 有效期**（`WEATHER_TTL`/`MAO_TTL`/`BTC_TTL`/`DEVICE_TTL`，默认 900/60/300/300 秒，0=每次实拉；请求时过期才实拉并更新时间戳，失败沿用旧值、不更新时间戳），服务**不读本机任何文件**；Claude/Codex 用量为**账户级、形态 A**：本机 `main.py --target push` 采集（Claude 复用 Claude Code 钥匙串登录态调 `/api/oauth/usage`；Codex 经 `codex app-server` RPC）后推送原始快照（`X-Push-Token` 鉴权），服务端内存暂存、**不持任何凭证**、渲染时现算 pace。静态形态 `main.py --target e1002`（`output/e1002/index.html` + `dashboard.png`）仍保留。渲染由 `renderer_e1002.py` 完成：继承 `DashboardRenderer` 组件、**k=1 字号与三色版完全相同（不放大，放大后字太大很傻）**，四段版式：A 大时钟 **F84**（墨迹 16～79）＋ 其右一列三行、左缘对齐（F12，行距 22）：① 电池图标＋电量（充电中绿、≤20% 红）② 温度计＋温度 ｜ 蓝色水滴＋湿度 ③ 星期/日期（与时钟基线对齐）——设备数据来自 **SenseCraft 设备遥测** `sensecraft_api.py`（2026-09-14 新增；先做过「状态栏横排在时钟上方＋时钟缩 F60」被否）/天气；B 左 **Claude Usage 两行（5h ／ 合并行 7d——整行高度不变、**一个大边框**，边框内上下精确对半两条 7px **实心**填充（紧挨、无空隙，2026-09-14 用户要求去掉白隔）：上＝总 7d、下＝fable 7d，各按自身档位取色；右侧百分比与 pace **只显示两者中较大者**，边框与文字随其档位取色；`E1002Renderer._usage_row_split` 以较大者合成一条交给基类 `_usage_row`（已返回条几何）画边框/文字后在内部重绘两条半高实心。2026-09-14 为与右块对称而合并，先做过「两条各带边框的细条＋两行数字」版被否；标签去掉 all 前缀）**、右 **Codex Usage 两行（5h / 7d——ChatGPT 订阅的 Codex 额度池；服务端未收到推送时 mock 标「示例数据」）**。宽版用量行的**空值不显示 "--"**：pct 为 None 按 0 画（"00%"、pace "00"、空条、全黑中性色），且 pace 列在 diff=0 时三角位画一个等宽等号「=」（2026-09-14 用户要求，原为留空、后短暂用过「-」；已下沉到基类 `_pace`，小屏同样）——各行进度条右端齐平、等宽（2026-09-14；Codex Plus 接口 `secondary_window` 就是 null，原始 `wham/usage` 已核对，5h 行为空是数据如此）。**真 0 的窗口也必须有 pace 列**：Claude 5h 空闲时接口回 `utilization: 0.0, resets_at: null`，算不出 time_pct，早先渲染器遇「有 pct 无 time_pct」整列跳过，该行条就比别行长——现 `data.usage_from_raw` 对 pct=0 且无重置时刻的窗口记 time_pct=0（窗口未开始），基类 `_usage_row` 只要有 pct 就画 pace（time_pct 缺失按 0 差值画 "00"），紧凑单行样式（曾试过撑满高度的大卡片，被否）；C **橘喵·今日实时**五列全宽（探店单量／探店流水／团购单量／团购流水／毛利，2026-09-11 接口新增团购字段后由三列改五列；列内四行逐行居中：名 F12 / 值 F24 粗 / 环比 / 同比，与小屏同构——五列每列仅 ~157px，此前「值 F36 粗 ＋ 右侧叠放的环比/同比」并排组约 194px 放不下、降 F24 后 156px 仍贴分隔线，故改竖排；更早试过名与值同行、左上角角标，均已否）；D **BTC/USDT 时 K 蜡烛图（近 48 小时 = 2 天，2026-09-14 由 72 根改 48 根）**（免费公开行情：OKX 主源、Coinbase/Huobi 备源，`btc_api.py`，5 分钟缓存；周期/根数 `BTC_BAR`/`BTC_LIMIT` 可配，日 K 也支持；**涨绿跌红**）。此前放过 30 天折线图（用户明确不要）和「近 7 天」数据表（已被 K 线替换）。六色语义：用量进度条（含边框、百分比数字三者同色——2026-09-14 用户要求百分比随条色）与 pace 各自**三档、颜色顺序固定 绿→黑→红、两者独立取色**：用量 ≤ `USAGE_OK` 30 绿「健康」｜30～80 黑「正常」｜≥ `USAGE_WARN` 80 红「危险」；pace ≤ −`PACE_TOL` 10 绿「节余」｜±10 内黑「持平」｜≥ +10 红「偏快」。**黄不用**：2026-09-14 曾按要求加过 60%～80% 黄档（含 `USAGE_NOTICE`/`PACE_WARN` 两个阈值），同日被否并整体移除，别再加回。**今日实时的环比/同比「三角 + 数值」涨绿跌红**（2026-09-14 改，与 K 线一致；基类钩子 `_cmp_color`，三色小屏仍涨红）；红另用于定位/太阳闪电，蓝=雨雪。 +> **分支 `feature/reterminal-e1002`**（基于 `feature/colorful`）：新增第二个目标设备 **Seeed reTerminal E1002**（7.3 寸 **800×480**，E Ink **Spectra 6 原生六色**：黑/白/黄/红/绿/蓝，真机已验证六色量化干净）。该设备不接受局域网直推，而是由 **SenseCraft HMI** 云端的 **HTML 控件**按设备刷新间隔（最小 5 分钟）**每周期重新抓取**一个公网 HTTPS URL、无头浏览器截图后量化下发；不支持 ETag/304，内容不变也会整屏重绘（全刷约 17 秒）。**真机验证（2026-09）**：Image 控件只在填写 URL 时抓一次快照、此后不再更新；HTML 控件填同一 URL 则每周期重抓——所以对外只用 HTML 控件。当前主形态是 **`server.py` 动态服务**（部署公网 HTTPS；局域网地址/明文 HTTP 云端抓不到）：三条恒定 URL 并行供对比——方案一 `IMAGE_PATH`（默认 `/e1002.png`）每次请求**内存中现渲染 PNG**（Pillow 点阵版）；方案二 `HTML_PATH`（默认 `/e1002.html`）每次请求生成 **800×480 现代网页**（`html_renderer.py`，系统/网络字体 + 内联 SVG K 线，无 JS）由平台截图——**真机实拍：文字抗锯齿灰边被平台抖动成毛边、小字与复杂汉字发糊**；方案三 `HTML_PNG_PATH`（默认 `/e1002-web.png`）同一网页由**服务端无头 Chrome 截图后按最近色（不抖动）固化为六色 PNG**（`html_shot.py`），平台拿到纯色图无从抖动，需服务器装 Chrome。**结论（2026-09-10）：方案一为主力**——方案二/三的矢量字体在 125 PPI 下小字必然毛糙（抗锯齿灰边无论由平台还是我们二值化都只能变成锯齿/断笔，见 `output/e1002/font_compare.png`：矢量字体单色渲染 ≈ 抗锯齿后二值化，都不如点阵），Canvas 逐像素画也改变不了这点（Pillow 本身就是逐像素画）。方案二/三端点保留供对比，不再投入。宽版**只用点阵字体的整数倍字号 12/24/36/48/84**（`E1002Renderer.__init__` 把基类的 F13/F16/FPACE 都映射到 12px——用量行 标签常规字重、右对齐贴进度条（基类类属性 `LABEL_BOLD`/`LABEL_ALIGN`/`LABEL_GAP`），百分比与 pace 数字粗体；24px 试过被嫌大；另加 F84 给顶部大时钟），可用 `all(v % 12 == 0 for v in 字体尺寸)` 自查。天气/橘喵/BTC/设备遥测 走**服务端内存缓存 + 有效期**（`WEATHER_TTL`/`MAO_TTL`/`BTC_TTL`/`DEVICE_TTL`，默认 900/60/300/300 秒，0=每次实拉；请求时过期才实拉并更新时间戳，失败沿用旧值、不更新时间戳），服务**不读本机任何文件**；Claude/Codex 用量为**账户级、形态 A**：本机 `main.py --target push` 采集（Claude 复用 Claude Code 钥匙串登录态调 `/api/oauth/usage`；Codex 经 `codex app-server` RPC）后推送原始快照（`X-Push-Token` 鉴权），服务端内存暂存、**不持任何凭证**、渲染时现算 pace。静态形态 `main.py --target e1002`（`output/e1002/index.html` + `dashboard.png`）仍保留。渲染由 `renderer_e1002.py` 完成：继承 `DashboardRenderer` 组件、**k=1 字号与三色版完全相同（不放大，放大后字太大很傻）**，四段版式：A 大时钟 **F84**（墨迹 16～79）＋ 其右一列三行、左缘对齐（F12，行距 22）：① 电池图标＋电量（充电中绿、≤20% 红）② 温度计＋温度 ｜ 蓝色水滴＋湿度（①② 数字 F12 伪粗体、字号不变，占位 -- 不加粗，2026-09-14）③ 星期/日期（与时钟基线对齐）——设备数据来自 **SenseCraft 设备遥测** `sensecraft_api.py`（2026-09-14 新增；先做过「状态栏横排在时钟上方＋时钟缩 F60」被否）/天气；B 左 **Claude Usage 两行（5h ／ 合并行 7d——整行高度不变、**一个大边框**，边框内上下精确对半两条 7px **实心**填充（紧挨、无空隙，2026-09-14 用户要求去掉白隔）：上＝总 7d、下＝fable 7d，各按自身档位取色；右侧百分比与 pace **只显示两者中较大者**，边框与文字随其档位取色；`E1002Renderer._usage_row_split` 以较大者合成一条交给基类 `_usage_row`（已返回条几何）画边框/文字后在内部重绘两条半高实心。2026-09-14 为与右块对称而合并，先做过「两条各带边框的细条＋两行数字」版被否；标签去掉 all 前缀）**、右 **Codex Usage 两行（5h / 7d——ChatGPT 订阅的 Codex 额度池；服务端未收到推送时 mock 标「示例数据」）**。宽版用量行的**空值不显示 "--"**：pct 为 None 按 0 画（"00%"、pace "00"、空条、全黑中性色），且 pace 列在 diff=0 时三角位画一个等宽等号「=」（2026-09-14 用户要求，原为留空、后短暂用过「-」；已下沉到基类 `_pace`，小屏同样）——各行进度条右端齐平、等宽（2026-09-14；Codex Plus 接口 `secondary_window` 就是 null，原始 `wham/usage` 已核对，5h 行为空是数据如此）。**真 0 的窗口也必须有 pace 列**：Claude 5h 空闲时接口回 `utilization: 0.0, resets_at: null`，算不出 time_pct，早先渲染器遇「有 pct 无 time_pct」整列跳过，该行条就比别行长——现 `data.usage_from_raw` 对 pct=0 且无重置时刻的窗口记 time_pct=0（窗口未开始），基类 `_usage_row` 只要有 pct 就画 pace（time_pct 缺失按 0 差值画 "00"），紧凑单行样式（曾试过撑满高度的大卡片，被否）；C **橘喵·今日实时**五列全宽（探店单量／探店流水／团购单量／团购流水／毛利，2026-09-11 接口新增团购字段后由三列改五列；列内四行逐行居中：名 F12 / 值 F24 粗 / 环比 / 同比，与小屏同构——五列每列仅 ~157px，此前「值 F36 粗 ＋ 右侧叠放的环比/同比」并排组约 194px 放不下、降 F24 后 156px 仍贴分隔线，故改竖排；更早试过名与值同行、左上角角标，均已否）；D **BTC/USDT 时 K 蜡烛图（近 48 小时 = 2 天，2026-09-14 由 72 根改 48 根）**（免费公开行情：OKX 主源、Coinbase/Huobi 备源，`btc_api.py`，5 分钟缓存；周期/根数 `BTC_BAR`/`BTC_LIMIT` 可配，日 K 也支持；**涨绿跌红**）。此前放过 30 天折线图（用户明确不要）和「近 7 天」数据表（已被 K 线替换）。六色语义：用量进度条（含边框、百分比数字三者同色——2026-09-14 用户要求百分比随条色）与 pace 各自**三档、颜色顺序固定 绿→黑→红、两者独立取色**：用量 ≤ `USAGE_OK` 30 绿「健康」｜30～80 黑「正常」｜≥ `USAGE_WARN` 80 红「危险」；pace ≤ −`PACE_TOL` 10 绿「节余」｜±10 内黑「持平」｜≥ +10 红「偏快」。**黄不用**：2026-09-14 曾按要求加过 60%～80% 黄档（含 `USAGE_NOTICE`/`PACE_WARN` 两个阈值），同日被否并整体移除，别再加回。**今日实时的环比/同比「三角 + 数值」涨绿跌红**（2026-09-14 改，与 K 线一致；基类钩子 `_cmp_color`，三色小屏仍涨红）；红另用于定位/太阳闪电，蓝=雨雪。 ## 命令 @@ -42,7 +42,7 @@ EPD_HOST=epd400a44.local python3 main.py `main.py` 串联三层，各层职责单一、低耦合： -- **`data.py`** — 两种形态：本机 `get_dashboard_data()`（带文件缓存，两路用量经本机采集器）；服务端用纯拉取函数 `weather_fetch()`/`mao_fetch()`/`btc_fetch()` + `usage_from_raw(now, raw, windows, title)`（`_usage(now, raw=)`/`_usage_gpt(now, raw=, allow_local=)` 都基于它，raw=None 时前者经 `claude_usage` 本机采集、后者经 `codex_usage` 本机采集，Codex 采集失败或服务端 `allow_local=False` 时用 `gpt_mock_raw()` 并标 mock）。所有「现在」用 `now_tz()`、时间戳格式化用 `_local()`（`TZ=ZoneInfo(config.TZ_NAME)`），本机与境外服务端结果一致。返回固定结构的 dict：`date`/`weather`/`mao`/`usage`/`usage_gpt`/`btc`/`device`（`device` = `{battery, charging, temp, humidity}`，由 `_device(now)` 经 `sensecraft_api` 拉取、文件缓存 `.device_cache.json` TTL=`DEVICE_TTL`，服务端用纯拉取 `device_fetch()`/占位 `device_empty()`）。日期时间用真实系统时间；橘喵今日经营由 `_mao()` 经 `jm_api`、天气由 `_weather()` 经 `weather_api`（和风，定位南京·江宁）、Claude 用量由 `_usage()` 经 `claude_usage`、Codex 用量由 `_usage_gpt()` 经 `codex_usage`，**Claude 任何异常都回退占位 `"--"`，不回退 mock**（Codex 无数据时回退 mock 并显式标「示例数据」）。改数据保持返回结构不变即可（renderer 依赖其 key：`weather.icon` 为和风图标代码；`mao.cols[]` 为 `{k, v, hb, tb, wide}`，五列由 `REALTIME_COLS`（标签、接口字段前缀、格式化、是否仅宽版）驱动，`_col_from()` 用 `.get()` 取 `today{Base}`/`{base}WowRate`/`{base}YoyRate`，字段缺失（旧后端未上团购）该列占位 `--`；`wide=True`（团购两列）小屏 `render()` 跳过、宽版全显；`hb/tb` 为环比/同比 `(direction, text)`，direction 为 `None` 时不画三角；接口文档见 `../docs/首页看板接口文档-20260911.md`（毛利口径已含团购、金额与增长率为字符串、增长率可 `null`）；`usage.bars[]` 为 `{k(短标签，小屏用), label(长标签 5h/7d/fable 7d，宽版用), pct(或 None), time_pct?, reset?, scoped}`（宽版把 scoped 行并入紧邻其前的非 scoped 行作同一边框内的下半实心）、`usage.warn`/`usage.ok`/`usage.pace_tol` 为用量与 pace 的三档阈值（小屏只用 warn）、`usage.updated` 为快照采集时刻；`usage_gpt` 与 `usage` 同构、标题「Codex Usage」、只有 5h/7d 两行（快照各窗口可带 `window` 真实秒数，pace 优先按它算），服务端未收到推送时为 mock（`mock: True`，88/22 覆盖红/绿两端）。注：`_mao` 仍会拉 `mao.trend`，但两个版面当前都不用它。宽版另有 `btc`：`_btc()` 经 `btc_api.get_candles(BTC_BAR, BTC_LIMIT)` 取 K 线（默认 1H×48），结构 `{symbol, bar, src, candles:[{t, o, h, l, c}], last, chg, chg_label}`，chg 时 K 取相对 24 根前收盘（24h）、日 K 取相对上一根；缓存 `.btc_cache.json`（TTL=`BTC_TTL` 默认 5 分钟，周期变更即失效，失败沿用旧缓存，仍无则 candles 为空 → 面板 `--`）。 +- **`data.py`** — 两种形态：本机 `get_dashboard_data()`（带文件缓存，两路用量经本机采集器）；服务端用纯拉取函数 `weather_fetch()`/`mao_fetch()`/`btc_fetch()` + `usage_from_raw(now, raw, windows, title)`（`_usage(now, raw=)`/`_usage_gpt(now, raw=, allow_local=)` 都基于它，raw=None 时前者经 `claude_usage` 本机采集、后者经 `codex_usage` 本机采集，Codex 采集失败或服务端 `allow_local=False` 时用 `gpt_mock_raw()` 并标 mock）。所有「现在」用 `now_tz()`、时间戳格式化用 `_local()`（`TZ=ZoneInfo(config.TZ_NAME)`），本机与境外服务端结果一致。返回固定结构的 dict：`date`/`weather`/`mao`/`usage`/`usage_gpt`/`btc`/`device`（`device` = `{battery, charging, temp, humidity}`，由 `_device(now)` 经 `sensecraft_api` 拉取、文件缓存 `.device_cache.json` TTL=`DEVICE_TTL`，服务端用纯拉取 `device_fetch()`/占位 `device_empty()`）。日期时间用真实系统时间；橘喵今日经营由 `_mao()` 经 `jm_api`、天气由 `_weather()` 经 `weather_api`（和风，定位南京·江宁）、Claude 用量由 `_usage()` 经 `claude_usage`、Codex 用量由 `_usage_gpt()` 经 `codex_usage`，**Claude 任何异常都回退占位 `"--"`，不回退 mock**（Codex 无数据时回退 mock 并显式标「示例数据」）。改数据保持返回结构不变即可（renderer 依赖其 key：`weather.icon` 为和风图标代码；`mao.cols[]` 为 `{k, v, vp, hb, tb, wide}`（`vp` 为数值三段 `(前缀, 主数字, 后缀)`，金额为 `("¥", "2.14", "万")`／不足万 `("¥", "2590", "")`、单量前后缀为空，`v` 是三段拼接的整串供网页版用；2026-09-14 用户要求 ¥ 与 万 字号小一点），五列由 `REALTIME_COLS`（标签、接口字段前缀、格式化、是否仅宽版）驱动，`_col_from()` 用 `.get()` 取 `today{Base}`/`{base}WowRate`/`{base}YoyRate`，字段缺失（旧后端未上团购）该列占位 `--`；`wide=True`（团购两列）小屏 `render()` 跳过、宽版全显；`hb/tb` 为环比/同比 `(direction, text)`，direction ∈ `up`/`down`/`flat`/`None`：`flat` 为增长率恰等于 0，三角位画等号「=」（2026-09-14 用户要求，与用量行 pace 持平一致，此前 0 也画上三角）、`None` 不画三角；接口文档见 `../docs/首页看板接口文档-20260911.md`（毛利口径已含团购、金额与增长率为字符串、增长率可 `null`）；`usage.bars[]` 为 `{k(短标签，小屏用), label(长标签 5h/7d/fable 7d，宽版用), pct(或 None), time_pct?, reset?, scoped}`（宽版把 scoped 行并入紧邻其前的非 scoped 行作同一边框内的下半实心）、`usage.warn`/`usage.ok`/`usage.pace_tol` 为用量与 pace 的三档阈值（小屏只用 warn）、`usage.updated` 为快照采集时刻；`usage_gpt` 与 `usage` 同构、标题「Codex Usage」、只有 5h/7d 两行（快照各窗口可带 `window` 真实秒数，pace 优先按它算），服务端未收到推送时为 mock（`mock: True`，88/22 覆盖红/绿两端）。注：`_mao` 仍会拉 `mao.trend`，但两个版面当前都不用它。宽版另有 `btc`：`_btc()` 经 `btc_api.get_candles(BTC_BAR, BTC_LIMIT)` 取 K 线（默认 1H×48），结构 `{symbol, bar, src, candles:[{t, o, h, l, c}], last, chg, chg_label}`，chg 时 K 取相对 24 根前收盘（24h）、日 K 取相对上一根；缓存 `.btc_cache.json`（TTL=`BTC_TTL` 默认 5 分钟，周期变更即失效，失败沿用旧缓存，仍无则 candles 为空 → 面板 `--`）。 - **缓存**（为 launchd 每 5 分钟独立进程而设，必须落盘）：天气 `.weather_cache.json`（TTL=`WEATHER_TTL`，默认 15min）、趋势 `.trend_cache.json`（按日期 key，每天只拉一次）、BTC K 线 `.btc_cache.json`（TTL=`BTC_TTL`，默认 5min）；三者拉取失败沿用旧缓存。两路用量各有采集缓存 `.claude_usage_cache.json`/`.codex_usage_cache.json`（`usage_common.cached_snapshot`：距上次成功 0 超前↑ / <0 节余↓）；窗口空闲（pct=0 且 `resets_at` 为 null）记 time_pct=0；故即使 `utilization` 来自缓存/推送暂存，pace 仍随时钟准确推进。5h 窗口 18000s、7d 窗口 604800s（Codex 快照带 `window` 时用真实值）。 - **`jm_api.py`** — jm-devops 后端统计接口客户端，**设备密钥授权**（`grant_type=client_secret`，免验证码）。先用 `CLIENT_ID + CLIENT_SECRET` 调 `POST /auth/login` 换 token（进程内缓存、按 `expire_in` 提前刷新），再带 `Authorization: Bearer ` + `clientid` 头调 `/system/statistics/{realtime,recent-days}`；遇 401 清 token 重登一次重试。token 字段为蛇形 `access_token`/`expire_in`。注：历史上曾免鉴权直调、更早曾用账号密码+验证码 OCR 登录（ddddocr 不稳定），现统一为 client_secret 授权——密钥即长期凭证，务必走 HTTPS、优先用 `JM_CLIENT_SECRET` 环境变量、可在后端 `sys_client` 轮换。 @@ -52,15 +52,15 @@ EPD_HOST=epd400a44.local python3 main.py - **`claude_usage.py`** — Claude **账户级**用量采集（形态 A，跑在本机）：**复用 Claude Code 自身的 OAuth 登录态**，直接 GET `https://api.anthropic.com/api/oauth/usage`（头 `Authorization: Bearer ` + `anthropic-beta: oauth-2025-04-20`）——与 Claude Code `/usage`、claude.ai 用量页同源，CLI/桌面 App/网页消耗都算，**不依赖 Claude Code 进程在跑、不依赖 statusline 或任何插件**（2026-09-14 起替代旧的「statusline 补丁落盘 `~/.claude/usage-snapshot.json`、本项目读文件」方案，`usage_local.py` 已删）。token 来源按序：环境变量 `CLAUDE_CODE_OAUTH_TOKEN` → macOS 钥匙串 generic password（service `Claude Code-credentials`，JSON `claudeAiOauth.accessToken/expiresAt(ms)`）→ `~/.claude/.credentials.json`（尊重 `CLAUDE_CONFIG_DIR`）。**铁律**：① **只读、绝不刷新 token**（refresh token 每次使用即轮换，第三方刷新不写回会让 Claude Code 强制重登，多个官方 issue 证实）；access token 约 8 小时有效，过期抛 `TokenUnavailable` → 沿用旧快照，等 Claude Code 下次启动自动刷新；② **有效期 `CLAUDE_USAGE_TTL` 内不再调、建议 ≥300 秒**（突发调用 429 会封约 24 小时并连带 Claude Code `/usage`、claude.ai 一起看不到）；③ 直连不走代理。`normalize()` 优先解析 `limits[]`（`kind`=session/weekly_all/weekly_scoped，模型限定周额度按 `scope.model.display_name == CLAUDE_USAGE_SCOPE_MODEL`「Fable」识别——2026 年中起顶层 `seven_day_opus/sonnet` 已置 null，只能这样取），顶层 `five_hour/seven_day` 兜底；输出与旧快照同构 `{five_hour, seven_day, seven_day_fable|None, updated_at, source}`。`get_usage(force=)` 经 `usage_common.cached_snapshot` 带缓存/最小间隔/退避，`status` ∈ fetched/cache/stale/backoff。官方合规页禁止第三方「收集、存储、中介」claude.ai 凭证，未专门点名此端点，个人自用只读监控属灰色地带、无封号报告——所以凭证只留本机、服务端不碰。 - **`codex_usage.py`** — Codex **账户级**用量采集（形态 A，跑在本机）：经官方 **`codex app-server` stdio JSON-RPC** 读 ChatGPT 订阅的 **Codex 额度池**（CLI/IDE 扩展/Codex Web/ChatGPT 桌面 App 内 Codex 共用）。**调研结论（2026-09-14）**：ChatGPT 订阅的**普通聊天**额度没有任何可编程的账户级读取途径（私有端点在 Sentinel/Cloudflare 门后、且只在被限流时才有值；官方明确聊天与 Codex 分开计量），故右侧块如实命名「Codex Usage」。协议（本机 codex-cli 0.154 验证）：`initialize` → 通知 `initialized` → `account/rateLimits/read`（params `{excludeResetCreditDetails:true}`），响应 `rateLimits.primary/secondary{usedPercent, windowDurationMins, resetsAt(epoch 秒)}` + `planType` + 多桶 `rateLimitsByLimitId`；未登录 ChatGPT 账号时 error「codex account authentication required to read rate limits」。**窗口归类按 `windowDurationMins`**（≤12h → five_hour，≥5 天 → seven_day），Pro 计划常只回一个窗口、另一个 null，不能按 primary/secondary 位置判断；快照各窗口带 `window` 真实秒数供 pace 用。为什么不直调 `chatgpt.com/backend-api/wham/usage`：token 刷新由 Codex CLI 代管（refresh token 轮换，外部自刷会踢掉 CLI 登录，官方 CI 文档也明示「不要自己调刷新接口」）。**登录**：2026-09-14 用户直接在默认 `~/.codex` 用 ChatGPT 账号 `codex login`（`auth_mode=chatgpt`，原 API Key 仍保留在 auth.json；`config.toml` 的第三方中转 base_url 只影响推理、不影响额度读取），故 `CODEX_USAGE_HOME` 默认留空跟随默认目录；若要隔离可设独立 `CODEX_HOME`（目录不存在会自动建）并在其下 `codex login`。**`CODEX_BIN` 由 `config._which_codex()` 解析为绝对路径**（launchd 的 PATH 不含 `/opt/homebrew/bin`，曾报「找不到 codex 可执行文件」进入退避；`.env` 已写死 `/opt/homebrew/bin/codex`）。子进程剥掉代理环境变量直连（chatgpt.com 本地直连可达）。**真实数据（Plus 计划）**：`rateLimits.primary` 只有周窗口（`windowDurationMins=10080`）、`secondary=null`，`rateLimitsByLimitId` 仅一个桶 `codex`——故 5h 行为 `--`、7d 行有值；`buckets` 原样附带，若将来出现第二个桶再决定是否加第三行。 - **`usage_common.py`** — 两个采集器共用的骨架 `cached_snapshot(path, ttl, backoff, fetch, force)`：距上次成功 /` 调试同一套接口）。`push_image()` 先调 `GET /images` 拿画廊已存图片名单，逐个 `POST /delete_image?name=`清空（单张删除失败不阻塞后续），再 `POST /upload`（`Content-Type: image/png`，body 为原始 PNG 字节，非 multipart）触发设备转换+刷屏。**清空画廊是刻意设计**：设备把每次 `/upload` 都追加存一份到画廊（`GET /images` 可见），不清理会越推越多、且设备当前 `current_mode` 为 slideshow 会轮播到旧图；先清后传使画廊恒为 1 张，等价于始终静态展示最新一张。**清理非核心**：拉取画廊列表本身失败也不阻塞后续 `/upload`（跳过清理，直接推）。`_request()` 对连接类异常（`urllib.error.URLError`，含 mDNS `.local` 域名解析瞬时失败）内置重试（`RETRY_TIMES=2`，间隔 `RETRY_DELAY=2s`）——mDNS 基于组播 UDP，偶发丢包很正常，单次失败不该让整轮推送直接跳过。注：历史上曾走 Zectrix 公网 API（`POST /devices/{id}/display/image` + 设备 MAC + `ZECTRIX_API_KEY`），现统一为局域网直连。 -- **`renderer_e1002.py`** — reTerminal E1002 目标：`E1002Renderer(DashboardRenderer)` 以 **k=1** 复用组件（字号 12/24/48 与三色版一致），只重写版式与配色钩子（基类抽出类属性 `PCT_TRACK`，宽版置 0——百分比已是整数倍字号不需手动加字距；基类另抽 `FPACE` 让 pace 字体与标签 F13 解耦）。四段、三道横规，各段 y 由上一段实际底部推算：A 顶部 0–90 **大时钟 F84 粗 3**（按 `getbbox` 把墨迹顶沿放到 16、底沿 79，占满整段且保住原上/左/下边距），其右 14px 起一列三行左缘对齐：电池行、温度湿度行（`_status_battery`/`_status_env`）、星期/日期 F12（按日期数字底沿与时钟**基线对齐**；三行中心约 30.5/52.5/74.5，行距 22）；天气右（贴 x=790）；B 用量 `_usage_block`×2（左 `usage` 10–386｜竖规 x=400｜右 `usage_gpt` 414–790）：`_label` 标题 + 右侧「上次更新 HH:MM」（与今日实时同款文案）或 mock 的「示例数据」，行用基类紧凑 `_usage_row`（行距 31，宽版把 `bar["label"]` 长标签代入 `k`，`label_w` 按本块最长标签自适应）；C `_realtime` 今日实时五列全宽（`mao.cols` 全部，含 `wide` 列）：列内四行 `ctext`/`_cmp_line` 逐行水平居中——名 F12 y0+21 / 值 F24 粗 y0+38 / 环比 y0+72 / 同比 y0+88（按墨迹框：标题↔名 ~9px——2026-09-14 整列下移 4px，原 ~5px 用户觉得挤；名↔值 ~9px、值↔环比 ~6px），竖规 y0+26～102，区块底 y0+104；D `_btc_chart` BTC K 线（`data.btc`，标题按 `bar` 显示「时K/日K」：右侧最新价 F12 粗 + 口径 `chg_label`（24h/1d）+ 涨跌三角 + 涨跌幅，涨绿跌红；每根蜡烛 1px 影线 + 实心实体（宽≈槽位 60% 取奇数）、收≥开 绿 否则 红；右侧 66px 标签列放最高/最低/最新价，最新价横贯一道点规、标签避让顶底；底部基线 + 首/中/末时间标签 `t`；无数据居中 `--`）。用量块 `_usage_block` 返回末条进度条底部，B/C 分割线取其 +16px（用户反馈太挤）。配色钩子覆写：`_usage_colors` 三档（≥`USAGE_WARN` 红｜≤`USAGE_OK` 绿｜其间黑；填充、边框、百分比文字三者同色）、`_pace_color` 三档（≥+`PACE_TOL` 红｜≤−`PACE_TOL` 绿｜其间黑），阈值由 `usage.ok`/`usage.pace_tol`（来自 config）在 `_usage_block` 内注入。天气图标 `wet=BLUE` 让雨滴/雪花着蓝。可选六色测试色条 `_color_strip`（`E1002_COLOR_STRIP=1` 打开，默认关）。`write_page()` 写出固定 800×480 的 `index.html`（零边距、`image-rendering: pixelated`、PNG 带时间戳参数防缓存）。**为何固定尺寸而非自适应**：云端截图视口/DPR 不可控，自适应会重排+抗锯齿产生中间色再被平台抖动；固定页里的 1:1 PNG 每个像素本就是六色之一，截图零损失——已用无头 Chrome `--window-size=800,480` 截图验证与 PNG 逐像素一致。设备端 HTML 控件须铺满整个画布。历史（均已弃用）：k=2 整体放大版；「左用量/右今日实时/下 30 天折线」版；「用量大卡片撑满」版。 +- **`renderer_e1002.py`** — reTerminal E1002 目标：`E1002Renderer(DashboardRenderer)` 以 **k=1** 复用组件（字号 12/24/48 与三色版一致），只重写版式与配色钩子（基类抽出类属性 `PCT_TRACK`，宽版置 0——百分比已是整数倍字号不需手动加字距；基类另抽 `FPACE` 让 pace 字体与标签 F13 解耦）。四段、三道横规，各段 y 由上一段实际底部推算：A 顶部 0–90 **大时钟 F84 粗 3**（按 `getbbox` 把墨迹顶沿放到 16、底沿 79，占满整段且保住原上/左/下边距），其右 14px 起一列三行左缘对齐：电池行、温度湿度行（`_status_battery`/`_status_env`）、星期/日期 F12（按日期数字底沿与时钟**基线对齐**；三行中心约 30.5/52.5/74.5，行距 22）；天气右（贴 x=790）；B 用量 `_usage_block`×2（左 `usage` 10–386｜竖规 x=400｜右 `usage_gpt` 414–790）：`_label` 标题 + 右侧「上次更新 HH:MM」（与今日实时同款文案）或 mock 的「示例数据」，行用基类紧凑 `_usage_row`（行距 31，宽版把 `bar["label"]` 长标签代入 `k`，`label_w` 按本块最长标签自适应）；C `_realtime` 今日实时五列全宽（`mao.cols` 全部，含 `wide` 列）：列内四行 `ctext`/`_cmp_line` 逐行水平居中——名 F12 y0+21 / 值 `_value` F24 粗＋小号 ¥/万 y0+38 / 环比 y0+72 / 同比 y0+88（按墨迹框：标题↔名 ~9px——2026-09-14 整列下移 4px，原 ~5px 用户觉得挤；名↔值 ~9px、值↔环比 ~6px），竖规 y0+26～102，区块底 y0+104；D `_btc_chart` BTC K 线（`data.btc`，标题按 `bar` 显示「时K/日K」：右侧最新价 F12 粗 + 口径 `chg_label`（24h/1d）+ 涨跌三角 + 涨跌幅（F12 粗，2026-09-14 加粗），涨绿跌红；每根蜡烛 1px 影线 + 实心实体（宽≈槽位 60% 取奇数）、收≥开 绿 否则 红；右侧 66px 标签列放最高/最低/最新价，最新价横贯一道点规、标签避让顶底；底部基线 + 首/中/末时间标签 `t`；无数据居中 `--`）。用量块 `_usage_block` 返回末条进度条底部，B/C 分割线取其 +16px（用户反馈太挤）。配色钩子覆写：`_usage_colors` 三档（≥`USAGE_WARN` 红｜≤`USAGE_OK` 绿｜其间黑；填充、边框、百分比文字三者同色）、`_pace_color` 三档（≥+`PACE_TOL` 红｜≤−`PACE_TOL` 绿｜其间黑），阈值由 `usage.ok`/`usage.pace_tol`（来自 config）在 `_usage_block` 内注入。天气图标 `wet=BLUE` 让雨滴/雪花着蓝。可选六色测试色条 `_color_strip`（`E1002_COLOR_STRIP=1` 打开，默认关）。`write_page()` 写出固定 800×480 的 `index.html`（零边距、`image-rendering: pixelated`、PNG 带时间戳参数防缓存）。**为何固定尺寸而非自适应**：云端截图视口/DPR 不可控，自适应会重排+抗锯齿产生中间色再被平台抖动；固定页里的 1:1 PNG 每个像素本就是六色之一，截图零损失——已用无头 Chrome `--window-size=800,480` 截图验证与 PNG 逐像素一致。设备端 HTML 控件须铺满整个画布。历史（均已弃用）：k=2 整体放大版；「左用量/右今日实时/下 30 天折线」版；「用量大卡片撑满」版。 - **`server.py`** — E1002 动态服务（stdlib `ThreadingHTTPServer`，无第三方依赖）。`build_data()` → `(data, 各路状态)`：日期按 `config.TZ_NAME` 时区现算；四路上游（天气/橘喵/BTC/设备遥测）经 `_cached(key, ttl, fetch)`——`STATE.last_good[key]` 未过期（`time - STATE.fetched_at[key] < ttl`）直接用；过期的**并行**提交到线程池 `_POOL`（`_refresh` 跑 `data.weather_fetch()`/`data.mao_fetch(now, with_trend=False)`/`data.btc_fetch()`，成功更新数据与时间戳），`build_data` 用 `concurrent.futures.wait` 整体最多等 **`FETCH_BUDGET`** 秒（默认 5，`.env` 可调），再由 `_settle` 结算：完成→`fetched(0.27s)`（带耗时）/失败沿用旧值 `stale`/从未成功占位 `none`；**未完成→ `slow→stale`（用上一次成功值）或 `slow→none`（占位）**，拉取线程继续跑完写入缓存供下次请求（stale-while-revalidate），`STATE.inflight[key]` 保证同一路进行中不重复实拉。响应上限 ≈ 预算 + 渲染，任一路上游卡死（socket 超时和风/橘喵 30s、BTC 8s）不再拖垮整图。**2026-09-14 前为串行实拉**（三路全拉约 1.1～2.6s，单路卡住即整体超时）；改并行后三路全拉约 0.75s（取最慢一路）。日志每行末尾 `[weather:cache(12s) mao:fetched(0.06s) btc:slow→stale]` 可直接看命中/耗时/超预算情况，`/health` 有 `cache_age_s`/`ttl_s`/`fetch_budget_s`/`inflight`；用量取 `STATE.raw`（推送暂存）→ `data._usage(now, raw=…)`/`data._usage_gpt(now, raw=…)`，未推送时 Claude 全 `--`、ChatGPT 用 mock。端点：`GET IMAGE_PATH` → `render_png_bytes()`（`_RENDER_LOCK` 串行化，Pillow 渲染器非线程安全）；`GET HTML_PATH` → `html_renderer.render_html()`；`GET HTML_PNG_PATH` → `html_shot.screenshot_html()`+`quantize6()`（`?raw=1` 跳过量化）；`GET /health` JSON；`POST /push/usage|/push/usage_gpt`（body=原始快照 JSON，≤64KB，头 `X-Push-Token`==`PUSH_TOKEN`，为空拒绝）；`GET /push/*` 查看暂存（同令牌）。所有响应 `Cache-Control: no-store`；每请求打一行日志（含 `CF-Connecting-IP`）。`PUSH_STATE_PATH` 非空时推送数据落盘（原子替换），重启恢复；图片永不落盘。实测：三路全实拉约 1.1～1.3s（天气 0.28s、橘喵 0.06s、OKX 0.7s 串行），全部命中缓存约 0.02s（渲染 20ms + 编码 14ms）。 - **`html_shot.py`** — 方案三：`screenshot_html(html)` 用无头 Chrome（`find_chrome()` 自动探测或 `CHROME_BIN`；Linux root 需 `CHROME_EXTRA_ARGS=--no-sandbox`）把 HTML 截成 800×480，临时目录用后即删，`_SHOT_LOCK` 串行化；**切勿传 `--user-data-dir` 指向全新目录**——新版 `--headless=new` 对空 profile 首启会卡死到超时（实测 A/B/D/E 全超时、只有不带它的 C 2 秒完成）。`quantize6(img)`：每通道二值化（阈值 `HTML_PNG_THRESHOLD` 默认 160，偏向保墨迹，细笔画浅灰边归黑而非丢白）→ Pillow 调色板 `quantize(dither=NONE)` 映射到 `SPECTRA6`，输出保证只含六色。服务端 `?raw=1` 返回未量化截图供对照。实测单次约 3.3s（Chrome 启动为主）。 - **`html_renderer.py`** — 方案二网页版：纯 HTML+CSS+内联 SVG、无 JS，数据服务端写死；字体栈 PingFang/微软雅黑/Noto Sans SC + Google Fonts 兜底（平台截图机若无中文字体会掉字，能否加载取决于其出网能力）；颜色只用六色纯值；配色规则与 PNG 版一致（用量/pace 三档、涨红跌黑、K 线涨绿跌红），版式同构。K 线标题右侧价格用 ``（`h3 b::before` 的方块装饰只给标题）。 diff --git a/data.py b/data.py index bfc842b..a65f87e 100644 --- a/data.py +++ b/data.py @@ -145,33 +145,37 @@ def weather_fetch(): # ---------- 格式化 ---------- +# 数值统一拆成三段 (前缀, 主数字, 后缀)：渲染器把主数字画大、前后缀画小（如「¥」「万」，2026-09-14 用户要求）， +# 拼接后的整串仍放在 col["v"]，供网页版等只认字符串的消费方使用。 def _fmt_count(n): - return f"{int(n):,}" # 千分位，如 1,284 + return ("", f"{int(n):,}", "") # 千分位，如 1,284 def _fmt_money(yuan): - """元金额 → 紧凑展示：≥1万显示「X.XX万」(两位小数)，否则取整元。""" + """元金额 → 紧凑展示：≥1万显示「¥X.XX万」(两位小数)，否则「¥整数元」；人民币符号作小号前缀、万作小号后缀。""" v = float(yuan) - return f"{v / 10000:.2f}万" if abs(v) >= 10000 else f"{v:.0f}" + return ("¥", f"{v / 10000:.2f}", "万") if abs(v) >= 10000 else ("¥", f"{v:.0f}", "") def _fmt_rate(rate): - """增长率字符串 → (方向, 文本)。null/空 → (None, '--')，方向 None 表示不画三角。 + """增长率字符串 → (方向, 文本)。null/空 → (None, '--')，方向 None 表示不画三角； + 恰为 0 → 'flat'，渲染器在三角位画等号「=」（与用量行 pace 持平一致，2026-09-14 用户要求，原来 0 也画上三角）。 数值统一两位小数；整数部分不足两位用前导 0 补齐(6.5→06.50)，便于环比/同比上下对齐； 三/四位数(≥100%)原样完整输出不截断。""" if rate is None or rate == "": return (None, "--") v = float(rate) - return ("down" if v < 0 else "up", f"{abs(v):05.2f}%") + direction = "flat" if v == 0 else "down" if v < 0 else "up" + return (direction, f"{abs(v):05.2f}%") -def _col(k, v, wow, yoy, wide=False): - """一列指标。wide=True 表示仅宽版（800×480）展示，400×300 小屏三列放不下、渲染时跳过。""" - return {"k": k, "v": v, "hb": _fmt_rate(wow), "tb": _fmt_rate(yoy), "wide": wide} +def _col(k, parts, wow, yoy, wide=False): + """一列指标。parts 为 (前缀, 主数字, 后缀)；wide=True 表示仅宽版（800×480）展示，400×300 小屏三列放不下、渲染时跳过。""" + return {"k": k, "v": "".join(parts), "vp": tuple(parts), "hb": _fmt_rate(wow), "tb": _fmt_rate(yoy), "wide": wide} def _placeholder_col(k, wide=False): - return {"k": k, "v": "--", "hb": (None, "--"), "tb": (None, "--"), "wide": wide} + return {"k": k, "v": "--", "vp": ("", "--", ""), "hb": (None, "--"), "tb": (None, "--"), "wide": wide} # 今日实时五列：（标签、接口字段前缀、格式化、是否仅宽版）。字段前缀 base 对应 today{Base} / {base}WowRate / {base}YoyRate， diff --git a/html_renderer.py b/html_renderer.py index 39b5d2d..338bb30 100644 --- a/html_renderer.py +++ b/html_renderer.py @@ -96,7 +96,8 @@ def _usage_card(usage): def _cmp(label, pair): direction, val = pair col = GREEN if direction == "up" else RED if direction == "down" else BLACK - tri = '' if direction == "up" else ('' if direction == "down" else "") + tri = ('' if direction == "up" else '' if direction == "down" + else "= " if direction == "flat" else "") # flat：增长率恰为 0，等号表示持平（与 PNG 版一致） return f'
{_e(label)} {tri}{_e(val)}
' diff --git a/renderer.py b/renderer.py index 4fdd622..1ff014f 100644 --- a/renderer.py +++ b/renderer.py @@ -108,8 +108,8 @@ class DashboardRenderer: """环比/同比一行的总宽度（标签 + 间隙 + 三角 + 数值），供居中/右对齐排布。""" direction, val = pair k = self.k - trw, tgap = (8 * k, 4 * k) if direction else (0, 0) - return self._tw(label, self.F12) + 5 * k + trw + tgap + self._tw(val, self.F12) + trw, tgap, vb = (8 * k, 4 * k, k) if direction else (0, 0, 0) # vb：数值伪粗体的偏移宽度（占位 -- 不加粗） + return self._tw(label, self.F12) + 5 * k + trw + tgap + self._tw(val, self.F12) + vb def _cmp_line(self, cx, y, label, pair, fg=BLACK): """环比/同比一行：标签 + 涨跌三角 + 数值，整体居中于 cx。direction 为 None 时不画三角。""" @@ -119,20 +119,49 @@ class DashboardRenderer: """环比/同比「三角 + 数值」的颜色钩子：三色版 涨红、其余沿用 fg。宽版覆写。""" return RED if direction == "up" else fg + def _eq(self, cx, cy, w, fill=BLACK): + """等号「=」：两道横杠各宽 w、厚 k，中间隔 2k，整体以 (cx, cy) 为中心——占三角的位子表示「持平」。 + 用量行 pace（diff=0）与今日实时环比/同比（增长率恰为 0）共用。""" + k = self.k + for top in (cy - 2 * k, cy + k): + self.d.rectangle([cx - w / 2, top, cx + w / 2 - 1, top + k - 1], fill=fill) + def _cmp_at(self, x, y, label, pair, fg=BLACK): - """环比/同比一行，左对齐于 x（宽版把它放在数值右侧时用）。""" + """环比/同比一行，左对齐于 x（宽版把它放在数值右侧时用）。 + direction: up 上三角 / down 下三角 / flat 等号（增长率恰为 0，2026-09-14 用户要求，原来 0 也画上三角）/ None 不画。""" direction, val = pair k = self.k lw = self._tw(label, self.F12); gap = 5 * k trw, tgap = (8 * k, 4 * k) if direction else (0, 0) self.text(x, y, label, self.F12, fill=fg); x += lw + gap - # 方向语义配色由 _cmp_color 决定（三色版：红涨、跌/无 → 黑；宽版覆写为 涨绿跌红 与 K 线一致）；标签始终黑 - up = direction == "up" + # 方向语义配色由 _cmp_color 决定（三色版：红涨、跌/无/持平 → 黑；宽版覆写为 涨绿跌红 与 K 线一致）；标签始终黑 val_color = self._cmp_color(direction, fg) - if direction: + if direction == "flat": + self._eq(x + trw / 2, y + 8 * k, 7 * k, fill=val_color); x += trw + tgap # 横杠落在第 6/9 行，中心 8 ≈ 数字墨迹中心 8.5 + elif direction: # 三角中心对齐 F12 数字墨迹竖直中心(y+8.5)，否则箭头偏高 - self.tri(x + trw / 2, y + 8.5 * k, 7 * k, up=up, fill=val_color); x += trw + tgap - self.text(x, y, val, self.F12, fill=val_color) + self.tri(x + trw / 2, y + 8.5 * k, 7 * k, up=direction == "up", fill=val_color); x += trw + tgap + # 数值伪粗体、字号不变（2026-09-14 用户要求）；标签常规字重；占位「--」不加粗（加粗会粘成一条长横） + self.text(x, y, val, self.F12, fill=val_color, bold=k if direction else 0) + + def _value(self, cx, y, col, bold=1): + """今日实时的数值：主数字 F24 粗，前缀（¥）/后缀（万）F12 小号、与主数字基线对齐（2026-09-14 用户要求「¥ 与 万 字号小一点」）， + 整体水平居中于 cx。col["vp"] 为 (前缀, 主数字, 后缀)，缺失时退回整串 col["v"] 按 F24 画。""" + pre, num, suf = col.get("vp") or ("", col["v"], "") + k = self.k + GAP = 1 * k # 小号段与主数字的间距 + sb = bold # 小号段同样伪粗体，否则挨着粗体主数字显得单薄 + wp = self._tw(pre, self.F12) + sb + GAP if pre else 0 + ws = GAP + self._tw(suf, self.F12) + sb if suf else 0 + wn = self._tw(num, self.F24) + bold + x = cx - (wp + wn + ws) / 2.0 + # 基线对齐：F12/F24 数字墨迹底沿分别为 13k/26k（getbbox），小号段下移其差值 + ys = y + (self.F24.getbbox("0")[3] - self.F12.getbbox("0")[3]) + if pre: + self.text(x, ys, pre, self.F12, bold=sb); x += wp + self.text(x, y, num, self.F24, bold=bold); x += wn + if suf: + self.text(x + GAP, ys, suf, self.F12, bold=sb) def _label(self, y, title, right=None, x0=None, x1=None): """区块标题（两区块统一，对齐主分支 _title_bar 风格）： @@ -174,9 +203,7 @@ class DashboardRenderer: if diff != 0: self.tri(cx, cy, TRI, up=up, fill=color) else: - k = self.k # 等号「=」：两道横杠，各宽 6k、厚 k，中间隔 2k，整体以 cy 为中心 - for top in (cy - 2 * k, cy + k): - self.d.rectangle([cx - TRI / 2, top, cx + TRI / 2 - 1, top + k - 1], fill=color) + self._eq(cx, cy, TRI, fill=color) # 等号与三角等宽 return tw + TRI_GAP + TRI def _usage_row(self, x0, x1, y, bar, warn, label_w=None): @@ -477,7 +504,7 @@ class DashboardRenderer: for i, c in enumerate(cols): cx = ax0 + cw * (i + 0.5) self.ctext(cx, 211, c["k"], self.F12) # 指标名（标题+18） - self.ctext(cx, 227, c["v"], self.F24, bold=1) # 数值 伪粗体（+34） + self._value(cx, 227, c, bold=1) # 数值 F24 伪粗体 + 小号 ¥/万（+34） self._cmp_line(cx, 257, "环比", c["hb"]) # +64 self._cmp_line(cx, 275, "同比", c["tb"]) # +82，墨迹止于≈289，底部留≈10px diff --git a/renderer_e1002.py b/renderer_e1002.py index 2ad0863..7b7ff5e 100644 --- a/renderer_e1002.py +++ b/renderer_e1002.py @@ -96,7 +96,7 @@ class E1002Renderer(DashboardRenderer): # ---------- 组件 ---------- def _status_battery(self, x, cy, dev): - """状态项·电池（F12，墨迹中心 cy）：外框 16×9 + 正极 2×4，内部按电量实心填充——充电中 GREEN、≤20% RED、其余 BLACK； + """状态项·电池（F12，数字伪粗体，墨迹中心 cy）：外框 16×9 + 正极 2×4，内部按电量实心填充——充电中 GREEN、≤20% RED、其余 BLACK； 右侧电量数字，缺失 "--"。返回末端 x。""" F, GAP_I = self.F12, 5 lvl, chg = (dev or {}).get("battery"), (dev or {}).get("charging") @@ -109,11 +109,12 @@ class E1002Renderer(DashboardRenderer): self.d.rectangle([x + 2, cy - 2, x + 2 + fw, cy + 2], fill=fill) x += 18 + GAP_I txt = f"{lvl}%" if lvl is not None else "--" - self._mid(x, cy, txt, F) - return x + self._tw(txt, F) + b = 1 if lvl is not None else 0 # 数字伪粗体、字号不变（2026-09-14 用户要求）；占位不加粗 + self._mid(x, cy, txt, F, bold=b) + return x + self._tw(txt, F) + b def _status_env(self, x, cy, dev): - """状态项·环境（F12，墨迹中心 cy）：温度计（细管 3×8 + 底部球 7×7，管内水银线）＋温度 ｜ 蓝色水滴（上尖下圆）＋湿度， + """状态项·环境（F12，数字伪粗体，墨迹中心 cy）：温度计（细管 3×8 + 底部球 7×7，管内水银线）＋温度 ｜ 蓝色水滴（上尖下圆）＋湿度， 项间距 16、图标↔数字 5；缺失 "--"。返回末端 x。""" F, GAP_I, GAP = self.F12, 5, 16 dev = dev or {} @@ -123,14 +124,16 @@ class E1002Renderer(DashboardRenderer): x += 7 + GAP_I t = dev.get("temp") txt = f"{t:.1f}℃" if t is not None else "--" - self._mid(x, cy, txt, F); x += self._tw(txt, F) + GAP + b = 1 if t is not None else 0 # 数字伪粗体、字号不变（2026-09-14 用户要求）；占位不加粗 + self._mid(x, cy, txt, F, bold=b); x += self._tw(txt, F) + b + GAP self.d.polygon([(x + 4, cy - 6), (x, cy + 2), (x + 8, cy + 2)], fill=BLUE) self.d.ellipse([x, cy - 1, x + 8, cy + 6], fill=BLUE) x += 9 + GAP_I h = dev.get("humidity") txt = f"{h:.0f}%" if h is not None else "--" - self._mid(x, cy, txt, F) - return x + self._tw(txt, F) + b = 1 if h is not None else 0 + self._mid(x, cy, txt, F, bold=b) + return x + self._tw(txt, F) + b def _color_strip(self, y0, y1, x0=None, x1=None): """六色测试色条：六块等宽实心色块，白块加 1px 黑框以便可见。真机校准用。""" @@ -210,7 +213,7 @@ class E1002Renderer(DashboardRenderer): for i, c in enumerate(cols): cx = x0 + cw * (i + 0.5) self.ctext(cx, TAG_Y, c["k"], self.F12) - self.ctext(cx, VAL_Y, c["v"], self.F24, bold=1) + self._value(cx, VAL_Y, c, bold=1) # F24 粗主数字 + 小号 ¥ / 万 self._cmp_line(cx, HB_Y, "环比", c["hb"]) self._cmp_line(cx, TB_Y, "同比", c["tb"]) return y0 + 104 @@ -236,7 +239,7 @@ class E1002Renderer(DashboardRenderer): col = GREEN if chg >= 0 else RED xr = x1 pct_txt = f"{abs(chg):.2f}%" - self.rtext(xr, y0, pct_txt, self.F12, fill=col); xr -= self._tw(pct_txt, self.F12) + 4 + self.rtext(xr, y0, pct_txt, self.F12, fill=col, bold=1); xr -= self._tw(pct_txt, self.F12) + 1 + 4 # 涨跌幅伪粗体（+1 为粗体偏移） self.tri(xr - 4, y0 + 8.5, 7, up=chg >= 0, fill=col); xr -= 8 + 6 if btc.get("chg_label"): # 涨跌幅口径（24h / 1d） self.rtext(xr, y0, btc["chg_label"], self.F12); xr -= self._tw(btc["chg_label"], self.F12) + 10