Struct PreserveConfig 

pub struct PreserveConfig {
    pub recent_turns: u32,
    pub recent_tokens: Option<u64>,
}

消息保留策略 — 压缩时保留哪些近期内容不总结。

保留的消息保持原始内容，不被 LLM 重新摘要。 这对保留最近的工具调用上下文、用户指令尤其重要。

两种维度

• turns — 按 user turn 数量保留（opencode tail_turns=2）
• tokens — 按 token 预算保留（oh-my-pi keepRecentTokens=20K）

两者取 交集：先按 turns 选出候选，再按 tokens 预算裁剪。

Examples

use katu_core::compaction::PreserveConfig;

// 保留最近 2 个 user turn，最多 8K tokens
let config = PreserveConfig::new(2, 8_000);

Fields

recent_turns: u32

保留最近 N 个 user turn（含其后续的 assistant/tool 回复）。

0 = 不按 turn 保留。 来源: opencode DEFAULT_TAIL_TURNS = 2。

recent_tokens: Option<u64>

保留最近内容的 token 预算上限。

None = 自动计算（usable_tokens * 0.25，clamp 到 2K~8K）。 来源: oh-my-pi keepRecentTokens=20K, opencode preserve_recent_tokens。

Implementations

impl PreserveConfig

pub fn new(recent_turns: u32, recent_tokens: u64) -> Self

创建保留配置。

pub fn with_recent_turns(self, turns: u32) -> Self

设置 turn 数量。

pub fn with_recent_tokens(self, tokens: u64) -> Self

设置 token 预算。

pub fn resolve_recent_tokens( &self, usable_tokens: u64, min: u64, max: u64, ) -> u64

解析最终的保留 token 预算。

如果 recent_tokens 已设置，直接返回。 否则自动计算：usable_tokens * 0.25，clamp 到 [min, max]。

Arguments

• usable_tokens: 可用 token 数（context_window - reserve - output）
• min: 最小保留（默认 2,000）
• max: 最大保留（默认 8,000）

Trait Implementations

impl Clone for PreserveConfig

fn clone(&self) -> PreserveConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PreserveConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PreserveConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PreserveConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PreserveConfig

fn eq(&self, other: &PreserveConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PreserveConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for PreserveConfig

impl Eq for PreserveConfig

impl StructuralPartialEq for PreserveConfig