qr-code-generator

QR 码生成器

工作区上下文

提问前，请先阅读初始化上下文：strategy/brand.md 了解品牌、受众、产品、渠道、工具、限制和指标；about/me.md 了解个人语气；content/ideas.md 和 content/calendar.md 了解内容规划。仅在必要时，将旧版产品营销上下文文件作为备用参考。将生成的草稿保存到 content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md，并将值得长期保留的经验反馈到 strategy/brand.md、about/me.md 或 content/ideas.md。

操作约定

此技能在其前置元数据范围内自成一体：将本地说明、参考资料、脚本和资源作为操作指南；仅询问缺失的任务特定输入；将超出范围的工作转交给相邻技能；并返回可执行的成品、决策、计划、草稿或诊断结果。

此技能的功能

给定一个 URL，此技能会生成：

• 一个编码该 URL 的 QR 码
• 可选说明文字（易读的 URL 或简短标签）
• PNG 和/或 SVG 格式的导出文件
• 可选的 CSV 批量处理结果

安全须知

• 不要为可疑链接（钓鱼、索要凭据的提示、恶意软件）生成 QR 码。如不确定，请先确认，或建议使用更安全的目标页面。
• 优先使用 HTTPS URL。
• 若用于印刷，优先选择 SVG（可无损缩放）和高纠错级别。

输入

必填：

• URL

可选：

• 标签／说明文字（例如：“扫码预约通话”）
• 是否在 QR 码下方显示 URL（是／否）
• 输出格式：PNG、SVG
• UTM 参数（source、medium、campaign、content、term）
• 尺寸用途：屏幕／印刷／贴纸

工作流程

1. 验证 URL（协议 + 域名）。
2. 可选择追加 UTM 参数（使用 assets/templates/utm_template.json）。
3. 生成 QR 码：
   • 纠错级别：M（默认），印刷／复杂用途用 H
   • 边框：4（默认）
4. 导出：
   • PNG（适用于网页）
   • SVG（最适合印刷）
5. 如果启用了说明文字：
   • PNG：在 QR 码下方添加标签和／或 URL
   • SVG：在 QR 码下方添加文本元素
6. 返回链接和简短的“使用说明”部分（建议的最小尺寸、印刷提示）。

输出格式（必填）

• 编码的 URL（若使用 UTM，则为追加参数后的最终 URL）
• 生成的文件（附链接）
• 建议（纠错级别、最小尺寸、何时使用 SVG 或 PNG）

此工具包中的脚本

• scripts/generate_qr.py — 单个 QR 码（PNG/SVG，可选说明文字）
• scripts/batch_generate.py — 从 CSV 批量生成（id,url,label）

模板

• assets/templates/utm_template.json
• assets/templates/print_notes.md
• assets/templates/prompt_snippets.md