并行搜索 parallel-web/dsh-web-search-parallel

DeepSeek Harness 的并行搜索

此插件使 DeepSeek Harness 内置的 web_search 工具使用 Parallel Search。它不会添加新工具，也不提供 web_fetch。

它目前支持 Node.js ^22.19.0 || >=24.0.0 上的 @deepseek-ai/dsh@0.1.0-rc.6。
DeepSeek Harness 仍处于开发者预览阶段，因此后续版本可能需要更新插件。

开始之前

你需要：

- pnpm 10 或更新版本；
- 一个 Parallel API 密钥；以及
- 已在 DeepSeek Harness 中配置好的模型提供商。

你不需要全局安装 dsh。以下命令通过 npx 运行受支持的版本。

安装

首先，在你要运行 Harness 的终端中使你的 Parallel API 密钥可用：

export PARALLEL_API_KEY="your-key"

然后将插件安装到 web 配置文件中：

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 \
plugin --profile web add \
--allow-build=@parallel-web/dsh-web-search-parallel \
"github:parallel-web/dsh-web-search-parallel#main"

--allow-build 标志允许 pnpm 仅构建此插件，而不构建其他任何内容。若要可复现安装，请将 main 替换为完整的提交 SHA。

停止任何正在运行的 Harness 进程，然后再次启动它：

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web

检查它是否生效

检查配置文件：

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 \
--profile web --dump-config | \
grep -E 'searchProvider: parallel|web-search-parallel'

你应该会看到 searchProvider: parallel 和一个 web-search-parallel 条目。
同时看到内置的 web-search-deepseek 插件是正常的—— searchProvider 设置决定由哪个提供商处理搜索。

若要获得直接请求证据，请以信息级 Parallel 日志启动 Harness：

PARALLEL_LOG=info npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web

在调用 web_search 之后，终端应显示向 https://api.parallel.ai/v1/search 发出的成功请求。分享日志前请先检查日志。

可选设置

默认设置无需额外配置即可工作。如果你想调整搜索，请编辑 ~/.dsh/profiles/web/cordis.patch.yml：

- id: web-search-parallel
config:
mode: turbo
maxCharsTotal: 12000
maxCharsPerResult: 2000

| 设置 | 默认值 | 它控制的内容 |
| mode | Parallel 的 advanced 默认值 | turbo、basic 或 advanced 搜索 |
| maxCharsTotal | 25000 | 返回给 Harness 的摘要字符总数 |
| maxCharsPerResult | 无限制 | 为每个结果保留的摘要字符数 |

请将 PARALLEL_API_KEY 保留在环境中，而不是放入此文件，因为该文件以可读文本形式存储。

如果出现问题

- 找不到 dsh： 使用上面的 npx @deepseek-ai/dsh 命令。
- 端口 3080 已被占用： 在启动另一个 Harness 进程之前，停止较旧的 Harness 进程。
- 提供商仍然是 deepseek-official： 重启 Harness 并检查
- 检查你的 cordis.patch.yml 是否包含后续的 searchProvider 覆盖项。
- pnpm 报告缺少 DSH 对等依赖： 对于此 Git 安装方式，此警告是预期内的。Harness 会从 profile 运行时提供这些包。
- Harness 未搜索即作答： 所配置的模型会自行决定何时调用 web_search。请尝试使用明确需要最新信息的提示词。
- 提供程序不可用： 请确认在启动 Harness 的同一终端中已设置 PARALLEL_API_KEY。

移除

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 \
plugin --profile web remove @parallel-web/dsh-web-search-parallel

移除插件后，请重启 Harness。

开发与安全

有关本地开发、测试以及打包产物审查工作流，请参阅 CONTRIBUTING.md。请按照 SECURITY.md 报告漏洞。

如需帮助，请联系 support@parallel.ai。

MIT 许可。