optiflow-mcp

一个单一的 Claude Code 插件，一个 MCP 服务器，一个仓库——不是围绕独立安装工具的包装器。它真正地将两个上游项目的真实源码合并到自己的代码库中：

1. token-optimizer-mcp 的 76 个真实 smart_*/分析/仪表盘监控 MCP 工具，以及其 PreToolUse/PreCompact 强制钩子，直接移植到 src/optimizer/ 中——无需 npx 安装，无需独立进程。

2. headroom 的实际 Rust 压缩核心（SmartCrusher）分支到 native/headroom-core/，经过功能精简并编译为真实的 WebAssembly（native/headroom-wasm/），由 Node 插件直接加载——是真正的 Rust 算法，而非重写。headroom 的 CodeCompressor 和 Kompress ML 模型则改用 TypeScript 在本地重新实现（src/native/）。

3. 五个两个上游工具均未覆盖的自有模块：chop 风格的 Bash/CLI 输出拦截、会话报告转录分析、状态栏上下文指示器、/optiflow:compact-continue 会话交接检查点，以及针对大型 JSON/CSV/YAML 负载的 TOON 转换。

两个上游项目仍作为 git 子模块引用在 vendor/ 下，用于来源/许可证文本，但 src/ 或 native/ 下的任何内容均不从 vendor/ 导入——参见 docs/ADR/0002-real-merge-not-orchestration.md 了解为何这取代了最初的编排包装器设计（v1），以及 docs/architecture.md 了解完整的权限映射和锁定决策。

状态

两个主要合并已完成并连接：来自 token-optimizer-mcp 的 76 个工具 + 强制钩子合并，以及 headroom 的压缩核心（WASM SmartCrusher + TS CodeCompressor/Kompress）实际在发布的流水线中被调用，而非仅独立构建。npm run build、npm test 和 npx tsc --noEmit 均通过——参见 docs/modules.md 了解每个模块的详细信息和当前测试数量。从源码构建需要 Rust 工具链（rustup、wasm32-unknown-unknown 目标、wasm-pack）以及 Node；插件安装则不需要（编译后的 .wasm 已提交，理由与 plugin/dist/ 相同）。

Related MCP server: claude-engineering-coach

快速开始

发布于 github.com/kristijankopacevic/optiflow-mcp。通过本地路径市场进行端到端验证（无需 gh 认证）：

1. 在 Claude Code 会话中，将此仓库添加为市场并安装插件：

   /plugin marketplace add C:\path\to\optiflow-mcp
   /plugin install optiflow@optiflow

2. 检查你的环境：

   optiflow doctor

   报告 Node/npm 版本、配置解析以及 gh 存在性/认证状态。

3. 激活状态栏（可选，选择加入——仅安装插件不会修改你的 settings.json）：

   optiflow install --statusline

   在写入前备份你的 ~/.claude/settings.json，以原子方式写入，并在没有 --force 的情况下拒绝覆盖不同的现有状态栏。optiflow uninstall 可撤销此操作。参见 docs/statusline-manual-setup.md 了解详情（包括手动操作），以及 docs/modules.md 了解其余模块。

参见 docs/ 了解架构、配置以及超出此快速入门范围的每个模块的参考深度。

许可证

optiflow-mcp 自身代码采用 MIT 许可证（参见 LICENSE）。此仓库还从 MIT 许可证（token-optimizer-mcp）和 Apache-2.0 许可证（headroom）的上游项目复制了源码——参见 THIRD_PARTY_LICENSES.md 和 NOTICE。