词霸每日一句

要解决什么问题

词霸每日一句 API（https://open.iciba.com/dsapi/）返回英文句子、中文译文、日期与 TTS 等字段，但直接拿 JSON 很难做出适合发朋友圈或当明信片分享的成品图。手工排版 HTML、再截 PNG，还要处理配图失败和二维码该指向页面还是语音，重复劳动多。

技能如何工作

默认走 scripts/render_iciba_card.py，而不是手写 HTML（除非你明确要求只要 HTML）。

1. 拉取数据：从上述 API 取当日 JSON；网络不可达时使用内置 fallback，并在结果里说明。
2. 配图策略：按 picture → picture2 → picture3 → picture4 依次尝试；仅当 API 不可用或全部下载失败时，才生成本地 fallback 图。
3. 模板渲染：HTML 在 templates/ 中与 Python 分离，用占位符替换（如 [[CONTENT]]、[[NOTE]]、[[HERO_URI]]）。

- moments_vertical：9:16 竖版，上图下文，二维码在文字区右下（默认）。
- postcard_horizontal：横版明信片，左图右信，含 POST CARD、邮戳区与语音 QR。

1. 出图：Playwright 将选定模板渲染为 PNG；输出目录通常含 .html、.png、_data.json、hero_source.txt。
2. 二维码：默认把 TTS URL 写入 QR，而不是页面 URL（除非你明确要求改）。

字段映射：content 英文主句、note 中文翻译、caption/translation/dateline 作标签与日期、tts 作 QR 载荷。

适用边界与注意点

• 新增模板需在 templates/ 加 HTML，并在 scripts/render_iciba_card.py 的 TEMPLATE_CONFIG 注册后用 --template 测试。
• 若 API 有文本但图下载失败，仍会使用 API 文案与 TTS，但 hero 可能是 fallback；不要在 hero_source.txt 未标明 api_picture 时声称图片来自 API。
• 长句在横版明信片上会自动缩小引文以保证可读；整体风格偏杂志/纸质感（裁切边、阴影、暖色底），装饰不能压过正文。