PyModel/dsh-research-plugins

dsh-research-plugins

用于 DeepSeek Harness 的研究插件 —— 一个 pnpm monorepo，为你的 DSH agent 添加网页搜索和 MCP（Model Context Protocol）桥接，用于 AI 研究、网页抓取和实时文档。

这是什么 ·
安装 ·
API 密钥 ·
仓库结构 ·
许可证

这是什么

dsh-research-plugins 为你的 DeepSeek Harness（DSH）agent 提供了三项开箱即用之外的研究超能力：

- 网页搜索，通过 Tavily Search API —— 一个设置开关，将内置的 DeepSeek 搜索替换为 Tavily，并支持无密钥搜索。
- 网页抓取与爬取，通过 Firecrawl MCP 服务器 —— 在工具调用中抓取、爬取、映射和搜索开放网络。
- 最新的库文档，通过 Context7 MCP 服务器 —— 按需获取任何库或框架的文档和代码示例。

一切都以即插即用的 DSH 插件形式提供 —— 没有供应商锁定，无需 fork，只需一条 dsh plugin add 命令。

| 包 | 它添加的功能 |
|---|---|
| @pymodel/dsh-tavily | 将 Tavily Search API 作为网页搜索提供方（设置开关、无密钥搜索）+ 一个 Tavily MCP 桥接（tavily-search / tavily-extract 无密钥；crawl / map 需要密钥） |
| dsh-mcp-firecrawl | Firecrawl MCP：无密钥的 search / scrape / parse；使用 API 密钥时提供完整工具集 |
| dsh-mcp-context7 | Context7 MCP：mcp__context7__* 提供最新的库文档和代码示例 |

安装

每个包都独立安装到 DSH 配置文件中：

dsh plugin --profile web add @pymodel/dsh-tavily
dsh plugin --profile web add dsh-mcp-firecrawl
dsh plugin --profile web add dsh-mcp-context7
dsh web

或者从 GitHub 安装（本仓库，最新提交）：

dsh plugin --profile web add github:PyModel/dsh-research-plugins#path:packages/dsh-tavily
dsh plugin --profile web add github:PyModel/dsh-research-plugins#path:packages/dsh-mcp-firecrawl
dsh plugin --profile web add github:PyModel/dsh-research-plugins#path:packages/dsh-mcp-context7

API 密钥

MCP 桥接使用 harness 自带的 @deepseek-ai/dsh-mcp-client。它们从启动环境读取密钥（真实的环境变量、项目的 .env 或 $DSH_HOME/.env）——而不是从 $DSH_HOME/.credentials.yaml：

| 插件 | 环境变量 | 是否必需 | 端点 |
|---|---|---|---|
| dsh-tavily（MCP 部分） | TAVILY_API_KEY | 否（无密钥 MCP：search + extract；crawl/map 需要密钥） | https://mcp.tavily.com/mcp/ |
| dsh-mcp-firecrawl | FIRECRAWL_API_KEY | 否（无密钥：search/scrape/parse；使用密钥时提供完整工具集） | https://mcp.firecrawl.dev/v2/mcp |
| dsh-mcp-context7 | CONTEXT7_API_KEY | 否（无密钥也可用） | https://mcp.context7.com/mcp |

密钥在加载时作为 Authorization: Bearer 请求头发送——绝不出现在 URL 中，也绝不出现在明文 YAML 中。没有密钥时，桥接会以各厂商文档所述的无密钥模式运行（Tavily 使用 X-Tavily-Access-Mode: keyless），因此每一行开箱即用。添加到 .env 的密钥需要重启 dsh web。

仓库结构

packages/
dsh-tavily/          # 网页搜索提供方 + 设置卡片 + Tavily MCP 行
dsh-mcp-firecrawl/   # 纯配置的 Firecrawl MCP 包
dsh-mcp-context7/    # 纯配置的 Context7 MCP 包

Firecrawl 和 Context7 包是纯配置包（package.json + cordis.patch.yml），无需构建步骤。Tavily 包保留其预构建的 lib/ 和浏览器客户端。

贡献

欢迎提交 issue 和 pull request。在开始大型改动之前，请先在 GitHub 上发起讨论。

作者

elkaix · pymodel

许可证

MIT © elkaix