Install
openclaw skills install almanac-creatorAlmanac Creator
Daily Chinese Almanac Image Generator - Create traditional Huangli calendar images with zodiac fortune, fengshui tips, auspicious timing, and dressing advice for social media publishing (Toutiao/Douyin/Xiaohongshu)
Almanac Creator (黄历制作技能)
标准版本: almanac-image-standard.md V3
适用范围: 每日黄历图片生成
输出规格: 3 页 PNG 图片（1080x1400 像素）
最新版本: V3.0.3 抖音优化版（2026-04-18）
🎯 技能概述
本技能用于按照标准化流程制作每日黄历图片（V3 紧凑版），包含：
- 第 1 页: 封面 + 宜忌 + 生肖 + 完整干支纪年
- 第 2 页: 财神方位 + 吉时查询 + 养生建议
- 第 3 页: 穿衣建议 + 黄历科普 + 传统故事
适用于今日头条（三图轮播）、抖音/小红书（单图发布）等平台。
V3.0.3 更新内容（2026-04-18 抖音优化版）⭐⭐⭐⭐⭐
抖音算法适配优化:
- ✅ 互动引导: 第2、3页底部添加"👍 点赞接好运 💬 评论区留下你的生肖 ➕ 关注每日更新"
- ✅ 生肖图标: 生肖运势添加emoji图标（🐭🐮🐯🐰🐲🐍🐴🐑🐵🐔🐶🐷）
- ✅ 用户体验: 提升视觉吸引力和互动率
V3.0.2 更新内容（2026-04-12 干支修复版）⭐⭐⭐⭐⭐
紧急修复: 干支计算错误（月柱/日柱）
| 更新项 | 说明 |
|---|---|
| 🔧 月柱修复 | 根据节气计算月柱（修复 lunar-python 农历月问题） |
| 🔧 日柱修复 | 使用 Solar.fromYmd 转换（修复 Lunar.fromYmd 农历日期问题） |
| ✅ 向后兼容 | 完全兼容 V3.0.1，建议所有用户升级 |
问题说明:
- V3.0.1 使用
Lunar.fromYmd()导致日期转换错误 - lunar-python 的
getMonthInGanZhi()返回农历月干支，不是节气月干支 - 修复后：2026-04-13 = 丙午年 壬辰月 丁巳日 ✅
V3.0.2 更新内容（2026-05-22 lunar-python API 修复版）⭐⭐⭐⭐⭐
紧急修复: Lunar.fromYmd 把公历日期当农历解析，导致日期越界
| 更新项 | 说明 |
|---|---|
| 🔧 API 误用修复 | Lunar.fromYmd(y,m,d) 的参数是农历年月日，不是公历 |
| 🔧 正确用法 | 公历→农历转换必须用 Solar.fromYmd(y,m,d).getLunar() |
| 🔧 影响范围 | 脚本中 2 处误用（年柱获取 + 宜忌获取） |
| ✅ 向后兼容 | 完全兼容 V3.0.1，建议所有用户升级 |
问题说明:
Lunar.fromYmd(2026, 5, 30)被解析为"农历 2026 年 5 月 30 日"- 2026 年农历五月是小月（只有 29 天），传入 day=30 直接抛异常
- 即使没报错（如 5 月 23 日），干支/宜忌/生肖也对应错误的农历日期
- 修复后：所有日期统一用
Solar.fromYmd().getLunar()正确转换
教训: lunar-python 的 API 命名容易混淆，公历→农历一律用 Solar.fromYmd().getLunar()
V3.0.1 更新内容（2026-04-12 通用化版）⭐⭐⭐⭐⭐⭐
使用示例:
# 单日生成
python generate_almanac.py --date 2026-04-12
# 批量生成 7 天
python generate_almanac.py --batch 7 --start-date 2026-04-12
# 指定配置文件
python generate_almanac.py --date 2026-04-12 --config my_config.yaml
V2.3.1 更新内容（2026-04-11 季节故事修复版）⭐⭐⭐⭐⭐
V2.3 更新内容（2026-04-11 大字体优化版）⭐⭐⭐⭐⭐
| 更新项 | 说明 |
|---|---|
| ✅ 字体全面加大 | 栏目题 55→60px，正文 45→48px，故事/养生正文 40→44px |
| ✅ 行间距优化 | 1.3→1.4，提升阅读舒适度 |
| ✅ 间距调整 | 栏目/内容/分隔线间距加大 2-3px |
| ✅ 可读性提升 | 整体可读性提升约 15%，中老年用户友好 |
| ✅ 无需分页 | 保持 3 页完整布局，内容不裁剪 |
V2.2 更新内容（2026-04-10 多模板版）⭐⭐⭐
| 更新项 | 说明 |
|---|---|
| ✅ 集成 lunar-python | 使用 lunar-python（lunar-java 的 Python 版本） |
| ✅ 干支计算升级 | 使用 lunar-python 准确计算（替代 100+ 行映射表） |
| ✅ 宜忌准确性提升 | 使用 lunar-python 传统算法（替代本地池） |
| ✅ 5 套模板轮换 | 传统/现代/喜庆/典雅/清新，每日自动轮换 |
| ✅ 24 节气故事 | 故事池从 4 个扩展到 24 个（按季节分类） |
| ✅ 输出目录修复 | 支持多用户、跨平台，智能路径检测 |
| ✅ 生肖黑榜修复 | 智能检测重复，确保红黑榜无冲突 |
| ✅ 传统元素支持 | 彭祖百忌、纳音、星宿、建除十二值星、九星 |
| ✅ 代码优化 | 减少 150+ 行硬编码，更易维护 |
V2.1 更新内容（2026-04-10 修复版）⭐
| 更新项 | 说明 |
|---|---|
| ✅ 生肖运势 | 基于六合三合相冲相害计算，吉凶正确 |
| ✅ 吉时查询 | 使用十二神值时（青龙明堂等） |
| ✅ 财神方位 | 根据日干准确计算方位 |
V3 更新内容（2026-04-09）
| 更新项 | 说明 |
|---|---|
| ✅ 紧凑布局 | 全局段间距离缩小 10-15px |
| ✅ 完整干支 | 第 1 页增加年柱 + 月柱 + 日柱 |
| ✅ 吉时查询 | 第 2 页增加时辰吉凶（仅地支名称） |
| ✅ 穿衣建议 | 第 3 页增加五行颜色搭配 |
📐 图片规格标准
基础参数
| 参数 | 值 | 说明 |
|---|---|---|
| 宽度 | 1080 像素 | 适配手机竖屏 |
| 高度 | 1400 像素 | 内容舒展不拥挤 |
| 比例 | 9:12.96 | 接近 9:13 竖版 |
| 格式 | PNG | 高质量无损压缩 |
| 质量 | 95 | 平衡文件大小与质量 |
| 文件大小 | 150-250 KB/页 | 适合网络传播 |
背景与边框
# 背景色
BACKGROUND_COLOR = '#F8F0E6' # 温暖的米黄色（宣纸质感）
# 双层边框
外层边框：8px 中国红 (#8B0000)
内层边框：2px 金色 (#D4AF37)
边距：外层 10px，内层 22px
📝 字体与颜色标准
字体层级
| 用途 | 字号 | 颜色 | 示例 |
|---|---|---|---|
| 主标题 | 90px | #8B0000 | 每日黄历 |
| 副标题 | 65px | #2C2C2C | 2026 年 4 月 8 日 星期三 |
| 栏目题 | 55px | #8B0000 | 今日宜/生肖运势 |
| 正文 | 45px | #2C2C2C | 宜忌内容 |
| 小字 | 38px | #999999 | 底部信息 |
字体选择
# 优先使用 Windows 黑体
font = ImageFont.truetype('C:/Windows/Fonts/simhei.ttf', size)
# Mac/Linux 备选
font = ImageFont.truetype('/System/Library/Fonts/PingFang.ttc', size)
font = ImageFont.truetype('/usr/share/fonts/noto-cjk/NotoSansCJK-Regular.ttc', size)
颜色标准
| 颜色 | 色值 | 用途 |
|---|---|---|
| 中国红 | #8B0000 | 标题、边框、重点信息 |
| 亮红色 | #C41E3A | 宜/红榜/强调内容 |
| 墨黑色 | #2C2C2C | 正文、日期、常规信息 |
| 金色 | #D4AF37 | 边框、分隔线、装饰 |
| 米黄色 | #F8F0E6 | 背景色 |
| 浅灰色 | #999999 | 底部信息、辅助说明 |
🛠️ 制作流程
步骤 1：准备黄历数据
获取当日黄历信息：
- 公历日期 + 星期
- 农历日期（年 + 月 + 日）
- 节气信息
- 今日宜忌
- 生肖运势（红榜 3 个 + 黑榜 3 个）
- 财神方位（喜神/福神/财神/胎神）
数据来源:
- 黄历 API（推荐）：
https://api.qingyunke.com/api.php?key=free&appid=01&msg=今日黄历 - 手动查询万年历
- 参考昨日黄历格式
步骤 2：生成图片
使用脚本生成 3 页图片：
# 方法 1：使用整合脚本（推荐）
python scripts/generate_almanac.py --date 2026-04-08
# 方法 2：分页面生成
python scripts/generate_almanac_page1.py --date 2026-04-08
python scripts/generate_almanac_page2.py --date 2026-04-08
python scripts/generate_almanac_page3.py --date 2026-04-08
步骤 3：质量检查
视觉检查清单:
- ✅ 双层边框完整（外红内金）
- ✅ 所有文字居中对齐
- ✅ 字体大小符合标准
- ✅ 颜色使用正确
- ✅ 行间距舒适（不拥挤）
- ✅ 分隔线位置合理
- ✅ 底部信息完整
- ✅ 文件大小 150-250KB
内容检查清单:
- ✅ 日期信息准确（公历 + 农历）
- ✅ 宜忌内容完整
- ✅ 生肖运势正确（红榜/黑榜各 3 个）
- ✅ 财神方位准确
- ✅ 养生建议合理
- ✅ 科普内容准确
- ✅ 故事内容完整
- ✅ 底部免责声明存在
步骤 4：生成发布文案
今日头条文案:
标题：【{日期}】{农历} 每日黄历
正文：
今日黄历已更新！
📅 公历：{日期}
🌙 农历：{农历}
✅ 宜：{宜内容}
❌ 忌：{忌内容}
🏆 红榜：{红榜生肖}
⚠️ 黑榜：{黑榜生肖}
更多详情见图👆
#每日黄历 #传统文化 #生肖运势
抖音/小红书文案:
【{日期}黄历】{节气信息}✨
今日红榜生肖：{红榜}
黑榜生肖：{黑榜}
财神在{财神方位}，记得朝这个方向求财哦💰
#黄历 #每日运势 #传统文化
步骤 5：发布
| 平台 | 发布时间 | 使用图片 | 文案 |
|---|---|---|---|
| 今日头条 | 12:00-14:00 | 3 页轮播 | 完整版 |
| 抖音 | 18:00-21:00 | 第 1 页 | 精简版 |
| 小红书 | 20:00-22:00 | 第 1 页 | 精简版 |
📁 文件命名标准
{日期}_黄历 [_页面].png
示例:
- 2026-04-08_黄历.png (第 1 页)
- 2026-04-08_黄历_养生.png (第 2 页)
- 2026-04-08_黄历_故事.png (第 3 页)
📋 内容布局标准
详见 references/almanac-image-standard.md
第 1 页：封面 + 宜忌 + 生肖
- 每日黄历标题
- 公历 + 农历日期
- 完整干支纪年（年柱 + 月柱 + 日柱）⭐ V3 新增
- 节气信息
- 今日宜（分 2 行）
- 今日忌
- 红榜生肖（3 个，带🥇🥈🥉）
- 黑榜生肖（3 个）
第 2 页：财神 + 吉时 + 养生
- 财神方位（喜神/福神/财神/胎神）
- 吉时查询（12 时辰吉凶，仅地支名称）⭐ V3 新增
- 季节养生（饮食/运动/作息）
第 3 页：穿衣 + 科普 + 故事
- 今日穿衣建议（幸运色/忌讳色）⭐ V3 新增
- 黄历科普（天干地支/冲煞/吉神凶神）
- 传统故事（与节气或日期相关）
- 启示总结
⚠️ 注意事项
- 字体版权: 使用系统自带字体（如黑体），避免版权风险
- 内容准确性: 黄历数据需核对权威来源
- 免责声明: 必须包含"传统文化 仅供参考"
- 文件大小: 控制在 250KB 以内，便于网络传播
- 备份脚本: 保存生成脚本以便复用
🔧 脚本说明
generate_almanac.py（整合脚本）
# 使用方法
python scripts/generate_almanac.py --date 2026-04-08
# 参数说明
--date: 日期（YYYY-MM-DD 格式）
--pages: 生成页数（1/2/3，默认 3）
--output: 输出目录（默认 reports/）
核心函数
def draw_centered_text(draw, text, y, font, color):
"""居中绘制文字"""
bbox = draw.textbbox((0, 0), text, font=font)
text_width = bbox[2] - bbox[0]
x = (WIDTH - text_width) // 2
draw.text((x, y), text, fill=color, font=font)
return y + (bbox[3] - bbox[1])
def draw_double_border(draw, width, height):
"""绘制双层边框"""
draw.rectangle([10, 10, width-10, height-10],
outline='#8B0000', width=8)
draw.rectangle([22, 22, width-22, height-22],
outline='#D4AF37', width=2)
📊 质量标准
视觉标准
- 双层边框完整（外红内金）
- 所有文字居中对齐
- 字体大小符合标准
- 颜色使用正确
- 行间距舒适（不拥挤）
- 分隔线位置合理
- 底部信息完整
- 无错别字
- 文件大小 150-250KB
- 图片清晰无锯齿
内容标准
- 日期信息准确（公历 + 农历 + 干支）
- 宜忌内容完整
- 生肖运势正确（红榜/黑榜各 3 个）
- 财神方位准确
- 吉时查询准确（12 时辰吉凶）⭐ V3 新增
- 穿衣建议准确（五行颜色）⭐ V3 新增
- 养生建议合理
- 科普内容准确
- 故事内容完整
- 底部免责声明存在
📚 参考文档
- almanac-image-standard.md - 完整黄历图片制作标准 V3
- lunar-python-api-guide.md - lunar-python API 使用规范（Solar vs Lunar）⭐ V3.0.2 新增
- almanac-data-template.md - 黄历数据模板
- publish-guide.md - 发布平台指南
📝 版本历史
| 版本 | 日期 | 改进内容 |
|---|---|---|
| V1 | 2026-04-07 18:27 | 初始版本（单页 1080x1920） |
| V1-Full | 2026-04-07 18:33 | 完整版（3 页 1080x1920） |
| V1-Opt | 2026-04-07 18:39 | 优化版（3 页 1080x1280） |
| V2 | 2026-04-07 18:42 | 最终版（3 页 1080x1400） |
| Skill | 2026-04-08 11:23 | 技能化封装 |
| V2.0.0 | 2026-04-09 15:25 | 紧凑版 + 干支 + 吉时 + 穿衣 ⭐ |
| V2.2.0 | 2026-04-10 23:50 | 5 套模板 + lunar-python + 24 节气 ⭐⭐⭐ |
| V2.3.0 | 2026-04-11 18:53 | 大字体优化（可读性 +15%） ⭐⭐⭐⭐⭐ |
| V2.3.1 | 2026-04-11 19:30 | 季节故事修复（不再春季贴秋膘） ⭐⭐⭐⭐⭐ |
| V3.0.1 | 2026-04-12 | 通用化版（lunar-python 干支修复） ⭐⭐⭐⭐⭐ |
| V3.0.2 | 2026-05-22 | lunar-python API 修复（Solar.fromYmd vs Lunar.fromYmd） ⭐⭐⭐⭐⭐ |
最后更新：2026-05-22 09:55
数字化专班 - 商业航天数字化转型