@anysearch/anysearch-dsh

中文文档
0.1.8发布于 2026/10/10MITTypeScriptES Module构建来源已验证近 30 天下载 1.5万

AnySearch web search and fetch providers plus advanced tools for DeepSeek Harness

原始使用文档
文档目录14 节
  1. 快速开始
  2. 面向 AI Agent
  3. 面向人类
  4. 提供什么
  5. 可选 API Key
  6. 工具
  7. 环境依赖
  8. 配置
  9. 管理插件
  10. 兼容性与限制
  11. 文档
  12. 社群与支持
  13. 开发
  14. 许可证
AnySearch Logo

@anysearch/anysearch-dsh

由 AnySearch 驱动,为 DeepSeek Harness 提供实时网页搜索与垂直领域搜索能力。

AnySearch AI Search npm 版本 MIT 许可证 DeepSeek Harness 插件

English | 简体中文

@anysearch/anysearch-dsh 将 AnySearch 作为插件接入 DeepSeek Harness。无需改变 Harness 使用方式,即可通过原生 web_search 和 web_fetch 获得实时网页搜索、URL 清洗正文、垂直领域搜索和批量搜索能力。

AnySearch 是面向 AI Agent 的搜索基础设施,覆盖公开网页,以及代码、金融、学术、法律、安全等专业数据源。

快速开始

面向 AI Agent

# 获取完整安装指南,通读全文,然后严格按步骤执行:
curl -fsSL https://raw.githubusercontent.com/anysearch-team/anysearch-dsh/refs/heads/main/docs/agent-installation.md

面向人类

将插件安装到 web profile:

npx -y @deepseek-ai/dsh plugin --profile web add @anysearch/anysearch-dsh

启动 DeepSeek Harness:

npx -y @deepseek-ai/dsh web

快速体验不需要 API Key。未配置时,请求使用 AnySearch 匿名额度。

提供什么

  • 通过 Harness 内置的 web_search 返回 AnySearch 搜索结果,来源包含标题、摘要和 URL,便于引用。
  • 通过 Harness 内置的 web_fetch 调用 AnySearch Extract,抓取并清洗指定公开 HTTP(S) URL 的正文。
  • 实时发现可搜索领域、垂直分类和支持的参数,再用标签、地区、语言和结构化参数执行高级搜索。
  • 一次并发执行一至五个搜索,单项失败不影响其他结果。
  • 高级搜索会保留没有来源 URL 的有效结构化结果;对于带网页来源的结果,可按需返回清洗正文。

可选 API Key

无需 API Key 即可体验。

注册 AnySearch 账号并配置 API Key 后,可获得每天 1000 次免费搜索调用额度。

访问 anysearch.com 注册并登录,然后前往 API Keys 获取。获取后,将凭据写入 $DSH_HOME/.credentials.yaml,默认位置是 ~/.dsh/.credentials.yaml:

ANYSEARCH_API_KEY: "as_sk_your_key"

插件会在每次操作时解析受管凭据,因此轮换凭据后,下一次请求即可使用新值,无需重启 DSH。启动进程的 ANYSEARCH_API_KEY 环境变量具有更高优先级。

可以检查最终组合配置,输出中不会出现真实凭据值:

npx -y @deepseek-ai/dsh --profile web --dump-config

工具

使用场景Harness 工具
普通网页搜索web_search
抓取并清洗指定 URLweb_fetch
查看可用领域和标签anysearch_capabilities
垂直或参数化搜索anysearch_search
一次执行一至五个搜索anysearch_batch_search

对于普通提示词,让 Harness 自动选择工具即可。模型可以先读取实时领域和参数定义,再执行专门搜索。

环境依赖

需要 Node.js 22.19 或 Node.js 24+、pnpm 11.7 和 DeepSeek Harness。DSH 插件命令使用 pnpm 管理 profile 依赖,因此 pnpm 必须位于 PATH 中。

Windows、Linux 和 macOS 使用相同的安装命令。安装前请确保 Node.js、npx 和 pnpm 均可从 PATH 直接运行。

配置

随包提供的 profile 层会自动将 AnySearch 设为现有 ctx.web 的搜索与抓取 Provider、启用 web_fetch,并挂载高级工具,默认无需修改。

如需自定义,请让 AI 助手(或手工)把下面的完整条目加入目标 DSH profile 的用户配置层,以覆盖随包提供的 id: web-search-anysearch 配置。保持 id 不变,完整替换 config,不要使用不同 ID 新增第二个 AnySearch Provider:

- id: web-search-anysearch
  config:
    apiKeyEnv: ANYSEARCH_API_KEY
    baseURL: https://api.anysearch.com
    maxRenderedContentChars: 12000
字段默认值用途
apiKeyEnvANYSEARCH_API_KEYDSH 凭据引用;缺失时使用匿名访问
baseURLhttps://api.anysearch.comAnySearch API 基础地址
maxRenderedContentChars12000单次高级工具调用向模型展示的结果正文字符上限

管理插件

更新:

npx -y @deepseek-ai/dsh plugin --profile web update @anysearch/anysearch-dsh

移除:

npx -y @deepseek-ai/dsh plugin --profile web remove @anysearch/anysearch-dsh

兼容性与限制

  • DeepSeek Harness 仍处于开发预览阶段,可能发布不兼容变更。
  • 当前源码覆盖从 0.0.1-rc.5 到 0.2.1-alpha.1 的 28 个已发布 DSH 版本,包括 0.1.5-rc.2。具体版本、验证范围和 npm 发布状态见兼容性说明。
  • 默认允许新版 DSH(包括 alpha、rc)安装,已测试版本列表不作为安装白名单;实际遇到兼容问题请提交 issue。
  • 网页提取通过 Harness 原生 web_fetch 暴露;插件不会再增加一个重复的 anysearch_extract 工具。
  • 请通过 DSH 管理的凭据文件或环境变量配置 API Key;DSH 设置页当前不提供第三方 Provider 凭据输入项。

文档

社群与支持

欢迎加入 AnySearch 社群,交流使用体验、反馈问题并获取技术支持。

  • GitHub Issues:提交问题报告和使用反馈。
  • 微信群:扫描下方二维码填写入群问卷,工作人员审核后会邀请你加入。
  • Discord 社群:扫描二维码或点击链接直接加入。
微信群入群问卷
微信群入群问卷二维码
Discord 邀请
Discord 邀请二维码

开发

git clone https://github.com/anysearch-team/anysearch-dsh.git
cd anysearch-dsh
pnpm install
pnpm run check

真实 AnySearch E2E 测试需要显式开启。匿名模式不会读取环境中的凭据:

ANYSEARCH_E2E=1 ANYSEARCH_E2E_ANONYMOUS=1 pnpm run test:e2e

许可证

MIT

版本与发布记录

@anysearch/anysearch-dsh 共发布 9 个版本,首次发布于 2026/08/14;过去 12 个月发布了 9 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.8latest2026/10/1028 天前
0.1.72026/10/0830 天前
0.1.62026/09/201 个月前
0.1.52026/09/181 个月前
0.1.42026/08/252 个月前
0.1.32026/08/242 个月前

关于 @anysearch/anysearch-dsh 的常见问题

@anysearch/anysearch-dsh 是什么?

AnySearch web search and fetch providers plus advanced tools for DeepSeek Harness

如何安装 @anysearch/anysearch-dsh?

在项目目录运行 npm install @anysearch/anysearch-dsh,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@deepseek-ai/cordis(>=4.0.1-rc.1 <5 || 4.0.5-alpha.1)、@deepseek-ai/dsh-web(*)、@deepseek-ai/dsh-tools(*)、@deepseek-ai/dsh-tool-web(*)、@deepseek-ai/dsh-credentials(*)、@deepseek-ai/dsh-system-prompt(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@anysearch/anysearch-dsh 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@anysearch/anysearch-dsh 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@anysearch/anysearch-dsh 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^22.19.0 || >=24.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@anysearch/anysearch-dsh 可以商用吗?

@anysearch/anysearch-dsh 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@anysearch/anysearch-dsh 的下载量有多少?

根据 npm 官方下载统计,@anysearch/anysearch-dsh 在 2026/10/06 – 2026/11/04 这 30 天内被下载 15,430 次,日均约 514 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@anysearch/anysearch-dsh 还在维护吗?

最新版本 0.1.8 发布于 2026/10/10(28 天前);至今共发布 9 个版本,其中过去 12 个月发布了 9 个;首次发布于 2026/08/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。