图片水印 · 文字与图片水印

图片水印：在原有插件设置页管理图片品牌标识

适用于灯塔CMS（Lighthouse CMS）的免费图片水印插件，开发者 SHOPAGG，版本 1.0.2。支持中文文字、图片及组合水印，复用系统媒体库选择图片，为新上传图片自动处理，也可对历史图片分批添加、更新水印或恢复原图。

适用场景

• 工厂与制造业官网：为产品、生产工艺及设备照片添加企业文字或 Logo。
• 外贸公司与 B2B 产品目录：统一产品图、应用案例与文章图片的品牌标识。
• 持续维护的网站：对新上传图片自动处理，对已有媒体按目录分批补充水印。

水印用于品牌展示与来源提示，不能阻止所有复制行为，也不代表图片已取得版权或使用授权。请仅处理有权使用的图片。

核心功能

• 三种水印形式：文字、图片、图片与文字组合；中文字体随包提供，处理不依赖外部图片服务或 API Key。
• 九宫格定位：支持左上、上中、右上、左中、居中、右中、左下、下中、右下，可配置边距。
• 外观配置：调整文字颜色、字号、不透明度与水印图片的宽度比例。文字带自动对比描边，改善白底及缩略图中的可见性。
• 最小尺寸：可设置最小处理宽度与高度，避免给小图标或缩略图添加过大的水印。
• 原生媒体库：水印图片与预览图片均从系统媒体库选择，可选已有图片或在媒体库上传，无需手填图片路径。
• 统一设置入口：从“插件管理 → 图片水印 → 设置”进入。配置、图片选择、预览和批量工具在同一页，无额外侧栏菜单或独立设置页面。

新上传图片自动添加水印

自动模式默认关闭。保存配置并确认预览效果后，开启“新上传图片自动添加水印”。经系统媒体库及原有上传函数上传的支持格式会触发处理；页面上传与媒体库弹窗上传使用同一上传服务。处理完成后，上传结果提示与插件日志提供已添加、跳过或失败信息。

处理失败时保留上传原图，不中断上传。上传成功不一定代表水印成功，请检查结果与日志。通过 FTP、外部同步或绕过系统上传方法写入的文件不会触发自动处理。

历史图片批量处理与恢复

• 按媒体目录及其子目录限定范围，留空为媒体库全部支持格式；单次范围最多 10000 张，更多图片可按目录拆分。
• 每次请求最多处理 3 张，显示进度与成功、恢复、跳过、失败计数，可暂停并在同一浏览器继续。
• 任务使用开始时已保存的配置快照。相同配置重复处理会跳过，修改水印配置后从备份原图重新生成，避免累计叠加。
• 首次修改前保留原图，支持从备份恢复；恢复会替换公开图片文件。若图片已被其他工具修改，会拒绝覆盖，避免误覆盖未知内容。
• 启用、停用或安装插件不会自动批量处理旧图；必须由管理员确认范围后主动开始。

预览与媒体安全

选择预览图片后可在新窗口查看效果，未选择则使用示例图。预览不修改所选图片。对于已由本插件处理且备份校验一致的图片，会优先使用备份原图，避免重复叠加；选作水印的图片保存为独立快照。

备份与任务存放于 storage/plugin-data/image-watermark，需确保磁盘空间充足且 Web 服务器禁止公开访问 storage。停用或移除插件不会自动恢复图片，备份保留；请勿在恢复前删除备份。重要图片仍建议另做独立备份。

格式支持与限制

支持静态 JPEG、PNG、WebP，保留对应格式输出。GIF、APNG、动画 WebP、SVG、ICO、BMP 等不处理，以免丢失动画或破坏格式；超过 20MB、1600 万像素或当前内存预算的图片会跳过。实际限制还取决于网站媒体库和服务器配置。

图片会重编码，文件体积、画质及 EXIF/ICC 等元数据可能变化；当前不自动处理 EXIF 方向。带方向信息的摄影原图建议先规范方向。浏览器或 CDN 缓存可能需要刷新才能看到新效果。

安装要求与核心兼容性（安装前必读）

需要 PHP 8.1 或以上、GD（JPEG/PNG/WebP 支持）、FreeType、mbstring，以及可写的 uploads/storage 目录。安装包仅含插件源码、前台交互脚本、字体与说明，不包含客户数据库、网站图片、密钥或备份。

必须使用已包含本插件所需扩展点的灯塔CMS核心：media.uploaded、media.upload_result、admin.plugin.settings、admin.plugin.settings_save。旧版核心即使能安装 ZIP，也可能不显示完整工具或无法自动加水印；请先升级/同步这些核心扩展点，再启用。具体对接说明见安装包 README。插件不会自动修改核心文件。

在支持上述扩展点的网站，安装并启用后进入插件列表的“设置”，配置水印并预览，再开启自动模式或主动执行历史批量任务。管理员权限与 CSRF 校验保护写操作，不支持通过插件处理远端地址、符号链接或 uploads 以外的文件。

截图与更新说明

三张截图依次展示完整设置页、系统原生媒体库选择器、历史图片批量与恢复工具，均在隔离环境使用生成的示例图片采集，不包含客户数据。1.0.2 完善原生媒体库选择、处理反馈及文字对比描边；设置入口保持统一。

费用与第三方字体

本插件免费提供（¥0）。Noto Sans SC 字体随包附带，遵循原 SIL Open Font License 1.1，原许可与素材来源保留在 fonts 目录。字体许可不因插件发布而改变。