内容
<div align="center">
<img src="https://img.shields.io/badge/Version-2.0.0-blue?style=for-the-badge" alt="Version">
<img src="https://img.shields.io/badge/License-AGPL--3.0-green?style=for-the-badge" alt="License">
<img src="https://img.shields.io/badge/Node.js-18+-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js">
<img src="https://img.shields.io/badge/Python-3.11+-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python">
<br><br>
# MiroFish 代理
### 增强版 — 多智能体 AI 预测引擎
**从 [MiroFish](https://github.com/666ghj/MiroFish) 由 [666ghj](https://github.com/666ghj) 修改**
新增：MCP 数据工具 · 多提供商 LLM · 智能体技能 · 简体中文
<br>
[](https://github.com/666ghj/MiroFish)
[](https://console.groq.com/keys)
[](https://aistudio.google.com/apikey)
</div>
---
## 关于
**MiroFish** 是一种基于**群体智能**的预测引擎，使用多智能体技术。通过从现实世界中提取种子信息，MiroFish 自动构建一个数字平行世界，数千个智能体在其中相互作用和进化。
> ⭐ **原始仓库：** [github.com/666ghj/MiroFish](https://github.com/666ghj/MiroFish)
> 🍴 **本 Fork** 新增 MCP、多提供商、智能体技能和简体中文。
---
## 新增功能
| 功能 | 原始版 | 本 Fork |
|-------|----------|----------|
| 📄 文档上传 | ✅ | ✅ |
| 🖼️ 图片分析 | ❌ | ✅ AI 视觉 |
| 🔗 URL 获取 | ❌ | ✅ + 截图 |
| 🖥️ 本地主机审查 | ❌ | ✅ UI 分析 |
| 🌐 MCP 数据工具 | ❌ | ✅ **11 个免费工具** |
| 🤖 多提供商 LLM | ❌ (1 个提供商) | ✅ **6 个提供商** |
| 🏦 智能体技能 | ❌ | ✅ **9 个内置技能** |
| 💰 节省成本路由器 | ❌ | ✅ 选择最便宜的 |
| 🇮🇩 简体中文 | ❌ | ✅ 665+ 键 |
| 📊 历史记录和重放 | ❌ | ✅ 查看 + 删除 |
| 🔄 MCP 守护进程 | ❌ | ✅ 自动更新数据 |
---
## 快速开始
```bash
# 1. 克隆
git clone https://github.com/farhanturu/mirofish-agent.git
cd mirofish-agent
# 2. 注册 ZEP（免费，必填！）
# 打开 https://app.getzep.com → 注册 → 复制 API 密钥
# 3. 设置 API 密钥
cp .env.example .env
nano .env
# 填写 ZEP_API_KEY（必填）+ 至少 1 个 LLM 提供商
# 4. 安装所有依赖项
npm run setup:all
# 5. 运行！
npm run dev
```
**打开浏览器：** http://localhost:3000
---
## 需要的 API 密钥
### 🔴 必需：ZEP 内存图（免费！）
ZEP 用于**知识图谱和智能体内存**。没有 ZEP，MiroFish **无法运行**。
| 信息 | 详情 |
|------|--------|
| **注册** | https://app.getzep.com |
| **费用** | **免费** 适用于轻度使用 |
| **功能** | 知识图谱、智能体内存、GraphRAG |
| **必填？** | ✅ **是** |
```bash
# 获取 ZEP API 密钥的方法：
# 1. 打开 https://app.getzep.com
# 2. 注册（免费，无需信用卡）
# 3. 打开仪表盘 → 复制 API 密钥
# 4. 粘贴到 .env：
ZEP_API_KEY=z_your_key_here
```
### LLM 提供商（选择至少 1 个）
| 提供商 | 费用 | 注册 | 模型 | 速度 |
|----------|-------|--------|-------|-----------|
| 🦙 **Groq** | **免费** 30 RPM | [注册](https://console.groq.com/keys) | Llama 3.3 70B | ⚡⚡⚡ |
| 🆓 **Gemini** | **免费** 1500/天 | [注册](https://aistudio.google.com/apikey) | Gemini 2.0 Flash | ⚡⚡ |
| 🏆 **Atomesus** | 基于计划 | [注册](https://www.atomesus.com/dashboard) | Cipher | ⚡⚡⚡ |
| 🤖 **Together AI** | **免费** 60 RPM | [注册](https://api.together.xyz/settings/api-keys) | Llama 3.1 8B | ⚡⚡ |
| 💻 **Ollama** | **免费** 本地 | [安装](https://ollama.com) | Llama 3.2 | ⚡ |
> 💡 **Groq + Gemini = 100% 免费**，无需信用卡！
---
## MCP 数据代理 — 11 个实时工具
| # | 工具 | 命令 | 来源 | 免费？ |
|---|------|----------|--------|---------|
| 1 | 🔍 **搜索** | `search <查询>` | Google 新闻 | ✅ |
| 2 | 📰 **新闻** | `news <主题>` | Google 新闻 | ✅ |
| 3 | 🌤️ **天气** | `weather <城市>` | wttr.in | ✅ |
| 4 | 🌏 **国家** | `country <名称>` | REST Countries | ✅ |
| 5 | 💱 **汇率** | `kurs USD/IDR` | 汇率 | ✅ |
| 6 | ₿ **加密货币** | `crypto bitcoin` | CoinGecko | ✅ |
| 7 | 🏅 **黄金** | `emas` | 黄金 API | ✅ |
| 8 | 📈 **股票** | `saham IHSG` | Google 新闻 | ✅ |
| 9 | 📊 **经济** | `ekonomi Indonesia` | Google 新闻 | ✅ |
| 10 | 📚 **维基百科** | `wiki <查询>` | 维基百科 | ✅ |
| 11 | 🤖 **自动** | `auto <查询>` | 自动检测 | ✅ |
```bash
python3 tools/mcp-client.py kurs USD/IDR
python3 tools/mcp-client.py crypto bitcoin
python3 tools/mcp-client.py saham IHSG
```
---
## 9 个内置智能体技能
每个模拟中的智能体都有 9 个技能：
| # | 技能 | 功能 |
|---|-------|--------|
| 1 | 🔍 **数据搜索** | 搜索实时信息 |
| 2 | 📊 **结构化分析** | 数据 → 分析 → 结论 |
| 3 | 👁️ **多视角** | 多角度视角 |
| 4 | 🤝 **协作** | 智能体间协作 |
| 5 | 🧠 **批判性思维** | 挑战假设 |
| 6 | 🌏 **印度尼西亚语境** | 理解本地文化 |
| 7 | 📈 **基于数据** | 以事实为依据的论证 |
| 8 | 🏦 **成本节约** | 选择最便宜的模型 |
| 9 | 🌐 **地缘政治** | 实时全球数据 |
---
## CLI 工具
```bash
# 实时数据
python3 tools/mcp-client.py search "印度尼西亚经济"
python3 tools/mcp-client.py kurs USD/IDR
python3 tools/mcp-client.py weather jakarta
# 免费 AI 聊天
python3 tools/free-chat.py --model groq-llama "IHSG 分析"
# 历史记录
python3 tools/history-viewer.py env
python3 tools/history-viewer.py 删除 sim_xxx
# 监视器
python3 tools/process-monitor.py
# MCP 守护进程（自动更新）
python3 tools/mcp-daemon.py start
```
---
## API 端点
| 方法 | 端点 | 功能 |
|--------|----------|--------|
| `GET` | `/health` | 健康检查 |
| `POST` | `/api/graph/ontology/generate` | 上传并创建本体 |
| `POST` | `/api/graph/build` | 构建知识图谱 |
| `POST` | `/api/simulation/create` | 创建模拟 |
| `POST` | `/api/simulation/prepare` | 准备环境 |
| `POST` | `/api/simulation/start` | 启动模拟 |
| `GET` | `/api/simulation/:id/run-status` | 模拟状态 |
| `POST` | `/api/report/generate` | 生成预测报告 |
| `POST` | `/api/report/chat` | 与报告智能体聊天 |
| `POST` | `/api/simulation/interview` | 智能体访谈 |
| `GET` | `/api/mcp/status` | MCP 守护进程状态 |
---
## 项目结构
```
mirofish-agent/
├── README.md ← 文档
├── .env.example ← API 密钥模板（安全）
├── .gitignore ← 敏感数据保护
├── package.json ← Node.js 依赖项
├── docker-compose.yml ← Docker 部署
├── LICENSE ← AGPL-3.0
│
├── frontend/ ← Vue 3 + Vite
│ └── src/
│ ├── views/ ← 网页
│ ├── components/ ← UI 组件（HistoryDatabase 等）
│ ├── i18n/ ← 翻译
│ └── router/ ← 路由
│
├── backend/ ← Flask + Python
│ ├── app/
│ │ ├── api/ ← REST API（图谱、模拟、报告、MCP）
│ │ ├── services/ ← 业务逻辑
│ │ ├── agent_skills/ ← 🆕 9 个内置技能 + 成本路由器
│ │ └── utils/ ← 工具
│ ├── scripts/ ← 模拟脚本
│ └── uploads/ ← 模拟数据（忽略）
│
├── tools/ ← 🆕 CLI 工具
│ ├── mcp-client.py ← 11 个 MCP 数据工具
│ ├── mcp-daemon.py ← 后台数据更新器
│ ├── free-chat.py ← 免费 AI 聊天
│ ├── history-viewer.py ← 查看和删除历史记录
│ ├── simulation-replay.py ← 模拟重放
│ ├── process-monitor.py ← 进程监视器
│ ├── analyze-image.py ← 图片分析
│ ├── fetch-url.py ← URL 获取
│ └── review-localhost.py ← 本地主机审查
│
├── locales/ ← UI 翻译
│ ├── id.json ← 🆕 印度尼西亚语（665+ 键）
│ ├── en.json ← 英语
│ ├── zh.json ← 中文
│ └── languages.json ← 语言列表
│
└── skills/ ← 智能体技能定义
└── pinchtab/ ← 浏览器控制技能
```
---
## 智能体技能 — `/mirofish-agent`
此仓库还包含 **智能体技能**，可以直接调用：
/mirofish-agent # 设置并运行 MiroFish
/mirofish-agent start # 重新运行
/mirofish-agent config # 修改提供商/配置
### 安装技能
```bash
# 将技能复制到智能体目录
cp -r skills/mirofish-agent ~/.agents/skills/
# 或创建符号链接（以便自动更新）
ln -sf $(pwd)/skills/mirofish-agent ~/.agents/skills/mirofish-agent
```
### 技能功能
| 功能 | 说明 |
|-------|------------|
| 🚀 一键设置 | 克隆、安装、配置、自动运行 |
| 🇮🇩 印度尼西亚语 | 完整翻译的 UI（665+ 键） |
| 🤖 多提供商 | Groq、Gemini、Atomesus、Together AI、Ollama |
| 🌐 MCP 数据 | 11 个实时数据工具 |
| 🏦 成本路由器 | 自动选择最便宜的模型 |
| 🧠 9 个智能体技能 | 内置、自动激活 |
### 技能文件
```
skills/mirofish-agent/
├── SKILL.md ← 主要指令
├── README.md ← 文档
├── .env.example ← API 密钥模板
├── providers.json ← 提供商注册表
├── setup.sh ← 安装脚本
├── config.sh ← 交互式配置
└── patches/ ← UI 和后端补丁
```
---
## 🐳 Docker
```bash
# 构建并运行
docker compose up -d
# 或手动构建
docker build -t mirofish-agent .
docker run -p 3000:3000 -p 5001:5001 mirofish-agent
```
---
## 📝 语言支持
MiroFish 的 UI 已翻译为 **8 种语言**：
| 语言 | 代码 | 状态 |
|--------|------|--------|
| 🇮🇩 印度尼西亚语 | `id` | ✅ 默认 |
| 🇺🇸 英语 | `en` | ✅ |
| 🇨🇳 中文 | `zh` | ✅ |
| 🇪🇸 西班牙语 | `es` | ✅ |
| 🇫🇷 法语 | `fr` | ✅ |
| 🇵🇹 葡萄牙语 | `pt` | ✅ |
| 🇷🇺 俄语 | `ru` | ✅ |
| 🇩🇪 德语 | `de` | ✅ |
---
## 🤝 贡献
1. Fork 此仓库
2. 创建分支：`git checkout -b feature/功能名称`
3. 提交：`git commit -m "feat: 添加功能 X"`
4. 推送：`git push origin feature/功能名称`
5. 创建拉取请求
---
## 🙏 致谢
| 贡献 | 作者 |
|------------|--------|
| **MiroFish 原始版** | [666ghj](https://github.com/666ghj) |
| **CAMEL-OASIS 引擎** | [camel-ai](https://github.com/camel-ai) |
| **Zep 内存图** | [getzep](https://github.com/getzep) |
| **MCP 数据工具** | Fork 增强 |
| **多提供商** | Fork 增强 |
| **智能体技能** | Fork 增强 |
| **印度尼西亚语** | Fork 增强 |
---
## 📄 许可证
[AGPL-3.0](LICENSE) — 与 MiroFish 原始许可证相同。
---
<div align="center">
**原始版：** [github.com/666ghj/MiroFish](https://github.com/666ghj/MiroFish)
**本 Fork：** [github.com/YOUR_USERNAME/mirofish-agent](https://github.com/YOUR_USERNAME/mirofish-agent)
<br>
🐟 **MiroFish 代理** — 增强版，包含 MCP、多提供商和智能体技能
</div>
