lovstudio 二维码工坊 · QR Studio
把一段内容确定性地生成二维码或按需生成 Warm Academic 海报 PNG。默认只输出二维码 本体，不加 header、footer、标题或明文；配色、码点、尺寸、纠错和海报选项可由当前 请求或共享 Profile 覆盖。
Triggers
Activate when
- 用户说“把这个链接生成二维码”“按我的偏好做一个 QR code”“生成可扫码的二维码海报”。
- 用户要把文本、网址、Wi-Fi 配置或其他 UTF-8 内容编码成 PNG 二维码。
- The user asks to “create a QR code”, “make a branded QR poster”, or “use my saved QR preferences”.
Do not activate when
- 用户要识别、反解或批量提取现有二维码内容；使用二维码识别能力。
- 用户要装饰一张已有图片，但不需要生成二维码；交给
lov-image-decorator。 - 用户要生成插画、Logo 或改动二维码所指向的网页；交给对应图像或工程能力。
User Profile (cross-session)
每次运行先读取 skill.yaml 和共享 user-profile/v1。按当前请求、项目上下文、
skills.lov-create-qrcode.records、共享 Preferences、品牌 Profile、安全默认值的顺序
解析配置。具体字段与允许值见 references/style-contract.md。
只有用户直接声明的长期偏好才通过 scripts/profile_store.py record --confirm 保存；
推断自品牌资产、历史产物或当前项目的值只用于本次任务。不得保存二维码载荷、Wi-Fi
密码、token 或其他秘密。
Skill Group Composition
运行前读取 references/skill-composition.md。相邻 Skills 只通过图片、Logo 或已校验的
本地文件交接，不构成隐藏运行依赖。
Workflow (MANDATORY)
Step 0: Resolve root, dependencies, and preferences
- 从当前 Skill 上下文解析
SKILL_DIR，确认下列资源存在：$SKILL_DIR/scripts/create_qrcode.py$SKILL_DIR/scripts/profile_store.py$SKILL_DIR/references/style-contract.md$SKILL_DIR/references/skill-composition.md
- 读取
skill.yaml与 Profile；不得把 Profile 中的私有路径或载荷写进 Skill 真源。 - 检查 Python、
qrcode与 Pillow。用户要求扫码回读时还要检查 OpenCV。
Step 1: Resolve the payload and visible output
- 保留用户提供内容的 UTF-8 字节，不擅自补协议、改大小写、去查询参数或缩短网址。
- 私密载荷优先通过 stdin 或输入文件传入，避免写进 shell history。
- 未指定样式时使用安全默认：
rounded、classic、M 级纠错、4 modules quiet zone。 - 默认只生成二维码方图，不添加 header、footer、标题、说明、边框海报或载荷明文。
- 只有用户明确需要海报、标题或说明时启用
--poster；只有用户明确允许显示原始内容 时启用--show-data。不能因为品牌 Profile 存在名称就自行切换成海报。 - 使用 Logo 时要求 H 级纠错，且 Logo 必须是用户有权使用的本地图片。
Step 2: Generate through the deterministic CLI
普通二维码：
printf '%s' 'https://example.com' | python3 "$SKILL_DIR/scripts/create_qrcode.py" \
--stdin --output ./qrcode.png --json
按 Profile 生成 Warm Academic 海报：
printf '%s' 'https://example.com' | python3 "$SKILL_DIR/scripts/create_qrcode.py" \
--stdin --poster --title '扫码访问' --show-data \
--output ./qrcode-poster.png --verify scan --json
当前请求中的 flag 始终覆盖 Profile。需要完全忽略 Profile 时使用 --no-profile。
Step 3: Verify the actual artifact
- 回读 JSON，确认绝对输出路径、PNG 尺寸、字节数、SHA-256、载荷字节数和载荷摘要。
- 至少完成结构校验；对公开交付、打印、Logo 或自定义低对比度样式使用
--verify scan，确认解码内容与输入逐字节一致。 - 检查 quiet zone 至少 4 modules、前景比背景更暗、图像没有被拉伸或覆盖。
- 海报需视觉检查标题、正文披露、留白与移动端可读性；不得把
verification=structural写成已扫码验证。
Output contract
- 默认输出一个宽高等于
size的纯二维码 PNG；不包含 header、footer 或海报包装。 - 只有显式
--poster才输出海报版；只有显式--force才允许覆盖精确目标。 --json返回输出路径、尺寸、样式、纠错级别、验证模式、载荷长度与摘要，不回显载荷。- 失败时不留下部分文件，并返回可诊断错误；扫码失败不能降级为成功。
Dependencies
- Python 3.10+
qrcode7.4+ 与 Pillow 9+- OpenCV Python 可选，仅用于真实扫码回读
- 不需要网络、浏览器、凭据或外部 sibling Skill
Runtime context (shared)
字段解析顺序为当前请求、项目上下文、Skill 记录、共享 Preferences、品牌 Profile、 安全默认值。直接声明的长期偏好才写入 Profile，并在结果中报告保存路径。