feat: 添加具有服务器和简单模式的内存图可视化工具
-实现了用于启动内存图可视化工具的PowerShell脚本（visualizer.ps1）。 -开发了一个完整的服务器（visualizer_server.py），为可视化内存图数据提供了web API。 -创建了一个简单的独立版本（visualizer_simple.py），可以直接从存储的数据文件生成可视化。 -添加了用于获取完整图形数据、内存详细信息、搜索内存和检索统计信息的端点。 -包括列出可用数据文件和选择特定文件进行可视化的功能。 -在整个服务器和简单的可视化脚本中增强错误处理和日志记录。
This commit is contained in:
Windpicker-owo
163
tools/memory_visualizer/FILE_ORGANIZATION.md
Normal file
163
tools/memory_visualizer/FILE_ORGANIZATION.md
Normal file
@@ -0,0 +1,163 @@
|
||||
# 📁 可视化工具文件整理完成
|
||||
|
||||
## ✅ 整理结果
|
||||
|
||||
### 新的目录结构
|
||||
|
||||
```
|
||||
tools/memory_visualizer/
|
||||
├── visualizer.ps1 ⭐ 统一启动脚本（主入口）
|
||||
├── visualizer_simple.py # 独立版服务器
|
||||
├── visualizer_server.py # 完整版服务器
|
||||
├── generate_sample_data.py # 测试数据生成器
|
||||
├── test_visualizer.py # 测试脚本
|
||||
├── run_visualizer.py # Python 运行脚本（独立版）
|
||||
├── run_visualizer_simple.py # Python 运行脚本（简化版）
|
||||
├── start_visualizer.bat # Windows 批处理启动脚本
|
||||
├── start_visualizer.ps1 # PowerShell 启动脚本
|
||||
├── start_visualizer.sh # Linux/Mac 启动脚本
|
||||
├── requirements.txt # Python 依赖
|
||||
├── templates/ # HTML 模板
|
||||
│ └── visualizer.html # 可视化界面
|
||||
├── docs/ # 文档目录
|
||||
│ ├── VISUALIZER_README.md
|
||||
│ ├── VISUALIZER_GUIDE.md
|
||||
│ └── VISUALIZER_INSTALL_COMPLETE.md
|
||||
├── README.md # 主说明文档
|
||||
├── QUICKSTART.md # 快速开始指南
|
||||
└── CHANGELOG.md # 更新日志
|
||||
```
|
||||
|
||||
### 根目录保留文件
|
||||
|
||||
```
|
||||
项目根目录/
|
||||
├── visualizer.ps1 # 快捷启动脚本（指向 tools/memory_visualizer/visualizer.ps1）
|
||||
└── tools/memory_visualizer/ # 所有可视化工具文件
|
||||
```
|
||||
|
||||
## 🚀 使用方法
|
||||
|
||||
### 推荐方式：使用统一启动脚本
|
||||
|
||||
```powershell
|
||||
# 在项目根目录
|
||||
.\visualizer.ps1
|
||||
|
||||
# 或在工具目录
|
||||
cd tools\memory_visualizer
|
||||
.\visualizer.ps1
|
||||
```
|
||||
|
||||
### 命令行参数
|
||||
|
||||
```powershell
|
||||
# 直接启动独立版（推荐）
|
||||
.\visualizer.ps1 -Simple
|
||||
|
||||
# 启动完整版
|
||||
.\visualizer.ps1 -Full
|
||||
|
||||
# 生成测试数据
|
||||
.\visualizer.ps1 -Generate
|
||||
|
||||
# 运行测试
|
||||
.\visualizer.ps1 -Test
|
||||
```
|
||||
|
||||
## 📋 整理内容
|
||||
|
||||
### 已移动的文件
|
||||
|
||||
从项目根目录移动到 `tools/memory_visualizer/`：
|
||||
|
||||
1. **脚本文件**
|
||||
- `generate_sample_data.py`
|
||||
- `run_visualizer.py`
|
||||
- `run_visualizer_simple.py`
|
||||
- `test_visualizer.py`
|
||||
- `start_visualizer.bat`
|
||||
- `start_visualizer.ps1`
|
||||
- `start_visualizer.sh`
|
||||
- `visualizer.ps1`
|
||||
|
||||
2. **文档文件** → `docs/` 子目录
|
||||
- `VISUALIZER_GUIDE.md`
|
||||
- `VISUALIZER_INSTALL_COMPLETE.md`
|
||||
- `VISUALIZER_README.md`
|
||||
|
||||
### 已创建的新文件
|
||||
|
||||
1. **统一启动脚本**
|
||||
- `tools/memory_visualizer/visualizer.ps1` - 功能齐全的统一入口
|
||||
|
||||
2. **快捷脚本**
|
||||
- `visualizer.ps1`（根目录）- 快捷方式，指向实际脚本
|
||||
|
||||
3. **更新的文档**
|
||||
- `tools/memory_visualizer/README.md` - 更新为反映新结构
|
||||
|
||||
## 🎯 优势
|
||||
|
||||
### 整理前的问题
|
||||
- ❌ 文件散落在根目录
|
||||
- ❌ 多个启动脚本功能重复
|
||||
- ❌ 文档分散不便管理
|
||||
- ❌ 不清楚哪个是主入口
|
||||
|
||||
### 整理后的改进
|
||||
- ✅ 所有文件集中在 `tools/memory_visualizer/`
|
||||
- ✅ 单一统一的启动脚本 `visualizer.ps1`
|
||||
- ✅ 文档集中在 `docs/` 子目录
|
||||
- ✅ 清晰的主入口和快捷方式
|
||||
- ✅ 更好的可维护性
|
||||
|
||||
## 📝 功能对比
|
||||
|
||||
### 旧的方式（整理前）
|
||||
```powershell
|
||||
# 需要记住多个脚本名称
|
||||
.\start_visualizer.ps1
|
||||
.\run_visualizer.py
|
||||
.\run_visualizer_simple.py
|
||||
.\generate_sample_data.py
|
||||
```
|
||||
|
||||
### 新的方式（整理后）
|
||||
```powershell
|
||||
# 只需要一个统一的脚本
|
||||
.\visualizer.ps1 # 交互式菜单
|
||||
.\visualizer.ps1 -Simple # 启动独立版
|
||||
.\visualizer.ps1 -Generate # 生成数据
|
||||
.\visualizer.ps1 -Test # 运行测试
|
||||
```
|
||||
|
||||
## 🔧 维护说明
|
||||
|
||||
### 添加新功能
|
||||
1. 在 `tools/memory_visualizer/` 目录下添加新文件
|
||||
2. 如需启动选项，在 `visualizer.ps1` 中添加新参数
|
||||
3. 更新 `README.md` 文档
|
||||
|
||||
### 更新文档
|
||||
1. 主文档：`tools/memory_visualizer/README.md`
|
||||
2. 详细文档：`tools/memory_visualizer/docs/`
|
||||
|
||||
## ✅ 测试结果
|
||||
|
||||
- ✅ 统一启动脚本正常工作
|
||||
- ✅ 独立版服务器成功启动（端口 5001）
|
||||
- ✅ 数据加载成功（725 节点，769 边）
|
||||
- ✅ Web 界面正常访问
|
||||
- ✅ 所有文件已整理到位
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
- [README](tools/memory_visualizer/README.md) - 主要说明文档
|
||||
- [QUICKSTART](tools/memory_visualizer/QUICKSTART.md) - 快速开始指南
|
||||
- [CHANGELOG](tools/memory_visualizer/CHANGELOG.md) - 更新日志
|
||||
- [详细指南](tools/memory_visualizer/docs/VISUALIZER_GUIDE.md) - 完整使用指南
|
||||
|
||||
---
|
||||
|
||||
整理完成时间：2025-11-06
|
||||
Reference in New Issue
Block a user