DSH Marketplace

modsearch

liustack/modsearch

纯文本 agent 的联网搜索桥:搜索网页与 X,返回结构化 JSON 证据(search/fetch/引用)。

80928TypeScriptMIT源码

安装

把 modsearch 装进 DeepSeek Harness

装到哪

npm 方式

直接拉已发布的 tarball,不用克隆整个仓库,也不需要额外配置。如果你用的是别的 profile,把 `web` 换成对应的名字。

GitHub 方式 · npm 包

从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。

我们跑过之后

我们跑过,装得上

这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 11 天前,DeepSeek Harness 0.2.2-rc.1.

挂进你的 README

实测可装 — dshmarketplace

给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。

安装前须知

装 modsearch 之前,先看这几条

  • 源码在这里: liustack/modsearch——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
  • 开源协议:MIT。

安全

装 modsearch 会执行什么

构建脚本

我们这次实装里没有构建脚本被拦。

来源:我们在沙箱里的实装,DeepSeek Harness 0.2.2-rc.1,11 天前。

安装钩子

package.json 里没有 preinstall / install / postinstall 脚本。

来源:最近一次同步时读到的 GitHub 上的 package.json。prepare 没有记录——它只在从 GitHub 装时执行,被 pnpm 拦下时会出现在「构建脚本」那一行。

README 里提到

shell 命令(bash、exec、spawn 之类)

来源:对 README 做的关键词匹配,只提示它可能碰到什么,不是代码分析。

这不是安全审计。上面是一次实装记录加两次文本扫描,没有人替你读过这个插件的代码。插件带着你 agent 的权限在跑。

AI 锐评

是什么 — 让纯文本 agent 能搜网页、抓页面、查 X,并拿到带出处的 JSON 结果。

谁该装 — 你在 DeepSeek Harness 里用 DeepSeek 或 GLM 写稿、核对链接或追当天新闻,模型自己打不开网页。日常已经泡在自带联网搜索的聊天客户端、并不走 DSH profile 的人,不必再叠这一层。

注意 — 沙箱里在全新 profile 装上后,DeepSeek Harness 已把它注册进去。默认走 Firecrawl 免注册档,每月 1,000 credits,失败或额度用尽会切下一个引擎;查 X 还要另装 Grok Build,Tavily、Exa 的 key 写在 ~/.modsearch/config.json。它会在本机执行 shell 命令。

锐评 — 文本模型的 DSH profile 我会装;先当默认搜索层用,不把引擎配齐当成安装步骤。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。

modsearch 是做什么的

Abstract diagram of scattered web signals converging into structured evidence cards.

modsearch 是一个 DeepSeek Harness 插件,为没有原生联网能力的文本 agent 提供网页搜索、X 搜索和单页读取。它接入 DSH 内置的 web_search,另外提供 x_search 与 read_page,把搜索或抓取结果整理成带来源、引用和不确定性信息的结构化 JSON 证据。引擎包括 Antigravity CLI、Tavily、Exa、Firecrawl、Grok Build 和内置的 local,配置多个引擎时会在失败或配额耗尽后自动切换。

配置写入 ~/.modsearch/config.json,权限为 0600。API key 可通过 modsearch config set tavily.apiKey 等命令设置,也可使用 TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY。需要兼容服务时,还能设置对应的 baseURL。

它适合需要最新网页资料、X 内容或定向读取 URL 的 agent;如果 DSH 原有的 web_search 已够用,或不希望引入外部服务,则没有必要安装。Antigravity CLI 需要浏览器登录,X 搜索依赖 Grok Build 及 SuperGrok 或 X Premium。插件存在终端面:会运行 agy、grok 等辅助 CLI,并执行配置命令。

modsearch 的文档

配置

modsearch 按顺序使用引擎链。默认通道是 Antigravity CLI,需要安装 agy 并完成浏览器登录。配置文件为 ~/.modsearch/config.json,权限为 0600。API key 也可放在环境变量 TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY 中。

引擎 能力 配置
Antigravity CLI 网页搜索、页面抓取 安装 agy 并登录
Tavily 网页搜索 tavily.apiKey
Exa 网页搜索 exa.apiKey
Firecrawl 网页搜索、页面抓取 firecrawl.apiKey
Grok Build X 搜索 安装 grok 并登录
local 页面抓取 内置

多个引擎同时配置时会自动故障转移。兼容的第三方或自托管服务可通过对应的 baseURL 指定。

命令

使用 modsearch config set <key> <value> 写入配置,例如 modsearch config set tavily.apiKey <key> 和 modsearch config set tavily.baseURL <url>。CLI 还提供 config 与 doctor 相关功能,用于配置和健康检查。

行为说明

插件把 DSH 的 web_search 接到引擎链,并增加 x_search 与 read_page。结果以结构化 JSON 证据返回,包含来源和引用;示例中还使用 uncertainty 表达聚合信息需要复核的情况。agent 在对话中提出联网问题或提供 URL 后,skill 会选择搜索或抓取操作。

环境要求

网页搜索至少需要一个搜索引擎。Antigravity CLI 需要浏览器登录;Grok Build 需要 SuperGrok 或 X Premium。Tavily、Exa、Firecrawl 依赖各自配额或兼容 API。local 只有页面抓取能力,不能替代网页搜索引擎。

根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README

同一分类

modsearch 的同类插件

BrowserSkill 的 DeepSeek Harness 浏览器自动化桥接插件,通过原生浏览器工具控制可见的 Chrome 和 Edge Agent Window,支持可访问性与 VOM 页面观察、截图、隔离的多会话控制和 Web UI 实时观察浮层。

没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。

GitHub 源码TypeScript今天

AI 锐评

dsh-plugin-browserskill

是什么 — BrowserSkill 插件为 DeepSeek Harness 提供浏览器桥接,允许 agent 控制可见 Chrome 和 Edge 窗口,使用浏览器工具、截图和多会话管理。

谁该装 — 在使用 DeepSeek Harness 执行网页浏览、表单提交或已登录站点任务时适合安装此插件。 不适合仅依赖本地模型完成代码生成或无浏览器需求的 agent,因为它们无需可见窗口支持。

注意 — 安装需作为 DeepSeek Harness 子目录插件。 静态检查提示会执行 shell 命令。 未进行沙箱实测,未发现明显的坑。

锐评 — 我会装它,因为它允许 agent 以可见窗口方式操作已登录浏览器,而不需要中断自身浏览工作。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
1源码
833

Chrome 侧边栏扩展,让 DSH 直接操控你的浏览器,无需视觉能力。

没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。

GitHub 源码TypeScript1 个月前

AI 锐评

bridge-browser

是什么 — bridge-browser 使 DeepSeek Harness 能直接操作已打开的 Chrome 或 Firefox 标签页,模型可读取页面内容、操作控件并管理标签,提供侧边栏对话界面。

谁该装 — 在 DeepSeek Harness 的浏览器任务中使用 deepseek-v4-flash 模型且希望保留浏览器登录状态的用户适合安装此插件。 不希望提供 API key 或 token 的用户可以选择其他方案。

注意 — 没发现明显的坑。需要提供 API key 或 token。插件会执行 shell 命令。

锐评 — 我装它,因为在特定基准测试中它能减少工具调用次数并降低延迟。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
2源码
809

Chrome 侧边栏扩展,让 DSH 直接操控你的浏览器,无需视觉能力。

没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。

GitHub 源码TypeScript1 个月前

AI 锐评

bridge-browser

是什么 — bridge-browser 是 DeepSeek Harness 的浏览器控制插件,能让模型在现有浏览器标签页中直接操作,无需视觉能力。

谁该装 — 在使用 DeepSeek Harness 进行网页点击、表单填充和导航时,需要浏览器控制能力。 如果你的工作不需要在浏览器中保留会话状态,则无需安装此插件。

注意 — 安装此插件需要 Node.js ^22.19 或 >=24 版本,并需要 Chrome 116+ 或 Firefox 140+。运行时需要提供 API key 或 token。没发现明显的坑。

锐评 — 我会装它,因为它减少了模型和工具往返次数并更快完成任务。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
2源码

DSH 免费搜索插件:7 个引擎(DuckDuckGo/Bing/SearXNG 免费 + Exa/Perplexity/DeepSeek 付费)、自动回退、设置页 UI(API key 输入 + 官网链接)、web_fetch、引擎测试工具。

我们跑过,装得上

npm 包JavaScript1 个月前

AI 锐评

dsh-free-search

是什么 — dsh-free-search 为 DeepSeek Harness 添加多引擎 web_search 工具,支持免费引擎自动切换与测试。

谁该装 — 当你使用不支持 web_search 工具的网关模型时适合安装此插件。 那些仅依赖本地工具完成任务的用户不必安装。

注意 — 沙箱测试在全新 profile 里装上,并被 harness 注册进 profile,未发现明显的坑。

锐评 — 我会装它,因为它提供了 keyless 搜索方案,但前提是 agent 需要 web_search 工具。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
2详情

用 35 个结构化工具从 DeepSeek Harness 驱动真实 Chrome/Chromium:导航、语义快照、点击、表单、JavaScript/CDP、截图、下载与标签页管理;右侧边栏实时镜像页面,并支持鼠标键盘直接接管。插件自带受管 CDP 运行时,跨调用保留登录状态,并可通过配套 Chrome 扩展从日常浏览器导入 cookie。

我们跑过,装得上

npm 包TypeScript13 天前

AI 锐评

dsh-ego-browser

是什么 — DeepSeek Harness 通过此插件驱动真实 Chrome 浏览器并提供实时侧边栏观测。

谁该装 — DeepSeek Harness 的 agent 需要执行网页导航和表单操作时,此插件提供实时浏览器观测。 如果不使用桌面端 DSH 的项目用户无需安装,因为它通过 DSH 原生侧边栏实现面板支持。

注意 — 沙箱实测通过:在全新 profile 里装上并被 harness 注册进 profile。 没发现明显的坑。

锐评 — 我会装它,因为它支持从日常 Chrome 导入登录态并保持跨调用。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
1详情
144

共享真实浏览器:用户可观看并随时接管的原生 Electron 窗口,agent 通过 CDP 驱动,内置 20 个 browser_* 工具(打开/快照/执行/填表/截图/下载/登录态);任务级会话隔离、登录态持久化、人机验证识别,纯 `dsh web` 无需桌面外壳即可自托管。

我们跑过,装得上

npm 包JavaScript23 天前

AI 锐评

dsh-browser

是什么 — 为 DeepSeek Harness 提供共享真实浏览器的插件,agent 通过 CDP 驱动 Electron 窗口,人可观看接管页面。

谁该装 — 当使用 DeepSeek Harness 执行网页自动化任务时,此插件适合安装。 如果你主要使用无头浏览器方案,现有集成即可满足需求。

注意 — 没发现明显的坑。沙箱实测通过,在全新 profile 里装上并被 harness 注册进 profile。 自托管环境无需额外启动步骤。

锐评 — 我会装它,因为它在纯 dsh web 环境中也能自托管。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
源码