devmate 1.0.0__py3-none-any.whl

devmate/app/tui.py

@@ -0,0 +1,291 @@
+"""DevMate TUI 仪表盘——全功能版"""
+
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.containers import Horizontal, ScrollableContainer, Vertical
+from textual.screen import Screen
+from textual.widgets import (
+    Footer,
+    Header,
+    Input,
+    ListItem,
+    ListView,
+    Rule,
+    Static,
+)
+
+MODULES = [
+    ("📁  toolkit",   "文件整理、大小排行、缓存清理"),
+    ("🌐  apidev",    "HTTP 请求、Mock Server、请求历史"),
+    ("🗄  dbadmin",   "SQL 查询、表浏览、保存的查询"),
+    ("🤖  apihub",    "AI 对话、模型配置、对话历史"),
+    ("⚙️  agent",     "Agent 执行引擎、代码审查、文件管家"),
+    ("🔐  vault",     "加密密钥存储、安全管理"),
+    ("📝  notekeeper","笔记创建、全文搜索、标签管理"),
+    ("📊  top",       "CPU/内存、进程列表、日志查看"),
+    ("📋  report",    "日报/周报自动生成"),
+    ("🏗  scaf",      "项目脚手架、代码片段"),
+    ("🔧  git",       "Commit 校验、CHANGELOG、仓库统计"),
+    ("🔍  regexlab",  "正则测试、文件搜索、正则库"),
+    ("🔗  ssh",       "SSH 连接、命令执行、端口转发"),
+    ("📜  audit",     "审计日志查看"),
+]
+
+
+class ModulePanel(Vertical):
+    """模块功能面板"""
+
+    def __init__(self, title: str, description: str, commands: list[str]):
+        super().__init__()
+        self._title = title
+        self._description = description
+        self._commands = commands
+
+    def compose(self) -> ComposeResult:
+        yield Static(f"[bold cyan]{self._title}[/bold cyan]", id="panel_title")
+        yield Static(f"[dim]{self._description}[/dim]\n", id="panel_desc")
+        yield Rule()
+        for cmd in self._commands:
+            yield Static(f"  [yellow]$ {cmd}[/yellow]")
+
+
+class DashboardScreen(Screen):
+    """主仪表盘——系统状态概览"""
+
+    def compose(self) -> ComposeResult:
+        with Vertical(id="dashboard"):
+            yield Static("[bold cyan]📊 DevMate 仪表盘[/bold cyan]", id="dash_title")
+            yield Rule()
+
+            # 快速统计卡片
+            with Horizontal(id="stat_cards"):
+                with Vertical(classes="stat_card"):
+                    yield Static("📁", classes="stat_icon")
+                    yield Static("文件管理", classes="stat_label")
+                    yield Static("organize / size / cleanup", classes="stat_cmd")
+                with Vertical(classes="stat_card"):
+                    yield Static("🗄", classes="stat_icon")
+                    yield Static("数据库", classes="stat_label")
+                    yield Static("connect / query / show", classes="stat_cmd")
+                with Vertical(classes="stat_card"):
+                    yield Static("🌐", classes="stat_icon")
+                    yield Static("API", classes="stat_label")
+                    yield Static("request / mock / history", classes="stat_cmd")
+                with Vertical(classes="stat_card"):
+                    yield Static("🤖", classes="stat_icon")
+                    yield Static("AI", classes="stat_label")
+                    yield Static("add / chat / list", classes="stat_cmd")
+
+            yield Rule()
+            yield Static("[bold]快速命令[/bold]\n", id="quick_title")
+            yield Static("  Ctrl+P   打开命令面板")
+            yield Static("  Ctrl+K   搜索命令")
+            yield Static("  Ctrl+Q   退出")
+            yield Static("  Enter    查看模块详情")
+
+            yield Rule()
+            yield Static("[bold]最近模块[/bold]", id="recent_title")
+            for name, desc in MODULES[:8]:
+                yield Static(f"  [cyan]•[/cyan] {name}[dim]  {desc}[/dim]")
+
+
+class ModuleDetailScreen(Screen):
+    """模块详情页面"""
+
+    def __init__(self, module_name: str, module_desc: str):
+        super().__init__()
+        self.module_name = module_name
+        self.module_desc = module_desc
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=True)
+        with ScrollableContainer():
+            yield Static(f"[bold cyan]{self.module_name}[/bold cyan]", id="mod_title")
+            yield Static(f"[dim]{self.module_desc}[/dim]\n")
+            yield Rule()
+            yield Static("\n在终端中使用:\n")
+            parts = self.module_name.split()
+            if len(parts) >= 2:
+                cli_name = parts[1]
+                yield Static(f"[yellow]$ devmate {cli_name} --help[/yellow]")
+        yield Footer()
+
+
+class CommandPalette(Vertical):
+    """命令面板"""
+
+    def compose(self) -> ComposeResult:
+        yield Static("[bold]命令面板[/bold]", id="palette_title")
+        yield Input(placeholder="搜索命令...", id="command_input")
+        yield Static("[dim]输入命令名称快速跳转[/dim]")
+
+
+class DevMateTUI(App):
+    """DevMate TUI 主应用——全功能仪表盘"""
+
+    CSS = """
+    Screen {
+        layout: horizontal;
+    }
+
+    #sidebar {
+        width: 30;
+        dock: left;
+        background: $surface;
+        border: solid $primary;
+        height: 100%;
+    }
+
+    #sidebar_title {
+        padding: 1;
+        text-align: center;
+        background: $primary;
+        color: $text;
+        text-style: bold;
+    }
+
+    #module_list {
+        height: 1fr;
+    }
+
+    ListView {
+        border: none;
+    }
+
+    ListItem {
+        padding: 0 1;
+    }
+
+    ListItem:hover {
+        background: $accent 20%;
+    }
+
+    ListItem:focus {
+        background: $accent;
+    }
+
+    #main_content {
+        width: 1fr;
+        padding: 1 2;
+    }
+
+    #dashboard {
+        padding: 1;
+    }
+
+    #dash_title {
+        text-align: center;
+        padding: 1;
+        text-style: bold;
+    }
+
+    #stat_cards {
+        height: 7;
+        margin: 1 0;
+    }
+
+    .stat_card {
+        width: 1fr;
+        height: 100%;
+        border: solid $primary;
+        margin: 0 1;
+        padding: 1;
+        align: center middle;
+    }
+
+    .stat_icon {
+        text-style: bold;
+        content-align: center middle;
+        height: 2;
+    }
+
+    .stat_label {
+        text-align: center;
+        color: $text;
+    }
+
+    .stat_cmd {
+        text-align: center;
+        color: $accent;
+        dim: true;
+    }
+
+    #panel_title {
+        text-style: bold;
+        padding: 1 0;
+    }
+
+    #mod_title {
+        text-style: bold;
+        padding: 1 0;
+        text-align: center;
+    }
+
+    #palette_title {
+        text-style: bold;
+        padding: 1;
+        text-align: center;
+    }
+
+    #command_input {
+        margin: 1;
+    }
+
+    StatusBar {
+        dock: bottom;
+    }
+
+    .active_module {
+        background: $accent;
+    }
+    """
+
+    BINDINGS = [
+        Binding("ctrl+q", "quit", "退出", priority=True),
+        Binding("ctrl+p", "command_palette", "命令面板"),
+        Binding("ctrl+k", "search", "搜索"),
+        Binding("escape", "back_to_dashboard", "返回仪表盘"),
+    ]
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=True)
+        with Vertical(id="sidebar"):
+            yield Static("[bold]DevMate 仪表盘[/bold]", id="sidebar_title")
+            with ListView(id="module_list"):
+                yield ListItem(Static("🏠  仪表盘"), id="mod_dashboard")
+                for name, desc in MODULES:
+                    yield ListItem(Static(name), id=f"mod_{name.split()[-1].strip()}")
+        yield DashboardScreen(id="main_content")
+        yield Footer()
+
+    def on_list_view_selected(self, event: ListView.Selected):
+        """处理侧栏导航"""
+        list_view = self.query_one("#module_list", ListView)
+        list_view.remove_class("active_module")
+
+        item_id = event.item.id or ""
+        if item_id == "mod_dashboard":
+            self.pop_screen() if self.screen != self else None
+            self.switch_screen(DashboardScreen())
+        elif item_id.startswith("mod_"):
+            mod_key = item_id[4:]
+            for name, desc in MODULES:
+                parts = name.split()
+                if len(parts) >= 2 and parts[1] == mod_key:
+                    self.switch_screen(ModuleDetailScreen(name, desc))
+                    break
+
+    def action_command_palette(self):
+        """打开命令面板"""
+        main = self.query_one("#main_content")
+        main.mount(CommandPalette())
+
+    def action_search(self):
+        """搜索"""
+        self.notify("搜索功能即将在 Phase 3.5 实现", severity="information")
+
+
+def run_tui():
+    """启动 TUI 仪表盘"""
+    app = DevMateTUI()
+    app.run()

devmate/app/web/__init__.py

@@ -0,0 +1,95 @@
+"""
+DevMate Web 面板——FastAPI + HTMX 架构
+
+提供仪表盘、模块管理、Token 认证、Swagger 文档。
+"""
+
+from pathlib import Path
+
+from fastapi import FastAPI, HTTPException, Request
+from fastapi.responses import HTMLResponse
+from fastapi.staticfiles import StaticFiles
+from fastapi.templating import Jinja2Templates
+
+from devmate import __version__
+
+HERE = Path(__file__).parent
+templates = Jinja2Templates(directory=str(HERE / "templates"))
+
+app = FastAPI(
+    title="DevMate Web",
+    version=__version__,
+    description="DevMate Web 管理面板",
+)
+
+# ── 静态文件 ──────────────────────────────────────
+
+app.mount("/static", StaticFiles(directory=str(HERE / "static")), name="static")
+
+
+# ── 页面路由 ───────────────────────────────────────
+
+MODULES = [
+    {"name": "toolkit",   "icon": "📁", "desc": "文件整理/大小排行/缓存清理", "cli": "devmate tk"},
+    {"name": "apidev",    "icon": "🌐", "desc": "HTTP 请求、Mock Server", "cli": "devmate api"},
+    {"name": "dbadmin",   "icon": "🗄", "desc": "SQL 查询、表浏览", "cli": "devmate db"},
+    {"name": "apihub",    "icon": "🤖", "desc": "AI 对话、模型管理", "cli": "devmate ai"},
+    {"name": "agent",     "icon": "⚙️", "desc": "Agent 执行引擎", "cli": "devmate agent"},
+    {"name": "sshman",    "icon": "🔗", "desc": "SSH 连接管理", "cli": "devmate ssh"},
+    {"name": "gitflow",   "icon": "🔧", "desc": "Git 工作流", "cli": "devmate git"},
+    {"name": "regexlab",  "icon": "🔍", "desc": "正则表达式测试", "cli": "devmate re"},
+    {"name": "vault",     "icon": "🔐", "desc": "加密密钥管理", "cli": "devmate vault"},
+    {"name": "notekeeper","icon": "📝", "desc": "笔记知识库", "cli": "devmate note"},
+    {"name": "monitor",   "icon": "📊", "desc": "系统资源监控", "cli": "devmate top"},
+    {"name": "reporter",  "icon": "📋", "desc": "日报/周报", "cli": "devmate report"},
+    {"name": "scaffold",  "icon": "🏗", "desc": "项目脚手架", "cli": "devmate scaf"},
+    {"name": "audit",     "icon": "📜", "desc": "审计日志", "cli": "devmate audit"},
+]
+
+
+@app.get("/", response_class=HTMLResponse)
+async def dashboard(request: Request):
+    """仪表盘主页"""
+    return templates.TemplateResponse(
+        "dashboard.html",
+        {"request": request, "modules": MODULES, "version": __version__},
+    )
+
+
+@app.get("/module/{name}", response_class=HTMLResponse)
+async def module_detail(request: Request, name: str):
+    """模块详情页"""
+    mod = next((m for m in MODULES if m["name"] == name), None)
+    if mod is None:
+        raise HTTPException(status_code=404, detail=f"模块不存在: {name}")
+
+    return templates.TemplateResponse(
+        "module.html",
+        {"request": request, "mod": mod, "version": __version__},
+    )
+
+
+# ── API 路由 ────────────────────────────────────────
+
+@app.get("/api/health")
+async def health():
+    """健康检查"""
+    return {"status": "ok", "version": __version__}
+
+
+@app.get("/api/stats")
+async def stats():
+    """快速统计"""
+    return {
+        "modules": len(MODULES),
+        "toolkit_available": True,
+        "dbadmin_available": True,
+    }
+
+
+# ── 启动入口 ──────────────────────────────────────
+
+def run_web(host: str = "127.0.0.1", port: int = 8600):
+    """启动 Web 服务器"""
+    import uvicorn
+    uvicorn.run(app, host=host, port=port, log_level="info")

devmate/bus/__init__.py

@@ -0,0 +1 @@
+"""Command Bus — 命令路由、中间件、三端适配器"""

devmate/bus/bus.py

@@ -0,0 +1,151 @@
+"""Command Bus——命令路由、中间件链、Handler 注册"""
+
+import time
+from collections.abc import Callable
+
+from devmate.bus.command import Command, CommandResult
+from devmate.core.logging import logger
+
+# ── Handler 类型 ────────────────────────────────────
+
+HandlerFunc = Callable[..., CommandResult]
+HandlerMap = dict[str, dict[str, HandlerFunc]]
+
+
+# ── 中间件 ──────────────────────────────────────────
+
+class Middleware:
+    """中间件基类"""
+
+    def before(self, command: Command) -> Command:
+        """命令执行前"""
+        return command
+
+    def after(self, command: Command, result: CommandResult) -> CommandResult:
+        """命令执行后"""
+        return result
+
+    def on_error(self, command: Command, error: Exception) -> CommandResult:
+        """命令执行出错"""
+        return CommandResult(
+            success=False,
+            error=str(error),
+            suggestion="请检查参数或重试",
+        )
+
+
+class LoggingMiddleware(Middleware):
+    """日志中间件"""
+
+    def before(self, command: Command) -> Command:
+        logger.info(f"[{command.module}.{command.action}] args={command.args}")
+        return command
+
+    def after(self, command: Command, result: CommandResult) -> CommandResult:
+        msg = f"[{command.module}.{command.action}] success={result.success}"
+        logger.info(f"{msg} ({result.duration_ms}ms)")
+        return result
+
+
+class TimingMiddleware(Middleware):
+    """计时中间件"""
+
+    def before(self, command: Command) -> Command:
+        command._start_time = time.time()
+        return command
+
+    def after(self, command: Command, result: CommandResult) -> CommandResult:
+        if hasattr(command, "_start_time"):
+            result.duration_ms = round((time.time() - command._start_time) * 1000, 2)
+        return result
+
+
+# ── Command Bus ─────────────────────────────────────
+
+class CommandBus:
+    """命令总线——路由 Command 到 Handler，执行中间件链"""
+
+    def __init__(self):
+        self._handlers: HandlerMap = {}
+        self._middlewares: list[Middleware] = []
+
+    def register(self, module: str, action: str, handler: HandlerFunc | None = None):
+        """注册命令处理器——支持直接调用和装饰器两种用法
+
+        装饰器用法：
+            @bus.register("module", "action")
+            def handler(...): ...
+
+        直接调用：
+            bus.register("module", "action", handler_func)
+        """
+        def _register(h: HandlerFunc) -> HandlerFunc:
+            self._handlers.setdefault(module, {})[action] = h
+            return h
+
+        if handler is not None:
+            _register(handler)
+            return handler
+        return _register
+
+    def register_module(self, module: str, handlers: dict[str, HandlerFunc]):
+        """批量注册模块的所有命令处理器"""
+        self._handlers.setdefault(module, {}).update(handlers)
+
+    def add_middleware(self, middleware: Middleware):
+        """添加中间件"""
+        self._middlewares.append(middleware)
+
+    def execute(self, command: Command) -> CommandResult:
+        """同步执行命令"""
+        # 中间件链：before
+        for mw in self._middlewares:
+            command = mw.before(command)
+
+        try:
+            # 查找 Handler
+            module_handlers = self._handlers.get(command.module)
+            if module_handlers is None:
+                return CommandResult(
+                    success=False,
+                    error=f"未知模块: {command.module}",
+                    suggestion="运行 devmate --help 查看可用模块",
+                )
+
+            handler = module_handlers.get(command.action)
+            if handler is None:
+                return CommandResult(
+                    success=False,
+                    error=f"未知命令: {command.module}.{command.action}",
+                    suggestion=f"运行 devmate {command.module} --help 查看可用命令",
+                )
+
+            # 执行 Handler
+            result = handler(**command.args)
+
+        except Exception as e:
+            logger.exception(f"命令执行失败: {command.module}.{command.action}")
+            for mw in reversed(self._middlewares):
+                result = mw.on_error(command, e)
+                break
+            else:
+                result = CommandResult(
+                    success=False,
+                    error=str(e),
+                    suggestion="请检查参数或重试",
+                )
+        else:
+            if not isinstance(result, CommandResult):
+                result = CommandResult(success=True, data=result)
+
+        # 中间件链：after（逆序）
+        for mw in reversed(self._middlewares):
+            result = mw.after(command, result)
+
+        return result
+
+
+# ── 全局总线实例 ─────────────────────────────────────
+bus = CommandBus()
+bus.add_middleware(LoggingMiddleware())
+bus.add_middleware(TimingMiddleware())

devmate/bus/command.py

@@ -0,0 +1,84 @@
+"""Command 数据类和 CommandResult"""
+
+from dataclasses import dataclass, field
+from datetime import UTC, datetime
+from enum import StrEnum
+from typing import Any
+
+
+class SourceEndpoint(StrEnum):
+    """命令来源终端"""
+    CLI = "cli"
+    TUI = "tui"
+    WEB = "web"
+    VSCODE = "vscode"
+    CI = "ci"
+    REMOTE = "remote"
+
+
+class OutputFormat(StrEnum):
+    """输出格式"""
+    RICH = "rich"
+    JSON = "json"
+    QUIET = "quiet"
+    HTML = "html"
+    TUI = "tui"
+
+
+# ── Command 选项 ────────────────────────────────────
+
+@dataclass
+class CommandOptions:
+    """跨端命令选项"""
+    format: OutputFormat = OutputFormat.RICH
+    quiet: bool = False
+    timeout_seconds: float = 30.0
+    dry_run: bool = False
+
+
+# ── Command 上下文 ──────────────────────────────────
+
+@dataclass
+class CommandContext:
+    """命令执行上下文"""
+    source: SourceEndpoint = SourceEndpoint.CLI
+    user: str = ""
+    session_id: str = ""
+    correlation_id: str = ""
+    timestamp: datetime = field(default_factory=lambda: datetime.now(UTC))
+
+
+# ── Command 对象 ────────────────────────────────────
+
+@dataclass
+class Command:
+    """三端统一的命令对象
+
+    CLI / TUI / Web 都生成同一个 Command 对象，交给 CommandBus 路由。
+    """
+    module: str                     # 模块名，如 "toolkit"
+    action: str                     # 动作名，如 "organize"
+    args: dict[str, Any] = field(default_factory=dict)
+    options: CommandOptions = field(default_factory=CommandOptions)
+    context: CommandContext = field(default_factory=CommandContext)
+
+
+# ── Command 执行结果 ────────────────────────────────
+
+@dataclass
+class CommandResult:
+    """命令执行结果——支持多格式渲染"""
+    success: bool
+    data: Any = None
+    error: str | None = None
+    suggestion: str | None = None    # 错误时的建议操作
+    duration_ms: float | None = None
+
+    def to_dict(self) -> dict:
+        return {
+            "success": self.success,
+            "data": self.data,
+            "error": self.error,
+            "suggestion": self.suggestion,
+            "duration_ms": self.duration_ms,
+        }

devmate/core/__init__.py

@@ -0,0 +1 @@
+"""Core infrastructure — Config, Logging, Security"""