argo-search 2.9.7 → 2.9.9

package/backends/engine_registry.yaml

@@ -1,6 +1,6 @@
 _generated: 由 scripts/sync_backends.py 从运行时引擎声明派生，勿手工修改。
 version: 2
-last_updated: '2026-10-20'
+last_updated: '2026-10-22'
 engines:
 - name: aljazeera
   tier: T1
@@ -242,6 +242,21 @@ engines:
   recommended: false
   explicit_only: false
   desc: 英国电网碳强度与发电结构（国家电网官方，免认证）
+- name: cfets
+  tier: T1
+  type: cfets
+  coverage:
+  - finance
+  - macro
+  - china
+  - official
+  - realtime
+  latency_ms: 2000
+  cost: free
+  status: ok
+  recommended: false
+  explicit_only: false
+  desc: 中国外汇交易中心人民币中间价（25 个币种，官方授权口径，免 key）
 - name: cinii
   tier: T1
   type: http
@@ -518,6 +533,20 @@ engines:
   recommended: false
   explicit_only: false
   desc: 音乐艺人/专辑（Deezer，免认证）
+- name: defillama
+  tier: T1
+  type: defillama
+  coverage:
+  - crypto
+  - finance
+  - blockchain
+  - defi
+  latency_ms: 2000
+  cost: free
+  status: ok
+  recommended: false
+  explicit_only: false
+  desc: DeFiLlama 协议 TVL（8700+ 协议资金规模/24h 与 7d 变化，免 key）
 - name: deps_dev
   tier: T1
   type: deps_dev
@@ -1115,6 +1144,20 @@ engines:
   recommended: true
   explicit_only: false
   desc: GitHub 代码搜索 API
+- name: gleif
+  tier: T1
+  type: http
+  coverage:
+  - company
+  - business
+  - legal
+  - org_entity
+  latency_ms: 2000
+  cost: free
+  status: ok
+  recommended: false
+  explicit_only: false
+  desc: GLEIF 全球法人 LEI 注册库（法定名称/注册地/状态/母公司，免 key）
 - name: google_news
   tier: T1
   type: google_news
@@ -1246,6 +1289,21 @@ engines:
   recommended: true
   explicit_only: false
   desc: 日本技术圈书签搜索（RDF RSS，带收藏日期）
+- name: hkex
+  tier: T1
+  type: hkex
+  coverage:
+  - finance
+  - stock
+  - hk_stock
+  - legal
+  - official
+  latency_ms: 2000
+  cost: free
+  status: ok
+  recommended: false
+  explicit_only: false
+  desc: 港交所披露易公告检索（港股一手公告 PDF，代码/公司名/标题关键词，免 key）
 - name: huggingface
   tier: T1
   type: http
@@ -1405,6 +1463,19 @@ engines:
   recommended: true
   explicit_only: false
   desc: Keenable 通用网页搜索（ranked results，含 published_at，按 credits 计费）
+- name: keenable_free
+  tier: T1
+  type: keenable_free
+  coverage:
+  - general
+  - english
+  - chinese
+  latency_ms: 2000
+  cost: free
+  status: ok
+  recommended: false
+  explicit_only: false
+  desc: Keenable 官方免 key 匿名通道（通用网页搜索，无需注册）
 - name: know_your_meme
   tier: T1
   type: html
@@ -2425,6 +2496,21 @@ engines:
   recommended: true
   explicit_only: false
   desc: 神马搜索（m.sm.cn/s 移动端 HTML 解析），中文通用网页
+- name: shfe
+  tier: T1
+  type: shfe
+  coverage:
+  - finance
+  - futures
+  - commodity
+  - china
+  - official
+  latency_ms: 2000
+  cost: free
+  status: ok
+  recommended: false
+  explicit_only: false
+  desc: 上海期货交易所日行情（铜/铝/黄金/螺纹钢等品种，官方一手，免 key）
 - name: sina_quote
   tier: T1
   type: sina_quote
@@ -2587,7 +2673,20 @@ engines:
   status: ok
   recommended: true
   explicit_only: false
-  desc: Tavily AI 搜索 API（免费层 1000 次/月，按 credit 计费；与 exa 同为 api 档）
+  desc: Tavily AI 搜索 API（免费层 1000 次/月，超出按美元计费；与 exa 同为 api 档）
+- name: tavily_free
+  tier: T1
+  type: http
+  coverage:
+  - general
+  - english
+  - chinese
+  latency_ms: 2000
+  cost: free
+  status: ok
+  recommended: false
+  explicit_only: false
+  desc: Tavily 官方免 key 匿名通道（通用网页搜索，无需注册）
 - name: tencent_kline
   tier: T1
   type: tencent_kline
@@ -2747,13 +2846,14 @@ engines:
   tier: T1
   type: cli
   coverage:
-  - general
+  - social
+  - english
   latency_ms: 2000
   cost: free
   status: ok
   recommended: true
   explicit_only: false
-  desc: Twitter/X
+  desc: X/Twitter 关键词搜索（ego-browser 通道，原生布尔语法 from:/-is:retweet/lang:）
 - name: twitter_syndication
   tier: T1
   type: twitter_syndication
@@ -3196,6 +3296,20 @@ engines:
   recommended: true
   explicit_only: false
   desc: You.com 网页+新闻搜索（时效性强，官方一手源，web/news 合并）
+- name: yuanbao
+  tier: T1
+  type: yuanbao
+  coverage:
+  - web
+  - chinese
+  - news
+  - official
+  latency_ms: 2000
+  cost: api
+  status: ok
+  recommended: false
+  explicit_only: false
+  desc: 腾讯元宝搜索（yuanbao）
 - name: zbmath
   tier: T1
   type: http

package/backends/quota_profiles.json

@@ -23,7 +23,7 @@
   "anysearch": {
     "label": "AnySearch",
     "qps": 5,
-    "limit": 2000,
+    "limit": 1000,
     "period": "day",
     "cost_per_call": 0.0,
     "cost_unit": "free",
@@ -143,8 +143,8 @@
   "bocha": {
     "label": "博查搜索",
     "qps": 5,
-    "limit": 10000,
-    "period": "month",
+    "limit": null,
+    "period": "second",
     "cost_per_call": 0.0001,
     "cost_unit": "credit",
     "cost_tier": "low",
@@ -153,8 +153,8 @@
   "bocha_ai": {
     "label": "博查AI搜索",
     "qps": 5,
-    "limit": 10000,
-    "period": "month",
+    "limit": null,
+    "period": "second",
     "cost_per_call": 0.001,
     "cost_unit": "credit",
     "cost_tier": "low",
@@ -190,6 +190,16 @@
     "cost_tier": "free",
     "priority": 50
   },
+  "cfets": {
+    "label": "人民币中间价",
+    "qps": 2,
+    "limit": null,
+    "period": "second",
+    "cost_per_call": 0.0,
+    "cost_unit": "free",
+    "cost_tier": "free",
+    "priority": 51
+  },
   "cinii": {
     "label": "cinii",
     "qps": 2,
@@ -410,6 +420,16 @@
     "cost_tier": "free",
     "priority": 50
   },
+  "defillama": {
+    "label": "DeFiLlama",
+    "qps": 1,
+    "limit": null,
+    "period": "second",
+    "cost_per_call": 0.0,
+    "cost_unit": "free",
+    "cost_tier": "free",
+    "priority": 45
+  },
   "deps_dev": {
     "label": "deps_dev",
     "qps": 2,
@@ -665,8 +685,8 @@
     "qps": 1,
     "limit": 1000,
     "period": "month",
-    "cost_per_call": 0.0,
-    "cost_unit": "free",
+    "cost_per_call": 0.01,
+    "cost_unit": "usd",
     "cost_tier": "api",
     "priority": 14
   },
@@ -706,7 +726,7 @@
     "limit": null,
     "period": "second",
     "cost_per_call": 0.0,
-    "cost_unit": "credit",
+    "cost_unit": "usd",
     "cost_tier": "paid",
     "priority": 8
   },
@@ -736,7 +756,7 @@
     "limit": 1000,
     "period": "month",
     "cost_per_call": 0.001,
-    "cost_unit": "credit",
+    "cost_unit": "usd",
     "cost_tier": "free",
     "priority": 50
   },
@@ -890,6 +910,16 @@
     "cost_tier": "free",
     "priority": 11
   },
+  "gleif": {
+    "label": "GLEIF 法人标识",
+    "qps": 2,
+    "limit": null,
+    "period": "second",
+    "cost_per_call": 0.0,
+    "cost_unit": "free",
+    "cost_tier": "free",
+    "priority": 55
+  },
   "google_news": {
     "label": "google_news",
     "qps": 2,
@@ -990,6 +1020,16 @@
     "cost_tier": "free",
     "priority": 48
   },
+  "hkex": {
+    "label": "港交所披露易",
+    "qps": 1,
+    "limit": null,
+    "period": "second",
+    "cost_per_call": 0.0,
+    "cost_unit": "free",
+    "cost_tier": "free",
+    "priority": 50
+  },
   "huggingface": {
     "label": "Hugging Face",
     "qps": 2,
@@ -1110,6 +1150,16 @@
     "cost_tier": "free",
     "priority": 50
   },
+  "keenable_free": {
+    "label": "Keenable (keyless)",
+    "qps": 1,
+    "limit": null,
+    "period": "second",
+    "cost_per_call": 0.0,
+    "cost_unit": "free",
+    "cost_tier": "free",
+    "priority": 57
+  },
   "know_your_meme": {
     "label": "Know Your Meme",
     "qps": 2,
@@ -1940,6 +1990,16 @@
     "cost_tier": "free",
     "priority": 20
   },
+  "shfe": {
+    "label": "上期所行情",
+    "qps": 2,
+    "limit": null,
+    "period": "second",
+    "cost_per_call": 0.0,
+    "cost_unit": "free",
+    "cost_tier": "free",
+    "priority": 52
+  },
   "sina_quote": {
     "label": "新浪行情",
     "qps": 2,
@@ -2005,8 +2065,8 @@
     "qps": 1,
     "limit": 300,
     "period": "day",
-    "cost_per_call": 1.0,
-    "cost_unit": "request",
+    "cost_per_call": 0.0,
+    "cost_unit": "usd",
     "cost_tier": "free",
     "priority": 45
   },
@@ -2066,10 +2126,20 @@
     "limit": 1000,
     "period": "month",
     "cost_per_call": 0.001,
-    "cost_unit": "credit",
+    "cost_unit": "usd",
     "cost_tier": "api",
     "priority": 5
   },
+  "tavily_free": {
+    "label": "Tavily (keyless)",
+    "qps": 1,
+    "limit": null,
+    "period": "second",
+    "cost_per_call": 0.0,
+    "cost_unit": "free",
+    "cost_tier": "free",
+    "priority": 56
+  },
   "tencent_kline": {
     "label": "腾讯 K 线",
     "qps": 2,
@@ -2550,6 +2620,16 @@
     "cost_tier": "api",
     "priority": 12
   },
+  "yuanbao": {
+    "label": "腾讯元宝搜索",
+    "qps": 2,
+    "limit": 2000,
+    "period": "month",
+    "cost_per_call": 0.0,
+    "cost_unit": "credit",
+    "cost_tier": "api",
+    "priority": 55
+  },
   "zbmath": {
     "label": "zbmath",
     "qps": 2,

package/backends/source_types_cn.json

@@ -30,12 +30,38 @@
     "zhuanlan.zhihu.com": 0.65,
     "www.zhihu.com": 0.90
   },
+  "content_farm_markers": [
+    "ctolib.com",
+    "coder.work",
+    "voidcn.com",
+    "it1352.com",
+    "oommake.com",
+    "py4u.net",
+    "wenku.zone",
+    "chinadmd.com",
+    "biquge",
+    "99lib.net",
+    "shubaow.net",
+    "jb51.cc",
+    "kafan.cn",
+    "yiidian.com"
+  ],
+  "content_farm_url_patterns": [
+    "/tag/",
+    "/tags/",
+    "/label/",
+    "/zt/",
+    "/zhuanti/"
+  ],
   "demote_domains": {
     "maigoo.com": {"score": 0.28, "class": "commercial_recommendation", "reason": "商业品牌榜单"},
     "chinapp.com": {"score": 0.28, "class": "commercial_recommendation", "reason": "加盟/品牌网"},
     "cnpp.cn": {"score": 0.28, "class": "commercial_recommendation", "reason": "十大品牌网类"},
     "canyin88.com": {"score": 0.35, "class": "commercial_recommendation", "reason": "行业加盟倾向"},
-    "xiuxianshipin.com": {"score": 0.3, "class": "commercial_recommendation", "reason": "加盟内容"}
+    "xiuxianshipin.com": {"score": 0.3, "class": "commercial_recommendation", "reason": "加盟内容"},
+    "jb51.net": {"score": 0.35, "class": "aggregated_tech", "reason": "SEO爬虫抓取聚合"},
+    "pc6.com": {"score": 0.25, "class": "download_portal", "reason": "软件下载引流壳"},
+    "onlinedown.net": {"score": 0.25, "class": "download_portal", "reason": "软件下载引流壳"}
   },
   "serp_host_markers": [
     "baidu.com",

package/bin/argo

@@ -69,13 +69,35 @@ MIN_PYTHON = (3, 9)
 # 运行（静默跑在不支持的解释器上）。根因是把「版本」和「依赖」两个判据拆到了两条
 # 分支上，谁抄漏一个就少一半闸门。现在两个脚本同源生成，只换 yaml 那一段。
 _PY_MIN_VER = ",".join(str(part) for part in MIN_PYTHON)
+# 廉价档：find_spec 只问「存在性」，不 import（~15 ms）。
 _PY_CHEAP_CHECK = (
     "import sys, importlib.util as u; sys.exit(0 if sys.version_info >= (%s,) "
     "and u.find_spec('yaml') is not None else 1)" % _PY_MIN_VER
 )
+# 严格档：真 import 一遍（~80–170 ms），抓「find_spec 说在、import 却炸」——
+# 半装的 PyYAML、被 sys.path 上的坏 .pth 顶掉的 namespace 包、ABI 不匹配的
+# 扩展模块都属这类。版本判据必须与廉价档同源，否则又会回到「3.9 被选中写进
+# 缓存」那个历史 bug（见上方历史注记）。
+#
+# 2026-10-21 修复：此前的写法是
+#     import sys; sys.exit(0 if sys.version_info >= (3,9,) else 1); import yaml
+# `sys.exit()` 在版本判据成立的那一刻就终止进程，`import yaml` 是**永不执行的
+# 死代码**——严格档与廉价档的唯一区别（真 import）被自己吃掉了，两个档退化成
+# 同一个判据。实锤后果：macOS 自带 python3.9（无 PyYAML）通过探测、被写进
+# ~/.cache/unified-search/.argo_python，此后每个 `type: cli` 引擎都先付一次
+# 子进程 ModuleNotFoundError；实测 weather 引擎单次 5.8s 失败、weather_query
+# 域 p50 被抬到 3071ms（本机最慢域）。
+#
+# 现在的写法把「版本不达标 → exit(1)」写成**前置 if**，import yaml 与 sys.exit(0)
+# 都在它后面：只有版本放过之后才碰依赖，依赖炸就炸在 exit 之前，rc 非 0。
+# 反过来写（`sys.exit(0 if ... else 1); import yaml`，无论单行还是换行）都还是
+# 死代码——exit 是立即终止，同一行分号挡不住它。测试见
+# tests/test_python_probe.py::test_strict_check_fails_when_yaml_is_unavailable。
 _PY_STRICT_CHECK = (
-    "import sys; sys.exit(0 if sys.version_info >= (%s,) else 1); import yaml"
-    % _PY_MIN_VER
+    "import sys\n"
+    "if sys.version_info < (%s,): sys.exit(1)\n"
+    "import yaml\n"
+    "sys.exit(0)" % _PY_MIN_VER
 )
 
 
@@ -145,6 +167,43 @@ def _remember_python(p: str) -> None:
         pass
 
 
+# 已知安装前缀：GUI / 非交互式 shell 常常没跑 `brew shellenv`，于是
+# /opt/homebrew/bin 不在 PATH 上，`shutil.which("python3.14")` 一律落空。
+#
+# 本机实测（2026-10-21）：`/opt/homebrew/bin/python3.14` 带 PyYAML 6.0.3，
+# 而 PATH 上只有 `/usr/bin/python3`（3.9.6，无 PyYAML）。探测链全部落空后
+# _pick_python 回落到 sys.executable=3.9，argo 全程跑在缺依赖的解释器上：
+# 每个 `type: cli` 引擎（weather/wx.py 等）都先付一次 ModuleNotFoundError
+# （实测 weather 单次 5.8s 失败，weather_query 域 p50 被抬到 3071ms）。
+#
+# PATH 仍然优先（那是用户的显式意图），这只是「which 落空时按惯例位置再找
+# 一遍」的兜底，不改变任何 PATH 上已能解析到的选择。Windows 无这些前缀，
+# 列表里的路径不存在即跳过（isfile 守卫），不引入平台分支。
+_KNOWN_PY_PREFIXES = (
+    "/opt/homebrew/bin",              # macOS arm64 Homebrew
+    "/usr/local/bin",                 # macOS x86 Homebrew / 手工安装
+    "/opt/local/bin",                 # MacPorts
+    os.path.expanduser("~/.local/bin"),
+)
+
+
+def _which_python(name: str) -> str:
+    """按「PATH → 已知安装前缀」的顺序解析解释器；都找不到返回空串。
+
+    只替换 `shutil.which` 的调用点，语义是它的**严格超集**：PATH 上有就直接
+    用它（含用户自建的 shim/pyenv），没有才去惯例位置找。因此不会改变任何
+    「原本就能解析到」的机器上的选择。
+    """
+    found = shutil.which(name)
+    if found:
+        return found
+    for prefix in _KNOWN_PY_PREFIXES:
+        cand = os.path.join(prefix, name)
+        if os.path.isfile(cand) and os.access(cand, os.X_OK):
+            return cand
+    return ""
+
+
 def _pick_python() -> str:
     """选择可用解释器：ARGO_PYTHON 优先，其次高版本 python3.x，兜底当前解释器。
 
@@ -153,13 +212,17 @@ def _pick_python() -> str:
     python3），只有在没有更高版本时才被选中——那时 MIN_PYTHON 仍会兜住，
     不会静默选一个跑不动的解释器。
 
+    候选名经 `_which_python` 解析（PATH 优先 + 已知安装前缀兜底），见
+    _KNOWN_PY_PREFIXES 的实测记录：只查 PATH 会让「装了 3.14 但没进 PATH」
+    的机器静默回落到无 PyYAML 的系统 python。
+
     探测结果落盘缓存（见 _PY_CACHE）：命中时不再起子进程 import 依赖。显式
     指定 ARGO_PYTHON 时不查也不写缓存——用户的覆盖是权威，不该被缓存遮蔽，
     也不该把它固化下来。
     """
     env_py = os.environ.get("ARGO_PYTHON", "").strip()
     if env_py:
-        p = shutil.which(env_py) if not os.path.isabs(env_py) else env_py
+        p = _which_python(env_py) if not os.path.isabs(env_py) else env_py
         if p and _probe_python(p, True):
             return p
     else:
@@ -177,9 +240,9 @@ def _pick_python() -> str:
         if isinstance(cand, str):
             if not cand:
                 continue
-            py = cand if os.path.isabs(cand) else shutil.which(cand)
+            py = cand if os.path.isabs(cand) else _which_python(cand)
         else:
-            launcher = shutil.which(cand[0])
+            launcher = _which_python(cand[0])
             py = _resolve_launcher([launcher] + list(cand[1:])) if launcher else ""
         if not py:
             continue
@@ -498,6 +561,8 @@ Usage:
   argo paths [--check] [--migrate]     路径自省 / 本机自检 / 搬历史状态到惯例目录
   argo daemon    {{start|status|stop}}   常驻进程（search 自动走 UDS 快路径，消每次 ~85ms 启动+import；ARGO_NO_DAEMON=1 关）
   argo stats [-n N]                    使用日志与反馈状态（本地使用日志只读出口）
+  argo budget  {{list|set|unset}}        按引擎的月度预算（原生币种；默认 DeepSeek ¥5/月）
+  argo quota   [--json] [--refresh]    知乎开放平台当日额度（官方 API，不消耗业务额度）
 
 Common flags: --json --mode {{fast|auto|deep|budget}} --max-results N --depth {{fast|balanced|deep}}
 
@@ -593,8 +658,16 @@ def main():
         "job":       ("job.py",        []),
         "preflight": ("batch_probe.py", []),
         "mcp":       ("mcp_setup.py",  []),
+        # engine：新引擎一键接入（spec → 探测 → 派生 → 语料 → 验证 → 准入 → 同步）。
+        # `argo engine add --from-yaml ...` / `--from-url ...` / `--engine ...`；
+        # 详见 scripts/engine_add.py 与 docs/ADDING_NEW_ENGINE.md。
+        "engine":    ("engine_add.py", []),
         # stats：本地使用日志只读出口（日志与反馈的规范化入口，见 references/usage.md）
         "stats":     ("stats_cli.py",  ["--json"]),
+        # budget：按引擎的月度预算（原生币种）；quota 启动时读取并强制执行
+        "budget":    ("budget_cli.py", []),
+        # quota：知乎开放平台当日额度（官方 /api/v1/quota，不消耗业务额度）
+        "quota":     ("zhihu_quota.py", []),
         # paths：路径自省（状态目录/密钥文件到底解析到了哪里）。支持类问题的
         # 第一问，且不必进 MCP 工具面（与 answer/watch 同类）。
         "paths":     ("argo_paths.py", []),

package/bin/argo.js

@@ -45,9 +45,37 @@ const env = { ...process.env, PYTHONUTF8: process.env.PYTHONUTF8 || '1' };
 
 const argv = process.argv.slice(2);
 
+// 快速参数与帮助支持
+if (argv[0] === '-v' || argv[0] === '--version') {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
+    console.log(pkg.version);
+  } catch (_) {
+    console.log('2.9.9');
+  }
+  process.exit(0);
+}
+
+if (argv[0] === '-h' || argv[0] === '--help') {
+  console.log(`Argo Search — 专为 Agent 打造的统一搜索与证据核验工具
+
+用法:
+  argo-search                         启动 MCP Stdio 服务（默认）
+  argo-search mcp                     显式启动 MCP Stdio 服务
+  argo-search call <tool> [json-args] CLI 单发调用指定 MCP 工具
+  argo-search -v, --version           查看当前版本
+  argo-search -h, --help              查看本帮助信息
+
+环境依赖:
+  需要 Python 3.9+ 及 PyYAML。
+  无配置零门槛运行推荐: uvx argo-search argo-mcp
+`);
+  process.exit(0);
+}
+
 // 子命令分发：`argo-search call <tool> '<json-args>'` —— CLI 单发，与 stdio
 // 服务共用 mcp_server.py --call / execute_tool 入口（同引擎同压缩），供 DSH
-// 原生工具等调用方免 MCP 帧协议复用；无子命令保持原行为：启动 stdio 服务。
+// 原生工具等调用方免 MCP 帧协议复用；无子命令或 'mcp' 保持原行为：启动 stdio 服务。
 if (argv[0] === 'call') {
   const tool = argv[1];
   if (!tool) {
@@ -66,7 +94,9 @@ if (argv[0] === 'call') {
     process.exit(exitCodeOf(code, signal));
   });
 } else {
-  const proc = spawn(PYTHON, [SCRIPT], {
+  // 'mcp' 子命令作为 stdio 服务的显式别名，去除该前导参数
+  const forwardedArgs = argv[0] === 'mcp' ? argv.slice(1) : argv;
+  const proc = spawn(PYTHON, [SCRIPT, ...forwardedArgs], {
     stdio: ['pipe', 'pipe', 'inherit'],
     env,
   });
@@ -77,6 +107,7 @@ if (argv[0] === 'call') {
   proc.on('error', (err) => {
     console.error(`argo-search: 无法启动 Python (${PYTHON}): ${err.message}`);
     console.error('请确认已安装 Python 3.9+，并已执行: pip install pyyaml');
+    console.error('或使用无需预装环境的现代包管理工具: uvx argo-search argo-mcp');
     process.exit(1);
   });