updaste comments in visualize-trace

Author: ntudy

apps/visualize-trace/app.py

@@ -14,13 +14,13 @@
 
 @app.route("/")
 def index():
-    """主页面"""
+    """Main page"""
     return render_template("index.html")
 
 
 @app.route("/api/list_files", methods=["GET"])
 def list_files():
-    """列出可用的JSON文件"""
+    """List available JSON files"""
     try:
         directory = request.args.get("directory", "")
 
@@ -35,10 +35,10 @@ def list_files():
         directory = os.path.abspath(directory)
 
         if not os.path.exists(directory):
-            return jsonify({"error": f"目录不存在: {directory}"}), 404
+            return jsonify({"error": f"Directory does not exist: {directory}"}), 404
 
         if not os.path.isdir(directory):
-            return jsonify({"error": f"路径不是目录: {directory}"}), 400
+            return jsonify({"error": f"Path is not a directory: {directory}"}), 400
 
         try:
             json_files = []
@@ -68,54 +68,54 @@ def list_files():
                 {
                     "files": json_files,
                     "directory": directory,
-                    "message": f'在目录 "{directory}" 中找到 {len(json_files)} 个JSON文件',
+                    "message": f'Found {len(json_files)} JSON files in directory "{directory}"',
                 }
             )
         except PermissionError:
-            return jsonify({"error": f"没有权限访问目录: {directory}"}), 403
+            return jsonify({"error": f"No permission to access directory: {directory}"}), 403
         except Exception as e:
-            return jsonify({"error": f"读取目录失败: {str(e)}"}), 500
+            return jsonify({"error": f"Failed to read directory: {str(e)}"}), 500
 
     except Exception as e:
         return jsonify({"error": str(e)}), 500
 
 
 @app.route("/api/load_trace", methods=["POST"])
 def load_trace():
-    """加载trace文件"""
+    """Load trace file"""
     global analyzer
 
     data = request.get_json()
     file_path = data.get("file_path")
 
     if not file_path:
-        return jsonify({"error": "请提供文件路径"}), 400
+        return jsonify({"error": "Please provide file path"}), 400
 
     # If it's a relative path, convert to absolute path
     if not os.path.isabs(file_path):
         file_path = os.path.abspath(file_path)
 
     if not os.path.exists(file_path):
-        return jsonify({"error": f"文件不存在: {file_path}"}), 404
+        return jsonify({"error": f"File does not exist: {file_path}"}), 404
 
     try:
         analyzer = TraceAnalyzer(file_path)
         return jsonify(
             {
-                "message": "文件加载成功",
+                "message": "File loaded successfully",
                 "file_path": file_path,
                 "file_name": os.path.basename(file_path),
             }
         )
     except Exception as e:
-        return jsonify({"error": f"加载文件失败: {str(e)}"}), 500
+        return jsonify({"error": f"Failed to load file: {str(e)}"}), 500
 
 
 @app.route("/api/basic_info")
 def get_basic_info():
-    """获取基本信息"""
+    """Get basic information"""
     if not analyzer:
-        return jsonify({"error": "请先加载trace文件"}), 400
+        return jsonify({"error": "Please load trace file first"}), 400
 
     try:
         return jsonify(analyzer.get_basic_info())
@@ -125,9 +125,9 @@ def get_basic_info():
 
 @app.route("/api/performance_summary")
 def get_performance_summary():
-    """获取性能摘要"""
+    """Get performance summary"""
     if not analyzer:
-        return jsonify({"error": "请先加载trace文件"}), 400
+        return jsonify({"error": "Please load trace file first"}), 400
 
     try:
         return jsonify(analyzer.get_performance_summary())
@@ -137,9 +137,9 @@ def get_performance_summary():
 
 @app.route("/api/execution_flow")
 def get_execution_flow():
-    """获取执行流程"""
+    """Get execution flow"""
     if not analyzer:
-        return jsonify({"error": "请先加载trace文件"}), 400
+        return jsonify({"error": "Please load trace file first"}), 400
 
     try:
         return jsonify(analyzer.analyze_conversation_flow())
@@ -149,9 +149,9 @@ def get_execution_flow():
 
 @app.route("/api/execution_summary")
 def get_execution_summary():
-    """获取执行摘要"""
+    """Get execution summary"""
     if not analyzer:
-        return jsonify({"error": "请先加载trace文件"}), 400
+        return jsonify({"error": "Please load trace file first"}), 400
 
     try:
         return jsonify(analyzer.get_execution_summary())
@@ -161,9 +161,9 @@ def get_execution_summary():
 
 @app.route("/api/spans_summary")
 def get_spans_summary():
-    """获取spans摘要"""
+    """Get spans summary"""
     if not analyzer:
-        return jsonify({"error": "请先加载trace文件"}), 400
+        return jsonify({"error": "Please load trace file first"}), 400
 
     try:
         return jsonify(analyzer.get_spans_summary())
@@ -173,9 +173,9 @@ def get_spans_summary():
 
 @app.route("/api/step_logs_summary")
 def get_step_logs_summary():
-    """获取步骤日志摘要"""
+    """Get step logs summary"""
     if not analyzer:
-        return jsonify({"error": "请先加载trace文件"}), 400
+        return jsonify({"error": "Please load trace file first"}), 400
 
     try:
         return jsonify(analyzer.get_step_logs_summary())
@@ -185,9 +185,9 @@ def get_step_logs_summary():
 
 @app.route("/api/debug/raw_messages")
 def get_raw_messages():
-    """获取原始消息数据用于调试"""
+    """Get raw message data for debugging"""
     if not analyzer:
-        return jsonify({"error": "请先加载trace文件"}), 400
+        return jsonify({"error": "Please load trace file first"}), 400
 
     try:
         main_history = analyzer.get_main_agent_history()
@@ -220,7 +220,7 @@ def get_raw_messages():
                 "raw_main_history": main_history,
                 "raw_browser_sessions": {
                     k: v for k, v in list(browser_sessions.items())[:2]
-                },  # 只显示前两个会话
+                },  # Only show first two sessions
             }
         )
     except Exception as e:

apps/visualize-trace/run.py

@@ -5,7 +5,7 @@
 # SPDX-License-Identifier: Apache-2.0
 
 """
-Trace Analysis Web Demo 启动脚本
+Trace Analysis Web Demo startup script
 """
 
 import os
@@ -14,98 +14,98 @@
 
 
 def check_dependencies():
-    """检查依赖是否已安装"""
+    """Check if dependencies are installed"""
     try:
         import importlib.util
 
         if importlib.util.find_spec("flask") is not None:
-            print("✓ Flask 已安装")
+            print("✓ Flask installed")
             return True
         else:
             raise ImportError("Flask not found")
     except ImportError:
-        print("✗ Flask 未安装")
-        print("请使用以下命令安装依赖:")
+        print("✗ Flask not installed")
+        print("Please use the following command to install dependencies:")
         print("  uv sync")
-        print("或者:")
+        print("or:")
         print("  uv pip install -r requirements.txt")
         return False
 
 
 def install_dependencies():
-    """安装依赖（建议使用uv）"""
-    print("正在安装依赖...")
+    """Install dependencies (recommended to use uv)"""
+    print("Installing dependencies...")
     try:
-        # 优先尝试使用uv
+        # Try using uv first
         try:
             subprocess.check_call(["uv", "sync"])
-            print("✓ 使用uv安装依赖完成")
+            print("✓ Dependencies installed using uv")
             return True
         except (subprocess.CalledProcessError, FileNotFoundError):
-            # 回退到pip
+            # Fall back to pip
             subprocess.check_call(
                 [sys.executable, "-m", "pip", "install", "-r", "requirements.txt"]
             )
-            print("✓ 使用pip安装依赖完成")
+            print("✓ Dependencies installed using pip")
             return True
     except subprocess.CalledProcessError:
-        print("✗ 依赖安装失败")
-        print("请手动运行: uv sync 或 pip install -r requirements.txt")
+        print("✗ Failed to install dependencies")
+        print("Please run manually: uv sync or pip install -r requirements.txt")
         return False
 
 
 def main():
-    """主函数"""
+    """Main function"""
     import argparse
 
-    # 解析命令行参数
+    # Parse command line arguments
     parser = argparse.ArgumentParser(description="Trace Analysis Web Demo")
     parser.add_argument(
-        "-p", "--port", type=int, default=5000, help="指定端口号 (默认: 5000)"
+        "-p", "--port", type=int, default=5000, help="Specify port number (default: 5000)"
     )
     args = parser.parse_args()
 
     print("=" * 50)
     print("Trace Analysis Web Demo")
     print("=" * 50)
 
-    # 检查依赖
+    # Check dependencies
     if not check_dependencies():
-        print("\n正在安装依赖...")
+        print("\nInstalling dependencies...")
         if not install_dependencies():
-            print("请手动安装依赖: pip install -r requirements.txt")
+            print("Please install dependencies manually: pip install -r requirements.txt")
             return
 
-    # 检查JSON文件
+    # Check JSON files
     parent_dir = os.path.dirname(os.path.abspath(__file__))
     json_files = [
         f for f in os.listdir(os.path.join(parent_dir, "..")) if f.endswith(".json")
     ]
 
     if not json_files:
-        print("\n警告: 在上级目录中没有找到JSON文件")
-        print("请确保有trace JSON文件在 trace_analyze/ 目录中")
+        print("\nWarning: No JSON files found in parent directory")
+        print("Please ensure there are trace JSON files in the trace_analyze/ directory")
     else:
-        print(f"\n找到 {len(json_files)} 个JSON文件:")
-        for file in json_files[:5]:  # 只显示前5个
+        print(f"\nFound {len(json_files)} JSON files:")
+        for file in json_files[:5]:  # Show only first 5
             print(f"  - {file}")
         if len(json_files) > 5:
-            print(f"  ... 和其他 {len(json_files) - 5} 个文件")
+            print(f"  ... and {len(json_files) - 5} other files")
 
-    # 启动应用
-    print("\n正在启动Web应用...")
-    print(f"应用将在 http://localhost:{args.port} 运行")
-    print("按 Ctrl+C 停止应用")
+    # Start application
+    print("\nStarting web application...")
+    print(f"Application will run at http://localhost:{args.port}")
+    print("Press Ctrl+C to stop the application")
     print("=" * 50)
 
     try:
         from app import app
 
         app.run(debug=True, host="0.0.0.0", port=args.port)
     except KeyboardInterrupt:
-        print("\n应用已停止")
+        print("\nApplication stopped")
     except Exception as e:
-        print(f"\n启动应用失败: {e}")
+        print(f"\nFailed to start application: {e}")
 
 
 if __name__ == "__main__":