argo-search 1.0.1 → 2.9.8

package/engines/specs/carbon_intensity.yaml

@@ -0,0 +1,32 @@
+# UK Carbon Intensity — 英国电网碳强度（国家电网 ESO 官方，免认证）
+# 补 environment 域的「电网碳强度」维度。无查询参数：返回当前全国碳强度快照；
+# 同域兄弟端点 /regional 给区域碳强度 + 发电燃料占比（generationmix）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine carbon_intensity --stage all --admit --write-doc
+
+engine_id: carbon_intensity
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://api.carbonintensity.org.uk/regional
+timeout: 12
+query_param: ""
+canary_query: "carbon intensity"
+desc: "英国电网碳强度与发电结构（国家电网官方，免认证）"
+coverage: [environment, energy, realtime, official]
+recommended: false
+latency_ms: 1200
+
+headers:
+  User-Agent: argo-search/1.0 (+carbon_intensity)
+  Accept: application/json
+
+output_map:
+  items: data.0.regions
+  item_title: shortname
+  item_summary: intensity.index
+  url_template: "https://carbonintensity.org.uk/"
+
+quality_queries:
+  - query: "carbon intensity"

package/engines/specs/cfets.yaml

@@ -0,0 +1,41 @@
+# 中国外汇交易中心（CFETS）人民币中间价（免 key）
+#
+# 补的盲区：**在岸人民币官方价**。现有汇率源都是离岸/聚合口径：
+# frankfurter 是 ECB 参考价、fx_rate 是 open.er-api 聚合价，都不是
+# 人民银行授权的中间价。CFETS 是每个交易日 9:15 公布的官方中间价，
+# 也是跨境结算与合同计价的口径来源。
+#
+# 端点语义（2026-10-21 实测）：按货币对 + 日期区间查历史，不支持自由文本。
+#   GET /ags/ms/cm-u-bk-ccpr/CcprHisNew?currency=USD/CNY&startDate=…&endDate=…
+#   → records[].date + values[]（values[0] 即该货币对中间价）
+# 币种覆盖 25 个（USD/EUR/100JPY/HKD/GBP/AUD/NZD/SGD/CHF/CAD/CNY-MOP…
+# CNY-MYR/RUB/ZAR/KRW/AED/SAR/HUF/PLN/DKK/SEK/NOK/TRY/MXN/THB）。
+# builder 负责把「美元」「日元」「USD/CNY」这类查询词解析成货币对；
+# 只说「人民币中间价」时按美元对（市场最常用口径）。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine cfets --stage health --admit
+#   argo search "美元 人民币 中间价" --engine cfets --json
+
+engine_id: cfets
+type: cfets
+enabled: true
+cost_tier: free
+label: 人民币中间价
+family: finance_macro
+priority: 51
+qps: 2
+period: second
+cost_per_call: 0.0
+cost_unit: free
+recommended: false
+
+timeout: 15
+canary_query: 美元 人民币 中间价
+desc: "中国外汇交易中心人民币中间价（25 个币种，官方授权口径，免 key）"
+coverage: [finance, macro, china, official, realtime]
+
+quality_queries:
+  - query: 美元 人民币 中间价
+  - query: 日元 人民币 中间价
+  - query: CNY HKD mid rate

package/engines/specs/cinii.yaml

@@ -0,0 +1,44 @@
+# CiNii Research — 日本学术总库（免 key，NII 官方）
+#
+# 补的盲区：**亚洲学术**。argo 的 academic 域此前全是欧美源
+# （arxiv/openalex/crossref/semantic_scholar/dblp/europepmc/biorxiv/
+# openreview/core），日文论文与日本学会刊没有任何直采通道。
+#
+# 实测（2026-09-21）：OpenSearch JSON，免 appid 可用；「AI」158741 条命中，
+# 返回 9230B / 2 条。条目含 dc:creator / dc:publisher / prism:publicationDate
+# / description，字段密度与 crossref 同档。
+#
+# 形态：检索式（query 参与检索），与 ndl（日本国会图书馆书目）互补——
+# ndl 查「有什么书」，cinii 查「有什么论文/研究项目」。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine cinii --stage all --admit
+
+engine_id: cinii
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://cir.nii.ac.jp/opensearch/all
+timeout: 15
+query_param: q
+canary_query: "人工知能"
+family: academic
+langs:
+- ja
+coverage: [academic, paper, japan]
+desc: "CiNii Research 日本学术总库（论文/博士论文/科研项目，免 key）"
+recommended: false
+extra_params:
+  format: json
+  count: "{n}"
+output_map:
+  items: items
+  item_title: title
+  item_url: link.@id
+  item_summary: description
+  item_published_at: prism:publicationDate
+
+quality_queries:
+  - query: "人工知能"
+  - query: "機械学習"

package/engines/specs/clawhub.yaml

@@ -0,0 +1,49 @@
+# ClawHub — OpenClaw 技能生态聚合搜索（skill 域，GET JSON，keyless）
+# 聚合器：索引含 OpenClaw 原生技能 + skills.sh（Vercel 生态）条目，
+# 与 redskill（小红书生态）/ skillsmp（独立索引）互补不重复（不同上游）。
+# downloads 是其生态下载量口径，与 skills.sh 安装遥测、SkillsMP 仓库星数互不可比。
+# canonicalUrl 为站内相对路径，经 url_template 拼接为完整 URL。
+# 验证:
+#   python3 scripts/engine_validate.py --engine clawhub --stage all --admit --write-doc
+
+engine_id: clawhub
+type: http
+enabled: true
+cost_tier: free
+label: ClawHub 技能目录
+family: misc_vertical
+priority: 50
+qps: 2
+period: second
+limit: null
+cost_per_call: 0.0
+cost_unit: free
+method: GET
+url: https://clawhub.ai/api/search
+timeout: 15
+canary_query: "git commit"
+coverage:
+- skill
+- developer
+- tech
+desc: "ClawHub 技能生态聚合搜索（OpenClaw 原生 + skills.sh 条目，免认证，下载量口径）"
+format: json
+query_param: q
+extra_params:
+  limit: "{n}"
+output_map:
+  items: results
+  item_title: displayName
+  item_url: canonicalUrl
+  item_summary: summary
+  # 可验证出处：install.reference 是 `owner/slug` 形式的安装引用，比
+  # canonicalUrl 市场页更接近「装什么」（sourceUrl 多为 null 故不取）。
+  item_upstream: install.reference
+  # updatedAt 是 epoch **毫秒**（SkillsMP 同名字段是秒，差 1000 倍，由
+  # engines_base._normalize_epoch 按量级归一成日期）。
+  item_published_at: updatedAt
+  url_template: "https://clawhub.ai{canonicalUrl}"
+quality_queries:
+  - query: "git commit"
+  - query: "code review"
+  - query: "pdf"

package/engines/specs/cleveland.yaml

@@ -0,0 +1,19 @@
+# 克利夫兰艺术博物馆（CC0 开放图像，免认证）
+# 与 artic/met_museum 互补：CC0 授权可直接取图，含 tombstone 完整著录。
+# 验证:
+#   python3 scripts/engine_validate.py --engine cleveland --stage all --admit --write-doc
+
+engine_id: cleveland
+type: cleveland
+enabled: true
+cost_tier: free
+timeout: 20
+canary_query: "monet"
+desc: "克利夫兰艺术博物馆（CC0 开放图像，免认证）"
+coverage: [art, museum, culture, image]
+recommended: false
+latency_ms: 2500
+
+quality_queries:
+  - query: "monet"
+  - query: "armor"

package/engines/specs/cn_ai_news.yaml

@@ -0,0 +1,43 @@
+# 中文 AI 垂直资讯检索（免 Key）
+# 数据源: https://aihot.virxact.com 公开 REST API（浏览器 UA 必需，否则 403）
+# 能力: 精选中文 AI 资讯（模型/产品/行业/论文），带发布时间 publishedAt 与上游来源
+# 端点: GET /api/public/items?mode=selected&q=<关键词>&take=<n>
+#   模式: selected=精选 / all=全量；since 需 ISO 且服务端上限 7 天（spec 不透传）
+# 验证:
+#   python3 scripts/engine_validate.py --engine cn_ai_news --stage all --admit
+#   python3 scripts/search.py "大模型" --engine cn_ai_news --json
+
+engine_id: cn_ai_news
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://aihot.virxact.com/api/public/items
+timeout: 10
+query_param: q
+canary_query: "人工智能"
+desc: "中文 AI 垂直资讯检索（模型/产品/行业/论文，含发布时间与上游来源）"
+coverage: [chinese, news, ml]
+recommended: false
+
+family: news_flash
+
+headers:
+  User-Agent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+  Accept: application/json
+
+extra_params:
+  mode: selected
+  take: "{n}"
+
+# 上游来源（如「字节 Seed：Research Feed（网页内嵌数据）」）是真实发布方标注，
+# 保留而非改写为引擎名
+preserve_source: true
+
+output_map:
+  items: items
+  item_title: title
+  item_url: url
+  item_summary: summary
+  item_source: source
+  item_published_at: publishedAt

package/engines/specs/core.yaml

@@ -0,0 +1,35 @@
+# CORE — 开放获取论文全文聚合（api.core.ac.uk v3，免 key）
+#
+# 覆盖定位：聚合全球机构仓储的**开放获取全文**（实测 totalHits≈8 万/常见词）。
+# 与既有源的区别——openalex/crossref 给元数据，CORE 直接给可下载 PDF
+# （downloadUrl）；且覆盖机构仓储里未进 arXiv/PubMed 的学位论文与灰色文献。
+#
+# 两处实现要点（详见 engines_builders_batch9._build_core_engine 文档串）：
+#   ① 限流响应是 **HTTP 200 + 错误封套**（{"message":"Azure search failed
+#      with status code: 503..."}），通用 _envelope_error 要求 Code 与
+#      message 同时在场，识别不出 → 会静默变成「无结果」。本引擎显式识别。
+#   ② 端点**必须带尾斜杠**：/v3/search/works?q= 会 301 到 /works/?q=，
+#      多一次往返。故此处 type 走自定义 builder，URL 在 builder 内拼装。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine core --stage all --admit --write-doc
+
+engine_id: core
+type: core
+enabled: true
+cost_tier: free
+qps: 2
+priority: 31
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 20
+desc: "CORE 开放获取全文（含 PDF 直链，覆盖机构仓储灰色文献）"
+coverage: [academic, science]
+recommended: false
+latency_ms: 4000
+
+quality_queries:
+  - query: "CRISPR gene editing"
+  - query: "open access repository"
+  - query: "machine learning"

package/engines/specs/crt_sh.yaml

@@ -0,0 +1,38 @@
+# crt.sh — 证书透明度日志搜索（免认证，comodo/Sectigo 维护）
+# 补 security_search 域的子域名/证书情报维度（资产测绘、钓鱼域发现），
+# NVD 只覆盖漏洞不覆盖暴露面。响应偏慢（常见 10-40s），超时放宽、延迟声明从宽。
+# 配额契约：无官方限额，声明 qps 从紧。
+# 验证:
+#   python3 scripts/engine_validate.py --engine crt_sh --stage all --admit --write-doc
+
+engine_id: crt_sh
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://crt.sh/
+timeout: 45
+query_param: q
+canary_query: "example.com"
+desc: "crt.sh 证书透明度日志（子域名/证书情报，免认证，响应较慢）"
+coverage: [security, tech]
+recommended: false
+latency_ms: 15000
+
+headers:
+  User-Agent: argo-search/1.0 (+crt_sh)
+  Accept: application/json
+
+extra_params:
+  output: json
+
+output_map:
+  items: "."
+  item_title: common_name
+  item_summary: issuer_name
+  item_published_at: not_before
+  url_template: "https://crt.sh/?id={id}"
+
+quality_queries:
+  - query: "example.com"
+  - query: "github.com"

package/engines/specs/ct24.yaml

@@ -0,0 +1,43 @@
+# 捷克电视台24 RSS — ČT24，捷克公共电视新闻
+#
+# 补的盲区：**cs 本地一手新闻**。接入前 argo 的新闻链路只有中英源
+# （google_news/guardian_rss/dw_news/france24 都是英语视角），cs 查询
+# 拿不到本地一手报道。
+#
+# 实测（2026-09-21）：**30 条**，摘要中位 433 字、最长 828 字。
+#
+# 形态：feed_mode=hot（实时流语义，同 guardian_rss）。归 world_news 族——
+# 与 hot_trending（热榜）分族，避免同族 max_per_family=2 把本地源互相挤掉。
+# 语言由 langs 声明，路由按查询语言选源（见 route._lang_aware_combo_order）。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine ct24 --stage all --admit
+#   python3 scripts/search.py "dnešní zprávy" --engine ct24 --json
+
+engine_id: ct24
+type: rss_feed
+enabled: true
+cost_tier: free
+label: 捷克电视台24 RSS
+family: world_news
+feed_mode: hot
+relevance_check: false
+priority: 53
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+timeout: 12
+feed_url: https://ct24.ceskatelevize.cz/rss/hlavni-zpravy
+langs:
+- cs
+canary_query: "dnešní zprávy"
+coverage:
+- news
+- czech
+desc: "捷克电视台24（ČT24，捷克公共电视新闻，免 key）"
+recommended: false
+
+quality_queries:
+  - query: "dnešní zprávy"
+  - query: "ekonomika Česko"

package/engines/specs/datacite.yaml

@@ -0,0 +1,27 @@
+# DataCite 科研数据集搜索（免 Key）
+# 文档: https://support.datacite.org/docs/api-getting-started
+# 验证:
+#   python3 scripts/engine_validate.py --engine datacite --stage all --admit
+#   python3 scripts/search.py "genome" --engine datacite --json
+
+engine_id: datacite
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://api.datacite.org/dois
+timeout: 15
+query_param: query
+canary_query: "genome"
+desc: "DataCite 科研数据集搜索（Dryad/Figshare/Dataverse/OSF 等仓储，免认证）"
+coverage: [dataset, academic, opendata]
+recommended: false
+
+extra_params:
+  page[size]: "{n}"
+
+output_map:
+  items: data
+  item_title: attributes.titles.0.title
+  item_url: attributes.url
+  item_summary: attributes.descriptions.0.description

package/engines/specs/datagov_uk.yaml

@@ -0,0 +1,41 @@
+# data.gov.uk — 英国政府开放数据目录（免 key，CKAN API）
+#
+# 补的盲区：**英国政府开放数据集**。argo 已有 eu_opendata（欧盟）与
+# fr_opendata（法国），英国这一档缺位；且英国是开放数据运动的发源地，
+# 数据集密度高于多数欧盟国家。
+#
+# 实测（2026-09-21）：CKAN package_search 免 key，JSON 直出；
+# 「climate」返回结构化数据集条目（title / notes / name / organization）。
+#
+# 形态：检索式。url 由 url_template 从数据集 slug 拼出。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine datagov_uk --stage all --admit
+
+engine_id: datagov_uk
+type: http
+enabled: true
+cost_tier: free
+method: GET
+url: https://data.gov.uk/api/3/action/package_search
+timeout: 20
+query_param: q
+canary_query: "climate"
+family: misc_vertical
+langs:
+- en
+coverage: [opendata, government, dataset, uk]
+desc: "data.gov.uk 英国政府开放数据目录（CKAN，免 key）"
+recommended: false
+explicit_only: true
+extra_params:
+  rows: "{n}"
+output_map:
+  items: result.results
+  item_title: title
+  item_summary: notes
+  url_template: "https://data.gov.uk/dataset/{name}"
+
+quality_queries:
+  - query: "climate"
+  - query: "transport"

package/engines/specs/ddgs_images.yaml

@@ -0,0 +1,45 @@
+# 通用图片搜索（免 Key，走 ddgs/Bing 图片通道）
+#
+# 为什么要有这个源：image_search 域此前只有 openverse 一个通用图库，而它是
+# **开放版权素材库**——查「雪山」给的是 Flickr 上 CC 授权的照片，覆盖窄，且
+# 对「这个产品长什么样」「这个梗图」这类检索无能为力。本引擎补的是**全网
+# 图片**维度：底层 ddgs 走 Bing 图片索引，覆盖商业图库、新闻配图、社交平台
+# （实测中文查询能出花瓣、千叶网等站点），是通用图库之外的覆盖面。
+#
+# 与 openverse 的分工（两者都要，不是替代）：
+#   - openverse：要「能合法发布」的素材 → 带 license/宽高/商用判据
+#   - ddgs_images：要「能找到这张图」 → 覆盖面优先，**多数结果无许可信息**
+# 因此本源结果不带 image_commercial_ok（上游不给许可字段，判定为「未判定」
+# 而非「不可商用」），用在要发布的稿子里之前须自行核对。
+#
+# 实现复用 sub-skills/local-search 的 local_ddgs_images 子引擎（那边已写好
+# ddgs 调用与字段解析），不在主仓重复实现一遍 CLI 调用逻辑。
+# 验证:
+#   python3 scripts/engine_validate.py --engine ddgs_images --stage all --admit
+
+engine_id: ddgs_images
+type: cli
+enabled: true
+cost_tier: free
+label: 通用图片
+desc: "通用图片搜索（免 Key，覆盖全网图片；无版权标注，发布前须自行核对）"
+coverage: [image, media, web]
+family: misc_vertical
+priority: 34
+timeout: 20
+canary_query: "snow mountain"
+cmd:
+- python3
+- sub-skills/local-search/search_v3.py
+search_args:
+- '{query}'
+- --n
+- '{n}'
+- --engine
+- local_ddgs_images
+- --json
+output_format: json
+quality_queries:
+  - query: "snow mountain"
+  - query: "雪山"
+  - query: "vintage poster"

package/engines/specs/deepseek_search.yaml

@@ -0,0 +1,74 @@
+# DeepSeek Search 引擎（官方 API）——默认开启（需 DEEPSEEK_API_KEY，无 key 时自动停用）
+#
+# 它是什么：DeepSeek 官方网页搜索（POST api.deepseek.com/v1/tools/search），
+# 按次计费 5 元/千次**成功**请求，账号级 QPS 5。返回结果自带四样 Argo 既有
+# 中文 API 引擎（bocha/byted/metaso/octen）都没有的结构化字段：
+#   - authority：0-4 权威分级（-1 未知，≥3 极权威）
+#   - rerank_score：0-3 排序分（≥1.5 优质，综合相关性/权威性/时效）
+#   - date：发布时间，RFC 3339 UTC
+#   - site_name / site_icon：站点名与图标
+# 前两样经 output_map 的 item_upstream_* 透传进结果（upstream_authority/
+# upstream_score），输出层的 authority_level（0-4 离散等级，DeepSeek 语义）
+# 优先采信上游原生 authority，没有再回退 Argo 自己的连续 authority 映射。
+#
+# 计费口径与 Argo 自适应学习天然对齐：DeepSeek 只对 HTTP 200 且 results
+# 非空的请求收费；Argo 的 classify_engine_outcome 对 no-results/timeout/
+# error 一律不计成功——两边同口径，不存在「失败也扣分」的错位。
+#
+# 搜索语法（DeepSeek 原样透传给上游，本引擎可吃用户查询里的 site:/-词/
+# -"短语"/"短语"/lang:zh,en/after:/before: 操作符）——查询级操作符契约层
+# 见 scripts/query_operators.py（2026-10-17 同期落地）。
+#
+# 启用前提：
+#   1. export DEEPSEEK_API_KEY=<key>（DeepSeek 开放平台申请；只进 env，
+#      与 {ENV} 占位纪律一致，不写进任何仓库文件）——无 key 时引擎不可用，
+#      路由自动跳过，不影响其他源
+#   2. 健康门：python3 scripts/engine_validate.py --engine deepseek_search --stage all --admit
+#   3. 显式调用：argo search "查询" --engine deepseek_search
+# 路由形态：不进任何域 combo；auto/deep 档位下仅可能经 TF-IDF 强匹配注入
+# （罕见，如查询本身就是 deepseek 主题），显式 --engine deepseek_search
+# 是主路径；fast/budget 模式按成本纪律自动排除付费源。计费口径见文件头
+# （5 元/千次成功请求，失败/空结果不计费）。
+#
+# 配套 Fetch 接口（api.deepseek.com/v1/tools/fetch，返回 Markdown 正文）
+# 留作抓取链备选，本 spec 只接 search。
+engine_id: deepseek_search
+type: http
+enabled: true          # 默认开；无 DEEPSEEK_API_KEY 时不可用，路由自动跳过
+explicit_only: true    # 不进任何域 combo 与通用兜底，只经 --engine 显式调用
+cost_tier: paid
+method: POST
+url: https://api.deepseek.com/v1/tools/search
+timeout: 12
+canary_query: "DeepSeek"
+label: DeepSeek Search
+family: web_general
+priority: 60
+qps: 5
+period: second
+cost_per_call: 0.005
+cost_unit: cny
+required_env:
+  - DEEPSEEK_API_KEY
+
+headers:
+  Authorization: Bearer {DEEPSEEK_API_KEY}
+  Content-Type: application/json
+
+# POST body：{query} 查询词，{n} 结果数（DeepSeek count 1-50，渲染时自动 int 化）
+body:
+  query: "{query}"
+  count: "{n}"
+
+# DeepSeek 返回 {results:[{rerank_score,title,url,snippet,summary,content,
+# site_name,site_icon,date,authority}]}。snippet 100-200 字走 snippet 档；
+# summary/content 不接（正文按需走 fetch/verify 链，不在 search 层拉全量）。
+output_map:
+  items: results
+  item_title: title
+  item_url: url
+  item_summary: snippet
+  item_source: deepseek_search
+  item_published_at: date
+  item_upstream_authority: authority
+  item_upstream_score: rerank_score

package/engines/specs/deezer.yaml

@@ -0,0 +1,20 @@
+# Deezer 音乐艺人/专辑（免认证）
+# 补 media_search 域：现有 qq_music（华语）、itunes（Apple 生态）、musicbrainz（元数据），
+# Deezer 补欧洲/西语圈曲库与粉丝量维度。
+# 验证:
+#   python3 scripts/engine_validate.py --engine deezer --stage all --admit --write-doc
+
+engine_id: deezer
+type: deezer
+enabled: true
+cost_tier: free
+timeout: 15
+canary_query: "radiohead"
+desc: "音乐艺人/专辑（Deezer，免认证）"
+coverage: [media, music, entertainment]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "radiohead"
+  - query: "coldplay"

package/engines/specs/defillama.yaml

@@ -0,0 +1,38 @@
+# DeFiLlama 协议 TVL（免 key）
+#
+# 补的盲区：**链上资金规模**。现有 crypto 源只有 CoinGecko（币价/市值），
+# 没有「协议里锁了多少钱」这个口径。DeFiLlama 是 DeFi TVL 的事实标准，
+# 免 key、免注册，覆盖 8700+ 协议与 300+ 链。
+#
+# 端点语义（2026-10-21 实测）：单次返回全量协议列表（约 9 MB / 2.4s），
+# 不支持关键词查询，builder 本地过滤（名称/代号/类别/链）并按 TVL 排序。
+# 全量结果进程内缓存 5 分钟，连续查询不重复下载。
+#   GET /protocols → [{name, symbol, category, chain, chains, tvl,
+#                      change_1d, change_7d, slug, url, description}]
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine defillama --stage health --admit
+#   argo search "aave tvl" --engine defillama --json
+
+engine_id: defillama
+type: defillama
+enabled: true
+cost_tier: free
+label: DeFiLlama
+family: finance_market
+priority: 45
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+recommended: false
+
+timeout: 30
+canary_query: aave
+desc: "DeFiLlama 协议 TVL（8700+ 协议资金规模/24h 与 7d 变化，免 key）"
+coverage: [crypto, finance, blockchain, defi]
+
+quality_queries:
+  - query: aave tvl
+  - query: uniswap 锁仓
+  - query: Lido 质押 规模

package/engines/specs/deps_dev.yaml

@@ -0,0 +1,21 @@
+# deps.dev — 包依赖与版本状态（Google 维护，npm/pypi/go/maven/cargo 五生态，免认证）
+# 边界：只答包存在性/最新版本/弃用状态/发布时间；包级漏洞聚合端点不存在，
+# 漏洞情报由 nvd 引擎按关键词补位。查询形态：「<生态> <包名>」或裸包名（默认 npm）。
+# 验证:
+#   python3 scripts/engine_validate.py --engine deps_dev --stage all --admit --write-doc
+
+engine_id: deps_dev
+type: deps_dev
+enabled: true
+cost_tier: free
+timeout: 10
+canary_query: "npm express"
+desc: "deps.dev 包依赖（npm/pypi/go/maven/cargo；版本/弃用/发布时间）"
+coverage: [code, package]
+recommended: false
+latency_ms: 2000
+
+quality_queries:
+  - query: "npm express"
+  - query: "python requests"
+  - query: "rust serde"

package/engines/specs/digup.yaml

@@ -0,0 +1,36 @@
+# DigUp 本地文件语义搜索（CLI 桥接）——默认关闭，按需启用
+#
+# 它搜什么：本机文件按「内容」而不是文件名——照片/截图按画面与图内文字、
+# PDF 按页、文档按块、音频/视频按 30s 窗口与抽帧（命中精确到页/秒/行）。
+# 模型 EmbeddingGemma 2 在设备端跑（llama.cpp/Metal），索引与检索全程离线。
+#
+# 前提（一次性）：
+#   1. digup CLI 就位（桥按此序自动定位，也可 $DIGUP_BIN / --bin 指定）：
+#      PATH 里的 digup > /Applications/DigUp.app/Contents/Helpers/digup
+#      （brew install --cask arahim3/tap/digup 或 DMG 装的 App 自带）
+#   2. 建索引：digup index <文件夹>…（或开 DigUp.app 选文件夹；索引默认
+#      ~/Library/Application Support/DigUp/index.noindex，$DIGUP_INDEX 可覆盖）
+#   3. 启用：本文件 enabled 改 true，然后跑一次健康门
+#      python3 scripts/engine_validate.py --engine digup --stage health --admit
+#      （canary 需命中你索引里真实存在的内容，可用 --query 覆盖探针词）
+#
+# 调用：argo search "<用大白话描述文件内容>" --engine digup
+# 口径：强项是语义/多模态/跨语言召回；中文关键词精确查找仍以主链为准，
+# 两路结果在融合层按名次合并，本引擎不做额外降权。
+engine_id: digup
+type: cli
+enabled: false         # ← 默认关；开启步骤见文件头
+disabled_reason: 按需启用的本地引擎——需先装 digup CLI 并建索引（文件头三步），装好把 enabled 改 true 后跑 engine_validate 健康门；本机不装不影响任何主链功能
+cost_tier: free
+label: 本地文件语义搜索
+desc: DigUp（EmbeddingGemma 2 本地多模态嵌入，全程离线）——照片/截图/PDF/文档/音视频按内容检索
+canary_query: "test"
+relevance_check: false  # 本地索引内容因机而异，词面交集不是有效健康判据（schema+非空已够）
+cmd:
+- python3
+- scripts/digup_bridge.py
+search_args:
+- '{query}'
+- -n
+- '{n}'
+timeout: 30             # digup 首查冷启要加载 ~250MB text 模型（实测 0.4–0.8s），留足