argo-search 2.9.7 → 2.9.8

package/engines/specs/tavily_free.yaml

@@ -0,0 +1,56 @@
+# Tavily 免 key 通道（官方 keyless 匿名额度）
+#
+# 为什么与 tavily 并列而不是合并：两者同上游、不同经济模型——tavily 用
+# ARGO_TAVILY_API_KEY 走账号档（额度高、结果稳），本引擎走官方 keyless
+# 头（x-tavily-access-mode），不读任何 key。计费语义不同，合并会让
+# 「免费源不当计费源」的检查失真（与 parallel / parallel_free 同一处理）。
+#
+# 端点语义（2026-10-21 实测）：POST /search，带 `x-tavily-access-mode: keyless`
+# 且不带 Authorization，返回与账号档同构的 {results:[{title,url,content,score}]}。
+# 匿名额度有 IP 级限流；失效时返回 4xx，由调度层换源，不静默伪装成空结果。
+#
+# 验证:
+#   python3 scripts/engine_validate.py --engine tavily_free --stage health --admit
+#   argo search "OpenAI" --engine tavily_free --json
+
+engine_id: tavily_free
+type: http
+enabled: true
+cost_tier: free
+label: Tavily (keyless)
+family: web_general
+priority: 56
+qps: 1
+period: second
+cost_per_call: 0.0
+cost_unit: free
+recommended: false
+
+method: POST
+url: https://api.tavily.com/search
+timeout: 15
+
+headers:
+  Content-Type: application/json
+  x-tavily-access-mode: keyless
+
+body:
+  query: "{query}"
+  max_results: "{n}"
+  search_depth: basic
+  include_answer: false
+
+output_map:
+  items: results
+  item_title: title
+  item_url: url
+  item_summary: content
+  item_published_at: published_date
+
+canary_query: OpenAI
+desc: "Tavily 官方免 key 匿名通道（通用网页搜索，无需注册）"
+coverage: [general, english, chinese]
+
+quality_queries:
+  - query: OpenAI
+  - query: 人工智能 应用

package/engines/specs/yuanbao.yaml

@@ -0,0 +1,93 @@
+# 腾讯元宝搜索（Tencent WSA SearchPro，需 key）——默认开，无 key 时路由自动跳过
+#
+# 它是什么：腾讯云「联网搜索」的元宝口径（POST api.wsa.cloud.tencent.com/SearchPro）。
+# 中文全网检索，返回**权威源占比很高**：实测「三星堆的由来」10 条里 8 条来自
+# 人民日报 / 新华网 / 国家文物局 / 住建部 / 国家民委 / 中国日报 / 中新网 /
+# 中国经济网，另 2 条为环球网与腾讯新闻。这与 bocha/byted 的「门户+自媒体」
+# 构成互补——同一个查询上，它更偏一手/官方口径。
+#
+# 返回字段（实测）：passage（摘要 ~800 字）、content（更长正文 ~2000 字）、
+# score（相关度 0.55-0.65 区间）、date（`YYYY/MM/DD HH:MM:SS`，东八区）、
+# title、url、site（站点中文名，如「人民日报」）、favicon、pics。
+# 搜索层只取 passage 当摘要，正文按需走 fetch/verify 链（与 DeepSeek 引擎同口径）。
+#
+# 为什么是独立 builder 而不是 type: http（四条声明式表达不了的事实）：
+#   1. Pages 是 **JSON 字符串数组**，要二次解析
+#   2. 错误全部走 HTTP 200 + Response.Error（鉴权/欠费/限流都是），
+#      声明式会把它当「0 结果」
+#   3. date 是斜杠格式，不是 argo 的 ISO 约定
+#   4. Cnt 只接受 10/20/30/50，传别的值回 "illegal Cnt"
+# 详见 scripts/engines_builders_batch15.py 的模块 docstring。
+#
+# 成本口径：**未知**。官方文档未公布单价，只有 ResourceUnavailable「请检查账号
+# 是否欠费」这一条侧面说明它按量计费。故 cost_per_call 记 0.0（预算层因此不会
+# 扣减），并用 explicit_only 把它挡在自动路由之外——在价格与额度未知之前，
+# 不让它进任何域 combo，避免「自动花钱却算不出花了多少」。补齐价格后再按
+# scripts/paid_policy.py 的既有做法决定是否放进白名单域的付费对冲位。
+#
+# 启用前提：
+#   1. 配置 key（两个名字都认）：
+#        ARGO_YUANBAO_API_KEY=<key>      # argo 推荐名
+#        TENCENTCLOUD_WSA_APIKEY=<key>   # 腾讯官方名（文档里的环境变量名）
+#      写进 ~/.config/argo/env 即可，只进环境不落仓库。
+#   2. 健康门：python3 scripts/engine_validate.py --engine yuanbao --stage all --admit
+#   3. 显式调用：argo search "三星堆的由来" --engine yuanbao --json --fields agent
+#
+# 实测（2026-10-21 本机）：单次 POST 0.44s，返回 10 条，响应体 ~90KB。
+engine_id: yuanbao
+type: yuanbao
+enabled: true
+# 额度是**按次**的（默认 2000/月），不是按钱的——用 limit + period 的计数档位，
+# 不用 budget.py 的金额档（金额档要单价，计数档不要；单价官方也没公布）。
+#
+# 「次数」的口径：quota.record_many 的 used 计的是**发出过的调用数（含失败）**，
+# 只有 cost_used 是成功才累加。对硬额度而言这是安全的一侧——本地宁可早停，
+# 不让远端 2000 次的硬上限被撞穿；反过来说，本地显示「已用 100 次」时上游
+# 可能只计了其中成功的那些。本轮不改这个口径（改它要动 record_many 的通用
+# 语义，影响全部引擎）。
+#
+# 额度用完即 is_hard_down（全模式排除，不是仅仅排除路由），到 30 天周期边界
+# 惰性自愈；想提前恢复用 `python3 scripts/quota.py reset yuanbao`。
+#
+# **进自动路由（无 explicit_only）**：2026-10-21 起作为 chinese_general 域的第
+# 2 位对冲位（config.yaml 该域的注释里有实测依据）。之所以敢进，是因为额度是
+# **硬上限 + 自动摘除**：耗尽后 is_hard_down 把它从 combo 里摘掉，组合回落到
+# 此前的 anysearch/zhihu_global 形态——降级是明确的一步，不是静默变窄。
+# 代价是额度按查询量线性消耗（中文通用查询每次 1 次调用），档位见下方 limit。
+cost_tier: api
+method: POST
+url: https://api.wsa.cloud.tencent.com/SearchPro
+timeout: 12
+canary_query: 三星堆的由来
+label: 腾讯元宝搜索
+family: web_general
+priority: 55
+# 上游有 RequestLimitExceeded，但公开文档未给具体 QPS；保守取 2，避免撞限流。
+# 限频与下面的 period 无关：qps 检查走硬编码 60 秒窗口（quota.py:585 的
+# `now - t < 60`），全仓没有限频器读 period。
+qps: 2
+# period 是**额度语义**，今天只影响两处 + 一处展示：
+#   1. 本地额度重置跨度：quota._period_elapsed（month → 30 天，否则 1 天）
+#   2. 远端耗尽冷却窗：quota._PERIOD_SECONDS（month → 30 天；表里查不到的值
+#      ——含 second/minute——落 86400，且「过短一律按 24h 保守处理」）
+#   3. ENGINE_CATALOG 的「频率上限」列展示
+# 本引擎限额是月度，故两处都应为 30 天 = month。
+period: month
+# 月度调用额度。默认按体验额度 2000 次/月；开通更高套餐时改本行 limit
+# （DSH 面板默认值也按 2000 显示，面板写入只覆盖当前环境，不改进本文件）。
+limit: 2000
+# 单价未知（官方未公布超额度后的计价），故不填金额，只由 limit 约束次数。
+cost_per_call: 0.0
+cost_unit: credit
+recommended: false
+
+# key 候选链：任一有值即视为就绪（解析见 engine_env.missing_env_for）
+required_env:
+  - [ARGO_YUANBAO_API_KEY, TENCENTCLOUD_WSA_APIKEY, YUANBAO_API_KEY]
+
+coverage: [web, chinese, news, official]
+
+quality_queries:
+  - query: 三星堆的由来
+  - query: 央行 降准 最新
+  - query: 国家统计局 一季度 GDP

package/mcp/clients.yaml

@@ -72,3 +72,35 @@ clients:
     servers_key: mcpServers
     format: json
     detect: [.workbuddy]
+
+  - id: claude-desktop
+    name: Claude Desktop
+    config_path: Library/Application Support/Claude/claude_desktop_config.json
+    config_path_darwin: Library/Application Support/Claude/claude_desktop_config.json
+    config_path_win32: AppData/Roaming/Claude/claude_desktop_config.json
+    config_path_linux: .config/Claude/claude_desktop_config.json
+    servers_key: mcpServers
+    format: json
+    detect_darwin: [Library/Application Support/Claude]
+    detect_win32: [AppData/Roaming/Claude]
+    detect_linux: [.config/Claude]
+
+  - id: zed
+    name: Zed
+    config_path: .config/zed/settings.json
+    servers_key: context_servers
+    format: json
+    detect: [.config/zed]
+
+  - id: roo-code
+    name: Roo Code
+    config_path: Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
+    config_path_darwin: Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
+    config_path_win32: AppData/Roaming/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
+    config_path_linux: .config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
+    servers_key: mcpServers
+    format: json
+    detect_darwin: [Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline]
+    detect_win32: [AppData/Roaming/Code/User/globalStorage/rooveterinaryinc.roo-cline]
+    detect_linux: [.config/Code/User/globalStorage/rooveterinaryinc.roo-cline]
+

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "argo-search",
-  "version": "2.9.7",
-  "description": "Argo 阿尔戈 — 统一搜索与证据核验。推荐 npx -y github:taxueseek/argo 或 install.sh 安装（不依赖 npm 发版）。多语言路由、264 个源（227 个免密钥开箱可用）、影视/体育/金融等垂直源、19 个 MCP 工具（与 CLI 能力面对齐）。",
+  "version": "2.9.8",
+  "description": "Argo 阿尔戈 — 统一搜索与证据核验。推荐 npx -y github:taxueseek/argo 或 install.sh 安装（不依赖 npm 发版）。多语言路由、272 个源（235 个免密钥开箱可用）、影视/体育/金融等垂直源、19 个 MCP 工具（与 CLI 能力面对齐）。",
   "keywords": [
     "mcp",
     "mcp-server",
@@ -53,6 +53,7 @@
     "docs/RELEASE_NOTES_v2.8.8.md",
     "docs/RELEASE_NOTES_v2.8.9.md",
     "docs/RELEASE_NOTES_v2.9.0.md",
+    "docs/RELEASE_NOTES_v2.9.8.md",
     "docs/assets/",
     "docs/engines/",
     "cordis.patch.yml",
@@ -67,6 +68,9 @@
     "!**/*.pyc",
     "!sub-skills/**/__pycache__/**",
     "!sub-skills/**/*.pyc",
+    "!sub-skills/**/tests/**",
+    "!sub-skills/**/references/**",
+    "!assets/readme/*.webp",
     "!data/jobs"
   ],
   "dsh": {

package/packages/dsh-plugin/README.md

@@ -8,7 +8,25 @@ DeepSeek Harness 插件：一行同时挂上 [Argo](https://github.com/taxueseek
 dsh plugin --profile web add "github:taxueseek/argo#main&path:packages/dsh-plugin"
 ```
 
-重启 `dsh web` 后生效。本 bundle 提供 **三形态接入**——同一套 argo 检索能力（同引擎、同压缩、同守卫），三种调用通道互为冗余，按宿主能力自动降级：
+重启 `dsh web` 后生效。
+
+### 本地开发：改完源码必须同步进 profile
+
+profile 里的依赖是 `file:` / `github:`，pnpm 安装时**复制**进
+`node_modules/@taxueseek/argo-dsh`，不是软链。只改本仓源码、不跑同步，
+DSH 设置页读到的仍是旧 bundle（2026-10-22 实测：缓存开关与付费额度已改，
+面板仍显示旧版）。
+
+```bash
+packages/dsh-plugin/scripts/sync-local.sh --check    # 比对源码与已安装 bundle
+packages/dsh-plugin/scripts/sync-local.sh            # 同步 web/desktop
+packages/dsh-plugin/scripts/sync-local.sh --restart  # 同步并重启 dsh web
+```
+
+同步会先备份到 `~/.dsh/backups/argo-dsh-sync-<时间>-<profile>`；浏览器如仍显示
+旧面板，做一次硬刷新（Cmd+Shift+R）。
+
+本 bundle 提供 **三形态接入**——同一套 argo 检索能力（同引擎、同压缩、同守卫），三种调用通道互为冗余，按宿主能力自动降级：
 
 - **原生一等工具**（默认开）：`argo_search` / `argo_fetch`（`ctx.tools.register`），走 CLI 单发（`--call`）复用 MCP 同一套引擎与守卫，**不依赖 MCP 连接、零常驻 token 开销**；`nativeTools: []` 关闭
 - **原生 web seam**（默认开）：注册 `argo` 搜索与抓取两个 provider，宿主内置 `web_search` 路由到 argo 引擎链、`web_fetch` 走 argo 抓取链（HTTP 优先，遇 Cloudflare/JS 渲染自动升级反检测浏览器）；`searchProviderEnabled: false` / `fetchProviderEnabled: false` 时对应 provider 注册但不可选
@@ -29,7 +47,7 @@ dsh plugin --profile web add "github:taxueseek/argo#main&path:packages/dsh-plugi
 
 - **接入**：`web_search` / `web_fetch` seam 开关；引擎入口命令与参数（npx 或本机 `mcp_server.py`）；搜索/抓取超时、正文上限、连接空闲回收、并发连接数
 - **工具**：18 个原生一等工具的勾选（默认只开 `argo_search` / `argo_fetch`）；单次调用超时与返回文本上限
-- **引擎**：argo 本体的行为开关（原环境变量，curated 白名单 28 个：缓存 / TF-IDF 重排 / 数值交叉校验 / MinHash 去重 / SERP 守卫、Jina / 移动端 UA / Parallel 抓取层、语义证据层、对冲宽限与尾宽、引擎启停名单、代理、本机检索根与读取白名单、预热 / 使用日志 / 连接池 / 各类 TTL）。开关类即时生效，数字 / 文本 / 名单类分组保存；未配置行显示 argo 默认态并标注「默认」。授权类开关（可复算执行、内网 URL）刻意不进面板
+- **引擎**：argo 本体的行为开关（原环境变量，curated 白名单 35 个，分八组：缓存与排序 / 抓取层 / 语义与自适应 / 引擎启停 / 网络出口 / 本机检索 / **额度与预算** / 其他）。「缓存与排序」组第一项是**测试模式（关闭结果缓存）**，默认关、日常结果缓存 1 小时；只有改进 Skill/插件、需要实时结果时才打开。「额度与预算」组把免费与付费源放在同一套 QuotaManager 下：金额计费的源设月度预算（DeepSeek 元 / Exa 美元），按次数限额的源设日/月次数上限（AnySearch / 知乎按日，元宝默认 2000/月、Tavily 按月）；博查按量付费，不设固定次数上限，由服务商侧结算。额度或预算用尽后该源自动跳过并回落免费源。开关类即时生效，数字 / 文本 / 名单类分组保存；未配置行显示 argo 默认态并标注「默认」。授权类开关（可复算执行、内网 URL）刻意不进面板
 - **密钥**：常用引擎 key 的填写、更新、清除；显示「已配置 / 未配置 + 来源层（凭证库 / 启动环境 / .env）+ 只读态」，明文不回显；每行可勾选「转发」，等价于把引用名加进 `keyRefs`
 - **研究**：worker / 轨道 / 每轨信源 / token 上限与报告落盘目录
 - **高级**：worker 工具 allow / deny 名单、凭证转发名单
@@ -70,7 +88,7 @@ argo 的 `deepseek_search` 引擎（官方 `api.deepseek.com/v1/tools/search`，
 - 安全：插件不读 key 文件、不落盘、不打日志；key 值只经内存进入 argo 子进程 env，任何输出与错误信息都不含它
 - 旧宿主无 credentials 服务时静默跳过：argo 侧该引擎按缺 key 停用，其余 265 个源不受影响
 - `keyRefs: []` 可整体关闭转发；后续要转发别的宿主凭证（如 `ARGO_EXA_API_KEY`），把引用名加进数组即可，entry 必须是 POSIX 标识符（apply 期 loud fail）
-- `argoEnv`（设置页「引擎」分区写入）：argo 行为开关，一行一个 `KEY=VALUE`，名字限 curated 白名单（index.js 的 `ARGO_ENV_SPECS`，28 个；白名单外 apply 期 loud fail，防拼错静默失效）；授权位与路径 / 状态类变量刻意不收。与 `keyRefs` 的分工：`keyRefs` 管密钥（凭证库），`argoEnv` 管行为开关（插件配置），两者都不落明文
+- `argoEnv`（设置页「引擎」分区写入）：argo 行为开关，一行一个 `KEY=VALUE`，名字限 curated 白名单（index.js 的 `ARGO_ENV_SPECS`，35 个；白名单外 apply 期 loud fail，防拼错静默失效）；授权位与路径 / 状态类变量刻意不收。与 `keyRefs` 的分工：`keyRefs` 管密钥（凭证库），`argoEnv` 管行为开关（插件配置），两者都不落明文
 
 ## 依赖
 
@@ -83,8 +101,8 @@ argo 的 `deepseek_search` 引擎（官方 `api.deepseek.com/v1/tools/search`，
 
 | argo-dsh | DSH Harness | 说明 |
 |----------|-------------|------|
-| 2.9.7（当前） | 0.2.1-rc.2（当前，运行中） | 自带设置页（接入 / 工具 / API 密钥 / 研究 / 高级）；双栈入口 `startActivation({provider, label, request, signal, delivery})`；rc.2 移除 `toolFilter` 启动期字段后由插件内 tool guard 阻止 worker 嵌套调用 `wide_research`；`wide_research` 端到端实测通过（planner → 2 worker → synthesis，passed=true / 14 sources） |
-| 2.9.7（当前） | 0.2.1-alpha.1（实测，兼容） | 旧宿主走 `start(provider, request)` 分支，`toolFilter` 启动期字段仍认；该分支由插件单测覆盖，未在 alpha.x 上重跑端到端 |
+| 2.9.8（当前） | 0.2.1-rc.2（当前，运行中） | 自带设置页（接入 / 工具 / API 密钥 / 研究 / 高级）；双栈入口 `startActivation({provider, label, request, signal, delivery})`；rc.2 移除 `toolFilter` 启动期字段后由插件内 tool guard 阻止 worker 嵌套调用 `wide_research`；`wide_research` 端到端实测通过（planner → 2 worker → synthesis，passed=true / 14 sources） |
+| 2.9.7（上一版，兼容） | 0.2.1-alpha.1（实测，兼容） | 旧宿主走 `start(provider, request)` 分支，`toolFilter` 启动期字段仍认；该分支由插件单测覆盖，未在 alpha.x 上重跑端到端 |
 | 2.9.2 | 0.2.1-alpha.1（实测） | 上一轮适配验证基线；rc.2 的新入口与 tool guard 自 2.9.4 起进入 |
 
 低于 0.2.1 的 Harness 未做验证，不保证可用。