frontengine 1.0.14__tar.gz → 1.0.16__tar.gz

{frontengine-1.0.14 → frontengine-1.0.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.14
+Version: 1.0.16
 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.14 → frontengine-1.0.16}/frontengine/show/pet/desktop_pet.py

@@ -144,6 +144,30 @@ def windows_platforms(exclude_hwnds=()) -> list:
         return []
 
 
+def idle_seconds():
+    """
+    回傳使用者未操作的秒數；無法取得時回傳 None。僅 Windows 實作。
+    Seconds since the last user input, or None when unavailable (Windows only).
+    """
+    if sys.platform != "win32":
+        return None
+    try:
+        import ctypes
+
+        class _LASTINPUTINFO(ctypes.Structure):
+            _fields_ = [("cbSize", ctypes.c_uint), ("dwTime", ctypes.c_uint)]
+
+        info = _LASTINPUTINFO()
+        info.cbSize = ctypes.sizeof(info)
+        if not ctypes.windll.user32.GetLastInputInfo(ctypes.byref(info)):
+            return None
+        elapsed_ms = ctypes.windll.kernel32.GetTickCount() - info.dwTime
+        return max(0.0, elapsed_ms / 1000.0)
+    except Exception as error:  # pragma: no cover - Win32 boundary
+        front_engine_logger.warning(f"[idle_seconds] error: {error!r}")
+        return None
+
+
 def pop_due_reminders(now, reminders):
     """
     依 now 分出已到期與未到期的提醒。reminders 為 (due_datetime, text) 清單。
@@ -266,6 +290,40 @@ class PetMood:
         return self.CONTENT
 
 
+class PetHunger:
+    """
+    寵物飽足值 0~100：餵食上升、隨時間下降；level() 回傳 full/ok/hungry。
+    Pet fullness 0..100: feeding raises it, time lowers it; level() buckets it.
+    """
+
+    FULL = "full"
+    OK = "ok"
+    HUNGRY = "hungry"
+
+    def __init__(self, value: int = 70) -> None:
+        self.value = self._clamp(value)
+
+    @staticmethod
+    def _clamp(value) -> int:
+        try:
+            return max(0, min(100, int(value)))
+        except (TypeError, ValueError):
+            return 70
+
+    def feed(self, amount: int = 30) -> None:
+        self.value = self._clamp(self.value + amount)
+
+    def decay(self, amount: int = 1) -> None:
+        self.value = self._clamp(self.value - amount)
+
+    def level(self) -> str:
+        if self.value >= 60:
+            return self.FULL
+        if self.value <= 25:
+            return self.HUNGRY
+        return self.OK
+
+
 class SpeechBubble(QWidget):
     """寵物頭上的小對話泡泡，數秒後自動消失 / A small speech bubble that auto-hides."""
 
@@ -612,6 +670,12 @@ class PetMotion:
         self._idle_count = 0
         self._new_state(force_walk=True)
 
+    def sleep(self) -> None:
+        """讓寵物進入睡眠（使用者閒置時呼叫）/ Put the pet to sleep."""
+        self.state = STATE_SLEEP
+        self._state_ticks = self._rng.randint(300, 600)
+        self.follow_target_x = None
+
     # --- free wander ---
     def _step_wander(self, left, top, right, bottom) -> Tuple[int, int]:
         if abs(self.vy) < 1e-9:
@@ -702,6 +766,8 @@ class DesktopPetWidget(BaseWidget):
         self._moved = False
         self._chatter_rng = _random_module.SystemRandom()
         self._mood = PetMood(user_setting_dict.get("pet_mood", 60))
+        self._hunger = PetHunger(user_setting_dict.get("pet_hunger", 70))
+        self._hunger_warned = False
         self._messages = self._load_messages()
         self._sound: Optional[QSoundEffect] = None
         self._init_sound(sound_path)
@@ -714,6 +780,9 @@ class DesktopPetWidget(BaseWidget):
         # 電量提醒 / Low-battery reaction
         self._battery_provider = read_battery
         self._battery_warned = False
+        # 閒置反應 / Idle reaction
+        self._idle_provider = idle_seconds
+        self._idle_reacted = False
         # 提醒事項 / Reminders
         self._now_provider = datetime.now
         self._reminders: list = []
@@ -728,6 +797,9 @@ class DesktopPetWidget(BaseWidget):
         self.clone_action = QAction(language_wrapper.language_word_dict.get("pet_clone", "Clone"), self)
         self.clone_action.triggered.connect(self.clone_requested.emit)
         self.menu.addAction(self.clone_action)
+        self.feed_action = QAction(language_wrapper.language_word_dict.get("pet_feed", "Feed"), self)
+        self.feed_action.triggered.connect(self.feed)
+        self.menu.addAction(self.feed_action)
         self.reminder_action = QAction(
             language_wrapper.language_word_dict.get("pet_set_reminder", "Set reminder..."), self)
         self.reminder_action.triggered.connect(self._prompt_reminder)
@@ -866,6 +938,9 @@ class DesktopPetWidget(BaseWidget):
             "sad": lines("pet_chatter_sad", "Feeling a bit lonely...|Pet me?|(._.)"),
             "meet": lines("pet_chatter_meet", "Hi friend!|Hello!|Let's play!"),
             "battery": lines("pet_chatter_battery", "Battery's low - plug me in?|Low power!|Find a charger?"),
+            "hungry": lines("pet_chatter_hungry", "I'm hungry...|Got a snack?|Feed me?"),
+            "fed": lines("pet_chatter_fed", "Yum!|Thank you!|Delicious!"),
+            "away": lines("pet_chatter_away", "Still there?|I'll nap till you're back~|Zzz..."),
             "any": lines("pet_chatter_any", "Hi there!|(^_^)|Keep going!"),
         }
 
@@ -930,11 +1005,64 @@ class DesktopPetWidget(BaseWidget):
 
     def _on_chatter(self) -> None:
         self._mood.decay()  # a little neglect over time
+        self._hunger.decay()
         self._persist_mood()
-        if not self._warn_battery():   # a low-battery warning takes priority
+        # priority: user idle (nap), low battery, hunger, otherwise normal chatter
+        if not self._check_idle() and not self._warn_battery() and not self._warn_hungry():
             self.say()
         self._schedule_chatter()
 
+    IDLE_THRESHOLD = 120.0
+
+    def _check_idle(self) -> bool:
+        """使用者閒置久了打盹並說一句；回來後醒。回傳是否有反應（抑制一般閒聊）。"""
+        seconds = self._idle_provider()
+        if seconds is None:
+            return False
+        if seconds >= self.IDLE_THRESHOLD:
+            if not self._idle_reacted:
+                self._idle_reacted = True
+                self.motion.sleep()
+                if self._talk:
+                    pool = self._messages.get("away") or []
+                    if pool:
+                        self.say(pool[self._chatter_rng.randrange(len(pool))])
+                        return True
+            return False
+        if seconds < 5.0 and self._idle_reacted:
+            self._idle_reacted = False
+            self.motion.wake()
+        return False
+
+    def _persist_hunger(self) -> None:
+        user_setting_dict["pet_hunger"] = self._hunger.value
+
+    def feed(self) -> None:
+        """餵食：補足飽足並讓心情變好，說一句道謝。"""
+        self._hunger.feed()
+        self._mood.pet()
+        self._persist_hunger()
+        self._persist_mood()
+        pool = self._messages.get("fed") or []
+        if pool:
+            self.say(pool[self._chatter_rng.randrange(len(pool))])
+
+    def _warn_hungry(self) -> bool:
+        """飢餓時討食一次；吃飽後重置。回傳是否有討食。"""
+        self._persist_hunger()
+        if not self._talk:
+            return False
+        if self._hunger.level() == PetHunger.HUNGRY:
+            if not self._hunger_warned:
+                self._hunger_warned = True
+                pool = self._messages.get("hungry") or []
+                if pool:
+                    self.say(pool[self._chatter_rng.randrange(len(pool))])
+                    return True
+        elif self._hunger.level() == PetHunger.FULL:
+            self._hunger_warned = False
+        return False
+
     BATTERY_THRESHOLD = 20
 
     def _warn_battery(self) -> bool:

{frontengine-1.0.14 → frontengine-1.0.16}/frontengine/user_setting/user_setting_file.py

@@ -36,6 +36,9 @@ user_setting_dict: Dict[str, Any] = {
     # 桌面寵物心情值（0~100），跨工作階段保存
     # Desktop pet mood (0..100), persisted across sessions
     "pet_mood": 60,
+    # 桌面寵物飽足值（0~100）
+    # Desktop pet fullness (0..100)
+    "pet_hunger": 70,
 }
 
 

{frontengine-1.0.14 → frontengine-1.0.16}/frontengine/utils/multi_language/english.py

@@ -225,6 +225,10 @@ english_word_dict = {
     "pet_behaviour_chase": "Chase cursor",
     "pet_climb_label": "Climb walls",
     "pet_clone": "Clone",
+    "pet_feed": "Feed",
+    "pet_chatter_hungry": "I'm hungry...|Got a snack?|Feed me, please?|My tummy's rumbling~",
+    "pet_chatter_fed": "Yum!|Thank you!|Delicious!|Nom nom (^o^)",
+    "pet_chatter_away": "Still there?|I'll nap till you're back~|Zzz...|Take your time!",
     "pet_set_reminder": "Set reminder...",
     "pet_reminder_prompt": "Remind me to:",
     "pet_reminder_minutes": "In how many minutes?",

{frontengine-1.0.14 → frontengine-1.0.16}/frontengine/utils/multi_language/traditional_chinese.py

@@ -226,6 +226,10 @@ traditional_chinese_word_dict = {
     "pet_behaviour_chase": "追逐游標",
     "pet_climb_label": "攀爬牆壁",
     "pet_clone": "複製",
+    "pet_feed": "餵食",
+    "pet_chatter_hungry": "我餓了…|有點心嗎？|餵餵我好嗎？|肚子咕咕叫～",
+    "pet_chatter_fed": "好吃！|謝謝你！|真美味！|嗯嗯 (^o^)",
+    "pet_chatter_away": "還在嗎？|我先打個盹等你回來～|Zzz…|慢慢來沒關係！",
     "pet_set_reminder": "設定提醒...",
     "pet_reminder_prompt": "提醒我：",
     "pet_reminder_minutes": "幾分鐘後？",

{frontengine-1.0.14 → frontengine-1.0.16}/frontengine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.14
+Version: 1.0.16
 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.14 → frontengine-1.0.16}/pyproject.toml

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