@guanlin4924/devflow-pi 0.1.96 → 0.1.97

package/plugins/devflow-core/skills/workflow-orchestrator/scripts/wireframe_render.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import argparse
 import base64
+from collections import deque
 import hashlib
 import html
 import json
@@ -41,80 +42,144 @@ def mermaid_label(value: Any) -> str:
             .replace("\r", " ").replace("\n", " "))
 
 
-def render_screen(screen: dict[str, Any], platform: str) -> str:
+def render_screen(screen: dict[str, Any], platform: str, state: str = "default") -> str:
     mobile = platform == "mobile"
-    width, height = (390, 760) if mobile else (960, 600)
+    width, default_height = (390, 760) if mobile else (960, 600)
     pad = 20 if mobile else 48
-    pieces = [f'<svg xmlns="http://www.w3.org/2000/svg" width="{width}" height="{height}" viewBox="0 0 {width} {height}" role="img" aria-label="{text(screen.get("title"))} {platform} 页面线框">', f'<rect width="{width}" height="{height}" fill="#f8fafc"/>']
+    pieces: list[str] = []
     y = 45 if mobile else 58
-    if screen.get("presentation") in {"modal", "drawer"}:
+    presentation = screen.get("presentation")
+    overlay = presentation in {"modal", "drawer"}
+    if overlay:
         if mobile:
-            panel_x, panel_y, panel_w, panel_h = 0, 220, width, height - 220
+            panel_x, panel_y, panel_w, original_panel_h = 0, 220, width, default_height - 220
             pad, y = 24, 265
-        elif screen.get("presentation") == "drawer":
-            panel_x, panel_y, panel_w, panel_h = 540, 0, 420, height
+        elif presentation == "drawer":
+            panel_x, panel_y, panel_w, original_panel_h = 540, 0, 420, default_height
             pad, y = 570, 48
         else:
-            panel_x, panel_y, panel_w, panel_h = 270, 70, 420, 460
+            panel_x, panel_y, panel_w, original_panel_h = 270, 70, 420, 460
             pad, y = 300, 115
-        pieces.append(f'<rect width="{width}" height="{height}" fill="#0f172a33"/>')
-        pieces.append(f'<rect x="{panel_x}" y="{panel_y}" width="{panel_w}" height="{panel_h}" rx="12" fill="white" stroke="#7c3aed" stroke-width="2"/>')
         content_right = panel_x + panel_w - (24 if mobile else 30)
     else:
         content_right = width - pad
     content_width = content_right - pad
-    for element in screen.get("elements", []):
+    elements = screen.get("elements", [])
+    if overlay and not any(element.get("type") == "page_header" for element in elements):
+        pieces.append(svg_text(pad, y, screen.get("title"), 18, weight="700"))
+        y += 40
+
+    data_types = {"table", "card_list"}
+    has_data_region = any(element.get("type") in data_types for element in elements)
+    error_drawn = False
+
+    def error_bar() -> None:
+        nonlocal y, error_drawn
+        pieces.append(f'<rect x="{pad}" y="{y}" width="{content_width}" height="40" fill="#fef2f2" stroke="#fca5a5"/>')
+        pieces.append(svg_text(pad + 16, y + 26, "加载失败，请重试", 14, "#b91c1c"))
+        y += 62
+        error_drawn = True
+
+    if state == "error" and not has_data_region and not elements:
+        error_bar()
+
+    bottom_navigation: dict[str, Any] | None = None
+    for element_index, element in enumerate(elements):
         typ = element.get("type")
+        if state == "error" and has_data_region and typ in data_types and not error_drawn:
+            error_bar()
         if typ == "page_header":
             pieces.append(svg_text(pad, y, element.get("title", screen.get("title")), 21 if mobile else 25, weight="700"))
             y += 48
         elif typ == "filter_bar":
-            box_h = 92 if mobile else 76
-            pieces.append(f'<rect x="{pad}" y="{y}" width="{content_width}" height="{box_h}" rx="8" fill="white" stroke="#cbd5e1"/>')
             fields = element.get("fields", [])
-            for i, field in enumerate(fields[:2]):
-                x = pad + 16 if mobile else pad + 24 + i * 220
-                pieces.append(svg_text(x, y + 28, field.get("label"), 12, "#64748b"))
-                pieces.append(f'<rect x="{x}" y="{y + 38}" width="{150 if mobile else 180}" height="24" fill="#f1f5f9" stroke="#cbd5e1"/>')
+            per_row = 1 if mobile else max(1, (content_width - 24) // 220)
+            rows = (len(fields) + per_row - 1) // per_row
+            box_h = 20 + rows * 56 if fields else 76
+            pieces.append(f'<rect x="{pad}" y="{y}" width="{content_width}" height="{box_h}" rx="8" fill="white" stroke="#cbd5e1"/>')
+            for i, field in enumerate(fields):
+                row, col = divmod(i, per_row)
+                x = pad + 16 if mobile else pad + 24 + col * 220
+                field_y = y + row * 56
+                pieces.append(svg_text(x, field_y + 28, field.get("label"), 12, "#64748b"))
+                pieces.append(f'<rect x="{x}" y="{field_y + 38}" width="{150 if mobile else 180}" height="24" fill="#f1f5f9" stroke="#cbd5e1"/>')
             y += box_h + 22
         elif typ == "table":
             box_h = 290 if mobile else 300
             pieces.append(f'<rect x="{pad}" y="{y}" width="{content_width}" height="{box_h}" rx="8" fill="white" stroke="#cbd5e1"/>')
             columns = element.get("columns", [])
-            if mobile:
+            if state in {"empty", "error"}:
+                if state == "empty":
+                    pieces.append(f'<text x="{pad + content_width // 2}" y="{y + box_h // 2 + 5}" text-anchor="middle" font-size="14" fill="#64748b">暂无数据</text>')
+            elif state == "loading":
+                skeleton_width = content_width - 32
+                for i, ratio in enumerate((0.9, 0.7, 0.8)):
+                    pieces.append(f'<rect x="{pad + 16}" y="{y + 34 + i * 28}" width="{int(skeleton_width * ratio)}" height="14" rx="4" fill="#e2e8f0"/>')
+                pieces.append(svg_text(pad + 16, y + 132, "加载中…", 14, "#64748b"))
+            elif mobile and columns:
                 pieces.append(svg_text(pad + 16, y + 36, "列表", 14, weight="700"))
-                for row, label in enumerate(["示例任务一", "示例任务二"]):
+                first = f'{columns[0].get("label", "")}示例'
+                secondary = " · ".join(
+                    f'{column.get("label", "")}示例'
+                    for column in columns[1:3]
+                    if not _is_action_column(column)
+                )
+                for row in range(2):
                     ry = y + 78 + row * 72
-                    pieces.extend([svg_text(pad + 16, ry, label), svg_text(pad + 16, ry + 24, "运行中 · 2026-09-01", 12, "#64748b"), f'<path d="M{pad + 16} {ry + 38} H{width - pad - 16}" stroke="#e2e8f0"/>'])
-            else:
-                for i, col in enumerate(columns):
-                    pieces.append(svg_text(pad + 24 + i * 160, y + 36, col.get("label"), 13, "#475569"))
+                    pieces.append(svg_text(pad + 16, ry, first))
+                    if secondary:
+                        pieces.append(svg_text(pad + 16, ry + 24, secondary, 12, "#64748b"))
+                    pieces.append(f'<path d="M{pad + 16} {ry + 38} H{content_right - 16}" stroke="#e2e8f0"/>')
+            elif not mobile and columns:
+                available_width = content_width - 32
+                max_cols = max(1, available_width // 110)
+                visible_columns = list(columns)
+                if len(columns) > max_cols:
+                    shown = list(columns[:max_cols - 1])
+                    visible_columns = shown + [{"id": "__overflow__", "label": f"+{len(columns) - len(shown)} 列"}]
+                col_w = available_width // len(visible_columns)
+                limit = col_w // 14
+                for i, column in enumerate(visible_columns):
+                    pieces.append(svg_text(pad + 16 + i * col_w, y + 36, _truncate(column.get("label", ""), limit), 13, "#475569"))
                 for row in range(4):
                     ry = y + 74 + row * 54
                     pieces.append(f'<path d="M{pad + 16} {ry} H{content_right - 16}" stroke="#e2e8f0"/>')
                     if row < 2:
-                        pieces.extend([svg_text(pad + 24, ry + 32, "示例任务"), svg_text(pad + 184, ry + 32, "运行中"), svg_text(pad + 344, ry + 32, "2026-09-01"), svg_text(pad + 504, ry + 32, "查看", 13, "#2563eb")])
+                        for i, column in enumerate(visible_columns):
+                            if column.get("id") == "__overflow__":
+                                value, fill = "", "#0f172a"
+                            elif _is_action_column(column):
+                                value, fill = "查看", "#2563eb"
+                            else:
+                                value, fill = f'{column.get("label", "")}示例', "#0f172a"
+                            pieces.append(svg_text(pad + 16 + i * col_w, ry + 32, _truncate(value, limit), 13, fill))
             y += box_h + 22
         elif typ == "card_list":
-            for item in element.get("items", []):
-                pieces.append(f'<rect x="{pad}" y="{y}" width="{width - 2 * pad}" height="90" rx="8" fill="white" stroke="#cbd5e1"/>')
-                pieces.append(svg_text(pad + 20, y + 34, item.get("title"), 14, weight="700"))
-                meta = item.get("meta", [])
-                pieces.append(svg_text(pad + 20, y + 62, " · ".join(f'{m.get("label")}: {m.get("value")}' for m in meta), 12, "#64748b"))
-                y += 108
+            if state in {"empty", "loading", "error"}:
+                box_h = 160
+                pieces.append(f'<rect x="{pad}" y="{y}" width="{content_width}" height="{box_h}" rx="8" fill="white" stroke="#cbd5e1"/>')
+                if state == "empty":
+                    pieces.append(f'<text x="{pad + content_width // 2}" y="{y + box_h // 2 + 5}" text-anchor="middle" font-size="14" fill="#64748b">暂无数据</text>')
+                elif state == "loading":
+                    skeleton_width = content_width - 32
+                    for i, ratio in enumerate((0.9, 0.7, 0.8)):
+                        pieces.append(f'<rect x="{pad + 16}" y="{y + 22 + i * 28}" width="{int(skeleton_width * ratio)}" height="14" rx="4" fill="#e2e8f0"/>')
+                    pieces.append(svg_text(pad + 16, y + 128, "加载中…", 14, "#64748b"))
+                y += box_h + 18
+            else:
+                for item in element.get("items", []):
+                    pieces.append(f'<rect x="{pad}" y="{y}" width="{content_width}" height="90" rx="8" fill="white" stroke="#cbd5e1"/>')
+                    pieces.append(svg_text(pad + 20, y + 34, item.get("title"), 14, weight="700"))
+                    meta = item.get("meta", [])
+                    pieces.append(svg_text(pad + 20, y + 62, " · ".join(f'{m.get("label")}: {m.get("value")}' for m in meta), 12, "#64748b"))
+                    y += 108
         elif typ == "tabs":
             pieces.append(f'<rect x="{pad}" y="{y}" width="{content_width}" height="48" fill="white" stroke="#cbd5e1"/>')
             for i, tab in enumerate(element.get("tabs", [])):
                 pieces.append(svg_text(pad + 20 + i * 120, y + 30, tab.get("label"), 14, "#2563eb" if i == 0 else "#64748b"))
             y += 70
         elif typ == "bottom_navigation":
-            bar_h = 58
-            bar_y = height - bar_h - 18
-            pieces.append(f'<rect x="{pad}" y="{bar_y}" width="{content_width}" height="{bar_h}" rx="8" fill="white" stroke="#cbd5e1"/>')
-            items = element.get("items", [])
-            slot = max(1, (width - 2 * pad) // max(1, len(items)))
-            for i, item in enumerate(items):
-                pieces.append(f'<text x="{pad + slot * i + slot // 2}" y="{bar_y + 35}" text-anchor="middle" font-size="12" fill="#475569">{text(item.get("label"))}</text>')
+            bottom_navigation = element
         elif typ in {"input", "select"}:
             pieces.append(svg_text(pad, y, element.get("label"), 12, "#64748b"))
             pieces.append(f'<rect x="{pad}" y="{y + 10}" width="{content_width}" height="38" fill="white" stroke="#cbd5e1"/>')
@@ -124,24 +189,152 @@ def render_screen(screen: dict[str, Any], platform: str) -> str:
             pieces.append(f'<rect x="{pad}" y="{y}" width="{bw}" height="40" rx="5" fill="#334155"/>')
             pieces.append(f'<text x="{pad + bw // 2}" y="{y + 26}" text-anchor="middle" font-size="13" fill="white">{text(element.get("label"))}</text>')
             y += 58
-    pieces.append("</svg>")
-    return "".join(pieces)
+        if state == "error" and not has_data_region and element_index == 0 and not error_drawn:
+            error_bar()
+
+    if not has_data_region and state in {"empty", "loading"}:
+        pieces.append(f'<rect x="{pad}" y="{y}" width="{content_width}" height="120" rx="8" fill="white" stroke="#cbd5e1"/>')
+        label = "暂无数据" if state == "empty" else "加载中…"
+        pieces.append(f'<text x="{pad + content_width // 2}" y="{y + 65}" text-anchor="middle" font-size="14" fill="#64748b">{label}</text>')
+        y += 142
+
+    y_end = y
+    if bottom_navigation is not None:
+        y_end += 58 + 18 + 12
+    height = max(default_height, y_end + 40)
+
+    if bottom_navigation is not None:
+        bar_h = 58
+        bar_y = height - bar_h - 18
+        pieces.append(f'<rect x="{pad}" y="{bar_y}" width="{content_width}" height="{bar_h}" rx="8" fill="white" stroke="#cbd5e1"/>')
+        items = bottom_navigation.get("items", [])
+        slot = max(1, content_width // max(1, len(items)))
+        for i, item in enumerate(items):
+            pieces.append(f'<text x="{pad + slot * i + slot // 2}" y="{bar_y + 35}" text-anchor="middle" font-size="12" fill="#475569">{text(item.get("label"))}</text>')
+
+    prefix = [f'<svg xmlns="http://www.w3.org/2000/svg" width="{width}" height="{height}" viewBox="0 0 {width} {height}" role="img" aria-label="{text(screen.get("title"))} {platform} {state} 页面线框">', f'<rect width="{width}" height="{height}" fill="#f8fafc"/>']
+    if overlay:
+        if mobile or presentation == "drawer":
+            panel_h = height - panel_y
+        else:
+            panel_h = max(original_panel_h, y_end - panel_y + 30)
+        prefix.extend([f'<rect width="{width}" height="{height}" fill="#0f172a33"/>', f'<rect x="{panel_x}" y="{panel_y}" width="{panel_w}" height="{panel_h}" rx="12" fill="white" stroke="#7c3aed" stroke-width="2"/>'])
+    return "".join(prefix + pieces + ["</svg>"])
+
+
+def _is_action_column(column: dict[str, Any]) -> bool:
+    return column.get("id") in {"actions", "action", "operation", "operations", "op"} or column.get("label") == "操作"
+
+
+def _truncate(value: Any, limit: int) -> str:
+    value = str(value if value is not None else "")
+    if len(value) <= limit:
+        return value
+    if limit <= 1:
+        return "…" if limit == 1 else ""
+    return value[:limit - 1] + "…"
 
 
 def render_flow(screens: list[dict[str, Any]]) -> str:
-    width = max(760, 220 * len(screens) + 80)
-    parts = [f'<svg xmlns="http://www.w3.org/2000/svg" width="{width}" height="180" viewBox="0 0 {width} 180" role="img" aria-label="页面流转图"><defs><marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto"><path d="M0,0 L8,4 L0,8 Z" fill="#64748b"/></marker></defs><rect width="100%" height="100%" fill="#f8fafc"/>']
-    ids = {s.get("id"): i for i, s in enumerate(screens)}
-    for i, screen in enumerate(screens):
-        x = 40 + i * 220
+    screen_by_id = {screen.get("id"): screen for screen in screens}
+    order = {screen.get("id"): i for i, screen in enumerate(screens)}
+    adjacency: dict[str, list[str]] = {screen["id"]: [] for screen in screens}
+    indegree = {screen["id"]: 0 for screen in screens}
+    first_opener: dict[str, str] = {}
+    for screen in screens:
+        source = screen["id"]
+        for action in screen.get("actions", []):
+            target = action.get("target")
+            if action.get("type") == "open" and target in screen_by_id:
+                adjacency[source].append(target)
+                indegree[target] += 1
+                first_opener.setdefault(target, source)
+
+    roots = [screen["id"] for screen in screens if indegree[screen["id"]] == 0]
+    if not roots and screens:
+        roots = [screens[0]["id"]]
+    layers: dict[str, int] = {}
+    visit_order: dict[str, int] = {}
+    queue: deque[str] = deque()
+
+    def add_root(root: str) -> None:
+        if root not in layers:
+            layers[root] = 0
+            visit_order[root] = len(visit_order)
+            queue.append(root)
+
+    for root in roots:
+        add_root(root)
+    while True:
+        while queue:
+            source = queue.popleft()
+            for target in adjacency[source]:
+                candidate = layers[source] + 1
+                if target not in layers:
+                    layers[target] = candidate
+                    visit_order[target] = len(visit_order)
+                    queue.append(target)
+                elif candidate < layers[target]:
+                    layers[target] = candidate
+                    queue.append(target)
+        unreachable = next((screen["id"] for screen in screens if screen["id"] not in layers), None)
+        if unreachable is None:
+            break
+        add_root(unreachable)
+
+    by_layer: dict[int, list[str]] = {}
+    for screen in screens:
+        sid = screen["id"]
+        by_layer.setdefault(layers[sid], []).append(sid)
+    for layer_ids in by_layer.values():
+        layer_ids.sort(key=lambda sid: (visit_order[sid], order[sid]))
+    positions: dict[str, tuple[int, int]] = {}
+    for layer, layer_ids in by_layer.items():
+        for row, sid in enumerate(layer_ids):
+            positions[sid] = (40 + layer * 240, 40 + row * 90)
+
+    layer_count = max(layers.values(), default=-1) + 1
+    max_rows = max((len(layer_ids) for layer_ids in by_layer.values()), default=1)
+    bottom = 40 + (max_rows - 1) * 90 + 56
+    width = max(760, 40 + layer_count * 240 + 40)
+    height = max(180, 40 + max_rows * 90 + 40)
+    parts = [f'<svg xmlns="http://www.w3.org/2000/svg" width="{width}" height="{height}" viewBox="0 0 {width} {height}" role="img" aria-label="页面流转图"><defs><marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto"><path d="M0,0 L8,4 L0,8 Z" fill="#64748b"/></marker></defs><rect width="100%" height="100%" fill="#f8fafc"/>']
+
+    back_edge_count = 0
+
+    def edge(source: str, target: str, dashed: bool = False) -> str:
+        nonlocal back_edge_count
+        if source == target:
+            return ""
+        sx, sy = positions[source]
+        tx, ty = positions[target]
+        source_y, target_y = sy + 28, ty + 28
+        if layers[target] > layers[source]:
+            path = f'M{sx + 180} {source_y} L{tx} {target_y}'
+        else:
+            offset_index = back_edge_count % 3
+            off = 4 * offset_index
+            bend_y = bottom + 12 + 8 * offset_index
+            back_edge_count += 1
+            path = f'M{sx + 180} {source_y} H{sx + 180 + 20 + off} V{bend_y} H{tx - 20 - off} V{target_y} H{tx}'
+        dash = ' stroke-dasharray="6 4"' if dashed else ""
+        return f'<path d="{path}" fill="none" stroke="#64748b" stroke-width="2"{dash} marker-end="url(#arrow)"/>'
+
+    for screen in screens:
+        source = screen["id"]
+        for action in screen.get("actions", []):
+            target = action.get("target")
+            if action.get("type") == "open" and target in screen_by_id:
+                parts.append(edge(source, target))
+            elif action.get("type") in {"close", "back"} and source in first_opener:
+                parts.append(edge(source, first_opener[source], True))
+
+    for screen in screens:
+        x, y = positions[screen["id"]]
         modal = screen.get("presentation") in {"modal", "drawer"}
-        shape = f'<path d="M{x + 90} 62 L{x + 180} 90 L{x + 90} 118 L{x} 90 Z"' if modal else f'<rect x="{x}" y="62" width="180" height="56" rx="8"'
+        shape = f'<path d="M{x + 90} {y} L{x + 180} {y + 28} L{x + 90} {y + 56} L{x} {y + 28} Z"' if modal else f'<rect x="{x}" y="{y}" width="180" height="56" rx="8"'
         parts.append(shape + ' fill="#fff" stroke="#334155" stroke-width="2"/>')
-        parts.append(f'<text x="{x + 90}" y="96" text-anchor="middle" font-family="Arial,sans-serif" font-size="14" fill="#0f172a">{mermaid_label(screen.get("title"))}</text>')
-        for action in screen.get("actions", []):
-            if action.get("type") == "open" and action.get("target") in ids:
-                tx = 40 + ids[action["target"]] * 220
-                parts.append(f'<path d="M{x + 180} 90 H{tx}" stroke="#64748b" stroke-width="2" marker-end="url(#arrow)"/>')
+        parts.append(f'<text x="{x + 90}" y="{y + 34}" text-anchor="middle" font-family="Arial,sans-serif" font-size="14" fill="#0f172a">{mermaid_label(screen.get("title"))}</text>')
     parts.append("</svg>")
     return "".join(parts)
 
@@ -151,10 +344,18 @@ def render_preview(screens: list[dict[str, Any]], feature: str) -> str:
     for screen in screens:
         sid = screen["id"].replace("-", "_")
         lines.append(f'  {sid}["{mermaid_label(screen["title"])}"]')
+    screen_ids = {screen["id"] for screen in screens}
+    first_opener: dict[str, str] = {}
+    for screen in screens:
+        for action in screen.get("actions", []):
+            if action.get("type") == "open" and action.get("target") in screen_ids:
+                first_opener.setdefault(action["target"], screen["id"])
     for screen in screens:
         for action in screen.get("actions", []):
             if action.get("type") == "open":
                 lines.append(f'  {screen["id"].replace("-", "_")} -->|{mermaid_label(action.get("id", "open"))}| {action["target"].replace("-", "_")}')
+            elif action.get("type") in {"close", "back"} and screen["id"] in first_opener:
+                lines.append(f'  {screen["id"].replace("-", "_")} -.->|{mermaid_label(action.get("id", action["type"]))}| {first_opener[screen["id"]].replace("-", "_")}')
     lines += ["```", "", "## Screens", ""]
     for screen in screens:
         lines += [f'### {screen["title"]} (`{screen["id"]}`)', "", f'- presentation: `{screen.get("presentation", "page")}`', f'- platforms: `{", ".join(screen.get("platforms", ["web", "mobile"]))}`', f'- states: `{", ".join(screen.get("states", []))}`', "", "| 顺序 | 元素 ID | 类型 | 内容 |", "|---:|---|---|---|"]
@@ -187,8 +388,8 @@ def gallery_html(manifest: dict[str, Any], assets: dict[str, str], standalone: b
 <style>body{{margin:0;background:#eef2f7;color:#0f172a;font:14px system-ui,sans-serif}}header{{padding:18px 24px;background:#fff;border-bottom:1px solid #cbd5e1}}main{{display:flex;min-height:calc(100vh - 70px)}}aside{{width:190px;padding:20px;background:#f8fafc;border-right:1px solid #cbd5e1}}button{{display:block;width:100%;margin:0 0 8px;padding:10px;text-align:left;border:1px solid #cbd5e1;border-radius:6px;background:#fff;cursor:pointer}}button.active{{border-color:#7c3aed;background:#f3e8ff}}section{{flex:1;padding:24px}}.toolbar{{display:flex;gap:8px;margin-bottom:18px}}.toolbar button{{width:auto}}.frame{{padding:20px;background:#dbe3ed;border-radius:10px;min-height:620px}}.frame img{{display:block;max-width:100%;max-height:620px;margin:auto;box-shadow:0 8px 24px #94a3b855;background:#fff}}.meta{{color:#64748b;font-size:12px;margin-top:12px}}</style>
 <script type="application/json" id="gallery-manifest">{embedded_manifest}</script>
 <header><strong>低保真原型画廊</strong><div class="meta">prototype: {esc(manifest['prototype_fingerprint'])} · source: {esc(manifest['source_document_fingerprint'])} · renderer: {esc(manifest['renderer_version'])}</div></header>
-<main><aside id="nav"></aside><section><div class="toolbar"><button id="web">Web</button><button id="mobile">Mobile</button><button id="flow">流程图</button></div><div class="frame"><img id="preview" alt="页面线框"></div><div class="meta" id="state">state: default</div></section></main>
-<script>const manifest=JSON.parse(document.querySelector('#gallery-manifest').textContent);const assets={asset_json};let current=manifest.screens[0].screen_id,platform='web';const nav=document.querySelector('#nav'),img=document.querySelector('#preview'),webBtn=document.querySelector('#web'),mobileBtn=document.querySelector('#mobile');function path(id,p){{const s=manifest.screens.find(x=>x.screen_id===id);return s&&s.platforms[p]&&s.platforms[p].states.default}}manifest.screens.forEach(s=>{{const b=document.createElement('button');b.textContent=s.screen_id;b.dataset.id=s.screen_id;b.onclick=()=>{{current=s.screen_id;render()}};nav.append(b)}});function render(){{document.querySelectorAll('aside button').forEach(b=>b.classList.toggle('active',b.dataset.id===current));const s=manifest.screens.find(x=>x.screen_id===current);webBtn.disabled=!s.platforms.web;mobileBtn.disabled=!s.platforms.mobile;const p=path(current,platform);if(p){{img.src=assets[p]||p;img.alt=current+' '+platform+' default'}}else{{img.removeAttribute('src');img.alt=current+' '+platform+' 未定义'}}}}webBtn.onclick=()=>{{platform='web';render()}};mobileBtn.onclick=()=>{{platform='mobile';render()}};document.querySelector('#flow').onclick=()=>{{img.src=assets['flow.svg']||'flow.svg'}};render()</script>'''
+<main><aside id="nav"></aside><section><div class="toolbar"><button id="web">Web</button><button id="mobile">Mobile</button><button id="flow">流程图</button><div class="toolbar" id="state-buttons"></div></div><div class="frame"><img id="preview" alt="页面线框"></div><div class="meta" id="state">state: default</div></section></main>
+<script>const manifest=JSON.parse(document.querySelector('#gallery-manifest').textContent);const assets={asset_json};let current=manifest.screens[0].screen_id,platform='web',state='default';const nav=document.querySelector('#nav'),img=document.querySelector('#preview'),webBtn=document.querySelector('#web'),mobileBtn=document.querySelector('#mobile'),stateButtons=document.querySelector('#state-buttons'),stateLabel=document.querySelector('#state');function screen(){{return manifest.screens.find(x=>x.screen_id===current)}}function states(){{const s=screen();return s&&s.platforms[platform]?s.platforms[platform].states:{{}}}}function ensureState(){{if(!states()[state])state='default'}}manifest.screens.forEach(s=>{{const b=document.createElement('button');b.textContent=s.screen_id;b.dataset.id=s.screen_id;b.onclick=()=>{{current=s.screen_id;if(!s.platforms[platform])platform=Object.keys(s.platforms)[0];ensureState();render()}};nav.append(b)}});function render(){{document.querySelectorAll('aside button').forEach(b=>b.classList.toggle('active',b.dataset.id===current));const s=screen();webBtn.disabled=!s.platforms.web;mobileBtn.disabled=!s.platforms.mobile;ensureState();stateButtons.replaceChildren();Object.keys(states()).forEach(name=>{{const b=document.createElement('button');b.textContent=name;b.classList.toggle('active',name===state);b.onclick=()=>{{state=name;render()}};stateButtons.append(b)}});const p=states()[state];stateLabel.textContent='state: '+state;if(p){{img.src=assets[p]||p;img.alt=current+' '+platform+' '+state}}else{{img.removeAttribute('src');img.alt=current+' '+platform+' 未定义'}}}}webBtn.onclick=()=>{{platform='web';ensureState();render()}};mobileBtn.onclick=()=>{{platform='mobile';ensureState();render()}};document.querySelector('#flow').onclick=()=>{{img.src=assets['flow.svg']||'flow.svg';img.alt='页面流转图'}};render()</script>'''
 
 
 def main() -> int:
@@ -202,15 +403,20 @@ def main() -> int:
     screens = canonical.get("screens", [])
     canonical_bytes = json.dumps(canonical_order(normalize(canonical)), ensure_ascii=False, separators=(",", ":")) + "\n"
     prototype = "sha256:" + hashlib.sha256(canonical_bytes.encode("utf-8")).hexdigest()
-    manifest: dict[str, Any] = {"prototype_fingerprint": prototype, "source_document_fingerprint": args.source_fingerprint, "renderer_version": "1.0.0", "generated_at": datetime.now(timezone.utc).isoformat(), "screens": []}
+    manifest: dict[str, Any] = {"prototype_fingerprint": prototype, "source_document_fingerprint": args.source_fingerprint, "renderer_version": "1.1.0", "generated_at": datetime.now(timezone.utc).isoformat(), "screens": []}
     assets: dict[str, str] = {}
     svg_by_path: dict[str, str] = {"flow.svg": render_flow(screens)}
     for screen in screens:
         entry = {"screen_id": screen["id"], "platforms": {}}
         for platform in screen.get("platforms", ["web", "mobile"]):
-            path = f"screens/{screen['id']}/{platform}/default.svg"
-            svg_by_path[path] = render_screen(screen, platform)
-            entry["platforms"][platform] = {"states": {"default": path}}
+            state_paths = {}
+            declared_states = list(screen.get("states") or [])
+            render_states = declared_states if "default" in declared_states else ["default", *declared_states]
+            for state in render_states:
+                path = f"screens/{screen['id']}/{platform}/{state}.svg"
+                svg_by_path[path] = render_screen(screen, platform, state)
+                state_paths[state] = path
+            entry["platforms"][platform] = {"states": state_paths}
         manifest["screens"].append(entry)
     args.out.mkdir(parents=True, exist_ok=True)
     (args.out / "preview.md").write_text(render_preview(screens, canonical.get("feature", "wireframe")), encoding="utf-8")

package/plugins/devflow-core/skills/workflow-orchestrator/templates/regression-acceptance.yaml

@@ -0,0 +1,126 @@
+schema_version: 1
+id: regression-acceptance
+name: Regression Acceptance Workflow
+description: >
+  从空闲状态为已上线或存量功能建立并执行一套可追溯的回归验收用例。
+
+entry:
+  from_flow: idle
+  initial_step: regression-test-design
+
+governance:
+  hard_gate_mode: core
+  gate_contract_version: 3
+  requirement_graph_gate: enforced
+  enforced_checkpoints:
+    - CP-3
+  step_checkers:
+    regression-test-design:
+      - change-impact-check
+      - test-coverage-check
+      - test-obligation-check
+    regression-dsl:
+      - test-coverage-check
+    run-acceptance-tests:
+      - acceptance-test-results-check
+
+artifact_registry:
+  source: ".devflow/planning/artifacts/index.yaml"
+  path_key: path
+  status_key: status
+  pending_statuses:
+    - planned
+    - pending_rerun
+  terminal_success_statuses:
+    - approved
+    - completed
+    - passed
+
+state_contract:
+  source: ".devflow/planning/STATE.md"
+  parser_hint: "read YAML front matter first, then fall back to Markdown sections"
+  required_fields:
+    - current_flow
+    - current_feature
+    - current_phase
+    - current_step
+    - status
+    - completed_steps
+    - pending_steps
+
+variables:
+  feature:
+    source: state.current_feature
+  phase:
+    source: state.current_phase
+
+checkpoints:
+  CP-3:
+    name: Regression test suite freeze
+    gate_after: regression-test-design
+    producing_step: regression-test-design
+    required_outputs:
+      - ".devflow/planning/requirements/{feature}/tests.json"
+    required_meta_output: ".devflow/planning/requirements/{feature}/tests.meta.json"
+    required_meta_fields:
+      - oracle_source_counts
+      - test_case_count
+      - candidate_test_suite_graph_revision
+      - candidate_test_suite_fingerprint
+    summary_fields:
+      - test_case_count
+      - oracle_source_counts
+      - characterization_test_case_count
+    prompt: "确认每条回归 TC 的判定标准来源、证据和可复现范围；确认后由 Core 冻结测试集。"
+    confirm_options:
+      - approve
+      - needs_fix
+    skip_policy: never
+    resume_behavior: "user confirms, then continue with regression-dsl"
+
+steps:
+  - id: regression-test-design
+    order: 10
+    label: Regression test design
+    skill: workflow-regression-test-design
+    depends_on: []
+    inputs:
+      - ".devflow/planning/code-index/"
+      - ".devflow/planning/PROJECT.md"
+    outputs:
+      - path: ".devflow/planning/requirements/{feature}/tests.json"
+        type: acceptance-test-design
+        required: true
+      - path: ".devflow/planning/features/{feature}/回归验收测试设计.md"
+        type: regression-test-design
+        required: true
+    checkpoint: CP-3
+
+  - id: regression-dsl
+    order: 20
+    label: Generate regression DSL cases
+    skill: workflow-generate-mainflow-cases
+    depends_on:
+      - regression-test-design
+    inputs:
+      - ".devflow/planning/requirements/{feature}/tests.json"
+      - ".devflow/planning/code-index/"
+    outputs:
+      - path: ".devflow/planning/generated-cases/{feature}/"
+        type: generated-acceptance-cases
+        required: true
+
+  - id: run-acceptance-tests
+    order: 30
+    label: Run regression acceptance tests
+    skill: workflow-run-acceptance-tests
+    depends_on:
+      - regression-dsl
+    inputs:
+      - ".devflow/planning/requirements/{feature}/tests.json"
+      - ".devflow/planning/features/{feature}/acceptance-test-bindings.json"
+    outputs:
+      - path: ".devflow/planning/test-runs/{feature}/acceptance-results.json"
+        type: acceptance-test-results
+        required: true
+

package/plugins/devflow-core/skills/workflow-pipeline/SKILL.md

@@ -82,6 +82,8 @@ pipeline 本身不包含执行规则——所有门禁、CP 协议、失败分
 
 每次启动时，通过 workflow-orchestrator 的程序化 inspector 判断当前状态和下一步动作：
 
+如果 Runtime 指令中带有 `<startup-briefing>`，说明预检和合同激活已经完成，直接按简报执行。
+
 ```bash
 devflow_state(action="inspect")
 ```