图片管理

ulthon-document 提供完整的图片上传和代理方案，覆盖上传、缩放、压缩、分发场景，让文档配图既清晰又轻量。

上传方式

三种上传方式可选：

• 编辑器内上传：从本地选图，最常用，支持 jpg、png、gif、webp、bmp
• URL 远程抓取：填图片地址，服务器自动下载入库，不用先存到本地
• Base64 上传：直接粘贴 base64 字符串，适合从剪贴板或代码里复制的图

图片代理（/resizer）

所有图片默认走 /resizer 代理路由，服务器按需缩放，避免原始大图直接发给浏览器。支持的参数：

缩放模式说明

• m=0：强制裁剪。按目标尺寸裁切，多出来的部分切掉
• m=1：等比缩放。保持宽高比，长边贴合目标值
• m=2：等比但不放大。小图保持原尺寸，大图按比例缩小

文件代理（/file）

/file 路由支持 q 参数控制图片质量，范围 0 到 100。jpg、webp 这类有损格式效果明显，能进一步压小体积。q=75 是常用平衡点，肉眼几乎看不出差别。

缓存机制

代理结果会缓存到本地。第一次访问稍慢，之后直接命中缓存，加载快，服务器压力也小。

适合的场景

• 文档配图、截图展示
• 缩略图按需生成
• 移动端适配，按设备请求合适尺寸
• 批量压缩图片体积，提升页面加载速度