fr-cli 2.3.3__tar.gz → 2.4.1__tar.gz

fr_cli-2.4.1/MANIFEST.in

@@ -0,0 +1,5 @@
+include fr_cli/WEAPON.MD
+include fr_cli/README.md
+include fr_cli/assets/*.jpeg
+include fr_cli/assets/*.png
+include fr_cli/assets/*.jpg

{fr_cli-2.3.3/fr_cli.egg-info → fr_cli-2.4.1}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: fr-cli
-Version: 2.3.3
+Version: 2.4.1
 Summary: 凡人打字机 - 支持多模型(Zhipu/DeepSeek/Kimi/Qwen/StepFun/MiniMax/Spark/Doubao/MiMo)的终极全能终端工具
 Author: FANREN CLI Author
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/yourname/fr-cli
-Project-URL: Issues, https://github.com/yourname/fr-cli/issues
+Project-URL: Homepage, https://github.com/leungyukit/fr-cli
+Project-URL: Issues, https://github.com/leungyukit/fr-cli/issues
 Keywords: zhipuai,deepseek,kimi,qwen,cli,ai,terminal,chatbot
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -28,6 +28,8 @@ Requires-Dist: openai>=1.0.0
 Requires-Dist: requests>=2.28.0
 Requires-Dist: mcp>=1.6.0
 Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: prompt_toolkit>=3.0.0
+Requires-Dist: Pillow>=10.0.0
 Provides-Extra: data
 Requires-Dist: pandas>=1.5.0; extra == "data"
 Requires-Dist: openpyxl>=3.0.0; extra == "data"
@@ -82,10 +84,11 @@ 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
-- **Kimi Code**: 代码平台 kimi-cache-test (Kimi 会员)
+- **Kimi Code**: 代码平台 kimi-for-coding (Kimi 会员)
 - **通义千问 (Qwen)**: qwen-turbo 等
 - **阶跃星辰 (StepFun)**: step-1-8k, step-2-16k, step-3-auto 等
 - **Step-Audio**: 实时语音交互
@@ -120,6 +123,7 @@ Dynamic: license-file
 - **MCP 外部神通**：支持 Model Context Protocol
 - **多源信息融合**：大模型 + 工具结果统一汇总
 - **中英文切换**：完整国际化支持
+- **NO_COLOR 支持**：`NO_COLOR=1` 禁用所有 ANSI 颜色，适合 CI/管道环境
 
 ## 🚀 快速开始
 
@@ -133,10 +137,10 @@ fr-cli
 # 或从源码运行
 cd fr-cli
 pip install -e .
-python3 main.py
+fr-cli
 ```
 
-首次运行会引导输入当前道统的 API Key。
+首次运行会引导输入当前道统的 API Key。直接回车可进入 Mock 模式试用。
 
 ## 📝 使用方法
 
@@ -153,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>           切换到指定道统
 
@@ -171,23 +180,24 @@ python3 main.py
 /exit              退出
 ```
 
-### 🤖 AI 模型切换示例
+### 🤖 AI 模型配置
 
-```
-# 使用 Kimi K2（代码优化版）
-/model kimi-k2
+```bash
+# 交互式配置向导（推荐）
+>>> /model config
 
-# 使用 MiniMax M2.7（Token Plan）
-/model minimax-m27
+# 直接切换（仅当前会话生效，重启后恢复 factory 默认）
+>>> /model deepseek-chat
+>>> /model deepseek:deepseek-reasoner
 
-# 使用 Step-3（阶跃星辰）
-/model step-3
+# 查看当前模型
+>>> /model current
 
-# 使用 Kimi Code
-/model kimi-code
+# 恢复 factory 默认模型
+>>> /model default
 
 # 配置新的 API Key
-/providers add step-3 <your-api-key>
+>>> /providers add step-3 <your-api-key>
 ```
 
 ### 🔧 Agent 管理
@@ -237,7 +247,7 @@ python3 main.py
 /security        查看安全设置
 ```
 
-## � Hermes 核心功能
+## 🧠 Hermes 核心功能
 
 ### 📋 任务管理
 ```
@@ -302,32 +312,35 @@ 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-cache-test | 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 |
+## 🤖 支持的模型提供商（25+）
+
+| 道统 | 默认模型 | 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 |
 
 ## 🔧 开发
 
@@ -343,9 +356,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` | 非交互模式，安全确认默认拒绝 |
+
 ## 📂 项目结构
 
 ```
@@ -356,7 +377,8 @@ fr_cli/
 │   ├── master.py        # MasterAgent 主控
 │   └── ...
 ├── core/                 # 核心模块
-│   └── llm.py           # LLM 客户端（20+ 提供商）
+│   ├── llm.py           # LLM 客户端（20+ 提供商）
+│   └── model_factory.py # 模型工厂配置
 ├── weapon/              # 武器库
 ├── memory/              # 记忆系统
 └── lang/                # 国际化
@@ -364,8 +386,75 @@ fr_cli/
 
 ## 📚 文档
 
-- [NEW_PROVIDERS_GUIDE.md](NEW_PROVIDERS_GUIDE.md) - 新增模型使用指南
-- [A2A_AND_PROVIDERS_GUIDE.md](A2A_AND_PROVIDERS_GUIDE.md) - A2A 协议文档
+- [AGENTS.md](AGENTS.md) - 面向 AI 编码助手的项目架构与开发指南
+
+## 📂 配置目录
+
+> 配置统一在 `~/.fr_cli/` 目录下，旧路径 `~/.zhipu_cli_config.json` 等会在首次启动时自动迁移。
+
+| 路径 | 说明 |
+|------|------|
+| `~/.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）|
+
+## ❓ 常见问题
+
+**Q: 如何切换思维模式?**
+```bash
+/mode direct   # 直接回复
+/mode cot      # 思维链
+/mode tot      # 思维树
+/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
+/load
+/export
+```
+
+**Q: 如何查看历史记录?**
+```bash
+/history
+/session_list
+```
+
+**Q: 邮件发送失败?**
+- QQ/163 邮箱需使用「授权码」而非登录密码
+- 授权码在邮箱设置 → 账户 → 开启 IMAP/SMTP 服务后生成
+
+**Q: 搜索功能无法使用?**
+```bash
+pip install requests
+```
+
+**Q: 云盘功能无法使用?**
+```bash
+pip install aligo   # 阿里云盘
+```
+首次使用需运行 `/disk_setup` 完成扫码登录。
 
 ## 📄 License
 

{fr_cli-2.3.3 → fr_cli-2.4.1}/README.md

@@ -10,10 +10,11 @@
 支持以下 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
-- **Kimi Code**: 代码平台 kimi-cache-test (Kimi 会员)
+- **Kimi Code**: 代码平台 kimi-for-coding (Kimi 会员)
 - **通义千问 (Qwen)**: qwen-turbo 等
 - **阶跃星辰 (StepFun)**: step-1-8k, step-2-16k, step-3-auto 等
 - **Step-Audio**: 实时语音交互
@@ -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,24 @@ python3 main.py
 /exit              退出
 ```
 
-### 🤖 AI 模型切换示例
+### 🤖 AI 模型配置
 
-```
-# 使用 Kimi K2（代码优化版）
-/model kimi-k2
+```bash
+# 交互式配置向导（推荐）
+>>> /model config
 
-# 使用 MiniMax M2.7（Token Plan）
-/model minimax-m27
+# 直接切换（仅当前会话生效，重启后恢复 factory 默认）
+>>> /model deepseek-chat
+>>> /model deepseek:deepseek-reasoner
 
-# 使用 Step-3（阶跃星辰）
-/model step-3
+# 查看当前模型
+>>> /model current
 
-# 使用 Kimi Code
-/model kimi-code
+# 恢复 factory 默认模型
+>>> /model default
 
 # 配置新的 API Key
-/providers add step-3 <your-api-key>
+>>> /providers add step-3 <your-api-key>
 ```
 
 ### 🔧 Agent 管理
@@ -165,7 +173,7 @@ python3 main.py
 /security        查看安全设置
 ```
 
-## � Hermes 核心功能
+## 🧠 Hermes 核心功能
 
 ### 📋 任务管理
 ```
@@ -230,32 +238,35 @@ 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-cache-test | 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 |
+## 🤖 支持的模型提供商（25+）
+
+| 道统 | 默认模型 | 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 +282,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 +303,8 @@ fr_cli/
 │   ├── master.py        # MasterAgent 主控
 │   └── ...
 ├── core/                 # 核心模块
-│   └── llm.py           # LLM 客户端（20+ 提供商）
+│   ├── llm.py           # LLM 客户端（20+ 提供商）
+│   └── model_factory.py # 模型工厂配置
 ├── weapon/              # 武器库
 ├── memory/              # 记忆系统
 └── lang/                # 国际化
@@ -292,9 +312,76 @@ fr_cli/
 
 ## 📚 文档
 
-- [NEW_PROVIDERS_GUIDE.md](NEW_PROVIDERS_GUIDE.md) - 新增模型使用指南
-- [A2A_AND_PROVIDERS_GUIDE.md](A2A_AND_PROVIDERS_GUIDE.md) - A2A 协议文档
+- [AGENTS.md](AGENTS.md) - 面向 AI 编码助手的项目架构与开发指南
+
+## 📂 配置目录
+
+> 配置统一在 `~/.fr_cli/` 目录下，旧路径 `~/.zhipu_cli_config.json` 等会在首次启动时自动迁移。
+
+| 路径 | 说明 |
+|------|------|
+| `~/.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）|
+
+## ❓ 常见问题
+
+**Q: 如何切换思维模式?**
+```bash
+/mode direct   # 直接回复
+/mode cot      # 思维链
+/mode tot      # 思维树
+/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
+/load
+/export
+```
+
+**Q: 如何查看历史记录?**
+```bash
+/history
+/session_list
+```
+
+**Q: 邮件发送失败?**
+- QQ/163 邮箱需使用「授权码」而非登录密码
+- 授权码在邮箱设置 → 账户 → 开启 IMAP/SMTP 服务后生成
+
+**Q: 搜索功能无法使用?**
+```bash
+pip install requests
+```
+
+**Q: 云盘功能无法使用?**
+```bash
+pip install aligo   # 阿里云盘
+```
+首次使用需运行 `/disk_setup` 完成扫码登录。
 
 ## 📄 License
 
-MIT
+MIT

{fr_cli-2.3.3 → fr_cli-2.4.1}/fr_cli/WEAPON.MD

@@ -243,7 +243,7 @@ Agent 能力类型:
   - DeepSeek: deepseek (deepseek-chat)
   - Kimi: kimi (moonshot-v1-8k)
   - Kimi K2: kimi-k2 (kimi-k2-0905-preview) - 代码优化版
-  - Kimi Code: kimi-code (kimi-cache-test) - 代码平台
+  - Kimi Code: kimi-code (kimi-for-coding) - 代码平台
   - 通义千问: qwen (qwen-turbo)
   - 阶跃星辰: stepfun (step-1-8k), step-1, step-2, step-3, step-audio
   - MiniMax: minimax (MiniMax-Text-01)

{fr_cli-2.3.3 → fr_cli-2.4.1}/fr_cli/__init__.py

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

{fr_cli-2.3.3 → fr_cli-2.4.1}/fr_cli/addon/plugin.py

@@ -3,11 +3,12 @@
 负责本地技能的扫描、动态落盘与沙盒执行
 """
 import re, subprocess, sys
+from fr_cli.conf.paths import PLUGIN_DIR
 from pathlib import Path
 from fr_cli.lang.i18n import T
 from fr_cli.ui.ui import RED, DIM, RESET
 
-PLUGIN_DIR = Path.home() / ".zhipu_cli_plugins"
+PLUGIN_DIR = PLUGIN_DIR  # from fr_cli.conf.paths
 
 def init_plugins():
     """扫描并初始化本地插件字典 {名字: 绝对路径}"""

{fr_cli-2.3.3 → fr_cli-2.4.1}/fr_cli/agent/__init__.py

@@ -2,8 +2,6 @@
 Agent 分身系统
 支持创建、管理、执行由 AI 自动生成的独立 Agent
 """
-from pathlib import Path
-
-AGENTS_DIR = Path.home() / ".fr_cli_agents"
+from fr_cli.conf.paths import AGENTS_DIR
 
 __all__ = ["AGENTS_DIR"]

{fr_cli-2.3.3 → fr_cli-2.4.1}/fr_cli/agent/a2a.py

@@ -1,3 +1,4 @@
+from fr_cli.conf.paths import REGISTRY_FILE
 """
 Agent2Agent Protocol (A2A) - Agent 互操作协议
 
@@ -116,7 +117,7 @@ class AgentRegistry:
             return
         self._agents: Dict[str, AgentInfo] = {}
         self._tasks: Dict[str, TaskResult] = {}
-        self._registry_file = Path.home() / ".fr_cli_agent_registry.json"
+        self._registry_file = REGISTRY_FILE
         self._load_registry()
         self._initialized = True