W
AI-Wiki
← 开源项目

superagents-lab/jev-search

已整理
https://github.com/superagents-lab/jev-search

Jev Search 帮助用户用日常语言在多个网页来源中查找信息,并按相关性整理出链接和摘要,而不是直接生成答案。它适合需要更透明地比较搜索结果、筛选来源和时间范围的用户,也适合想自托管自然语言搜索应用的开发者。

项目简介

Jev Search 帮助用户用日常语言在多个网页来源中查找信息,并按相关性整理出链接和摘要,而不是直接生成答案。它适合需要更透明地比较搜索结果、筛选来源和时间范围的用户,也适合想自托管自然语言搜索应用的开发者。

官方仓库资料

主要语言
TypeScript
许可证
MIT
默认分支
main
Stars
426
Forks
53
Open Issues
1
仓库状态
正常运行
派生仓库
非 Fork
数据采样
2026/9/23 19:06:00
资料抓取
2026/9/23 19:06:00
首次收录
2026/9/23 19:04:11

Topics:仓库未提供

AI 整理 · 基于已抓取的官方资料

核心功能

  • 支持用自然语言描述搜索需求
  • 自动选择搜索来源、时间范围和查询词
  • 支持用户覆盖来源和时间筛选条件
  • 通过 Search1API 调用 Google、DuckDuckGo、Yandex 以及 Hacker News、Reddit、GitHub、X、arXiv、YouTube、Wikipedia、IMDb、WeChat 等垂直来源
  • 并发调用多个搜索来源,单个来源失败不会丢弃其他来源结果
  • 对搜索结果进行相关性评分,并显示可见的相关性分数
  • 按 URL 合并结果,并根据相关性、引擎一致性和原始排名排序
  • 以流式 newline-delimited JSON 返回搜索进度和结果
  • 支持安装为浏览器应用,缓存离线页面
  • 支持多个 Jev provider:TypeSafe、Cloudflare Workers AI、Vercel AI Gateway
  • 支持 Cloudflare KV 缓存搜索引擎响应
  • 包含速率限制、同源检查和部署配置说明

适用场景

  • 搜索某个主题在 Hacker News、Reddit、GitHub 等社区或平台上的讨论
  • 查找近期论文、技术文章或新闻结果
  • 按时间范围筛选搜索结果
  • 比较多个搜索来源返回的网页结果
  • 构建或自托管一个不生成答案、只展示链接和摘要的搜索应用
  • 在 Cloudflare Workers 上部署带缓存和限流的搜索服务

使用方式

hosted_demo: https://jev.s1.dev local_development: - 需要 Node.js 22.12+ 和 pnpm 10.8.0

  • 需要 Search1API API key
  • 需要至少一个 Jev provider 凭据:TypeSafe、Cloudflare Workers AI 或 Vercel AI Gateway
  • 运行:git clone https://github.com/superagents-lab/jev-search.git
  • 进入目录:cd jev-search
  • 启用 corepack:corepack enable
  • 安装依赖:pnpm install --frozen-lockfile
  • 复制配置:cp .dev.vars.example .dev.vars
  • 在 .dev.vars 中设置 SEARCH1API_API_KEY 和至少一个 Jev provider key
  • 启动开发服务:pnpm dev
  • 打开 http://localhost:3030 common_commands: - pnpm generate-routes
  • pnpm cf-typegen
  • pnpm test
  • pnpm build
  • pnpm exec wrangler deploy --dry-run deploy_to_cloudflare_workers: - 需要 Cloudflare account,并启用 Workers 和 KV
  • 运行 pnpm exec wrangler login
  • 在 wrangler.jsonc 中设置 Worker name、路由、KV namespace 和 rate-limit namespace
  • 上传 SEARCH1API_API_KEY secret
  • 上传至少一个 Jev provider secret,例如 TYPESAFE_API_KEY
  • 运行 pnpm cf-typegen
  • 运行 pnpm test
  • 运行 pnpm run deploy:dry-run
  • 运行 pnpm run deploy api: - 应用从 POST /api/ask 流式返回 newline-delimited JSON
  • 事件包括 intent、found、lane 和 done

技术特点

  • 主要语言为 TypeScript
  • 应用使用 TanStack Start、React 和 Cloudflare Vite plugin
  • 部署目标为 Cloudflare Workers
  • 搜索请求会发送给 Search1API 和响应的 Jev provider
  • Jev provider 会接收请求内容以及结果标题和摘要,用于意图理解和相关性评分
  • 每个搜索引擎有 15 秒 deadline,整体请求 deadline 为 30 秒
  • Google 可能在 Jev 解释问题时先进行 speculative search
  • 成功且非空的搜索引擎响应会按时间窗口缓存 10 分钟到 6 小时
  • 可选的 s 来源列表最多为当前支持来源数量,README 中说明目前过滤前为 12 个条目
  • 重复的有效来源会合并,并保留首次出现顺序
  • 测试会 mock providers,不需要 API keys
  • 构建过程不会调用 provider
  • 生产构建会注册 service worker,但不会拦截 /api/ask
  • 应用代码采用 MIT license
  • 该项目是独立项目,不是官方 TypeSafe 产品

限制与边界

  • 不会生成答案,只提供链接和摘要
  • 搜索需要网络连接;安装为应用后只缓存离线页面,不缓存结果
  • 相关性百分比是模型判断,不代表已验证的准确性
  • 搜索摘要可能不正确、不完整或过时
  • 日期过滤和 Newest 排序依赖 Search1API 的 published_date,在缺失时回退到摘要中的日期,未知日期仍可能保留
  • 选择和排序现有结果不会验证网页内容中的主张
  • 每次搜索可能产生多个可计费 provider 调用
  • 同源检查是浏览器边界,不是身份认证
  • Cloudflare Workers 请求日志可能包含带搜索查询的请求 URL
  • 托管 demo 会加载 Cloudflare Web Analytics beacon
  • 页面加载 Google Fonts
  • 结果链接会跳转到第三方网站
  • Cloudflare KV 可能存储查询派生的缓存键和结果摘要,具体 TTL 取决于配置
  • Jev provider 和模型覆盖情况可能变化
  • 来源或时间筛选变更触发的搜索也会计入同一速率限制

README

README 介绍了 Jev Search 的定位:使用自然语言搜索开放网页,由 Jev 理解请求、选择查询条件并对 Search1API 返回的结果进行相关性排序。文档详细说明了搜索流程、支持来源、流式 API、缓存和超时策略、本地开发步骤、Cloudflare Workers 部署流程、Jev provider 配置、数据处理与限制、项目目录、许可证和图标归属。

关联 Wiki 词条

暂无已建立的词条关联。