NexForgeCLI 是一个运行在终端里的智能体助手,既支持 DeepSeek/千问等多模型,也是插件宿主(plugins 目录即插即用)。既能作为全屏 TUI 交互式对话/编码,也能作为 one-shot 命令行工具嵌进脚本和管道。
当前版本:v0.7.6 · PyPI:
pip install nexforge-cli
v0.7.6 要点(新增局域网实例接管):按 F12 打开实例侧栏,同一局域网里的 nf 会自动
互相发现(组播, 不出网段), 核对指纹后即可互相接管——在被控端跑长任务, 在控制端看
事件流、改它的配置、审批它的写操作。配对走 TOFU(首次核对指纹), 之后按实例身份记住。
发现不到对方时用 /remote add <地址>[:端口] 手动按地址配对(跨网段/交换机禁组播也能连),
它同样要核对指纹——绕过组播不等于可以绕过 TOFU。跨机首次使用请先看手册 02 章的
"先过这三关"(共享 token / 放行 TCP 8898 + UDP 47892 / 同一网段)。
另: 新增机器级待修清单(bug_report/bug_list/bug_update)——干活时顺手把"与本任务
无关但别丢了"的问题记成工单, 跨项目跨实例共用; 以及修复了流式输出期间上滚会被跟底拽回、
搜索把推荐池当结果两处用户可见问题。
(上一版 0.7.5 要点: 新增 REPL 模式 nexforge --repl —— 轻量多轮交互 + 终端审批,
适合 SSH/服务器; 审批支持 a = 本会话全部允许, 可用 /ask 收回。)
(上一版 0.7.4 要点: 新增 /open 命令 + 卡片点击改用 on_mouse_down。
另:0.7.4 首次把手册补上 CLI/REPL 用法——此前手册只讲了 TUI。)(上一版 0.7.2 要点: 生图接入火山方舟 Agent Plan —— 默认 seedream-5.0-pro;
网关必须用套餐专用的 /api/plan/v3, 模型名要用套餐覆盖的。)
📦 安装
# 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
Metadata
Release files for nexforge-cli 0.7.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| nexforge_cli-0.7.6.tar.gz | 859.5 kB | Without provenance | Details for nexforge_cli-0.7.6.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nexforge_cli-0.7.6-py3-none-any.whl | Python 3 | none | any | Details for nexforge_cli-0.7.6-py3-none-any.whl |
Total release size: 1.4 MB
Release files / nexforge_cli-0.7.6.tar.gz
| Download URL | nexforge_cli-0.7.6.tar.gz |
|---|---|
| Size | 859.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dda83b1521072a52e5218dabab13f38607aab7689203e375379e7f179da06653
|
|
BLAKE2b-256 checksum How to use checksums |
118078e7ae74595abaa2d8556a06a54f8de71de2c0a52f9ac4aa58758b210bb3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Release files / nexforge_cli-0.7.6-py3-none-any.whl
| Download URL | nexforge_cli-0.7.6-py3-none-any.whl |
|---|---|
| Size | 506.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0144e33ef463b3d6f8d39514cb6f54604cecb010f820767567ea8d1606ddca1a
|
|
BLAKE2b-256 checksum How to use checksums |
8a8de0c58341c4eca57629e637d5e09cae37e664afd82f470f010d9bd9f0a94b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Security for nexforge-cli 0.7.6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.