---
title: 通用品类能力
summary: 通用品类能力由基础库内置能力（面板环境初始化、离线处理、OTA 升级）和 Panel SDK 开发套件（SDM、SGM、多语言、Hooks/Utils）组成，提升面板小程序开发效率。
---

## 通用品类能力

通用品类能力由 **“基础库内置能力”** 与 **“Panel SDK 开发套件”** 两部分组成，旨在通过标准化交互与提炼开发模型，提升面板小程序的开发效率。

### 能力清单

| 维度 | 实现主体 | 模块名 | 说明 | 文档 |
| :--- | :--- | :--- | :--- | :--- |
| **标准核心能力** | **基础库** | **面板环境初始化** | 自动处理离线弹窗、蓝牙连接、OTA 升级、故障提醒等逻辑 | [总览与初始化](./common/init-panel-environment) |
| | | **连接与离线** | 离线遮罩引导与蓝牙自动重连行为说明 | [连接与离线逻辑](./common/init-panel-environment/connectivity) |
| | | **OTA 升级** | 固件检测、强制/提醒升级逻辑 | [OTA 升级说明](./common/init-panel-environment/ota) |
| **面板开发套件** | **Panel SDK** | **智能设备模型 (SDM)** | 基于 OOP 的智能设备编程模型，简化数据管理与控制逻辑 | [智能设备模型](./common/sdm) |
| | | **智能群组模型 (SGM)** | 基于 OOP 的智能群组编程模型 | [智能群组模型](./common/sgm) |
| | | **多设备管理** | 在同一小程序内自由管理多台独立设备实例，支持批量状态读取与指令下发 | [多设备管理](./common/multi-device) |
| | | **面板多语言** | 面板专属国际化适配方案，支持云端词条同步 | [多语言配置](./common/multi-language) |
| | | **功能点解析集** | 常用功能点协议的解析 with 转换工具 | [功能点解析集](./common/protocol) |
| | | **Hooks & Utils** | 提炼自业务逻辑的常用 React Hooks 与工具函数 | [Hooks](./common/hooks) |

---

#### 1. 基础库内置能力

基础库内置能力是涂鸦面板小程序的**标准交互规范**实现。它由基础库直接驱动，无需安装额外依赖（需引入 `DeviceKit`），主要解决设备生命周期中的共性交互问题（如：如何提醒用户设备离线、如何引导固件升级等）。

*   **特点**：开箱即用、交互统一、逻辑封闭安全。
*   **核心入口**：[initPanelEnvironment](./common/init-panel-environment)

#### 2. Panel SDK 开发套件

Panel SDK 是为了提升开发者**编程体验**而设计的扩展套件。它通过对设备 DPs、群组、多语言等底层数据的抽象封装，提供了一套更符合现代前端开发习惯（OOP/Hooks）的编程模型。

*   **特点**：提效显著、灵活扩展、按需引入。
*   **安装依赖**：

### 安装

```shell
$ yarn add @ray-js/panel-sdk
# or
$ npm install @ray-js/panel-sdk
```

### 使用

```typescript
// 引入标准环境初始化（基础库能力）
import { initPanelEnvironment } from '@ray-js/ray';

// 引入 Panel SDK 工具（SDK 能力）
import { useProps, useActions } from '@ray-js/panel-sdk';
```