agent-desktop/scripts/startup_profile/README.md

🚀 QwenPaw Startup Performance Analyzer

One-click analysis of QwenPaw startup performance, identify bottlenecks, and provide optimization suggestions.

Quick Start

# 1. Generate report
python scripts/startup_profile/analyze.py

# 2. Start local server to view (recommended)
python scripts/startup_profile/serve.py

After execution:

1. Collect import time data
2. Collect function execution trace (optional)
3. Generate JSON data
4. View report via HTTP server

Note: Due to browser security restrictions (CORS), opening HTML directly with file:// protocol cannot load data. Please use serve.py or manually start an HTTP server:

cd /path/to/QwenPaw
python -m http.server 8000
# Visit: http://localhost:8000/scripts/startup_profile/output/report.html

Generated Files

output/
├── importtime.log         # Import time raw log
├── execution_trace.json   # Function execution trace (if successful)
├── analysis.json          # Analysis data (core)
└── report.html            # Visual report ⭐

Report Features

• Import Time Analysis - QwenPaw modules and third-party library import time ranking
• Function Execution Time - Top 20 function execution time statistics
• Function Call Tree - Complete function call hierarchy and timing (limited to 5 levels deep, top 10 calls per level)
• Interactive Charts - Chart.js horizontal bar chart visualization
• Bilingual Support - Chinese/English one-click toggle
• Performance Markers - Auto-mark fast/medium/slow functions based on timing (green/yellow/red)

How It Works

1. Data Collection

   • Use Python -X importtime to collect import time
   • Use exec_tracer to track function calls

2. Data Analysis

   • Parse log files
   • Categorize statistics (QwenPaw/third-party/stdlib)
   • Calculate percentages and performance metrics

3. Visualization

   • HTML reads JSON data
   • Interactive charts and tables
   • Supports search, sort, filter

File Description

• analyze.py - Data collection and analysis script
• viewer.html - Visualization interface (bilingual)
• README.md - Chinese documentation
• README_EN.md - English documentation

FAQ

Q: Why do results vary each run? A: Import time is affected by system load. Run multiple times and take average.

Q: How to compare before/after optimization? A: Save output/ directory, re-run after optimization and compare.

Q: Function trace fails? A: Normal, doesn't affect import analysis. Can use exec_tracer separately.

Technical Details

• Python 3.8+
• No extra dependencies (except QwenPaw itself)
• Pure JSON data output
• HTML runs standalone, viewable offline

Related Tools

• src/pineagents/utils/startup_display.py - Startup banner display

---

Version: 2.0.0 Author: QwenPaw Team Updated: 2026-04-17