PyClickerRPA 0.1.0__py3-none-any.whl

autoclicker/gui/snippet_library.py

@@ -0,0 +1,117 @@
+"""Reusable step-snippet library — port of snippetlibrary.cpp.
+
+Snippets are JSON files under <AppDataLocation>/snippets (same folder as the C++
+app, so they are shared). Each holds a named list of Steps that can be inserted
+into the current task.
+"""
+from __future__ import annotations
+
+import json
+import os
+import re
+
+from PySide6.QtCore import Qt, Signal, QStandardPaths
+from PySide6.QtWidgets import (
+    QHBoxLayout, QInputDialog, QLabel, QListWidget, QListWidgetItem,
+    QPushButton, QVBoxLayout, QWidget,
+)
+
+from autoclicker.models import Step
+
+
+class SnippetLibrary(QWidget):
+    insertRequested = Signal(object)   # emits list[Step]
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        lay = QVBoxLayout(self)
+        hint = QLabel("步骤模板库 — 保存常用步骤组合，一键插入复用")
+        hint.setStyleSheet("color: gray;")
+        lay.addWidget(hint)
+        self.list = QListWidget()
+        lay.addWidget(self.list)
+        row = QHBoxLayout()
+        for text, slot in [("插入到任务", self._insert), ("重命名", self._rename), ("删除", self._delete)]:
+            b = QPushButton(text)
+            b.clicked.connect(slot)
+            row.addWidget(b)
+        lay.addLayout(row)
+
+        os.makedirs(self._dir(), exist_ok=True)
+        self.refresh()
+
+    def _dir(self) -> str:
+        base = QStandardPaths.writableLocation(QStandardPaths.AppDataLocation)
+        return os.path.join(base, "snippets")
+
+    def save_snippet(self, name: str, steps: list[Step]):
+        if not steps:
+            return
+        filename = re.sub(r"[^\w\-]", "_", name) + ".json"
+        root = {"name": name, "step_count": len(steps), "steps": [s.to_json() for s in steps]}
+        with open(os.path.join(self._dir(), filename), "w", encoding="utf-8") as f:
+            json.dump(root, f, ensure_ascii=False, indent=4)
+        self.refresh()
+
+    def _load(self, filename: str) -> list[Step]:
+        try:
+            with open(os.path.join(self._dir(), filename), "r", encoding="utf-8") as f:
+                doc = json.load(f)
+        except (OSError, json.JSONDecodeError):
+            return []
+        return [Step.from_json(o) for o in doc.get("steps", [])]
+
+    def refresh(self):
+        self.list.clear()
+        d = self._dir()
+        if not os.path.isdir(d):
+            return
+        for fn in sorted(f for f in os.listdir(d) if f.endswith(".json")):
+            try:
+                with open(os.path.join(d, fn), "r", encoding="utf-8") as f:
+                    doc = json.load(f)
+            except (OSError, json.JSONDecodeError):
+                continue
+            name = doc.get("name", os.path.splitext(fn)[0])
+            count = doc.get("step_count", len(doc.get("steps", [])))
+            item = QListWidgetItem(f"{name} ({count} 步)")
+            item.setData(Qt.UserRole, fn)
+            self.list.addItem(item)
+
+    def _insert(self):
+        item = self.list.currentItem()
+        if not item:
+            return
+        steps = self._load(item.data(Qt.UserRole))
+        if steps:
+            self.insertRequested.emit(steps)
+
+    def _delete(self):
+        item = self.list.currentItem()
+        if not item:
+            return
+        try:
+            os.remove(os.path.join(self._dir(), item.data(Qt.UserRole)))
+        except OSError:
+            pass
+        self.refresh()
+
+    def _rename(self):
+        item = self.list.currentItem()
+        if not item:
+            return
+        fn = item.data(Qt.UserRole)
+        path = os.path.join(self._dir(), fn)
+        try:
+            with open(path, "r", encoding="utf-8") as f:
+                doc = json.load(f)
+        except (OSError, json.JSONDecodeError):
+            return
+        old = doc.get("name", "")
+        new, ok = QInputDialog.getText(self, "重命名", "新名称:", text=old)
+        if not ok or not new or new == old:
+            return
+        doc["name"] = new
+        with open(path, "w", encoding="utf-8") as f:
+            json.dump(doc, f, ensure_ascii=False, indent=4)
+        self.refresh()

autoclicker/gui/task_widget.py

@@ -0,0 +1,547 @@
+"""Linear step-list editor — port of taskwidget.cpp.
+
+A QListWidget of steps with add/remove/move/copy/paste, plus a dynamic step
+editor dialog that shows only the fields relevant to the chosen step type
+(mirroring the conditional field building in the C++ TaskWidget). Advanced
+retry / repeat / until sections are shown for action-type steps.
+"""
+from __future__ import annotations
+
+import copy
+
+from PySide6.QtCore import Qt, Signal
+from PySide6.QtWidgets import (
+    QCheckBox, QComboBox, QDialog, QDialogButtonBox, QDoubleSpinBox, QFileDialog,
+    QFormLayout, QHBoxLayout, QLabel, QLineEdit, QListWidget, QListWidgetItem,
+    QPushButton, QSpinBox, QVBoxLayout, QWidget,
+)
+
+from autoclicker.models import (
+    RetryConfig, RepeatConfig, UntilConfig, Step, StepType, Task,
+    RetryPolicy, UntilCondition,
+)
+
+# Human labels for the type picker (add order roughly matches C++ menu)
+TYPE_LABELS = [
+    (StepType.ClickImage, "找图点击"),
+    (StepType.ClickText, "找字点击"),
+    (StepType.ClickPosition, "坐标点击"),
+    (StepType.Wait, "等待"),
+    (StepType.RandomWait, "随机等待"),
+    (StepType.Loop, "循环"),
+    (StepType.Goto, "跳转"),
+    (StepType.IfImageFound, "条件(图片)"),
+    (StepType.IfTextFound, "条件(文字)"),
+    (StepType.IfColorMatch, "条件(颜色)"),
+    (StepType.IfImageCount, "条件(图片数量)"),
+    (StepType.IfVar, "条件(变量)"),
+    (StepType.IfElse, "If/Else"),
+    (StepType.CallSub, "调用子任务"),
+    (StepType.SetVar, "设置变量"),
+    (StepType.KeyPress, "按键"),
+    (StepType.TypeText, "输入文字"),
+    (StepType.Hotkey, "组合键"),
+    (StepType.LongPress, "长按"),
+    (StepType.Drag, "拖拽"),
+    (StepType.MultiDrag, "多点拖拽"),
+    (StepType.Pinch, "捏合"),
+    (StepType.Scroll, "滚轮"),
+    (StepType.WaitImage, "等待图片出现"),
+    (StepType.WaitImageGone, "等待图片消失"),
+    (StepType.MergeImage, "合成拖拽"),
+    (StepType.ClickAll, "点击所有匹配"),
+    (StepType.ClickRelative, "相对点击(last+偏移)"),
+    (StepType.ReadText, "读取文字→变量"),
+    (StepType.DoUntil, "循环直到"),
+    (StepType.WhileCondition, "While 条件"),
+    (StepType.GroupBegin, "分组开始"),
+    (StepType.GroupEnd, "分组结束"),
+]
+
+_IMAGE_TYPES = {StepType.ClickImage, StepType.WaitImage, StepType.WaitImageGone,
+                StepType.MergeImage, StepType.ClickAll, StepType.IfImageFound,
+                StepType.IfImageCount}
+_IF_TYPES = {StepType.IfImageFound, StepType.IfTextFound, StepType.IfElse,
+             StepType.IfColorMatch, StepType.IfImageCount, StepType.IfVar}
+_ACTION_TYPES = {StepType.ClickImage, StepType.ClickText, StepType.ClickPosition,
+                 StepType.CallSub, StepType.WaitImage, StepType.WaitImageGone,
+                 StepType.MergeImage, StepType.ClickAll}
+_UNTIL_TYPES = {StepType.DoUntil, StepType.WhileCondition}
+
+
+class ImageListEditor(QWidget):
+    """Edit one-or-more template image paths."""
+    def __init__(self, paths: list[str], parent=None):
+        super().__init__(parent)
+        lay = QVBoxLayout(self)
+        lay.setContentsMargins(0, 0, 0, 0)
+        self.list = QListWidget()
+        self.list.setMaximumHeight(90)
+        for p in paths:
+            self.list.addItem(p)
+        row = QHBoxLayout()
+        add = QPushButton("添加图片…")
+        rm = QPushButton("移除")
+        add.clicked.connect(self._add)
+        rm.clicked.connect(self._remove)
+        row.addWidget(add)
+        row.addWidget(rm)
+        lay.addWidget(self.list)
+        lay.addLayout(row)
+
+    def _add(self):
+        files, _ = QFileDialog.getOpenFileNames(self, "选择模板图片", "", "图片 (*.png *.jpg *.jpeg *.bmp)")
+        for f in files:
+            self.list.addItem(f)
+
+    def _remove(self):
+        for it in self.list.selectedItems():
+            self.list.takeItem(self.list.row(it))
+
+    def paths(self) -> list[str]:
+        return [self.list.item(i).text() for i in range(self.list.count())]
+
+
+class StepEditorDialog(QDialog):
+    def __init__(self, step: Step, parent=None):
+        super().__init__(parent)
+        self.setWindowTitle("编辑步骤")
+        self.setMinimumWidth(420)
+        self._step = copy.deepcopy(step)
+        self.w: dict = {}
+
+        outer = QVBoxLayout(self)
+        self.form = QFormLayout()
+        outer.addLayout(self.form)
+        self._build_fields(self._step.type)
+
+        buttons = QDialogButtonBox(QDialogButtonBox.Ok | QDialogButtonBox.Cancel)
+        buttons.accepted.connect(self.accept)
+        buttons.rejected.connect(self.reject)
+        outer.addWidget(buttons)
+
+    # -- field builders -------------------------------------------------
+    def _spin(self, key, val, lo=-100000, hi=100000):
+        s = QSpinBox()
+        s.setRange(lo, hi)
+        s.setValue(val)
+        self.w[key] = s
+        return s
+
+    def _dspin(self, key, val):
+        s = QDoubleSpinBox()
+        s.setRange(0.0, 1.0)
+        s.setSingleStep(0.05)
+        s.setValue(val)
+        self.w[key] = s
+        return s
+
+    def _line(self, key, val):
+        e = QLineEdit(val)
+        self.w[key] = e
+        return e
+
+    def _build_fields(self, t: StepType):
+        s = self._step
+        if t in _IMAGE_TYPES:
+            paths = list(s.imagePaths) if s.imagePaths else ([s.imagePath] if s.imagePath else [])
+            self.w["images"] = ImageListEditor(paths)
+            self.form.addRow("模板图片", self.w["images"])
+            self.form.addRow("匹配阈值", self._dspin("threshold", s.threshold))
+            self.form.addRow("ROI (x,y,w,h)", self._line("roi", _roi_to_str(s.roiRect)))
+            mc = QCheckBox("多尺度匹配")
+            mc.setChecked(s.multiScale)
+            self.w["multiScale"] = mc
+            self.form.addRow("", mc)
+        if t in (StepType.ClickImage, StepType.WaitImage, StepType.WaitImageGone, StepType.MergeImage):
+            self.form.addRow("超时(ms)", self._spin("timeoutMs", s.timeoutMs, 0, 3600000))
+        if t == StepType.IfImageCount:
+            self.form.addRow("最少匹配数", self._spin("minMatchCount", s.minMatchCount, 1, 100))
+        if t == StepType.ClickAll:
+            self.form.addRow("点击间隔(ms)", self._spin("clickDelayMs", s.clickDelayMs, 0, 60000))
+        if t == StepType.MergeImage:
+            self.form.addRow("合成间隔(ms)", self._spin("mergeDelayMs", s.mergeDelayMs, 0, 60000))
+            self.form.addRow("拖拽时长(ms)", self._spin("durationMs", s.durationMs, 0, 60000))
+
+        if t in (StepType.ClickText, StepType.IfTextFound):
+            self.form.addRow("目标文字", self._line("text", s.text))
+        if t == StepType.ClickText:
+            self.form.addRow("超时(ms)", self._spin("timeoutMs", s.timeoutMs, 0, 3600000))
+        if t == StepType.TypeText:
+            self.form.addRow("输入文字", self._line("text", s.text))
+
+        if t in (StepType.ClickPosition, StepType.LongPress, StepType.Drag,
+                 StepType.Pinch, StepType.Scroll, StepType.IfColorMatch):
+            self.form.addRow("X", self._spin("x", s.x))
+            self.form.addRow("Y", self._spin("y", s.y))
+        if t == StepType.ClickPosition:
+            uv = QCheckBox("使用 last_x/last_y 变量")
+            uv.setChecked(s.varName == "use_var")
+            self.w["use_var"] = uv
+            self.form.addRow("", uv)
+        if t == StepType.Drag:
+            self.form.addRow("X2", self._spin("x2", s.x2))
+            self.form.addRow("Y2", self._spin("y2", s.y2))
+            self.form.addRow("时长(ms)", self._spin("durationMs", s.durationMs, 0, 60000))
+        if t == StepType.LongPress:
+            self.form.addRow("按住(ms)", self._spin("holdMs", s.holdMs, 0, 600000))
+        if t == StepType.Pinch:
+            self.form.addRow("起始距离", self._spin("pinchStartDist", s.pinchStartDist, 0, 5000))
+            self.form.addRow("结束距离", self._spin("pinchEndDist", s.pinchEndDist, 0, 5000))
+            self.form.addRow("时长(ms)", self._spin("durationMs", s.durationMs, 0, 60000))
+        if t == StepType.Scroll:
+            self.form.addRow("滚动格数", self._spin("scrollAmount", s.scrollAmount, -100, 100))
+
+        # Click offset from the matched image center (0,0 = center)
+        if t in (StepType.ClickImage, StepType.ClickText, StepType.ClickAll):
+            self.form.addRow("点击偏移X", self._spin("x", s.x))
+            self.form.addRow("点击偏移Y", self._spin("y", s.y))
+
+        if t == StepType.ClickRelative:
+            self.form.addRow("偏移X (相对 last_x)", self._spin("x", s.x))
+            self.form.addRow("偏移Y (相对 last_y)", self._spin("y", s.y))
+
+        if t == StepType.ReadText:
+            self.form.addRow("目标变量", self._line("varName", s.varName))
+            mode = QComboBox()
+            mode.addItem("文字", "text")
+            mode.addItem("数字", "number")
+            mode.setCurrentIndex(1 if s.varValue == "number" else 0)
+            self.w["readmode"] = mode
+            self.form.addRow("读取模式", mode)
+            self.form.addRow("过滤子串(可选)", self._line("text", s.text))
+            self.form.addRow("ROI (x,y,w,h)", self._line("roi", _roi_to_str(s.roiRect)))
+
+        if t in (StepType.ClickImage, StepType.ClickText, StepType.ClickPosition,
+                 StepType.ClickAll, StepType.ClickRelative):
+            self.form.addRow("随机偏移(px)", self._spin("randomOffset", s.randomOffset, 0, 500))
+
+        if t == StepType.Wait:
+            self.form.addRow("等待(ms)", self._spin("waitMs", s.waitMs, 0, 3600000))
+        if t == StepType.RandomWait:
+            self.form.addRow("最小(ms)", self._spin("waitMs", s.waitMs, 0, 3600000))
+            self.form.addRow("最大(ms)", self._spin("waitMsMax", s.waitMsMax, 0, 3600000))
+
+        if t in (StepType.Loop, StepType.DoUntil, StepType.WhileCondition):
+            self.form.addRow("回到步骤(从1)", self._spin("loopTarget1", s.loopTarget + 1, 1, 100000))
+        if t == StepType.Loop:
+            self.form.addRow("循环次数(-1=无限)", self._spin("loopCount", s.loopCount, -1, 1000000))
+        if t == StepType.Goto:
+            self.form.addRow("跳转到步骤(从1)", self._spin("gotoTarget1", s.gotoTarget + 1, 1, 100000))
+
+        if t in _IF_TYPES:
+            self.form.addRow("否则跳过步数", self._spin("elseSkip", s.elseSkip, 0, 1000))
+
+        if t == StepType.CallSub:
+            self.form.addRow("子任务路径", self._line("subTaskPath", s.subTaskPath))
+        if t == StepType.SetVar:
+            self.form.addRow("变量名", self._line("varName", s.varName))
+            self.form.addRow("值 (++/-- 支持)", self._line("varValue", s.varValue))
+        if t in (StepType.IfVar, StepType.WhileCondition):
+            self.form.addRow("变量名", self._line("varName", s.varName))
+            op = QComboBox()
+            op.addItems(["==", "!=", ">", "<", ">=", "<="])
+            if s.compareOp:
+                op.setCurrentText(s.compareOp)
+            self.w["compareOp"] = op
+            self.form.addRow("比较", op)
+            self.form.addRow("比较值", self._line("compareValue", s.compareValue))
+        if t == StepType.KeyPress:
+            self.form.addRow("按键", self._line("keyName", s.keyName))
+        if t == StepType.Hotkey:
+            self.form.addRow("修饰键", self._line("modifierKey", s.modifierKey))
+            self.form.addRow("按键", self._line("keyName", s.keyName))
+        if t == StepType.IfColorMatch:
+            self.form.addRow("目标颜色(#RRGGBB)", self._line("targetColor", s.targetColor))
+            self.form.addRow("容差", self._spin("colorTolerance", s.colorTolerance, 0, 255))
+        if t == StepType.MultiDrag:
+            self.form.addRow("拖拽点 (x,y;x,y…)", self._line("dragPoints", _points_to_str(s.dragPoints)))
+            self.form.addRow("每段时长(ms)", self._spin("durationMs", s.durationMs, 0, 60000))
+            self.form.addRow("段间延迟(ms)", self._spin("dragStepDelay", s.dragStepDelay, 0, 60000))
+        if t == StepType.GroupBegin:
+            self.form.addRow("分组名", self._line("groupName", s.groupName))
+            dc = QCheckBox("禁用该分组")
+            dc.setChecked(s.disabled)
+            self.w["disabled"] = dc
+            self.form.addRow("", dc)
+
+        if t in _UNTIL_TYPES:
+            self._build_until(s.until)
+        if t in _ACTION_TYPES:
+            self._build_retry(s.retry)
+            self._build_repeat(s.repeat)
+
+    def _build_until(self, u: UntilConfig):
+        self.form.addRow(QLabel("── 条件 ──"))
+        combo = QComboBox()
+        for uc, name in [(UntilCondition.NoneCond, "无"), (UntilCondition.ImageFound, "图片出现"),
+                         (UntilCondition.ImageGone, "图片消失"), (UntilCondition.TextFound, "文字出现"),
+                         (UntilCondition.ColorMatch, "颜色匹配")]:
+            combo.addItem(name, uc)
+        idx = combo.findData(u.type)
+        combo.setCurrentIndex(max(0, idx))
+        self.w["until_type"] = combo
+        self.form.addRow("条件类型", combo)
+        self.form.addRow("条件图片", self._line("until_image", u.image))
+        self.form.addRow("条件文字", self._line("until_text", u.text))
+        self.form.addRow("条件颜色", self._line("until_color", u.color))
+        self.form.addRow("条件超时(ms)", self._spin("until_timeoutMs", u.timeoutMs, 0, 3600000))
+
+    def _build_retry(self, r: RetryConfig):
+        self.form.addRow(QLabel("── 失败处理 ──"))
+        combo = QComboBox()
+        for rp, name in [(RetryPolicy.NoneP, "无"), (RetryPolicy.Retry, "重试"),
+                         (RetryPolicy.Skip, "跳过"), (RetryPolicy.Abort, "中止任务")]:
+            combo.addItem(name, rp)
+        combo.setCurrentIndex(max(0, combo.findData(r.policy)))
+        self.w["retry_policy"] = combo
+        self.form.addRow("策略", combo)
+        self.form.addRow("重试次数", self._spin("retry_count", r.count, 0, 1000))
+        self.form.addRow("重试间隔(ms)", self._spin("retry_delayMs", r.delayMs, 0, 600000))
+
+    def _build_repeat(self, rp: RepeatConfig):
+        self.form.addRow(QLabel("── 重复 ──"))
+        self.form.addRow("重复次数(1=一次)", self._spin("repeat_times", rp.times, -1, 100000))
+        self.form.addRow("重复间隔(ms)", self._spin("repeat_delayMs", rp.delayMs, 0, 600000))
+
+    # -- collect --------------------------------------------------------
+    def result_step(self) -> Step:
+        s = self._step
+        t = s.type
+        w = self.w
+
+        def gi(key):
+            return w[key].value()
+
+        def gt(key):
+            return w[key].text()
+
+        if "images" in w:
+            paths = w["images"].paths()
+            if len(paths) == 1:
+                s.imagePath, s.imagePaths = paths[0], []
+            else:
+                s.imagePath, s.imagePaths = "", paths
+        if "threshold" in w:
+            s.threshold = w["threshold"].value()
+        if "roi" in w:
+            s.roiRect = _str_to_roi(gt("roi"))
+        if "multiScale" in w:
+            s.multiScale = w["multiScale"].isChecked()
+        for key in ("timeoutMs", "minMatchCount", "clickDelayMs", "mergeDelayMs",
+                    "x", "y", "x2", "y2", "durationMs", "holdMs", "pinchStartDist",
+                    "pinchEndDist", "scrollAmount", "randomOffset", "waitMs", "waitMsMax",
+                    "loopCount", "elseSkip", "colorTolerance", "dragStepDelay"):
+            if key in w:
+                setattr(s, key, gi(key))
+        if "loopTarget1" in w:
+            s.loopTarget = gi("loopTarget1") - 1
+        if "gotoTarget1" in w:
+            s.gotoTarget = gi("gotoTarget1") - 1
+        for key in ("text", "subTaskPath", "varName", "varValue", "keyName",
+                    "modifierKey", "targetColor", "groupName", "compareValue"):
+            if key in w:
+                setattr(s, key, gt(key))
+        if "compareOp" in w:
+            s.compareOp = w["compareOp"].currentText()
+        if "readmode" in w:
+            s.varValue = w["readmode"].currentData()
+        if "use_var" in w:
+            s.varName = "use_var" if w["use_var"].isChecked() else ""
+        if "disabled" in w:
+            s.disabled = w["disabled"].isChecked()
+        if "dragPoints" in w:
+            s.dragPoints = _str_to_points(gt("dragPoints"))
+        if "until_type" in w:
+            s.until.type = w["until_type"].currentData()
+            s.until.image = gt("until_image")
+            s.until.text = gt("until_text")
+            s.until.color = gt("until_color")
+            s.until.timeoutMs = gi("until_timeoutMs")
+        if "retry_policy" in w:
+            s.retry.policy = w["retry_policy"].currentData()
+            s.retry.count = gi("retry_count")
+            s.retry.delayMs = gi("retry_delayMs")
+        if "repeat_times" in w:
+            s.repeat.times = gi("repeat_times")
+            s.repeat.delayMs = gi("repeat_delayMs")
+        return s
+
+
+class TaskWidget(QWidget):
+    taskChanged = Signal()
+    testStepRequested = Signal(object)   # emits a single Step to test-run
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self._task = Task()
+        self._clipboard: list[Step] = []
+
+        lay = QVBoxLayout(self)
+        top = QHBoxLayout()
+        self.type_combo = QComboBox()
+        for st, label in TYPE_LABELS:
+            self.type_combo.addItem(label, st)
+        add_btn = QPushButton("添加")
+        add_btn.clicked.connect(self._add)
+        top.addWidget(self.type_combo, 1)
+        top.addWidget(add_btn)
+        lay.addLayout(top)
+
+        self.list = QListWidget()
+        self.list.itemDoubleClicked.connect(self._edit_item)
+        lay.addWidget(self.list, 1)
+
+        row = QHBoxLayout()
+        for text, slot in [("↑", self._move_up), ("↓", self._move_down),
+                           ("删除", self._remove), ("复制", self._copy), ("粘贴", self._paste),
+                           ("试跑选中步", self._test_step)]:
+            b = QPushButton(text)
+            b.clicked.connect(slot)
+            row.addWidget(b)
+        lay.addLayout(row)
+
+    # -- task <-> ui ----
+    def get_task(self) -> Task:
+        return self._task
+
+    def set_task(self, task: Task):
+        self._task = task
+        self._refresh()
+
+    def _refresh(self):
+        self.list.clear()
+        for i, step in enumerate(self._task.steps):
+            self.list.addItem(QListWidgetItem(f"{i + 1}. {step.display_name()}"))
+
+    def get_selected_steps(self) -> list[Step]:
+        rows = sorted(self.list.row(it) for it in self.list.selectedItems())
+        return [copy.deepcopy(self._task.steps[r]) for r in rows if 0 <= r < len(self._task.steps)]
+
+    def current_index(self) -> int:
+        return self.list.currentRow()
+
+    def step_at(self, i: int) -> Step | None:
+        return self._task.steps[i] if 0 <= i < len(self._task.steps) else None
+
+    def replace_step(self, i: int, step: Step):
+        if 0 <= i < len(self._task.steps):
+            self._task.steps[i] = step
+            self._refresh()
+            self.list.setCurrentRow(i)
+            self.taskChanged.emit()
+
+    def insert_steps(self, steps: list[Step]):
+        row = self._selected_row()
+        at = row + 1 if row >= 0 else len(self._task.steps)
+        for i, s in enumerate(steps):
+            self._task.steps.insert(at + i, copy.deepcopy(s))
+        self._refresh()
+        self.taskChanged.emit()
+
+    def append_step(self, step: Step):
+        self._task.steps.append(step)
+        self._refresh()
+        self.taskChanged.emit()
+
+    def _selected_row(self) -> int:
+        return self.list.currentRow()
+
+    # -- actions ----
+    def _add(self):
+        st = self.type_combo.currentData()
+        step = Step(type=st)
+        dlg = StepEditorDialog(step, self)
+        if dlg.exec() == QDialog.Accepted:
+            self._task.steps.append(dlg.result_step())
+            self._refresh()
+            self.taskChanged.emit()
+
+    def _edit_item(self, item):
+        row = self.list.row(item)
+        if 0 <= row < len(self._task.steps):
+            dlg = StepEditorDialog(self._task.steps[row], self)
+            if dlg.exec() == QDialog.Accepted:
+                self._task.steps[row] = dlg.result_step()
+                self._refresh()
+                self.list.setCurrentRow(row)
+                self.taskChanged.emit()
+
+    def _remove(self):
+        row = self._selected_row()
+        if 0 <= row < len(self._task.steps):
+            del self._task.steps[row]
+            self._refresh()
+            self.taskChanged.emit()
+
+    def _move_up(self):
+        row = self._selected_row()
+        if row > 0:
+            self._task.steps[row - 1], self._task.steps[row] = self._task.steps[row], self._task.steps[row - 1]
+            self._refresh()
+            self.list.setCurrentRow(row - 1)
+            self.taskChanged.emit()
+
+    def _move_down(self):
+        row = self._selected_row()
+        if 0 <= row < len(self._task.steps) - 1:
+            self._task.steps[row + 1], self._task.steps[row] = self._task.steps[row], self._task.steps[row + 1]
+            self._refresh()
+            self.list.setCurrentRow(row + 1)
+            self.taskChanged.emit()
+
+    def _copy(self):
+        row = self._selected_row()
+        if 0 <= row < len(self._task.steps):
+            self._clipboard = [copy.deepcopy(self._task.steps[row])]
+
+    def _test_step(self):
+        step = self.step_at(self._selected_row())
+        if step is not None:
+            self.testStepRequested.emit(copy.deepcopy(step))
+
+    def _paste(self):
+        if not self._clipboard:
+            return
+        row = self._selected_row()
+        insert_at = row + 1 if row >= 0 else len(self._task.steps)
+        for i, s in enumerate(self._clipboard):
+            self._task.steps.insert(insert_at + i, copy.deepcopy(s))
+        self._refresh()
+        self.taskChanged.emit()
+
+
+# -- small parse helpers --------------------------------------------------------
+def _roi_to_str(roi):
+    return "" if not roi else f"{roi[0]},{roi[1]},{roi[2]},{roi[3]}"
+
+
+def _str_to_roi(text):
+    text = text.strip()
+    if not text:
+        return None
+    try:
+        parts = [int(p) for p in text.replace("，", ",").split(",")]
+        if len(parts) == 4:
+            return tuple(parts)
+    except ValueError:
+        pass
+    return None
+
+
+def _points_to_str(points):
+    return ";".join(f"{x},{y}" for x, y in points)
+
+
+def _str_to_points(text):
+    pts = []
+    for chunk in text.replace("；", ";").split(";"):
+        chunk = chunk.strip()
+        if not chunk:
+            continue
+        try:
+            x, y = (int(v) for v in chunk.replace("，", ",").split(","))
+            pts.append((x, y))
+        except ValueError:
+            pass
+    return pts