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

je_editor/pyside_ui/code/variable_inspector/inspector_gui.py

@@ -7,12 +7,23 @@ from je_editor.utils.multi_language.multi_language_wrapper import language_wrapp
 
 
 class VariableModel(QAbstractTableModel):
+    """
+    變數模型：負責管理與顯示 Python 全域變數
+    Variable model: manages and displays Python global variables
+    """
     def __init__(self, parent=None):
         super().__init__(parent)
-        self.variables = []
+        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
@@ -22,17 +33,21 @@ class VariableModel(QAbstractTableModel):
         self.variables = [
             [name, type(value).__name__, repr(value), value]
             for name, value in vars_dict.items()
-            if not name.startswith("__")  # 過濾內建變數
+            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:
@@ -40,6 +55,8 @@ class VariableModel(QAbstractTableModel):
         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"),
@@ -49,14 +66,20 @@ class VariableModel(QAbstractTableModel):
         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:  # 只允許編輯值欄
+        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 == "":
@@ -68,13 +91,19 @@ class VariableModel(QAbstractTableModel):
 
             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
@@ -82,29 +111,44 @@ class VariableModel(QAbstractTableModel):
             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)
-        self.proxy_model.setFilterKeyColumn(0)
+        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)
@@ -113,10 +157,13 @@ class VariableInspector(QWidget):
         )
         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)
+        self.timer.start(500)

je_editor/pyside_ui/dialog/ai_dialog/set_ai_dialog.py

@@ -6,19 +6,33 @@ from je_editor.utils.multi_language.multi_language_wrapper import language_wrapp
 
 
 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)
@@ -27,18 +41,31 @@ class SetAIDialog(QWidget):
         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:
-            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"))
+            # 若缺少必要欄位，顯示警告訊息框
+            # 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,31 +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("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"))
+                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()
-        language_wrapper.reset_language(user_setting_dict.get("language", "English"))
+
+        # 重設語言設定 / 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,15 +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
+    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("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")
-        self.setLayout(self.box_layout)
+
+        # 套用主佈局
+        # 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("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"))
-        self.setLayout(self.box_layout)
+
+        # 套用主佈局
+        # Apply main layout
+        self.setLayout(self.box_layout)

je_editor/pyside_ui/git_ui/code_diff_compare/code_diff_viewer_widget.py

@@ -34,10 +34,10 @@ class DiffViewerWidget(QWidget):
 
         # === View → Theme switching (exclusive) / 主題切換（單選模式） ===
         theme_group = QActionGroup(self)
-        theme_group.setExclusive(True)  # 確保只能選擇一個主題
+        theme_group.setExclusive(True)  # 確保只能選擇一個主題 / ensure only one theme can be selected
 
-        dark_action = QAction("Dark Mode", self, checkable=True)  # 深色模式
-        light_action = QAction("Light Mode", self, checkable=True)  # 淺色模式
+        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)
@@ -55,8 +55,8 @@ class DiffViewerWidget(QWidget):
 
         # === Layout / 版面配置 ===
         layout = QVBoxLayout(self)
-        layout.setMenuBar(self.menubar)  # 把選單列放在上方
-        layout.addWidget(self.viewer)  # 把差異檢視器放在主要區域
+        layout.setMenuBar(self.menubar)   # 把選單列放在上方 / put menu bar at the top
+        layout.addWidget(self.viewer)     # 把差異檢視器放在主要區域 / add diff viewer in main area
 
     def open_repo(self):
         """
@@ -67,16 +67,16 @@ class DiffViewerWidget(QWidget):
         if not path:
             return
         try:
-            repo = Repo(path)  # 嘗試載入 Git 專案
-            diff_text = repo.git.diff()  # 取得差異文字
+            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 中
+                # 如果有差異，顯示在 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):
@@ -87,4 +87,4 @@ class DiffViewerWidget(QWidget):
         if mode == "dark":
             self.viewer.set_dark_theme()
         else:
-            self.viewer.set_light_theme()
+            self.viewer.set_light_theme()