这是踏雪寻仙 DeepSeek Harness 插件系列的一员(dsh-files 39★ · dsh-models 模型选择 + 子代理路由 + 推理层级)。同作者完整技能系列:session-digger 29★ · taxue-invest 21★ · 23★ · 12★
Alimenter votre agent
Installation de l'éditeur. Ce n'est pas un endpoint PlugMCP.
Host a copy with our keys and logs.
Pas encore de version packagée dans le registre. Suivez le README du dépôt.
URL distante ou commande sur votre machine ? Ce qui distingue les deux installations
Exécuter sur PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LancerDe l'éditeur
这是踏雪寻仙 DeepSeek Harness 插件系列的一员(dsh-files 39★ · dsh-models 模型选择 + 子代理路由 + 推理层级)。同作者完整技能系列:session-digger 29★ · taxue-invest 21★ · 23★ · 12★
Multi-engine search and deep research for AI agents across 300+ sources, 18 languages, and MCP / CLI.
简单来说:前三种方案解决「人找信息」,Argo 解决「Agent 及搜索核查于一身,具备一条龙的搜索服务」。差别不在界面,在交付物,给人看的叫总结页或链接清单,给 Agent 的应是能排序、能复核、不撑爆上下文的优质内容,更可靠的搜索信息。 | 维度 | 模型自带搜索 | AI 搜索(总结型) | 聚合搜索 / 搜索引擎 | Argo | |------|------------|-------------------|---------------------|----------| | 结果形态 | 拼好的长文本 | 给人看的总结页 | SERP 链接清单 | 精简 JSON:证据候选 + 可信度分解 | | 垂直问题(行情 / 化学式) | 泛搜网页 | 泛搜再总结 | 泛搜网页 | 直连垂直源,直接给答案 | | 证据可信度 | 无评分 | 无结构化评分 | 无评分 | selection · absorption · freshness · 共识 | | 重复查询 | 每次都打网 | 每次都打网 | 靠页面缓存 | 双层缓存(内存 + SQLite),热查询约 10ms | | 成本控制 | 不可控 | 单次贵 | 免费但费事 | 预算模式,免费优先,Key 全可选 | | 多语言 | 随模型走 | 随模型走 | 随引擎走 | 语言检测 + 引擎语言参数 + 多国语言支持 |
机制上,Argo 把搜索当成一条证据管线:语言检测 → 领域路由 → 多引擎召回 → RRF 融合 → 证据快评,交付的是 Agent 可直接排序、可
fetch复核、不撑爆上下文的材料。工具链不用换,需要换的是「搜索结果应该长什么样」——再往下一层,还有和「再包一层搜索 API 的差别」,那是实现细节的对比。
Agent 干活的量级变了,检索的玩法跟着变了四件事,每一件 Argo 都已经落在代码里:
.md 直出在头部文档站快速铺开——Argo 抓取链第零级自动探测这些 AI 友好变体,命中即跳过整条反爬链;HTTP/TLS 都失败还有 r.jina.ai 阅读器级保底。v2.9.3 把以上全部落地:264 个源、94 个领域、229 个免配置开箱。逐项细节见 docs/为什么选择argo.md 与 发布说明。
Argo 是给 AI Agent 用的多语言搜索基础设施。
真实检索从来不是「一种语言 + 一个搜索框」:有人问 A 股行情,有人问 World Cup,有人用日文找动画,有人要 IMDb 上的导演信息。Argo 的出发点很朴素——按领域、按语言、按需求选路,把问题送到合适的源,而不是一律扫网页标题。联网搜索与本机文件搜索一体可用。
产出不是「链接清单」,而是「证据候选 + 可信度分解」。路选对了,证据才站得住。
查询
├─ 意图消歧(可选)
├─ 查询改写(可选;路由仍看原始意图)
├─ 语言检测 + 语言偏好
├─ 路由(域规则 + TF-IDF + 预算 + 语言补充源 + 热路径缓存)
├─ 多引擎召回(熔断 / 负缓存 / 并行)
├─ 空结果分阶恢复(放宽 → 换同族/通用 → 跨语言;防污染)
├─ RRF 融合 + 可选精排
├─ 证据快评(权威 · 证据密度 · 时效 · 共识)
└─ 统一 JSON(含 engine_outcomes / recovery / route_reason)
selection ≈ 域名权威,SERP/跳转链压到很低
absorption ≈ 数字 / 定义 / 对比 / 披露等证据密度
freshness ≈ 发布时间(会忽略「2015 年以来」这类历史对比年)
综合 ≈ 0.40·selection + 0.35·absorption + 0.15·freshness + 0.10·引擎分
结果字段含 selection、absorption、credibility_fast、evidence_flags 等,方便 Agent 直接排序。
fetch → 再下结论任选一种即可。以 GitHub 为唯一安装来源(npx github:taxueseek/argo 或 install.sh / install.ps1),当前推荐 v2.9.6。请勿用 npm install argo-search——npm registry 上那份是非官方陈旧版 v1.0.1(非本仓库维护,功能残缺、不随本项目更新)。本包 package.json 已设 private: true 防止误发布到 npm registry。
零配置就能跑:不配 API Key 时走免费引擎 + 本地 local_* 引擎;配了 Key 的源质量通常更好,没配则自动跳过。
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/taxueseek/argo/main/scripts/install.sh | bash
Windows(PowerShell):
powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taxueseek/argo/main/scripts/install.ps1 | iex"
# 或下载后执行:
# powershell -ExecutionPolicy Bypass -File scripts/install.ps1
装到指定目录、并挂 Skill 入口:
curl -fsSL https://raw.githubusercontent.com/taxueseek/argo/main/scripts/install.sh \
| bash -s -- --home "$HOME/.local/share/argo" --link "$HOME/.claude/skills/argo"
验证:
python3 ~/.local/share/argo/scripts/search.py "python asyncio error handling" --json
python3 ~/.local/share/argo/scripts/search.py --list-engines
需要 Node.js 18+ 和 Python 3.9+,首次执行一次:
pip3 install pyyaml
npx -y github:taxueseek/argo
客户端配置示例(Claude Code / Cursor / Kimi 等):
{
"mcpServers": {
"argo": {
"command": "npx",
"args": ["-y", "github:taxueseek/argo"]
}
}
}
在 DeepSeek Harness 里一行安装(两种装法):
# 装法 A:19 个 mcp__argo__* 工具(主包自带 bundle,与 MCP 全量相同)
dsh plugin --profile web add "github:taxueseek/argo"
# 装法 B:搜索工具 + wide_research 并行研究调度(子包)
dsh plugin --profile web add "github:taxueseek/argo#main&path:packages/dsh-plugin"
重启 dsh web 后生效。包结构见 packages/dsh-plugin/;同 id mcp-argo / wide-research 可在用户层 cordis.patch.yml 覆盖。装法 B 的 wide_research 模块只存在于子包依赖树,主包 patch 不引用它,避免只装主包时 Cordis 解析失败。DSH 0.2.1-alpha.1 与 0.2.1-rc.2 均已实测:rc.2 上 wide_research(2 worker,passed=true / 14 sources)与原生 argo_search(count=3)真跑通,dsh web 启动无 argo 报错;web seam 随启动注册通过(headless 无 web 服务,未做实际调用)。
安装脚本(install.sh)只自动装前两个;其余可选依赖按需 pip install 或 brew install 即可。
更稳、完全不依赖 Node 的写法:先装脚本(方式一),再指向本机 Python:
{
"mcpServers": {
"argo": {
"command": "python3",
"args": ["/path/to/argo/scripts/mcp_server.py"]
}
}
}
Python 路径特殊时:export ARGO_PYTHON=/path/to/python3(仅 npx 入口会读)。
git clone https://github.com/taxueseek/argo.git
cd argo
pip3 install pyyaml
bash scripts/install.sh --link ~/.claude/skills/argo # 可选
python3 scripts/search.py --list-engines
python3 --version # 需要 3.9+(Windows 可用 py -3)
python3 -c "import yaml; print('PyYAML OK')"
python3 scripts/search.py --list-engines # 引擎面与状态总览
python3 scripts/search.py --list-engines --detail # 逐源状态:配了 key 却没结果,
# 先看 missing_env 给出的确切变量名
python3 scripts/health_check.py --all # 真联网探针:验证 key 对端真认(可选)
python3 bin/argo paths --check # 本机路径自检(可选)
python3 bin/argo mcp status # MCP 注入/连通诊断(可选)
python3 -m pytest tests/test_unit.py -q # 单测(可选)
MCP 起不来时:
python3 scripts/mcp_diag.py会把 stdin 往来记录到~/.kimi/argo_diag.log。health_check.py是给人用的联网探针,health_probe.py写健康库供路由消费——名字相近,职责不同。 CLI 退出码恒 0(含断网):成败判断走 JSON 的status/errors字段。
1. 通用搜索 + 垂直搜索,双管齐下
日常问题走通用网页搜索;一问到行情、影视、体育、宏观这类「有标准答案」的问题,自动切到垂直源直接给答案,而不是扔给你一堆链接。目前 266 个源(229 个免密钥开箱可用)、94 个业务域,金融 / 宏观 / 影视 / 体育 / 地理 / 组织 / 媒体 / 化学 / 学术 / 代码等都有专门的路。
2. 缓存:不重复花冤枉钱
时效性没那么强的内容(百科类、历史数据这类),第一次查完会进缓存,之后同样的查询直接命中,不再每次都走一遍 API。双层缓存(内存 + SQLite),热查询约 10ms 级返回,既省钱也省时间。
3. 专为 Agent 设计,更省 Token
产出是「证据候选 + 可信度分解」的精简 JSON,不是长篇网页;MCP 响应可以按需裁剪,snippet 可控,不会撑爆 Agent 的上下文。比常规模型自带的搜索能力更专业、更省 Token。
4. 深度研究
把一个笼统的问题拆成多个子问题,多源并行采集,最后给出「还差什么证据」的缺口提示。适合综述、调研这类要全面、要扎实的场景。
5. 登录态专业搜索(专业模式,默认关闭)
知乎、小红书、公众号这类要登录才能看的内容,以及 JS 渲染页、反爬页,用真实浏览器配合登录态去搜。默认关闭,需要时开启,依赖 ego lite 和 WebBridge 两个东西,详见下节「登录态专业搜索」。
6. 时间能力(时间窗 + 方向排序)
要搜「最近几天刚发布的内容」,用 --since 7d 这类时间窗框住发布时间范围,判断新旧不再靠猜。支持引擎(如 realtime_index,免 Key 实时索引源、需自装 CLI,结果自带发布时间)把窗口下推给数据源;其余引擎的融合结果会按 published_at 最后再剔除明确超窗的条目(宽松策略,无时间字段的保留),返回包带 time_filtered 统计,CLI 与 MCP 均支持。--since 7d 与「7 天前的绝对日期」等价、共享缓存;--until 2026-08-01 含当天。配合 --sort newest|oldest 按发布时间重排——找最新动态用 newest,找最早出处用 oldest。
DeepSeek Search 接入 + 查询操作符契约 + 传输层去重付费 + 路由快照门(v2.9.6 新增):官方 deepseek_search 引擎默认启用(无 DEEPSEEK_API_KEY 时路由自动跳过,其余 265 源不受影响;延迟 445-510ms,authority 权威分级 / rerank_score / 发布时间三引擎中唯一全覆盖,ja/ko/es 多语言与 anysearch 持平,--since/--until 时间窗唯一真生效;按次计费,不进域 combo,显式 --engine deepseek_search 为主路径;DSH 宿主经原生凭证 seam 共用同一把 key);site: / -site: / -词 / lang: / after: / before: 收敛为查询操作符契约层(query_operators.py,路由与缓存只认剥掉指令的 clean_query,site: 从「只解析不执行」到真正后置过滤并并入缓存键);POST 走连接池复用(anysearch 省 320ms / octen 省 561ms 每次)+ MCP 预连接;octen 进通用兜底与对冲位(p90 3273→1614ms、max 6266→1928ms、错误 9→0,ARGO_GENERAL_FALLBACK_LEGACY=1 可退回旧序);修复 RRF 口径隔离名次衰减(同引擎结果同分退化)与 Bing ck/a 跳转壳(此前 40.2% 空结果);新增 pre-commit 快门禁(~12s 六道)与路由决策快照门(治 90 天 13 次 fix(route) 慢性病);DSH 插件适配 0.2.1-rc.2 双栈(startActivation 新入口 + tool guard 承接已移除的 toolFilter),0.2.1-alpha.1 兼容分支单测覆盖
汇率查询专域 + 去重双轨判定 + 排序误杀修复(v2.9.5 新增):fx_query 域让汇率/中间价类查询 675ms 出「即期汇率 + 每日快讯」(改前 1411ms 百科词条);去重补站后缀归一(零依赖)+ rapidfuzz 模糊复核(可选依赖、ARGO_DEDUP_FUZZY 可控、缺失自动回退);修复精排降级时标题分隔符 ×0.6 误杀(官方文档回到前排);否定理解补「不是X」;daemon 落盘名字按检出目录隔离,多 worktree 互抢/误杀/静默旧代码三类故障根除
显式引擎域归因 + 恢复链止损 + 门禁同步(v2.9.4 新增):--engine X 显式指定引擎时补 match_domains 域判定,修复缓存 TTL 一刀切 general;单引擎无备选时跳过 L1 同引擎空跑;config.yaml 域规则增强(org_entity 加 unless 股东尽调词、fund_query 加 unless 政策法规词);mcp_launch.sh 环境变量导出收窄;local-search 引擎注册表层收口与质量提升;门禁同步(module_size_gate / ENGINE_CATALOG)
X 帖子完整打包 argo tweet(v2.9.3 新增):一条命令打包指定 X 帖子的正文、串/引用/转发与互动数据;默认纯文本,--out 落四件套(post.md/raw.json/manifest.json/CHECKLIST.md),--media 才下载图片/视频;主帖失败原因随产物可见
浏览器登录态车道 argo auth(v2.9.3 新增):argo auth login/status/logout 自持站点持久浏览器 profile,扫码一次即可抓取需登录页面;cookie 只存 Chrome 自身加密存储,登录态结果标记 login_state_used 并拒绝入公共缓存(ARGO_AUTH_FETCH 开启)
本地中文链质速双修(v2.9.3 新增):搜狗/百度跳转壳无会话解析成真实直链,保留结果 1→5 条;共识宽限自适应(首引擎交足即放行),英文分发 ~3.0s→2.2-2.5s
火车票中转+经停(v2.9.3 新增):12306 查询扩展中转/经停方案,候补漏斗 10→1 压缩修为如实 10→10;学术搜索 --academic-deep 一键多源深挖
路由扩容与意图门修复(v2.9.3 新增):43 个无域引用引擎接入对应领域,新增 3 个零 key 金融源;「教程」类查询不再被意图门误锁单引擎
本地能力提速(v2.9.3 新增):本地图片指纹 77k 张 158ms→3.9ms(默认关,ARGO_LOCAL_IMAGE=1 启用);agent 消费自动瘦身,MCP 每调用固定开销 −32%
DSH 0.2.1-alpha.1 适配验证(v2.9.2 新增):DSH 插件三形态(原生一等工具 / web_search seam / wide_research)在最新版 DSH 实测启用;argo mcp inject 新增 WorkBuddy,一键注入覆盖到第 7 宿主
js-run 子技能(v2.9.2 新增):不开浏览器执行「环境探测 + 纯计算」型网页 JS(V8 沙箱 + 环境垫片,单次上下文 P50 ≈ 1ms),补 curl_cffi 取数与浏览器渲染之间的「算」车道
输出减重与漏斗归因(v2.8.9 新增):默认输出 −66%(同一段结果不再重复三遍,--envelope 开完整版);六格漏斗(路由→调用→返回→去重→过滤→保留)让「搜到 0 条」能定位塌在哪一层;阶段耗时账拆出过滤与恢复,慢在哪不再被指错方向
DSH 插件工具原生化(v2.8.5 新增):argo_search / argo_fetch 原生一等工具默认可用(CLI 单发,不依赖 MCP 连接);schema 由 gen_native_tools.py 从 mcp_tools.py 唯一来源生成(漂移检查测试把关);nativeTools 配置可按需启用全部 18 个工具(argo_research 除外)
MCP 默认关闭(v2.8.5 变更):三形态接入——MCP 按需挂载(profile patch)/ 原生工具(默认入口)/ 原生 web_search seam;平时零常驻 token 开销
Windows 全平台兼容(v2.8.5 增强,社区贡献):临时路径走 tempfile.gettempdir();解析映射显式 UTF-8(根治 GBK 静默失效);解释器运行时解析(python3 → python → sys.executable);symlink 无权限退化 junction;PowerShell 一键安装 install.ps1;--spotlight 无 mdfind 自动退化 rg
配额自愈完整链路(v2.8.5 新增):HTTP 200 业务错误封套识别(火山/知乎风格);远端配额耗尽自动标记 → 路由全模式排除 → 备用源接管 → 周期边界自愈回归;配额/鉴权错误不毒化自适应分数与熔断
抓取全局 deadline(v2.8.5 新增):ARGO_FETCH_DEADLINE_S(默认 60s)封顶降级链总耗时;429/503 停止信号;tinyfish 渲染层(TINYFISH_API_KEY)+ {url}.md 变体探测;移动 UA 首发身份记忆
本地数据融合(v2.8.4 新增,深度研究 L1):工作包可带 file_inputs(本地一手数据白名单入账,登记 sha256/来源记录)与 recompute(可复算执行器,受限子进程安全重算,重算值与检索数字冲突触发 recompute_conflict);dossier 输出 local_sources,本地一手计入一手命中(防 no_sources 假阴性)
多客户端 MCP 一键接入(v2.8.4 新增):argo mcp inject 一键给 Claude Code / Cursor / Windsurf / Codex / OpenCode / Cline / WorkBuddy 注入 argo MCP(原子写 + 备份 + 可逆,客户端来源 mcp/clients.yaml)
结构化搜索增强(v2.8.4 新增):查询归一化(全角→半角、点号版本拆斜杠)+ 检索变体 + 复杂度门控(低复杂度查询不放行高价多轮);social 域语法优先(from:/subreddit:/lang: 命中提前)+ TF-IDF 检索修复(丢弃中文引擎后继续看 top-2/3);--include-local 本机命中并入(默认关)
Keenable(v2.8.4 新增):接入通用网页搜索引擎(L1 声明式 HTTP,免费体验期,ARGO_KEENABLE_API_KEY)
多语言路由修复(v2.8.3 新增):ja/ko 查询返回目标语言(不再被中文引擎污染);德法西意等多语言走 anysearch 返回对应语言;weighted RRF 弱源降权(weakest-link,论文 2508.01405);anysearch 进程内 builder(更快更稳)
Windows 全平台可用(v2.8.2 新增):移除 npm os 限制;全链路 UTF-8 防线(PYTHONUTF8 + -X utf8 + 6 处 JSON read_bytes)根治 GBK 崩溃;工具探测改 shutil.which;Chrome/Edge 自动发现;Ctrl+C 干净退出
DSH 插件两种装法(v2.8.2 新增):主包自带 dsh.bundle,dsh plugin add github:taxueseek/argo 即得 19 个 MCP 工具;子包再加 wide_research 并行研究调度
wide_research 证据检查(v2.8.2 新增):输出自带 quality_gate_results(conclusion_cap low/medium/high),与 dossier 同一套语义;depends_on 依赖分阶段;仅 http(s) 入证据账本;worker 不可调 argo_research(防研究套研究)
取证协议化(v2.8.2):深度研究只产 dossier(来源/覆盖/缺口/检查),判断稿归 Agent;--work-packages 按 depends_on 分阶段
证据完整链路(v2.8.0 新增):搜索输出自带证据门控——高后果问题(金融/医疗/法律)标 fetch_required,每条结果标 fetch_suggested;--verify 一键核验正文并回填「核实后证据分」,核实过的链接自动记住,下次搜索直接显示已核实
求职搜索 v3(v2.8.0 升级):argo job 结构化字段 + 增量监控 + 指纹去重,新增 Ashby ATS 免 Key 后端与北京高校就业源
天气双源并行(v2.8.0 升级):wttr.in + Open-Meteo 双源,地理编码 + 空气质量,问天气不落空
通用搜索增强(v2.8.0 新增):Parallel 搜索(长文摘录、多路召回)与 You.com(网页+新闻合并、时效动态化),无 Key 优雅降级
266 个搜索源(229 个免密钥开箱可用)、95 个业务域:通用网页 + 金融 / 宏观 / 影视 / 体育 / 地理 / 组织 / 媒体 / 化学 / 学术 / 代码等(来源:config.yaml 与 engines/specs/*.yaml)。逐源清单(费用 / 密钥 / 状态 / 域组合 / 特别能力)见 搜索源使用文档,该文档由脚本从声明生成、有检查防漂移;选源判断与语义分工见 references/engines.md
双层缓存:内存 LRU + SQLite 持久化,时效性弱的内容不重复打 API;登录态结果单独隔离,不污染公共缓存
为 Agent 节省 Token:MCP 响应可紧凑裁剪、snippet 可控,输出为精简 JSON 而非整页文本
19 个 MCP 工具(与 CLI 能力面对齐):搜索、研究、证据、消歧、抓取、截图、PDF、社交舆情、本地文件搜索、站点爬取、本地预览、可复算、公众号文章全文、招聘聚合、结构化提取、URL 批量预检、直答、网页变化监控、DOI 引用条目
多语言搜索:中、英、日、韩、西里尔、泰、阿、希伯来、希腊、天城体等;路由与引擎参数跟着语言走;非中文查询避免误入知乎 / 搜狗微信 / A 股快照等中文专用源
登录态专业搜索:ego-search 子技能,登录墙正文 / JS 渲染页 / 登录站点接口直取(默认关闭,见上节)
垂直域检查:空结果恢复时不把 pypi / npm / 快讯等无关源「串」进影视、体育查询
日常更快、研究更全:engine_policy 分层——日常 combo 收紧,deep / research 再放开长尾源
引擎层 HttpClient 接入(v2.7.3 追加):HTTP/HTML 引擎 GET 统一走 UA 轮换 + 重试 + 重定向跟随层,arxiv 类 UA 敏感引擎从 5s 超时空返回变为 2s 内 10 条有效结果;ARGO_ENGINE_HTTP_CLIENT=0 回退 urllib
TF-IDF 强语义注入(v2.7.3 追加):marginalia / open_meteo / usda / gov_policy / cnii 等 25 个垂直引擎不再被正则域压制——「独立博客 长尾」路由到 marginalia、「营养成分 热量」路由到 usda、「国务院 政策」路由到 gov_policy
70 域 TTL 全覆盖(v2.7.3 追加):实时卡片/快讯/行情缓存 5-15 分钟(此前 1 小时),学术稳定型放宽到 2 小时
垂直源中英双语(v2.7.3 追加):worldbank / eurostat 英文国家与指标名(China GDP / US inflation / Japan population 实测命中);快讯类引擎触发词放行全量榜单;百科条目页直接命中保底
当前配置 266 个源(229 个免密钥开箱可用)、95 个业务域(以 config.yaml 与 --list-engines 为准)。
local_*)不依赖独立的 SearXNG 服务。主路径用进程内 HTML / RSS / JSON 解析(如 local_bing、local_sogou、local_google、local_arxiv 等)。多语言查询时,路由会按语种动态改写引擎语言参数(例如 Bing setlang),并参与 RRF 融合。
普通搜索拿不到知乎、小红书、微博、公众号等需要登录的内容,也常抓不回来 JS 渲染页 / 反爬页。ego-search 用真实浏览器去做这类搜索:继承登录态、抓登录墙后的正文、在已登录站点直接调接口取数据(如知乎搜索接口)。
默认关闭,需要时开启(在 argo 目录下运行):
python3 sub-skills/ego-search/scripts/ego_search.py enable
常用命令:python3 sub-skills/ego-search/scripts/ego_search.py status(查看状态)、... disable(关闭)、search / fetch / api(分别对应浏览器搜索、抓正文、调站点接口)。
依赖(装好其中一个就能用,两个都装更好):
登录态搜到的结果不写公共搜索缓存(避免污染共享缓存),需要融合时用 merge 命令把常规结果和登录态结果放一起分析。
python3 scripts/search.py "贵州茅台股价" --explain
# 典型:命中 stock_query → 行情快照源
python3 scripts/search.py "transformer attention mechanism paper" --json
# domain 常为 academic,引擎组合含 arxiv 等
python3 scripts/research.py "2026 公募基金二季报 持仓结构" --depth deep --json
python3 scripts/search.py "同一查询" --json | \
python3 scripts/evidence.py "同一查询" --stdin --json
不配置则跳过对应引擎,免费引擎自动保底。请用环境变量,不要把真实 Key 写进仓库或贴到 Issue。
# 推荐(提升搜索质量)
export TAVILY_API_KEY="你的密钥"
export BOCHA_API_KEY="你的密钥"
export METASO_API_KEY="你的密钥"
export ZHIHU_ACCESS_SECRET="你的密钥"
# 可选
export BRAVE_API_KEY="你的密钥"
export FELO_API_KEY="你的密钥"
export GITHUB_TOKEN="你的密钥"
export WEB_SEARCH_API_KEY="你的密钥"
export ANYSEARCH_API_KEY="你的密钥"
export OCTEN_API_KEY="你的密钥"
export ARGO_KEENABLE_API_KEY="你的密钥" # 可选;Keenable 免费体验期
config.yaml 里只写 {ENV_NAME} 占位,不会提交明文密钥。
默认 SQLite 路径见 config.yaml 的 cache.db_path(一般为 ~/.cache/unified-search/cache.db)。
不配 API Key 能用吗?
能。内置大量本地零成本引擎和免费 API 源,不配 Key 时自动走免费路径。
安装脚本和 npx 有什么区别?
安装脚本适合固定装在本机、改配置、挂 Skill;npx 适合快速把 MCP 挂进 Agent。两者底层同一套 Python 代码。
如何确认引擎是否正常?
python3 scripts/search.py --list-engines,或加 --explain。
会不会在仓库里复制多份代码?
不会。推荐「一份源文件 + 符号链接」。用 link_source.py,不要 rsync 多副本。
python3 scripts/search.py [选项] 查询词
--engine, -e 引擎,默认 auto
--max-results, -n 条数,默认 5
--depth, -d fast | balanced | deep
--mode fast | auto | deep | budget
--no-cache 跳过缓存
--explain 打印路由说明
--json JSON 输出
--timeout, -t 超时秒数
--list-engines 列出引擎
config.yaml 为唯一来源。不太适合单独承担:平台内高级互动定榜、需要长期养服务的最大召回聚合器(已用内嵌本地引擎替代外挂 SearXNG 主路径)。
argo/
├── README.md # 中文介绍(默认)
├── README.en.md # English
├── README.ja.md # 日本語
├── README.ko.md # 한국어
├── README.es.md # Español
├── SKILL.md
├── package.json # npx 入口
├── bin/argo.js # Node 启动 MCP
├── bin/argo # Python CLI
├── config.yaml # 引擎与域配置(来源)
├── assets/readme/ # README 视觉资源
├── backends/
├── mcp/ # 多客户端 MCP 注入配置(clients.yaml)
├── scripts/ # search / research / mcp / install …
├── sub-skills/local-search/
├── sub-skills/ego-search/ # 登录态专业搜索(默认关闭,开启命令见正文)
├── tests/
└── docs/ # 含 ENGINE_CATALOG.md(搜索源使用文档,生成)
deepseek_search(官方 api.deepseek.com/v1/tools/search)默认启用:无 DEEPSEEK_API_KEY 时路由自动跳过、其余 265 源不受影响;实测延迟 445-510ms(anysearch 1.7-4.5s / exa 3.7s),authority 权威分级 / rerank_score / 发布时间为三引擎中唯一全覆盖,ja/ko/es 多语言与 anysearch 持平;按次计费,不进域 combo,显式 --engine deepseek_search 为主路径;DSH 宿主经原生凭证 seam 与官方后端共用同一把 key(web Models 页轮换后下一跳生效,不落盘不打日志)--since/--until 对 deepseek_search 静默无效(入 TIME_CAPABLE_ENGINES)query_operators.py 查询操作符契约层:site: / -site: / -词 / -"短语" / lang: / after: / before: 从五种散落形态收敛为结构化 operators;路由、缓存、查询理解只认剥掉指令后的 clean_query;site: / -site: 真正后置过滤执行(子域匹配、多站点 OR,过滤数进 site_filtered),操作符并入结果缓存键避免互串evidence.py:新增 Agent 档双层摘要 summary 字段(借鉴 DeepSeek Search 摘要语义)ARGO_GENERAL_FALLBACK_LEGACY=1 逃生开关退回旧序['anysearch','anysearch'] 并发跑两遍(双倍配额且 wasted_ms 记 0):200 条真实查询重放,重复 combo 1→0scripts/pre-commit 快门禁(static_lint / module_size_gate / usage_doc / consistency / routing_snapshot / context_budget + engine_catalog,实测 ~12s);路由决策快照门把路由翻转变成可 diff 的 golden(三处标注集并集 115 条,只比对 domain 与 kind 不被环境噪声假红);口径注册表同步测试锁「表里的引擎名必须真实注册」startActivation({provider, label, request, signal, delivery}) 新 / start(provider, request) 旧),rc.2 移除 toolFilter 后由插件内 tool guard 阻止 worker 嵌套调用 wide_research;rc.2 上 wide_research(planner → 2 worker → synthesis,passed=true / 14 sources)与原生 argo_search(count=3)端到端实测通过;0.2.1-alpha.1 兼容分支由单测覆盖;插件单测 46→50packages/dsh-plugin/README.md 的 Compatibility 小节config.yaml:新增 fx_query 域——「人民币/美元 汇率、中间价、离岸」类查询不再落进宏观域空转后兜底百科词条,改为即期汇率 + 每日中间价快讯(实测 675ms,改前 1411ms 且答非所问)search_rank.py:去重补两层判据——标题站后缀归一(零依赖)+ rapidfuzz 模糊近重复复核(仅近似命中带内启用;ARGO_DEDUP_FUZZY=0 关闭,未安装则自动回退纯 minhash)| / _ / —— 的标题一律 ×0.6,官方文档被压 40%;无 Bocha Key 的用户每条 auto/deep 查询都在受益(判据收敛到 rank_signals 单一实现)query_understanding.py:否定理解补「不是X」(疑问句式「是不是」不误判为否定)daemon.py:socket/pid/指针等落盘名字按检出目录隔离——多 worktree/clone 互抢 daemon、互杀进程、「改了不生效」三类故障根除pip install rapidfuzz;install.sh 自动安装,缺失不影响核心功能)route.py:显式 --engine X 时补 match_domains 域判定,修复缓存 TTL 一刀切 generalrecovery.py:显式单引擎无备选时跳过 L1 同引擎空跑,减少无意义 RTTconfig.yaml:org_entity 加 unless 股东尽调词;fund_query 加 unless 政策法规词mcp_launch.sh:set -a 收窄到 . "$ENV_FILE" 单行sub-skills/local-search/:引擎注册表层收口与 search_v3 质量提升argo tweet——一条命令打包 X 帖子正文、串/引用/转发与互动数据;默认纯文本不下载媒体,--out 落四件套(post.md/raw.json/manifest.json/CHECKLIST.md),--media 按需下载图片/视频;主帖失败原因随产物可见不静默argo auth 浏览器登录态车道——login/status/logout 管理站点持久浏览器 profile,扫码一次即可抓取需登录页面;cookie 只存 Chrome 自身加密存储、argo 不读取不导出,登录态结果标记 login_state_used 并拒绝入公共缓存(ARGO_AUTH_FETCH 开启)ARGO_LOCAL_IMAGE=1);agent 消费自动瘦身 + markdown 内容协商,MCP 每调用固定开销 −32%--academic-deep 一键学术多源深挖;火车票中转+经停查询argo mcp inject 新增 WorkBuddy,一键注入覆盖到第 7 宿主int() 换类型守卫);local-seek 四类假阴性收口(v1.4.0)sub-skills/js-run 子技能(v0 骨架)——不开浏览器跑「环境探测 + 纯计算」型网页 JS,单次上下文 P50 ≈ 1msargo stats 让搜索质量有了自己的账本ARGO_PROXY、config 按域规则、标准代理环境变量都生效,NO_PROXY 尊重--no-timing 可关)argo answer 直答、argo watch 网页观察、CLI 与 MCP 工具面对齐argo paths 自省)、支持 Python 3.9、静默故障如实记账;详见 发布说明argo_search / argo_fetch 以原生一等工具注册,默认可用,不依赖 MCP 连接;schema 从 mcp_tools.py 唯一来源自动生成,两侧零漂移;除 argo_research 外 13 个工具都可经 nativeTools 按需启用python3/python 运行时解析、symlink 无权限自动退化 junction、新增 PowerShell 一键安装 install.ps1ARGO_FETCH_DEADLINE_S(默认 60s)封顶降级链总耗时;429/503 停止信号尊重服务器指示;tinyfish 免费渲染层 + .md 变体探测命中即跳过反爬链argo research 只吃网页,现在工作包能带 file_inputs(你的一手 CSV / XLSX / 文献,登记哈希、内容不入账)+ recompute(可复算执行器,安全地重算数字并和检索对账,对不上就提示)argo mcp inject 一条命令把 argo 注入 Claude Code / Cursor / Windsurf / Codex / OpenCode / Cline(原子写 + 自动备份 + 可还原)~/.agents 这类)、修了一处会把用户引向陈旧 npm 包的安装提示完整变更见下表与各版发布说明。
更细说明见 docs/RELEASE_NOTES_v2.7.0.md 与 docs/OPTIMIZATION_ROADMAP_v2.4.md。
欢迎提 Issue 与 Pull Request。改路由或证据逻辑时,请尽量补对应测试:
python3 -m pytest tests/test_unit.py tests/test_multilingual.py -q
python3 scripts/regression_p0p1.py --offline
python3 scripts/matrix_search_eval.py --offline
python3 scripts/ab_eval_p0p1.py # 可选,含在线实测
提交前请确认:不含真实 API Key、本机绝对路径、账号 cookie 等敏感信息。本机 Skill 路径请写在 installs.local.yaml(已忽略)。
好的搜索不是让你看得更多,是让你更敢下结论——以及知道什么时候还不该下结论。
本引擎的财经垂直源(eastmoney、nbs_stats、jin10、nbs、fred、eurostat、finviz 等)已接入 invest 系列投资技能。
invest-cli 通过 info(invest-cli info <词> --engine eastmoney)与 intent macro 直接复用 argo 的财经 / 宏观 / 资讯取数,用于环节配额、低成本、多源数据,与 invest-cli 的结构化数据层(Wind / 盈米 / 东财 / yfinance / 天天基金)协同。
最新版已完成 argo 数据与 invest 系列技能(v2.0.5)的集成。
Multi-engine search and deep research for AI agents across 300+ sources, 18 languages, and MCP / CLI.
Outils
Pas encore de liste d'outils. Les serveurs distants en obtiennent une après le premier contrôle d'état.
FAQ
Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.
Aucune variable d'environnement requise n'est indiquée sur cette fiche.
Argo s'exécute en local via stdio.
Dernière vérification : 2026-11-16. Multi-engine search and deep research for AI agents across 300+ sources, 18 languages, and MCP / CLI.