nexforge-cli 0.1.0__py3-none-any.whl

nexforge/ui/widgets/__init__.py

@@ -0,0 +1 @@
+"""Textual 自定义组件。"""

nexforge/ui/widgets/apikey_modal.py

@@ -0,0 +1,65 @@
+"""API Key 输入面板 —— 首次使用或 /key 无参时弹出。"""
+
+from __future__ import annotations
+
+from textual.app import ComposeResult
+from textual.containers import Vertical
+from textual.screen import ModalScreen
+from textual.widgets import Button, Input, Label
+
+
+class ApiKeyModal(ModalScreen[str | None]):
+    DEFAULT_CSS = """
+    ApiKeyModal {
+        align: center middle;
+    }
+    ApiKeyModal > Vertical {
+        width: 55;
+        background: #1a1a24;
+        border: round #6D5EF5;
+        padding: 1 2;
+    }
+    #apikey-title {
+        color: #22D3EE;
+        text-style: bold;
+        margin-bottom: 1;
+    }
+    #apikey-body {
+        height: auto;
+        margin-bottom: 1;
+    }
+    #apikey-input {
+        margin-bottom: 1;
+    }
+    #apikey-buttons {
+        height: auto;
+        align: center bottom;
+    }
+    """
+
+    def compose(self) -> ComposeResult:
+        with Vertical():
+            yield Label("配置 DeepSeek API Key", id="apikey-title")
+            yield Label(
+                "请输入你的 DeepSeek API Key(以 sk- 开头)。\n"
+                "Key 将安全保存在本地凭据文件中,不会上传。\n\n"
+                "[dim]获取地址: https://platform.deepseek.com/api_keys[/]",
+                id="apikey-body",
+            )
+            yield Input(placeholder="sk-…", id="apikey-input", password=True)
+            with Vertical(id="apikey-buttons"):
+                yield Button("保存并开始", variant="primary", id="btn-apikey-save")
+                yield Button("跳过(稍后配置)", id="btn-apikey-skip")
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "btn-apikey-save":
+            key = self.query_one("#apikey-input", Input).value.strip()
+            if key.startswith("sk-"):
+                self.dismiss(key)
+            else:
+                self.query_one("#apikey-body", Label).update(
+                    "[red]Key 必须以 sk- 开头,请检查后重试。[/]\n\n"
+                    "[dim]获取地址: https://platform.deepseek.com/api_keys[/]"
+                )
+        else:
+            self.dismiss(None)

nexforge/ui/widgets/banner.py

@@ -0,0 +1,18 @@
+"""顶部品牌横幅。"""
+
+from __future__ import annotations
+
+from rich.text import Text
+from textual.widgets import Static
+
+from nexforge.icons import icon
+
+
+class Banner(Static):
+    def on_mount(self) -> None:
+        ic = icon("agent")
+        t = Text()
+        t.append(f"{ic} NexForge", style="bold #6D5EF5")
+        t.append("CLI", style="bold #22D3EE")
+        t.append("   DeepSeek V4 终端智能体", style="dim")
+        self.update(t)

nexforge/ui/widgets/confirm_modal.py

@@ -0,0 +1,58 @@
+"""通用确认弹窗:删前确认,防误操作。"""
+
+from __future__ import annotations
+
+from textual.app import ComposeResult
+from textual.containers import Vertical
+from textual.screen import ModalScreen
+from textual.widgets import Button, Label
+
+
+class ConfirmModal(ModalScreen[bool]):
+    DEFAULT_CSS = """
+    ConfirmModal {
+        align: center middle;
+    }
+    ConfirmModal > Vertical {
+        width: 50;
+        background: #1a1a24;
+        border: round #E04040;
+        padding: 1 2;
+    }
+    #confirm-title {
+        color: #E04040;
+        text-style: bold;
+        margin-bottom: 1;
+    }
+    #confirm-body {
+        height: auto;
+        margin-bottom: 1;
+    }
+    #confirm-buttons {
+        height: auto;
+        align: center bottom;
+    }
+    """
+
+    def __init__(self, title: str, message: str, confirm_label: str = "确认删除") -> None:
+        super().__init__()
+        self._title = title
+        self._message = message
+        self._confirm_label = confirm_label
+
+    def compose(self) -> ComposeResult:
+        with Vertical():
+            yield Label(self._title, id="confirm-title")
+            yield Label(self._message, id="confirm-body")
+            with Vertical(id="confirm-buttons"):
+                yield Button(f"{self._confirm_label} (y)", variant="error", id="btn-confirm-yes")
+                yield Button("取消 (n)", variant="primary", id="btn-confirm-no")
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        self.dismiss(event.button.id == "btn-confirm-yes")
+
+    def on_key(self, event) -> None:
+        if event.key in ("y", "Y"):
+            self.dismiss(True)
+        elif event.key in ("n", "N", "escape"):
+            self.dismiss(False)

nexforge/ui/widgets/diff_modal.py

@@ -0,0 +1,67 @@
+"""Diff 审批模态:写文件/执行危险操作前展示变更,用户 y/n 审批。"""
+
+from __future__ import annotations
+
+from textual.app import ComposeResult
+from textual.containers import Vertical
+from textual.screen import ModalScreen
+from textual.widgets import Button, Label, Static
+
+
+class DiffApprovalModal(ModalScreen[bool]):
+    """模态:展示变更预览,返回 True(批准)或 False(拒绝)。"""
+
+    DEFAULT_CSS = """
+    DiffApprovalModal {
+        align: center middle;
+    }
+    DiffApprovalModal > Vertical {
+        width: 60;
+        max-height: 80%;
+        background: #1a1a24;
+        border: round #6D5EF5;
+        padding: 1 2;
+    }
+    #diff-title {
+        color: #22D3EE;
+        text-style: bold;
+        margin-bottom: 1;
+    }
+    #diff-body {
+        height: auto;
+        max-height: 20;
+        margin-bottom: 1;
+    }
+    #diff-buttons {
+        height: auto;
+        align: center bottom;
+    }
+    """
+
+    def __init__(self, tool_name: str, preview: str, diff: str = "") -> None:
+        super().__init__()
+        self._tool = tool_name
+        self._preview = preview
+        self._diff = diff
+
+    def compose(self) -> ComposeResult:
+        with Vertical():
+            yield Label(f"审批 {self._tool}", id="diff-title")
+            yield Label(f"[dim]{self._preview}[/]", id="diff-preview")
+            if self._diff:
+                yield Static(self._diff, id="diff-body")
+            with Vertical(id="diff-buttons"):
+                yield Button("批准 (y)", variant="primary", id="btn-approve")
+                yield Button("拒绝 (n)", variant="error", id="btn-deny")
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "btn-approve":
+            self.dismiss(True)
+        else:
+            self.dismiss(False)
+
+    def on_key(self, event) -> None:
+        if event.key in ("y", "Y"):
+            self.dismiss(True)
+        elif event.key in ("n", "N", "escape"):
+            self.dismiss(False)

nexforge/ui/widgets/messages.py

@@ -0,0 +1,132 @@
+"""消息组件:用户消息、助手回合(思考面板 + Markdown 正文)、工具卡片、系统提示。"""
+
+from __future__ import annotations
+
+from rich.markup import escape
+from textual.app import ComposeResult
+from textual.containers import Vertical
+from textual.widgets import Collapsible, Static
+from rich.markdown import Markdown as RichMarkdown
+
+
+class SystemNote(Static):
+    """系统 / 错误提示行。"""
+
+    def __init__(self, text: str, *, error: bool = False) -> None:
+        from nexforge.icons import icon
+
+        sym = icon("err") if error else icon("running")
+        color = "red" if error else "#22D3EE"
+        super().__init__(f"[{color}]{sym}[/] {escape(text)}")
+
+
+class UserMessage(Static):
+    def __init__(self, text: str) -> None:
+        from nexforge.icons import icon
+
+        super().__init__(f"[b #6D5EF5]{icon('user')}[/] {escape(text)}")
+
+
+class ToolCard(Static):
+    """一次工具调用:执行中 → 完成(✔/✖)。"""
+
+    def __init__(self, preview: str, icon_name: str = "running") -> None:
+        super().__init__()
+        self._preview = preview
+        self._icon = icon_name
+
+    def on_mount(self) -> None:
+        from nexforge.icons import icon
+
+        ic = icon(self._icon)
+        self.update(f"[#22D3EE]{ic}[/] {escape(self._preview)}  [dim]执行中…[/]")
+
+    def set_result(self, ok: bool, summary: str) -> None:
+        from nexforge.icons import icon
+
+        mark = icon("ok") if ok else icon("err")
+        color = "green" if ok else "red"
+        self.update(
+            f"[{color}]{mark}[/] [#22D3EE]{escape(self._preview)}[/] "
+            f"[dim]{escape(summary)}[/]"
+        )
+
+
+class AssistantTurn(Vertical):
+    """一轮助手输出:可折叠思考面板 + Markdown 正文。"""
+
+    def __init__(self, initial_content: str = "") -> None:
+        super().__init__()
+        self._reasoning = ""
+        self._content = initial_content
+        self._collapsed_once = False
+
+    def compose(self) -> ComposeResult:
+        import re
+        from nexforge.icons import icon
+        from rich.markup import escape as rich_escape
+
+        with Collapsible(title=f"{icon('thinking')} 思考", collapsed=False, id="think"):
+            yield Static("", id="reasoning-body")
+        # 流式时用 Static 快速渲染(避免每 token 全量 Markdown 解析变慢)
+        init = re.sub(r"\n{3,}", "\n\n", self._content).lstrip("\n")
+        yield Static(rich_escape(init), id="content-txt")
+
+    def on_mount(self) -> None:
+        # 未产生思考内容前隐藏思考面板
+        self.query_one("#think", Collapsible).display = False
+
+    def add_reasoning(self, text: str) -> None:
+        self._reasoning += text
+        panel = self.query_one("#think", Collapsible)
+        if not panel.display:
+            panel.display = True
+        self.query_one("#reasoning-body", Static).update(self._reasoning)
+        # 思考面板的 Contents 有 overflow-y:auto,每次更新后滚到底
+        try:
+            contents = panel.query_one("Contents")
+            contents.scroll_end(animate=False)
+        except Exception:
+            pass
+
+    def add_content(self, text: str) -> None:
+        # 正文开始 → 折叠思考面板
+        if not self._collapsed_once and self._reasoning:
+            self.query_one("#think", Collapsible).collapsed = True
+            self._collapsed_once = True
+        self._content += text
+        import re
+        from rich.markup import escape as rich_escape
+        # 折叠 3+ 连续空行为 2,避免句子间出现大空白
+        normalized = re.sub(r"\n{3,}", "\n\n", self._content).lstrip("\n")
+        # static 用 escaped 文本,避免 [ / # / ` 触发 Rich markup 吞内容
+        self.query_one("#content-txt", Static).update(rich_escape(normalized))
+
+    def finalize_content(self) -> None:
+        """回合结束:用 Rich Markdown 渲染到 Static(无 Textual Markdown bug)。"""
+        import re
+        try:
+            self.query_one("#content-txt", Static).remove()
+        except Exception:
+            pass
+        try:
+            self.query_one("#think", Collapsible).remove()
+        except Exception:
+            pass
+        normalized = re.sub(r"\n{3,}", "\n\n", self._content).strip("\n")
+        rich_md = RichMarkdown(normalized)
+        self.mount(Static(rich_md, id="content-rt"))
+        self._scroll_to_end()
+
+    def _scroll_to_end(self) -> None:
+        """精确找到 #chat-log 并滚到底。"""
+        try:
+            from textual.containers import VerticalScroll
+            log = self.app.query_one("#chat-log", VerticalScroll)
+            log.scroll_end(animate=False)
+        except Exception:
+            pass
+
+    @property
+    def is_empty(self) -> bool:
+        return not self._reasoning and not self._content

nexforge/ui/widgets/mode_warning.py

@@ -0,0 +1,57 @@
+"""警告模态:切换全自动模式前的确认弹窗。"""
+
+from __future__ import annotations
+
+from textual.app import ComposeResult
+from textual.containers import Vertical
+from textual.screen import ModalScreen
+from textual.widgets import Button, Label
+
+
+class ModeWarningModal(ModalScreen[bool]):
+    DEFAULT_CSS = """
+    ModeWarningModal {
+        align: center middle;
+    }
+    ModeWarningModal > Vertical {
+        width: 50;
+        background: #1a1a24;
+        border: round #E04040;
+        padding: 1 2;
+    }
+    #mw-title {
+        color: #E04040;
+        text-style: bold;
+        margin-bottom: 1;
+    }
+    #mw-body {
+        height: auto;
+        margin-bottom: 1;
+    }
+    #mw-buttons {
+        height: auto;
+        align: center bottom;
+    }
+    """
+
+    def compose(self) -> ComposeResult:
+        with Vertical():
+            yield Label("⚠ 全自动模式", id="mw-title")
+            yield Label(
+                "全自动模式下,所有写文件/执行命令/删除操作将 [bold #E04040]不经审批自动执行[/]。\n\n"
+                "这可能导致不可逆的文件修改或系统命令执行。\n\n"
+                "[dim]确认开启? (y/n)[/]",
+                id="mw-body",
+            )
+            with Vertical(id="mw-buttons"):
+                yield Button("确认开启 (y)", variant="error", id="btn-auto-yes")
+                yield Button("取消 (n)", variant="primary", id="btn-auto-no")
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        self.dismiss(event.button.id == "btn-auto-yes")
+
+    def on_key(self, event) -> None:
+        if event.key in ("y", "Y"):
+            self.dismiss(True)
+        elif event.key in ("n", "N", "escape"):
+            self.dismiss(False)

nexforge/ui/widgets/multiline_modal.py

@@ -0,0 +1,59 @@
+"""多行输入弹窗:F2 弹出,Enter 换行,Ctrl+Enter 或按钮提交。"""
+
+from __future__ import annotations
+
+from textual.app import ComposeResult
+from textual.containers import Horizontal, Vertical
+from textual.screen import ModalScreen
+from textual.widgets import Button, Label, TextArea
+
+
+class MultilineInputModal(ModalScreen[str | None]):
+
+    DEFAULT_CSS = """
+    MultilineInputModal {
+        align: center middle;
+    }
+    MultilineInputModal > Vertical {
+        width: 80;
+        height: 26;
+        background: #1a1a24;
+        border: round #6D5EF5;
+        padding: 1 2;
+    }
+    #mli-title {
+        color: #6D5EF5;
+        text-style: bold;
+        height: auto;
+    }
+    #mli-textarea {
+        height: 1fr;
+        margin: 1 0;
+    }
+    #mli-buttons {
+        height: auto;
+        align: center top;
+    }
+    """
+
+    def __init__(self, prefilled: str = "") -> None:
+        super().__init__()
+        self._prefilled = prefilled
+
+    def compose(self) -> ComposeResult:
+        with Vertical():
+            yield Label("多行输入 (Enter 换行,点发送提交)", id="mli-title")
+            yield TextArea(self._prefilled, id="mli-textarea")
+            with Horizontal(id="mli-buttons"):
+                yield Button("发送", variant="primary", id="btn-mli-send")
+                yield Button("取消", id="btn-mli-cancel")
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "btn-mli-send":
+            self.action_send_text()
+        elif event.button.id == "btn-mli-cancel":
+            self.dismiss(None)
+
+    def action_send_text(self) -> None:
+        text = self.query_one("#mli-textarea", TextArea).text.strip()
+        self.dismiss(text if text else None)

nexforge/ui/widgets/multiline_prompt.py

@@ -0,0 +1,25 @@
+"""多行输入组件:Enter 提交,自适应 1~5 行,粘贴多行。"""
+
+from __future__ import annotations
+
+from textual.message import Message
+from textual.widgets import TextArea
+
+
+class MultilinePrompt(TextArea):
+    """Enter 提交,自适应高度。"""
+
+    class PromptSubmitted(Message):
+        def __init__(self, text: str) -> None:
+            self.text = text
+            super().__init__()
+
+    async def _on_key(self, event) -> None:
+        if event.key == "enter":
+            event.stop()
+            event.prevent_default()
+            text = self.text
+            self.clear()
+            self.post_message(self.PromptSubmitted(text))
+            return
+        await super()._on_key(event)

nexforge/ui/widgets/plan_sidebar.py

@@ -0,0 +1,89 @@
+"""计划面板 —— 右侧面板,显示计划标题按钮列表 + 进度。
+
+Ctrl+B 开关;默认隐藏。点击标题 → 载入计划到主屏。
+"""
+
+from __future__ import annotations
+
+from textual.app import ComposeResult
+from textual.containers import Vertical, VerticalScroll
+from textual.widgets import Button, Label
+
+from nexforge.store.plan_store import PlanInfo, list_plans
+
+
+class PlanSidebar(Vertical):
+    DEFAULT_CSS = """
+    PlanSidebar {
+        width: 32;
+        height: 100%;
+        border-left: outer #22D3EE;
+        background: #12121a;
+        padding: 1;
+    }
+    #plan-title {
+        color: #22D3EE;
+        text-style: bold;
+        height: auto;
+        margin-bottom: 1;
+    }
+    #plan-list {
+        height: 1fr;
+    }
+    #plan-buttons {
+        height: auto;
+        padding-top: 1;
+    }
+    PlanSidebar Button {
+        width: 100%;
+        margin-bottom: 1;
+        height: auto;
+    }
+    .plan-btn {
+        background: #1a1a24;
+        border: none;
+        text-align: left;
+    }
+    .plan-btn:hover {
+        background: #6D5EF5 30%;
+    }
+    """
+
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        self.plan_map: dict[str, PlanInfo] = {}
+        self.active_id: str = ""  # 当前激活计划
+        self._gen = 0
+
+    def compose(self) -> ComposeResult:
+        yield Label("计划列表", id="plan-title")
+        yield VerticalScroll(id="plan-list")
+        with Vertical(id="plan-buttons"):
+            yield Button("+ 新建计划(/plan)", id="btn-plan-new", variant="primary")
+            yield Button("关闭计划模式", id="btn-plan-toggle", variant="default")
+            yield Button("✖ 删除当前", id="btn-plan-del", variant="error")
+
+    def on_mount(self) -> None:
+        self.refresh_list()
+
+    def refresh_list(self) -> None:
+        cont = self.query_one("#plan-list", VerticalScroll)
+        cont.remove_children()
+        self.plan_map.clear()
+        self._gen += 1
+        gen = self._gen
+        plans = list_plans()
+        if not plans:
+            cont.mount(Label("[dim](暂无计划)[/]", id=f"empty-{gen}"))
+            return
+        for i, p in enumerate(plans[:40]):
+            bid = f"plan-{gen}-{i}"
+            self.plan_map[bid] = p
+            progress = f" [{p.done}/{p.total}]" if p.total > 0 else ""
+            active_dot = "[#3CE88A]●[/] " if p.id == self.active_id else "  "
+            btn = Button(
+                f"{active_dot}{p.title[:20]}{progress}",
+                id=bid,
+                classes="plan-btn",
+            )
+            cont.mount(btn)

nexforge/ui/widgets/sidebar.py

@@ -0,0 +1,99 @@
+"""会话管理侧边栏 —— 右侧面板,列会话/新建/切换/删除。
+
+Ctrl+S 开关;默认隐藏。会话行、新建、删除都是 Button,点击事件
+冒泡到 ChatScreen.on_button_pressed 处理。
+"""
+
+from __future__ import annotations
+
+from textual.app import ComposeResult
+from textual.containers import Vertical, VerticalScroll
+from textual.widgets import Button, Label
+
+from nexforge.store.session_store import SessionInfo, list_sessions
+
+
+class Sidebar(Vertical):
+    DEFAULT_CSS = """
+    Sidebar {
+        width: 30;
+        height: 100%;
+        border-left: outer #6D5EF5;
+        background: #12121a;
+        padding: 1;
+    }
+    #sb-title {
+        color: #22D3EE;
+        text-style: bold;
+        height: auto;
+        margin-bottom: 1;
+    }
+    #sb-list {
+        height: 1fr;
+    }
+    #sb-buttons {
+        height: auto;
+        padding-top: 1;
+    }
+    Sidebar Button {
+        width: 100%;
+        margin-bottom: 1;
+        height: auto;
+    }
+    .sess-btn {
+        background: #1a1a24;
+        border: none;
+        text-align: left;
+    }
+    .sess-btn:hover {
+        background: #6D5EF5 30%;
+    }
+    """
+
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        # 按钮 id → SessionInfo 映射
+        self.session_map: dict[str, SessionInfo] = {}
+        # 刷新代数:每次刷新用新的 id 前缀,避免 remove_children 异步未完成时 id 冲突
+        self._gen = 0
+        self.active_id: str = ""  # 当前激活会话(绿点标识)
+
+    def compose(self) -> ComposeResult:
+        yield Label("会话管理", id="sb-title")
+        yield VerticalScroll(id="sb-list")
+        with Vertical(id="sb-buttons"):
+            yield Button("+ 新建会话", id="btn-new", variant="primary")
+            yield Button("✖ 删除当前", id="btn-del", variant="error")
+
+    def on_mount(self) -> None:
+        self.refresh_list()
+
+    def refresh_list(self) -> None:
+        """重建会话列表。用代数前缀保证 id 唯一(remove_children 是异步的)。"""
+        # 从当前屏幕同步激活会话 id(绿点标识)
+        try:
+            self.active_id = getattr(self.screen, "_session_id", "") or ""
+        except Exception:
+            pass
+        cont = self.query_one("#sb-list", VerticalScroll)
+        cont.remove_children()
+        self.session_map.clear()
+        self._gen += 1
+        gen = self._gen
+
+        sessions = list_sessions()
+        if not sessions:
+            cont.mount(Label("[dim](暂无历史会话)[/]", id=f"empty-{gen}"))
+            return
+        for i, s in enumerate(sessions[:50]):
+            bid = f"sess-{gen}-{i}"
+            self.session_map[bid] = s
+            active = s.id == self.active_id
+            dot = "[#3CE88A]●[/] " if active else "  "
+            btn = Button(
+                f"{dot}{s.name[:15]}  ({s.message_count})",
+                id=bid,
+                classes="sess-btn",
+            )
+            cont.mount(btn)
+        cont.refresh()