MiroFish：
一款基于多智能体技术的新一代 AI 预测引擎。通过提取现实世界的种子信息（如突发新闻、政策草案、金融信号），自动构建出高保真的平行数字世界。在此空间内，成千上万个具备独立人格、长期记忆与行为逻辑的智能体进行自由交互与社会演化。你可透过「上帝视角」动态注入变量，精准推演未来走向——让未来在数字沙盘中预演，助决策在百战模拟后胜出。
工作流程：
- • 图谱构建：现实种子提取 & 个体与群体记忆注入 & GraphRAG构建
- • 环境搭建：实体关系抽取 & 人设生成 & 环境配置Agent注入仿真参数
- • 开始模拟：双平台并行模拟 & 自动解析预测需求 & 动态更新时序记忆
- • 报告生成：ReportAgent拥有丰富的工具集与模拟后环境进行深度交互
- • 深度互动：与模拟世界中的任意一位进行对话 & 与ReportAgent进行对话
准备
在部署前，需要先准备好 ZEP 记忆图谱的密钥，以及 LLM 模型的密钥。下面也会手把手指引怎么样获取，有需要的可以参考。
ZEP：https://app.getzep.com
没有账号的先注册一个
选择个人使用就行
进入面板（默认好像是送一定使用量）
滑动到下面，创建 API Keys
复制保管好密钥
TIP：其他兼容 OpenAI 格式的模型提供商都是可以的，不过需要注意 token 使用量可能比较大，最好用免费的先试试效果
阿里云百炼：https://bailian.console.aliyun.com
新人注册好像是有免费额度，我这里是之前开通的
点击排序，挑选免费额度的模型（记得开启“免费额度用完即停”）
来到密钥管理，创建 API Key
创建完成复制保存好，到时候需要用到
安装
Docker Compose
services:
mirofish:
image: ghcr.nju.edu.cn/666ghj/mirofish:latest
container_name: mirofish
ports:
- 3000:3000
- 5001:5001
environment:
- VITE_API_BASE_URL=http://192.168.31.90:5001
- ZEP_API_KEY=your_zep_api_key_here
- LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
- LLM_API_KEY=your_api_key_here
- LLM_MODEL_NAME=qwen3.5-plus
volumes:
- ./backend/uploads:/app/backend/uploads
restart: unless-stopped
参数说明（更多参数建议去看文档）
:::VITE_API_BASE_URL（环境变量）：后端 API 的外部可访问地址
ZEP_API_KEY（环境变量）：ZEP 记忆图谱密钥
LLM_BASE_URL（环境变量）：LLM 模型提供商，兼容 OpenAI 协议
LLM_API_KEY（环境变量）：LLM 模型调用密钥
LLM_MODEL_NAME（环境变量）：LLM 模型名称
:::
TIP：镜像比较大，下载的时间可能比较长
启动容器，先看看日志有没有报错
使用
浏览器中输入 <span leaf="">http://NAS的IP:3000</span> 就能看到界面
滑动到下面，就能看到操作界面了
上传你需要分析的文档，这里用《白夜行》作为演示
输入预测的问题，比如“假如他们选择自首、赎罪，而不是一路隐瞒，结局会不会更光明？”
TIP：如果提示 500 报错，那有可能是返回的数据格式有问题（更换模型，或者提供商）
正常没有问题，本体生成的速度挺快的
TIP：可以查看容器日志，能看到实在运行的
本体生成以后，会自动进行图谱构建（这一步也是最花时间的）
TIP：有一个需要特别注意的坑，上传的文档尽可能干净，避免过多不相关数据
由于超了 ZEP 的免费套餐限制，一直停在图谱构建过程了不动了（我就不**了，基本流程就这样）
简单看看生成到 15% 的图谱，每个节点之间都标有相关的关系
总结
这个项目我折腾了挺久的，之前一直都生成有问题。碰巧最近看到“老苏”大佬出了教程，发现原来还有一个参数设置后端接口的，加上后就成功跑起来了。
MiroFish 这款应用基于多智能体技术的 AI 预测引擎，提取现实世界的种子信息（如新闻、政策、金融信号），构建高保真平行数字世界。试想一下，将断更的小说放到里面，就能推演出想要的结果了，属于上帝开外挂了！不过这次我还是太激进了，将整本《白夜行》放进去了，导致生成到一半 ZEP 记忆图谱的免费额度用完了，就卡住了。如果后续能将 ZEP 替换为可本地化部署的开源方案，我大概率还会再来部署玩玩。最后还是要特别提醒， MiroFish 调用 AI 非常消耗 token，一定要注意！
综合推荐：⭐⭐⭐⭐（有意思，窥见还未发生的时间线）
使用体验：⭐⭐⭐（操作流程简单，使用门槛低）
部署难易：⭐⭐（简单）︎
