- 实现3D可视化性能优化(降低DPR、阴影贴图、简化光源) - 实现LOD多级细节系统,根据相机距离自动切换 - 添加设备弹出动画开关,默认关闭 - 修复设备缩放时位置偏移问题 - 更新README添加项目截图占位符 - 精简DEPLOYMENT.md文档,添加Gitee仓库支持 - 更新CHANGELOG.md记录v1.1.0版本
项目截图说明
截图列表
以下截图需要在README.md中展示:
-
dashboard.png - 数据看板页面截图
- 路径:访问 http://localhost:3000
- 内容:展示数据看板的统计图表、设备状态分布等
-
3d-visualization.png - 3D机柜可视化页面截图
- 路径:访问 http://localhost:3000/visualization-3d
- 内容:展示3D机柜的三维视图、设备布局、交互功能
-
device-management.png - 设备管理页面截图
- 路径:访问 http://localhost:3000/devices
- 内容:展示设备列表、筛选功能、操作按钮等
-
room-management.png - 机房管理页面截图
- 路径:访问 http://localhost:3000/rooms
- 内容:展示机房列表、机柜统计、管理功能等
添加截图步骤
Windows系统
-
启动项目
cd backend && npm run dev cd frontend && npm run dev -
打开浏览器访问对应页面
-
使用截图工具
- Windows截图工具:Win + Shift + S
- 或使用其他截图工具(如Snipaste、ShareX等)
-
保存截图
- 将截图保存为PNG格式
- 文件名对应上面的列表
- 保存到
docs/images/目录
-
优化截图(可选)
- 建议分辨率:1920x1080 或更高
- 建议压缩:使用TinyPNG等工具压缩图片大小
- 建议格式:PNG(保持清晰度)或 WebP(更小体积)
macOS系统
-
启动项目
cd backend && npm run dev cd frontend && npm run dev -
打开浏览器访问对应页面
-
使用截图工具
- macOS截图工具:Cmd + Shift + 4(区域截图)
- 或 Cmd + Shift + 3(全屏截图)
-
保存截图
- 将截图保存为PNG格式
- 文件名对应上面的列表
- 保存到
docs/images/目录
截图建议
最佳实践
- 浏览器全屏模式:按F11进入全屏,避免浏览器UI干扰
- 隐藏开发者工具:确保没有开发者工具面板
- 合适的窗口大小:建议使用1920x1080或1366x768分辨率
- 数据准备:确保页面有足够的测试数据展示
- 清晰度:保持截图清晰,避免模糊
截图内容建议
- 数据看板:展示多种图表类型、统计数据、关键指标
- 3D可视化:展示机柜的3D视图、设备详情、交互状态
- 设备管理:展示设备列表、搜索筛选、操作按钮
- 机房管理:展示机房列表、机柜分布、统计信息
自动化截图(可选)
如果需要自动化截图,可以使用以下工具:
Playwright
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
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变化