Skip to content

TokenStep for Windows v0.1.0

Choose a tag to compare

@canyexuanfan canyexuanfan released this 19 Jun 19:24

TokenStep for Windows v0.1.0

把 AI token 用量变成「每日 AI 步数」的本地小工具。基于 macOS 版 TokenStep(作者黄叔)移植,Tauri 2 + Rust 构建。

📦 下载(二选一)

方式一:免安装版(推荐)

下载 TokenStep.exe(约 7 MB),双击即可运行,无需安装。

  • 想放哪就放哪,建议放固定目录(截图会存在同目录的 share/ 文件夹)
  • 想卸载直接删 exe 即可

方式二:安装版

下载 TokenStep_0.1.0_x64-setup.exe(约 3 MB),双击安装。

  • 会创建开始菜单快捷方式和卸载入口
  • 需要 WebView2 运行时(Win10/11 一般已预装,缺失时自动下载)

⚠️ 首次运行 Windows SmartScreen 可能弹出「未知发布者」警告,点击「更多信息 → 仍要运行」即可。

✨ 功能

  • 🔔 系统托盘驻留,动态进度圆环显示今日 token 完成度
  • 🏠 仪表盘:今日 / 历史 / 统计 / 隐私 / 设置
  • 🎨 5 套主题配色:青绿 / 海蓝 / 紫藤 / 琥珀 / 石墨,一键切换立即生效
  • 🔄 分段圈数进度:用量超目标后开始新一圈,像运动圆环
  • 📸 截图:一键导出今日数据卡片 PNG,默认存 share/ 文件夹
  • 📊 CSV 导出 + 贡献墙热力图(GitHub 风格活动图)
  • 内存优化:流式读取,支持超大日志历史
  • 💰 OpenAI 价格估算(gpt-5.5 / gpt-5.4)
  • 🔒 本地优先:只读取用量元数据,不上传代码或对话内容

📖 数据来源

自动读取本机已安装的 AI 编码代理的用量日志:

  • Codex~/.codex/sessions/**/*.jsonl + .codex/archived_sessions/*.jsonl + SQLite threads
  • Claude Code~/.claude/projects/**/*.jsonl

不联网,不上传,只统计 token 数量、日期、模型。

🙏 致谢

基于 TokenStep(macOS 原版,作者 黄叔 / Chaoqiang Huang)移植。感谢原作者的开源贡献,遵循 MIT 许可证。

Windows 移植版作者:十七°

🔧 从源码构建

cd windows/src-tauri
cargo install tauri-cli --version "^2.0"
cargo tauri build      # 产出 NSIS 安装包
cargo build --release  # 只产出单 exe