feat: add MetaX GPU examples and documentation

New examples:
- examples/metax_example.cpp: Basic MetaX MCPTI profiling
- examples/metax_benchmark.cpp: Multi-stream benchmark with analysis
- python/examples/metax_profiling.py: Python API for MetaX GPUs

Build system:
- Add MetaX examples to CMakeLists.txt
- Use find_library() for mcpti and mcruntime linking

Documentation:
- Add MetaX MCPTI profiling section to README
- Include C++ and Python API examples
- Document captured event types

Author: chenxingqiang

README.md

@@ -406,6 +406,77 @@ profiler.export_perfetto("metal_trace.json")
 - `Game Performance` - Frame rate and GPU time
 - `Animation Hitches` - Animation performance
 
+**Output:**
+
+#### MetaX GPU Profiling with MCPTI
+
+TraceSmith supports MetaX GPUs (C500, C550, etc.) using the MCPTI (MACA Profiling Tools Interface), which provides an API compatible with NVIDIA CUPTI.
+
+**Build with MetaX support:**
+
+```bash
+cmake -DTRACESMITH_ENABLE_MACA=ON ..
+make -j4
+```
+
+**C++ API:**
+
+```cpp
+#include <tracesmith/tracesmith.hpp>
+
+// Check MetaX GPU availability
+if (tracesmith::isMACAAvailable()) {
+    std::cout << "MetaX devices: " << tracesmith::getMACADeviceCount() << std::endl;
+}
+
+// Create MCPTI profiler
+auto profiler = tracesmith::createProfiler(tracesmith::PlatformType::MACA);
+
+// Configure
+tracesmith::ProfilerConfig config;
+config.capture_kernels = true;
+config.capture_memcpy = true;
+profiler->initialize(config);
+
+// Capture events
+profiler->startCapture();
+// ... GPU code using MACA runtime ...
+profiler->stopCapture();
+
+// Get events
+std::vector<tracesmith::TraceEvent> events;
+profiler->getEvents(events);
+```
+
+**Python API:**
+
+```python
+import tracesmith as ts
+
+# Check MetaX availability
+if ts.is_maca_available():
+    print(f"MetaX devices: {ts.get_maca_device_count()}")
+    
+    # Create profiler
+    profiler = ts.create_profiler(ts.PlatformType.MACA)
+    profiler.initialize(ts.ProfilerConfig())
+    
+    profiler.start_capture()
+    # ... GPU code ...
+    profiler.stop_capture()
+    
+    events = profiler.get_events()
+```
+
+**MCPTI Captured Events:**
+
+| Event Type | Description |
+|------------|-------------|
+| KernelLaunch/Complete | Kernel execution timing |
+| MemcpyH2D/D2H/D2D | Memory transfers |
+| MemsetDevice | Memory initialization |
+| StreamSync/DeviceSync | Synchronization events |
+
 **Output:**
 - SBT file with parsed GPU events
 - Optional: Raw `.trace` file (use `--keep-trace`) for viewing in Instruments

examples/CMakeLists.txt

@@ -268,6 +268,35 @@ if(TRACESMITH_ENABLE_METAL AND APPLE)
     )
 endif()
 
+# ----------------------------------------------------------------------------
+# MetaX MACA Examples (requires MetaX GPU)
+# ----------------------------------------------------------------------------
+if(TRACESMITH_ENABLE_MACA)
+    # MetaX basic example
+    add_executable(metax_example
+        metax_example.cpp
+    )
+    
+    target_link_libraries(metax_example PRIVATE
+        tracesmith-common
+        tracesmith-format
+        tracesmith-capture
+        tracesmith-state
+    )
+    
+    # MetaX benchmark example
+    add_executable(metax_benchmark
+        metax_benchmark.cpp
+    )
+    
+    target_link_libraries(metax_benchmark PRIVATE
+        tracesmith-common
+        tracesmith-format
+        tracesmith-capture
+        tracesmith-state
+    )
+endif()
+
 # ----------------------------------------------------------------------------
 # Goal Validation Example - Validates all project goals from PLANNING.md
 # ----------------------------------------------------------------------------
@@ -380,5 +409,10 @@ if(TRACESMITH_ENABLE_METAL AND APPLE)
     message(STATUS "  Metal examples (Apple GPU):")
     message(STATUS "    - metal_example (Apple Metal profiling)")
 endif()
+if(TRACESMITH_ENABLE_MACA)
+    message(STATUS "  MetaX examples (MetaX GPU):")
+    message(STATUS "    - metax_example (MetaX MCPTI profiling)")
+    message(STATUS "    - metax_benchmark (MetaX benchmark with multi-stream)")
+endif()
 message(STATUS "  Python examples:")
 message(STATUS "    - python_example.py (Python API demonstration)")