automas-script-maafw-pack-m9a 0.1.1__tar.gz

automas_script_maafw_pack_m9a-0.1.1/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: automas-script-maafw-pack-m9a
+Version: 0.1.1
+Summary: M9A project pack declarations for the AUTO-MAS MaaFW plugin
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: automas-script-maafw>=0.1.2
+Requires-Dist: pydantic>=2
+
+# automas-script-maafw-pack-m9a
+
+M9A project pack declarations for the AUTO-MAS MaaFW plugin.
+
+The package provides `maafw.pack.m9a.v1`. It does not declare default project
+sources, controller, resource, preset, task queues, or task templates. Those are
+loaded through the generic MaaFW project/interface flow.

automas_script_maafw_pack_m9a-0.1.1/README.md

@@ -0,0 +1,7 @@
+# automas-script-maafw-pack-m9a
+
+M9A project pack declarations for the AUTO-MAS MaaFW plugin.
+
+The package provides `maafw.pack.m9a.v1`. It does not declare default project
+sources, controller, resource, preset, task queues, or task templates. Those are
+loaded through the generic MaaFW project/interface flow.

automas_script_maafw_pack_m9a-0.1.1/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "automas-script-maafw-pack-m9a"
+version = "0.1.1"
+description = "M9A project pack declarations for the AUTO-MAS MaaFW plugin"
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.10"
+dependencies = [
+    "automas-script-maafw>=0.1.2",
+    "pydantic>=2",
+]
+
+[project.entry-points."auto_mas.plugins"]
+automas_script_maafw_pack_m9a = "automas_script_maafw_pack_m9a.plugin:Plugin"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+automas_script_maafw_pack_m9a = ["py.typed", "assets/*.png"]

automas_script_maafw_pack_m9a-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a/__init__.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from .models import (
+    M9AMigrationDraft,
+    M9ANotificationContent,
+    M9APackDefinition,
+    M9APeriodRule,
+)
+from .service import M9APackService
+
+__all__ = [
+    "M9AMigrationDraft",
+    "M9ANotificationContent",
+    "M9APackDefinition",
+    "M9APackService",
+    "M9APeriodRule",
+]

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a/migration.py

@@ -0,0 +1,398 @@
+from __future__ import annotations
+
+import json
+from typing import Any
+
+from automas_maafw_interface.models import MaaFWInterface, MaaFWOption, MaaFWTask
+from automas_maafw_interface.service import MaaFWInterfaceService
+
+
+_RESERVED_TASK_NAMES = {
+    "启动游戏",
+    "关闭游戏",
+    "切换账号",
+    "StartUp",
+    "CloseDown",
+    "Close1999",
+    "SwitchAccount",
+}
+
+
+async def migrate_legacy_m9a_config(legacy_script: Any, provider: Any) -> Any:
+    """Convert a persisted M9AConfig into the generated MaaFW plugin shape."""
+
+    raw_script = await legacy_script.toDict(if_decrypt=False)
+    project_path = str(_nested(raw_script, "Info", "Path") or "").strip()
+    if not project_path:
+        raise ValueError("旧 M9A 配置缺少项目路径，暂不自动迁移")
+
+    interface = MaaFWInterfaceService().load(project_path)
+    controller_name = _default_adb_controller(interface)
+    script_payload = _build_script_payload(raw_script, interface, controller_name)
+    script_payload["SubConfigsInfo"] = {
+        "UserData": await _build_user_collection(
+            legacy_script,
+            provider.user_config_class,
+            interface,
+            controller_name,
+        )
+    }
+
+    migrated = provider.script_config_class()
+    await migrated.load(script_payload)
+    return migrated
+
+
+def _build_script_payload(
+    raw_script: dict[str, Any],
+    interface: MaaFWInterface,
+    controller_name: str,
+) -> dict[str, Any]:
+    daily_tasks = (
+        _task_names_for_entries(interface, "Psychube")
+        if bool(_nested(raw_script, "Run", "IfPsychubeDailyOnce"))
+        else []
+    )
+    monthly_tasks = (
+        _task_names_for_entries(interface, "Limbo", "Lucidscape", "SleepDream")
+        if bool(_nested(raw_script, "Run", "IfSleepDreamMonthlyOnce"))
+        else []
+    )
+    return {
+        "Info": {
+            "Name": _nested(raw_script, "Info", "Name"),
+            "ProjectLabel": interface.label or interface.name,
+            "Path": _nested(raw_script, "Info", "Path"),
+            "Controller": controller_name,
+            "Resource": "",
+        },
+        "Emulator": {
+            "Id": _nested(raw_script, "Emulator", "Id"),
+            "Index": _nested(raw_script, "Emulator", "Index"),
+        },
+        "Update": {
+            "IfAutoUpdate": bool(
+                _nested(raw_script, "Run", "IfAutoUpdateAfterQueue")
+            ),
+        },
+        "Run": {
+            "ProxyTimesLimit": _nested(raw_script, "Run", "ProxyTimesLimit"),
+            "RunTimesLimit": _nested(raw_script, "Run", "RunTimesLimit"),
+            "RunTimeLimit": _nested(raw_script, "Run", "RunTimeLimit"),
+            "DailyOnceTasks": _json(daily_tasks),
+            "WeeklyOnceTasks": _json([]),
+            "MonthlyOnceTasks": _json(monthly_tasks),
+        },
+    }
+
+
+async def _build_user_collection(
+    legacy_script: Any,
+    user_config_class: type,
+    interface: MaaFWInterface,
+    controller_name: str,
+) -> dict[str, Any]:
+    result: dict[str, Any] = {"instances": []}
+    for uid, old_user in legacy_script.UserData.items():
+        raw_user = await old_user.toDict(if_decrypt=False)
+        result["instances"].append(
+            {"uid": str(uid), "type": user_config_class.__name__}
+        )
+        result[str(uid)] = _build_user_payload(
+            raw_user,
+            interface,
+            controller_name,
+        )
+    return result
+
+
+def _build_user_payload(
+    raw_user: dict[str, Any],
+    interface: MaaFWInterface,
+    controller_name: str,
+) -> dict[str, Any]:
+    task_snapshot = _build_task_snapshot(
+        _load_json(_nested(raw_user, "Task", "Queue"), list),
+        interface,
+    )
+    period_records = {
+        "daily": _period_records(
+            interface,
+            str(_nested(raw_user, "Data", "LastPsychubeDate") or "2000-01-01"),
+            "Psychube",
+        ),
+        "weekly": {},
+        "monthly": {
+            **_period_records(
+                interface,
+                str(_nested(raw_user, "Data", "LastLimboMonth") or "2000-01"),
+                "Limbo",
+            ),
+            **_period_records(
+                interface,
+                str(
+                    _nested(raw_user, "Data", "LastLucidscapeMonth")
+                    or "2000-01"
+                ),
+                "Lucidscape",
+            ),
+        },
+    }
+    resource_name = _match_resource_name(
+        interface,
+        str(_nested(raw_user, "Info", "Resource") or ""),
+        controller_name,
+    )
+    payload = {
+        "Info": {
+            **_copy_group(
+                raw_user,
+                "Info",
+                (
+                    "Name",
+                    "Status",
+                    "RemainedDay",
+                    "IfScriptBeforeTask",
+                    "ScriptBeforeTask",
+                    "IfScriptAfterTask",
+                    "ScriptAfterTask",
+                    "Notes",
+                    "Account",
+                ),
+            ),
+            "Controller": controller_name,
+            "Resource": resource_name,
+        },
+        "Task": {
+            "SelectedPreset": "",
+            "TaskSnapshot": _json(task_snapshot),
+        },
+        "Data": {
+            **_copy_group(
+                raw_user,
+                "Data",
+                ("LastProxyDate", "ProxyTimes", "IfPassCheck"),
+            ),
+            "PeriodTaskRecords": _json(period_records),
+        },
+        "Notify": _copy_group(
+            raw_user,
+            "Notify",
+            (
+                "Enabled",
+                "IfSendStatistic",
+                "IfSendMail",
+                "ToAddress",
+                "IfServerChan",
+                "ServerChanKey",
+            ),
+        ),
+    }
+    custom_webhooks = (
+        raw_user.get("SubConfigsInfo", {}).get("Notify_CustomWebhooks")
+        if isinstance(raw_user.get("SubConfigsInfo"), dict)
+        else None
+    )
+    if isinstance(custom_webhooks, dict):
+        payload["SubConfigsInfo"] = {
+            "Notify_CustomWebhooks": custom_webhooks,
+        }
+    return payload
+
+
+def _build_task_snapshot(
+    queue: list[Any],
+    interface: MaaFWInterface,
+) -> dict[str, Any]:
+    task_order: list[str] = []
+    task_checked = {task.name: False for task in interface.task}
+    task_options: dict[str, dict[str, Any]] = {}
+    for item in queue:
+        if not isinstance(item, dict):
+            continue
+        raw_name = str(item.get("name") or item.get("entry") or "").strip()
+        if not raw_name or raw_name in _RESERVED_TASK_NAMES:
+            continue
+        task = _match_task(interface, raw_name, str(item.get("entry") or ""))
+        if task is None or task.name in task_order:
+            continue
+        task_order.append(task.name)
+        task_checked[task.name] = True
+        task_options[task.name] = _convert_task_options(
+            item.get("options"),
+            interface,
+        )
+
+    task_order.extend(task.name for task in interface.task if task.name not in task_order)
+    return {
+        "taskOrder": task_order,
+        "taskChecked": task_checked,
+        "taskOptions": task_options,
+    }
+
+
+def _convert_task_options(
+    raw_options: Any,
+    interface: MaaFWInterface,
+) -> dict[str, Any]:
+    converted: dict[str, Any] = {}
+    if not isinstance(raw_options, list):
+        return converted
+    for raw_option in raw_options:
+        if not isinstance(raw_option, dict):
+            continue
+        option_name = str(raw_option.get("name") or "").strip()
+        option = interface.option.get(option_name)
+        if not option_name or option is None:
+            continue
+        value = _convert_option_value(raw_option, option)
+        if value is not None:
+            converted[option_name] = value
+        converted.update(
+            _convert_task_options(raw_option.get("sub_options"), interface)
+        )
+    return converted
+
+
+def _convert_option_value(raw_option: dict[str, Any], option: MaaFWOption) -> Any:
+    if option.type == "input":
+        value = raw_option.get("input_values", raw_option.get("data"))
+        if isinstance(value, dict):
+            return {
+                str(key): str(item)
+                for key, item in value.items()
+                if isinstance(key, str)
+            }
+        return None
+    if option.type == "checkbox":
+        selected = raw_option.get("selected_cases")
+        if isinstance(selected, list):
+            return [str(item) for item in selected]
+        return []
+
+    cases = option.cases or []
+    selected = raw_option.get("selected_cases")
+    if isinstance(selected, list) and selected:
+        return str(selected[0])
+    try:
+        index = int(raw_option.get("index", 0))
+    except (TypeError, ValueError):
+        index = 0
+    if 0 <= index < len(cases):
+        return cases[index].name
+    return cases[0].name if cases else None
+
+
+def _match_task(
+    interface: MaaFWInterface,
+    name: str,
+    entry: str = "",
+) -> MaaFWTask | None:
+    for candidate in (name, entry):
+        if not candidate:
+            continue
+        task = next(
+            (
+                item
+                for item in interface.task
+                if candidate in {item.name, item.entry, item.label}
+            ),
+            None,
+        )
+        if task is not None:
+            return task
+    return None
+
+
+def _task_names_for_entries(
+    interface: MaaFWInterface,
+    *entries: str,
+) -> list[str]:
+    wanted = set(entries)
+    return [
+        task.name
+        for task in interface.task
+        if task.entry in wanted or task.name in wanted
+    ]
+
+
+def _period_records(
+    interface: MaaFWInterface,
+    period_key: str,
+    *entries: str,
+) -> dict[str, str]:
+    return {
+        task_name: period_key
+        for task_name in _task_names_for_entries(interface, *entries)
+    }
+
+
+def _default_adb_controller(interface: MaaFWInterface) -> str:
+    controller = next(
+        (item for item in interface.controller if item.type == "Adb"),
+        None,
+    )
+    return controller.name if controller is not None else ""
+
+
+def _match_resource_name(
+    interface: MaaFWInterface,
+    legacy_value: str,
+    controller_name: str,
+) -> str:
+    if legacy_value:
+        resource = next(
+            (
+                item
+                for item in interface.resource
+                if legacy_value in {item.name, item.label}
+            ),
+            None,
+        )
+        if resource is not None:
+            return resource.name
+    resource = next(
+        (
+            item
+            for item in interface.resource
+            if not item.controller or controller_name in item.controller
+        ),
+        None,
+    )
+    return resource.name if resource is not None else ""
+
+
+def _copy_group(
+    payload: dict[str, Any],
+    group_name: str,
+    field_names: tuple[str, ...],
+) -> dict[str, Any]:
+    group = payload.get(group_name)
+    if not isinstance(group, dict):
+        return {}
+    return {name: group[name] for name in field_names if name in group}
+
+
+def _nested(payload: dict[str, Any], group: str, name: str) -> Any:
+    value = payload.get(group)
+    return value.get(name) if isinstance(value, dict) else None
+
+
+def _load_json(value: Any, expected_type: type) -> Any:
+    if isinstance(value, expected_type):
+        return value
+    if isinstance(value, str):
+        try:
+            parsed = json.loads(value)
+        except json.JSONDecodeError:
+            return expected_type()
+        if isinstance(parsed, expected_type):
+            return parsed
+    return expected_type()
+
+
+def _json(value: Any) -> str:
+    return json.dumps(value, ensure_ascii=False)
+
+
+__all__ = ["migrate_legacy_m9a_config"]

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a/models.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from typing import Any, Literal
+
+from pydantic import BaseModel, Field
+
+
+class M9APeriodRule(BaseModel):
+    task: str
+    period: Literal["daily", "weekly", "monthly"]
+
+
+class M9APackDefinition(BaseModel):
+    """M9A project pack 定义，对应文档 6.3 MaaFWProjectPackDefinition。"""
+
+    key: str = "m9a"
+    display_name: str = "M9A"
+    project_repo: str | None = None
+    interface_path: str = "interface.json"
+    supported_controllers: list[str] = Field(default_factory=lambda: ["adb", "win32"])
+    default_controller: str = "adb"
+    default_resource: str | None = None
+    default_preset: str | None = None
+    default_task_queue: list[str] | None = None
+    period_rules: list[M9APeriodRule] = Field(default_factory=list)
+    reserved_task_semantics: dict[str, Any] = Field(default_factory=dict)
+    icon: str | None = "automas_script_maafw_pack_m9a:assets/m9a.png"
+    notes: str | None = None
+    # 额外能力声明（非 6.3 标准字段）
+    framework: str = "maafw"
+    capabilities: list[str] = Field(default_factory=list)
+
+
+class M9ANotificationContent(BaseModel):
+    title: str
+    text: str
+    html: str | None = None
+
+
+class M9AMigrationDraft(BaseModel):
+    script: dict[str, Any]
+    users: list[dict[str, Any]] = Field(default_factory=list)
+    warnings: list[str] = Field(default_factory=list)

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a/plugin.py

@@ -0,0 +1,105 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from app.plugins import ScriptAdapterDefinition, ScriptAdapterPlugin
+from automas_script_maafw.adapter import MaaFWAdapterHooks
+
+from .migration import migrate_legacy_m9a_config
+from .schema import M9A_SCRIPT_GROUPS, M9A_USER_GROUPS
+from .service import M9APackService
+
+if TYPE_CHECKING:
+    from auto_mas_core import PluginContext
+
+
+DEFAULT_INSTANCE = {
+    "name": "M9A MaaFW Pack",
+    "enabled": True,
+    "config": {},
+}
+
+schema = {
+    "__no_plugin_config__": {
+        "type": "boolean",
+        "default": True,
+        "hidden": True,
+        "configurable": False,
+        "title": "No plugin-level configuration",
+    },
+}
+
+SCRIPT_TYPE_BINDINGS = [
+    {
+        "type_key": "M9A",
+        "display_name": "M9A",
+        "script_config_class_name": "M9AConfig",
+    }
+]
+
+
+class Plugin(ScriptAdapterPlugin):
+    provides = ["maafw.pack.m9a.v1"]
+    wants = [
+        "maafw.registry.v1",
+        "maafw.interface.v1",
+        "maafw.project_update.v1",
+        "maafw.runner.v1",
+    ]
+
+    def __init__(self, ctx: "PluginContext") -> None:
+        super().__init__(ctx)
+        self.ctx = ctx
+        self.service = M9APackService()
+
+    def build_script_adapters(self):
+        return [
+            ScriptAdapterDefinition(
+                type_key="M9A",
+                display_name="M9A",
+                hooks_factory=MaaFWAdapterHooks,
+                script_groups=M9A_SCRIPT_GROUPS,
+                user_groups=M9A_USER_GROUPS,
+                script_class_name="M9APluginConfig",
+                user_class_name="M9APluginUserConfig",
+                module="automas_script_maafw.schema",
+                related_bindings={"EmulatorConfig": "EmulatorConfig"},
+                supported_modes=("AutoProxy",),
+                icon="M9A",
+                icon_path="automas_script_maafw_pack_m9a:assets/m9a.png",
+                editor_kind="plugin:automas_script_maafw_pack_m9a",
+                legacy_config_class_name="M9AConfig",
+                legacy_user_config_class_name="M9AUserConfig",
+                is_builtin=False,
+                metadata={
+                    "framework": "maafw",
+                    "source": "automas_script_maafw_pack_m9a",
+                    "project_pack": "m9a",
+                    "m9a_standalone": True,
+                    "theme_color": "cyan",
+                    "legacy_config_migrator": migrate_legacy_m9a_config,
+                    "script_edit_hint": {
+                        "text": "遇到配置问题时，可以查看",
+                        "link_text": "M9A 配置指南",
+                        "url": "https://doc.auto-mas.top/docs/script-guide/m9a.html",
+                        "suffix": "，其中整理了项目目录、运行环境和任务配置步骤。",
+                    },
+                },
+            )
+        ]
+
+    async def on_start(self) -> None:
+        self.ctx.set("maafw.pack.m9a.v1", self.service)
+        registry = self.ctx.get("maafw.registry.v1")
+        if registry is not None and hasattr(registry, "register_project_pack"):
+            registry.register_project_pack(self.service.get_definition())
+        await super().on_start()
+        self.ctx.logger.info("maafw.pack.m9a.v1 ready")
+
+    async def on_stop(self, reason: str) -> None:
+        registry = self.ctx.get("maafw.registry.v1")
+        if registry is not None and hasattr(registry, "unregister_project_pack"):
+            registry.unregister_project_pack("m9a")
+        self.ctx.set("maafw.pack.m9a.v1", None)
+        await super().on_stop(reason)
+        self.ctx.logger.info(f"maafw.pack.m9a.v1 stopped, reason={reason}")

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a/py.typed

@@ -0,0 +1 @@
+

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a/schema.py

@@ -0,0 +1,75 @@
+"""M9A project-pack schema overrides for the shared MaaFW editor."""
+
+from __future__ import annotations
+
+import json
+from dataclasses import replace
+
+from app.plugins.fields import PluginFieldGroup
+from automas_script_maafw.schema import SCRIPT_GROUPS, USER_GROUPS, build_source_config
+
+
+schema = {
+    "__no_plugin_config__": {
+        "type": "boolean",
+        "default": True,
+        "hidden": True,
+        "configurable": False,
+        "title": "No plugin-level configuration",
+    },
+}
+
+
+M9A_PERIOD_TASK_DEFAULTS = {
+    "DailyOnceTasks": ["Psychube"],
+    "WeeklyOnceTasks": [],
+    "MonthlyOnceTasks": ["SleepDream"],
+}
+
+
+def _build_m9a_info_group(group: PluginFieldGroup) -> PluginFieldGroup:
+    name_field = replace(group.fields[0], default="新M9A脚本")
+    path_field = replace(
+        group.fields[2],
+        label="M9A 项目路径",
+        placeholder="选择包含 interface.json 的 M9A 项目目录",
+    )
+    return replace(
+        group,
+        fields=(
+            name_field,
+            group.fields[1],
+            path_field,
+            *group.fields[3:],
+        ),
+    )
+
+
+def _build_m9a_run_group(group: PluginFieldGroup) -> PluginFieldGroup:
+    return replace(
+        group,
+        fields=tuple(
+            replace(field, default=json.dumps(M9A_PERIOD_TASK_DEFAULTS[field.name]))
+            if field.name in M9A_PERIOD_TASK_DEFAULTS
+            else field
+            for field in group.fields
+        ),
+    )
+
+
+def _build_m9a_group(group: PluginFieldGroup) -> PluginFieldGroup:
+    if group.key == "Info":
+        return _build_m9a_info_group(group)
+    if group.key == "Run":
+        return _build_m9a_run_group(group)
+    return group
+
+
+M9A_SCRIPT_GROUPS: tuple[PluginFieldGroup, ...] = tuple(
+    _build_m9a_group(group) for group in SCRIPT_GROUPS
+)
+
+# User config intentionally reuses the MaaFW surface and storage shape.
+M9A_USER_GROUPS = USER_GROUPS
+
+__all__ = ["M9A_SCRIPT_GROUPS", "M9A_USER_GROUPS", "build_source_config"]

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a/service.py

@@ -0,0 +1,185 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+
+from .models import (
+    M9AMigrationDraft,
+    M9ANotificationContent,
+    M9APackDefinition,
+    M9APeriodRule,
+)
+
+
+PERIOD_RULES = [
+    M9APeriodRule(task="Psychube", period="daily"),
+    M9APeriodRule(task="SleepDream", period="monthly"),
+]
+
+DEFAULT_TASK_QUEUE = [
+    "StartUp",
+    "Psychube",
+    "SleepDream",
+    "Award",
+    "CloseDown",
+]
+
+RESERVED_TASK_SEMANTICS = {
+    "Psychube": {"period": "daily", "label": "每日心相"},
+    "SleepDream": {"period": "monthly", "label": "深眠浅梦"},
+}
+
+
+class M9APackService:
+    """maafw.pack.m9a.v1 service."""
+
+    def get_definition(self) -> M9APackDefinition:
+        return M9APackDefinition(
+            key="m9a",
+            display_name="M9A",
+            project_repo="MAA1999/M9A",
+            interface_path="interface.json",
+            supported_controllers=["adb", "win32"],
+            default_controller="adb",
+            default_resource="resource",
+            default_preset="日常任务",
+            default_task_queue=DEFAULT_TASK_QUEUE,
+            period_rules=PERIOD_RULES,
+            reserved_task_semantics=RESERVED_TASK_SEMANTICS,
+            icon="automas_script_maafw_pack_m9a:assets/m9a.png",
+            notes="M9A 专项插件包 — 重返未来：1999 自动化",
+            framework="maafw",
+            capabilities=[
+                "period_rules",
+                "notification_translation",
+                "create_only_migration",
+            ],
+        )
+
+    def translate_notification(
+        self,
+        result: Any,
+        *,
+        script_name: str = "M9A",
+        user_name: str = "",
+        started_at: str | None = None,
+        ended_at: str | None = None,
+    ) -> M9ANotificationContent:
+        payload = _to_mapping(result)
+        success = bool(payload.get("success"))
+        completed_tasks = [
+            str(item)
+            for item in payload.get("completedTasks", [])
+            if str(item).strip()
+        ]
+        failed_task = str(payload.get("failedTask") or "").strip()
+        error_message = str(payload.get("errorMessage") or "").strip()
+
+        subject = user_name or script_name or "M9A"
+        title = f"{subject} 的 M9A 任务已完成" if success else f"{subject} 的 M9A 任务未完成"
+        lines = []
+        if started_at or ended_at:
+            lines.append(f"开始时间: {started_at or '-'}")
+            lines.append(f"结束时间: {ended_at or datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+        if completed_tasks:
+            lines.append("已完成任务: " + ", ".join(completed_tasks))
+        else:
+            lines.append("已完成任务: 无")
+        if failed_task:
+            lines.append(f"失败任务: {failed_task}")
+        if error_message:
+            lines.append(f"失败原因: {error_message}")
+        if not error_message and not success:
+            lines.append("失败原因: MaaFW runner 未返回成功状态")
+        return M9ANotificationContent(title=title, text="\n".join(lines))
+
+    def create_migration_draft(
+        self,
+        old_script_config: dict[str, Any] | None,
+        old_user_configs: list[dict[str, Any]] | None = None,
+        *,
+        script_name: str = "M9A",
+    ) -> M9AMigrationDraft:
+        warnings = [
+            "迁移入口只创建新插件配置草稿，不覆盖旧 M9A 配置。",
+            "项目来源、controller、resource、preset、任务队列和模板必须通过通用 MaaFW 流程现拉。",
+        ]
+        script_payload = {
+            "type": "PluginScriptConfig",
+            "Meta": {"PluginTypeKey": "M9A"},
+            "Info": {"Name": script_name},
+            "PluginData": {
+                "Config": {
+                    "pack": "m9a",
+                    "legacy": _filter_legacy_script_fields(old_script_config or {}),
+                }
+            },
+        }
+
+        users: list[dict[str, Any]] = []
+        for index, old_user in enumerate(old_user_configs or [], start=1):
+            user_name = _extract_user_name(old_user) or f"M9A 用户 {index}"
+            users.append(
+                {
+                    "type": "PluginUserConfig",
+                    "Meta": {"PluginTypeKey": "M9A"},
+                    "Info": {"Name": user_name},
+                    "PluginData": {
+                        "Config": {
+                            "pack": "m9a",
+                            "legacy": _filter_legacy_user_fields(old_user),
+                        }
+                    },
+                }
+            )
+
+        return M9AMigrationDraft(script=script_payload, users=users, warnings=warnings)
+
+
+def _to_mapping(value: Any) -> dict[str, Any]:
+    if isinstance(value, dict):
+        return value
+    if hasattr(value, "model_dump"):
+        data = value.model_dump(mode="json")
+        return data if isinstance(data, dict) else {}
+    if hasattr(value, "__dict__"):
+        return {
+            key: item
+            for key, item in vars(value).items()
+            if not key.startswith("_")
+        }
+    return {}
+
+
+def _filter_legacy_script_fields(value: dict[str, Any]) -> dict[str, Any]:
+    return {
+        "path": _nested_get(value, "Info", "Path"),
+        "autoUpdate": _nested_get(value, "Run", "IfAutoUpdateAfterQueue"),
+        "weeklyTasks": _nested_get(value, "Run", "WeeklyOnceTasks"),
+        "monthlyTasks": _nested_get(value, "Run", "MonthlyOnceTasks"),
+    }
+
+
+def _filter_legacy_user_fields(value: dict[str, Any]) -> dict[str, Any]:
+    return {
+        "name": _extract_user_name(value),
+        "taskQueue": _nested_get(value, "Task", "Queue"),
+        "notifyEnabled": _nested_get(value, "Notify", "Enabled"),
+    }
+
+
+def _nested_get(value: dict[str, Any], section: str, key: str) -> Any:
+    section_value = value.get(section)
+    if isinstance(section_value, dict):
+        return section_value.get(key)
+    return None
+
+
+def _extract_user_name(value: dict[str, Any]) -> str:
+    info = value.get("Info")
+    if isinstance(info, dict):
+        name = info.get("Name")
+        if isinstance(name, str) and name.strip():
+            return name.strip()
+    name = value.get("name")
+    return name.strip() if isinstance(name, str) else ""

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a.egg-info/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: automas-script-maafw-pack-m9a
+Version: 0.1.1
+Summary: M9A project pack declarations for the AUTO-MAS MaaFW plugin
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: automas-script-maafw>=0.1.2
+Requires-Dist: pydantic>=2
+
+# automas-script-maafw-pack-m9a
+
+M9A project pack declarations for the AUTO-MAS MaaFW plugin.
+
+The package provides `maafw.pack.m9a.v1`. It does not declare default project
+sources, controller, resource, preset, task queues, or task templates. Those are
+loaded through the generic MaaFW project/interface flow.

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+README.md
+pyproject.toml
+src/automas_script_maafw_pack_m9a/__init__.py
+src/automas_script_maafw_pack_m9a/migration.py
+src/automas_script_maafw_pack_m9a/models.py
+src/automas_script_maafw_pack_m9a/plugin.py
+src/automas_script_maafw_pack_m9a/py.typed
+src/automas_script_maafw_pack_m9a/schema.py
+src/automas_script_maafw_pack_m9a/service.py
+src/automas_script_maafw_pack_m9a.egg-info/PKG-INFO
+src/automas_script_maafw_pack_m9a.egg-info/SOURCES.txt
+src/automas_script_maafw_pack_m9a.egg-info/dependency_links.txt
+src/automas_script_maafw_pack_m9a.egg-info/entry_points.txt
+src/automas_script_maafw_pack_m9a.egg-info/requires.txt
+src/automas_script_maafw_pack_m9a.egg-info/top_level.txt
+src/automas_script_maafw_pack_m9a/assets/m9a.png

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[auto_mas.plugins]
+automas_script_maafw_pack_m9a = automas_script_maafw_pack_m9a.plugin:Plugin

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a.egg-info/requires.txt

@@ -0,0 +1,2 @@
+automas-script-maafw>=0.1.2
+pydantic>=2

automas_script_maafw_pack_m9a-0.1.1/src/automas_script_maafw_pack_m9a.egg-info/top_level.txt

@@ -0,0 +1 @@
+automas_script_maafw_pack_m9a