Skip to content

canyexuanfan/TokenStep-Windows

 
 

Repository files navigation

TokenStep for Windows

像记录步数一样,记录你每天的 AI Token 消耗。

AI 时代,每个人都在和 Agent 一起工作。

但我们很少知道:今天到底用了多少 AI?有没有比昨天更进一步?

TokenStep 是一个 Windows 桌面应用,用来本地统计你在 Codex、Claude Code 等 AI 编程工具里的 Token 消耗,并把它变成一个像健身圆环一样的每日目标。

默认目标是:每天 1 亿 Token

当你超过目标,圆环会进入下一圈。用得越多,颜色越深。

它不是为了严肃比较,而是让你直观看到:今天你和 AI 一起走了多远。

本版本是 macOS 版 TokenStep 的 Windows 移植版,原作者为 @黄叔。MIT 许可证。原项目地址:https://github.com/Backtthefuture/TokenStep

立即下载

下载最新版安装包,双击运行即可:

下载 TokenStep for Windows 最新版

也可以从 Release 页面查看所有版本:

GitHub Releases

安装包已使用自签名证书签名。首次运行时 Windows SmartScreen 可能会提示「已保护你的电脑」,点击「更多信息 → 仍要运行」即可,这是自签名证书的正常现象。

如果你更偏好免安装版,也可以直接下载 TokenStep_vX.X.X.exe,双击运行,无需安装。

TokenStep 适合谁?

TokenStep 适合这些人:

  • 每天使用 Codex / Claude Code 写代码的人
  • 用 AI Agent 做内容、开发、研究、自动化的人
  • 想知道自己每天到底消耗了多少 AI Token 的人
  • 把 AI 当成生产力基础设施,而不是偶尔试用工具的人

以前我们看步数,知道自己今天有没有动起来。

现在我们看 Token 消耗,知道自己今天有没有真正用 AI 推进工作。

它能做什么?

  • 系统托盘常驻,后台运行,实时统计今日 Token 消耗和进度圆环。
  • 点击托盘图标打开主窗口。
  • 仪表盘:今日、历史、统计、隐私、设置。
  • 超过 1 亿后自动进入第 2 圈、第 3 圈。
  • 最近 30 天 Token 使用趋势(按客户端分色堆叠柱图)。
  • 按客户端、按模型查看用量统计。
  • 粗略估算 Token 消耗金额。
  • 每日目标可设置,默认每天一个亿。
  • 自动刷新,默认 1 分钟。
  • 多种主题色,圆环、活动墙和按钮会一起变化。
  • 一键截图分享当前页面。
  • Codex 5 小时 / 7 天剩余额度可在设置中打开,默认关闭。
  • Claude Code 配额卡片(需已登录 Claude Code)。
  • 三语界面:简体中文 / English / 繁體中文,切换立即生效。
  • 自动检查更新,发现新版后可一键安装。
  • 本地数据存放在 %APPDATA%\TokenStep,不上传任何内容。

当前支持

  • Codex:优先读取 Codex 本地 SQLite token 汇总,必要时回退 JSONL。
  • Claude Code:读取 ~/.claude/projects 下的 JSONL 转录日志。
  • CC Switch:实验性支持,读取 ~/.cc-switch/cc-switch.db 的代理请求日志(经过 CC Switch 代理的 Codex/Claude/Gemini 流量)。

更多 AI 编程工具支持会逐步加入。

隐私

TokenStep 默认只做本地统计。

它只读取 Token 用量元数据,例如日期、模型、客户端名称和 Token 数量,用于生成趋势、圆环和统计图。

它不会上传你的代码、prompt、对话正文或项目文件。

唯一的外部网络请求是「检查更新」(访问 GitHub Releases)和「Token 榜单」(可选功能,访问 scys.com),均可关闭。

「消耗金额」只是本地粗略估算,不等于真实账单。

为什么做 TokenStep?

因为 AI 编程工具正在变成新的「工作现场」。

过去我们用日历看时间,用步数看运动,用记账软件看消费。

但 AI 使用量一直是隐形的。

TokenStep 想把这件事变得可见:

今天你不是用了多少工具,而是和 AI 一起走了多少步。

从源码构建

要求:

  • Windows 10/11
  • Rust(stable,x86_64-pc-windows-msvc)
  • Node.js(用于 jsdom 测试,可选)

构建并产出 NSIS 安装包:

cd windows/src-tauri
cargo tauri build

产物生成在 windows/src-tauri/target/release/bundle/nsis/

签名与部署流程见 windows/scripts/build-release.bat(含 NSIS 静默覆盖安装的 patch,升级时不弹卸载确认)。

跨平台移植说明

本 Windows 版与 macOS 版在核心数据采集与统计逻辑上保持一致,但以下 macOS 专属功能不在 Windows 版范围内:

  • Token Island(刘海浮层)、菜单栏浮层
  • Apple 公证 / DMG 打包
  • iCloud / 系统集成特性

Windows 版使用系统托盘 + 主窗口的交互模式,对应 macOS 的菜单栏 + 浮层。

致谢

本项目基于 @黄叔macOS 版 TokenStep 移植,感谢原作者开源与支持。MIT 许可证。

开源协议

MIT。见 LICENSE

About

Windows 版 TokenStep · 用 Tauri+Rust 把 macOS 原 TokenStep 移植到 Windows,本地统计 Codex / Claude Code 的 Token 消耗 · MIT

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages

  • Swift 50.0%
  • JavaScript 14.5%
  • Rust 14.3%
  • Python 9.9%
  • HTML 7.9%
  • CSS 1.5%
  • Other 1.9%