je-editor 0.0.222__py3-none-any.whl → 0.0.224__py3-none-any.whl

je_editor/pyside_ui/main_ui/menu/run_menu/under_run_menu/build_shell_menu.py

@@ -1,32 +1,62 @@
+# 匯入未來功能，允許延遲型別註解 (Python 3.7+ 常用)
+# Import future feature: postponed evaluation of type annotations
 from __future__ import annotations
 
+# 僅用於型別檢查，避免循環匯入
+# For type checking only (avoids circular imports)
 from typing import TYPE_CHECKING
 
+# 匯入編輯器元件與輸入處理
+# Import EditorWidget and ProcessInput
 from je_editor.pyside_ui.main_ui.editor.editor_widget import EditorWidget
 from je_editor.pyside_ui.main_ui.editor.process_input import ProcessInput
+
+# 匯入工具函式：顯示「請先關閉目前執行中的程式」訊息框
+# Import utility: show message box if a program is already running
 from je_editor.pyside_ui.main_ui.menu.run_menu.under_run_menu.utils import please_close_current_running_messagebox
+
+# 匯入日誌紀錄器
+# Import logger instance
 from je_editor.utils.logging.loggin_instance import jeditor_logger
 
+# 僅在型別檢查時匯入 EditorMain，避免循環依賴
+# Import EditorMain only for type checking (avoids circular dependency)
 if TYPE_CHECKING:
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+
+# 匯入 Qt 動作
+# Import QAction
 from PySide6.QtGui import QAction
 
+# 匯入 ShellManager，用於執行系統命令
+# Import ShellManager for executing shell commands
 from je_editor.pyside_ui.code.shell_process.shell_exec import ShellManager
+
+# 匯入多語言包裝器
+# Import multi-language wrapper for UI localization
 from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
 
 
+# 設定 Shell 選單
+# Set up the Shell menu
 def set_shell_menu(ui_we_want_to_set: EditorMain) -> None:
     jeditor_logger.info(f"build_shell_menu.py set_shell_menu ui_we_want_to_set: {ui_we_want_to_set}")
+    # 在 Run 選單下建立 Shell 子選單
+    # Create Shell submenu under Run menu
     ui_we_want_to_set.run_shell_menu = ui_we_want_to_set.run_menu.addMenu(
         language_wrapper.language_word_dict.get("run_menu_run_on_shell_label"))
-    # Run on shell
+
+    # 建立「在 Shell 執行」動作
+    # Add "Run on Shell" action
     ui_we_want_to_set.run_shell_menu.run_on_shell_action = QAction(
         language_wrapper.language_word_dict.get("run_menu_run_on_shell_label"))
     ui_we_want_to_set.run_shell_menu.run_on_shell_action.triggered.connect(
         lambda: shell_exec(ui_we_want_to_set)
     )
     ui_we_want_to_set.run_shell_menu.addAction(ui_we_want_to_set.run_shell_menu.run_on_shell_action)
-    # Show shell input
+
+    # 建立「顯示 Shell 輸入」動作
+    # Add "Show Shell Input" action
     ui_we_want_to_set.run_shell_menu.show_shell_input = QAction(
         language_wrapper.language_word_dict.get("show_shell_input"))
     ui_we_want_to_set.run_shell_menu.show_shell_input.triggered.connect(
@@ -35,26 +65,36 @@ def set_shell_menu(ui_we_want_to_set: EditorMain) -> None:
     ui_we_want_to_set.run_shell_menu.addAction(ui_we_want_to_set.run_shell_menu.show_shell_input)
 
 
+# 在 Shell 中執行程式碼
+# Execute code in Shell
 def shell_exec(ui_we_want_to_set: EditorMain) -> None:
     jeditor_logger.info(f"build_shell_menu.py shell_exec ui_we_want_to_set: {ui_we_want_to_set}")
     widget = ui_we_want_to_set.tab_widget.currentWidget()
     if isinstance(widget, EditorWidget):
+        # 確保沒有正在執行的 Shell 程式
+        # Ensure no shell process is already running
         if widget.exec_shell is None:
+            # 建立 ShellManager 並執行當前編輯器中的程式碼
+            # Create ShellManager and execute current editor code
             shell_command = ShellManager(
                 main_window=widget,
                 shell_encoding=ui_we_want_to_set.encoding)
             shell_command.later_init()
             shell_command.exec_shell(
-                widget.code_edit.toPlainText()
+                widget.code_edit.toPlainText()  # 直接執行編輯器中的文字
             )
             widget.exec_shell = shell_command
         else:
+            # 如果已有 Shell 在執行，顯示提示訊息
+            # If a shell process is already running, show message
             please_close_current_running_messagebox(ui_we_want_to_set)
 
 
+# 顯示 Shell 輸入介面
+# Show Shell input interface
 def show_shell_input(ui_we_want_to_set: EditorMain) -> None:
     jeditor_logger.info(f"build_shell_menu.py show_shell_input ui_we_want_to_set: {ui_we_want_to_set}")
     widget = ui_we_want_to_set.tab_widget.currentWidget()
     if isinstance(widget, EditorWidget):
         widget.shell_input = ProcessInput(widget, "shell")
-        widget.shell_input.show()
+        widget.shell_input.show()

je_editor/pyside_ui/main_ui/menu/run_menu/under_run_menu/utils.py

@@ -2,19 +2,41 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+# 匯入 Qt 訊息框
+# Import QMessageBox for showing message dialogs
 from PySide6.QtWidgets import QMessageBox
 
+# 匯入日誌紀錄器
+# Import logger instance
 from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+# 匯入多語言包裝器，用於多語言顯示
+# Import multi-language wrapper for UI localization
 from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
 
+# 僅在型別檢查時匯入 EditorMain，避免循環依賴
+# Import EditorMain only for type checking (avoids circular dependency)
 if TYPE_CHECKING:
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
 
 
+# 顯示「請先關閉目前執行中的程式」訊息框
+# Show a message box: "Please stop the currently running program first"
 def please_close_current_running_messagebox(ui_we_want_to_set: EditorMain):
+    # 紀錄日誌，方便除錯
+    # Log info for debugging
     jeditor_logger.info(f"utils.py please_close_current_running_messagebox ui_we_want_to_set: {ui_we_want_to_set}")
+
+    # 建立訊息框，父視窗為主編輯器
+    # Create a message box with the main editor as parent
     please_stop_current_running_program_messagebox = QMessageBox(ui_we_want_to_set)
+
+    # 設定訊息框文字，從多語言字典取得對應語言的提示
+    # Set message text, retrieved from multi-language dictionary
     please_stop_current_running_program_messagebox.setText(
         language_wrapper.language_word_dict.get("please_stop_current_running_program")
     )
-    please_stop_current_running_program_messagebox.show()
+
+    # 顯示訊息框
+    # Show the message box
+    please_stop_current_running_program_messagebox.show()

je_editor/pyside_ui/main_ui/menu/set_menu_bar.py

@@ -1,7 +1,13 @@
 from __future__ import annotations
+# 啟用未來註解功能，允許型別提示使用字串前向參照
+# Enable future annotations, allowing forward references in type hints
 
 from typing import TYPE_CHECKING
+# TYPE_CHECKING 用於避免在執行時載入不必要的模組
+# TYPE_CHECKING prevents unnecessary imports at runtime
 
+# 匯入各種子選單的建構函式
+# Import functions to build different sub-menus
 from je_editor.pyside_ui.main_ui.menu.dock_menu.build_dock_menu import set_dock_menu
 from je_editor.pyside_ui.main_ui.menu.language_menu.build_language_server import set_language_menu
 from je_editor.pyside_ui.main_ui.menu.style_menu.build_style_menu import set_style_menu
@@ -11,8 +17,15 @@ from je_editor.utils.logging.loggin_instance import jeditor_logger
 
 if TYPE_CHECKING:
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+    # 僅在型別檢查時匯入 EditorMain，避免循環依賴
+    # Import EditorMain only for type checking
+
 from PySide6.QtWidgets import QMenuBar
+# 匯入 QMenuBar，用於建立選單列
+# Import QMenuBar to create the menu bar
 
+# 其他子選單建構函式
+# Other sub-menu builders
 from je_editor.pyside_ui.main_ui.menu.check_style_menu.build_check_style_menu import set_check_menu
 from je_editor.pyside_ui.main_ui.menu.file_menu.build_file_menu import set_file_menu
 from je_editor.pyside_ui.main_ui.menu.help_menu.build_help_menu import set_help_menu
@@ -21,17 +34,29 @@ from je_editor.pyside_ui.main_ui.menu.python_env_menu.build_venv_menu import set
 
 
 def set_menu_bar(ui_we_want_to_set: EditorMain) -> None:
+    """
+    建立主選單列，並依序加入各種子選單
+    Build the main menu bar and add all sub-menus in order
+    """
     jeditor_logger.info(f"set_menu_bar.py set_menu_bar ui_we_want_to_set: {ui_we_want_to_set}")
-    # set menu
+
+    # 建立一個新的選單列
+    # Create a new menu bar
     ui_we_want_to_set.menu = QMenuBar()
-    set_file_menu(ui_we_want_to_set)
-    set_run_menu(ui_we_want_to_set)
-    set_text_menu(ui_we_want_to_set)
-    set_check_menu(ui_we_want_to_set)
-    set_help_menu(ui_we_want_to_set)
-    set_venv_menu(ui_we_want_to_set)
-    set_tab_menu(ui_we_want_to_set)
-    set_dock_menu(ui_we_want_to_set)
-    set_style_menu(ui_we_want_to_set)
-    set_language_menu(ui_we_want_to_set)
-    ui_we_want_to_set.setMenuBar(ui_we_want_to_set.menu)
+
+    # === 加入各種子選單 ===
+    # === Add different sub-menus ===
+    set_file_menu(ui_we_want_to_set)       # 檔案選單 / File menu
+    set_run_menu(ui_we_want_to_set)        # 執行選單 / Run menu
+    set_text_menu(ui_we_want_to_set)       # 文字設定選單 / Text menu
+    set_check_menu(ui_we_want_to_set)      # 程式碼檢查選單 / Code style check menu
+    set_help_menu(ui_we_want_to_set)       # 幫助選單 / Help menu
+    set_venv_menu(ui_we_want_to_set)       # Python 虛擬環境選單 / Python venv menu
+    set_tab_menu(ui_we_want_to_set)        # 分頁選單 / Tab menu
+    set_dock_menu(ui_we_want_to_set)       # Dock 視窗選單 / Dock menu
+    set_style_menu(ui_we_want_to_set)      # 介面樣式選單 / Style menu
+    set_language_menu(ui_we_want_to_set)   # 語言選單 / Language menu
+
+    # 將選單列設定到主視窗
+    # Attach the menu bar to the main editor window
+    ui_we_want_to_set.setMenuBar(ui_we_want_to_set.menu)

je_editor/pyside_ui/main_ui/menu/style_menu/build_style_menu.py

@@ -2,36 +2,73 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+# 匯入 Qt 動作
+# Import QAction
 from PySide6.QtGui import QAction
 
+# 匯入使用者設定字典，用來保存 UI 樣式設定
+# Import user settings dictionary for saving UI style preferences
 from je_editor.pyside_ui.main_ui.save_settings.user_setting_file import user_setting_dict
+
+# 匯入日誌紀錄器
+# Import logger instance
 from je_editor.utils.logging.loggin_instance import jeditor_logger
 
 if TYPE_CHECKING:
+    # 僅在型別檢查時匯入 EditorMain，避免循環依賴
+    # Import EditorMain only for type checking (avoids circular dependency)
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
 
+# 匯入多語言包裝器，用於 UI 多語言顯示
+# Import multi-language wrapper for UI localization
 from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
 
 
+# 設定 Style 選單
+# Set up the Style menu
 def set_style_menu(ui_we_want_to_set: EditorMain) -> None:
     jeditor_logger.info(f"build_style_menu.py set_style_menu ui_we_want_to_set: {ui_we_want_to_set}")
+
+    # 在主選單中新增「Style」子選單
+    # Add "Style" submenu under the main menu
     ui_we_want_to_set.menu.style_menu = ui_we_want_to_set.menu.addMenu(
         language_wrapper.language_word_dict.get("style_menu_label")
     )
-    for style in ['dark_amber.xml', 'dark_blue.xml', 'dark_cyan.xml', 'dark_lightgreen.xml',
-                  'dark_pink.xml', 'dark_purple.xml', 'dark_red.xml', 'dark_teal.xml',
-                  'dark_yellow.xml', 'light_amber.xml', 'light_blue.xml', 'light_cyan.xml',
-                  'light_cyan_500.xml', 'light_lightgreen.xml', 'light_pink.xml', 'light_purple.xml'
-                  ]:
+
+    # 預設提供的樣式清單 (深色/淺色不同配色)
+    # Predefined style list (dark/light themes with different colors)
+    for style in [
+        'dark_amber.xml', 'dark_blue.xml', 'dark_cyan.xml', 'dark_lightgreen.xml',
+        'dark_pink.xml', 'dark_purple.xml', 'dark_red.xml', 'dark_teal.xml',
+        'dark_yellow.xml', 'light_amber.xml', 'light_blue.xml', 'light_cyan.xml',
+        'light_cyan_500.xml', 'light_lightgreen.xml', 'light_pink.xml', 'light_purple.xml'
+    ]:
+        # 建立一個 QAction，名稱為樣式檔名
+        # Create an QAction with the style filename as label
         change_style_action = QAction(style, parent=ui_we_want_to_set.menu.style_menu)
+
+        # 綁定觸發事件，呼叫 set_style 來套用樣式
+        # Connect action to set_style function
         change_style_action.triggered.connect(
-            lambda checked=False, action=change_style_action: set_style(ui_we_want_to_set, action))
+            lambda checked=False, action=change_style_action: set_style(ui_we_want_to_set, action)
+        )
+
+        # 將動作加入 Style 選單
+        # Add action to the Style menu
         ui_we_want_to_set.menu.style_menu.addAction(change_style_action)
 
 
+# 套用選擇的樣式
+# Apply the selected style
 def set_style(ui_we_want_to_set: EditorMain, action: QAction) -> None:
     jeditor_logger.info("build_style_menu.py set_style "
                         f"ui_we_want_to_set: {ui_we_want_to_set} "
                         f"action: {action}")
+
+    # 呼叫主視窗的 apply_stylesheet 方法，套用選擇的樣式
+    # Call main window's apply_stylesheet method to apply the chosen style
     ui_we_want_to_set.apply_stylesheet(ui_we_want_to_set, action.text())
-    user_setting_dict.update({"ui_style": action.text()})
+
+    # 更新使用者設定，保存目前選擇的樣式
+    # Update user settings dictionary to persist the chosen style
+    user_setting_dict.update({"ui_style": action.text()})

je_editor/pyside_ui/main_ui/menu/tab_menu/build_tab_menu.py

@@ -4,9 +4,11 @@ from typing import TYPE_CHECKING
 
 from frontengine import FrontEngineMainUI
 
-from je_editor.pyside_ui.git_ui.code_diff_compare.code_diff_viewer_widget import DiffViewerWidget
-from je_editor.pyside_ui.browser.browser_widget import BrowserWidget
+from je_editor.pyside_ui.browser.main_browser_widget import MainBrowserWidget
 from je_editor.pyside_ui.code.variable_inspector.inspector_gui import VariableInspector
+# 匯入各種 UI 元件 (編輯器、瀏覽器、Git、變數檢查器、聊天、控制台、IPython、程式碼比對)
+# Import various UI components (editor, browser, Git, variable inspector, chat, console, IPython, code diff)
+from je_editor.pyside_ui.git_ui.code_diff_compare.code_diff_viewer_widget import DiffViewerWidget
 from je_editor.pyside_ui.git_ui.git_client.git_branch_tree_widget import GitTreeViewGUI
 from je_editor.pyside_ui.git_ui.git_client.git_client_gui import GitGui
 from je_editor.pyside_ui.main_ui.ai_widget.chat_ui import ChatUI
@@ -15,88 +17,127 @@ from je_editor.pyside_ui.main_ui.editor.editor_widget import EditorWidget
 from je_editor.pyside_ui.main_ui.ipython_widget.rich_jupyter import IpythonWidget
 from je_editor.utils.logging.loggin_instance import jeditor_logger
 
+# 啟用未來的註解功能，允許在型別提示中使用字串形式的前向參照
+# Enable future annotations, allowing forward references in type hints
+# TYPE_CHECKING 用於避免在型別檢查時引入不必要的模組
+# TYPE_CHECKING is used to avoid unnecessary imports during type checking
+# 匯入 FrontEngine 主 UI
+# Import the FrontEngine main UI
+# 匯入日誌工具，用於記錄操作
+# Import logger for recording operations
+
 if TYPE_CHECKING:
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+    # 僅在型別檢查時匯入 EditorMain，避免循環依賴
+    # Import EditorMain only for type checking to avoid circular imports
+
 from PySide6.QtGui import QAction
+# 匯入 QAction，用於建立選單動作
+# Import QAction for creating menu actions
+
 from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
 
 
+# 匯入多語言包裝器，用於支援多語系 UI
+# Import language wrapper for multilingual UI support
+
+
 def set_tab_menu(ui_we_want_to_set: EditorMain) -> None:
+    """
+    設定主編輯器的分頁選單
+    Set up the tab menu for the main editor
+    """
     jeditor_logger.info(f"build_tab_menu.py set_tab_menu ui_we_want_to_set:{ui_we_want_to_set}")
-    # Editor
+
+    # 建立 Tab 選單 (主容器)
+    # Create the Tab menu (main container)
     ui_we_want_to_set.tab_menu = ui_we_want_to_set.menu.addMenu(
         language_wrapper.language_word_dict.get("tab_menu_label")
     )
+
+    # === Editor 分頁 ===
+    # === Editor Tab ===
     ui_we_want_to_set.tab_menu.add_editor_action = QAction(
         language_wrapper.language_word_dict.get("tab_menu_add_editor_label"))
     ui_we_want_to_set.tab_menu.add_editor_action.triggered.connect(
         lambda: add_editor_tab(ui_we_want_to_set)
     )
-    # Front Engine
     ui_we_want_to_set.tab_menu.addAction(ui_we_want_to_set.tab_menu.add_editor_action)
+
+    # === Front Engine 分頁 ===
+    # === Front Engine Tab ===
     ui_we_want_to_set.tab_menu.add_frontengine_action = QAction(
         language_wrapper.language_word_dict.get("tab_menu_add_frontengine_label"))
     ui_we_want_to_set.tab_menu.add_frontengine_action.triggered.connect(
         lambda: add_frontengine_tab(ui_we_want_to_set)
     )
-    # Web
     ui_we_want_to_set.tab_menu.addAction(ui_we_want_to_set.tab_menu.add_frontengine_action)
+
+    # === Web 瀏覽器分頁 ===
+    # === Web Browser Tab ===
     ui_we_want_to_set.tab_menu.add_web_action = QAction(
         language_wrapper.language_word_dict.get("tab_menu_add_web_label"))
     ui_we_want_to_set.tab_menu.add_web_action.triggered.connect(
         lambda: add_web_tab(ui_we_want_to_set)
     )
     ui_we_want_to_set.tab_menu.addAction(ui_we_want_to_set.tab_menu.add_web_action)
-    # Stackoverflow
-    ui_we_want_to_set.tab_menu.add_stackoverflow_action = QAction(
-        language_wrapper.language_word_dict.get("tab_menu_add_stackoverflow_label"))
-    ui_we_want_to_set.tab_menu.add_stackoverflow_action.triggered.connect(
-        lambda: add_stackoverflow_tab(ui_we_want_to_set)
-    )
-    ui_we_want_to_set.tab_menu.addAction(ui_we_want_to_set.tab_menu.add_stackoverflow_action)
-    # IPython
+
+    # === IPython 分頁 ===
+    # === IPython Tab ===
     ui_we_want_to_set.tab_menu.add_ipython_action = QAction(
         language_wrapper.language_word_dict.get("tab_menu_ipython_tab_name"))
     ui_we_want_to_set.tab_menu.add_ipython_action.triggered.connect(
         lambda: add_ipython_tab(ui_we_want_to_set)
     )
     ui_we_want_to_set.tab_menu.addAction(ui_we_want_to_set.tab_menu.add_ipython_action)
-    # ChatUI
+
+    # === Chat UI 分頁 ===
+    # === Chat UI Tab ===
     ui_we_want_to_set.tab_menu.add_chat_ui_action = QAction(
         language_wrapper.language_word_dict.get("tab_menu_chat_ui_tab_name"))
     ui_we_want_to_set.tab_menu.add_chat_ui_action.triggered.connect(
         lambda: add_chat_ui_tab(ui_we_want_to_set)
     )
     ui_we_want_to_set.tab_menu.addAction(ui_we_want_to_set.tab_menu.add_chat_ui_action)
-    # Git Client
+
+    # === Git Client 分頁 ===
+    # === Git Client Tab ===
     ui_we_want_to_set.tab_menu.add_git_client_ui_action = QAction(
         language_wrapper.language_word_dict.get("tab_menu_git_client_tab_name"))
     ui_we_want_to_set.tab_menu.add_git_client_ui_action.triggered.connect(
         lambda: add_git_client_tab(ui_we_want_to_set)
     )
     ui_we_want_to_set.tab_menu.addAction(ui_we_want_to_set.tab_menu.add_git_client_ui_action)
-    # Git Branch tree
+
+    # === Git Branch Tree 分頁 ===
+    # === Git Branch Tree Tab ===
     ui_we_want_to_set.tab_menu.add_git_branch_view_ui_action = QAction(
         language_wrapper.language_word_dict.get("tab_menu_git_branch_tree_view_tab_name"))
     ui_we_want_to_set.tab_menu.add_git_branch_view_ui_action.triggered.connect(
         lambda: add_git_tree_view_tab(ui_we_want_to_set)
     )
     ui_we_want_to_set.tab_menu.addAction(ui_we_want_to_set.tab_menu.add_git_branch_view_ui_action)
-    # Variable Inspector
+
+    # === Variable Inspector 分頁 ===
+    # === Variable Inspector Tab ===
     ui_we_want_to_set.tab_menu.add_variable_inspector_ui_action = QAction(
         language_wrapper.language_word_dict.get("tab_menu_variable_inspector_tab_name"))
     ui_we_want_to_set.tab_menu.add_variable_inspector_ui_action.triggered.connect(
         lambda: add_variable_inspector_tab(ui_we_want_to_set)
     )
     ui_we_want_to_set.tab_menu.addAction(ui_we_want_to_set.tab_menu.add_variable_inspector_ui_action)
-    # Dynamic Console
+
+    # === Console 分頁 ===
+    # === Console Tab ===
     ui_we_want_to_set.tab_menu.add_console_widget_ui_action = QAction(
         language_wrapper.language_word_dict.get("tab_menu_console_widget_tab_name"))
     ui_we_want_to_set.tab_menu.add_console_widget_ui_action.triggered.connect(
         lambda: add_console_widget_tab(ui_we_want_to_set)
     )
     ui_we_want_to_set.tab_menu.addAction(ui_we_want_to_set.tab_menu.add_console_widget_ui_action)
-    # Code diff viewer
+
+    # === Code Diff Viewer 分頁 ===
+    # === Code Diff Viewer Tab ===
     ui_we_want_to_set.tab_menu.add_code_diff_viewer_ui_action = QAction(
         language_wrapper.language_word_dict.get("tab_code_diff_viewer_tab_name"))
     ui_we_want_to_set.tab_menu.add_code_diff_viewer_ui_action.triggered.connect(
@@ -104,7 +145,13 @@ def set_tab_menu(ui_we_want_to_set: EditorMain) -> None:
     )
     ui_we_want_to_set.tab_menu.addAction(ui_we_want_to_set.tab_menu.add_code_diff_viewer_ui_action)
 
+
+# === 以下為各分頁新增函式 ===
+# === Functions to add each tab ===
+
 def add_editor_tab(ui_we_want_to_set: EditorMain):
+    # 新增 Editor 分頁
+    # Add Editor tab
     jeditor_logger.info(f"build_tab_menu.py add editor tab ui_we_want_to_set: {ui_we_want_to_set}")
     widget = EditorWidget(ui_we_want_to_set)
     ui_we_want_to_set.tab_widget.addTab(
@@ -115,77 +162,113 @@ def add_editor_tab(ui_we_want_to_set: EditorMain):
 
 
 def add_frontengine_tab(ui_we_want_to_set: EditorMain):
+    # 新增 FrontEngine 分頁
+    # Add FrontEngine tab
     jeditor_logger.info(f"build_tab_menu.py add frontengine tab ui_we_want_to_set: {ui_we_want_to_set}")
     ui_we_want_to_set.tab_widget.addTab(
         FrontEngineMainUI(show_system_tray_ray=False, redirect_output=False),
         f"{language_wrapper.language_word_dict.get('tab_menu_frontengine_tab_name')} "
         f"{ui_we_want_to_set.tab_widget.count()}")
 
-
 def add_web_tab(ui_we_want_to_set: EditorMain):
+    # 紀錄日誌：新增 Web 分頁
+    # Log: add a Web tab
     jeditor_logger.info(f"build_tab_menu.py add web tab ui_we_want_to_set: {ui_we_want_to_set}")
+    # 在主編輯器的 tab_widget 中新增一個瀏覽器分頁
+    # Add a browser tab into the main editor's tab_widget
     ui_we_want_to_set.tab_widget.addTab(
-        BrowserWidget(),
+        MainBrowserWidget(),  # 建立瀏覽器元件 / Create browser widget
         f"{language_wrapper.language_word_dict.get('tab_menu_web_tab_name')} "
-        f"{ui_we_want_to_set.tab_widget.count()}")
-
-
-def add_stackoverflow_tab(ui_we_want_to_set: EditorMain):
-    jeditor_logger.info(f"build_tab_menu.py add stackoverflow tab ui_we_want_to_set: {ui_we_want_to_set}")
-    ui_we_want_to_set.tab_widget.addTab(
-        BrowserWidget(start_url="https://stackoverflow.com/", search_prefix="https://stackoverflow.com/search?q="),
-        f"{language_wrapper.language_word_dict.get('tab_menu_stackoverflow_tab_name')} "
-        f"{ui_we_want_to_set.tab_widget.count()}")
+        f"{ui_we_want_to_set.tab_widget.count()}"  # 分頁名稱包含序號 / Tab name with index
+    )
 
 
 def add_ipython_tab(ui_we_want_to_set: EditorMain):
+    # 紀錄日誌：新增 IPython 分頁
+    # Log: add an IPython tab
     jeditor_logger.info(f"build_tab_menu.py add ipython tab ui_we_want_to_set: {ui_we_want_to_set}")
+    # 在主編輯器中新增 IPython 互動式分頁
+    # Add an IPython interactive tab
     ui_we_want_to_set.tab_widget.addTab(
-        IpythonWidget(ui_we_want_to_set),
+        IpythonWidget(ui_we_want_to_set),  # 建立 IPython 元件 / Create IPython widget
         f"{language_wrapper.language_word_dict.get('tab_menu_ipython_tab_name')} "
-        f"{ui_we_want_to_set.tab_widget.count()}")
+        f"{ui_we_want_to_set.tab_widget.count()}"
+    )
 
 
 def add_chat_ui_tab(ui_we_want_to_set: EditorMain):
+    # 紀錄日誌：新增 Chat UI 分頁
+    # Log: add a Chat UI tab
     jeditor_logger.info(f"build_tab_menu.py add chat_ui tab ui_we_want_to_set: {ui_we_want_to_set}")
+    # 在主編輯器中新增聊天分頁
+    # Add a chat tab into the main editor
     ui_we_want_to_set.tab_widget.addTab(
-        ChatUI(ui_we_want_to_set),
+        ChatUI(ui_we_want_to_set),  # 建立聊天元件 / Create Chat UI widget
         f"{language_wrapper.language_word_dict.get('tab_menu_chat_ui_tab_name')} "
-        f"{ui_we_want_to_set.tab_widget.count()}")
+        f"{ui_we_want_to_set.tab_widget.count()}"
+    )
 
 
 def add_git_client_tab(ui_we_want_to_set: EditorMain):
+    # 紀錄日誌：新增 Git Client 分頁
+    # Log: add a Git Client tab
     jeditor_logger.info(f"build_tab_menu.py add git client tab ui_we_want_to_set: {ui_we_want_to_set}")
+    # 在主編輯器中新增 Git 客戶端分頁
+    # Add a Git client tab
     ui_we_want_to_set.tab_widget.addTab(
-        GitGui(),
+        GitGui(),  # 建立 Git GUI 元件 / Create Git GUI widget
         f"{language_wrapper.language_word_dict.get('tab_menu_git_client_tab_name')} "
-        f"{ui_we_want_to_set.tab_widget.count()}")
+        f"{ui_we_want_to_set.tab_widget.count()}"
+    )
+
 
 def add_git_tree_view_tab(ui_we_want_to_set: EditorMain):
+    # 紀錄日誌：新增 Git Branch Tree 分頁
+    # Log: add a Git Branch Tree tab
     jeditor_logger.info(f"build_tab_menu.py add git tree view tab ui_we_want_to_set: {ui_we_want_to_set}")
+    # 在主編輯器中新增 Git 分支樹狀圖分頁
+    # Add a Git branch tree view tab
     ui_we_want_to_set.tab_widget.addTab(
-        GitTreeViewGUI(),
+        GitTreeViewGUI(),  # 建立 Git Tree View 元件 / Create Git Tree View widget
         f"{language_wrapper.language_word_dict.get('tab_menu_git_branch_tree_view_tab_name')} "
-        f"{ui_we_want_to_set.tab_widget.count()}")
+        f"{ui_we_want_to_set.tab_widget.count()}"
+    )
+
 
 def add_variable_inspector_tab(ui_we_want_to_set: EditorMain):
+    # 紀錄日誌：新增 Variable Inspector 分頁
+    # Log: add a Variable Inspector tab
     jeditor_logger.info(f"build_tab_menu.py add variable inspector tab ui_we_want_to_set: {ui_we_want_to_set}")
+    # 在主編輯器中新增變數檢查器分頁
+    # Add a variable inspector tab
     ui_we_want_to_set.tab_widget.addTab(
-        VariableInspector(),
+        VariableInspector(),  # 建立變數檢查器元件 / Create Variable Inspector widget
         f"{language_wrapper.language_word_dict.get('tab_menu_variable_inspector_tab_name')} "
-        f"{ui_we_want_to_set.tab_widget.count()}")
+        f"{ui_we_want_to_set.tab_widget.count()}"
+    )
 
 
 def add_console_widget_tab(ui_we_want_to_set: EditorMain):
+    # 紀錄日誌：新增 Console 分頁
+    # Log: add a Console tab
     jeditor_logger.info(f"build_tab_menu.py add console widget tab ui_we_want_to_set: {ui_we_want_to_set}")
+    # 在主編輯器中新增動態控制台分頁
+    # Add a dynamic console tab
     ui_we_want_to_set.tab_widget.addTab(
-        ConsoleWidget(),
+        ConsoleWidget(),  # 建立控制台元件 / Create Console widget
         f"{language_wrapper.language_word_dict.get('tab_menu_console_widget_tab_name')} "
-        f"{ui_we_want_to_set.tab_widget.count()}")
+        f"{ui_we_want_to_set.tab_widget.count()}"
+    )
+
 
 def add_code_diff_compare_tab(ui_we_want_to_set: EditorMain):
+    # 紀錄日誌：新增 Code Diff Compare 分頁
+    # Log: add a Code Diff Compare tab
     jeditor_logger.info(f"build_tab_menu.py add code diff compare tab ui_we_want_to_set: {ui_we_want_to_set}")
+    # 在主編輯器中新增程式碼差異比較分頁
+    # Add a code diff comparison tab
     ui_we_want_to_set.tab_widget.addTab(
-        DiffViewerWidget(),
+        DiffViewerWidget(),  # 建立程式碼比對元件 / Create Code Diff Viewer widget
         f"{language_wrapper.language_word_dict.get('tab_code_diff_viewer_tab_name')} "
-        f"{ui_we_want_to_set.tab_widget.count()}")
+        f"{ui_we_want_to_set.tab_widget.count()}"
+    )