je-editor 0.0.202__py3-none-any.whl → 0.0.228__py3-none-any.whl

je_editor/pyside_ui/code/variable_inspector/inspector_gui.py

@@ -0,0 +1,172 @@
+import ast
+
+from PySide6.QtCore import QAbstractTableModel, Qt, QTimer, QSortFilterProxyModel
+from PySide6.QtWidgets import QTableView, QVBoxLayout, QWidget, QLineEdit, QLabel
+
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+
+class VariableModel(QAbstractTableModel):
+    """
+    變數模型：負責管理與顯示 Python 全域變數
+    Variable model: manages and displays Python global variables
+    """
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self.variables = []  # 儲存變數資訊 [名稱, 型別, 值字串, 真實值]
+        # Store variable info [name, type, repr(value), actual value]
+
+    def update_data(self):
+        """
+        更新變數清單，從全域變數中擷取
+        Update variable list from globals()
+        """
+        parent_widget = self.parent()
+        # 避免在 table 正在互動時更新，造成衝突
+        # Avoid updating while table is in active state
+        if parent_widget and getattr(parent_widget, "table", None):
+            if parent_widget.table.state() != QTableView.State.NoState:
+                return
+
+        vars_dict = globals()
+        self.beginResetModel()
+        self.variables = [
+            [name, type(value).__name__, repr(value), value]
+            for name, value in vars_dict.items()
+            if not name.startswith("__")  # 過濾內建變數 / filter out built-in variables
+        ]
+        self.endResetModel()
+
+    def rowCount(self, parent=None):
+        # 回傳變數數量 / return number of variables
+        return len(self.variables)
+
+    def columnCount(self, parent=None):
+        # 固定三欄：名稱、型別、值 / fixed 3 columns: name, type, value
+        return 3
+
+    def data(self, index, role=Qt.ItemDataRole.DisplayRole):
+        # 提供表格顯示的資料
+        # Provide data for table display
+        if not index.isValid() or not (0 <= index.row() < len(self.variables)):
+            return None
+        if role == Qt.ItemDataRole.DisplayRole:
+            return self.variables[index.row()][index.column()]
+        return None
+
+    def headerData(self, section, orientation, role=Qt.ItemDataRole.DisplayRole):
+        # 設定表頭文字 (支援多語系)
+        # Set header labels (multi-language support)
+        if role == Qt.ItemDataRole.DisplayRole and orientation == Qt.Orientation.Horizontal:
+            return [
+                language_wrapper.language_word_dict.get("variable_inspector_var_name"),
+                language_wrapper.language_word_dict.get("variable_inspector_var_type"),
+                language_wrapper.language_word_dict.get("variable_inspector_var_value")
+            ][section]
+        return None
+
+    def flags(self, index):
+        # 設定欄位屬性，僅允許「值」欄可編輯
+        # Set column flags, only "value" column is editable
+        if not index.isValid() or not (0 <= index.row() < len(self.variables)):
+            return Qt.ItemFlag.NoItemFlags
+        base = super().flags(index)
+        if index.column() == 2:  # 只允許編輯值欄 / only value column editable
+            base |= Qt.ItemFlag.ItemIsEditable
+        return base
+
+    def setData(self, index, value, role=Qt.ItemDataRole.EditRole):
+        """
+        更新變數值，並同步到全域變數
+        Update variable value and sync to globals()
+        """
+        if role == Qt.ItemDataRole.EditRole and index.column() == 2:
+
+            if value == "":
+                return False
+
+            old_repr = self.variables[index.row()][2]
+            if str(value) == old_repr:
+                return False
+
+            var_name = self.variables[index.row()][0]
+            try:
+                # 嘗試將輸入轉換為 Python 物件
+                # Try to evaluate input as Python object
+                new_value = ast.literal_eval(value)
+            except Exception:
+                # 若失敗則當作字串處理
+                # If failed, treat as string
+                new_value = value
+
+            if new_value == self.variables[index.row()][3]:
+                return False
+
+            # 更新全域變數與模型資料
+            # Update globals and model data
+            globals()[var_name] = new_value
+            self.variables[index.row()][2] = repr(new_value)
+            self.variables[index.row()][3] = new_value
+            self.dataChanged.emit(index, index, [Qt.ItemDataRole.DisplayRole])
+            return True
+        return False
+
+
+class VariableProxy(QSortFilterProxyModel):
+    """
+    過濾代理模型：支援搜尋與編輯轉發
+    Proxy model: supports filtering and forwards editing
+    """
+
+    def setData(self, index, value, role=Qt.ItemDataRole.EditRole):
+        # 將編輯操作轉發到原始模型
+        # Forward editing to source model
+        return self.sourceModel().setData(
+            self.mapToSource(index), value, role
+        )
+
+
+class VariableInspector(QWidget):
+    """
+    變數檢視器：提供 GUI 介面顯示與搜尋全域變數
+    Variable inspector: GUI interface to display and search global variables
+    """
+
+    def __init__(self):
+        super().__init__()
+        self.setWindowTitle(language_wrapper.language_word_dict.get("variable_inspector_title"))
+        layout = QVBoxLayout(self)
+
+        # 搜尋框 / search box
+        self.search_box = QLineEdit()
+        self.search_box.setPlaceholderText(language_wrapper.language_word_dict.get("variable_inspector_search"))
+        layout.addWidget(QLabel(language_wrapper.language_word_dict.get("variable_inspector_search")))
+        layout.addWidget(self.search_box)
+
+        # 模型與代理模型 / model and proxy model
+        self.model = VariableModel(parent=self)
+        self.proxy_model = VariableProxy(self)
+        self.proxy_model.setSourceModel(self.model)
+        self.proxy_model.setFilterCaseSensitivity(Qt.CaseSensitivity.CaseInsensitive)  # 不分大小寫 / case-insensitive
+        self.proxy_model.setFilterKeyColumn(0)  # 僅針對變數名稱過濾 / filter by variable name
+
+        # 表格顯示 / table view
+        self.table = QTableView()
+        self.table.setModel(self.proxy_model)
+        self.table.horizontalHeader().setStretchLastSection(True)
+        self.table.horizontalHeader().setSectionResizeMode(
+            self.table.horizontalHeader().ResizeMode.Stretch
+        )
+        layout.addWidget(self.table, stretch=1)
+
+        # 綁定搜尋框輸入事件 / bind search box input
+        self.search_box.textChanged.connect(
+            self.proxy_model.setFilterFixedString
+        )
+
+        # 定時更新變數清單 (每 500ms)
+        # Periodically update variable list (every 500ms)
+        self.timer = QTimer(self)
+        self.timer.timeout.connect(self.model.update_data)
+        self.timer.start(500)

je_editor/pyside_ui/dialog/ai_dialog/set_ai_dialog.py

@@ -0,0 +1,71 @@
+from PySide6.QtWidgets import QWidget, QLineEdit, QPushButton, QMessageBox, QGridLayout, QLabel
+
+from je_editor.pyside_ui.main_ui.ai_widget.ai_config import ai_config
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+
+class SetAIDialog(QWidget):
+    """
+    設定 AI 模型的對話框
+    Dialog for configuring AI model settings
+    """
+
+    def __init__(self):
+        jeditor_logger.info("Init SetAIDialog")
+        super().__init__()
+
+        # Base URL 輸入欄位 / Base URL input field
+        self.base_url_label = QLabel(language_wrapper.language_word_dict.get("base_url_label"))
+        self.base_url_input = QLineEdit()
+
+        # API Key 輸入欄位 / API Key input field
+        self.api_key_label = QLabel(language_wrapper.language_word_dict.get("api_key_label"))
+        self.api_key_input = QLineEdit()
+
+        # Chat Model 輸入欄位 / Chat model input field
+        self.chat_model_label = QLabel(language_wrapper.language_word_dict.get("ai_model_label"))
+        self.chat_model_input = QLineEdit()
+
+        # 新增 AI 設定按鈕 / Button to add AI configuration
+        self.add_ai_info_button = QPushButton()
+        self.add_ai_info_button.setText(language_wrapper.language_word_dict.get("add_ai_model_pushbutton"))
+        self.add_ai_info_button.clicked.connect(self.update_ai_config)
+
+        # 使用 GridLayout 排版 / Use GridLayout for layout
+        self.grid_layout = QGridLayout()
+        self.grid_layout.addWidget(self.base_url_label, 0, 0)
+        self.grid_layout.addWidget(self.base_url_input, 0, 1)
+        self.grid_layout.addWidget(self.api_key_label, 1, 0)
+        self.grid_layout.addWidget(self.api_key_input, 1, 1)
+        self.grid_layout.addWidget(self.chat_model_label, 2, 0)
+        self.grid_layout.addWidget(self.chat_model_input, 2, 1)
+        self.grid_layout.addWidget(self.add_ai_info_button, 3, 1)
+
+        # 設定視窗標題 / Set window title
+        self.setWindowTitle(language_wrapper.language_word_dict.get("add_ai_model_title"))
+        self.setLayout(self.grid_layout)
+
+    def update_ai_config(self):
+        """
+        更新 AI 設定，將使用者輸入的 base_url、api_key、chat_model
+        儲存到 ai_config.choosable_ai 中
+        Update AI configuration with user inputs (base_url, api_key, chat_model)
+        """
+        base_url = self.base_url_input.text().strip()
+        api_key = self.api_key_input.text().strip()
+        chat_model = self.chat_model_input.text().strip()
+
+        if base_url and chat_model:
+            # 更新設定字典 / Update configuration dictionary
+            ai_config.choosable_ai.update(
+                {"AI_model": {"base_url": base_url, "api_key": api_key, "chat_model": chat_model}}
+            )
+        else:
+            # 若缺少必要欄位，顯示警告訊息框
+            # Show warning message box if required fields are missing
+            QMessageBox.warning(
+                self,
+                language_wrapper.language_word_dict.get("set_ai_model_warring_title"),
+                language_wrapper.language_word_dict.get("set_ai_model_warring_text")
+            )

je_editor/pyside_ui/dialog/file_dialog/create_file_dialog.py

@@ -5,30 +5,64 @@ from je_editor.utils.multi_language.multi_language_wrapper import language_wrapp
 
 
 class CreateFileDialog(QWidget):
+    """
+    建立新檔案的對話框
+    Dialog for creating a new file
+    """
 
     def __init__(self):
         jeditor_logger.info("Init CreateFileDialog")
         super().__init__()
+
+        # 垂直佈局 (上到下)
+        # Vertical layout (top to bottom)
         self.box_layout = QBoxLayout(QBoxLayout.Direction.TopToBottom)
+
+        # 檔案名稱輸入框 / File name input field
         self.file_name_input = QLineEdit()
+
+        # 建立檔案按鈕 / Create file button
         self.create_file_button = QPushButton()
-        self.create_file_button.setText(language_wrapper.language_word_dict.get("dialog_create_file"))
+        self.create_file_button.setText(language_wrapper.language_word_dict.get("create_file_dialog_pushbutton"))
         self.create_file_button.clicked.connect(self.create_file)
+
+        # 水平佈局 (放置按鈕) / Horizontal layout (for button)
         self.box_h_layout = QHBoxLayout()
         self.box_h_layout.addWidget(self.create_file_button)
+
+        # 將元件加入主佈局 / Add widgets to main layout
         self.box_layout.addWidget(self.file_name_input)
         self.box_layout.addLayout(self.box_h_layout)
-        self.setWindowTitle(language_wrapper.language_word_dict.get("dialog_create_file"))
+
+        # 設定視窗標題 / Set window title
+        self.setWindowTitle(language_wrapper.language_word_dict.get("create_file_dialog_pushbutton"))
         self.setLayout(self.box_layout)
 
     def create_file(self):
+        """
+        建立檔案的邏輯：
+        1. 檢查輸入是否為空
+        2. 若為空，顯示警告訊息
+        3. 否則建立新檔案並關閉對話框
+        File creation logic:
+        1. Check if input is empty
+        2. If empty, show warning message
+        3. Otherwise, create new file and close dialog
+        """
         jeditor_logger.info("CreateFileDialog create_file")
         file_name = self.file_name_input.text().strip()
+
         if file_name == "":
+            # 若未輸入檔名，顯示提示訊息
+            # Show warning if no file name is entered
             create_file_message_box = QMessageBox(self)
-            create_file_message_box.setText(language_wrapper.language_word_dict.get("dialog_input_file_name"))
+            create_file_message_box.setText(
+                language_wrapper.language_word_dict.get("input_file_name_dialog_pushbutton")
+            )
             create_file_message_box.show()
         else:
+            # 建立新檔案 (若存在則覆蓋)
+            # Create new file (overwrite if exists)
             with open(file_name, "w+") as file:
                 file.write("")
-            self.close()
+            self.close()  # 關閉對話框 / close dialog

je_editor/pyside_ui/dialog/file_dialog/open_file_dialog.py

@@ -12,6 +12,8 @@ from je_editor.utils.multi_language.multi_language_wrapper import language_wrapp
 from je_editor.utils.venv_check.check_venv import check_and_choose_venv
 
 if TYPE_CHECKING:
+    # 僅在型別檢查時匯入，避免循環依賴
+    # Only imported during type checking to avoid circular imports
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
 
 from PySide6.QtWidgets import QFileDialog
@@ -22,14 +24,16 @@ from je_editor.utils.file.open.open_file import read_file
 
 def choose_file_get_open_file_path(parent_qt_instance: EditorMain) -> None:
     """
+    開啟檔案並將內容載入編輯器
     Open file and set code edit content
-    :param parent_qt_instance: Pyside parent
+    :param parent_qt_instance: Pyside 主視窗 / Pyside parent
     :return: None
     """
     jeditor_logger.info("open_file_dialog.py choose_file_get_open_file_path"
                         f" parent_qt_instance: {parent_qt_instance}")
     widget = parent_qt_instance.tab_widget.currentWidget()
     if isinstance(widget, EditorWidget):
+        # 開啟檔案選擇對話框 / Open file dialog
         file_path = QFileDialog().getOpenFileName(
             parent=parent_qt_instance,
             dir=str(Path.cwd()),
@@ -37,27 +41,40 @@ def choose_file_get_open_file_path(parent_qt_instance: EditorMain) -> None:
             HTML file (*.html);;
             File (*.*)"""
         )[0]
+
         if file_path is not None and file_path != "":
+            # 檢查檔案是否已經開啟 / Check if file already opened
             if file_is_open_manager_dict.get(str(Path(file_path)), None) is not None:
                 widget.tab_manager.setCurrentWidget(
                     widget.tab_manager.findChild(EditorWidget, str(Path(file_path).name)))
                 return
             else:
+                # 記錄已開啟檔案 / Register opened file
                 file_is_open_manager_dict.update({file_path: str(Path(file_path).name)})
+
+            # 設定目前檔案路徑 / Set current file path
             widget.current_file = file_path
+            # 讀取檔案內容 / Read file content
             file_content = read_file(file_path)[1]
-            widget.code_edit.setPlainText(
-                file_content
-            )
+            widget.code_edit.setPlainText(file_content)
+
+            # 啟動自動儲存執行緒 / Start auto-save thread
             if widget.current_file is not None and widget.code_save_thread is None:
                 init_new_auto_save_thread(widget.current_file, widget)
             else:
                 widget.code_save_thread.file = widget.current_file
+
+            # 更新使用者設定中的最後開啟檔案 / Update last opened file in user settings
             user_setting_dict.update({"last_file": str(widget.current_file)})
+            # 更新分頁標題 / Rename tab title
             widget.rename_self_tab()
 
 
 def choose_dir_get_dir_path(parent_qt_instance: EditorMain) -> None:
+    """
+    選擇資料夾並更新工作目錄與專案樹
+    Choose directory and update working dir and project tree
+    """
     jeditor_logger.info("open_file_dialog.py choose_dir_get_dir_path"
                         f" parent_qt_instance: {parent_qt_instance}")
     dir_path = QFileDialog().getExistingDirectory(parent=parent_qt_instance, )
@@ -65,19 +82,30 @@ def choose_dir_get_dir_path(parent_qt_instance: EditorMain) -> None:
         check_path = Path(dir_path)
     else:
         return
+
     if check_path.exists() and check_path.is_dir():
+        # 更新工作目錄 / Update working directory
         parent_qt_instance.working_dir = dir_path
         os.chdir(dir_path)
+
+        # 更新所有編輯器的專案樹與環境檢查 / Update project tree and check env for all editors
         for code_editor in range(parent_qt_instance.tab_widget.count()):
             widget = parent_qt_instance.tab_widget.widget(code_editor)
             if isinstance(widget, EditorWidget):
                 widget.project_treeview.setRootIndex(widget.project_treeview_model.index(dir_path))
                 widget.code_edit.check_env()
+
+        # 設定虛擬環境路徑 / Set virtual environment path
         if sys.platform in ["win32", "cygwin", "msys"]:
             venv_path = Path(os.getcwd() + "/venv/Scripts")
         else:
             venv_path = Path(os.getcwd() + "/venv/bin")
+
         parent_qt_instance.python_compiler = check_and_choose_venv(venv_path)
+
+        # 重新讀取使用者設定並套用啟動設定 / Reload user settings and apply startup settings
         read_user_setting()
         parent_qt_instance.startup_setting()
+
+        # 重設語言設定 / Reset language
         language_wrapper.reset_language(user_setting_dict.get("language", "English"))

je_editor/pyside_ui/dialog/file_dialog/save_file_dialog.py

@@ -8,7 +8,10 @@ from je_editor.pyside_ui.code.auto_save.auto_save_manager import file_is_open_ma
 from je_editor.utils.logging.loggin_instance import jeditor_logger
 
 if TYPE_CHECKING:
+    # 僅在型別檢查時匯入，避免循環依賴
+    # Only imported during type checking to avoid circular imports
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+
 from PySide6.QtWidgets import QFileDialog
 
 from je_editor.pyside_ui.main_ui.editor.editor_widget import EditorWidget
@@ -17,13 +20,20 @@ from je_editor.utils.file.save.save_file import write_file
 
 def choose_file_get_save_file_path(parent_qt_instance: EditorMain) -> bool:
     """
-    :param parent_qt_instance: Pyside parent
-    :return: save code edit content to file
+    開啟「另存新檔」對話框，將編輯器內容儲存到檔案
+    Open "Save As" dialog and save editor content to file
+    :param parent_qt_instance: Pyside 主視窗 / Pyside parent
+    :return: 是否成功儲存檔案 / whether file was saved successfully
     """
     jeditor_logger.info("save_file_dialog.py choose_file_get_save_file_path"
                         f" parent_qt_instance: {parent_qt_instance}")
+
+    # 取得目前分頁的編輯器元件
+    # Get current tab's editor widget
     widget = parent_qt_instance.tab_widget.currentWidget()
+
     if isinstance(widget, EditorWidget):
+        # 開啟檔案儲存對話框 / Open file save dialog
         file_path = QFileDialog().getSaveFileName(
             parent=parent_qt_instance,
             dir=os.getcwd(),
@@ -31,14 +41,27 @@ def choose_file_get_save_file_path(parent_qt_instance: EditorMain) -> bool:
             HTML file (*.html);;
             File (*.*)"""
         )[0]
+
+        # 確認使用者有選擇檔案路徑 / Ensure user selected a file path
         if file_path is not None and file_path != "":
+            # 更新目前檔案路徑 / Update current file path
             widget.current_file = file_path
+
+            # 將編輯器內容寫入檔案 / Write editor content to file
             write_file(file_path, widget.code_edit.toPlainText())
+
+            # 更新已開啟檔案管理字典 / Update opened file manager dictionary
             path = Path(file_path)
             file_is_open_manager_dict.update({str(path): str(path.name)})
+
+            # 若有自動儲存執行緒，更新其監控的檔案與編輯器
+            # If auto-save thread exists, update its file and editor reference
             if widget.code_save_thread is not None:
                 widget.code_save_thread.file = file_path
                 widget.code_save_thread.editor = widget.code_edit
+
+            # 更新分頁標題 / Update tab title
             widget.rename_self_tab()
             return True
         return False
+    return False

je_editor/pyside_ui/dialog/search_ui/search_error_box.py

@@ -5,20 +5,45 @@ from je_editor.utils.multi_language.multi_language_wrapper import language_wrapp
 
 
 class SearchResultBox(QWidget):
+    """
+    搜尋結果對話框
+    Search result dialog box
+    """
 
     def __init__(self):
         jeditor_logger.info("Init SearchResultBox")
         super().__init__()
+
+        # 垂直佈局 (上到下)
+        # Vertical layout (top to bottom)
         self.box_layout = QBoxLayout(QBoxLayout.Direction.TopToBottom)
+
+        # 搜尋輸入框 / Search input field
         self.search_input = QLineEdit()
+
+        # 下一個搜尋按鈕 / Next search button
         self.search_next_button = QPushButton()
-        self.search_next_button.setText(language_wrapper.language_word_dict.get("dialog_search_next"))
+        self.search_next_button.setText(language_wrapper.language_word_dict.get("search_next_dialog_pushbutton"))
+
+        # 上一個搜尋按鈕 / Previous search button
         self.search_back_button = QPushButton()
-        self.search_back_button.setText(language_wrapper.language_word_dict.get("dialog_search_back"))
+        self.search_back_button.setText(language_wrapper.language_word_dict.get("search_back_dialog_pushbutton"))
+
+        # 水平佈局 (放置前後搜尋按鈕)
+        # Horizontal layout (for back/next buttons)
         self.box_h_layout = QHBoxLayout()
         self.box_h_layout.addWidget(self.search_back_button)
         self.box_h_layout.addWidget(self.search_next_button)
+
+        # 將元件加入主佈局
+        # Add widgets to main layout
         self.box_layout.addWidget(self.search_input)
         self.box_layout.addLayout(self.box_h_layout)
+
+        # 設定視窗標題
+        # Set window title
         self.setWindowTitle("Search Result")
+
+        # 套用主佈局
+        # Apply main layout
         self.setLayout(self.box_layout)

je_editor/pyside_ui/dialog/search_ui/search_text_box.py

@@ -5,20 +5,45 @@ from je_editor.utils.multi_language.multi_language_wrapper import language_wrapp
 
 
 class SearchBox(QWidget):
+    """
+    搜尋框元件
+    Search box widget
+    """
 
     def __init__(self):
         jeditor_logger.info("Init SearchBox")
         super().__init__()
+
+        # 垂直佈局 (上到下)
+        # Vertical layout (top to bottom)
         self.box_layout = QBoxLayout(QBoxLayout.Direction.TopToBottom)
+
+        # 搜尋輸入框 / Search input field
         self.search_input = QLineEdit()
+
+        # 下一個搜尋按鈕 / Next search button
         self.search_next_button = QPushButton()
-        self.search_next_button.setText(language_wrapper.language_word_dict.get("dialog_search_next"))
+        self.search_next_button.setText(language_wrapper.language_word_dict.get("search_next_dialog_pushbutton"))
+
+        # 上一個搜尋按鈕 / Previous search button
         self.search_back_button = QPushButton()
-        self.search_back_button.setText(language_wrapper.language_word_dict.get("dialog_search_back"))
+        self.search_back_button.setText(language_wrapper.language_word_dict.get("search_back_dialog_pushbutton"))
+
+        # 水平佈局 (放置前後搜尋按鈕)
+        # Horizontal layout (for back/next buttons)
         self.box_h_layout = QHBoxLayout()
         self.box_h_layout.addWidget(self.search_back_button)
         self.box_h_layout.addWidget(self.search_next_button)
+
+        # 將元件加入主佈局
+        # Add widgets to main layout
         self.box_layout.addWidget(self.search_input)
         self.box_layout.addLayout(self.box_h_layout)
-        self.setWindowTitle("Search Text")
+
+        # 設定視窗標題 (支援多語系)
+        # Set window title (multi-language support)
+        self.setWindowTitle(language_wrapper.language_word_dict.get("search_box_dialog_title"))
+
+        # 套用主佈局
+        # Apply main layout
         self.setLayout(self.box_layout)

je_editor/pyside_ui/git_ui/code_diff_compare/code_diff_viewer_widget.py

@@ -0,0 +1,90 @@
+from PySide6.QtGui import QAction, QActionGroup
+from PySide6.QtWidgets import (
+    QWidget, QVBoxLayout, QMenuBar, QFileDialog, QMessageBox
+)
+from git import Repo
+
+from je_editor.pyside_ui.git_ui.code_diff_compare.multi_file_diff_viewer import MultiFileDiffViewer
+
+
+class DiffViewerWidget(QWidget):
+    """
+    Git Diff Viewer Application
+    Git 差異檢視器應用程式
+    """
+
+    def __init__(self):
+        super().__init__()
+        self.setWindowTitle("Git Diff Viewer")
+
+        # === Main diff viewer widget / 主要的差異檢視元件 ===
+        self.viewer = MultiFileDiffViewer()
+
+        # === Menu bar / 選單列 ===
+        self.menubar = QMenuBar(self)
+        file_menu = self.menubar.addMenu("File")  # File 選單
+        view_menu = self.menubar.addMenu("View")  # View 選單
+
+        # --- File → Open Git Repo ---
+        # Action to open a Git repository
+        # 開啟 Git 專案的動作
+        open_repo_action = QAction("Open Git Repo", self)
+        open_repo_action.triggered.connect(self.open_repo)
+        file_menu.addAction(open_repo_action)
+
+        # === View → Theme switching (exclusive) / 主題切換（單選模式） ===
+        theme_group = QActionGroup(self)
+        theme_group.setExclusive(True)  # 確保只能選擇一個主題 / ensure only one theme can be selected
+
+        dark_action = QAction("Dark Mode", self, checkable=True)  # 深色模式 / dark mode
+        light_action = QAction("Light Mode", self, checkable=True)  # 淺色模式 / light mode
+
+        theme_group.addAction(dark_action)
+        theme_group.addAction(light_action)
+
+        # Default to dark mode / 預設為深色模式
+        dark_action.setChecked(True)
+        self.viewer.set_dark_theme()
+
+        # Connect theme actions / 綁定主題切換事件
+        dark_action.triggered.connect(lambda: self.set_theme("dark"))
+        light_action.triggered.connect(lambda: self.set_theme("light"))
+
+        view_menu.addAction(dark_action)
+        view_menu.addAction(light_action)
+
+        # === Layout / 版面配置 ===
+        layout = QVBoxLayout(self)
+        layout.setMenuBar(self.menubar)  # 把選單列放在上方 / put menu bar at the top
+        layout.addWidget(self.viewer)  # 把差異檢視器放在主要區域 / add diff viewer in main area
+
+    def open_repo(self):
+        """
+        Open a Git repository and display its diff.
+        開啟一個 Git 專案並顯示差異。
+        """
+        path = QFileDialog.getExistingDirectory(self, "Select Git Repository")
+        if not path:
+            return
+        try:
+            repo = Repo(path)  # 嘗試載入 Git 專案 / try to load Git repo
+            diff_text = repo.git.diff()  # 取得差異文字 / get diff text
+            if not diff_text.strip():
+                # 如果沒有差異，顯示提示訊息 / show info if no changes
+                QMessageBox.information(self, "Info", "No changes in repo.")
+            else:
+                # 如果有差異，顯示在 viewer 中 / show diff in viewer
+                self.viewer.set_diff_text(diff_text)
+        except Exception as e:
+            # 如果開啟失敗，顯示錯誤訊息 / show error if failed
+            QMessageBox.critical(self, "Error", f"Failed to open repo:\n{e}")
+
+    def set_theme(self, mode: str):
+        """
+        Switch between dark and light themes.
+        切換深色與淺色主題。
+        """
+        if mode == "dark":
+            self.viewer.set_dark_theme()
+        else:
+            self.viewer.set_light_theme()