frontengine 1.0.15__tar.gz → 1.0.17__tar.gz

{frontengine-1.0.15 → frontengine-1.0.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.15
+Version: 1.0.17
 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.15 → frontengine-1.0.17}/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,34 @@ class PetMood:
         return self.CONTENT
 
 
+class PetGrowth:
+    """
+    親密度累積與等級：互動會累加親密度，跨過門檻即升級。
+    Affection points accrue from interactions; crossing a threshold levels up.
+    """
+
+    THRESHOLDS = (0, 100, 250, 500, 1000, 2000)
+
+    def __init__(self, affection: int = 0) -> None:
+        self.affection = self._clamp(affection)
+
+    @staticmethod
+    def _clamp(value) -> int:
+        try:
+            return max(0, int(value))
+        except (TypeError, ValueError):
+            return 0
+
+    def level(self) -> int:
+        return max(1, sum(1 for threshold in self.THRESHOLDS if self.affection >= threshold))
+
+    def add(self, amount: int) -> bool:
+        """累加親密度；若因此升級回傳 True。"""
+        before = self.level()
+        self.affection = self._clamp(self.affection + int(amount))
+        return self.level() > before
+
+
 class PetHunger:
     """
     寵物飽足值 0~100：餵食上升、隨時間下降；level() 回傳 full/ok/hungry。
@@ -646,6 +698,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:
@@ -738,6 +796,7 @@ class DesktopPetWidget(BaseWidget):
         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._growth = PetGrowth(user_setting_dict.get("pet_affection", 0))
         self._messages = self._load_messages()
         self._sound: Optional[QSoundEffect] = None
         self._init_sound(sound_path)
@@ -750,6 +809,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 = []
@@ -816,6 +878,7 @@ class DesktopPetWidget(BaseWidget):
             self.motion.clear_follow()
             if self._talk and not self._peer_greeted:
                 self._peer_greeted = True
+                self._gain_affection(3)
                 self.motion.vx = abs(self.motion.vx) if peer[0] >= my_center[0] else -abs(self.motion.vx)
                 pool = self._messages.get("meet") or []
                 if pool:
@@ -907,9 +970,20 @@ class DesktopPetWidget(BaseWidget):
             "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..."),
+            "levelup": lines("pet_chatter_levelup", "Level up!|I'm growing!|We're getting closer!"),
             "any": lines("pet_chatter_any", "Hi there!|(^_^)|Keep going!"),
         }
 
+    def _gain_affection(self, amount: int) -> None:
+        """互動累加親密度；升級時慶祝一下並保存。"""
+        leveled = self._growth.add(amount)
+        user_setting_dict["pet_affection"] = self._growth.affection
+        if leveled and self._talk:
+            pool = self._messages.get("levelup") or []
+            if pool:
+                self.say(pool[self._chatter_rng.randrange(len(pool))])
+
     def _persist_mood(self) -> None:
         user_setting_dict["pet_mood"] = self._mood.value
 
@@ -973,11 +1047,33 @@ class DesktopPetWidget(BaseWidget):
         self._mood.decay()  # a little neglect over time
         self._hunger.decay()
         self._persist_mood()
-        # priority: low battery, then hunger, otherwise normal chatter
-        if not self._warn_battery() and not self._warn_hungry():
+        # 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
 
@@ -987,6 +1083,7 @@ class DesktopPetWidget(BaseWidget):
         self._mood.pet()
         self._persist_hunger()
         self._persist_mood()
+        self._gain_affection(5)
         pool = self._messages.get("fed") or []
         if pool:
             self.say(pool[self._chatter_rng.randrange(len(pool))])
@@ -1072,6 +1169,7 @@ class DesktopPetWidget(BaseWidget):
             self.motion.clear_follow()
             self._mood.pet()    # petting cheers it up
             self._persist_mood()
+            self._gain_affection(2)
             self._play_sound()
             self._set_active_sprite(STATE_DRAG)
         super().mousePressEvent(event)

{frontengine-1.0.15 → frontengine-1.0.17}/frontengine/user_setting/user_setting_file.py

@@ -39,6 +39,9 @@ user_setting_dict: Dict[str, Any] = {
     # 桌面寵物飽足值（0~100）
     # Desktop pet fullness (0..100)
     "pet_hunger": 70,
+    # 桌面寵物親密度（累積互動）
+    # Desktop pet affection (accumulated interactions)
+    "pet_affection": 0,
 }
 
 

{frontengine-1.0.15 → frontengine-1.0.17}/frontengine/utils/multi_language/english.py

@@ -228,6 +228,8 @@ english_word_dict = {
     "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_chatter_levelup": "Level up!|I'm growing!|We're getting closer!|Yay, thank you!",
     "pet_set_reminder": "Set reminder...",
     "pet_reminder_prompt": "Remind me to:",
     "pet_reminder_minutes": "In how many minutes?",

{frontengine-1.0.15 → frontengine-1.0.17}/frontengine/utils/multi_language/traditional_chinese.py

@@ -229,6 +229,8 @@ traditional_chinese_word_dict = {
     "pet_feed": "餵食",
     "pet_chatter_hungry": "我餓了…|有點心嗎？|餵餵我好嗎？|肚子咕咕叫～",
     "pet_chatter_fed": "好吃！|謝謝你！|真美味！|嗯嗯 (^o^)",
+    "pet_chatter_away": "還在嗎？|我先打個盹等你回來～|Zzz…|慢慢來沒關係！",
+    "pet_chatter_levelup": "升級了！|我長大了！|我們更親近了！|耶，謝謝你！",
     "pet_set_reminder": "設定提醒...",
     "pet_reminder_prompt": "提醒我：",
     "pet_reminder_minutes": "幾分鐘後？",

{frontengine-1.0.15 → frontengine-1.0.17}/frontengine.egg-info/PKG-INFO

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

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