nexforge-cli 0.2.13__tar.gz → 0.2.14__tar.gz

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: nexforge-cli
-Version: 0.2.13
+Version: 0.2.14
 Summary: NexForgeCLI — 一个面向 DeepSeek V4 的终端智能体(TUI + CLI 双模式)
 Project-URL: Homepage, https://gitee.com/Lighthorn/nexforgecli
 Author: NexForge
@@ -51,7 +51,7 @@ Description-Content-Type: text/markdown
 
 NexForgeCLI 是一个运行在终端里的智能体助手，既支持 DeepSeek/千问等多模型，也是**插件宿主**（plugins 目录即插即用）。既能作为全屏 TUI 交互式对话/编码，也能作为 one-shot 命令行工具嵌进脚本和管道。
 
-> 当前版本:**v0.2.11** · PyPI: `pip install nexforge-cli`
+> 当前版本:**v0.2.14** · PyPI: `pip install nexforge-cli`
 
 ---
 

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/README.md

@@ -8,7 +8,7 @@
 
 NexForgeCLI 是一个运行在终端里的智能体助手，既支持 DeepSeek/千问等多模型，也是**插件宿主**（plugins 目录即插即用）。既能作为全屏 TUI 交互式对话/编码，也能作为 one-shot 命令行工具嵌进脚本和管道。
 
-> 当前版本:**v0.2.11** · PyPI: `pip install nexforge-cli`
+> 当前版本:**v0.2.14** · PyPI: `pip install nexforge-cli`
 
 ---
 

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/manual/01-/345/256/211/350/243/205/344/270/216/351/205/215/347/275/256.md

@@ -1,6 +1,6 @@
 # 安装与配置
 
-> NexForgeCLI v0.2.13
+> NexForgeCLI v0.2.14
 
 ## 环境要求
 
@@ -72,6 +72,8 @@ API Key 保存在 `~/.nexforge/auth.toml`，不会被 Git 追踪。
 pip install --upgrade nexforge-cli
 ```
 
+启动 nf 时会自动检查 PyPI 最新版本（24 小时缓存一次，失败静默），若有新版本会在界面提示升级命令。
+
 ## 卸载
 
 ```bash

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/manual/03-/346/250/241/345/236/213/351/205/215/347/275/256.md

@@ -125,6 +125,27 @@ models = ["claude-sonnet-4-20250514"]
 
 切换后自动持久化，重启 nf 保持选中。
 
+### 动态模型列表（千问 / OpenAI 兼容）
+
+大模型更新太快，`models.toml` 里手写的模型名可能过时。对 **千问** 和 **OpenAI 兼容**（`type = "openai"`）provider，F6 侧边栏会：
+
+- 自动调用该平台的 `/models` 接口，拉取当前 API Key 下**实际可用**的模型列表
+- 拉取结果缓存 24 小时，失败时回退 `models.toml` 里写的静态列表
+- 每个模型名都是一个可点击按钮，直接点选切换具体模型（当前使用的模型标绿点 ●）
+
+```
+│ ● qianwen  ✓            │
+│   类型: qianwen          │
+│   ● qwen3.8-max          │  ← 当前使用
+│     qwen-vision-plus     │  ← 动态拉取到的新模型, 点选即切换
+│     qwen-long            │
+│   [🔄 刷新模型]          │  ← 强制重新拉取最新列表
+```
+
+点「🔄 刷新模型」可强制清缓存重新拉取（比如平台刚上线了新模型）。
+
+**选择持久化**：点选的具体模型记录到 `~/.nexforge/model_selection.json`（独立于只读的 `models.toml`，不污染配置），重启 nf 保持选中。
+
 ## 自动路由 vs 多模型切换
 
 - **自动路由**（DeepSeek auto 档）：同一个模型内，根据任务复杂度自动选择 flash 或 pro

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/manual/04-/345/267/245/345/205/267/345/217/202/350/200/203.md

@@ -87,7 +87,7 @@ NexForgeCLI 内置 **35 个工具**供 AI 调用（`git_commit` 需在 config.to
 
 | 限制 | 值 | 说明 |
 |------|-----|------|
-| 工具调用轮数 | 200 | 防死循环 |
+| 工具调用轮数 | 300(目标模式 500) | 防死循环; 单轮内连续调工具上限, 目标模式自动放大 |
 | 单轮总超时 | 0 秒(不限额) | 默认不限额; 可 /timeout <秒> 或 config.toml 的 `turn_timeout` 设置 |
 | 单工具超时 | 60 秒 | |
 

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/manual/08-/350/207/252/345/256/232/344/271/211/351/205/215/347/275/256.md

@@ -59,6 +59,7 @@ model = "qwen-audio-3.0-tts-flash"  # 千问 TTS 模型
 voice = "loongmary"             # 音色(flash 用 loong 系列: loongmary/loongeva/loongJohn 等)
 engine = "auto"                 # auto | qianwen | local
 max_chars = 100                 # 简报最大字符数
+enabled = true                  # 语音播报总开关
 
 [search]
 engine = "bing"              # bing | duckduckgo | google | searxng

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/manual/10-/346/217/222/344/273/266/345/274/200/345/217/221.md

@@ -70,9 +70,9 @@ def register(api):
 
 `~/.nexforge/plugins/speech_summary.py`（已随本机安装）——每轮任务结束用 TTS 播报简报：
 
-- **引擎**：千问语音合成（qwen-audio-3.0-tts-plus，官方 dashscope SDK WebSocket 方式）优先，失败自动回退 Windows 本地语音（SAPI）
+- **引擎**：千问语音合成（qwen-audio-3.0-tts-flash，官方 dashscope SDK WebSocket 方式）优先，失败自动回退 Windows 本地语音（SAPI）
 - **配置**（config.toml `[tts]` 段）：`engine=auto|qianwen|local`、`voice`、`api_key`（留空用 [image] 按量 key）、`ws_url`、`max_chars`、`enabled`
 - **不阻塞**：合成+播放在后台线程，回合结束流程零延迟
 - **简报内容**：项目名 + 工具调用次数 + AI 最终总结摘要（自动清理 Markdown 符号）
 
-> 千问 TTS 使用条件：① `pip install dashscope`；② 平台控制台**开通 qwen-audio-3.0-tts-plus 按量服务**（¥1.4/万字符，Token Plan 套餐不含）。未满足时自动回退本地语音，不打断工作。
+> 千问 TTS 使用条件：① `pip install dashscope`；② 平台控制台**开通 qwen-audio-3.0-tts-flash 按量服务**（¥1.4/万字符，Token Plan 套餐不含）。未满足时自动回退本地语音，不打断工作。

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/manual/README.md

@@ -1,4 +1,4 @@
-# NexForgeCLI 用户手册 · v0.2.13
+# NexForgeCLI 用户手册 · v0.2.14
 
 ## 这是什么
 

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/pyproject.toml

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

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/src/nexforge/__init__.py

@@ -3,5 +3,5 @@
 TUI(全屏交互)+ CLI(one-shot / 管道)双模式。
 """
 
-__version__ = "0.2.13"
+__version__ = "0.2.14"
 __all__ = ["__version__"]

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/src/nexforge/app.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import os
 import sys
 from pathlib import Path
 from typing import TYPE_CHECKING
@@ -53,10 +54,39 @@ class NexForgeApp(App):
         return ChatScreen(config=self._config, resume_session_id=None)
 
 
+def _mouse_enabled() -> bool:
+    """决定是否启用鼠标追踪(Textual 的 app.run(mouse=...))。
+
+    Windows 老式控制台(conhost)下, Textual 会开启鼠标追踪
+    (ESC[?1003h 任意事件 + ESC[?1006h SGR 模式), 鼠标一移动就产生海量转义序列。
+    长时间搁置/窗口失焦恢复后, 积压的鼠标事件会淹没输入处理导致假死,
+    且若退出时终端状态未正确恢复, 这些序列会泄漏到命令行(表现为
+    动鼠标就刷出一堆 [555;78;27M 之类的字符)。
+
+    判定规则(优先级从高到低):
+    1. 环境变量 NEXFORGE_MOUSE=1/0 跨平台强制覆盖(逃生舱);
+    2. 非 Windows → 始终开鼠标;
+    3. Windows 下仅"纯老式 conhost"(无 ConPTY 标记)禁用鼠标。
+       Windows Terminal 设 WT_SESSION, VS Code 集成终端设 TERM_PROGRAM=vscode,
+       二者基于 ConPTY(VT 支持完善), 保留鼠标;
+       老式 cmd/PowerShell 窗口两者皆无 → 禁用, 避免搁置后鼠标序列泄漏。
+    """
+    env = os.environ.get("NEXFORGE_MOUSE")
+    if env is not None:
+        return env.strip().lower() in ("1", "true", "yes", "on")
+    if sys.platform != "win32":
+        return True
+    if os.environ.get("WT_SESSION"):
+        return True
+    if os.environ.get("TERM_PROGRAM", "").lower() == "vscode":
+        return True
+    return False
+
+
 def run_tui(config: "NexForgeConfig", *, resume: bool = False) -> int:
     app = NexForgeApp(config, resume=resume)
     try:
-        app.run()
+        app.run(mouse=_mouse_enabled())
     except KeyboardInterrupt:
         return 0
     return 0

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/src/nexforge/config.py

@@ -114,7 +114,7 @@ class UIConfig(BaseModel):
 
 class ToolsConfig(BaseModel):
     enable_git_commit: bool = False
-    max_tool_iters: int = 200  # 工具轮数安全上限(防死循环)
+    max_tool_iters: int = 300  # 工具轮数安全上限(防死循环); 目标模式自动放大到 500
     turn_timeout: int = 0  # 单轮总超时(秒); 0=不限额(用户按需设置)
     tool_timeout: int = 60    # 单个工具超时(秒)
 
@@ -275,6 +275,15 @@ def load_config(path: Path | None = None) -> NexForgeConfig:
                             cfg.providers[name] = ProviderDef(**entry)
                 except Exception:
                     pass
+        # 读用户选择的模型(独立于只读 models.toml, 见 core/model_catalog.py)
+        try:
+            from nexforge.core.model_catalog import load_selection
+            selection = load_selection()
+            for sel_name, sel_model in selection.items():
+                if sel_name in cfg.providers and sel_model:
+                    cfg.providers[sel_name].default_model = sel_model
+        except Exception:
+            pass
     # 恢复已验证的 provider 列表(从项目配置的 provider.verified 字段)
     verified_list: list[str] = []
     if path is None:

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/src/nexforge/core/agent.py

@@ -89,7 +89,10 @@ class AgentLoop:
         last_failed: tuple[str, str] = ("", "")
         consecutive_fails = 0
         try:
+            # 工具轮数上限: 目标模式放开到 500(多轮开发), 普通会话 300
             limit = self.config.tools.max_tool_iters
+            if getattr(self.config.ui, "goal_mode", False):
+                limit = max(limit, 500)
             for _ in range(limit):
                 decision = self.router.choose(self.session, user_text, tool_failures)
                 yield AgentEvent(AgentEventKind.ROUTE, route=decision)

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/src/nexforge/core/goal_manager.py

@@ -113,7 +113,7 @@ class GoalManager:
     def read_goal(self) -> str:
         from nexforge.tools._paths import sanitize
         if self.goal_path.exists():
-            return sanitize(self.goal_path.read_text(encoding="utf-8"))
+            return self._strip_md_title(sanitize(self.goal_path.read_text(encoding="utf-8")))
         return ""
 
     def set_plan(self, plan: str) -> None:
@@ -123,9 +123,21 @@ class GoalManager:
     def read_plan(self) -> str:
         from nexforge.tools._paths import sanitize
         if self.plan_path.exists():
-            return sanitize(self.plan_path.read_text(encoding="utf-8"))
+            return self._strip_md_title(sanitize(self.plan_path.read_text(encoding="utf-8")))
         return ""
 
+    @staticmethod
+    def _strip_md_title(content: str) -> str:
+        """去掉 Markdown '# 标题' 首行, 返回纯净正文。
+
+        修复: 之前 read_goal/read_plan 返回含标题前缀的完整文件内容,
+        amend_plan 再 set_goal 会重复累加 '# 目标' 前缀污染文件。
+        """
+        lines = content.split("\n", 1)
+        if len(lines) > 1 and lines[0].startswith("#"):
+            return lines[1].strip()
+        return content.strip()
+
     def save_round(self, num: int, dev_report: str, director_review: str) -> None:
         from nexforge.tools._paths import sanitize
         dev_report = sanitize(dev_report)

nexforge_cli-0.2.14/src/nexforge/core/model_catalog.py

@@ -0,0 +1,114 @@
+"""动态模型目录 —— 拉取 provider 可用模型列表并缓存。
+
+解决"大模型更新太快, 每次都要升级软件才能跟上"的问题:
+- 对 OpenAI 兼容 provider(openai/qianwen) 调用 /models 接口拉取可用模型列表
+- 缓存 24 小时, 失败回退 models.toml 静态列表
+- 用户点选的具体模型持久化到 model_selection.json
+  (独立于只读的 models.toml, 不污染该文件)
+
+数据文件:
+- ``~/.nexforge/model_catalog.json``   — 动态拉取的模型列表缓存
+- ``~/.nexforge/model_selection.json`` — 用户对每个 provider 选择的模型
+"""
+
+from __future__ import annotations
+
+import json
+import time
+from pathlib import Path
+from typing import Any
+
+from nexforge.config import CONFIG_DIR
+
+CATALOG_PATH = CONFIG_DIR / "model_catalog.json"
+SELECTION_PATH = CONFIG_DIR / "model_selection.json"
+CACHE_TTL_SECONDS = 24 * 3600  # 24 小时
+
+
+def _read_json(path: Path) -> dict:
+    try:
+        if path.exists():
+            return json.loads(path.read_text(encoding="utf-8"))
+    except Exception:
+        pass
+    return {}
+
+
+def _write_json(path: Path, data: dict) -> None:
+    try:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(
+            json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8"
+        )
+    except Exception:
+        pass
+
+
+def load_catalog() -> dict:
+    """读动态模型缓存目录。"""
+    return _read_json(CATALOG_PATH)
+
+
+def load_selection() -> dict[str, str]:
+    """读用户模型选择 {provider_name: model_id}。"""
+    return _read_json(SELECTION_PATH)
+
+
+def save_selection(name: str, model: str) -> None:
+    """记录用户对某 provider 选择的模型。"""
+    sel = load_selection()
+    sel[name] = model
+    _write_json(SELECTION_PATH, sel)
+
+
+def get_cached_models(name: str) -> list[str] | None:
+    """返回缓存模型列表; 无缓存或已过期返回 None。"""
+    entry = load_catalog().get(name)
+    if not isinstance(entry, dict):
+        return None
+    fetched_at = entry.get("fetched_at", 0)
+    if time.time() - float(fetched_at) > CACHE_TTL_SECONDS:
+        return None
+    models = entry.get("models")
+    return models if isinstance(models, list) else None
+
+
+def set_cached_models(name: str, models: list[str]) -> None:
+    cat = load_catalog()
+    cat[name] = {"fetched_at": time.time(), "models": list(models)}
+    _write_json(CATALOG_PATH, cat)
+
+
+def clear_cache(name: str | None = None) -> None:
+    """清除动态模型缓存。name 为 None 时清空全部。"""
+    if name is None:
+        _write_json(CATALOG_PATH, {})
+    else:
+        cat = load_catalog()
+        cat.pop(name, None)
+        _write_json(CATALOG_PATH, cat)
+
+
+async def fetch_models(config: Any, name: str, pdef: Any) -> list[str]:
+    """拉取 provider 可用模型列表(带缓存)。
+
+    成功且非空 → 返回动态列表并写缓存;
+    失败或为空 → 回退 pdef.models 静态列表(不写缓存, 允许下次重试)。
+    """
+    cached = get_cached_models(name)
+    if cached:
+        return cached
+
+    dynamic: list[str] = []
+    try:
+        from nexforge.provider import create_provider
+        provider = create_provider(config, name=name)
+        dynamic = await provider.list_models()
+        await provider.aclose()
+    except Exception:
+        dynamic = []
+
+    if dynamic:
+        set_cached_models(name, dynamic)
+        return dynamic
+    return list(pdef.models) if pdef else []

{nexforge_cli-0.2.13 → nexforge_cli-0.2.14}/src/nexforge/core/provider.py

@@ -36,6 +36,14 @@ class BaseProvider(ABC):
         """
         return self.supports_multimodal
 
+    async def list_models(self) -> list[str]:
+        """拉取当前 API key 下可用的模型 ID 列表。
+
+        默认返回空(不支持动态列举的 provider 保持空)。
+        OpenAI 兼容 provider(openai/qianwen)覆写此方法调用 /models 接口。
+        """
+        return []
+
     @abstractmethod
     async def stream(
         self,

nexforge_cli-0.2.14/src/nexforge/core/update_check.py

@@ -0,0 +1,99 @@
+"""PyPI 自升级检查。
+
+启动时异步检查 PyPI 上 nexforge-cli 的最新版本, 若有更新则提示用户。
+设计要点:
+- 24 小时缓存(避免每次启动都请求 PyPI, 且网络失败不阻断启动)
+- 版本比较用标准库实现(点分数字, 忽略 v 前缀与预发布后缀), 不引入 packaging
+- 检查失败静默返回 None(无更新提示)
+"""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from pathlib import Path
+
+from nexforge.config import CONFIG_DIR
+
+PYPI_URL = "https://pypi.org/pypi/nexforge-cli/json"
+CHECK_INTERVAL_SECONDS = 24 * 3600
+_CACHE_PATH = CONFIG_DIR / ".update_check"
+
+
+def compare_versions(a: str, b: str) -> int:
+    """比较两个点分版本号。返回 a>b:1, a<b:-1, a==b:0。
+
+    仅比较数字段(忽略 v 前缀、-rc1/-dev1 等预发布后缀),
+    段数不足按 0 补齐, 避免字符串比较 "0.2.9" > "0.2.13" 的经典错误。
+    """
+    def _parts(v: str) -> list[int]:
+        v = v.strip().lstrip("vV")
+        v = v.split("-")[0].split("+")[0]
+        out: list[int] = []
+        for part in v.split("."):
+            try:
+                out.append(int(part))
+            except ValueError:
+                out.append(0)
+        return out
+
+    pa, pb = _parts(a), _parts(b)
+    n = max(len(pa), len(pb))
+    pa += [0] * (n - len(pa))
+    pb += [0] * (n - len(pb))
+    for x, y in zip(pa, pb):
+        if x != y:
+            return 1 if x > y else -1
+    return 0
+
+
+def _read_cache() -> tuple[float, str] | None:
+    """读缓存, 返回 (上次检查时间戳, 最新版本) 或 None。"""
+    try:
+        if _CACHE_PATH.exists():
+            text = _CACHE_PATH.read_text(encoding="utf-8").strip()
+            ts_str, _, version = text.partition(" ")
+            return float(ts_str), version.strip()
+    except Exception:
+        pass
+    return None
+
+
+def _write_cache(version: str) -> None:
+    """写缓存(时间戳 + 最新版本)。失败静默。"""
+    try:
+        _CACHE_PATH.parent.mkdir(parents=True, exist_ok=True)
+        ts = datetime.now(timezone.utc).timestamp()
+        _CACHE_PATH.write_text(f"{ts} {version}\n", encoding="utf-8")
+    except Exception:
+        pass
+
+
+async def check_update(current_version: str) -> str | None:
+    """检查是否有新版本。
+
+    返回最新版本号(若有更新)或 None(无更新 / 网络失败 / 缓存未过期)。
+    """
+    import time
+
+    # 24 小时内已检查 → 用缓存结果
+    cached = _read_cache()
+    if cached:
+        ts, version = cached
+        if time.time() - ts < CHECK_INTERVAL_SECONDS:
+            return version if compare_versions(version, current_version) > 0 else None
+
+    # 请求 PyPI JSON API
+    try:
+        import httpx
+        async with httpx.AsyncClient(timeout=8) as client:
+            resp = await client.get(PYPI_URL)
+            resp.raise_for_status()
+            data = resp.json()
+            latest = str(data.get("info", {}).get("version", "")).strip()
+    except Exception:
+        return None  # 网络失败静默
+
+    if not latest:
+        return None
+    _write_cache(latest)
+    return latest if compare_versions(latest, current_version) > 0 else None