feat: optimize auto context memory

[shiyiyue1102]

This pull request introduces significant improvements to the AutoContextMemory system, focusing on enhanced configuration, event tracking, and documentation for context compression in LLM-based agent systems. The main changes include adding configurable compression ratios, detailed compression event tracking, and comprehensive documentation for users and developers.

Key changes:

1. Configuration Enhancements

• Added a new currentRoundCompressionRatio parameter (default 0.3) to AutoContextConfig, allowing users to specify the compression ratio for current round messages. This includes builder methods, getters, setters, and integration into the config build process. [1] [2] [3] [4] [5]

2. Compression Event Tracking

• Introduced a compressionEvents list in AutoContextMemory to record detailed information about each compression operation, including event type, affected message range, tokens used, and timing. This includes serialization support for state persistence. [1] [2] [3]
• Implemented the recordCompressionEvent method to log each compression event with relevant metadata, such as token counts and time taken, ensuring traceability and facilitating analysis.
• Updated the compression logic for current round message summarization and large message summarization to record events with metadata from LLM usage. [1] [2]

3. Documentation Improvements

• Added a comprehensive Chinese README (README.md) for AutoContextMemory, detailing the background, architecture, compression strategies, configuration options, API reference, event tracking, best practices, and usage notes. This documentation provides clear guidance for configuring and using AutoContextMemory effectively.

4. Example and Minor Adjustments

• Updated example usage in AutoMemoryExample.java to reflect new configuration defaults and session IDs, demonstrating the new compression ratio parameter. [1] [2]
• Minor import addition to support new features.

These changes collectively make AutoContextMemory more configurable, auditable, and user-friendly, supporting advanced context management for LLM agent applications.## AgentScope-Java Version

[The version of AgentScope-Java you are working on, e.g. 1.0.2, check your pom.xml dependency version or run mvn dependency:tree | grep agentscope-parent:pom(only mac/linux)]

Description

[Please describe the background, purpose, changes made, and how to test this PR]

Checklist

Please check the following items before code is ready to be reviewed.

• Code has been formatted with mvn spotless:apply
• All tests are passing (mvn test)
• Javadoc comments are complete and follow project conventions
• Related documentation has been updated (e.g. links, examples, etc.)
• Code is ready for review

[codecov]

Codecov Report

❌ Patch coverage is 59.19118% with 111 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...o/agentscope/core/memory/autocontext/MsgUtils.java	24.73%	57 Missing and 13 partials ⚠️
...cope/core/memory/autocontext/CompressionEvent.java	31.03%	20 Missing ⚠️
...ope/core/memory/autocontext/AutoContextMemory.java	88.02%	1 Missing and 16 partials ⚠️
...ope/core/memory/autocontext/AutoContextConfig.java	50.00%	4 Missing ⚠️

📢 Thoughts on this report? Let us know!