ai-optimizer

AI Token Optimizer

一个 MCP 服务，通过框架感知型上下文优化，减少 AI 编码 Agent 60–80% 的 Token 用量。

AI 编码 Agent 只需要 15 行代码，却会读取整个文件。它们会将 *.g.dart、 R.java、node_modules/ 和 dist/ 加载到上下文中——下一轮又会重复这一过程。 AI Token Optimizer 是一个 Model Context Protocol 服务，会拦截这些工具调用，并在内容传到模型 之前 清除框架噪声。

适用于所有支持 MCP 的客户端：Claude Code、Cursor、Cline、Continue、Zed、 JetBrains AI、GitHub Copilot agent mode、Antigravity、Windsurf、OpenAI Codex CLI。

快速开始

npm install -g @ai-optimizer/core

然后将 Agent 指向 ai-optimizer stdio 服务。对于 Claude Code，将以下内容添加到 ~/.claude/settings.json：

{
  "mcpServers": {
    "ai-optimizer": {
      "command": "ai-optimizer"
    }
  }
}

或者自动生成配置并预览节省的用量：

npx @ai-optimizer/init
# "we'd skip 47 files, ~14K tokens/session, ~$0.42/session at Sonnet pricing"

各客户端的完整配置说明（Cursor 等）、LSP 安装和验证步骤见 packages/core/README.md。

功能

它会注册 Agent 可用于替代内置文件／目录／错误读取功能的工具：

工具	节省内容
optimized_read_file	感知框架并跳过无关内容 + 可选的行切片
optimized_list_files	遍历目录树并应用忽略 glob（包括 .gitignore）
optimized_grep	根据忽略筛选器限定内容搜索范围
optimized_diagnostics	启动相应的 LSP，返回错误信息 + 范围较窄的代码窗口
read_symbol	使用 LSP workspace/symbol 切片，而非读取整个文件（Pro/LSP）
strip_bash_noise	清除 ANSI、npm/maven/gradle 进度信息和 JVM 警告
optimizer_status	检测到的框架、启用的 pack、累计节省的 Token 数

检测到项目类型后（例如通过 pyproject.toml 检测 Python），相应 pack 的忽略规则会自动启用。 此外，还会遵循 .gitignore。

套餐

	免费版（MIT 核心）	Pro（$9/月）	Team（$29/席位）
框架包	Python、JS/TS	+ React、Flutter、Java、Kotlin、Go、Rust、C#、Swift、Ruby、Elixir、PHP、Solidity	所有 Pro 套餐包
历史记录压缩	—	✓	✓
调度器（claude -p cron）	—	✓	+ 在各提供商之间进行工作窃取
审计日志 + 密钥脱敏 + 策略	—	—	✓

请参阅 PRICING.md。会改变行为或共享数据的功能 （调度器、工作窃取、遥测）默认关闭，必须明确选择启用。仅用于显示的功能（节省金额） 默认开启。

Monorepo 布局

包	用途	发布状态
packages/core	MCP 服务 + 免费包	npm（MIT）
packages/init	npx @ai-optimizer/init 配置 + 节省金额预览	npm
packages/sdk	definePack 插件 SDK	npm
packages/context-mode-import	导入 .contextmode 配置	npm
packages/pro	Pro/Team 套餐包 + 调度器 + 审计	私有
apps/landing、apps/dashboard、apps/vscode-extension、apps/license-server	网站、本地仪表板、IDE 小组件、许可证签发	私有
tools/pack-bench	套餐质量基准测试工具	私有

架构详情：ARCHITECTURE.md。

开发

npm install            # at repo root (workspaces)
npm run build          # build all packages
npm test               # run all test suites

安全

按设计仅在本地运行——许可证验证是唯一的网络调用。请按照 SECURITY.md 报告漏洞。

许可证

核心引擎采用 MIT 许可证——请参阅 LICENSE。Pro/Team 套餐包为专有软件。