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

je_editor/pyside_ui/main_ui/console_widget/qprocess_adapter.py

@@ -0,0 +1,84 @@
+import os
+
+from PySide6.QtCore import QObject, QProcess, Signal, QTimer
+
+
+class ConsoleProcessAdapter(QObject):
+    """
+    ConsoleProcessAdapter 負責管理 QProcess，提供互動式 shell 的啟動、指令傳送與輸出監聽。
+    ConsoleProcessAdapter manages QProcess, providing interactive shell start, command sending, and output handling.
+    """
+
+    # 定義訊號 / Define signals
+    started = Signal()  # 當子程序啟動時發射 / Emitted when process starts
+    finished = Signal(int, QProcess.ExitStatus)  # 當子程序結束時發射 / Emitted when process finishes
+    stdout = Signal(str)  # 標準輸出訊號 / Standard output signal
+    stderr = Signal(str)  # 錯誤輸出訊號 / Standard error signal
+    system = Signal(str)  # 系統訊息訊號 / System message signal
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        # 建立 QProcess 物件 / Create QProcess object
+        self.proc = QProcess(self)
+        # 設定輸出通道分離 (stdout / stderr) / Separate stdout and stderr
+        self.proc.setProcessChannelMode(QProcess.ProcessChannelMode.SeparateChannels)
+
+        # 綁定事件處理函式 / Connect signals to handlers
+        self.proc.readyReadStandardOutput.connect(self._on_stdout)
+        self.proc.readyReadStandardError.connect(self._on_stderr)
+        self.proc.started.connect(self.started)
+        self.proc.finished.connect(self.finished)
+
+    # 設定工作目錄 / Set working directory
+    def set_cwd(self, path: str):
+        self.proc.setWorkingDirectory(path)
+
+    # 啟動 shell / Start shell
+    def start_shell(self, shell: str = "auto"):
+        if self.is_running():
+            self.system.emit("Shell already running")  # 如果已經在執行，發送提示 / Emit message if already running
+            return
+        program, args = self._build_shell_command(shell)  # 建立 shell 指令 / Build shell command
+        self.proc.start(program, args)  # 啟動子程序 / Start process
+
+        # Windows 特殊處理：設定 UTF-8 編碼 / Windows-specific: set UTF-8 encoding
+        if os.name == "nt":
+            QTimer.singleShot(500, lambda: self.send_command("chcp 65001"))
+
+    # 傳送指令到 shell / Send command to shell
+    def send_command(self, cmd: str):
+        if not self.is_running():
+            self.system.emit("Shell not running")  # 如果 shell 未啟動，發送提示 / Emit message if not running
+            return
+        self.proc.write((cmd + "\n").encode("utf-8"))  # 傳送指令並換行 / Send command with newline
+
+    # 停止 shell / Stop shell
+    def stop(self):
+        if not self.is_running():
+            return
+        self.proc.terminate()  # 嘗試正常結束 / Try graceful termination
+        # 如果 1 秒後仍在執行，強制 kill / Force kill if still running after 1s
+        QTimer.singleShot(1000, lambda: self.is_running() and self.proc.kill())
+
+    # 判斷是否正在執行 / Check if process is running
+    def is_running(self):
+        return self.proc.state() != QProcess.ProcessState.NotRunning
+
+    # 處理標準輸出 / Handle standard output
+    def _on_stdout(self):
+        self.stdout.emit(bytes(self.proc.readAllStandardOutput()).decode("utf-8", errors="replace"))
+
+    # 處理錯誤輸出 / Handle standard error
+    def _on_stderr(self):
+        self.stderr.emit(bytes(self.proc.readAllStandardError()).decode("utf-8", errors="replace"))
+
+    # 建立 shell 指令 / Build shell command
+    def _build_shell_command(self, shell: str):
+        if shell == "auto":
+            shell = "cmd" if os.name == "nt" else "bash"  # Windows 預設 cmd，Linux/macOS 預設 bash
+        if os.name == "nt":
+            if shell == "powershell":
+                return "powershell.exe", ["-NoLogo", "-NoProfile", "-ExecutionPolicy", "Bypass"]
+            return "cmd.exe", []
+        # Linux/macOS 預設 bash，否則使用 sh / Default bash, fallback to sh
+        return ("/bin/bash" if shell == "bash" else "/bin/sh"), []

je_editor/pyside_ui/main_ui/dock/destroy_dock.py

@@ -0,0 +1,50 @@
+from PySide6.QtCore import Qt
+from PySide6.QtWidgets import QDockWidget
+
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+
+class DestroyDock(QDockWidget):
+    """
+    DestroyDock 繼承自 QDockWidget，主要用於建立一個可停駐的視窗，
+    並在關閉時自動釋放資源與記錄日誌。
+
+    DestroyDock inherits from QDockWidget, mainly used to create a dockable window,
+    and automatically release resources and log events when closed.
+    """
+
+    def __init__(self):
+        # 初始化時記錄日誌 / Log initialization
+        jeditor_logger.info("Init DestroyDock")
+        super().__init__()
+
+        # 設定允許停駐的區域 (可停駐在所有邊)
+        # Allow docking in all areas (top, bottom, left, right)
+        self.setAllowedAreas(Qt.DockWidgetArea.AllDockWidgetAreas)
+
+        # 設定屬性：當視窗關閉時，自動刪除物件以釋放記憶體
+        # Set attribute: delete object on close to free memory
+        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
+
+    def closeEvent(self, event) -> None:
+        """
+        覆寫 closeEvent，在關閉時額外處理：
+        - 記錄關閉事件
+        - 關閉內部 widget
+        - 呼叫父類別的 close()
+
+        Override closeEvent to:
+        - Log the close event
+        - Close the internal widget
+        - Call parent close()
+        """
+        # 記錄關閉事件 / Log close event
+        jeditor_logger.info(f"DestroyDock closeEvent event: {event}")
+
+        # 關閉 dock 內部的 widget，確保資源釋放
+        # Close the internal widget to ensure resource release
+        self.widget().close()
+
+        # 呼叫父類別的 close()，完成 Qt 預設的關閉流程
+        # Call parent close() to complete default Qt closing process
+        super().close()

je_editor/pyside_ui/main_ui/editor/editor_widget.py

@@ -0,0 +1,301 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from PySide6.QtGui import QTextCharFormat
+
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+if TYPE_CHECKING:
+    from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+    from je_editor.pyside_ui.code.shell_process.shell_exec import ShellManager
+    from je_editor.pyside_ui.code.code_process.code_exec import ExecManager
+
+import pathlib
+from pathlib import Path
+from typing import Union
+
+from PySide6.QtCore import Qt, QFileInfo, QDir
+from PySide6.QtWidgets import QWidget, QGridLayout, QSplitter, QScrollArea, QFileSystemModel, QTreeView, QTabWidget, \
+    QMessageBox
+
+from je_editor.pyside_ui.code.auto_save.auto_save_manager import auto_save_manager_dict, init_new_auto_save_thread, \
+    file_is_open_manager_dict
+from je_editor.pyside_ui.code.auto_save.auto_save_thread import CodeEditSaveThread
+from je_editor.pyside_ui.code.code_format.pep8_format import PEP8FormatChecker
+from je_editor.pyside_ui.code.plaintext_code_edit.code_edit_plaintext import CodeEditor
+from je_editor.pyside_ui.code.textedit_code_result.code_record import CodeRecord
+from je_editor.pyside_ui.main_ui.save_settings.user_color_setting_file import actually_color_dict
+from je_editor.pyside_ui.main_ui.save_settings.user_setting_file import user_setting_dict
+from je_editor.utils.file.open.open_file import read_file
+
+
+class EditorWidget(QWidget):
+    """
+    EditorWidget 是主要的程式碼編輯器元件，包含：
+    - 專案檔案樹狀檢視
+    - 程式碼編輯區
+    - 執行結果、格式檢查、除錯輸出
+    - 自動儲存與檔案管理
+
+    EditorWidget is the main code editor widget, including:
+    - Project file tree view
+    - Code editing area
+    - Execution result, format check, debugger output
+    - Auto-save and file management
+    """
+
+    def __init__(self, main_window: EditorMain):
+        jeditor_logger.info(f"Init EditorWidget main_window: {main_window}")
+        super().__init__()
+        # ---------------- Init variables 初始化變數 ----------------
+        self.checker: Union[PEP8FormatChecker, None] = None
+        self.current_file = None
+        self.tree_view_scroll_area = None
+        self.project_treeview: Union[QTreeView, None] = None
+        self.project_treeview_model = None
+        self.python_compiler = None
+        self.main_window = main_window
+        self.tab_manager = self.main_window.tab_widget
+
+        # 執行相關物件 / Execution related objects
+        self.exec_program: Union[None, ExecManager] = None
+        self.exec_shell: Union[None, ShellManager] = None
+        self.exec_python_debugger: Union[None, ExecManager] = None
+
+        # 自動儲存執行緒 / Auto-save thread
+        self.code_save_thread: Union[CodeEditSaveThread, None] = None
+
+        # ---------------- UI 初始化 ----------------
+        self.grid_layout = QGridLayout(self)
+        self.setWindowTitle(language_wrapper.language_word_dict.get("application_name"))
+
+        # 建立專案檔案樹狀檢視 / Setup project tree view
+        self.set_project_treeview()
+
+        # 主分割器 (左：檔案樹，右：編輯器) / Main splitter (left: tree, right: editor)
+        self.full_splitter = QSplitter()
+        self.full_splitter.setOrientation(Qt.Orientation.Horizontal)
+
+        # 編輯器分割器 (上：編輯器，下：輸出) / Editor splitter (top: editor, bottom: output)
+        self.edit_splitter = QSplitter(self.full_splitter)
+        self.edit_splitter.setOrientation(Qt.Orientation.Vertical)
+
+        # 程式碼編輯器與輸出區 / Code editor and result area
+        self.code_edit = CodeEditor(self)
+        self.code_result = CodeRecord()
+        self.code_result_cursor = self.code_result.textCursor()
+
+        # 捲動區包裝編輯器與輸出 / Scroll areas for editor and result
+        self.code_edit_scroll_area = QScrollArea()
+        self.code_edit_scroll_area.setWidgetResizable(True)
+        self.code_edit_scroll_area.setViewportMargins(0, 0, 0, 0)
+        self.code_edit_scroll_area.setWidget(self.code_edit)
+
+        self.code_result_scroll_area = QScrollArea()
+        self.code_result_scroll_area.setWidgetResizable(True)
+        self.code_result_scroll_area.setViewportMargins(0, 0, 0, 0)
+        self.code_result_scroll_area.setWidget(self.code_result)
+
+        # 格式檢查與除錯輸出 / Format check and debugger output
+        self.format_check_result = CodeRecord()
+        self.debugger_result = CodeRecord()
+
+        # 輸出分頁 (執行結果 / 格式檢查 / 除錯) / Output tabs
+        self.code_difference_result = QTabWidget()
+        self.code_difference_result.addTab(
+            self.code_result_scroll_area, language_wrapper.language_word_dict.get("editor_code_result"))
+        self.code_difference_result.addTab(
+            self.format_check_result, language_wrapper.language_word_dict.get("editor_format_check"))
+        self.code_difference_result.addTab(
+            self.debugger_result, language_wrapper.language_word_dict.get("editor_debugger_input_title_label"))
+
+        # 加入分割器 / Add widgets to splitters
+        self.edit_splitter.addWidget(self.code_edit_scroll_area)
+        self.edit_splitter.addWidget(self.code_difference_result)
+        self.edit_splitter.setStretchFactor(0, 3)
+        self.edit_splitter.setStretchFactor(1, 1)
+        self.edit_splitter.setSizes([300, 100])
+
+        self.full_splitter.addWidget(self.project_treeview)
+        self.full_splitter.addWidget(self.edit_splitter)
+        self.full_splitter.setStretchFactor(0, 1)
+        self.full_splitter.setStretchFactor(1, 3)
+        self.full_splitter.setSizes([100, 300])
+
+        # 設定字體樣式 / Set font style
+        self.code_edit.setStyleSheet(
+            f"font-size: {user_setting_dict.get('font_size', 12)}pt;"
+            f"font-family: {user_setting_dict.get('font', 'Lato')};"
+        )
+        self.code_result.setStyleSheet(
+            f"font-size: {user_setting_dict.get('font_size', 12)}pt;"
+            f"font-family: {user_setting_dict.get('font', 'Lato')};"
+        )
+
+        # 加入主版面配置 / Add to main layout
+        self.grid_layout.addWidget(self.full_splitter)
+
+    # ---------------- Project Treeview ----------------
+    def set_project_treeview(self) -> None:
+        """
+        建立並設定專案檔案樹狀檢視
+        Setup and configure project file tree view
+        """
+        jeditor_logger.info("EditorWidget set_project_treeview")
+        self.project_treeview_model = QFileSystemModel()
+        self.project_treeview_model.setRootPath(QDir.currentPath())
+        self.project_treeview = QTreeView()
+        self.project_treeview.setModel(self.project_treeview_model)
+
+        # 設定根目錄 (工作目錄或當前路徑) / Set root directory (working dir or current path)
+        if self.main_window.working_dir is None:
+            self.project_treeview.setRootIndex(
+                self.project_treeview_model.index(str(Path.cwd()))
+            )
+        else:
+            self.project_treeview.setRootIndex(
+                self.project_treeview_model.index(self.main_window.working_dir)
+            )
+
+        # 包裝成可捲動區域 / Wrap in scroll area
+        self.tree_view_scroll_area = QScrollArea()
+        self.tree_view_scroll_area.setWidgetResizable(True)
+        self.tree_view_scroll_area.setViewportMargins(0, 0, 0, 0)
+        self.tree_view_scroll_area.setWidget(self.project_treeview)
+        self.grid_layout.addWidget(self.tree_view_scroll_area, 0, 0, 0, 1)
+
+        # 點擊檔案時觸發 / Connect click event
+        self.project_treeview.clicked.connect(self.treeview_click)
+
+    def check_is_open(self, path: Path):
+        """
+        檢查檔案是否已經開啟，如果已開啟則切換到該分頁。
+        Check if the file is already open, if yes then switch to that tab.
+        """
+        jeditor_logger.info(f"EditorWidget check_is_open path: {path}")
+        if file_is_open_manager_dict.get(str(path), None) is not None:
+            # 嘗試在分頁中找到對應的 EditorWidget
+            # Try to find the corresponding EditorWidget in tab manager
+            widget: QWidget = self.tab_manager.findChild(EditorWidget, str(path))
+            if widget is None:
+                # 如果找不到，代表之前的紀錄失效，移除紀錄
+                # If not found, remove stale record
+                file_is_open_manager_dict.pop(str(path), None)
+            else:
+                # 如果找到，直接切換到該分頁
+                # If found, switch to that tab
+                self.tab_manager.setCurrentWidget(widget)
+                return False
+        else:
+            # 如果檔案未開啟，加入紀錄
+            # If file not open, add to open manager dict
+            file_is_open_manager_dict.update({str(path): str(path)})
+            return True
+
+    def open_an_file(self, path: Path) -> bool:
+        """
+        開啟檔案並載入到編輯器。
+        Open a file and load it into the editor.
+
+        :param path: 檔案路徑 / File path
+        :return: 如果檔案已經開啟則回傳 False / Return False if file tab already exists
+        """
+        jeditor_logger.info(f"EditorWidget open_an_file path: {path}")
+        if not self.check_is_open(path):
+            return False
+
+        # 如果有自動儲存執行緒，暫時跳過這一輪
+        # If auto-save thread exists, skip this round
+        if self.code_save_thread:
+            self.code_save_thread.skip_this_round = True
+
+        # 讀取檔案內容 / Read file content
+        file, file_content = read_file(str(path))
+        self.code_edit.setPlainText(file_content)
+
+        # 更新目前檔案資訊 / Update current file info
+        self.current_file = file
+        self.code_edit.current_file = file
+        self.code_edit.reset_highlighter()
+
+        # 更新使用者設定中的最後開啟檔案 / Update last opened file in user settings
+        user_setting_dict.update({"last_file": str(self.current_file)})
+
+        # 啟動或更新自動儲存執行緒 / Start or update auto-save thread
+        if self.current_file is not None and self.code_save_thread is None:
+            init_new_auto_save_thread(self.current_file, self)
+        else:
+            self.code_save_thread.file = self.current_file
+            self.code_save_thread.skip_this_round = False
+
+        # 更新分頁標籤名稱 / Update tab title
+        self.rename_self_tab()
+        return True
+
+    def treeview_click(self) -> None:
+        """
+        當使用者點擊檔案樹中的項目時觸發。
+        Triggered when user clicks an item in the project tree view.
+        """
+        jeditor_logger.info("EditorWidget treeview_click")
+        clicked_item: QFileSystemModel = self.project_treeview.selectedIndexes()[0]
+        file_info: QFileInfo = self.project_treeview.model().fileInfo(clicked_item)
+        path = pathlib.Path(file_info.absoluteFilePath())
+        if path.is_file():
+            self.open_an_file(path)
+
+    def rename_self_tab(self):
+        """
+        將目前分頁的標籤名稱改為目前檔案名稱。
+        Rename the current tab to the current file name.
+        """
+        jeditor_logger.info("EditorWidget rename_self_tab")
+        if self.tab_manager.currentWidget() is self:
+            self.tab_manager.setTabText(
+                self.tab_manager.currentIndex(), str(Path(self.current_file)))
+            self.setObjectName(str(Path(self.current_file)))
+
+    def check_file_format(self):
+        """
+        檢查目前檔案的程式碼格式 (僅支援 Python)。
+        Check the code format of the current file (only supports Python).
+        """
+        if self.current_file:
+            jeditor_logger.info("EditorWidget check_file_format")
+            suffix_checker = Path(self.current_file).suffix
+            if suffix_checker == ".py":
+                # 使用 PEP8 格式檢查器 / Use PEP8 format checker
+                self.checker = PEP8FormatChecker(self.current_file)
+                self.checker.check_all_format()
+                self.format_check_result.setPlainText("")
+
+                # 顯示錯誤訊息並套用顏色 / Display errors with color formatting
+                for error in self.checker.error_list:
+                    text_cursor = self.format_check_result.textCursor()
+                    text_format = QTextCharFormat()
+                    text_format.setForeground(actually_color_dict.get("error_output_color"))
+                    text_cursor.insertText(error, text_format)
+                    text_cursor.insertBlock()
+                self.checker.error_list.clear()
+            else:
+                # 非 Python 檔案，顯示提示訊息 / Show message if not Python file
+                message_box = QMessageBox()
+                message_box.setText(
+                    language_wrapper.language_word_dict.get("python_format_checker_only_support_python_message"))
+                message_box.exec_()
+
+    def close(self) -> bool:
+        """
+        關閉編輯器，釋放資源並移除自動儲存紀錄。
+        Close the editor, release resources, and remove auto-save records.
+        """
+        jeditor_logger.info("EditorWidget close")
+        if self.code_save_thread is not None:
+            self.code_save_thread.still_run = False
+            self.code_save_thread = None
+        if self.current_file:
+            file_is_open_manager_dict.pop(str(Path(self.current_file)), None)
+            auto_save_manager_dict.pop(self.current_file, None)
+        return super().close()

je_editor/pyside_ui/main_ui/editor/editor_widget_dock.py

@@ -0,0 +1,70 @@
+from pathlib import Path
+
+from PySide6.QtCore import Qt
+from PySide6.QtWidgets import QWidget, QGridLayout, QScrollArea
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+
+from je_editor.pyside_ui.code.plaintext_code_edit.code_edit_plaintext import CodeEditor
+from je_editor.pyside_ui.main_ui.save_settings.user_setting_file import user_setting_dict
+from je_editor.utils.file.save.save_file import write_file
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+
+class FullEditorWidget(QWidget):
+    """
+    FullEditorWidget 提供一個完整的單檔編輯器介面，
+    包含程式碼編輯區、捲動支援，以及關閉時自動儲存功能。
+
+    FullEditorWidget provides a full single-file editor interface,
+    including code editing area, scroll support, and auto-save on close.
+    """
+
+    def __init__(self, current_file: str):
+        # 初始化時記錄日誌 / Log initialization
+        jeditor_logger.info(f"Init FullEditorWidget current_file: {current_file}")
+        super().__init__()
+
+        # ---------------- Init variable 初始化變數 ----------------
+        self.current_file = current_file  # 目前編輯的檔案路徑 / Current editing file path
+
+        # ---------------- Attributes 屬性設定 ----------------
+        # 設定關閉時自動刪除物件，釋放記憶體
+        # Delete object on close to free memory
+        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
+
+        # ---------------- UI 初始化 ----------------
+        self.grid_layout = QGridLayout(self)
+        self.setWindowTitle(language_wrapper.language_word_dict.get("application_name"))
+
+        # 建立程式碼編輯器並放入捲動區域
+        # Create code editor and put inside scroll area
+        self.code_edit = CodeEditor(self)
+        self.code_edit_scroll_area = QScrollArea()
+        self.code_edit_scroll_area.setWidgetResizable(True)
+        self.code_edit_scroll_area.setViewportMargins(0, 0, 0, 0)
+        self.code_edit_scroll_area.setWidget(self.code_edit)
+
+        # 將編輯器加入版面配置
+        # Add editor to layout
+        self.grid_layout.addWidget(self.code_edit_scroll_area, 0, 0)
+
+        # 設定字體樣式 (從使用者設定檔讀取)
+        # Set font style (from user settings)
+        self.code_edit.setStyleSheet(
+            f"font-size: {user_setting_dict.get('font_size', 12)}pt;"
+            f"font-family: {user_setting_dict.get('font', 'Lato')};"
+        )
+
+    def closeEvent(self, event) -> None:
+        """
+        覆寫 closeEvent，在關閉視窗時自動儲存檔案內容。
+        Override closeEvent to auto-save file content when closing window.
+        """
+        jeditor_logger.info(f"FullEditorWidget closeEvent event: {event}")
+        path = Path(self.current_file)
+        if path.exists() and path.is_file():
+            # 將編輯器內容寫回檔案 / Write editor content back to file
+            write_file(self.current_file, self.code_edit.toPlainText())
+        # 呼叫父類別的 closeEvent，完成 Qt 預設流程
+        # Call parent closeEvent to complete Qt default process
+        super().closeEvent(event)

je_editor/pyside_ui/main_ui/editor/process_input.py

@@ -0,0 +1,101 @@
+from __future__ import annotations  # 允許未來版本的型別註解功能 / Enable postponed evaluation of type annotations
+
+from typing import \
+    TYPE_CHECKING  # 用於避免循環匯入，僅在型別檢查時載入 / Used to avoid circular imports, only loaded during type checking
+
+from PySide6.QtCore import Qt  # Qt 核心模組 / Qt core module
+from PySide6.QtWidgets import QWidget, QLineEdit, QBoxLayout, QPushButton, QHBoxLayout
+
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+# 匯入 PySide6 的 GUI 元件 / Import GUI widgets from PySide6
+
+# 專案內的日誌紀錄器 / Project's logger instance
+
+if TYPE_CHECKING:
+    from je_editor.pyside_ui.main_ui.main_editor import EditorWidget
+    # 僅在型別檢查時匯入 EditorWidget，避免循環依賴 / Import only for type checking to avoid circular dependency
+
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+
+# 多語系支援工具 / Multi-language wrapper for UI text
+
+
+class ProcessInput(QWidget):
+    """
+    ProcessInput 是一個輸入視窗，允許使用者輸入指令並傳送到不同的子程序 (program/shell/debugger)。
+    ProcessInput is an input widget that allows users to send commands to different subprocesses.
+    """
+
+    def __init__(self, main_window: EditorWidget, process_type: str = "debugger"):
+        # 初始化時記錄日誌 / Log initialization
+        jeditor_logger.info("Init ProcessInput "
+                            f"main_window: {main_window} "
+                            f"process_type: {process_type}")
+        super().__init__()
+
+        # 設定當視窗關閉時自動刪除資源
+        # Set attribute to delete widget on close
+        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
+
+        # === UI 設定 / UI Setup ===
+        self.main_window = main_window  # 儲存主視窗參考 / Store reference to main window
+        self.box_layout = QBoxLayout(QBoxLayout.Direction.TopToBottom)  # 垂直佈局 / Vertical layout
+        self.command_input = QLineEdit()  # 輸入框 / Input field
+        self.send_command_button = QPushButton()  # 傳送按鈕 / Send button
+
+        # 設定按鈕文字 (多語系) / Set button text (multi-language)
+        self.send_command_button.setText(language_wrapper.language_word_dict.get("process_input_send_command"))
+
+        # 水平佈局，放置按鈕 / Horizontal layout for button
+        self.box_h_layout = QHBoxLayout()
+        self.box_h_layout.addWidget(self.send_command_button)
+
+        # 將元件加入主佈局 / Add widgets to main layout
+        self.box_layout.addWidget(self.command_input)
+        self.box_layout.addLayout(self.box_h_layout)
+
+        # 根據 process_type 設定不同的標題與功能 / Configure behavior based on process_type
+        if process_type == "program":
+            self.setWindowTitle(language_wrapper.language_word_dict.get("editor_program_input_title_label"))
+            self.send_command_button.clicked.connect(self.program_send_command)
+        elif process_type == "shell":
+            self.setWindowTitle(language_wrapper.language_word_dict.get("editor_shell_input_title_label"))
+            self.send_command_button.clicked.connect(self.shell_send_command)
+        else:  # 預設為 debugger / Default: debugger
+            self.setWindowTitle(language_wrapper.language_word_dict.get("editor_debugger_input_title_label"))
+            self.send_command_button.clicked.connect(self.debugger_send_command)
+            # 切換主視窗的顯示頁面到 debugger 結果 / Switch main window tab to debugger result
+            self.main_window.code_difference_result.setCurrentWidget(self.main_window.debugger_result)
+
+        # 設定主佈局 / Apply layout
+        self.setLayout(self.box_layout)
+
+    # === Debugger 指令傳送 / Send command to debugger ===
+    def debugger_send_command(self):
+        jeditor_logger.info("EditorWidget debugger_send_command")
+        if self.main_window.exec_python_debugger is not None:
+            process_stdin = self.main_window.exec_python_debugger.process.stdin
+            if process_stdin is not None:
+                # 將輸入框文字編碼後寫入子程序 stdin / Write encoded input to subprocess stdin
+                process_stdin.write(self.command_input.text().encode() + b"\n")
+                process_stdin.flush()
+
+    # === Shell 指令傳送 / Send command to shell ===
+    def shell_send_command(self):
+        jeditor_logger.info("EditorWidget shell_send_command")
+        if self.main_window.exec_shell is not None:
+            process_stdin = self.main_window.exec_shell.process.stdin
+            if process_stdin is not None:
+                process_stdin.write(self.command_input.text().encode() + b"\n")
+                process_stdin.flush()
+
+    # === Program 指令傳送 / Send command to program ===
+    def program_send_command(self):
+        jeditor_logger.info("EditorWidget program_send_command")
+        if self.main_window.exec_program is not None:
+            process_stdin = self.main_window.exec_program.process.stdin
+            if process_stdin is not None:
+                process_stdin.write(self.command_input.text().encode() + b"\n")
+                process_stdin.flush()