Helm（Dock）开源安卓时钟软件

admin

Helm（Dock）开源安卓时钟软件

链接：wxydejoy/Helm: 横屏常亮的安卓工位屏：时钟、电脑监控、米家快控、电脑启动项，以及手机本地播放。






Helm（Dock）
横屏安卓桌面摆件 + Windows Python Hub：显示天气与室内温湿度、电脑监控，控制米家设备，一键启动电脑上的白名单程序。

手机只通过局域网 HTTP 与 Hub 通信，不直连米家。协议是两边的唯一契约：

docs/lan-protocol.md — 说明、时序、验收
docs/openapi.yaml — OpenAPI 3

默认

游客，如果您要查看本帖隐藏内容请回复

Bearer token。

仓库结构

目录
说明

android/
安卓客户端（Kotlin / Jetpack Compose）

hub/
Windows Hub（米家 + 本机启动 + PC 监控 + 托盘 exe）

docs/
局域网协议（改接口先改文档）

安卓（客户端）
横屏全屏 Dock，未配置 Hub 时进入预览模式（本地演示数据）。

主屏

大时钟 + 中文日期（多种字体与字号）
PC 监控条：CPU / 内存 / GPU / FPS（有数据时约 3s 刷新）— 点击进入设置
左侧：**多 3 个 Windows 应用快捷启动（Remix 图标）
右侧：米家灯/开关 + 手机媒体控制（上一** / 播放暂停 / 下一**）
底部：室外天气 + 室内温湿度
可选视频背景（循环静音）；方块样式（磨砂 / 深色 / 实心 / 细线）与透明度可调

设置

Hub：地址 / 端口 / Token，测试连接（/health）
视频背景：选择 / 更换 / 清除本地视频
方块样式与字体排版预览
插电亮屏、拔电熄屏（需设备管理员，仅用于 lockNow()）
媒体控制需开启通知使用权

构建
cd android
./gradlew :app:assembleDebug
安装后**次打开为预览；在设置页填入 Hub 的 IP、17890、token 即可联机。

单元测试：

./gradlew :app:testDebugUnitTest
Windows Hub（服务端）
完整说明见 hub/README.md。

推荐：打包 exe，管理员运行（托盘图标 + 米家重新登录）

cd hub
powershell -ExecutionPolicy Bypass -File .\build-exe.ps1
# 右键 dist\DockHub.exe → 以管理员身份运行
源码开发：

cd hub
uv sync
uv run dock-hub --init
uv run dock-hub --list-devices
uv run dock-hub
uv run dock-hub --login    # 米家过期时重新扫码
配置：%USERPROFILE%\.config\dock-hub\hub.yaml（token、设备白名单、本机程序路径）。

防火墙放行入站 TCP 17890；CPU 温度需 PawnIO + 管理员权限。

联机速查

Windows 启动 Hub，记下局域网 IP（如 10.83.22.31）与 hub.yaml 里的 token
安卓设置页填入 IP、端口 17890、token，点测试连接
米家设备名在 Hub 侧用 uv run dock-hub --list-devices 核对

许可

Hub 依赖 mijia-api（GPL-3.0）；分发 Hub 需同样开源
安卓内置字体见 android/app/src/main/assets/font-licenses/（OFL）

---

下载链接：
百度网盘：

游客，如果您要查看本帖隐藏内容请回复

  提取码：52pj
GitHub：

游客，如果您要查看本帖隐藏内容请回复

GitHub：

游客，如果您要查看本帖隐藏内容请回复