Struct PruneConfig 

pub struct PruneConfig {
    pub enabled: bool,
    pub protect_tokens: u64,
    pub minimum_tokens: u64,
    pub tool_output_max_chars: usize,
    pub protected_tools: Vec<String>,
}

旧工具输出修剪配置。

Prune 是一种轻量级的上下文优化手段，独立于全量压缩： 把旧的、体积大的工具输出内容截断或标记为已压缩， 释放 token 空间，延迟全量压缩的触发。

算法（来源: opencode）

1. 从最新消息向旧遍历，跳过最近 2 个 user turn
2. 累计 tool output tokens，超过 protect_tokens 后开始标记
3. 仅在总修剪量超过 minimum_tokens 时才实际执行

Examples

use katu_core::compaction::PruneConfig;

let config = PruneConfig::default();
assert!(config.enabled);
assert_eq!(config.protect_tokens, 40_000);

Fields

enabled: bool

是否启用修剪。

protect_tokens: u64

保护最近的 tool output token 数不被修剪。

从最新往旧遍历，累计超过此值后才开始标记修剪。 来源: opencode PRUNE_PROTECT = 40,000。

minimum_tokens: u64

修剪的最小触发阈值。

仅当可修剪量超过此值时才执行，避免无意义的小量修剪。 来源: opencode PRUNE_MINIMUM = 20,000。

tool_output_max_chars: usize

修剪时工具输出截断的最大字符数。

超过此长度的工具输出在修剪时被截断。 来源: opencode TOOL_OUTPUT_MAX_CHARS = 2,000。

protected_tools: Vec<String>

不受修剪影响的工具名称列表。

某些工具（如 skill）的输出对上下文非常重要，不应被修剪。 来源: opencode PRUNE_PROTECTED_TOOLS = [“skill”]。

Implementations

impl PruneConfig

pub fn with_enabled(self, enabled: bool) -> Self

设置修剪开关。

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

设置保护 token 数。

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

设置最小触发阈值。

pub fn with_tool_output_max_chars(self, chars: usize) -> Self

设置工具输出截断字符数。

pub fn add_protected_tool(self, tool: impl Into<String>) -> Self

添加受保护的工具。

Trait Implementations

impl Clone for PruneConfig

fn clone(&self) -> PruneConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PruneConfig

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

Formats the value using the given formatter.

impl Default for PruneConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PruneConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PruneConfig

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for PruneConfig

impl StructuralPartialEq for PruneConfig