Skip to content
Back to search

dsh-web-search-pro

Enhanced, persistent web search plugin for DeepSeek Harness (multi-engine search, SQLite+LRU cache, platform backends, Playwright rendering)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/anweat--dsh-web-search-pro/badge.svg)](/listings/anweat--dsh-web-search-pro)

HTML

<a href="/listings/anweat--dsh-web-search-pro"><img src="/api/listings/anweat--dsh-web-search-pro/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 默认安装(面向 dsh-v0.2.0-rc.2 宿主;浏览器插件可选,需要读取渲染页 / 浏览器平台时一起装):
dsh plugin --profile web add @anweat/dsh-browser@0.2.0 dsh-web-search-pro@0.2.1
# 不需要浏览器能力时,只装本插件即可:
dsh plugin --profile web add dsh-web-search-pro@0.2.1
# 或本地目录 / tarball:
dsh plugin --profile web add ../dsh-browser ./dsh-web-search-pro
# 重启(web profile 关闭了 HMR):
dsh --profile web

> 两个插件都必须是 profile 的直接依赖:DSH 只激活直接依赖的 bundle layer,且标准 profile 可能设置 `autoInstallPeers: false`。不要只安装 Web Search Pro 后依赖 peer 自动补齐。 > pnpm 11 若拦截 Browser 的 OpenCLI 依赖安装脚本,会要求在 profile 的 `pnpm-workspace.yaml` 中明确决定 `allowBuilds: { '@jackwener/opencli': false }`(或在确实需要安装期下载 adapter 时自行审核后设为 `true`),再重试安装;隔离 profile 中禁用脚本后,已发布 Browser 的 OpenCLI 入口仍可运行。 > 本版只支持 `dsh-v0.2.0-rc.2` 与 Browser `^0.2.0`,宿主或浏览器插件仍在 0.1.x 线上的,请安装 `dsh-web-search-pro@0.1.15`。若你的 harness 是本地源码 checkout,版本号可能有出入——用 > `dsh plugin --profile web add ./<path>` 并在 profile 的 `pnpm-workspace.yaml` > 里对齐版本后重装即可。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 115 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # dsh-web-search-pro
  2. [English](./README.en.md) | 中文
  3. [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)的增强型网页搜索插件:多引擎搜索、平台搜索、持久化缓存和证据包,常驻上下文只有两个工具。
  4. - **证据包模式**:给 `search.run` 一句任务目标,返回的不是结果列表,而是按需求评分后的摘录和未满足的缺口,占用的上下文少得多。
  5. - **多引擎 + 平台来源**:ddg / bing / Exa / Jina 等网页引擎加 GitHub、B站、YouTube、小红书、知乎、Reddit、X、RSS 等平台,统一的探测、冷却、回退与历史;DeepSeek 搜索 / 抓取是“常用”来源(按请求计费)。
  6. - **登录由你自己完成**:需要登录的平台优先走 `opencli`(用你日常 Chrome 的登录态),插件没有登录窗口,也不读 Cookie。
  7. - **两个常驻工具**:`web_index`(目录)→ `web_call`(执行),27 个动作按需披露,约 800 字符常驻。
  8. - **持久化**:SQLite + 内存 LRU 双层缓存、查询历史、可再导入的站点提取规则。
  9. - **可视化设置**:一张设置卡片管理搜索顺序、Key、自定义 CLI 和评分模型,agent 的改动以覆盖层形式出现,可一键采纳或撤销。
  10. ## 兼容性
  11. | 项 | 范围 |
  12. |---|---|
  13. | dsh-web-search-pro | `0.2.4` |
  14. | DSH 宿主(peer) | `>=0.2.0-rc.2 <0.2.1-0 \|\| >=0.2.1-rc.2 <0.2.2-0 \|\| >=0.2.2-rc.1 <0.2.3-0`;实测 `0.2.0-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.4`、`0.2.1-rc.5`、`0.2.2-rc.1` |
  15. | cordis(peer) | `~4.0.4 \|\| ~4.1.0`(0.2.2 线宿主带 4.1.x) |
  16. | 可选配套 `@anweat/dsh-browser` | `^0.2.0`(0.2.1 线宿主上必须是 `0.2.2` 起;0.2.2 线宿主上请用 `0.2.3` 或更新) |
  17. | DSH 0.1.x 宿主或 dsh-browser 0.1.x | 固定使用 `dsh-web-search-pro@0.1.15`,不再更新 |
  18. **0.2.2 线的设置卡片通道**:宿主 0.2.2-rc.1 的 `connection.rpc.handle()` 在 cordis 4.1 下对外部插件抛错(根因在宿主 `dsh-client-connection` 的 `register()` 读 `owner.webServer`,而 cordis 4.1 按服务的定义处检查 `inject`)。插件经一个自带 `webServer` 的派生上下文调用 `handle`(`ctx.extend({ webServer: ctx.get('webServer') })`),只用公开的 Context API,不依赖宿主的私有方法;三条宿主线(0.2.0-rc.2、0.2.1-rc.5、0.2.2-rc.1)用同一写法。做法来自 [anweat/dsh-browser#49](https://github.com/anweat/dsh-browser/issues/49)(@shuaigekda)。挂载失败时插件在控制台打一行警告并照常运行(卡片的实时状态、agent 修改面板、CLI 试运行不可用)。详见 [CHANGELOG](./CHANGELOG.md) 与 [验证记录](docs/validation/2026-11-05-dsh-0.2.2.md)。
  19. 历史版本的兼容表见 [CHANGELOG](./CHANGELOG.md#兼容与发布通道历史),peer 范围的写法见 [兼容范围](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/compatibility.md)。
  20. ## 安装
  21. **DSH CLI**(装完重启 profile):
  22. ```bash
  23. # 只要搜索:
  24. dsh plugin --profile web add dsh-web-search-pro@0.2.4
  25. # 还要读取渲染页 / 浏览器平台:连同可选的浏览器插件一起装(两者都必须是 profile 的直接依赖)
  26. dsh plugin --profile web add @anweat/dsh-browser@0.2.3 dsh-web-search-pro@0.2.4
  27. dsh --profile web
  28. ```
  29. **DSH Desktop**:Desktop 的 profile 由应用管理,CLI 不能操作它。打开**插件**页 → **Add plugin**,填包名(可带版本,如 `dsh-web-search-pro@0.2.4`,写法同上面 `add` 后面那段)→ Install;对话框里还能选 **Registry**。非官方插件升级 = 先卸载再重装;国内镜像(如 npmmirror)可能晚同步,装不到新版本时把 Registry 换成 `https://registry.npmjs.org`。
  30. **本地目录 / tarball(开发用)**:`dsh plugin --profile web add ../dsh-browser ./dsh-web-search-pro`。
  31. 更多(新用户第一次安装的注意事项、排障)见 [安装与首次使用](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/install.md);升级见 [CHANGELOG](./CHANGELOG.md#从旧版本升级)。
  32. ## 第一次使用
  33. - **设置卡片**:`设置 → 插件 → 插件配置 → Web Search Pro`。顶部的状态摘要显示实际尝试顺序的默认引擎链、已配置 Key 的来源数、DeepSeek 是否就绪、待重启项等。
  34. - **查看后端**:让模型调用 `web_call` 的 `sources.status`,每个来源 / 平台的就绪状态和被跳过的原因都在里面。
  35. - **来源与密钥**:网页搜索和证据管线装完即用(ddg / bing 免 Key)。有 `DEEPSEEK_API_KEY` 时,默认搜索会先用**按请求计费**的 DeepSeek 搜索;不想用就在 `sources.disabled` 里写 `deepseek`。Exa、Jina、博查、GitHub 等 Key 在设置卡片的“来源”分组里写入(存进 DSH Credentials,不读回明文)。
  36. - **开箱默认值**:默认关闭 Jev(`evidence.jevMode: off`,证据评分用本地规则,不调用任何模型,也不需要任何模型 Key);只有配置了博查 Key 才会使用博查。
  37. - **可选依赖**:浏览器插件 `@anweat/dsh-browser`(`read.snapshot`、`read.fetch mode=playwright`、搜索页类平台;有 Chrome / Edge 就直接用,不用下载 Chromium);`npm i -g @jackwener/opencli` 加它的 Browser Bridge 扩展(小红书 / 知乎 / Reddit / X,用你日常 Chrome 的登录态,见 [平台登录态](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/platform-login.md));bili、yt-dlp、gh 等 CLI 由 `sources.deps` 检测。
  38. ## 快速示例
  39. 模型通过 `web_call({action, args})` 调用。证据包(传 `task` 或 `profile`):
  40. ```json
  41. {"action":"search.run","args":{"query":"node:sqlite busy timeout","task":"how to set a busy timeout in node:sqlite","profile":"docs_code"}}
  42. ```
  43. 搜单个平台(登录类平台走 opencli-first 的后端链):
  44. ```json
  45. {"action":"search.run","args":{"query":"机械键盘 轴体 推荐","task":"了解知乎上对机械键盘轴体的真实经验","profile":"experience","platform":"zhihu"}}
  46. ```
  47. 读页用 `read.fetch`(长页传 `offset` 续读),不知道用哪个来源就问 `search.recommend`。更多用法见 [搜索用法与证据包](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/search-and-evidence.md)。
  48. ## 工具与动作概览
  49. 常驻工具只有两个:`web_index({group?, action?, query?})` 渐进披露目录,`web_call({action, args})` 执行动作并返回统一信封。使用指引在随包的 skill `dsh-web-search-pro` 里。
  50. | 组 | 动作 | 用途 |
  51. |---|---|---|
  52. | `search` | `run` `recommend` | 多引擎 / 平台搜索与证据包;按任务推荐至多 3 个来源 |
  53. | `read` | `fetch` `contents` `snapshot` | 可读化抓取与续读;Exa 批量正文;浏览器快照 |
  54. | `history` | `list` `replay` `expand` `export` `delete` | 查询历史的列出、回放、展开证据块、导出、删除 |
  55. | `sources` | `status` `deps` `install` | 后端探测与诊断;外部依赖检测与安装 |
  56. | `rules` | `list` `upsert` `remove` `import` `export` | 按站点提取规则 |
  57. | `cache` | `clear` `stats` | 缓存清理与统计 |
  58. | `config` | `inspect` `set_order` `set_confidence` `upsert_cli` `remove_cli` `reset` `export` | agent 覆盖层:运行时调整搜索顺序、置信度、自定义 CLI |
  59. 完整参数、审批规则、输出预算与旧工具映射见 [工具与动作](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/tools-and-actions.md)。
  60. ## 常用配置
  61. 写在 `$DSH_HOME/settings.yaml` 的 `web-search-pro:` 段,或用设置卡片;几乎都是热更新。
  62. | 键 | 默认值 | 说明 |
  63. |---|---|---|
  64. | `engines` | `[ddg, bing, exa, seam, jina]` | 通用搜索的回退顺序 |
  65. | `sources.priority` / `sources.disabled` | 空 | 提前 / 完全不用的来源 id(如 `disabled: [deepseek]`) |
  66. | `searchMaxResults` | `8` | 普通搜索的默认结果数 |
  67. | `evidence.jevMode` | `off` | 博查 Jev 评分:`off` \| `shadow` \| `control` \| `hybrid`(付费,默认不调用) |
  68. | `evidence.sourcePolicy` | `default` | `anonymous-only` = 自动规划绝不用需要 Key / 账号 / 登录的来源 |
  69. | `deepseekFetch` | `false` | `true` = `read.fetch` 可用 DeepSeek Fetch API(按请求计费) |
  70. | `fetchDefaultChars` | `20000` | `read.fetch` 默认返回字符数 |
  71. | `toolSurface` | `indexed` | `flat` = 每个动作一个工具(仅对照与调试);**需重启** |
  72. | `registerProvider` | `false` | 让宿主内置 `web_search` / `web_fetch` 经过本插件;**需重启** |
  73. 需要重启插件的只有 `toolSurface`、`registerProvider`、`providerId`、`timeoutMs`、`memoryCacheEntries`、`dbPath`、`verbose`、`playwright.snapshotDir`。全部键与默认值见 [配置参考](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/config.md)。
  74. ## 文档索引
  75. 详细文档(中文)在 [docs/](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/README.md):
  76. - 使用:[安装与首次使用](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/install.md) · [搜索用法与证据包](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/search-and-evidence.md) · [工具与动作](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/tools-and-actions.md) · [历史管理](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/history.md)
  77. - 配置:[配置参考](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/config.md) · [设置面板](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/settings-panel.md) · [来源与引擎](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/sources.md) · [内置 web 工具路由](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/web-provider.md) · [Jev 评分](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/evidence-scoring.md)
  78. - 平台与 CLI:[平台登录态](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/platform-login.md) · [CLI 适配与自定义 CLI](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/cli-adapters.md) · [外部依赖](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/dependencies.md) · [自定义平台](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/custom-platforms.md) · [浏览器脚本与自动化分层](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/browser-scripts.md)
  79. - 版本与开发:[兼容范围](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/compatibility.md) · [CHANGELOG](./CHANGELOG.md) · [开发](https://github.com/anweat/dsh-web-search-pro/blob/master/docs/guide/development.md) · [设计与调研记录](https://github.com/anweat/dsh-web-search-pro/tree/master/docs/dev) · [验证记录](https://github.com/anweat/dsh-web-search-pro/tree/master/docs/validation)
  80. ## License
  81. MIT。路由控制面借鉴 Agent-Reach 的后端探测、顺序选择和失败冷却思路,核心逻辑为本项目原生 TypeScript 实现。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.