🌐 Web Capture

📚 使用说明

重要提示：

• 🧠 按需截图：每次截图后用视觉大模型实时判断是否已截全主题内容、是否还需继续滚动，自动滚动到内容结束并拼接成长图；支持多视觉大模型接口配置（「⚙️ 智能配置」中增删改，列表顺序=优先级，失败/报错自动降级到下一个接口）
• 📦 网址缓存：默认开启——同一网址先查提取历史（同动作、成功、在有效期内）直接返回，不重复提取；有效期默认 7 天，填 -1 则永久有效。可「⚙️ 缓存/重试」关开关/改有效期，或请求带 refresh:true 强制绕过
• 🔁 失败自动重试：提取失败（网络/超时/浏览器错误）自动重试，次数可设（默认 2 次，间隔 15 秒），响应带 attempts 字段
• 📊 提取历史统计：历史区点「📊 统计」，可按天/操作类型/后端/状态/调用者/调用方式等角度切换图表（柱状/饼图可换，支持 7/30/90 天范围，可下载 PNG）
• 📝 提取文本：自动剔除脚本/样式/标签，得到干净的前端可读文本，适合直接用于分析/喂给大模型
• ⏱️ 页面加载等待：某些网站需要验证过程（如 Cloudflare），请设置较长时间（10000-30000ms）
• 🔄 滚动次数：用于加载动态内容（如微博、推特等），建议 3-5 次
• 🎯 全页截图：滚动加载后建议开启此选项
• 📜 提取历史：每次提取自动入库，支持分页浏览、按类型筛选、搜索与删除；每条记录会标注调用者（游客/项目名）与调用方式（web/api），并自动把最原始 HTML 按月归档到 data/html/<月份>/（详情里可点「📄 原始HTML文件」查看）
• 👤 API 调用方标识：请求体带 caller（或请求头 X-Caller/X-Project）即可在历史里显示项目名；带 call_method 或 X-From 标注调用方式，缺省按 Referer 自动判定 web/api

API 调用：

POST /api/capture
{
  "url": "https://example.com",
  "action": "smart",          // "screenshot" | "html" | "text" | "smart"
  "wait_time": 15000,         // 重要！验证网站需设置较长等待
  "scroll_times": 3,          // 可选：加载动态内容
  "scroll_delay": 1000,       // 可选：滚动间隔
  "full_page": true,          // 可选：全页截图
  "backend": "auto",           // 可选：auto(默认,优先playwright,失败回退agent-browser) / playwright / agent-browser / chrome-cdp
  "caller": "news-tracker",     // 可选：调用者标识（历史记录里显示，默认游客）
  "call_method": "api",        // 可选：调用方式 web/api（缺省自动判定）
  "viewport": {"width":1280,"height":700},
  // ---- 📦 网址缓存（默认开启，全局配置在 /api/capture/settings）----
  "refresh": false,           // 可选：true=强制实时提取(绕过缓存)
  "cache": true,              // 可选：false=本次请求禁用缓存
  "cache_ttl_seconds": 604800,  // 可选：本次缓存时效(秒, -1=永久)，覆盖全局有效期，命中判定也用它
  "smart_config": {           // 可选：临时覆盖按需截图配置（接口列表按顺序=优先级，失败自动降级）
    "endpoints": [
      {"name":"本地Qwen", "base_url":"http://121.40.164.32:18008/v1", "api_key":"xxxx", "model":"unsloth/Qwen3.8-27B-NVFP4", "enabled":true},
      {"name":"Kimi", "base_url":"https://api.siliconflow.cn/v1", "api_key":"sk-xxx", "model":"Pro/moonshotai/Kimi-K2.6", "enabled":true}
    ],
    "max_scrolls": 20,
    "scroll_ratio": 0.85
  }
}
// 缓存命中响应（text/html/smart 为 JSON；screenshot 直接返回历史图片文件）：
// {success:true, from_cache:true, history_id:123, cached_at:"2026-09-11 22:49:41", cache_ttl_seconds:3600, ...}

📦 缓存/🔁 重试全局配置（页面「⚙️ 缓存/重试」按钮或以下接口）：
GET  /api/capture/settings
POST /api/capture/settings
{
  "settings": {
    "cache": {"enabled": true, "ttl_seconds": 604800},  // enabled=缓存开关, ttl_seconds=有效期(秒, 默认7天=604800, -1=永久有效)
    "retry": {"max_retries": 2, "delay_seconds": 15}    // max_retries=失败重试次数(默认2), delay_seconds=重试间隔(秒, 默认15)
  }
}

GET  /api/smart/config         // 获取智能截图配置（含 endpoints 多接口列表）
POST /api/smart/config         // 保存配置（body: {config:{endpoints:[...], prompt, max_scrolls,...}}）
POST /api/smart/test           // 测试指定接口（body: {endpoint_id} 或 {endpoint:{...}} 或旧版 {config:{...}}）
GET  /api/history?page=1&page_size=15&action=all&search=关键词   // 历史分页
GET  /api/history/stats?dimension=day&days=30   // 历史统计（dimension: day/action/backend/status/caller/method）
GET  /api/history/<id>         // 历史详情
GET  /api/history/<id>/file     // 历史截图文件
DELETE /api/history/<id>        // 删除历史