Files

Windpicker-owo 2ba869c954 feat: 添加具有服务器和简单模式的内存图可视化工具

-实现了用于启动内存图可视化工具的PowerShell脚本（visualizer.ps1）。
-开发了一个完整的服务器（visualizer_server.py），为可视化内存图数据提供了web API。
-创建了一个简单的独立版本（visualizer_simple.py），可以直接从存储的数据文件生成可视化。
-添加了用于获取完整图形数据、内存详细信息、搜索内存和检索统计信息的端点。
-包括列出可用数据文件和选择特定文件进行可视化的功能。
-在整个服务器和简单的可视化脚本中增强错误处理和日志记录。

2025-11-06 11:25:48 +08:00

4.4 KiB

Raw Blame History

📁 可视化工具文件整理完成

✅ 整理结果

新的目录结构

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/    # 所有可视化工具文件

🚀 使用方法

推荐方式：使用统一启动脚本

# 在项目根目录
.\visualizer.ps1

# 或在工具目录
cd tools\memory_visualizer
.\visualizer.ps1

命令行参数

# 直接启动独立版（推荐）
.\visualizer.ps1 -Simple

# 启动完整版
.\visualizer.ps1 -Full

# 生成测试数据
.\visualizer.ps1 -Generate

# 运行测试
.\visualizer.ps1 -Test

📋 整理内容

已移动的文件

从项目根目录移动到 tools/memory_visualizer/：

脚本文件
- 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
文档文件 → docs/ 子目录
- VISUALIZER_GUIDE.md
- VISUALIZER_INSTALL_COMPLETE.md
- VISUALIZER_README.md

已创建的新文件

统一启动脚本
- tools/memory_visualizer/visualizer.ps1 - 功能齐全的统一入口
快捷脚本
- visualizer.ps1（根目录）- 快捷方式，指向实际脚本
更新的文档
- tools/memory_visualizer/README.md - 更新为反映新结构

🎯 优势

整理前的问题

❌ 文件散落在根目录
❌ 多个启动脚本功能重复
❌ 文档分散不便管理
❌ 不清楚哪个是主入口

整理后的改进

✅ 所有文件集中在 tools/memory_visualizer/
✅ 单一统一的启动脚本 visualizer.ps1
✅ 文档集中在 docs/ 子目录
✅ 清晰的主入口和快捷方式
✅ 更好的可维护性

📝 功能对比

旧的方式（整理前）

# 需要记住多个脚本名称
.\start_visualizer.ps1
.\run_visualizer.py
.\run_visualizer_simple.py
.\generate_sample_data.py

新的方式（整理后）

# 只需要一个统一的脚本
.\visualizer.ps1              # 交互式菜单
.\visualizer.ps1 -Simple      # 启动独立版
.\visualizer.ps1 -Generate    # 生成数据
.\visualizer.ps1 -Test        # 运行测试

🔧 维护说明

添加新功能

在 tools/memory_visualizer/ 目录下添加新文件
如需启动选项，在 visualizer.ps1 中添加新参数
更新 README.md 文档

更新文档

主文档：tools/memory_visualizer/README.md
详细文档：tools/memory_visualizer/docs/

✅ 测试结果

✅ 统一启动脚本正常工作
✅ 独立版服务器成功启动（端口 5001）
✅ 数据加载成功（725 节点，769 边）
✅ Web 界面正常访问
✅ 所有文件已整理到位

📚 相关文档

README - 主要说明文档
QUICKSTART - 快速开始指南
CHANGELOG - 更新日志
详细指南 - 完整使用指南

整理完成时间：2025-11-06

4.4 KiB Raw Blame History Unescape Escape

📁 可视化工具文件整理完成

✅ 整理结果

新的目录结构

根目录保留文件

🚀 使用方法

推荐方式：使用统一启动脚本

命令行参数

📋 整理内容

已移动的文件

已创建的新文件

🎯 优势

整理前的问题

整理后的改进

📝 功能对比

旧的方式（整理前）

新的方式（整理后）

🔧 维护说明

添加新功能

更新文档

✅ 测试结果

📚 相关文档

4.4 KiB

Raw Blame History