LifeHud —— 长在 DSH 里的个人工作台
打开 DSH 的第一屏不该是一句空白的欢迎语。LifeHud(中文名「抬头」)把七张卡片钉在一屏:任务、天气、会话、专注、热力、体重、相框。
为什么做这个
每天开电脑的第一个动作是翻应用:任务清单看今天还剩几件、天气 App 看要不要带伞、再把昨天的会话找回来。这些信息彼此无关,却总要一起看。
LifeHud 是一个 DSH 插件:不改动 DSH 本身,只是往侧栏加一个面板、往主区加一个 keyed 页面,把散在各处的数据聚到一屏。它本身几乎不产生数据——唯一自己采的只有「专注 / 热力」。
一屏七张卡
| 卡片 | 数据来源 | 读法 |
|---|---|---|
| 当前时段任务 | NowTree 的 nowtree.sqlite |
node:sqlite 只读打开,按 time_slot 过滤当前时段 |
| 天气 | Open-Meteo(免 key) | 48 小时逐时图标,可跨午夜;Host 缓存 10 分钟 |
| 最近会话 | DSH 的 session_projcache |
读投影缓存 JSON,运行中转圈,点击跳回会话 |
| 专注 | 自己采:collector.ps1 |
最近 24 小时按应用的横向条形图 + 最长一段,一律扣掉 AFK |
| 热力日历 | 同一份采集库 capture.db |
当月每日活跃分钟,分位数分档,GitHub 风格 |
| 体重 | 小米云 MX80(只读) | 拉下来镜像到本地 SQLite,画「最近有数据的 7 个测量日」 |
| 相框 | 本地文件 | 自己上传,当一块背景板 |
任务卡的口径值得说一句:NowTree 自己的「Next」语义很严(库里 58 条 active,符合它定义的只有 2 条)。LifeHud 用的是用户视角——只要任务落在当前时段就显示,另用 NEXT 徽标标出哪些也在 NowTree 的 Next 里。
只读聚合:能不碰的数据一律不碰
插件跑在别人的进程里,一旦写坏别人的库就是灾难。所以这里有硬边界:
- 只读:NowTree 的任务库、DSH 的会话投影、小米云、ActivityWatch(只在首次迁移时读一次文件);
- 可写只有
~/.dsh/lifehud/:体重镜像库、专注采集库capture.db、设置、相框; - 路由全部自己做鉴权:DSH 不给插件路由加会话保护(页面
/返回 401,但插件自己的/lifehud/api/*是裸的),所以每条路由都过一遍isLocalPeer,只放行127.0.0.1/::1; - 零第三方依赖:Node 内置模块 + 原生
fetch,页面侧手写React.createElement,没有 JSX、没有打包、没有eval、没有外链脚本。
专注与热力为什么自己采
v1.1.0 之前这两张卡读 ActivityWatch 的本地 API。问题很直接:关掉 AW 就没数据,而大多数人不会为了看一个卡片常驻一个追踪器。
v1.1.1 改成自己采,用一个不到百行的 PowerShell 脚本(collector.ps1):Windows 自带的 PowerShell 5.1 + 内存里编译的 C# P/Invoke,每 2 秒取一次「前台窗口的进程名 / 标题」和「键鼠空闲秒数」,idle ≥ 180s 记为离开。
三个设计点:
- 合并,不然库会炸:连续同应用的心跳合并成一条带
duration的事件——「8 小时都在 VS Code」只占一行,不是 14,400 行。空闲强度也只能存离散档位(0-10 / 10-60 / 60-180 / 180+),存每秒变化的原始值会让合并语义直接失效。 - 未闭合事件先落盘:首个样本就 INSERT,之后每 60 秒原地 UPDATE 时长。如果只在应用切换时才写,页面一小时内会一直是空的。
- AFK 必须扣干净:窗口时长先减掉离开区间,
explorer.exe/Program Manager一律丢弃(锁屏、桌面焦点)——否则一天里 explorer 能占几百分钟。
历史也没丢:首次启动会把 ActivityWatch 库里所有 bucket 和分类规则一次性迁进 capture.db(幂等,只做一次,AW 原库只读),迁完就能把 AW 卸了。
隐私口径是显式的:只读前台窗口的进程名和标题、只读键鼠空闲秒数;不采具体输入、不采屏幕内容、不采浏览器 URL、不联网。storeTitles: false 就只存应用名。
几个踩过的坑
- 中文窗口标题变乱码:Windows PowerShell 5.1 在管道下按 ANSI 输出。脚本开头必须设
UTF8Encoding,脚本自身还得保持纯 ASCII(PS 5.1 按 ANSI 读脚本,非 ASCII 字节会被误读)。 - 采集器不能靠 PATH:不点名
pwsh(很多机器没有),直接用%WINDIR%\System32\WindowsPowerShell\v1.0\powershell.exe的绝对路径。 - 写库回滚后必须清 rowId:事务里 INSERT 拿到
lastInsertRowid,一旦 COMMIT 失败触发 ROLLBACK,这些 rowId 已经不存在;不清空的话下一轮 UPDATE 命中 0 行、SQLite 还不报错——一段专注数据就静默丢了。这是评审阶段抓到的真 Bug。 - Node 24 没有 RC4:OpenSSL 3 不带 legacy provider,小米云签名只能纯 JS 实现,而且必须先吃掉 1024 字节密钥流才对得上。
weightId是毫秒时间戳,但必须按文本存:一旦按 number 落库变成…0146.0,就再也去不了重。- SVG 里不能放
<text>:体重图用preserveAspectRatio="none"做自适应拉伸,文字会被非等比拉变形;刻度、点值全改成 HTML 绝对定位覆盖层。 - Host 代码没有热更新:改
index.js必须remove_bundle→install_bundle(直接重装会报 already-installed),改client.js只需刷新页面。
技术形态与验证
- Host 侧(
plugin/index.js+plugin/lib/):apply(ctx, config)→ctx.inject(['webServer'])注册 6 条 exact 路由;后台另跑体重同步(10 分钟)和采集器(长驻子进程,崩了指数退避重启、封顶 5 次)。 - Client 侧(
plugin/client.js,单文件):window.__ModuleLoader__.load+ctx.slots.register,挂到sidebar.panellist(侧栏入口)和main(页面)。 - 验证方式:没有测试框架,用零依赖探针硬跑——
spike/probe-hud.mjs(聚合卡 21 项 / 真实库 24 项)、probe-capture.mjs(采集器 50 项)、probe-focus.mjs(60 项)、probe-weight.mjs(46 项)、probe-update.mjs(离线 32 项)。探针不碰浏览器,直接打 Host 逻辑,所以 CI 里跑得动(端口从参数传,不硬编码——DSH 的端口每次启动都变)。
安装
// 在 DSH 里执行(需要 Full access)
plugin_manager({ action: 'install_bundle', target: '<本仓库路径>/plugin' })
装完刷新页面即生效。数据源路径都有默认值,通常一行配置都不用改。
已知限制
- 打开 DSH 不会自动停在这一页,也不会自动收起侧边栏——DSH 没有公开对应接口。
- 专注数据只在 DSH 运行时采集,不做 7×24;“关掉采集开关”目前只影响展示,Host 仍在采。
- 天气的「一句话」是规则拼接,不是模型生成。
- 「检查更新」只在手动点按钮时联网(刻意的,不想让页面加载替你发请求);插件是
link:安装,升级要git pull+ 重装。 - 小米云那段走的是从米家插件逆出来的非公开接口,随时可能失效;只用于备份自己的数据,不自动登录、不保存密码。
仓库
github.com/z1lyA/dsh-lifehud — MIT,当前自用版本 v1.1.2,欢迎 Star / Issue。