Function maybe_auto_compact

tutorials/07_auto_compaction.py:353–374

检查是否需要自动压缩。如果需要，执行压缩。 对应源码: conversation.rs:310-333 (maybe_auto_compact)

(
    session: Session,
    cumulative_input_tokens: int,
    threshold: int = DEFAULT_AUTO_COMPACTION_THRESHOLD,
)

def maybe_auto_compact(
    session: Session,
    cumulative_input_tokens: int,
    threshold: int = DEFAULT_AUTO_COMPACTION_THRESHOLD,
) -> Optional[CompactionResult]:
    """
    检查是否需要自动压缩。如果需要，执行压缩。

    对应源码: conversation.rs:310-333 (maybe_auto_compact)
    """
    if cumulative_input_tokens < threshold:
        return None  # 还没到限制，不需要压缩

    result = compact_session(session, CompactionConfig(
        preserve_recent_messages=4,
        max_estimated_tokens=0,  # 强制压缩（0 表示任何大小都要压缩）
    ))

    if result.removed_message_count == 0:
        return None  # 没有可压缩的消息

    return result


# ============================================================