PyClickerRPA 0.2.0__tar.gz → 0.3.0__tar.gz

{pyclickerrpa-0.2.0 → pyclickerrpa-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyClickerRPA
-Version: 0.2.0
+Version: 0.3.0
 Summary: Visual UI automation & testing tool: Windows + Android(ADB) automation, robust/self-healing image matching, OCR, node flow editor, recorder, a visual test framework (assertions, visual regression, HTML/JUnit reports) and a web console.
 Author: Equinox
 License-Expression: MIT
@@ -84,12 +84,15 @@ autoclicker-web --suites-dir examples          # web console at http://127.0.0.1
 - **~30+ step types**: click image/text/position, click-all, relative/offset
   clicks, wait / random / wait-stable, drag / long-press / pinch / scroll,
   key / type / hotkey, loop / goto / while / do-until, if image/text/color/
-  count/var, set-var, read-text→variable, HTTP request, run-Python-script,
-  call sub-task, groups — with retry / repeat / until policies.
+  count/var with **true/false branching** (if-else), set-var, read-text→variable,
+  activate-window, HTTP request, run-Python-script, call sub-task, groups, and a
+  **stop** step to end a run — with retry / repeat / until policies.
 
 ## Authoring (desktop GUI)
 
-Drag-and-drop **node flow graph** and an interoperable **step list** with a full
+Drag-and-drop **node flow graph** (condition nodes have **true/false branch
+ports** for visual if-else; a terminal **stop** node ends the flow) and an
+interoperable **step list** with a full
 per-step dialog; an action **recorder** (global hooks), snippet library, task
 packages (`.zip` with templates), on-preview coordinate/color picking, template
 crop, single-step test run; global hotkeys (F6 run/stop, ESC stop), scheduler,

{pyclickerrpa-0.2.0 → pyclickerrpa-0.3.0}/PyClickerRPA.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyClickerRPA
-Version: 0.2.0
+Version: 0.3.0
 Summary: Visual UI automation & testing tool: Windows + Android(ADB) automation, robust/self-healing image matching, OCR, node flow editor, recorder, a visual test framework (assertions, visual regression, HTML/JUnit reports) and a web console.
 Author: Equinox
 License-Expression: MIT
@@ -84,12 +84,15 @@ autoclicker-web --suites-dir examples          # web console at http://127.0.0.1
 - **~30+ step types**: click image/text/position, click-all, relative/offset
   clicks, wait / random / wait-stable, drag / long-press / pinch / scroll,
   key / type / hotkey, loop / goto / while / do-until, if image/text/color/
-  count/var, set-var, read-text→variable, HTTP request, run-Python-script,
-  call sub-task, groups — with retry / repeat / until policies.
+  count/var with **true/false branching** (if-else), set-var, read-text→variable,
+  activate-window, HTTP request, run-Python-script, call sub-task, groups, and a
+  **stop** step to end a run — with retry / repeat / until policies.
 
 ## Authoring (desktop GUI)
 
-Drag-and-drop **node flow graph** and an interoperable **step list** with a full
+Drag-and-drop **node flow graph** (condition nodes have **true/false branch
+ports** for visual if-else; a terminal **stop** node ends the flow) and an
+interoperable **step list** with a full
 per-step dialog; an action **recorder** (global hooks), snippet library, task
 packages (`.zip` with templates), on-preview coordinate/color picking, template
 crop, single-step test run; global hotkeys (F6 run/stop, ESC stop), scheduler,

{pyclickerrpa-0.2.0 → pyclickerrpa-0.3.0}/PyClickerRPA.egg-info/SOURCES.txt

@@ -52,6 +52,7 @@ autoclicker/web/static/app.js
 autoclicker/web/static/index.html
 autoclicker/web/static/style.css
 tests/test_adb.py
+tests/test_flow_branch.py
 tests/test_matcher.py
 tests/test_models.py
 tests/test_runner.py

{pyclickerrpa-0.2.0 → pyclickerrpa-0.3.0}/README.md

@@ -46,12 +46,15 @@ autoclicker-web --suites-dir examples          # web console at http://127.0.0.1
 - **~30+ step types**: click image/text/position, click-all, relative/offset
   clicks, wait / random / wait-stable, drag / long-press / pinch / scroll,
   key / type / hotkey, loop / goto / while / do-until, if image/text/color/
-  count/var, set-var, read-text→variable, HTTP request, run-Python-script,
-  call sub-task, groups — with retry / repeat / until policies.
+  count/var with **true/false branching** (if-else), set-var, read-text→variable,
+  activate-window, HTTP request, run-Python-script, call sub-task, groups, and a
+  **stop** step to end a run — with retry / repeat / until policies.
 
 ## Authoring (desktop GUI)
 
-Drag-and-drop **node flow graph** and an interoperable **step list** with a full
+Drag-and-drop **node flow graph** (condition nodes have **true/false branch
+ports** for visual if-else; a terminal **stop** node ends the flow) and an
+interoperable **step list** with a full
 per-step dialog; an action **recorder** (global hooks), snippet library, task
 packages (`.zip` with templates), on-preview coordinate/color picking, template
 crop, single-step test run; global hotkeys (F6 run/stop, ESC stop), scheduler,

{pyclickerrpa-0.2.0 → pyclickerrpa-0.3.0}/autoclicker/capture.py

@@ -30,35 +30,51 @@ def _bitmap_to_bgr(bmp, width: int, height: int) -> np.ndarray:
 
 
 def capture_window(hwnd) -> np.ndarray:
-    """Capture the client area of *hwnd* as a BGR ndarray."""
+    """Capture the **client area** of *hwnd* as a BGR ndarray.
+
+    PrintWindow renders the whole window (title bar + borders + client) from the
+    window's top-left, so we render the full window and then crop to the client
+    rect. The result's (0, 0) is the client top-left — matching the Clicker's
+    ``ClientToScreen`` mapping, so match coords click the right spot (no offset
+    by the non-client area / title bar).
+    """
     if not _HAS_WIN32:
         raise RuntimeError("win32 modules unavailable")
+    import ctypes
 
-    left, top, right, bottom = win32gui.GetClientRect(hwnd)
-    width, height = right - left, bottom - top
-    if width <= 0 or height <= 0:
+    _, _, cw, ch = win32gui.GetClientRect(hwnd)     # client size
+    if cw <= 0 or ch <= 0:
+        return np.empty((0, 0, 3), dtype=np.uint8)
+
+    wl, wt, wr, wb = win32gui.GetWindowRect(hwnd)    # whole-window screen rect
+    ww, wh = wr - wl, wb - wt
+    csx, csy = win32gui.ClientToScreen(hwnd, (0, 0))  # client top-left in screen
+    ox, oy = csx - wl, csy - wt                       # client offset within window
+    if ww <= 0 or wh <= 0:
         return np.empty((0, 0, 3), dtype=np.uint8)
 
     hwnd_dc = win32gui.GetWindowDC(hwnd)
     mfc_dc = win32ui.CreateDCFromHandle(hwnd_dc)
     save_dc = mfc_dc.CreateCompatibleDC()
     bmp = win32ui.CreateBitmap()
-    bmp.CreateCompatibleBitmap(mfc_dc, width, height)
+    bmp.CreateCompatibleBitmap(mfc_dc, ww, wh)       # full-window sized bitmap
     save_dc.SelectObject(bmp)
 
     try:
-        import ctypes
         ok = ctypes.windll.user32.PrintWindow(hwnd, save_dc.GetSafeHdc(), PW_RENDERFULLCONTENT)
         if not ok:
-            # Fallback: BitBlt the window DC
-            save_dc.BitBlt((0, 0), (width, height), mfc_dc, (0, 0), win32con.SRCCOPY)
-        img = _bitmap_to_bgr(bmp, width, height)
+            save_dc.BitBlt((0, 0), (ww, wh), mfc_dc, (0, 0), win32con.SRCCOPY)
+        full = _bitmap_to_bgr(bmp, ww, wh)
     finally:
         win32gui.DeleteObject(bmp.GetHandle())
         save_dc.DeleteDC()
         mfc_dc.DeleteDC()
         win32gui.ReleaseDC(hwnd, hwnd_dc)
-    return img
+
+    ox = max(0, min(ox, max(0, ww - 1)))
+    oy = max(0, min(oy, max(0, wh - 1)))
+    client = full[oy:oy + ch, ox:ox + cw]
+    return np.ascontiguousarray(client)
 
 
 def capture_screen() -> np.ndarray:

{pyclickerrpa-0.2.0 → pyclickerrpa-0.3.0}/autoclicker/gui/flow_connection.py

@@ -65,7 +65,14 @@ class FlowConnection(QGraphicsPathItem):
             dy = end.y() - start.y()
             ctrl = min(dy * 0.5, 80.0)
             path.cubicTo(start.x(), start.y() + ctrl, end.x(), end.y() - ctrl, end.x(), end.y())
-            self.setPen(QPen(QColor(200, 200, 200), 2))
+            branch = getattr(self.from_port, "branch", None)
+            if branch == "true":
+                col = QColor(76, 175, 80)      # 真:绿
+            elif branch == "false":
+                col = QColor(229, 57, 53)      # 假:红
+            else:
+                col = QColor(200, 200, 200)
+            self.setPen(QPen(col, 2))
 
         self.setPath(path)
         mid = path.pointAtPercent(0.5)

{pyclickerrpa-0.2.0 → pyclickerrpa-0.3.0}/autoclicker/gui/flow_editor.py

@@ -22,14 +22,24 @@ from autoclicker.gui.flow_connection import FlowConnection
 # Context-menu "add node" grouping (label, StepType)
 _ADD_MENU = {
     "点击": [("找图点击", StepType.ClickImage), ("找字点击", StepType.ClickText),
-             ("坐标点击", StepType.ClickPosition), ("长按", StepType.LongPress)],
+             ("坐标点击", StepType.ClickPosition), ("点击所有匹配", StepType.ClickAll),
+             ("相对点击(last+偏移)", StepType.ClickRelative), ("长按", StepType.LongPress)],
     "输入": [("按键", StepType.KeyPress), ("输入文字", StepType.TypeText), ("快捷键", StepType.Hotkey)],
-    "手势": [("拖拽", StepType.Drag), ("捏合", StepType.Pinch), ("滚轮", StepType.Scroll)],
+    "手势": [("拖拽", StepType.Drag), ("多点拖拽", StepType.MultiDrag),
+             ("捏合", StepType.Pinch), ("滚轮", StepType.Scroll)],
+    "识别/变量": [("读取文字→变量", StepType.ReadText), ("设置变量", StepType.SetVar)],
+    "条件": [("条件(图片)", StepType.IfImageFound), ("条件(文字)", StepType.IfTextFound),
+             ("条件(颜色)", StepType.IfColorMatch), ("条件(图片数量)", StepType.IfImageCount),
+             ("条件(变量)", StepType.IfVar), ("If/Else", StepType.IfElse)],
     "流程": [("等待", StepType.Wait), ("随机等待", StepType.RandomWait),
+             ("等待画面稳定", StepType.WaitStable),
              ("等待图片出现", StepType.WaitImage), ("等待图片消失", StepType.WaitImageGone),
-             ("条件(图片)", StepType.IfImageFound), ("条件(文字)", StepType.IfTextFound),
-             ("条件(颜色)", StepType.IfColorMatch), ("调用子任务", StepType.CallSub),
-             ("设置变量", StepType.SetVar), ("循环直到", StepType.DoUntil)],
+             ("循环直到", StepType.DoUntil), ("While 条件", StepType.WhileCondition),
+             ("跳转", StepType.Goto), ("调用子任务", StepType.CallSub),
+             ("分组开始", StepType.GroupBegin), ("分组结束", StepType.GroupEnd),
+             ("结束任务", StepType.Stop)],
+    "窗口/高级": [("刷新/激活窗口", StepType.ActivateWindow), ("合成拖拽", StepType.MergeImage),
+                  ("HTTP 请求", StepType.HttpRequest), ("运行脚本(Python)", StepType.RunScript)],
 }
 
 
@@ -196,6 +206,13 @@ class FlowEditor(QGraphicsView):
             node.set_step(dlg.result_step())
             self.taskChanged.emit()
 
+    def selected_node(self):
+        """当前选中的第一个节点(FlowNode),没有则返回 None。"""
+        for item in self._scene.selectedItems():
+            if isinstance(item, FlowNode):
+                return item
+        return None
+
     def _set_repeat(self, conn: FlowConnection):
         count, ok = QInputDialog.getInt(self, "重复次数", "执行次数 (-1 = 无限, 1 = 单次):",
                                         conn.repeat_count, -1, 99999, 1)
@@ -231,88 +248,197 @@ class FlowEditor(QGraphicsView):
         return self.nodes[0] if self.nodes else None
 
     # ---- graph <-> Task ----
+    def _first_forward(self, port, emitted) -> FlowNode | None:
+        """该端口的首个「尚未发出」的目标(前向边);全被发出过则回退到首个目标(回边)。"""
+        targets = [c.to_port.parentItem() for c in port.connections]
+        for t in targets:
+            if t not in emitted:
+                return t
+        return targets[0] if targets else None
+
+    def _reachable(self, node, blocked: set) -> set:
+        """从 node 沿所有输出口前向可达的节点集合(带环保护)。
+        不穿过 blocked 里的节点——它们是已发出的祖先/循环目标,若允许穿过,回边会
+        绕一圈把分支入口自身也算成「可达」,导致汇合点误判(见 test_flow_branch 回边用例)。"""
+        seen, stack = set(), [node]
+        while stack:
+            n = stack.pop()
+            if n is None or n in seen or n in blocked:
+                continue
+            seen.add(n)
+            for p in n.output_ports():
+                for c in p.connections:
+                    stack.append(c.to_port.parentItem())
+        return seen
+
+    def _find_merge(self, a, b, blocked: set):
+        """真/假两分支入口 a、b 的首个共同汇合点;无则 None(两支各自终止或直接回边)。
+        blocked = 已发出节点,遍历不穿过它们,避免回边绕回上游造成误判。"""
+        if a is None or b is None:
+            return None
+        ra = self._reachable(a, blocked)
+        seen, stack = set(), [b]
+        while stack:
+            n = stack.pop()
+            if n is None or n in seen or n in blocked:
+                continue
+            seen.add(n)
+            if n in ra:
+                return n
+            for p in n.output_ports():
+                for c in p.connections:
+                    stack.append(c.to_port.parentItem())
+        return None
+
     def build_task(self) -> Task:
         task = Task(name="FlowTask")
         start = self._find_start()
         if not start:
             return task
 
-        order: list[FlowNode] = []
-        visited = {start}
-        queue = deque([start])
-        while queue:
-            current = queue.popleft()
-            order.append(current)
-            for conn in current.output_port.connections:
-                nxt = conn.to_port.parentItem()
-                if nxt not in visited:
-                    visited.add(nxt)
-                    queue.append(nxt)
-
-        node_index = {node: i for i, node in enumerate(order)}
-        for node in order:
+        emitted: set = set()
+        node_index: dict = {}
+
+        def emit(node, stop):
+            while node is not None and node is not stop and node not in emitted:
+                emitted.add(node)
+                s = node.step()
+                idx = len(task.steps)
+                node_index[node] = idx
+                task.steps.append(s)
+
+                has_else = (node.is_condition() and node.false_port is not None
+                            and bool(node.false_port.connections))
+                if has_else:
+                    then_entry = self._first_forward(node.output_port, emitted)
+                    else_entry = self._first_forward(node.false_port, emitted)
+                    merge = self._find_merge(then_entry, else_entry, emitted)
+                    emit(then_entry, merge)                      # then 块
+                    ifelse = Step(type=StepType.IfElse)
+                    ifelse_idx = len(task.steps)
+                    task.steps.append(ifelse)
+                    emit(else_entry, merge)                      # else 块
+                    merge_idx = len(task.steps)
+                    # cond 为假 → 跳过 then 块 + IfElse 标记,落到 else 块首行
+                    s.elseSkip = ifelse_idx - idx
+                    # IfElse 为真(then 已跑完)→ 跳过整个 else 块
+                    ifelse.elseSkip = merge_idx - ifelse_idx - 1
+                    node = merge
+                else:
+                    if node.is_condition():
+                        s.elseSkip = 0   # 图里未接双分支 → 只求值不跳转
+                    nxt = None
+                    if node.output_port is not None:      # 终止节点无输出口
+                        nxt = self._first_forward(node.output_port, emitted)
+                    if nxt is None and node.false_port is not None:
+                        nxt = self._first_forward(node.false_port, emitted)
+                    node = nxt
+
+        emit(start, None)
+
+        for node, idx in node_index.items():
             s = node.step()
             if s.type == StepType.DoUntil:
-                for conn in node.output_port.connections:
-                    target = conn.to_port.parentItem()
-                    ti = node_index.get(target, -1)
-                    mi = node_index.get(node, -1)
-                    if ti >= 0 and ti <= mi:
-                        s.loopTarget = ti
-                        break
-            task.steps.append(s)
-
-        # Back-edges with a repeat count become Loop steps
+                for p in node.output_ports():
+                    for conn in p.connections:
+                        ti = node_index.get(conn.to_port.parentItem(), -1)
+                        if 0 <= ti <= idx:
+                            s.loopTarget = ti
+                            break
+
+        # 带重复次数的回边 → Loop 步骤。注意:不支持把重复回边嵌进 if/else 分支内部
+        # (会打乱分支的相对 elseSkip 偏移);回边应作用于线性/循环段。
         for conn in self.connections:
-            from_node = conn.from_port.parentItem()
-            to_node = conn.to_port.parentItem()
-            fi = node_index.get(from_node, -1)
-            ti = node_index.get(to_node, -1)
+            fi = node_index.get(conn.from_port.parentItem(), -1)
+            ti = node_index.get(conn.to_port.parentItem(), -1)
             if fi >= 0 and ti >= 0 and ti <= fi and conn.repeat_count != 1:
                 loop = Step(type=StepType.Loop, loopTarget=ti, loopCount=conn.repeat_count)
                 insert_pos = fi + 1
                 task.steps.insert(insert_pos, loop)
-                for node in list(node_index):
-                    if node_index[node] >= insert_pos:
-                        node_index[node] += 1
+                for n in list(node_index):
+                    if node_index[n] >= insert_pos:
+                        node_index[n] += 1
         return task
 
     def load_task(self, task: Task):
+        """线性 Task → 图。Loop 步骤还原为回边;IfElse 是 build 时生成的分界标记，
+        不建节点,而是据此把条件节点的真/假分支口重新连回。非嵌套 if/else 可完整往返;
+        深度嵌套分支可能退化为线性连线(不影响已保存的线性 .json)。"""
+        from PySide6.QtCore import QPointF
+        from autoclicker.gui.flow_node import _CONDITION_TYPES
         self.clear()
+        steps = task.steps
+
+        node_step_idx = [i for i, s in enumerate(steps)
+                         if s.type not in (StepType.Loop, StepType.IfElse)]
+        node_set = set(node_step_idx)
+
+        # 识别 if/else 区间: 条件步(elseSkip>0) 且 C+elseSkip 处是 IfElse 标记
+        regions = []   # (C, then_nodes, else_nodes, merge_idx)
+        else_steps: set = set()
+        for c in node_step_idx:
+            s = steps[c]
+            if s.type in _CONDITION_TYPES and s.elseSkip > 0:
+                m = c + s.elseSkip
+                if 0 <= m < len(steps) and steps[m].type == StepType.IfElse:
+                    e = steps[m].elseSkip
+                    merge_idx = m + e + 1
+                    then_nodes = [j for j in range(c + 1, m) if j in node_set]
+                    else_nodes = [j for j in range(m + 1, min(merge_idx, len(steps))) if j in node_set]
+                    regions.append((c, then_nodes, else_nodes, merge_idx))
+                    else_steps.update(else_nodes)
+
+        node_of: dict[int, FlowNode] = {}
         y = 0.0
-        prev = None
-        step_to_node: dict[int, int] = {}
-        node_idx = 0
-        for i, step in enumerate(task.steps):
-            if step.type == StepType.Loop:
-                continue
-            step_to_node[i] = node_idx
-            node_idx += 1
+        for i in node_step_idx:
+            x = 260.0 if i in else_steps else 0.0
+            node_of[i] = self.add_node(steps[i], QPointF(x, y))
+            y += 100
 
-        from PySide6.QtCore import QPointF
-        for i, step in enumerate(task.steps):
-            if step.type == StepType.Loop:
+        def wire(a: int, b: int, false=False):
+            if b not in node_of:
+                return
+            src = node_of[a]
+            port = src.false_port if (false and src.false_port is not None) else src.output_port
+            if port is None:      # 终止节点无输出口
+                return
+            self.connect_nodes(port, node_of[b].input_port)
+
+        handled: set = set()
+        for c, then_nodes, else_nodes, merge_idx in regions:
+            handled.add(c)
+            for chain, is_false in ((then_nodes, False), (else_nodes, True)):
+                if chain:
+                    wire(c, chain[0], false=is_false)
+                    for a, b in zip(chain, chain[1:]):
+                        wire(a, b)
+                    if merge_idx in node_of:
+                        wire(chain[-1], merge_idx)
+                    handled.update(chain)
+                elif merge_idx in node_of:
+                    wire(c, merge_idx, false=is_false)
+
+        # 未被分支逻辑接管的相邻节点 → 顺序连线
+        for a, b in zip(node_step_idx, node_step_idx[1:]):
+            if a in handled:
                 continue
-            node = self.add_node(step, QPointF(0, y))
-            if prev is not None:
-                self.connect_nodes(prev.output_port, node.input_port)
-            prev = node
-            y += 100
+            wire(a, b)
 
-        for i, step in enumerate(task.steps):
+        # 回边: 带重复次数的 Loop
+        for i, step in enumerate(steps):
             if step.type == StepType.Loop:
-                real_from = step_to_node.get(i - 1, -1)
-                real_to = step_to_node.get(step.loopTarget, -1)
-                if 0 <= real_from < len(self.nodes) and 0 <= real_to < len(self.nodes):
-                    conn = self.connect_nodes(self.nodes[real_from].output_port, self.nodes[real_to].input_port)
+                from_node = node_of.get(i - 1)
+                to_node = node_of.get(step.loopTarget)
+                if from_node is not None and to_node is not None:
+                    conn = self.connect_nodes(from_node.output_port, to_node.input_port)
                     if conn:
                         conn.set_repeat_count(step.loopCount)
 
-        for i, node in enumerate(self.nodes):
-            if node.step().type == StepType.DoUntil:
-                real_to = step_to_node.get(node.step().loopTarget, -1)
-                if 0 <= real_to < len(self.nodes) and real_to <= i:
-                    self.connect_nodes(node.output_port, self.nodes[real_to].input_port)
+        for i in node_step_idx:
+            if steps[i].type == StepType.DoUntil:
+                to_node = node_of.get(steps[i].loopTarget)
+                if to_node is not None and steps[i].loopTarget <= i:
+                    self.connect_nodes(node_of[i].output_port, to_node.input_port)
 
     def validate_graph(self) -> tuple[bool, list[str]]:
         if not self.nodes:
@@ -324,11 +450,12 @@ class FlowEditor(QGraphicsView):
         queue = deque([start])
         while queue:
             current = queue.popleft()
-            for conn in current.output_port.connections:
-                nxt = conn.to_port.parentItem()
-                if nxt not in reachable:
-                    reachable.add(nxt)
-                    queue.append(nxt)
+            for port in current.output_ports():
+                for conn in port.connections:
+                    nxt = conn.to_port.parentItem()
+                    if nxt not in reachable:
+                        reachable.add(nxt)
+                        queue.append(nxt)
             for conn in current.input_port.connections:
                 prev = conn.from_port.parentItem()
                 if prev not in reachable:

{pyclickerrpa-0.2.0 → pyclickerrpa-0.3.0}/autoclicker/gui/flow_node.py

@@ -33,17 +33,31 @@ _COLORS = {
     StepType.DoUntil: (183, 28, 28),
     StepType.HttpRequest: (3, 155, 229),
     StepType.RunScript: (94, 53, 177),
+    StepType.ActivateWindow: (0, 172, 193),
+    StepType.Stop: (55, 71, 79),
 }
 
+# 终止节点:没有输出口(到此结束)
+_TERMINAL_TYPES = {StepType.Stop}
+
 
 class FlowPort(QGraphicsEllipseItem):
     INPUT = "input"
     OUTPUT = "output"
 
-    def __init__(self, port_type: str, parent):
+    def __init__(self, port_type: str, parent, branch: str | None = None):
         super().__init__(-6, -6, 12, 12, parent)
         self.port_type = port_type
-        self.setBrush(QColor(100, 200, 100) if port_type == self.INPUT else QColor(100, 100, 200))
+        self.branch = branch   # None / "true" / "false" —— 条件节点的真假分支口
+        if port_type == self.INPUT:
+            fill = QColor(100, 200, 100)
+        elif branch == "true":
+            fill = QColor(76, 175, 80)     # 真:绿
+        elif branch == "false":
+            fill = QColor(229, 57, 53)     # 假:红
+        else:
+            fill = QColor(100, 100, 200)
+        self.setBrush(fill)
         self.setPen(QPen(Qt.white, 1))
         self.setFlag(QGraphicsItem.ItemIsSelectable, False)
         self.setCursor(Qt.CrossCursor)
@@ -53,6 +67,13 @@ class FlowPort(QGraphicsEllipseItem):
         return self.mapToScene(self.rect().center())
 
 
+# 会设置 _last_condition 并用 else_skip 分支的条件步骤 —— 这些节点有真/假两个输出口
+_CONDITION_TYPES = {
+    StepType.IfImageFound, StepType.IfTextFound, StepType.IfColorMatch,
+    StepType.IfImageCount, StepType.IfVar,
+}
+
+
 class FlowNode(QGraphicsItem):
     WIDTH = 180
     HEIGHT = 60
@@ -68,14 +89,40 @@ class FlowNode(QGraphicsItem):
 
         self.input_port = FlowPort(FlowPort.INPUT, self)
         self.input_port.setPos(self.WIDTH / 2, -6)
-        self.output_port = FlowPort(FlowPort.OUTPUT, self)
-        self.output_port.setPos(self.WIDTH / 2, self.HEIGHT + 6)
+
+        # 条件节点有真(绿)/假(红)两个输出口;其余节点只有一个。
+        # output_port 始终代表「主/真」分支(条件节点时是真分支),false_port
+        # 只有条件节点才有(否则为 None)。
+        self.false_port = None
+        if self._step.type in _TERMINAL_TYPES:
+            self.output_port = None      # 终止节点无输出口
+        elif self.is_condition():
+            self.output_port = FlowPort(FlowPort.OUTPUT, self, branch="true")
+            self.output_port.setPos(self.WIDTH * 0.28, self.HEIGHT + 6)
+            self.false_port = FlowPort(FlowPort.OUTPUT, self, branch="false")
+            self.false_port.setPos(self.WIDTH * 0.72, self.HEIGHT + 6)
+            self._add_port_label("真", self.WIDTH * 0.28)
+            self._add_port_label("假", self.WIDTH * 0.72)
+        else:
+            self.output_port = FlowPort(FlowPort.OUTPUT, self)
+            self.output_port.setPos(self.WIDTH / 2, self.HEIGHT + 6)
 
         self._label = QGraphicsTextItem(self)
         self._label.setDefaultTextColor(Qt.white)
         self._label.setTextWidth(self.WIDTH - 16)
         self._update_label()
 
+    def is_condition(self) -> bool:
+        return self._step.type in _CONDITION_TYPES
+
+    def output_ports(self) -> list:
+        return [p for p in (self.output_port, self.false_port) if p is not None]
+
+    def _add_port_label(self, text: str, x: float):
+        lbl = QGraphicsTextItem(text, self)
+        lbl.setDefaultTextColor(Qt.white)
+        lbl.setPos(x - 16, self.HEIGHT + 8)
+
     def step(self) -> Step:
         return self._step
 
@@ -102,8 +149,8 @@ class FlowNode(QGraphicsItem):
 
     def itemChange(self, change, value):
         if change == QGraphicsItem.ItemPositionHasChanged:
-            for conn in list(self.input_port.connections):
-                conn.update_path()
-            for conn in list(self.output_port.connections):
-                conn.update_path()
+            ports = [self.input_port, *self.output_ports()]
+            for port in ports:
+                for conn in list(port.connections):
+                    conn.update_path()
         return super().itemChange(change, value)