anweat/dsh-web-search-pro 预览 preview

anweat/dsh-web-search-pro

Plugin插件 Native原生 ⭐ 73 MIT Search & Web Access搜索与联网

DeepSeek Harness 的增强型持久化网页搜索插件(多引擎搜索、SQLite+LRU 缓存、平台后端、Playwright 渲染)

Project Overview项目介绍

dsh-web-search-pro is a native bundle plugin built exclusively for DeepSeek Harness (DSH) that adds enhanced, persistent web search capabilities to DSH sessions. It packages 11 tools that LLM can call directly, including multi-engine web search, 2-layer persistent caching, site-specific search enhancement, and Playwright-powered page rendering. Its core logic is implemented natively in TypeScript, drawing routing control inspiration from Agent-Reach’s backend detection and selection approach. It supports multiple popular search engines and platforms including DDG, Bing, Exa, Bilibili, GitHub, and more.

To install the plugin, you must install both dsh-web-search-pro and @anweat/dsh-browser as direct dependencies of your DSH web profile, because DSH only activates bundle layers that are direct dependencies. After adding both plugins via the dsh plugin --profile web add command, you need to fully stop and restart your web profile for the changes to take effect, since refreshing the page won’t rescan plugin files. Once installed, you can first call the web_backend_status tool to check if all backends are ready, then ask your LLM to call any of the search tools to get the results you need. This plugin is ideal for DSH users who need access to real-time web information and platform-specific content.

dsh-web-search-pro is released under the open source MIT license. It also supports persistent search history, cache clearing, and usage statistics out of the box. Some backend features require additional system-level dependencies, such as bili-cli for Bilibili search, yt-dlp for YouTube search, and mcporter for Exa fallback when you don’t have an Exa API key. The plugin includes a built-in web_deps tool that can detect and install these required dependencies automatically. For Chinese community platforms that require login, the plugin lets you save your login state after a single sign-in, so you don’t need to log in repeatedly for future searches.

这是专为 DeepSeek Harness 开发的原生 bundle 插件,提供增强型可持久化网页搜索能力。它打包了 11 个可直接调用的工具,涵盖多引擎搜索、持久化双层缓存、按站搜索增强、Playwright 页面渲染等功能,兼容 DDG、Bing、Exa、B站、GitHub 等多个主流搜索和平台搜索引擎。支持引擎失败后自动回退、失败冷却,还支持用户自定义搜索平台,核心逻辑由原生 TypeScript 实现。

安装需要同时搭配 @anweat/dsh-browser 插件,两者都必须作为 profile 的直接依赖安装,通过 dsh plugin 命令添加后,需要完整停止并重启 DSH 的 web profile 才能生效。安装完成后可先调用 web_backend_status 检查后端是否就绪,之后就能在会话中让模型调用搜索工具完成需求。适合需要在 DSH 会话中获取实时网页信息、平台内容的用户使用。

本插件采用 MIT 许可开源,部分后端功能需要依赖系统额外安装的工具,比如 bili-cli、yt-dlp 等,插件自带 web_deps 工具可以检测和安装这些依赖。对于需要登录的中文社区平台,支持一次性保存登录态后重复使用,不会要求用户反复登录。用户也可以自定义任意搜索平台,无需修改代码就能新增站点。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 no risk signal found未发现风险信号
  • This site's static screen found no obvious risk signal (stars, license, activity, manifest)本站静态筛查没发现明显风险信号(星标、许可证、更新活跃度、清单完整度)
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 @anweat/dsh-browser@0.1.15 dsh-web-search-pro@0.1.15

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

READMEREADME

dsh-web-search-pro

增强型、可持久化的扩展网页搜索插件 for DeepSeek Harness(DSH)。

一个 DSH bundle 插件,把多引擎网页搜索、平台搜索、持久化缓存、受控按站增强和 Playwright 渲染打包成模型可直接调用的 11 个工具。路由控制面借鉴 Agent-Reach 的后端探测、顺序选择和失败冷却思路,核心逻辑为本项目原生 TypeScript 实现。

兼容与发布通道

插件发布通道 DSH 基线 兼容承诺
0.1.11 及更早的维护版本 dsh-v0.1.1-rc.2 旧基线;不与新插件混装
0.1.15 dsh-v0.1.7-rc.2 + Browser 0.1.15 精确锁定此宿主版本;组合安装、真实 Web profile 与设置持久化已验证

0.1.15 的 DSH 运行时依赖精确锁定 0.1.7-rc.2, 客户端配置改走 configForms 和插件 bundle 的专属配置槽位。

安装

dsh plugin --profile web add @anweat/dsh-browser@0.1.15 dsh-web-search-pro@0.1.15
# 或本地目录 / tarball:
dsh plugin --profile web add ../dsh-browser ./dsh-web-search-pro
# 重启(web profile 关闭了 HMR):
dsh --profile web

两个插件都必须是 profile 的直接依赖:DSH 只激活直接依赖的 bundle layer,且标准 profile 可能设置 autoInstallPeers: false。不要只安装 Web Search Pro 后依赖 peer 自动补齐。 pnpm 11 若拦截 Browser 的 OpenCLI 依赖安装脚本,会要求在 profile 的 pnpm-workspace.yaml 中明确决定 allowBuilds: { '@jackwener/opencli': false }(或在确实需要安装期下载 adapter 时自行审核后设为 true),再重试安装;隔离 profile 中禁用脚本后,已发布 Browser 的 OpenCLI 入口仍可运行。 本版仅支持 dsh-v0.1.7-rc.2 与 Browser 0.1.15,不能混用仍声明旧 DSH peer 的 Browser 0.1.15-alpha.2。若你的 harness 是本地源码 checkout,版本号可能有出入——用 dsh plugin --profile web add ./<path> 并在 profile 的 pnpm-workspace.yaml 里对齐版本后重装即可。

从旧版本升级

升级 Web Search Pro 时应同时升级浏览器插件;两者都需要作为 profile 的直接依赖。

dsh plugin --profile web add @anweat/dsh-browser@0.1.15 dsh-web-search-pro@0.1.15

升级完成后需要完整停止并重新启动 Web profile;仅刷新网页不会重新扫描插件的 client.js。随后依次检查:

  1. browser_status:确认 OpenCLI、playwright | patchright 运行时、automationMode 与 usagePolicy 符合预期。
  2. web_backend_status:确认搜索、CLI、Agent Reach 与浏览器后端是否 ready。
  3. 打开 插件 → 已安装 中两个 bundle 各自的详情页,确认配置表单都已加载;浏览器表单负责自由度、运行时、OpenCLI 与调用缓冲。

automationMode 和防止过度调用的 usagePolicy 都属于 dsh-browser,升级不会自动改写现有配置。生产 profile 建议保留 standard;unrestricted 只用于隔离的自动化测试 profile,并且仍受并发、突发、页数/深度和 429/503 退避保护。

若 Clash/TUN 使用 fake-IP DNS,原生 HTTP 后端可能看到 198.18.0.0/15 或 fdfe:dcba:9876::/96。可在可视化面板的高级设置中启用 allowProxyFakeIp;默认关闭。该开关只信任这两个代理网段的 DNS 解析结果,字面 fake-IP URL、localhost 和其他私网地址仍会被 SSRF 防护拒绝。

快速使用与适用情形

安装并重启后,直接在 DSH 会话里要求模型调用工具即可:

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-deepseek-flow 下一个 Next deepseek-harness-control-center →