dsh-lifehud
抬头(LifeHud) —— 长在 DeepSeek Harness 里的个人工作台:一屏看完今天该干什么、外面什么情况、我昨天停在哪里。
v1.1.3 · 零依赖 · 单个 DSH 插件 · 不改动任何被读取的应用(专注数据由自己采集,见下)
装什么、读什么
LifeHud 自己几乎不产生数据:只有「专注 / 热力」是它自己采的(本机 Windows API → 自己的 SQLite),其余全是只读聚合:
| 卡片 | 数据来源 | 读法 |
|---|---|---|
| 当前时段任务 | NowTree 的 nowtree.sqlite |
node:sqlite 只读打开,按 time_slot 过滤 |
| 天气 | Open-Meteo(无需 key) | 48 小时逐时数据,可跨午夜 |
| 最近会话 | DSH 的 session_projcache |
读 json;已删除的会话(无日志目录)不显示 |
| 专注(v1.1.1) | 本机自采集:plugin/collector.ps1 每 2 秒读前台窗口与空闲时间 |
减掉 AFK 区间,按应用聚合最近 24 小时,并显示最长一段;空闲强度按四档另存(v1.1.2,页面暂未展示) |
| 热力日历 | 同一份本地采集库 <dataDir>/capture.db |
当月每日活跃分钟,分位数分档 |
| 相框 | 本地文件 ~/.dsh/lifehud/ |
自己上传 |
| 体重(v1.1.0) | 小米云 user/get_user_device_data(MX80 体脂秤) |
只读拉取,落地到自己的 SQLite 镜像;画最近有数据的 7 个测量日(纵轴刻度 + 悬停看某天数值) |
体重卡的取数细节(RC4 签名、会话过期后怎么重新登录)见 docs/小米云取数.md。
「网页对话 ↗」直接调系统浏览器打开(内嵌 webview 会被 DeepSeek 风控判定"环境不安全")。
专注 / 热力:自己采集,不再需要 ActivityWatch(v1.1.1)
v1.1.0 之前这两张卡读 ActivityWatch 的本地 API,关掉 AW 就没数据。v1.1.1 起改成自己采:
- 采集器
plugin/collector.ps1:Windows 自带的 PowerShell 5.1 + 内存里编译的 C# P/Invoke,每 2 秒取「前台窗口的进程名 / 标题」和「键鼠空闲秒数」,idle ≥ 180s记为afk。零安装、不联网、不读其它应用的数据。 - 落库
<dataDir>/capture.db,通用模型:buckets(哪几条数据流)+events(data列存原始 JSON)+meta。连续同应用的心跳会合并成一条带duration的事件,所以"8 小时都在 VS Code"只占一行,而不是 14,400 行。 - 一次性迁移 AW 历史:首次启动时把 ActivityWatch 库里所有 bucket(窗口 / AFK / stopwatch)和分类规则
classes全量搬进capture.db,之后可以卸载 AW。迁移幂等,只做一次;AW 原库只读、不修改。 - 隐私:默认保存窗口标题,配置
storeTitles: false就只存应用名;数据只在本机dataDir,不出网、不上传。 - 开关:页面「设置 → 专注卡采集」关掉后卡片显示「已关闭」(目前只是不展示,Host 仍在采集)。
安装
// 在 DSH 里执行(需要 Full access)
plugin_manager({ action: 'install_bundle', target: '<本仓库路径>/plugin' })
安装后刷新页面即生效。改 Host 代码(plugin/index.js)需要 remove_bundle → install_bundle 重新加载;改 Client(plugin/client.js)只需刷新页面。
检查更新(v1.1.2)
页面「设置 → 版本与更新」里有一个「检查更新」按钮:点一下才知道远端有没有新版本,不会自动联网。
- 数据源:公开仓库
z1lyA/dsh-lifehud的 GitHub Release / Tag(只读)。有 Release 就显示发布页、发布日期与正文,没有就回退到 tags 取最大的vX.Y.Z。 - 只带
user-agent: dsh-lifehud/<版本>,不带账号、设备号或 token;Host 只把最近一次结果留在内存里(仅用于失败降级),页面把上次手动查到的结果显示在设置里(localStorage,不发请求)。 - 同时显示 Host 版本与页面资源版本;两者不一致会提示按
Ctrl+R,避免「Host 升级了、浏览器还在跑旧代码」的假故障。 - 升级步骤就写在弹窗里:
git pull→plugin_managerremove_bundle → install_bundle → 刷新页面。 - 离线、超时、GitHub 限流、仓库名写错都有中文提示,并保留上一次查到的结果(标
stale)。
配置
数据源路径写在 plugin/cordis.patch.yml 的 config 里:
数据源路径都有默认值,装完通常一行配置都不用改(想覆盖再改 plugin/cordis.patch.yml):
| 配置项 | 默认值 | 说明 |
|---|---|---|
nowtreeDb |
%APPDATA%\com.nowtree.app\nowtree.sqlite |
NowTree 的任务库(只读) |
leveldbDir |
%LOCALAPPDATA%\com.nowtree.app\EBWebView\Default\Local Storage\leveldb |
NowTree 的早/午/晚分界(只读) |
dataDir |
~/.dsh/lifehud |
LifeHud 自己的可写状态(设置、相框、体重镜像库) |
weightDb |
<dataDir>/lifehud-weight.db |
体重镜像库(只读云、只写本地) |
miSession |
<dataDir>/mi-session.json |
小米云会话文件,自己放进去、别提交(格式见 docs/小米云取数.md) |
miDid |
自动发现 | 体脂秤设备号:插件会从账号设备列表里找,不用手填 |
weightTtlMs |
600000 |
体重同步 TTL(10 分钟),手动「刷新」会强制跳过 |
captureDb |
<dataDir>/capture.db |
专注自采集库(LifeHud 唯一自己写的库) |
capturePollSeconds |
2 |
采样间隔(秒);想省资源可以调 5 |
afkThresholdSeconds |
180 |
空闲超过这么多秒算「离开」 |
storeTitles |
true |
是否落库窗口标题;false 只存应用名(更隐私) |
historyImport |
'once' |
'never' 表示不迁移 ActivityWatch 历史 |
historySource |
自动推导 | ActivityWatch 库路径,正常情况不用填 |
updateCheck |
true |
false 完全关掉检查更新(不联网,路由返回 disabled) |
updateRepo |
z1lyA/dsh-lifehud |
检查哪个仓库;fork 时改成自己的 owner/name |
天气位置也可以在页面「设置」里点「使用我的位置」自动写入。 体重卡、「专注卡采集」两个开关都在「设置」里(存 localStorage,与其它界面设置同一套)。
安全边界
- 所有 HTTP 路由只接受 loopback(
127.0.0.1/::1)——DSH 不会给插件路由加鉴权,这层必须自己做。 - 不写任何外部数据源:NowTree / DSH 会话 / 小米云全部只读;ActivityWatch 只在首次迁移时读一次库文件,运行期零依赖。LifeHud 自己的可写状态只在
dataDir(体重镜像库 + 专注采集库capture.db)。 - 专注采集不越界:只读 Windows 的前台窗口进程名/标题和键鼠空闲时间;不采键鼠具体输入、不采屏幕内容、不采浏览器 URL,也不联网。
- 小米云会话文件只读,不进 git、不进日志、不打印明文;不自动登录、不保存小米密码。
- 设备号不写死:插件从账号设备列表里自动发现体脂秤,配置里不需要出现任何人的设备 id。
- 面板里没有任何
eval、没有外链脚本、零第三方依赖。
目录
plugin/ 唯一被 DSH 加载的包(index.js = Host 入口,lib/ = Host 实现,client.js = 浏览器,collector.ps1 = 专注采集器)
docs/ ADR(架构决策)+ 小米云取数方法 + BACKLOG(评审里先不做的事,含拆法与验收标准)
spike/ 独立探针与验证脚本(不依赖 DSH 也能跑)+ RESULT.md 结论
AGENTS.md 给接手 AI 的协作手册(含所有踩过的坑)
免责声明
- 小米云那段取数走的是非公开接口(从米家插件里逆出来的),不是官方 API,随时可能改或失效; 仅供个人备份自己的数据,用之前想清楚小米的服务条款。项目不提供自动登录、不保存你的密码。
- 其余数据源(NowTree / DSH 会话 / 小米云)全部只读,本插件从不写它们;ActivityWatch 只在首次迁移时读一次库文件。
已知限制
- 打开 DSH 后不会自动停在这一页,也不会自动收起侧边栏——DSH 没有公开对应接口。
- 天气的「一句话」是规则拼接,不是模型生成。
- HUD 快照(任务/天气/会话/专注/热力)现在每 5 分钟自动刷新一次(页面隐藏时不拉,回到页面补一次);体重仍由 Host 每 10 分钟自动同步。
- 专注数据只在 DSH 运行期间采集:DSH 关着的时间段没有数据(7×24 采集不做)。
- 空闲强度(
idle_seconds四档)从 v1.1.2 起已落库,但页面还没展示;留给 1.2 详情页。 - 「专注卡采集」开关目前只影响展示,Host 还在继续采集(真正停采是 1.2 的事)。
- 检查更新只在手动点按钮时联网(这是刻意的:不想让页面加载时替你发请求);GitHub 未登录限流 60 次/小时,限流时会显示提示并沿用上次结果。插件是
link:安装,所以升级要git pull+ 重装,没有「点一下自动更新」。 - 小米云会话过期后要手动重新登录一次才能续上(卡片会红字提示,历史数据不丢)——步骤见
docs/小米云取数.md。 - 布局是 flex 便当盒:第一行 天气 / 体重 / 任务,第二行 专注 / 会话 / 相框 / 热力,不做瀑布流。
许可
MIT
No comments yet. Be the first to write one.