JEV4PG 官方项目指南

JEV 理解语义。
PostgreSQL 精确执行。

jev4pg 是围绕 JEV 与 PostgreSQL 构建的开源查询框架。这里是项目的官方指南。它将自然语言转 SQL 与 JEV 类型化算子结合,用于文本筛选、提取、排序和验证。关联、计算和事务由 PostgreSQL 执行;有关含义的问题由 JEV 评估。

jev4pg 项目 · 更新于 2026 年 10 月 4 日 · Apache 2.0

三种能力,各有分工。

能力输入可检查的输出
自然语言转 SQL自然语言问题和已授权的数据目录。生成的 SQL、问题解释与结果。执行前可检查或修正计划。
语义 SQL文本记录、明确的语义问题,以及常规 SQL 筛选条件。类型化判断、来源证据与执行状态。精确关联和计算仍由 SQL 完成。
概率嵌入(原生预览)固定的问题与答案类别定义,在各条记录间保持一致。所有答案的概率分布、展开后的向量,以及兼容记录间的本地距离比较。

互不依赖的语义任务在配置的限额内并发执行,共享上下文的问题可以批量评估。判断阈值改变时,兼容的观测结果可以复用;跳过的任务不会被当作否定答案。

实现说明:自然语言查询 · 算子参考 · 原生阶段计划

可以复现的查询。

“按供应商汇总交付数量,从大到小排序。”项目的交付数据教程记录了以下生成查询:

SELECT
  SUM("r0"."quantity") AS "result_1",
  "r0"."supplier" AS "result_2"
FROM "deliveries" AS "r0"
GROUP BY "r0"."supplier"
ORDER BY SUM("r0"."quantity") DESC NULLS LAST;

在教程数据上,结果为 Birch:36、Aster:30、Cedar:8。总量由 SQL 聚合计算。这是具体示例结果,并不代表任意自然语言问题都能被正确理解。

运行教程并检查数据 · 查看记录的查询与结果

以 JEV 为核心的 PostgreSQL 原生框架。

原生开发预览将 Rust 语义算子放在 PostgreSQL 17 内执行。相互独立的 JEV 阶段可以并行运行,有依赖的阶段则等待所需证据。关系关联与聚合由 PostgreSQL 完成,语义问题交由模型评估。

框架保留兼容的答案概率,在判断阈值变化时复用证据。可解释嵌入使用具名问题及其答案分布,使每个坐标都有明确含义。正式工作台与原生预览各有独立的部署路径。

原生安装 · 并行原生计划 · 可解释嵌入

每个坐标都有明确含义。

开发版本中的 jev_native.embed 用同一组问题评估每条记录。问题可以使用真假答案、具名类别或评分等级。每个答案都会保留,因此一条记录产生一个“问题 × 答案”概率矩阵和展开后的向量。

一条支持消息的示意分布
问题答案分布
是否要求进一步行动?否 0.20 · 是 0.80
是否报告问题已解决?否 0.70 · 是 0.30

展开向量为 [0.20, 0.80, 0.70, 0.30]。这些数值仅解释表示方式,并非测得的模型置信度。一组定义可包含 1–32 个独立问题。未评估的项目保持 null 和 NOT_EVALUATED 状态,不会变成零概率。

jev_native.embedding_distance 比较具有相同问题定义、坐标和评估器身份的完整嵌入。它计算各问题 Hellinger 距离的均方根,无需再次调用模型。检索质量取决于问题设计和模型提供方;项目不宣称它普遍优于稠密向量检索。

嵌入接口与限制 · 可运行的嵌入 SQL

把不同证据组合起来。

以下为应用设计示例,并非已部署客户案例。请使用自己数据中的结构关系、领域定义和明确的审核策略。

客户支持

独立评估行动请求、客户影响和主题。把判断与账户及工单数据关联,用 SQL 统计工作量,并保留不确定案例供审核。

供应商评估

精确筛选交付日期和数量,再按明确的评估规则分析事件描述。按供应商汇总,同时保留每个判断对应的原文证据。

事件调查

从报告提取类型化实体,关联已授权的事件记录,分别评估紧急程度和影响范围。在所需证据齐备后再合并结果。

应用集成 · 文本提取与审核 · 依赖与并行阶段

选择 jev4pg 前,先了解这些。

jev4pg 就是 JEV 模型吗?

不是。jev4pg 是 PostgreSQL 应用与算子层,通过配置接入 JEV 提供方,不包含模型权重。接口支持 TypeSafe、兼容的 HTTP 服务和本地 Python 适配器。混合规划还需要 LLM 提供方。查看模型接入说明。

自行部署就代表推理完全在本地吗?

只有配置合适的本地模型服务时才是如此。使用托管推理时,选定的上下文字段会发送给提供方。接入现有 PostgreSQL 数据避免了整表复制,但不自动意味着模型处理留在本地。

“自发展”具体指什么?

有用的定义、证据和修正可以成为经过审核、能够复用的数据库特征。新定义在提升为正式特征前需要审核,并非数据库在后台自行改写应用代码。查看能力边界。

项目为什么有不同名称?

jev4pg 曾以 JevSDSQL 和 jevsd-pg 名称发布。当前网站为 jev4pg.com,仓库为 Sheltercosmo/jev4pg。为兼容已有安装,部分旧命令和数据库标识符仍然保留。

相关研究:语义查询与 AI 数据系统。

以下论文为语言模型与关系查询的结合提供研究背景。它们介绍的是其他系统,论文中的结果并非 jev4pg 的性能评测。

jev4pg 当前文档中的重点是 JEV 类型化判断、证据复用,以及 PostgreSQL 原生开发路径。已实现行为请查看项目的算子参考与原生计划文档。

了解 JEV 与 PostgreSQL 生态。

以下独立维护的项目提供了使用类型化判断与 PostgreSQL 的其他方式:

jev4pg 将自然语言查询工作台、语义算子、可复用证据与原生开发预览组合起来。选择时可以比较判断执行的位置、部署要求,以及需要检查和保留的证据。

选择部署路径。

正式版本 v0.6.0:网页工作台、HTTP API、Python 语义执行引擎和异步 SQL 任务。开发分支 main:Rust 原生预览,包含概率嵌入,面向 Linux 上的 PostgreSQL 17。原生语义函数可以不依赖 Python 服务运行;原生持续维护特征和语义写入审核仍在路线图中。

固定部署请使用发布标签。体验原生开发版本前,请先检查兼容性和模型提供方要求。