快速参考

🚀 常用命令¶

RAG Worker 向量管理¶

# 查看实时日志
cd tools/rag-worker && wrangler tail --format pretty

# 删除单个向量
npm run delete-vector-ids <向量ID>

# 批量删除向量
npm run delete-vector-ids <ID1> <ID2> <ID3>

# 从文件删除向量
npm run delete-vector-ids --file vector_ids.txt

# 分析日志提取向量ID
npm run analyze-logs cloudflare-logs.txt --save-ids vectors.txt

图片尺寸优化¶

检查当前状态¶

npm run check-image-dimensions

批量添加图片尺寸¶

npm run add-image-dimensions

快速处理（测试用）¶

npm run add-image-dimensions

修正属性格式¶

npm run check-image-dimensions

监控进度¶

npm run monitor-progress

📝 正确的图片格式¶

✅ 标准格式¶

![图片描述](image.webp)
{width=1000 height=467}

❌ 错误格式¶

![图片描述](image.webp){width=1000 height=467}

🔧 VS Code 代码片段¶

📊 智能默认尺寸¶

• SVG 文件: 800x600
• 架构图: 800x500
• 截图界面: 1000x600
• 常规图片: 800x600

🎯 最佳实践¶

1. 新增图片时: 使用 VS Code 代码片段
2. 批量处理时: 使用智能处理器
3. 格式检查: 定期运行状态检查
4. 问题修正: 使用格式修正器

🔍 常见问题¶

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 集成