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

{fr_cli-2.4.1 → 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.1/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.1
+Version: 2.4.2
 Summary: 凡人打字机 - 支持多模型(Zhipu/DeepSeek/Kimi/Qwen/StepFun/MiniMax/Spark/Doubao/MiMo)的终极全能终端工具
 Author: FANREN CLI Author
 License-Expression: MIT
@@ -180,6 +180,28 @@ fr-cli
 /exit              退出
 ```
 
+### 🖥️ 非交互 / 批处理模式
+
+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等于几"
+```
+
 ### 🤖 AI 模型配置
 
 ```bash
@@ -390,7 +412,7 @@ fr_cli/
 
 ## 📂 配置目录
 
-> 配置统一在 `~/.fr_cli/` 目录下，旧路径 `~/.zhipu_cli_config.json` 等会在首次启动时自动迁移。
+> 配置统一在 `~/.fr_cli/` 目录下，旧路径（如 `~/.zhipu_cli_config.json`）会在首次启动时自动迁移到新路径。
 
 | 路径 | 说明 |
 |------|------|

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

@@ -106,6 +106,28 @@ fr-cli
 /exit              退出
 ```
 
+### 🖥️ 非交互 / 批处理模式
+
+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等于几"
+```
+
 ### 🤖 AI 模型配置
 
 ```bash
@@ -316,7 +338,7 @@ fr_cli/
 
 ## 📂 配置目录
 
-> 配置统一在 `~/.fr_cli/` 目录下，旧路径 `~/.zhipu_cli_config.json` 等会在首次启动时自动迁移。
+> 配置统一在 `~/.fr_cli/` 目录下，旧路径（如 `~/.zhipu_cli_config.json`）会在首次启动时自动迁移到新路径。
 
 | 路径 | 说明 |
 |------|------|

{fr_cli-2.4.1 → 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.1 → fr_cli-2.4.2}/fr_cli/__init__.py

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

{fr_cli-2.4.1 → 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.1 → 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.1 → 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.1 → 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():

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/agent/generator.py

@@ -34,7 +34,7 @@ Agent 名称: {name}
    - 'memory': str — 记忆文本
    - 'skills': str — 技能文本
    - 'client': LLM 客户端实例（已根据 Agent 专属配置或全局默认初始化）
-   - 'provider': str — 当前使用的提供商/提供商 ID（如 'zhipu', 'deepseek'）
+   - 'provider': str — 当前使用的提供商/提供商 ID
    - 'model': str — 模型名称
    - 'lang': str — 语言代码（'zh' 或 'en'）
    - 'executor': CommandExecutor 实例（可使用 invoke_tool/execute 调用工具）

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/agent/hermes.py

@@ -205,19 +205,31 @@ class ConfigManager:
         self._load_config_file()
 
     def _load_env(self):
-        """从环境变量加载"""
-        for key in ["ZHIPU_API_KEY", "MOONSHOT_API_KEY", "DEEPSEEK_API_KEY",
-                    "QWEN_API_KEY", "OPENAI_API_KEY", "ANTHROPIC_API_KEY"]:
+        """从环境变量加载 API Key。
+
+        provider → env_key 映射优先从 ModelFactory 读取，避免硬编码。
+        对于未在工厂中声明的厂商，保留少量兜底映射。
+        """
+        # 兜底映射（仅覆盖 factory 中没有的厂商）
+        fallback_env_map = {
+            "ANTHROPIC_API_KEY": "anthropic",
+        }
+
+        env_to_provider = dict(fallback_env_map)
+
+        try:
+            from fr_cli.core.model_factory import get_model_factory
+            factory = get_model_factory()
+            for provider_id in factory.list_providers():
+                cfg = factory.get_config(provider_id)
+                env_key = cfg.get("env_key")
+                if env_key:
+                    env_to_provider[env_key] = provider_id
+        except Exception:
+            pass
+
+        for key, provider in env_to_provider.items():
             if key in os.environ:
-                provider = key.lower().replace("_api_key", "")
-                if "zhipu" in provider:
-                    provider = "zhipu"
-                elif "moonshot" in provider or "kimi" in provider:
-                    provider = "kimi"
-                elif "deepseek" in provider:
-                    provider = "deepseek"
-                elif "qwen" in provider:
-                    provider = "qwen"
                 self.config.setdefault("providers", {})
                 self.config["providers"].setdefault(provider, {})
                 self.config["providers"][provider]["key"] = os.environ[key]

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/agent/image_and_parallel.py

@@ -62,46 +62,32 @@ class ImageModelConfig:
         self._register_builtin_providers()
 
     def _register_builtin_providers(self):
-        """注册内置图片提供商"""
-
-        # 智谱 CogView
-        self.register_provider(ImageProvider(
-            name="智谱 CogView-4",
-            provider_id="zhipu",
-            model="cogview-4",
-            api_key="",
-            size="1024x1024"
-        ))
-
-        # MiniMax 图片
-        self.register_provider(ImageProvider(
-            name="MiniMax 图片",
-            provider_id="minimax",
-            model="image-01",
-            api_key="",
-            base_url="https://api.minimax.chat/v1",
-            size="1024x1024"
-        ))
-
-        # 通义万相
-        self.register_provider(ImageProvider(
-            name="通义万相",
-            provider_id="qwen",
-            model="wanx2.1-t2i-turbo",
-            api_key="",
-            base_url="https://dashscope.aliyuncs.com/api/v2",
-            size="1024x1024"
-        ))
-
-        # StepFun 图片
-        self.register_provider(ImageProvider(
-            name="StepFun 图片",
-            provider_id="stepfun",
-            model="step-1-image",
-            api_key="",
-            base_url="https://api.stepfun.com/v1",
-            size="1024x1024"
-        ))
+        """从 ModelFactory 注册内置图片提供商，避免硬编码 model/base_url"""
+        from fr_cli.core.model_factory import get_model_factory
+
+        factory = get_model_factory()
+        image_provider_map = [
+            ("智谱 CogView-4", "zhipu"),
+            ("MiniMax 图片", "minimax"),
+            ("通义万相", "qwen"),
+            ("StepFun 图片", "stepfun"),
+        ]
+
+        for name, provider_id in image_provider_map:
+            cfg = factory.get_config(provider_id)
+            if not cfg:
+                continue
+            image_model = cfg.get("image_model")
+            if not image_model:
+                continue
+            self.register_provider(ImageProvider(
+                name=name,
+                provider_id=provider_id,
+                model=image_model,
+                api_key="",
+                base_url=cfg.get("base_url"),
+                size="1024x1024"
+            ))
 
     def register_provider(self, provider: ImageProvider):
         """注册图片提供商"""
@@ -251,7 +237,7 @@ class ImageGenerator:
             client = ZhipuAI(api_key=self.provider.api_key or os.getenv("ZHIPU_API_KEY"))
 
             response = client.images.generation(
-                model="cogview-4",
+                model=self.provider.model,
                 prompt=prompt,
                 size=size,
                 quality=quality
@@ -276,7 +262,7 @@ class ImageGenerator:
             )
 
             response = client.images.generate(
-                model="image-01",
+                model=self.provider.model,
                 prompt=prompt,
                 size=size
             )
@@ -298,7 +284,7 @@ class ImageGenerator:
                 url=f"{self.provider.base_url}/services/aigc/text-to-image/imageCreation",
                 headers={"Authorization": f"Bearer {self.provider.api_key or os.getenv('DASHSCOPE_API_KEY')}"},
                 json={
-                    "model": "wanx2.1-t2i-turbo",
+                    "model": self.provider.model,
                     "input": {"prompt": prompt},
                     "parameters": {"size": size}
                 },
@@ -424,6 +410,13 @@ class TerminalImageDisplay:
     @staticmethod
     def _detect_method() -> str:
         """检测终端支持的显示方法"""
+        from fr_cli.ui.ui import _NO_COLOR
+
+        # NO_COLOR / prompt_toolkit patch_stdout 环境下，原始转义序列会显示为乱码，
+        # 强制回退到最安全的 ASCII 字符画。
+        if _NO_COLOR:
+            return "ascii"
+
         term = os.environ.get("TERM_PROGRAM", "")
 
         if term == "iTerm.app":

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/agent/remote.py

@@ -1,40 +1,25 @@
 """
 远程 Agent 管理 —— 配置其他用户电脑中已启用 API 的 fr-cli Agent
 
-配置文件: ~/.fr_cli/remote/agents.json
-格式:
-{
-    "agent_name": {
-        "host": "192.168.1.100",
-        "port": 8080,
-        "token": "xxx",
-        "description": "远程数据分析助手"
-    }
-}
+配置统一收敛到 ~/.fr_cli/config.json 的 remote.agents 命名空间。
+旧文件 ~/.fr_cli/remote/agents.json 会在首次加载时一次性迁移。
 """
-import json
+from fr_cli.conf.config import load_namespace, save_namespace
 from fr_cli.conf.paths import REMOTE_AGENTS_FILE
-from pathlib import Path
 
-REMOTE_AGENTS_FILE = REMOTE_AGENTS_FILE  # from fr_cli.conf.paths
+_NS_KEY = "remote"
+REMOTE_AGENTS_FILE = REMOTE_AGENTS_FILE  # 保留用于一次性迁移
 
 
 def _load_remote_agents():
-    if not REMOTE_AGENTS_FILE.exists():
-        return {}
-    try:
-        with open(REMOTE_AGENTS_FILE, "r", encoding="utf-8") as f:
-            return json.load(f)
-    except Exception:
-        return {}
+    ns = load_namespace(_NS_KEY, default={"agents": {}}, old_path=REMOTE_AGENTS_FILE)
+    return ns.get("agents", {})
 
 
 def _save_remote_agents(data):
-    try:
-        with open(REMOTE_AGENTS_FILE, "w", encoding="utf-8") as f:
-            json.dump(data, f, ensure_ascii=False, indent=2)
-    except Exception:
-        pass
+    ns = load_namespace(_NS_KEY, default={"agents": {}})
+    ns["agents"] = data
+    save_namespace(_NS_KEY, ns)
 
 
 def add_remote_agent(name, host, port, token, description=""):

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/command/handlers/config.py

@@ -1,6 +1,6 @@
 """命令处理器 —— config"""
 
-from fr_cli.command.registry import register
+from fr_cli.command.registry import register, _TRIGGERS_CONFIG
 
 @register(
     name="undo",

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/command/handlers/cron.py

@@ -1,6 +1,6 @@
 """命令处理器 —— cron"""
 
-from fr_cli.command.registry import register
+from fr_cli.command.registry import register, _TRIGGERS_CRON
 
 @register(
     name="cron_add",

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/command/handlers/disk.py

@@ -1,6 +1,6 @@
 """命令处理器 —— disk"""
 
-from fr_cli.command.registry import register
+from fr_cli.command.registry import register, _TRIGGERS_DISK
 
 @register(
     name="disk_ls",

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/command/handlers/fs.py

@@ -1,6 +1,6 @@
 """命令处理器 —— fs"""
 
-from fr_cli.command.registry import register
+from fr_cli.command.registry import register, _TRIGGERS_FILE
 
 @register(
     name="write_file",

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/command/handlers/mail.py

@@ -1,6 +1,6 @@
 """命令处理器 —— mail"""
 
-from fr_cli.command.registry import register
+from fr_cli.command.registry import register, _TRIGGERS_MAIL
 
 @register(
     name="mail_inbox",

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/command/handlers/session.py

@@ -1,6 +1,6 @@
 """命令处理器 —— session"""
 
-from fr_cli.command.registry import register
+from fr_cli.command.registry import register, _TRIGGERS_SESSION
 
 @register(
     name="save_session",

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/command/handlers/web.py

@@ -1,6 +1,6 @@
 """命令处理器 —— web"""
 
-from fr_cli.command.registry import register
+from fr_cli.command.registry import register, _TRIGGERS_WEB
 
 @register(
     name="search_web",

{fr_cli-2.4.1 → fr_cli-2.4.2}/fr_cli/conf/config.py

@@ -22,6 +22,7 @@ DEFAULT_LIMIT = 20000
 def _default_config():
     """返回默认配置字典 —— provider/model 不再硬编码，由用户显式配置"""
     return {
+        "version": 2,
         "key": "",
         # 注意：默认不设置 provider 和 model，由用户通过 /model config 显式配置
         # 未配置时状态栏显示'未配置'
@@ -42,6 +43,24 @@ def _default_config():
     }
 
 
+def _upgrade_schema(cfg):
+    """把旧版配置升级到当前 schema（幂等执行）"""
+    version = cfg.get("version", 1)
+    if version >= 2:
+        return cfg
+
+    # v1 -> v2: 将顶层 model 同步到当前 provider 的专属配置中
+    provider = cfg.get("provider")
+    if provider and cfg.get("model"):
+        providers = cfg.setdefault("providers", {})
+        pcfg = providers.setdefault(provider, {})
+        if not pcfg.get("model"):
+            pcfg["model"] = cfg["model"]
+
+    cfg["version"] = 2
+    return cfg
+
+
 def load_config():
     """加载配置，如果缺失或损坏则返回带默认值的安全字典
 
@@ -74,19 +93,15 @@ def load_config():
         print(f"{YELLOW}⚠️ 使用默认配置，请重新设置{RESET}")
         return d
 
+    # schema 升级与向后兼容迁移（必须在补齐默认字段之前执行，
+    # 否则默认值中的 version 会提前写入，导致升级逻辑被跳过）
+    c = _upgrade_schema(c)
+
     # 补齐缺失字段（跳过 provider 和 model，由用户显式配置）
     for k, v in d.items():
         if k not in c and k not in ("provider", "model"):
             c[k] = v
 
-    # 向后兼容迁移：将顶层 model 同步到当前 provider 的专属配置中
-    provider = c.get("provider", "zhipu")
-    providers_cfg = c.setdefault("providers", {})
-    pcfg = providers_cfg.setdefault(provider, {})
-    if c.get("model") and not pcfg.get("model"):
-        pcfg["model"] = c["model"]
-        c["providers"] = providers_cfg
-
     return c
 
 
@@ -125,6 +140,46 @@ class ConfigError(Exception):
     pass
 
 
+def load_namespace(key, default=None, old_path=None):
+    """从主配置 config.json 的命名空间中读取数据。
+
+    若 old_path 指定的旧独立配置文件存在且主配置中该命名空间为空，
+    则一次性迁移旧文件内容到主配置并保存。
+    """
+    if default is None:
+        default = {}
+    cfg = load_config()
+    data = cfg.get(key)
+    if data is not None:
+        return data
+
+    # 尝试迁移旧文件
+    if old_path is not None:
+        old_path = Path(old_path)
+        if old_path.exists():
+            try:
+                old_data = json.loads(old_path.read_text(encoding="utf-8"))
+                if old_data:
+                    cfg[key] = old_data
+                    save_config(cfg)
+                    try:
+                        old_path.rename(str(old_path) + ".migrated")
+                    except Exception:
+                        pass
+                    return old_data
+            except Exception:
+                pass
+
+    return default
+
+
+def save_namespace(key, value):
+    """把数据写入主配置 config.json 的命名空间并持久化。"""
+    cfg = load_config()
+    cfg[key] = value
+    save_config(cfg)
+
+
 def init_config():
     """首次运行引导：迁移旧配置 → 检查并要求输入 API Key → 自动创建默认工作空间"""
     # 1. 自动迁移旧路径 → 新路径（一次性，幂等）
@@ -180,10 +235,8 @@ def init_config():
 
     pcfg = providers_cfg.get(provider, {})
 
-    # 检查当前提供商是否已配置 key
-    has_key = bool(pcfg.get("key"))
-    if not has_key and provider == "zhipu":
-        has_key = bool(c.get("key", ""))
+    # 检查当前提供商是否已配置 key（兼容旧版顶层 key 字段）
+    has_key = bool(pcfg.get("key") or c.get("key", ""))
 
     if not has_key:
         from fr_cli.core.llm import list_providers, get_provider_info