用途：在已有图片上添加形状、箭头、文字、编号步骤、高亮、模糊或纯色遮挡，生成带标注的新图片，适用于截图说明、教程步骤和分享前遮蔽敏感信息。
主要能力：提供矩形、箭头、文字、圆形/椭圆、编号步骤、高亮、模糊、纯色遮挡和裁剪等操作；简单标注可用一次性命令行参数，三处以上标注建议用 JSON 规格文件，多个操作按顺序叠加，后面的标记覆盖前面的。输出为单层 PNG 或 JPEG，所有标记已烘焙进图像，无图层、无 SVG 可再编辑路径。
使用方式：先安装依赖，pip install --user Pillow（可先运行 python -c "import PIL; print(PIL.version)" 检查）。简单标注示例：python scripts/annotate.py input.png output.png --rect 100,100,500,300 --rect-color red --rect-width 5 --arrow 600,250,520,200 --arrow-color yellow --text 600,260 "Click this button" --text-color white --text-bg black；组合标注可用 python scripts/annotate.py input.png output.png --spec marks.json。坐标原点在左上角，x 向右、y 向下，坐标为像素值，需与图片分辨率一致；视网膜屏（2x）截图坐标是 DevTools 显示值的 2 倍。
限制与注意：绝不覆盖原图，输出路径必须与输入不同；模糊对文字内容可逆，密码、API 密钥、令牌、社保号、支付号码等应使用纯色遮挡而非模糊；颜色可用 CSS 风格名称，Pillow 也接受 #ff8800 等写法；坐标超出边界会被静默裁剪；操作按顺序应用，遮挡应放在规格文件最后；输出格式由扩展名决定，PNG 无损，JPEG 适合控制体积，反复以 JPEG 保存会累积压缩伪影。
其他集成与参考：需要先截图可配合 web-screenshot，标注图可嵌入 report-writer 生成的 HTML 报告；参考文件包括 redaction-safety 和 coordinate-cheatsheet。其他功能细节、价格或限制资料未提供。