核心用法
QR Code Skill 是一款面向多平台消息渠道的智能二维码处理工具，核心能力覆盖三大场景：生成、解码、美化。用户无需记忆命令，通过自然语言即可触发全部功能，如"生成一个我的网站二维码""解码这张图片""用圆点样式美化二维码"等。
生成功能：支持标准文本/链接转二维码，提供高级视觉定制——圆点模块替代传统方块、基于位置的双色渐变、中心Logo叠加（自动计算安全区域保障可扫性）。
解码功能：自动识别用户上传的二维码图片，提取其中隐藏的文本、链接或其他数据。
美化功能：对现有二维码应用视觉升级，包括样式转换、色彩调整、Logo整合等。
显著优点
1. 零学习成本的自然语言交互：打破传统命令式操作，意图识别覆盖生成、解码、美化三类请求。
2. 专业级视觉定制：圆点样式、逐点渐变色彩、品牌Logo嵌入——接近商用设计软件的效果。
3. 跨渠道一致性：针对WhatsApp（PNG自动转换、移动尺寸优化）、Telegram（完整媒体处理）、WebChat（Base64预览+下载）分别优化，体验统一。
4. 高容错率设计：内置高纠错等级，即使Logo遮挡中心区域仍可正常扫描。
5. 安全沙箱机制：Logo路径限定工作区、参数严格校验、临时文件自动清理。
潜在局限
- 插件依赖：高级功能（圆点、渐变、Logo）需额外安装Node.js配套插件，纯技能仅支持基础生成/解码。
- 英文生态为主：GitHub仓库及文档为英文，国内用户部署时可能遇到网络或语言障碍。
- Logo管理成本：需手动将品牌素材放入
qr-assets/目录，无内置素材库或云端同步。
- 渐变算法局限：基于位置的简单渐变，暂不支持复杂径向渐变或多色过渡。
适合人群
- 需要快速生成品牌二维码的中小商家、自媒体运营者
- 追求视觉差异化的市场营销人员
- 跨WhatsApp/Telegram/WebChat多平台服务的客服/运营团队
- 具备基础技术能力、能完成插件部署的开发者或运维
常规风险
| 风险类型 | 说明 |
|---------|------|
| 供应链安全 | 插件从GitHub克隆，需验证仓库可信度；npm依赖存在供应链攻击可能 |
| 路径遍历 | 虽有限制，但Logo加载涉及文件系统操作，需确保`qr-assets/`权限隔离 |
| 二维码内容风险 | 生成/解码的内容可能包含恶意链接，技能本身不做内容安全审核 |
| 隐私泄露 | 生成的二维码若含敏感信息（个人链接、内部系统地址），文件落地`~/clawd/qr-codes/`需定期清理 |