为什么 功能 隐私 下载
G0 · dogfood 公开试用 · 作者本人日常使用中

AI 订阅有 Usage,
人也有。

HumanUsage 把你在 AI 协作中的认知消耗,计量成菜单栏上一块诚实的精力用量表: 四种失控前兆在酿成后果前被点破,低状态下做的决定进次日复核清单。 本地优先,默认沉默。

下载 v0.1.0 tar.gz · 1.3 MB 安装只需四条命令
需要 macOS + Node ≥ 22 + Claude Code · 可选 xbar(菜单栏显示)与 terminal-notifier(通知)

01为什么需要它

当 agent 可以并行干活,瓶颈从"AI 的产出速度"转移到人身上。

1人是新的被限流资源

AI 的用量有仪表盘、有 rate limit;操纵这一切的人没有任何仪表。你同时追着 5 个会话跑的时候,没人告诉你还剩多少劲。

2消耗表,不是余量表

别的工具回答"我还剩多少额度";HumanUsage 回答"我今天烧掉了什么、烧得值不值、人机的分配比是否合理"。两者互补。

3失控有可观测的前兆

任务没收尾就开新任务、AI 问什么都秒点同意、完成半天不验收——这些都能从交互事件里提前看到,不需要摄像头或手环。

02它做什么

像运动监测一样:被动记录、默认沉默、随时可看但不逼你看。

● 61菜单栏一个诚实的数字

HU% 常驻菜单栏,按四档分区着色:充沛 ≥70 / 正常 40–70 / 疲劳 20–40 / 透支 <20。它是"电量",不是 KPI——无排行榜,无徽章。

⚠四种失控前兆

并发过载、机械确认、双向空转、验收债,在酿成后果前被点破。每条提醒都能在面板看到"为什么收到这条"——触发规则与当时的数据。

⇄人机双表与杠杆率

人表记"点":开新任务 1 点、追问或确认 ≈0.4、验收 0.5;AI 表记 tokens。杠杆率(AI 燃烧 ÷ 你的点)回答"AI 到底放大了我多少"。

☑复核清单

低状态下通过的决定,次日精力充沛时补看。补救,而不是马后炮——模拟用户中呼声最高的功能。

…默认沉默

每条通知先过准入三问:可行动?值得?非现在不可?再过预算:每类每小时 ≤1、全局每日 ≤6。表现好的一天 = 零通知的一天。

≡账目可信

实时值与离线重放走同一代码路径,结果恒等;逐笔账单算式透明。表不准 = 死罪,这是工程红线,不是口号。

03界面

真实界面,示例数据。左边是点菜单栏弹出的快捷面板;右边是完整面板的当日双轴曲线。

快捷面板:血条 + 体征 + 等你处理的事,30 秒内处理完。
充沛 ≥70 正常 40–70 疲劳 20–40 透支 <20 1 点 = 开新任务 · 追问确认 ≈0.4 · 验收 0.5
完整面板:当日曲线、四象限时间条、逐笔账单算式、复核清单、日终小结。

04隐私:可审计的承诺

采集清单写在 README 与设置页里,变更走决策流程;测试套件含隐私扫描,可复跑。

✓ 只采集元数据

  • 事件类型与时间戳
  • 会话与项目标识(目录名,非全路径)
  • 确认选项数、键鼠 idle 秒数(仅时长)

✗ 永不采集

  • prompt 与回复正文(hooks 白名单剥离)
  • 窗口标题、剪贴板、按键内容、鼠标轨迹
  • 屏幕内容、URL、文件路径原文

数据去哪

  • 全部在本机 ~/.humanusage/(0700),零自建服务器
  • 本地 API 仅绑 127.0.0.1 + token 认证
  • 卸载即移除 hooks / launchd / 插件,账本可由你亲手删除

不设计用于雇主监控

  • 无管理报表、无团队视图、无集中导出,数据模型里没有管理员角色
  • 本站与产品同一条规矩:无追踪、无 Cookie、无弹窗

05它不是什么

已知限制,写给用户的诚实清单(完整版见仓库 Docs/13)。

  • E 是行为代理指标,不是生理测量;像计步器:不精确,但趋势有效。本工具不构成健康建议。
  • 只看得见 AI 协作:会议、工单、带娃的消耗不在表上——你的真实疲劳可能比表上更重。
  • 前 14 天是校准期:数字仍在学习你的基线,期间只记录、不打扰,体征告警禁用。
  • G0 阶段:仅 macOS、单机假设;机械确认只统计不告警;通知经 terminal-notifier,无交互按钮。

06下载与安装

G0 dogfood 版:早期软件,作者本人正在 28 天自用验证。欢迎同样重度使用 AI 的你一起试。

下载 humanusage-0.1.0.tar.gz 1.3 MB
sha256 7330e8ccf9bf1b38928333b502801271673e884b378c543bf78cb3a93b78fb04 (校验文件)
校验:shasum -a 256 humanusage-0.1.0.tar.gz 
# 1. 解压并进入(需要 macOS + Node ≥ 22 + Claude Code)
tar -xzf humanusage-0.1.0.tar.gz && cd humanusage-0.1.0

# 2. 安装依赖并构建(运行时零第三方依赖)
npm install && npm run build

# 3. 安装到系统:hooks + launchd + xbar 插件(可先 install --dry-run 看清单)
node dist/cli/hu.js install

# 4. 启动 daemon,一次性登录打开面板
node dist/cli/hu.js start && node dist/cli/hu.js open
  • 装完后 ~/.humanusage/bin/hu 可直接用;升级 = 重新打包构建后 hu install,数据不动。
  • 菜单栏显示需 brew install --cask xbar(或 SwiftBar),不装不影响 daemon;通知走 brew install terminal-notifier,缺失自动降级。
  • 首次打开面板会问三个问题(并发基线 / 日预算 / 作息型),可跳过全默认;之后 14 天校准期只记录、不打扰。
  • 卸载:hu uninstall(账本保留)或 hu uninstall --delete-data(连数据一起删)。