用途:TypeBox 用于定义可移植的 JSON Schema 形状模式,并据此做运行时校验与 JSON Schema 生成。适合需要 JSON Schema 结构、元数据、Static<> 类型推导或模式自省的场景,如工作区表、kv、字段、actions、MCP 输入、manifest 等。
主要能力:用 Type.* 定义模式;用 typebox/value 的 Value.Check() 做一次性校验,返回布尔值;用 typebox/compile 的 Compile() 做高性能校验,其 Check() 返回布尔值,Parse() 抛错或返回带类型的值。TypeBox 模式是可移植的 JSON Schema 形状数据,边界需要校验时可直接校验该模式。
用法要点:包名使用 typebox,不要用已废弃的 @sinclair/typebox。正确写法为 import { Type } from 'typebox'、import { Compile } from 'typebox/compile'、import { Value } from 'typebox/value'。
限制:TypeBox 不实现 Standard Schema,不要编写期望 schema['~standard'] 的代码。若某边界接受 Standard Schema,应优先选用原生实现它的库(如 Arktype);若边界拥有 TypeBox 模式,则保持 TypeBox 原生,并以 JSON Schema 作为可移植表示。仓库策略上,TypeBox 用于可移植模式对象,Arktype 用于本地运行时校验、请求解析、env/config 解析、持久化 UI 状态、转换与品牌化领域值。
其他:官方文本暂未提供;具体版本、安装命令与收费信息暂未提供。