nexforge-cli 0.2.9__tar.gz → 0.2.12__tar.gz

{nexforge_cli-0.2.9 → nexforge_cli-0.2.12}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: nexforge-cli
-Version: 0.2.9
+Version: 0.2.12
 Summary: NexForgeCLI — 一个面向 DeepSeek V4 的终端智能体(TUI + CLI 双模式)
 Project-URL: Homepage, https://gitee.com/Lighthorn/nexforgecli
 Author: NexForge
@@ -49,9 +49,9 @@ Description-Content-Type: text/markdown
 
 </div>
 
-NexForgeCLI 是一个运行在终端里的智能体助手,专为 **DeepSeek V4** 打造。既能作为全屏 TUI 交互式对话/编码,也能作为 one-shot 命令行工具嵌进脚本和管道。
+NexForgeCLI 是一个运行在终端里的智能体助手，既支持 DeepSeek/千问等多模型，也是**插件宿主**（plugins 目录即插即用）。既能作为全屏 TUI 交互式对话/编码，也能作为 one-shot 命令行工具嵌进脚本和管道。
 
-> 当前版本:**v0.2.5** · PyPI: `pip install nexforge-cli`
+> 当前版本:**v0.2.11** · PyPI: `pip install nexforge-cli`
 
 ---
 
@@ -81,14 +81,16 @@ API Key 获取: https://platform.deepseek.com/api_keys
 
 ## ✨ 特性
 
-- **DeepSeek V4 深度优化** —— thinking 模式、KV Cache、streaming、采样参数、JSON Mode、tool_choice 全适配
-- **TUI 全屏交互** —— Textual 驱动,流式 Markdown、可折叠思考面板、工具卡片、状态栏
-- **安全分级** —— safe/supervised/auto 三级权限,审批弹窗
+- **多模型底座** —— 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 生成计划后执行
+- **计划模式** —— 只读讨论，AI 生成计划后执行
 - **多行输入** —— F2 弹窗面板、F3 系统编辑器
 - **一键安装** —— `pip install nexforge-cli`
-- **性能优化** —— O(n²)→O(n) 流式渲染、DOM 查询缓存、I/O 异步化
 
 ---
 
@@ -125,14 +127,12 @@ nexforge -p "这个项目是做什么的?"
 
 | 文档 | 内容 |
 |------|------|
-| [总览](doc/总览.md) | 项目介绍 |
-| [安装与配置](doc/安装与配置.md) | 安装/配置/FAQ |
-| [命令与快捷键](doc/命令与快捷键.md) | 全部命令和快捷键 |
-| [工具参考](doc/工具参考.md) | AI 可调用工具说明 |
-| [会话管理](doc/会话管理.md) | 会话保存/恢复/切换 |
-| [计划模式](doc/计划模式.md) | 只读讨论模式 |
-| [权限系统](doc/权限系统.md) | 三级权限 |
-| [高级功能](doc/高级功能.md) | DeepSeek 集成/Web/技能 |
+| [01-安装与配置](manual/01-安装与配置.md) | 安装/配置/API Key |
+| [02-界面与快捷键](manual/02-界面与快捷键.md) | 全部命令和快捷键 |
+| [03-模型配置](manual/03-模型配置.md) | DeepSeek/千问/多模型接入 |
+| [04-工具参考](manual/04-工具参考.md) | AI 可调用工具说明 |
+| [08-自定义配置](manual/08-自定义配置.md) | config.toml/models.toml 全字段 |
+| [10-插件开发](manual/10-插件开发.md) | 插件宿主开发指南 |
 
 ---
 

nexforge_cli-0.2.12/README.md

@@ -0,0 +1,109 @@
+<div align="center">
+
+# ◆ NexForgeCLI
+
+**面向 DeepSeek V4 的终端智能体 · TUI + CLI 双模式**
+
+</div>
+
+NexForgeCLI 是一个运行在终端里的智能体助手，既支持 DeepSeek/千问等多模型，也是**插件宿主**（plugins 目录即插即用）。既能作为全屏 TUI 交互式对话/编码，也能作为 one-shot 命令行工具嵌进脚本和管道。
+
+> 当前版本:**v0.2.11** · 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(内置) / 千问专用底座 / 通用 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`
+
+---
+
+## 🚀 使用
+
+```bash
+# 全屏 TUI(默认)
+nexforge
+
+# 或简写
+nf
+
+# one-shot 模式
+nexforge -p "这个项目是做什么的?"
+```
+
+### 快捷键
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Enter` | 发送消息 |
+| `F1` | 帮助 |
+| `F2` | 多行输入弹窗 |
+| `F3` | 外部编辑器 |
+| `Ctrl+S` | 会话面板 |
+| `Ctrl+B` | 计划面板 |
+| `Ctrl+L` | 清屏 |
+| `Ctrl+Shift+C` | 复制 AI 回复 |
+| `Esc` | 停止/退出 |
+
+---
+
+## 📁 文档
+
+| 文档 | 内容 |
+|------|------|
+| [01-安装与配置](manual/01-安装与配置.md) | 安装/配置/API Key |
+| [02-界面与快捷键](manual/02-界面与快捷键.md) | 全部命令和快捷键 |
+| [03-模型配置](manual/03-模型配置.md) | DeepSeek/千问/多模型接入 |
+| [04-工具参考](manual/04-工具参考.md) | AI 可调用工具说明 |
+| [08-自定义配置](manual/08-自定义配置.md) | config.toml/models.toml 全字段 |
+| [10-插件开发](manual/10-插件开发.md) | 插件宿主开发指南 |
+
+---
+
+## 🧪 开发
+
+```bash
+git clone https://gitee.com/Lighthorn/nexforgecli.git
+cd nexforgecli
+pip install -e ".[dev]"
+python -m pytest -q
+```
+
+---
+
+## 📄 License
+
+MIT

nexforge_cli-0.2.12/docs/submission/README-/346/212/225/347/250/277/350/257/264/346/230/216.md

@@ -0,0 +1,67 @@
+# 投稿 NexForgeCLI 到 awesome-deepseek-agent
+
+## 已准备好的文件
+
+```
+docs/submission/
+  nexforge.md            ← 英文指南(可直接用)
+  nexforge.zh-CN.md      ← 简体中文指南(可直接用)
+```
+
+## 需要你手动做的 4 步(需要 GitHub 账号)
+
+### 第 1 步: Fork 仓库
+
+1. 打开 https://github.com/deepseek-ai/awesome-deepseek-agent
+2. 点右上角 **Fork** 到你的账号
+
+### 第 2 步: 上传两个指南文件
+
+在你的 fork 里进入 `docs/` 目录 → **Add file → Upload files**:
+
+```
+docs/nexforge.md           ← 内容取自 docs/submission/nexforge.md
+docs/nexforge.zh-CN.md     ← 内容取自 docs/submission/nexforge.zh-CN.md
+```
+
+### 第 3 步: 修改两个 README(插入表格条目)
+
+**README.md**(英文版): 在 `| **nanobot** |` 行之后、`| **Oh My Pi** |` 行之前插入:
+
+```markdown
+| **NexForgeCLI** | Open-source terminal AI coding assistant with 35 built-in tools, native DeepSeek-V4 support (1M context), data analysis, web search, and a director-loop goal mode. | [Guide](./docs/nexforge.md) |
+```
+
+**README.zh-CN.md**(中文版): 同样位置(在 nanobot 之后、Oh My Pi 之前)插入:
+
+```markdown
+| **NexForgeCLI** | 开源终端 AI 编程助手，内置 35 个工具，原生支持 DeepSeek-V4（100 万上下文）、数据分析、网络搜索与总监循环目标模式。 | [指南](./docs/nexforge.zh-CN.md) |
+```
+
+> 注意: 按字母序插入(Ne 在 na 和 Oh 之间), 不要追加到表格末尾, 否则合并冲突概率高。
+
+### 第 4 步: 提交 PR
+
+1. 在 fork 仓库页面点 **Contribute → Open Pull Request**
+2. Base: `deepseek-ai/awesome-deepseek-agent:main` ← Compare: `你的fork:main`
+3. PR 标题建议: `Add NexForgeCLI integration guide (EN + zh-CN)`
+4. 描述里注明: 双语指南在一个 PR 内、README 表格按字母序插入
+
+## 已满足的 CONTRIBUTING.md 硬性要求
+
+| 要求 | 状态 |
+|------|------|
+| 双语(英文 + 简体中文, 单 PR) | ✓ 两个文件同 PR |
+| README 表格按字母序插入 | ✓ nanobot 与 Oh My Pi 之间 |
+| 模型命名用新名 deepseek-v4-pro/flash | ✓ 全文无 v3 旧名 |
+| 1M 上下文提及/配置 | ✓ context_window = 1000000 |
+| max 思考档兼容 | ✓ auto 路由自动升级到 max |
+| 不写降级 workaround | ✓ 无 |
+| 配置字段真实存在 | ✓ 全部核实过代码 |
+| 截图 | 未涉及 |
+
+## 注意事项
+
+- 仓库托管在 **gitee**(https://gitee.com/Lighthorn/nexforgecli), PR 描述里说明即可, 不影响收录(README 表格中其他项目也有非 GitHub 托管的情况, 但多数为 GitHub; 若被要求 GitHub 镜像可再考虑)
+- 若 PR 被要求修改, 在 fork 里改对应文件, PR 会自动更新
+- 提交后把 PR 链接发我, 我可以帮你复核 diff

nexforge_cli-0.2.12/docs/submission/nexforge.md

@@ -0,0 +1,97 @@
+[English](./nexforge.md) | [简体中文](./nexforge.zh-CN.md) · [← Back](../README.md)
+
+# Integrate with NexForgeCLI
+
+NexForgeCLI is an open-source terminal AI coding assistant with 35 built-in tools covering file editing, shell execution, Git, data analysis (CSV / SQLite / text), web search, image understanding, and ops automation. It talks to `api.deepseek.com` natively with DeepSeek-V4-Pro / DeepSeek-V4-Flash, supports the full 1M-token context window, and can also drive any OpenAI-compatible or Anthropic-compatible endpoint (Kimi, GPT, Claude, …) through a single `models.toml`.
+
+- **Repository:** <https://gitee.com/Lighthorn/nexforgecli>
+- **PyPI:** <https://pypi.org/project/nexforge-cli/>
+
+#### 1. Install NexForgeCLI
+
+Requires Python 3.11+:
+
+```sh
+pip install nexforge-cli
+```
+
+Verify:
+
+```sh
+nf --version
+```
+
+#### 2. Get a DeepSeek API Key
+
+Get your API Key from the [DeepSeek Platform](https://platform.deepseek.com/api_keys), then save it:
+
+```sh
+nf --login
+```
+
+This stores the key in `~/.nexforge/auth.toml`. You can also set the `DEEPSEEK_API_KEY` environment variable — it takes precedence.
+
+#### 3. Enter a project directory and launch
+
+```sh
+cd /path/to/my-project
+nf
+```
+
+NexForgeCLI defaults to **DeepSeek-V4-Flash** with thinking enabled (effort `high`). Press `F6` to open the model sidebar and switch to **DeepSeek-V4-Pro** at any time. `auto` tier routes automatically: it starts on Flash and escalates to Pro + `max` effort when the task looks complex or tools keep failing.
+
+#### Modes
+
+| Mode | What it does |
+|---|---|
+| **safe** | Read-only tools run freely; mutations require approval. |
+| **supervised** | Reads + writes run freely; shell and deletions require approval. |
+| **auto** | Everything auto-approved (same as "YOLO"). |
+| **Plan** | Read-only investigation. No mutations, no shell (`/plan`). |
+| **Goal** | Director–worker loop: the director agent decomposes your goal, reviews each round, and issues the next instruction automatically. |
+
+#### Key shortcuts
+
+| Key | Action |
+|-----|--------|
+| `Enter` | Send the prompt |
+| `F1` | Help |
+| `F2` | Cycle approval mode (safe / supervised / auto) |
+| `F3` | Open the editor (multiline input) |
+| `F5` | Session sidebar |
+| `F6` | Model sidebar (switch provider / model / thinking) |
+| `F7` | Ops mode (validated runbook reuse) |
+| `F8` | Goal mode (director loop) |
+| `F10` | Quick reply (repeat the last prompt N times) |
+| `Esc` | Interrupt the current turn |
+| `Ctrl+L` | Clear the screen |
+
+#### Slash commands (highlights)
+
+| Command | What it does |
+|---|---|
+| `/model [flash\|pro\|auto]` | Switch tier |
+| `/think on\|off` | Toggle DeepSeek thinking mode |
+| `/provider [<name>]` | List / switch provider |
+| `/mode safe\|supervised\|auto` | Approval mode |
+| `/plan` | Enter plan mode (read-only) |
+| `/goal` | Enter goal mode (director loop) |
+| `/balance` | Query DeepSeek balance |
+| `/cost` | Show accumulated token usage and cost |
+| `/map view\|check\|sync` | View / check / sync the project map |
+| `/memory view\|add\|search` | Project memory |
+| `/federation` | Link multiple projects |
+
+#### Configuration
+
+- `~/.nexforge/config.toml` — main config (theme, icons, mode, router, pricing).
+- `~/.nexforge/models.toml` — add any OpenAI-compatible / Anthropic-compatible provider. For DeepSeek, 1M context is already set via `context_window = 1000000`; thinking mode is on by default with `reasoning_effort = "high"` (router escalates to `max` automatically).
+- `~/.nexforge/tools.json` — register external tools (git-bash, godot, …) so the agent calls them with exact paths instead of guessing. Project-level `.nexforge/tools.json` overrides the user-level one.
+- `.nexforge/map.md` — auto-synced project map (module layers, dependency graph, call graph, symbol index) refreshed every turn.
+
+#### Highlights
+
+- **Director loop (goal mode)** — the director agent (separate hidden session) decomposes goals, reviews each developer round, and keeps the loop running until the goal is achieved.
+- **Data tools** — `read_csv` (auto delimiter/encoding), `query_sqlite` (read-only, injection-safe), `inspect_text` (line/word/encoding/top-freq stats) — all stdlib, no extra deps.
+- **Search & fetch** — `search_web` (Bing HTML by default, no key needed; optional Google / DuckDuckGo / SearXNG) plus `web_fetch` (5 MB cap, streaming).
+- **Session persistence** — auto-save every turn and on exit; sessions resume after restart and are project-scoped.

nexforge_cli-0.2.12/docs/submission/nexforge.zh-CN.md

@@ -0,0 +1,97 @@
+[English](./nexforge.md) | [简体中文](./nexforge.zh-CN.md) · [← 返回](../README.zh-CN.md)
+
+# 接入 NexForgeCLI
+
+NexForgeCLI 是一款开源的终端 AI 编程助手，内置 35 个工具，覆盖文件编辑、Shell 执行、Git、数据分析（CSV / SQLite / 文本）、网络搜索、图片理解与运维自动化。原生对接 `api.deepseek.com`，支持 DeepSeek-V4-Pro 与 DeepSeek-V4-Flash 全 100 万 token 上下文，也可通过一份 `models.toml` 驱动任意 OpenAI 兼容或 Anthropic 兼容的端点（Kimi、GPT、Claude 等）。
+
+- **仓库：** <https://gitee.com/Lighthorn/nexforgecli>
+- **PyPI：** <https://pypi.org/project/nexforge-cli/>
+
+#### 1. 安装 NexForgeCLI
+
+需要 Python 3.11+：
+
+```sh
+pip install nexforge-cli
+```
+
+验证安装：
+
+```sh
+nf --version
+```
+
+#### 2. 获取 DeepSeek API Key
+
+在 [DeepSeek 开放平台](https://platform.deepseek.com/api_keys) 获取 API Key，然后保存：
+
+```sh
+nf --login
+```
+
+Key 会保存到 `~/.nexforge/auth.toml`。也可以直接设置环境变量 `DEEPSEEK_API_KEY`（优先级更高）。
+
+#### 3. 进入项目目录并启动
+
+```sh
+cd /path/to/my-project
+nf
+```
+
+NexForgeCLI 默认使用 **DeepSeek-V4-Flash**，思考模式开启（effort `high`）。随时按 `F6` 打开模型侧边栏切换到 **DeepSeek-V4-Pro**。`auto` 档位会自动路由：默认 Flash 起步，任务复杂或工具连续失败时自动升级到 Pro + `max` 思考强度。
+
+#### 模式
+
+| 模式 | 说明 |
+|---|---|
+| **safe** | 只读工具自由执行，写操作需审批。 |
+| **supervised** | 读写自由执行，Shell 与删除需审批。 |
+| **auto** | 全部自动批准（相当于 YOLO）。 |
+| **Plan** | 只读调研模式。不写文件、不执行 Shell（`/plan`）。 |
+| **Goal** | 总监-开发者循环：总监 agent 分解目标、每轮复盘审核、自动下发下一步指令。 |
+
+#### 快捷键
+
+| 按键 | 操作 |
+|-----|------|
+| `Enter` | 发送 prompt |
+| `F1` | 帮助 |
+| `F2` | 循环切换审批模式（safe / supervised / auto） |
+| `F3` | 打开编辑器（多行输入） |
+| `F5` | 会话侧边栏 |
+| `F6` | 模型侧边栏（切换 provider / 模型 / 思考模式） |
+| `F7` | 运维模式（复用已验证方案） |
+| `F8` | 目标模式（总监循环） |
+| `F10` | 快捷回复（重复上次 prompt N 次） |
+| `Esc` | 中断当前回合 |
+| `Ctrl+L` | 清屏 |
+
+#### 斜杠命令（节选）
+
+| 命令 | 说明 |
+|---|---|
+| `/model [flash\|pro\|auto]` | 切换档位 |
+| `/think on\|off` | 切换 DeepSeek 思考模式 |
+| `/provider [<name>]` | 列出 / 切换 provider |
+| `/mode safe\|supervised\|auto` | 审批模式 |
+| `/plan` | 进入计划模式（只读） |
+| `/goal` | 进入目标模式（总监循环） |
+| `/balance` | 查询 DeepSeek 余额 |
+| `/cost` | 显示累计 token 用量与费用 |
+| `/map view\|check\|sync` | 查看 / 检查 / 同步项目地图 |
+| `/memory view\|add\|search` | 项目记忆 |
+| `/federation` | 联结多个项目 |
+
+#### 配置
+
+- `~/.nexforge/config.toml` —— 主配置（主题、图标、模式、路由、定价）。
+- `~/.nexforge/models.toml` —— 添加任意 OpenAI 兼容 / Anthropic 兼容 provider。DeepSeek 已配置 1M 上下文（`context_window = 1000000`），思考模式默认开启（`reasoning_effort = "high"`，路由自动升级到 `max`）。
+- `~/.nexforge/tools.json` —— 注册外部工具（git-bash、godot 等），让 agent 用精确路径调用而不是猜测。项目级 `.nexforge/tools.json` 覆盖用户级配置。
+- `.nexforge/map.md` —— 每轮自动同步的项目地图（模块分层、依赖图、调用图、符号索引）。
+
+#### 亮点
+
+- **总监循环（目标模式）** —— 总监 agent（独立隐藏会话）分解目标、审核每一轮开发者产出、自动下发下一步指令，直到目标达成。
+- **数据工具** —— `read_csv`（自动识别分隔符/编码）、`query_sqlite`（只读、防注入）、`inspect_text`（行数/字数/编码/词频统计），全部标准库实现，零额外依赖。
+- **搜索与抓取** —— `search_web`（默认 Bing HTML，无需 Key；可选 Google / DuckDuckGo / SearXNG）与 `web_fetch`（5 MB 上限、流式读取）。
+- **会话持久化** —— 每轮与退出时自动保存，重启后恢复，按项目隔离。

{nexforge_cli-0.2.9 → nexforge_cli-0.2.12}/manual/01-/345/256/211/350/243/205/344/270/216/351/205/215/347/275/256.md

@@ -1,6 +1,6 @@
 # 安装与配置
 
-> NexForgeCLI v0.2.9
+> NexForgeCLI v0.2.12
 
 ## 环境要求
 

{nexforge_cli-0.2.9 → nexforge_cli-0.2.12}/manual/02-/347/225/214/351/235/242/344/270/216/345/277/253/346/215/267/351/224/256.md

@@ -76,9 +76,10 @@
 | `/mode safe|supervised|auto` | 切换权限级别(审批模式) |
 | `/plan` | 切换计划模式(只读讨论) |
 | `/json` | 切换 JSON 输出模式 |
-| `/goal` | 切换目标模式(总监循环) |
+| `/goal` | 切换目标模式(总监循环, 先出方案等确认再动工) |
 | `/ops` | 切换运维场景 |
-| `/max <N>` | 目标场景最大轮数(默认200) |
+| `/max <N>` | 目标场景最大轮数(0=不限额,默认0) |
+| `/timeout <N>` | 单轮执行超时秒数(0=不限额,默认0) |
 
 **会话管理**
 
@@ -100,6 +101,8 @@
 | `/memory [view|add|search]` | 管理持久记忆 |
 | `/federation init|add|context|memory` | 联结体管理 |
 | `/map view|check|sync` | 项目地图管理 |
+| `/kb search|add|list|path` | 知识库管理(检索/添加/列出/设置路径) |
+| `/plugins [list\|reload]` | 插件管理(列出/重载第三方插件) |
 | `/web start|stop` | Web 管理面板(端口8899) |
 
 **系统**
@@ -107,4 +110,5 @@
 | 命令 | 说明 |
 |------|------|
 | `/help` | 显示帮助 |
+| `/lang zh|en` | 切换界面语言(立即生效,无需重启) |
 | `/quit` | 退出 |

{nexforge_cli-0.2.9 → nexforge_cli-0.2.12}/manual/03-/346/250/241/345/236/213/351/205/215/347/275/256.md

@@ -5,6 +5,7 @@ NexForgeCLI 支持多模型：
 | 模型 | 支持方式 | 说明 |
 |------|----------|------|
 | **DeepSeek V4** | 内置 | flash/pro 双档位 + auto 自动路由，无需额外配置 |
+| **千问(qianwen)** | 专用底座 | 思考链流式显示 / enable_thinking 开关 / 多模态贴图直发(与 DeepSeek 平级) |
 | **OpenAI 兼容** | models.toml | Kimi/GPT/通义千问/智谱等一切 OpenAI 兼容接口 |
 | **Anthropic** | models.toml | Claude 系列(需安装额外依赖) |
 
@@ -20,6 +21,8 @@ DeepSeek 是内置的默认模型，首次运行只需提供 API Key 即可使
 | pro | 推理模型 | 复杂算法、架构设计、调试 |
 | auto | 自动路由 | 默认。小任务 flash，大任务自动升级 pro |
 
+**默认 flash**：deepseek 涨价后默认固定 flash 省成本；需要深度推理时用 `/model pro`，或 `/model auto` 恢复自动路由。
+
 auto 模式下的升级触发条件：
 - 关键词(重构/架构/算法/证明/调试/为什么/设计)
 - 上下文超过 200K tokens
@@ -29,6 +32,34 @@ auto 模式下的升级触发条件：
 - 默认开启，实时显示 AI 的推理过程(可折叠面板)
 - `/think off` 关闭思考(速度更快、费用更低)
 
+## 千问（qianwen 专用底座）
+
+千问AI平台(platform.qianwenai.com / 阿里云百炼)有专用 provider，深度匹配千问特性：
+
+```toml
+[[provider]]
+name = "qianwen"
+type = "qianwen"            # 专用底座(非通用 openai)
+api_key = "sk-sp-..."
+base_url = "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"
+models = ["qwen3.8-max"]
+default_model = "qwen3.8-max"
+```
+
+**千问专用特性（与 DeepSeek 平级）**：
+
+| 特性 | 说明 |
+|------|------|
+| 思考链流式显示 | reasoning_content 实时解析，UI 实时显示推理过程(与 DeepSeek 同体验) |
+| `/think on/off` | enable_thinking 开关。思考开启时复杂任务思考可达 1-2 分钟(流式实时显示思考)；关闭时快 7 倍 |
+| 多模态贴图 | 剪贴板截图直接 base64 发给模型，AI 自己看图(不再走识图工具) |
+| 识图/生图工具 | 自动跟随 qianwen provider 的 base_url/key(生图 wan2.7-image、识图 qwen3.8-max) |
+| 切换 | `/provider qianwen` |
+
+**说明**：
+- 思考型模型思考期间流式持续输出思考链，UI 不会无反应；若网络慢导致 3s 无首块，UI 会提示"深入思考中…"
+- 其他模型(如 Kimi/GLM)建议用通用 `type = "openai"` 接入，不做深度定制
+
 ## 配置多模型（models.toml）
 
 编辑 `~/.nexforge/models.toml`（首次运行自动生成模板）：
@@ -43,6 +74,8 @@ base_url = "https://api.example.com/v1"
 models = ["kimi-k3"]
 ```
 
+**加载规则（两级合并）**：`~/.nexforge/models.toml`（用户级）先加载做基线，项目 `.nexforge/models.toml`（项目级）后加载覆盖/追加同名与新增 provider。两个文件里的 provider 都会生效。
+
 ```toml
 # 示例：Claude
 [[provider]]
@@ -55,7 +88,7 @@ models = ["claude-sonnet-4-20250514"]
 
 **配置要点**：
 - `name`：唯一标识符，用于切换
-- `type`：`openai` 或 `anthropic`
+- `type`：`openai`、`anthropic` 或 `qianwen`（千问专用底座，见下）
 - `api_key`：直接填写 Key；也可留空，改用 `api_key_env` 指定环境变量名
 - `api_key_env`：可选，指定从哪个环境变量读取 Key（如 `KIMI_API_KEY`）
 - `api_key` 和 `api_key_env` 都未配置 → 回退到全局保存的 Key（`~/.nexforge/auth.toml`）

{nexforge_cli-0.2.9 → nexforge_cli-0.2.12}/manual/04-/345/267/245/345/205/267/345/217/202/350/200/203.md

@@ -47,6 +47,10 @@ NexForgeCLI 内置 **35 个工具**供 AI 调用（`git_commit` 需在 config.to
 | `search_web` | 网络搜索(默认 Bing, 可选 Google/DuckDuckGo/SearXNG) |
 | `image_vision` | 图片识别(阿里云千问 VL) |
 | `image_gen` | 图片生成(阿里云通义万相) |
+| `kb_search` | 知识库检索(全局+项目两级) |
+| `kb_write` | 知识沉淀(写入项目/全局知识库) |
+| `window_screenshot` | 指定窗口截图(Windows, 标题/进程定位, 遮挡也能截) |
+| `web_screenshot` | Web 页面离线渲染截图(无头浏览器, 不弹窗) |
 
 详见 [05-数据与搜索](05-数据与搜索.md)。
 
@@ -75,14 +79,16 @@ NexForgeCLI 内置 **35 个工具**供 AI 调用（`git_commit` 需在 config.to
 
 | 工具 | 功能 |
 |------|------|
-| `federation` | 多项目联结体管理 |
+| `federation` | 多项目联结体管理(init/add/remove/context/status/memory/sessions/handoff/close/task-add/task-list/task-done) |
+| `kb_search` | 知识检索(scope 支持 fed 聚合联结体成员、member:<名> 指定成员) |
+| `kb_write` | 知识沉淀(scope 支持 `member:<成员名>` 写回联结体成员知识库) |
 
 ## 工具限制
 
 | 限制 | 值 | 说明 |
 |------|-----|------|
 | 工具调用轮数 | 200 | 防死循环 |
-| 单轮总超时 | 300 秒 | |
+| 单轮总超时 | 0 秒(不限额) | 默认不限额; 可 /timeout <秒> 或 config.toml 的 `turn_timeout` 设置 |
 | 单工具超时 | 60 秒 | |
 
 ## 审批规则

{nexforge_cli-0.2.9 → nexforge_cli-0.2.12}/manual/05-/346/225/260/346/215/256/344/270/216/346/220/234/347/264/242.md

@@ -60,3 +60,5 @@ HTTP GET 抓取指定 URL，返回正文（截断至 20000 字符）。带浏览
 1. config.toml 中 `[image] api_key = "sk-..."`（优先）
 2. 环境变量 `DASHSCOPE_API_KEY`
 3. `~/.nexforge/dashscope.key` 文件
+
+图片工具端点独立于对话模型：默认 DashScope 全局域名（`dashscope.aliyuncs.com`），如使用业务空间专属域名可在 `[image] base_url` 另行指定。