refactor(autoscript): 替换 dsl 包为 autoscript 引擎模块

2026-06-18 07:23:03 +08:00 · 2026-05-12 11:49:43 +08:00
parent 14c6db3384
commit 500ddd41c5
6 changed files with 1064 additions and 395 deletions
@@ -0,0 +1,55 @@
+"""
+    AutoScript module for the AutoLibrary project.
+
+    A lightweight scripting DSL for preprocessing user reservation data
+    in repeatable timer tasks. Supports IF/ELSE IF/ELSE/END IF control
+    flow, SET assignments, .ADD./.SUB. operations, and rich comparisons.
+
+    Public API:
+    - execute(script_text, target_data): Execute an AutoScript.
+    - addTargetVar(name, var_type, key_path, display_name): Register a variable.
+    - registerDefaultTargetVars(): Register all built-in target variables.
+    - META_VARS: dict of built-in read-only meta variables.
+    - ALL_VARIABLES: dict of all available variables (display_name -> (name, type)).
+"""
+
+from autoscript.ASEngine import execute, addTargetVar
+from autoscript.ASObject import _META_VARS as META_VARS
+
+__all__ = [
+    "execute", "addTargetVar", "registerDefaultTargetVars",
+    "META_VARS", "ALL_VARIABLES",
+]
+
+# All variables available to scripts (display_name -> (name, type)).
+# This mirrors the old AutoScriptEngine.VARIABLE_META for backward
+# compatibility in the UI orchestration dialog.
+ALL_VARIABLES: dict = {
+    "用户名": ("USERNAME", "String"),
+    "用户启用": ("USER_ENABLE", "Boolean"),
+    "预约日期": ("RESERVE_DATE", "Date"),
+    "预约开始时间": ("RESERVE_BEGIN_TIME", "Time"),
+    "预约结束时间": ("RESERVE_END_TIME", "Time"),
+    "当前时间": ("CURRENT_TIME", "Time"),
+    "当前日期": ("CURRENT_DATE", "Date"),
+}
+
+# Key paths into target_data dict for each target variable.
+# (name, type, key_path, display_name)
+_TARGET_VAR_DEFS = [
+    ("USERNAME",           "String",["username"],                           "用户名"),
+    ("USER_ENABLE",        "Boolean",["enabled"],                           "用户启用"),
+    ("RESERVE_DATE",       "Date",  ["reserve_info", "date"],               "预约日期"),
+    ("RESERVE_BEGIN_TIME", "Time",  ["reserve_info", "begin_time", "time"], "预约开始时间"),
+    ("RESERVE_END_TIME",   "Time",  ["reserve_info", "end_time",   "time"], "预约结束时间"),
+]
+
+
+def registerDefaultTargetVars() -> None:
+    """
+        Register all built-in target variables with the engine.
+        This must be called before any script execution.
+        Calling multiple times is idempotent (re-registers same keys).
+    """
+    for name, var_type, key_path, display_name in _TARGET_VAR_DEFS:
+        addTargetVar(name, var_type, key_path, display_name)