Upload 3 files

DEPLOY.md

@@ -46,4 +46,9 @@ JupyterLab 必须设置 Space Secret `JUPYTER_TOKEN`，打开实际 Space App
 
 若仍无法进入界面，请从 Hugging Face Space 的 Runtime logs 复制 `jupyter.log`/`nginx` 对应错误、以及浏览器网络请求的 HTTP 状态码（不要包含 token 或 API key）。
 
-QQ 白名单用户还可以发送 `/diag` 获取脱敏后的最近 bridge/startup/jupyter 日志；若机器人仍在线，优先用 `/status` 和 `/diag` 排查，无须进入 Jupyter Terminal。不要把诊断消息转发给其他人。容器的 Jupyter 与 QQ 日志默认保存在临时 data 目录；启动崩溃时会将脱敏后的最后几行写入 Space Runtime logs。
+QQ 白名单用户还可以发送 `/diag` 获取脱敏后的最近 bridge/startup/jupyter 日志；若机器人仍在线，优先用 `/status` 和 `/diag` 排查，无须进入 Jupyter Terminal。不要把诊断消息转发给其他人。容器的 Jupyter 与 QQ 日志默认保存在临时 data 目录；启动崩溃时会将脱敏后的最后几行写入 Space Runtime logs。
+
+## UptimeRobot 成功请求记录
+每次 `/health` 同时确认 Jupyter 可连接并返回 HTTP 200 后，服务会在 `/home/node/app/data/uptime-heartbeat.log` 追加一个 `.` 字符；启动时删除旧文件并重建为空文件。查看该文件的字符数即可判断成功到达的健康请求次数，例如 `wc -c data/uptime-heartbeat.log`。失败的请求、404 和 Jupyter 未启动时不会追加字符。该文件和 history 一样属于临时容器文件层，Space 重启后会丢失。
+
+这个日志只能证明请求到达了当前运行中的容器，不能让 Hugging Face 把 Space 视为永久活跃，也不能阻止平台按免费硬件的闲置策略休眠或回收。若 Space 已经休眠，UptimeRobot 的请求通常只能触发一次唤醒/返回启动中的状态，是否重新启动及响应时间由 Hugging Face 平台决定；请以 Space Runtime 状态和平台政策为准。

scripts/health.py

@@ -2,8 +2,10 @@ import http.server
 import os
 import socket
 import sys
+from pathlib import Path
 
 PIDS = [int(p) for p in sys.argv[1:] if p.isdigit() and int(p) > 0]
+HEARTBEAT_FILE = Path(os.environ.get("HEARTBEAT_FILE", "/home/node/app/data/uptime-heartbeat.log"))
 
 class Handler(http.server.BaseHTTPRequestHandler):
     def do_GET(self):
@@ -15,6 +17,11 @@ class Handler(http.server.BaseHTTPRequestHandler):
                 os.kill(pid, 0)
             with socket.create_connection(("127.0.0.1", 8888), timeout=2):
                 pass
+            # One successful public health request produces exactly one byte.
+            HEARTBEAT_FILE.parent.mkdir(parents=True, exist_ok=True)
+            with HEARTBEAT_FILE.open("a", encoding="ascii") as heartbeat:
+                heartbeat.write(".")
+                heartbeat.flush()
             status, body = 200, b"ok\n"
         except OSError:
             status, body = 503, b"unavailable\n"

scripts/start.sh

@@ -4,7 +4,9 @@ cd /home/node/app
 mkdir -p data workspace /tmp/nginx
 # Both chat history and Codex/Jupyter working files are ephemeral.
 find workspace -mindepth 1 -maxdepth 1 -exec rm -rf -- {} +
-rm -f data/history.json data/bridge.log data/codex-*.txt data/jupyter.log data/nginx.log data/startup.log
+rm -f data/history.json data/bridge.log data/codex-*.txt data/jupyter.log data/nginx.log data/startup.log data/health.log data/uptime-heartbeat.log
+touch data/uptime-heartbeat.log
+export HEARTBEAT_FILE=/home/node/app/data/uptime-heartbeat.log
 exec > >(tee -a data/startup.log) 2>&1
 : "${JUPYTER_TOKEN:?Set JUPYTER_TOKEN in Space Secrets to access JupyterLab}"
 printf '%s startup begin\n' "$(date -Is)"