核心用法
QR Code Skill 是一款专注于二维码生成、解码与美化的 OpenClaw 插件，支持 PNG/JPG/SVG 多种格式输出。用户可通过自然语言指令（如"生成圆点渐变色二维码"）或命令行模式快速调用，同时支持从图片中解码提取原始数据。
关键功能模块：
- 生成器：自定义前景/背景色、圆点样式、Logo 叠加、尺寸缩放
- 解码器：上传二维码图片即可解析原始内容
- 美化器：保留数据的前提下重新渲染样式
- 跨渠道适配：自动处理 WhatsApp 等平台格式限制（SVG 自动转 PNG）
显著优点
1. 零门槛交互：自然语言支持大幅降低使用门槛，无需记忆参数语法
2. 视觉增强：渐变色彩、圆角像素、Logo 嵌入等商业级美化能力
3. 安全设计：内置路径遍历防护、输入参数白名单校验、错误信息脱敏
4. 生态兼容：自动适配 OpenClaw 全渠道（WhatsApp/Telegram/Discord 等）
潜在缺点与局限性
- 依赖外部插件：完整功能需从 GitHub 安装配套组件，ClawHub 基础版功能受限
- Logo 路径限制：仅支持工作目录内相对路径，无法直接调用外部资源
- 色彩依赖渲染：复杂渐变在部分低版本客户端可能存在显示差异
- 无实时预览：生成后需下载查看，不支持交互式调整
适合人群
- 市场营销人员（快速生成品牌二维码）
- 社群运营者（跨平台内容分发）
- 开发者（需要程序化批量生成）
- 普通用户（简洁直观的自然语言操作）
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 供应链风险 | 推荐安装脚本托管于个人 GitHub 仓库 | 建议审查 `install.sh` 内容后再执行 |
| 路径遍历 | 已修复：Logo 路径禁止 `..` 和绝对路径 | 保持插件更新至最新版本 |
| 信息泄露 | 已修复：错误日志脱敏处理 | 避免在公共频道解码敏感二维码 |
| 依赖安全 | 依赖 Pillow、pyzbar 等 Python 库 | 使用虚拟环境隔离运行 |