项目档案应用项目

superagents-lab/jev-search 是什么？用途、安装与使用指南

superagents-lab/jev-search：Jev Search是基于TypeSafe Jev模型与Search1API构建的Web搜索应用，支持自然语言输入自动选择搜索源、时间范围与查询本页整理它解决什么问题、适用场景、安装方式和使用方法。

169TypeScriptStar 于 2026年9月18日2026年9月19日更新

查看 GitHub 仓库打开项目主页

AI 总结

Jev Search是基于TypeSafe Jev模型与Search1API构建的Web搜索应用，支持自然语言输入自动选择搜索源、时间范围与查询词，提供带相关性评分的多引擎可溯源搜索结果，降低搜索门槛提升检索效率。

中文项目介绍

Jev Search是由Search1API开发的Web搜索应用，集成TypeSafe的Jev大模型实现自然语言搜索能力，核心价值是降低搜索门槛、提升检索效率。传统搜索需要用户手动配置筛选条件、跨多引擎检索繁琐，且查询词优化依赖用户经验。本项目通过Jev的意图理解能力，自动完成查询词优化、搜索源选择、时间范围判断，无需用户手动设置硬编码筛选条件。项目支持Google、DuckDuckGo、Yandex等通用搜索引擎，以及Hacker News、Reddit、GitHub、arXiv、YouTube等垂直搜索源，多引擎并发检索，单引擎故障不影响其他结果返回；Jev会对所有结果做相关性评分，按相关性、引擎共识、原始排序合并去重后流式返回，同时提供可编辑的筛选标签支持用户手动调整搜索参数。搜索结果仅返回原始链接与摘要，无生成式回答，保证结果可溯源，适合搜索技术文档、开源项目信息、垂直平台特定时间范围内容等场景。

详细信息与使用说明

1. 项目定位与用途

Jev Search是Search1API开发的智能Web搜索应用，集成TypeSafe的Jev大模型与Search1API搜索服务，核心定位是让用户通过自然语言描述搜索需求即可完成检索，无需手动配置筛选条件。应用自动完成意图理解、搜索源选择、时间范围判断与查询词优化，最终返回带相关性评分的原始搜索结果链接与摘要，不生成式回答，保证结果可溯源。

2. 解决的问题

传统搜索流程存在三大痛点：一是用户需要手动配置搜索源、时间范围等筛选条件，操作门槛高；二是跨多引擎检索需要逐个切换，效率低下；三是普通用户缺乏查询词优化经验，容易得到不匹配的搜索结果。Jev Search通过Jev模型的意图理解能力自动完成全流程配置，支持多引擎并发检索，单引擎故障不影响整体结果，同时通过相关性排序提升结果匹配度，解决上述痛点。

3. 适用场景

Jev Search适合以下搜索场景：一是自然语言搜索技术文档、开源项目相关信息；二是搜索Hacker News、GitHub、arXiv等垂直平台的特定时间范围内容；三是跨多引擎对比同一查询的搜索结果；四是需要可溯源原始链接与摘要、无需生成式回答的搜索需求。用户仅需输入自然语言格式的搜索请求即可获得高质量结果。

4. 安装方式

Jev Search本地开发需Node.js 22.12+与pnpm 10.8.0环境。安装步骤为：克隆仓库后进入项目目录，执行corepack enable启用pnpm，再执行pnpm install --frozen-lockfile安装依赖；复制.dev.vars.example为.dev.vars，配置SEARCH1API_API_KEY与TYPESAFE_API_KEY两个密钥；最后执行pnpm dev即可启动本地服务，访问http://localhost:3030即可使用。

5. 使用方式

本地开发阶段访问http://localhost:3030，在搜索框输入自然语言搜索请求即可，可通过界面上的筛选标签手动覆盖搜索源、时间范围等参数。若需部署到Cloudflare Workers，需先配置wrangler、创建KV缓存命名空间与速率限制命名空间，通过wrangler secret上传provider密钥后，执行部署命令即可将服务发布到Cloudflare平台。

6. 实现特点

Jev Search采用流式输出设计，POST /api/ask接口返回换行符分隔的JSON格式数据，包含意图识别、进度计数、分通道结果、流程完成等事件。每个搜索引擎有15秒超时限制，整体请求超时30秒，Google会提前启动预搜索；成功非空的引擎响应会被缓存10分钟到6小时，缓存时间根据搜索时间窗口动态调整。测试用例已mock所有provider，无需API密钥即可运行，构建流程不会调用任何外部provider服务。

思维导图

jev-search

前端界面

React 19 + TanStack Start

Tailwind CSS 4 样式

搜索框/结果/筛选组件

流式结果展示

搜索核心流程

意图理解（TypeSafe Jev）

多引擎并发检索

结果合并去重

常见问题

Jev Search需要哪些API密钥？

需要Search1API的SEARCH1API_API_KEY和TypeSafe的TYPESAFE_API_KEY，本地开发时配置在.dev.vars文件中，Cloudflare部署时通过wrangler secret上传。

Jev Search支持哪些搜索源？

支持Google、DuckDuckGo、Yandex等通用搜索引擎，以及Hacker News、Reddit、GitHub、arXiv、YouTube、Wikipedia、IMDb、WeChat、X等垂直搜索源，多引擎并发检索，单引擎故障不影响其他结果返回。

本地开发如何启动Jev Search？

需Node.js 22.12+和pnpm 10.8.0，克隆仓库后执行corepack enable、pnpm install --frozen-lockfile安装依赖，配置好API密钥后执行pnpm dev，访问http://localhost:3030即可使用。

Jev Search的搜索结果是如何排序的？

由TypeSafe的Jev模型对每个结果做相关性评分，结果按URL合并去重后，综合相关性得分、引擎共识度、原始排序权重排序，低分结果会单独分组展示。

Jev Search可以部署到哪些平台？

官方支持部署到Cloudflare Workers，需配置Cloudflare账号的Workers、KV服务，创建缓存命名空间与速率限制命名空间后，通过wrangler上传密钥并执行部署即可。