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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: nexforge-cli
-Version: 0.2.14
+Version: 0.2.15
 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.14** · PyPI: `pip install nexforge-cli`
+> 当前版本:**v0.2.15** · PyPI: `pip install nexforge-cli`
 
 ---
 

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

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

{nexforge_cli-0.2.14 → nexforge_cli-0.2.15}/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.14
+> NexForgeCLI v0.2.15
 
 ## 环境要求
 

{nexforge_cli-0.2.14 → nexforge_cli-0.2.15}/manual/02-/347/225/214/351/235/242/344/270/216/345/277/253/346/215/267/351/224/256.md

@@ -9,10 +9,10 @@
 │  [用户消息]                                              │
 │  [AI 回复 · 思考面板(可折叠) · 工具调用卡片]           │
 │                                                          │
-│  ── 本轮结束 · F4 复制最后回复                          │
+│  ── 本轮结束 · Ctrl+C 复制最后回复                          │
 ├── 输入区 ────────────────────────────────────────────────┤
 │ > 请输入…                                                │
-│ F1帮助 · F2模式 · F3编辑器 · F5会话 · F6模型 · F10快捷回复│
+│ F1帮助 · F2模式 · F3编辑 · F4文件 · F5会话 · F6模型 · F10快捷回复│
 ├── 状态栏 ────────────────────────────────────────────────┤
 │ 🔥 全自动 · deepseek · flash · 思考:开 · 8k token · ¥0.00│
 └──────────────────────────────────────────────────────────┘
@@ -43,19 +43,35 @@
 | `F1` | 帮助 |
 | `F2` | 切换审批模式(审批/半自动/全自动) |
 | `F3` | 系统默认编辑器编辑文本 |
-| `F4` | 复制最后一条 AI 回复 |
+| `F4` | 文件浏览器侧边栏(点击引用/右键编辑) |
 | `F5` | 会话侧边栏(切换/重命名/删除) |
 | `F6` | 模型选择侧边栏 |
 | `F7` | 切换运维模式 |
 | `F8` | 切换目标模式(总监循环) |
 | `F9` | 粘贴截图 |
 | `F10` | 激活快捷回复 |
-| `Ctrl+C` | 复制最后 AI 回复(备选键) |
+| `Ctrl+C` | 复制最后 AI 回复 |
 | `Ctrl+L` | 清屏 |
 | `↑/↓` | 滚动对话 |
 | `PageUp/PageDown` | 上下翻页 |
 | `End` | 滚到底部 |
 
+## 文件浏览器
+
+按 `F4` 打开右侧文件浏览器。打开后**直接显示项目根下的文件与目录**(树形,自动隐藏 `.git`、`__pycache__`、`.nexforge` 等噪音目录):
+
+| 操作 | 效果 |
+|------|------|
+| 点击文件 | 引用文件路径到输入框,可继续输入指令 |
+| 点击目录 | 展开/折叠该目录 |
+| 右键文件 | 弹出操作菜单(引用路径 / 打开编辑 / 复制路径 / 复制内容) |
+| 右键目录 | 弹出操作菜单(引用目录路径 / 在系统文件管理器中打开 / 复制路径) |
+
+- **引用**：把文件/目录路径(项目根内为相对路径)插入输入框,聚焦后可直接补充"分析这个文件"之类指令
+- **打开编辑**：文件用系统默认程序打开(Windows 记事本/关联程序、macOS `open`、Linux `xdg-open`)；目录则在系统文件管理器中打开
+- **复制内容**：复制文件文本内容到剪贴板(超过 512KB 拒绝,防止卡顿)
+- 键盘：F4 打开后焦点即在文件树,`↑/↓` 移动、`→` 展开、`Enter` 引用选中项、`Esc` 关闭并回输入框
+
 ## 斜杠命令
 
 **模型与账户**

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

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

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

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

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

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

{nexforge_cli-0.2.14 → nexforge_cli-0.2.15}/src/nexforge/i18n.py

@@ -50,8 +50,8 @@ def t(key: str, **fmt: str) -> str:
 MESSAGES: dict[str, dict[str, str]] = {
     # ---- 底部提示行 --------------------------------------------------------
     "ui.prompt_hint": {
-        "zh": "F1帮助 · F2模式 · F3编辑 · F4复制 · F5会话 · F6模型 · F7运维 · F8目标 · F9粘贴截图 · F10快捷回复 · Ctrl+L清屏 · Esc退出 · Enter发送",
-        "en": "F1 help · F2 mode · F3 editor · F4 copy · F5 sessions · F6 models · F7 ops · F8 goal · F9 paste image · F10 quick reply · Ctrl+L clear · Esc quit · Enter send",
+        "zh": "F1帮助 · F2模式 · F3编辑 · F4文件 · F5会话 · F6模型 · F7运维 · F8目标 · F9粘贴截图 · F10快捷回复 · Ctrl+L清屏 · Esc退出 · Enter发送",
+        "en": "F1 help · F2 mode · F3 editor · F4 files · F5 sessions · F6 models · F7 ops · F8 goal · F9 paste image · F10 quick reply · Ctrl+L clear · Esc quit · Enter send",
     },
     "ui.banner_sub": {
         "zh": "多模型终端智能体",
@@ -178,6 +178,14 @@ MESSAGES: dict[str, dict[str, str]] = {
     "note.lang_switched": {"zh": "界面语言已切换", "en": "UI language switched"},
     "note.copied_last": {"zh": "已复制最后一条 AI 回复。", "en": "Copied the last AI reply."},
     "note.no_reply": {"zh": "暂无 AI 回复。", "en": "No AI reply yet."},
+    "note.file_referenced": {"zh": "已引用 {path}", "en": "Referenced {path}"},
+    "note.file_opened": {"zh": "已打开 {path}", "en": "Opened {path}"},
+    "note.file_open_fail": {"zh": "打开失败: {exc}", "en": "Open failed: {exc}"},
+    "note.file_path_copied": {"zh": "路径已复制", "en": "Path copied"},
+    "note.file_content_copied": {"zh": "内容已复制", "en": "Content copied"},
+    "note.file_too_large": {"zh": "文件过大(>512KB), 未复制", "en": "File too large (>512KB), not copied"},
+    "note.file_read_fail": {"zh": "读取失败: {exc}", "en": "Read failed: {exc}"},
+    "note.copy_fail": {"zh": "复制失败(剪贴板不可用)", "en": "Copy failed (clipboard unavailable)"},
     "note.qr_not_set": {"zh": "未设置快捷回复。请先 /qr <文本>", "en": "Quick reply not set. Use /qr <text> first"},
     "note.qr_activated": {"zh": "快捷回复已激活({n}次): {txt}", "en": "Quick reply activated ({n}x): {txt}"},
     "note.director_stopped": {
@@ -187,7 +195,7 @@ MESSAGES: dict[str, dict[str, str]] = {
     "note.task_stopped": {"zh": "⏹ 已停止当前 AI 任务。", "en": "⏹ Current AI task stopped."},
     "note.turn_timeout": {"zh": "⏱ 单轮执行超时({n}秒),已中断。可调整 config.toml 的 turn_timeout。", "en": "⏱ Turn timeout ({n}s) reached, interrupted. Adjust turn_timeout in config.toml."},
     "note.output_truncated": {"zh": "✂️ 输出达到长度上限被截断, 输入\"继续\"可续写 (可调大 config.toml 的 max_output_tokens)", "en": "✂️ Output truncated by length limit. Type \"continue\" to resume (raise max_output_tokens in config.toml)."},
-    "note.turn_done": {"zh": "── 本轮结束 · F4 复制最后回复", "en": "── Turn done · F4 to copy last reply"},
+    "note.turn_done": {"zh": "── 本轮结束 · Ctrl+C 复制最后回复", "en": "── Turn done · Ctrl+C to copy last reply"},
     "note.quick_reply_remaining": {"zh": "📨 快捷回复({n}次剩余): {txt}", "en": "📨 Quick reply ({n} left): {txt}"},
     "note.verifying_provider": {"zh": "正在验证 {name}...", "en": "Verifying {name}..."},
     "note.verifying_all": {"zh": "正在验证所有 provider...", "en": "Verifying all providers..."},
@@ -316,6 +324,15 @@ MESSAGES: dict[str, dict[str, str]] = {
     "img.clear": {"zh": "✖ 清空全部", "en": "✖ Clear all"},
     "img.empty": {"zh": "(无截图)", "en": "(no images)"},
 
+    # ---- 文件浏览器 ---------------------------------------------------------
+    "filebrowser.title": {"zh": "📂 文件浏览", "en": "📂 Files"},
+    "filebrowser.hint": {"zh": "点击文件=引用 · 右键=操作 · 点目录=展开", "en": "Click file=reference · Right-click=actions · Click dir=expand"},
+    "filebrowser.menu.title": {"zh": "文件操作", "en": "File actions"},
+    "filebrowser.menu.ref": {"zh": "引用路径到输入框", "en": "Reference path to prompt"},
+    "filebrowser.menu.edit": {"zh": "打开(系统程序)", "en": "Open with system app"},
+    "filebrowser.menu.copy_path": {"zh": "复制路径", "en": "Copy path"},
+    "filebrowser.menu.copy_content": {"zh": "复制文件内容", "en": "Copy file content"},
+
     # ---- 消息组件 ---------------------------------------------------------
     "msg.director_review": {"zh": "◆ 项目总监 · 审核意见", "en": "◆ Director · Review"},
     "msg.director_label": {"zh": "◆ 项目总监: ", "en": "◆ Director: "},

{nexforge_cli-0.2.14 → nexforge_cli-0.2.15}/src/nexforge/ui/screens/chat.py

@@ -9,11 +9,11 @@ from __future__ import annotations
 import asyncio
 from pathlib import Path
 
-from textual import work
+from textual import on, work
 from textual.app import ComposeResult
 from textual.containers import Horizontal, Vertical, VerticalScroll
 from textual.screen import Screen
-from textual.widgets import Button, Label, Static
+from textual.widgets import Button, DirectoryTree, Label, Static
 from nexforge.ui.widgets.multiline_prompt import MultilinePrompt
 
 from nexforge.config import NexForgeConfig
@@ -40,6 +40,8 @@ from nexforge.ui.widgets.sidebar import Sidebar
 from nexforge.ui.widgets.plan_sidebar import PlanSidebar
 from nexforge.ui.widgets.model_sidebar import ModelSidebar
 from nexforge.ui.widgets.image_sidebar import ImageSidebar
+from nexforge.ui.widgets.file_browser import FileBrowser, FileBrowserTree
+from nexforge.ui.widgets.file_menu import FileMenuModal
 from nexforge.skills.loader import Skill, discover_skills, skill_index_str
 from nexforge.store.session_store import _next_id, list_sessions, save_session
 import nexforge.store.plan_store as plan_store
@@ -58,8 +60,8 @@ class ChatScreen(ChatActionsMixin, Screen):
         ("f10", "quick_reply", "快捷回复"),
         ("f1", "show_help", "帮助"),
         ("f3", "external_edit", "编辑器"),
-        ("f4", "copy_last", "复制"),
-        ("ctrl+c", "copy_last", "复制备选"),
+        ("f4", "toggle_file_browser", "文件"),
+        ("ctrl+c", "copy_last", "复制"),
         ("pageup", "scroll_up", "上滚"),
         ("pagedown", "scroll_down", "下滚"),
         ("up", "line_up", "上一行"),
@@ -82,6 +84,7 @@ class ChatScreen(ChatActionsMixin, Screen):
         self._plan_sidebar: PlanSidebar | None = None
         self._model_sidebar: ModelSidebar | None = None
         self._image_sidebar: ImageSidebar | None = None
+        self._file_browser: FileBrowser | None = None
         self._balance: str = ""
         self._session_id: str = ""
         self._session_name: str = ""
@@ -139,10 +142,13 @@ class ChatScreen(ChatActionsMixin, Screen):
             yield self._model_sidebar
             self._image_sidebar = ImageSidebar(id="image-sidebar")
             yield self._image_sidebar
+            self._file_browser = FileBrowser(id="file-browser")
+            yield self._file_browser
         self._sidebar.display = False  # 初始隐藏
         self._plan_sidebar.display = False
         self._model_sidebar.display = False
         self._image_sidebar.display = False
+        self._file_browser.display = False
         self._set_dev_log_visible(False)  # 上栏工作区初始隐藏(非目标模式单栏)
 
     async def on_unmount(self) -> None:
@@ -1082,6 +1088,96 @@ class ChatScreen(ChatActionsMixin, Screen):
             self._image_sidebar.clear_all()
             self._image_sidebar.display = False
 
+    # ---- 文件浏览器 -------------------------------------------------------
+
+    @on(FileBrowserTree.FileContextMenu)
+    def _on_file_context_menu(self, event: FileBrowserTree.FileContextMenu) -> None:
+        """右键文件/目录 → 弹操作菜单。"""
+        path = event.path
+        try:
+            is_dir = path.is_dir()
+        except OSError:
+            is_dir = False
+        self.app.push_screen(
+            FileMenuModal(str(path), is_dir=is_dir),
+            callback=lambda action: self._handle_file_action(action, path),
+        )
+
+    @on(DirectoryTree.FileSelected)
+    def _on_file_selected(self, event: DirectoryTree.FileSelected) -> None:
+        """左键文件 → 引用路径到输入框。"""
+        self._reference_file(event.path)
+
+    def _handle_file_action(self, action: str | None, path: Path) -> None:
+        if action is None:
+            return
+        if action == "ref":
+            self._reference_file(path)
+        elif action == "edit":
+            self._open_file(path)
+        elif action == "copy_path":
+            self._copy_text(str(path), t("note.file_path_copied"))
+        elif action == "copy_content":
+            self._copy_file_content(path)
+
+    def _reference_file(self, path: Path) -> None:
+        """把文件路径引用到输入框末尾(项目根内用相对路径,否则绝对路径)。
+
+        注意: 用 document.end 指定插入位置 —— TextArea 的 text setter / 光标
+        可能在文档开头, 直接 insert 会把引用插到最前面; 快速引用应追加到末尾。
+        """
+        display = self._rel_path(path)
+        try:
+            prompt = self.query_one("#prompt", MultilinePrompt)
+            sep = "" if not prompt.text or prompt.text.endswith(" ") else " "
+            prompt.insert(sep + display, prompt.document.end)
+            prompt.focus()
+        except Exception:
+            pass
+        self._note(t("note.file_referenced", path=display), scroll=True)
+
+    def _open_file(self, path: Path) -> None:
+        """用系统默认程序打开文件(编辑/查看)。"""
+        import os
+        import subprocess
+        import sys
+        try:
+            if sys.platform == "win32":
+                os.startfile(str(path))  # type: ignore[attr-defined]
+            elif sys.platform == "darwin":
+                subprocess.run(["open", str(path)], check=False)
+            else:
+                subprocess.run(["xdg-open", str(path)], check=False)
+            self._note(t("note.file_opened", path=path.name), scroll=True)
+        except Exception as exc:
+            self._note(t("note.file_open_fail", exc=str(exc)), error=True)
+
+    def _copy_text(self, text: str, ok_note: str) -> None:
+        import pyperclip
+        try:
+            pyperclip.copy(text)
+            self._note(ok_note, scroll=True)
+        except Exception:
+            self._note(t("note.copy_fail"), error=True)
+
+    def _copy_file_content(self, path: Path) -> None:
+        try:
+            if path.stat().st_size > 512 * 1024:
+                self._note(t("note.file_too_large"), error=True)
+                return
+            content = path.read_text(encoding="utf-8", errors="replace")
+            self._copy_text(content, t("note.file_content_copied"))
+        except Exception as exc:
+            self._note(t("note.file_read_fail", exc=str(exc)), error=True)
+
+    def _rel_path(self, path: Path) -> str:
+        from nexforge.core.context import get_project_root
+        try:
+            rel = path.resolve().relative_to(get_project_root().resolve())
+            return str(rel).replace("\\", "/")
+        except (ValueError, OSError):
+            return str(path.resolve()).replace("\\", "/")
+
     # ---- 计划文件操作 ---------------------------------------------------
     # ---- action_* methods moved to ChatActionsMixin (chat_actions.py) ----
 

{nexforge_cli-0.2.14 → nexforge_cli-0.2.15}/src/nexforge/ui/screens/chat_actions.py

@@ -73,6 +73,48 @@ class ChatActionsMixin:
             self._force_reflow()
         self._scroll_to_bottom()
 
+    def action_toggle_file_browser(self) -> None:
+        self: ChatScreen
+        fb = self._file_browser
+        if not fb:
+            return
+        opening = not fb.display
+        fb.display = opening
+        if opening:
+            fb.refresh_tree()
+            # 打开 → 焦点移到文件树: 键盘立即可用(方向键浏览 / Enter 引用)。
+            # 延迟到 reflow 完成后 widget 可见才可 focus。
+            self.call_later(self._focus_file_tree)
+        else:
+            self._focus_prompt()
+        self._force_reflow()
+        self._scroll_to_bottom()
+
+    def action_close_file_browser(self) -> None:
+        """关闭文件浏览器并回输入框(树的 Esc 绑定调用)。"""
+        self: ChatScreen
+        if self._file_browser and self._file_browser.display:
+            self._file_browser.display = False
+            self._force_reflow()
+        self._focus_prompt()
+
+    def _focus_file_tree(self) -> None:
+        self: ChatScreen
+        try:
+            if self._file_browser and self._file_browser.display:
+                tree = self._file_browser.tree
+                if tree is not None:
+                    tree.focus()
+        except Exception:
+            pass
+
+    def _focus_prompt(self) -> None:
+        self: ChatScreen
+        try:
+            self.query_one("#prompt").focus()
+        except Exception:
+            pass
+
     def action_toggle_ops_mode(self) -> None:
         self: ChatScreen
         feat = self._try_feature("ops_mode")

nexforge_cli-0.2.15/src/nexforge/ui/widgets/file_browser.py

@@ -0,0 +1,163 @@
+"""文件浏览器侧边栏 —— 右侧面板,树形展示项目文件。
+
+- 左键点击文件 → 发出 FileSelected(引用路径到输入框)
+- 左键点击目录 → 展开/折叠
+- 右键点击文件 → 发出 FileContextMenu(弹出操作菜单:引用/编辑/复制)
+- 自动过滤 .git / __pycache__ / .nexforge 等噪音目录
+
+F4 开关;默认隐藏。事件冒泡到 ChatScreen 处理。
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from textual import events
+from textual.app import ComposeResult
+from textual.containers import Vertical
+from textual.message import Message
+from textual.widgets import DirectoryTree, Label
+
+from nexforge.i18n import t
+
+# 目录树默认隐藏的噪音目录(不进入树, 文件仍正常显示)
+_NOISY_DIRS = {
+    ".git", "__pycache__", ".nexforge", "node_modules", ".venv", "venv",
+    "dist", "build", ".pytest_cache", ".mypy_cache", ".ruff_cache",
+    ".idea", ".vscode", ".eggs",
+}
+
+
+def _is_noisy_dir(name: str) -> bool:
+    """目录名是否噪音(精确名或 *.egg-info 后缀)。"""
+    return name in _NOISY_DIRS or name.endswith(".egg-info")
+
+
+class FileBrowserTree(DirectoryTree):
+    """文件树:在 DirectoryTree 基础上区分左右键 + 过滤噪音目录。"""
+
+    # Esc: 关闭文件浏览器并回输入框(树获得焦点时 Esc 不应冒泡触发退出确认)
+    BINDINGS = [
+        ("escape", "close_browser", ""),
+    ]
+
+    class FileContextMenu(Message):
+        """右键点击文件时发出,携带文件路径。"""
+
+        def __init__(self, path: Path) -> None:
+            super().__init__()
+            self.path: Path = path
+
+    def action_close_browser(self) -> None:
+        try:
+            self.screen.action_close_file_browser()
+        except Exception:
+            pass
+
+    def filter_paths(self, paths):
+        """过滤掉噪音目录,文件与正常目录保留。"""
+        for p in paths:
+            try:
+                if p.is_dir() and _is_noisy_dir(p.name):
+                    continue
+            except OSError:
+                pass
+            yield p
+
+    async def _on_click(self, event: events.Click) -> None:
+        """右键:文件/目录都弹操作菜单(引用/打开/复制), 不触发默认选中/展开;
+        左键走默认逻辑(文件→引用, 目录→展开)。"""
+        if event.button == 3:  # 3 = 右键
+            meta = event.style.meta
+            if "line" in meta:
+                node = self.get_node_at_line(meta["line"])
+                if node is not None and node.data is not None:
+                    self.post_message(self.FileContextMenu(node.data.path))
+                    event.stop()
+                    event.prevent_default()
+            return
+        await super()._on_click(event)
+
+
+class FileBrowser(Vertical):
+    """文件浏览器侧边栏容器。"""
+
+    DEFAULT_CSS = """
+    FileBrowser {
+        width: 42;
+        height: 100%;
+        border-left: outer #22D3EE;
+        background: #12121a;
+        padding: 0 1 1 1;
+    }
+    #fb-title {
+        color: #22D3EE;
+        text-style: bold;
+        height: auto;
+        margin-top: 1;
+    }
+    #fb-path {
+        color: $text-muted;
+        height: auto;
+        margin-bottom: 1;
+    }
+    #fb-tree {
+        height: 1fr;
+        scrollbar-size-vertical: 1;
+        scrollbar-color: #22D3EE 30%;
+    }
+    #fb-hint {
+        color: $text-muted;
+        height: auto;
+        margin-top: 1;
+    }
+    """
+
+    def __init__(self, root: str | Path | None = None, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        if root is None:
+            try:
+                from nexforge.core.context import get_project_root
+                root = get_project_root()
+            except Exception:
+                root = Path.cwd()
+        self._root = Path(root)
+        self.display = False
+
+    def compose(self) -> ComposeResult:
+        yield Label(t("filebrowser.title"), id="fb-title")
+        yield Label(str(self._root), id="fb-path")
+        tree = FileBrowserTree(self._root, id="fb-tree")
+        # 隐藏根节点行: 树直接从"根目录之下"开始显示第一层文件/目录,
+        # 避免打开后只看到孤零零一个根目录行、还要再点一次才看到内容。
+        tree.show_root = False
+        yield tree
+        yield Label(t("filebrowser.hint"), id="fb-hint")
+
+    @property
+    def tree(self) -> FileBrowserTree | None:
+        try:
+            return self.query_one("#fb-tree", FileBrowserTree)
+        except Exception:
+            return None
+
+    def set_root(self, root: str | Path) -> None:
+        """切换根目录并刷新树。
+
+        只设 path 即可 —— DirectoryTree 的 watch_path 会异步重建 + reload,
+        不要手动再调 reload(),避免双重加载竞态。
+        """
+        self._root = Path(root)
+        try:
+            self.query_one("#fb-path", Label).update(str(self._root))
+        except Exception:
+            pass
+        tree = self.tree
+        if tree is not None and tree.is_attached:
+            tree.path = self._root
+
+    def refresh_tree(self) -> None:
+        """刷新当前根目录内容。"""
+        tree = self.tree
+        if tree is not None and tree.is_attached:
+            tree.reload()

nexforge_cli-0.2.15/src/nexforge/ui/widgets/file_menu.py

@@ -0,0 +1,74 @@
+"""文件操作菜单 —— 右键点击文件/目录时弹出的操作列表。
+
+返回操作 key(字符串): "ref" / "edit" / "copy_path" / "copy_content"。
+目录不显示 "copy_content"(复制内容无意义, 打开=系统文件管理器)。
+"""
+
+from __future__ import annotations
+
+from textual.app import ComposeResult
+from textual.containers import Vertical
+from textual.screen import ModalScreen
+from textual.widgets import Label, OptionList
+from textual.widgets.option_list import Option
+
+from nexforge.i18n import t
+
+
+class FileMenuModal(ModalScreen[str]):
+    DEFAULT_CSS = """
+    FileMenuModal {
+        align: center middle;
+    }
+    FileMenuModal > Vertical {
+        width: 44;
+        background: #1a1a24;
+        border: round #22D3EE;
+        padding: 1 2;
+    }
+    #fm-title {
+        color: #22D3EE;
+        text-style: bold;
+        height: auto;
+        margin-bottom: 1;
+    }
+    #fm-name {
+        color: $text-muted;
+        height: auto;
+        margin-bottom: 1;
+    }
+    #fm-options {
+        height: auto;
+    }
+    """
+
+    def __init__(self, path: str, is_dir: bool = False) -> None:
+        super().__init__()
+        self._path = path
+        self._is_dir = is_dir
+
+    def compose(self) -> ComposeResult:
+        options = [
+            Option(t("filebrowser.menu.ref"), id="ref"),
+            Option(t("filebrowser.menu.edit"), id="edit"),
+            Option(t("filebrowser.menu.copy_path"), id="copy_path"),
+        ]
+        if not self._is_dir:
+            options.append(Option(t("filebrowser.menu.copy_content"), id="copy_content"))
+        with Vertical():
+            yield Label(t("filebrowser.menu.title"), id="fm-title")
+            yield Label(self._path, id="fm-name")
+            yield OptionList(*options, id="fm-options")
+
+    def on_mount(self) -> None:
+        try:
+            self.query_one("#fm-options", OptionList).focus()
+        except Exception:
+            pass
+
+    def on_option_list_option_selected(self, event: OptionList.OptionSelected) -> None:
+        self.dismiss(event.option.id)
+
+    def on_key(self, event) -> None:
+        if event.key == "escape":
+            self.dismiss(None)

{nexforge_cli-0.2.14 → nexforge_cli-0.2.15}/src/nexforge/ui/widgets/multiline_prompt.py

@@ -15,7 +15,7 @@ class MultilinePrompt(TextArea):
         ("f1", "forward_help", ""),
         ("f2", "forward_toggle_mode", ""),
         ("f3", "forward_external_edit", ""),
-        ("f4", "forward_copy_last", ""),
+        ("f4", "forward_file_browser", ""),
         ("f5", "forward_toggle_sidebar", ""),
         ("f6", "forward_model_sidebar", ""),
         ("f7", "forward_ops", ""),
@@ -41,6 +41,9 @@ class MultilinePrompt(TextArea):
     def action_forward_copy_last(self) -> None:
         self.screen.action_copy_last()
 
+    def action_forward_file_browser(self) -> None:
+        self.screen.action_toggle_file_browser()
+
     def action_forward_toggle_sidebar(self) -> None:
         self.screen.action_toggle_sidebar()
 

{nexforge_cli-0.2.14 → nexforge_cli-0.2.15}/tests/test_cross_platform.py

@@ -45,6 +45,8 @@ MODULES = [
     "nexforge.ui.slash_handler",
     "nexforge.ui.screen_api",
     "nexforge.ui.clipboard_image",
+    "nexforge.ui.widgets.file_browser",
+    "nexforge.ui.widgets.file_menu",
     "nexforge.web.server",
     "nexforge.mcp",
     "nexforge.features.registry",
@@ -56,10 +58,21 @@ MODULES = [
 
 @pytest.mark.parametrize("mod", MODULES)
 def test_import_without_windll(mod):
-    """无 windll 环境下所有模块必须可导入(子进程隔离验证, 不污染当前测试进程)。"""
+    """无 windll 环境下所有模块必须可导入(子进程隔离验证, 不污染当前测试进程)。
+
+    仅在真实 POSIX(Linux/macOS)上完整有效: 那里 ctypes 天然无 windll 属性,
+    click/platformdirs 等第三方库按 sys.platform 走 posix 分支, 不碰 windll。
+    Windows 上删 windll 无法真实模拟 Linux(click 走 win32 分支模块级访问
+    windll.kernel32; 改 sys.platform 又会让 platformdirs 尝试 os.getuid 而
+    Windows os 模块没有它), 故 provider 模块(import 链含 click)在 win32 跳过,
+    其 Linux 正确性由 test_linux_full_deploy_chain 覆盖。
+    """
     import subprocess
     import textwrap
 
+    if sys.platform == "win32" and mod.startswith("nexforge.provider."):
+        pytest.skip("provider import 链含 click(win32 分支硬依赖 windll), 仅真实 POSIX 可验证")
+
     code = textwrap.dedent(f"""
         import ctypes, sys
         if hasattr(ctypes, "windll"):