Skills: socket-panel-development-guidelines

概述 {#description}

本技能服务于涂鸦电工插座/排插/智能开关品类 Ray 小程序面板的 AI 辅助开发。核心知识包括多路开关动态渲染（switch_16）、倒计时控制（countdown_16 秒级转 HH:MM 展示）、用电统计（add_ele/cur_power/cur_voltage/cur_current 含换算规则与统计 API）、Complex DP 解析（cycle_time/random_time/switch_inching）、功能页跳转（电工定时/电费设置）、设备操作日志，以及断电记忆/童锁/故障告警等安全保护功能。技能通过 reference/ 子目录对 API、功能页提供完整签名，SKILL.md 速查表仅用于选型，详细用法以 reference 为准。

适用场景 {#scene}

• 新建电工面板：从零搭建插座/排插/智能开关面板，需要多路开关渲染、DP 类型定义、基础控制页面。
• 用电统计开发：接入用电量统计 API（15min/hour/day/month 粒度），展示今日/昨日用电、历史趋势图表。
• 倒计时功能：各路独立倒计时（countdown_1~6），秒转 HH:MM 格式化展示与触发提示。
• 功能页接入：电工定时（普通定时+倒计时）、电费设置，含 appid 注册与路由参数编码。
• Complex DP 开发：cycle_time / random_time / switch_inching 解析器注册与编解码。
• 设备日志：操作日志查询、DP 值转换（switch boolean→on/off、fault bitmap 按位解析）。
• 不适用：非涂鸦平台设备、电工品类之外（照明、门锁等）的面板开发。

搭配使用 {#usage}