← 返回 Skills 市场
Token Tracker Pro
作者
longziruo-max
· GitHub ↗
· v2.2.0
· MIT-0
172
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install token-tracker-pro
功能描述
记录和追踪 OpenClaw 会话的 token 消耗,提供每日、每周和累计统计,并提出节省 token 的建议
安全使用建议
要不要安装:如果你只是想本地统计 token,这个包在功能上匹配;但它会修改你的主目录配置(~/.bashrc、~/.config/autostart、Windows APPDATA 下的 AutoHotkey 脚本)并尝试把自己加入 PATH 和设置快捷键——这些改动没有在元数据里声明。建议在安装前:
- 手动审查 shortcut.ts、token-tracker-hook.ts 和 token-tracker-cli.ts(确认要写入/修改的路径和行为)。
- 备份你的 shell 配置(~/.bashrc、~/.zshrc)和任何被改动的目录。不要接受自动 shortcut 安装,改为手动配置快捷键。
- 如果可能,先在隔离环境或临时账号中运行并观察(例如 Docker 或临时用户),确认没有意外行为。
- 注意示例脚本里有硬编码路径(/home/seelong/...),运行前替换为你的路径或删除示例中对绝对路径的引用。
- 如果你不需要全局快捷键,避免运行 npm run token:shortcuts / npx 指令,或者在源码中注释掉 shortcut.ts 的自动写入部分。
如果你希望我,我可以:
- 列出 shortcut.ts 将写入的具体文件与修改行,或
- 帮你审查 token-tracker-hook.ts(如果提供其完整内容)以确认它如何读取会话上下文和估算 token。
功能分析
Type: OpenClaw Skill
Name: token-tracker-pro
Version: 2.2.0
The skill bundle contains high-risk system modification logic in `shortcut.ts`, which appends to `~/.bashrc` and creates persistence entries in autostart directories across Linux (`~/.config/autostart`), macOS (`~/Library/Services`), and Windows (AutoHotkey). While documented as a 'shortcut' feature, these actions are invasive and non-standard for a token tracking utility. Additionally, `dashboard.ts` launches a local Express server on port 3000 that exposes token history data via an API, and `cli.js` utilizes `execSync` to run shell commands, increasing the potential attack surface.
能力评估
Purpose & Capability
Skill 名称与主要代码(CLI、dashboard、hook、数据文件)一致:它记录会话 token、提供统计、在本地保存数据并提供可视化与推荐。可疑点:示例脚本与若干实现使用硬编码路径(/home/seelong/...)和向 PATH/.bashrc 写入的行为,超出了最小必要范围但与“全局 CLI / 快捷键”目标有一定合理性。
Instruction Scope
SKILL.md 与 INTEGRATION.md 建议通过在主程序中调用 hook 自动记录,且提到手动/交互式用法。实际代码(shortcut.ts)会自动写入 ~/.bashrc、创建 ~/.config/autostart/.desktop 文件、在 Windows 下写 AutoHotkey 脚本,并在 macOS 写 workflow 文件——这些文件/路径并未在元数据说明中列出,也没有明确要求用户确认。dashboard 在本地开服务(http://localhost:3000)并从本地 data 文件读取,未向外部服务器发送数据。总体上指令有“超出最小权限”的文件写入/系统配置更改。
Install Mechanism
Skill 为 instruction + 本地 Node.js/TypeScript 项目;没有声明自动下载任意可疑二进制或从外部私服提取代码。依赖通过 package.json(express、tsx 等),页面使用 Chart.js CDN(jsdelivr)。没有高风险的远程 extract/install 步骤在 install spec 中。
Credentials
元数据声明无需环境变量或凭据,但代码读取 process.env.HOME 和 process.env.APPDATA 并直接修改用户配置文件(~/.bashrc、~/.config/autostart、AutoHotkey 目录等)。虽然这些访问可以解释为实现全局快捷键与 CLI 的需要,但没有在 requires.env/required config paths 中声明,且修改用户 shell 配置和启动脚本属于高影响操作,应由用户显式批准并备份。
Persistence & Privilege
Skill 会创建持久化文件(data/token-history.json)并可安装自动启动/快捷键(.desktop、AutoHotkey 脚本、修改 .bashrc PATH),从而获得长期存在于用户环境中的能力。always:false(没有强制安装)减轻了风险,但写入用户启动配置与 PATH 修改是显著的持久性/权限更改,需谨慎。
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install token-tracker-pro - 安装完成后,直接呼叫该 Skill 的名称或使用
/token-tracker-pro触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.2.0
- 新增“Pro”版,升级名称为 token-tracker-pro
- 更新文档结构,详细列出主要功能、使用方法、快捷键支持和数据存储说明
- 引入智能模型配置推荐与优化建议,增强节省 token 的指导
- 增加更多命令行和 npm script 操作(如导出、清理、重置等)
- 详细描述 Web 仪表板和技术栈信息
- 明确贡献及许可方式
v2.1.0
Added smart model recommender, token optimization, dashboard, improved UI/UX, better error handling
v2.0.0
新增全局命令、快捷别名、交互式菜单
元数据
常见问题
Token Tracker Pro 是什么?
记录和追踪 OpenClaw 会话的 token 消耗,提供每日、每周和累计统计,并提出节省 token 的建议. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 172 次。
如何安装 Token Tracker Pro?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install token-tracker-pro」即可一键安装,无需额外配置。
Token Tracker Pro 是免费的吗?
是的,Token Tracker Pro 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Token Tracker Pro 支持哪些平台?
Token Tracker Pro 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Token Tracker Pro?
由 longziruo-max(@longziruo-max)开发并维护,当前版本 v2.2.0。
推荐 Skills