solax-summary-fetch

该 Skill 通过封装 npm 包 solax-cloud-api，为 Solax 光伏逆变器用户提供标准化的数据获取接口。用户需提供 Solax Cloud API Token（tokenId）和逆变器序列号（sn），Skill 将自动调用 Solax Cloud 的 getAPIData() 接口并转换为结构化的 SolaxSummary JSON 数据。支持通过环境变量或 CLI 参数传入凭证，输出直接面向标准输出流，便于与 Home Assistant、Node-RED 等自动化平台集成。

该 Skill 在安全设计方面表现突出：明确强制使用环境变量存储敏感凭证，内置 redact() 函数对 Token 进行脱敏显示（仅展示前后字符），并禁止在日志中输出完整密钥。工程实现上采用 TypeScript 类型定义（SolaxSummary 接口），提供结构化错误处理（返回 {ok:false, error:...} 而非崩溃），且依赖版本严格锁定（0.2.0），有效避免供应链攻击风险。部署方式轻量便捷，仅需 Node.js 环境，通过标准 npm install 即可安装，无需复杂配置。

主要限制在于数据来源单一且依赖第三方库：核心功能完全依赖 solax-cloud-api npm 包（v0.2.0），若该库停止维护或出现兼容性问题，Skill 将受影响。其次，功能范围较窄，仅支持获取"摘要数据"（Summary），无法获取历史详细数据或进行设备控制。此外，来源可信度为 T3 级别（个人开发者 allmightysauron），对于企业级高安全要求场景可能需要额外审计。网络层面，完全依赖 Solax Cloud 服务可用性，本地局域网直连功能缺失。

该 Skill 最适合拥有 Solax 品牌光伏逆变器的家庭用户和智能家居爱好者，特别是需要能源数据自动化采集的场景。适用于构建个人能源监控仪表板、自动化规则（如根据发电量控制家电）或进行长期的能源效率分析。对于开发者而言，可作为物联网数据接入的中间件，快速集成到现有的数据分析 pipeline 中。

使用过程中的常规风险包括：1）凭证管理风险，尽管 Skill 本身安全，但用户若误将 Token 提交至 Git 仓库或在不安全环境变量中存储，仍可能导致能源数据泄露；2）网络稳定性，Solax Cloud API 的响应延迟或故障将直接影响数据获取；3）依赖维护，npm 包的长期维护状态不确定，建议定期运行 npm audit 检查漏洞；4）速率限制，Solax Cloud 可能对 API 调用频率有限制，高频自动化场景需注意遵守平台限流策略。