前言¶
在 DeepSeek Harness（DSH）里给 agent 接网页能力时，常见做法是依赖宿主自带的 web_search / web_fetch。它们能完成基本检索和抓取，但返回形态往往偏「原始网页」或字段较少，条数、正文长度、搜索语法和成本也不易在一套接口里统一控制。
@vfvrpq/dsh-search（仓库 439436269-ctrl/dsh-search）把 DeepSeek 官方的 Search / Fetch API 封装成三个 Harness 工具，向模型输出结构化结果（含 rerank 分、权威度、发布时间、长摘要等），并附带搜索操作符与可推算的计费口径。维护者为 439436269-ctrl，在社区目录中归类为「联网工具」。
这是什么¶
一句话：@vfvrpq/dsh-search 是面向 DSH 的联网插件，基于官方 Search/Fetch 接口，提供搜索、单页抓取与「搜索 + 多页正文」的一站式研究能力；实现上为三个工具、一个配置块、零运行时依赖（见仓库 README）。
插件向 agent 提供的是结构化网页结果，而不是整页 HTML 堆砌；相对内置联网工具，README 强调的差异包括：搜索语法、条数与正文可控、成本可推算。
三个工具与计费口径¶
安装成功后，工具会出现在工具表中，无需重启 DSH（升级插件时才需要重启）。
| 工具 | 作用 | 计费请求数 |
|---|---|---|
deepseek_search |
搜索，返回标题/URL/snippet/summary/可选正文/日期/权威度/rerank 分 | 1 |
deepseek_fetch |
单页转 Markdown（标题 + 正文） | 1 |
deepseek_research |
搜索并抓取前 N 页正文，一次给出研究结论 | 1 + N |
成本方面（README 原文）：
- 约 5 元 / 1000 次成功请求，即单次约 0.005 元；Search 与 Fetch 同价。
- 仅 HTTP 200 且产生结果时计费；空结果、失败、超时不计费。
count不改变单价，宜在一次请求中取够条数，避免拆成多次小请求。- Search 与 Fetch 各自账号级限速 5 QPS；超限返回 429，插件会按配置退避重试。
判读结果时，README 建议：rerankScore >= 1.5 视为优质结果（渲染中会标 ★），authority >= 3 视为高权威。summary 为二手摘要；版本号、日期、价格、API 字段等应以 deepseek_fetch 原文核实，引用时给出原始 URL。
deepseek_search 与查询语法¶
deepseek_search 可在 query 中书写操作符，或通过参数传入。支持的操作符包括：site:、-site:、-词、-"短语"、"精确"、lang:、after:、before:。
安装与启用¶
从 npm 安装已发布版本（命令来自仓库 README）：
dsh plugin --profile desktop add @vfvrpq/dsh-search@0.1.0
若从源码打包安装：插件依赖 @deepseek-ai/*，须使用 tgz 包，目录软链可能导致宿主无法解析依赖。流程为先 pnpm pack，再执行：
dsh plugin --profile desktop add /绝对路径/vfvrpq-dsh-search-0.1.0.tgz
package.json 标明运行环境为 Node >=22，与 DSH 0.2.0-rc.2 在插件元数据中标记为 compatible。许可证为 MIT。
安装前建议自行查看仓库源码与许可证；插件以当前 DSH 进程权限运行，API Key 的解析会读取环境变量与用户侧密钥文件（见下文），请勿将密钥写入可被他人读取的配置。
典型用法¶
下列示例来自 README，可在工具调用中复现：
deepseek_search query="llama.cpp 安装" site="github.com" after=2025 count=5
deepseek_fetch url="https://api-docs.deepseek.com/zh-cn/guides/search"
deepseek_research query="DeepSeek V4 上下文长度" count=5 top=2
配置项可在 profile 中调整（默认值见下表）。apiKey 默认为空；README 明确建议不要把 key 写进 profile，而依赖运行时四层解析。
| 键 | 默认 | 说明 |
|---|---|---|
apiKey |
"" |
空则按四层顺序解析 |
baseUrl |
https://api.deepseek.com |
仅在使用代理时修改 |
defaultCount |
5 |
未传 count 时的条数 |
maxContentChars |
8000 |
deepseek_search 每条正文上限 |
fetchMaxChars |
20000 |
deepseek_fetch 正文上限 |
timeoutMs |
30000 |
单请求超时 |
maxRetries |
2 |
408 / 429 / 5xx 重试次数 |
promptEnabled |
true |
是否向系统提示贡献用法章节 |
promptOrder |
55 |
该章节排序 |
Key 解析顺序：
- 插件配置
apiKey - 环境变量
$DEEPSEEK_API_KEY ~/.secrets/keys.env中的DEEPSEEK_API_KEY=...$DSH_HOME/.credentials.yaml里refs: DEEPSEEK_API_KEY: sk-...
适用场景与已知边界¶
适合需要在 DSH 中统一使用官方 Search/Fetch、并希望 agent 拿到结构化字段与可控条数/正文的场景；需要一次搜索并多读几页正文做归纳时，可用 deepseek_research 减少往返。
README 列出的边界包括：
- 无法抓取需登录、强交互或非 HTML 响应的页面，此类需求应使用浏览器自动化类插件。
- 部分 SPA 文档站对不存在路径仍返回 200 与站点壳内容；若正文出现首页标语，可能是 fallback，需人工判断。
- Fetch 返回的 Markdown 可能对部分标点做反斜杠转义，属上游产物，可按需 unescape。
社区插件目录 skillhub.cn 上的 dsh-search 页 与 GitHub 仓库相互独立索引；目录站点与 DeepSeek / 幻方无官方从属关系，安装与计费以仓库文档与 DeepSeek API 说明为准。
结尾¶
@vfvrpq/dsh-search 把官方 Search/Fetch 收敛为 deepseek_search、deepseek_fetch、deepseek_research 三个工具，用结构化输出和明确计费规则降低 agent 联网时的噪声与试错成本。进一步了解可访问 插件目录页 与 GitHub 仓库。
