feat:增加清理多余日志功能

Author: duorua

agent/custom/action.py

@@ -20,6 +20,7 @@
     validate_mfa,
     wait_for_freezes,
     check_resolution,
+    cleanup_maafw_bak_logs,
 )
 
 
@@ -356,3 +357,34 @@ def run(
         except Exception as e:
             logger.error(f"非线性滑动执行失败: {str(e)}")
             return CustomAction.RunResult(success=False)
+
+
+@AgentServer.custom_action("CleanupMaafwBakLogs")
+class CleanupMaafwBakLogs(CustomAction):
+    """
+    清理maafw.bak日志文件
+    参数：{"save_log_count": 保留日志数量}
+    默认留3个
+    """
+
+    def run(
+        self,
+        context: Context,
+        argv: CustomAction.RunArg,
+    ) -> CustomAction.RunResult:
+        try:
+            keep_count = 3  # 与你的函数默认值保持一致
+            if argv.custom_action_param:
+                param_dict = json.loads(argv.custom_action_param)
+                count_value = param_dict.get("save_log_count", "")
+                # 安全解析数字
+                if count_value and str(count_value).isdigit():
+                    keep_count = int(count_value)
+
+            cleanup_maafw_bak_logs(context, keep_count=keep_count)
+
+            return CustomAction.RunResult(success=True)
+
+        except Exception as e:
+            print(f"日志清理执行异常: {e}")
+            return CustomAction.RunResult(success=False)

agent/custom/sink.py

@@ -21,7 +21,7 @@
 def is_aspect_ratio_16x9(width: int, height: int) -> bool:
     """
     检查给定的尺寸是否大约为 16:9
-    同时处理横屏（16:9）和竖屏（9:16）方向
+    同时处理横屏(16:9)和竖屏(9:16)方向
     """
     if width <= 0 or height <= 0:
         return False

agent/custom/utils.py

@@ -301,3 +301,43 @@ def nonlinear_swipe(
 
 def send_notification(title: str = "系统通知", msg: str = "这是一条测试消息"):
     Notify(title, msg, "MaaAutoNaruto", logo.__str__()).send()
+
+
+def cleanup_maafw_bak_logs(context=None, keep_count: int = 3):
+    import sys
+    from pathlib import Path
+
+    root = Path(__file__).parent.parent.parent
+    sys.path.insert(0, str(root))
+
+    try:
+        debug_folder = root / "debug"
+
+        if not debug_folder.exists():
+            print("[日志清理] debug文件夹不存在")
+            return
+
+        log_files = list(debug_folder.glob("maafw.bak.*.log"))
+        print(f"[日志清理] 找到日志总数:{len(log_files)}")
+
+        if not log_files:
+            print("[日志清理] 无符合格式的日志")
+            return
+
+        # 按时间从新到旧排序
+        log_files.sort(reverse=True)
+        to_delete = log_files[keep_count:]
+        print(f"[日志清理] 待删除旧日志:{len(to_delete)} 个")
+
+        # 删除
+        for f in to_delete:
+            try:
+                f.unlink()
+                print(f"[日志清理] 已删除:{f.name}")
+            except Exception as e:
+                print(f"[日志清理] 删除失败 {f.name}:{e}")
+
+        print(f"[日志清理] 完成!保留最新 {keep_count} 个日志")
+
+    except Exception as e:
+        print(f"[日志清理] 异常:{e}")

assets/interface.json

@@ -377,6 +377,15 @@
                 "display_touch"
             ]
         },
+        {
+            "name": "日志清理",
+            "entry": "cleanup_maafw_bak_logs",
+            "option": [
+                "保留备份日志个数"
+            ],
+            "default_check": true,
+            "description": "清理多余的日志,节省空间"
+        },
         {
             "name": "完成标记",
             "entry": "complete",
@@ -3380,6 +3389,27 @@
                     }
                 }
             ]
+        },
+        "保留备份日志个数": {
+            "description": "清理日志时保留备份日志个数",
+            "type": "input",
+            "inputs": [
+                {
+                    "name": "保留日志数",
+                    "label": "保留日志数",
+                    "description": "输入需要的保留日志数,最大999",
+                    "pipeline_type": "int",
+                    "default": "3",
+                    "verify": "^[1-9]\\d{0,2}$"
+                }
+            ],
+            "pipeline_override": {
+                "cleanup_maafw_bak_logs": {
+                    "custom_action_param": {
+                        "save_log_count": "{保留日志数}"
+                    }
+                }
+            }
         }
     }
 }

assets/resource/base/pipeline/Routine.json

@@ -0,0 +1,20 @@
+{
+    "complete": {
+        "recognition": "DirectHit",
+        "pre_delay": 0,
+        "post_delay": 0,
+        "$doc": "用来标记全部任务已经完成,和auto_mas配合",
+        "focus": "OK"
+    },
+    "cleanup_maafw_bak_logs": {
+        "recognition": "DirectHit",
+        "action": "Custom",
+        "custom_action": "CleanupMaafwBakLogs",
+        "custom_action_param": {
+            "save_log_count": "3"
+        },
+        "pre_delay": 0,
+        "post_delay": 0,
+        "$doc": "清理多余的maafw_bak日志,节省空间"
+    }
+}

assets/resource/base/pipeline/Share.json

@@ -330,11 +330,5 @@
         "post_delay": 0,
         "post_wait_freezes": 200,
         "focus": "[color:darkgray]关闭周榜更新提示[/color]"
-    },
-    "complete": {
-        "recognition": "DirectHit",
-        "pre_delay": 0,
-        "post_delay": 0,
-        "focus": "OK"
     }
 }

deps/tools/custom.action.schema.json

@@ -10,7 +10,8 @@
                 "StopTaskList",
                 "RetryFailed",
                 "CounterIncrement",
-                "NonlinearSwipe"
+                "NonlinearSwipe",
+                "CleanupMaafwBakLogs"
             ]
         },
         "custom_action_param": {
@@ -35,6 +36,9 @@
                 },
                 {
                     "$ref": "#/$defs/NonlinearSwipe"
+                },
+                {
+                    "$ref": "#/$defs/CleanupMaafwBakLogsParam"
                 }
             ]
         }
@@ -123,6 +127,21 @@
             "description": "调用非线性滑动",
             "markdownDescription": "非线性滑动\n\n**功能说明：**\n- 进行非线性滑动\n\n**返回值：**\n- `success`正常时返回 true",
             "properties": {}
+        },
+        "CleanupMaafwBakLogsParam": {
+            "type": "object",
+            "description": "清理debug目录下的maafw.bak日志文件,保留指定数量的最新日志",
+            "markdownDescription": "清理maafw.bak日志文件\n\n**功能说明：**\n- 扫描项目根目录下 debug 文件夹\n- 匹配格式:maafw.bak.*.log\n- 按文件名时间戳从新到旧排序\n- 删除超出指定数量的旧日志文件\n- 无依赖项目日志器,使用控制台输出\n\n**参数说明:**\n- `save_log_count`:保留的最新日志文件数量\n  - 类型:整数（数字）\n  - 非必填,默认值:3\n  - 示例:`5` 表示保留最新5个日志\n\n**返回值:**\n- `success`:执行完成始终返回 true",
+            "properties": {
+                "save_log_count": {
+                    "title": "Save Log Count",
+                    "description": "需要保留的最新日志文件数量,默认值为3",
+                    "type": "integer",
+                    "minimum": 1,
+                    "default": 3,
+                    "markdownDescription": "*integer*\n\n保留的最新日志文件数量.默认值:3最小值:1"
+                }
+            }
         }
     }
 }