feat(compare): /api/v1/trace/epilogue 透传壳(比价结果页尾声帧)

App 收到 done、渲染完比价结果页后, 把自己页面的截图(base64 ~几百 KB)经本壳透传给
pricebot /api/trace/epilogue, 存进 trace 目录并触发重传 —— trace 里补上"用户实际
看到的汇总页"(步骤帧只有目标 App 画面)。壳同 finalize: 不鉴权、带 trace_id 亲和。

配套: pricebot-backend(端点+viewer)/android(拍屏上报)同名分支 7-3-ljh-testlab。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

.env.example

@@ -29,7 +29,7 @@ JG_REQUEST_TIMEOUT_SEC=15
 
 # ===== 无障碍保护存活监控(pull 后置检测;本期不接推送)=====
 HEARTBEAT_MONITOR_ENABLED=true
-HEARTBEAT_TIMEOUT_MINUTES=10
+HEARTBEAT_TIMEOUT_MINUTES=60
 HEARTBEAT_SCAN_INTERVAL_SEC=60
 
 # ===== 短信 (mock 模式) =====

app/api/v1/compare.py

@@ -119,6 +119,14 @@ async def price_step(request: Request) -> dict[str, Any]:
     return await _passthrough(request, "/api/price/step")
 
 
+@router.post("/trace/epilogue", summary="比价结果页尾声帧 (透传到 pricebot, 用户视角截图入 trace)")
+async def trace_epilogue(request: Request) -> dict[str, Any]:
+    # App 收到 done、渲染完结果页后,把自己页面的截图(base64)传给 pricebot 存进 trace
+    # 目录并触发重传 —— trace 里补上"用户实际看到的汇总页"(步骤帧只有目标 App 画面)。
+    # body ~几百 KB(截图 base64), 透传壳同 finalize(带 trace_id 亲和)。
+    return await _passthrough(request, "/api/trace/epilogue")
+
+
 @router.post("/trace/finalize", summary="比价 trace 收尾上云 (透传到 pricebot, 终止/未识别拿 trace_url)")
 async def trace_finalize(request: Request) -> dict[str, Any]:
     # 用户终止 / Phase1 未识别没走到 done 帧, pricebot 没上云也没回传 trace_url。客户端收尾时

app/core/config.py

@@ -68,7 +68,7 @@ class Settings(BaseSettings):
 
     # 无障碍保护存活监控后台任务(pull 后置检测;本期不接推送)
     HEARTBEAT_MONITOR_ENABLED: bool = True       # 总开关
-    HEARTBEAT_TIMEOUT_MINUTES: int = 10          # 多久没心跳算掉线(≈3 个客户端心跳周期)
+    HEARTBEAT_TIMEOUT_MINUTES: int = 60          # 多久没心跳算掉线(1 小时,避免短暂离线误判被杀)
     HEARTBEAT_SCAN_INTERVAL_SEC: int = 60        # 扫描周期
 
     # ===== 短信 =====