fr-cli 2.1.0__py3-none-any.whl

fr_cli/README.md

@@ -0,0 +1,148 @@
+# 凡人打字机 (fr-cli)
+
+基于智谱 AI (ZhipuAI / GLM) 的终极全能终端工具。
+
+**🇨🇳 中文简介**
+
+支持：AI 智能对话、MasterAgent 自我进化主控、思维模式切换（direct/CoT/ToT/ReAct）、文件沙盒操作、联网搜索（SSRF 防护）、图片生成与识别、邮件收发、定时任务（shlex 安全解析）、云盘集成、会话记忆、按日期自动存档、插件进化（子进程隔离）、四阶安全拦截、Shell 管道直通 AI。
+
+**🇺🇸 English Intro**
+
+The ultimate all-knowing terminal tool based on Zhipu AI. Supports AI chat, MasterAgent self-evolving controller, thinking modes (direct/CoT/ToT/ReAct), virtual filesystem, web search (SSRF-protected), image generation & vision, email, cron jobs (shlex-safe), cloud drive, session memory, auto date-based archiving, self-evolving plugins (subprocess-isolated), and powerful Shell piping.
+
+---
+
+## 🚀 快速开始
+
+```bash
+pip install fr-cli
+fr-cli
+```
+
+首次运行会引导输入智谱 API Key。
+
+## 🎮 使用方式
+
+### 用户直接命令
+
+在 `>>>` 提示符下输入 `/` 命令：
+
+```
+/ls                列出当前目录文件
+/cat <file>        查看文件内容
+/write <file>      写入文件（多行输入，Ctrl+D 结束）
+/cd <dir>          切换工作目录
+/delete <file>     删除文件
+/search <query>    联网搜索
+/save <name>       保存会话
+/load              加载历史会话
+/export            导出会话为 Markdown
+/session_list      列出按日期存档的会话
+/session_load <idx>  加载存档会话
+/mode direct|cot|tot|react  切换思维模式
+/master on|off|status        MasterAgent 主控
+/mcp_list          列出 MCP 服务器及工具
+/mcp_add <名> <命令> [参数]  添加 MCP 服务器
+/mcp_del <名>      删除 MCP 服务器
+/help              查看全部命令
+/exit              退出
+```
+
+### AI 自动工具调用
+
+当请求涉及文件、搜索、画图等操作时，AI 会自动调用内置工具：
+
+```
+【调用：write_file({"path": "hello.md", "content": "# Hello\n\nWorld"})】
+【调用：search_web({"query": "Python 教程"})】
+【调用：generate_image({"prompt": "一只猫在月球上"})】
+```
+
+### 插件（Skills）
+
+自定义插件通过命令方式调用：
+
+```
+【命令：/my_plugin 参数】
+```
+
+---
+
+## 📂 项目结构
+
+```
+fr_cli/
+├── main.py              # 核心入口：REPL 循环、AI 交互编排（~600行）
+├── repl/
+│   └── commands.py      # 40个命令处理器（从 main.py 提取）
+├── WEAPON.MD            # 法宝图谱（工具清单，人类可读，不再参与程序逻辑）
+├── agent/               # Agent 分身系统 + MasterAgent 主控
+│   ├── master.py        # 自我进化主控 Agent（ReAct 循环）
+│   ├── master_prompt.py # MasterAgent 系统提示词模板
+│   ├── manager.py       # Agent 生命周期管理
+│   ├── executor.py      # Agent 执行器（run/delegate/multi-agent）
+│   ├── workflow.py      # 工作流引擎（workflow.md 解析与执行）
+│   └── server.py        # HTTP 服务（默认 127.0.0.1 + Bearer Token）
+├── command/
+│   ├── executor.py      # 命令执行引擎（动态构建依赖，消除 _deps 快照）
+│   ├── registry.py      # 统一工具注册表
+│   └── security.py      # 四阶安全确认管理器
+├── weapon/              # 武器库/扩展子系统
+│   ├── fs.py            # 虚拟文件系统 VFS
+│   ├── web.py           # 网络搜索与网页抓取（SSRF 防护）
+│   ├── vision.py        # 图片生成 (CogView) / 多模态 (GLM-4V)
+│   ├── mail.py          # 邮件客户端（防头注入）
+│   ├── disk.py          # 云盘适配器
+│   ├── cron.py          # 定时任务（shlex + shell=False）
+│   ├── launcher.py      # 本地应用启动器（跨平台）
+│   ├── dataframe.py     # Excel / CSV 读取与分析
+│   └── loader.py        # 从注册表动态生成工具描述
+├── memory/
+│   ├── history.py       # 会话历史保存/加载/导出
+│   ├── context.py       # 上下文记忆（最近 5 轮摘要）
+│   └── session.py       # 按日期自动存档会话引擎
+├── core/
+│   ├── core.py          # AppState 全局状态容器（DI 容器）
+│   ├── stream.py        # 流式输出与代码块高亮
+│   ├── recommender.py   # 功能推荐引擎
+│   ├── sysmon.py        # 系统状态监控
+│   └── thinking.py      # 思维模式引擎（CoT/ToT/ReAct）
+├── addon/
+│   └── plugin.py        # 插件加载与执行（runpy + json.dumps）
+├── conf/
+│   └── config.py        # 配置读写（mkstemp + 0o600 原子写入）
+├── lang/
+│   └── i18n.py          # 国际化 (zh/en)
+├── security/
+│   └── security.py      # 安全确认引擎
+└── ui/
+    └── ui.py            # 终端 UI、颜色、动画
+```
+
+---
+
+## 📦 可选依赖
+
+```bash
+pip install fr-cli[all]          # 全功能（含网盘）
+pip install fr-cli[baidu]        # 百度网盘
+pip install fr-cli[aliyun]       # 阿里云盘
+pip install fr-cli[onedrive]     # OneDrive
+```
+
+---
+
+## 🔧 开发
+
+```bash
+git clone https://github.com/yourname/fr-cli.git
+cd fr-cli
+pip install -e ".[all]"
+python -m pytest tests/ -v
+```
+
+---
+
+## 📄 License
+
+MIT

fr_cli/WEAPON.MD

@@ -0,0 +1,186 @@
+# 法宝图谱 (WEAPON.MD)
+
+> 本文档描述凡人打字机所有可用工具（武器/法宝）。
+> 程序运行时会从此文件读取工具信息，动态注入大模型上下文。
+> 修改本文件后重启程序即可生效，无需改动源码。
+> **调用格式**：所有内置工具使用 `【调用：tool_name({"参数": "值"})】` 格式，参数为标准 JSON。
+
+---
+
+## file_operations
+- **名称**: 文件操作工具
+- **功能**: 列出文件、查看文件内容、切换目录、写入文件、追加内容、删除文件等
+- **程序路径**: fr_cli/weapon/fs.py
+- **调用方式**: write_file, read_file, list_files, change_dir, append_file, delete_file
+- **触发关键词**: 文件, 目录, folder, 读取, read, 保存到, save to, 写入文件, 创建文件, 生成文件, ls , cat , cd , write , append , delete
+
+## image_analysis
+- **名称**: 图片分析工具
+- **功能**: 查看和分析图片内容、生成图片
+- **程序路径**: fr_cli/weapon/vision.py
+- **调用方式**: analyze_image, generate_image
+- **触发关键词**: 分析图片, 识图, 看图, describe image, 图片内容, 识别图片, 生成图片, 画图, 画一张
+
+## email_management
+- **名称**: 邮件管理工具
+- **功能**: 查看收件箱、读取邮件、发送邮件
+- **程序路径**: fr_cli/weapon/mail.py
+- **调用方式**: mail_inbox, mail_read, mail_send
+- **触发关键词**: 邮件, mail, email, 发邮件, 收件箱, inbox, 发送邮件, 查看邮件
+
+## web_search
+- **名称**: 网络搜索工具
+- **功能**: 搜索网络内容和获取网页
+- **程序路径**: fr_cli/weapon/web.py
+- **调用方式**: search_web, fetch_web
+- **触发关键词**: 搜索, search, 查一下, 查询, look up, 最新新闻, 今天天气, 股价, 汇率, 查百度, 查谷歌
+
+## scheduled_tasks
+- **名称**: 定时任务工具
+- **功能**: 添加、列出和删除定时任务。支持 shell 命令和 Agent 分身两种任务类型。
+- **程序路径**: fr_cli/weapon/cron.py
+- **调用方式**: 
+  - shell 类型: `cron_add`, `cron_list`, `cron_del`（由 Gatekeeper 持久化执行）
+  - Agent 类型: `/agent_cron_add <agent> <秒> [输入]`, `/agent_cron_list`, `/agent_cron_del <ID>`
+- **触发关键词**: 定时任务, 定时执行, 周期性执行, cron job, scheduled task, 定时器
+
+## cloud_storage
+- **名称**: 云盘管理工具
+- **功能**: 上传、下载和列出云盘文件
+- **程序路径**: fr_cli/weapon/disk.py
+- **调用方式**: disk_ls, disk_up, disk_down
+- **触发关键词**: 云盘, 上传文件, 下载文件, cloud disk, upload file, download file, 云端
+
+## session_management
+- **名称**: 会话管理工具
+- **功能**: 保存、加载和导出会话
+- **程序路径**: fr_cli/memory/history.py
+- **调用方式**: save_session, list_sessions, export_session
+- **触发关键词**: 保存会话, 加载会话, 导出会话, save session, load session, export session
+
+## configuration
+- **名称**: 配置管理工具
+- **功能**: 设置模型、API密钥、语言等
+- **程序路径**: fr_cli/conf/config.py
+- **调用方式**: set_model, set_key, set_limit, set_lang
+- **触发关键词**: 切换模型, 换模型, 改模型, set model, api key, api密钥, 切换语言, 设置上限
+
+## plugin_system
+- **名称**: 插件系统工具
+- **功能**: 查看和执行自定义插件（skills）
+- **程序路径**: fr_cli/addon/plugin.py
+- **调用方式**: 【命令：/skills】, 【命令：/<plugin_name>】
+- **触发关键词**: 插件, plugin, 技能, skill, 法宝, 自定义工具
+
+## system_commands
+- **名称**: 系统命令工具
+- **功能**: 执行shell命令和管道操作
+- **程序路径**: 内置 (main.py)
+- **调用方式**: !<command>, !<cmd> | <prompt>
+- **触发关键词**: 执行命令, shell, bash, 系统命令, 运行命令, terminal
+
+## launcher_system
+- **名称**: 本机应用启动器
+- **功能**: 跨平台调用浏览器、办公软件、通讯工具、媒体播放器等本地程序
+- **程序路径**: fr_cli/weapon/launcher.py
+- **调用方式**: /open <路径/URL>, /launch <应用> [目标], /apps
+- **触发关键词**: 打开, open, 启动, launch, 浏览, 播放, 查看, 打开微信, 打开浏览器, 打开 Word
+
+## agent_system
+- **名称**: Agent 分身系统
+- **功能**: 创建独立 Agent（角色设定/记忆/技能/工作流），支持 HTTP API 调用
+- **程序路径**: fr_cli/agent/
+- **调用方式**:
+  - `/agent_create <name> <desc>` — AI 自动生成完整 Agent
+  - `/agent_forge <name>` — 从最近 AI 回复中提取代码铸造 Agent
+  - `/agent_list`, `/agent_show`, `/agent_edit`, `/agent_run`, `/agent_delete` — 管理 Agent
+  - `/agent_server start [port]`, `/agent_server stop`, `/agent_server status` — HTTP 服务
+- **触发关键词**: agent, 分身, 工作流, workflow, API, HTTP 服务
+- **创建方式**: 1) AI 自动生成 2) `/agent_forge` 从代码铸造 3) 自动检测提示 4) 手动创建 `~/.fr_cli_agents/<name>/agent.py`
+
+## builtin_local
+- **名称**: @local 本机助手
+- **功能**: 拦截 `@local <需求>`，AI 自动生成并执行本机系统命令，结果保存到 Agent 记忆
+- **程序路径**: fr_cli/agent/builtins/local.py
+- **调用方式**: `@local <需求描述>`
+- **触发关键词**: 本地操作, 本机, 系统命令, 终端, shell
+
+## builtin_remote
+- **名称**: @remote 远程运维助手
+- **功能**: 管理多机 SSH 连接，`@remote [IP/别名] <需求>` 自动探测远程 OS 并生成命令
+- **程序路径**: fr_cli/agent/builtins/remote.py
+- **调用方式**: `@remote <需求>` 或 `@remote [别名] <需求>`
+- **触发关键词**: 远程, 服务器, SSH, 运维, Linux, 主机管理
+
+## builtin_spider
+- **名称**: @spider 爬虫助手
+- **功能**: requests → selenium 降级策略，模拟真人行为，深度爬取，保存到 `web_YYYYMMDD/`
+- **程序路径**: fr_cli/agent/builtins/spider.py
+- **调用方式**: `@spider <需求>`
+- **触发关键词**: 爬取, 爬虫, 抓取, spider, 采集, 网页下载, 批量下载
+
+## builtin_db
+- **名称**: @db 数据库助手
+- **功能**: MySQL/PostgreSQL/SQL Server/Oracle 通用交互，自动分析 Schema 生成 SQL，危险操作警告
+- **程序路径**: fr_cli/agent/builtins/db.py
+- **调用方式**: `@db <需求>` 或 `@db [别名] <需求>`
+- **触发关键词**: 数据库, SQL, MySQL, PostgreSQL, 查询, 表结构, DB
+
+## builtin_rag
+- **名称**: @RAG 本地知识库助手
+- **功能**: ChromaDB 向量检索 + CrossEncoder 重排序(Rerank) + 大模型最佳片段判定。后台自动向量化监控目录。支持两种监控模式：
+  - 向量检索：使用 all-MiniLM-L6-v2 嵌入模型，检索 top-15 候选
+  - Rerank 重排序：使用 cross-encoder/ms-marco-MiniLM-L-6-v2 对候选重新打分，取 top-3
+  - 大模型判定：让 LLM 从 top-3 中评估相关性/完整性/准确性，选出最佳片段 ★【最佳】
+  - 最终生成：优先基于最佳片段回答，可综合其他片段补充
+  - 内置模式（daemon 线程）：`/rag_dir <目录>` 后自动启动
+  - 独立模式（系统进程）：`/rag_watch start [目录] [--interval N]`，退出终端后仍继续运行
+- **程序路径**: fr_cli/agent/builtins/rag.py
+- **调用方式**: `@RAG <问题>` / `/rag_dir <路径>` / `/rag_sync` / `/rag_watch start|stop|status|log`
+- **触发关键词**: 知识库, RAG, 检索, 向量搜索, 文档问答, 本地文档
+
+## data_scroll
+- **名称**: 数据卷轴
+- **功能**: 读取 Excel/CSV，输出列名、类型、统计信息和数据预览
+- **程序路径**: fr_cli/weapon/dataframe.py
+- **调用方式**: `/read_excel <文件>`, `/read_csv <文件>`
+- **触发关键词**: Excel, CSV, 表格, 数据分析, 数据预览, 统计
+
+## gatekeeper
+- **名称**: 结界守护进程
+- **功能**: 独立于主程序运行的守护进程，持久化 Agent HTTP 服务、全局定时任务（shell）和 Agent 分身定时任务。每30秒热重载配置，自动同步主进程新增/删除的任务。
+- **程序路径**: fr_cli/gatekeeper/daemon.py, fr_cli/gatekeeper/manager.py
+- **调用方式**: `/gatekeeper start|stop|status`, `/agent_cron_add <agent> <秒> [输入]`, `/agent_cron_list`, `/agent_cron_del <ID>`
+- **触发关键词**: 守护进程, 后台, daemon, gatekeeper, 持久化, Agent 定时任务
+
+
+## thinking_mode
+- **名称**: 思维推演模式
+- **功能**: 在最终回答前，让大模型按照人类思维范式进行问题拆解和自我反馈验证。支持 CoT（思维链）、ToT（思维树）、ReAct（推理+行动）三种模式。
+- **程序路径**: fr_cli/core/thinking.py
+- **调用方式**: `/mode direct|cot|tot|react`
+- **触发关键词**: 深度思考, 推理, 思维链, 思维树, ReAct, 拆解问题, 自我验证
+
+模式说明:
+  - direct（默认）：直接回答，不增加额外推理步骤
+  - cot：先进行问题拆解、假设提出、验证评估、方案整合、自我检查，再将推理结果注入最终回答
+  - tot：生成多分支策略树，逐层评估打分，选择最优路径并给出备选方案
+  - react：每一步先思考（Thought）再行动（Action），基于观察结果（Observation）循环迭代，直到问题解决
+
+
+## mcp_tools
+- **名称**: MCP 外部神通
+- **功能**: 连接外部 MCP (Model Context Protocol) 服务器，将其工具纳入统一注册表。支持 stdio 传输方式，可动态发现服务器提供的工具并调用。
+- **程序路径**: fr_cli/weapon/mcp.py
+- **调用方式**: 
+  - 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` 字段
+- **示例**:
+  ```
+  /mcp_add fs npx -y @modelcontextprotocol/server-filesystem /tmp
+  /mcp_refresh
+  >>> 用 MCP 工具读取 /tmp/hello.txt
+  🧙 仙人 【调用：mcp_call({"server": "fs", "tool": "read_file", "arguments": {"path": "/tmp/hello.txt"}})】
+  ```

fr_cli/__init__.py

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

fr_cli/addon/plugin.py

@@ -0,0 +1,69 @@
+"""
+插件进化引擎
+负责本地技能的扫描、动态落盘与沙盒执行
+"""
+import re, subprocess, sys
+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"
+
+def init_plugins():
+    """扫描并初始化本地插件字典 {名字: 绝对路径}"""
+    PLUGIN_DIR.mkdir(parents=True, exist_ok=True)
+    plugins = {}
+    for f in PLUGIN_DIR.glob("*.py"):
+        name = f.stem.lower()
+        plugins[name] = str(f)
+    return plugins
+
+def extract_code(text):
+    """提取 AI 回复中的首段 Python 代码段"""
+    pattern = r"```python\s*\n(.*?)```"
+    match = re.search(pattern, text, re.DOTALL | re.IGNORECASE)
+    if match:
+        return match.group(1).strip()
+    return ""
+
+
+def exec_plugin(name, path, args, lang):
+    """
+    在子进程中安全执行插件
+    约定：插件必须包含 def run(args='')
+    """
+    # 安全检查：插件名必须是合法 Python 标识符
+    if not name.isidentifier():
+        print(f"{RED}❌ 非法插件名: {name}{RESET}")
+        return
+
+    import json, shlex
+    # 使用 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__')
+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})))
+    except Exception as e:
+        print(f"Error: {{e}}", file=sys.stderr)
+"""
+    try:
+        # 使用子进程执行，限制超时时间为 15 秒
+        res = subprocess.run(
+            [sys.executable, "-c", runner_code],
+            capture_output=True, text=True, timeout=15
+        )
+        if res.stdout.strip():
+            print(res.stdout.strip())
+        if res.stderr.strip():
+            print(f"{DIM}{res.stderr.strip()}{RESET}")
+    except subprocess.TimeoutExpired:
+        print(f"{RED}⏳ {T('err_posix', lang)} Timeout (15s){RESET}")
+    except Exception as e:
+        print(f"{RED}{T('err_posix', lang)} {e}{RESET}")

fr_cli/agent/__init__.py

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

fr_cli/agent/builtins/__init__.py

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

fr_cli/agent/builtins/_utils.py

@@ -0,0 +1,48 @@
+"""
+内置 Agent 公共工具库
+提取各内置 Agent 中的重复逻辑：Markdown 清理、确认对话框、JSON 配置读写等。
+"""
+import json
+from pathlib import Path
+
+
+def strip_code_blocks(text):
+    """去除 markdown 代码块标记（```language ... ```）"""
+    text = text.strip()
+    if text.startswith("```"):
+        text = text.split("\n", 1)[1] if "\n" in text else ""
+        if text.endswith("```"):
+            text = text.rsplit("\n", 1)[0]
+        text = text.strip()
+    return text
+
+
+def confirm_execute(prompt="是否执行", default_yes=True):
+    """交互式确认执行
+    返回 True 表示用户确认执行，False 表示取消。
+    """
+    from fr_cli.ui.ui import DIM, RESET
+    suffix = "[Y/n]" if default_yes else "[y/N]"
+    confirm = input(f"{DIM}{prompt}? {suffix}: {RESET}").strip().lower()
+    if default_yes:
+        return not confirm or confirm in ("y", "yes")
+    return confirm in ("y", "yes")
+
+
+def load_json_config(path, default=None):
+    """安全加载 JSON 配置文件"""
+    if default is None:
+        default = {}
+    path = Path(path)
+    if not path.exists():
+        return default
+    try:
+        return json.loads(path.read_text(encoding="utf-8"))
+    except Exception:
+        return default
+
+
+def save_json_config(path, data):
+    """安全保存 JSON 配置文件"""
+    path = Path(path)
+    path.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")