DeepSeek Harness Plugin

taxueseek/argo#dsh-plugin

Stars ★ 269 Category Tools & Capabilities Added 2026-08-14

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_fetch seam 开关;引擎入口命令与参数(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。

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.