photo-watermark

为照片添加可自定义的文字或图片水印。在处理图片、添加水印或批量处理照片时使用。支持JPG、PNG和其他常见图片格式。

Security Scan

The skill's code and runtime instructions match its stated purpose (local image watermarking and optional retouching); no unexplained credential requests or network activity are present, but there are documentation/metadata inconsistencies you should review before installing.

Purpose & Capability

Name/description describe adding text/image watermarks and optional retouching; the repository contains image-processing modules (add_watermark.py, skin_retouch.py, aspect_converter.py, utils/config) and examples that align with that purpose. Declared optional dependencies (Pillow, opencv, numpy, scipy) are appropriate for the claimed features.

Instruction Scope

SKILL.md instructs running local Python scripts (scripts/add_watermark.py) on user-supplied image files (single or glob patterns). The instructions reference only local files and example docs; they do not instruct reading unexpected system data or sending data externally.

Install Mechanism

There is no automated install spec in the registry entry (instruction-only skill). README suggests manual pip install of requirements; optional curl example is accompanied by a warning to inspect scripts before running. No evidence of downloads from untrusted URLs or archive extraction in the provided files.

Credentials

Skill requires no environment variables or credentials. Optional dependencies are relevant to image processing. There are no requests for unrelated secrets or system config paths in the provided files and docs.

Persistence & Privilege

Skill is not 'always: true' and uses standard local scripts. It does not request elevated privileges or claim to modify other skills or system-wide settings. File I/O is limited to user-specified input/output paths.

Assessment

Overall the package appears to implement what it claims: local watermarking and optional retouching, using standard Python imaging libraries with no network calls or credential access. Before installing or running it: 1) Inspect scripts/add_watermark.py and the is_safe_path() implementation to confirm path validation blocks undesired files (the tests reference this). 2) Note documentation/metadata inconsistencies: registry metadata lists version 1.0.5 while many docs/manifests reference v2.1.0/2.2.0 and mention an install.py that is not present — confirm you have the intended release. 3) Verify any optional dependency (opencv/numpy/scipy) is installed only if you need retouching; opencv can be large. 4) If you plan to run any curl|sh installation examples, download and review the script first (as the README suggests). 5) Run the included test_skill.py in a safe environment to validate behavior on your machine before processing important files.

照片水印添加器

概述

本技能使用文字或图片叠加层为照片添加专业水印。非常适合保护您的图片、品牌照片或添加版权信息。

快速开始

文字水印

# 为单张图片添加文字水印
python scripts/add_watermark.py --input photo.jpg --text "© 2026 您的名字" --position bottom-right

# 为多张图片添加文字水印
python scripts/add_watermark.py --input "*.jpg" --text "样例" --opacity 0.5

图片水印

# 添加Logo水印
python scripts/add_watermark.py --input photo.jpg --watermark logo.png --scale 0.2 --position center

使用选项

位置选项

• top-left（左上）, top-center（上中）, top-right（右上）
• center-left（左中）, center（居中）, center-right（右中）
• bottom-left（左下）, bottom-center（下中）, bottom-right（右下）

自定义参数

• --opacity: 水印透明度 (0.0-1.0)
• --scale: 图片水印的大小缩放因子
• --font-size: 文字水印的字体大小
• --color: 文字颜色，十六进制格式 (#RRGGBB)
• --rotate: 旋转角度（度）

批量处理

一次处理多张图片：

python scripts/add_watermark.py --input "photos/*.jpg" --text "草稿" --output "watermarked/"

示例

查看 examples/watermark-examples.md 获取详细的使用示例和示例输出。

故障排除

常见问题：

• 文件未找到：检查输入文件路径
• 不支持的格式：使用JPG、PNG或GIF文件
• 内存错误：分批次处理图片

详细故障排除指南请参见 examples/troubleshooting.md。

脚本参考

主脚本：scripts/add_watermark.py 工具函数：scripts/utils.py 配置文件：scripts/config.py