fr-cli 2.4.0__tar.gz → 2.4.2__tar.gz

{fr_cli-2.4.0 → fr_cli-2.4.2}/MANIFEST.in

@@ -1,5 +1,6 @@
 include fr_cli/WEAPON.MD
 include fr_cli/README.md
+include fr_cli/conf/default_models.yaml
 include fr_cli/assets/*.jpeg
 include fr_cli/assets/*.png
 include fr_cli/assets/*.jpg

{fr_cli-2.4.0/fr_cli.egg-info → fr_cli-2.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fr-cli
-Version: 2.4.0
+Version: 2.4.2
 Summary: 凡人打字机 - 支持多模型(Zhipu/DeepSeek/Kimi/Qwen/StepFun/MiniMax/Spark/Doubao/MiMo)的终极全能终端工具
 Author: FANREN CLI Author
 License-Expression: MIT
@@ -84,6 +84,7 @@ Dynamic: license-file
 支持以下 AI 模型提供商：
 - **智谱 AI**: GLM-4-Flash 等
 - **智谱 Coding Plan**: GLM-4.7 等 (https://docs.bigmodel.cn/cn/coding-plan/quick-start)
+- **OpenAI**: GPT-4o / GPT-4o-mini / o1-mini / o3-mini 等（标准 OpenAI 接口）
 - **DeepSeek**: DeepSeek-Chat 等
 - **Kimi (Moonshot)**: moonshot-v1-8k 等
 - **Kimi K2**: 代码优化版 kimi-k2-0905-preview
@@ -122,6 +123,7 @@ Dynamic: license-file
 - **MCP 外部神通**：支持 Model Context Protocol
 - **多源信息融合**：大模型 + 工具结果统一汇总
 - **中英文切换**：完整国际化支持
+- **NO_COLOR 支持**：`NO_COLOR=1` 禁用所有 ANSI 颜色，适合 CI/管道环境
 
 ## 🚀 快速开始
 
@@ -135,10 +137,10 @@ fr-cli
 # 或从源码运行
 cd fr-cli
 pip install -e .
-python3 main.py
+fr-cli
 ```
 
-首次运行会引导输入当前道统的 API Key。
+首次运行会引导输入当前道统的 API Key。直接回车可进入 Mock 模式试用。
 
 ## 📝 使用方法
 
@@ -155,11 +157,16 @@ python3 main.py
 /load               加载历史会话
 /export             导出会话为 Markdown
 
-/model <模型名>              切换AI模型
+/model <模型名>              切换AI模型（仅当前会话生效）
 /model <道统>:<模型名>       同时切换道统和模型
+/model config               🆕 交互式模型配置向导
+/model list                 列出所有可用模型
+/model current              显示当前模型
+/model default              恢复 factory 默认模型
 /key <key>                   修改当前道统 API Key
 /key <道统> <key>            为指定道统设置 Key
 /providers                   查看所有道统配置
+/providers setup            交互式配置向导
 /providers add <p> <k> [m]   添加/更新道统配置
 /providers use <p>           切换到指定道统
 
@@ -173,23 +180,46 @@ python3 main.py
 /exit              退出
 ```
 
-### 🤖 AI 模型切换示例
+### 🖥️ 非交互 / 批处理模式
+
+fr-cli 支持在不进入 REPL 的情况下执行单次命令或单次 AI 对话，适用于脚本、cron、管道等场景：
+
+```bash
+# 执行一条 slash 命令后退出
+fr-cli -c "/model current"
+fr-cli -c "/ls"
+
+# 向 AI 提问后退出
+fr-cli "请总结 README.md"
+fr-cli -p "Python 如何读取 JSON？"
 
+# 从文件或标准输入读取提示词
+cat article.txt | fr-cli -s
+fr-cli -f prompt.txt
+
+# 静默模式（跳过启动 banner，只输出核心结果）
+fr-cli -q -c "/model current"
+fr-cli -q -p "1+1等于几"
 ```
-# 使用 Kimi K2（代码优化版）
-/model kimi-k2
 
-# 使用 MiniMax M2.7（Token Plan）
-/model minimax-m27
+### 🤖 AI 模型配置
+
+```bash
+# 交互式配置向导（推荐）
+>>> /model config
 
-# 使用 Step-3（阶跃星辰）
-/model step-3
+# 直接切换（仅当前会话生效，重启后恢复 factory 默认）
+>>> /model deepseek-chat
+>>> /model deepseek:deepseek-reasoner
 
-# 使用 Kimi Code
-/model kimi-code
+# 查看当前模型
+>>> /model current
+
+# 恢复 factory 默认模型
+>>> /model default
 
 # 配置新的 API Key
-/providers add step-3 <your-api-key>
+>>> /providers add step-3 <your-api-key>
 ```
 
 ### 🔧 Agent 管理
@@ -306,30 +336,33 @@ fr acp
 
 ## 🤖 支持的模型提供商（25+）
 
-| 道统 | 默认模型 | API 地址 |
-|------|---------|----------|
-| zhipu | glm-4-flash | - |
-| zhipu-coding | GLM-4.7 | open.bigmodel.cn/api/coding/paas/v4 |
-| zhipu-anthropic | glm-4.6 | open.bigmodel.cn/api/anthropic |
-| deepseek | deepseek-chat | api.deepseek.com |
-| kimi | moonshot-v1-8k | api.moonshot.cn |
-| kimi-k2 | kimi-k2-0905-preview | api.moonshot.cn |
-| kimi-code | kimi-for-coding | api.kimi.com/coding/v1 |
-| qwen | qwen-turbo | dashscope.aliyuncs.com |
-| stepfun | step-1-8k | api.stepfun.com |
-| step-1 | step-1-8k | api.stepfun.com |
-| step-2 | step-2-16k | api.stepfun.com |
-| step-3 | step-3-auto | api.stepfun.com |
-| step-audio | step-audio-2 | api.stepfun.com |
-| minimax | MiniMax-Text-01 | api.minimax.chat |
-| minimax-m27 | MiniMax-M2.7 | api.minimax.chat |
-| minimax-m27-fast | MiniMax-M2.7-HighSpeed | api.minimax.chat |
-| minimax-token-plan | MiniMax-M2.7 | api.minimax.chat |
-| spark | generalv3.5 | spark-api-open.xf-yun.com |
-| doubao | doubao-1-5-pro-32k-250115 | ark.cn-beijing.volces.com |
-| mimo | mimo-v2-flash | api.xiaomimimo.com |
-| longcat | LongCat-Flash-Chat | api.longcat.chat/openai |
-| longcat-anthropic | LongCat | api.longcat.chat/anthropic |
+| 道统 | 默认模型 | API 地址 | 常用模型 |
+|------|---------|----------|---------|
+| zhipu | glm-4-flash | open.bigmodel.cn/api/paas/v4 | glm-4-flash, glm-4-plus, glm-4, glm-4v-plus, glm-4-air, glm-4-long |
+| zhipu-coding | GLM-4.7 | open.bigmodel.cn/api/coding/paas/v4 (Coding Plan) | GLM-4.7, GLM-5.1, GLM-4.5-air |
+| zhipu-anthropic | glm-4.6 | open.bigmodel.cn/api/anthropic | glm-4.6 |
+| openai | gpt-4o-mini | api.openai.com/v1 | gpt-4o, gpt-4o-mini, gpt-4-turbo, gpt-3.5-turbo, o1-mini, o3-mini |
+| deepseek | deepseek-chat | api.deepseek.com | deepseek-chat, deepseek-reasoner, deepseek-coder |
+| kimi | moonshot-v1-8k | api.moonshot.cn | moonshot-v1-8k, moonshot-v1-32k, moonshot-v1-128k |
+| kimi-k2 | kimi-k2-0905-preview | api.moonshot.cn | kimi-k2-0905-preview |
+| kimi-code | kimi-for-coding | api.kimi.com/coding/v1 | kimi-for-coding |
+| qwen | qwen-turbo | dashscope.aliyuncs.com | qwen-turbo, qwen-plus, qwen-max, qwen-coder-plus |
+| stepfun | step-1-8k | api.stepfun.com (api.stepfun.com/step_plan/v1 for Step Plan) | step-1-8k, step-1-32k, step-2-16k, step-3-auto |
+| step-1 | step-1-8k | api.stepfun.com | step-1-8k |
+| step-2 | step-2-16k | api.stepfun.com | step-2-16k |
+| step-3 | step-3-auto | api.stepfun.com | step-3-auto |
+| step-audio | step-audio-2 | api.stepfun.com | step-audio-2 |
+| stepfun-step-plan | step-3-auto | api.stepfun.com/step_plan/v1 (Step Plan) | step-3-auto, step-2-16k, step-1-8k |
+| minimax | MiniMax-Text-01 | api.minimax.io (api.minimax.chat for Token Plan) | MiniMax-Text-01, MiniMax-M2.1, abab6.5s-chat, abab6.5t-chat |
+| minimax-m27 | MiniMax-M2.7 | api.minimax.chat (Token Plan) | MiniMax-M2.7 |
+| minimax-m27-fast | MiniMax-M2.7-HighSpeed | api.minimax.chat (Token Plan) | MiniMax-M2.7-HighSpeed |
+| minimax-token-plan | MiniMax-M2.7 | api.minimax.chat (Token Plan) | MiniMax-M2.7 |
+| spark | generalv3.5 | spark-api-open.xf-yun.com | generalv3.5 |
+| doubao | doubao-1-5-pro-32k-250115 | ark.cn-beijing.volces.com | doubao-1-5-pro-32k, doubao-1-5-lite-32k |
+| mimo | mimo-v2-flash | api.xiaomimimo.com | mimo-v2-flash, mimo-v2-pro |
+| mimo-token-plan | mimo-v2-flash | token-plan-sgp.xiaomimimo.com (Token Plan) | mimo-v2-flash, mimo-v2-pro |
+| longcat | LongCat-Flash-Chat | api.longcat.chat/openai | LongCat-Flash-Chat |
+| longcat-anthropic | LongCat | api.longcat.chat/anthropic | LongCat |
 
 ## 🔧 开发
 
@@ -345,9 +378,17 @@ pip install -e ".[all]"
 python3 -m pytest tests/ -v
 
 # 运行程序
-python3 main.py
+fr-cli
 ```
 
+### 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `NO_COLOR=1` | 禁用所有 ANSI 颜色输出，适合 CI/管道/日志重定向 |
+| `FR_CLI_DEBUG=1` | 开启调试模式，显示详细 traceback |
+| `FR_CLI_NON_INTERACTIVE=1` | 非交互模式，安全确认默认拒绝 |
+
 ## 📂 项目结构
 
 ```
@@ -358,7 +399,8 @@ fr_cli/
 │   ├── master.py        # MasterAgent 主控
 │   └── ...
 ├── core/                 # 核心模块
-│   └── llm.py           # LLM 客户端（20+ 提供商）
+│   ├── llm.py           # LLM 客户端（20+ 提供商）
+│   └── model_factory.py # 模型工厂配置
 ├── weapon/              # 武器库
 ├── memory/              # 记忆系统
 └── lang/                # 国际化
@@ -370,18 +412,21 @@ fr_cli/
 
 ## 📂 配置目录
 
+> 配置统一在 `~/.fr_cli/` 目录下，旧路径（如 `~/.zhipu_cli_config.json`）会在首次启动时自动迁移到新路径。
+
 | 路径 | 说明 |
 |------|------|
-| `~/.zhipu_cli_config.json` | 主配置文件 |
-| `~/.zhipu_cli_history/` | 会话历史记录 |
-| `~/.zhipu_cli_plugins/` | 用户插件目录 |
-| `~/.zhipu_cli_context.json` | 上下文记忆 |
-| `~/.fr_cli_agents/` | Agent 分身目录 |
-| `~/.fr_cli_sessions/` | 按日期自动存档的会话 |
-| `~/.fr_cli_master/` | MasterAgent 记忆与进化记录 |
-| `~/.fr_cli_remotes.json` | 远程主机配置 |
-| `~/.fr_cli_databases.json` | 数据库连接配置 |
-| `~/.fr_cli_rag_db/` | RAG 向量库（ChromaDB）|
+| `~/.fr_cli/config.json` | 主配置文件（统一配置目录） |
+| `~/.fr_cli/config.json.bak` | 配置自动备份 |
+| `~/.fr_cli/history/` | 会话历史记录 |
+| `~/.fr_cli/context.json` | 上下文记忆 |
+| `~/.fr_cli/sessions/` | 按日期自动存档的会话 |
+| `~/.fr_cli/plugins/` | 用户插件目录 |
+| `~/.fr_cli/agents/` | Agent 分身目录 |
+| `~/.fr_cli/master/` | MasterAgent 记忆与进化记录 |
+| `~/.fr_cli/remotes.json` | 远程主机配置 |
+| `~/.fr_cli/databases.json` | 数据库连接配置 |
+| `~/.fr_cli/rag_db/` | RAG 向量库（ChromaDB）|
 
 ## ❓ 常见问题
 
@@ -393,6 +438,18 @@ fr_cli/
 /mode react    # ReAct
 ```
 
+**Q: 模型切换后重启又变回去了？**
+这是预期行为。fr-cli 每次启动从 `model_factory.py` 的工厂配置读取默认模型，`/model` 切换仅当前会话生效。如需持久化切换默认模型，可修改 `fr_cli/core/model_factory.py` 中的默认模型，或使用 `/providers setup` 交互式配置向导。
+
+**Q: 如何配置模型？**
+```bash
+# 推荐：交互式向导
+/model config
+
+# 或
+/providers setup
+```
+
 **Q: 如何保存会话?**
 ```bash
 /save my-session

{fr_cli-2.4.0 → fr_cli-2.4.2}/README.md

@@ -10,6 +10,7 @@
 支持以下 AI 模型提供商：
 - **智谱 AI**: GLM-4-Flash 等
 - **智谱 Coding Plan**: GLM-4.7 等 (https://docs.bigmodel.cn/cn/coding-plan/quick-start)
+- **OpenAI**: GPT-4o / GPT-4o-mini / o1-mini / o3-mini 等（标准 OpenAI 接口）
 - **DeepSeek**: DeepSeek-Chat 等
 - **Kimi (Moonshot)**: moonshot-v1-8k 等
 - **Kimi K2**: 代码优化版 kimi-k2-0905-preview
@@ -48,6 +49,7 @@
 - **MCP 外部神通**：支持 Model Context Protocol
 - **多源信息融合**：大模型 + 工具结果统一汇总
 - **中英文切换**：完整国际化支持
+- **NO_COLOR 支持**：`NO_COLOR=1` 禁用所有 ANSI 颜色，适合 CI/管道环境
 
 ## 🚀 快速开始
 
@@ -61,10 +63,10 @@ fr-cli
 # 或从源码运行
 cd fr-cli
 pip install -e .
-python3 main.py
+fr-cli
 ```
 
-首次运行会引导输入当前道统的 API Key。
+首次运行会引导输入当前道统的 API Key。直接回车可进入 Mock 模式试用。
 
 ## 📝 使用方法
 
@@ -81,11 +83,16 @@ python3 main.py
 /load               加载历史会话
 /export             导出会话为 Markdown
 
-/model <模型名>              切换AI模型
+/model <模型名>              切换AI模型（仅当前会话生效）
 /model <道统>:<模型名>       同时切换道统和模型
+/model config               🆕 交互式模型配置向导
+/model list                 列出所有可用模型
+/model current              显示当前模型
+/model default              恢复 factory 默认模型
 /key <key>                   修改当前道统 API Key
 /key <道统> <key>            为指定道统设置 Key
 /providers                   查看所有道统配置
+/providers setup            交互式配置向导
 /providers add <p> <k> [m]   添加/更新道统配置
 /providers use <p>           切换到指定道统
 
@@ -99,23 +106,46 @@ python3 main.py
 /exit              退出
 ```
 
-### 🤖 AI 模型切换示例
+### 🖥️ 非交互 / 批处理模式
+
+fr-cli 支持在不进入 REPL 的情况下执行单次命令或单次 AI 对话，适用于脚本、cron、管道等场景：
+
+```bash
+# 执行一条 slash 命令后退出
+fr-cli -c "/model current"
+fr-cli -c "/ls"
+
+# 向 AI 提问后退出
+fr-cli "请总结 README.md"
+fr-cli -p "Python 如何读取 JSON？"
 
+# 从文件或标准输入读取提示词
+cat article.txt | fr-cli -s
+fr-cli -f prompt.txt
+
+# 静默模式（跳过启动 banner，只输出核心结果）
+fr-cli -q -c "/model current"
+fr-cli -q -p "1+1等于几"
 ```
-# 使用 Kimi K2（代码优化版）
-/model kimi-k2
 
-# 使用 MiniMax M2.7（Token Plan）
-/model minimax-m27
+### 🤖 AI 模型配置
+
+```bash
+# 交互式配置向导（推荐）
+>>> /model config
 
-# 使用 Step-3（阶跃星辰）
-/model step-3
+# 直接切换（仅当前会话生效，重启后恢复 factory 默认）
+>>> /model deepseek-chat
+>>> /model deepseek:deepseek-reasoner
 
-# 使用 Kimi Code
-/model kimi-code
+# 查看当前模型
+>>> /model current
+
+# 恢复 factory 默认模型
+>>> /model default
 
 # 配置新的 API Key
-/providers add step-3 <your-api-key>
+>>> /providers add step-3 <your-api-key>
 ```
 
 ### 🔧 Agent 管理
@@ -232,30 +262,33 @@ fr acp
 
 ## 🤖 支持的模型提供商（25+）
 
-| 道统 | 默认模型 | API 地址 |
-|------|---------|----------|
-| zhipu | glm-4-flash | - |
-| zhipu-coding | GLM-4.7 | open.bigmodel.cn/api/coding/paas/v4 |
-| zhipu-anthropic | glm-4.6 | open.bigmodel.cn/api/anthropic |
-| deepseek | deepseek-chat | api.deepseek.com |
-| kimi | moonshot-v1-8k | api.moonshot.cn |
-| kimi-k2 | kimi-k2-0905-preview | api.moonshot.cn |
-| kimi-code | kimi-for-coding | api.kimi.com/coding/v1 |
-| qwen | qwen-turbo | dashscope.aliyuncs.com |
-| stepfun | step-1-8k | api.stepfun.com |
-| step-1 | step-1-8k | api.stepfun.com |
-| step-2 | step-2-16k | api.stepfun.com |
-| step-3 | step-3-auto | api.stepfun.com |
-| step-audio | step-audio-2 | api.stepfun.com |
-| minimax | MiniMax-Text-01 | api.minimax.chat |
-| minimax-m27 | MiniMax-M2.7 | api.minimax.chat |
-| minimax-m27-fast | MiniMax-M2.7-HighSpeed | api.minimax.chat |
-| minimax-token-plan | MiniMax-M2.7 | api.minimax.chat |
-| spark | generalv3.5 | spark-api-open.xf-yun.com |
-| doubao | doubao-1-5-pro-32k-250115 | ark.cn-beijing.volces.com |
-| mimo | mimo-v2-flash | api.xiaomimimo.com |
-| longcat | LongCat-Flash-Chat | api.longcat.chat/openai |
-| longcat-anthropic | LongCat | api.longcat.chat/anthropic |
+| 道统 | 默认模型 | API 地址 | 常用模型 |
+|------|---------|----------|---------|
+| zhipu | glm-4-flash | open.bigmodel.cn/api/paas/v4 | glm-4-flash, glm-4-plus, glm-4, glm-4v-plus, glm-4-air, glm-4-long |
+| zhipu-coding | GLM-4.7 | open.bigmodel.cn/api/coding/paas/v4 (Coding Plan) | GLM-4.7, GLM-5.1, GLM-4.5-air |
+| zhipu-anthropic | glm-4.6 | open.bigmodel.cn/api/anthropic | glm-4.6 |
+| openai | gpt-4o-mini | api.openai.com/v1 | gpt-4o, gpt-4o-mini, gpt-4-turbo, gpt-3.5-turbo, o1-mini, o3-mini |
+| deepseek | deepseek-chat | api.deepseek.com | deepseek-chat, deepseek-reasoner, deepseek-coder |
+| kimi | moonshot-v1-8k | api.moonshot.cn | moonshot-v1-8k, moonshot-v1-32k, moonshot-v1-128k |
+| kimi-k2 | kimi-k2-0905-preview | api.moonshot.cn | kimi-k2-0905-preview |
+| kimi-code | kimi-for-coding | api.kimi.com/coding/v1 | kimi-for-coding |
+| qwen | qwen-turbo | dashscope.aliyuncs.com | qwen-turbo, qwen-plus, qwen-max, qwen-coder-plus |
+| stepfun | step-1-8k | api.stepfun.com (api.stepfun.com/step_plan/v1 for Step Plan) | step-1-8k, step-1-32k, step-2-16k, step-3-auto |
+| step-1 | step-1-8k | api.stepfun.com | step-1-8k |
+| step-2 | step-2-16k | api.stepfun.com | step-2-16k |
+| step-3 | step-3-auto | api.stepfun.com | step-3-auto |
+| step-audio | step-audio-2 | api.stepfun.com | step-audio-2 |
+| stepfun-step-plan | step-3-auto | api.stepfun.com/step_plan/v1 (Step Plan) | step-3-auto, step-2-16k, step-1-8k |
+| minimax | MiniMax-Text-01 | api.minimax.io (api.minimax.chat for Token Plan) | MiniMax-Text-01, MiniMax-M2.1, abab6.5s-chat, abab6.5t-chat |
+| minimax-m27 | MiniMax-M2.7 | api.minimax.chat (Token Plan) | MiniMax-M2.7 |
+| minimax-m27-fast | MiniMax-M2.7-HighSpeed | api.minimax.chat (Token Plan) | MiniMax-M2.7-HighSpeed |
+| minimax-token-plan | MiniMax-M2.7 | api.minimax.chat (Token Plan) | MiniMax-M2.7 |
+| spark | generalv3.5 | spark-api-open.xf-yun.com | generalv3.5 |
+| doubao | doubao-1-5-pro-32k-250115 | ark.cn-beijing.volces.com | doubao-1-5-pro-32k, doubao-1-5-lite-32k |
+| mimo | mimo-v2-flash | api.xiaomimimo.com | mimo-v2-flash, mimo-v2-pro |
+| mimo-token-plan | mimo-v2-flash | token-plan-sgp.xiaomimimo.com (Token Plan) | mimo-v2-flash, mimo-v2-pro |
+| longcat | LongCat-Flash-Chat | api.longcat.chat/openai | LongCat-Flash-Chat |
+| longcat-anthropic | LongCat | api.longcat.chat/anthropic | LongCat |
 
 ## 🔧 开发
 
@@ -271,9 +304,17 @@ pip install -e ".[all]"
 python3 -m pytest tests/ -v
 
 # 运行程序
-python3 main.py
+fr-cli
 ```
 
+### 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `NO_COLOR=1` | 禁用所有 ANSI 颜色输出，适合 CI/管道/日志重定向 |
+| `FR_CLI_DEBUG=1` | 开启调试模式，显示详细 traceback |
+| `FR_CLI_NON_INTERACTIVE=1` | 非交互模式，安全确认默认拒绝 |
+
 ## 📂 项目结构
 
 ```
@@ -284,7 +325,8 @@ fr_cli/
 │   ├── master.py        # MasterAgent 主控
 │   └── ...
 ├── core/                 # 核心模块
-│   └── llm.py           # LLM 客户端（20+ 提供商）
+│   ├── llm.py           # LLM 客户端（20+ 提供商）
+│   └── model_factory.py # 模型工厂配置
 ├── weapon/              # 武器库
 ├── memory/              # 记忆系统
 └── lang/                # 国际化
@@ -296,18 +338,21 @@ fr_cli/
 
 ## 📂 配置目录
 
+> 配置统一在 `~/.fr_cli/` 目录下，旧路径（如 `~/.zhipu_cli_config.json`）会在首次启动时自动迁移到新路径。
+
 | 路径 | 说明 |
 |------|------|
-| `~/.zhipu_cli_config.json` | 主配置文件 |
-| `~/.zhipu_cli_history/` | 会话历史记录 |
-| `~/.zhipu_cli_plugins/` | 用户插件目录 |
-| `~/.zhipu_cli_context.json` | 上下文记忆 |
-| `~/.fr_cli_agents/` | Agent 分身目录 |
-| `~/.fr_cli_sessions/` | 按日期自动存档的会话 |
-| `~/.fr_cli_master/` | MasterAgent 记忆与进化记录 |
-| `~/.fr_cli_remotes.json` | 远程主机配置 |
-| `~/.fr_cli_databases.json` | 数据库连接配置 |
-| `~/.fr_cli_rag_db/` | RAG 向量库（ChromaDB）|
+| `~/.fr_cli/config.json` | 主配置文件（统一配置目录） |
+| `~/.fr_cli/config.json.bak` | 配置自动备份 |
+| `~/.fr_cli/history/` | 会话历史记录 |
+| `~/.fr_cli/context.json` | 上下文记忆 |
+| `~/.fr_cli/sessions/` | 按日期自动存档的会话 |
+| `~/.fr_cli/plugins/` | 用户插件目录 |
+| `~/.fr_cli/agents/` | Agent 分身目录 |
+| `~/.fr_cli/master/` | MasterAgent 记忆与进化记录 |
+| `~/.fr_cli/remotes.json` | 远程主机配置 |
+| `~/.fr_cli/databases.json` | 数据库连接配置 |
+| `~/.fr_cli/rag_db/` | RAG 向量库（ChromaDB）|
 
 ## ❓ 常见问题
 
@@ -319,6 +364,18 @@ fr_cli/
 /mode react    # ReAct
 ```
 
+**Q: 模型切换后重启又变回去了？**
+这是预期行为。fr-cli 每次启动从 `model_factory.py` 的工厂配置读取默认模型，`/model` 切换仅当前会话生效。如需持久化切换默认模型，可修改 `fr_cli/core/model_factory.py` 中的默认模型，或使用 `/providers setup` 交互式配置向导。
+
+**Q: 如何配置模型？**
+```bash
+# 推荐：交互式向导
+/model config
+
+# 或
+/providers setup
+```
+
 **Q: 如何保存会话?**
 ```bash
 /save my-session
@@ -349,4 +406,4 @@ pip install aligo   # 阿里云盘
 
 ## 📄 License
 
-MIT
+MIT

{fr_cli-2.4.0 → fr_cli-2.4.2}/fr_cli/WEAPON.MD

@@ -176,7 +176,7 @@
   - AI 调用: `mcp_call({"server": "服务器名", "tool": "工具名", "arguments": {...}})`
   - REPL 管理: `/mcp_list`, `/mcp_add`, `/mcp_del`, `/mcp_enable`, `/mcp_disable`, `/mcp_refresh`
 - **触发关键词**: mcp, 外部工具, 外部神通, 调用工具, use tool, invoke tool
-- **配置持久化**: `~/.zhipu_cli_config.json` 的 `mcp.servers` 字段
+- **配置持久化**: `~/.fr_cli/config.json` 的 `mcp.servers` 字段
 - **示例**:
   ```
   /mcp_add fs npx -y @modelcontextprotocol/server-filesystem /tmp

{fr_cli-2.4.0 → fr_cli-2.4.2}/fr_cli/__init__.py

@@ -1,4 +1,4 @@
 """
 凡人打字机 - 基于智谱AI的终极全能终端工具
 """
-__version__ = "2.4.0"
+__version__ = "2.4.2"

{fr_cli-2.4.0 → fr_cli-2.4.2}/fr_cli/addon/plugin.py

@@ -38,19 +38,19 @@ def exec_plugin(name, path, args, lang):
         print(f"{RED}❌ 非法插件名: {name}{RESET}")
         return
 
-    import json, shlex
+    import json
     # 使用 json.dumps 安全序列化参数，防止字符串逃逸注入
     safe_args = json.dumps(args)
     runner_code = f"""
 import sys, json, runpy
-sys.path.insert(0, {shlex.quote(str(PLUGIN_DIR))})
-mod = runpy.run_module({shlex.quote(name)}, run_name='__main__')
+sys.path.insert(0, {json.dumps(str(PLUGIN_DIR), ensure_ascii=False)})
+mod = runpy.run_module({json.dumps(name, ensure_ascii=False)}, run_name='__main__')
 run_fn = mod.get('run')
 if run_fn is None:
     print("Error: 插件缺少 run 函数", file=sys.stderr)
 else:
     try:
-        print(run_fn(json.loads({safe_args})))
+        print(run_fn(json.loads({json.dumps(safe_args, ensure_ascii=False)})))
     except Exception as e:
         print(f"Error: {{e}}", file=sys.stderr)
 """

{fr_cli-2.4.0 → fr_cli-2.4.2}/fr_cli/agent/builtins/db.py

@@ -1,11 +1,14 @@
 """
 @db 内置 Agent —— 数据库智能助手
 支持 MySQL / PostgreSQL / SQL Server / Oracle 的 Schema 分析和 SQL 生成。
+
+数据库连接配置统一收敛到 ~/.fr_cli/config.json 的 databases 命名空间。
 """
-from pathlib import Path
+from fr_cli.conf.config import load_namespace, save_namespace
 from fr_cli.conf.paths import DATABASE_FILE
 
-DB_CFG_PATH = DATABASE_FILE  # from fr_cli.conf.paths
+_NS_KEY = "databases"
+DB_CFG_PATH = DATABASE_FILE  # 保留用于一次性迁移
 
 DB_SYS_PROMPT = """你是一个数据库专家。请根据以下数据库 Schema 信息和用户需求，生成最合适的 SQL 语句。
 
@@ -25,13 +28,11 @@ Schema 信息:
 
 
 def _load_dbs():
-    from fr_cli.agent.builtins._utils import load_json_config
-    return load_json_config(DB_CFG_PATH)
+    return load_namespace(_NS_KEY, default={}, old_path=DB_CFG_PATH)
 
 
 def _save_dbs(dbs):
-    from fr_cli.agent.builtins._utils import save_json_config
-    save_json_config(DB_CFG_PATH, dbs)
+    save_namespace(_NS_KEY, dbs)
 
 
 def _connect(db_cfg):

{fr_cli-2.4.0 → fr_cli-2.4.2}/fr_cli/agent/builtins/powerful_agent_template.py

@@ -17,8 +17,8 @@
 
 示例配置：
 {
-    "provider": "kimi-k2",
-    "model": "kimi-k2-0905-preview",
+    "provider": "<your-provider>",
+    "model": "<your-model>",
     "key": "your-api-key"
 }
 """
@@ -641,10 +641,17 @@ class PowerfulAgent:
         self.a2a = A2AIntegration(name, context.get("state"))
         self.evolution = EvolutionSystem(name)
 
-        # 从 context 获取配置
+        # 从 context 获取配置；未指定时回退到 ModelFactory 首个 provider
         self.client = context.get("client")
-        self.provider = context.get("provider", "zhipu")
-        self.model = context.get("model", "glm-4-flash")
+        self.provider = context.get("provider")
+        self.model = context.get("model")
+        if not self.provider:
+            from fr_cli.core.model_factory import get_model_factory
+            factory = get_model_factory()
+            providers = factory.list_providers()
+            if providers:
+                self.provider = providers[0]
+                self.model = factory.get_model_name(self.provider)
         self.persona = context.get("persona", "")
         self.skills = context.get("skills", "")
         self.lang = context.get("lang", "zh")
@@ -900,8 +907,8 @@ if __name__ == "__main__":
     # 示例：创建并运行 Agent
     example_context = {
         "client": None,  # 在实际运行时由 fr-cli 提供
-        "provider": "kimi-k2",
-        "model": "kimi-k2-0905-preview",
+        "provider": "<your-provider>",
+        "model": "<your-model>",
         "persona": "你是一个专业的代码审查员，擅长发现代码中的问题和优化点。",
         "skills": "代码审查、性能优化、重构建议",
         "lang": "zh",

{fr_cli-2.4.0 → fr_cli-2.4.2}/fr_cli/agent/builtins/remote.py

@@ -1,11 +1,15 @@
 """
 @remote 内置 Agent —— 远程 SSH 操作助手
 支持多机配置、配置向导、AI 生成远程命令。
+
+远程主机配置统一收敛到 ~/.fr_cli/config.json 的 remote.hosts 命名空间。
+旧文件 ~/.fr_cli/remote/hosts.json 会在首次加载时一次性迁移。
 """
-from pathlib import Path
+from fr_cli.conf.config import load_namespace, save_namespace
 from fr_cli.conf.paths import REMOTE_HOSTS_FILE
 
-REMOTE_CFG_PATH = REMOTE_HOSTS_FILE  # from fr_cli.conf.paths
+_NS_KEY = "remote"
+REMOTE_CFG_PATH = REMOTE_HOSTS_FILE  # 保留用于一次性迁移
 
 REMOTE_SYS_PROMPT = """你是一个远程系统命令专家。请根据目标主机的操作系统类型和用户需求，生成最合适的远程命令。
 
@@ -21,13 +25,14 @@ REMOTE_SYS_PROMPT = """你是一个远程系统命令专家。请根据目标主
 
 
 def _load_hosts():
-    from fr_cli.agent.builtins._utils import load_json_config
-    return load_json_config(REMOTE_CFG_PATH)
+    ns = load_namespace(_NS_KEY, default={"hosts": {}}, old_path=REMOTE_CFG_PATH)
+    return ns.get("hosts", {})
 
 
 def _save_hosts(hosts):
-    from fr_cli.agent.builtins._utils import save_json_config
-    save_json_config(REMOTE_CFG_PATH, hosts)
+    ns = load_namespace(_NS_KEY, default={"hosts": {}})
+    ns["hosts"] = hosts
+    save_namespace(_NS_KEY, ns)
 
 
 def list_hosts():