argo-search 1.0.1 → 2.9.8

package/docs/assets/architecture.svg

@@ -0,0 +1,104 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 500" fill="none">
+  <defs>
+    <linearGradient id="bg2" x1="0" y1="0" x2="800" y2="500" gradientUnits="userSpaceOnUse">
+      <stop offset="0%" stop-color="#0f172a"/>
+      <stop offset="100%" stop-color="#1e293b"/>
+    </linearGradient>
+    <linearGradient id="g-blue" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#38bdf8"/>
+      <stop offset="100%" stop-color="#0ea5e9"/>
+    </linearGradient>
+    <linearGradient id="g-purple" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#818cf8"/>
+      <stop offset="100%" stop-color="#6366f1"/>
+    </linearGradient>
+    <linearGradient id="g-green" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#34d399"/>
+      <stop offset="100%" stop-color="#10b981"/>
+    </linearGradient>
+    <linearGradient id="g-amber" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#fbbf24"/>
+      <stop offset="100%" stop-color="#f59e0b"/>
+    </linearGradient>
+    <linearGradient id="g-rose" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#fb7185"/>
+      <stop offset="100%" stop-color="#e11d48"/>
+    </linearGradient>
+  </defs>
+
+  <rect width="800" height="500" rx="12" fill="url(#bg2)"/>
+
+  <!-- Title -->
+  <text x="400" y="35" text-anchor="middle" font-family="system-ui, sans-serif" font-size="16" font-weight="600" fill="#e2e8f0">Argo 架构概览</text>
+
+  <!-- Input -->
+  <rect x="320" y="50" width="160" height="36" rx="8" fill="url(#g-blue)" opacity="0.9"/>
+  <text x="400" y="73" text-anchor="middle" font-family="system-ui, sans-serif" font-size="12" fill="white" font-weight="600">搜索查询</text>
+
+  <!-- Arrow down -->
+  <line x1="400" y1="86" x2="400" y2="110" stroke="#475569" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+  <defs><marker id="arrowhead" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto"><polygon points="0 0, 8 3, 0 6" fill="#475569"/></marker></defs>
+
+  <!-- Router box -->
+  <rect x="250" y="110" width="300" height="55" rx="10" fill="url(#g-purple)" opacity="0.15" stroke="url(#g-purple)" stroke-width="1.5"/>
+  <text x="400" y="132" text-anchor="middle" font-family="system-ui, sans-serif" font-size="11" fill="#c4b5fd" font-weight="600">TF-IDF 语义路由</text>
+  <text x="400" y="152" text-anchor="middle" font-family="system-ui, sans-serif" font-size="9" fill="#94a3b8">正则域 · 余弦相似度 · 配额感知</text>
+
+  <!-- Arrows from router -->
+  <line x1="330" y1="165" x2="200" y2="210" stroke="#475569" stroke-width="1" marker-end="url(#arrowhead)"/>
+  <line x1="400" y1="165" x2="400" y2="210" stroke="#475569" stroke-width="1" marker-end="url(#arrowhead)"/>
+  <line x1="470" y1="165" x2="600" y2="210" stroke="#475569" stroke-width="1" marker-end="url(#arrowhead)"/>
+
+  <!-- T1 box -->
+  <rect x="80" y="210" width="240" height="80" rx="10" fill="url(#g-purple)" opacity="0.1" stroke="url(#g-purple)" stroke-width="1"/>
+  <text x="200" y="232" text-anchor="middle" font-family="system-ui, sans-serif" font-size="11" fill="#a5b4fc" font-weight="600">T1 — 直连引擎</text>
+  <text x="200" y="250" text-anchor="middle" font-family="monospace" font-size="8" fill="#94a3b8">anysearch · zhihu · eastmoney</text>
+  <text x="200" y="264" text-anchor="middle" font-family="monospace" font-size="8" fill="#94a3b8">tavily · github · arxiv · byted</text>
+  <text x="200" y="280" text-anchor="middle" font-family="system-ui, sans-serif" font-size="8" fill="#94a3b8">0.4–3.5s · 部分需 API Key</text>
+
+  <!-- Cache box -->
+  <rect x="340" y="210" width="120" height="80" rx="10" fill="url(#g-amber)" opacity="0.1" stroke="url(#g-amber)" stroke-width="1"/>
+  <text x="400" y="232" text-anchor="middle" font-family="system-ui, sans-serif" font-size="11" fill="#fcd34d" font-weight="600">缓存</text>
+  <text x="400" y="250" text-anchor="middle" font-family="system-ui, sans-serif" font-size="8" fill="#94a3b8">L1 内存 LRU</text>
+  <text x="400" y="264" text-anchor="middle" font-family="system-ui, sans-serif" font-size="8" fill="#94a3b8">L2 SQLite</text>
+  <text x="400" y="280" text-anchor="middle" font-family="system-ui, sans-serif" font-size="8" fill="#94a3b8">分级 TTL</text>
+
+  <!-- T2 box -->
+  <rect x="480" y="210" width="240" height="80" rx="10" fill="url(#g-green)" opacity="0.1" stroke="url(#g-green)" stroke-width="1"/>
+  <text x="600" y="232" text-anchor="middle" font-family="system-ui, sans-serif" font-size="11" fill="#6ee7b7" font-weight="600">T2 — 本地引擎</text>
+  <text x="600" y="250" text-anchor="middle" font-family="monospace" font-size="8" fill="#94a3b8">bing · sogou · duckduckgo</text>
+  <text x="600" y="264" text-anchor="middle" font-family="monospace" font-size="8" fill="#94a3b8">github · stackoverflow · pubmed</text>
+  <text x="600" y="280" text-anchor="middle" font-family="system-ui, sans-serif" font-size="8" fill="#94a3b8">0.6–5s · 零成本</text>
+
+  <!-- Fallback arrows -->
+  <path d="M 320 250 Q 330 250 330 250" stroke="#475569" stroke-width="1" stroke-dasharray="4,3" marker-end="url(#arrowhead)"/>
+  <path d="M 460 250 Q 470 250 470 250" stroke="#475569" stroke-width="1" stroke-dasharray="4,3" marker-end="url(#arrowhead)"/>
+
+  <!-- Labels for fallback -->
+  <text x="325" y="244" font-family="system-ui, sans-serif" font-size="7" fill="#64748b" text-anchor="end">T1 失败</text>
+  <text x="475" y="244" font-family="system-ui, sans-serif" font-size="7" fill="#64748b">T2 失败</text>
+
+  <!-- Arrows to merge -->
+  <line x1="200" y1="290" x2="350" y2="330" stroke="#475569" stroke-width="1" marker-end="url(#arrowhead)"/>
+  <line x1="400" y1="290" x2="400" y2="330" stroke="#475569" stroke-width="1" marker-end="url(#arrowhead)"/>
+  <line x1="600" y1="290" x2="450" y2="330" stroke="#475569" stroke-width="1" marker-end="url(#arrowhead)"/>
+
+  <!-- Merge / RRF box -->
+  <rect x="280" y="330" width="240" height="45" rx="10" fill="url(#g-rose)" opacity="0.15" stroke="url(#g-rose)" stroke-width="1"/>
+  <text x="400" y="350" text-anchor="middle" font-family="system-ui, sans-serif" font-size="11" fill="#fda4af" font-weight="600">RRF 融合 · 去重 · 精排</text>
+  <text x="400" y="368" text-anchor="middle" font-family="system-ui, sans-serif" font-size="8" fill="#94a3b8">多源融合 → 可选语义精排</text>
+
+  <!-- Arrow to output -->
+  <line x1="400" y1="375" x2="400" y2="405" stroke="#475569" stroke-width="1.5" marker-end="url(#arrowhead)"/>
+
+  <!-- Output box -->
+  <rect x="280" y="405" width="240" height="50" rx="10" fill="url(#g-blue)" opacity="0.15" stroke="url(#g-blue)" stroke-width="1.5"/>
+  <text x="400" y="427" text-anchor="middle" font-family="system-ui, sans-serif" font-size="11" fill="#7dd3fc" font-weight="600">统一 JSON 输出</text>
+  <text x="400" y="445" text-anchor="middle" font-family="system-ui, sans-serif" font-size="8" fill="#94a3b8">结果 · 评分 · 域 · 引擎状态</text>
+
+  <!-- Side labels -->
+  <text x="45" y="260" font-family="monospace" font-size="9" fill="#6366f1" transform="rotate(-90, 45, 260)">TIER 1</text>
+  <text x="755" y="260" font-family="monospace" font-size="9" fill="#10b981" transform="rotate(90, 755, 260)">TIER 2</text>
+  <text x="315" y="255" font-family="monospace" font-size="7" fill="#f59e0b">→</text>
+  <text x="455" y="255" font-family="monospace" font-size="7" fill="#f59e0b">→</text>
+</svg>

package/docs/assets/hero.svg

@@ -0,0 +1,98 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 200" fill="none">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="800" y2="200" gradientUnits="userSpaceOnUse">
+      <stop offset="0%" stop-color="#0f172a"/>
+      <stop offset="100%" stop-color="#1e293b"/>
+    </linearGradient>
+    <linearGradient id="accent" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#38bdf8"/>
+      <stop offset="100%" stop-color="#818cf8"/>
+    </linearGradient>
+    <linearGradient id="accent2" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#34d399"/>
+      <stop offset="100%" stop-color="#38bdf8"/>
+    </linearGradient>
+    <filter id="glow">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="800" height="200" rx="12" fill="url(#bg)"/>
+
+  <!-- Grid pattern -->
+  <g opacity="0.06" stroke="#38bdf8" stroke-width="0.5">
+    <line x1="0" y1="40" x2="800" y2="40"/>
+    <line x1="0" y1="80" x2="800" y2="80"/>
+    <line x1="0" y1="120" x2="800" y2="120"/>
+    <line x1="0" y1="160" x2="800" y2="160"/>
+    <line x1="100" y1="0" x2="100" y2="200"/>
+    <line x1="200" y1="0" x2="200" y2="200"/>
+    <line x1="300" y1="0" x2="300" y2="200"/>
+    <line x1="400" y1="0" x2="400" y2="200"/>
+    <line x1="500" y1="0" x2="500" y2="200"/>
+    <line x1="600" y1="0" x2="600" y2="200"/>
+    <line x1="700" y1="0" x2="700" y2="200"/>
+  </g>
+
+  <!-- Central search icon -->
+  <g transform="translate(400, 85)" filter="url(#glow)">
+    <circle cx="0" cy="0" r="28" fill="none" stroke="url(#accent)" stroke-width="2.5" opacity="0.9"/>
+    <circle cx="0" cy="0" r="18" fill="none" stroke="url(#accent)" stroke-width="1.5" opacity="0.5"/>
+    <line x1="20" y1="20" x2="38" y2="38" stroke="url(#accent)" stroke-width="3" stroke-linecap="round"/>
+    <circle cx="0" cy="0" r="4" fill="url(#accent)" opacity="0.8"/>
+  </g>
+
+  <!-- Engine nodes -->
+  <g opacity="0.85">
+    <!-- T1 nodes -->
+    <circle cx="120" cy="70" r="16" fill="none" stroke="#38bdf8" stroke-width="1.5" opacity="0.7"/>
+    <text x="120" y="74" text-anchor="middle" font-family="monospace" font-size="8" fill="#38bdf8">API</text>
+
+    <circle cx="200" cy="55" r="16" fill="none" stroke="#818cf8" stroke-width="1.5" opacity="0.7"/>
+    <text x="200" y="59" text-anchor="middle" font-family="monospace" font-size="8" fill="#818cf8">T1</text>
+
+    <circle cx="600" cy="55" r="16" fill="none" stroke="#818cf8" stroke-width="1.5" opacity="0.7"/>
+    <text x="600" y="59" text-anchor="middle" font-family="monospace" font-size="8" fill="#818cf8">T1</text>
+
+    <circle cx="680" cy="70" r="16" fill="none" stroke="#38bdf8" stroke-width="1.5" opacity="0.7"/>
+    <text x="680" y="74" text-anchor="middle" font-family="monospace" font-size="8" fill="#38bdf8">API</text>
+
+    <!-- T2 nodes -->
+    <circle cx="120" cy="130" r="14" fill="none" stroke="#34d399" stroke-width="1.5" opacity="0.6"/>
+    <text x="120" y="134" text-anchor="middle" font-family="monospace" font-size="7" fill="#34d399">T2</text>
+
+    <circle cx="200" cy="145" r="14" fill="none" stroke="#34d399" stroke-width="1.5" opacity="0.6"/>
+    <text x="200" y="149" text-anchor="middle" font-family="monospace" font-size="7" fill="#34d399">T2</text>
+
+    <circle cx="600" cy="145" r="14" fill="none" stroke="#34d399" stroke-width="1.5" opacity="0.6"/>
+    <text x="600" y="149" text-anchor="middle" font-family="monospace" font-size="7" fill="#34d399">T2</text>
+
+    <circle cx="680" cy="130" r="14" fill="none" stroke="#34d399" stroke-width="1.5" opacity="0.6"/>
+    <text x="680" y="134" text-anchor="middle" font-family="monospace" font-size="7" fill="#34d399">T2</text>
+  </g>
+
+  <!-- Connection lines -->
+  <g stroke="url(#accent)" stroke-width="1" opacity="0.3">
+    <line x1="136" y1="70" x2="370" y2="85"/>
+    <line x1="216" y1="55" x2="375" y2="80"/>
+    <line x1="584" y1="55" x2="425" y2="80"/>
+    <line x1="664" y1="70" x2="430" y2="85"/>
+    <line x1="134" y1="130" x2="370" y2="95"/>
+    <line x1="214" y1="145" x2="375" y2="100"/>
+    <line x1="586" y1="145" x2="425" y2="100"/>
+    <line x1="666" y1="130" x2="430" y2="95"/>
+  </g>
+
+  <!-- Title -->
+  <text x="400" y="170" text-anchor="middle" font-family="system-ui, -apple-system, sans-serif" font-size="28" font-weight="700" fill="white">
+    Argo 阿尔戈
+  </text>
+  <text x="400" y="192" text-anchor="middle" font-family="system-ui, -apple-system, sans-serif" font-size="12" fill="#94a3b8">
+    统一搜索 · 证据核验 · 多引擎路由 · 双层缓存
+  </text>
+</svg>

package/docs/engines/bangumi.md

@@ -0,0 +1,27 @@
+# 引擎：`bangumi`
+
+- 准入时间: 2026-09-12T21:19:33+08:00
+- 状态: admitted
+- cost_tier: free
+- type: bangumi
+- quality_score: 1.0
+- avg_latency_ms: 595.6
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=412.4ms · count=10
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine bangumi
+python3 scripts/engine_validate.py --engine bangumi --stage health
+```

package/docs/engines/biorxiv.md

@@ -0,0 +1,27 @@
+# 引擎：`biorxiv`
+
+- 准入时间: 2026-09-12T16:38:04+08:00
+- 状态: admitted
+- cost_tier: free
+- type: biorxiv
+- quality_score: 1.0
+- avg_latency_ms: 1784.0
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=1240.8ms · count=2
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine biorxiv
+python3 scripts/engine_validate.py --engine biorxiv --stage health
+```

package/docs/engines/clawhub.md

@@ -0,0 +1,27 @@
+# 引擎：`clawhub`
+
+- 准入时间: 2026-09-15T17:03:23+08:00
+- 状态: admitted
+- cost_tier: free
+- type: http
+- quality_score: 1.0
+- avg_latency_ms: 6646.3
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=5094.3ms · count=10
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine clawhub
+python3 scripts/engine_validate.py --engine clawhub --stage health
+```

package/docs/engines/crt_sh.md

@@ -0,0 +1,27 @@
+# 引擎：`crt_sh`
+
+- 准入时间: 2026-09-12T21:26:15+08:00
+- 状态: admitted
+- cost_tier: free
+- type: http
+- quality_score: 0.5
+- avg_latency_ms: 6603.5
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=3281.2ms · count=10
+- quality: pass · score=0.5 · empty_rate=0.5
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine crt_sh
+python3 scripts/engine_validate.py --engine crt_sh --stage health
+```

package/docs/engines/datacite.md

@@ -0,0 +1,27 @@
+# 引擎：`datacite`
+
+- 准入时间: 2026-08-05T21:56:02+08:00
+- 状态: admitted
+- cost_tier: free
+- type: http
+- quality_score: 1.0
+- avg_latency_ms: 2184.8
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=1496.8ms · count=3
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine datacite
+python3 scripts/engine_validate.py --engine datacite --stage health
+```

package/docs/engines/deps_dev.md

@@ -0,0 +1,27 @@
+# 引擎：`deps_dev`
+
+- 准入时间: 2026-09-12T16:37:56+08:00
+- 状态: admitted
+- cost_tier: free
+- type: deps_dev
+- quality_score: 1.0
+- avg_latency_ms: 216.0
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=275.7ms · count=9
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine deps_dev
+python3 scripts/engine_validate.py --engine deps_dev --stage health
+```

package/docs/engines/douban_movie.md

@@ -0,0 +1,27 @@
+# 引擎：`douban_movie`
+
+- 准入时间: 2026-09-12T21:19:35+08:00
+- 状态: admitted
+- cost_tier: free
+- type: douban_movie
+- quality_score: 1.0
+- avg_latency_ms: 319.9
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=245.5ms · count=4
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine douban_movie
+python3 scripts/engine_validate.py --engine douban_movie --stage health
+```

package/docs/engines/endoflife.md

@@ -0,0 +1,27 @@
+# 引擎：`endoflife`
+
+- 准入时间: 2026-09-12T16:37:58+08:00
+- 状态: admitted
+- cost_tier: free
+- type: endoflife
+- quality_score: 1.0
+- avg_latency_ms: 305.3
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=235.1ms · count=10
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine endoflife
+python3 scripts/engine_validate.py --engine endoflife --stage health
+```

package/docs/engines/flk_law.md

@@ -0,0 +1,27 @@
+# 引擎：`flk_law`
+
+- 准入时间: 2026-09-12T21:26:20+08:00
+- 状态: admitted
+- cost_tier: free
+- type: flk_law
+- quality_score: 1.0
+- avg_latency_ms: 800.1
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=1385.1ms · count=10
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine flk_law
+python3 scripts/engine_validate.py --engine flk_law --stage health
+```

package/docs/engines/fxtwitter.md

@@ -0,0 +1,27 @@
+# 引擎：`fxtwitter`
+
+- 准入时间: 2026-07-30T18:40:00+08:00
+- 状态: admitted
+- cost_tier: free
+- type: http
+- quality_score: 1.0
+- avg_latency_ms: 948.3
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=1000.0ms · count=3
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine fxtwitter
+python3 scripts/engine_validate.py --engine fxtwitter --stage health
+```

package/docs/engines/google_news.md

@@ -0,0 +1,27 @@
+# 引擎：`google_news`
+
+- 准入时间: 2026-09-12T21:18:53+08:00
+- 状态: admitted
+- cost_tier: free
+- type: google_news
+- quality_score: 1.0
+- avg_latency_ms: 854.1
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=627.8ms · count=10
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine google_news
+python3 scripts/engine_validate.py --engine google_news --stage health
+```

package/docs/engines/gov_regulations.md

@@ -0,0 +1,27 @@
+# 引擎：`gov_regulations`
+
+- 准入时间: 2026-09-12T21:18:50+08:00
+- 状态: admitted
+- cost_tier: free
+- type: http
+- quality_score: 1.0
+- avg_latency_ms: 355.6
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=389.6ms · count=10
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine gov_regulations
+python3 scripts/engine_validate.py --engine gov_regulations --stage health
+```

package/docs/engines/guqian.md

@@ -0,0 +1,27 @@
+# 引擎：`guqian`
+
+- 准入时间: 2026-08-05T21:56:03+08:00
+- 状态: admitted
+- cost_tier: free
+- type: cli
+- quality_score: 1.0
+- avg_latency_ms: 32.0
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=36.7ms · count=3
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine guqian
+python3 scripts/engine_validate.py --engine guqian --stage health
+```

package/docs/engines/hackernews.md

@@ -0,0 +1,27 @@
+# 引擎：`hackernews`
+
+- 准入时间: 2026-07-30T08:53:49+08:00
+- 状态: admitted
+- cost_tier: free
+- type: hackernews
+- quality_score: None
+- avg_latency_ms: 519.6
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=519.6ms · count=3
+- quality: None · score=None · empty_rate=None
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine hackernews
+python3 scripts/engine_validate.py --engine hackernews --stage health
+```

package/docs/engines/iplant.md

@@ -0,0 +1,27 @@
+# 引擎：`iplant`
+
+- 准入时间: 2026-09-21T13:58:04+08:00
+- 状态: admitted
+- cost_tier: free
+- type: iplant
+- quality_score: 1.0
+- avg_latency_ms: 683.4
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| （无） | 否 |
+
+## 最近验证
+
+- health: pass · latency=678.5ms · count=1
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine iplant
+python3 scripts/engine_validate.py --engine iplant --stage health
+```

package/docs/engines/keenable.md

@@ -0,0 +1,27 @@
+# 引擎：`keenable`
+
+- 准入时间: 2026-08-26T08:57:39+08:00
+- 状态: admitted
+- cost_tier: free
+- type: http
+- quality_score: 1.0
+- avg_latency_ms: 669.3
+- blocked: False
+
+## 环境变量
+
+| 变量 | 必填 |
+|------|------|
+| `ARGO_KEENABLE_API_KEY` | 是 |
+
+## 最近验证
+
+- health: pass · latency=666.1ms · count=10
+- quality: pass · score=1.0 · empty_rate=0.0
+
+## 调用
+
+```bash
+python3 scripts/search.py "查询词" --engine keenable
+python3 scripts/engine_validate.py --engine keenable --stage health
+```