nexforge-cli 0.1.0__tar.gz

nexforge_cli-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.eggs/
+
+# venv
+.venv/
+venv/
+env/
+
+# 测试 / 缓存
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# 会话与本地配置(不入库)
+.nexforge/
+*.jsonl
+
+# 生成的图标位图
+assets/icons/*.png
+
+# IDE / OS
+.idea/
+.vscode/
+.DS_Store

nexforge_cli-0.1.0/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: nexforge-cli
+Version: 0.1.0
+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: 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**(`deepseek-v4-flash` / `deepseek-v4-pro`)打造。既能作为全屏 TUI 交互式对话/编码,也能作为 one-shot 命令行工具嵌进脚本和管道。
+
+> 状态:**M1 走通骨架**(真实 API 接入 + Textual TUI + 核心工具循环)。M2+ 见下方路线图。
+
+---
+
+## ✨ 特性
+
+- **DeepSeek V4 原生接入** —— flash / pro 双模型,思考模式(`reasoning_content` 独立面板)、上下文缓存计费、真实用量与费用统计。
+- **三档模型选择** —— `flash`(快)、`pro`(强)、`auto`(客户端智能路由:默认 flash,命中信号自动升 pro + 思考)。
+- **智能体循环** —— 函数调用(function calling),自动读写文件、执行命令,直到任务完成。
+- **美化 TUI** —— Textual 驱动:品牌横幅、流式 Markdown、可折叠思考面板、工具调用卡片、状态栏(档位/上下文/费用)。
+- **SVG 图标系统** —— 以 SVG 为唯一源,按终端能力分级渲染(Kitty/iTerm2/Sixel 真图 → Nerd/Unicode 字形 → ASCII 兜底)。
+- **双运行模式** —— 全屏交互 or 管道式 one-shot,同一套核心。
+
+---
+
+## 📦 安装
+
+```bash
+# 一键安装(推荐)
+pip install git+https://gitee.com/Lighthorn/nexforgecli.git
+
+# 或本地开发安装
+git clone https://gitee.com/Lighthorn/nexforgecli.git
+cd NexForgeCLI && pip install -e .
+```
+
+设置 API Key:
+
+```bash
+export DEEPSEEK_API_KEY="sk-..."     # Windows: setx DEEPSEEK_API_KEY sk-...
+```
+
+---
+
+## 🚀 使用
+
+```bash
+# 全屏 TUI(默认)
+nexforge
+
+# one-shot:回答后退出
+nexforge -p "这个项目是做什么的?"
+
+# 管道输入
+git diff | nexforge -p "帮我写一条 commit message"
+
+# 指定档位 / 关思考
+nexforge --model pro
+nexforge --no-think -p "列出当前目录"
+
+# 查看当前配置
+nexforge --config
+```
+
+### TUI 内斜杠命令
+
+| 命令 | 作用 |
+|---|---|
+| `/help` | 帮助 |
+| `/model flash\|pro\|auto` | 切换模型档位 |
+| `/think on\|off` | 开关思考模式 |
+| `/cost` | 累计费用 |
+| `/clear` | 清空会话 |
+| `/quit` | 退出 |
+
+快捷键:`Ctrl+C` 退出 · `Ctrl+L` 清屏
+
+---
+
+## ⚙️ 配置
+
+默认值内置(真实 V4 参数),可在 `~/.nexforge/config.toml` 覆盖。参考 [`config.example.toml`](config.example.toml)。
+
+| 档位 | 模型 | 说明 |
+|---|---|---|
+| `flash` | deepseek-v4-flash | 低延迟低成本 |
+| `pro` | deepseek-v4-pro | 复杂推理/大重构 |
+| `auto` | 客户端路由 | 默认 flash,命中关键词/大上下文/多次失败 → 升 pro |
+
+---
+
+## 🧱 架构
+
+```
+cli.py ─┬─ app.py (Textual TUI) ── ui/ (screens, widgets)
+        └─ core/agent.py (AgentLoop 事件流)
+                ├─ provider/deepseek.py (V4 流式/思考/工具/缓存)
+                ├─ core/router.py (auto 路由)
+                ├─ core/session.py (消息 + reasoning 回传规则)
+                └─ tools/ (read/list/edit/shell + Registry)
+icons.py + assets/icons/*.svg (图标能力分级)
+```
+
+---
+
+## 🗺️ 路线图
+
+- [x] **M1 骨架** —— 真 V4 接入、TUI、核心工具循环、双模式
+- [ ] **M2 工具齐全 + 通用 skill** —— 完整工具集、审批门 diff、MCP 客户端、SKILL.md 技能加载
+- [ ] **M3 美化** —— 图标真图渲染、diff 视图、主题切换
+- [ ] **M4 实用化** —— 会话持久化/恢复、上下文压缩、费用总账、`nexforge login`
+- [ ] **M5 发布** —— PyInstaller 单文件 + pipx + brew/scoop、PyPI
+
+---
+
+## 🧪 开发
+
+```bash
+pip install -e ".[dev]"
+python -m pytest -q                    # 单元测试(不触网)
+python scripts/smoke_provider.py flash think   # 真实 API 冒烟
+python scripts/smoke_tui.py                     # TUI 端到端冒烟
+```
+
+---
+
+## 📄 License
+
+MIT

nexforge_cli-0.1.0/PyPI-Recovery-Codes-NexTech_2026-2026-07-11T08_45_53.599616.txt

@@ -0,0 +1,8 @@
+25970f29e0085983
+d721cf8503654f96
+0f14bb30cf902fb2
+13df6f4f93bba3fc
+e38d3b20202f60c7
+b80d68356adcd775
+d3c307a60b88db50
+2aec528903ab6bbe

nexforge_cli-0.1.0/README.md

@@ -0,0 +1,129 @@
+<div align="center">
+
+# ◆ NexForgeCLI
+
+**面向 DeepSeek V4 的终端智能体 · TUI + CLI 双模式**
+
+</div>
+
+NexForgeCLI 是一个运行在终端里的智能体助手,专为 **DeepSeek V4**(`deepseek-v4-flash` / `deepseek-v4-pro`)打造。既能作为全屏 TUI 交互式对话/编码,也能作为 one-shot 命令行工具嵌进脚本和管道。
+
+> 状态:**M1 走通骨架**(真实 API 接入 + Textual TUI + 核心工具循环)。M2+ 见下方路线图。
+
+---
+
+## ✨ 特性
+
+- **DeepSeek V4 原生接入** —— flash / pro 双模型,思考模式(`reasoning_content` 独立面板)、上下文缓存计费、真实用量与费用统计。
+- **三档模型选择** —— `flash`(快)、`pro`(强)、`auto`(客户端智能路由:默认 flash,命中信号自动升 pro + 思考)。
+- **智能体循环** —— 函数调用(function calling),自动读写文件、执行命令,直到任务完成。
+- **美化 TUI** —— Textual 驱动:品牌横幅、流式 Markdown、可折叠思考面板、工具调用卡片、状态栏(档位/上下文/费用)。
+- **SVG 图标系统** —— 以 SVG 为唯一源,按终端能力分级渲染(Kitty/iTerm2/Sixel 真图 → Nerd/Unicode 字形 → ASCII 兜底)。
+- **双运行模式** —— 全屏交互 or 管道式 one-shot,同一套核心。
+
+---
+
+## 📦 安装
+
+```bash
+# 一键安装(推荐)
+pip install git+https://gitee.com/Lighthorn/nexforgecli.git
+
+# 或本地开发安装
+git clone https://gitee.com/Lighthorn/nexforgecli.git
+cd NexForgeCLI && pip install -e .
+```
+
+设置 API Key:
+
+```bash
+export DEEPSEEK_API_KEY="sk-..."     # Windows: setx DEEPSEEK_API_KEY sk-...
+```
+
+---
+
+## 🚀 使用
+
+```bash
+# 全屏 TUI(默认)
+nexforge
+
+# one-shot:回答后退出
+nexforge -p "这个项目是做什么的?"
+
+# 管道输入
+git diff | nexforge -p "帮我写一条 commit message"
+
+# 指定档位 / 关思考
+nexforge --model pro
+nexforge --no-think -p "列出当前目录"
+
+# 查看当前配置
+nexforge --config
+```
+
+### TUI 内斜杠命令
+
+| 命令 | 作用 |
+|---|---|
+| `/help` | 帮助 |
+| `/model flash\|pro\|auto` | 切换模型档位 |
+| `/think on\|off` | 开关思考模式 |
+| `/cost` | 累计费用 |
+| `/clear` | 清空会话 |
+| `/quit` | 退出 |
+
+快捷键:`Ctrl+C` 退出 · `Ctrl+L` 清屏
+
+---
+
+## ⚙️ 配置
+
+默认值内置(真实 V4 参数),可在 `~/.nexforge/config.toml` 覆盖。参考 [`config.example.toml`](config.example.toml)。
+
+| 档位 | 模型 | 说明 |
+|---|---|---|
+| `flash` | deepseek-v4-flash | 低延迟低成本 |
+| `pro` | deepseek-v4-pro | 复杂推理/大重构 |
+| `auto` | 客户端路由 | 默认 flash,命中关键词/大上下文/多次失败 → 升 pro |
+
+---
+
+## 🧱 架构
+
+```
+cli.py ─┬─ app.py (Textual TUI) ── ui/ (screens, widgets)
+        └─ core/agent.py (AgentLoop 事件流)
+                ├─ provider/deepseek.py (V4 流式/思考/工具/缓存)
+                ├─ core/router.py (auto 路由)
+                ├─ core/session.py (消息 + reasoning 回传规则)
+                └─ tools/ (read/list/edit/shell + Registry)
+icons.py + assets/icons/*.svg (图标能力分级)
+```
+
+---
+
+## 🗺️ 路线图
+
+- [x] **M1 骨架** —— 真 V4 接入、TUI、核心工具循环、双模式
+- [ ] **M2 工具齐全 + 通用 skill** —— 完整工具集、审批门 diff、MCP 客户端、SKILL.md 技能加载
+- [ ] **M3 美化** —— 图标真图渲染、diff 视图、主题切换
+- [ ] **M4 实用化** —— 会话持久化/恢复、上下文压缩、费用总账、`nexforge login`
+- [ ] **M5 发布** —— PyInstaller 单文件 + pipx + brew/scoop、PyPI
+
+---
+
+## 🧪 开发
+
+```bash
+pip install -e ".[dev]"
+python -m pytest -q                    # 单元测试(不触网)
+python scripts/smoke_provider.py flash think   # 真实 API 冒烟
+python scripts/smoke_tui.py                     # TUI 端到端冒烟
+```
+
+---
+
+## 📄 License
+
+MIT

nexforge_cli-0.1.0/assets/icons/agent.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
+  <defs>
+    <linearGradient id="nf" x1="0" y1="0" x2="32" y2="32" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#6D5EF5"/>
+      <stop offset="1" stop-color="#22D3EE"/>
+    </linearGradient>
+  </defs>
+  <!-- NexForge 铁砧 / 分叉标记 -->
+  <path d="M16 3 4 9v8c0 6.5 5.1 10.7 12 12 6.9-1.3 12-5.5 12-12V9L16 3z"
+        stroke="url(#nf)" stroke-width="2" stroke-linejoin="round"/>
+  <path d="M11 15h10M16 11v10M11 15l-2 3M21 15l2 3" stroke="url(#nf)"
+        stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/cost.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#22D3EE" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- cost / coin/dollar -->
+  <circle cx="12" cy="12" r="10"/>
+  <path d="M12 7v10M10 9h4"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/edit.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#22D3EE" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- edit: same as write(alias) -->
+  <path d="M17 3a2.828 2.828 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5L17 3z"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/err.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#E04040" stroke-width="3" stroke-linecap="round">
+  <!-- error / x -->
+  <line x1="6" y1="6" x2="18" y2="18"/>
+  <line x1="18" y1="6" x2="6" y2="18"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/file.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#6D5EF5" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- file / generic document -->
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/model.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#6D5EF5" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- model / diamond with AI dots -->
+  <rect x="4" y="4" width="16" height="16" rx="2" transform="rotate(45 12 12)"/>
+  <circle cx="10" cy="10" r="1.5" fill="#22D3EE" stroke="none"/>
+  <circle cx="14" cy="10" r="1.5" fill="#22D3EE" stroke="none"/>
+  <circle cx="12" cy="14" r="1.5" fill="#22D3EE" stroke="none"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/ok.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#22D3EE" stroke-width="3" stroke-linecap="round" stroke-linejoin="round">
+  <!-- ok / check -->
+  <polyline points="4,12 10,19 20,5"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/read.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#6D5EF5" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- read_file / document -->
+  <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+  <polyline points="14,2 14,8 20,8"/>
+  <line x1="16" y1="13" x2="8" y2="13"/>
+  <line x1="16" y1="17" x2="8" y2="17"/>
+  <polyline points="10,9 9,9 8,9"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/running.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#6D5EF5" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- running / spinner dot + arc -->
+  <circle cx="12" cy="12" r="10"/>
+  <path stroke="#22D3EE" d="M12 2a10 10 0 0 1 10 10"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/search.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#6D5EF5" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- search / magnifying glass -->
+  <circle cx="11" cy="11" r="8"/>
+  <line x1="21" y1="21" x2="16.65" y2="16.65"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/shell.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#6D5EF5" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- shell / terminal / >_ -->
+  <polyline points="4,17 10,11 4,5"/>
+  <line x1="12" y1="19" x2="20" y2="19"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/thinking.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#6D5EF5" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- thinking / brain -->
+  <path d="M12 2a5 5 0 0 0-5 5c0 1.2.4 2.3 1 3.2L5 21h14l-3-10.8a5 5 0 0 0-4-8.2z"/>
+  <path d="M9 13h6M10 17h4" stroke="#22D3EE"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/web.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#22D3EE" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- web / globe -->
+  <circle cx="12" cy="12" r="10"/>
+  <line x1="2" y1="12" x2="22" y2="12"/>
+  <path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/>
+</svg>

nexforge_cli-0.1.0/assets/icons/write.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#22D3EE" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <!-- write / pencil -->
+  <path d="M17 3a2.828 2.828 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5L17 3z"/>
+</svg>

nexforge_cli-0.1.0/config.example.toml

@@ -0,0 +1,42 @@
+# NexForgeCLI 配置示例。
+# 复制到 ~/.nexforge/config.toml 后按需修改;所有字段都有内置默认值,可只写要覆盖的项。
+# DeepSeek V4 参数已核实自 api-docs.deepseek.com(2026-04)。
+
+[provider]
+base_url = "https://api.deepseek.com"     # OpenAI 格式;Anthropic 格式加 /anthropic
+api_key_env = "DEEPSEEK_API_KEY"           # 优先从此环境变量读 key
+# api_key = "sk-..."                       # 次选:直接写这里(不建议入库)
+timeout = 120.0
+max_retries = 2
+
+[models]
+flash = "deepseek-v4-flash"
+pro = "deepseek-v4-pro"
+default_tier = "auto"                      # flash | pro | auto
+thinking = true                            # 思考模式,默认开
+reasoning_effort = "high"                  # high | max
+max_output_tokens = 8192                   # 上限 384K
+
+# 定价(每百万 token,USD)—— 已核实
+[models.pricing.flash]
+input_cache_hit = 0.0028
+input_cache_miss = 0.14
+output = 0.28
+
+[models.pricing.pro]
+input_cache_hit = 0.003625
+input_cache_miss = 0.435
+output = 0.87
+
+[router]                                   # auto 档位的客户端路由
+entry = "flash"                            # auto 默认从 flash 起步
+escalate_to = "pro"
+escalate_on_tool_failures = 2
+escalate_context_tokens = 200000
+
+[ui]
+theme = "dark"                             # dark | light
+show_thinking = true
+icons = "auto"                             # auto | image | glyph | ascii
+accent = "#6D5EF5"
+accent2 = "#22D3EE"