feat: 添加具有服务器和简单模式的内存图可视化工具
-实现了用于启动内存图可视化工具的PowerShell脚本（visualizer.ps1）。 -开发了一个完整的服务器（visualizer_server.py），为可视化内存图数据提供了web API。 -创建了一个简单的独立版本（visualizer_simple.py），可以直接从存储的数据文件生成可视化。 -添加了用于获取完整图形数据、内存详细信息、搜索内存和检索统计信息的端点。 -包括列出可用数据文件和选择特定文件进行可视化的功能。 -在整个服务器和简单的可视化脚本中增强错误处理和日志记录。
This commit is contained in:
Windpicker-owo
210
tools/memory_visualizer/docs/VISUALIZER_INSTALL_COMPLETE.md
Normal file
210
tools/memory_visualizer/docs/VISUALIZER_INSTALL_COMPLETE.md
Normal file
@@ -0,0 +1,210 @@
|
||||
# ✅ 记忆图可视化工具 - 安装完成
|
||||
|
||||
## 🎉 恭喜！可视化工具已成功创建！
|
||||
|
||||
---
|
||||
|
||||
## 📦 已创建的文件
|
||||
|
||||
```
|
||||
Bot/
|
||||
├── visualizer.ps1 ⭐⭐⭐ # 统一启动脚本 (推荐使用)
|
||||
├── start_visualizer.ps1 # 独立版快速启动
|
||||
├── start_visualizer.bat # CMD版启动脚本
|
||||
├── generate_sample_data.py # 示例数据生成器
|
||||
├── VISUALIZER_README.md ⭐ # 快速参考指南
|
||||
├── VISUALIZER_GUIDE.md # 完整使用指南
|
||||
└── tools/memory_visualizer/
|
||||
├── visualizer_simple.py ⭐ # 独立版服务器 (推荐)
|
||||
├── visualizer_server.py # 完整版服务器
|
||||
├── README.md # 详细文档
|
||||
├── QUICKSTART.md # 快速入门
|
||||
├── CHANGELOG.md # 更新日志
|
||||
└── templates/
|
||||
└── visualizer.html ⭐ # 精美Web界面
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 立即开始 (3秒)
|
||||
|
||||
### 方法 1: 使用统一启动脚本 (最简单 ⭐⭐⭐)
|
||||
|
||||
```powershell
|
||||
.\visualizer.ps1
|
||||
```
|
||||
|
||||
然后按提示选择:
|
||||
- **1** = 独立版 (推荐，快速)
|
||||
- **2** = 完整版 (实时数据)
|
||||
- **3** = 生成示例数据
|
||||
|
||||
### 方法 2: 直接启动
|
||||
|
||||
```powershell
|
||||
# 如果还没有数据，先生成
|
||||
.\.venv\Scripts\python.exe generate_sample_data.py
|
||||
|
||||
# 启动可视化
|
||||
.\start_visualizer.ps1
|
||||
|
||||
# 打开浏览器
|
||||
# http://127.0.0.1:5001
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 功能亮点
|
||||
|
||||
### ✨ 核心功能
|
||||
- 🎯 **交互式图形**: 拖动、缩放、点击
|
||||
- 🎨 **颜色分类**: 5种节点类型自动上色
|
||||
- 🔍 **智能搜索**: 快速定位相关记忆
|
||||
- 🔧 **灵活过滤**: 按节点类型筛选
|
||||
- 📊 **实时统计**: 节点、边、记忆数量
|
||||
- 💾 **数据导出**: JSON格式导出
|
||||
|
||||
### 📂 独立版特色 (推荐)
|
||||
- ⚡ **秒速启动**: 2秒内完成
|
||||
- 📁 **文件切换**: 浏览所有历史数据
|
||||
- 🔄 **自动搜索**: 智能查找数据文件
|
||||
- 💚 **低资源**: 占用资源极少
|
||||
|
||||
### 🔥 完整版特色
|
||||
- 🔴 **实时数据**: 与Bot同步
|
||||
- 🔄 **自动更新**: 无需刷新
|
||||
- 🛠️ **完整功能**: 使用全部API
|
||||
|
||||
---
|
||||
|
||||
## 📊 界面预览
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ 侧边栏 │ 主区域 │
|
||||
│ ┌─────────────────────┐ │ ┌───────────────────────┐ │
|
||||
│ │ 📂 数据文件 │ │ │ 🔄 📐 💾 控制按钮 │ │
|
||||
│ │ [选择] [刷新] │ │ └───────────────────────┘ │
|
||||
│ │ 📄 当前: xxx.json │ │ ┌───────────────────────┐ │
|
||||
│ └─────────────────────┘ │ │ │ │
|
||||
│ │ │ 交互式图形可视化 │ │
|
||||
│ ┌─────────────────────┐ │ │ │ │
|
||||
│ │ 🔍 搜索记忆 │ │ │ 🔴 主体 🔵 主题 │ │
|
||||
│ │ [...........] [搜索] │ │ │ 🟢 客体 🟠 属性 │ │
|
||||
│ └─────────────────────┘ │ │ 🟣 值 │ │
|
||||
│ │ │ │ │
|
||||
│ 📊 统计: 12节点 15边 │ │ 可拖动、缩放、点击 │ │
|
||||
│ │ │ │ │
|
||||
│ 🎨 节点类型图例 │ └───────────────────────┘ │
|
||||
│ 🔧 过滤器 │ │
|
||||
│ ℹ️ 节点信息 │ │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 快速命令
|
||||
|
||||
```powershell
|
||||
# 统一启动 (推荐)
|
||||
.\visualizer.ps1
|
||||
|
||||
# 生成示例数据
|
||||
.\.venv\Scripts\python.exe generate_sample_data.py
|
||||
|
||||
# 独立版 (端口 5001)
|
||||
.\start_visualizer.ps1
|
||||
|
||||
# 完整版 (端口 5000)
|
||||
.\.venv\Scripts\python.exe tools/memory_visualizer/visualizer_server.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📖 文档索引
|
||||
|
||||
### 快速参考 (必读 ⭐)
|
||||
- **VISUALIZER_README.md** - 快速参考卡片
|
||||
- **VISUALIZER_GUIDE.md** - 完整使用指南
|
||||
|
||||
### 详细文档
|
||||
- **tools/memory_visualizer/README.md** - 技术文档
|
||||
- **tools/memory_visualizer/QUICKSTART.md** - 快速入门
|
||||
- **tools/memory_visualizer/CHANGELOG.md** - 版本历史
|
||||
|
||||
---
|
||||
|
||||
## 💡 使用建议
|
||||
|
||||
### 🎯 对于首次使用者
|
||||
1. 运行 `.\visualizer.ps1`
|
||||
2. 选择 `3` 生成示例数据
|
||||
3. 选择 `1` 启动独立版
|
||||
4. 打开浏览器访问 http://127.0.0.1:5001
|
||||
5. 开始探索！
|
||||
|
||||
### 🔧 对于开发者
|
||||
1. 运行Bot积累真实数据
|
||||
2. 启动完整版可视化: `.\visualizer.ps1` → `2`
|
||||
3. 实时查看记忆图变化
|
||||
4. 调试和优化
|
||||
|
||||
### 📊 对于数据分析
|
||||
1. 使用独立版查看历史数据
|
||||
2. 切换不同时期的数据文件
|
||||
3. 使用搜索和过滤功能
|
||||
4. 导出数据进行分析
|
||||
|
||||
---
|
||||
|
||||
## 🐛 常见问题
|
||||
|
||||
### Q: 未找到数据文件？
|
||||
**A**: 运行 `.\visualizer.ps1` 选择 `3` 生成示例数据
|
||||
|
||||
### Q: 端口被占用？
|
||||
**A**: 修改对应服务器文件中的端口号，或关闭占用端口的程序
|
||||
|
||||
### Q: 两个版本有什么区别？
|
||||
**A**:
|
||||
- **独立版**: 快速，读文件，可切换，推荐日常使用
|
||||
- **完整版**: 实时，用内存，完整功能，推荐开发调试
|
||||
|
||||
### Q: 图形显示混乱？
|
||||
**A**:
|
||||
1. 使用过滤器减少节点
|
||||
2. 点击"适应窗口"
|
||||
3. 刷新页面
|
||||
|
||||
---
|
||||
|
||||
## 🎉 开始使用
|
||||
|
||||
### 立即启动
|
||||
```powershell
|
||||
.\visualizer.ps1
|
||||
```
|
||||
|
||||
### 访问地址
|
||||
- 独立版: http://127.0.0.1:5001
|
||||
- 完整版: http://127.0.0.1:5000
|
||||
|
||||
---
|
||||
|
||||
## 🤝 反馈与支持
|
||||
|
||||
如有问题或建议，请查看:
|
||||
- 📖 `VISUALIZER_GUIDE.md` - 完整使用指南
|
||||
- 📝 `tools/memory_visualizer/README.md` - 技术文档
|
||||
|
||||
---
|
||||
|
||||
## 🌟 特别感谢
|
||||
|
||||
感谢你使用 MoFox Bot 记忆图可视化工具！
|
||||
|
||||
**享受探索记忆图的乐趣！** 🚀🦊
|
||||
|
||||
---
|
||||
|
||||
_最后更新: 2025-11-06_
|
||||
159
tools/memory_visualizer/docs/VISUALIZER_README.md
Normal file
159
tools/memory_visualizer/docs/VISUALIZER_README.md
Normal file
@@ -0,0 +1,159 @@
|
||||
# 🎯 记忆图可视化工具 - 快速参考
|
||||
|
||||
## 🚀 快速启动
|
||||
|
||||
### 推荐方式 (交互式菜单)
|
||||
```powershell
|
||||
.\visualizer.ps1
|
||||
```
|
||||
|
||||
然后选择:
|
||||
- **选项 1**: 独立版 (快速，推荐) ⭐
|
||||
- **选项 2**: 完整版 (实时数据)
|
||||
- **选项 3**: 生成示例数据
|
||||
|
||||
---
|
||||
|
||||
## 📋 各版本对比
|
||||
|
||||
| 特性 | 独立版 ⭐ | 完整版 |
|
||||
|------|---------|--------|
|
||||
| **启动速度** | 🚀 快速 (2秒) | ⏱️ 较慢 (5-10秒) |
|
||||
| **数据源** | 📂 文件 | 💾 内存 (实时) |
|
||||
| **文件切换** | ✅ 支持 | ❌ 不支持 |
|
||||
| **资源占用** | 💚 低 | 💛 中等 |
|
||||
| **端口** | 5001 | 5000 |
|
||||
| **适用场景** | 查看历史数据、调试 | 实时监控、开发 |
|
||||
|
||||
---
|
||||
|
||||
## 🔧 手动启动命令
|
||||
|
||||
### 独立版 (推荐)
|
||||
```powershell
|
||||
# Windows
|
||||
.\start_visualizer.ps1
|
||||
|
||||
# 或直接运行
|
||||
.\.venv\Scripts\python.exe tools/memory_visualizer/visualizer_simple.py
|
||||
```
|
||||
访问: http://127.0.0.1:5001
|
||||
|
||||
### 完整版
|
||||
```powershell
|
||||
.\.venv\Scripts\python.exe tools/memory_visualizer/visualizer_server.py
|
||||
```
|
||||
访问: http://127.0.0.1:5000
|
||||
|
||||
### 生成示例数据
|
||||
```powershell
|
||||
.\.venv\Scripts\python.exe generate_sample_data.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 功能一览
|
||||
|
||||
### 🎨 可视化功能
|
||||
- ✅ 交互式图形 (拖动、缩放、点击)
|
||||
- ✅ 节点类型颜色分类
|
||||
- ✅ 实时搜索和过滤
|
||||
- ✅ 统计信息展示
|
||||
- ✅ 节点详情查看
|
||||
|
||||
### 📂 数据管理
|
||||
- ✅ 自动搜索数据文件
|
||||
- ✅ 多文件切换 (独立版)
|
||||
- ✅ 数据导出 (JSON格式)
|
||||
- ✅ 文件信息显示
|
||||
|
||||
---
|
||||
|
||||
## 🎯 使用场景
|
||||
|
||||
### 1️⃣ 首次使用
|
||||
```powershell
|
||||
# 1. 生成示例数据
|
||||
.\visualizer.ps1
|
||||
# 选择: 3
|
||||
|
||||
# 2. 启动可视化
|
||||
.\visualizer.ps1
|
||||
# 选择: 1
|
||||
|
||||
# 3. 打开浏览器
|
||||
# 访问: http://127.0.0.1:5001
|
||||
```
|
||||
|
||||
### 2️⃣ 查看实际数据
|
||||
```powershell
|
||||
# 先运行Bot生成记忆
|
||||
# 然后启动可视化
|
||||
.\visualizer.ps1
|
||||
# 选择: 1 (独立版) 或 2 (完整版)
|
||||
```
|
||||
|
||||
### 3️⃣ 调试记忆系统
|
||||
```powershell
|
||||
# 使用完整版，实时查看变化
|
||||
.\visualizer.ps1
|
||||
# 选择: 2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 故障排除
|
||||
|
||||
### ❌ 问题: 未找到数据文件
|
||||
**解决**:
|
||||
```powershell
|
||||
.\visualizer.ps1
|
||||
# 选择 3 生成示例数据
|
||||
```
|
||||
|
||||
### ❌ 问题: 端口被占用
|
||||
**解决**:
|
||||
- 独立版: 修改 `visualizer_simple.py` 中的 `port=5001`
|
||||
- 完整版: 修改 `visualizer_server.py` 中的 `port=5000`
|
||||
|
||||
### ❌ 问题: 数据加载失败
|
||||
**可能原因**:
|
||||
- 数据文件格式不正确
|
||||
- 文件损坏
|
||||
|
||||
**解决**:
|
||||
1. 检查 `data/memory_graph/` 目录
|
||||
2. 重新生成示例数据
|
||||
3. 查看终端错误信息
|
||||
|
||||
---
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
- **完整指南**: `VISUALIZER_GUIDE.md`
|
||||
- **快速入门**: `tools/memory_visualizer/QUICKSTART.md`
|
||||
- **详细文档**: `tools/memory_visualizer/README.md`
|
||||
- **更新日志**: `tools/memory_visualizer/CHANGELOG.md`
|
||||
|
||||
---
|
||||
|
||||
## 💡 提示
|
||||
|
||||
1. **首次使用**: 先生成示例数据 (选项 3)
|
||||
2. **查看历史**: 使用独立版，可以切换不同数据文件
|
||||
3. **实时监控**: 使用完整版，与Bot同时运行
|
||||
4. **性能优化**: 大型图使用过滤器和搜索
|
||||
5. **快捷键**:
|
||||
- `Ctrl + 滚轮`: 缩放
|
||||
- 拖动空白: 移动画布
|
||||
- 点击节点: 查看详情
|
||||
|
||||
---
|
||||
|
||||
## 🎉 开始探索！
|
||||
|
||||
```powershell
|
||||
.\visualizer.ps1
|
||||
```
|
||||
|
||||
享受你的记忆图之旅！🚀🦊
|
||||
Reference in New Issue
Block a user