Struct CompactionThreshold 

pub struct CompactionThreshold {
    pub tokens: Option<u64>,
    pub ratio: Option<f64>,
}

压缩阈值配置 — 控制在 Threshold 模式下何时触发。

解析优先级（与 oh-my-pi 一致）

tokens (固定值) > ratio (百分比) > fallback (context_window - reserve_tokens)

Examples

use katu_core::compaction::CompactionThreshold;

// 固定阈值: 超过 150K tokens 时触发
let fixed = CompactionThreshold::fixed(150_000);

// 百分比阈值: 超过 context window 的 85% 时触发
let ratio = CompactionThreshold::ratio(0.85);

// 默认: 都不设 — 使用 fallback (context_window - reserve_tokens)
let fallback = CompactionThreshold::default();

Fields

tokens: Option<u64>

固定 token 阈值 — 优先级最高。

当 context_tokens > tokens 时触发压缩。

ratio: Option<f64>

百分比阈值 (0.0 ~ 1.0) — tokens 未设置时使用。

当 context_tokens > context_window * ratio 时触发。 来源: oh-my-pi thresholdPercent。

Implementations

impl CompactionThreshold

pub fn fixed(tokens: u64) -> Self

创建固定 token 阈值。

pub fn ratio(ratio: f64) -> Self

创建百分比阈值。

pub fn resolve(&self, context_window: u64, reserve_tokens: u64) -> u64

解析最终阈值 token 数。

优先级

1. self.tokens — 固定值，直接返回（clamp 到 [1, context_window-1]）
2. self.ratio — 百分比，返回 context_window * ratio
3. fallback — context_window - reserve_tokens

Trait Implementations

impl Clone for CompactionThreshold

fn clone(&self) -> CompactionThreshold

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompactionThreshold

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

Formats the value using the given formatter.

impl Default for CompactionThreshold

fn default() -> CompactionThreshold

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CompactionThreshold

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CompactionThreshold

fn eq(&self, other: &CompactionThreshold) -> 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 CompactionThreshold

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 CompactionThreshold

impl StructuralPartialEq for CompactionThreshold