je-editor 0.0.104__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

@@ -0,0 +1,68 @@
+from PySide6.QtWidgets import QWidget, QBoxLayout, QLineEdit, QPushButton, QHBoxLayout, QMessageBox
+
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+
+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("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)
+
+        # 設定視窗標題 / 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("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()  # 關閉對話框 / close dialog

je_editor/pyside_ui/dialog/file_dialog/open_file_dialog.py

@@ -0,0 +1,111 @@
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from je_editor.pyside_ui.code.auto_save.auto_save_manager import init_new_auto_save_thread, file_is_open_manager_dict
+from je_editor.pyside_ui.main_ui.save_settings.user_setting_file import user_setting_dict, read_user_setting
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+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
+
+from je_editor.pyside_ui.main_ui.editor.editor_widget import EditorWidget
+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 主視窗 / 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()),
+            filter="""Python file (*.py);;
+            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)
+
+            # 啟動自動儲存執行緒 / 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, )
+    if dir_path != "":
+        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

@@ -0,0 +1,67 @@
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from je_editor.pyside_ui.code.auto_save.auto_save_manager import file_is_open_manager_dict
+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
+from je_editor.utils.file.save.save_file import write_file
+
+
+def choose_file_get_save_file_path(parent_qt_instance: EditorMain) -> bool:
+    """
+    開啟「另存新檔」對話框，將編輯器內容儲存到檔案
+    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(),
+            filter="""Python file (*.py);;
+            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

@@ -0,0 +1,49 @@
+from PySide6.QtWidgets import QWidget, QLineEdit, QPushButton, QBoxLayout, QHBoxLayout
+
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+
+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("search_next_dialog_pushbutton"))
+
+        # 上一個搜尋按鈕 / Previous search button
+        self.search_back_button = QPushButton()
+        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

@@ -0,0 +1,49 @@
+from PySide6.QtWidgets import QWidget, QLineEdit, QPushButton, QBoxLayout, QHBoxLayout
+
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+
+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("search_next_dialog_pushbutton"))
+
+        # 上一個搜尋按鈕 / Previous search button
+        self.search_back_button = QPushButton()
+        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 (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()