Token Monitor 源码构建教程npm install 到三平台安装器.dmg/.exe/AppImage完整流程【免费下载链接】token-monitorLocal-first desktop widget for tracking token usage, costs, and limits across 43 AI coding tools—including Claude Code, Codex, Cursor, OpenCode, OpenClaw, and more—with multi-device sync.项目地址: https://gitcode.com/gh_mirrors/tok/token-monitorToken Monitor是一款本地优先Local-first的桌面小组件用于实时追踪43 款 AI 编程工具Claude Code、Codex、Cursor、OpenCode、OpenClaw 等的 Token 用量、成本与额度限制并支持多设备同步。本文将带你完成Token Monitor 源码构建的完整流程从npm install安装依赖到用 electron-builder 打包出 macOS 的.dmg、Windows 的.exe安装器和 Linux 的AppImage全程只需几条命令。一、构建前准备环境与系统要求⚠️ 两条硬性规则先说清楚Node.js ≥ 22.15项目 package.json 中engines字段声明在目标操作系统上构建——electron-builder 无法交叉编译打 macOS.dmg必须用macOS打 Windows.exe必须用Windows打 LinuxAppImage必须用Linux想同时发布三平台安装器就需要三台机器或三套 CI 环境。二、克隆仓库并执行 npm installgit clone https://gitcode.com/gh_mirrors/tok/token-monitor cd token-monitor npm installnpm install完成后无需手动下载任何二进制依赖。项目采用按需确保策略运行时和打包脚本会调用 scripts/ensure-vendored-tokscale.js自动校验并补齐锁定版本的 tokscale 采集二进制带 sha256 校验与--version冒烟测试。而npm install、lint、测试环节保持离线不会触发下载。建议先跑一遍质量检查确认环境无误npm run verify # 等价于 eslint node --test三、npm start 先跑开发版验证环境可用构建安装器前先用开发模式确认应用能正常启动npm start # 等价于 ensure:tokscale electron .首次启动后进入本地模式默认无需任何 Hub 配置应用会立即开始追踪本机的 AI 工具日志。窗口会显示实时 Token 总数与成本能正常显示数据说明 Node、Electron 与 tokscale 二进制三者都工作正常可以进入打包环节。四、一键构建三平台安装器核心命令都在 package.json 的scripts里按下表选择即可平台命令产物输出到dist/ macOS Apple Siliconnpm run dist:macToken-Monitor-版本-arm64.dmg.zip macOS Intelnpm run dist:mac:x64Token-Monitor-版本-x64.dmg Windows x64npm run dist:winToken-Monitor-Setup-版本.exeNSIS 安装器 便携版.exe Linux x64npm run dist:linuxToken-Monitor-版本.AppImage 仅解包目录快速测试npm run packdist/平台-unpacked/不含安装器每个dist:*脚本内部都已串好ensure:tokscale --platform...会自动下载对应目标平台的 tokscale 二进制再交给 electron-builder 打包。各平台注意事项macOS发布级构建要求本机有Developer ID Application 签名证书forceCodeSigning: true。没有证书时请用npm start做本地开发。官方发布流程还会做公证notarization见 .github/workflows/release.yml。WindowsNSIS 安装器采用非一键安装oneClick: false允许自定义安装目录并附带 scripts/nsis-installer.nsh 自定义脚本官方产物的 Authenticode 签名策略见 docs/code-signing.md。Linux在无libfuse2的环境如 CI runner构建时设置环境变量APPIMAGE_EXTRACT_AND_RUN1让 electron-builder 内置的 appimagetool 以解包方式运行。五、看懂构建配置electron-builder 如何工作打包行为由 scripts/electron-builder.config.js 统一提供它在 package.json 的build段基础上注入 Electron 版本覆盖Linux 产物单独锁定运行时版本关键配置包括打包内容files只收集src/electron/**、src/shared/**、src/hub/**、图标与package.jsonasarUnpacktokscale、koffi等需要原生执行的能力从 asar 中解出保证二进制可被直接调用产物命名artifactName模板生成带版本号的文件名自动更新系统依赖这些稳定命名发布配置publish指向官方 Releases供 electron-updater 做增量更新检查六、构建后验证产物npm run verify:release-artifact-names # 校验 dist/ 中文件名符合更新器约定完成后打开dist/你会看到对应平台的.dmg/.exe/.AppImage以及latest.yml、latest-mac.yml、latest-linux.yml和.blockmap等自动更新元数据。直接运行安装器安装即可——本地构建的版本不会自动检查官方更新适合私有部署或二次开发。小贴士官方三平台产物由 .github/workflows/release.yml 在推送v*标签时自动构建macOS 26 构建 Mac 腿、Windows 走 SignPath 签名、Ubuntu 出 AppImage。如果你想在自己的 CI 上复刻这一流程照着该工作流的npm ci→ensure:tokscale→dist:*顺序配置即可。祝构建顺利 【免费下载链接】token-monitorLocal-first desktop widget for tracking token usage, costs, and limits across 43 AI coding tools—including Claude Code, Codex, Cursor, OpenCode, OpenClaw, and more—with multi-device sync.项目地址: https://gitcode.com/gh_mirrors/tok/token-monitor创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考