Function compact_session

mini_claude_code/compact.py:328–378

源码: compact.rs:75-111 流程: 1. 检查是否需要压缩 (should_compact) 2. 分割: messages[:-N] 压缩, messages[-N:] 保留 3. 旧消息 → 结构化摘要 4. 新 session = [system 摘要] + [保留消息]

(
    messages: list[Message],
    config: CompactionConfig,
)

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

def compact_session(
    messages: list[Message],
    config: CompactionConfig,
) -> CompactionResult:
    """源码: compact.rs:75-111

    流程:
    1. 检查是否需要压缩 (should_compact)
    2. 分割: messages[:-N] 压缩, messages[-N:] 保留
    3. 旧消息 → 结构化摘要
    4. 新 session = [system 摘要] + [保留消息]
    """
    if not should_compact(messages, config):
        return CompactionResult(
            compacted_messages=list(messages),
            removed_count=0,
        )

    keep_from = max(0, len(messages) - config.preserve_recent_messages)
    removed = messages[:keep_from]
    preserved = messages[keep_from:]

    summary = summarize_messages(removed)
    formatted_summary = format_compact_summary(summary)

    continuation_text = (
        "This session is being continued from a previous conversation "
        "that ran out of context. The summary below covers the earlier portion.\n\n"
        f"{formatted_summary}"
    )
    if preserved:
        continuation_text += "\n\nRecent messages are preserved verbatim."
    continuation_text += (
        "\nContinue the conversation from where it left off without "
        "asking the user any further questions."
    )

    # 摘要作为 system 角色的消息 — 源码: compact.rs:95-99
    system_msg = Message(
        role="user",  # 我们的 models.py 没有 system role，用 user 代替
        content=[TextContentBlock(text=continuation_text)],
    )

    compacted = [system_msg] + list(preserved)

    return CompactionResult(
        summary=summary,
        formatted_summary=formatted_summary,
        compacted_messages=compacted,
        removed_count=len(removed),
    )