From 04fa31cb94178d7d58b9b2588b75874dcc1f4b2c Mon Sep 17 00:00:00 2001 From: YANG JIANKUAN Date: Fri, 18 Sep 2026 11:42:23 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20server.py=20=E8=BF=81=E7=A7=BB=E9=83=A8?= =?UTF-8?q?=E7=BD=B2=E5=88=B0=20NGCQ=EF=BC=881Panel=20Nginx=20=E5=8F=8D?= =?UTF-8?q?=E4=BB=A3=20eink.njcqit.com=EF=BC=89=EF=BC=8B=E5=A2=83=E5=86=85?= =?UTF-8?q?=E5=8F=AF=E8=BE=BE=20BTC=20=E8=A1=8C=E6=83=85=E6=BA=90=EF=BC=8B?= =?UTF-8?q?=E9=A1=B5=E9=9D=A2=E8=AE=BF=E9=97=AE=E4=BB=A4=E7=89=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - btc_api：新增 gateio／huobi_aws／binance_vision 三源，config 增 BTC_SOURCES 控制尝试顺序（境内 okx／coinbase／huobi 主域名不通） - server：IMAGE_TOKEN 非空时三个渲染端点须带 ?token=…，否则与未知路径同样 404（防爬虫扫描）；推送令牌改常量时间比较 - 文档：CLAUDE.md／README／.env.example 记录 NGCQ 部署（systemd eink-server、1Panel API 建站坑）、本机 server／cloudflared 已卸载 Co-Authored-By: Claude Fable 5.1 --- .env.example | 6 ++++++ CLAUDE.md | 24 +++++++++++------------- README.md | 3 ++- btc_api.py | 52 +++++++++++++++++++++++++++++++++++++++++++++------- config.py | 6 ++++++ server.py | 17 ++++++++++++++++- 6 files changed, 86 insertions(+), 22 deletions(-) diff --git a/.env.example b/.env.example index 459201e..9277c2b 100644 --- a/.env.example +++ b/.env.example @@ -35,6 +35,9 @@ CHROME_BIN= CHROME_EXTRA_ARGS= HTML_PNG_THRESHOLD=160 PUSH_TOKEN= +# 页面访问令牌：非空时 /e1002.png、/e1002.html、/e1002-web.png 必须带 ?token=，否则 404（防爬虫扫描）； +# SenseCraft HTML 控件填 https://<域名>/e1002.png?token=。生成：python3 -c "import secrets; print(secrets.token_urlsafe(24))" +IMAGE_TOKEN= PUSH_STATE_PATH= # 推送端（本机）：服务地址（协议+域名/端口，不含路径），令牌与服务端一致 PUSH_URL= @@ -47,6 +50,9 @@ PACE_TOL=10 BTC_BAR=1H BTC_LIMIT=48 BTC_TTL=300 +# 行情源尝试顺序（可选：okx,coinbase,huobi,gateio,huobi_aws,binance_vision；未列出的按默认顺序追加）。 +# 境内服务器 okx/coinbase/huobi 主域名不通且各超时数秒，部署 NGCQ 时设为 gateio,huobi_aws,binance_vision +BTC_SOURCES=okx,coinbase,huobi,gateio,huobi_aws,binance_vision # ---- AI 用量（本机采集 → main.py --target push 上报；server.py 不持凭证）---- # Claude：复用 Claude Code 钥匙串登录态调 /api/oauth/usage（只读不刷新）。快照有效期（秒，同 WEATHER_TTL 语义，0=每次实拉）建议 ≥300，失败退避 1800 秒 CLAUDE_USAGE_TTL=300 diff --git a/CLAUDE.md b/CLAUDE.md index 481392b..2229279 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -34,7 +34,7 @@ EPD_HOST=epd400a44.local python3 main.py 无测试、无 lint。调试渲染效果就跑 `--render-only` 看 `output/dashboard.png`。 -**配置统一走 `.env`**：所有凭证/参数放同目录 `.env`（已在 `.gitignore`，本机专用；模板见已提交的 `.env.example`）。`config.py` 顶部用零依赖加载器 `_load_dotenv()` 把 `.env` 写入 `os.environ`，再由各 `os.environ.get(...)` 读取；采用 `setdefault`，故**真实环境变量（cron/命令行注入）优先级高于 `.env`**。`config.py` 内不再保留任何明文凭证（fallback 为空串）。可配置项：`EPD_HOST`（局域网设备 mDNS host，默认 `epd400a44.local`）、`JM_BASE_API`/`JM_CLIENT_ID`/`JM_CLIENT_SECRET`/`JM_GRANT_TYPE`/`JM_TENANT_ID`、`QWEATHER_HOST`/`QWEATHER_KEY`/`WEATHER_LOCATION`(默认南京·江宁)/`WEATHER_TTL`、设备遥测 `SENSECRAFT_API_KEY`/`SENSECRAFT_DEVICE_EUI`/`DEVICE_TTL`、服务端 `FETCH_BUDGET`、`USAGE_WARN`、Claude 采集 `CLAUDE_USAGE_TTL`（快照有效期，语义同 `WEATHER_TTL`，0=每次实拉）/`CLAUDE_USAGE_BACKOFF`/`CLAUDE_USAGE_SCOPE_MODEL`、Codex 采集 `CODEX_BIN`/`CODEX_USAGE_HOME`/`CODEX_USAGE_TTL`/`CODEX_USAGE_BACKOFF`、仅宽版的 `USAGE_OK`/`PACE_TOL`/`BTC_BAR`/`BTC_LIMIT`/`BTC_TTL`/`MAO_TTL`、`E1002_COLOR_STRIP`。 +**配置统一走 `.env`**：所有凭证/参数放同目录 `.env`（已在 `.gitignore`，本机专用；模板见已提交的 `.env.example`）。`config.py` 顶部用零依赖加载器 `_load_dotenv()` 把 `.env` 写入 `os.environ`，再由各 `os.environ.get(...)` 读取；采用 `setdefault`，故**真实环境变量（cron/命令行注入）优先级高于 `.env`**。`config.py` 内不再保留任何明文凭证（fallback 为空串）。可配置项：`EPD_HOST`（局域网设备 mDNS host，默认 `epd400a44.local`）、`JM_BASE_API`/`JM_CLIENT_ID`/`JM_CLIENT_SECRET`/`JM_GRANT_TYPE`/`JM_TENANT_ID`、`QWEATHER_HOST`/`QWEATHER_KEY`/`WEATHER_LOCATION`(默认南京·江宁)/`WEATHER_TTL`、设备遥测 `SENSECRAFT_API_KEY`/`SENSECRAFT_DEVICE_EUI`/`DEVICE_TTL`、服务端 `FETCH_BUDGET`/`IMAGE_TOKEN`（页面访问令牌）/`PUSH_TOKEN`、`USAGE_WARN`、Claude 采集 `CLAUDE_USAGE_TTL`（快照有效期，语义同 `WEATHER_TTL`，0=每次实拉）/`CLAUDE_USAGE_BACKOFF`/`CLAUDE_USAGE_SCOPE_MODEL`、Codex 采集 `CODEX_BIN`/`CODEX_USAGE_HOME`/`CODEX_USAGE_TTL`/`CODEX_USAGE_BACKOFF`、仅宽版的 `USAGE_OK`/`PACE_TOL`/`BTC_BAR`/`BTC_LIMIT`/`BTC_TTL`/`BTC_SOURCES`（行情源顺序，境内服务器须排 gateio/huobi_aws/binance_vision 在前）/`MAO_TTL`、`E1002_COLOR_STRIP`。 **定时部署**：由 macOS **launchd LaunchAgent** 触发 `run.sh`（不再用 cron——cron 在现代 macOS 上易被 TCC/权限静默拦截，launchd 是系统原生调度器）。LaunchAgent plist 装在 `~/Library/LaunchAgents/com.jm.eink-push.plist`（机器专用，未入库，等价于 `run.sh`/`.env` 的本机产物），`StartInterval=300` + `RunAtLoad=true`：登录/重启后立即跑一次，此后每 5 分钟一次。用 LaunchAgent（非 LaunchDaemon）是因为脚本依赖当前用户的登录钥匙串（Claude Code 凭证）、`~/.codex`（Codex 登录态）、`.env`，必须在用户会话下运行——机器需已登录（或开了自动登录）才能保证开机即触发。`run.sh` 内部逻辑不变：cron 不继承登录环境，故脚本内 python 写死 vfox 绝对路径、并 `cd` 到项目目录后追加日志到 `output/cron.log`（`cd` 后 `config.py` 才能就近找到 `.env`）；launchd 自身的 stdout/stderr 另落 `output/launchd.log`（正常应为空，非空说明进程本身起不来，而非业务报错）。常用排查：`launchctl list | grep com.jm.eink-push` 看是否常驻及最近退出码，`launchctl kickstart -k gui/$(id -u)/com.jm.eink-push` 手动立即触发一次；改 plist 后需 `launchctl bootout` + `bootstrap` 重新加载才生效（热改文件不会自动生效）。每 5 分钟触发：业务数据每次都刷新，天气靠缓存、两路用量各有 `CLAUDE_USAGE_TTL`/`CODEX_USAGE_TTL` 有效期缓存（默认 300s，同一分钟内小屏渲染与上报两个进程只打一次接口），避免高频打接口（见 `data.py`）。 @@ -48,7 +48,7 @@ EPD_HOST=epd400a44.local python3 main.py - **`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` 轮换。 - **`weather_api.py`** — 和风天气（QWeather）客户端。用**用户专属 API Host**（`QWEATHER_HOST`）+ `X-QW-Api-Key` 头鉴权；响应 **gzip 压缩**（按 magic number 手动解压）、返回 `code` 为**字符串**。`get_now()` 取实时（`now.text` 中文天气 / `now.temp` / `now.icon` 图标代码），`get_today()` 取 `/3d` 的 `daily[0]` 今日温区。`QWEATHER_HOST`/`QWEATHER_KEY` 未配置时直接抛错→天气区显示 `"--"`。 - **`sensecraft_api.py`** — SenseCraft HMI 设备遥测客户端：`GET {SENSECRAFT_API_BASE}/api/v1/user/device/iot_data/{SENSECRAFT_DEVICE_EUI}`，头 `api-key`（用户在 SenseCraft 后台生成，放 `.env`，**2026-09-14 该 key 曾出现在对话里，建议轮换**），取 `result.battery.level/charging`、`result.sensor.temp/humidity`；设备每 `dataaccess.interval`=300s 上报一次，故 `DEVICE_TTL` 默认 300。直连不走代理、超时 10s、`code!=200` 抛错 → 状态栏 `--`。 -- **`btc_api.py`** — 比特币 K 线客户端，免费公开接口、无需密钥，`get_candles(bar, limit)`，周期代号 `BARS = {"1H", "1D"}` 映射到各源写法，逐源兜底 `SOURCES = (okx, coinbase, huobi)`：OKX `/api/v5/market/candles?instId=BTC-USDT&bar=`（主源，本地直连可达且最新）、Coinbase `/products/BTC-USD/candles?granularity=`、Huobi `/market/history/kline?period=`；各源字段顺序不同（OKX/Huobi 最新在前，Coinbase 为 [time, low, high, open, close]），统一归一为升序 `{ts, o, h, l, c}`。Binance 在本地区返回 restricted location，不列入。 +- **`btc_api.py`** — 比特币 K 线客户端，免费公开接口、无需密钥，`get_candles(bar, limit)`，周期代号 `BARS = {"1H", "1D"}` 映射到各源写法，逐源兜底 `SOURCES = (okx, coinbase, huobi, gateio, huobi_aws, binance_vision)`：OKX `/api/v5/market/candles?instId=BTC-USDT&bar=`（主源，本地直连可达且最新）、Coinbase `/products/BTC-USD/candles?granularity=`、Huobi `/market/history/kline?period=`（`huobi_aws` 同接口换 `api-aws.huobi.pro`）、Gate.io `/api/v4/spot/candlesticks`（升序 [ts, 成交额, close, high, low, open, …]）、Binance 公开镜像 `data-api.binance.vision/api/v3/klines`（升序 [openTime ms, o, h, l, c, …]）；各源字段顺序不同（OKX/Huobi 最新在前，Coinbase 为 [time, low, high, open, close]），统一归一为升序 `{ts, o, h, l, c}`。尝试顺序由 `config.BTC_SOURCES`（`_ordered_sources()`，未列出的按默认顺序追加）决定：本机默认 okx 在前；**境内 NGCQ 服务器 okx/coinbase/huobi 主域名不通**，`.env` 设 `gateio,huobi_aws,binance_vision`。`api.binance.com` 在本地区返回 restricted location，不列入。 - **`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`（小屏 F16 百分比的手动字距），宽版置 0——其 F16 映射到 12px、加粗后由 `_track()` 自动加 1px 字距；基类另抽 `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）；天气右（上层 图标 ×1.25 ｜ 温度 F48 顶沿齐时钟＋「°」F24 上标；下层 一行 定位＋城市·天气·温区 右对齐，均贴 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）。 +- **`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 渲染器非线程安全）；**三个渲染端点在 `IMAGE_TOKEN` 非空时必须带 `?token=`（`_page_authed`，`hmac.compare_digest`），否则返回与未知路径完全相同的 404、日志标 `bad page token`（2026-09-18 用户要求，防爬虫扫到固定路径）；`/health` 不需要令牌**；`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` 的方块装饰只给标题）。 - **`push_client.py`** — 本机推送端：`SOURCES` 两路——`claude_usage.get_usage()` → `POST {PUSH_URL}/push/usage`、`codex_usage.get_usage()` → `POST {PUSH_URL}/push/usage_gpt`（推前去掉 `status` 键）；两路彼此独立，一路失败只打日志、两路都失败才非零退出；直连不走代理、连接类异常重试 2 次、4xx/5xx 直接报错。 @@ -91,20 +91,18 @@ EPD_HOST=epd400a44.local python3 main.py （`git show HEAD:renderer.py > /tmp/orig/renderer.py`，切换 `sys.path` 分别 import 渲染，`ImageChops.difference(a,b).getbbox() is None`）； 六色版渲染后 `set(img.getcolors())` 必须 ⊆ `SPECTRA6`。夹具需覆盖：pct=None、≥warn 红档、≤ok 绿档、direction=None、空 candles。 - **HTML→截图逐像素核验**：`"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless=new --disable-gpu --hide-scrollbars --force-device-scale-factor=1 --window-size=800,480 --screenshot=/tmp/s.png file://…`；**勿加指向空目录的 `--user-data-dir`**（卡死到超时）。 -- **server.py / cloudflared 常驻（2026-09-15 起走 launchd）**：`~/Library/LaunchAgents/com.jm.eink-server.plist`（vfox python 绝对路径跑 `server.py`）与 `com.jm.eink-cloudflared.plist`（`cloudflared tunnel --url http://127.0.0.1:8790 --no-autoupdate --protocol http2`），均 `RunAtLoad`+`KeepAlive`，日志仍落 `output/server.log`/`output/cloudflared.log`；机器专用、未入库。**为什么**：此前两者在 Claude Code 工具 shell 里 `nohup … &` 启动，会话回收时被同一秒 SIGTERM（2026-09-15 10:11 两进程同时退出），电脑重启后也不会自起（当天早上重启即中断）。重启/查看：`launchctl kickstart -k gui/$(id -u)/com.jm.eink-cloudflared`（隧道地址会变，需更新 SenseCraft）、`launchctl list | grep com.jm.eink`；改代码后 kickstart server 即生效。改 plist 需 `launchctl bootout gui/$(id -u)/