dsh-open-deep-research: DeepSeek Harness 深度研究插件

前言¶

DeepSeek Harness（DSH）的理念是「一切皆插件」。在构建需要联网搜索、阅读网页或 PDF 并生成引用报告的研究型智能体时，手动编排这些步骤既繁琐又容易出错。dsh-open-deep-research 插件提供了一个现成的深度研究框架，它基于 DSH 构建，负责规划、执行研究和综合结论。

这是什么¶

dsh-open-deep-research 是一个可配置的 Deep Research 代理和 TypeScript 框架。该插件由 songyang0603 维护，旨在解决从单一问题出发，生成带引用链接的 Markdown 报告的需求。它通过 CLI、DSH Tool 和 TypeScript API 暴露了标准化的研究服务。

核心功能¶

规划与执行：规划 1 到 3 个专注的研究单元，并通过 DSH 子智能体运行，最后由合成智能体生成报告。
多模态检索：支持 Web 搜索（在专用 Profile 中）以及通过 research-jina Profile 读取选定的页面或 PDF。
结构化输出：返回带引用的 Markdown 报告、规范化的链接、终端状态和运行元数据。
多种接入方式：提供 CLI、DSH Tool 和 TypeScript 入口点，底层基于可替换的 ResearchEngine。

安装与启用¶

环境要求：
* Node.js ^22.19.0 或 >=24.0.0
* pnpm 10.x
* DeepSeek Harness 0.1.0-rc.8

下载预发布包：

    curl -fL -O \
      https://github.com/songyang0603/dsh-open-deep-research/releases/download/v0.1.0-alpha.5/dsh-open-deep-research-0.1.0-alpha.5.tgz

安装插件（以 research-jina Profile 为例）：

    npx @deepseek-ai/dsh@0.1.0-rc.8 plugin --profile research-jina add ./dsh-open-deep-research-0.1.0-alpha.5.tgz

典型用法¶

全量研究（搜索 + 阅读）¶

使用 research-jina Profile，需要 DeepSeek Key 和 Jina Key。该 Profile 提供网页搜索和页面阅读能力，会将选定的公共 URL 发送到 Jina。

export DEEPSEEK_API_KEY='<your-deepseek-key>'
export JINA_API_KEY='<your-jina-key>'

npx @deepseek-ai/dsh@0.1.0-rc.8 --profile research-jina \
  --breadth balanced \
  --language English \
  "Research the main changes in DeepSeek Harness rc.8. Search for relevant material, read important source pages, and produce a report with citation links."

仅搜索¶

当没有 Jina Key 或网络无法访问 Jina 时，使用独立的 research Profile。它提供规划、Web 搜索、多个研究单元、综合和报告生成，但不提供可靠的全页面或 PDF 读取能力。

export DEEPSEEK_API_KEY='<your-deepseek-key>'

npx @deepseek-ai/dsh@0.1.0-rc.8 --profile research \
  --language English \
  "Research the main changes in DeepSeek Harness rc.8 and produce a report."

适用场景与注意¶

该插件适用于需要在 DeepSeek Harness 中快速构建复杂调研流程的场景。

注意 1：项目状态为 0.1.0-alpha.5 Alpha Public Preview，不建议在生产环境直接使用。
注意 2：Reader 每次请求最多返回 8,000 tokens，长文档可能被截断。
注意 3：第一次干净的 npx 调用会花费几分钟下载和构建依赖，请耐心等待。
注意 4：research-jina Profile 会发送选定的公共 URL 到 Jina，请使用非敏感、公开的 URL。
注意 5：DSH 在管理 Profile 插件时会调用 pnpm，确保 pnpm 已安装。
注意 6：两个 Profile（research 和 research-jina）是独立的，它们之间不会互相覆盖。

结语¶

dsh-open-deep-research 为 DeepSeek Harness 用户提供了一个开箱即用的深度研究解决方案。它通过标准化的接口和 Profile 管理，简化了从问题定义到报告生成的全过程。