frontengine 1.0.54__tar.gz → 1.0.56__tar.gz

{frontengine-1.0.54 → frontengine-1.0.56}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.54
+Version: 1.0.56
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine

frontengine-1.0.56/frontengine/ui/dialog/how_to_use_dialog.py

@@ -0,0 +1,118 @@
+"""
+使用說明：在程式裡直接講清楚 FrontEngine 是什麼、第一個覆蓋層怎麼開出來、
+每個分頁共通的那幾個設定是什麼意思，以及東西開太多時怎麼一次收乾淨。
+
+刻意寫成「快速上手」而不是完整手冊——完整的在文件站上，最後一顆按鈕就是去那裡。
+使用者第一次打開程式時真正需要知道的，其實只有這幾件事。
+
+How to use: say in the application itself what FrontEngine is, how to get a
+first overlay on screen, what the settings every page shares actually mean, and
+how to clear everything away when there is too much of it.
+
+Deliberately a quick start rather than the whole manual - the manual is on the
+documentation site and the last button goes there. What someone opening this
+for the first time actually needs is only this much.
+"""
+from __future__ import annotations
+
+from typing import List, Optional, Tuple
+
+from PySide6.QtCore import Qt
+from PySide6.QtWidgets import (
+    QDialog, QDialogButtonBox, QLabel, QPushButton, QScrollArea, QVBoxLayout, QWidget,
+)
+
+from frontengine.utils.browser.browser import open_browser
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.multi_language.retranslate import retranslator, tr, translate
+
+DOC_URL = "https://frontengine.readthedocs.io/en/latest/"
+
+# (標題鍵, 標題預設, 內文鍵, 內文預設)
+SECTIONS: List[Tuple[str, str, str, str]] = [
+    ("how_to_use_start_title", "Your first overlay",
+     "how_to_use_start_body",
+     "Pick a tab for the kind of thing you want on screen - a video, an image, "
+     "a web page, some text - choose the file or address, then press the start "
+     "button on that page. It appears on top of everything else and stays there "
+     "until you close it."),
+    ("how_to_use_shared_title", "Settings every page shares",
+     "how_to_use_shared_body",
+     "Opacity decides how much of the desktop shows through. Target monitor "
+     "chooses the screen, or asks each time. Show on all screens puts a copy on "
+     "each monitor, and Show on all window bottom drops it beneath your windows "
+     "so it behaves like a backdrop rather than something in front."),
+    ("how_to_use_clicks_title", "Overlays do not get in the way",
+     "how_to_use_clicks_body",
+     "Clicks pass straight through an overlay to whatever is underneath, so the "
+     "window below keeps working normally. The two exceptions are the pet and "
+     "the drawing layer on the Presenting page, which need the mouse to do what "
+     "they do."),
+    ("how_to_use_control_title", "Managing several at once",
+     "how_to_use_control_body",
+     "The Control Center reaches every overlay, whichever page opened it: hide "
+     "them for a moment, mute them, lock them so they stop moving, or lower the "
+     "quality when the battery matters. Unlock them first if you want to drag "
+     "one somewhere else - it remembers where you dropped it."),
+    ("how_to_use_escape_title", "Clearing the screen",
+     "how_to_use_escape_body",
+     "Close all in the Control Center closes everything at once, and you can "
+     "bind a global shortcut to it under Settings, Hotkeys. If something ever "
+     "stops responding, pressing F12 shuts FrontEngine down immediately."),
+    ("how_to_use_more_title", "Keeping what you set up",
+     "how_to_use_more_body",
+     "The Presets menu saves how every page is configured under a name and "
+     "brings it back later, and one preset can be applied automatically at "
+     "startup. The Settings menu holds the rest: shortcuts, reminders, a phone "
+     "remote, screen-sharing privacy and more."),
+]
+
+
+class HowToUseDialog(QDialog):
+    """
+    使用說明。內容放在捲動區裡，視窗小的時候也讀得完。
+    A quick start, in a scroll area so it stays readable on a small window.
+    """
+
+    def __init__(self, parent: Optional[QWidget] = None) -> None:
+        front_engine_logger.info("[HowToUseDialog] Init")
+        super().__init__(parent)
+        self.setWindowTitle(translate("how_to_use_title", "How to use FrontEngine"))
+        retranslator.bind(self, "how_to_use_title", "How to use FrontEngine", "setWindowTitle")
+        self.resize(560, 520)
+
+        self.content = QWidget()
+        self.content_layout = QVBoxLayout(self.content)
+        self.intro_label = tr(
+            QLabel(), "how_to_use_intro",
+            "FrontEngine puts things on top of your screen - videos, images, web pages, "
+            "text, a desktop pet - and keeps them there while you work.")
+        self.intro_label.setWordWrap(True)
+        self.content_layout.addWidget(self.intro_label)
+
+        self.section_labels: List[QLabel] = []
+        for title_key, title_text, body_key, body_text in SECTIONS:
+            heading = tr(QLabel(), title_key, title_text)
+            heading.setStyleSheet("font-weight: bold; margin-top: 10px;")
+            body = tr(QLabel(), body_key, body_text)
+            body.setWordWrap(True)
+            self.content_layout.addWidget(heading)
+            self.content_layout.addWidget(body)
+            self.section_labels += [heading, body]
+        self.content_layout.addStretch(1)
+
+        self.scroll_area = QScrollArea()
+        self.scroll_area.setWidgetResizable(True)
+        self.scroll_area.setWidget(self.content)
+
+        self.button_box = QDialogButtonBox(QDialogButtonBox.StandardButton.Close)
+        self.doc_button = QPushButton()
+        tr(self.doc_button, "how_to_use_open_doc", "Full documentation")
+        self.doc_button.clicked.connect(lambda: open_browser(DOC_URL))
+        self.button_box.addButton(self.doc_button, QDialogButtonBox.ButtonRole.ActionRole)
+        self.button_box.rejected.connect(self.reject)
+
+        layout = QVBoxLayout(self)
+        layout.addWidget(self.scroll_area)
+        layout.addWidget(self.button_box)
+        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)

{frontengine-1.0.54 → frontengine-1.0.56}/frontengine/ui/menu/help_menu.py

@@ -5,6 +5,7 @@ from typing import TYPE_CHECKING
 from PySide6.QtGui import QAction
 from PySide6.QtWidgets import QMessageBox
 
+from frontengine.ui.dialog.how_to_use_dialog import HowToUseDialog
 from frontengine.utils.browser.browser import open_browser
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
@@ -26,6 +27,15 @@ def build_help_menu(ui_we_want_to_set: FrontEngineMainUI) -> None:
     ui_we_want_to_set.help_menu = help_menu
 
     # --- 建立動作 / Create actions ---
+    # 使用說明放第一個：第一次打開程式的人最先需要的就是它
+    # Usage first: it is what someone opening this for the first time needs.
+    _add_action(
+        help_menu,
+        "how_to_use_action",
+        lambda: show_how_to_use(ui_we_want_to_set),
+        "How to use..."
+    )
+
     _add_action(
         help_menu,
         "help_menu_open_issue",
@@ -52,6 +62,14 @@ def _add_action(menu, key: str, callback, fallback: str = "") -> QAction:
     return action
 
 
+def show_how_to_use(ui_we_want_to_set: FrontEngineMainUI) -> None:
+    """開啟使用說明對話框。"""
+    front_engine_logger.info("[HelpMenu] show_how_to_use")
+    dialog = HowToUseDialog(ui_we_want_to_set)
+    ui_we_want_to_set.how_to_use_dialog = dialog
+    dialog.show()
+
+
 def how_to_critical_exit(ui_we_want_to_set: FrontEngineMainUI) -> None:
     """
     顯示「如何強制退出」訊息

{frontengine-1.0.54 → frontengine-1.0.56}/frontengine/utils/multi_language/english.py

@@ -559,4 +559,21 @@ english_word_dict = {
     "whiteboard_save": 'Save whiteboard',
     "pet_audio_speakers": 'Speakers',
     "pet_audio_microphone": 'Microphone',
+    # How to use dialog
+    "how_to_use_action": "How to use...",
+    "how_to_use_title": "How to use FrontEngine",
+    "how_to_use_intro": "FrontEngine puts things on top of your screen - videos, images, web pages, text, a desktop pet - and keeps them there while you work.",
+    "how_to_use_start_title": "Your first overlay",
+    "how_to_use_start_body": "Pick a tab for the kind of thing you want on screen - a video, an image, a web page, some text - choose the file or address, then press the start button on that page. It appears on top of everything else and stays there until you close it.",
+    "how_to_use_shared_title": "Settings every page shares",
+    "how_to_use_shared_body": "Opacity decides how much of the desktop shows through. Target monitor chooses the screen, or asks each time. Show on all screens puts a copy on each monitor, and Show on all window bottom drops it beneath your windows so it behaves like a backdrop rather than something in front.",
+    "how_to_use_clicks_title": "Overlays do not get in the way",
+    "how_to_use_clicks_body": "Clicks pass straight through an overlay to whatever is underneath, so the window below keeps working normally. The two exceptions are the pet and the drawing layer on the Presenting page, which need the mouse to do what they do.",
+    "how_to_use_control_title": "Managing several at once",
+    "how_to_use_control_body": "The Control Center reaches every overlay, whichever page opened it: hide them for a moment, mute them, lock them so they stop moving, or lower the quality when the battery matters. Unlock them first if you want to drag one somewhere else - it remembers where you dropped it.",
+    "how_to_use_escape_title": "Clearing the screen",
+    "how_to_use_escape_body": "Close all in the Control Center closes everything at once, and you can bind a global shortcut to it under Settings, Hotkeys. If something ever stops responding, pressing F12 shuts FrontEngine down immediately.",
+    "how_to_use_more_title": "Keeping what you set up",
+    "how_to_use_more_body": "The Presets menu saves how every page is configured under a name and brings it back later, and one preset can be applied automatically at startup. The Settings menu holds the rest: shortcuts, reminders, a phone remote, screen-sharing privacy and more.",
+    "how_to_use_open_doc": "Full documentation",
 }

{frontengine-1.0.54 → frontengine-1.0.56}/frontengine/utils/multi_language/france.py

@@ -549,4 +549,21 @@ french_word_dict = {
     "whiteboard_save": "Enregistrer le tableau blanc",
     "pet_audio_speakers": "Haut-parleurs",
     "pet_audio_microphone": "Microphone",
+    # How to use dialog
+    "how_to_use_action": "Comment l'utiliser…",
+    "how_to_use_title": "Comment utiliser FrontEngine",
+    "how_to_use_intro": "FrontEngine place des choses par-dessus votre écran - vidéos, images, pages web, texte, une mascotte - et les y garde pendant que vous travaillez.",
+    "how_to_use_start_title": "Votre premier calque",
+    "how_to_use_start_body": "Choisissez l'onglet correspondant à ce que vous voulez afficher : une vidéo, une image, une page web, du texte. Indiquez le fichier ou l'adresse, puis appuyez sur le bouton de démarrage de cette page. Le calque apparaît par-dessus tout le reste et y demeure jusqu'à ce que vous le fermiez.",
+    "how_to_use_shared_title": "Les réglages communs à toutes les pages",
+    "how_to_use_shared_body": "L'opacité décide de ce que laisse voir le bureau. L'écran cible choisit le moniteur, ou demande à chaque fois. « Afficher sur tous les écrans » en place une copie par moniteur, et « Afficher sous toutes les fenêtres » le glisse sous vos fenêtres : il se comporte alors comme un fond plutôt que comme quelque chose devant.",
+    "how_to_use_clicks_title": "Les calques ne gênent pas",
+    "how_to_use_clicks_body": "Les clics traversent le calque jusqu'à ce qui se trouve dessous, la fenêtre en dessous continue donc de fonctionner normalement. Les deux exceptions sont la mascotte et le calque de dessin de la page Présentation, qui ont besoin de la souris pour faire ce qu'ils font.",
+    "how_to_use_control_title": "En gérer plusieurs à la fois",
+    "how_to_use_control_body": "Le Centre de contrôle atteint chaque calque, quelle que soit la page qui l'a ouvert : les masquer un instant, les couper, les verrouiller pour qu'ils cessent de bouger, ou baisser la qualité quand la batterie compte. Déverrouillez d'abord si vous voulez en déplacer un - il retient où vous l'avez déposé.",
+    "how_to_use_escape_title": "Dégager l'écran",
+    "how_to_use_escape_body": "« Tout fermer » dans le Centre de contrôle ferme tout d'un coup, et vous pouvez lui associer un raccourci global dans Réglages, Raccourcis clavier. Si quelque chose ne répond plus, la touche F12 arrête FrontEngine immédiatement.",
+    "how_to_use_more_title": "Conserver ce que vous avez réglé",
+    "how_to_use_more_body": "Le menu Préréglages enregistre sous un nom la configuration de toutes les pages et la retrouve plus tard ; un préréglage peut être appliqué automatiquement au démarrage. Le menu Réglages contient le reste : raccourcis, rappels, télécommande sur téléphone, confidentialité du partage d'écran et davantage.",
+    "how_to_use_open_doc": "Documentation complète",
 }

{frontengine-1.0.54 → frontengine-1.0.56}/frontengine/utils/multi_language/germany.py

@@ -552,4 +552,21 @@ germany_word_dict = {
     "whiteboard_save": "Whiteboard speichern",
     "pet_audio_speakers": "Lautsprecher",
     "pet_audio_microphone": "Mikrofon",
+    # How to use dialog
+    "how_to_use_action": "Bedienung …",
+    "how_to_use_title": "FrontEngine bedienen",
+    "how_to_use_intro": "FrontEngine legt Dinge über Ihren Bildschirm - Videos, Bilder, Webseiten, Text, ein Haustier - und lässt sie dort, während Sie arbeiten.",
+    "how_to_use_start_title": "Ihr erstes Overlay",
+    "how_to_use_start_body": "Wählen Sie die Registerkarte für das, was Sie sehen möchten - ein Video, ein Bild, eine Webseite, etwas Text - dann die Datei oder die Adresse, und drücken Sie auf dieser Seite die Start-Schaltfläche. Es erscheint über allem anderen und bleibt dort, bis Sie es schließen.",
+    "how_to_use_shared_title": "Einstellungen, die jede Seite teilt",
+    "how_to_use_shared_body": "Die Deckkraft bestimmt, wie viel vom Schreibtisch durchscheint. Der Zielbildschirm wählt den Monitor oder fragt jedes Mal nach. „Auf allen Bildschirmen zeigen“ legt je Monitor eine Kopie an, und „Unter allen Fenstern zeigen“ schiebt es unter Ihre Fenster, sodass es wie ein Hintergrund wirkt statt wie etwas davor.",
+    "how_to_use_clicks_title": "Overlays stehen nicht im Weg",
+    "how_to_use_clicks_body": "Klicks gehen glatt durch ein Overlay hindurch auf das, was darunter liegt; das Fenster darunter funktioniert also weiter wie gewohnt. Die beiden Ausnahmen sind das Haustier und die Zeichenebene auf der Seite „Präsentieren“, die die Maus brauchen, um überhaupt etwas zu tun.",
+    "how_to_use_control_title": "Mehrere auf einmal verwalten",
+    "how_to_use_control_body": "Das Kontrollzentrum erreicht jedes Overlay, gleich von welcher Seite geöffnet: kurz ausblenden, stummschalten, sperren, damit sie sich nicht mehr bewegen, oder die Qualität senken, wenn der Akku zählt. Zum Verschieben zuerst entsperren - wo Sie es ablegen, merkt es sich.",
+    "how_to_use_escape_title": "Den Bildschirm frei räumen",
+    "how_to_use_escape_body": "„Alles schließen“ im Kontrollzentrum schließt alles auf einmal, und unter Einstellungen, Tastenkürzel lässt sich dafür ein globales Kürzel hinterlegen. Falls einmal etwas nicht mehr reagiert, beendet F12 FrontEngine sofort.",
+    "how_to_use_more_title": "Behalten, was Sie eingerichtet haben",
+    "how_to_use_more_body": "Das Menü „Voreinstellungen“ sichert unter einem Namen, wie jede Seite eingestellt ist, und holt es später zurück; eine Voreinstellung lässt sich beim Start automatisch anwenden. Im Menü „Einstellungen“ steht der Rest: Tastenkürzel, Erinnerungen, eine Fernsteuerung fürs Telefon, Privatsphäre beim Bildschirmteilen und mehr.",
+    "how_to_use_open_doc": "Vollständige Dokumentation",
 }

{frontengine-1.0.54 → frontengine-1.0.56}/frontengine/utils/multi_language/italy.py

@@ -549,4 +549,21 @@ italian_word_dict = {
     "whiteboard_save": "Salva la lavagna",
     "pet_audio_speakers": "Altoparlanti",
     "pet_audio_microphone": "Microfono",
+    # How to use dialog
+    "how_to_use_action": "Come si usa…",
+    "how_to_use_title": "Come si usa FrontEngine",
+    "how_to_use_intro": "FrontEngine mette cose sopra il tuo schermo - video, immagini, pagine web, testo, una mascotte - e ce le lascia mentre lavori.",
+    "how_to_use_start_title": "Il tuo primo overlay",
+    "how_to_use_start_body": "Scegli la scheda corrispondente a ciò che vuoi vedere: un video, un'immagine, una pagina web, del testo. Indica il file o l'indirizzo, poi premi il pulsante di avvio di quella pagina. Comparirà sopra a tutto il resto e resterà lì finché non lo chiudi.",
+    "how_to_use_shared_title": "Le impostazioni comuni a tutte le pagine",
+    "how_to_use_shared_body": "L'opacità decide quanto traspare la scrivania. Lo schermo di destinazione sceglie il monitor, o lo chiede ogni volta. «Mostra su tutti gli schermi» ne mette una copia per monitor, e «Mostra sotto tutte le finestre» lo infila sotto le tue finestre, così si comporta da sfondo anziché da qualcosa davanti.",
+    "how_to_use_clicks_title": "Gli overlay non danno fastidio",
+    "how_to_use_clicks_body": "I clic passano attraverso l'overlay fino a ciò che sta sotto, quindi la finestra sottostante continua a funzionare normalmente. Le due eccezioni sono la mascotte e il livello di disegno nella pagina Presentazione, che del mouse hanno bisogno per fare quello che fanno.",
+    "how_to_use_control_title": "Gestirne diversi insieme",
+    "how_to_use_control_body": "Il Centro di controllo raggiunge ogni overlay, da qualunque pagina sia stato aperto: nasconderli un momento, silenziarli, bloccarli perché smettano di muoversi, o abbassare la qualità quando conta la batteria. Per spostarne uno sbloccalo prima: si ricorda dove lo hai lasciato.",
+    "how_to_use_escape_title": "Liberare lo schermo",
+    "how_to_use_escape_body": "«Chiudi tutto» nel Centro di controllo chiude ogni cosa in una volta, e in Impostazioni, Scorciatoie puoi assegnargli una combinazione globale. Se qualcosa smette di rispondere, F12 chiude subito FrontEngine.",
+    "how_to_use_more_title": "Conservare ciò che hai impostato",
+    "how_to_use_more_body": "Il menu Preimpostazioni salva sotto un nome come sono configurate tutte le pagine e le riporta in seguito; una preimpostazione può essere applicata automaticamente all'avvio. Nel menu Impostazioni c'è il resto: scorciatoie, promemoria, telecomando dal telefono, privacy nella condivisione schermo e altro.",
+    "how_to_use_open_doc": "Documentazione completa",
 }

{frontengine-1.0.54 → frontengine-1.0.56}/frontengine/utils/multi_language/russian.py

@@ -549,4 +549,21 @@ russian_word_dict = {
     "whiteboard_save": "Сохранить доску",
     "pet_audio_speakers": "Динамики",
     "pet_audio_microphone": "Микрофон",
+    # How to use dialog
+    "how_to_use_action": "Как пользоваться…",
+    "how_to_use_title": "Как пользоваться FrontEngine",
+    "how_to_use_intro": "FrontEngine размещает поверх экрана видео, изображения, веб-страницы, текст, питомца - и держит их там, пока вы работаете.",
+    "how_to_use_start_title": "Первый слой",
+    "how_to_use_start_body": "Выберите вкладку по тому, что хотите увидеть: видео, изображение, веб-страницу или текст. Укажите файл либо адрес и нажмите на этой вкладке кнопку запуска. Слой появится поверх всего остального и останется там, пока вы его не закроете.",
+    "how_to_use_shared_title": "Настройки, общие для всех вкладок",
+    "how_to_use_shared_body": "Непрозрачность решает, насколько просвечивает рабочий стол. Целевой экран выбирает монитор или спрашивает каждый раз. «Показывать на всех экранах» кладёт по копии на каждый монитор, а «Показывать под всеми окнами» уводит слой под ваши окна, и он ведёт себя как задник, а не как что-то спереди.",
+    "how_to_use_clicks_title": "Слои не мешают",
+    "how_to_use_clicks_body": "Щелчки проходят сквозь слой к тому, что под ним, поэтому нижнее окно работает как обычно. Исключений два: питомец и слой рисования на вкладке «Презентация» - им мышь нужна по сути дела.",
+    "how_to_use_control_title": "Управление сразу несколькими",
+    "how_to_use_control_body": "Центр управления дотягивается до каждого слоя, какой бы вкладкой он ни был открыт: ненадолго скрыть, выключить звук, заблокировать, чтобы не двигались, или снизить качество, когда важна батарея. Чтобы перетащить слой, сначала разблокируйте - он запомнит, где вы его оставили.",
+    "how_to_use_escape_title": "Очистить экран",
+    "how_to_use_escape_body": "«Закрыть всё» в Центре управления закрывает сразу всё, а в «Настройках», «Горячих клавишах» этому можно назначить глобальное сочетание. Если что-то перестало отвечать, F12 немедленно завершает FrontEngine.",
+    "how_to_use_more_title": "Сохранить то, что настроили",
+    "how_to_use_more_body": "Меню «Пресеты» сохраняет под именем настройки всех вкладок и возвращает их позже; один пресет можно применять автоматически при запуске. В меню «Настройки» остальное: горячие клавиши, напоминания, пульт для телефона, приватность при показе экрана и прочее.",
+    "how_to_use_open_doc": "Полная документация",
 }

{frontengine-1.0.54 → frontengine-1.0.56}/frontengine/utils/multi_language/simplified_chinese.py

@@ -551,4 +551,21 @@ simplified_chinese_word_dict = {
     "whiteboard_save": "储存白板",
     "pet_audio_speakers": "喇叭",
     "pet_audio_microphone": "麦克风",
+    # How to use dialog
+    "how_to_use_action": "使用说明…",
+    "how_to_use_title": "FrontEngine 使用说明",
+    "how_to_use_intro": "FrontEngine 把东西放在你的画面最上层——视频、图片、网页、文字、桌面宠物——并且在你工作的时候一直留在那里。",
+    "how_to_use_start_title": "打开第一个覆盖层",
+    "how_to_use_start_body": "先挑一个标签页，看你想放什么：视频、图片、网页还是文字。选好文件或网址，再按那一页的开始按钮。它就会出现在所有东西之上，直到你把它关掉为止。",
+    "how_to_use_shared_title": "每个页面共通的设置",
+    "how_to_use_shared_body": "「不透明度」决定桌面透出来多少。「目标屏幕」选要用哪个屏幕，或每次询问。「显示在所有屏幕」会在每个屏幕各放一份；「显示在所有窗口底下」则把它压到窗口之下，像背景而不是挡在前面的东西。",
+    "how_to_use_clicks_title": "覆盖层不会挡路",
+    "how_to_use_clicks_body": "点击会直接穿透覆盖层落到底下的东西上，所以下面的窗口照常可以操作。只有两个例外：宠物，以及演示页的涂鸦层——它们本来就需要鼠标才能运作。",
+    "how_to_use_control_title": "一次管理很多个",
+    "how_to_use_control_body": "控制中心能碰到每一个覆盖层，不管是哪一页打开的：可以暂时全部隐藏、全部静音、锁定让它们不再移动，或在意电池时降低画质。想把某一个拖到别的位置，要先解除锁定——松开的地方它会记住。",
+    "how_to_use_escape_title": "把画面清干净",
+    "how_to_use_escape_body": "控制中心的「关闭所有」会一次关掉全部，也可以到「设定」→「快捷键」绑一个全局快捷键。万一有东西没有反应，按 F12 会立刻关闭 FrontEngine。",
+    "how_to_use_more_title": "把设置留下来",
+    "how_to_use_more_body": "「预设」菜单可以把各页面的设置整组取名保存、之后再调回来，其中一组还能设成开机自动应用。其余的都在「设定」菜单里：快捷键、提醒、手机遥控、屏幕共享隐私等等。",
+    "how_to_use_open_doc": "完整文档",
 }

{frontengine-1.0.54 → frontengine-1.0.56}/frontengine/utils/multi_language/traditional_chinese.py

@@ -558,4 +558,21 @@ traditional_chinese_word_dict = {
     "whiteboard_save": '儲存白板',
     "pet_audio_speakers": '喇叭',
     "pet_audio_microphone": '麥克風',
+    # How to use dialog
+    "how_to_use_action": "使用說明…",
+    "how_to_use_title": "FrontEngine 使用說明",
+    "how_to_use_intro": "FrontEngine 把東西放在你的畫面最上層——影片、圖片、網頁、文字、桌面寵物——並且在你工作的時候一直留在那裡。",
+    "how_to_use_start_title": "開出第一個覆蓋層",
+    "how_to_use_start_body": "先挑一個分頁，看你想放什麼：影片、圖片、網頁還是文字。選好檔案或網址，再按那一頁的開始按鈕。它就會出現在所有東西之上，直到你把它關掉為止。",
+    "how_to_use_shared_title": "每個分頁共通的設定",
+    "how_to_use_shared_body": "「不透明度」決定桌面透出來多少。「目標螢幕」選要用哪個螢幕，或每次詢問。「顯示在所有螢幕」會在每個螢幕各放一份；「顯示在所有視窗底下」則把它壓到視窗之下，像背景而不是擋在前面的東西。",
+    "how_to_use_clicks_title": "覆蓋層不會擋路",
+    "how_to_use_clicks_body": "點擊會直接穿透覆蓋層落到底下的東西上，所以下面的視窗照常可以操作。只有兩個例外：寵物，以及簡報頁的塗鴉層——它們本來就需要滑鼠才能運作。",
+    "how_to_use_control_title": "一次管理很多個",
+    "how_to_use_control_body": "控制中心碰得到每一個覆蓋層，不管是哪一頁開的：可以暫時全部隱藏、全部靜音、鎖定讓它們不再移動，或在意電池時降低畫質。想把某一個拖到別的位置，要先解除鎖定——放開的地方它會記住。",
+    "how_to_use_escape_title": "把畫面清乾淨",
+    "how_to_use_escape_body": "控制中心的「關閉所有」會一次關掉全部，也可以到「設定」→「快速鍵」綁一個全域快速鍵。萬一有東西沒有反應，按 F12 會立刻關閉 FrontEngine。",
+    "how_to_use_more_title": "把設定留下來",
+    "how_to_use_more_body": "「預設集」選單可以把各分頁的設定整組取名存起來、之後再叫回來，其中一組還能設成開機自動套用。其餘的都在「設定」選單裡：快速鍵、提醒、手機遙控、螢幕分享隱私等等。",
+    "how_to_use_open_doc": "完整文件",
 }

{frontengine-1.0.54 → frontengine-1.0.56}/frontengine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.54
+Version: 1.0.56
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine

{frontengine-1.0.54 → frontengine-1.0.56}/frontengine.egg-info/SOURCES.txt

@@ -75,6 +75,7 @@ frontengine/ui/dialog/app_profile_dialog.py
 frontengine/ui/dialog/choose_file_dialog.py
 frontengine/ui/dialog/clipboard_dialog.py
 frontengine/ui/dialog/hotkey_settings_dialog.py
+frontengine/ui/dialog/how_to_use_dialog.py
 frontengine/ui/dialog/reminder_dialog.py
 frontengine/ui/dialog/remote_control_dialog.py
 frontengine/ui/dialog/screen_privacy_dialog.py

{frontengine-1.0.54 → frontengine-1.0.56}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "frontengine"
-version = "1.0.54"
+version = "1.0.56"
 authors = [
     { name = "JE-Chen", email = "jechenmailman@gmail.com" },
 ]