← 返回 Skills 市场
longziruo-max

Token Tracker Pro

作者 longziruo-max · GitHub ↗ · v2.2.0 · MIT-0
cross-platform ⚠ suspicious
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 修改是显著的持久性/权限更改,需谨慎。
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install token-tracker-pro
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /token-tracker-pro 触发
  4. 根据 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
新增全局命令、快捷别名、交互式菜单
元数据
Slug token-tracker-pro
版本 2.2.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

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。

💬 留言讨论