Lowfat：可插拔CLI过滤器，节省91.8%的LLM令牌成本

lowfat 是一款轻量级 CLI 工具，通过在 CLI 输出到达代理之前过滤掉不必要的内容，从而降低 AI 令牌成本。- 轻量级：单个小体积二进制文件，核心小巧但可扩展。- 本地优先：无遥测，数据归你所有。

- 可组合：UNIX 风格管道，混合内置和自定义过滤器，不依赖魔法。- 用户自主：lowfat history 显示你最常运行的命令，允许你根据使用场景自定义。

安装方式：cargo install lowfat# 或brew install zdk/tools/lowfatGitHub Releases 也提供预编译二进制文件。

集成方式之一：Claude Code 钩子——添加到 .claude/settings.json：{ "hooks":{ "PreToolUse":[ { "matcher":"Bash","hooks":[{ "type":"command","command":

"lowfat hook" }] } ] }}

Shell 集成——在代理环境（CLAUDECODE=1,CODEX_ENV）中自动激活，或设置 LOWFAT_ENABLE=1 强制在任何 shell 中启用：

echo 'eval "$(lowfat shell-init zsh)"' >> ~/.zshrc # 或 ~/.bashrc

OpenCode 插件——一条命令，无需编辑配置：lowfat opencode install # 写入 ~/.config/opencode/plugins/lowfat.ts重启 OpenCode；

命令在运行前会被透明地重写。随时可用 lowfat opencode uninstall 移除。

直接使用——在任何命令前加前缀：lowfat git statuslowfat docker pslowfat ls -la

Pi 代理——在 ~/.pi/agent/settings 中配置。

JSON 配置：{ "shellCommandPrefix": "eval \"$(lowfat shell-init zsh)\";" }

查看配置和每个过滤器的活跃程度：lowfat info # 状态徽章 + 活跃过滤器lowfat info git # 针对 `git` 的管道lowfat info --config # 完整解析后的配置

查看 lowfat 为你节省了多少：lowfat stats # 生命周期令牌节省量lowfat stats --audit # 最近的插件执行lowfat history # 按潜在节省量对命令排序

调节过滤强度：lowfat level ultra # 最大压缩LOWFAT_LEVEL=lite lowfat git log # 一次性覆盖

编写插件：lowfat plugin new terraform # 生成 ~/.lowfat/plugins/terraform/ 脚手架lowfat plugin doctor # 检查插件（并预安装任何 Python 依赖）

在不安装的情况下针对样本测试插件：cat samples/git-diff-full.txt | lowfat filter --explain ./filter.lf --sub=diff --level=ultra

- docs/ARCHITECTURE.md — 高层架构图：CLI,Runner,Plugins,Builtins- docs/CONFIG.md — .lowfat 文件、环境变量、管道 DSL、内置处理器、

history 排名- docs/PLUGINS.md — lf-filter（.lf 插件 DSL）、shell 逃生舱、PEP 723 + uv、AI 代理提示

许可证：Apache-2.0本项目使用了多种 AI 工具。