Metadata-Version: 2.5
Name: nexforge-cli
Version: 0.2.10
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: pillow>=10.0
Requires-Dist: pydantic>=2.6
Requires-Dist: pyperclip>=1.8
Requires-Dist: rich>=13.7
Requires-Dist: textual>=0.60
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.50; extra == 'anthropic'
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.5** · 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
