快速参考
🚀 常用命令
检查当前状态
npm run check-image-dimensions
批量添加图片尺寸
npm run add-image-dimensions
快速处理（测试用）
npm run add-image-dimensions
修正属性格式
npm run check-image-dimensions
监控进度
npm run monitor-progress
📝 正确的图片格式
✅ 标准格式
{width=1000 height=467}
❌ 错误格式
{width=1000 height=467}
🔧 VS Code 代码片段
| 片段 | 触发词 | 用途 |
|---|---|---|
img | 基础图片 | 插入带尺寸的图片 |
imglocal | 本地图片 | 插入本地 WebP 图片 |
imgsvg | SVG 图片 | 插入 SVG 图片 |
imgres | 响应式图片 | 插入懒加载图片 |
📊 智能默认尺寸
- SVG 文件: 800x600
- 架构图: 800x500
- 截图界面: 1000x600
- 常规图片: 800x600
🎯 最佳实践
- 新增图片时: 使用 VS Code 代码片段
- 批量处理时: 使用智能处理器
- 格式检查: 定期运行状态检查
- 问题修正: 使用格式修正器
🔍 常见问题
Q: 如何只处理特定文件夹？
A: 修改脚本中的 glob 模式，如 content/zh/blog/**/*.md
Q: 如何跳过某些图片？
A: 脚本会自动跳过已有尺寸的图片
Q: 如何调整默认尺寸？
A: 修改脚本中的智能尺寸设置
Q: 处理失败怎么办？
A: 查看终端错误信息，通常是网络问题或图片不存在
📈 性能指标
- 处理速度: 平均每批 5 个文件
- 成功率: 100%（零错误）
- 覆盖范围: 1,497 张图片
- 处理文件: 816 个 Markdown 文件
💡 更新日志
- 2024-06: 首次创建图片优化系统
- 2024-06: 添加智能批量处理器
- 2024-06: 修正图片属性格式标准
- 2024-06: 完善 VS Code 集成