awesome-jev 官方资源速查表:TypeSafe AI 文档、JS/Python SDK 与模型版本对照
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 项目是否靠谱的最快方式。
📌 模型版本对照:当前该用哪个 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 章节 收录了四条主流接入路径:
- Cloudflare AI:维护
typesafe/jev集成,接受状态与类型化问题 - Netlify AI Gateway:Netlify Functions 内零配置调用,凭据与计费由 Netlify 托管
- OpenRouter:
typesafe/jev-1.13固定版本 +jev-latest移动别名 - 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 更新的最佳来源:
- research/2026-09-20.md:最新一轮增量审查,新增 10 个框架集成 + 10 个社区项目,累计 155 条,并逐条给出固定 commit 的源码证据
- research/2026-09-19.md:上一轮完整审查记录
其中还收录了本地方案 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 条条目反复出现的设计模式。
