更新日志：Jev 模型与 SDK 版本时间线

💡 目标：8 分钟把 Jev 更新日志一次看完。Jev 的「更新」有三条线——模型（jev-1.12 → 1.13 → 1.14.0）、Python SDK（typesafe-sdk v0.5.7 → v0.7.5）、JavaScript SDK（@typesafe-ai/sdk v0.5.7 → v0.7.0）——这一页拼出完整时间线：各自更新了什么、哪些是破坏性变更、怎么升级怎么验证。更新时间 2026-11-04，事实全部来自官方 changelog、官方文档与官方博文。

学完你能做什么

一张总表说出三条版本线在 2026 年 9–10 月的发布顺序，以及 2026-10-14 这天「模型 + 两个 SDK」同步更新了什么
说出 jev-1.14.0 的更新定位：全局小改进、多语言增益最大，外加 danger zone 三特性（Images / Box / Long-Context）
列出两个 SDK 的破坏性变更（Score.criteria 改列表、msgspec→pydantic、Node 22+），升级前知道要查哪几处
用可复制的命令升级 typesafe-sdk / @typesafe-ai/sdk，并验证装到的版本号
知道 jev-latest 别名什么时候切换、官方的弃用预告政策（60 天 / 30 天），以及调过阈值的系统该怎么锁版本

你现在的困境

生产环境调好的 confidence 阈值，怕新版本一发布答案悄悄变——想第一时间知道「更新了什么、影响不影响我」
官方更新散在三处：模型发博文、Python 和 JavaScript 各自一份英文 changelog，没有统一的中文时间线
想升 SDK 又怕踩破坏性变更：v0.7.0 换了序列化库、JS 版把 Node 门槛提到 22+，不查清楚不敢动手

什么时候用这一招

当你需要：

新版本发布后评估「要不要跟」：看更新内容，决定别名跟随还是锁定版本 ID
升级 SDK 前过一遍破坏性变更清单
排查「答案怎么变了」：先对时间线，确认是不是别名漂移，而不是先怀疑自己的代码

而且不想：

翻三份英文原文自己拼时间线
上线后才发现踩了官方早就公布过的破坏性变更

🎒 开始前的准备

本页是速查型页面，没有硬性前置；以下按需准备：

（可选）跑过安装与第一个请求，见过 model 字段和响应长什么样
（可选）要升级 SDK：环境里有 pip / uv（Python）或 npm（JavaScript）任一
（可选）要查模型指向：环境变量里有 TYPESAFE_API_KEY（没有就回注册与 API Key）

核心思路：三条版本线，两种更新节奏

Jev 的「更新」要分三条线看，因为它们发布节奏不同、你要做的事也不同：

版本线	变的是什么	你要做什么	官方出处
Jev 模型	版本 ID（`jev-1.14.0`）+ 别名（`jev-latest` / `jev-preview`）	什么都不做（用别名自动跟）或改 model 字段	官方博文 + docs/models.md
Python SDK	`typesafe-sdk` 包	升级包，过一遍破坏性变更	docs/sdk/python/changelog.md
JavaScript SDK	`@typesafe-ai/sdk` 包	升级包，先查 Node 版本	docs/sdk/javascript/changelog.md

模型线没有「安装」这一步——换模型只是换 model 字段的值；SDK 线才是真的要升级代码依赖。

版本时间线总表

日期	模型线	Python SDK	JavaScript SDK
2026-09-11	—	—	v0.5.7 首次公开发布
2026-09-14	—	v0.5.7 首次公开发布	—
2026-09-15	—	v0.6.0（破坏性变更：Score.criteria 改有序序列）	v0.6.0（同一变更）
2026-09-18	—	v0.7.0（破坏性变更：msgspec → pydantic）	—
2026-09-21 ~ 09-26	—	v0.7.1（Key 提前校验）、v0.7.2（http2 extra）	—
2026-10-09	—	v0.7.3（并发 TLS 修复）、v0.7.4（非有限数修复）	—
2026-10-14	jev-1.14.0 发布（jev-preview 先行，jev-latest 一周后跟上）	v0.7.5（当前版本）	v0.7.0（当前版本，要 Node 22+）

2026-10-14 是关键节点：模型和两个 SDK 同一天更新，SDK 的 Image / Box 支持与新模型的 danger zone 特性同批落地。

模型线更早的历史：cookbook 实测记录

官方没有公布 jev-1.12 和 jev-1.13.0 的发布日期，但官方 cookbook 里留着采样记录，能看出版本先后：

cookbook 采样时间	当时用的模型	cookbook
2026-08-11	`jev-1.12`	entity_alignment（啤酒目录实体对齐）
2026-08-16	`jev-1.12`	citation_check（引用核查）
2026-09（标注 as of 2026-09）	`jev-1.12`	parallel_questions（并行提问）
2026-09-29	`jev-1.13.0`	intelliprompter（演讲提词器）
2026-10-15	`jev-1.14.0`	ocr_confidence_bounding_boxes、feeder_watch
2026-10-29	`jev-1.14.0`	twitch_chat_filter、cart_from_primitives、basic_memory

注意两点：

上表是 cookbook 数字的采样时间，不是发布日期；官方明确给出的发布日期只有 jev-1.14.0 的 2026-10-14。
多个 cookbook 代码里锁的是 TYPESAFE_MODEL = "jev-1.12"——这正是模型与价格里「调过阈值就锁版本 ID」的实例：锁了就不受别名漂移影响，但也吃不到新版本的改进。

💡 别名漂移的活例子

consistency_noul cookbook 用的是 jev-latest，采样于 2026-09-11。今天再跑同一段代码，jev-latest 已经指向 jev-1.14.0——代码一行没改，应答的模型版本已经不同。这就是官方文档说「别名随新版本移动，答案可能在你的代码不变的情况下变化」的意思。

模型更新：jev-1.14.0（2026-10-14）

发布日期：2026-10-14 ｜先通过 jev-preview 提供，官方预告 jev-latest 一周后切换（当前两个别名都指向 jev-1.14.0，暂无 preview build）。

🔥 本版重点

多语言支持是官方预期的最大增益点。官方博文对 1.14 的定位是「不追求惊艳，而是对一切的小幅改进」：大多数事情都会好一点点，预期增益最大的是多语言支持（multi-lingual support）。对中文用户这是最该关注的一条——官方同时提醒过 CJK 准确度不如英语：如果你的中文内容在 1.13 上调过阈值，1.14 上值得重测一遍。
用 jev-latest 的系统，应答模型已经换了。别名切到 1.14.0 后，同样的请求由新版本应答。调过阈值的系统按模型与价格的做法：锁定版本 ID，准备好再切。

✨ 新功能：danger zone 三特性

1.14 发布的同时，官方开放了三个实验特性，全部要显式开启（opt-in），官方原话是「Enter the danger zone at your own risk（进危险区，风险自负）」、「毛边太多，不敢为生产场景背书」：

特性	开启方式	内容	详见
Composable Images（图像）	请求头 `TypeSafe-Danger-Zone-Images: true`	state、instructions、criteria 里都能放图；官方彩蛋：1.13 其实一直是多模态的	Box 与图像
Box 题型	同上（图像头），且仅 `jev-1.14.0` 启用	在图里找东西，返回按图片宽高比例的四条边；第一个「纯决策之外」的题型	Box 与图像
Long-Context（长上下文）	请求头 `TypeSafe-Danger-Zone-Long-Context: true`	上下文从 64k / 32k 提到 262k；价格不变，但更慢更不准；1.14 和 1.13 都支持	模型与价格

三个特性里只有 Box 依赖 1.14——官方说这项「最近进步很大」，所以只给 jev-1.14.0 开放；图像和长上下文 1.13 也能用。

官方对图像特性的建议：所有模型（包括 Jev）在多模态上的表现都不如纯文本，把问题拆到最简能明显改善。另外 Box 文档明说：请求格式、答案和限制可能在版本之间变化——用 danger zone 特性的代码要有随版本调整的预期。

💡 帮官方找毛边是自愿的

官方在 1.14 发布时加了一个 opt-in 机制，允许你用自己的查询帮助发现模型毛边（model jaggedness）；官方强调仍然不会拿你的查询做训练。1.13 的 9 种已知失败模式与替代做法，见 Jev 1.13 踩坑手册——官方说其中很多会在后续版本修复。

⚠️ 破坏性变更 / 需要你操作

模型线没有官方公布的代码级破坏性变更（博文称模型发布「一般也是 strict improvements」），但两件官方预告的事需要你留意：

事项	官方说法	你要做什么
别名已切换	`jev-latest` 于发布一周后更新为 `jev-1.14.0`；`jev-1.13.0` 会保留一段时间	用别名的先做回归测试；要稳就锁 `jev-1.14.0`，或继续显式用 `jev-1.13.0`
弃用预告政策	计划在 `jev-1.13.0` 正式弃用前给 60 天预告、`jev-1.14.0` 给 30 天；正式的弃用政策会在那之前发布	锁了旧版本 ID 的系统关注官方时间表，别等到最后一天

官方还预告了之后的发布节奏：大多数会是「美好的无聊」（beautifully boring）——全局小改进、更好的稳定性、面向真实部署的功能。

Python SDK 更新：typesafe-sdk（v0.5.7 → v0.7.5）

当前版本 v0.7.5（2026-10-14，与 jev-1.14.0 同天发布）。以下按时间倒序，逐条对应官方 changelog，没有添加官方没写的变化。

v0.7.5（2026-10-14，当前版本）：zstd 压缩 + Image/Box

✨ 新功能：

请求体默认用 zstd 压缩（官方提醒：非官方 API / 网关可能暂时不支持）
Image 资源支持四种来源：原始字节、文件路径、base64 字符串、PIL 对象
支持 Box 题型的提问与应答
在文本里引用资源：attach_assets

📝 文档：使用指南拆成 Basic / Advanced 两页；新增图像与 Box 文档。

v0.7.1 ~ v0.7.4（2026-09-21 ~ 2026-10-09）：修复与性能

版本	日期	内容
v0.7.4	2026-10-09	修复：非有限数字（NaN 这类）改序列化成字符串，不再产出非法 JSON
v0.7.3	2026-10-09	修复：`truststore<=0.10.4` 时并发 TLS 连接导致异步客户端崩溃；增加请求校验。性能：默认设置改为池化连接保活 30 秒。文档：新增高并发 Performance 一节
v0.7.2	2026-09-26	新增 `http2` extra（`typesafe-sdk[http2]`）；文档补 HTTP/2 用法
v0.7.1	2026-09-21	修复：API Key 提前校验，且不把 Key 值写进异常日志；文档补 AI 网关用法示例

v0.7.0（2026-09-18）：pydantic 迁移（破坏性变更）

破坏性变更：序列化/反序列化库从 msgspec 换成 pydantic
新功能：system_one 方法新增 response_model 参数，可传 pydantic 模型拿到额外的类型安全
修复：str 子类正确序列化成字符串（此前会变成字符列表）

v0.5.7 ~ v0.6.0（2026-09-14 / 15）：首次公开发布

v0.5.7（2026-09-14）：TypeSafe Python SDK 首次公开发布
v0.6.0（2026-09-15）：破坏性变更——Score.criteria 从「以整数为键的字典」改为「有序序列」；类型注解接受 Mapping / Sequence 等抽象类型；报错信息带上 HTTP 详情；修复 RetryPolicy 非法值；异常与响应对象可 pickle

⚠️ 破坏性变更与升级检查清单

版本	变更	升级前查哪里
v0.6.0（2026-09-15）	`Score.criteria` 改为有序序列（列表）	把 `criteria={0: "…", 1: "…"}` 写法改成 `criteria=["…", "…"]`
v0.7.0（2026-09-18）	序列化库 `msgspec` → `pydantic`	依赖 msgspec 私有类型的代码；想加类型安全可改用 `response_model`
v0.7.5（2026-10-14）	请求体默认 zstd 压缩（非破坏性，但影响兼容）	走非官方端点 / 网关报错时，用 `TypeSafeClient(compression=False)` 关闭

JavaScript SDK 更新：@typesafe-ai/sdk（v0.5.7 → v0.7.0）

当前版本 v0.7.0（2026-10-14）。这条线版本少，但 v0.7.0 一次带了两个破坏性变更。

v0.7.0（2026-10-14，当前版本）：图像、Box、zstd、Node 22+

破坏性变更：

要求 Node.js 22 或更新版本（官方 quickstart 的 JavaScript 标签页写「Requires Node.js 20 or later」——那是旧版 SDK 的要求，见下方踩坑提醒）
不再导出请求载荷类型（request payload types）

新功能：

图像支持（实验特性，TypeSafe-Danger-Zone-Images: true 请求头开启）：用 image() 或 Image.fromBase64() 创建，可放进 state、question instructions、criteria；用 withAssets 和 withAssets.join 写进文本，或在 assets 里按自取的名字引用
新增 box 题型（定位 instructions 描述的东西在图里的位置；官方 changelog 写「配合 jev-preview 模型使用」——发布时 jev-preview 指向 jev-1.14.0）
请求体 ≥ 1 KiB 时用 zstd 压缩（Node.js 22.15 或更新；传 compression: false 发不压缩的请求体）

修复：usage 里允许 null token 计数；增加请求校验；非法请求改为 reject 返回的 Promise 而不是 throw；接受运行时构建的 score criteria 列表；修复 Node 22 上请求超时或中途取消时的 unhandled rejection。

v0.5.7 ~ v0.6.0（2026-09-11 / 15）：首次公开发布

v0.5.7（2026-09-11）：TypeSafe JavaScript / TypeScript SDK 首次公开发布
v0.6.0（2026-09-15）：破坏性变更——Score.criteria 改为有序序列（与 Python SDK 同一变更、同一天）

⚠️ 破坏性变更与升级检查清单

变更	升级前查哪里
Node.js 22+（TypeScript 不经编译直跑要 22.18+）	先 `node --version`；旧运行时先升 Node，再升 SDK
不再导出请求载荷类型	从包里 import 请求 payload 类型的代码要改

如何升级

四步走：先看清自己在哪，再升两个包，最后决定 model 字段跟不跟新版本。

第 1 步：对照 Jev 更新日志确认当前版本

为什么：升级前先摸清现状——模型看别名实际指向、SDK 看已装版本号，才知道差距在哪。

查模型指向（命令逐字来自官方 models 文档）：

bash

curl https://api.typesafe.ai/v1/models \
  -H "Authorization: Bearer $TYPESAFE_API_KEY"

你应该看到：JSON 列表，每项含 name（模型 ID 或别名）、description、release_date；当前列出的是别名。每个响应的 model 字段会写明实际应答的版本 ID（如 jev-1.14.0），可以记进日志。

查 SDK 版本：

bash

pip show typesafe-sdk      # Python：看 Version 行
npm ls @typesafe-ai/sdk    # JavaScript：看已装版本

你应该看到：Python 端 Version: 0.7.5、npm 端 @typesafe-ai/sdk@0.7.0 就是最新；低于这两个号，就该升级了。

第 2 步：升级 Python SDK typesafe-sdk

为什么：v0.7.5 带来 zstd 默认压缩、Image / Box 支持；底层从 v0.7.0 起换成了 pydantic——先升包，再按上面的破坏性变更清单过一遍代码。

pip 路线（在 venv 里）：

bash

pip install -U typesafe-sdk

uv 路线（uv 管理的项目）：

bash

uv lock --upgrade-package typesafe-sdk
uv sync

你应该看到：解析 / 安装输出里的版本号是 0.7.5；再跑 pip show typesafe-sdk，Version 行显示 0.7.5。

💡 走网关 / 中转端点的注意 zstd

v0.7.5 起请求体默认 zstd 压缩，官方提醒非官方 API 可能暂时不支持。如果你的 TYPESAFE_BASE_URL 指向网关且报压缩相关错误，用 TypeSafeClient(compression=False) 关掉压缩。反过来，Python 3.14 之前的版本要启用压缩，需要装 extra：uv add "typesafe-sdk[zstd]"。

第 3 步：升级 JavaScript SDK @typesafe-ai/sdk

为什么：v0.7.0 把 Node 门槛提到 22+——先确认运行时再升包，避免升完跑不起来。

bash

node --version

你应该看到：v22.x.x 或更高（TypeScript 不经编译直跑要 22.18+）。低于 22 先升 Node。

确认后升级：

bash

npm install @typesafe-ai/sdk@latest

你应该看到：npm 输出里 @typesafe-ai/sdk 装到 0.7.0；npm ls @typesafe-ai/sdk 确认已装版本。

第 4 步：决定 model 字段跟不跟新版本

为什么：模型线的「升级」就是一个字段值的选择——用别名等于选择「自动跟最新」，锁版本 ID 等于选择「由我控制切换时机」。

你的情况	model 字段填什么	理由
原型验证、想尝鲜	`jev-latest`	自动跟最新稳定版，官方文档示例都用它
调过 confidence 阈值、在生产	`jev-1.14.0`（或继续 `jev-1.13.0`）	别名会随版本移动、答案会变；锁版本由你控制切换
想用 Box 题型	`jev-1.14.0`	Box 仅 1.14 启用

切版本后跑一遍自己的测试数据，重点看 confidence 分布有没有漂移；响应的 model 字段记进日志，方便事后对账。

检查点 ✅

我能说出 2026-10-14 这天更新了什么：jev-1.14.0 发布 + Python SDK v0.7.5 + JavaScript SDK v0.7.0
我知道 1.14 的定位：全局小改进、多语言增益最大；Box 仅 1.14 启用
我能列出两个 SDK 的破坏性变更：Score.criteria 改列表（v0.6.0）、msgspec→pydantic（Python v0.7.0）、Node 22+（JS v0.7.0）
我知道 danger zone 三特性都要显式开启：Images / Box 用 TypeSafe-Danger-Zone-Images: true，长上下文用 TypeSafe-Danger-Zone-Long-Context: true
我知道弃用预告政策：1.13 弃用前给 60 天预告、1.14 给 30 天；jev-1.13.0 目前仍可用
我升级后用 pip show / npm ls / 响应 model 字段验证过版本

踩坑提醒

❌ 照着官方 quickstart 装完 SDK，旧机器上跑不起来

官方 quickstart 的 JavaScript 标签页写「Requires Node.js 20 or later」，那是旧版 SDK 的要求；SDK v0.7.0（2026-10-14）起要 Node 22+，TypeScript 不经编译直跑要 22.18+。先 node --version 再升 SDK。

❌ 升级 Python SDK 后，走网关的请求报错

v0.7.5 起请求体默认 zstd 压缩，非官方端点可能不支持。用 TypeSafeClient(compression=False) 关掉压缩再试；直连官方 API 不用关——官方 API 支持 zstd。

❌ 拿着 jev-latest 调阈值，新版本一发布答案全变

别名移动是官方设计。调过阈值的系统锁版本 ID（jev-1.14.0），切版本前用自己的数据回归一遍——1.14 官方预期多语言增益最大，中文内容的阈值尤其值得重测。

❌ 把 danger zone 特性直接上生产

官方原话「毛边太多，不敢为生产场景背书」；Box 文档明说请求格式和限制可能在版本间变化。实验特性先做原型，生产等官方宣布 ready。

❌ 升级后 Score 报 criteria 类型错误

v0.6.0（2026-09-15）起 Score.criteria 要传有序序列（列表），旧的「整数为键的字典」写法不再接受——两个 SDK 同一天改的。把 criteria={0: "…", 1: "…"} 改成 criteria=["…", "…"]。

本课小结

✅ Jev 更新日志一页记住：模型线 2026-10-14 发布 jev-1.14.0（全局小改进、多语言增益最大），jev-latest 一周后跟上，jev-1.13.0 仍可用（正式弃用前有 60 天预告）。

✅ 同一天两个 SDK 配套更新：Python typesafe-sdk v0.7.5（zstd 默认压缩、Image / Box、attach_assets），JavaScript @typesafe-ai/sdk v0.7.0（图像、Box、zstd、Node 22+）。

✅ 破坏性变更三处：Score.criteria 改有序序列（两 SDK 的 v0.6.0）、Python v0.7.0 序列化库换 pydantic、JS v0.7.0 要 Node 22+ 且不再导出请求载荷类型。

✅ danger zone 三特性都要显式开启、不建议上生产：Images（TypeSafe-Danger-Zone-Images: true）、Box（仅 1.14）、Long-Context（262k，更慢更不准）。

✅ 升级四步：查现状（GET /v1/models + pip show / npm ls）→ 升 Python → 升 JS（先看 Node）→ 决定 model 字段跟不跟。

关键数字回顾：

项	值	出处
jev-1.14.0 发布	2026-10-14；jev-preview 先行、jev-latest 一周后跟上	docs/models.md、官方博文
当前别名指向	`jev-latest` / `jev-preview` → `jev-1.14.0`（暂无 preview build）	docs/models.md
弃用预告	1.13 给 60 天、1.14 给 30 天；正式政策待发布	官方博文
Python SDK 当前版本	v0.7.5（2026-10-14）	docs/sdk/python/changelog.md
JavaScript SDK 当前版本	v0.7.0（2026-10-14），Node 22+	docs/sdk/javascript/changelog.md、docs/sdk/javascript.md
长上下文	262k（`TypeSafe-Danger-Zone-Long-Context: true`）	docs/models.md
图像 / Box 开关	`TypeSafe-Danger-Zone-Images: true`（缺头返回 400）	docs/images.md、docs/primitives/box.md

接下来学什么

Jev 教程的全部页面到这里就完整了。三条路任你挑：

回到快速起步：用最新 SDK 重跑第一个请求，几分钟确认环境没被升级弄坏
挑一条场景路线实战：场景实战有直播弹幕过滤、引用核查、RAG 把关等官方 cookbook 复现
想知道当前版本还有哪些已知坑：Jev 1.13 踩坑手册（9 种失败模式与替代做法）

附录：源码参考

点击展开查看官方文档出处

更新时间：2026-11-04（官方文档本地信息源 sources/jev/docs/，URL = https://docs.typesafe.ai/<本地路径>）

内容	文件路径	关键位置
Python SDK 全部版本条目（v0.5.7 ~ v0.7.5）	docs/sdk/python/changelog.md	各版本日期与 Breaking Changes / Features / Bug fixes / Documentation 分类
JavaScript SDK 全部版本条目（v0.5.7 ~ v0.7.0）	docs/sdk/javascript/changelog.md	v0.7.0 Node 22+、图像 / Box / zstd；v0.6.0 Score.criteria
jev-1.14.0 发布、别名切换、弃用预告、多语言增益、danger zone 三特性、opt-in 找毛边、「美好的无聊」发布节奏	官方博文 typesafe.ai/blog/jev-1-14（本地 `site/jev-1-14.md`）	2026-10-14；jev-latest 一周后切 1.14.0；60 / 30 天预告；「largest gain in multi-lingual support」；Box 仅 jev-1.14.0 启用
当前模型表、别名表与 WARNING、长上下文 262k、GET /v1/models（curl 示例逐字）	docs/models.md	Current models；Aliases；Long context；Listing models
图像 / Box 开启方式（`TypeSafe-Danger-Zone-Images: true`）、「格式与限制可能在版本间变化」、缺头 400	docs/images.md、docs/primitives/box.md	Turning on images；Dreamer-ready 段
Python 压缩配置与 zstd extra	docs/sdk/python/usage/advanced.md、docs/sdk/python/api/clients/sync.md	`compression` 构造参数（`False` 发不压缩）；`uv add "typesafe-sdk[zstd]"`（Python < 3.14）；1 KiB 起压缩
JS SDK Node 22+ 要求	docs/sdk/javascript.md	Quickstart「Node.js 22 or newer」；zstd 需 22.15+
TS 直跑 22.18+；quickstart「Node 20+」对应旧版 SDK 的核对结论	docs/introduction/quickstart.md:210、sources/jev/extra/03b-install-alternatives-live-checks.md	「Requires Node.js 22.18 or later to run TypeScript directly」；「quickstart 的 20+ 对应旧版本」
cookbook 采样记录（jev-1.12 / 1.13.0 / 1.14.0 的使用时间、consistency_noul 用 jev-latest 采样于 2026-09-11）	docs/cookbooks/ 下 entity_alignment.md、citation_check.md、parallel_questions.md、intelliprompter.md、ocr_confidence_bounding_boxes.md、feeder_watch.md、twitch_chat_filter.md、cart_from_primitives.md、basic_memory.md、consistency_noul_cookbook.md	各文件「Numbers below came from … on …」与 `TYPESAFE_MODEL` 锁定值
uv 升级命令	sources/jev/extra/uv-docs-sync.md（uv 官方文档本地副本）	`uv lock --upgrade-package <package>`
1.13 已知坑与「很多会在后续版本修复」	docs/model-jaggedness/jev-1.13.md	9 种失败模式表；「Many of these will be fixed in later versions」

更新日志：Jev 模型与 SDK 版本时间线 ​

学完你能做什么 ​

你现在的困境 ​

什么时候用这一招 ​

🎒 开始前的准备 ​

核心思路：三条版本线，两种更新节奏 ​

版本时间线总表 ​

模型线更早的历史：cookbook 实测记录 ​

模型更新：jev-1.14.0（2026-10-14） ​

🔥 本版重点 ​

✨ 新功能：danger zone 三特性 ​

⚠️ 破坏性变更 / 需要你操作 ​

Python SDK 更新：typesafe-sdk（v0.5.7 → v0.7.5） ​

v0.7.5（2026-10-14，当前版本）：zstd 压缩 + Image/Box ​

v0.7.1 ~ v0.7.4（2026-09-21 ~ 2026-10-09）：修复与性能 ​

v0.7.0（2026-09-18）：pydantic 迁移（破坏性变更） ​

v0.5.7 ~ v0.6.0（2026-09-14 / 15）：首次公开发布 ​

⚠️ 破坏性变更与升级检查清单 ​

JavaScript SDK 更新：@typesafe-ai/sdk（v0.5.7 → v0.7.0） ​

v0.7.0（2026-10-14，当前版本）：图像、Box、zstd、Node 22+ ​

v0.5.7 ~ v0.6.0（2026-09-11 / 15）：首次公开发布 ​

⚠️ 破坏性变更与升级检查清单 ​

如何升级 ​

第 1 步：对照 Jev 更新日志确认当前版本 ​

第 2 步：升级 Python SDK typesafe-sdk ​

第 3 步：升级 JavaScript SDK @typesafe-ai/sdk ​

第 4 步：决定 model 字段跟不跟新版本 ​

检查点 ✅ ​

踩坑提醒 ​

❌ 照着官方 quickstart 装完 SDK，旧机器上跑不起来 ​

❌ 升级 Python SDK 后，走网关的请求报错 ​

❌ 拿着 jev-latest 调阈值，新版本一发布答案全变 ​

❌ 把 danger zone 特性直接上生产 ​

❌ 升级后 Score 报 criteria 类型错误 ​

本课小结 ​

接下来学什么 ​

相关教程 ​

附录：源码参考 ​

更新日志：Jev 模型与 SDK 版本时间线

学完你能做什么

你现在的困境

什么时候用这一招

🎒 开始前的准备

核心思路：三条版本线，两种更新节奏

版本时间线总表

模型线更早的历史：cookbook 实测记录

模型更新：jev-1.14.0（2026-10-14）

🔥 本版重点

✨ 新功能：danger zone 三特性

⚠️ 破坏性变更 / 需要你操作

Python SDK 更新：typesafe-sdk（v0.5.7 → v0.7.5）

v0.7.5（2026-10-14，当前版本）：zstd 压缩 + Image/Box

v0.7.1 ~ v0.7.4（2026-09-21 ~ 2026-10-09）：修复与性能

v0.7.0（2026-09-18）：pydantic 迁移（破坏性变更）

v0.5.7 ~ v0.6.0（2026-09-14 / 15）：首次公开发布

⚠️ 破坏性变更与升级检查清单

JavaScript SDK 更新：@typesafe-ai/sdk（v0.5.7 → v0.7.0）

v0.7.0（2026-10-14，当前版本）：图像、Box、zstd、Node 22+

v0.5.7 ~ v0.6.0（2026-09-11 / 15）：首次公开发布

⚠️ 破坏性变更与升级检查清单

如何升级

第 1 步：对照 Jev 更新日志确认当前版本

第 2 步：升级 Python SDK typesafe-sdk

第 3 步：升级 JavaScript SDK @typesafe-ai/sdk

第 4 步：决定 model 字段跟不跟新版本

检查点 ✅

踩坑提醒

❌ 照着官方 quickstart 装完 SDK，旧机器上跑不起来

❌ 升级 Python SDK 后，走网关的请求报错

❌ 拿着 jev-latest 调阈值，新版本一发布答案全变

❌ 把 danger zone 特性直接上生产

❌ 升级后 Score 报 criteria 类型错误

本课小结

接下来学什么

相关教程

附录：源码参考