Enum TokenBudgetState 

pub enum TokenBudgetState {
    Normal {
        percent_remaining: f64,
    },
    Warning {
        percent_remaining: f64,
    },
    Error {
        percent_remaining: f64,
    },
    Blocking,
}

Token 用量状态 — 当前上下文占用量的分级警告。

UI 层用此枚举渲染进度条颜色和警告提示。 Agent loop 用此判断是否触发自动压缩。

阈值对照（来源: claude-code）

|------ Normal ------|-- Warning --|-- Error --|-- Blocking --|
0%                 ~70%          ~85%        ~95%          100%

Examples

use katu_core::compaction::TokenBudgetState;

let state = TokenBudgetState::from_usage(150_000, 200_000, 13_000);

Variants

Normal

正常 — 充足余量。

Fields

percent_remaining: f64

剩余可用百分比 (0.0 ~ 1.0)。

Warning

警告 — 接近阈值，UI 显示黄色提示。

Fields

percent_remaining: f64

Error

危险 — 非常接近上限，UI 显示红色提示。

Fields

percent_remaining: f64

Blocking

阻塞 — 已达到上限，应阻止新消息发送。

Implementations

impl TokenBudgetState

pub fn from_usage( used_tokens: u64, context_window: u64, auto_compact_buffer: u64, ) -> Self

根据当前 token 用量计算状态。

Arguments

• used_tokens: 当前已使用的 token 数
• context_window: 模型 context window 大小
• auto_compact_buffer: 自动压缩缓冲区大小（reserve_tokens）

阈值计算

effective_window = context_window - summary_reserve (通常 20K)
auto_compact_threshold = effective_window - auto_compact_buffer
warning_threshold = auto_compact_threshold - 20K
error_threshold = effective_window - 20K

pub fn should_auto_compact(&self) -> bool

是否应触发自动压缩。

pub fn is_blocking(&self) -> bool

是否应阻止新消息发送。

pub fn is_warning_or_worse(&self) -> bool

是否处于警告或更严重状态。

Trait Implementations

impl Clone for TokenBudgetState

fn clone(&self) -> TokenBudgetState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TokenBudgetState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TokenBudgetState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TokenBudgetState

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

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 TokenBudgetState

impl StructuralPartialEq for TokenBudgetState