nexforge-cli 0.2.6__tar.gz → 0.2.7__tar.gz

{nexforge_cli-0.2.6 → nexforge_cli-0.2.7}/PKG-INFO

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

nexforge_cli-0.2.7/STATS_API.md

@@ -0,0 +1,209 @@
+# NexTech 软件统计 API 文档
+
+> 版本: 1.0
+> 基础路径: `https://nextech.club/api/stats.php`
+
+---
+
+## 概述
+
+轻量级软件在线统计服务，用于采集和查询软件客户端的下载量、在线用户数等指标。采用 **SQLite** 存储 + **POST 心跳** 机制，支持万级并发。
+
+### 设计原则
+
+- 最小资源消耗：单条 SQLite `INSERT OR REPLACE` 写入，无 MySQL 开销
+- 自动过期清理：120 秒无心跳自动标记离线
+- 批量清理：每 10 次心跳触发一次过期记录删除
+
+---
+
+## 接口列表
+
+### 1. 软件心跳上报
+
+```
+POST /api/stats.php?action=heartbeat
+Content-Type: application/json
+```
+
+上报软件客户端的在线状态，建议每 **60 秒** 调用一次。
+
+#### 请求参数
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `software` | string | 是 | 软件名称（如 `NexAgent`、`NexClient`） |
+| `client_id` | string | 是 | 客户端唯一标识（每台设备的 ID） |
+
+#### 请求示例
+
+```bash
+curl -X POST https://nextech.club/api/stats.php?action=heartbeat \
+  -H "Content-Type: application/json" \
+  -d '{"software":"NexAgent","client_id":"device-001"}'
+```
+
+#### 响应示例
+
+```json
+{
+    "ok": true,
+    "online_total": 42,
+    "cleaned": 3
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `ok` | bool | 是否成功 |
+| `online_total` | int | 当前总在线数 |
+| `cleaned` | int | 本次清理的过期记录数 |
+
+#### 错误响应
+
+```json
+{
+    "ok": false,
+    "error": "software 和 client_id 不能为空"
+}
+```
+
+HTTP 状态码: `400`
+
+---
+
+### 2. 获取统计
+
+```
+GET /api/stats.php
+```
+
+返回当前在线用户数（按软件分组）和今日软件下载量。
+
+#### 请求示例
+
+```bash
+curl https://nextech.club/api/stats.php
+```
+
+#### 响应示例
+
+```json
+{
+    "ok": true,
+    "time": "2026-07-21 06:48:00",
+    "online": {
+        "total": 42,
+        "by_software": {
+            "NexAgent": 30,
+            "NexClient": 12
+        }
+    },
+    "downloads": [
+        {
+            "name": "nexhttp-1.0.0.zip",
+            "count": 4,
+            "size_mb": 23.37
+        }
+    ]
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `online.total` | int | 总在线数（120 秒内有心跳） |
+| `online.by_software` | object | 按软件名称分组的在线数 |
+| `downloads[]` | array | 今日下载统计列表 |
+| `downloads[].name` | string | 下载文件名 |
+| `downloads[].count` | int | 今日下载次数 |
+| `downloads[].size_mb` | float | 文件大小（MB） |
+
+---
+
+## 客户端接入示例
+
+### Python
+
+```python
+import requests
+import time
+import uuid
+
+CLIENT_ID = str(uuid.uuid4())  # 每台设备固定一个 ID
+
+def heartbeat():
+    while True:
+        try:
+            r = requests.post(
+                "https://nextech.club/api/stats.php?action=heartbeat",
+                json={"software": "NexAgent", "client_id": CLIENT_ID},
+                timeout=5
+            )
+            print(f"心跳成功: {r.json()['online_total']} 在线")
+        except Exception as e:
+            print(f"心跳失败: {e}")
+        time.sleep(60)  # 每 60 秒上报一次
+```
+
+### JavaScript / Node.js
+
+```javascript
+const CLIENT_ID = 'device-' + Math.random().toString(36).substr(2, 9);
+
+setInterval(async () => {
+    try {
+        const res = await fetch('https://nextech.club/api/stats.php?action=heartbeat', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ software: 'NexClient', client_id: CLIENT_ID })
+        });
+        const data = await res.json();
+        console.log(`心跳成功: ${data.online_total} 在线`);
+    } catch (e) {
+        console.error('心跳失败:', e);
+    }
+}, 60000);
+```
+
+### C / C++（libcurl）
+
+```c
+#include <curl/curl.h>
+
+void heartbeat() {
+    CURL *curl = curl_easy_init();
+    if (!curl) return;
+    
+    char json[256];
+    snprintf(json, sizeof(json), 
+        "{\"software\":\"NexAgent\",\"client_id\":\"%s\"}", DEVICE_ID);
+    
+    curl_easy_setopt(curl, CURLOPT_URL, 
+        "https://nextech.club/api/stats.php?action=heartbeat");
+    curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json);
+    curl_easy_setopt(curl, CURLOPT_TIMEOUT, 5);
+    curl_easy_perform(curl);
+    curl_easy_cleanup(curl);
+}
+```
+
+---
+
+## 性能参考
+
+| 并发数 | 每次心跳 | SQLite 写入 | 服务器负载 |
+|--------|----------|-------------|-----------|
+| 100    | 60 秒    | 1.7 次/秒   | < 0.1% CPU |
+| 1,000  | 60 秒    | 17 次/秒    | < 0.5% CPU |
+| 10,000 | 60 秒    | 167 次/秒   | ~3% CPU |
+| 50,000 | 60 秒    | 833 次/秒   | ~15% CPU |
+
+---
+
+## 技术细节
+
+- **数据库**: SQLite3 `/tmp/software_online.db`
+- **表结构**: `heartbeats(id, software, client_id, last_seen, ip)`
+- **过期 TTL**: 120 秒
+- **清理策略**: 每 10 次心跳批量 `DELETE WHERE last_seen < now - 120`
+- **索引**: `idx_last_seen`、`idx_software`

{nexforge_cli-0.2.6 → nexforge_cli-0.2.7}/pyproject.toml

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

{nexforge_cli-0.2.6 → nexforge_cli-0.2.7}/src/nexforge/config.py

@@ -83,6 +83,8 @@ class UIConfig(BaseModel):
     mode: Literal["review", "auto"] = "review"
     plan_mode: bool = False  # /plan 切换
     json_mode: bool = False  # /json 开关,强制 JSON 输出
+    goal_mode: bool = False  # /goal 切换,目标驱动自动循环
+    ops_mode: bool = False  # /ops 切换,运维模式
     accent: str = "#6D5EF5"
     accent2: str = "#22D3EE"
 

nexforge_cli-0.2.7/src/nexforge/stats/heartbeat.py

@@ -0,0 +1,58 @@
+"""软件在线统计心跳:每60秒POST一次到云端API。"""
+
+from __future__ import annotations
+
+import json
+import os
+import threading
+import time
+import uuid
+from pathlib import Path
+
+import httpx
+
+SOFTWARE_NAME = "NexForgeCLI"
+STATS_URL = "https://nextech.club/api/stats.php?action=heartbeat"
+
+_client_id: str | None = None
+
+
+def _get_client_id() -> str:
+    global _client_id
+    if _client_id:
+        return _client_id
+    path = Path.home() / ".nexforge" / "client_id"
+    path.parent.mkdir(parents=True, exist_ok=True)
+    if path.exists():
+        _client_id = path.read_text().strip()
+    else:
+        _client_id = str(uuid.uuid4())
+        path.write_text(_client_id)
+    return _client_id
+
+
+def start_heartbeat() -> None:
+    """启动后台心跳线程(不阻塞主流程)。"""
+    cid = _get_client_id()
+
+    def _loop() -> None:
+        while True:
+            try:
+                resp = httpx.post(
+                    STATS_URL,
+                    json={"software": SOFTWARE_NAME, "client_id": cid},
+                    timeout=5,
+                )
+                if resp.status_code == 200:
+                    data = resp.json()
+                    if data.get("ok"):
+                        total = data.get("online_total", "?")
+                        # 静默成功,只在开发模式打印
+                        if os.environ.get("NEXFORGE_DEV"):
+                            print(f"[stats] 心跳成功: {total} 在线")
+            except Exception:
+                pass  # 静默失败,不打扰用户
+            time.sleep(60)
+
+    t = threading.Thread(target=_loop, daemon=True)
+    t.start()

{nexforge_cli-0.2.6 → nexforge_cli-0.2.7}/src/nexforge/store/session_store.py

@@ -62,7 +62,7 @@ def _format_message(msg: dict) -> str:
     tool_calls = msg.get("tool_calls")
 
     if role == "system":
-        return f"> ℹ {content}\n"
+        return ""  # 系统消息不回显在会话中
     if role == "user":
         return f"### ❯ 用户\n\n{content}\n"
     if role == "assistant":
@@ -86,21 +86,52 @@ def _format_message(msg: dict) -> str:
 
 
 def save_session(session_id: str, name: str, messages: list[dict]) -> Path:
-    """把消息列表写成 MD 文件,返回文件路径。"""
-    target = _today_dir() / f"{session_id}.md"
-    lines = [
-        f"# {name}",
-        f"",
-        f"> 创建 {datetime.now(timezone.utc).strftime('%Y-%m-%d %H:%M UTC')}",
-        f"> 项目 `{_project_name()}`",
-        f"",
-        "---",
-        "",
-    ]
-    for msg in messages:
-        lines.append(_format_message(msg))
-    target.write_text("\n".join(lines), encoding="utf-8")
-    return target
+    """把消息列表写成 MD 文件(200行/文件,过滤系统消息),返回第一段路径。"""
+    # 过滤系统消息
+    visible = [m for m in messages if m.get("role") != "system"]
+    MAX_LINES = 200
+
+    def _write_segment(seq: int, msgs: list[dict]) -> Path:
+        suffix = f"-{seq}" if seq > 1 else ""
+        target = _today_dir() / f"{session_id}{suffix}.md"
+        ts = datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
+        hdr = [
+            f"# {name}",
+            f"",
+            f"> 创建 {ts}",
+            f"> 项目 `{_project_name()}`",
+            f"",
+            "---",
+            "",
+        ]
+        body: list[str] = []
+        for m in msgs:
+            body.append(_format_message(m))
+        # 按 MAX_LINES 切割:header算8行
+        header_lines = 8
+        all_lines = hdr + body
+        if len(all_lines) > MAX_LINES:
+            # 取前 MAX_LINES 行写入,剩余放到下一个 segment
+            chunk = all_lines[:MAX_LINES]
+            target.write_text("\n".join(chunk), encoding="utf-8")
+        else:
+            target.write_text("\n".join(all_lines), encoding="utf-8")
+        return target
+
+    # 估算每段能装多少条消息(保守估计:每条消息约4行)
+    per_segment = MAX_LINES // 4
+    first_path: Path | None = None
+    seq = 1
+    i = 0
+    while i < len(visible):
+        chunk = visible[i:i + per_segment]
+        path = _write_segment(seq, chunk)
+        if first_path is None:
+            first_path = path
+        seq += 1
+        i += per_segment
+
+    return first_path or (_today_dir() / f"{session_id}.md")
 
 
 def load_session(path: Path) -> list[dict] | None:

{nexforge_cli-0.2.6 → nexforge_cli-0.2.7}/src/nexforge/ui/screens/chat.py

@@ -24,7 +24,7 @@ from nexforge.ui.widgets.banner import Banner
 from nexforge.ui.widgets.apikey_modal import ApiKeyModal
 from nexforge.ui.widgets.confirm_modal import ConfirmModal
 from nexforge.ui.widgets.diff_modal import DiffApprovalModal
-from nexforge.ui.widgets.mode_warning import ModeWarningModal
+from nexforge.ui.widgets.mode_warning import ModeWarningModal, GoalModeModal, OpsModeModal
 from nexforge.ui.widgets.multiline_modal import MultilineInputModal
 from nexforge.ui.widgets.messages import (
     AssistantTurn,
@@ -61,6 +61,8 @@ HELP = """\
   /clear             清空当前会话
   /quit              退出
   /web start|stop     Web 管理面板
+  /goal              开启目标模式(自动循环直到达成目标)
+  /ops               开启运维模式(记录工具、减少试错)
 快捷键:Esc 退出(确认) · Ctrl+L 清屏 · F1 帮助"""
 
 
@@ -153,8 +155,9 @@ class ChatScreen(Screen):
         self._auto_resume()
         # 自动查询余额
         self._auto_fetch_balance()
-
-    # ---- 输入处理 ---------------------------------------------------------
+        # 在线统计心跳
+        from nexforge.stats.heartbeat import start_heartbeat
+        start_heartbeat()
 
     async def on_multiline_prompt_prompt_submitted(self, event: MultilinePrompt.PromptSubmitted) -> None:
         text = event.text.strip()
@@ -197,6 +200,28 @@ class ChatScreen(Screen):
             except ProviderError as exc:
                 self._note(str(exc), error=True)
             return
+        elif cmd == "goal":
+            def _on_goal_confirm(result: bool) -> None:
+                if result:
+                    self.config.ui.goal_mode = True
+                    self._refresh_status()
+                    self._note("🎯 目标模式已开启:AI 将自动循环执行直到目标达成。Esc 可停止。", scroll=True)
+                else:
+                    self._note("已取消")
+            self.app.push_screen(GoalModeModal(), callback=_on_goal_confirm)
+        elif cmd == "ops":
+            def _on_ops_confirm(result: bool) -> None:
+                if result:
+                    self.config.ui.ops_mode = True
+                    self._refresh_status()
+                    self.session.messages.insert(1, {"role": "system", "content": (
+                        "[运维模式] 你在为系统/网站做运维。优先使用已成功的工具和命令;"
+                        "对相似任务复用已验证的方案;记录每次操作的结果。"
+                    )})
+                    self._note("🔧 运维模式已开启:工具调用将记录日志,优先复用已验证方案。", scroll=True)
+                else:
+                    self._note("已取消")
+            self.app.push_screen(OpsModeModal(), callback=_on_ops_confirm)
         elif cmd == "quit" or cmd == "exit":
             self.app.exit()
         elif cmd == "clear":
@@ -370,6 +395,9 @@ class ChatScreen(Screen):
                     await self._mount(SystemNote("── 本轮结束 · F4 复制最后回复"))
                     log = self._log
                     self.set_timer(0.05, lambda: log.scroll_end(animate=False))
+                    # 目标模式:自动发起下一轮
+                    if self.config.ui.goal_mode and self.agent is not None:
+                        self._run_agent("请继续执行目标,直到达成。如已达成请明确说明。")
                 elif ev.kind is AgentEventKind.ERROR:
                     await self._mount(SystemNote(ev.text, error=True))
         finally:
@@ -458,6 +486,8 @@ class ChatScreen(Screen):
             plan_mode=self.config.ui.plan_mode,
             perm=self.config.permissions.profile,
             mode=self.config.ui.mode,
+            goal_mode=self.config.ui.goal_mode,
+            ops_mode=self.config.ui.ops_mode,
             balance=getattr(self, "_balance", ""),
             working=self._agent_running,
         )
@@ -732,6 +762,10 @@ class ChatScreen(Screen):
             self._auto_save()
         self.session = Session()
         self.session.messages = msgs
+        # 如果加载的消息缺少 system prompt,补上
+        if not msgs or msgs[0].get("role") != "system":
+            from nexforge.core.session import DEFAULT_SYSTEM
+            msgs.insert(0, {"role": "system", "content": DEFAULT_SYSTEM})
         self._session_id = info.id
         self._session_name = info.name
         self._follow = True
@@ -810,6 +844,10 @@ class ChatScreen(Screen):
             self._session_name = latest.name
             return
         self.session.messages = msgs
+        # 如果加载的消息缺少 system prompt,补上
+        if not msgs or msgs[0].get("role") != "system":
+            from nexforge.core.session import DEFAULT_SYSTEM
+            msgs.insert(0, {"role": "system", "content": DEFAULT_SYSTEM})
         self._session_id = latest.id
         self._session_name = latest.name
         # 渲染历史

{nexforge_cli-0.2.6 → nexforge_cli-0.2.7}/src/nexforge/ui/widgets/messages.py

@@ -96,7 +96,8 @@ class AssistantTurn(Vertical):
             panel.display = True
         if self._body is None:
             self._body = self.query_one("#reasoning-body", Static)
-        self._body.update(self._reasoning)
+        from rich.markup import escape as rich_escape
+        self._body.update(rich_escape(self._reasoning))
         # 思考面板的 Contents 有 overflow-y:auto,每次更新后滚到底
         try:
             contents = panel.query_one("Contents")

nexforge_cli-0.2.7/src/nexforge/ui/widgets/mode_warning.py

@@ -0,0 +1,120 @@
+"""警告模态:切换全自动模式前的确认弹窗。"""
+
+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)
+
+
+class GoalModeModal(ModalScreen[bool]):
+
+    DEFAULT_CSS = """
+    GoalModeModal { align: center middle; }
+    GoalModeModal > Vertical {
+        width: 60; background: #1a1a24; border: round #E63946;
+        padding: 1 2;
+    }
+    """
+
+    def compose(self) -> ComposeResult:
+        with Vertical():
+            yield Label(
+                "🎯 目标模式\n\n"
+                "该模式会让 AI 自主循环执行,直到判断目标达成或 token 耗尽。\n\n"
+                "[red]⚠ 风险提示:[/]\n"
+                "- AI 将自动连续执行多个工具调用,可能消耗大量 token\n"
+                "- 可能修改大量文件,请确保代码已提交 Git\n"
+                "- 中途可按 Esc 强制停止\n\n"
+                "确定要开启目标模式吗?",
+            )
+            with Vertical(id="goal-buttons"):
+                yield Button("确认开启(我已了解风险)", variant="error", id="btn-goal-yes")
+                yield Button("取消", id="btn-goal-no")
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "btn-goal-yes":
+            self.dismiss(True)
+        else:
+            self.dismiss(False)
+
+
+class OpsModeModal(ModalScreen[bool]):
+
+    DEFAULT_CSS = """
+    OpsModeModal { align: center middle; }
+    OpsModeModal > Vertical {
+        width: 60; background: #1a1a24; border: round #22D3EE;
+        padding: 1 2;
+    }
+    """
+
+    def compose(self) -> ComposeResult:
+        with Vertical():
+            yield Label(
+                "🔧 运维模式\n\n"
+                "该模式为网站/系统运维优化:\n\n"
+                "- 记录所有工具调用和结果到运维日志\n"
+                "- 优先使用已验证的工具和命令,减少试错\n"
+                "- 自动记录常用操作模式,提升效率\n\n"
+                "开启后状态栏显示 🔧 运维模式",
+            )
+            with Vertical(id="ops-buttons"):
+                yield Button("开启运维模式", variant="primary", id="btn-ops-yes")
+                yield Button("取消", id="btn-ops-no")
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "btn-ops-yes":
+            self.dismiss(True)
+        else:
+            self.dismiss(False)

{nexforge_cli-0.2.6 → nexforge_cli-0.2.7}/src/nexforge/ui/widgets/statusbar.py

@@ -24,6 +24,8 @@ class StatusBar(Static):
         balance: str = "",
         working: bool = False,
         mode: str = "review",
+        goal_mode: bool = False,
+        ops_mode: bool = False,
     ) -> None:
         t = Text()
 
@@ -42,6 +44,10 @@ class StatusBar(Static):
         # 计划
         if plan_mode:
             t.append("  📋 计划中", style="#22D3EE bold")
+        if goal_mode:
+            t.append("  🎯 目标", style="#E63946 bold")
+        if ops_mode:
+            t.append("  🔧 运维", style="#22D3EE bold")
 
         # 余额(人民币)
         if balance:

nexforge_cli-0.2.6/src/nexforge/ui/widgets/mode_warning.py

@@ -1,57 +0,0 @@
-"""警告模态:切换全自动模式前的确认弹窗。"""
-
-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)