（13335期）Solar Cloud API – Solax 逆变器数据一键获取

Solax 逆变器数据一键获取 通过 Solax Cloud API 获取逆变器实时汇总数据，输出标准化 JSON 供仪表盘与自动化流程使用。 使用说明 核心用法 solax-summary-fetch 是一个轻量级 Node.js 技能，用于从 Solax Cloud API 拉取光伏逆变器的实时/汇总能源数据。用户需提供 tokenId（API 令牌）和 sn（逆变器序列号），脚本调用底层 solax-cloud-api npm 包的 getAPIData() 方法并转换为 SolaxSummary 类型输出。 调用方式： 推荐通过环境变量 SOLAXTOKENID 和 SOLAXSN 注入凭证，避免敏感信息泄露至 shell 历史记录。 备选通过 CLI 参数 --tokenId 和 --sn 显式传递。 输出格式：单一 JSON 对象，符合 TypeScript 定义的 SolaxSummary 接口，可直接对接 Home Assistant、Grafana 或其他自动化平台。 显著优点 标准化输出：依赖 solax-cloud-api 官方封装，数据结构稳定，减少自行解析原始 API 的维护成本。 凭证隔离机制：设计上明确禁止硬编码，强制环境变量或 CLI 传参，降低密钥泄露风险。 错误结构化：API 异常时返回 {ok:false, error:"..."}，便于下游程序优雅处理失败场景。 无锁文件依赖：使用 npm install 而非 npm ci，适应无预置 lockfile 的部署环境。 潜在缺点与局限性 网络依赖：Solax Cloud 服务端可用性直接影响数据获取，本地局域网离线场景无法使用。 凭证管理门槛：环境变量配置对非技术用户存在学习成本；CLI 传参则有历史记录残留风险。 功能单一：仅封装 toSummary() 接口，若需原始全量数据或设备配置信息，需额外开发。 npm 供应链风险：依赖第三方包 solax-cloud-api，需关注其更新维护状态及潜在安全漏洞。 适合人群 已部署 Solax 光伏系统、具备 Node.js 运行环境的智能家居爱好者。 需要将逆变器数据集成至自定义仪表盘或自动化流程（如 Node-RED、Home Assistant）的技术用户。 能够妥善管理 API 令牌、理解环境变量配置的基础运维人员。 常规风险 令牌泄露：tokenId 一旦泄露，攻击者可访问用户能源数据；技能虽设计 redact 机制，但运行时环境变量仍需用户自行保护。 API 限流/变更：Solax Cloud 可能对未公开文档的端点施加频率限制或 Breaking Changes。 供应链安全：npm 包的安装过程可能引入依赖树中的恶意代码，建议在隔离环境（如容器）中运行并审计 lockfile。 原始说明 Fetch inverter summary data from the Solax Cloud API using the npm package solax-cloud-api. Use when the user provides (or has configured) a Solax tokenId and inverter serial number (sn) and wants current/summary energy data returned as JSON (typed as SolaxSummary) for dashboards/automation.