devmate 1.0.0__py3-none-any.whl

devmate/app/cli.py

@@ -0,0 +1,1663 @@
+"""CLI 主入口——click Group + rich 渲染"""
+
+from pathlib import Path
+
+import click
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+
+from devmate import __app_name__, __description__, __version__
+from devmate.core.logging import logger
+from devmate.core.security import sanitize
+from devmate.module.registry import registry
+
+console = Console()
+
+
+# ═══════════════════════════════════════════════════
+# Welcome 横幅
+# ═══════════════════════════════════════════════════
+
+def print_welcome():
+    """显示欢迎信息"""
+    text = Text()
+    text.append(f"\n  {__app_name__} ", style="bold cyan")
+    text.append(f"v{__version__}", style="yellow")
+    text.append(f"\n  {__description__}", style="dim")
+    console.print(Panel(text, border_style="cyan", padding=(1, 4)))
+
+
+_INIT_FLAG = Path.home() / ".devmate" / ".initialized"
+
+
+def first_run_wizard():
+    """首次运行引导——4 步交互式向导"""
+    if _INIT_FLAG.exists():
+        return
+
+    _INIT_FLAG.parent.mkdir(parents=True, exist_ok=True)
+
+    welcome = Text()
+    welcome.append("\n  ⚡ 欢迎使用 DevMate！", style="bold green")
+    welcome.append("\n\n  来看看你能用它做什么：", style="white")
+    console.print(Panel(welcome, border_style="green", padding=(1, 4)))
+
+    steps = [
+        ("📁 整理文件", "devmate tk organize ~/Downloads --dry-run",
+         "整理 Downloads 目录，按类型分类"),
+        ("🗄 查数据库", "devmate db connect sqlite:///test.db",
+         "连接 SQLite 数据库并执行查询"),
+        ("🌐 调 API", 'devmate api get https://httpbin.org/get',
+         "发送 HTTP 请求查看响应"),
+        ("🤖 AI 对话", "devmate ai add default --provider openai --key <你的 Key>",
+         "配置 AI 模型开始对话"),
+    ]
+
+    for i, (title, cmd, desc) in enumerate(steps, 1):
+        console.print(f"\n[bold cyan]步骤 {i}：{title}[/bold cyan]")
+        console.print(f"  [dim]{desc}[/dim]")
+        console.print(f"  [yellow]$ {cmd}[/yellow]")
+
+    console.print("\n[green]试试上面的命令吧！[/green]")
+    console.print("[dim]提示：运行 devmate --help 查看全部命令 | Ctrl+C 跳过引导[/dim]\n")
+
+    # 标记首次运行完成
+    _INIT_FLAG.write_text("initialized")
+
+
+def print_help():
+    """打印主帮助"""
+    print_welcome()
+    console.print("\n  [bold]用法:[/bold] devmate [模块] [命令] [参数]")
+    console.print("  [bold]      [/bold] devmate --help")
+
+    table = Table(show_header=True, header_style="bold cyan")
+    table.add_column("模块", style="cyan", width=14)
+    table.add_column("入口", style="yellow", width=18)
+    table.add_column("说明", style="white")
+
+    table.add_row("toolkit", "devmate tk", "文件整理、压缩、查重、批量重命名")
+    table.add_row("apidev", "devmate api", "HTTP 客户端、Mock Server")
+    table.add_row("dbadmin", "devmate db", "SQL 编辑器、表浏览器")
+    table.add_row("apihub", "devmate ai", "AI 模型统一接入")
+    table.add_row("agent", "devmate agent", "Agent 执行引擎")
+    table.add_row("sshman", "devmate ssh", "SSH 连接管理器")
+    table.add_row("gitflow", "devmate git", "Git 工作流增强")
+    table.add_row("regexlab", "devmate re", "正则测试器")
+    table.add_row("notekeeper", "devmate note", "笔记知识库")
+    table.add_row("monitor", "devmate top", "系统监控")
+    table.add_row("reporter", "devmate report", "日报/周报生成")
+    table.add_row("scaffold", "devmate scaf", "项目脚手架")
+    table.add_row("publisher", "devmate pub", "文章发布")
+    table.add_row("vault", "devmate vault", "密钥管理器")
+    table.add_row("plugin", "devmate plugin", "插件管理")
+    table.add_row("audit", "devmate audit", "审计日志")
+
+    console.print(table)
+    console.print("\n  [dim]运行 devmate [模块] --help 查看模块详情[/dim]")
+
+
+# ═══════════════════════════════════════════════════
+# 顶层 click Group
+# ═══════════════════════════════════════════════════
+
+@click.group(invoke_without_command=True)
+@click.option("--version", "-V", is_flag=True, help="显示版本号")
+@click.option("--debug", is_flag=True, help="调试模式")
+@click.option("--json", "json_output", is_flag=True, help="JSON 格式输出")
+@click.option("--quiet", "-q", is_flag=True, help="安静模式，最小输出")
+@click.pass_context
+def cli(ctx, version, debug, json_output, quiet):
+    """DevMate — 程序员终端瑞士军刀"""
+    ctx.ensure_object(dict)
+
+    if version:
+        console.print(f"{__app_name__} v{__version__}")
+        return
+
+    if debug:
+        logger.setLevel("DEBUG")
+        logger.debug("调试模式已启用")
+
+    if ctx.invoked_subcommand is None:
+        if not _INIT_FLAG.exists():
+            first_run_wizard()
+        else:
+            print_help()
+
+
+# ═══════════════════════════════════════════════════
+# 模块子命令占位
+# ═══════════════════════════════════════════════════
+
+@cli.group("tk", help="文件整理、压缩、查重、批量重命名")
+def tk_group():
+    """toolkit — 文件瑞士军刀"""
+    pass
+
+
+@tk_group.command("organize", help="按类型/日期整理文件")
+@click.argument("source", default=".")
+@click.option("--dry-run", is_flag=True, help="预览模式，不实际移动文件")
+@click.option("--by", type=click.Choice(["type", "date"]), default="type", help="整理方式")
+def tk_organize(source, dry_run, by):
+    """按文件类型或修改日期将目录中的文件分类到子目录"""
+    from rich.table import Table
+
+    from devmate_toolkit import organize as _organize
+
+    result = _organize(source, dry_run=dry_run, by=by)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    console.print(f"\n[bold cyan]{data['message']}[/bold cyan]\n")
+
+    if result.data["details"]:
+        table = Table(show_header=True)
+        table.add_column("文件", style="cyan")
+        table.add_column("操作", style="yellow")
+        for d in data["details"][:20]:  # 最多显示 20 条
+            table.add_row(d["file"], d["action"])
+        console.print(table)
+        if len(data["details"]) > 20:
+            console.print(f"[dim]... 还有 {len(data['details']) - 20} 个文件[/dim]")
+
+
+@tk_group.command("size", help="目录大小排行")
+@click.argument("path", default=".")
+@click.option("--top", default=10, help="显示前 N 项")
+def tk_size(path, top):
+    """显示指定目录下的文件和子目录大小排行"""
+    from rich.table import Table
+
+    from devmate_toolkit import size as _size
+
+    result = _size(path, top=top)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    console.print(f"\n[bold cyan]📊 {data['path']} 的大小排行[/bold cyan]")
+    console.print(f"   总计：{data['total_size']} | 文件数：{data['file_count']}\n")
+
+    table = Table(show_header=True)
+    table.add_column("#", style="dim")
+    table.add_column("名称", style="cyan")
+    table.add_column("大小", style="yellow", justify="right")
+
+    for i, entry in enumerate(data["entries"], 1):
+        table.add_row(str(i), entry["name"], entry["size_str"])
+    console.print(table)
+
+
+@tk_group.command("cleanup", help="清理缓存文件")
+@click.argument("path", default=".")
+@click.option("--dry-run", is_flag=True, help="预览模式，不实际删除")
+def tk_cleanup(path, dry_run):
+    """清理 __pycache__、.pyc、.DS_Store 等缓存文件"""
+    from rich.table import Table
+
+    from devmate_toolkit import cleanup as _cleanup
+
+    result = _cleanup(path, dry_run=dry_run)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    console.print(f"\n[bold cyan]{data['message']}[/bold cyan]\n")
+
+    if data["details"]:
+        table = Table(show_header=True)
+        table.add_column("路径", style="cyan")
+        table.add_column("大小", style="yellow", justify="right")
+        for d in data["details"][:20]:
+            table.add_row(d["name"], d["size"])
+        console.print(table)
+
+
+@cli.group("api", help="HTTP 客户端、Mock Server")
+def api_group():
+    """apidev — API 开发工具"""
+    pass
+
+
+_HTTP_METHODS = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]
+
+@api_group.command("request", help="发送 HTTP 请求")
+@click.argument("method", type=click.Choice(_HTTP_METHODS))
+@click.argument("url")
+@click.option("--header", "-H", multiple=True, help="请求头")
+@click.option("--param", "-P", multiple=True, help="URL 查询参数")
+@click.option("--body", "-b", help="请求体（JSON）")
+@click.option("--timeout", "-t", default=30, help="超时秒数")
+@click.option("--save", is_flag=True, help="保存到历史记录")
+def api_request(method, url, header, param, body, timeout, save):
+    from rich.syntax import Syntax
+
+    from devmate_apidev import request as _request
+    from devmate_apidev import save_history
+
+    headers = {}
+    for h in header:
+        if ":" in h:
+            k, v = h.split(":", 1)
+            headers[k.strip()] = v.strip()
+
+    params = {}
+    for p in param:
+        if "=" in p:
+            k, v = p.split("=", 1)
+            params[k.strip()] = v.strip()
+
+    result = _request(method, url, headers=headers, params=params, body=body, timeout=timeout)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    sc = data["status_code"]
+    color = "green" if sc < 300 else "yellow" if sc < 400 else "red"
+    console.print(f"\n[bold]{method.upper()} {data['url']}[/bold]")
+    console.print(f"[{color}]{sc} {data['status_text']}[/{color}]  "
+                  f"[dim]{data['elapsed_ms']}ms[/dim]\n")
+
+    console.print("[bold underline]响应头:[/bold underline]")
+    from rich.table import Table
+    ht = Table(show_header=False, box=None)
+    for k, v in list(data["headers"].items())[:15]:
+        ht.add_row(f"  [cyan]{k}[/cyan]", str(v))
+    console.print(ht)
+
+    if data.get("body_json"):
+        import json as _json
+        console.print("\n[bold underline]响应体 (JSON):[/bold underline]")
+        syntax = Syntax(_json.dumps(data["body_json"], indent=2, ensure_ascii=False), "json")
+        console.print(syntax)
+    elif data["body"]:
+        console.print(f"\n[bold underline]响应体:[/bold underline]\n{data['body'][:2000]}")
+
+    if save:
+        save_history({"method": method.upper(), "url": url, "status": sc})
+
+
+@api_group.command("mock", help="启动/停止 Mock Server")
+@click.argument("action", type=click.Choice(["start", "stop"]))
+@click.option("--spec", "-s", default="openapi.json", help="OpenAPI spec")
+@click.option("--port", "-p", default=8765, help="端口")
+def api_mock(action, spec, port):
+    from devmate_apidev import mock_start, mock_stop
+
+    if action == "start":
+        result = mock_start(spec, port=port)
+        if result.success:
+            d = result.data
+            console.print(f"[green]✅ {d['message']}[/green]")
+            console.print(f"   端口: {d['port']}  PID: {d['pid']}")
+            if d.get("endpoints"):
+                console.print("[bold underline]可用端点:[/bold underline]")
+                for ep in d["endpoints"]:
+                    console.print(f"  [cyan]{ep}[/cyan]")
+        else:
+            console.print(f"[red]❌ {result.error}[/red]")
+    else:
+        result = mock_stop()
+        console.print(f"[green]✅ {result.data['message']}[/green]" if result.success
+                      else f"[red]❌ {result.error}[/red]")
+
+
+@api_group.command("history", help="查看请求历史")
+@click.option("--limit", default=20, help="显示条数")
+def api_history(limit):
+    from rich.table import Table
+
+    from devmate_apidev import load_history
+
+    entries = load_history(limit=limit)
+    if not entries:
+        console.print("[yellow]暂无请求历史[/yellow]")
+        return
+
+    table = Table(title=f"请求历史（最近 {len(entries)} 条）")
+    table.add_column("方法", style="bold")
+    table.add_column("URL", style="cyan")
+    table.add_column("状态码", style="yellow")
+    for e in entries:
+        table.add_row(e.get("method", ""), e.get("url", ""), str(e.get("status", "")))
+    console.print(table)
+
+
+@cli.group("db", help="SQL 编辑器、表浏览器")
+def db_group():
+    """dbadmin — 数据库管理"""
+    pass
+
+
+@db_group.command("connect", help="连接数据库")
+@click.argument("dsn")
+@click.option("--name", default="default", help="连接名称")
+def db_connect(dsn, name):
+    """连接数据库，如：devmate db connect sqlite:///test.db"""
+    from devmate_dbadmin import connect as _connect
+    result = _connect(dsn, name=name)
+    if result.success:
+        console.print(f"[green]{result.data['message']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@db_group.command("list-tables", help="列出所有表")
+@click.option("--name", default="default", help="连接名称")
+def db_list_tables(name):
+    """列出数据库中所有表及其行数"""
+    from rich.table import Table
+
+    from devmate_dbadmin import list_tables
+
+    result = list_tables(name=name)
+    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")
+
+    for t in data["tables"]:
+        table.add_row(t["name"], str(t["row_count"]))
+    console.print(table)
+
+
+@db_group.command("show", help="查看表结构")
+@click.argument("table_name")
+@click.option("--name", default="default", help="连接名称")
+def db_show(table_name, name):
+    """查看表的列信息、类型、约束，及前 10 行数据预览"""
+    from rich.table import Table
+
+    from devmate_dbadmin import show_table
+
+    result = show_table(table_name, name=name)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    # 列信息
+    col_table = Table(title=f"表结构: {data['table']}")
+    col_table.add_column("列名", style="cyan")
+    col_table.add_column("类型", style="yellow")
+    col_table.add_column("可空", style="green")
+    col_table.add_column("主键", style="bold")
+    col_table.add_column("默认值", style="dim")
+
+    for col in data["columns"]:
+        col_table.add_row(
+            col["name"],
+            col["type"],
+            "✅" if col["nullable"] else "❌",
+            "🔑" if col["primary_key"] else "",
+            col["default"],
+        )
+    console.print(col_table)
+
+    # 数据预览
+    preview = data.get("preview")
+    if preview and preview["rows"]:
+        pt = Table(title="数据预览（前 10 行）")
+        for c in preview["columns"]:
+            pt.add_column(c)
+        for row in preview["rows"]:
+            pt.add_row(*[str(v) if v is not None else "[dim]NULL[/dim]" for v in row])
+        console.print(pt)
+
+
+@db_group.command("query", help="执行 SQL 查询")
+@click.argument("sql")
+@click.option("--name", default="default", help="连接名称")
+@click.option("--timeout", default=5, help="超时秒数")
+def db_query(sql, name, timeout):
+    """执行 SQL SELECT 查询并显示结果表格"""
+    from rich.table import Table
+
+    from devmate_dbadmin import query as _query
+
+    result = _query(sql, name=name, timeout=timeout)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        if result.suggestion:
+            console.print(f"[yellow]💡 {result.suggestion}[/yellow]")
+        return
+
+    data = result.data
+    if data["type"] == "query":
+        dt = Table(title=f"查询结果（{data['row_count']} 行, {data['elapsed_ms']}ms）")
+        for col in data["columns"]:
+            dt.add_column(str(col))
+        for row in data["rows"]:
+            dt.add_row(*[str(v) if v is not None else "[dim]NULL[/dim]" for v in row])
+        console.print(dt)
+    else:
+        console.print(f"[green]{data.get('message', '执行成功')}[/green]"
+                      f"  [dim]{data['elapsed_ms']}ms[/dim]")
+
+
+@db_group.command("saved", help="管理保存的查询")
+@click.argument("action", type=click.Choice(["list", "save", "run"]))
+@click.argument("name", required=False)
+@click.option("--sql", help="SQL 语句（save 时使用）")
+@click.option("--conn", default="default", help="连接名称（run 时使用）")
+def db_saved(action, name, sql, conn):
+    """保存、列出、运行常用查询"""
+    from rich.table import Table
+
+    from devmate_dbadmin import list_saved_queries, run_saved_query, save_query
+
+    if action == "list":
+        result = list_saved_queries()
+        if not result.success:
+            console.print(f"[red]❌ {result.error}[/red]")
+            return
+        queries = result.data["queries"]
+        if not queries:
+            hint = "暂无保存的查询。用 devmate db saved save <名字> --sql \"...\" 保存"
+            console.print(f"[yellow]{hint}[/yellow]")
+            return
+        qt = Table(title=f"保存的查询（共 {len(queries)} 个）")
+        qt.add_column("名称", style="cyan")
+        qt.add_column("SQL", style="yellow")
+        qt.add_column("创建时间", style="dim")
+        for q in queries:
+            sql_display = q["sql"][:60]
+            if len(q["sql"]) > 60:
+                sql_display += "..."
+            qt.add_row(q["name"], sql_display, q.get("created", ""))
+        console.print(qt)
+    elif action == "save":
+        if not name or not sql:
+            err = "请指定查询名称和 SQL。用法: devmate db saved save <名字> --sql \"SELECT ...\""
+            console.print(f"[red]{err}[/red]")
+            return
+        result = save_query(name, sql)
+        console.print(f"[green]✅ {result.data['message']}[/green]")
+    elif action == "run":
+        if not name:
+            console.print("[red]请指定查询名称。用法: devmate db saved run <名字>[/red]")
+            return
+        result = run_saved_query(name, conn_name=conn)
+        if not result.success:
+            console.print(f"[red]❌ {result.error}[/red]")
+            return
+        data = result.data
+        if data["type"] == "query":
+            dt = Table(title=f"查询结果（{data['row_count']} 行）")
+            for col in data["columns"]:
+                dt.add_column(str(col))
+            for row in data["rows"]:
+                dt.add_row(*[str(v) if v is not None else "[dim]NULL[/dim]" for v in row])
+            console.print(dt)
+
+
+@cli.group("ai", help="AI 模型统一接入、成本追踪")
+def ai_group():
+    """apihub — AI 模型中心"""
+    pass
+
+
+@ai_group.command("add", help="添加 AI 模型配置")
+@click.argument("name")
+@click.option("--provider", "-p", default="openai", help="提供商: openai, deepseek")
+@click.option("--key", "-k", help="API Key（或交互式输入）")
+@click.option("--model", "-m", help="模型名")
+@click.option("--api-base", help="API 地址")
+def ai_add(name, provider, key, model, api_base):
+    """添加一个 AI 模型提供商配置"""
+    from devmate_apihub import add_provider
+
+    if not key:
+        key = click.prompt("请输入 API Key", hide_input=True)
+
+    result = add_provider(name, provider, key, model=model or "", api_base=api_base or "")
+    if result.success:
+        console.print(f"[green]{result.data['message']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@ai_group.command("list", help="列出已配置的模型")
+def ai_list():
+    """列出所有已配置的 AI 模型"""
+    from rich.table import Table
+
+    from devmate_apihub import list_providers
+
+    result = list_providers()
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    providers = result.data["providers"]
+    if not providers:
+        console.print("[yellow]暂无配置。用 devmate ai add <名字> --provider openai 添加[/yellow]")
+        return
+
+    table = Table(title="已配置的 AI 模型")
+    table.add_column("名称", style="cyan")
+    table.add_column("提供商", style="yellow")
+    table.add_column("模型", style="green")
+
+    for p in providers:
+        table.add_row(p["name"], p["provider"], p["model"])
+    console.print(table)
+
+
+@ai_group.command("remove", help="删除模型配置")
+@click.argument("name")
+@click.confirmation_option(prompt="确认删除此配置？")
+def ai_remove(name):
+    """删除指定的 AI 模型配置"""
+    from devmate_apihub import remove_provider
+
+    result = remove_provider(name)
+    if result.success:
+        console.print(f"[green]✅ {result.data['message']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@ai_group.command("chat", help="AI 对话")
+@click.argument("message")
+@click.option("--provider", "-p", default="default", help="模型配置名")
+@click.option("--system", "-s", help="系统提示词")
+def ai_chat(message, provider, system):
+    """与 AI 模型对话（流式输出）"""
+    from devmate_apihub import chat as _chat
+
+    console.print("[dim]🤖 正在思考...[/dim]")
+    result = _chat(message, provider_name=provider, system_prompt=system or "")
+    if result.success:
+        console.print(f"\n[cyan]🤖 {result.data['reply']}[/cyan]\n")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@ai_group.command("history", help="查看对话历史")
+@click.option("--provider", "-p", help="按模型名过滤")
+@click.option("--load", help="加载指定对话")
+def ai_history(provider, load):
+    """查看或加载 AI 对话历史"""
+    from rich.table import Table
+
+    from devmate_apihub import list_chats, load_chat
+
+    if load:
+        result = load_chat(load)
+        if not result.success:
+            console.print(f"[red]❌ {result.error}[/red]")
+            return
+        console.print(f"\n[bold underline]对话: {load}[/bold underline]\n")
+        for msg in result.data["messages"]:
+            prefix = "[cyan]🤖[/cyan]" if msg["role"] == "assistant" else "[green]🧑[/green]"
+            console.print(f"{prefix} {msg['content'][:500]}\n")
+        return
+
+    result = list_chats(provider_name=provider or "")
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    chats = result.data["chats"]
+    if not chats:
+        console.print("[yellow]暂无对话历史[/yellow]")
+        return
+
+    table = Table(title="对话历史")
+    table.add_column("文件名", style="cyan")
+    table.add_column("大小", style="yellow")
+    table.add_column("时间", style="dim")
+    for c in chats:
+        table.add_row(c["name"], str(c["size"]), c["modified"])
+    console.print(table)
+
+
+@cli.group("agent", help="Agent 执行引擎（调用工具完成任务）")
+def agent_group():
+    """agent-harness — Agent 引擎"""
+    pass
+
+
+@agent_group.command("chat", help="与 Agent 对话，完成任务")
+@click.argument("message")
+@click.option("--system", "-s", help="自定义系统提示词")
+def agent_chat(message, system):
+    """向 Agent 发送任务，Agent 会自动调用工具完成"""
+    from rich.table import Table
+
+    from devmate_agent import AgentRuntime
+
+    console.print("[dim]🤖 Agent 思考中...[/dim]\n")
+    runtime = AgentRuntime(system_prompt=system or "")
+    result = runtime.run(message)
+
+    data = result.data
+
+    if data["output"]:
+        console.print(f"[cyan]{data['output']}[/cyan]\n")
+
+    if data.get("steps"):
+        table = Table(title=f"执行步骤（共 {data['step_count']} 步, {data['duration_ms']}ms）")
+        table.add_column("#", style="dim")
+        table.add_column("工具", style="cyan")
+        table.add_column("状态", style="bold")
+        table.add_column("结果", style="white")
+
+        for s in data["steps"]:
+            status = "[green]✅[/green]" if s["status"] == "success" else "[red]❌[/red]"
+            result_text = s.get("result", "")[:40]
+            table.add_row(str(s["step"]), s["tool"], status, result_text)
+        console.print(table)
+
+
+@agent_group.command("tools", help="列出 Agent 可用工具")
+def agent_tools():
+    """列出 Agent 可调用的所有工具"""
+    from rich.table import Table
+
+    from devmate_agent import AgentRuntime
+
+    runtime = AgentRuntime()
+    tools = runtime.list_available_tools()
+
+    table = Table(title=f"可用工具（共 {len(tools)} 个）")
+    table.add_column("工具名", style="cyan")
+    table.add_column("说明", style="white")
+    table.add_column("参数", style="yellow", width=40)
+
+    for t in tools:
+        params = ", ".join(f"{p['name']}({p['type']})" for p in t["parameters"])
+        table.add_row(f"!{t['name']}", t["description"], params)
+    console.print(table)
+    console.print("[dim]在对话中使用 !工具名(参数) 来调用工具[/dim]")
+
+
+@agent_group.command("review", help="代码审查 Agent")
+@click.option("--path", default=".", help="Git 仓库路径")
+def agent_review(path):
+    """审查当前 Git 仓库的代码变更"""
+    from devmate_agent import code_review as _review
+
+    console.print("[dim]🔍 分析代码变更...[/dim]")
+    result = _review(diff_path=path)
+
+    if result.success:
+        console.print(f"\n[cyan]{result.data['output']}[/cyan]")
+    else:
+        console.print(f"[yellow]输出: {result.data.get('output', '')}[/yellow]")
+
+
+@agent_group.command("files", help="文件管家 Agent")
+@click.argument("task")
+@click.option("--path", default=".", help="工作目录")
+def agent_files(task, path):
+    """用自然语言管理文件"""
+    from devmate_agent import file_butler
+
+    console.print("[dim]📁 文件管家工作中...[/dim]")
+    result = file_butler(task, path=path)
+
+    if result.success:
+        console.print(f"\n[cyan]{result.data['output']}[/cyan]")
+    else:
+        console.print(f"[yellow]{result.data.get('output', '')}[/yellow]")
+
+
+@cli.group("ssh", help="SSH 连接管理器、命令执行、端口转发")
+def ssh_group():
+    """sshman — SSH 管理器"""
+    pass
+
+
+@ssh_group.command("add", help="添加 SSH 连接配置")
+@click.argument("name")
+@click.argument("hostname")
+@click.argument("username")
+@click.option("--port", "-p", default=22, help="SSH 端口")
+@click.option("--key", "key_file", help="私钥文件路径")
+@click.option("--password", help="密码（加密存储在 vault）")
+def ssh_add(name, hostname, username, port, key_file, password):
+    """添加 SSH 服务器连接配置"""
+    from devmate_sshman import add as _add
+
+    result = _add(name, hostname, username, port=port,
+                  key_file=key_file or "", password=password or "")
+    if result.success:
+        console.print(f"[green]{result.data['message']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@ssh_group.command("list", help="列出 SSH 连接")
+def ssh_list():
+    """列出所有已配置的 SSH 连接"""
+    from rich.table import Table
+
+    from devmate_sshman import list_connections
+
+    result = list_connections()
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    connections = result.data["connections"]
+    if not connections:
+        hint = "暂无配置。用 devmate ssh add <名字> <主机> <用户> 添加"
+        console.print(f"[yellow]{hint}[/yellow]")
+        return
+
+    table = Table(title="SSH 连接")
+    table.add_column("名称", style="cyan")
+    table.add_column("主机", style="yellow")
+    table.add_column("用户", style="green")
+    table.add_column("端口", style="dim")
+    table.add_column("密钥", style="dim")
+
+    for c in connections:
+        table.add_row(c["name"], c["hostname"], c["username"],
+                      str(c["port"]), c.get("key_file", "") or "-")
+    console.print(table)
+
+
+@ssh_group.command("remove", help="删除 SSH 连接")
+@click.argument("name")
+@click.confirmation_option(prompt="确认删除此连接？")
+def ssh_remove(name):
+    """删除指定的 SSH 连接配置"""
+    from devmate_sshman import remove as _remove
+
+    result = _remove(name)
+    if result.success:
+        console.print(f"[green]✅ {result.data['message']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@ssh_group.command("connect", help="测试 SSH 连接")
+@click.argument("name")
+def ssh_connect(name):
+    """测试能否连接到 SSH 服务器"""
+    from devmate_sshman import connect as _connect
+
+    result = _connect(name)
+    if result.success:
+        console.print(f"[green]{result.data['message']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@ssh_group.command("run", help="在远程服务器执行命令")
+@click.argument("name")
+@click.argument("command")
+def ssh_run(name, command):
+    """在远程服务器上执行一条命令"""
+    from devmate_sshman import run_command as _run
+
+    result = _run(name, command)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    console.print(f"[dim]📡 {data['hostname']}$ {data['command']}[/dim]\n")
+    if data["stdout"]:
+        console.print(data["stdout"])
+    if data["stderr"]:
+        console.print(f"[red]{data['stderr']}[/red]")
+    console.print(f"\n[dim]exit code: {data['exit_code']}[/dim]")
+
+
+@ssh_group.command("batch", help="批量执行命令")
+@click.argument("names", nargs=-1, required=True)
+@click.argument("command")
+def ssh_batch(names, command):
+    """在多个服务器上批量执行同一命令"""
+    from rich.table import Table
+
+    from devmate_sshman import batch as _batch
+
+    console.print(f"[bold]在 {len(names)} 台服务器上执行:[/bold] [yellow]{command}[/yellow]\n")
+
+    result = _batch(list(names), command)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    table = Table(title=f"批量执行结果（{data['success_count']} 成功, {data['fail_count']} 失败）")
+    table.add_column("服务器", style="cyan")
+    table.add_column("结果", style="bold")
+    table.add_column("输出", style="white")
+
+    for r in data["results"]:
+        if r["success"]:
+            out = r.get("stdout", "").strip()
+            table.add_row(r["name"], "✅", out[:60] if out else "(空)")
+        else:
+            table.add_row(r["name"], "❌", r.get("error", "")[:60])
+    console.print(table)
+
+
+@ssh_group.command("tunnel", help="启动 SSH 端口转发")
+@click.argument("name")
+@click.option("--local-port", "-L", default=8080, help="本地端口")
+@click.option("--remote-host", "-R", default="127.0.0.1", help="远程主机")
+@click.option("--remote-port", "-P", default=80, help="远程端口")
+def ssh_tunnel(name, local_port, remote_host, remote_port):
+    """启动 SSH 端口转发到远程服务器"""
+    from devmate_sshman import tunnel as _tunnel
+
+    result = _tunnel(name, local_port, remote_host=remote_host, remote_port=remote_port)
+    if result.success:
+        console.print(f"[green]✅ {result.data['message']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@cli.group("git", help="Git 工作流增强、Commit 规范、统计")
+def git_group():
+    """gitflow — Git 增强"""
+    pass
+
+
+@git_group.command("check", help="校验 Conventional Commit 格式")
+@click.argument("message")
+def git_check(message):
+    """校验 Git commit message 是否符合 Conventional Commit 规范"""
+    from rich.table import Table
+
+    from devmate_gitflow import commit_check
+
+    result = commit_check(message)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    style = "[green]" if data["valid"] else "[red]"
+    console.print(f"\n{style}提交信息结构分析[/]\n")
+    table = Table(show_header=False, box=None)
+    table.add_column("字段", style="cyan", width=12)
+    table.add_column("值", style="yellow")
+    table.add_row("类型", data["type"])
+    table.add_row("范围", data["scope"] or "(无)")
+    table.add_row("描述", data["description"])
+    table.add_row("Breaking", "⚠️ 是" if data["breaking"] else "否")
+    console.print(table)
+
+    if data.get("warnings"):
+        console.print("\n[bold yellow]⚠️ 警告:[/bold yellow]")
+        for w in data["warnings"]:
+            console.print(f"  [yellow]• {w}[/yellow]")
+
+
+@git_group.command("changelog", help="自动生成 CHANGELOG")
+@click.option("--since", "-s", help="起始日期，如 '2026-01-01'")
+@click.option("--path", default=".", help="Git 仓库路径")
+def git_changelog(since, path):
+    """从 git log 自动生成 CHANGELOG"""
+    from devmate_gitflow import changelog
+
+    result = changelog(path=path, since=since or "")
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    console.print(result.data["markdown"])
+
+
+@git_group.command("ignore", help="生成 .gitignore")
+@click.argument("types", nargs=-1, required=True)
+def git_ignore(types):
+    """生成 .gitignore 内容"""
+    from devmate_gitflow import gitignore
+
+    result = gitignore(list(types))
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    console.print(f"[dim]# .gitignore 生成: {', '.join(result.data['types'])}[/dim]")
+    console.print(result.data["content"])
+
+
+@git_group.command("stats", help="Git 仓库统计")
+@click.option("--path", default=".", help="Git 仓库路径")
+def git_stats(path):
+    """统计仓库信息"""
+    from rich.table import Table
+
+    from devmate_gitflow import stats
+
+    result = stats(path=path)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    console.print(f"\n[bold]📊 Git 仓库统计: {data['path']}[/bold]\n")
+
+    table = Table(show_header=False, box=None)
+    table.add_column("指标", style="cyan", width=18)
+    table.add_column("值", style="yellow")
+    table.add_row("总提交数", str(data["total_commits"]))
+    table.add_row("贡献者数", str(data["contributor_count"]))
+    table.add_row("分支数", str(data["branch_count"]))
+    console.print(table)
+
+    if data.get("contributors"):
+        ct = Table(title="贡献者排名")
+        ct.add_column("#", style="dim", width=4)
+        ct.add_column("名字", style="cyan")
+        ct.add_column("提交数", style="yellow", justify="right")
+        for i, c in enumerate(data["contributors"], 1):
+            ct.add_row(str(i), c["name"], str(c["commits"]))
+        console.print(ct)
+
+
+@cli.group("re", help="正则测试器、常用正则库")
+def re_group():
+    """regexlab — 正则实验室"""
+    pass
+
+
+@re_group.command("test", help="测试正则表达式")
+@click.argument("pattern")
+@click.argument("text")
+@click.option("--flags", "-f", help="正则标志: i(忽略大小写) m(多行) s(DOTALL)")
+def re_test(pattern, text, flags):
+    """测试正则表达式匹配结果"""
+    from rich.table import Table
+
+    from devmate_regexlab import match
+
+    result = match(pattern, text, flags=flags or "")
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        if result.suggestion:
+            console.print(f"[yellow]💡 {result.suggestion}[/yellow]")
+        return
+
+    data = result.data
+    console.print(f"\n[bold]正则:[/bold] [yellow]{data['pattern']}[/yellow]")
+    console.print(f"[bold]目标文本:[/bold] [dim]{text[:200]}[/dim]")
+    console.print(f"[bold]匹配结果:[/bold] [cyan]{data['total']}[/cyan] 个匹配\n")
+
+    if data["matches"]:
+        table = Table(show_header=True)
+        table.add_column("#", style="dim")
+        table.add_column("位置", style="cyan")
+        table.add_column("匹配内容", style="yellow")
+        for i, m in enumerate(data["matches"], 1):
+            table.add_row(str(i), f"{m['start']}-{m['end']}", m['matched'][:60])
+        console.print(table)
+
+
+@re_group.command("search", help="在文件中搜索正则")
+@click.argument("pattern")
+@click.argument("path", default=".")
+@click.option("--flags", "-f", help="正则标志")
+@click.option("--max", default=50, help="最大匹配数")
+def re_search(pattern, path, flags, max):
+    """在指定路径的文件中搜索正则模式"""
+    from rich.table import Table
+
+    from devmate_regexlab import search
+
+    result = search(pattern, path, flags=flags or "", max_results=max)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    console.print(f"\n[bold]在 {data['target']} 中搜索[/bold] [yellow]{data['pattern']}[/yellow]")
+    msg = f"检查了 {data['files_checked']} 个文件，找到 [cyan]{data['total']}[/cyan] 处匹配"
+    console.print(f"{msg}\n")
+
+    if data["matches"]:
+        table = Table(show_header=True)
+        table.add_column("文件", style="cyan")
+        table.add_column("行号", style="yellow")
+        table.add_column("内容", style="white")
+        for m in data["matches"]:
+            table.add_row(m["file"], str(m["line"]), m["content"])
+        console.print(table)
+
+
+@re_group.command("lib", help="管理正则库")
+@click.argument("action", type=click.Choice(["list", "add", "remove"]))
+@click.argument("name", required=False)
+@click.option("--pattern", "-p", help="正则表达式（add 时使用）")
+@click.option("--desc", "-d", help="描述")
+@click.option("--example", "-e", help="示例文本")
+def re_lib(action, name, pattern, desc, example):
+    """查看、添加、删除常用正则表达式"""
+    from rich.table import Table
+
+    from devmate_regexlab import lib_add, lib_list, lib_remove
+
+    if action == "list":
+        result = lib_list()
+        if not result.success:
+            console.print(f"[red]❌ {result.error}[/red]")
+            return
+
+        builtin = result.data["builtin"]
+        table = Table(title=f"内置正则（共 {len(builtin)} 个）")
+        table.add_column("名称", style="cyan")
+        table.add_column("正则", style="yellow")
+        table.add_column("示例", style="dim")
+        for item in builtin:
+            table.add_row(item["name"], item["pattern"][:50], item.get("example", ""))
+        console.print(table)
+
+        custom = result.data["custom"]
+        if custom:
+            ct = Table(title=f"自定义正则（共 {len(custom)} 个）")
+            ct.add_column("名称", style="cyan")
+            ct.add_column("正则", style="yellow")
+            for item in custom:
+                ct.add_row(item["name"], item["pattern"][:50])
+            console.print(ct)
+
+    elif action == "add":
+        if not name or not pattern:
+            err = "请指定名称和正则。用法: devmate re lib add <名字> --pattern <正则>"
+            console.print(f"[red]{err}[/red]")
+            return
+        result = lib_add(name, pattern, desc=desc or "", example=example or "")
+        console.print(f"[green]✅ {result.data['message']}[/green]" if result.success
+                      else f"[red]❌ {result.error}[/red]")
+
+    elif action == "remove":
+        if not name:
+            console.print("[red]请指定名称。用法: devmate re lib remove <名字>[/red]")
+            return
+        result = lib_remove(name)
+        console.print(f"[green]✅ {result.data['message']}[/green]" if result.success
+                      else f"[red]❌ {result.error}[/red]")
+
+
+@cli.group("note", help="笔记知识库、全文搜索")
+def note_group():
+    """notekeeper — 笔记知识库"""
+    pass
+
+
+@note_group.command("new", help="创建笔记")
+@click.argument("title")
+@click.option("--content", "-c", help="笔记内容")
+@click.option("--tags", "-t", help="标签（逗号分隔）")
+def note_new(title, content, tags):
+    """创建一条新笔记"""
+    from devmate_notekeeper import new as _new
+    result = _new(title, content=content or "", tags=tags or "")
+    if result.success:
+        console.print(f"[green]{result.data['message']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@note_group.command("list", help="列出笔记")
+@click.option("--limit", default=20, help="显示条数")
+def note_list(limit):
+    """列出最近笔记"""
+    from rich.table import Table
+
+    from devmate_notekeeper import list_notes
+
+    result = list_notes(limit=limit)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    notes = result.data["notes"]
+    if not notes:
+        console.print("[yellow]暂无笔记[/yellow]")
+        return
+
+    table = Table(title=f"笔记列表（共 {result.data['total']} 条）")
+    table.add_column("ID", style="dim", width=4)
+    table.add_column("标题", style="cyan")
+    table.add_column("标签", style="yellow")
+    table.add_column("更新时间", style="dim", width=16)
+    for n in notes:
+        tags_str = ", ".join(n.get("tags", []))
+        table.add_row(str(n["id"]), n["title"][:40], tags_str, n.get("updated_at", ""))
+    console.print(table)
+
+
+@note_group.command("show", help="查看笔记")
+@click.argument("note_id", type=int)
+def note_show(note_id):
+    """查看单条笔记的完整内容"""
+
+    from devmate_notekeeper import show as _show
+
+    result = _show(note_id)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    n = result.data
+    console.print(f"\n[bold cyan]# {n['title']}[/bold cyan]")
+    if n.get("tags"):
+        console.print(f"[dim]标签: {', '.join(n['tags'])}[/dim]")
+    console.print(f"[dim]创建: {n.get('created_at', '')} | 更新: {n.get('updated_at', '')}[/dim]\n")
+    console.print(n.get("content", "(无内容)"))
+
+
+@note_group.command("search", help="全文搜索笔记")
+@click.argument("query")
+@click.option("--limit", default=20, help="显示条数")
+def note_search(query, limit):
+    """全文搜索笔记内容"""
+    from rich.table import Table
+
+    from devmate_notekeeper import search as _search
+
+    result = _search(query, limit=limit)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    notes = result.data["notes"]
+    if not notes:
+        console.print(f"[yellow]未找到匹配 \"{query}\" 的笔记[/yellow]")
+        return
+
+    table = Table(title=f"搜索结果: \"{query}\"（{result.data['total']} 条）")
+    table.add_column("ID", style="dim", width=4)
+    table.add_column("标题", style="cyan")
+    table.add_column("内容预览", style="white", width=60)
+    for n in notes:
+        table.add_row(str(n["id"]), n["title"], n.get("content", ""))
+    console.print(table)
+
+
+@note_group.command("edit", help="编辑笔记")
+@click.argument("note_id", type=int)
+@click.option("--title", help="新标题")
+@click.option("--content", "-c", help="新内容")
+@click.option("--tags", "-t", help="新标签（逗号分隔）")
+def note_edit(note_id, title, content, tags):
+    """编辑笔记内容"""
+    from devmate_notekeeper import edit as _edit
+    result = _edit(note_id, title=title or "", content=content or "", tags=tags or "")
+    console.print(f"[green]✅ {result.data['message']}[/green]" if result.success
+                  else f"[red]❌ {result.error}[/red]")
+
+
+@note_group.command("delete", help="删除笔记")
+@click.argument("note_id", type=int)
+@click.confirmation_option(prompt="确认删除此笔记？")
+def note_delete(note_id):
+    """删除笔记"""
+    from devmate_notekeeper import remove as _remove
+    result = _remove(note_id)
+    console.print(f"[green]{result.data['message']}[/green]" if result.success
+                  else f"[red]❌ {result.error}[/red]")
+
+
+@note_group.command("tag", help="管理标签")
+@click.argument("action", type=click.Choice(["list"]))
+def note_tag(action):
+    """查看所有标签"""
+    from rich.table import Table
+
+    from devmate_notekeeper import tag_list
+
+    result = tag_list()
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    tags = result.data["tags"]
+    if not tags:
+        console.print("[yellow]暂无标签[/yellow]")
+        return
+
+    table = Table(title="标签列表")
+    table.add_column("标签", style="cyan")
+    table.add_column("笔记数", style="yellow", justify="right")
+    for t in tags:
+        table.add_row(t["name"], str(t["count"]))
+    console.print(table)
+
+
+@note_group.command("export", help="导出笔记为 Markdown")
+@click.argument("note_id", type=int)
+@click.option("--output", "-o", help="输出文件路径")
+def note_export(note_id, output):
+    """导出笔记为 Markdown 文件"""
+    from devmate_notekeeper import export_note
+    result = export_note(note_id, output=output or "")
+    if result.success:
+        if "markdown" in result.data:
+            console.print(result.data["markdown"])
+        else:
+            console.print(f"[green]{result.data['message']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@note_group.command("import", help="从 Markdown 导入笔记")
+@click.argument("path")
+def note_import(path):
+    """从 Markdown 文件导入笔记"""
+    from devmate_notekeeper import import_markdown
+    result = import_markdown(path)
+    if result.success:
+        console.print(f"[green]{result.data['message']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@cli.group("top", help="系统资源监控")
+def top_group():
+    """monitor — 系统监控"""
+    pass
+
+
+@top_group.command("dashboard", help="系统资源概览")
+def top_dashboard():
+    """查看 CPU/内存/磁盘/进程概览"""
+    from rich.table import Table
+
+    from devmate_monitor import dashboard
+
+    result = dashboard()
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    sys_info = data.get("system", {})
+    mem = data.get("memory", {})
+
+    console.print(f"\n[bold cyan]📊 系统状态: {sys_info.get('hostname', '')}[/bold cyan]\n")
+
+    table = Table(show_header=False, box=None)
+    table.add_column("指标", style="cyan", width=16)
+    table.add_column("值", style="white")
+    table.add_row("CPU 核数", str(sys_info.get("cpu_count", "?")))
+    mem_str = f"{mem.get('used', '?')} / {mem.get('total', '?')} ({mem.get('percent', 0)}%)"
+    table.add_row("内存", mem_str)
+    table.add_row("进程数", str(data.get("processes", "?")))
+    console.print(table)
+
+
+@top_group.command("process", help="进程列表")
+@click.option("--sort", type=click.Choice(["cpu", "memory"]), default="cpu")
+@click.option("--limit", default=20)
+def top_process(sort, limit):
+    """列出按 CPU/内存排序的进程"""
+    from rich.table import Table
+
+    from devmate_monitor import process_list
+
+    result = process_list(sort_by=sort, limit=limit)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    processes = result.data["processes"]
+    table = Table(title=f"进程列表（按 {sort} 排序）")
+    table.add_column("PID", style="dim", width=6)
+    table.add_column("名称", style="cyan")
+    table.add_column("CPU%", style="yellow", justify="right" if sort == "cpu" else "right")
+    table.add_column("内存%", style="green", justify="right")
+    table.add_column("状态", style="dim")
+
+    for p in processes:
+        table.add_row(str(p["pid"]), p["name"][:30],
+                      f"{p['cpu']:.1f}", f"{p['memory']:.1f}", p["status"])
+    console.print(table)
+
+
+@top_group.command("log", help="查看日志")
+@click.argument("path")
+@click.option("--lines", default=50)
+def top_log(path, lines):
+    """查看文件末尾 N 行日志"""
+    from devmate_monitor import log_tail
+
+    result = log_tail(path, lines=lines)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    console.print(f"[dim]📄 {data['path']} ({data['size']/1024:.1f}KB)[/dim]\n")
+    console.print(data["content"])
+
+
+@cli.group("report", help="日报/周报自动生成")
+def report_group():
+    """reporter — 报告生成"""
+    pass
+
+
+@report_group.command("generate", help="生成报告")
+@click.option("--period", type=click.Choice(["daily", "weekly"]), default="daily")
+@click.option("--template", type=click.Choice(["minimal", "standup", "detailed"]), default="standup")  # noqa: E501
+@click.option("--title", help="报告标题")
+@click.option("--path", default=".", help="Git 仓库路径")
+def report_generate(period, template, title, path):
+    """自动生成日报或周报"""
+    from devmate_reporter import generate
+
+    result = generate(period=period, template=template, path=path, title=title or "")
+    if result.success:
+        console.print(f"[green]✅ 报告已生成: {result.data['path']}[/green]")
+        console.print(f"\n{result.data['markdown']}")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@report_group.command("export", help="导出报告为 HTML")
+@click.argument("path")
+def report_export(path):
+    """将 Markdown 报告导出为 HTML"""
+    from devmate_reporter import export_html
+
+    result = export_html(path)
+    if result.success:
+        console.print(f"[green]✅ HTML 已导出: {result.data['path']}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@cli.group("scaf", help="项目脚手架、代码片段")
+def scaf_group():
+    """scaffold — 项目脚手架"""
+    pass
+
+
+@scaf_group.command("new", help="从模板创建新项目")
+@click.argument("template")
+@click.argument("name")
+@click.option("--output", "-o", help="输出目录")
+def scaf_new(template, name, output):
+    """基于内置模板创建新项目"""
+    from devmate_scaffold import new_project
+
+    result = new_project(template, name, output=output or "")
+    if result.success:
+        data = result.data
+        console.print(f"[green]{data['message']}[/green]")
+        console.print(f"\n[dim]创建了 {len(data['files'])} 个文件:[/dim]")
+        for f in data["files"]:
+            console.print(f"  [cyan]{f}[/cyan]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@scaf_group.command("templates", help="列出可用模板")
+def scaf_templates():
+    """列出所有可用的项目模板"""
+    from rich.table import Table
+
+    from devmate_scaffold import _list_templates
+
+    templates = _list_templates()
+    if not templates:
+        console.print("[yellow]暂无模板[/yellow]")
+        return
+
+    table = Table(title="可用模板")
+    table.add_column("模板名", style="cyan")
+    table.add_column("说明", style="white")
+    for t in templates:
+        table.add_row(t["name"], t.get("description", ""))
+    console.print(table)
+
+
+@scaf_group.command("snippet", help="管理代码片段")
+@click.argument("action", type=click.Choice(["list", "add", "remove"]))
+@click.argument("name", required=False)
+@click.option("--code", help="代码内容（add 时）")
+@click.option("--lang", help="编程语言")
+def scaf_snippet(action, name, code, lang):
+    """管理常用代码片段"""
+    from rich.table import Table
+
+    from devmate_scaffold import snippet_add, snippet_list, snippet_remove
+
+    if action == "list":
+        result = snippet_list()
+        snippets = result.data["snippets"]
+        if not snippets:
+            console.print("[yellow]暂无代码片段[/yellow]")
+            return
+        table = Table(title="代码片段")
+        table.add_column("名称", style="cyan")
+        table.add_column("语言", style="yellow")
+        table.add_column("预览", style="white")
+        for s in snippets:
+            code_preview = s.get("code", "")[:60]
+            table.add_row(s["name"], s.get("lang", ""), code_preview)
+        console.print(table)
+
+    elif action == "add":
+        if not name or not code:
+            console.print("[red]请指定名称和代码内容[/red]")
+            return
+        result = snippet_add(name, code, lang=lang or "")
+        console.print(f"[green]✅ {result.data['message']}[/green]")
+
+    elif action == "remove":
+        if not name:
+            console.print("[red]请指定要删除的片段名称[/red]")
+            return
+        result = snippet_remove(name)
+        console.print(f"[green]✅ {result.data['message']}[/green]" if result.success
+                      else f"[red]❌ {result.error}[/red]")
+
+
+@cli.group("pub", help="文章多平台发布")
+def pub_group():
+    """publisher — 文章发布"""
+    pass
+
+
+@cli.group("vault", help="密钥加密存储")
+def vault_group():
+    """vault — 密钥管理器"""
+    pass
+
+
+@vault_group.command("set", help="存储密钥（交互式输入密码和值）")
+@click.argument("name")
+def vault_set(name):
+    """存储一个加密密钥（交互式输入主密码和密钥值）"""
+    from devmate.security.vault import vault as _vault
+    password = click.prompt("请输入主密码", hide_input=True)
+    value = click.prompt("请输入密钥值", hide_input=True)
+    try:
+        _vault.set(name, value, password)
+        console.print(f"[green]✅ 密钥已存储: {name}[/green]")
+    except Exception as e:
+        console.print(f"[red]❌ 存储失败: {e}[/red]")
+
+
+@vault_group.command("get", help="读取密钥")
+@click.argument("name")
+def vault_get(name):
+    """读取并显示解密后的密钥"""
+    from devmate.security.vault import KeyNotFoundError
+    from devmate.security.vault import vault as _vault
+    password = click.prompt("请输入主密码", hide_input=True)
+    try:
+        value = _vault.get(name, password)
+        console.print(f"[green]✅ {name}: {sanitize(value, name)}[/green]")
+        console.print("  原始值已复制到剪贴板（仅显示脱敏值）")
+    except KeyNotFoundError:
+        console.print(f"[red]❌ 密钥不存在: {name}[/red]")
+    except Exception as e:
+        console.print(f"[red]❌ 读取失败: {e}[/red]")
+
+
+@vault_group.command("list", help="列出所有密钥")
+def vault_list():
+    """列出所有已存储的密钥名称"""
+    from devmate.security.vault import vault as _vault
+    keys = _vault.list()
+    if not keys:
+        console.print("[yellow]vault 中没有密钥[/yellow]")
+        return
+    table = Table(title=f"vault 密钥列表（共 {len(keys)} 个）")
+    table.add_column("密钥名称", style="cyan")
+    for k in keys:
+        table.add_row(k)
+    console.print(table)
+
+
+@vault_group.command("delete", help="删除密钥")
+@click.argument("name")
+@click.confirmation_option(prompt="⚠️ 确认删除此密钥？")
+def vault_delete(name):
+    """删除指定密钥"""
+    from devmate.security.vault import KeyNotFoundError
+    from devmate.security.vault import vault as _vault
+    password = click.prompt("请输入主密码", hide_input=True)
+    try:
+        _vault.delete(name, password)
+        console.print(f"[green]✅ 密钥已删除: {name}[/green]")
+    except KeyNotFoundError:
+        console.print(f"[red]❌ 密钥不存在: {name}[/red]")
+    except Exception as e:
+        console.print(f"[red]❌ 删除失败: {e}[/red]")
+
+
+@vault_group.command("lock", help="锁定 vault（清除内存中的密钥）")
+def vault_lock():
+    """锁定 vault"""
+    from devmate.security.vault import vault as _vault
+    _vault.lock()
+    console.print("[green]✅ vault 已锁定[/green]")
+
+
+@vault_group.command("unlock", help="解锁 vault")
+def vault_unlock():
+    """解锁 vault"""
+    from devmate.security.vault import VaultUnlockedError
+    from devmate.security.vault import vault as _vault
+    try:
+        password = click.prompt("请输入主密码", hide_input=True)
+        _vault.unlock(password)
+        console.print("[green]✅ vault 已解锁[/green]")
+    except VaultUnlockedError:
+        console.print("[yellow]vault 已经解锁[/yellow]")
+    except Exception as e:
+        console.print(f"[red]❌ 解锁失败: {e}[/red]")
+
+
+@cli.group("plugin", help="插件管理")
+def plugin_group():
+    """插件管理"""
+    pass
+
+
+@cli.group("audit", help="审计日志")
+def audit_group():
+    """审计日志"""
+    pass
+
+
+@audit_group.command("log", help="查看最近审计记录")
+@click.option("--level", type=click.Choice(["SAFE", "SENSITIVE", "HIGH"]), help="按级别过滤")
+@click.option("--module", "module_filter", help="按模块过滤")
+@click.option("--limit", default=20, help="显示条数")
+def audit_log(level, module_filter, limit):
+    """查看最近审计记录"""
+    from rich.table import Table
+
+    from devmate.security.audit import audit as _audit
+
+    entries = _audit.query(level=level, module=module_filter, limit=limit)
+    if not entries:
+        console.print("[yellow]暂无审计记录[/yellow]")
+        return
+
+    table = Table(title=f"审计日志（最近 {len(entries)} 条）")
+    table.add_column("时间", style="dim")
+    table.add_column("级别", style="bold")
+    table.add_column("模块", style="cyan")
+    table.add_column("操作", style="yellow")
+    table.add_column("结果")
+
+    for e in entries:
+        level_style = {"SAFE": "green", "SENSITIVE": "yellow", "HIGH": "red"}
+        table.add_row(
+            e.timestamp.split(".")[0] if "T" in e.timestamp else e.timestamp[:19],
+            f"[{level_style.get(e.level, 'white')}]{e.level}[/]",
+            e.module,
+            e.action,
+            "✅" if e.result == "success" else "❌",
+        )
+    console.print(table)
+
+
+@audit_group.command("count", help="审计记录总数")
+def audit_count():
+    """审计记录总数"""
+    from devmate.security.audit import audit as _audit
+    console.print(f"审计记录总数：[cyan]{_audit.count}[/cyan] 条")
+
+
+# ═══════════════════════════════════════════════════
+# 顶层命令：web / upgrade
+# ═══════════════════════════════════════════════════
+
+@cli.command("web", help="启动 Web 面板")
+@click.option("--host", default="127.0.0.1", help="监听地址")
+@click.option("--port", default=8600, help="监听端口")
+@click.option("--auth", type=click.Choice(["local", "oauth"]), default="local", help="认证方式")
+def web_cmd(host, port, auth):
+    """启动 Web 面板——FastAPI + Jinja2 + HTMX"""
+    try:
+        from devmate.app.web import run_web
+        console.print(f"[green]🌐 DevMate Web 面板: http://{host}:{port}[/green]")
+        console.print("[dim]按 Ctrl+C 停止[/dim]")
+        run_web(host=host, port=port)
+    except ImportError:
+        console.print("[red]❌ 请安装 Web 依赖: pip install 'devmate[web]'[/red]")
+
+
+@cli.command("upgrade", help="检查并升级 DevMate")
+def upgrade_cmd():
+    """检查更新"""
+    console.print("[yellow]自动升级尚未实现[/yellow]")
+
+
+# ═══════════════════════════════════════════════════
+# 入口函数
+# ═══════════════════════════════════════════════════
+
+def main():
+    """CLI 主入口"""
+    # 发现已安装模块
+    registry.discover()
+    logger.debug(f"发现 {len(registry.module_names)} 个模块")
+
+    # 启动 CLI
+    cli()
+
+
+if __name__ == "__main__":
+    main()