← 开源项目https://github.com/superagents-lab/jev-search
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 词条
暂无已建立的词条关联。