devmate 2.3.0__tar.gz → 2.4.0__tar.gz

{devmate-2.3.0 → devmate-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devmate
-Version: 2.3.0
+Version: 2.4.0
 Summary: 程序员终端瑞士军刀 + AI 原生平台——替代 5 个独立工具，一个 CLI 搞定
 Author-email: DevMate Team <devmate@example.com>
 License: MIT

{devmate-2.3.0 → devmate-2.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devmate"
-version = "2.3.0"
+version = "2.4.0"
 description = "程序员终端瑞士军刀 + AI 原生平台——替代 5 个独立工具，一个 CLI 搞定"
 readme = "README.md"
 authors = [

{devmate-2.3.0 → devmate-2.4.0}/src/devmate/__init__.py

@@ -1,6 +1,6 @@
 """
 DevMate — 程序员终端瑞士军刀
 """
-__version__ = "2.3.0"
+__version__ = "2.4.0"
 __app_name__ = "DevMate"
 __description__ = "程序员终端瑞士军刀——替代 5 个独立工具，一个 CLI 搞定"

{devmate-2.3.0 → devmate-2.4.0}/src/devmate/app/cli.py

@@ -276,6 +276,53 @@ def tk_dup(path, min_size):
             console.print(f"  [dim]{f}[/dim]")
 
 
+@tk_group.command("dedup", help="清理重复文件（默认预览）")
+@click.argument("path", default=".")
+@click.option("--apply", is_flag=True, help="实际删除（默认只预览）")
+@click.option("--min-size", default=1, type=int, help="最小文件大小（字节）")
+@click.option("--keep", type=click.Choice(["first", "last"]), default="first",
+              help="每组保留哪个：first=最早(默认) last=最新")
+def tk_dedup(path, apply, min_size, keep):
+    """清理重复文件——安全模式
+
+    默认只预览（列出将删除的文件，不实际删除）。
+    确认无误后加 --apply 才真正删除。每组保留最早(first)或最新(last)的副本。
+    """
+    from rich.table import Table
+
+    from devmate_toolkit import clean_duplicates
+
+    result = clean_duplicates(path, dry_run=not apply,
+                              min_size=min_size, keep=keep)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    mode_style = "yellow" if data["mode"] == "dry_run" else "green"
+    console.print(f"\n[{mode_style}]{data['message']}[/{mode_style}]\n")
+
+    if data["to_delete"]:
+        table = Table(title=f"待删除文件（{data['to_delete_count']} 个，共 {data['freed']}）")
+        table.add_column("#", style="dim", width=4)
+        table.add_column("文件路径", style="cyan")
+        for i, f in enumerate(data["to_delete"], 1):
+            table.add_row(str(i), f)
+        console.print(table)
+
+        if data["kept"]:
+            console.print("[bold]保留的副本:[/bold]")
+            for k in data["kept"][:10]:
+                console.print(f"  [green]✓[/green] [dim]{k}[/dim]")
+
+    if data["mode"] == "dry_run":
+        console.print("\n[dim]提示: 确认无误后加 [yellow]--apply[/yellow] 实际删除[/dim]")
+    elif data.get("errors"):
+        console.print(f"\n[red]⚠️ {len(data['errors'])} 个文件删除失败:[/red]")
+        for e in data["errors"][:5]:
+            console.print(f"  [red]{e}[/red]")
+
+
 @tk_group.command("json", help="JSON 格式化/校验/压缩")
 @click.option("--path", type=click.Path(exists=False), help="JSON 文件路径")
 @click.option("--text", "-t", help="JSON 字符串")
@@ -1068,8 +1115,16 @@ def agent_group():
 @agent_group.command("chat", help="与 Agent 对话，完成任务")
 @click.argument("message")
 @click.option("--system", "-s", help="自定义系统提示词")
-def agent_chat(message, system):
-    """向 Agent 发送任务，Agent 自动调用 LLM + 11 个工具完成"""
+@click.option("--dry-run", is_flag=True, help="预览模式：只展示执行计划，不执行")
+@click.option("--confirm", is_flag=True, help="执行前确认（先预览计划，确认后执行）")
+@click.option("--mcp", is_flag=True, help="连接已配置的外部 MCP 工具")
+def agent_chat(message, system, dry_run, confirm, mcp):
+    """向 Agent 发送任务，Agent 自动调用 LLM + 11 个工具完成
+
+    --dry-run  仅生成执行计划不执行（信任机制）
+    --confirm  先展示计划，确认后执行（信任机制）
+    --mcp      动态加载已连接的外部 MCP Server 工具（双向兼容）
+    """
     import uuid
 
     from rich.table import Table
@@ -1081,8 +1136,41 @@ def agent_chat(message, system):
     if debug:
         console.print("[dim]🔍 调试模式 (DEVMATE_AGENT_DEBUG=1)[/dim]")
 
+    runtime = AgentRuntime(system_prompt=system or "", connect_mcp=mcp)
+    if mcp and runtime.external_servers:
+        console.print(f"[dim]🔌 已连接 {len(runtime.external_servers)} 个外部 MCP Server，"
+                      f"Agent 工具总数: {len(runtime.tools.list_names())}[/dim]")
+    elif mcp:
+        console.print("[dim]🔌 未配置外部 MCP Server（devmate mcp connect <url> 添加）[/dim]")
+
+    # 信任机制：先预览计划
+    if dry_run or confirm:
+        console.print("[dim]🤖 生成执行计划中…（预览模式，不执行）[/dim]\n")
+        result = runtime.run(message, dry_run=True)
+        data = result.data
+        save_trace(session_id, message, result)
+
+        if data["output"]:
+            console.print(f"[cyan]{data['output']}[/cyan]\n")
+
+        if data.get("planned_tools"):
+            console.print("[yellow]📋 将执行以下工具操作:[/yellow]")
+            for i, t in enumerate(data["planned_tools"], 1):
+                console.print(f"  {i}. [cyan]{t}[/cyan]")
+
+        if dry_run:
+            console.print("\n[dim]提示: 确认无误后去掉 --dry-run 实际执行[/dim]")
+            console.print(f"\n[dim]Trace ID: {session_id}[/dim]")
+            return
+
+        # confirm 模式：询问确认
+        if not click.confirm("\n是否执行以上操作？", default=True):
+            console.print("[yellow]已取消执行[/yellow]")
+            console.print(f"\n[dim]Trace ID: {session_id}[/dim]")
+            return
+        console.print("\n[dim]🤖 开始执行…[/dim]\n")
+
     console.print("[dim]🤖 Agent v2.0 思考中…（LLM + 工具调用）[/dim]\n")
-    runtime = AgentRuntime(system_prompt=system or "")
     result = runtime.run(message)
     data = result.data
     save_trace(session_id, message, result)
@@ -1108,9 +1196,85 @@ def agent_chat(message, system):
             table.add_row(str(s["step"]), s.get("type", ""), tool_name, status, result_text)
         console.print(table)
 
+    # 变更回滚提示
+    snapshots = runtime.list_snapshots()
+    if snapshots.success and snapshots.data["total"] > 0:
+        console.print(f"\n[dim]💾 本次执行有 {snapshots.data['total']} 处文件变更，"
+                      f"可用 [yellow]devmate agent rollback[/yellow] 回滚[/dim]")
+
     console.print(f"\n[dim]Trace ID: {session_id}[/dim]")
 
 
+@agent_group.command("rollback", help="回滚 Agent 文件变更")
+@click.option("--index", type=int, help="回滚第几次变更（默认最后一次）")
+def agent_rollback(index):
+    """回滚 Agent 执行产生的文件变更（信任机制）"""
+    from devmate_agent import AgentRuntime
+
+    runtime = AgentRuntime()
+    result = runtime.rollback(index)
+    if result.success:
+        console.print(f"[green]{result.data['message']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@agent_group.command("snapshots", help="查看 Agent 变更快照")
+def agent_snapshots():
+    """列出 Agent 执行的变更快照（可回滚）"""
+    from rich.table import Table
+
+    from devmate_agent import AgentRuntime
+
+    runtime = AgentRuntime()
+    result = runtime.list_snapshots()
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+    data = result.data
+    if data["total"] == 0:
+        console.print("[yellow]暂无变更快照[/yellow]")
+        return
+    table = Table(title=f"变更快照（{data['total']} 处，从新到旧）")
+    table.add_column("时间", style="dim")
+    table.add_column("文件", style="cyan")
+    table.add_column("大小", style="yellow")
+    for s in data["snapshots"]:
+        table.add_row(s["time"], s["path"], f"{s['size']}B")
+    console.print(table)
+    console.print("[dim]回滚: devmate agent rollback [--index N][/dim]")
+
+
+@agent_group.command("audit", help="查看 Agent 操作审计")
+@click.option("--limit", default=20, help="显示条数")
+def agent_audit(limit):
+    """查看 Agent 每次工具调用的审计记录（信任机制）"""
+    from rich.table import Table
+
+    from devmate_agent import AgentRuntime
+
+    runtime = AgentRuntime()
+    result = runtime.audit_log(limit=limit)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+    data = result.data
+    if data["total"] == 0:
+        console.print("[yellow]暂无审计记录[/yellow]")
+        return
+    table = Table(title=f"Agent 操作审计（{data['total']} 条）")
+    table.add_column("时间", style="dim")
+    table.add_column("模式", style="cyan")
+    table.add_column("工具", style="yellow")
+    table.add_column("参数", style="white")
+    table.add_column("耗时", style="dim", justify="right")
+    for e in data["entries"]:
+        args = json.dumps(e.get("args", {}), ensure_ascii=False)[:40]  # noqa: F821
+        table.add_row(e["time"], e["action"], e["tool"], args,
+                      f"{e['duration_ms']}ms")
+    console.print(table)
+
+
 @agent_group.command("tools", help="列出 Agent 可用工具")
 def agent_tools():
     """列出 Agent 可调用的所有工具"""
@@ -2065,6 +2229,124 @@ def top_port(port):
         console.print(table)
 
 
+@top_group.command("net", help="网络流量实时监控")
+@click.option("--interval", default=1.0, type=float, help="采样间隔秒数")
+def top_net(interval):
+    """实时网络流量（收/发速率 + 总流量）"""
+    from rich.table import Table
+
+    from devmate_monitor import network_usage
+
+    console.print(f"[dim]采样中（{interval}s）…[/dim]")
+    result = network_usage(interval=interval)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    table = Table(title="🌐 网络流量")
+    table.add_column("方向", style="cyan", width=10)
+    table.add_column("速率", style="yellow")
+    table.add_column("总流量", style="green")
+    table.add_row("📥 接收", data["recv_speed"], data["total_recv"])
+    table.add_row("📤 发送", data["sent_speed"], data["total_sent"])
+    console.print(table)
+
+
+@top_group.command("disk", help="所有磁盘分区用量")
+def top_disk():
+    """列出所有磁盘分区/挂载点用量（按使用率排序）"""
+    from rich.table import Table
+
+    from devmate_monitor import disk_usage_all
+
+    result = disk_usage_all()
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    partitions = result.data["partitions"]
+    if not partitions:
+        console.print("[yellow]未检测到磁盘分区[/yellow]")
+        return
+
+    table = Table(title=f"💾 磁盘分区（{result.data['total']} 个，按使用率排序）")
+    table.add_column("挂载点", style="cyan")
+    table.add_column("设备", style="dim")
+    table.add_column("已用", style="yellow")
+    table.add_column("可用", style="green")
+    table.add_column("总容量", style="white")
+    table.add_column("使用率", style="bold", justify="right")
+    for p in partitions:
+        percent = p["percent"]
+        color = "red" if percent >= 90 else ("yellow" if percent >= 75 else "green")
+        table.add_row(p["mountpoint"], p["device"], p["used"],
+                      p["free"], p["total"], f"[{color}]{percent:.1f}%[/{color}]")
+    console.print(table)
+
+
+@top_group.command("alert", help="资源阈值告警检查")
+@click.option("--cpu", default=80, type=int, help="CPU 阈值 %")
+@click.option("--mem", default=80, type=int, help="内存阈值 %")
+@click.option("--disk", default=90, type=int, help="磁盘阈值 %")
+def top_alert(cpu, mem, disk):
+    """检查 CPU/内存/磁盘是否超过阈值"""
+    from rich.table import Table
+
+    from devmate_monitor import alert_check
+
+    result = alert_check(cpu_limit=cpu, mem_limit=mem, disk_limit=disk)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    status_icon = "[red]🚨 告警[/red]" if data["status"] == "ALERT" else "[green]✅ 正常[/green]"
+    console.print(f"\n{status_icon}（{data['alert_count']} 项告警）\n")
+
+    table = Table(title=f"阈值: CPU>{cpu}% 内存>{mem}% 磁盘>{disk}%")
+    table.add_column("指标", style="cyan")
+    table.add_column("当前值", style="white")
+    table.add_column("阈值", style="dim")
+    table.add_column("状态", style="bold")
+    for name, info in data["summary"].items():
+        icon = "[red]🚨[/red]" if info["alert"] else "[green]✅[/green]"
+        table.add_row(name, f"{info['value']:.1f}{info['unit']}",
+                      f"{info['limit']}{info['unit']}", icon)
+    console.print(table)
+
+    if data["alerts"]:
+        console.print("\n[bold red]告警详情:[/bold red]")
+        for a in data["alerts"]:
+            console.print(f"  [red]⚠️ {a}[/red]")
+
+
+@top_group.command("battery", help="电池状态")
+def top_battery():
+    """电池状态（笔记本；台式机可能不可用）"""
+    from devmate_monitor import battery_status
+
+    result = battery_status()
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    if not data.get("available"):
+        console.print(f"[yellow]🔋 {data.get('message', '电池不可用')}[/yellow]")
+        return
+
+    percent = data["percent"]
+    bar = "█" * (percent // 5) + "░" * (20 - percent // 5)
+    color = "green" if percent > 50 else ("yellow" if percent > 20 else "red")
+    console.print(f"\n🔋 [bold]电池: {percent}%[/bold] [{color}]{bar}[/{color}]")
+    console.print(f"状态: {data['status']}")
+    secs = data.get("remaining_sec")
+    if isinstance(secs, int) and secs >= 0:
+        mins, _ = divmod(secs, 60)
+        console.print(f"剩余时间: ~{mins} 分钟")
+
+
 @cli.group("report", help="日报/周报自动生成")
 def report_group():
     """reporter — 报告生成"""
@@ -2919,6 +3201,58 @@ def wf_rm_step(name, index):
                   else f"[red]❌ {result.error}[/red]")
 
 
+@wf_group.command("template", help="管理工作流模板")
+@click.argument("action", type=click.Choice(["list", "new"]))
+@click.argument("name", required=False)
+@click.argument("template", required=False)
+@click.option("--param", "-p", multiple=True, help="模板参数 key=value")
+def wf_template(action, name, template, param):
+    """列出内置模板 / 从模板创建工作流（闭环编排）"""
+    from rich.table import Table
+
+    from devmate.workflow import create_from_template, list_templates
+
+    if action == "list":
+        result = list_templates()
+        if not result.success:
+            console.print(f"[red]❌ {result.error}[/red]")
+            return
+        data = result.data
+        table = Table(title=f"内置工作流模板（{data['total']} 个）——跨模块闭环")
+        table.add_column("模板", style="cyan")
+        table.add_column("步骤", style="yellow", justify="right")
+        table.add_column("工具链", style="green")
+        table.add_column("描述", style="white")
+        for t in data["templates"]:
+            table.add_row(t["name"], str(t["step_count"]),
+                          " → ".join(t["tools"]), t["description"])
+        console.print(table)
+        console.print("\n[dim]使用: devmate wf template new <工作流名> <模板名> -p 参数=值[/dim]")
+        console.print("[dim]示例: devmate wf template new 每日巡检 daily-check -p topic=数据库 -p output=~/reports[/dim]")  # noqa: E501
+        return
+
+    # action == "new"
+    if not name or not template:
+        console.print("[red]❌ new 需要 <工作流名> <模板名>[/red]")
+        return
+    params = {}
+    for p in param:
+        if "=" in p:
+            k, v = p.split("=", 1)
+            params[k.strip()] = v.strip()
+    result = create_from_template(name, template, params)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+    data = result.data
+    console.print(f"\n[green]{data['message']}[/green]")
+    if data.get("unresolved_params"):
+        console.print(f"[yellow]未提供参数（用默认值）: {', '.join(data['unresolved_params'])}[/yellow]")  # noqa: E501
+    tool_chain = " → ".join(s["tool"] for s in data["steps"])
+    console.print(f"[dim]步骤: {tool_chain}[/dim]")
+    console.print("[dim]执行: devmate wf run <工作流名>[/dim]")
+
+
 @cli.group("knowledge", help="RAG 知识库管理")
 def knowledge_group():
     """RAG 知识库——向量检索笔记"""
@@ -3146,6 +3480,203 @@ def mcp_disconnect_cmd(server_url):
     console.print(f"[green]{result.data['message']}[/green]")
 
 
+@mcp_group.command("list", help="列出已连接的 MCP 服务器")
+def mcp_list_cmd():
+    """查看所有已保存的外部 MCP 服务器连接"""
+    import json as _json
+    from pathlib import Path as _Path
+
+    from rich.table import Table
+
+    config_path = _Path.home() / ".devmate" / "mcp_servers.json"
+    if not config_path.exists():
+        console.print("[yellow]暂无已连接的 MCP 服务器[/yellow]")
+        console.print("[dim]连接: devmate mcp connect <url>[/dim]")
+        return
+
+    try:
+        servers = _json.loads(config_path.read_text())
+    except Exception:
+        servers = []
+    if not servers:
+        console.print("[yellow]暂无已连接的 MCP 服务器[/yellow]")
+        return
+
+    table = Table(title=f"已连接的 MCP 服务器（{len(servers)} 个）")
+    table.add_column("#", style="dim")
+    table.add_column("服务器地址", style="cyan")
+    for i, s in enumerate(servers, 1):
+        table.add_row(str(i), s)
+    console.print(table)
+    console.print("\n[dim]Agent 集成: devmate agent chat \"...\" --mcp 可让 Agent 使用这些外部工具[/dim]")  # noqa: E501
+
+
+@mcp_group.command("agent-tools", help="查看 Agent 可用的 MCP 工具")
+def mcp_agent_tools_cmd():
+    """查看 Agent 动态注册的外部 MCP 工具（双向兼容）"""
+    from rich.table import Table
+
+    from devmate_agent import AgentRuntime
+
+    runtime = AgentRuntime(connect_mcp=True)
+    tools = runtime.list_available_tools()
+    external = [t for t in tools if t["name"].startswith("external_")]
+
+    if not external:
+        console.print("[yellow]当前没有外部 MCP 工具（先 devmate mcp connect <url>）[/yellow]")
+        return
+
+    table = Table(title=f"Agent 已注册的外部 MCP 工具（{len(external)} 个）")
+    table.add_column("工具名", style="cyan")
+    table.add_column("说明", style="white")
+    for t in external:
+        table.add_row(t["name"], t["description"].replace("[外部MCP] ", ""))
+    console.print(table)
+
+
+# ═══════════════════════════════════════════════════
+# 3 分钟 Aha 场景（devmate demo）
+# ═══════════════════════════════════════════════════
+
+_DEMO_SCENARIOS = [
+    {
+        "id": "daily",
+        "title": "📊 每日巡检（3 个工具一次搞定）",
+        "desc": "系统监控 → 检索笔记 → 自动生成日报",
+        "tools": "top dashboard + note search + 报告生成",
+        "workflow": "daily-check",
+        "params": {"topic": "开发", "output": "~/.devmate/demo"},
+    },
+    {
+        "id": "api",
+        "title": "🌐 API 调试（替代 Postman）",
+        "desc": "发送请求 → 保存到集合 → 复用执行",
+        "tools": "api request + api collection + api env",
+        "workflow": "api-health",
+        "params": {"url": "https://httpbin.org/get", "url2": "https://httpbin.org/status/500",
+                   "output": "~/.devmate/demo"},
+    },
+    {
+        "id": "files",
+        "title": "📁 文件整理（替代手动拖拽）",
+        "desc": "扫描目录 → 按类型整理 → 生成清理报告",
+        "tools": "tk size + tk organize + 报告生成",
+        "workflow": "disk-cleanup",
+        "params": {"path": "~/Downloads", "output": "~/.devmate/demo"},
+    },
+]
+
+
+@cli.command("demo", help="3 分钟体验 DevMate（Aha 场景）")
+@click.option("--scenario", type=click.Choice(["daily", "api", "files"]),
+              help="指定场景（默认交互选择）")
+@click.option("--list", "list_only", is_flag=True, help="列出可用场景")
+def demo_cmd(scenario, list_only):
+    """3 分钟完成一个"原来要开 3 个工具"的真实任务闭环
+
+    零配置、无需 LLM：每个场景自动调用 DevMate 模块完成真实操作
+    """
+    import time as _time
+
+    from rich.table import Table as _Table
+
+    if list_only:
+        table = _Table(title="DevMate Aha 场景（3 分钟体验）")
+        table.add_column("ID", style="cyan")
+        table.add_column("场景", style="bold")
+        table.add_column("说明", style="white")
+        table.add_column("工具链", style="green")
+        for s in _DEMO_SCENARIOS:
+            table.add_row(s["id"], s["title"], s["desc"], s["tools"])
+        console.print(table)
+        console.print("\n[dim]体验: devmate demo --scenario daily | api | files[/dim]")
+        return
+
+    # 选择场景
+    selected = None
+    if scenario:
+        selected = next((s for s in _DEMO_SCENARIOS if s["id"] == scenario), None)
+    else:
+        console.print(Panel(
+            "[bold green]⚡ 3 分钟体验 DevMate[/bold green]\n"
+            "[dim]选一个场景，自动完成一个原来要开 3 个工具才能完成的任务[/dim]",
+            border_style="green", padding=(1, 2)))
+        table = _Table(show_header=False, box=None)
+        table.add_column("#", style="dim", width=4)
+        table.add_column("场景", style="bold cyan")
+        table.add_column("说明", style="white")
+        for i, s in enumerate(_DEMO_SCENARIOS, 1):
+            table.add_row(str(i), s["title"], s["desc"])
+        console.print(table)
+        console.print()
+        choice = click.prompt("选择场景编号", type=int, default=1)
+        if choice < 1 or choice > len(_DEMO_SCENARIOS):
+            console.print(f"[red]无效编号: {choice}[/red]")
+            return
+        selected = _DEMO_SCENARIOS[choice - 1]
+
+    wf_name = f"demo-{selected['id']}-{int(_time.time())}"
+
+    console.print(f"\n[bold cyan]{selected['title']}[/bold cyan]")
+    console.print(f"[dim]{selected['desc']}[/dim]")
+    console.print(f"[green]工具链: {selected['tools']}[/green]\n")
+
+    # 步骤 1: 从模板创建
+    console.print("[dim]① 创建场景工作流…[/dim]")
+    from devmate.workflow import create_from_template
+    from devmate.workflow import run as run_workflow
+    result = create_from_template(wf_name, selected["workflow"],
+                                  params=selected["params"])
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    # 步骤 2: 执行闭环
+    console.print(f"[dim]② 执行 {len(result.data['steps'])} 步闭环任务…[/dim]\n")
+    run_result = run_workflow(wf_name)
+
+    # 步骤 3: 展示结果
+    if not run_result.success:
+        console.print(f"[red]❌ 执行失败: {run_result.error}[/red]")
+        return
+    data = run_result.data
+
+    steps_table = _Table(title=f"✅ 任务完成（{data['success_count']} 成功 / {data['fail_count']} 失败，{data['duration_ms']}ms）")  # noqa: E501
+    steps_table.add_column("#", style="dim")
+    steps_table.add_column("步骤", style="cyan")
+    steps_table.add_column("工具", style="yellow")
+    steps_table.add_column("结果", style="white", width=55)
+    icons = {"success": "[green]✅[/green]", "error": "[red]❌[/red]"}
+    for i, s in enumerate(data["steps"], 1):
+        icon = icons.get(s["status"], "[dim]⏭️[/dim]")
+        text = s.get("error", "") or s.get("result", "")[:55]
+        steps_table.add_row(str(i), s["step_id"], s["tool"], f"{icon} {text}")
+    console.print(steps_table)
+
+    # 报告产物路径
+    from pathlib import Path as _Path
+    report_dir = _Path(selected["params"]["output"]).expanduser()
+    if report_dir.exists():
+        reports = sorted(report_dir.glob("*.md"))
+        if reports:
+            console.print("\n[bold green]📄 生成报告:[/bold green]")
+            for rp in reports[-3:]:
+                console.print(f"  [cyan]{rp}[/cyan]")
+                try:
+                    first_lines = rp.read_text()[:120]
+                    console.print(f"    [dim]{first_lines.replace(chr(10), chr(10)+'    ')}[/dim]")
+                except Exception:
+                    pass
+
+    # 清理临时工作流
+    from devmate.workflow import delete as delete_wf
+    delete_wf(wf_name)
+
+    console.print("\n[bold green]🎉 3 分钟体验完成！[/bold green]")
+    console.print(f"[dim]真实工具链: {selected['tools']}[/dim]")
+    console.print("[dim]继续探索: devmate --help | devmate wf template list[/dim]\n")
+
+
 @cli.command("web", help="启动 Web 面板")
 @click.option("--host", default="127.0.0.1", help="监听地址")
 @click.option("--port", default=8600, help="监听端口")