dondai44423/donsetch-dsh

Plugin插件 Native原生 ⭐ 2 AGPL-3.0 Search & Web Access搜索与联网

First-class DonSeTch web access for DeepSeek Harness (dsh). One install line, and every dsh agent gets the full DonSeTch suite: fetch, search, and crawl with browser-grade stealth, keyless engines, BYOK providers, and an auto-updating native binary. No API key required to start.

catalog descriptioncatalog 简介 / catalog description:First-class DonSeTch plugin for DeepSeek Harness: fetch, search and crawl as native dsh tools with an auto-updating verified binary

Project Overview项目介绍

donsetch-dsh is a first-class DonSeTch web-access plugin built specifically for DeepSeek Harness (dsh). It installs with a single command — dsh plugin --profile web add github:dondai44423/donsetch-dsh — and on the next dsh web boot it downloads the matching DonSeTch binary for the host platform, SHA256-verifies it against the GitHub Releases sidecar, and registers donsetch_web_fetch, donsetch_web_search, donsetch_web_crawl, and donsetch_status directly into the harness tool registry rather than exposing them as mcp__* imports, so they inherit dsh's permission, timeout, and cancellation pipeline.

The typical workflow is fully zero-config: every dsh agent immediately gains browser-grade fetch, keyless search, and whole-site crawling with sitemap discovery; when richer engines are wanted, users add provider keys via donsetch keys add exa <key> and switch defaults with donsetch keys default exa. It targets developers and power users who want reliable, supervised web tooling inside dsh sessions, including headless --profile headless invocations such as npx @deepseek-ai/dsh "research the latest donsetch release notes", and it is explicitly the recommended replacement for wiring donsetch mcp through dsh's built-in MCP client.

Runtime requirements are Node ^22.19.0 || >=24.0.0, compatibility verified against @deepseek-ai/dsh 0.1.1-rc.2 (npm) and 0.1.2-alpha.1 (source), and the license is AGPL-3.0-only matching DonSeTch. No API key is needed to start; the daemon runs supervised under donsetch mcp --supervised so crashes recover transparently, the update check never blocks tool service and never runs paid queries, and a known upstream gap (npm dsh CLI missing a pty.node linux-x64 prebuild on GitHub runners, issue #1686) affects only the Linux web-boot smoke test, which CI runs on Windows instead.

donsetch-dsh 是面向 DeepSeek Harness(dsh)的一等 DonSeTch Web 访问插件,使用 dsh plugin --profile web add github:dondai44423/donsetch-dsh 即可安装。它专为 dsh 工具注册表设计,在 bundle 内注册 donsetch_web_fetch、donsetch_web_search、donsetch_web_crawl、donsetch_status 等原生工具,而非通过 mcp__* 引入,因此完全遵循 dsh 的权限、超时与取消管道,并在 Web 工作台展示调用卡片。

典型流程是安装后重启 dsh web,首次启动自动下载适配当前平台的 DonSeTch 二进制并校验 SHA256,工具即可零配置使用;BYOK 场景下用户可用 donsetch keys 添加 Exa、Tavily 等提供方。它面向需要在 agent 流程中可靠完成网页抓取、搜索与整站爬取的开发者和高级用户,亦支持 dsh --profile headless 无头模式调用。

运行时需要 Node ^22.19.0 || >=24.0.0,并与 @deepseek-ai/dsh 0.1.x train 兼容;开源协议为 AGPL-3.0,首次运行无需任何 API Key。已知限制是 npm 版 dsh CLI 在 Linux GitHub Runner 上缺少 pty.node linux-x64 预编译,Web 启动冒烟测试需改在 Windows 上跑,但插件本身不受 pty 影响。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:dondai44423/donsetch-dsh

把 dondai44423/donsetch-dsh 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

donsetch-dsh

First-class DonSeTch web access for DeepSeek Harness (dsh). One install line, and every dsh agent gets the full DonSeTch suite: fetch, search, and crawl with browser-grade stealth, keyless engines, BYOK providers, and an auto-updating native binary. No API key required to start.

Install

dsh plugin --profile web add github:dondai44423/donsetch-dsh

Restart dsh web (bundle plugins activate on the next boot). On first start the plugin downloads the correct DonSeTch binary for your platform from GitHub Releases, verifies its SHA256 against the release sidecar, and registers the tools. That is the whole setup: no API key, no config file.

Add the dsh-plugin topic to your repo mentions: this repo is already on it. The plugin also works in headless profiles:

npx @deepseek-ai/dsh --profile headless "research the latest donsetch release notes"

What you get

  • donsetch_web_fetch: one URL to full markdown, browser-grade rendering and stealth where needed
  • donsetch_web_search: keyless engines out of the box, or your own keys via BYOK providers (Exa, Tavily, Serper, SerpApi, SerpBase, Bright Data, TinyFish, plus plugin adapters)
  • donsetch_web_crawl: whole-site crawling with sitemap discovery
  • donsetch_status: self-diagnostics (degraded daemons get one automatically)

The tools are registered in-process on the harness tool registry, not as mcp__* imports, so they flow through dsh's permission, timeout, and cancellation pipeline like any native tool, and they show call/result cards in the Web workbench.

Why it is not just an MCP config

dsh ships a built-in MCP client. Pointing it at donsetch mcp works, but this plugin is the first-class version:

built-in MCP config this plugin
Install you write a config row one plugin add
Binary download + SHA256 verify manual install automatic
Auto-updates with donsetch releases never yes, throttled, swappable between calls
Tool names mcp__donsetch__... donsetch_...
Config changes from the CLI restart everything live daemon restart on config file change
Workbench cards generic per-tool call/result summaries
Status + doctor for the agent none donsetch_status
Harness schema contract none parameters comply with the enforced raw JSON Schema contract
Correctness gate in CI none the plugin runs inside a real dsh ToolRuntime on every push

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-gaokao 下一个 Next dsh-conversation-language →