TokenStep for Windows v0.1.0
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+ SQLitethreads表 - 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