devmate 2.1.0__tar.gz → 2.3.0__tar.gz

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

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

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

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

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

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

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

@@ -221,6 +221,102 @@ def tk_cleanup(path, dry_run):
         console.print(table)
 
 
+@tk_group.command("rename", help="批量重命名文件")
+@click.argument("path", default=".")
+@click.option("--pattern", "-p", help="正则匹配模式")
+@click.option("--replacement", "-r", default="", help="替换为")
+@click.option("--prefix", help="统一前缀")
+@click.option("--suffix", help="统一后缀（插入扩展名前）")
+@click.option("--apply", is_flag=True, help="实际执行（默认预览）")
+def tk_rename(path, pattern, replacement, prefix, suffix, apply):
+    """批量重命名文件（支持正则替换/前缀/后缀），默认预览"""
+    from rich.table import Table
+
+    from devmate_toolkit import rename as _rename
+
+    result = _rename(path=path, pattern=pattern or "", replacement=replacement,
+                     prefix=prefix or "", suffix=suffix or "", dry_run=not apply)
+    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["results"]:
+        table = Table(show_header=True)
+        table.add_column("原文件名", style="dim")
+        table.add_column("新文件名", style="cyan")
+        table.add_column("状态", style="yellow")
+        for r in data["results"]:
+            table.add_row(r["old"], r["new"], r["status"])
+        console.print(table)
+    console.print("[dim]提示: 预览确认后加 --apply 实际执行[/dim]")
+
+
+@tk_group.command("dup", help="查找重复文件")
+@click.argument("path", default=".")
+@click.option("--min-size", default=1, type=int, help="最小文件大小（字节）")
+def tk_dup(path, min_size):
+    """扫描目录下重复文件（按大小分组后 MD5 校验）"""
+
+    from devmate_toolkit import find_duplicates
+
+    result = find_duplicates(path, min_size=min_size)
+    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")
+
+    for i, dup in enumerate(data["duplicates"], 1):
+        console.print(f"[yellow]组 {i}[/yellow]（{dup['size']}，hash {dup['hash']}）")
+        for f in dup["files"]:
+            console.print(f"  [dim]{f}[/dim]")
+
+
+@tk_group.command("json", help="JSON 格式化/校验/压缩")
+@click.option("--path", type=click.Path(exists=False), help="JSON 文件路径")
+@click.option("--text", "-t", help="JSON 字符串")
+@click.option("--indent", default=2, type=int, help="缩进空格数")
+@click.option("--compress", is_flag=True, help="压缩模式（去除空白）")
+@click.option("--check", is_flag=True, help="仅校验，不输出格式化结果")
+def tk_json(path, text, indent, compress, check):
+    """格式化/校验/压缩 JSON"""
+    from devmate_toolkit import json_format
+
+    result = json_format(path=path or "", text=text or "", indent=indent,
+                         compress=compress)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    if check:
+        console.print(f"[green]✅ {data['message']}[/green]")
+        return
+    console.print(data["output"])
+
+
+@tk_group.command("hash", help="计算文件哈希")
+@click.argument("path")
+@click.option("--algorithm", "-a", default="md5",
+              type=click.Choice(["md5", "sha1", "sha256", "sha512"]))
+def tk_hash(path, algorithm):
+    """计算文件哈希（md5/sha1/sha256/sha512）"""
+    from devmate_toolkit import hash_file
+
+    result = hash_file(path, algorithm=algorithm)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+    data = result.data
+    console.print(f"[bold]文件:[/bold] [cyan]{data['file']}[/cyan]")
+    console.print(f"[bold]{algorithm}:[/bold] [yellow]{data['hash']}[/yellow]")
+    console.print(f"[dim]大小: {data['size']}[/dim]")
+
+
 @cli.group("api", help="HTTP 客户端、Mock Server")
 def api_group():
     """apidev — API 开发工具"""
@@ -332,6 +428,112 @@ def api_history(limit):
     console.print(table)
 
 
+@api_group.command("collection", help="管理请求集合")
+@click.argument("action", type=click.Choice(["add", "list", "run", "remove"]))
+@click.argument("name", required=False)
+@click.option("--method", "-m", default="GET", type=click.Choice(_HTTP_METHODS))
+@click.option("--url", "-u", help="请求 URL")
+@click.option("--body", "-b", help="请求体")
+@click.option("--desc", help="描述")
+def api_collection(action, name, method, url, body, desc):
+    """保存/查看/执行/删除请求集合（支持 {{var}} 环境变量）"""
+    from rich.table import Table
+
+    from devmate_apidev import (
+        collection_add,
+        collection_list,
+        collection_remove,
+        collection_run,
+    )
+
+    if action == "add":
+        if not name or not url:
+            console.print("[red]❌ add 需要 --name 和 --url[/red]")
+            return
+        result = collection_add(name, method, url, body=body or "",
+                                description=desc or "")
+    elif action == "list":
+        result = collection_list()
+        if result.success:
+            items = result.data["collections"]
+            if not items:
+                console.print("[yellow]集合为空[/yellow]")
+                return
+            table = Table(title=f"请求集合（{len(items)} 条）")
+            table.add_column("名称", style="cyan")
+            table.add_column("方法", style="bold")
+            table.add_column("URL", style="green")
+            table.add_column("描述", style="dim")
+            for c in items:
+                table.add_row(c["name"], c["method"], c["url"], c.get("description", ""))
+            console.print(table)
+            return
+    elif action == "run":
+        if not name:
+            console.print("[red]❌ run 需要集合名[/red]")
+            return
+        result = collection_run(name)
+    elif action == "remove":
+        if not name:
+            console.print("[red]❌ remove 需要集合名[/red]")
+            return
+        result = collection_remove(name)
+    else:
+        console.print(f"[red]未知动作: {action}[/red]")
+        return
+
+    if result.success:
+        console.print(f"[green]{result.data.get('message', '✅ 完成')}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
+@api_group.command("env", help="管理请求环境变量")
+@click.argument("action", type=click.Choice(["set", "list", "remove"]))
+@click.argument("key", required=False)
+@click.option("--value", "-v", help="变量值")
+def api_env(action, key, value):
+    """设置/查看/删除环境变量（在请求中通过 {{key}} 引用）"""
+    from rich.table import Table
+
+    from devmate_apidev import env_list, env_remove, env_set
+
+    if action == "set":
+        if not key or value is None:
+            console.print("[red]❌ set 需要 KEY 和 --value[/red]")
+            return
+        result = env_set(key, value)
+    elif action == "list":
+        result = env_list()
+        if result.success:
+            envs = result.data["envs"]
+            masked = result.data["masked"]
+            if not envs:
+                console.print("[yellow]暂无环境变量[/yellow]")
+                return
+            table = Table(title=f"环境变量（{len(envs)} 个）")
+            table.add_column("键", style="cyan")
+            table.add_column("值", style="dim")
+            table.add_column("使用方式", style="green")
+            for k in envs:
+                table.add_row(k, masked.get(k, ""), f"{{{{{k}}}}}")
+            console.print(table)
+            return
+    elif action == "remove":
+        if not key:
+            console.print("[red]❌ remove 需要 KEY[/red]")
+            return
+        result = env_remove(key)
+    else:
+        console.print(f"[red]未知动作: {action}[/red]")
+        return
+
+    if result.success:
+        console.print(f"[green]{result.data.get('message', '✅ 完成')}[/green]")
+    else:
+        console.print(f"[red]❌ {result.error}[/red]")
+
+
 @cli.group("db", help="SQL 编辑器、表浏览器")
 def db_group():
     """dbadmin — 数据库管理"""
@@ -418,6 +620,82 @@ def db_show(table_name, name):
         console.print(pt)
 
 
+@db_group.command("describe", help="查看表结构详情")
+@click.argument("table_name")
+@click.option("--name", default="default", help="连接名称")
+def db_describe(table_name, name):
+    """查看表结构详情：列/索引/外键/行数"""
+    from rich.table import Table
+
+    from devmate_dbadmin import describe
+
+    result = describe(table_name, name=name)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    console.print(f"\n[bold cyan]表: {data['table']}[/bold cyan] "
+                  f"[dim]({data['row_count']} 行)[/dim]\n")
+
+    # 列
+    col_table = Table(title="列")
+    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)
+
+    # 索引
+    if data["indexes"]:
+        idx_table = Table(title="索引")
+        idx_table.add_column("名称", style="cyan")
+        idx_table.add_column("列", style="yellow")
+        idx_table.add_column("唯一", style="green")
+        for idx in data["indexes"]:
+            idx_table.add_row(idx["name"], ", ".join(idx["columns"]),
+                              "✅" if idx["unique"] else "❌")
+        console.print(idx_table)
+
+    # 外键
+    if data["foreign_keys"]:
+        fk_table = Table(title="外键")
+        fk_table.add_column("名称", style="cyan")
+        fk_table.add_column("列", style="yellow")
+        fk_table.add_column("引用表", style="green")
+        fk_table.add_column("引用列", style="dim")
+        for fk in data["foreign_keys"]:
+            fk_table.add_row(fk["name"], ", ".join(fk["columns"]),
+                             fk["ref_table"], ", ".join(fk["ref_columns"]))
+        console.print(fk_table)
+
+
+@db_group.command("export", help="导出表数据")
+@click.argument("table_name")
+@click.argument("format", type=click.Choice(["csv", "json", "sql"]))
+@click.option("--output", "-o", help="输出文件路径（默认当前目录 表名.格式）")
+@click.option("--limit", default=1000, type=int, help="最大行数")
+@click.option("--name", default="default", help="连接名称")
+def db_export(table_name, format, output, limit, name):
+    """导出表数据为 CSV/JSON/SQL"""
+    from devmate_dbadmin import export_table
+
+    result = export_table(table_name, format=format, output=output or "",
+                          limit=limit, name=name)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+    data = result.data
+    console.print(f"[green]{data['message']}[/green]")
+    console.print(f"[dim]列: {', '.join(data['columns'])}[/dim]")
+
+
 @db_group.command("query", help="执行 SQL 查询")
 @click.argument("sql")
 @click.option("--name", default="default", help="连接名称")
@@ -1243,6 +1521,89 @@ def git_stats(path):
         console.print(ct)
 
 
+@git_group.command("status", help="仓库概览")
+@click.option("--path", default=".", help="Git 仓库路径")
+def git_status(path):
+    """仓库概览：分支/未提交/领先落后"""
+    from rich.table import Table
+
+    from devmate_gitflow import overview
+
+    result = overview(path=path)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    console.print(f"\n[bold]📂 仓库: {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("当前分支", f"[bold]{data['branch']}[/bold]")
+    table.add_row("未提交变更", str(data["uncommitted"]))
+    table.add_row("领先远程", data["ahead"] or "-")
+    table.add_row("落后远程", data["behind"] or "-")
+    table.add_row("总提交数", str(data["commits"]))
+    console.print(table)
+
+    if data["status_lines"]:
+        console.print("\n[bold]未提交变更:[/bold]")
+        for line in data["status_lines"][:15]:
+            console.print(f"  [dim]{line}[/dim]")
+
+
+@git_group.command("br", help="分支列表")
+@click.option("--path", default=".", help="Git 仓库路径")
+def git_br(path):
+    """列出本地分支 + 识别已合并分支"""
+    from rich.table import Table
+
+    from devmate_gitflow import branches
+
+    result = branches(path=path)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    console.print(f"\n[bold]🌿 分支列表（{data['total']} 个）[/bold]\n")
+
+    table = Table()
+    table.add_column("分支", style="cyan")
+    table.add_column("状态", style="yellow")
+    for b in data["branches"]:
+        if b["current"]:
+            table.add_row(b["name"], "✅ 当前")
+        elif b["name"] in data["merged"]:
+            table.add_row(b["name"], "[dim]已合并[/dim]")
+        else:
+            table.add_row(b["name"], "[green]未合并[/green]")
+    console.print(table)
+
+    if data["merged"]:
+        console.print(f"\n[dim]提示: 已合并分支可清理 → git branch -d {' '.join(data['merged'][:5])}[/dim]")  # noqa: E501
+
+
+@git_group.command("pr", help="生成 PR 描述")
+@click.option("--base", default="main", help="基础分支")
+@click.option("--head", default="", help="当前分支（默认自动检测）")
+@click.option("--path", default=".", help="Git 仓库路径")
+def git_pr(base, head, path):
+    """基于分支提交自动生成 PR 描述（按类型聚合）"""
+    from devmate_gitflow import pr_description
+
+    result = pr_description(path=path, base=base, head=head)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+
+    data = result.data
+    console.print(f"\n[bold cyan]{data['description']}[/bold cyan]")
+    console.print(f"\n[dim]提交数: {data['commit_count']}，"
+                  f"类型分布: {', '.join(f'{k}:{v}' for k, v in data['types'].items())}[/dim]")
+
+
 @cli.group("re", help="正则测试器、常用正则库")
 def re_group():
     """regexlab — 正则实验室"""
@@ -1312,6 +1673,63 @@ def re_search(pattern, path, flags, max):
         console.print(table)
 
 
+@re_group.command("replace", help="正则替换")
+@click.argument("pattern")
+@click.argument("replacement")
+@click.option("--text", "-t", help="输入文本")
+@click.option("--path", help="输入文件路径（就地替换）")
+@click.option("--flags", "-f", help="正则标志（i=忽略大小写, m=多行）")
+@click.option("--count", "-c", default=0, type=int, help="替换次数（0=全部）")
+def re_replace(pattern, replacement, text, path, flags, count):
+    """正则替换（支持字符串或文件就地替换）"""
+    from devmate_regexlab import replace
+
+    result = replace(pattern, replacement, text=text or "", path=path or "",
+                     flags=flags or "", count=count)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+    data = result.data
+    if path:
+        console.print(f"[green]{data['message']}[/green]")
+    else:
+        console.print(f"[bold]替换结果（{data['matches']} 处）:[/bold]")
+        console.print(data["result"])
+
+
+@re_group.command("extract", help="提取所有匹配")
+@click.argument("pattern")
+@click.option("--text", "-t", help="输入文本")
+@click.option("--path", help="输入文件路径")
+@click.option("--flags", "-f", help="正则标志")
+@click.option("--max", default=100, type=int, help="最大提取数")
+def re_extract(pattern, text, path, flags, max):
+    """提取所有匹配结果（支持分组提取）"""
+    from rich.table import Table
+
+    from devmate_regexlab import extract
+
+    result = extract(pattern, text=text or "", path=path or "",
+                     flags=flags or "", max_matches=max)
+    if not result.success:
+        console.print(f"[red]❌ {result.error}[/red]")
+        return
+    data = result.data
+    console.print(f"\n[bold]提取 {data['pattern']}[/bold] → "
+                  f"[yellow]{data['total']}[/yellow] 个匹配\n")
+
+    if data["matches"]:
+        table = Table(show_header=True)
+        table.add_column("#", style="dim", width=4)
+        table.add_column("匹配", style="cyan")
+        table.add_column("分组", style="yellow")
+        table.add_column("位置", style="dim")
+        for i, m in enumerate(data["matches"], 1):
+            groups = ", ".join(str(g) for g in m["groups"]) if m["groups"] else "-"
+            table.add_row(str(i), m["full"], groups, str(m["position"]))
+        console.print(table)
+
+
 @re_group.command("lib", help="管理正则库")
 @click.argument("action", type=click.Choice(["list", "add", "remove"]))
 @click.argument("name", required=False)
@@ -1620,6 +2038,33 @@ def top_log(path, lines):
     console.print(data["content"])
 
 
+@top_group.command("port", help="查询端口占用")
+@click.argument("port", required=False, type=int)
+def top_port(port):
+    """查询端口占用情况（跨平台）"""
+    from rich.table import Table
+
+    from devmate_monitor import port_usage
+
+    result = port_usage(port)
+    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["listeners"]:
+        table = Table(show_header=True)
+        table.add_column("端口", style="yellow")
+        table.add_column("PID", style="cyan")
+        table.add_column("进程", style="green")
+        table.add_column("地址", style="dim")
+        for l in data["listeners"][:30]:  # noqa: E741
+            table.add_row(str(l["port"]), str(l["pid"]), l["process"], l["host"])
+        console.print(table)
+
+
 @cli.group("report", help="日报/周报自动生成")
 def report_group():
     """reporter — 报告生成"""
@@ -2321,6 +2766,19 @@ def audit_count():
     console.print(f"审计记录总数：[cyan]{_audit.count}[/cyan] 条")
 
 
+@audit_group.command("export", help="导出审计记录 CSV")
+@click.option("--output", "-o", help="输出文件路径（默认 ~/.devmate/audit_export.csv）")
+@click.option("--level", help="过滤级别（SAFE/SENSITIVE/HIGH）")
+@click.option("--module", "-m", help="过滤模块")
+def audit_export(output, level, module):
+    """导出审计记录为 CSV（支持级别/模块过滤）"""
+    from devmate.security.audit import audit as _audit
+
+    count = _audit.export(output=output or "", level=level, module=module)
+    out = output or str(Path.home() / ".devmate" / "audit_export.csv")
+    console.print(f"[green]✅ 已导出 {count} 条审计记录到 {out}[/green]")
+
+
 # ═══════════════════════════════════════════════════
 # 顶层命令：mcp / web / upgrade
 # ═══════════════════════════════════════════════════

{devmate-2.1.0 → devmate-2.3.0}/src/devmate/app/web/__init__.py

@@ -78,15 +78,21 @@ async def dashboard(request: Request, _: str = Depends(require_auth)):
 
 @app.get("/module/{name}", response_class=HTMLResponse)
 async def module_detail(request: Request, name: str, _: str = Depends(require_auth)):
-    """模块详情页"""
+    """模块详情页——含完整命令文档"""
+    from devmate.app.web.cli_docs import CLI_ALIASES, collect_cli_docs
+
     mod = next((m for m in MODULES if m["name"] == name), None)
     if mod is None:
         raise HTTPException(status_code=404, detail=f"模块不存在: {name}")
 
+    # 自动收集该模块的 click 命令文档
+    cli_name = next((k for k, v in CLI_ALIASES.items() if v == name), name)
+    commands = collect_cli_docs(cli_name)
+
     return templates.TemplateResponse(
         "module.html",
         {"request": request, "mod": mod, "modules": MODULES,
-         "active_module": name, "version": __version__},
+         "active_module": name, "commands": commands, "version": __version__},
     )