面向 agent 的统一搜索与证据核验:120+ 引擎多语言路由,垂直域与结构化模态卡,10 个 MCP 工具与 wide_research 编排,fetch 核验回填证据分的证据闭环。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:taxueseek/argo#path:/packages/dsh-plugin
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
DeepSeek Harness 插件:一行同时挂上 Argo 搜索 MCP 和 wide_research 并行研究编排。
安装
版本号以仓库根 package.json 的 version 为准(与 argo --version、npm 上的 argo-search 同步),本文不复制版本号。
dsh plugin --profile web add @taxueseek/argo-dsh # npm 发布版
dsh plugin --profile web add "github:taxueseek/argo#main&path:packages/dsh-plugin" # GitHub main
@taxueseek/argo-dsh 是 DSH 插件包,argo-search 是 CLI 包,两者不能互换。安装由官方 plugin manager 应用;RC2 profile HMR 可同 PID 重组 bundle,默认保持同一个 DSH PID,不需要也不应默认重启 Host。本机 dsh CLI 只有 dsh plugin --profile <name> add|remove,没有 restart 子命令;activation-plan / restart-supervised 属于外部工作台 dshx(需单独安装,本机当前未装),不要把它们写成官方命令。激活证据要分开报:ARTIFACT_SYNCED、HOST_TREE_ACTIVE、CLIENT_LOADED、VISUAL_BEHAVIOR_VERIFIED;只看到安装成功、配置行、HTTP 200 或 boot manifest 都不算插件已生效。见 dsh-external-plugin-devkit/knowledge/contracts/live-activation.md。
本地开发:改完源码必须同步进 profile(改动收尾固定步骤)
profile 里的依赖是 file: / github:,pnpm 安装时复制进
node_modules/@taxueseek/argo-dsh,不是软链。只改本仓源码、不跑同步,
DSH 设置页读到的仍是旧 bundle(2026-10-22 实测:缓存开关与付费额度已改,
面板仍显示旧版;2026-11-08 复核:web 与 desktop 两个 profile 均已漂移)。
packages/dsh-plugin/scripts/sync-local.sh --check # 1. 比对源码与已安装 bundle,有漂移退出 1
packages/dsh-plugin/scripts/sync-local.sh # 2. 同步 web/desktop(只到 ARTIFACT_SYNCED)
sync-local.sh 只同步产物,输出 ARTIFACT_SYNCED; LIVE_ACTIVATION_UNPROVEN,不是插件生效证明;它没有 --restart 参数,也不该有。同步脚本存在的原因是本机依赖装成了 file:(pnpm 复制而非软链),而官方 dsh plugin add 对同路径的 file: 依赖会打印 Already up to date 不重拷,见 dsh-external-plugin-devkit/knowledge/pitfalls/file-copy-stale.md。
结构性修法:把 web 与 desktop profile 的依赖改成 link:(dsh plugin --profile <name> add "link:<packages/dsh-plugin 的绝对目录>"),源码直接可见,本脚本及其备份逻辑即可整体删除;这一步改的是本机 profile,需在宿主空闲时做并单独验证。改之前不要用 dsh plugin add "file:..." 冒充同步,它不会重拷。
官方明确禁止手改 profile node_modules 后直接串重启。激活要核对同 PID 的 Host 行与页面功能;本机没有 activation-plan,装了 dshx 工作台才可用,且它是外部工具,不是 dsh 的一部分(本机当前未装)。
改完源码或文档后,必须跑到 sync-local.sh --check 输出 [ok] 才算交付完成;不适用 --check 的场景(例如只改仓库内文档、不影响已安装 bundle)要在交付说明里写明跳过理由。同步会先备份到 ~/.dsh/backups/argo-dsh-sync-<时间>-<profile>;浏览器如仍显示旧面板,做一次硬刷新(Cmd+Shift+R)。
当前启用状态(web profile)
wide_research 编排、原生 argo_search / argo_fetch 与 web 服务行的 searchProvider: argo 已在用户层 ~/.dsh/profiles/web/cordis.patch.yml 默认启用,无需取消任何注释即可使用。profile patch 里 mcp-argo 段注释掉的「按需开启」只针对 MCP 完整工具面,不代表整个插件未启用。
该 patch 的 fetchProviderEnabled: false 是主动关闭 fetch seam,因此 web 服务行不 pin fetchProvider;若改为启用 fetch seam,必须按本文「web seam 的 pin 必读」一节在 web 服务行加 fetchProvider: argo,否则多个可用 provider 会触发 WEB_PROVIDER_AMBIGUOUS。
本 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 注册但不可选 - MCP 形态(按需开):19 个
mcp__argo__*完整工具面(argo_search/argo_local_search/argo_local_read/argo_recompute/argo_research/argo_evidence/argo_clarify/argo_fetch/argo_crawl/argo_screenshot/argo_pdf/argo_social_search/argo_article/argo_job/argo_extract/argo_preflight/argo_answer/argo_watch/argo_cite,与 CLI 能力面对齐)。工具定义每轮注入上下文且压缩清不掉(实测 19 工具 ≈3.7K token/轮),而搜索/抓取高频路径已由原生工具与 web seam 覆盖,故默认不挂载;需要长尾取证能力(screenshot / pdf / social / article / job / evidence / clarify / crawl / local_*)时在 profile patch 中取消mcp-argo行注释
另有 1 个 wide_research:规划互补轨道(depends_on 依赖分阶段,默认并行)→ 有界并发子代理取证 → 来源账本(仅 http(s) URL 入账)→ 综合报告;输出自带 quality_gate_results(conclusion_cap:low/medium/high),passed=false 时降级表述、先核验账本来源再下结论。worker 取证工具白名单默认双写 MCP 与原生工具名(allow 语义)——MCP 挂载与否两态自洽:MCP 在时用全量面,缺席时自动落到 argo_search / argo_fetch 与宿主 web_search / web_fetch。
日常一问用 argo_search;单代理取证用 argo_research;多视角对比、要引用账本用 wide_research。worker 默认只能调 argo 取证工具,不会再调 argo_research(硬保护,用户层放行也无效)。
设置界面
插件自带浏览器端设置页,两个入口:
- 设置弹窗(Cmd+,)左侧一级菜单「Argo」
- 设置 > 插件 > Argo(同一面板的摘要卡片,点开即用)
六个分区:
- 接入:
web_search/web_fetchseam 开关;引擎入口命令与参数(npx 或本机mcp_server.py);搜索/抓取超时、正文上限、连接空闲回收、并发连接数 - 工具:18 个原生一等工具的勾选(默认只开
argo_search/argo_fetch);单次调用超时与返回文本上限 - 引擎:argo 本体的行为开关(原环境变量,curated 白名单 35 个,分八组:缓存与排序 / 抓取层 / 语义与自适应 / 引擎启停 / 网络出口 / 本机检索 / 额度与预算 / 其他)。「缓存与排序」组第一项是测试模式(关闭结果缓存),默认关、日常结果缓存 1 小时;只有改进 Skill/插件、需要实时结果时才打开。「额度与预算」组把免费与付费源放在同一套 QuotaManager 下:金额计费的源设月度预算(DeepSeek 元 / Exa 美元),按次数限额的源设日/月次数上限(AnySearch / 知乎按日,元宝默认 2000/月、Tavily 按月);博查按量付费,不设固定次数上限,由服务商侧结算。额度或预算用尽后该源自动跳过并回落免费源。开关类即时生效,数字 / 文本 / 名单类分组保存;未配置行显示 argo 默认态并标注「默认」。授权类开关(可复算执行、内网 URL)刻意不进面板
- 密钥:常用引擎 key 的填写、更新、清除;显示「已配置 / 未配置 + 来源层(凭证库 / 启动环境 / .env)+ 只读态」,明文不回显;每行可勾选「转发」,等价于把引用名加进
keyRefs - 研究:worker / 轨道 / 每轨信源 / token 上限与报告落盘目录
- 高级:worker 工具 allow / deny 名单、凭证转发名单
保存即生效(全部为 volatile 配置):原生工具集合按勾选增删注册,超时、并发、研究上限在下一次调用时读取;引擎开关写成 argoEnv(一行一个 KEY=VALUE)随 argo 子进程 env 进入,对下一次新建连接生效(池内旧连接按 searchIdleMs 回收,默认 60s)。结构性字段(toolName、provider、searchProviderId、fetchProviderId)不在设置页,仍走 profile patch;watched patch 由官方 watcher 同 PID 重组,改后核对 Host 行与功能即可,不默认重启 Host。
密钥写入 DSH 凭证库(与 Models 页同一处),不写进插件配置、不打日志。凭证服务优先级为存储文件层 > 启动环境 > 项目 .env > 家目录 .env:在面板(或 Models 页)保存即覆盖启动环境里的旧值,argo 子进程下一跳新连接用新 key;「清除」只删凭证库里的值,环境变量或 .env 提供的 key 会重新露出。设置页只是凭证域的写入口,读取仍由宿主在每次调用时完成。
web seam 的 pin 必读(漏配会打挂 web_fetch)
宿主 dsh-web 的 provider 选择规则:配置 id 优先;都没有且恰好一个可用则选它;多个可用直接报 WEB_PROVIDER_AMBIGUOUS。web profile 默认挂着官方 http fetch provider(免 key、永远可用),本 bundle 再注册一个就是两个可用——不 pin 的话 web_fetch 整个挂掉(web_search 同理,若 profile 里另有搜索 provider)。故启用 web seam 的 profile 必须在 web 服务行显式指定:
- id: web
config:
searchProvider: argo # 已默认启用搜索 seam 时必配
fetchProvider: argo # 已默认启用抓取 seam 时必配
用户层 cordis.patch.yml 同 id 覆盖(同 id + name 匹配才是替换)。searchProviderEnabled: false / fetchProviderEnabled: false 可整体关掉对应 seam(provider 仍注册但不可选,不影响另一个)。
搜索引擎侧,Firecrawl 等匿名可用引擎 keyless 免配置即用(免费层额度),配置了密钥的引擎自动升级为认证请求;缺密钥不阻断路由。
DeepSeek 官方 key:DSH 凭证服务原生供给
argo 的 deepseek_search 引擎(官方 api.deepseek.com/v1/tools/search,结果自带 authority 权威分级 / rerank_score 排序分 / 发布时间)与 DSH 官方搜索后端共用同一把 key。插件经 DSH 原生凭证 seam 取用,不需要任何手工配置:
- id: wide-research
name: '@taxueseek/argo-dsh'
config:
# 默认即 ['DEEPSEEK_API_KEY'],一般无需写这一行
keyRefs: ['DEEPSEEK_API_KEY']
- 解析路径:
ctx.get('credentials').resolve('DEEPSEEK_API_KEY'),逐次解析——在 web Models 页轮换 key 后,下一跳新连接即生效,无需重启插件(池内连接最长存活searchIdleMs,默认 60s) - 层级语义与官方后端一致:凭证服务管理的
.credentials.yaml(web Models 页或设置页写入的那把)> 启动环境变量 > 调用目录.env>$DSH_HOME/.env——存储值胜出,所以面板轮换 key 后 argo 子进程拿到的是新值,不是启动时的旧值 - 安全:插件不读 key 文件、不落盘、不打日志;key 值只经内存进入 argo 子进程 env,任何输出与错误信息都不含它
- 旧宿主无 credentials 服务时静默跳过:argo 侧该引擎按缺 key 停用,其余源不受影响
keyRefs: []可整体关闭转发;后续要转发别的宿主凭证(如ARGO_EXA_API_KEY),把引用名加进数组即可,entry 必须是 POSIX 标识符(apply 期 loud fail)argoEnv(设置页「引擎」分区写入):argo 行为开关,一行一个KEY=VALUE,名字限 curated 白名单(specs.js 的ARGO_ENV_SPECS,35 个;白名单外 apply 期 loud fail,防拼错静默失效);授权位与路径 / 状态类变量刻意不收。与keyRefs的分工:keyRefs管密钥(凭证库),argoEnv管行为开关(插件配置),两者都不落明文
依赖
- Node.js ≥ 18(npx 拉取 argo 包)
- Python 3.9+,
pip install pyyaml - DSH 子代理 provider 需支持
outputSchema、depthLimit(标准spawn即可);toolFilter在 alpha.x 上可选,rc.2 已移除该启动期字段,改由插件内的 tool guard 阻止 worker 嵌套调用wide_research - 已在 DSH 0.2.1-alpha.1 与 0.2.1-rc.2 实测:rc.2 上
wide_research(planner → 2 worker → synthesis,passed=true / 14 sources)与原生argo_search(count=3)均真跑通;dsh web启动无 argo 报错。web seam 的 provider 注册随启动通过,headless 无 web 服务,未做实际调用。旧宿主 alpha.x 的start分支由单测覆盖
Compatibility(DSH Harness 版本对照)
本机 dsh --version 与插件 package.json 的 dsh.compatibility 是版本真源;下表只保留历史验证记录,不声明「当前」版本。
| argo-dsh | DSH Harness | 说明 |
|---|---|---|
| 2.11.2(本机已装) | 0.2.2-rc.1(本机运行中) | package.json 的 compatibility 已含该版本;wide_research 与原生工具走既有工具面,插件侧无需改动 |
| 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 起进入 |
低于 0.2.1 的 Harness 未做验证,不保证可用。
自定义(可选)
两行配置 id 分别为 mcp-argo 和 wide-research。用户层 cordis.patch.yml 同 id + name 才是替换:
- id: mcp-argo
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: argo
transport: stdio
command: /usr/bin/python3
args:
- /path/to/argo/scripts/mcp_server.py
- id: wide-research
name: '@taxueseek/argo-dsh'
config:
defaultWorkers: 6
maxWorkers: 9
maxTracks: 9
# 原生一等工具(可选调整):默认只注册 argo_search / argo_fetch(高频路径,
# 零常驻 token 开销)。全部长尾工具(article / job / social_search / pdf /
# crawl / extract / evidence / clarify / screenshot / preflight / answer /
# watch / cite / local_search / local_read / recompute,共 16 个,schema
# 自动派生自 MCP 真源)都可按需追加,例如:
# nativeTools: ['argo_search', 'argo_fetch', 'argo_pdf', 'argo_article']
# nativeTools: [] # 空数组关闭
# nativeTimeoutMs: 60000 # 单次进程超时(ms)
# nativeMaxChars: 24000 # 返回文本上限(字符)
# searchProviderEnabled: false # 关闭原生 web seam
childToolAllow:
- mcp__argo__argo_search
- mcp__argo__argo_evidence
- mcp__argo__argo_fetch
- web_search
- web_fetch
注意:
argo_research不提供原生单发形态——它是分钟级编排,默认 60s 进程超时会中断研究;深度研究请用wide_research(本 bundle 已注册)或挂载 MCP 形态。
卸载
在 DSH 的 Settings → Plugins 管理面板中移除本 bundle,或用官方入口 dsh plugin --profile web remove @taxueseek/argo-dsh。从 profile package.json 的 dsh.profile.bundles 手删条目是失败卸载后的残留修复手段,不是正常卸载路径,见 dsh-external-plugin-devkit/knowledge/pitfalls/leftover-bundles.md。
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 37546
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
DayuanJiang/next-ai-draw-io#dsh-plugin★ 36997
dsh 的 draw.io 绘图插件:通过 next-ai-drawio MCP 服务器作图,点回复里的链接在右侧栏打开实时预览,可以手动修改图,AI 的每次修改都是可以恢复的版本。需 Node.js 18+,首次使用由 npx 下载 MCP 服务器。
superdesigndev/treg★ 8164
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
T-Auto/dsh-ops★ 5864
为 Windows 的 DSH 提供 bash、PowerShell 7 及 Rust 高性能工具,减少 token 消耗。
sixtysevenlf/dsh-blender-plugin★ 2147
让 DSH agent 通过直连 TCP 通道驱动本地 Blender,提供 15 个工具:视口帧、自定义视角渲染、Python 执行、无头与作业卸载、事务回滚,以及 34 个 family / 228 个 op 的规划层。
helloHub1212/dsh-windows-mcp★ 1456
通过官方 MCP 客户端桥接层把 CursorTouch/Windows-MCP 桌面自动化服务器接入 DSH,把截屏、UI 树快照、鼠标键盘输入、剪贴板、进程与注册表等工具注册成 mcp__windows__* 供模型调用,并附带 windows_mcp_doctor 诊断工具;Computer Use 默认关闭,需在插件面板里打开。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。