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

fr_cli-2.4.0/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.2/fr_cli.egg-info → fr_cli-2.4.0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: fr-cli
-Version: 2.3.2
+Version: 2.4.0
 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"
@@ -85,7 +87,7 @@ Dynamic: license-file
 - **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**: 实时语音交互
@@ -237,7 +239,7 @@ python3 main.py
 /security        查看安全设置
 ```
 
-## � Hermes 核心功能
+## 🧠 Hermes 核心功能
 
 ### 📋 任务管理
 ```
@@ -302,7 +304,7 @@ fr acp
 }
 ```
 
-## �📦 支持的模型提供商（25+）
+## 🤖 支持的模型提供商（25+）
 
 | 道统 | 默认模型 | API 地址 |
 |------|---------|----------|
@@ -312,7 +314,7 @@ fr acp
 | 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 |
+| 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 |
@@ -364,8 +366,60 @@ 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 编码助手的项目架构与开发指南
+
+## 📂 配置目录
+
+| 路径 | 说明 |
+|------|------|
+| `~/.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）|
+
+## ❓ 常见问题
+
+**Q: 如何切换思维模式?**
+```bash
+/mode direct   # 直接回复
+/mode cot      # 思维链
+/mode tot      # 思维树
+/mode react    # ReAct
+```
+
+**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.2 → fr_cli-2.4.0}/README.md

@@ -13,7 +13,7 @@
 - **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**: 实时语音交互
@@ -165,7 +165,7 @@ python3 main.py
 /security        查看安全设置
 ```
 
-## � Hermes 核心功能
+## 🧠 Hermes 核心功能
 
 ### 📋 任务管理
 ```
@@ -230,7 +230,7 @@ fr acp
 }
 ```
 
-## �📦 支持的模型提供商（25+）
+## 🤖 支持的模型提供商（25+）
 
 | 道统 | 默认模型 | API 地址 |
 |------|---------|----------|
@@ -240,7 +240,7 @@ fr acp
 | 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 |
+| 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 |
@@ -292,8 +292,60 @@ 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 编码助手的项目架构与开发指南
+
+## 📂 配置目录
+
+| 路径 | 说明 |
+|------|------|
+| `~/.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）|
+
+## ❓ 常见问题
+
+**Q: 如何切换思维模式?**
+```bash
+/mode direct   # 直接回复
+/mode cot      # 思维链
+/mode tot      # 思维树
+/mode react    # ReAct
+```
+
+**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.2 → fr_cli-2.4.0}/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.2 → fr_cli-2.4.0}/fr_cli/__init__.py

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

{fr_cli-2.3.2 → fr_cli-2.4.0}/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.2 → fr_cli-2.4.0}/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.2 → fr_cli-2.4.0}/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
 

{fr_cli-2.3.2 → fr_cli-2.4.0}/fr_cli/agent/acp.py

@@ -43,12 +43,11 @@ class ACPServer:
         """启动 ACP 服务器"""
         self.port = port
         self.running = True
-        
+
         try:
             import uvicorn
-            from fastapi import FastAPI
-            from fastapi.websockets import WebSocket
-            
+            from fastapi import FastAPI, WebSocket
+
             app = FastAPI()
 
             @app.websocket("/acp")
@@ -58,10 +57,10 @@ class ACPServer:
                     while self.running:
                         data = await websocket.receive_text()
                         message = json.loads(data)
-                        
+
                         # 处理 ACP 消息
                         response = await self.handle_message(message)
-                        
+
                         if response:
                             await websocket.send_text(json.dumps(response))
                 except Exception as e:
@@ -79,28 +78,33 @@ class ACPServer:
     async def handle_message(self, message: Dict) -> Optional[Dict]:
         """处理 ACP 消息"""
         msg_type = message.get("type")
-        
+
         if msg_type == "request":
             method = message.get("method")
             params = message.get("params", {})
-            
+
             if method == "chat":
                 result = await self.chat(params)
                 return {"id": message.get("id"), "type": "response", "result": result}
             elif method == "tools":
                 return {"id": message.get("id"), "type": "response", "result": self.get_tools()}
-            
+
         return None
 
     async def chat(self, params: Dict) -> str:
-        """处理聊天请求"""
-        from fr_cli.core.core import ask
+        """处理聊天请求（通过 fr_cli 的统一入口调用 LLM）"""
+        from fr_cli.main import handle_ai_chat
+        from fr_cli.core.core import AppState
+        from fr_cli.conf.config import load_config
         message = params.get("message", "")
         try:
-            result, _ = await asyncio.to_thread(ask, message)
-            return result
-        except:
-            return "Error processing request"
+            cfg = load_config()
+            # 构造一个临时 AppState 用于 LLM 调用（ACP 场景下 executor 可能未初始化）
+            state = AppState(cfg=cfg)
+            result, _ = await asyncio.to_thread(handle_ai_chat, state, message)
+            return result if result else ""
+        except Exception as e:
+            return f"Error processing request: {e}"
 
     def get_tools(self) -> list:
         """获取可用工具列表"""

fr_cli-2.4.0/fr_cli/agent/artifact_detector.py

@@ -0,0 +1,106 @@
+"""
+AI 回复产物检测器 —— 统一检测插件/Agent 代码结构
+
+提取自 core/chat.py 与 agent/master.py 的公共逻辑，
+消除重复代码，保证行为一致性。
+"""
+
+import sys
+from fr_cli.ui.ui import RED, GREEN, YELLOW, DIM, RESET
+from fr_cli.lang.i18n import T
+from fr_cli.addon.plugin import extract_code, PLUGIN_DIR
+
+
+def detect_plugin_artifact(txt: str, lang: str, state) -> bool:
+    """检测 AI 回复中的插件代码结构，提示用户保存。
+
+    :param txt: AI 回复文本
+    :param lang: 界面语言
+    :param state: AppState 实例（需有 security 和 plugins 属性）
+    :return: 是否检测到并处理了插件
+    """
+    if not txt or "def run(args='')" not in txt or "```python" not in txt:
+        return False
+
+    code = extract_code(txt)
+    if not code or "def run" not in code or len(code) <= 50:
+        return False
+
+    try:
+        pname = input(f"{YELLOW}{T('artifact_detect', lang)}{RESET}").strip()
+        if not pname:
+            return False
+
+        safe_name = "".join(c for c in pname if c.isalnum() or c == '_')
+        if not safe_name:
+            print(f"{RED}名称无效，仅允许字母/数字/下划线{RESET}")
+            return False
+
+        if hasattr(state, 'security') and state.security:
+            if not state.security.check("sec_write", f"/{safe_name}"):
+                return False
+        else:
+            # 无安全模块时直接放行（测试环境）
+            pass
+
+        PLUGIN_DIR.mkdir(parents=True, exist_ok=True)
+        p_path = PLUGIN_DIR / f"{safe_name}.py"
+        p_path.write_text(code, encoding='utf-8')
+        if hasattr(state, 'plugins'):
+            state.plugins[safe_name] = str(p_path)
+        print(f"{GREEN}{T('ok_forged', lang, safe_name)}{RESET}")
+        return True
+    except EOFError:
+        return False
+
+
+def detect_agent_artifact(txt: str, lang: str, state) -> bool:
+    """检测 AI 回复中的 Agent 分身代码结构，提示用户保存。
+
+    :param txt: AI 回复文本
+    :param lang: 界面语言
+    :param state: AppState 实例（仅用于安全校验，可选）
+    :return: 是否检测到并处理了 Agent
+    """
+    if not txt or "def run(context," not in txt or "```python" not in txt:
+        return False
+
+    code = extract_code(txt)
+    if not code or "def run(context," not in code or len(code) <= 50:
+        return False
+
+    try:
+        aname = input(f"{YELLOW}⚡ 检测到 Agent 分身结构，赐名 (回车放弃): {RESET}").strip()
+        if not aname:
+            return False
+
+        safe_name = "".join(c for c in aname if c.isalnum() or c == '_')
+        if not safe_name:
+            print(f"{RED}名称无效，仅允许字母/数字/下划线{RESET}")
+            return False
+
+        from fr_cli.agent.manager import (
+            create_agent_dir, save_agent_code, save_persona, save_skills, agent_exists
+        )
+        if agent_exists(safe_name):
+            confirm = input(
+                f"{YELLOW}Agent [{safe_name}] 已存在，是否覆盖? [y/N]: {RESET}"
+            ).strip().lower()
+            if confirm not in ("y", "yes"):
+                print(f"{DIM}已取消。{RESET}")
+                return False
+            d = create_agent_dir(safe_name)
+            save_agent_code(safe_name, code)
+            print(f"{GREEN}✅ Agent [{safe_name}] 已覆盖更新。{RESET}")
+            print(f"{DIM}  路径: {d}{RESET}")
+        else:
+            d = create_agent_dir(safe_name)
+            save_agent_code(safe_name, code)
+            save_persona(safe_name, f"#{safe_name}\n\n由 AI 对话创建的 Agent 分身。")
+            save_skills(safe_name, "## 技能\n\n- 执行自定义 Python 逻辑\n- 入口: run(context, **kwargs)")
+            print(f"{GREEN}✅ Agent [{safe_name}] 创建完成！{RESET}")
+            print(f"{DIM}  路径: {d}{RESET}")
+            print(f"{DIM}  运行: /agent_run {safe_name} [参数]{RESET}")
+        return True
+    except EOFError:
+        return False

{fr_cli-2.3.2 → fr_cli-2.4.0}/fr_cli/agent/builtins/__init__.py

@@ -1,4 +1,4 @@
 """
-内置 Agent 分身 —— 本命神通
+内置 Agent 分身 —— 本命工具/功能
 @local / @remote / @spider 等特殊前缀的 REPL 拦截器
 """

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

@@ -3,8 +3,9 @@
 支持 MySQL / PostgreSQL / SQL Server / Oracle 的 Schema 分析和 SQL 生成。
 """
 from pathlib import Path
+from fr_cli.conf.paths import DATABASE_FILE
 
-DB_CFG_PATH = Path.home() / ".fr_cli_databases.json"
+DB_CFG_PATH = DATABASE_FILE  # from fr_cli.conf.paths
 
 DB_SYS_PROMPT = """你是一个数据库专家。请根据以下数据库 Schema 信息和用户需求，生成最合适的 SQL 语句。
 
@@ -104,8 +105,12 @@ def _get_schema_info(conn, db_type):
         cursor.execute("SELECT table_name FROM information_schema.tables WHERE table_type = 'BASE TABLE'")
         tables = [r[0] for r in cursor.fetchall()]
         for table in tables:
+            # 防御：表名可能含特殊字符（罕见但合法），用参数化
             info.append(f"\n表: {table}")
-            cursor.execute(f"SELECT column_name, data_type FROM information_schema.columns WHERE table_name = '{table}'")
+            cursor.execute(
+                "SELECT column_name, data_type FROM information_schema.columns WHERE table_name = ?",
+                (table,),
+            )
             for col in cursor.fetchall():
                 info.append(f"  {col[0]} {col[1]}")
     elif db_type == "oracle":
@@ -113,19 +118,57 @@ def _get_schema_info(conn, db_type):
         tables = [r[0] for r in cursor.fetchall()]
         for table in tables:
             info.append(f"\n表: {table}")
-            cursor.execute(f"SELECT column_name, data_type FROM user_tab_columns WHERE table_name = '{table}' ORDER BY column_id")
+            # Oracle: 表名是 Oracle 标识符；用绑定变量同样安全
+            cursor.execute(
+                "SELECT column_name, data_type FROM user_tab_columns WHERE table_name = :t ORDER BY column_id",
+                {"t": table},
+            )
             for col in cursor.fetchall():
                 info.append(f"  {col[0]} {col[1]}")
 
     return "\n".join(info)
 
 
+def _has_multiple_statements(sql: str) -> bool:
+    """检测 SQL 是否包含多条语句（启发式：去掉字符串字面量后是否还有 ;）
+
+    用于阻断 SELECT 1; DELETE FROM users 这类多语句注入。
+    末尾的 ; 不算（先 rstrip 掉）。
+    """
+    # 先去掉末尾空白和分号
+    sql_stripped = sql.rstrip(" \t\r\n;")
+
+    cleaned = []
+    in_string = False
+    escape = False
+    quote_char = None
+    for ch in sql_stripped:
+        if escape:
+            escape = False
+            continue
+        if ch == "\\" and in_string:
+            escape = True
+            continue
+        if in_string:
+            if ch == quote_char:
+                in_string = False
+            continue
+        if ch in ("'", '"'):
+            in_string = True
+            quote_char = ch
+            continue
+        cleaned.append(ch)
+    return ";" in "".join(cleaned)
+
+
 def _exec_sql(conn, sql, db_type):
     """执行 SQL 并返回结果"""
     cursor = conn.cursor()
     try:
-        # 限制只执行单条语句，防止注入
-        sql = sql.strip().rstrip(";")
+        sql = sql.strip()
+        if _has_multiple_statements(sql):
+            return None, "禁止执行多条 SQL 语句（检测到语句分隔符 ';'）"
+        sql = sql.rstrip(";")
         cursor.execute(sql)
 
         # 如果是 SELECT，返回结果集
@@ -199,7 +242,7 @@ def handle_db(user_input, state):
         ]
 
         print(f"{CYAN}🧙 正在生成 SQL...{RESET}")
-        sql_text, _, _ = stream_cnt(state.client, state.model_name, messages, state.lang, custom_prefix="", max_tokens=1024)
+        sql_text, _, _, _ = stream_cnt(state.client, state.model_name, messages, state.lang, custom_prefix="", max_tokens=1024)
         sql_text = sql_text.strip()
 
         from fr_cli.agent.builtins._utils import strip_code_blocks

{fr_cli-2.3.2 → fr_cli-2.4.0}/fr_cli/agent/builtins/local.py

@@ -5,6 +5,7 @@
 import platform
 import shutil
 import subprocess
+import shlex
 
 LOCAL_SYS_PROMPT = """你是一个系统命令专家。请根据用户的操作系统类型和需求，生成最合适、最安全的系统命令。
 
@@ -56,7 +57,7 @@ def handle_local(user_input, state):
     ]
 
     print(f"{CYAN}🧙 正在分析本地操作...{RESET}")
-    cmd_text, _, _ = stream_cnt(state.client, state.model_name, messages, state.lang, custom_prefix="", max_tokens=1024)
+    cmd_text, _, _, _ = stream_cnt(state.client, state.model_name, messages, state.lang, custom_prefix="", max_tokens=1024)
     cmd_text = cmd_text.strip()
 
     # 清理可能的代码块
@@ -85,9 +86,9 @@ def handle_local(user_input, state):
             if ps_exe:
                 res = subprocess.run([ps_exe, "-Command", cmd_text], capture_output=True, text=True, timeout=30)
             else:
-                res = subprocess.run(cmd_text, shell=True, capture_output=True, text=True, timeout=30)
+                res = _run_cmd_safely(cmd_text, timeout=30, allow_shell=True)
         else:
-            res = subprocess.run(cmd_text, shell=True, capture_output=True, text=True, timeout=30)
+            res = _run_cmd_safely(cmd_text, timeout=30)
         out = res.stdout + res.stderr
         if out.strip():
             print(f"\n{GREEN}{out.strip()[:3000]}{RESET}")
@@ -103,3 +104,17 @@ def handle_local(user_input, state):
         print(f"{RED}⏱️ 命令执行超时（30秒）{RESET}")
     except Exception as e:
         print(f"{RED}❌ 执行失败: {e}{RESET}")
+
+
+def _run_cmd_safely(cmd_text: str, timeout: int = 30, allow_shell: bool = False):
+    """安全执行命令：POSIX 用 shlex.split + shell=False；仅在显式 allow_shell=True 时降级。"""
+    try:
+        cmd_list = shlex.split(cmd_text)
+    except ValueError:
+        # shlex 解析失败（包含未闭合引号等）—— 视情况降级
+        if allow_shell:
+            return subprocess.run(cmd_text, shell=True, capture_output=True, text=True, timeout=timeout)
+        return subprocess.CompletedProcess(args=cmd_text, returncode=1, stdout="", stderr="命令解析失败")
+    if not cmd_list:
+        return subprocess.CompletedProcess(args=cmd_text, returncode=1, stdout="", stderr="空命令")
+    return subprocess.run(cmd_list, shell=False, capture_output=True, text=True, timeout=timeout)

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

@@ -11,7 +11,7 @@
 - 多轮对话和任务执行
 
 使用方法：
-1. 将此文件复制到 ~/.fr_cli_agents/<your_agent>/agent.py
+1. 将此文件复制到 ~/.fr_cli/agents/<your_agent>/agent.py
 2. 编辑 persona.md, memory.md, skills.md 配置 Agent 角色
 3. 在 config.json 中设置专属模型配置
 
@@ -281,7 +281,7 @@ class MemorySystem:
 
     def __init__(self, agent_name: str, memory_file: str = None):
         self.agent_name = agent_name
-        self.memory_file = memory_file or f"~/.fr_cli_agents/{agent_name}/memory.md"
+        self.memory_file = memory_file or f"~/.fr_cli/agents/{agent_name}/memory.md"
         self.short_term: List[MemoryEntry] = []
         self.long_term: List[MemoryEntry] = []
         self.max_short_term = 50  # 短期记忆最大条数
@@ -913,4 +913,4 @@ if __name__ == "__main__":
     print("可用工具: read_file, write_file, list_files, search_files,")
     print("          web_search, fetch_url, execute_code, run_command,")
     print("          db_query, call_agent, delegate_task")
-    print("\n将此模板复制到 ~/.fr_cli_agents/<your_agent>/agent.py 即可使用")
+    print("\n将此模板复制到 ~/.fr_cli/agents/<your_agent>/agent.py 即可使用")