nexforge-cli 0.2.14__tar.gz → 0.2.16__tar.gz

{nexforge_cli-0.2.14 → nexforge_cli-0.2.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: nexforge-cli
-Version: 0.2.14
+Version: 0.2.16
 Summary: NexForgeCLI — 一个面向 DeepSeek V4 的终端智能体(TUI + CLI 双模式)
 Project-URL: Homepage, https://gitee.com/Lighthorn/nexforgecli
 Author: NexForge
@@ -51,7 +51,7 @@ Description-Content-Type: text/markdown
 
 NexForgeCLI 是一个运行在终端里的智能体助手，既支持 DeepSeek/千问等多模型，也是**插件宿主**（plugins 目录即插即用）。既能作为全屏 TUI 交互式对话/编码，也能作为 one-shot 命令行工具嵌进脚本和管道。
 
-> 当前版本:**v0.2.14** · PyPI: `pip install nexforge-cli`
+> 当前版本:**v0.2.16** · PyPI: `pip install nexforge-cli`
 
 ---
 

{nexforge_cli-0.2.14 → nexforge_cli-0.2.16}/README.md

@@ -8,7 +8,7 @@
 
 NexForgeCLI 是一个运行在终端里的智能体助手，既支持 DeepSeek/千问等多模型，也是**插件宿主**（plugins 目录即插即用）。既能作为全屏 TUI 交互式对话/编码，也能作为 one-shot 命令行工具嵌进脚本和管道。
 
-> 当前版本:**v0.2.14** · PyPI: `pip install nexforge-cli`
+> 当前版本:**v0.2.16** · PyPI: `pip install nexforge-cli`
 
 ---
 

{nexforge_cli-0.2.14 → nexforge_cli-0.2.16}/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.14
+> NexForgeCLI v0.2.16
 
 ## 环境要求
 

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

@@ -9,10 +9,10 @@
 │  [用户消息]                                              │
 │  [AI 回复 · 思考面板(可折叠) · 工具调用卡片]           │
 │                                                          │
-│  ── 本轮结束 · F4 复制最后回复                          │
+│  ── 本轮结束 · Ctrl+C 复制最后回复                          │
 ├── 输入区 ────────────────────────────────────────────────┤
 │ > 请输入…                                                │
-│ F1帮助 · F2模式 · F3编辑器 · F5会话 · F6模型 · F10快捷回复│
+│ F1帮助 · F2模式 · F3编辑 · F4文件 · F5会话 · F6模型 · F10快捷回复│
 ├── 状态栏 ────────────────────────────────────────────────┤
 │ 🔥 全自动 · deepseek · flash · 思考:开 · 8k token · ¥0.00│
 └──────────────────────────────────────────────────────────┘
@@ -43,19 +43,35 @@
 | `F1` | 帮助 |
 | `F2` | 切换审批模式(审批/半自动/全自动) |
 | `F3` | 系统默认编辑器编辑文本 |
-| `F4` | 复制最后一条 AI 回复 |
+| `F4` | 文件浏览器侧边栏(点击引用/右键编辑) |
 | `F5` | 会话侧边栏(切换/重命名/删除) |
 | `F6` | 模型选择侧边栏 |
 | `F7` | 切换运维模式 |
 | `F8` | 切换目标模式(总监循环) |
 | `F9` | 粘贴截图 |
 | `F10` | 激活快捷回复 |
-| `Ctrl+C` | 复制最后 AI 回复(备选键) |
+| `Ctrl+C` | 复制最后 AI 回复 |
 | `Ctrl+L` | 清屏 |
 | `↑/↓` | 滚动对话 |
 | `PageUp/PageDown` | 上下翻页 |
 | `End` | 滚到底部 |
 
+## 文件浏览器
+
+按 `F4` 打开右侧文件浏览器。打开后**直接显示项目根下的文件与目录**(树形,自动隐藏 `.git`、`__pycache__`、`.nexforge` 等噪音目录):
+
+| 操作 | 效果 |
+|------|------|
+| 点击文件 | 引用文件路径到输入框,可继续输入指令 |
+| 点击目录 | 展开/折叠该目录 |
+| 右键文件 | 弹出操作菜单(引用路径 / 打开编辑 / 复制路径 / 复制内容) |
+| 右键目录 | 弹出操作菜单(引用目录路径 / 在系统文件管理器中打开 / 复制路径) |
+
+- **引用**：把文件/目录路径(项目根内为相对路径)插入输入框,聚焦后可直接补充"分析这个文件"之类指令
+- **打开编辑**：文件用系统默认程序打开(Windows 记事本/关联程序、macOS `open`、Linux `xdg-open`)；目录则在系统文件管理器中打开
+- **复制内容**：复制文件文本内容到剪贴板(超过 512KB 拒绝,防止卡顿)
+- 键盘：F4 打开后焦点即在文件树,`↑/↓` 移动、`→` 展开、`Enter` 引用选中项、`Esc` 关闭并回输入框
+
 ## 斜杠命令
 
 **模型与账户**

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

@@ -4,7 +4,7 @@ NexForgeCLI 支持多模型：
 
 | 模型 | 支持方式 | 说明 |
 |------|----------|------|
-| **DeepSeek V4** | 内置 | flash/pro 双档位 + auto 自动路由，无需额外配置 |
+| **DeepSeek V4** | 内置(models.toml 可扩展) | flash/pro/auto 档位开箱可用；也可在 models.toml 挂独立模型(如实验版) |
 | **千问(qianwen)** | 专用底座 | 思考链流式显示 / enable_thinking 开关 / 多模态贴图直发(与 DeepSeek 平级) |
 | **OpenAI 兼容** | models.toml | Kimi/GPT/通义千问/智谱等一切 OpenAI 兼容接口 |
 | **Anthropic** | models.toml | Claude 系列(需安装额外依赖) |
@@ -34,6 +34,19 @@ auto 模式下的升级触发条件：
 - 默认开启，实时显示 AI 的推理过程(可折叠面板)
 - `/think off` 关闭思考(速度更快、费用更低)
 
+**挂独立模型**：DeepSeek 的 flash/pro 是内置档位，若想使用内置档位之外的模型(如限时实验版 `deepseek-v4.1-flash-expires-on-0910`)，可在 `~/.nexforge/models.toml` 加一个 `type = "deepseek"` 的 provider：
+
+```toml
+[[provider]]
+name = "deepseek-exp"
+type = "deepseek"
+base_url = "https://api.deepseek.com"
+models = ["deepseek-v4.1-flash-expires-on-0910"]
+default_model = "deepseek-v4.1-flash-expires-on-0910"
+```
+
+provider 的模型解析优先级：显式 `/model <名>` > `default_model` > `models` 第一个 > 内置 flash/pro。未配置 api_key 时自动回退全局 Key(`auth.toml`)。重启后在 F6 侧边栏点选即可切换。
+
 ## 千问（qianwen 专用底座）
 
 千问AI平台(platform.qianwenai.com / 阿里云百炼)有专用 provider，深度匹配千问特性：

{nexforge_cli-0.2.14 → nexforge_cli-0.2.16}/manual/README.md

@@ -1,4 +1,4 @@
-# NexForgeCLI 用户手册 · v0.2.14
+# NexForgeCLI 用户手册 · v0.2.16
 
 ## 这是什么
 

{nexforge_cli-0.2.14 → nexforge_cli-0.2.16}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nexforge-cli"
-version = "0.2.14"
+version = "0.2.16"
 description = "NexForgeCLI — 一个面向 DeepSeek V4 的终端智能体(TUI + CLI 双模式)"
 readme = "README.md"
 requires-python = ">=3.11"

{nexforge_cli-0.2.14 → nexforge_cli-0.2.16}/src/nexforge/__init__.py

@@ -3,5 +3,5 @@
 TUI(全屏交互)+ CLI(one-shot / 管道)双模式。
 """
 
-__version__ = "0.2.14"
+__version__ = "0.2.16"
 __all__ = ["__version__"]

{nexforge_cli-0.2.14 → nexforge_cli-0.2.16}/src/nexforge/core/goal_manager.py

@@ -9,6 +9,13 @@ from datetime import datetime, timezone
 
 DEFAULT_MAX_ROUNDS = 100
 
+# 目标/计划注入总监与开发者上下文的截断上限(字符)。
+# 目标必须完整传递: 长目标下截断会丢失后半部分(任务边界/次要目标/灵活处理等),
+# 导致总监/开发者做出错误判断(历史 bug: [:200]/[:300] 截断致目标信息丢失)。
+# 计划是中间产物(总监会重新生成), 可适当截断以控制 token。
+GOAL_CTX_LIMIT = 4000
+PLAN_CTX_LIMIT = 2000
+
 DIRECTOR_PROMPT = """[总监模式]
 你是项目总监,负责对整个开发周期做全局把控、目标分解和质量评审。
 

{nexforge_cli-0.2.14 → nexforge_cli-0.2.16}/src/nexforge/features/mode_features.py

@@ -9,6 +9,7 @@ from nexforge.features.base import Feature
 from nexforge.config import save_config
 from nexforge.i18n import t
 from nexforge.core.context import get_project_root
+from nexforge.core.goal_manager import GOAL_CTX_LIMIT, PLAN_CTX_LIMIT
 from nexforge.core.memory_engine import MemoryEngine, _MARKER_OPS, _MARKER_GOAL, clear_messages_by_marker, has_marker
 
 if TYPE_CHECKING:
@@ -106,6 +107,7 @@ class GoalModeFeature:
         if gm.rounds_dir.exists():
             shutil.rmtree(gm.rounds_dir, ignore_errors=True)
         gm.rounds_dir.mkdir(parents=True, exist_ok=True)
+        self._stop_director = False  # 复位停止标志, 防残留导致恢复的循环立即退出
         self._turn_count = 1
         # 清理残留状态(防上次崩溃遗留 dev_done_flag 导致重复验收)
         self._dev_done_flag = False
@@ -246,14 +248,19 @@ class GoalModeFeature:
         from nexforge.core.goal_manager import GoalManager
         gm = GoalManager(get_project_root())
         goal = gm.read_goal()
-        gm.set_goal(goal + "\n\n[用户补充意见]\n" + feedback[:500])
+        gm.set_goal(goal + "\n\n[用户补充意见]\n" + feedback[:2000])
         self._awaiting_plan_confirm = False
         self._turn_count = 0  # 让重新规划回复再次作为 turn=1(方案轮)
         s._note(t("note.goal_plan_amended"), scroll=True)
+        # 修复: 用户反馈必须完整传给总监, 不能依赖 read_goal()[:300] 截断。
+        # 旧实现把反馈追加到 goal 文件末尾后, 仅取前 300 字符作为 prompt,
+        # 而反馈永远位于 300 字符之后 → 总监收不到修改意见
+        # (表现为"传输截断/未检测到新的修改意见正文")。
         s._run_agent(
             "[项目总监] 用户对初步方案提出了修改意见, 请结合意见重新规划方案。"
             "注意: 先输出规划方案, 不要发布执行指令, 等待用户确认后再动工。\n"
-            "目标:" + gm.read_goal()[:300]
+            "【原始目标】\n" + goal +
+            "\n\n【用户本次修改意见】\n" + feedback[:2000]
         )
 
     def _fed_members_prompt(self) -> str:
@@ -348,8 +355,8 @@ class GoalModeFeature:
         from nexforge.core.goal_manager import GoalManager
         s = self.screen
         gm = GoalManager(get_project_root())
-        goal = gm.read_goal()[:300]
-        plan = gm.read_plan()[:300]
+        goal = gm.read_goal()[:GOAL_CTX_LIMIT]
+        plan = gm.read_plan()[:PLAN_CTX_LIMIT]
         fed_members = self._fed_members_prompt()  # 联结体成员(跨项目编排)
         ctx = (
             "[项目总监] 首次目标分解。\n"
@@ -387,13 +394,13 @@ class GoalModeFeature:
         max_r = s.config.ui.max_rounds
         cycle_n = self._turn_count - 1
         report = (report or self._dev_report)[:2000]
-        goal = gm.read_goal()[:300]
-        plan = gm.read_plan()[:300]
+        goal = gm.read_goal()[:GOAL_CTX_LIMIT]
+        plan = gm.read_plan()[:PLAN_CTX_LIMIT]
         fed_members = self._fed_members_prompt()
         ctx = (
             "[项目总监复盘] 第" + str(cycle_n) + "/" + str(max_r) + "轮。\n"
             "目标:" + goal + "\n"
-            "计划:" + plan[:500] + "\n"
+            "计划:" + plan + "\n"
             "开发者报告:" + report + "\n\n"
             "请按审核框架复盘:\n"
             "1. 本轮完成了多少?(核心/重要/次要)\n"
@@ -435,7 +442,7 @@ class GoalModeFeature:
         from nexforge.core.goal_manager import GoalManager
         s = self.screen
         gm = GoalManager(get_project_root())
-        goal = gm.read_goal()[:300]
+        goal = gm.read_goal()[:GOAL_CTX_LIMIT]
         dev_status = "开发者正在执行中" if self._dev_busy else "开发者空闲, 等待下一任务"
         ctx = (
             "[项目总监] 用户在工作进行中与你沟通(下栏沟通区)。\n"
@@ -461,15 +468,15 @@ class GoalModeFeature:
         s = self.screen
         gm = GoalManager(get_project_root())
         max_r = s.config.ui.max_rounds
-        goal = gm.read_goal()[:300]
-        plan = gm.read_plan()[:300]
+        goal = gm.read_goal()[:GOAL_CTX_LIMIT]
+        plan = gm.read_plan()[:PLAN_CTX_LIMIT]
         s.call_later(s._mount, DirectorNote(
             t("note.dev_round", n=str(round_n), mx=str(max_r))
         ), dev=True)
         msg = (
             "[开发者] 第" + str(round_n) + "/" + str(max_r) + "轮。\n"
             "目标:" + goal + "\n"
-            "计划:" + plan[:500] + "\n"
+            "计划:" + plan + "\n"
             "总监指令:" + instruction[:2000] + "\n\n"
             "请按指令执行。完成后提交执行报告。"
             "若遇到不可逾越的障碍,在报告开头标注 [BLOCKED]。"
@@ -502,6 +509,35 @@ class GoalModeFeature:
             self._resume_director_loop()
         self._wake_event.set()
 
+    def reset_for_session_change(self) -> None:
+        """会话切换/新建时完整重置目标模式运行状态(不关闭 goal_mode 开关)。
+
+        目标文件(goal/plan/rounds)是项目级跨会话共享,但总监循环是内存态。
+        切换会话时旧循环被 cancel, 若运行状态(_turn_count/_dev_done_flag/
+        _stop_director 等)残留, 新会话输入会走错分支:
+        - _turn_count 残留 → 方案生成后 on_turn_done 跳过 turn=1 分支,
+          方案不落盘、不进入待确认, 总监循环无法启动
+        - 旧目标文件残留 → 新会话输入被误判为"旧目标插话"入队, 循环又没恢复
+        结果都表现为"AI 回复一段就停, 必须反复输入才能继续"。
+        这里清零运行状态 + 清理目标文件, 让切换后输入作为全新目标进入正常流程。
+        """
+        self._stop_director = False  # 关键: 复位停止标志, 否则恢复的循环立即退出
+        self._awaiting_plan_confirm = False
+        self._director_busy = False
+        self._turn_count = 0  # 关键: 复位轮次, 否则方案生成后 on_turn_done 走错分支
+        self._user_inbox.clear()
+        self._dev_busy = False
+        self._dev_done_flag = False
+        self._dev_report = ""
+        self._director_loop_task = None
+        self._wake_event.clear()
+        # 清理目标文件, 防旧目标残留被误判为插话
+        try:
+            from nexforge.core.goal_manager import GoalManager
+            GoalManager(get_project_root()).cleanup()
+        except Exception:
+            pass
+
     def _stop_director_loop(self) -> None:
         """停止总监循环。"""
         self._stop_director = True

{nexforge_cli-0.2.14 → nexforge_cli-0.2.16}/src/nexforge/features/session_feature.py

@@ -109,7 +109,17 @@ class SessionFeature:
         s._director_session_id = ""
         s.session = Session()
         s.session.messages = list(msgs)
-        if not msgs or msgs[0].get("role") != "system":
+        # 系统提示判断: 摘要 system 消息(历史压缩)不算完整系统提示,
+        # 必须注入 DEFAULT_SYSTEM(否则 AI 缺失行为规范, 只回复一段就停)。
+        # 与 _auto_resume 保持一致 —— 原判断只看首条 role, 而压缩过的会话
+        # 首条是 "[历史摘要" system 消息(save_session 只回显摘要 system),
+        # 会误判为已有 system 而漏注入 DEFAULT_SYSTEM。
+        has_full_sys = any(
+            m.get("role") == "system"
+            and str(m.get("content", "")).startswith("【推理要求】")
+            for m in s.session.messages
+        )
+        if not has_full_sys:
             s.session.messages.insert(0, {"role": "system", "content": DEFAULT_SYSTEM})
         s._session_id = info.id
         s._session_name = info.name
@@ -145,11 +155,20 @@ class SessionFeature:
     # ---- 自动保存 ----
 
     def _reset_goal_confirm(self) -> None:
-        """切换/新建会话时重置目标模式方案确认状态(防残留误路由)。"""
+        """切换/新建会话时完整重置目标模式运行状态(防残留误路由)。
+
+        修复: 之前只重置 _awaiting_plan_confirm, 而 _turn_count/_dev_done_flag/
+        _stop_director 等运行状态与旧目标文件(项目级)残留, 导致切换会话后
+        总监循环无法正确恢复, 表现为"AI 回复一段就停, 必须反复输入才能继续"。
+        """
         try:
             gf = next((f for f in self.screen._features._features
                        if getattr(f, 'name', '') == 'goal_mode'), None)
-            if gf is not None:
+            if gf is None:
+                return
+            if hasattr(gf, 'reset_for_session_change'):
+                gf.reset_for_session_change()
+            else:
                 gf._awaiting_plan_confirm = False
         except Exception:
             pass

{nexforge_cli-0.2.14 → nexforge_cli-0.2.16}/src/nexforge/i18n.py

@@ -50,8 +50,8 @@ def t(key: str, **fmt: str) -> str:
 MESSAGES: dict[str, dict[str, str]] = {
     # ---- 底部提示行 --------------------------------------------------------
     "ui.prompt_hint": {
-        "zh": "F1帮助 · F2模式 · F3编辑 · F4复制 · F5会话 · F6模型 · F7运维 · F8目标 · F9粘贴截图 · F10快捷回复 · Ctrl+L清屏 · Esc退出 · Enter发送",
-        "en": "F1 help · F2 mode · F3 editor · F4 copy · F5 sessions · F6 models · F7 ops · F8 goal · F9 paste image · F10 quick reply · Ctrl+L clear · Esc quit · Enter send",
+        "zh": "F1帮助 · F2模式 · F3编辑 · F4文件 · F5会话 · F6模型 · F7运维 · F8目标 · F9粘贴截图 · F10快捷回复 · Ctrl+L清屏 · Esc退出 · Enter发送",
+        "en": "F1 help · F2 mode · F3 editor · F4 files · F5 sessions · F6 models · F7 ops · F8 goal · F9 paste image · F10 quick reply · Ctrl+L clear · Esc quit · Enter send",
     },
     "ui.banner_sub": {
         "zh": "多模型终端智能体",
@@ -178,6 +178,14 @@ MESSAGES: dict[str, dict[str, str]] = {
     "note.lang_switched": {"zh": "界面语言已切换", "en": "UI language switched"},
     "note.copied_last": {"zh": "已复制最后一条 AI 回复。", "en": "Copied the last AI reply."},
     "note.no_reply": {"zh": "暂无 AI 回复。", "en": "No AI reply yet."},
+    "note.file_referenced": {"zh": "已引用 {path}", "en": "Referenced {path}"},
+    "note.file_opened": {"zh": "已打开 {path}", "en": "Opened {path}"},
+    "note.file_open_fail": {"zh": "打开失败: {exc}", "en": "Open failed: {exc}"},
+    "note.file_path_copied": {"zh": "路径已复制", "en": "Path copied"},
+    "note.file_content_copied": {"zh": "内容已复制", "en": "Content copied"},
+    "note.file_too_large": {"zh": "文件过大(>512KB), 未复制", "en": "File too large (>512KB), not copied"},
+    "note.file_read_fail": {"zh": "读取失败: {exc}", "en": "Read failed: {exc}"},
+    "note.copy_fail": {"zh": "复制失败(剪贴板不可用)", "en": "Copy failed (clipboard unavailable)"},
     "note.qr_not_set": {"zh": "未设置快捷回复。请先 /qr <文本>", "en": "Quick reply not set. Use /qr <text> first"},
     "note.qr_activated": {"zh": "快捷回复已激活({n}次): {txt}", "en": "Quick reply activated ({n}x): {txt}"},
     "note.director_stopped": {
@@ -187,7 +195,7 @@ MESSAGES: dict[str, dict[str, str]] = {
     "note.task_stopped": {"zh": "⏹ 已停止当前 AI 任务。", "en": "⏹ Current AI task stopped."},
     "note.turn_timeout": {"zh": "⏱ 单轮执行超时({n}秒),已中断。可调整 config.toml 的 turn_timeout。", "en": "⏱ Turn timeout ({n}s) reached, interrupted. Adjust turn_timeout in config.toml."},
     "note.output_truncated": {"zh": "✂️ 输出达到长度上限被截断, 输入\"继续\"可续写 (可调大 config.toml 的 max_output_tokens)", "en": "✂️ Output truncated by length limit. Type \"continue\" to resume (raise max_output_tokens in config.toml)."},
-    "note.turn_done": {"zh": "── 本轮结束 · F4 复制最后回复", "en": "── Turn done · F4 to copy last reply"},
+    "note.turn_done": {"zh": "── 本轮结束 · Ctrl+C 复制最后回复", "en": "── Turn done · Ctrl+C to copy last reply"},
     "note.quick_reply_remaining": {"zh": "📨 快捷回复({n}次剩余): {txt}", "en": "📨 Quick reply ({n} left): {txt}"},
     "note.verifying_provider": {"zh": "正在验证 {name}...", "en": "Verifying {name}..."},
     "note.verifying_all": {"zh": "正在验证所有 provider...", "en": "Verifying all providers..."},
@@ -316,6 +324,15 @@ MESSAGES: dict[str, dict[str, str]] = {
     "img.clear": {"zh": "✖ 清空全部", "en": "✖ Clear all"},
     "img.empty": {"zh": "(无截图)", "en": "(no images)"},
 
+    # ---- 文件浏览器 ---------------------------------------------------------
+    "filebrowser.title": {"zh": "📂 文件浏览", "en": "📂 Files"},
+    "filebrowser.hint": {"zh": "点击文件=引用 · 右键=操作 · 点目录=展开", "en": "Click file=reference · Right-click=actions · Click dir=expand"},
+    "filebrowser.menu.title": {"zh": "文件操作", "en": "File actions"},
+    "filebrowser.menu.ref": {"zh": "引用路径到输入框", "en": "Reference path to prompt"},
+    "filebrowser.menu.edit": {"zh": "打开(系统程序)", "en": "Open with system app"},
+    "filebrowser.menu.copy_path": {"zh": "复制路径", "en": "Copy path"},
+    "filebrowser.menu.copy_content": {"zh": "复制文件内容", "en": "Copy file content"},
+
     # ---- 消息组件 ---------------------------------------------------------
     "msg.director_review": {"zh": "◆ 项目总监 · 审核意见", "en": "◆ Director · Review"},
     "msg.director_label": {"zh": "◆ 项目总监: ", "en": "◆ Director: "},

{nexforge_cli-0.2.14 → nexforge_cli-0.2.16}/src/nexforge/provider/deepseek.py

@@ -50,6 +50,7 @@ class DeepSeekProvider(BaseProvider):
         api_key: str | None = None,
     ):
         self.config = config
+        self.pdef = pdef
         key = api_key or config.resolve_api_key()
         if not key:
             raise ProviderError(
@@ -68,6 +69,7 @@ class DeepSeekProvider(BaseProvider):
         """用明确 key 创建 Provider(跳过 resolve_api_key 链)。"""
         inst = cls.__new__(cls)
         inst.config = config
+        inst.pdef = None
         inst._client = AsyncOpenAI(
             api_key=api_key,
             base_url=config.provider.base_url,
@@ -81,12 +83,27 @@ class DeepSeekProvider(BaseProvider):
 
     # ── 多模态(视觉模型) ────────────────────────────────────
 
+    def _resolve_model(self, tier: Tier | None, model: str | None = None) -> str:
+        """解析实际使用的模型名。
+
+        优先级: 显式传入 model > pdef.default_model > pdef.models[0] > 内置 tier 映射。
+        支持 models.toml 里以 type="deepseek" 注册独立模型(如实验版 flash 变体),
+        不再被内置 config.models.flash/pro 写死。
+        """
+        if model:
+            return model
+        if self.pdef and self.pdef.default_model:
+            return self.pdef.default_model
+        if self.pdef and self.pdef.models:
+            return self.pdef.models[0]
+        return self.config.model_id(tier)
+
     @property
     def current_model(self) -> str:
         """当前使用的模型名(最近一次调用或默认档位)。"""
         if getattr(self, "_last_model", ""):
             return self._last_model
-        return self.config.model_id(self.config.models.default_tier)
+        return self._resolve_model(self.config.models.default_tier)
 
     def supports_model_multimodal(self, model: str = "") -> bool:
         """视觉模型(模型名含 vision)支持图片输入。"""
@@ -157,6 +174,7 @@ class DeepSeekProvider(BaseProvider):
         tier: Tier | None,
         thinking: bool | None,
         effort: Effort | None,
+        model: str | None = None,
     ) -> dict:
         cfg = self.config
         think = cfg.models.thinking if thinking is None else thinking
@@ -169,7 +187,7 @@ class DeepSeekProvider(BaseProvider):
             extra_body["reasoning_effort"] = eff
 
         kwargs: dict[str, Any] = {
-            "model": cfg.model_id(tier),
+            "model": self._resolve_model(tier, model),
             "messages": messages,
             "stream": True,
             "stream_options": {"include_usage": True},
@@ -215,14 +233,14 @@ class DeepSeekProvider(BaseProvider):
         thinking: bool | None = kwargs.get("thinking")
         effort: Effort | None = kwargs.get("effort")
         resolved_tier: Tier = tier or self.config.models.default_tier
-        model_id = model or self.config.model_id(tier)
+        model_id = self._resolve_model(tier, model)
         self._last_model = model_id  # 供 current_model / 多模态判断
         # 视觉模型: 强制 thinking off(exp 模型未确认支持思考模式, 避免 400)
         if "vision" in model_id.lower() and thinking is not False:
             thinking = False
         # 多模态: 把 [图片附件: 路径] 展开为 base64 image_url
         messages = self._expand_image_attachments(messages, model_id)
-        bkwargs = self._build_kwargs(messages, tools, tier, thinking, effort)
+        bkwargs = self._build_kwargs(messages, tools, tier, thinking, effort, model_id)
 
         content = ""
         reasoning = ""