SUMERY · LIBRALibra English

Sumery Libra

衡量工作与恢复的平衡

把工作时长、疲劳信号与身体数据放在一起,在你自己的电脑上计算。

面向 VS Code 与其分支(Cursor、Windsurf 等),以及 GoLand、WebStorm、IntelliJ IDEA 等 JetBrains IDE。实测环境:VS Code 1.139、GoLand 2026.3。个人使用目前免费;在公司里使用需要商业授权。

Libra 概览的「今日」页:今日工作时长、与昨天的对比、最长连续一段、已扣除的空闲与锁屏时间、中文输入字数
今日:工作时长、和昨天比、最长连续一段,空闲与锁屏已经扣掉。
Libra 的「工作时段」:一周七天,每天按 macOS 活动、AI 会话、IDE 编码分三行画出时段,右侧是去重后的时长
一周:每个来源一行,IDE 编码单独一行;重叠的时段不重复计入。

四步开始用

IDE 开了十个小时,其中写代码的是多少?开着没动、在看文档、在开会的又是多少?一天结束时很难说清,因为能看到的只有「窗口在前台」。

  1. 装上插件,照常写代码

    你在当前编辑器里键入、删除、粘贴时,插件往本机文件里追加一行时间。打开文件、翻代码、切窗口、git 在磁盘上改写文件,都不写。

  2. 停下,计时就停在最后一次键入

    停下想一两分钟再接着写,算同一段;停下超过 3 分钟,这一段在最后一次编辑处结束。切到别的应用时,插件立刻把最后一次编辑写出来。

  3. 几个来源合在一起,不重复算

    IDE 插件、DSH 会话、macOS 前台应用各记各的,Libra 取并集:编辑器和终端同时观测到的那段时间只算一次。空闲、锁屏、睡眠从总数里扣掉。

  4. 看今天和这一周

    今日工作时长、和昨天比、最长连续工作、休息次数、按小时的分布,以及每一天按来源分开的时段。

只在你编辑代码的时候记时间

Libra 的 IDE 插件只在你编辑代码的时候记时间。停下超过 3 分钟,这一段就结束在你最后一次键入的那一刻,之后停下来的时间不计入。

插件写下的就是这样一行(~/.orea/ide-heartbeats.jsonl),没有别的:
{"source":"ide","kind":"heartbeat","at":1789500000000,"sessionId":"jetbrains:GO:/Users/me/work/libra","appId":"jetbrains:GO","appName":"GoLand","cwd":"/Users/me/work/libra"}

时间、IDE 名称、项目根目录。不记文件名、代码内容、编程语言、窗口标题和按键。

数据与边界

数据放在哪里、格式是不是你的、以及它做不到什么。

数据只在本机

所有记录写在 ~/.orea/(或 $OREA_HOME)下的 JSON Lines 文件里,一行一件事。插件不联网,不上传。

格式是开放的

不装 Libra 桌面应用,这些文件也是你的:tail -f ~/.orea/ide-heartbeats.jsonl 就能看,用任何脚本都能算。字段含义写在插件说明里。

随时能关

Libra 里每个来源一个开关,关掉是真的停止采集,不是忽略数据;已经记下的不会被删除。插件关掉后几秒内停止写入,不用重启 IDE。

能力之外

  • 系统「屏幕使用时间」:macOS 没有给第三方的公开接口。Libra 用自己采样的前台应用与空闲时间,并在界面上写明。
  • 步数、心率、睡眠:这些只在 iPhone 与 Apple Watch 上,Mac 上没有这份数据。界面显示「未连接」,不填估算值。
  • 输入法字数与 Keep 运动:依赖对方的非公开接口,可能随对方更新失效;失效时显示原因,不显示猜出来的数字。
  • 不做医疗判断:Libra 告诉你工作了多久、多久没停,不告诉你「你累了」或「你健康」。

数据来源

来源回答什么回答不了什么
IDE 插件在 VS Code 系或 JetBrains IDE 里编辑代码的时段读代码、想方案的时间(超过 3 分钟不编辑就不算)
DSH 插件AI 编程会话里每一轮、每次工具调用的时间对话内容:只记时间,不记 prompt 与回复
macOS 前台与空闲哪个应用在最前面、多久没碰键盘鼠标、锁屏与睡眠窗口标题(需要额外授权,默认不采)
搜狗输入法今天通过输入法上屏的中文字数英文键盘直接敲的字符;写了什么
Keep运动记录、体重、静息心率(不计入工作时长)全天步数、睡眠、HRV
专注计时你主动开始的每一轮专注与休息没有开计时的工作

个人使用,目前免费

「目前免费」只是现状,不是长期承诺:如果以后改收费,已经免费给你的能力不会收回,已发布版本继续可用。

能力免费核心Pro
专注计时有有
今日概览有有
活动时间线有有
IDE 插件(VS Code 系 / JetBrains)有,现在就能用有
健康合并(运动、体重、静息心率)—有
身体指标—有
习惯—有
洞察—有
提醒—有
导出—有

个人使用 · 目前免费

上面列出的能力,个人使用都不收费:没有付费墙,没有试用期,不用注册,不用联网校验。功能不阉割,也没有功能因为免费而打折扣。

公司使用 · 商业授权

在公司里使用需要商业授权:¥299 / 公司 / 年,不限人数。条款、发票与续期见企业页。

桌面应用(macOS)与两个 IDE 插件都已发布,个人使用照上面的规则,装上就能用。

下载

桌面应用(macOS)已发布首个版本;IDE 插件推荐从官方市场一键安装。

Libra 桌面应用(macOS)

把插件记下的时间、专注与身体数据放在一起看。首发 macOS(Apple 芯片);安装包暂未签名公证,首次打开需右键 → 打开。

版本
—
大小
—
安装与校验

打开 .dmg,把 Libra 拖进「应用程序」。

SHA-256:—

VS Code 系插件

VS Code 与 Cursor、Windsurf 等分支。声明兼容 VS Code 1.75 起,实测 1.139。

版本
—
大小
—
到 VS Code 市场安装
安装与校验

命令行:code --install-extension libra-coding-time-x.y.z.vsix(Cursor 把 code 换成 cursor);或在扩展面板「⋯ → 从 VSIX 安装」。

SHA-256:—

JetBrains 插件

GoLand、WebStorm、IntelliJ IDEA、PyCharm、DataGrip 等。声明兼容 2024.2 起,实测 GoLand 2026.3。

版本
—
大小
—
到 JetBrains 市场安装
安装与校验

Settings → Plugins → ⚙ → Install Plugin from Disk…,选中下载的 .jar。

SHA-256:—

为了防止链接被转发盗用和批量抓取,下载链接由服务器按次生成、一次性有效,同一网络短时间内点得太密会稍等几秒——按钮会自己恢复,不用刷新。

两个 IDE 插件均按Sumery Libra IDE 插件许可协议提供。公司商业授权:企业页。购买相关:退款政策 · 客服与支持 · 发票说明。

本页用自托管的 Umami 统计访问量与按钮点击:不设 Cookie,不存用户 ID。