awesome-jev 官方资源速查表:TypeSafe AI 文档、JS/Python SDK 与模型版本对照

原创2026-11-16 17:55:19740 阅读

awesome-jev 官方资源速查表:TypeSafe AI 文档、JS/Python SDK 与模型版本对照

awesome-jev 是一个经源码审查的 Jev 项目精选清单,收录了 155 个基于 Jev——TypeSafe AI 推出的 System One 快速决策模型——构建的开源项目。本文作为 awesome-jev 官方资源速查表,帮你一键定位 TypeSafe AI 官方文档、JavaScript 与 Python SDK、JS/Python SDK 版本更新,以及当前 Jev 模型版本对照,无需在长清单里大海捞针。

1️⃣ 速查表怎么用:按目录定位资源

README.md 就是这张"速查表"的总目录,所有官方资源都带源码或文档出处。新手建议按下面的目录顺序阅读:

章节 内容 适合谁看
Start here 决策流程、三种问题原语、适用与不适用场景 第一次接触 Jev 的人
Official resources TypeSafe AI 官方文档与 SDK 入口 找文档的人
SDKs and developer tools 官方 + 多语言社区 SDK、CLI、MCP 选 SDK 的人
Guides and cookbooks 官方 cookbook 与示例 动手实践的人

💡 提示:每条条目都标注"Jev 决定什么、确定性代码做什么",这是判断一个 Jev 项目是否靠谱的最快方式。

awesome-jev 收录的 Ollaya 项目:本地运行 Jev 兼容接口的开放决策模型

📌 模型版本对照:当前该用哪个 Jev?

根据 README.md 的"Current model"说明,对照如下:

别名 / 版本号 指向 说明
jev-1.13.0 当前稳定版 官方文档化的模型版本
jev-latest jev-1.13.0 稳定别名,会随版本移动
jev-preview jev-1.13.0 预览别名,同样指向 1.13.0
jev-1.14.0 评测中出现 部分独立评测已测试,接入前建议先查官方模型页

⚠️ 关键提醒:对比评测结果时请固定版本号(pin the version),因为 jev-latest 是移动指针。9 月 18 日 OpenRouter 上出现的 jev-1.13 上架记录只是服务商上架日期,并非新的上游模型版本(见 README.md 动态区)。

📚 官方文档与 SDK:一步到位的资源清单

来自 README.md 的 Official resources 章节:

  • 产品总览:TypeSafe AI 官网,含早鸟体验入口
  • 官方文档:docs.typesafe.ai,涵盖概念、问题原语、API、模式与 SDK 指南
  • 发布博客:System One 模型与 Jev 的正式介绍,含 RLCD 训练方法与性能声明
  • typesafe-sdk-js:官方 TypeScript / JavaScript SDK,答案类型自动推断
  • typesafe-sdk-python:官方 Python SDK,支持同步与异步调用
  • system-one-adapter-python:对比 System One 接口与 LLM 提供方的即用适配器
  • skills:官方 Agent 技能包,用于构建与评估 System One 工作流
  • 模型与别名页:版本 ID、限制、定价,以及 stable / preview 别名的区别
  • Confidence 页:讲清 Choice/Score 的 confidence 与答案概率的区别(Noul 没有单独的 confidence 字段)
  • Jev 1.13 局限性说明:官方一手披露的算术、日期、干扰项、对抗性状态等短板

🐍 JS SDK vs Python SDK,怎么选?

  • JavaScript / TypeScript 项目:选 typesafe-sdk-js,答案类型可从问题类型自动推断,前端与 Node 场景友好
  • Python 项目:选 typesafe-sdk-python,同步/异步双模式;注意 9 月 18 日发布的 0.7.0 版本 是一次破坏性更新——序列化从 msgspec 改为 Pydantic,并新增 response_model 参数,升级前务必读 Release notes
  • Rust、Go、Java、Ruby、Elixir、R、Kotlin 等:见 SDKs and developer tools 章节,社区已覆盖数十种语言的客户端,还有 jev-mcp、jev-axi 等 MCP 与命令行工具

🌐 提供商接入:不改代码也能用 Jev

Provider integrations 章节 收录了四条主流接入路径:

  1. Cloudflare AI:维护 typesafe/jev 集成,接受状态与类型化问题
  2. Netlify AI Gateway:Netlify Functions 内零配置调用,凭据与计费由 Netlify 托管
  3. OpenRouter:typesafe/jev-1.13 固定版本 + jev-latest 移动别名
  4. Vercel AI Gateway:通过 AI SDK 的实验性 evaluate 接口做类型化评估

框架侧同样值得看:LangChain(Python/JS)、Pydantic AI、LiteLLM、Rig、Composio、Effect、BAML、Ax、TanStack AI 均已出现可审查的 Jev 集成(Framework integrations 章节)。⚠️ 注意:出现在默认分支 ≠ 已随稳定版发布,依赖某个包之前请先检查对应仓库。

🧭 决策原语 30 秒速览

  • Choice:从选项里选一个
  • Score:按有序评分标准给档级
  • Noul:返回 0–1 的"是"概率

记住这个形态:程序状态 + 类型化问题 → 受约束答案 + 概率 → 确定性应用代码(Start here 章节)。另外,托管版 Jev 是纯文本输入,浏览器/音频/图像类项目需自行提供提取后的文本或结构观察结果。

📝 版本动态与研究笔记

仓库内置两轮生态审查笔记,是追踪 awesome-jev 更新的最佳来源:

其中还收录了本地方案 Ollaya:一个 Rust 守护进程,把开放决策模型(Laya、decider、NLI、GLiClass)放在 Jev 兼容的 /v1/systemone 接口之后本地运行,现有 Jev 客户端改一个 TYPESAFE_BASE_URL 即可切换(Ollaya 条目)。

✅ 参与前必读

想把自己的 Jev 项目提交进 awesome-jev?先读 CONTRIBUTING.md,核心要求只有 4 条:公开可访问、有具体的 Jev 决策任务、写清"Jev 决定什么 / 代码做什么"、不做无依据的性能或安全声明。开源复现类项目请放入 Open reproductions 章节。

🧭 写在最后:一个重要提醒

清单在 Start here 中明确标注:schema 合法 ≠ 决策正确。务必在自己的数据上验证、校准阈值,把高影响动作留在确定性代码之后,并保留人工兜底——这也是 awesome-jev 全部 155 条条目反复出现的设计模式。

登录后查看全文
awesome-jev