fr-cli 2.1.0__tar.gz

fr_cli-2.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 leungyukit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fr_cli-2.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include fr_cli/WEAPON.MD
+include fr_cli/README.md

fr_cli-2.1.0/PKG-INFO

@@ -0,0 +1,227 @@
+Metadata-Version: 2.4
+Name: fr-cli
+Version: 2.1.0
+Summary: 凡人打字机 - 基于智谱AI的终极全能终端工具
+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
+Keywords: zhipuai,glm,cli,ai,terminal,chatbot
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: zhipuai>=2.0.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: mcp>=1.6.0
+Provides-Extra: data
+Requires-Dist: pandas>=1.5.0; extra == "data"
+Requires-Dist: openpyxl>=3.0.0; extra == "data"
+Provides-Extra: db
+Requires-Dist: pymysql>=1.0.0; extra == "db"
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "db"
+Requires-Dist: pyodbc>=4.0.0; extra == "db"
+Requires-Dist: oracledb>=1.3.0; extra == "db"
+Provides-Extra: rag
+Requires-Dist: chromadb>=0.4.0; extra == "rag"
+Requires-Dist: sentence-transformers>=2.2.0; extra == "rag"
+Provides-Extra: remote
+Requires-Dist: paramiko>=3.0.0; extra == "remote"
+Provides-Extra: spider
+Requires-Dist: selenium>=4.10.0; extra == "spider"
+Provides-Extra: cloud
+Requires-Dist: bypy; extra == "cloud"
+Requires-Dist: aligo; extra == "cloud"
+Requires-Dist: msal; extra == "cloud"
+Provides-Extra: monitor
+Requires-Dist: watchdog>=3.0.0; extra == "monitor"
+Provides-Extra: all
+Requires-Dist: pandas>=1.5.0; extra == "all"
+Requires-Dist: openpyxl>=3.0.0; extra == "all"
+Requires-Dist: pymysql>=1.0.0; extra == "all"
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "all"
+Requires-Dist: pyodbc>=4.0.0; extra == "all"
+Requires-Dist: oracledb>=1.3.0; extra == "all"
+Requires-Dist: chromadb>=0.4.0; extra == "all"
+Requires-Dist: sentence-transformers>=2.2.0; extra == "all"
+Requires-Dist: paramiko>=3.0.0; extra == "all"
+Requires-Dist: selenium>=4.10.0; extra == "all"
+Requires-Dist: bypy; extra == "all"
+Requires-Dist: aligo; extra == "all"
+Requires-Dist: msal; extra == "all"
+Requires-Dist: watchdog>=3.0.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# 凡人打字机 (fr-cli)
+
+基于智谱 AI (ZhipuAI/GLM) 的终极全能终端工具。
+
+## ✨ 功能特性
+
+- 🤖 **AI 对话**：基于 GLM-4 系列模型的智能对话
+- 🧠 **MasterAgent 主控**：自我进化的 ReAct 主控 Agent，自动规划、调用工具、反思进化
+- 🧩 **思维模式**：direct / CoT / ToT / ReAct 四种推理模式切换
+- 📁 **文件沙盒**：安全的虚拟文件系统，支持读写/目录操作
+- 🔍 **联网搜索**：内置 Web 搜索与网页内容提取（SSRF 防护）
+- 🖼️ **视觉能力**：图片生成 (CogView) 与多模态识别 (GLM-4V)
+- 📧 **邮件收发**：支持 IMAP/SMTP（防头注入）
+- ⏰ **定时任务**：后台定时执行命令（shlex 安全解析）
+- ☁️ **云盘集成**：百度/阿里/OneDrive 网盘
+- 🔌 **插件系统**：AI 生成代码自动保存为插件（子进程隔离，无代码注入）
+- 🧠 **会话记忆**：自动保留最近 5 轮对话摘要 + 按日期自动存档
+- 🛡️ **安全确认**：四阶危险操作拦截 + 虚拟文件系统沙盒
+- 👤 **Agent 分身系统**：AI 自动生成 Agent（人设/记忆/技能/代码），支持工作流编排
+- 🌐 **Agent HTTP API**：将 Agent 发布为 REST API 供外部调用（默认 127.0.0.1 + Bearer Token）
+- 🖥️ **本机应用启动**：一键调用浏览器、微信、Word、WPS 等本地程序
+- 🧑‍💻 **内置 Agent**：`@local` `@remote` `@spider` `@db` `@RAG`
+- 📊 **数据卷轴**：Excel / CSV 读取与智能分析
+- 🗄️ **数据库助手**：MySQL / PostgreSQL / SQL Server / Oracle 智能 SQL 生成
+- 📚 **本地 RAG**：ChromaDB 向量库 + 自动文件监控与向量化
+- 🔗 **MCP 外部神通**：支持 Model Context Protocol，连接外部工具服务器（stdio/SSE）
+- 🧠 **多源信息融合**：大模型初步回答 + 工具结果（搜索/RAG/MCP/Agent）统一汇总整理
+- 🌍 **中英文切换**：完整国际化支持
+
+## 🚀 快速安装
+
+```bash
+pip install fr-cli
+fr-cli
+```
+
+首次运行会引导输入智谱 API Key。
+
+## 📝 使用示例
+
+### 终端命令
+
+```bash
+fr-cli
+
+# 用户直接输入的命令
+/ls                # 列出文件
+/cat hello.md      # 查看文件
+/cd /tmp           # 切换目录
+/save mysession    # 保存会话
+/export            # 导出为 Markdown
+/agent_server start 8080   # 启动 Agent HTTP API
+/agent_create coder "编写Python代码的助手"  # 自动生成Agent
+/open /Users/me/doc.pdf    # 用默认应用打开文件
+/launch chrome github.com  # 用 Chrome 打开网址
+/launch 微信               # 启动微信
+/apps                      # 列出可用应用
+@local 查看当前目录最大的5个文件  # 本地系统操作Agent
+@spider https://example.com 2  # 智能爬虫（深度2）
+@db mydb 查询最近7天注册用户    # 数据库智能助手
+@RAG 什么是向量数据库           # 本地知识库问答
+/read_excel report.xlsx    # 读取 Excel
+/read_csv data.csv         # 读取 CSV
+
+# MasterAgent 自我进化主控
+/master on                 # 启用主控Agent
+/master off                # 关闭主控Agent
+/master status             # 查看主控状态
+
+# MCP 外部神通
+/mcp_list                   # 列出已配置的 MCP 服务器及工具
+/mcp_add fs npx -y @modelcontextprotocol/server-filesystem /tmp
+/mcp_del fs                 # 删除 MCP 服务器
+/mcp_enable fs              # 启用服务器
+/mcp_disable fs             # 禁用服务器
+/mcp_refresh                # 刷新工具列表
+
+# 思维模式切换
+/mode direct               # 直接回答（默认）
+/mode cot                  # CoT 链式思考
+/mode tot                  # ToT 树状搜索
+/mode react                # ReAct 深度推理
+
+# 自动会话存档
+/session_list              # 列出按日期存档的会话
+/session_load 0            # 加载第0个存档
+/session_del 1             # 删除第1个存档
+
+/help              # 查看帮助
+/exit              # 退出
+```
+
+### AI 自动工具调用
+
+向 AI 描述需求，它会自动调用内置工具：
+
+```
+>>> 搜索一下 Python 最新版本
+🧙 仙人 [基于知识初步回答 + 调用 search_web 获取最新信息]
+...
+🤖 自动执行命令:
+✅ 工具调用成功: search_web
+...
+🧙 仙人 [整理后的最终答案，融合自身知识与搜索结果]
+
+>>> 把刚才的内容保存到文件
+🧙 仙人 【调用：write_file({"path": "python_news.md", "content": "..."})】
+✅ 卷轴已刻录
+```
+
+### Agent HTTP API 调用
+
+启动服务后，外部系统可直接调用 Agent：
+
+```bash
+# 在 fr-cli 中启动服务
+>>> /agent_server start 8080
+
+# 外部系统调用（需携带 Bearer Token）
+curl http://localhost:8080/agents \
+  -H "Authorization: Bearer <token>"
+curl -X POST http://localhost:8080/agents/my_agent/run \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <token>" \
+  -d '{"input": "请分析这个需求"}'
+```
+
+### 插件调用
+
+自定义插件保持命令方式：
+
+```
+>>> 运行我的天气插件
+🧙 仙人 【命令：/weather 北京】
+```
+
+## 📦 安装
+
+```bash
+# 一键安装（v2.1.0 起所有功能依赖默认包含）
+pip install fr-cli
+```
+
+默认包含：智谱 AI SDK、HTTP 请求、Excel/CSV 处理、MySQL/PostgreSQL/SQL Server/Oracle 驱动、ChromaDB 向量库、sentence-transformers、SSH、Selenium、文件监控、云盘支持。
+
+## 🔧 开发
+
+```bash
+git clone https://github.com/yourname/fr-cli.git
+cd fr-cli
+pip install -e .
+python -m pytest tests/ -v
+```
+
+## 📄 License
+
+MIT

fr_cli-2.1.0/README.md

@@ -0,0 +1,157 @@
+# 凡人打字机 (fr-cli)
+
+基于智谱 AI (ZhipuAI/GLM) 的终极全能终端工具。
+
+## ✨ 功能特性
+
+- 🤖 **AI 对话**：基于 GLM-4 系列模型的智能对话
+- 🧠 **MasterAgent 主控**：自我进化的 ReAct 主控 Agent，自动规划、调用工具、反思进化
+- 🧩 **思维模式**：direct / CoT / ToT / ReAct 四种推理模式切换
+- 📁 **文件沙盒**：安全的虚拟文件系统，支持读写/目录操作
+- 🔍 **联网搜索**：内置 Web 搜索与网页内容提取（SSRF 防护）
+- 🖼️ **视觉能力**：图片生成 (CogView) 与多模态识别 (GLM-4V)
+- 📧 **邮件收发**：支持 IMAP/SMTP（防头注入）
+- ⏰ **定时任务**：后台定时执行命令（shlex 安全解析）
+- ☁️ **云盘集成**：百度/阿里/OneDrive 网盘
+- 🔌 **插件系统**：AI 生成代码自动保存为插件（子进程隔离，无代码注入）
+- 🧠 **会话记忆**：自动保留最近 5 轮对话摘要 + 按日期自动存档
+- 🛡️ **安全确认**：四阶危险操作拦截 + 虚拟文件系统沙盒
+- 👤 **Agent 分身系统**：AI 自动生成 Agent（人设/记忆/技能/代码），支持工作流编排
+- 🌐 **Agent HTTP API**：将 Agent 发布为 REST API 供外部调用（默认 127.0.0.1 + Bearer Token）
+- 🖥️ **本机应用启动**：一键调用浏览器、微信、Word、WPS 等本地程序
+- 🧑‍💻 **内置 Agent**：`@local` `@remote` `@spider` `@db` `@RAG`
+- 📊 **数据卷轴**：Excel / CSV 读取与智能分析
+- 🗄️ **数据库助手**：MySQL / PostgreSQL / SQL Server / Oracle 智能 SQL 生成
+- 📚 **本地 RAG**：ChromaDB 向量库 + 自动文件监控与向量化
+- 🔗 **MCP 外部神通**：支持 Model Context Protocol，连接外部工具服务器（stdio/SSE）
+- 🧠 **多源信息融合**：大模型初步回答 + 工具结果（搜索/RAG/MCP/Agent）统一汇总整理
+- 🌍 **中英文切换**：完整国际化支持
+
+## 🚀 快速安装
+
+```bash
+pip install fr-cli
+fr-cli
+```
+
+首次运行会引导输入智谱 API Key。
+
+## 📝 使用示例
+
+### 终端命令
+
+```bash
+fr-cli
+
+# 用户直接输入的命令
+/ls                # 列出文件
+/cat hello.md      # 查看文件
+/cd /tmp           # 切换目录
+/save mysession    # 保存会话
+/export            # 导出为 Markdown
+/agent_server start 8080   # 启动 Agent HTTP API
+/agent_create coder "编写Python代码的助手"  # 自动生成Agent
+/open /Users/me/doc.pdf    # 用默认应用打开文件
+/launch chrome github.com  # 用 Chrome 打开网址
+/launch 微信               # 启动微信
+/apps                      # 列出可用应用
+@local 查看当前目录最大的5个文件  # 本地系统操作Agent
+@spider https://example.com 2  # 智能爬虫（深度2）
+@db mydb 查询最近7天注册用户    # 数据库智能助手
+@RAG 什么是向量数据库           # 本地知识库问答
+/read_excel report.xlsx    # 读取 Excel
+/read_csv data.csv         # 读取 CSV
+
+# MasterAgent 自我进化主控
+/master on                 # 启用主控Agent
+/master off                # 关闭主控Agent
+/master status             # 查看主控状态
+
+# MCP 外部神通
+/mcp_list                   # 列出已配置的 MCP 服务器及工具
+/mcp_add fs npx -y @modelcontextprotocol/server-filesystem /tmp
+/mcp_del fs                 # 删除 MCP 服务器
+/mcp_enable fs              # 启用服务器
+/mcp_disable fs             # 禁用服务器
+/mcp_refresh                # 刷新工具列表
+
+# 思维模式切换
+/mode direct               # 直接回答（默认）
+/mode cot                  # CoT 链式思考
+/mode tot                  # ToT 树状搜索
+/mode react                # ReAct 深度推理
+
+# 自动会话存档
+/session_list              # 列出按日期存档的会话
+/session_load 0            # 加载第0个存档
+/session_del 1             # 删除第1个存档
+
+/help              # 查看帮助
+/exit              # 退出
+```
+
+### AI 自动工具调用
+
+向 AI 描述需求，它会自动调用内置工具：
+
+```
+>>> 搜索一下 Python 最新版本
+🧙 仙人 [基于知识初步回答 + 调用 search_web 获取最新信息]
+...
+🤖 自动执行命令:
+✅ 工具调用成功: search_web
+...
+🧙 仙人 [整理后的最终答案，融合自身知识与搜索结果]
+
+>>> 把刚才的内容保存到文件
+🧙 仙人 【调用：write_file({"path": "python_news.md", "content": "..."})】
+✅ 卷轴已刻录
+```
+
+### Agent HTTP API 调用
+
+启动服务后，外部系统可直接调用 Agent：
+
+```bash
+# 在 fr-cli 中启动服务
+>>> /agent_server start 8080
+
+# 外部系统调用（需携带 Bearer Token）
+curl http://localhost:8080/agents \
+  -H "Authorization: Bearer <token>"
+curl -X POST http://localhost:8080/agents/my_agent/run \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <token>" \
+  -d '{"input": "请分析这个需求"}'
+```
+
+### 插件调用
+
+自定义插件保持命令方式：
+
+```
+>>> 运行我的天气插件
+🧙 仙人 【命令：/weather 北京】
+```
+
+## 📦 安装
+
+```bash
+# 一键安装（v2.1.0 起所有功能依赖默认包含）
+pip install fr-cli
+```
+
+默认包含：智谱 AI SDK、HTTP 请求、Excel/CSV 处理、MySQL/PostgreSQL/SQL Server/Oracle 驱动、ChromaDB 向量库、sentence-transformers、SSH、Selenium、文件监控、云盘支持。
+
+## 🔧 开发
+
+```bash
+git clone https://github.com/yourname/fr-cli.git
+cd fr-cli
+pip install -e .
+python -m pytest tests/ -v
+```
+
+## 📄 License
+
+MIT

fr_cli-2.1.0/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