Unified search with evidence verification for agents: 120+ engines with multilingual routing, vertical domains and structured modality cards, 10 MCP tools plus wide_research orchestration, and a fetch-verify loop that backfills evidence scores.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:taxueseek/argo#path:/packages/dsh-plugin
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
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。
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 37546
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
DayuanJiang/next-ai-draw-io#dsh-plugin★ 36997
Draws draw.io diagrams in DeepSeek Harness through the next-ai-drawio MCP server: the link in the reply opens a live preview in the right sidebar, you can edit the diagram by hand, and each AI change is a version you can restore. Node.js 18+; npx downloads the MCP server on first use.
superdesigndev/treg★ 8164
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 5864
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
sixtysevenlf/dsh-blender-plugin★ 2147
Lets a DSH agent drive a local Blender over a direct TCP channel with 15 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 228 ops across 34 families.
helloHub1212/dsh-windows-mcp★ 1456
Bridges the CursorTouch/Windows-MCP desktop automation server into DSH through the official MCP client bridge, registering its screenshot, UI tree snapshot, mouse and keyboard input, clipboard, process and registry tools as mcp__windows__* tools for the model, and adds a windows_mcp_doctor diagnostic tool. Computer Use is off by default and is switched on from the plugin panel.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.