Agent Skills
返回列表
参数化二维码生成

参数化二维码生成

设计多媒体 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-1qazsc77/qrcode-generate。

技能介绍

要解决的问题

在网页或文档里嵌入二维码时,常见痛点是:本地二维码库要在项目里引入依赖,批量定制样式(颜色、LOGO、尺寸)要重复写模板代码,而在线生成工具又没法集成进自动化流程。这个技能把「按参数生成二维码」封装成一次查询调用,省去环境搭建和样式适配的成本。

核心能力与工作流程

  • 参数化定制:text 指定二维码内容,width、fgcolor、bgcolor、oxlevel、margin、logo 调整外观与纠错等级,oxlevel 支持 L、M、Q、H 四档。
  • 返回即用结果:成功后返回 qrcode 字段,是 base64 编码的图片数据,可直接放进 <img> 标签,无需落盘或二次转换。
  • 执行流程:用户提供 Key 与目标内容 → 提取上述参数 → 在 Skill 根目录运行脚本 → 脚本携带参数调用接口 → 读取返回 JSON,按状态字段判断成败。
  • 错误处理:缺少 Key 返回 missing_api_key,应引导用户提供;参数格式错误返回 invalid_input;网络问题返回 network_error 或 timeout。

适用边界与注意点

  • 一次查询只处理一个目标,批量任务需逐条执行,不能合并为一次请求。
  • API Key 仅用于当前查询,不输出、不复述、不保存完整密钥。
  • 生成数据仅供参考,不具有法律效力。
  • 结果以实际返回为准,状态不明确时不要编造数据。

使用场景

  • 网页团队在支付页嵌入收款二维码,需要按品牌色调整前景色与背景色,生成后直接放进 HTML
  • 文档团队制作安装手册,要求为每个下载链接生成带 LOGO 和边距的二维码图片并插入 PDF
  • 后端开发者写自动化脚本,为数据库里的多个链接逐条生成纠错等级为 H 的二维码 base64 字符串

适合人员

  • 需要在网页或移动端项目中嵌入可定制二维码的前端开发与全栈工程师
  • 需要为产品文档、帮助中心或宣传手册批量生成二维码图片的内容运营与文档工程师
  • 需要编写脚本自动生成二维码并嵌入页面或消息的后端与自动化工程师