<< All versions

Skill v1.0.0

currentLLM-judged scan95/100
rexleimo/aios/aios-interception-runtime
──Details
PublishedOctober 9, 2026 at 09:29 AM
Content Hashsha256:364d2bbcb24d8e29...
Git SHA
──Files
Files (1 file, 6.2 KB)
SKILL.md6.2 KBactive
SKILL.md · 186 lines · 6.2 KB

version: "1.0.0" name: aios-interception-runtime description: RTK + Caveman community token compression tools install and config guide. RTK (github.com/rtk-ai/rtk) compresses command output 60-90%. Caveman (github.com/JuliusBrussee/caveman) cuts output tokens ~75%. Both run locally, no external services. The AIOS native interception runtime is deprecated. primary: false

installCatalogName: aios-interception-runtime clients: [codex, claude, gemini, opencode, hermes, workbuddy, pi, zcode, qoder] scopes: [global, project] defaultInstall: global: true project: false tags: [aios, token, compression, rtk, caveman, community] repoTargets: [codex, claude, gemini, opencode, hermes, workbuddy, pi, zcode, qoder]

<!-- 中文注释：Skill 已重写为 RTK + Caveman 社区工具安装配置指南。原生拦截运行时已废弃。 -->

RTK + Caveman 社区工具安装配置指南

AIOS 原生拦截运行时已废弃。Token 压缩改由社区维护的 RTK 和 Caveman 处理。

  • RTK (https://github.com/rtk-ai/rtk) — Rust CLI 代理，过滤和压缩命令输出 60-90%。单二进制，<10ms 开销，100+ 支持命令。本地运行，无外部服务。
  • Caveman (https://github.com/JuliusBrussee/caveman) — Claude Code skill/插件，压缩 agent 输出 token ~75%。保持技术准确性，仅压缩表述风格。本地 prompt skill。

一、自动安装

aios init 会自动检测并安装 RTK + Caveman（带有安装确认提示）：

bash
# 交互式安装（会提示确认）
aios init --agent <claude|codex|gemini|opencode>
 
# 跳过确认提示（用于 CI/无人值守场景）
aios init --yes-compression-tools
 
# 仅检测不安装
aios init --dry-run

安装后 aios init 会自动运行 rtk init -g 为检测到的客户端注册 hook/plugin。

二、手动安装

RTK

bash
# macOS (推荐)
brew install rtk
 
# Linux / macOS / WSL
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
 
# Windows (下载预编译二进制)
# 从 https://github.com/rtk-ai/rtk/releases 下载 rtk-x86_64-pc-windows-msvc.zip
# 解压到 PATH 中的目录（如 C:\Users\<you>\.local\bin）
 
# Cargo
cargo install --git https://github.com/rtk-ai/rtk
 
# 验证
rtk --version   # 应显示 rtk 0.28.2+
rtk gain        # 查看 token 节省统计

RTK 初始化

bash
rtk init -g                     # Claude Code / Copilot (默认)
rtk init -g --gemini            # Gemini CLI
rtk init -g --codex             # Codex (OpenAI)
rtk init --agent cursor         # Cursor
rtk init --agent windsurf        # Windsurf
rtk init --agent cline          # Cline / Roo Code
rtk init --agent hermes         # Hermes

Caveman

bash
# macOS / Linux / WSL / Git Bash
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash
 
# Windows (PowerShell 5.1+)
$installer = Join-Path $env:TEMP 'caveman-install.ps1'
irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 -OutFile $installer
powershell -NoProfile -ExecutionPolicy Bypass -File $installer
Remove-Item $installer -Force

安装后约 30 秒。需要 Node >= 18。会自动检测已安装的客户端并跳过没有的。 安全重复运行。

Caveman 使用

bash
/caveman              # 激活 caveman 模式（默认 full）
/caveman lite         # 轻度：去掉填充语
/caveman full         # 完整 caveman 模式（默认）
/caveman ultra        # 极简：电报体
/caveman wenyan       # 文言文模式（更短）
 
# 其他命令
/caveman-commit       # 压缩 commit message
/caveman-review       # 一行 PR 评论
/caveman-stats        # token 使用统计
/caveman-compress <file>  # 压缩文件内容
 
# 退出
"normal mode"         # 恢复正常输出

三、压缩级别参考

工具级别输出形态适用场景
RTK(自动)过滤噪声、分组、截断、去重所有 shell 命令输出
Cavemanlite去掉填充语轻度压缩
CavemanfullCaveman 表述默认，日常使用
Cavemanultra电报体最大压缩
Cavemanwenyan文言文中文场景最短

四、隐私说明

  • RTK：本地 Rust 二进制，过滤和压缩命令输出。不发送数据到外部服务。
  • Caveman：本地 prompt skill，压缩 agent 输出风格。压缩后的输出进入 LLM 上下文（和正常对话一样），但不经过额外中继。
  • 两者均为本地运行，不需要外部 API 或服务。
  • --yes-compression-tools 跳过安装确认提示（用于 CI/无人值守场景）。

五、故障排查

RTK 未运行

bash
# 检查安装
rtk --version
which rtk
 
# 检查 token 节省
rtk gain
 
# 重新初始化
rtk init -g

Windows 上 RTK hook 不工作

RTK 的 auto-rewrite hook 需要 Unix shell。在原生 Windows 上，RTK 回退到 CLAUDE.md injection 模式。 推荐使用 WSL 获得完整 hook 支持。详见 https://github.com/rtk-ai/rtk#windows

Caveman 未激活

bash
# 在 Claude Code 中输入
/caveman
 
# 或让 agent 读取安装文件
# "Read CLAUDE.md and INSTALL.md, install caveman for me."

从 AIOS 原生拦截迁移

  1. 运行 aios init 安装 RTK + Caveman
  2. 旧的 scripts/aios-mcp-proxy.mjs 和 scripts/aios-intercept.mjs 已标记 deprecated，不需要删除但不再维护
  3. 旧的 .aios/interception/metrics/ 目录可以清理但不影响功能
  4. 旧配置 config/aios-interception.json 不再被读取

六、AIOS Token Discipline（仍保留）

AIOS token discipline profiles（minimal | balanced | full）作为 pre-context 卫生层保留，与 RTK/Caveman 互补：

  • minimal: 使用最小有用上下文
  • balanced: 默认，保留足够证据但避免噪声
  • full: 仅用于调试/审计/审查

这些 profile 是提示层卫生，不替代 RTK/Caveman 的深度压缩。

Boundaries

  • RTK 是 Rust 二进制，通过 hook/plugin 机制拦截命令输出
  • Caveman 是 prompt skill，改变 agent 输出风格
  • 两者互补：RTK 压缩输入（工具输出），Caveman 压缩输出（agent 回复）
  • AIOS 原生拦截运行时代码保留但不再积极维护
  • Token discipline profiles 是 pre-context 卫生层
  • 遇到工具本身的 bug 应向对应社区报告
All versions