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

je_editor/pyside_ui/git_ui/git_client/commit_table.py

@@ -3,25 +3,63 @@ from PySide6.QtWidgets import QTableView
 
 
 class CommitTable(QTableView):
+    """
+    CommitTable 類別：用來顯示 Git Commit 紀錄的表格
+    CommitTable class: A table view to display Git commit history
+    """
+
     def __init__(self, parent=None):
         super().__init__(parent)
-        self.model_data = QStandardItemModel(0, 5, self)  # 多一欄
+
+        # 建立一個 QStandardItemModel，初始為 0 行 5 欄
+        # Create a QStandardItemModel with 0 rows and 5 columns
+        self.model_data = QStandardItemModel(0, 5, self)  # 多一欄 / 5 columns
+
+        # 設定表頭標籤
+        # Set horizontal header labels
         self.model_data.setHorizontalHeaderLabels(["#", "SHA", "Message", "Author", "Date"])
+
+        # 將模型綁定到 QTableView
+        # Set the model for QTableView
         self.setModel(self.model_data)
+
+        # 設定選擇行為為整列選取
+        # Set selection behavior to select entire rows
         self.setSelectionBehavior(QTableView.SelectionBehavior.SelectRows)
+
+        # 禁止編輯表格內容
+        # Disable editing of table cells
         self.setEditTriggers(QTableView.EditTrigger.NoEditTriggers)
+
+        # 讓最後一欄自動延展填滿
+        # Stretch the last column to fill available space
         self.horizontalHeader().setStretchLastSection(True)
 
     def set_commits(self, commits):
+        """
+        將 commit 資料填入表格
+        Populate the table with commit data
+        :param commits: commit 資料清單 (list of dicts with sha, message, author, date)
+        """
+        # 清空現有資料
+        # Clear existing rows
         self.model_data.setRowCount(0)
-        for idx, c in enumerate(commits, start=1):
+
+        # 遍歷 commit 清單，逐行加入表格
+        # Iterate over commits and append rows
+        for index, commit in enumerate(commits, start=1):
             row = [
-                QStandardItem(str(idx)),  # 行號
-                QStandardItem(c["sha"][:7]),
-                QStandardItem(c["message"]),
-                QStandardItem(c["author"]),
-                QStandardItem(c["date"]),
+                QStandardItem(str(index)),          # 行號 / row number
+                QStandardItem(commit["sha"][:7]),      # SHA 短碼 / short SHA
+                QStandardItem(commit["message"]),      # 提交訊息 / commit message
+                QStandardItem(commit["author"]),       # 作者 / author
+                QStandardItem(commit["date"]),         # 日期 / date
             ]
+            # 設定每個欄位不可編輯
+            # Make each item non-editable
             for item in row:
                 item.setEditable(False)
-            self.model_data.appendRow(row)
+
+            # 將這一列加入模型
+            # Append row to the model
+            self.model_data.appendRow(row)

je_editor/pyside_ui/git_ui/git_client/git_branch_tree_widget.py

@@ -19,64 +19,89 @@ log = logging.getLogger(__name__)
 
 
 class GitTreeViewGUI(QWidget):
+    """
+    GitTreeViewGUI: Git 提交歷史圖形化檢視器
+    GitTreeViewGUI: A graphical viewer for Git commit history
+    """
+
     def __init__(self):
         super().__init__()
         self.language_wrapper_get = language_wrapper.language_word_dict.get
         self.setWindowTitle(self.language_wrapper_get("git_graph_title"))
 
+        # === 主版面配置 / Main layout ===
         git_treeview_main_layout = QVBoxLayout(self)
         git_treeview_main_layout.setContentsMargins(0, 0, 0, 0)
         git_treeview_main_layout.setSpacing(0)
 
+        # === 工具列 / Toolbar ===
         git_treeview_toolbar = QToolBar()
+
+        # 開啟 Git 專案動作 / Action to open Git repo
         open_repo_action = QAction(self.language_wrapper_get("git_graph_toolbar_open"), self)
         open_repo_action.triggered.connect(self.open_repo)
         git_treeview_toolbar.addAction(open_repo_action)
 
+        # 刷新圖表動作 / Action to refresh graph
         act_refresh = QAction(self.language_wrapper_get("git_graph_toolbar_refresh"), self)
         act_refresh.triggered.connect(self.refresh_graph)
         git_treeview_toolbar.addAction(act_refresh)
 
         git_treeview_main_layout.addWidget(git_treeview_toolbar)
 
+        # === 分割器 (左：圖形檢視 / 右：提交表格) ===
         splitter = QSplitter(Qt.Orientation.Horizontal)
-        self.graph_view = CommitGraphView()
-        self.commit_table = CommitTable()
+        self.graph_view = CommitGraphView()   # 提交圖形檢視器 / commit graph view
+        self.commit_table = CommitTable()     # 提交表格 / commit table
         splitter.addWidget(self.graph_view)
         splitter.addWidget(self.commit_table)
-        splitter.setSizes([600, 400])
-        git_treeview_main_layout.addWidget(splitter, 1)  # 1 表示可伸縮
+        splitter.setSizes([600, 400])  # 左右比例 / left-right ratio
+        git_treeview_main_layout.addWidget(splitter, 1)  # stretch=1 表示可伸縮
 
+        # === 狀態列 / Status bar ===
         self.status = QStatusBar()
         git_treeview_main_layout.addWidget(self.status)
 
+        # === Git 相關屬性 ===
         self.repo_path = None
         self.git = None
 
+        # === 檔案監控器 / File system watcher ===
         self.watcher = QFileSystemWatcher()
         self.watcher.directoryChanged.connect(self._on_git_changed)
         self.watcher.fileChanged.connect(self._on_git_changed)
 
+        # === 定時器 (延遲刷新) / Timer for delayed refresh ===
         self.refresh_timer = QTimer()
         self.refresh_timer.setSingleShot(True)
         self.refresh_timer.timeout.connect(self.refresh_graph)
 
+        # === 表格選擇事件 / Table selection event ===
         self.commit_table.selectionModel().selectionChanged.connect(self._on_table_selection)
 
     def _on_table_selection(self, selected, _):
+        """
+        當使用者在提交表格中選擇某一列時，讓圖形檢視器聚焦到該行
+        When user selects a row in commit table, focus graph view on that row
+        """
         if not selected.indexes():
             return
         row = selected.indexes()[0].row()
         self.graph_view.focus_row(row)
 
     def open_repo(self):
-        # Open repo and set up the graph.
+        """
+        開啟 Git 專案並初始化圖形檢視
+        Open a Git repository and set up the graph view
+        """
         path = QFileDialog.getExistingDirectory(self, self.language_wrapper_get("git_graph_menu_open_repo"))
         if not path:
             return
         repo_path = Path(path)
         git = GitCLI(repo_path)
         if not git.is_git_repo():
+            # 若不是 Git 專案，顯示警告
+            # Show warning if not a Git repo
             QMessageBox.warning(self, self.language_wrapper_get("git_graph_title"),
                                 self.language_wrapper_get("git_graph_error_not_git"))
             return
@@ -86,11 +111,15 @@ class GitTreeViewGUI(QWidget):
         self.refresh_graph()
 
     def _setup_watcher(self):
+        """
+        設定檔案監控，監控 .git 目錄與相關檔案
+        Setup file watcher to monitor .git directory and related files
+        """
         self.watcher.removePaths(self.watcher.files())
         self.watcher.removePaths(self.watcher.directories())
         if not self.repo_path:
             return
-        git_dir = self.repo_path / ".git_client"
+        git_dir = self.repo_path / ".git_client"  # ⚠️ 這裡應該是 ".git"，可能是自訂路徑
         if git_dir.exists():
             self.watcher.addPath(str(git_dir))
             for f in ["HEAD", "packed-refs"]:
@@ -102,21 +131,26 @@ class GitTreeViewGUI(QWidget):
                 self.watcher.addPath(str(refs_dir))
 
     def _on_git_changed(self):
-        # Refresh git tree timer
+        """
+        當 Git 目錄變更時，啟動延遲刷新
+        When Git directory changes, start delayed refresh
+        """
         self.refresh_timer.start(500)
 
     def refresh_graph(self):
-        # Refresh git tree
+        """
+        刷新 Git 提交圖與提交表格
+        Refresh Git commit graph and commit table
+        """
         if not self.git:
             return
         try:
-            refs = self.git.get_all_refs()
-            commits = self.git.get_commits(max_count=500)
+            refs = self.git.get_all_refs()                  # 取得所有 refs
+            commits = self.git.get_commits(max_count=500)   # 取得最近 500 筆提交
             graph = CommitGraph()
-            graph.build(commits, refs)
-            self.graph_view.set_graph(graph)
-            self.commit_table.set_commits(commits)
+            graph.build(commits, refs)                      # 建立提交圖
+            self.graph_view.set_graph(graph)                # 更新圖形檢視
+            self.commit_table.set_commits(commits)          # 更新提交表格
         except Exception as e:
             QMessageBox.critical(self, self.language_wrapper_get("git_graph_title"),
-                                 f"{self.language_wrapper_get('git_graph_error_exec_failed')}\n{e}")
-
+                                 f"{self.language_wrapper_get('git_graph_error_exec_failed')}\n{e}")

je_editor/pyside_ui/git_ui/git_client/graph_view.py

@@ -14,18 +14,18 @@ from PySide6.QtWidgets import (
 from je_editor.git_client.commit_graph import CommitGraph
 from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
 
-# Layout constants
-NODE_RADIUS = 6
-ROW_HEIGHT = 28
-LANE_WIDTH = 22
-LEFT_MARGIN = 220  # space for SHA/message text area on the left
-
-# Colors
-EDGE_COLOR = QColor("#888")
-TEXT_COLOR = QColor("#222")
-BG_COLOR = QColor("#ffffff")
-
-# A small, repeatable lane palette
+# === 版面配置常數 / Layout constants ===
+NODE_RADIUS = 6       # 節點半徑 / node radius
+ROW_HEIGHT = 28       # 每一列高度 / row height
+LANE_WIDTH = 22       # 每一條 lane 的寬度 / lane width
+LEFT_MARGIN = 220     # 左側 SHA/訊息文字區域保留空間 / left margin for SHA/message text
+
+# === 顏色設定 / Colors ===
+EDGE_COLOR = QColor("#888")     # 邊線顏色 / edge color
+TEXT_COLOR = QColor("#222")     # 文字顏色 / text color
+BG_COLOR = QColor("#ffffff")    # 背景顏色 / background color
+
+# Lane 顏色調色盤 / Lane color palette
 LANE_COLORS = [
     QColor("#4C78A8"),
     QColor("#F58518"),
@@ -41,24 +41,38 @@ LANE_COLORS = [
 
 
 def lane_color(lane: int) -> QColor:
+    """
+    根據 lane index 回傳顏色
+    Return color based on lane index
+    """
     if lane < 0:
         return QColor("#999")
     return LANE_COLORS[lane % len(LANE_COLORS)]
 
 
 class CommitGraphView(QGraphicsView):
+    """
+    Git Commit Graph 視覺化檢視器
+    Git commit graph visualization view
+    """
+
     def __init__(self, parent=None):
         super().__init__(parent)
         self.language_wrapper_get = language_wrapper.language_word_dict.get
+
+        # 設定背景與抗鋸齒 / set background and antialiasing
         self.setBackgroundBrush(QBrush(BG_COLOR))
         self.setRenderHints(
             self.renderHints()
             | QPainter.RenderHint.Antialiasing
             | QPainter.RenderHint.TextAntialiasing
         )
+
+        # 啟用拖曳與縮放模式 / enable drag and zoom mode
         self.setDragMode(QGraphicsView.DragMode.ScrollHandDrag)
         self.setTransformationAnchor(QGraphicsView.ViewportAnchor.AnchorUnderMouse)
 
+        # 建立場景 / create scene
         self._scene = QGraphicsScene(self)
         self.setScene(self._scene)
 
@@ -67,21 +81,32 @@ class CommitGraphView(QGraphicsView):
         self._zoom = 1.0
 
     def set_graph(self, graph: CommitGraph):
+        """
+        設定 commit graph 並重新繪製
+        Set commit graph and redraw
+        """
         self.graph = graph
         self._redraw()
 
     def _lane_x(self, lane: int) -> float:
+        # 計算 lane 的 X 座標 / calculate X position for lane
         return lane * LANE_WIDTH + NODE_RADIUS * 2
 
     def _row_y(self, row: int) -> float:
+        # 計算 row 的 Y 座標 / calculate Y position for row
         return row * ROW_HEIGHT + NODE_RADIUS * 2
 
     def _redraw(self):
+        """
+        重新繪製整個 commit graph
+        Redraw the entire commit graph
+        """
         self._scene.clear()
         if not self.graph or not self.graph.nodes:
             self._scene.setSceneRect(QRectF(0, 0, 800, 400))
             return
 
+        # === 繪製邊線 (父子關係) / Draw edges (parent-child relationships) ===
         edge_pen = QPen(EDGE_COLOR, 2)
         for row, node in enumerate(self.graph.nodes):
             if not node.parent_shas:
@@ -95,6 +120,8 @@ class CommitGraphView(QGraphicsView):
                 parent_node = self.graph.nodes[prow]
                 x1 = self._lane_x(parent_node.lane_index)
                 y1 = self._row_y(prow)
+
+                # 使用三次貝茲曲線繪製邊線 / cubic Bezier curve for edge
                 path = QPainterPath(QPointF(x0, y0))
                 ctrl_y = (y0 + y1) / 2.0
                 path.cubicTo(QPointF(x0, ctrl_y), QPointF(x1, ctrl_y), QPointF(x1, y1))
@@ -102,6 +129,7 @@ class CommitGraphView(QGraphicsView):
                 edge_item.setPen(edge_pen)
                 self._scene.addItem(edge_item)
 
+        # === 繪製節點 (commit 圓點) / Draw nodes (commit circles) ===
         for row, node in enumerate(self.graph.nodes):
             cx = self._lane_x(node.lane_index)
             cy = self._row_y(row)
@@ -111,6 +139,7 @@ class CommitGraphView(QGraphicsView):
             )
             circle.setBrush(QBrush(lane_color(node.lane_index)))
             circle.setPen(QPen(Qt.PenStyle.NoPen))
+            # 設定 tooltip 顯示 commit 資訊 / tooltip with commit info
             circle.setToolTip(self.language_wrapper_get(
                 "git_graph_tooltip_commit"
             ).format(short=node.commit_sha[:7],
@@ -119,11 +148,13 @@ class CommitGraphView(QGraphicsView):
                      msg=node.commit_message))
             self._scene.addItem(circle)
 
+            # 在左側顯示行號 / show row number on the left
             label_item = QGraphicsSimpleTextItem(str(row + 1))
             label_item.setBrush(QBrush(TEXT_COLOR))
             label_item.setPos(-30, cy - NODE_RADIUS * 2)
             self._scene.addItem(label_item)
 
+        # 設定場景大小 / set scene rect
         self._scene.setSceneRect(
             QRectF(-40, 0,
                    self._lane_x(max(n.lane_index for n in self.graph.nodes) + 1) + self._padding,
@@ -131,15 +162,19 @@ class CommitGraphView(QGraphicsView):
         )
 
     def _apply_initial_view(self):
-        # Start with a mild zoom to fit rows comfortably
+        """
+        初始縮放設定
+        Apply initial zoom setting
+        """
         self._zoom = 0.9
         self._apply_zoom_transform()
 
-    # Zoom and interaction
+    # === 滑鼠滾輪縮放 / Mouse wheel zoom ===
     def wheelEvent(self, event):
         if not self._scene.items():
             return
 
+        # Ctrl+滾輪縮放，否則正常滾動
         # Ctrl+Wheel to zoom, else scroll normally
         if event.modifiers() & Qt.KeyboardModifier.ControlModifier:
             angle = event.angleDelta().y()
@@ -151,24 +186,33 @@ class CommitGraphView(QGraphicsView):
             super().wheelEvent(event)
 
     def _apply_zoom_transform(self):
+        """
+        套用縮放轉換
+        Apply zoom transform
+        """
         t = QTransform()
         t.scale(self._zoom, self._zoom)
         self.setTransform(t)
 
     def resizeEvent(self, event):
+        """
+        視窗大小改變時的事件
+        Handle resize event (keep scene rect, no auto-fit)
+        """
         super().resizeEvent(event)
-        # Keep scene rect; do not auto-fit. Users control zoom.
-        # Nothing else needed here.
+        # 保持場景大小，不自動縮放
+        # Keep scene rect; do not auto-fit
 
-    # Optional helpers for external controllers
+    # === 外部控制輔助方法 / Helper for external controllers ===
     def focus_row(self, row: int):
         """
-        Center the view around a specific row.
+        將檢視器聚焦到指定的 row
+        Center the view around a specific row
         """
         if not self.graph or row < 0 or row >= len(self.graph.nodes):
             return
         y = self._row_y(row)
         rect = QRectF(0, y - ROW_HEIGHT * 2, self._scene.width(), ROW_HEIGHT * 4)
         self.fitInView(rect, Qt.AspectRatioMode.KeepAspectRatio)
-        # Restore user zoom preference after focusing
-        self._apply_zoom_transform()
+        # 聚焦後恢復使用者縮放比例 / restore user zoom after focusing
+        self._apply_zoom_transform()

je_editor/pyside_ui/main_ui/ai_widget/ai_config.py

@@ -2,18 +2,33 @@ from queue import Queue
 
 
 class AIConfig(object):
+    """
+    AIConfig 類別：用來管理 AI 模型的設定與訊息佇列
+    AIConfig class: manages AI model configuration and message queue
+    """
 
     def __init__(self):
+        # 當前 AI 模型的系統提示詞 (system prompt)
+        # Current AI model system prompt
         self.current_ai_model_system_prompt: str = ""
+
+        # 可選擇的 AI 模型設定字典
+        # Dictionary of choosable AI model configurations
+        # 結構: { "AI_model": { "ai_base_url": ..., "ai_api_key": ..., "chat_model": ..., "prompt_template": ... } }
         self.choosable_ai: dict[str, dict[str, str]] = {
             "AI_model": {
-                "ai_base_url": "",
-                "ai_api_key": "",
-                "chat_model": "",
-                "prompt_template": "",
+                "ai_base_url": "",       # AI 服務的基礎 URL / Base URL of AI service
+                "ai_api_key": "",        # API 金鑰 / API key
+                "chat_model": "",        # 模型名稱 / Model name
+                "prompt_template": "",   # 提示詞模板 / Prompt template
             }
         }
+
+        # 訊息佇列，用來暫存與 AI 的互動訊息
+        # Message queue for storing AI interaction messages
         self.message_queue = Queue()
 
 
-ai_config = AIConfig()
+# 建立全域唯一的 AIConfig 實例
+# Create a global singleton instance of AIConfig
+ai_config = AIConfig()

je_editor/pyside_ui/main_ui/ai_widget/ask_thread.py

@@ -5,13 +5,32 @@ from je_editor.pyside_ui.main_ui.ai_widget.langchain_interface import LangChainI
 
 
 class AskThread(Thread):
+    """
+    AskThread 類別：用來在背景執行緒中呼叫 AI 模型，避免阻塞主執行緒
+    AskThread class: runs AI model calls in a background thread to avoid blocking the main thread
+    """
 
     def __init__(self, lang_chain_interface: LangChainInterface, prompt):
+        """
+        初始化 AskThread
+        Initialize AskThread
+        :param lang_chain_interface: LangChainInterface 實例，用來呼叫 AI 模型
+                                     LangChainInterface instance for calling AI model
+        :param prompt: 傳給 AI 模型的提示詞
+                       Prompt to send to the AI model
+        """
         super().__init__()
         self.lang_chain_interface = lang_chain_interface
         self.prompt = prompt
 
-
     def run(self):
+        """
+        執行緒的主要邏輯：
+        1. 呼叫 AI 模型並取得回應
+        2. 將回應放入 ai_config 的 message_queue 中，供主程式使用
+        Thread main logic:
+        1. Call AI model and get response
+        2. Put response into ai_config.message_queue for main program to consume
+        """
         ai_response = self.lang_chain_interface.call_ai_model(prompt=self.prompt)
         ai_config.message_queue.put(ai_response)

je_editor/pyside_ui/main_ui/ai_widget/chat_ui.py

@@ -23,73 +23,86 @@ class ChatUI(QWidget):
 
     def __init__(self, main_window: EditorMain):
         super().__init__()
-        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
+        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)  # 關閉視窗時自動釋放資源 / Auto delete on close
         self.main_window = main_window
-        # Chat panel
-        self.chat_panel = QPlainTextEdit()
-        self.chat_panel.setLineWrapMode(self.chat_panel.LineWrapMode.NoWrap)
-        self.chat_panel.setReadOnly(True)
-        self.chat_panel_scroll_area = QScrollArea()
+
+        # ---------------- Chat Panel 聊天面板 ----------------
+        self.chat_panel = QPlainTextEdit()  # 顯示聊天訊息的文字框 / Text area for chat messages
+        self.chat_panel.setLineWrapMode(self.chat_panel.LineWrapMode.NoWrap)  # 不自動換行 / Disable line wrap
+        self.chat_panel.setReadOnly(True)  # 設為唯讀，避免使用者直接輸入 / Read-only
+        self.chat_panel_scroll_area = QScrollArea()  # 加入滾動區域 / Scroll area for chat panel
         self.chat_panel_scroll_area.setWidgetResizable(True)
         self.chat_panel_scroll_area.setViewportMargins(0, 0, 0, 0)
         self.chat_panel_scroll_area.setWidget(self.chat_panel)
-        self.chat_panel.setFont(QFontDatabase.font(self.font().family(), "", 16))
-        # Prompt input
-        self.prompt_input = QLineEdit()
+        self.chat_panel.setFont(QFontDatabase.font(self.font().family(), "", 16))  # 設定字體大小 / Set font size
+
+        # ---------------- Prompt Input 輸入框 ----------------
+        self.prompt_input = QLineEdit()  # 使用者輸入提示詞 / Input field for prompts
         self.prompt_input.setSizePolicy(QSizePolicy.Policy.Expanding, QSizePolicy.Policy.Minimum)
-        self.prompt_input.returnPressed.connect(self.call_ai_model)
-        # Font size combobox
-        self.font_size_label = QLabel(language_wrapper.language_word_dict.get("font_size"))
-        self.font_size_combobox = QComboBox()
-        for font_size in range(2, 101, 2):
+        self.prompt_input.returnPressed.connect(self.call_ai_model)  # 按 Enter 時呼叫 AI / Call AI on Enter
+
+        # ---------------- Font Size Combobox 字體大小選單 ----------------
+        self.font_size_label = QLabel(language_wrapper.language_word_dict.get("font_size"))  # 標籤 / Label
+        self.font_size_combobox = QComboBox()  # 下拉選單 / Dropdown for font size
+        for font_size in range(2, 101, 2):  # 提供 2~100 的字體大小選項 / Font size options
             self.font_size_combobox.addItem(str(font_size))
-        self.font_size_combobox.setCurrentText("16")
+        self.font_size_combobox.setCurrentText("16")  # 預設字體大小 / Default font size
         self.font_size_combobox.currentTextChanged.connect(self.update_panel_text_size)
-        # Buttons
+
+        # ---------------- Buttons 按鈕 ----------------
         self.set_ai_config_button = QPushButton(language_wrapper.language_word_dict.get("chat_ui_set_ai_button"))
-        self.set_ai_config_button.clicked.connect(self.set_ai_config)
+        self.set_ai_config_button.clicked.connect(self.set_ai_config)  # 開啟 AI 設定視窗 / Open AI config dialog
+
         self.load_ai_config_button = QPushButton(language_wrapper.language_word_dict.get("chat_ui_load_ai_button"))
-        self.load_ai_config_button.clicked.connect(lambda: self.load_ai_config(show_load_complete=True))
+        self.load_ai_config_button.clicked.connect(lambda: self.load_ai_config(show_load_complete=True))  # 載入設定 / Load config
+
         self.call_ai_model_button = QPushButton(language_wrapper.language_word_dict.get("chat_ui_call_ai_model_button"))
-        self.call_ai_model_button.clicked.connect(self.call_ai_model)
-        # Add to layout
+        self.call_ai_model_button.clicked.connect(self.call_ai_model)  # 呼叫 AI / Call AI
+
+        # ---------------- Layout 版面配置 ----------------
         self.grid_layout = QGridLayout()
-        self.grid_layout.addWidget(self.chat_panel_scroll_area, 0, 0, 1, 4)
-        self.grid_layout.addWidget(self.call_ai_model_button, 1, 0)
-        self.grid_layout.addWidget(self.font_size_combobox, 1, 1)
-        self.grid_layout.addWidget(self.set_ai_config_button, 1, 2)
-        self.grid_layout.addWidget(self.load_ai_config_button, 1, 3)
-        self.grid_layout.addWidget(self.prompt_input, 2, 0, 1, 4)
-
-        # Variable
-        self.ai_config: AIConfig = ai_config
-        self.lang_chain_interface: Union[LangChainInterface, None] = None
-        self.set_ai_config_dialog = None
-        # Timer to pop queue
-        self.pull_message_timer = QTimer(self)
-        self.pull_message_timer.setInterval(1000)
+        self.grid_layout.addWidget(self.chat_panel_scroll_area, 0, 0, 1, 4)  # 聊天面板 / Chat panel
+        self.grid_layout.addWidget(self.call_ai_model_button, 1, 0)  # 呼叫 AI 按鈕 / Call AI button
+        self.grid_layout.addWidget(self.font_size_combobox, 1, 1)  # 字體大小選單 / Font size combobox
+        self.grid_layout.addWidget(self.set_ai_config_button, 1, 2)  # 設定 AI 按鈕 / Set AI config button
+        self.grid_layout.addWidget(self.load_ai_config_button, 1, 3)  # 載入設定按鈕 / Load AI config button
+        self.grid_layout.addWidget(self.prompt_input, 2, 0, 1, 4)  # 輸入框 / Prompt input
+
+        # ---------------- Variables 變數 ----------------
+        self.ai_config: AIConfig = ai_config  # AI 設定物件 / AI config object
+        self.lang_chain_interface: Union[LangChainInterface, None] = None  # LangChain 介面 / LangChain interface
+        self.set_ai_config_dialog = None  # 設定對話框 / Config dialog
+
+        # ---------------- Timer 計時器 ----------------
+        self.pull_message_timer = QTimer(self)  # 定時檢查訊息佇列 / Timer to pull messages
+        self.pull_message_timer.setInterval(1000)  # 每秒檢查一次 / Check every 1 second
         self.pull_message_timer.timeout.connect(self.pull_message)
         self.pull_message_timer.start()
 
-        # Set layout
+        # ---------------- Set Layout 設定版面 ----------------
         self.setLayout(self.grid_layout)
 
+        # ---------------- Load AI Config 載入 AI 設定 ----------------
         self.load_ai_config()
 
+    # 更新聊天面板字體大小 / Update chat panel font size
     def update_panel_text_size(self):
         self.chat_panel.setFont(
             QFontDatabase.font(self.font().family(), "", int(self.font_size_combobox.currentText())))
 
+    # 載入 AI 設定檔 / Load AI configuration file
     def load_ai_config(self, show_load_complete: bool = False):
         ai_config_file = Path(str(Path.cwd()) + "/" + ".jeditor/ai_config.json")
         if ai_config_file.exists():
             with open(ai_config_file, "r", encoding="utf-8"):
                 json_data: dict = read_json(str(ai_config_file))
             if json_data:
+                # 確認 AI_model 設定存在且格式正確 / Ensure AI_model config exists and valid
                 if json_data.get("AI_model") and len(json_data.get("AI_model")) == 4:
                     ai_info: dict = json_data.get("AI_model")
                     if ai_info.get("ai_base_url") and ai_info.get("chat_model"):
-                        ai_config.choosable_ai.update(json_data)
+                        ai_config.choosable_ai.update(json_data)  # 更新全域設定 / Update global config
+                    # 建立 LangChain 介面 / Initialize LangChain interface
                     self.lang_chain_interface = LangChainInterface(
                         main_window=self,
                         api_key=ai_info.get("ai_api_key"),
@@ -103,12 +116,14 @@ class ChatUI(QWidget):
                 load_complete.setText(language_wrapper.language_word_dict.get("load_ai_messagebox_text"))
                 load_complete.exec()
 
-
+    # 呼叫 AI 模型 / Call AI model
     def call_ai_model(self):
         if isinstance(self.lang_chain_interface, LangChainInterface):
+            # 建立新執行緒處理 AI 請求 / Start a new thread for AI request
             thread = AskThread(lang_chain_interface=self.lang_chain_interface, prompt=self.prompt_input.text())
             thread.start()
         else:
+            # 若未正確設定 AI，顯示錯誤訊息 / Show error if AI not configured
             ai_info = ai_config.choosable_ai.get('AI_model')
             QMessageBox.warning(self,
                                 language_wrapper.language_word_dict.get("call_ai_model_error_title"),
@@ -118,13 +133,13 @@ class ChatUI(QWidget):
                                     f"chat_model: {ai_info.get('chat_model')}, \n"
                                     f"prompt_template: {ai_info.get('prompt_template')}"))
 
+    # 從訊息佇列中取出 AI 回覆並顯示 / Pull AI response from queue
     def pull_message(self):
         if not ai_config.message_queue.empty():
             ai_response = ai_config.message_queue.get_nowait()
-            self.chat_panel.appendPlainText(ai_response)
+            self.chat_panel.appendPlainText(ai_response)  # 顯示回覆 / Display response
             self.chat_panel.appendPlainText("\n")
 
+    # 開啟 AI 設定對話框 / Open AI config dialog
     def set_ai_config(self):
-        # Set and output AI a config file
-        self.set_ai_config_dialog = SetAIDialog()
-        self.set_ai_config_dialog.show()
+        self.set_ai_config