用途:为 json-render 应用提供浮动检查器面板,用于调试生成式 UI、查看 spec 树、运行时编辑状态、观察派发的动作与流式事件。
主要能力:面板包含 Spec(元素树、props/可见性/事件/watchers、validateSpec 警告)、State(JSON Pointer 路径内联编辑)、Actions(动作时间线,含名称、参数、结果/错误、耗时)、Stream(spec 补丁、文本块、token 用量、生命周期标记)、Catalog(组件与动作声明)。工具栏提供元素拾取器,点击页面元素可跳转到 Spec 标签并聚焦。
安装:核心包加对应框架适配器,例如 React 用 npm install @json-render/devtools @json-render/devtools-react,Vue、Svelte、Solid 同理替换后缀。
使用方式:将 <JsonRenderDevtools /> 放在现有 <JSONUIProvider> 内即可,无需其他接线。面板右下角有浮动开关,默认热键 Ctrl/Cmd + Shift + J,可通过 hotkey 属性配置。抽屉可调整大小,高度持久化到 localStorage。
主要属性:spec、catalog、messages、initialOpen、position(bottom-right/bottom-left/right)、hotkey、bufferSize(默认 500)、reserveSpace(默认 true,通过 body padding 为面板腾出空间)、allowDockToggle(默认 true)、onEvent。
限制:生产环境(NODE_ENV === "production")下组件渲染为 null;命令式 API 仅 React 提供,且在挂载前或生产环境返回 null。面板使用 Shadow-DOM 隔离样式,拾取器通过 data-jr-key 标记元素,不影响布局。多渲染器场景需共享一个顶层 Provider 并避免状态路径冲突。