dsh-web-querit

English | 中文

Querit 网页搜索与整页抓取能力，以官方 ctx.web 能力接缝（web capability seam）的 provider 形式接入 DeepSeek Harness。它是 pi-querit-search 在 DeepSeek Harness 上的对应物：web_search（由 preset 按会话注册）与 web_fetch（由本包复用官方 dsh-tool-web 注册）工具保持官方形态，本包把它们的后端换成 Querit（POST https://api.querit.ai/v1/search 与 /v1/contents）。

在 Querit.ai 注册即可获得每月 1,000 次免费调用，无需信用卡。

快速开始

1. 按「安装与更新」装包，并按「接线」把两段补丁加进 profile 的 cordis.patch.yml。
2. 按优先级配置 API key：
   • 启动环境里的 QUERIT_API_KEY 环境变量，或
   • 凭据存储（$DSH_HOME/.credentials.yaml 加一行 QUERIT_API_KEY: <key>，热加载、无需重启），或
   • web-search-querit 行上的 apiKey 字面量（最不推荐，密钥不应进组合文件）。
3. 重启 profile 加载插件行。

插件首次加载时若解析不到 key，宿主日志会打印一条一次性警告；在配置 key 之前发起搜索会失败为 WEB_PROVIDER_CREDENTIAL_MISSING，错误信息同样写明了以上三种配置方式。

当前 harness 版本没有为外部插件提供设置页 UI（web 设置 API 只暴露固定命名空间白名单），所以所有配置都走组合补丁 + 凭据存储。

安装与更新

包已发布到 npm（dsh-web-querit），正常安装无需任何构建工具链：

dsh plugin --profile web add dsh-web-querit

（dsh plugin 会把参数转发给 profile 目录下的 pnpm；web 换成你的 profile 名。）

更新

dsh plugin --profile web outdated                 # 看看有没有新版本
dsh plugin --profile web update dsh-web-querit    # 在声明范围内升级

pnpm 11+ 对"刚发布几分钟"的版本有新鲜度防抖窗口，outdated/update 可能暂时看不到它。要立即安装某版本就用显式版本号：

dsh plugin --profile web add dsh-web-querit@<版本号>

其他安装来源

# GitHub Release 的 tarball（先从 releases 页面下载）
dsh plugin --profile web add ./dsh-web-querit-<版本号>.tgz

# 直接从 GitHub 安装（仓库已提交构建产物 lib/）
dsh plugin --profile web add github:MCapricorns/dsh-web-querit

仅当没有 pnpm 时兜底：手动解包到 <profile>/node_modules/dsh-web-querit，并在 profile 的 package.json 依赖里加上 "dsh-web-querit": "<版本号>"。注意手动解包的目录对 pnpm 不可见，dsh plugin remove 不会清理它。

接线

编辑 profile 的 cordis.patch.yml（$DSH_HOME/profiles/<profile>/cordis.patch.yml）：

# 添加插件行（同时注册 Querit provider 与 web_fetch 工具）
- insert:
    - id: web-search-querit
      name: 'dsh-web-querit'
      config:
        apiKeyEnv: QUERIT_API_KEY

# 把接缝的搜索与抓取路由到 Querit
- id: web
  config:
    searchProvider: querit
    fetchProvider: querit

补丁会整体替换目标行的 config，所以请把需要的键都写上。API key 可以通过凭据服务、启动环境的 QUERIT_API_KEY、或行内 apiKey 字面量提供。改完后重启 profile 生效。web-search-deepseek 行保留不动即可：接缝按配置的 id 选择 provider，随时可以一行补丁切回官方搜索。若某个 preset 自行注册了 web_fetch，请把本行 fetch 设为 false。

配置项

键	默认值	说明
apiKey	无	字面量 Querit API key（优先用 apiKeyEnv，避免密钥进配置文件）
apiKeyEnv	QUERIT_API_KEY	每次调用经凭据服务解析的凭据引用；缺失时调用失败为 WEB_PROVIDER_CREDENTIAL_MISSING
baseURL	https://api.querit.ai	API 基地址；可被 $QUERIT_BASE_URL 环境变量覆盖
timeoutMs	70000	单请求超时（毫秒）
count	5	无 maxResults 约束时的结果数（1–20）
timeRange	无	时间范围：d7/w2/m3/y1 或 YYYY-MM-DDtoYYYY-MM-DD
countries	无	国家偏好（17 个有效值）
languages	无	语言过滤（7 个有效值）
includeDomains	无	域名白名单
excludeDomains	无	域名黑名单
includeContent	false	请求句子级内容摘录（合并进 snippet）
chunksPerDoc	1	每结果内容块数（1–3）
fetchFormat	markdown	抓取格式：markdown/text/html
fetchCrawlTimeout	10	单页抓取超时（秒，1–60）
fetchMaxChars	8000	单页内容截断上限（字符）
fetch	true	是否注册 web_fetch 工具（当其他行已注册时设为 false）
fetchTimeoutMs	30000	web_fetch 工具协作超时预算（毫秒）
fetchMaxOutputChars	200000	单次 web_fetch 渲染输出上限（字符）

配置在哪改

当前 harness 版本没有为外部插件提供设置页 UI（web 设置 API 只暴露固定命名空间白名单），所以有两个配置入口：

1. 组合补丁（上面「接线」的 cordis.patch.yml）——改完需重启
2. 设置文档——$DSH_HOME/settings.yaml（与 .credentials.yaml 同一个 dsh 目录）。其中 web-search-querit: 段落覆盖行配置并热加载（设置服务监听该文件，实测无需重启）：

web-search-querit:
  count: 3
  timeRange: m3
  languages: [english]

每个字段的解析优先级：settings.yaml 段落 > cordis.patch.yml 行配置 > schema 默认值。API key 单独放 .credentials.yaml（或启动环境变量），不放 settings.yaml。

安全性

搜索结果与抓取内容一律视为不可信外部数据；API key 在所有错误输出中脱敏；响应体有大小上限；内容中的终端控制序列与 bidi 控制字符会被清除。

License

MIT