砍掉 65% 输出 Token，让 AI 编程助手戒掉废话：Caveman 你值得拥有

一、项目概述

1. 项目基本信息

仓库地址：github.com/JuliusBruss... Caveman 是面向 Claude Code、Cursor、Windsurf、Copilot、Gemini 等30+款AI编程代理的开源Skill插件，核心定位一句话概括：不改变AI思考逻辑，只压缩AI输出话术，剔除客套、过渡、冗余铺垫，代码、命令、报错、技术术语完整保留，平均减少65%输出Token消耗。

项目作者Julius Brussee的核心设计思路：why use many token when few do trick（能用少量Token讲清的内容，无需冗余文字）。区别于常规Prompt压缩工具，它不修改输入内容、不截断推理过程，仅约束AI回复的表达风格，不会丢失任何技术细节。

2. 核心价值

1. 降本：调试、架构解释类场景最高可节省87%输出Token，长期高频编码能显著降低API调用成本；
2. 提速：AI生成文字量大幅减少，回复渲染速度提升，减少等待；
3. 提准：2026年3月相关学术论文验证，强制精简输出约束下，大模型技术任务准确率平均提升26个百分点；
4. 本地无隐私风险：纯本地运行，无后台、无埋点、无遥测数据上传，安装完成后无额外网络请求；
5. 全生态适配：一套安装脚本自动识别本地所有AI编码工具，支持单工具定向安装。

3. 核心边界（官方诚实说明，避坑重点）

1. 仅压缩输出Token，用户输入、模型推理Token完全不受影响；
2. 启用Caveman规则会额外增加1~1.5k输入Token/轮次，纯极简提问场景可能出现整体Token消耗不降反升；
3. 65%压缩率仅针对AI回复文本，代码、文件、报错、命令行不会被压缩；
4. 压缩收益差距极大：架构讲解、Bug调试压缩率80%+，简单代码重构仅22%。

二、工作原理

1. 安装脚本向对应AI代理目录注入Skill规则文件、本地Hook脚本；
2. Skill规则给AI下达固定约束：删除所有寒暄、填充词、完整长句过渡，允许碎片化短句表达，严格保护代码块、路径、URL、报错堆栈；
3. Claude Code内置会话Hook，新建对话自动启用Caveman，无需手动输入指令；其他工具需手动触发；
4. 配套子命令读取本地会话日志，统计Token节省量；caveman-compress工具可永久压缩项目记忆文档（如CLAUDE.md），每次会话永久减少输入Token；
5. 所有逻辑运行在本地，Token统计仅读取本地日志文件，不会上传任何对话内容。

三、完整安装教程

前置环境要求

Node.js ≥ 18，Windows PowerShell 5.1+/WSL，macOS/Linux原生终端均可，安装全程约30秒。

方式1：一键全局安装（推荐，自动识别本机所有AI工具）

macOS / Linux / WSL / Git Bash

curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 | iex

支持重复执行脚本，不会重复覆盖已安装配置，可用于修复安装异常。

方式2：单工具定向安装

1. Claude Code专用（插件市场）

claude plugin marketplace add JuliusBrussee/caveman
claude plugin install caveman@caveman

2. Cursor / Cline / Windsurf / Copilot 通用

# 全局添加
npx skills add JuliusBrussee/caveman
# 仅为Cursor安装
npx skills add JuliusBrussee/caveman -a cursor
# 仅为OpenClaw网关安装
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash -s -- --only openclaw

3. Gemini CLI

gemini extensions install https://github.com/JuliusBrussee/caveman

卸载方式

在原安装脚本末尾追加 --uninstall，仅删除Caveman相关配置，不改动原有项目、Agent配置文件：

# Mac/Linux
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash -s -- --uninstall
# PowerShell
irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 -OutFile uninstall.ps1; .\uninstall.ps1 -uninstall

四、使用详解：档位模式 + 全部指令

1. 4档压缩强度（按需切换，会话内永久生效）

执行切换指令：/caveman [档位名]，默认full模式。

档位	压缩力度	表达特点	适用场景
lite	轻度	保留完整句子，仅删除客套、冗余铺垫，语法完整	新手调试、需要适度可读性
full（默认）	中度	删减冠词、连接词，碎片化短句，标准原始人风格	日常开发、Bug排查、代码优化
ultra	重度	极致精简，大量省略修饰词，单词简写	高频快速问答、长会话节省上下文
wenyan	文言文	中文专属特殊模式，以古文极简表意，压缩率最高	中文开发者、长文档上下文压缩

开关指令

• 开启：/caveman 或直接对话说 talk like caveman
• 关闭：normal mode

2. 全功能子命令速查

① /caveman-stats

统计当前会话Token消耗、累计节省Token、折合节省成本，支持--share输出可分享单行数据；Claude Code状态栏常驻展示累计节省Token，关闭展示：环境变量CAVEMAN_STATUSLINE_SAVINGS=0。

② /caveman-commit

生成符合Conventional规范的Git提交信息，正文≤50字符，优先说明修改原因而非操作内容，替代冗长描述。

③ /caveman-review

输出单行PR评审意见，格式统一行号: 类型: 问题描述. 修复方案，例如 L42: 🔴 bug: user null. Add guard.，适合批量代码审查。

④ /caveman-compress <文件路径>

永久压缩项目记忆文档（CLAUDE.md、项目笔记、配置说明等），官方平均压缩输入Token 46%，代码、路径、链接完全保留，压缩后所有新会话永久减少输入开销。 示例：

/caveman-compress ./CLAUDE.md

⑤ caveman-shrink

MCP中间件，封装任意MCP服务，压缩工具描述文本，降低工具调用上下文占用，npm独立包部署。

⑥ cavecrew-* 系列子代理

内置调查、构建、评审三类轻量化子Agent，整体Token消耗比原生Agent低60%，适合复杂多步骤开发任务。

3. 效果对比示例

普通AI回复（69Token）

The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I'd recommend using useMemo to memoize the object.

Caveman full模式（19Token）

New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo.

五、官方基准测试数据

基于10类典型开发任务，仅统计AI输出Token：

任务类型	正常回复Token	Caveman回复Token	压缩节省比例
React重渲染Bug解释	1180	159	87%
鉴权中间件Token过期修复	704	121	83%
PostgreSQL连接池搭建	2347	380	84%
Git rebase/merge区别讲解	702	292	58%
回调转Async/Await重构	387	301	22%
微服务vs单体架构对比	446	310	30%
PR安全漏洞审查	678	398	41%
Docker多阶段构建	1042	290	72%
PostgreSQL竞态条件调试	1200	232	81%
React错误边界实现	3454	456	87%
平均值	1214	294	65%

记忆文件压缩长期收益（永久减少输入Token）：

文件类型	原始Token	压缩后Token	节省比例
AI偏好配置CLAUDE.md	706	285	59.6%
项目开发笔记	1145	535	53.3%
项目专属AI配置	1122	636	43.3%
待开发清单	627	388	38.1%
代码混合说明文档	888	560	36.9%
平均值	898	481	46%

六、适用/不适用场景

✅ 推荐使用场景

1. 日常Bug调试、报错分析、底层原理讲解（压缩率最高）；
2. 代码评审、PR评论、Git提交信息生成；
3. 长会话持续编码，上下文窗口容易溢出；
4. 高频使用付费AI API，希望控制Token成本；
5. 中文开发者，使用wenyan文言文模式压缩项目记忆文件；
6. MCP工具开发，压缩工具描述减少上下文占用。

❌ 不建议启用场景

1. 教学、新手教程、对外客户技术沟通（需要完整友好的解释话术）；
2. 金融、医疗等强合规领域，代码注释、文档需要完整规范表述；
3. 简短极简提问（单条指令输出本身很短，Caveman规则会增加输入Token，整体成本上升）；
4. 对外交付正式技术文档、白皮书、方案说明。

七、配套生态体系

Caveman 并非单一工具，作者配套完整轻量化Token压缩产品线，统一安装入口：npx skills@latest add JuliusBrussee/skills

1. caveman（本文项目）：压缩AI输出话术；
2. caveman-code：全链路轻量化编码Agent，整体Token消耗减半；
3. cavemem：项目记忆文件专用压缩工具，长期降低输入开销；
4. cavekit：轻量化Spec驱动开发流程，减少冗余规划对话；
5. cavegemma：Gemma模型专用微调权重，内置原生精简输出逻辑。

配套辅助技能：grill-me（方案前置校验）、interface-kit（UI开发）、junior-to-senior（代码评审增强）、loop-factory（任务流程管理）。

八、隐私与安全说明

1. 零遥测：无日志上传、无用户行为采集、无账号体系；
2. 本地运行：所有压缩规则、Token统计、文件处理仅在本地执行；
3. 仅安装阶段发起网络请求：仅拉取GitHub仓库脚本、对应AI工具官方插件市场资源；
4. 源码完全开源MIT协议，可自行审计安装脚本、Hook逻辑；
5. 不会修改业务代码、系统配置文件，仅新增AI代理Skill目录文件。

九、总结

Caveman 精准击中开发者痛点：AI编程助手普遍输出冗余话术，大量Token消耗在无价值铺垫上。它不改动代码、不降低技术准确性，仅通过约束表达风格实现输出Token大幅削减，一键安装、多工具兼容、本地安全运行，适合长期高频使用AI编码工具的开发者。

使用时需要理性看待65%压缩率：该数值仅针对AI回复文本，简单短问答场景收益有限，架构、调试类长解释场景收益最明显；如果需要对外输出完整文档、教学内容，建议切换回normal模式。搭配caveman-compress压缩项目记忆文档，可实现输入+输出双向Token优化，长期使用收益最大化。