feat: 优化3D可视化性能并更新文档
- 实现3D可视化性能优化(降低DPR、阴影贴图、简化光源) - 实现LOD多级细节系统,根据相机距离自动切换 - 添加设备弹出动画开关,默认关闭 - 修复设备缩放时位置偏移问题 - 更新README添加项目截图占位符 - 精简DEPLOYMENT.md文档,添加Gitee仓库支持 - 更新CHANGELOG.md记录v1.1.0版本
This commit is contained in:
Binary file not shown.
|
After Width: | Height: | Size: 176 KiB |
@@ -0,0 +1,136 @@
|
||||
# 项目截图说明
|
||||
|
||||
## 截图列表
|
||||
|
||||
以下截图需要在README.md中展示:
|
||||
|
||||
1. **dashboard.png** - 数据看板页面截图
|
||||
- 路径:访问 http://localhost:3000
|
||||
- 内容:展示数据看板的统计图表、设备状态分布等
|
||||
|
||||
2. **3d-visualization.png** - 3D机柜可视化页面截图
|
||||
- 路径:访问 http://localhost:3000/visualization-3d
|
||||
- 内容:展示3D机柜的三维视图、设备布局、交互功能
|
||||
|
||||
3. **device-management.png** - 设备管理页面截图
|
||||
- 路径:访问 http://localhost:3000/devices
|
||||
- 内容:展示设备列表、筛选功能、操作按钮等
|
||||
|
||||
4. **room-management.png** - 机房管理页面截图
|
||||
- 路径:访问 http://localhost:3000/rooms
|
||||
- 内容:展示机房列表、机柜统计、管理功能等
|
||||
|
||||
## 添加截图步骤
|
||||
|
||||
### Windows系统
|
||||
|
||||
1. **启动项目**
|
||||
```bash
|
||||
cd backend && npm run dev
|
||||
cd frontend && npm run dev
|
||||
```
|
||||
|
||||
2. **打开浏览器访问对应页面**
|
||||
|
||||
3. **使用截图工具**
|
||||
- Windows截图工具:Win + Shift + S
|
||||
- 或使用其他截图工具(如Snipaste、ShareX等)
|
||||
|
||||
4. **保存截图**
|
||||
- 将截图保存为PNG格式
|
||||
- 文件名对应上面的列表
|
||||
- 保存到 `docs/images/` 目录
|
||||
|
||||
5. **优化截图(可选)**
|
||||
- 建议分辨率:1920x1080 或更高
|
||||
- 建议压缩:使用TinyPNG等工具压缩图片大小
|
||||
- 建议格式:PNG(保持清晰度)或 WebP(更小体积)
|
||||
|
||||
### macOS系统
|
||||
|
||||
1. **启动项目**
|
||||
```bash
|
||||
cd backend && npm run dev
|
||||
cd frontend && npm run dev
|
||||
```
|
||||
|
||||
2. **打开浏览器访问对应页面**
|
||||
|
||||
3. **使用截图工具**
|
||||
- macOS截图工具:Cmd + Shift + 4(区域截图)
|
||||
- 或 Cmd + Shift + 3(全屏截图)
|
||||
|
||||
4. **保存截图**
|
||||
- 将截图保存为PNG格式
|
||||
- 文件名对应上面的列表
|
||||
- 保存到 `docs/images/` 目录
|
||||
|
||||
## 截图建议
|
||||
|
||||
### 最佳实践
|
||||
|
||||
- **浏览器全屏模式**:按F11进入全屏,避免浏览器UI干扰
|
||||
- **隐藏开发者工具**:确保没有开发者工具面板
|
||||
- **合适的窗口大小**:建议使用1920x1080或1366x768分辨率
|
||||
- **数据准备**:确保页面有足够的测试数据展示
|
||||
- **清晰度**:保持截图清晰,避免模糊
|
||||
|
||||
### 截图内容建议
|
||||
|
||||
- **数据看板**:展示多种图表类型、统计数据、关键指标
|
||||
- **3D可视化**:展示机柜的3D视图、设备详情、交互状态
|
||||
- **设备管理**:展示设备列表、搜索筛选、操作按钮
|
||||
- **机房管理**:展示机房列表、机柜分布、统计信息
|
||||
|
||||
## 自动化截图(可选)
|
||||
|
||||
如果需要自动化截图,可以使用以下工具:
|
||||
|
||||
### Playwright
|
||||
|
||||
```javascript
|
||||
const { chromium } = require('playwright');
|
||||
|
||||
(async () => {
|
||||
const browser = await chromium.launch();
|
||||
const page = await browser.newPage();
|
||||
await page.setViewportSize({ width: 1920, height: 1080 });
|
||||
|
||||
// 截图数据看板
|
||||
await page.goto('http://localhost:3000');
|
||||
await page.screenshot({ path: 'docs/images/dashboard.png' });
|
||||
|
||||
// 截图3D可视化
|
||||
await page.goto('http://localhost:3000/visualization-3d');
|
||||
await page.waitForTimeout(2000); // 等待3D场景加载
|
||||
await page.screenshot({ path: 'docs/images/3d-visualization.png' });
|
||||
|
||||
await browser.close();
|
||||
})();
|
||||
```
|
||||
|
||||
### Puppeteer
|
||||
|
||||
```javascript
|
||||
const puppeteer = require('puppeteer');
|
||||
|
||||
(async () => {
|
||||
const browser = await puppeteer.launch();
|
||||
const page = await browser.newPage();
|
||||
await page.setViewport({ width: 1920, height: 1080 });
|
||||
|
||||
// 截图数据看板
|
||||
await page.goto('http://localhost:3000');
|
||||
await page.screenshot({ path: 'docs/images/dashboard.png' });
|
||||
|
||||
await browser.close();
|
||||
})();
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
- 确保截图文件名与README.md中的引用一致
|
||||
- 建议使用PNG格式以保持清晰度
|
||||
- 截图大小建议控制在500KB以内
|
||||
- 避免在截图中暴露敏感信息(如真实IP、密码等)
|
||||
- 定期更新截图以反映最新的UI变化
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 349 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 141 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 221 KiB |
Reference in New Issue
Block a user