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

{nexforge_cli-0.2.0 → nexforge_cli-0.2.2}/INSTALL.md

@@ -5,25 +5,43 @@
 - Python **3.11+**
 - 终端:Windows Terminal / macOS Terminal / Linux 任意终端
 - 网络:需能访问 `api.deepseek.com`
-- 可选:Git(仅 git 安装方式需要)
 
-## 方式一:Pip 安装(推荐)
+## 方式一:pipx 安装(推荐)
+
+`pipx` 自动管理 PATH,安装后即可在任意目录直接运行:
+
+```bash
+# 安装 pipx(如未安装)
+pip install pipx
+pipx ensurepath
+
+# 安装 NexForgeCLI
+pipx install nexforge-cli
+
+# 运行
+nexforge
+```
+
+## 方式二:pip 安装
 
 ```bash
 pip install nexforge-cli
 nexforge
 ```
 
-安装后运行 `nexforge`(或简写 `nf`)。
+如果提示 `nexforge: command not found`:
 
-## 方式二:Pip 安装开发版
+- **Windows**: 将 `%APPDATA%\Python\Python3xx\Scripts` 加入系统 PATH
+- **Linux/macOS**: 确保 `~/.local/bin` 在 PATH 中,或运行 `export PATH="$HOME/.local/bin:$PATH"`
+- 或直接用 `python -m nexforge` 代替
+
+## 方式三:开发版安装
 
 ```bash
 pip install git+https://gitee.com/Lighthorn/nexforgecli.git
-nexforge
 ```
 
-## 方式三:源码安装
+## 方式四:源码安装
 
 ```bash
 git clone https://gitee.com/Lighthorn/nexforgecli.git
@@ -61,13 +79,15 @@ nexforge --help
 ## 升级
 
 ```bash
-pip install --upgrade nexforge-cli
+pipx upgrade nexforge-cli     # pipx 方式
+pip install --upgrade nexforge-cli  # pip 方式
 ```
 
 ## 卸载
 
 ```bash
-pip uninstall nexforge-cli -y
+pipx uninstall nexforge-cli   # pipx 方式
+pip uninstall nexforge-cli -y # pip 方式
 ```
 
 配置文件和数据保留在 `~/.nexforge/` 和项目 `.nexforge/` 目录下,需手动删除。
@@ -76,7 +96,8 @@ pip uninstall nexforge-cli -y
 
 | 问题 | 解决 |
 |------|------|
-| `nexforge: command not found` | Python Scripts 目录不在 PATH 中,用 `python -m nexforge` 代替 |
+| `nexforge: command not found` | 用 pipx 安装,或手动加 Scripts 到 PATH,或用 `python -m nexforge` |
 | `No module named 'nexforge'` | pip 安装未成功,检查 Python 版本 ≥3.11 |
 | `ProviderError: 未找到 API Key` | 未配置 API Key,用 `/key` 或环境变量设置 |
 | Windows 终端乱码 | 使用 Windows Terminal 或 Git Bash,避免 PowerShell |
+| 大段粘贴被截断 | 按 F3 用外部编辑器粘贴大段文本 |

nexforge_cli-0.2.2/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: nexforge-cli
+Version: 0.2.2
+Summary: NexForgeCLI — 一个面向 DeepSeek V4 的终端智能体(TUI + CLI 双模式)
+Project-URL: Homepage, https://gitee.com/Lighthorn/nexforgecli
+Author: NexForge
+License: MIT
+Keywords: agent,cli,deepseek,textual,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Terminals
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: openai>=1.40
+Requires-Dist: pydantic>=2.6
+Requires-Dist: pyperclip>=1.8
+Requires-Dist: rich>=13.7
+Requires-Dist: textual>=0.60
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Provides-Extra: images
+Requires-Dist: cairosvg>=2.7; extra == 'images'
+Requires-Dist: pillow>=10.0; extra == 'images'
+Requires-Dist: term-image>=0.7; extra == 'images'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# ◆ NexForgeCLI
+
+**面向 DeepSeek V4 的终端智能体 · TUI + CLI 双模式**
+
+</div>
+
+NexForgeCLI 是一个运行在终端里的智能体助手,专为 **DeepSeek V4** 打造。既能作为全屏 TUI 交互式对话/编码,也能作为 one-shot 命令行工具嵌进脚本和管道。
+
+> 当前版本:**v0.2.0** · PyPI: `pip install nexforge-cli`
+
+---
+
+## 📦 安装
+
+```bash
+# pipx 安装(推荐,自动管理 PATH)
+pipx install nexforge-cli
+
+# pip 安装
+pip install nexforge-cli
+
+# 开发版
+pip install git+https://gitee.com/Lighthorn/nexforgecli.git
+```
+
+设置 API Key:
+
+```bash
+export DEEPSEEK_API_KEY="sk-..."
+# 或启动后在输入框输入: /key sk-...
+```
+
+API Key 获取: https://platform.deepseek.com/api_keys
+
+---
+
+## ✨ 特性
+
+- **DeepSeek V4 深度优化** —— thinking 模式、KV Cache、streaming、采样参数、JSON Mode、tool_choice 全适配
+- **TUI 全屏交互** —— Textual 驱动,流式 Markdown、可折叠思考面板、工具卡片、状态栏
+- **安全分级** —— safe/supervised/auto 三级权限,审批弹窗
+- **会话管理** —— 自动保存/恢复、多会话切换、重命名/删除
+- **计划模式** —— 只读讨论,AI 生成计划后执行
+- **多行输入** —— F2 弹窗面板、F3 系统编辑器
+- **一键安装** —— `pip install nexforge-cli`
+- **性能优化** —— O(n²)→O(n) 流式渲染、DOM 查询缓存、I/O 异步化
+
+---
+
+## 🚀 使用
+
+```bash
+# 全屏 TUI(默认)
+nexforge
+
+# 或简写
+nf
+
+# one-shot 模式
+nexforge -p "这个项目是做什么的?"
+```
+
+### 快捷键
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Enter` | 发送消息 |
+| `F1` | 帮助 |
+| `F2` | 多行输入弹窗 |
+| `F3` | 外部编辑器 |
+| `Ctrl+S` | 会话面板 |
+| `Ctrl+B` | 计划面板 |
+| `Ctrl+L` | 清屏 |
+| `Ctrl+Shift+C` | 复制 AI 回复 |
+| `Esc` | 停止/退出 |
+
+---
+
+## 📁 文档
+
+| 文档 | 内容 |
+|------|------|
+| [总览](doc/总览.md) | 项目介绍 |
+| [安装与配置](doc/安装与配置.md) | 安装/配置/FAQ |
+| [命令与快捷键](doc/命令与快捷键.md) | 全部命令和快捷键 |
+| [工具参考](doc/工具参考.md) | AI 可调用工具说明 |
+| [会话管理](doc/会话管理.md) | 会话保存/恢复/切换 |
+| [计划模式](doc/计划模式.md) | 只读讨论模式 |
+| [权限系统](doc/权限系统.md) | 三级权限 |
+| [高级功能](doc/高级功能.md) | DeepSeek 集成/Web/技能 |
+
+---
+
+## 🧪 开发
+
+```bash
+git clone https://gitee.com/Lighthorn/nexforgecli.git
+cd nexforgecli
+pip install -e ".[dev]"
+python -m pytest -q
+```
+
+---
+
+## 📄 License
+
+MIT

nexforge_cli-0.2.2/README.md

@@ -0,0 +1,109 @@
+<div align="center">
+
+# ◆ NexForgeCLI
+
+**面向 DeepSeek V4 的终端智能体 · TUI + CLI 双模式**
+
+</div>
+
+NexForgeCLI 是一个运行在终端里的智能体助手,专为 **DeepSeek V4** 打造。既能作为全屏 TUI 交互式对话/编码,也能作为 one-shot 命令行工具嵌进脚本和管道。
+
+> 当前版本:**v0.2.0** · PyPI: `pip install nexforge-cli`
+
+---
+
+## 📦 安装
+
+```bash
+# pipx 安装(推荐,自动管理 PATH)
+pipx install nexforge-cli
+
+# pip 安装
+pip install nexforge-cli
+
+# 开发版
+pip install git+https://gitee.com/Lighthorn/nexforgecli.git
+```
+
+设置 API Key:
+
+```bash
+export DEEPSEEK_API_KEY="sk-..."
+# 或启动后在输入框输入: /key sk-...
+```
+
+API Key 获取: https://platform.deepseek.com/api_keys
+
+---
+
+## ✨ 特性
+
+- **DeepSeek V4 深度优化** —— thinking 模式、KV Cache、streaming、采样参数、JSON Mode、tool_choice 全适配
+- **TUI 全屏交互** —— Textual 驱动,流式 Markdown、可折叠思考面板、工具卡片、状态栏
+- **安全分级** —— safe/supervised/auto 三级权限,审批弹窗
+- **会话管理** —— 自动保存/恢复、多会话切换、重命名/删除
+- **计划模式** —— 只读讨论,AI 生成计划后执行
+- **多行输入** —— F2 弹窗面板、F3 系统编辑器
+- **一键安装** —— `pip install nexforge-cli`
+- **性能优化** —— O(n²)→O(n) 流式渲染、DOM 查询缓存、I/O 异步化
+
+---
+
+## 🚀 使用
+
+```bash
+# 全屏 TUI(默认)
+nexforge
+
+# 或简写
+nf
+
+# one-shot 模式
+nexforge -p "这个项目是做什么的?"
+```
+
+### 快捷键
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Enter` | 发送消息 |
+| `F1` | 帮助 |
+| `F2` | 多行输入弹窗 |
+| `F3` | 外部编辑器 |
+| `Ctrl+S` | 会话面板 |
+| `Ctrl+B` | 计划面板 |
+| `Ctrl+L` | 清屏 |
+| `Ctrl+Shift+C` | 复制 AI 回复 |
+| `Esc` | 停止/退出 |
+
+---
+
+## 📁 文档
+
+| 文档 | 内容 |
+|------|------|
+| [总览](doc/总览.md) | 项目介绍 |
+| [安装与配置](doc/安装与配置.md) | 安装/配置/FAQ |
+| [命令与快捷键](doc/命令与快捷键.md) | 全部命令和快捷键 |
+| [工具参考](doc/工具参考.md) | AI 可调用工具说明 |
+| [会话管理](doc/会话管理.md) | 会话保存/恢复/切换 |
+| [计划模式](doc/计划模式.md) | 只读讨论模式 |
+| [权限系统](doc/权限系统.md) | 三级权限 |
+| [高级功能](doc/高级功能.md) | DeepSeek 集成/Web/技能 |
+
+---
+
+## 🧪 开发
+
+```bash
+git clone https://gitee.com/Lighthorn/nexforgecli.git
+cd nexforgecli
+pip install -e ".[dev]"
+python -m pytest -q
+```
+
+---
+
+## 📄 License
+
+MIT

nexforge_cli-0.2.2/doc//344/274/232/350/257/235/347/256/241/347/220/206.md

@@ -0,0 +1,56 @@
+# 会话管理
+
+## 自动保存
+
+每次 AI 回复完成后自动保存当前会话到 `.nexforge/sessions/` 目录下的 Markdown 文件。文件按日期分目录:
+
+```
+.nexforge/
+└── sessions/
+    └── 2026-07-14/
+        ├── session-075412.md
+        └── session-083021.md
+```
+
+## 自动恢复
+
+启动时自动恢复当前项目最近一次会话,包括完整的对话历史。
+
+## 会话面板(Ctrl+S)
+
+侧边栏显示所有历史会话,支持:
+
+- **新建会话**:点击 `+ 新建会话` 或快捷键 `Ctrl+S`
+- **切换会话**:点击会话名,自动保存当前会话并加载选中会话
+- **重命名**:`/rename 新名称`
+- **删除**:点击 `✖` 按钮,弹出确认弹窗
+- **绿点**:当前活跃会话的指示标记
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `/save [name]` | 手动保存当前会话 |
+| `/rename <name>` | 重命名当前会话 |
+| `/sessions` | 列出所有历史会话 |
+| `/clear` | 清空当前会话内容 |
+| `/cost` | 显示累计 token 用量和费用 |
+
+## 会话格式
+
+会话文件为 Markdown 格式,每条消息结构:
+
+```markdown
+### ❯ 用户
+消息内容
+
+### ❯ 助手
+回复内容
+<!-- thinking: 思考内容 -->
+```
+
+## 上下文管理
+
+- 屏幕 widget 上限 300 个(自动裁剪最旧的)
+- 会话消息无截断(完整保留在文件中)
+- 长会话警告:每轮 API 调用发送全量消息历史

nexforge_cli-0.2.2/doc//345/221/275/344/273/244/344/270/216/345/277/253/346/215/267/351/224/256.md

@@ -0,0 +1,57 @@
+# 命令与快捷键
+
+## 快捷键
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Enter` | 发送消息 |
+| `F1` | 显示帮助 |
+| `F2` | 弹出多行输入面板(30行) |
+| `F3` | 系统默认编辑器编辑文本 |
+| `Esc` | AI 工作中:停止当前任务 / 空闲时:退出确认 |
+| `Ctrl+L` | 清屏 |
+| `Ctrl+S` | 打开/关闭会话侧边栏 |
+| `Ctrl+B` | 打开/关闭计划侧边栏 |
+| `Ctrl+Shift+C` | 复制最后一条 AI 回复到剪贴板 |
+| `PageUp/PageDown` | 上下翻页 |
+| `↑/↓` | 单行滚动 |
+| `End` | 滚回底部 |
+
+## 斜杠命令
+
+| 命令 | 说明 |
+|------|------|
+| `/help` | 显示帮助 |
+| `/key sk-...` | 保存 API Key |
+| `/model flash\|pro\|auto` | 切换模型档位 |
+| `/think on\|off` | 开关思考模式 |
+| `/mode review\|auto` | 审批模式切换 |
+| `/plan` | 切换计划模式(只读讨论) |
+| `/json` | 切换 JSON 输出模式 |
+| `/perm safe\|supervised\|auto` | 切换权限级别 |
+| `/balance` | 查询 DeepSeek 账户余额 |
+| `/skill <name>` | 执行指定技能 |
+| `/skills` | 列出可用技能 |
+| `/save [name]` | 保存当前会话 |
+| `/rename <name>` | 重命名当前会话 |
+| `/sessions` | 列出历史会话 |
+| `/cost` | 显示累计费用 |
+| `/clear` | 清空当前会话 |
+| `/web start\|stop` | Web 管理面板 |
+| `/quit` | 退出 |
+
+## 权限级别
+
+| 级别 | 命令 | 效果 |
+|------|------|------|
+| 🛡 safe | `/perm safe` | 全部写/删/Shell 需审批 |
+| ⚡ supervised | `/perm supervised` | 写文件自动,删/Shell 需审批(默认) |
+| 🔥 auto | `/perm auto` | 全部直接执行 |
+
+## 提示栏
+
+输入框下方有一条提示栏,列出常用快捷键:
+
+```
+F1帮助 · F2多行输入 · F3外部编辑器 · Enter发送 · Ctrl+S会话 · Ctrl+B计划 · Ctrl+L清屏 · Ctrl+Shift+C复制 · Esc停止/退出 · /help命令
+```

nexforge_cli-0.2.2/doc//345/256/211/350/243/205/344/270/216/351/205/215/347/275/256.md

@@ -0,0 +1,108 @@
+# 安装与配置
+
+## 环境要求
+
+- Python **3.11+**
+- 终端:Windows Terminal / macOS Terminal / Linux 任意终端
+- 网络:需能访问 `api.deepseek.com`
+
+## 安装
+
+```bash
+# 方式一:pipx 安装(推荐,自动管理 PATH)
+pipx install nexforge-cli
+
+# 方式二:Pip 安装
+pip install nexforge-cli
+# 如果提示 nexforge 不在 PATH 中:
+# Windows: 将 %APPDATA%\Python\Python3xx\Scripts 加入 PATH
+# Linux/macOS: 确保 ~/.local/bin 在 PATH 中
+
+# 方式三:安装开发版
+pip install git+https://gitee.com/Lighthorn/nexforgecli.git
+
+# 方式四:源码安装
+git clone https://gitee.com/Lighthorn/nexforgecli.git
+cd nexforgecli
+pip install -e .
+```
+
+## 运行
+
+```bash
+nexforge
+# 或简写
+nf
+```
+
+## 配置 API Key
+
+### 首次启动自动配置
+
+运行 `nexforge` 后会弹出 API Key 输入面板,直接粘贴 `sk-…` 即可。
+
+### 手动配置
+
+```bash
+# 环境变量(每次有效)
+export DEEPSEEK_API_KEY="sk-你的密钥"
+
+# 或启动后在输入框输入
+/key sk-你的密钥
+```
+
+API Key 获取:[platform.deepseek.com/api_keys](https://platform.deepseek.com/api_keys)
+
+### 凭据文件
+
+API Key 保存在 `~/.nexforge/auth.toml`,不会被 Git 追踪。
+
+## 配置文件
+
+主配置文件:`~/.nexforge/config.toml`
+
+```toml
+[models]
+default_tier = "auto"      # flash | pro | auto
+thinking = true            # 思考模式
+reasoning_effort = "high"  # high | max
+max_output_tokens = 8192
+temperature = null         # 0-2,仅 thinking=off 生效
+top_p = null
+frequency_penalty = null
+presence_penalty = null
+stop = null
+
+[ui]
+mode = "review"     # review | auto
+plan_mode = false   # 计划模式
+json_mode = false   # JSON 强制输出
+theme = "dark"
+
+[permissions]
+profile = "supervised"  # safe | supervised | auto
+```
+
+## 升级
+
+```bash
+pip install --upgrade nexforge-cli
+```
+
+## 卸载
+
+```bash
+pip uninstall nexforge-cli -y
+```
+
+配置文件和数据保留在 `~/.nexforge/` 和项目 `.nexforge/` 目录下,需手动删除。
+
+## 常见问题
+
+| 问题 | 解决 |
+|------|------|
+| `nexforge: command not found` | Python Scripts 目录不在 PATH 中,用 `python -m nexforge` 代替 |
+| `No module named 'nexforge'` | pip 安装未成功,检查 Python 版本 ≥3.11 |
+| `ProviderError: 未找到 API Key` | 未配置 API Key,用 `/key` 或环境变量设置 |
+| Windows 终端乱码 | 使用 Windows Terminal 或 Git Bash,避免 PowerShell |
+| 大段粘贴被截断 | 按 F3 用外部编辑器粘贴大段文本 |

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.2/doc//345/267/245/345/205/267/345/217/202/350/200/203.md

@@ -0,0 +1,64 @@
+# 工具参考
+
+NexForgeCLI 内置以下工具供 AI 调用:
+
+## 文件操作
+
+| 工具 | 功能 |
+|------|------|
+| `read_file` | 读取文件内容 |
+| `write_file` | 写入新文件 |
+| `edit_file` | 搜索替换编辑已有文件 |
+| `multi_edit` | 批量编辑多个文件 |
+| `list_directory` | 列出目录内容 |
+| `search_files` | 按文件名搜索 |
+| `search_content` | 按文件内容搜索(grep) |
+| `delete_file` | 删除文件 |
+| `move_file` | 移动/重命名文件 |
+
+## Shell 命令
+
+| 工具 | 功能 |
+|------|------|
+| `run_shell` | 执行 Shell 命令 |
+
+## Git 操作
+
+| 工具 | 功能 |
+|------|------|
+| `git_status` | 查看 Git 状态 |
+| `git_diff` | 查看 Git 差异 |
+| `git_commit` | Git 提交(需启用) |
+
+## Web
+
+| 工具 | 功能 |
+|------|------|
+| `web_fetch` | 获取网页内容 |
+| `web_search` | 网页搜索 |
+
+## 工具限制
+
+- **工具轮数上限**:50 轮(防死循环)
+- **单轮超时**:300 秒
+- **单工具超时**:60 秒
+
+## 审批流程
+
+根据权限级别,以下工具需要用户审批:
+
+| 权限 | 读 | 写 | 删 | Shell |
+|------|----|----|-----|-------|
+| safe | ✅ | 🔒 | 🔒 | 🔒 |
+| supervised | ✅ | ✅ | 🔒 | 🔒 |
+| auto | ✅ | ✅ | ✅ | ✅ |
+
+✅ = 自动执行  🔒 = 需用户确认
+
+## DeepSeek 优化
+
+- **Thinking 模式**:启用以太坊思考链,提升复杂推理质量
+- **KV Cache**:自动记录缓存命中/未命中 tokens
+- **采样参数**:thinking=off 时可调节 temperature/top_p
+- **JSON Mode**:`/json` 强制输出合法 JSON
+- **max_completion_tokens**:使用 DeepSeek 推荐的新参数名