核心用法
Ulanzi TC001 技能通过本地 HTTP 协议与像素时钟设备通信，无需浏览器即可完成全面控制。用户需在 config.json 中配置设备 IP，或通过环境变量 TC001_HOST 指定。提供 Python 辅助脚本简化操作，支持设备状态查询、组件启停、系统设置修改三大类功能。
设备控制：status 命令获取系统设置与组件运行状态的 JSON 摘要；gadgets list/on/off 批量或单独控制 14 种显示组件（时间、日期、天气、B站/微博/YouTube/抖音数据、记分牌、计时器、番茄钟、电池、矩阵效果、AWTRIX、本地IP）。
系统配置：涵盖自动/手动亮度（0-100%）、夜间模式时段设置、时区调整（GMT 偏移或 AUTO）、组件切换间隔（10-60秒或无切换）、滚动速度（0-10）。支持语言切换、时间/日期格式、星期显示等细节定制。
应用配置：可设置城市代码获取天气，配置 B站、微博、YouTube、抖音的 UID/动画/颜色/格式参数，支持 YouTube API 密钥接入（需注意密钥安全）。
显著优点
- 本地化控制：纯 HTTP 通信，不依赖云服务，延迟低且隐私可控
- 功能完整：覆盖官方 App 绝大部分功能，支持社交平台实时数据展示
- 自动化友好：命令行脚本易于集成 Home Assistant、Cron 等自动化工作流
- 灵活配置：细粒度控制显示行为，包括夜间自动降亮度、组件轮播策略
潜在缺点与局限性
- 需固定 IP：设备需分配静态 IP 或依赖路由器 DHCP 保留，IP 变动需手动更新配置
- 无官方认证：非 Ulanzi 官方开发，API 可能随固件更新失效
- YouTube 限制：需自行申请 API 密钥，存在配额限制和隐私泄露风险
- 网络依赖：设备与控制器需同局域网，无法跨网络远程控制
适合人群
智能家居爱好者、桌面时钟用户、需要物理显示器监控社交媒体数据的创作者、追求本地化控制的隐私敏感用户。
常规风险
- 凭证泄露：YouTube API 密钥若硬编码可能意外提交至代码仓库
- 未加密通信：HTTP 明文传输，同一局域网内的流量可被嗅探
- 越权操作：局域网内任何设备若知晓 IP 均可操控，无认证机制
- 配置覆盖：错误的
sys命令可能导致设备无法正常运行，需恢复出厂设置