技能介绍

要解决的问题

把一段富文本、Markdown 或纯文本变成一张可直接转发的图片，看起来简单，实际很容易翻车。自写渲染器要处理字体回退、换行、代码高亮和背景填充；用截图工具又往往不稳定。流光卡片的价值在于：用一行命令把文本交给远端无头浏览器渲染，拿到 PNG 就结束，不用维护 DOM、字体和导出逻辑。

技能如何工作

核心能力是把本地文本/JSON 通过 POST 发给卡片 API，由服务端完成排版并回传图片。脚本 scripts/make_card.py 使用 Python 标准库 urllib，不引入第三方依赖。三条渲染路径按需选择：

A. --json payload.json：适合已有官方示例或 API 文档结构时，文件内容会原样透传，脚本不做额外校验。
B. --style jin：从 references/styles.json 的 10 个预设里选一个，再补充 --content、--author 等文本字段，视觉部分由预设固定。
C. 细粒度开关：例如 --temp tempB --color dark-color-2，适合需要手动拼装模板与配色的场景。

常见文本字段包括 --title、--content、--translate、--author、--signature、--date、--foreword、--code，并可用 --show-title、--hide-translation 等开关控制是否展示。长 Markdown 建议通过 cat note.md | ... --stdin-content 输入，避免 shell 转义和超长行问题。

适用边界与注意点

适合英文 README 翻译、读书摘录、金句卡、代码片段分享等高频出图场景，尤其是希望视觉风格统一、又不想维护模板引擎时。

注意：脚本需要访问 https://fireflycard-api.302ai.cn/api/saveImg，内网或离线环境需通过 LIUGUANG_API_URL 或 --api-url 指向可达端点。它负责“提交素材并下载结果”，不提供本地排版引擎，也不保证返回图一定符合预期；参数校验失败时可退回 --json 透传，但仍需自行检查 payload 合法性。