Universal Watermarker — 通用水印工具

Universal Watermarker Skill是一款具有高度工程化水准的文件防伪处理工具。支持PDF与图片混批，内置响应式排版引擎，字体自动映射与文件全内置，彻底解决乱码、水印移位与缩放兼容性问题。

核心模式（Modes）

• diagonal（对角单水印 - 默认）：水印从画面左下角贯穿至右上角。极客级三角函数计算，无论文档是横是竖，均能保证完美端对端覆盖。
• center（居中单水印）：水平放置于文档核心视角的正中央。
• tile（全图平铺）：满屏交叉斜向覆盖，极致防伪。

运行环境

• Language：Python 3.8+
• Dependencies：pypdf, reportlab, Pillow
• OS Support：Windows, macOS, Linux（无系统级底层GUI依赖）

参数定义（Parameters）

• 参数名：files

类型：list/string 必填：是 默认值：无 描述：待处理的文件路径（支持单个路径字符串或路径列表）。

• 参数名：text

类型：string 必填：是 默认值：无 描述：水印文字内容（如"内部机密"）。

• 参数名：opacity

类型：float 必填：否 默认值：0.3 描述：水印不透明度，范围0.0到1.0。

• 参数名：scale

类型：float 必填：否 默认值：None（智能默认） 描述：响应式字体比例（0.0~1.0）。 - diagonal默认0.8（占据对角线80%） - center默认0.5（占据画面宽度50%） - tile默认0.25。

• 参数名：mode

类型：string 必填：否 默认值："diagonal" 描述：渲染模式："diagonal", "center", "tile"。

• 参数名：angle

类型：int 必填：否 默认值：30 描述：水印倾斜角度（仅在mode="tile"时生效）。

• 参数名：auto_adjust

类型：bool 必填：否 默认值：True 描述：自动背景亮度感应，在color为None时智能切换深色/浅色水印。

• 参数名：color

类型：string/tuple 必填：否 默认值：None 描述：自定义水印颜色，可传入十六进制"#FF0000"或RGB元组（255,0,0）。若设置，将无视自动亮度调节。

• 参数名：font_path

类型：string 必填：否 默认值："./fonts/AlibabaPuHuiTi-3-65-Medium.ttf" 描述：字体文件路径，支持.ttf和.ttc。

输入与输出规范（I/O）

• 存储位置：处理后的文件直接保存在原文件所在目录下。
• 命名约定：输出文件名为wm_前缀加上原文件名。

AI调用指令参考（Instructions for LLM）

• 语义推断：如果用户要求“防伪”、“机密保护”、“铺满”，请自动设置mode="tile"。如果用户要求“淡一点”，请将opacity调低至0.1-0.2。
• 确认闭环：执行process_files完毕后，必须向用户明确播报输出文件的确切路径和名称，不要让用户自己去寻找。