Skip to main content

◆ NexForgeCLI

面向 DeepSeek V4 的终端智能体 · TUI + CLI 双模式

NexForgeCLI 是一个运行在终端里的智能体助手,既支持 DeepSeek/千问等多模型,也是插件宿主(plugins 目录即插即用)。既能作为全屏 TUI 交互式对话/编码,也能作为 one-shot 命令行工具嵌进脚本和管道。

当前版本:v0.7.8 · PyPI: pip install nexforge-cli

v0.7.8 要点(新增代理 + 两处行为修复):[proxy] 代理——让 nf 的工具流量走一台 代理机(局域网里某台机器跑着代理时用), 不必给本机搭全局梯子。run_shell 的子进程 (git/pip/hf/curl)与 web_fetch/搜索/图片请求自动走它; 模型 API 默认直连(国内更快, 也不必把 提示词与 Key 交给代理机); 局域网接管永远直连(硬约束, 代码里显式 bypass)。 命令: /proxy set <地址> · /proxy test(一条命令验证通不通: 端口可达 + 经代理/直连对照 + 结论)· /proxy status|on|off|llm on|off。哪些不走代理是从你的实际配置算出来的 (models.toml 里每个 provider、图片/搜索端点), 所以自建或冷门端点(如 tokenhub.tencentmaas.com、http://192.168.0.50:8000/v1)自动直连。 另修: 目标模式说"暂停"不听 —— 总监答应了"本轮结束即挂起"却继续派活, 根因不是不听而是 那句承诺不跨回合(下一轮复盘是另起提示词, 还写着"若需继续 → 发布下一条指令")。现在 /goal pause 与总监独立成行的 USER_PAUSE 标记都会真的挂起(派发点用代码拦截, 回一句话即恢复)。 以及 web_screenshot 失败时不再把浏览器 stderr 原样糊给用户(改为判读成可行动的一句话)。 (上一版 0.7.7 要点: 修复接管远端时退出 nf 会把自己的会话历史写成空; 搜索结果加 有效性校验(引擎无真命中时给的无关推荐不再被当成搜索结果); 测试隔离加固。)


📦 安装

# 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.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nexforge-cli 0.7.8
File Size Uploaded Provenance Actions
nexforge_cli-0.7.8.tar.gz 884.8 kB Without provenance Details for nexforge_cli-0.7.8.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nexforge-cli 0.7.8
File Interpreter ABI Platform Actions
nexforge_cli-0.7.8-py3-none-any.whl Python 3 none any Details for nexforge_cli-0.7.8-py3-none-any.whl

Total release size: 1.4 MB

Release files / nexforge_cli-0.7.8.tar.gz

Download URL nexforge_cli-0.7.8.tar.gz
Size 884.8 kB
Tags Source
SHA-256 checksum
How to use checksums
9037130b897c7580a4694fad013d8ff73aa90d9964c966e33c5fcc101cb17aa8
BLAKE2b-256 checksum
How to use checksums
c52dbe063fdec99aa12a9e5a0ec6f1bc3c522ceb41e3c89b67de853904dfa3e9
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.8-py3-none-any.whl

Download URL nexforge_cli-0.7.8-py3-none-any.whl
Size 519.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5257eea966fd0fc621e1ccea6dac704b0c63706ae580437231215d7cbb3fbabc
BLAKE2b-256 checksum
How to use checksums
3f197f35c3eda9f4ce9113d9e0fc80714e2ff84386e136fc2e0ca6c3c04cfee7
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.8

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.

Release history Release notifications | RSS feed

This release

0.7.8 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page