Skip to content
 
 

Repository files navigation

Juejin Usage logo

Token 用量明细追踪工具,本地记录、云端同步,
还有线上排行榜看看谁用得最多。

stars issues downloads release last-commit

下载安装包 · 排行榜 · 常见问题 · 用户隐私协议 · 稀土掘金

🖥️ 客户端使用

Juejin Usage 提供 macOS / Windows 桌面客户端,安装即用,无需额外配置。

下载安装

前往 Releases 页面下载对应系统的安装包(macOS 按芯片选 .dmg,Windows 选 .exe),安装即用。

💡 macOS 提示「已损坏」?在终端执行 sudo xattr -dr com.apple.quarantine 后把应用拖入终端窗口即可。

首次启动

  1. 打开 Juejin Usage 应用
  2. 首次运行会自动尝试注册 Claude / Codex Hook 并同步本地用量
  3. 面板将自动弹出,展示用量趋势、模型分布等数据

如未检测到 Claude / Codex 等 Agent 工具,请确认已安装并使用过至少一次。

桌面宠物(可选)

在面板「设置」中点击「桌面宠物」,打开 「显示桌面宠物」,提供 3 个可选的宠物

Click Yoyo Hawking
Click Yoyo Hawking

登录掘金(可选)

在面板「设置」中点击「掘金登录」,绑定账号后可:

⌨️ CLI 使用

需要 Node.js >= 20。macOS / Windows / Linux 安装后后台启动即可打开本地面板:

npm i -g @juejin-opensource/jusage
jusage service start
# 面板: http://127.0.0.1:8452

国内网络较慢可用 npm i -g @juejin-opensource/jusage --registry=https://registry.npmmirror.com/。完整命令、选项与数据说明见 CLI 使用说明

🏆 排行榜

前往 掘金 AI 使用排行榜 查看排名。

🔒 用户隐私协议

本产品采用本地优先架构,数据默认仅存储于您的设备。

  • 📊 本地采集:Token 用量、模型名称、来源渠道(仅本机存储)
  • 🚫 绝不收集:对话内容、Prompt 文本、主机名、项目名、API Key
  • ☁️ 云端同步:需您主动开启,仅上报脱敏的 Token 计数与匿名设备标识
  • 🔐 存储安全:本地数据存储在 ~/.ai-usage/,云端鉴权采用加密 Token
  • 🎛️ 您的控制:随时可开关云端同步,或删除本地数据目录清除全部记录

除了上报您使用的用量总数外,不会采集您任何信息。

具体内容前往点击查看用户隐私协议: 《稀土掘金用户隐私协议

🤝 贡献指南

  • 联系Captain:229199157

源码按 Desktop / CLI / Web 三端贡献。分支规范与本地启动见 Contributing Guide

  • Desktop — Electron 桌面端
  • CLI — 命令行与本地面板
  • Web — 线上看板

📚 参考项目

  • Token Tracker: 自动采集 30 款 AI 编码工具 的 token 用量,用一套漂亮的 Dashboard 看真实成本与趋势。
  • vibe-usage: Token 使用量统计工具(CLI)
  • OpenUsage: The Only AI Usage Tracker That's Truly Yours
  • models.dev: 模型 Token 计价数据源,内置计价表由此增量同步

About

Token 用量明细追踪工具,本地记录、云端同步, 还有线上排行榜看看谁用得最多。

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages