更新记录

1.0.0（2026-07-19）

首发：4 个开箱即用可视化场景组件（纯 uvue 组合层，零新原生代码）。

• <viz-poster-card> 分享海报卡：吃标题/二维码/预设即出高清位图（命令式位图，无引擎）。
• <viz-sensor-card> 实时传感器卡：封装 stream 引擎生命周期（建/喂/销毁），@ready(engineId) 逃生舱直喂原生。
• <viz-market-panel> 金融行情页：封装 kline 引擎 + revision 增量刷新，bump() 供实时 tick。
• <viz-bento-board> 数据大屏 bento：flex 网格编排上述卡片 + <nex-chart>，:blocks 声明式格子。
• 依赖声明 uni_modules.dependencies 指向底层 4 个插件（本仓首用；marketplace 自动安装行为未验证）。

平台兼容性

uni-app x(5.14)

nex-viz-kit · 可视化成品套件

吃 props 就出成品。 把 4 个高性能可视化引擎封装成 4 个开箱即用的场景组件——不再手搓「建引擎 → 拿句柄 → 喂数据 → 绑视图 → 销毁」这套生命周期，一个标签放下去就是一张能跑的实时监控卡 / 行情页 / 大屏 / 海报。

这是插件市场少见的成品套件（bundle）：现有可视化插件清一色是单能力零件，本套件给的是拼装好、可直接上线的场景组合。

4 个场景组件

快速上手

<template>
  <!-- 实时传感器卡：喂初始样本即出波形；真实推流经 @ready 拿到引擎句柄直喂原生 -->
  <viz-sensor-card :name="'温度'" :sample-rate="1000" :window-sec="30" :high="0.8"
    :initial-samples="warmup" @ready="onEngineReady" @alarm="onAlarm" />

  <!-- 金融行情页：传一批 OHLCV 蜡烛即渲染，带均线+子图 -->
  <viz-market-panel :symbol="'BTC/USDT'" :candles="candles" :ma="[5,10,20]" :sub="'macd'" />

  <!-- 分享海报卡：吃标题+二维码即出高清位图 -->
  <viz-poster-card :preset="'sale'" :title="'限时 5 折'" :qr="'https://example.com/act'" />
</template>

高频/实时数据不走 props 每帧刷新——组件在挂载时建一次引擎，@ready(engineId) 把引擎句柄交给你，之后热数据经引擎的 pushSamples / appendCandle 直喂原生，完全绕开 JS 层逐帧 diff。这是「成品封装 ≈ 零开销」的守门原则：套件不引入慢包装。

依赖模型（诚实说明）

• 本套件是纯前端组合层：components/ + utils/ 组合既有引擎，零新原生代码（无 utssdk/、无二进制、无 checksum）。
• package.json 的 uni_modules.dependencies 声明依赖 nex-stream / nex-kline / nex-charts / nex-poster。本仓这是首个填充该字段的包——HBuilderX 在插件市场引入本套件时是否据此自动带出底层 4 个插件，是 DCloud 平台行为，未在本仓验证，请以实际引入结果为准；若未自动带出，请手动引入这 4 个底层插件。
• 开发调试时底层 4 个插件由 scripts/link-demos.sh（_plugins.sh 库 清单驱动）软链进示例工程可用；本套件是纯 uvue 无 库 包、不在该清单里，示例工程里已单独软链（examples/uni-app-x/uni_modules/nex-viz-kit）。若在其它工程复用，把本包目录一并放进目标工程的 uni_modules/ 即可（easycom 按目录名自动注册）。

验证状态（诚实分层）

• H5（H5 端引擎，headless Chrome）W4 数据敏感断言：4 组件的 util 映射 + 引擎往返 + 出图/波形非空白 + 「成品封装 ≈ 裸引擎」同像素不退化对照——需 HBuilderX + vite + Playwright harness 跑绿（见 examples/uni-app-x/w4-e2e/）。未跑 harness 前不声称已验证。
• App 端原生手势帧（缩放/十字线/滚动实时性能）：easycom 原生视图外壳已就位，但本套件只做到 H5 验证上限，App 手势帧 gated（待真机验证，绝不抬「真机已验」）。
• 真机 L6：gated。

底层插件计费

底层 4 个插件的免费/计费/源码捆绑属各自市场 listing 的商业决策，本套件不代为定价。