如何一行压缩LLM内容：Headroom UniversalCompressor API完整参数手册-北京尧图网络

如何一行压缩LLM内容Headroom UniversalCompressor API完整参数手册【免费下载链接】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 之前压缩工具输出、日志、文件和 RAG 切片的开源项目编码代理节省约 20% tokenJSON 可节省 60–95%且回答不变。它的 Python 库中最灵活的一个入口就是UniversalCompressor——通过compress()一行调用即可自动检测内容类型JSON/代码/日志/文本、保留结构骨架、压缩冗余值并支持事后取回原文。本文带你读完compress()的全部参数与配置项。一行入门compress() 快捷函数如果你只需要丢进去、拿回来不必实例化任何类from headroom.compression import compress result compress({users: [{id: 1, name: Alice}]}) print(result.compressed) # 结构保留、值被压缩后的内容 print(result.savings_percentage) # 节省的 token 百分比该函数内部就是新建一个默认配置的UniversalCompressor然后调用compress()适合一次性脚本。可复用、可调参的场景请使用类形式from headroom.compression import UniversalCompressor, UniversalCompressorConfig config UniversalCompressorConfig(compression_ratio_target0.5) compressor UniversalCompressor(configconfig) result compressor.compress(content)compress() 方法参数详解compress()的签名只有三个参数源码universal.py参数类型必填说明contentstr✅要压缩的内容。短于min_content_length默认 100 字符会原样返回metadata中标记skipped: content too shortcontent_typeContentType/None❌跳过 ML 检测、手动指定内容类型。可取JSON、CODE、LOG、DIFF、MARKDOWN、TEXT、UNKNOWN枚举定义detector.py**kwargs—❌透传给结构处理器的选项如 JSON 处理器的精细开关不传content_type时压缩器会先调用 Magika 深度学习检测器本地运行、约 5ms、支持 100 类型、99% 准确率自动判断类型。构造函数3 个可定制入口UniversalCompressor.__init__universal.py接受参数默认行为作用config默认UniversalCompressorConfig()压缩策略总开关下节详解handlers内置JSONCODE两个结构处理器注入自定义处理器替换某类内容的结构保留逻辑compress_fnKompress可用时→ 否则简单截断替换底层压缩函数只压缩被标记为非结构性的片段UniversalCompressorConfig7 个核心配置项这是整份手册里最值得背的表格universal.py配置项默认值含义use_magikaTrue是否启用 ML 检测设为False改用规则型FallbackDetectoruse_kompressTrue是否用 Kompress 模型压缩非结构内容use_entropy_preservationTrue高熵片段UUID、API Key、哈希自动豁免压缩entropy_threshold0.85熵保阈值越高越少片段被豁免min_content_length100内容短于该字符数直接跳过压缩compression_ratio_target0.3目标压缩率保留 30% ≈ 削减 70%ccr_enabledTrue原文存入 CCR 缓存压缩后可凭ccr_key取回新手调参建议先只动compression_ratio_target。想更激进省 token 就调低如0.2担心丢信息就调高如0.5。CompressionResult 返回值字段速查compress()返回的CompressionResultuniversal.py信息量很大字段说明compressed/original压缩后内容 / 原文compression_ratio压缩后长度 ÷ 原文长度tokens_before/tokens_after压缩前后估算 token 数约 4 字符/tokentokens_saved⭐便捷属性实际省下的 token 数savings_percentage⭐便捷属性节省百分比content_type/detection_confidence检测出的类型及置信度0–1handler_used/preservation_ratio使用的结构处理器、被标记为结构性的比例ccr_keyCCR 存储键ccr_enabledTrue时非空可据此取回原文metadata检测原始标签、语言、处理器元数据等进阶批量压缩与自定义处理器批量压缩对多段内容逐个compress()会重复跑检测compress_batch()支持一次批量检测后逐条压缩universal.pyresults compressor.compress_batch([json_a, log_b, code_c])注册自定义处理器想保留某类内容的特殊结构实现get_mask()协议协议定义base.py后注册即可compressor.register_handler(ContentType.JSON, my_handler)参数选型速查表TL;DR你的场景推荐姿势脚本里临时压一段from headroom.compression import compress一行搞定已知内容是 JSON/代码传content_typeContentType.JSON省掉 5ms 检测内容里含密钥/UUID保持默认use_entropy_preservationTrue希望压缩后能取回原文保持默认ccr_enabledTrue记下ccr_key要更省 token调低compression_ratio_target如 0.2大批量 RAG 切片用compress_batch()相关源码与资料核心实现headroom/compression/universal.pyML 内容检测器headroom/compression/detector.py结构掩码系统headroom/compression/masks.pyJSON / 代码结构处理器headroom/compression/handlers/消息级压缩代理管线用headroom/compress.py项目文档与架构图解wiki/掌握这份手册后你可以根据业务场景精确控制 Headroom 的压缩行为——记住三个默认值的含义100 字符以下不压、目标保留 30%、高熵值自动豁免再配合CompressionResult里的savings_percentage验证效果就是一套完整的压缩—度量—调优闭环。【免费下载链接】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），仅供参考

如何一行压缩LLM内容：Headroom UniversalCompressor API完整参数手册

相关推荐

Ghidra 12.1 调试器深度拆解：JNA 到 Trace RMI 迁移的 3 个关键决策

零基础学Python避坑指南：环境搭建、学习路线与实战建议

如何用 /impeccable onboard：首次体验流、空状态与激活路径设计完整指南

更多资讯

深圳电工证费用多少钱？学历不高怕报不上名怎么办？

神木低压电工证科目三怎么报名？学历不高也能考

2017年电工证样子怎么转异地考费多少钱别被中介骗了

特种工持证电子证书过期了怎么复审？这几点你必须知道

临汾煤气作业证培训怎么报名？官方报名入口在这里

特种工复审要考试吗值不值得考 2025年最新实操考试攻略

今日更新

安监局电工证分数查询怎么查才能知道含金量高不高

新疆电工作业干活累吗良心建议助你避开考不过的坑

中牟县电工证怎么报名外省证能转吗

本周精选

安监局电工证分数查询怎么查才能知道含金量高不高

新疆电工作业干活累吗良心建议助你避开考不过的坑

中牟县电工证怎么报名外省证能转吗

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？

相关推荐

Ghidra 12.1 调试器深度拆解：JNA 到 Trace RMI 迁移的 3 个关键决策

零基础学Python避坑指南：环境搭建、学习路线与实战建议

如何用 /impeccable onboard：首次体验流、空状态与激活路径设计完整指南

更多资讯

深圳电工证费用多少钱？学历不高怕报不上名怎么办？

神木低压电工证科目三怎么报名？学历不高也能考

2017年电工证样子怎么转异地 考费多少钱别被中介骗了

特种工持证电子证书过期了怎么复审？这几点你必须知道

临汾煤气作业证培训怎么报名？官方报名入口在这里

特种工复审要考试吗 值不值得考 2025年最新实操考试攻略

今日更新

安监局电工证分数查询怎么查才能知道含金量高不高

新疆电工作业干活累吗 良心建议助你避开考不过的坑

中牟县电工证怎么报名外省证能转吗

本周精选

安监局电工证分数查询怎么查才能知道含金量高不高

新疆电工作业干活累吗 良心建议助你避开考不过的坑

中牟县电工证怎么报名外省证能转吗

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？

2017年电工证样子怎么转异地考费多少钱别被中介骗了

特种工复审要考试吗值不值得考 2025年最新实操考试攻略

新疆电工作业干活累吗良心建议助你避开考不过的坑

新疆电工作业干活累吗良心建议助你避开考不过的坑