SuperAPI AI 工具集

core

编程与开发

查看项目

更新于 10-16 08:34

技能介绍

@json-render/core 是 json-render 的核心包,负责 schema 定义、catalog 创建与 spec 流式处理。核心概念包括:Schema(用 defineSchema 定义 spec 与 catalog 结构)、Catalog(用 defineCatalog 将组件/动作名称映射到定义)、Spec(AI 输出且符合 schema 的 JSON)、SpecStream(用于渐进式构建 spec 的 JSONL 流格式)。

主要能力:用 defineSchema 定义结构并可传入自定义 promptTemplate;用 defineCatalog 注册组件及其 props 与描述;用 catalog.prompt() 生成系统提示词,支持 customRules;用 createSpecStreamCompiler 处理流式 JSONL 补丁;用 resolvePropValue、resolveElementProps 解析动态 prop 表达式($state、$bindState、$bindItem、$cond、$template、$computed);用 buildUserPrompt 构建用户提示词,支持 patch、merge、diff 编辑模式;用 validateSpec、autoFixSpec 校验并自动修复 spec;用 visibility 辅助函数构造可见性条件;用 check 创建校验(required、email、url、numeric、minLength、maxLength、min、max、pattern、matches、equalTo、lessThan、greaterThan、requiredIf);用 createStateStore 创建框架无关的内存 StateStore。

实验性决策模型组合:从 @json-render/core 导入 experimental_composeSpec 与 experimental_createEvaluator。这些 API 未发布,需使用源码构建,发布后固定精确版本;实验性导出与 Experimental_ 类型可能在任何版本变更。服务端运行 Gateway 评估器需 { model: "typesafe-ai/jev", apiKey: process.env.AI_GATEWAY_API_KEY! },必须使用纯模型标识符,不要导入 provider 构造函数。调用 experimental_composeSpec({ catalog, candidates, prompt, evaluate, initialState, signal }),它是异步生成器,可将 step.spec 快照流式传给现有渲染器,并检查 complete.stopReason(finish、limit、unavailable)。错误与取消会抛出,应保留最后快照作为部分 UI。

限制:V1 仅支持扁平 Spec catalog、命名槽、字面量、$state、$bindState 与状态可见性;不支持预构建 children、repeat/watch、computed/template/conditional props 或自定义指令。成功/错误回调必须引用允许的动作,事件必须在组件 catalog 中声明。props 与动作参数按初始状态校验,不应用 schema 转换/默认值。默认 32 次评估、深度 8、每次调用 10 秒 Gateway 超时。候选描述、提示词、指令、拓扑与显式上下文会发送给评估器;初始状态与原始 props/绑定值不会自动发送。自定义 provider 需实现 Experimental_CompositionEvaluator。更多集成与源码构建说明见 packages/core/README.md 与 /docs/jev。