argo-search 2.9.8 → 2.9.9

package/README.md

@@ -24,7 +24,7 @@
 <p align="center">
   <img alt="license" src="https://img.shields.io/badge/license-Apache_2.0-blue">
   <img alt="python" src="https://img.shields.io/badge/python-3.9+-green">
-  <img alt="version" src="https://img.shields.io/badge/version-2.9.8-informational">
+  <img alt="version" src="https://img.shields.io/badge/version-2.9.9-informational">
   <img alt="engines" src="https://img.shields.io/badge/engines-272-orange">
   <img alt="mcp" src="https://img.shields.io/badge/MCP-19%20tools-purple">
 </p>
@@ -57,7 +57,8 @@ Argo 的能力通过四个子技能（sub-skills）组织，每个子技能是
 Argo 同时是 DeepSeek Harness 的插件，一行命令装好：
 
 ```bash
-dsh plugin --profile web add "github:taxueseek/argo"
+dsh plugin --profile web add argo-search                  # npm 发布版
+dsh plugin --profile web add "github:taxueseek/argo"      # GitHub main
 ```
 
 装完重启 `dsh web` 即生效。搜索和抓取成为原生一等工具，不依赖 MCP 连接，不占常驻上下文开销。另有 1 个 `wide_research` 并行研究和 19 个 MCP 工具按需开启。完整接入形态见下文。
@@ -144,8 +145,10 @@ dsh plugin --profile web add "github:taxueseek/argo"
 # 方式一：一键脚本（推荐本机长期用）
 curl -fsSL https://raw.githubusercontent.com/taxueseek/argo/main/scripts/install.sh | bash
 
-# 方式二：npx 即用即走（推荐 Agent 快速挂载）
-npx -y github:taxueseek/argo
+# 方式二：npm / npx（已支持，当前 2.9.9；按 tag 发布，版本固定）
+npm install -g argo-search      # 全局安装 CLI
+npx -y argo-search              # 或即用即走，不装
+npx -y github:taxueseek/argo    # 要跟 main 最新提交时用这条
 
 # 方式三：git clone（开发 / 改源码）
 git clone https://github.com/taxueseek/argo.git
@@ -174,7 +177,7 @@ Argo 支持四种接入方式，按你的场景挑：
 | **MCP Server** | Agent 常驻挂载 | 19 个检索工具随时可用，一条命令注入 Claude Code / Cursor / Windsurf / Codex / OpenCode / Cline，写配置前自动备份 |
 | **DSH 插件** | DeepSeek Harness 用户 | 一行 `dsh plugin add` 装好，搜索和抓取成为原生一等工具，不依赖 MCP 连接，不占常驻上下文开销；自带六分区设置页，改完即生效 |
 | **Skill 文件** | Claude Code / Grok Build / Kimi 等 | 技能包装进 Agent 的技能目录，你说「帮我查一下」「核实一下」，它自己去查 |
-| **npx 即用即走** | 快速试一下 | `npx -y github:taxueseek/argo`，不用装，适合临时把 MCP 挂进任意客户端 |
+| **npx 即用即走** | 快速试一下 | `npx -y argo-search`（npm 发布版）或 `npx -y github:taxueseek/argo`（main），不用装，适合临时把 MCP 挂进任意客户端 |
 
 四种形态底层是同一套 Python 代码，CLI 与 MCP 工具一一对应，装哪种都不缺能力。
 
@@ -279,7 +282,7 @@ freshness  ≈ 发布时间（会忽略「2015 年以来」这类历史对比年
 
 ## 快速开始
 
-任选一种即可。**以 GitHub 为唯一安装来源**（`npx github:taxueseek/argo` 或 `install.sh` / `install.ps1`），当前推荐 **v2.9.8**。**请勿用 `npm install argo-search`**——npm registry 上那份是**非官方陈旧版 v1.0.1**（非本仓库维护，功能残缺、不随本项目更新）。本包 `package.json` 已设 `private: true` 防止误发布到 npm registry。
+任选一种即可。**npm 安装已支持，当前版本 2.9.9**，与 GitHub 同为本仓库发布。npm 路线用 `npm install -g argo-search` 或 `npx -y argo-search`，按 tag 发布、版本固定、下载体积更小；GitHub 路线用 `install.sh` / `install.ps1` 或 `npx github:taxueseek/argo`，跟 main 走。之后每次打 tag，CI 会把两个 npm 包和 GitHub Release 一起发出；registry 上更早的 v1.0.1 是历史版本，不要锁定到它。
 
 **零配置就能跑**：不配 API Key 时走免费引擎 + 本地 `local_*` 引擎；配了 Key 的源质量通常更好，没配则自动跳过。
 
@@ -344,9 +347,11 @@ npx -y github:taxueseek/argo
 
 ```bash
 # 装法 A：19 个 mcp__argo__* 工具（主包自带 bundle，与 MCP 全量相同）
-dsh plugin --profile web add "github:taxueseek/argo"
+dsh plugin --profile web add argo-search                  # npm 发布版
+dsh plugin --profile web add "github:taxueseek/argo"      # GitHub main
 
 # 装法 B：搜索工具 + wide_research 并行研究调度（子包）
+dsh plugin --profile web add @taxueseek/argo-dsh          # npm 发布版
 dsh plugin --profile web add "github:taxueseek/argo#main&path:packages/dsh-plugin"
 ```
 
@@ -491,7 +496,7 @@ python3 -m pytest tests/test_unit.py -q             # 单测（可选）
 | `deep` | 调研、综述 | 质量优先，可多用引擎 |
 | `budget` | 额度紧 | 配额控制，用完降级 |
 
-### 当前大致能力（v2.9.8）
+### 当前大致能力（v2.9.9）
 
 Argo 干的事，一句话能说完：把一个问题按领域和语言分给合适的源，取回结果后按可信度排个序，交回给 Agent 的是能排序、能复核的材料。搜索、抓取、核验、本机文件检索走同一条管线，19 个 MCP 工具和 CLI 命令一一对应，装哪种形态都不缺能力。另有几个单点命令随用随取：argo tweet 打包 X 帖子，argo auth 管登录态，argo job 聚合招聘信息。
 
@@ -499,6 +504,8 @@ Argo 干的事，一句话能说完：把一个问题按领域和语言分给合
 
 最近几个版本各修了一类问题。
 
+v2.9.9 做的是安全与交付质量。内容安全引擎原先只评分不拦截，高风险注入页照样进上下文；现在评分过阈值就隔离，用清洗后的正文替换原文，也不再进核验证据。网络出口补了两道纵深：重定向逐跳校验，DNS 解析结果钉死在当次连接上。调度侧，早停弃置的慢源交付不再丢弃：转后台收割，三秒内完成的照常交付并记进学习器。路由上，六族真实场景扫描收了五类误路由，A 股财务查询、企业尽调/开票/人查公司、民事实务、药品说明书、论文写作 howto 各归其位。另有 argo engine add 一键接入新引擎，DSH 设置页新增路由观测卡片与工具推荐组合。
+
 v2.9.8 做的是路由精度与反馈闭环。issue #18 报告的三件事——「latest」被误判进实时新闻、人民网匹配不到时回默认 feed、local_bing 只命中「2026」——都已复现并修掉；顺着这条线回放真实查询，又把 16 类同类误触发收窄：品牌名里的「雪」、产品名里的「火山引擎」、UI 排障里的「图标」、工商与金融字段里的「代码」、代码语境里的「汇率」等。SERP 覆盖率门与 CJK 交叉验证同时落地，避免「有结果就算相关」。感谢 @wpp666 提供的复现与定位。
 
 v2.9.7 修的是三个老毛病。DSH 宿主里的 AI 要读一个网址时，走的是宿主自带的抓取，短链跳转和 JS 挑战页经常直接失败，argo 的抓取链根本用不上；这版把宿主的读网址接到 argo 上，这类页面从失败变成成功，普通页面没有变化。路由候选池里原先混着 18 个「只能显式指定」的引擎，万一被自动选中，唯一的付费引擎就会悄悄扣费；如今候选池里没有它们，要用必须写明白。引擎每成功一次，熔断器都要加锁重写一次磁盘；健康状态下这版已经零文件开销，多个引擎的记账也合并成一笔事务。开源协议同时从 MIT 换成了 Apache-2.0，公司商用更放心。
@@ -766,13 +773,23 @@ argo/
 
 只列最近三个版本。完整历史见[版本记录](#版本记录)，逐版详情见 [Releases](https://github.com/taxueseek/argo/releases)。
 
-### 下一版：腾讯元宝搜索 + 免 key 三源 + 结构化失败清单
+### v2.9.9：安全纵深 + 慢源交付不丢 + 五类误路由收口
+
+- **高风险正文进不了上下文**：内容安全引擎从「只评分」升级为「隔离+清洗替换」，`risk_score ≥ 0.5` 的正文被清洗后正文替换、不进证据分；默认开，`ARGO_CONTENT_RISK_GATE=0` 应急放行
+- **网络出口纵深防御**：重定向逐跳校验（`ARGO_MAX_REDIRECTS`，默认 5）+ 解析即锁定，封堵 DNS 重绑定窗口
+- **早停弃置的慢源交付不再丢**：弃置引擎转后台收割，`ARGO_TAIL_COMPLETE_S`（默认 3s，0=关）内完成即照常交付并记真实成绩，交付去重合并回缓存
+- **五类误路由收口**：A 股财务查询进 `stock_query`、企业尽调/开票/人查公司进 `company_search`、民事实务进 `flk_law`、药品说明书不再被「用法」抢走、论文写作 howto 不再落学术域
+- **`argo engine add`**：新引擎一键接入，spec/env/验证/同步/combo/白名单的人工多步链编排成一步
+- **场景分桶学习 + ZCode 插件包**：路由能区分「引擎在 A 域强、B 域弱」；skill+CLI 直连与零 token 面板进 zcode-plugins
 
-- **新增元宝搜索**：中文一手 / 官方口径源，与 bocha、byted 的「门户 + 自媒体」互补；进中文通用域第 2 位做权威源对冲；key 用 `ARGO_YUANBAO_API_KEY`
-- **免 key 可用面再扩三源**：`tavily_free`、`keenable_free`、`exa` 匿名回退，不配任何 key 也能用
-- **失败能照着处置**：失败按来源与类别给出「可重试 / 换源 / 去配 key」与建议，结果同时带 `meta.uncertainty` 综合可信度
-- **本机配置覆盖层 `config.local.yaml`**：本机调优不再写进随版发布的公共配置
-- **DSH 设置页新增「引擎」分区**：argo 本体的 28 个行为开关从环境变量搬进面板
+### v2.9.8：路由精度审计 + 腾讯元宝搜索 + 免 key 三源 + 结构化失败清单
+
+- **issue #18/#19 全修**：`latest` 误判实时新闻、人民网默认 feed、local_bing 只命中「2026」、中文交叉验证恒 0、nightly 空日志崩溃；顺线收窄 16 类同构误触发
+- **新增元宝搜索**：中文一手/官方口径源，进中文通用域第 2 位做权威源对冲；key 用 `ARGO_YUANBAO_API_KEY`
+- **免 key 可用面扩三源**：`tavily_free`、`keenable_free`、`exa` 匿名回退，不配 key 也能用
+- **失败能照着处置**：失败按来源与类别给出「可重试/换源/去配 key」，结果带 `meta.uncertainty` 综合可信度
+- **本机配置覆盖层 `config.local.yaml`**：本机调优不再写进公共配置
+- **DSH 设置页新增「引擎」分区**：28 个行为开关从环境变量搬进面板
 
 ### v2.9.7：架构收口 + 宿主网页抓取交给 argo + License 转 Apache-2.0
 
@@ -782,20 +799,13 @@ argo/
 - **换新 key 下一跳就恢复**：配额耗尽的引擎不再等恢复窗口到点，路由缓存同步重算
 - **crawl / research / MCP 里跑 JS 不再崩**
 
-### v2.9.6：DeepSeek Search 接入 + 查询操作符 + 传输层去重付费
-
-- **新增 `deepseek_search` 官方引擎**：延迟 445-510ms，权威分级 / rerank_score / 发布时间三项唯一全覆盖，`--since/--until` 时间窗真正生效；按次计费，需自备 `DEEPSEEK_API_KEY`，无 key 自动跳过
-- **查询操作符收敛为契约层**：`site:` / `-site:` / `-词` / `lang:` / `after:` / `before:` 统一处理，`site:` 做真正的后置过滤
-- **同一个 POST 不再重复付费**：连接池复用，同连接第二次请求省 320ms（anysearch）/ 561ms（octen）
-- **两处取链与排序缺陷修复**：同引擎结果同分导致输出退化；Bing 跳转壳不还原导致近 7 天 40.2% 查询空手而归
-- **路由决策有了快照门**：路由翻转变成可 diff 的 golden，不再静默变脸
-
 ---
 
 ## 版本记录
 
 | 版本 | 说明 |
 |------|------|
+| **v2.9.9** | **安全纵深 + 慢源交付不丢 + 五类误路由收口**：高风险正文隔离+清洗替换（不进证据分）、逐跳重定向校验与 DNS 重绑定封堵；早停弃置的慢源转后台收割（`ARGO_TAIL_COMPLETE_S`），学习器记真实成绩；六族真实场景扫描收口学术/财务/企业/法律/医药误路由；`argo engine add` 一键接引擎、场景分桶学习、ZCode 插件包。详见 [发布说明](docs/RELEASE_NOTES_v2.9.9.md) |
 | **v2.9.8** | **路由精度审计 + issue #18/#19 修复 + 测试态隔离**：回放真实查询收窄 16 类误触发（品牌名/产品名/字段名/ASCII 子串），SERP 覆盖率门与 CJK 交叉验证落地；nightly 空日志、people_daily 默认 feed、缓存命中守卫一并收口；全量测试按用例隔离 adaptive/熔断状态。感谢 @wpp666 的复现与定位。详见 [发布说明](docs/RELEASE_NOTES_v2.9.8.md) |
 | **v2.9.7** | **架构收口 + DSH web_fetch 占位 + License 转 Apache-2.0**：宿主 web_fetch 改走 argo 抓取链，JS 挑战页与跨源跳转从失败变成功；18 个 explicit_only 引擎从路由候选池剔除，堵住 auto 档误调付费引擎扣费；熔断、记账、配额恢复与路由缓存一批状态契约收口。 |
 | **v2.9.6** | **DeepSeek Search 接入 + 查询操作符契约 + 传输层去重付费 + 路由快照门**：新引擎 `deepseek_search` 默认启用（445-510ms，权威分级 / rerank_score / 时间窗唯一全覆盖）；查询操作符收敛为契约层；POST 连接池复用省 320-561ms/次；路由决策变成可 diff 的 golden。 |

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: argo
 description: Argo 阿尔戈 — 统一搜索、网页抓取与证据核验。当需要搜索/查一下/核实/抓取网页/爬取/深度研究/论文检索/新闻/舆情/公众号文章/招聘聚合时使用；支持影视/体育/金融/宏观/学术等垂直域与多语言查询。
-version: 2.9.8
+version: 2.9.9
 triggers:
   - 搜索
   - 查一下

package/bin/argo

@@ -658,6 +658,10 @@ 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 启动时读取并强制执行

package/bin/argo.js

@@ -51,7 +51,7 @@ if (argv[0] === '-v' || argv[0] === '--version') {
     const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
     console.log(pkg.version);
   } catch (_) {
-    console.log('2.9.8');
+    console.log('2.9.9');
   }
   process.exit(0);
 }

package/config.yaml

@@ -197,7 +197,13 @@ domains:
   name: us_fundamentals
   parallel: false
   patterns:
-  - (?i)(营收|营业收入|净利润|净利|利润|财务数据|财务指标|annual\s+revenue|revenue|net\s+income|earnings|financials|fundamentals|balance\s+sheet|资产负债表|现金流|cash\s+flow|\bEPS\b|每股收益|总资产|总负债|毛利)
+  # 2026-10-25 补 unless：zh 词形的财务查询一律让位 stock_query（sina/eastmoney
+  # 对 A/US 两地上市都能交付，sec_companyfacts 只认 CIK，宁德时代这类 A 股
+  # 企业落本域全废）——与「XX 股价」既有分流约定同构：zh 词走 stock_query，
+  # 英文词形或美股语境才进本域。与 stock_query 新增的财务 pattern 成对出现，
+  # 改一处必须同步另一处。
+  - match: '(?i)(营收|营业收入|净利润|净利|利润|财务数据|财务指标|annual\s+revenue|revenue|net\s+income|earnings|financials|fundamentals|balance\s+sheet|资产负债表|现金流|cash\s+flow|\bEPS\b|每股收益|总资产|总负债|毛利)'
+    unless: '(?i)(A股|沪深|沪市|深市|上证|深证|北交所|创业板|科创板|年报|季报|财报|营收|营业收入|净利润|净利|利润|财务数据|财务指标|资产负债表|现金流|每股收益|总资产|总负债|毛利)'
   primary: sec_companyfacts
 
 - desc: 美股筛选/分析（Finviz + Seeking Alpha；须排在 stock_query 前，避免「美股/ticker」被 A 股域吸走）
@@ -235,6 +241,15 @@ domains:
   - (?i)(\bstock\b|stock price|share price|market\s+cap)
   - A股|港股|股票|ETF|板块
   - (资金流|主力资金|北向|龙虎榜|大宗交易|换手率)
+  # 2026-10-25 补：财务数值/估值类。A/US 分流沿用「XX 股价」既有约定——
+  # zh 词且无美股标记进本域（sina/eastmoney 双地覆盖），美股标记与 10-K
+  # 让位 us_*。裸「财报/年报」是披露浏览归 financial_news（「英伟达 财报」
+  # 是双向锁既有约定），本域只收数值/估值词形；howto（怎么写年报/模板）
+  # 让位通用域。实测 A 股企业「年报 营收」「市盈率 估值」此前分别落
+  # us_fundamentals 与 chinese_general。us_fundamentals 同日加了对应的
+  # zh 词形 unless，两处成对。
+  - match: '(?i)(营收|营业收入|净利润|净利|利润|毛利率|市盈率|市净率|股息率|净资产收益率|\bROE\b|估值|现金流)'
+    unless: '(?i)(美股|NASDAQ|NYSE|纳斯达克|标普|10-?[KQ]|\bSEC\b|EDGAR|怎么写|模板|格式|范文|入门|公告)'
   primary: sina_quote
   quote: true
   early_stop_min_results: 1
@@ -845,7 +860,10 @@ domains:
   parallel: false
   patterns:
   - (?i)\b(LLM|GPT|Claude|Gemini|GLM|Llama|Mistral|DeepSeek|Qwen|Grok)\b
-  - (?i)(模型|model).{0,24}(价格|pricing|多少钱|上下文|context|token|支持视觉|vision|能力|对比|免费|开源)
+  # 2026-10-25 补 unless：综述/论文语境让位给 tech_deep（openalex/arxiv）——
+  # 实测「大模型 长上下文 综述」被本域 models_dev 抢走，模型目录答不了综述。
+  - match: '(?i)(模型|model).{0,24}(价格|pricing|多少钱|上下文|context|token|支持视觉|vision|能力|对比|免费|开源)'
+    unless: '(?i)(综述|survey|论文|文献|研究进展|预印本|state\s+of\s+the\s+art|SOTA)'
   - (?i)(API price|pricing|context window|token limit|vision model|tool call)
   # 点查域意图豁免词（语义见 route_domains.intent_required）
   # 扩展（2026-10-06）：意图门 token 门槛降到 4 后，4 token 的真点查
@@ -883,6 +901,12 @@ domains:
   # 「裁判文书 判决书」落本域用 anysearch/byted 搜，而 wenshu 才是裁判文书权威源。
   - match: '(?i)(刑法|民法|司法解释|判例|法规|裁判文书|案由|案号|法院判决)'
     unless: '(?i)(裁判文书|判决书|裁定书|wenshu|court\.gov)'
+  # 2026-10-25 补：民事实务类（劳动/借贷/婚姻家事/侵权赔偿）——实测
+  # 「劳动合同解除 赔偿」「民间借贷 利率 司法保护上限」落 chinese_general，
+  # 而 flk_law/anysearch 能交付法条与实务口径。unless 锁求职（岗位/薪资）
+  # 与模板下载形态。
+  - match: '(?i)(劳动合同|工伤|民间借贷|借贷纠纷|借贷利率|婚姻|离婚|继承|遗产|侵权责任|交通肇事|仲裁申请|赔偿金|经济补偿|竞业限制)'
+    unless: '(?i)(岗位|招聘|薪资|待遇|面试|简历|模板|范文|下载)'
   primary: anysearch
 - desc: 裁判文书检索
   engines_combo:
@@ -924,6 +948,11 @@ domains:
   - (?i)(临床试验|clinical trial|nct\d+|clinicaltrials\.gov|openfda|fda 药品|药品说明书|药物标签|drug label|适应症|不良反应)
   - (?i)(medicine|pharmaceutical|dosage|contraindication|药物|药品|处方药|\botc\b)
   - (?i)(症状|用药|适应症|临床|临床指南|诊疗指南|医学指南|用药指南|治疗指南|副作用|禁忌|诊断|治疗|病因)
+  # 2026-10-25 补：药品说明书/用法用量类——实测「某药 说明书 用法用量」被
+  # code_search 的「用法」子串抢走（GitHub/MDN 答不了药）。unless 锁软件/
+  # 硬件语境的说明书。code_search 同日加了对应药品语境 unless，两处成对。
+  - match: '(?i)(说明书|用法用量|服用剂量|一次吃多少|一天几次)'
+    unless: '(?i)(软件|硬件|固件|安装|接口|\bAPI\b|\bAPP\b|app|产品说明)'
   - '(?i)(WHO|世界卫生组织).{0,12}(通报|疫情|卫生|指标|统计)'
   - '(?i)(公共卫生|卫生指标|疾病负担|死亡率|发病率|卫生统计)'
   primary: clinicaltrials
@@ -1174,8 +1203,12 @@ domains:
   # 2026-10-14 +股东尽调词：求职查询（岗位/招聘/薪资）与尽调查询（股东/持股/
   # 实控人/融资/股权）都不应命中本域——前者是招聘文案，后者 wikidata 无中国
   # 民企股东数据（实测 1.8s 只拿到两字「公司」）。
+  # 2026-10-25 再补让位词：注销/吊销/经营异常/行政处罚/开票/税号（尽调风险与
+  # 开票类）与 担任法定代表人/名下公司（人查公司反向）——这些形态此前落本域
+  # wikidata 组合，对中文企业同样全废（合成名实测四类全误投，wikidata 7 天
+  # 空结果率 82%），company_search 的元宝才是中文交付源。
   - match: '(?i)(股份有限公司|有限公司|集团|控股|总部|成立于|创立于|创办于|创始人|CEO|董事长|市值|子公司|母公司)'
-    unless: '(?i)(岗位|职位|招聘|薪资|待遇|面试|简历|JD|工作内容|任职要求|岗位要求|股东|持股|实控人|融资|股权|注册资本|工商登记|统一社会信用代码|社会信用代码|信用代码|法定代表人|经营范围|注册号|企业信息|工商信息)'
+    unless: '(?i)(岗位|职位|招聘|薪资|待遇|面试|简历|JD|工作内容|任职要求|岗位要求|股东|持股|实控人|融资|股权|注册资本|工商登记|统一社会信用代码|社会信用代码|信用代码|法定代表人|经营范围|注册号|企业信息|工商信息|注销|吊销|经营异常|行政处罚|开票|税号|担任法定代表人|名下公司)'
   - (?i)(创办年份|成立年份|创立年份|建校年份|成立时间|创办时间|创立时间|建校时间|何时成立|何时创办|何时创立)
   - (?i)(大学|学院|研究所|科学院|研究院).{0,12}(创办|成立|创立|建校)
   - (?i)\b([A-Z][A-Za-z0-9&.\- ]{1,40}\s+(Inc\.?|LLC|Ltd\.?|Corp\.?|Co\.|GmbH|S\.A\.|PLC))\b
@@ -1329,7 +1362,11 @@ domains:
   # 中文论文语境词此前是缺口：规则里有英文 preprint，却没有「预印本」。
   # 实测「生物医学预印本」因此一个域都不命中，掉进通用兜底（combo 变成
   # bocha+anysearch），biorxiv/openreview 这些已实现的源永远轮不上。
-  - (?i)(论文|\bpaper\b|预印本|preprint|arXiv|bioRxiv|medRxiv|DOI|引用|citation|学术|文献|期刊|学报|综述|同行评议|影响因子|openalex|crossref|europe pmc|dblp|PubMed|知网|万方|维普)
+  # 2026-10-25 补 unless：论文写作/评审的 howto 形态（怎么写/查重/盲审/开题）
+  # 不是找论文——实测两类都落本域，arxiv 答不了写作技巧。只否决这一条，
+  # 「综述 论文」等真检索语境不受影响。
+  - match: '(?i)(论文|\bpaper\b|预印本|preprint|arXiv|bioRxiv|medRxiv|DOI|引用|citation|学术|文献|期刊|学报|综述|同行评议|影响因子|openalex|crossref|europe pmc|dblp|PubMed|知网|万方|维普)'
+    unless: '(?i)(怎么写|查重|降重|盲审|开题|致谢|选题|范文|抄袭|写作技巧|参考文献格式)'
   - \b\d{4}\.\d{4,5}\b
   # 2026-09-30：模型名词表拆成独立条目并挂 unless。此前裸 (?i)...|BERT|GPT)
   # 是子串匹配，「chatgpt 使用技巧」「如何用 GPT 写周报」「gpt-5 发布」这类
@@ -1407,7 +1444,10 @@ domains:
   # 裸「开源」太宽：品牌/产品句（「雪原 开源 投研 搜索工具」）也会
   # 命中，GitHub 慢源要 7s 且只回一条。只收「开源项目/代码/仓库/库/软件/
   # 框架」这类明确指向代码仓库的说法；有 github/源码 的查询仍走本域。
-  - (?i)(github|source code|源码|开源\s*(项目|代码|仓库|库|软件|框架)|函数|实现|用法|snippet)
+  # 2026-10-25 补 unless：药品语境让位 medical——「用法」子串会命中
+  # 「用法用量」（实测药品说明书查询被 GitHub/MDN 接走）。
+  - match: '(?i)(github|source code|源码|开源\s*(项目|代码|仓库|库|软件|框架)|函数|实现|用法|snippet)'
+    unless: '(?i)(用法用量|说明书|不良反应|禁忌|症状|服用|剂量|药品|药物)'
   # 「统一社会信用代码」是工商登记字段，不是代码搜索。拆出「代码」单条，
   # 让 company_search（更靠后）能接到这类查询。
   - match: '(?i)(代码)'
@@ -1586,6 +1626,13 @@ domains:
   parallel: false
   patterns:
   - (?i)(公司注册|注册号|统一社会信用代码|工商信息|股东|法人|注册资本|经营范围|尽调|工商登记|企业信息)
+  # 2026-10-25 补：尽调风险（注销/吊销/经营异常/行政处罚）、开票（开票信息/税号）、
+  # 人查公司（担任法定代表人/名下公司）三类。unless 锁住办事指南形态（流程/
+  # 怎么办/条件/材料…）——「公司注销流程 怎么办」是 howto 不是主体查询，合成名
+  # 双向锁用例见 matrix_search_eval ROUTE_MATRIX。org_entity 侧同日补了对应
+  # 让位词（见其 unless 注释），两类改动必须成对出现。
+  - match: '(?i)(注销|吊销|经营异常|行政处罚|开票信息|开票|税号|担任法定代表人|名下公司|实际控制人是谁)'
+    unless: '(?i)(流程|怎么办|如何|怎么办理|怎样|条件|材料|手续|多久|费用|办理|指南)'
   - (?i)(\bLEI\b|法人识别码|法人标识|法人主数据|legal\s+entity\s+identifier)
   - (?i)\b(company\s*registration|incorporation|registered\s+number|business\s+registry|company\s+search|corporate\s+records)\b
   - (?i)(会社|法人|登記|기업|법인|등록)

package/docs/ARGO_INTRO.md

@@ -6,7 +6,7 @@
 
 ## 安装方式
 
-> **唯一真实源是 GitHub。** 请用下面任一方式，勿用 `npm install argo-search`（npm registry 上那份是**非官方陈旧版 v1.0.1**，不随本项目更新）。
+> npm 安装已支持，当前版本 **2.9.9**。GitHub 与 npm 都由本仓库发布：GitHub 跟 main 走，npm 按 tag 发布、版本固定。
 
 ### 方式一：一键脚本（推荐本机长期用）
 
@@ -14,10 +14,12 @@
 curl -fsSL https://raw.githubusercontent.com/taxueseek/argo/main/scripts/install.sh | bash
 ```
 
-### 方式二：npx（不加装，即用即走）
+### 方式二：npm（已支持，当前 2.9.9）
 
 ```bash
-npx -y github:taxueseek/argo
+npm install -g argo-search    # 全局安装 CLI
+npx -y argo-search            # 或即用即走，不装
+npx -y github:taxueseek/argo  # 要跟 main 最新提交时用这条
 ```
 
 ### 方式三：给 Agent 挂 MCP

package/docs/RELEASE_NOTES_v2.9.9.md

@@ -0,0 +1,78 @@
+# Argo v2.9.9 发布说明
+
+**版本**：2.9.9
+**定位**：安全纵深 + 交付质量。三条主线：内容与网络出口的安全加固（高风险正文隔离、逐跳重定向校验、DNS 重绑定封堵）、调度与学习重构（早停弃置的慢源交付不再丢弃、场景分桶学习）、路由精度的六族真实场景扫描收口；另有 `argo engine add` 一键接入与 ZCode 插件包两个能力扩展。
+
+---
+
+## 这次更新有什么（通俗版）
+
+### 1. 高风险网页内容不再原样进上下文（风险门禁）
+
+**以前**：内容安全引擎只「评分」，`risk_score` 等元数据回传了，清洗后的正文却被丢弃——安全引擎只评分不门禁，高风险注入页照样进证据流水线与 Agent 上下文。
+
+**现在**：`risk_score ≥ 0.5`（阈值可调）的正文被隔离：用清洗后正文替换原始正文、标 `content_quarantined`、`content_ok=false`，且不进证据分（与 `--verify` 联动）。默认开启，`ARGO_CONTENT_RISK_GATE=0` 应急放行，`ARGO_CONTENT_RISK_THRESHOLD` 调阈值。
+
+### 2. 网络出口纵深防御
+
+**以前**：主抓取路径的内联重定向循环只校验第一跳，重定向到内网即可绕过 SSRF 防护；DNS 解析与 TCP 连接之间存在重绑定窗口。
+
+**现在**：
+
+- 重定向逐跳校验，跳数上限 `ARGO_MAX_REDIRECTS`（默认 5）
+- 解析即锁定：DNS 解析一次、过滤私网、把结果钉给本次 TCP 连接，堵住 check 与 connect 之间的 DNS 重绑定窗口；SNI/Host 仍用原域名
+- 数字 IP 字面量直接查表判定，不再依赖解析器；直连显式校验 TLS 上下文（`check_hostname` + `CERT_REQUIRED`）
+
+### 3. 早停弃置的慢源交付不再丢弃
+
+**以前**：74% 的查询发生早停，被放弃的交付 81% 来自 anysearch（相关度高于均线）；五条对照查询里四条唯一有结果的正是慢源。早停省的是等待，连交付一起丢是拿准确性换速度。
+
+**现在**：早停弃置的引擎转入后台收割，宽限窗内完成的照常交付（`ARGO_TAIL_COMPLETE_S`，默认 3 秒，0=关）：学习器记真实成绩（此前 cancelled 一律跳过，慢源真实表现从没进过学习器）、交付按 URL 去重合并写回 L2 缓存（同查询第二次免费拿全量覆盖）。CLI 输出先行、退出前等宽限，MCP/daemon 常驻进程自然收割；真超窗的 timeout 弃置不收。
+
+### 4. 路由精度：六族真实场景扫描，五类误路由收口
+
+按 97 域全景构造真实场景探针电池（目标类目 + 边界反例 + 既有域回归）离线实测，五类实锤全部按「让位 unless + 收口 match/unless 成对改动」修：
+
+- **学术**：论文写作 howto（怎么写/查重/盲审）不再落学术检索域；综述语境不再被 AI 模型域的「模型+上下文」抢走
+- **金融/财务**：A 股企业的年报/营收/毛利率/市盈率查询此前落只认 CIK 的 SEC 源（全空）——中文词形财务查询统一进 `stock_query`（sina/eastmoney 双地覆盖），英文词形与美股标记进美股域，美股域中文词形全部让位
+- **企业主体**：尽调风险（注销/吊销/经营异常/行政处罚）、开票信息、人查公司（法定代表人/名下公司/实际控制人）三类此前落 wikidata 组合（中文企业空结果率 82%）——统一收口进 `company_search`，「公司注销流程 怎么办」这类办事指南形态不误吸
+- **法律**：民事实务（劳动合同/工伤/民间借贷/婚姻/继承/侵权赔偿）进 `flk_law`，不再落通用域；岗位/薪资仍归求职
+- **医药**：药品说明书/用法用量不再被 code_search 的「用法」子串抢走（GitHub/MDN 答不了药）
+
+### 5. 遥测去污 + 权威源加权补表
+
+- 测试夹具引擎名三次绕过隔离写进生产使用日志——在唯一落盘口反向判定，注册表外引擎名的整条拒写；存量 63 条隔离留档。stats 均值 2295→1855ms，假引擎（slow/fast）从最慢榜消失，真实慢尾（skillsmp/anysearch）露出
+- 12 个学术聚合/官方一手源（core/sec_edgar/federal_register/eu_opendata/egov_law/openstd/who_gho/usgs/nasa_cmr=1.3，zenodo/datacite=1.2）补融合权重——此前独家交付却拿基线 1.0
+
+### 6. 调度层确定性重构
+
+时间读写统一走 `clock()`（测试注入虚拟时钟，生产回退 monotonic）；等待一律按剩余预算（deadline 语义）判断，单次轮询抖动不再累加；完成判据从 `Thread.is_alive()` 改为 `holder[done]`，消除「跑完最后一行到被观测之间」的误判窗口——调度类用例在全量套件里间歇性红的共同根因。
+
+### 7. 能力扩展
+
+- **`argo engine add`**：写 spec→设 env→验证→同步→改 combo→补白名单→补语料的人工多步链编排成一步。三档：`--from-yaml` 安装+验证+准入、`--from-url` 探测+生成模板、`--engine` 只补元数据；幂等、`--dry-run`、判不准的字段保守留空
+- **场景分桶学习**：自适应学习按 `(engine, domain, lang)` 分桶聚合，与全局分加权融合（桶样本 <3 权重 0.3，≥3 权重 0.5）——「引擎在 A 域强、B 域弱」从此可被路由区分，新引擎也能在建议域里被更快识别
+- **ZCode 插件包**：skill 与 CLI 白名单为主通道、零 token 面板（MCP 每轮注入清不掉的问题绕开），已进 [zcode-plugins#120](https://github.com/zai-org/zcode-plugins/pull/120)
+- **DSH 设置页**：新增路由观测卡片（只读本机 usage_log/route.jsonl 汇总最近路由决策，无日志不假装有数据）与工具推荐组合（按场景一键套用工具勾选）
+- **慢源质量实证**：尾宽 A/B 回放基准（2721 条真实日志离线回放）+ 实证文档 `docs/QUALITY_OF_SLOW_SOURCES.md`——缩全局尾宽是拿准确性换速度，正确方向是早交付+后台补全
+
+### 8. 离线评测自愈重入
+
+缺 PyYAML 的解释器跑离线评测时，config 会静默回落内置默认引擎集，route 段整片假红（同机实测 94 FAIL vs 197 全绿，差异全在解释器不在路由）。守卫升级为自愈重入：按 `ARGO_PYTHON` → PATH 上 python3.14/3.13/3.15/3.12 → python3 的候选序逐个真验 import，找到即 `execv` 重入；换无可换才报错并给修法。
+
+---
+
+## 验证
+
+- 全量 `python3.14 -m pytest -q` 退出码 0（4625 用例，少量平台性 skip）
+- pre-commit 七门（静态检查/体积门禁/开关总表/五语一致性/路由快照/上下文预算/引擎目录）全绿
+- 路由探针电池 30/30；matrix 离线评测绿 0 红（路由段 212 用例）
+- 早交付端到端实证：skillsmp 被弃置 990ms 后收割线程等到其 2205ms 完成交付，学习器落真实成绩
+- 真实查询复验：合成开票查询从 wikidata 空结果回到 company_search（元宝交付）；学术域 core 独家交付查询加权后排基线源之上
+
+## 兼容性
+
+- 无破坏性变更，v2.9.8 的配置与用法继续有效
+- 新增开关：`ARGO_TAIL_COMPLETE_S`（默认 3，0=关）、`ARGO_CONTENT_RISK_GATE`（默认开）、`ARGO_CONTENT_RISK_THRESHOLD`（默认 0.5）、`ARGO_MAX_REDIRECTS`（默认 5）
+- 两处金标随约定更新：中文财务词形期望统一进 `stock_query`；其余既有查询行为不变
+- 仓库版本号、五语 README、DSH 插件对照表统一到 2.9.9

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "argo-search",
-  "version": "2.9.8",
-  "description": "Argo 阿尔戈 — 统一搜索与证据核验。推荐 npx -y github:taxueseek/argo 或 install.sh 安装（不依赖 npm 发版）。多语言路由、272 个源（235 个免密钥开箱可用）、影视/体育/金融等垂直源、19 个 MCP 工具（与 CLI 能力面对齐）。",
+  "version": "2.9.9",
+  "description": "Argo 阿尔戈 — 统一搜索与证据核验。推荐 npx -y argo-search（npm 发布版）或 install.sh 安装。多语言路由、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.9.md",
     "docs/RELEASE_NOTES_v2.9.8.md",
     "docs/assets/",
     "docs/engines/",

package/packages/dsh-plugin/README.md

@@ -5,7 +5,8 @@ DeepSeek Harness 插件：一行同时挂上 [Argo](https://github.com/taxueseek
 ## 安装
 
 ```bash
-dsh plugin --profile web add "github:taxueseek/argo#main&path:packages/dsh-plugin"
+dsh plugin --profile web add @taxueseek/argo-dsh          # npm 发布版，已支持，当前 2.9.9
+dsh plugin --profile web add "github:taxueseek/argo#main&path:packages/dsh-plugin"  # GitHub main
 ```
 
 重启 `dsh web` 后生效。
@@ -101,7 +102,7 @@ argo 的 `deepseek_search` 引擎（官方 `api.deepseek.com/v1/tools/search`，
 
 | argo-dsh | DSH Harness | 说明 |
 |----------|-------------|------|
-| 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.9（当前） | 0.2.1-rc.2（当前，运行中） | 自带设置页（接入 / 工具 / API 密钥 / 研究 / 高级）新增路由观测卡片（getRouteHealth 只读本机 usage_log / route.jsonl 汇总最近路由决策，无日志不假装有数据）与工具推荐组合（按场景一键套用工具勾选，中英双语）；双栈入口 `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 起进入 |