nexforge-cli 0.2.1__tar.gz → 0.2.2__tar.gz

{nexforge_cli-0.2.1 → nexforge_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nexforge-cli
-Version: 0.2.1
+Version: 0.2.2
 Summary: NexForgeCLI — 一个面向 DeepSeek V4 的终端智能体(TUI + CLI 双模式)
 Project-URL: Homepage, https://gitee.com/Lighthorn/nexforgecli
 Author: NexForge

nexforge_cli-0.2.2/doc//345/257/271/346/257/224/345/210/206/346/236/220.md

@@ -0,0 +1,76 @@
+# NexForgeCLI vs 其他 AI 编码智能体横向对比
+
+## 总览
+
+| | **NexForgeCLI** | **Claude Code** | **Codex CLI** | **Cursor** | **Windsurf** | **Aider** |
+|---|---|---|---|---|---|---|
+| **界面** | TUI(Textual)+CLI | 终端 TUI | 终端 CLI(Node) | VS Code 分支 | VS Code 扩展 | 终端 TUI+CLI |
+| **模型** | DeepSeek V4 | Claude 3.5/4 | GPT-4o/o-series | 多模型 | 多模型 | 多模型 |
+| **安装** | `pip install` | `npm install -g` | `npx` | 安装包(~400MB) | VS Code 市场 | `pip install` |
+| **开源** | ✅ MIT | ❌ | ✅ Apache | ❌ | ❌ | ✅ Apache |
+| **跨平台** | Win/Mac/Linux | Mac/Linux(WSL) | Mac/Linux(?) | 全平台 | 全平台 | 全平台 |
+| **大小** | ~95KB | ~50MB npm | ~? | ~400MB | ~500MB | ~3MB |
+
+---
+
+## 工具能力
+
+| | **NexForgeCLI** | **Claude Code** | **Codex CLI** | **Cursor** | **Windsurf** | **Aider** |
+|---|---|---|---|---|---|---|
+| **文件读取** | ✅ 行范围 | ✅ | ✅ | ✅ IDE原生 | ✅ IDE原生 | ✅ |
+| **文件编辑** | ✅ SEARCH/REPLACE | ✅ SEARCH/REPLACE | ✅ | ✅ IDE直接 | ✅ IDE直接 | ✅ SEARCH/REPLACE |
+| **批量编辑** | ✅ multi_edit | — | — | ✅ 多光标 | ✅ 多光标 | — |
+| **Shell** | ✅ 超时+危险拦截 | ✅ | ✅ | ✅ 集成终端 | ✅ 集成终端 | ✅ |
+| **后台任务** | ✅ run_background | — | — | ✅ 终端多标签 | ✅ 终端多标签 | — |
+| **Web 抓取** | ✅ web_fetch | — | — | — | — | ❌(靠 curl) |
+| **文件搜索** | ✅ grep+文件名 | ✅ | ✅ | ✅ VS搜索 | ✅ VS搜索 | ❌(靠 shell) |
+| **Git** | ✅ 三状态+可选commit | ✅ 完整 | ✅ 完整 | ✅ 内建VCS | ✅ 内建VCS | ✅ 完整 |
+
+---
+
+## 权限与安全
+
+| | **NexForgeCLI** | **Claude Code** | **Codex CLI** | **Cursor** | **Aider** |
+|---|---|---|---|---|---|
+| **权限分级** | 🛡safe/⚡supervised/🔥auto | 逐命令审批(Y/n) | 工具级审批 | 审批确认 | `--yes`全跳过 |
+| **危险命令拦截** | ✅ 内置黑名单(rm -rf /等) | ⚠ Shell警告 | — | ✅ IDE沙箱 | ❌ |
+| **死循环检测** | ✅ 连续3次同工具失败→注入提示 | — | — | — | — |
+
+---
+
+## 会话与上下文
+
+| | **NexForgeCLI** | **Claude Code** | **Codex CLI** | **Aider** |
+|---|---|---|---|---|
+| **会话保存** | ✅ 自动保存MD文件 | ✅ .claude/sessions/ | ✅ .codex/sessions/ | ✅ .md文件 |
+| **会话管理** | ✅ 侧边栏:新建/切/删/改名 | ✅ ls/resume命令 | — | `--restore` |
+| **会话恢复** | ✅ 启动自动恢复最近 | ✅ 可恢复 | ✅ 可恢复 | ✅ 可恢复 |
+| **上下文窗口** | **1M tokens**(DeepSeek V4) | 200K(Claude) | 128K(GPT-4o) | 模型决定 |
+| **计划模式** | ✅ /plan只读讨论 | — | — | — |
+
+---
+
+## 模型路由与优化
+
+| | **NexForgeCLI** | **Claude Code** | **Codex CLI** | **Cursor** | **Aider** |
+|---|---|---|---|---|---|
+| **自动路由** | ✅ Flash→Pro(关键词+上下文+失败次数) | ❌ | ❌ | ❌ | ❌ |
+| **思考模式** | ✅ thinking流式+可折叠面板 | ✅ 扩展思考 | ✅ o-series推理 | ❌ | ❌ |
+| **KV Cache计费** | ✅ 缓存命中/未命中拆分 | — | — | — | — |
+| **采样参数** | ✅ thinking=off时可用 | — | — | — | — |
+| **JSON模式** | ✅ /json切换 | — | — | — | — |
+
+---
+
+## 独有亮点
+
+1. **后台任务管理** —— 启动/监控/杀后台进程(`run_background`等5个工具)
+2. **自动路由** —— 客户端智能判断,小任务用 Flash 省钱,大任务自动升 Pro
+3. **死循环保护** —— 同一工具连续失败3次自动停止+提示
+4. **三级权限** —— safe/supervised/auto 允许用户按场景自由控制
+5. **DeepSeek KV Cache 精确计费** —— 区分缓存命中/未命中,费用更准确
+6. **自建 Web 面板** —— 零外部依赖,浏览器管理会话/计划/配置
+7. **计划模式** —— `/plan` 只读讨论,先规划再执行
+8. **Markdown 会话** —— 人类可读的会话文件,可直接编辑
+9. **跨 Agent 协作** —— `/import` 读取其他智能体的项目数据
+10. **轻量级** —— pip 包仅 95KB,无 Node.js 依赖

{nexforge_cli-0.2.1 → nexforge_cli-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nexforge-cli"
-version = "0.2.1"
+version = "0.2.2"
 description = "NexForgeCLI — 一个面向 DeepSeek V4 的终端智能体(TUI + CLI 双模式)"
 readme = "README.md"
 requires-python = ">=3.11"

{nexforge_cli-0.2.1 → nexforge_cli-0.2.2}/src/nexforge/ui/screens/chat.py

@@ -79,6 +79,7 @@ class ChatScreen(Screen):
         ("f2", "multiline_input", "多行"),
         ("f4", "copy_last", "复制"),
         ("f3", "external_edit", "编辑器"),
+        ("ctrl+c", "copy_last", "复制"),
     ]
 
     def __init__(
@@ -128,16 +129,18 @@ class ChatScreen(Screen):
         # 加载技能
         self._skills = discover_skills(Path.cwd())
         if not self.config.resolve_api_key():
-            # 弹出 API Key 输入面板
-            async def _ask_key():
-                key = await self.app.push_screen_wait(ApiKeyModal())
+            # 弹出 API Key 输入面板(延迟到屏幕完挂载后)
+            def _on_key(key: str | None) -> None:
                 if key:
                     from nexforge.config import save_api_key
                     save_api_key(key)
                     self.config.provider.api_key = key
                     self._init_provider(key)
-            import asyncio
-            asyncio.create_task(_ask_key())
+                    self._refresh_status()
+                    self._note("✅ API Key 已保存并验证通过!", scroll=True)
+                else:
+                    self._note("⚠ 跳过 API Key 配置,稍后可用 /key 设置。", scroll=True)
+            self.set_timer(0.1, lambda: self.app.push_screen(ApiKeyModal(), callback=_on_key))
         else:
             self._init_provider()
         self._refresh_status()
@@ -540,8 +543,8 @@ class ChatScreen(Screen):
             self.agent = AgentLoop(
                 self.config, self.provider, self.session, approve=self._ask_approve
             )
-        except ProviderError as exc:
-            self._note(str(exc), error=True)
+        except Exception as exc:
+            self._note(f"初始化失败:{exc}", error=True)
 
     def _auto_fetch_balance(self) -> None:
         """启动时自动查询余额(不阻塞)。"""

nexforge_cli-0.2.2/src/nexforge/ui/widgets/apikey_modal.py

@@ -0,0 +1,84 @@
+"""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, Static
+
+
+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-status { height: auto; margin-bottom: 1; }
+    #apikey-buttons { height: auto; align: center bottom; }
+    """
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._verified = False
+        self._key = ""
+
+    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)
+            yield Static("", id="apikey-status")
+            with Vertical(id="apikey-buttons"):
+                yield Button("验证 Key", variant="primary", id="btn-apikey-verify")
+                yield Button("保存并开始", variant="success", id="btn-apikey-save", disabled=True)
+                yield Button("跳过(稍后配置)", id="btn-apikey-skip")
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        bid = event.button.id
+        if bid == "btn-apikey-verify":
+            key = self.query_one("#apikey-input", Input).value.strip()
+            status = self.query_one("#apikey-status", Static)
+            if not key.startswith("sk-"):
+                status.update("[red]❌ Key 必须以 sk- 开头。[/]")
+                return
+            status.update("[yellow]⏳ 正在验证 Key…[/]")
+            import asyncio
+            asyncio.create_task(self._do_verify(key, status))
+        elif bid == "btn-apikey-save":
+            if self._verified and self._key:
+                self.dismiss(self._key)
+            else:
+                self.query_one("#apikey-status", Static).update(
+                    "[red]请先点击\"验证 Key\"通过验证。[/]"
+                )
+        else:
+            self.dismiss(None)
+
+    async def _do_verify(self, key: str, status: Static) -> None:
+        try:
+            from openai import AsyncOpenAI
+            client = AsyncOpenAI(api_key=key, base_url="https://api.deepseek.com", timeout=10)
+            resp = await client.models.list()
+            await client.close()
+            ok = len(resp.data) > 0
+        except Exception:
+            ok = False
+        if ok:
+            self._verified = True
+            self._key = key
+            status.update("[green]✅ Key 验证通过!点击\"保存并开始\"即可。[/]")
+            self.query_one("#btn-apikey-save", Button).disabled = False
+        else:
+            self._verified = False
+            status.update("[red]❌ Key 验证失败!请检查 Key 和网络。[/]")
+            self.query_one("#btn-apikey-save", Button).disabled = True

nexforge_cli-0.2.1/src/nexforge/ui/widgets/apikey_modal.py

@@ -1,65 +0,0 @@
-"""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)