核心功能与用法
LaMetric CLI 是一款面向 LaMetric TIME/SKY 智能像素时钟的命令行控制工具，由开发者 dedene 开源维护（MIT 协议）。该工具通过本地网络 API 与设备通信，允许用户从终端或脚本中发送通知、控制硬件设置、管理内置应用（计时器、秒表、收音机）以及推送自定义图像/视频流。
主要功能模块
1. 通知系统：支持发送带图标、声音、优先级的通知，可显示进度条、迷你图表（sparkline），并支持从标准输入管道化内容（echo "text" | lametric notify）。关键通知可设置为 critical 优先级以唤醒设备并播放警报。
2. 设备控制：调节屏幕亮度（含自动模式）、系统音量、蓝牙开关，以及获取设备状态信息。
3. 内置应用：管理计时器（支持 5m、1h30m 等友好时长格式）、秒表、收音机播放，以及应用间切换。
4. 流媒体推送：支持发送静态图片、GIF 动画，甚至通过 ffmpeg 管道实时传输视频流，实现自定义可视化效果。
5. 设备发现：自动扫描局域网内的 LaMetric 设备，简化初始配置。
典型应用场景
- CI/CD 集成：构建成功/失败时自动推送通知到开发桌面时钟
- 系统监控：CPU、磁盘等指标超限告警
- 个人效率：Pomodoro 番茄钟、会议提醒
- 数据可视化：通过 sparkline 显示实时指标趋势
安装与配置
提供 Homebrew 和 Go 两种安装方式。配置需从 LaMetric 手机应用获取 API 密钥，支持交互式向导（lametric setup）或环境变量（LAMETRIC_API_KEY、LAMETRIC_DEVICE）。
显著优点
- 开发者友好：纯 CLI 设计，完美适配 shell 脚本和自动化流水线
- 管道支持：标准输入集成允许与
git、ffmpeg等工具链式组合 - 丰富的通知格式：图标、声音、进度条、图表等多种视觉元素
- 实时流媒体：独特的视频流能力，扩展了硬件的使用场景
- 灵活配置：支持多设备管理、配置文件和环境变量
局限性与风险
- 网络依赖：需设备与运行 CLI 的主机处于同一局域网，无云端远程控制能力
- 硬件专用：仅兼容 LaMetric TIME/SKY 系列，不支持其他智能显示设备
- 认证安全：API 密钥以明文形式存储在配置文件或环境变量中，需用户自行保障主机安全
- 功能边界：为设备原生功能的封装，不支持深度自定义固件或第三方应用开发
适合人群
- 已拥有 LaMetric 硬件的开发者和技术爱好者
- 希望将物理显示设备集成到 DevOps 工作流中的团队
- 追求桌面自动化和可视化通知的极客用户
安全风险说明
- 本地网络通信：API 调用基于局域网 HTTP，建议确保网络边界安全
- 密钥管理：API 密钥具备设备完全控制权，泄露可能导致未授权操作
- 无加密存储：配置文件中密钥明文存储，共享主机需注意权限设置