local-search

name	local-search
parent	argo
description	argo 的本地/零成本兜底子技能。封装基于公开页面/HTML/RSS/JSON/CLI 的 33 个本地搜索引擎，不单独响应触发词，仅由 argo 通过 --sub-skill local-search 或 --local-first 调用。
version	1.1.0

Local Search 子技能

Local Search 是 argo 的「零成本兜底适配器」，用于：

• 在 --mode fast / --mode budget 下优先使用本地抓取引擎，避免消耗付费 API 配额。
• 当 SearXNG 不可用时，回退到本地 HTML/JSON 解析。
• 对中文网页、新闻、代码问答、学术、参考百科等垂直域提供补充结果。

设计原则

• 不单独响应触发词：没有独立的 skill trigger，仅作为 argo 的子能力。
• 统一 schema：输出与 argo 主 skill 完全一致，包含 results[]、engines_used、errors、elapsed_ms 等字段。
• 声明式解析：HTML 结构变化时只需修改 parse_maps.yaml。
• 命名空间隔离：本地引擎统一使用 local_ 前缀（如 local_bing、local_google），避免与 argo 已有的 HTTP 引擎（duckduckgo、wikipedia 等）重名。

本地引擎列表（33 个，29 个默认启用）

unified 名称	类型	默认启用	类别	说明
local_bing	cli(ddgs)	✅	web_general	Bing 网页结果（ddgs -b bing + JSON）
local_google	html	❌	web_general	Google 网页结果（反爬强；ddgs google backend 不可用）
local_mojeek	html	✅	web_general	Mojeek 独立索引（ddgs backend 返回导航链接）
local_yandex	cli(ddgs)	✅	web_general/japanese	Yandex 搜索（ddgs -b yandex）
local_startpage	html	✅	web_general	Startpage 隐私搜索（ddgs backend 不可用）
local_duckduckgo	cli(ddgs)	✅	web_general	DuckDuckGo（ddgs 默认）
local_brave	cli(ddgs)	✅	web_general	Brave 搜索（ddgs -b brave，实测稳定）
local_yahoo	cli(ddgs)	✅	web_general	Yahoo 搜索（ddgs -b yahoo，实测稳定）
local_baidu	html	✅	chinese	百度搜索
local_sogou	html	✅	chinese	搜狗搜索
local_360	html	✅	chinese	360 搜索
local_jisilu	html	✅	finance/chinese	集思录
local_ddgs_news	cli(ddgs)	✅	news	ddgs news 默认后端（带日期）
local_bing_news	rss	✅	news	Bing 新闻 RSS
local_google_news	rss	✅	news	Google News RSS
local_duckduckgo_news	cli(ddgs)	✅	news	ddgs news 备用后端
local_ddgs_images	cli(ddgs)	✅	images	ddgs images（bing TLS 偶发，已自动重试）
local_ddgs_videos	cli(ddgs)	✅	videos	ddgs videos
local_arxiv	xml	✅	academic	arXiv API
local_pubmed	json

CLI 引擎（ddgs 9.14.4）统一走 -o json 结构化输出 + 失败自动重试 1 次； 错误信号（DDGSException/ConnectError 等）在 rc=0 时也会被识别并上报，不静默吞错。

调用方式

# 直接调用子技能（单引擎）
python3 sub-skills/local-search/local_search_adapter.py "query" --engine local_bing

# 批量调用多个本地引擎
python3 sub-skills/local-search/local_search_adapter.py "query" \
  --engine local_bing,local_baidu,local_duckduckgo

# 由 argo 调用
python3 scripts/search.py "query" --sub-skill local-search
python3 scripts/search.py "query" --local-first --mode fast

文件结构

sub-skills/local-search/
├── SKILL.md                 # 本文件
├── config.yaml              # 引擎基础配置（URL/超时/类型/开关）
├── parse_maps.yaml          # HTML/RSS/JSON 抽取映射
├── engine_registry.py       # 引擎注册中心（唯一真源）
├── local_health_check.py    # 轻量健康探针（local_ 前缀避免与 scripts/health_check 同名冲突）
├── smart_router.py          # 查询特征路由
├── search_v3.py             # local-search 主入口
└── local_search_adapter.py  # 兼容入口

输出 schema

与 argo 主 skill 一致：

{
  "query": "string",
  "engine": "local_search",
  "engines": ["local_bing", "local_baidu"],
  "engines_combo": ["local_bing", "local_baidu"],
  "cached": false,
  "cache_level": null,
  "domain": null,
  "elapsed_ms": 1234,
  "tfidf_scores": [],
  "results": [
    {"title": "...", "url": "..."