Shell · 项目报告

Kulaxyz/token-diet

Always-on token-efficiency skill for coding agents (Claude Code, Codex, Cursor, Windsurf, Cline). ~31% lower bill on average, no loss of correctness.

已完成 打开 GitHub
K
566星标
3Fork
0Issue
未知许可证

分析结果

项目分析

token-diet 是一个面向 AI 编程代理的“常驻式 token 节省规则/技能”工具,支持 Claude Code、Codex、Cursor、Windsurf、Cline。它通过安装脚本向各类 Agent 的会话启动钩子或规则文件中注入精简输出、减少无效上下文读取、控制测试范围、批量工具调用等行为准则,目标是在不降低正确性的前提下降低 token 消耗和 API 账单。README 声称在真实 Sonnet 5 运行中平均账单降低约 31%,输出 token 平均降低约 53%。

适用领域 AI 编程助手 / LLM 成本优化 / 开发者工具 / 提示词工程 / 代码代理工作流 / 上下文管理 / 自动化配置脚本
配置难度 低。普通开发者只需执行安装脚本即可使用;理解其原理需要了解各 AI 编程代理的规则文件、会话 hook 和提示词注入机制。团队级推广时难度中等,需要处理已有规则冲突和模式选择。
商业价值 对高频使用 AI 编程助手的个人和团队有较明确的成本优化价值,尤其适合 API 账单较高、对输出冗余敏感的场景。它不直接提升模型能力,而是通过约束 AI 行为减少无效 token、压缩沟通成本、提高开发交互密度。对于创业团队、AI-first 开发团队和大规模使用 Claude/Codex/Cursor 的组织,若实际节省接近 README 所述平均 31%,长期可带来可观成本下降。但商业采用前应评估许可证、配置安全、团队可读性和实际节省效果。
01

技术亮点

  • 安装简单,一个 install.sh 自动检测并配置多个主流 AI 编程代理
  • 常驻生效,无需每次对话手动提醒 AI 节省 token
  • 支持 on、lite、ultra、off 多档模式,适应不同场景
  • 覆盖范围不只是回复文本,还包括文档、测试、代码、上下文读取、工具调用和子代理委派策略
  • 强调正确性优先,声明不压缩推理质量、关键测试、代码、命令和错误信息
  • 对输出密集型任务节省明显,README 中给出了基准数据和复现实验入口
  • 适合与现有 AI 编程工作流叠加使用,不需要修改业务代码
02

目标用户

  • 频繁使用 Claude Code、Codex、Cursor、Windsurf、Cline 的开发者
  • 使用 AI Agent 进行代码修改、测试、文档生成和代码审查的团队
  • 关注 LLM API 成本控制的个人开发者或创业团队
  • 希望减少 AI 输出冗余、提升交互效率的工程师
  • 需要统一团队 AI 编程助手行为规范的技术负责人
03

配置要求

  • 需要类 Unix shell 环境以运行 install.sh
  • 需要已安装至少一个受支持的 AI 编程代理:Claude Code、Codex、Cursor、Windsurf 或 Cline
  • 如果要复现实验基准,需要 Node.js 环境,并设置 ANTHROPIC_API_KEY
  • 全局安装可能需要写入用户目录下对应 Agent 的规则文件、配置文件或钩子文件
  • 项目级安装需要当前仓库允许写入 Agent 上下文文件,例如 AGENTS.md 或编辑器规则文件
  • 团队使用前建议审查安装脚本实际修改的文件,避免覆盖已有规则
04

适用场景

  • 在 Claude Code、Codex、Cursor、Windsurf 或 Cline 中默认启用更简洁的回复风格
  • 减少 AI 编程会话中的解释性废话、重复读取文件和过度测试
  • 降低长时间 AI 结对编程、代码审查、问题排查时的 token 成本
  • 为项目仓库注入统一的 Agent 行为规则,约束 AI 只做必要工作
  • 在输出密集型场景下,例如方案解释、计划制定、技术建议中显著减少输出 token
  • 通过 lite、on、ultra、off 等模式在简洁度和可读性之间切换
05

部署与配置

  • 克隆仓库:git clone https://github.com/Kulaxyz/token-diet.git
  • 进入目录:cd token-diet
  • 执行默认安装:./install.sh
  • 如需启用更激进的超精简聊天风格:./install.sh --ultra
  • 如需卸载:./install.sh --uninstall
  • 如需指定目标 Agent:./install.sh -a claude|codex|cursor|windsurf|cline|all|print
  • 如需只安装到当前项目而非全局配置:./install.sh --project
  • 安装后默认常驻生效,也可在支持的 Agent 中使用 /token-diet on|lite|ultra|off 手动切换
06

风险与注意事项

  • 项目本质上是向 Agent 注入行为规则,效果依赖不同 AI 工具对规则文件或 hook 的遵循程度,不一定稳定
  • README 中的节省比例来自特定实验场景,实际成本下降幅度可能因任务类型、模型、上下文规模而差异很大
  • 过度精简可能导致回复缺少背景解释,对初级开发者或复杂需求沟通不够友好
  • ultra 模式的电报式表达可能降低可读性,尤其在团队协作、文档沉淀或代码评审中需要谨慎使用
  • 自动修改 Agent 配置文件存在覆盖或冲突风险,尤其是已有自定义规则的用户
  • 仓库主要语言为 Shell,安装脚本需要信任本地执行,使用前应审计脚本内容
  • 许可证字段为空,商业或企业内部使用前需要确认授权风险
  • 当前 forks 为 0,社区验证和生态成熟度仍有限

历史记录

热榜历史快照

2026-07-10 第14名 新收录 · github_search
2026-07-09 第15名 新收录 · github_search
2026-07-08 第12名 新收录 · github_search
2026-07-07 第10名 新收录 · github_search
2026-07-06 第9名 新收录 · github_search
2026-07-05 第14名 新收录 · github_search