Headroom Marker区块机制可重复运行不重复的CLAUDE.local.md生成策略指南【免费下载链接】headroomCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.项目地址: https://gitcode.com/GitHub_Trending/head/headroomHeadroom 是一款 LLM Token 压缩工具其headroom learn命令通过Marker 区块机制把从失败会话中学到的规律写入CLAUDE.local.md。核心设计是用一对 HTML 注释标记圈出一块托管区域每次重跑只替换这块区域手写内容分毫不动——可无限重复运行绝不产生重复内容。为什么需要 Marker 区块headroom learn会分析你过往的编码会话Claude Code / Codex / Gemini CLI找出哪些路径猜错了、哪些命令总是失败、哪些文件必须分段读取然后生成修正建议写进 Agent 的记忆文件。问题来了这个命令你会反复运行。如果每次运行都往CLAUDE.local.md里追加内容文件会迅速膨胀成重复内容的垃圾堆。Marker 机制就是为了解决这个幂等写入难题。Marker 区块的工作原理Headroom 在文件中维护一个清晰分隔的区域定界符是两行 HTML 注释!-- headroom:learn:start -- ## Headroom Learned Patterns *Auto-generated by headroom learn on 2026-01-01 — do not edit manually* ### Environment - **Python**: use uv run python (not python3) ... !-- headroom:learn:end --关键行为有 4 条实现见 headroom/learn/writer.py场景行为文件里没有标记块在文件末尾追加新块标记块已存在只替换两行标记之间的内容块外内容原样保留新建议与旧区块同名如都是### Environment新运行覆盖旧内容避免冲突旧区块里有本次没提到的章节自动保留学习成果跨次运行累积不丢失第四点是最精巧的重跑不会因为本次没分析到就悄悄删掉上次学到的东西这就是 CHANGELOG 中记录的修复issue #231——学习是累积式的而非整块重建。三步上手从 dry-run 到落盘1️⃣ 先预览不写文件dry-runheadroom learn只打印建议清单不动任何文件。2️⃣ 确认后写入个人文件headroom learn --apply默认写入项目根目录的CLAUDE.local.md——这是 Claude Code 记忆约定中个人专属、默认 gitignore的文件避免把含本机绝对路径的学习成果污染到团队共享的CLAUDE.md。3️⃣ 想写入团队共享文件headroom learn --apply --target CLAUDE.md若旧版本 Headroom 曾把区块写进CLAUDE.md下一次--apply会自动迁移到CLAUDE.local.md、清理共享文件并给出警告提示让你提交前复查 diff迁移逻辑见 headroom/learn/writer.py 的_migrate_legacy_block。各 Agent 的输出文件一览同一套 Marker 机制被复用到所有支持的 Agent详见 wiki/learn.mdAgent上下文文件记忆文件Claude CodeCLAUDE.local.md默认MEMORY.mdOpenAI CodexAGENTS.mdinstructions.mdGemini CLIGEMINI.mdGEMINI.mdGrok CLIGROK.md—完整 CLI 参考与成功关联Success Correlation案例见官方文档 docs/content/docs/failure-learning.mdx。幂等性的测试保障这一机制的每一条行为都有回归测试锁定位于 tests/test_learn/test_writer.py只出现一对标记反复运行后文件里!-- headroom:learn:start --计数恒为 1手写内容不受影响标记块外的# My Project等手写内容逐字节保留章节累积验证旧区块中未被本次重新发现的### Large Files、### Build Commands等章节完整保留连*~15,000 tokens/session saved*的节省量标注都能往返解析同名覆盖验证新运行产出的同名章节优先于旧版本。进阶技巧与常见误区想彻底重建区块手动删除标记块再重跑即可——这正是标记外内容受保护设计的对偶托管区可随意重建非托管区绝对安全。⚠️不要把CLAUDE.local.md提交到 git它包含你机器的绝对路径等个性化事实请确保其在.gitignore中CLI 在迁移时也会主动提醒这一点。⚠️不要手动编辑标记块内部块内标注了do not edit manually手改内容会在下次运行时按新运行优先规则被覆盖。小结Marker 区块机制是 Headroom 把自动生成内容安全嵌入人机混编文件的优雅答案一对 HTML 注释圈出托管区域肉眼可辨、工具无关只替换区块内部区块外部的手写内容永不被碰章节级合并让学习成果跨运行累积同名章节以最新分析为准默认落到个人文件CLAUDE.local.md团队协作互不干扰。这正是 README.md 中headroom learn的定位——挖掘失败会话、把修正写入 Agent 记忆而 Marker 机制保证了这件事可以放心地每天重复执行。【免费下载链接】headroomCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.项目地址: https://gitcode.com/GitHub_Trending/head/headroom创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Headroom Marker区块机制：可重复运行不重复的CLAUDE.local.md生成策略指南
Headroom Marker区块机制可重复运行不重复的CLAUDE.local.md生成策略指南【免费下载链接】headroomCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.项目地址: https://gitcode.com/GitHub_Trending/head/headroomHeadroom 是一款 LLM Token 压缩工具其headroom learn命令通过Marker 区块机制把从失败会话中学到的规律写入CLAUDE.local.md。核心设计是用一对 HTML 注释标记圈出一块托管区域每次重跑只替换这块区域手写内容分毫不动——可无限重复运行绝不产生重复内容。为什么需要 Marker 区块headroom learn会分析你过往的编码会话Claude Code / Codex / Gemini CLI找出哪些路径猜错了、哪些命令总是失败、哪些文件必须分段读取然后生成修正建议写进 Agent 的记忆文件。问题来了这个命令你会反复运行。如果每次运行都往CLAUDE.local.md里追加内容文件会迅速膨胀成重复内容的垃圾堆。Marker 机制就是为了解决这个幂等写入难题。Marker 区块的工作原理Headroom 在文件中维护一个清晰分隔的区域定界符是两行 HTML 注释!-- headroom:learn:start -- ## Headroom Learned Patterns *Auto-generated by headroom learn on 2026-01-01 — do not edit manually* ### Environment - **Python**: use uv run python (not python3) ... !-- headroom:learn:end --关键行为有 4 条实现见 headroom/learn/writer.py场景行为文件里没有标记块在文件末尾追加新块标记块已存在只替换两行标记之间的内容块外内容原样保留新建议与旧区块同名如都是### Environment新运行覆盖旧内容避免冲突旧区块里有本次没提到的章节自动保留学习成果跨次运行累积不丢失第四点是最精巧的重跑不会因为本次没分析到就悄悄删掉上次学到的东西这就是 CHANGELOG 中记录的修复issue #231——学习是累积式的而非整块重建。三步上手从 dry-run 到落盘1️⃣ 先预览不写文件dry-runheadroom learn只打印建议清单不动任何文件。2️⃣ 确认后写入个人文件headroom learn --apply默认写入项目根目录的CLAUDE.local.md——这是 Claude Code 记忆约定中个人专属、默认 gitignore的文件避免把含本机绝对路径的学习成果污染到团队共享的CLAUDE.md。3️⃣ 想写入团队共享文件headroom learn --apply --target CLAUDE.md若旧版本 Headroom 曾把区块写进CLAUDE.md下一次--apply会自动迁移到CLAUDE.local.md、清理共享文件并给出警告提示让你提交前复查 diff迁移逻辑见 headroom/learn/writer.py 的_migrate_legacy_block。各 Agent 的输出文件一览同一套 Marker 机制被复用到所有支持的 Agent详见 wiki/learn.mdAgent上下文文件记忆文件Claude CodeCLAUDE.local.md默认MEMORY.mdOpenAI CodexAGENTS.mdinstructions.mdGemini CLIGEMINI.mdGEMINI.mdGrok CLIGROK.md—完整 CLI 参考与成功关联Success Correlation案例见官方文档 docs/content/docs/failure-learning.mdx。幂等性的测试保障这一机制的每一条行为都有回归测试锁定位于 tests/test_learn/test_writer.py只出现一对标记反复运行后文件里!-- headroom:learn:start --计数恒为 1手写内容不受影响标记块外的# My Project等手写内容逐字节保留章节累积验证旧区块中未被本次重新发现的### Large Files、### Build Commands等章节完整保留连*~15,000 tokens/session saved*的节省量标注都能往返解析同名覆盖验证新运行产出的同名章节优先于旧版本。进阶技巧与常见误区想彻底重建区块手动删除标记块再重跑即可——这正是标记外内容受保护设计的对偶托管区可随意重建非托管区绝对安全。⚠️不要把CLAUDE.local.md提交到 git它包含你机器的绝对路径等个性化事实请确保其在.gitignore中CLI 在迁移时也会主动提醒这一点。⚠️不要手动编辑标记块内部块内标注了do not edit manually手改内容会在下次运行时按新运行优先规则被覆盖。小结Marker 区块机制是 Headroom 把自动生成内容安全嵌入人机混编文件的优雅答案一对 HTML 注释圈出托管区域肉眼可辨、工具无关只替换区块内部区块外部的手写内容永不被碰章节级合并让学习成果跨运行累积同名章节以最新分析为准默认落到个人文件CLAUDE.local.md团队协作互不干扰。这正是 README.md 中headroom learn的定位——挖掘失败会话、把修正写入 Agent 记忆而 Marker 机制保证了这件事可以放心地每天重复执行。【免费下载链接】headroomCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.项目地址: https://gitcode.com/GitHub_Trending/head/headroom创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考