Almanac 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 通用化版）⭐⭐⭐⭐⭐⭐

使用示例:

bash

# 单日生成
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/页	适合网络传播

背景与边框

python

# 背景色
BACKGROUND_COLOR = '#F8F0E6'  # 温暖的米黄色（宣纸质感）

# 双层边框
外层边框：8px 中国红 (#8B0000)
内层边框：2px 金色 (#D4AF37)
边距：外层 10px，内层 22px

---

📝 字体与颜色标准

字体层级

用途	字号	颜色	示例
主标题	90px	#8B0000	每日黄历
副标题	65px	#2C2C2C	2026 年 4 月 8 日 星期三
栏目题	55px	#8B0000	今日宜/生肖运势
正文	45px	#2C2C2C	宜忌内容
小字	38px	#999999	底部信息

字体选择

python

# 优先使用 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 页图片：

bash

# 方法 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：生成发布文案

今日头条文案:

text

标题：【{日期}】{农历} 每日黄历

正文：
今日黄历已更新！

📅 公历：{日期}
🌙 农历：{农历}

✅ 宜：{宜内容}
❌ 忌：{忌内容}

🏆 红榜：{红榜生肖}
⚠️ 黑榜：{黑榜生肖}

更多详情见图👆

#每日黄历 #传统文化 #生肖运势

抖音/小红书文案:

text

【{日期}黄历】{节气信息}✨

今日红榜生肖：{红榜}
黑榜生肖：{黑榜}

财神在{财神方位}，记得朝这个方向求财哦💰

#黄历 #每日运势 #传统文化

步骤 5：发布

平台	发布时间	使用图片	文案
今日头条	12:00-14:00	3 页轮播	完整版
抖音	18:00-21:00	第 1 页	精简版
小红书	20:00-22:00	第 1 页	精简版

---

📁 文件命名标准

text

{日期}_黄历 [_页面].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 新增
• 黄历科普（天干地支/冲煞/吉神凶神）
• 传统故事（与节气或日期相关）
• 启示总结

---

⚠️ 注意事项

1. 字体版权: 使用系统自带字体（如黑体），避免版权风险
2. 内容准确性: 黄历数据需核对权威来源
3. 免责声明: 必须包含"传统文化 仅供参考"
4. 文件大小: 控制在 250KB 以内，便于网络传播
5. 备份脚本: 保存生成脚本以便复用

---

🔧 脚本说明

generate_almanac.py（整合脚本）

bash

# 使用方法
python scripts/generate_almanac.py --date 2026-04-08

# 参数说明
--date: 日期（YYYY-MM-DD 格式）
--pages: 生成页数（1/2/3，默认 3）
--output: 输出目录（默认 reports/）

核心函数

python

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
数字化专班 - 商业航天数字化转型