超长文档压缩 · 结构与代码块保留【律令·本地零联网】

长文压缩、长文本压缩与上下文压缩：长文与对话本地压缩，保住结构与代码块，产出带省略标记的摘要稿，零网络纯标准库。

这个技能做什么

本地运行，零网络、免 API Key、数据不出电脑。 四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。

上下文压缩器

子命令（全部实测通过）

analyze：结构分析

context_compressor.py analyze article.md

实测输出（40 章测试文章）：

{"total": {"chars": 7389, "est_tokens": 5984},
 "blocks": {"heading": {"count": 41, "est_tokens": 205}, "para": {"count": 41, "est_tokens": 5617}},
 "top_sections": [{"title": "第 1 章", "est_tokens": 142}, ...]}

compress：按压缩比产出摘要稿

context_compressor.py compress article.md --ratio 0.3 --style digest --out article_slim.md

实测：原 5984 est_tokens → 1973，saved_pct=67.0；标题与代码块结构保留，代码块超 15 行截断为「前 5 行 + 省略标记 + 末行」。--out 与原文件相同会被拒绝：{"ok": false, "error": "禁止覆盖原文件，--out 必须是不同路径"}。

dedupe：移除完全重复段落块

context_compressor.py dedupe article.md --out article_dd.md

实测：{"ok": true, "removed_duplicate_blocks": 1, "orig_tokens": 5984, "new_tokens": 5846}（按空白归一化后判重，重复块保留首份）。

工作流建议

1. 先 analyze 看结构和大块分布，再决定压缩比与样式（outline 逐段摘要化 / digest 整体按预算截断）
2. compress 只写 --out 副本，交付前抽读省略标记处，确认没有压掉关键信息
3. 交付时说明：token 为启发式估算（±20%），省略处都有标记可回溯原文行号

自检清单

• 输出的摘要稿里是否还有 ## 标题（标题应全部保留）
• 每处省略是否都有「省略 n 行/token」的显式标记
• --out 是否与原文件不同路径（相同必须报错）
• 重复段落是否只保留首份

与相邻技能的关系

本包只做自己职责范围内的事，遇到下列情形直接转给兄弟技能：

反向边界：压缩保结构、保代码块，被省略处必须有显式省略标记，绝不静默丢内容。

你是一个长文压缩的工程师：把塞不进上下文的长文压成结构完整的摘要稿，每一处省略都显式标记。核心原则：标题永远保留、省略必须显式标记、绝不覆盖原文件。

标签

长文压缩上下文压缩长文本文档压缩摘要

安装方式

1. 打开 SkillHub 上的技能页，点击安装；
2. 技能文件落在本机技能目录，SKILL.md 全文可在安装前预览；
3. 在你的 Agent 里直接说出使用场景即可触发，例如「文档太长了、超长文档塞不下、压缩这份资料」。

同类技能

常见问题

按真实会被问到的顺序排。每条答案都给得出可核对的依据——触发词、文件名、路径、源码，全部来自技能包里的真实内容，不是宣传话术。