docs: comprehensive README update with enhanced documentation

[drdoc-bot]

Comprehensive README Update

This PR significantly expands and improves the README.md documentation for the Sea of Simulation (SoS) project.

Changes Made

📝 Content Additions

• Badges: Added Cargo, Rust, and License badges for better project visibility
• Detailed Feature List: Expanded from basic features to include more technical capabilities
• Use Cases Section: Added common use cases (AI/ML agents, testing, CI/CD, security research, education)
• Prerequisites Section: Clear Docker and Rust requirements
• Enhanced Installation Guide: Multiple installation methods with clear instructions
• Comprehensive Usage Documentation:
  • Server mode with all command options
  • Client mode with detailed examples for each command
  • Complete workflow example with step-by-step instructions
  • Session mode and TUI usage

🔌 API Documentation

• Complete HTTP API Reference: Detailed documentation for all endpoints
• Request/Response Examples: JSON examples for each API call
• Endpoint Descriptions: Clear explanations of what each endpoint does

🏗️ Technical Documentation

• Architecture Section: Overview of the project structure
• File Organization: Descriptions of key source files and their purposes

🧪 Testing & Development

• Testing Guide: Instructions for running tests and benchmarks
• Development Setup: Steps for setting up a development environment
• Troubleshooting Section: Common issues and solutions

📚 Examples & Integration

• Examples Directory: Documentation of the RL and synthetic generator examples
• Environment Variables: List of useful configuration options
• Contributing Guidelines: Instructions for contributors

🎨 Formatting & Style

• Consistent markdown formatting
• Better organization with clear section headers
• Code blocks with language syntax highlighting
• Emojis for visual appeal and quick scanning
• Proper spacing and readability

Stats

• Before: ~3,000 bytes, basic documentation
• After: ~11,400 bytes, comprehensive documentation
• Sections Added: 8+ major new sections
• Examples Added: 15+ code examples

Benefits

• New Users: Can quickly understand what SoS does and how to use it
• Developers: Have clear API documentation and architecture overview
• Contributors: Have guidelines for contributing to the project
• All Users: Better troubleshooting guide and usage examples

Resolves #8