LifeHud —— 长在 DSH 里的个人工作台

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 记为离开。

三个设计点:

  1. 合并,不然库会炸:连续同应用的心跳合并成一条带 duration 的事件——「8 小时都在 VS Code」只占一行,不是 14,400 行。空闲强度也只能存离散档位(0-10 / 10-60 / 60-180 / 180+),存每秒变化的原始值会让合并语义直接失效。
  2. 未闭合事件先落盘:首个样本就 INSERT,之后每 60 秒原地 UPDATE 时长。如果只在应用切换时才写,页面一小时内会一直是空的。
  3. 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。