deepseek-harness/packages/compact/README.zh.md

compact/：压缩能力家族

English | 中文

一个压缩（compaction）能力家族（见能力 seam）：抽象接口、摘要生成后端、不依赖模型的工具结果剪枝配套组件，以及面向用户的命令适配器。这些全是产品包（package）。

包	职责	ctx key
compact/	抽象压缩 seam（接口 + compact/* 事件 + CompactionResult）	ctx.compact
compact-basic/	后端：ctx.tokenMeter 压力 + 按 token 预算保留内容 + llm.stream() 摘要生成	（注册 ctx.compact）
compact-tool-result-prune/	可选的不依赖模型的头／中／尾重写，在摘要压缩之前运行	ctx.toolResultPrune
command-compact/	面向用户的 /compact 命令，基于后端无关的 compactNow() seam	（注册到 ctx.commands）

接口位于 compact/compact/，后端位于 compact/compact-basic/，确定性剪枝位于 compact/compact-tool-result-prune/，命令位于 compact/command-compact/。与 bash seam 不同，该接口依赖 dsh-session 和 dsh-llm，因为它的操作以 Session 为对象，输出则使用 ContentBlock。这项偏差记录在压缩能力 seam Agent Note（agent 决策记录） 中。token 测量仍是可复用的 LLM（大语言模型）家族服务；基于模板或模型的压缩器可以替换 compact-basic，而无需更改计量器、剪枝器、命令或自动调用方。