SkillsScout
META-AGENT ／ 元技能与 Agent 增强

Token Optimizer

收录日期 2026-07-21·来源仓库 ↗
受欢迎程度
7
可用程度与相关性
9
安全性
8
8SCOUT SCORE

1. 基本信息

项目 内容 数据来源
名称 Token Optimizer —
作者/维护者 Alex Greenshpun（alexgreensh），另有 9 名活跃贡献者 GitHub API
来源链接 https://github.com/alexgreensh/token-optimizer —
许可证 PolyForm Noncommercial 1.0.0（非商业用途免费，禁止商业再分发） 仓库 LICENSE 文件
GitHub Stars / Forks 1,687 / 135 GitHub API
最新版本 v5.11.51（2026-07-19 发布） GitHub Releases
安装方式 Claude Code 插件市场一条命令安装；另提供 Codex / OpenClaw / OpenCode / Hermes / GitHub Copilot 多渠道安装 仓库 README

2. 功能介绍与亮点

Token Optimizer 审计 Claude Code、Codex 等编码助手的上下文窗口浪费，把浪费拆成三类分别处理：结构性浪费（臃肿配置、未使用的技能、陈旧的 MEMORY.md）、运行时浪费（冗长命令输出、文件重复读取）、行为性浪费（模型路由不当、缓存过期、重试循环）。

它通过宿主平台自身的 PreToolUse / PostToolUse hook 机制拦截 Read / Bash 调用：命令输出、搜索结果、表格与 JSON、文件重读分别做压缩或差量化处理，9 项压缩特性默认全部开启，无需手动配置。更关键的一点是“压缩存活于上下文压缩（compaction）”——在自动 compaction 前写检查点，压缩之后自动恢复，避免此前节省下来的 token 在一次 compaction 后打回原形。此外提供 7 项信号的实时上下文质量评分（S–F 等级）与本地 HTML 仪表盘，展示每轮 token、费用、缓存命中率。

亮点：官方公开了覆盖 57 个用例的压缩基准测试方法论，所有节省数字可自行复现验证；纯 Python / TypeScript 标准库实现，零运行时依赖；SECURITY.md 与 PRIVACY.md 详细披露数据读写范围；10 名贡献者、600 余次提交持续维护，用户在 GitHub Issue 中报告的问题（如 OpenCode 场景下的运行时误判）通常在数周内随版本更新修复。

3. 适用场景

固定分类：元技能与 Agent 增强

4. 跨 Agent 兼容性

Agent 结论 依据
Claude Code 原生支持 ✅ 官方插件市场一键安装（/plugin marketplace add），智能压缩、检查点、质量评分、仪表盘全部功能可用，是项目的维护重心
Codex 原生支持 ✅ 有专属 Codex 适配器（docs/codex.md），核心审计、教练、仪表盘、成本追踪、连续性、舰队扫描功能均可用；少数依赖 Codex 尚未开放的 hook API 的机制，以 Codex 安全等效方案替代
OpenClaw 原生支持 ✅ 独立 TypeScript 插件实现，零 Python 依赖，可通过 openclaw plugins install 从 GitHub 或 ClawHub 市场安装，兼容 Claude / GPT-5 / Gemini / DeepSeek 等任意模型
Hermes Agent 原生支持，官方标注 Beta（v0.1.0）⚠️ 以 NousResearch Hermes 原生 Python 插件形式提供，只读方式读取 Hermes 自身的 state.db，逐轮 token 统计、上下文提醒、会话汇总等核心功能已实现，但处于测试阶段

5. 推荐理由

在 Claude Code、Codex、OpenClaw、Hermes 四个生态均提供原生适配，这在同类工具中并不多见；它不满足于压缩命令输出这一类浅层优化，而是系统性覆盖结构性、运行时、行为性三类浪费，并用“检查点在 compaction 后自动恢复”和可复现的 before/after 节省基准，把优化效果落到可验证的数字上。

6. 评分

维度 分数 说明
受欢迎程度 7 GitHub 1,687 stars / 135 forks，处于 1k–5k 区间；仓库 2026-02 创建，5 个月内达成当前规模，星标/复刻比约 12.5:1 属正常范围；第三方技能市场 Tons of Skills 将其评为当周“Killer Skill of the Week”
可用性 9 Claude Code 端一条命令即装；官方文档站提供 2 分钟快速上手与完整卸载指南；最近一次代码推送在 2 天以内；零运行时依赖
安全性 8 见下方安全检查清单
综合评分 8.0 三项均值

安全检查清单：

检查项 结果
① Shell 命令执行 有，通过宿主平台自身的 PreToolUse/PostToolUse hook 机制拦截 Read/Bash 调用做压缩与归档，未见越权尝试宿主未开放的权限
② 运行时联网外发 官方安全文档声明零遥测、零运行时网络调用；唯一网络行为是安装/更新时向 GitHub Releases 查询版本号，不上传任何产品数据
③ API key/凭据 不要求任何账号或 API key；本地生成的随机令牌仅用于本机回环（127.0.0.1）仪表盘鉴权，不外发
④ 可疑指令 SKILL.md 与配套脚本中未见提示词注入或隐藏指令迹象
⑤ 作者信誉 个人开发者，10 名活跃贡献者、600 余次提交，GitHub Sponsors 页面公开，星标/复刻比处于正常区间，无造假迹象
⑥ License 明确，PolyForm Noncommercial 1.0.0，仅限非商业使用
⑦ 最近维护 活跃，最近一次代码推送 2 天以内，最新正式版本 2026-07-19 发布

安全性未给满分的原因：涉及本地代码执行（hook 脚本），虽范围明确、可审计且默认零外联，仍落在“有代码执行但可审计”的 7–8 档，未达“纯提示词零执行”的满分档。

7. 跟同类 Skills 相比的优势

项目 定位 与本技能的差异
Headroom Claude Code 终端内的上下文窗口用量进度条 只做用量可视化提示，不做压缩、不设 compaction 前后检查点，规模也小得多（68 stars）
context-mode 覆盖 17 个平台的上下文优化工具，沙盒化工具输出（声称减少 98%）并做会话记忆持久化与跨平台路由 覆盖平台数量更多、体量更大（19,133 stars），但压缩范围集中在命令输出与会话指引层面，未提供 compaction 前后自动检查点/恢复机制，也没有 7 项质量评分与 30 天历史趋势分析

差异化：多数同类工具止步于压缩命令行输出这一浅层优化，Token Optimizer 的独特之处在于把结构性、运行时、行为性三类浪费一并纳入审计范围，并额外解决“节省效果在 compaction 后消失”这一常被忽视的问题，同时提供可自行复现的量化基准而非一次性演示数字。

8. 用户评价

第三方技能市场 Tons of Skills 的编辑 Jeremy Longshore 在项目 GitHub Issue #2 中公开确认，Token Optimizer 被评选为该市场当周“Killer Skill of the Week”，并邀请项目长期收录进市场目录、通过每日自动同步跟踪仓库更新。该技能目前除此互动外，第三方平台尚无更多具名用户评价。

9. 其他补充

项目自 2026-02 创建以来版本号迭代密集，已发布至 v5.11.51，多数更新是针对 GitHub Issue 中用户报告问题的直接修复。除 Claude Code 插件市场外，OpenClaw 用户还可直接从 ClawHub 市场安装（openclaw plugins install token-optimizer）。

10. 安装使用方式

11. 注意事项