zhang1106
a0ad9ad604
- 实现3D可视化性能优化（降低DPR、阴影贴图、简化光源） - 实现LOD多级细节系统，根据相机距离自动切换 - 添加设备弹出动画开关，默认关闭 - 修复设备缩放时位置偏移问题 - 更新README添加项目截图占位符 - 精简DEPLOYMENT.md文档，添加Gitee仓库支持 - 更新CHANGELOG.md记录v1.1.0版本
137 lines
3.8 KiB
Markdown
137 lines
3.8 KiB
Markdown
# 项目截图说明
|
|
|
|
## 截图列表
|
|
|
|
以下截图需要在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变化
|