棱镜搜索 linhanson3-eng/dsh-web-search-prism

@hank52168/dsh-web-search-prism

为 DeepSeek Harness 的 web 能力接缝（ctx.web）提供基于 Firecrawl 的搜索服务商。用一次调用同时拿到搜索结果和整页 markdown，为 dsh 的 web_search 工具兜底，补上官方 DeepSeek 服务商的两个缺口：

| 缺口 | 官方（dsh-web-search-deepseek） | 本插件 |
| snippet | ❌ 缺失（只有 cited_text，通常为空） | ✅ description |
| content（答案） | ❌ 从不填充 | ✅ 整页 markdown |

为什么

官方服务商把每次搜索都跑成一轮完整的 DeepSeek 模型对话（没有专门的检索端点），所以结果里只有 url + title。本插件改用 Firecrawl 的 /v2/search，配上 scrapeOptions.formats: ["markdown"]，在同一次调用里返回每条命中的整页 markdown。

安装

本插件是 npm 包，通过 dsh.bundle.patch 声明自己是 dsh bundle。用插件管理器或 pnpm 安装，然后把它加进你配置档的 dsh.profile.bundles：

pnpm add @hank52168/dsh-web-search-prism
then in package.json: "dsh": { "profile": { "bundles": ["@hank52168/dsh-web-search-prism", ...] } }

配置

本服务商优先走无密钥模式——Firecrawl 的托管无密钥会话不需要凭证。想提高速率上限，就设置密钥：

export FIRECRAWL_API_KEY=fc-...

也可以在 cordis.patch.yml 里通过插件配置传入：

- id: web-search-prism
name: '@hank52168/dsh-web-search-prism'
config:
apiKeyEnv: FIRECRAWL_API_KEY

选择服务商（⚠️ 必做）

不做这一步，你的搜索仍然走官方 DeepSeek 服务商（它的 searchProvider: deepseek-official 是显式配置的，所以「唯一可用服务商」的自动选择永远不会生效）。

在你配置档的 cordis.patch.yml 里显式指定服务商：

- id: web
name: '@deepseek-ai/dsh-web'
config:
searchProvider: prism-search

或者设置环境变量（效果相同）：

export DSH_WEB_SEARCH_PROVIDER=prism-search

结果结构

接缝的 web_search 输出 schema（additionalProperties: false）：

{
content?: string, // full-page markdown, rendered as the answer
sources: [{
url: string,
title?: string,
snippet?: string, // Firecrawl description
publishedAt?: string,
}],
truncated: boolean,
}

开发

node --experimental-strip-types --test test/index.test.ts # tests (11)
npx tsc -p tsconfig.json # build to lib/

许可证

MIT