NexForgeCLI 是一个运行在终端里的智能体助手，既支持 DeepSeek/千问等多模型，也是插件宿主（plugins 目录即插即用）。既能作为全屏 TUI 交互式对话/编码，也能作为 one-shot 命令行工具嵌进脚本和管道。
当前版本:v0.2.15 · PyPI:
pip install nexforge-cli
📦 安装
# pipx 安装(推荐,自动管理 PATH)
pipx install nexforge-cli
# pip 安装
pip install nexforge-cli
# 开发版
pip install git+https://gitee.com/Lighthorn/nexforgecli.git
设置 API Key:
export DEEPSEEK_API_KEY="sk-..."
# 或启动后在输入框输入: /key sk-...
API Key 获取: https://platform.deepseek.com/api_keys
✨ 特性
- 多模型底座 —— DeepSeek(内置) / 千问专用底座 / 通用 OpenAI 兼容 / Anthropic，
/provider即切 - 插件宿主 ——
plugins/目录即插即用(工具/UI特性/技能)，无需改主程序 - 三级知识库 —— 全局+项目+项目地图，kb_search 检索、kb_write 沉淀
- DeepSeek 深度优化 —— thinking 模式、KV Cache、streaming、采样参数、JSON Mode、tool_choice 全适配
- TUI 全屏交互 —— Textual 驱动，流式 Markdown、可折叠思考面板、工具卡片、状态栏
- 安全分级 —— safe/supervised/auto 三级权限，审批弹窗
- 会话管理 —— 自动保存/恢复、多会话切换、重命名/删除
- 计划模式 —— 只读讨论，AI 生成计划后执行
- 多行输入 —— F2 弹窗面板、F3 系统编辑器
- 一键安装 ——
pip install nexforge-cli
🚀 使用
# 全屏 TUI(默认)
nexforge
# 或简写
nf
# one-shot 模式
nexforge -p "这个项目是做什么的?"
快捷键
| 快捷键 | 功能 |
|---|---|
Enter |
发送消息 |
F1 |
帮助 |
F2 |
多行输入弹窗 |
F3 |
外部编辑器 |
Ctrl+S |
会话面板 |
Ctrl+B |
计划面板 |
Ctrl+L |
清屏 |
Ctrl+Shift+C |
复制 AI 回复 |
Esc |
停止/退出 |
📁 文档
| 文档 | 内容 |
|---|---|
| 01-安装与配置 | 安装/配置/API Key |
| 02-界面与快捷键 | 全部命令和快捷键 |
| 03-模型配置 | DeepSeek/千问/多模型接入 |
| 04-工具参考 | AI 可调用工具说明 |
| 08-自定义配置 | config.toml/models.toml 全字段 |
| 10-插件开发 | 插件宿主开发指南 |
🧪 开发
git clone https://gitee.com/Lighthorn/nexforgecli.git
cd nexforgecli
pip install -e ".[dev]"
python -m pytest -q
📄 License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
nexforge_cli-0.2.15.tar.gz
(294.0 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
nexforge_cli-0.2.15-py3-none-any.whl
(262.7 kB
view details)
File details
Details for the file nexforge_cli-0.2.15.tar.gz.
File metadata
- Download URL: nexforge_cli-0.2.15.tar.gz
- Upload date:
- Size: 294.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
56ff725838a10fc6792d5eebfbec0abd82cad6a2921d38888689ccc6a8b91894
|
|
| MD5 |
653e4b4bd4f6adfb53d3e71eb6fe3a26
|
|
| BLAKE2b-256 |
87ee4cacbfb252a9e8ba77e095ab4dc7a2b5fce2d5102deb200a7ed5541cbca7
|
File details
Details for the file nexforge_cli-0.2.15-py3-none-any.whl.
File metadata
- Download URL: nexforge_cli-0.2.15-py3-none-any.whl
- Upload date:
- Size: 262.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
94506d3d575e9eb4e052a706f73bd10ee5c76070a6613d685c504806434d774c
|
|
| MD5 |
e5b58a965c34b4cc9e9af82fc7cd95c2
|
|
| BLAKE2b-256 |
5a4805d1346720765bbc8dd6b461f95070bc36f1665e5cba60f3b3744b470eb7
|
