Daily Horoscope Creator (每日星座运势生成器)

数据源: 天行数据 TianAPI（星座运势 + 星座配对）
输出规格: 5 页 PNG 图片（1080x1400 像素）
版本: 1.1.1
适用平台: 小红书 / 抖音 / 今日头条

---

🚀 快速开始

安装

npx clawhub@latest install daily-horoscope

配置

1. 复制配置文件模板：

cd skills/daily-horoscope/scripts
cp config.json.example config.json

2. 编辑 config.json，填写你的天行数据 API Key：

{
  "tianapi": {
    "key": "your_actual_api_key_here"
  }
}

💡 获取 API Key：天行数据官网（免费版 100 次/天）

使用

# 生成今日星座运势
python scripts/generate_horoscope_tianapi.py

# 生成指定日期
python scripts/generate_horoscope_tianapi.py --date 2026-04-16

# 指定模板（1-5）
python scripts/generate_horoscope_tianapi.py --template 1

# 指定输出目录
python scripts/generate_horoscope_tianapi.py --output ./my-output

---

✨ 功能特性

功能	说明
✅ 12 星座运势	基于天行数据 API，每日更新
✅ 5 种运势指数	综合 / 爱情 / 工作 / 财运 / 健康
✅ 开运指南	幸运色、幸运数字、速配星座（API真实数据）
✅ 星座配对	6 对热门配对指数
✅ 5 套模板	星空紫 / 海洋蓝 / 玫瑰金 / 极简黑 / 温暖橙
✅ 社交媒体优化	1080x1400 尺寸，适合小红书/抖音/头条
✅ 发布文案	自动生成今日头条格式文案

---

📐 输出规格

图片参数

参数	值	说明
尺寸	1080 × 1400 px	9:12.96 竖版比例
格式	PNG	高质量无损
质量	95%	平衡清晰度与文件大小
单页大小	70-200 KB	适合网络传播

5 页内容

页码	内容	说明
p1	封面 + 红榜TOP3 + 完整排名 + 配对 + 开运	精华汇总
p2	详细运势 1-3 名	天秤座、摩羯座、双鱼座...
p3	详细运势 4-6 名	狮子座、处女座、射手座...
p4	详细运势 7-9 名	双子座、巨蟹座、白羊座...
p5	详细运势 10-12 名	水瓶座、金牛座、天蝎座...

5 套配色模板

编号	名称	风格	背景
1	星空紫	神秘梦幻	深色 #1A0A2E
2	海洋蓝	清新深邃	深色 #0A1628
3	玫瑰金	轻奢优雅	浅色 #F8F0E6
4	极简黑	现代酷炫	深色 #1C1C1C
5	温暖橙	活力阳光	浅色 #FFF5E6

---

📋 发布指南

小红书

• 最佳时间: 20:00-22:00
• 使用图片: p1（封面）+ p2/p3（精选）
• 文案: 自动生成 + 添加 #星座 #今日运势 标签

抖音

• 最佳时间: 18:00-21:00
• 使用图片: p1 + p2
• 建议: 制作成视频（Ken Burns效果 + 背景音乐）

今日头条

• 最佳时间: 06:30 / 12:00
• 使用图片: 5 页完整版
• 文案: 使用自动生成的发布文案

---

🔧 技术细节

依赖

• Python 3.8+
• Pillow >= 9.0.0
• Requests >= 2.25.0

API 调用

API	次数/日	说明
星座运势	12 次	12 星座各 1 次
星座配对	6 次	6 对热门配对
总计	18 次	免费额度 100 次/天

数据来源

来自天行数据 API（每日变化）：

• ✅ 综合/爱情/工作/财运/健康指数
• ✅ 幸运颜色
• ✅ 幸运数字
• ✅ 速配星座（贵人星座）
• ✅ 今日概述

注意：API 不提供幸运方位、幸运时段、提防星座，故不显示

---

📁 文件结构

daily-horoscope/
├── SKILL.md                      # 技能说明
├── package.json                  # 包信息
├── LICENSE                       # MIT 许可证
├── scripts/
│   ├── generate_horoscope_tianapi.py  # 主脚本
│   ├── constellation_data.py          # 星座数据
│   ├── pair_descriptions.py           # 配对描述
│   ├── config.json                    # 配置文件（需手动创建）
│   ├── config.json.example            # 配置模板
│   ├── .gitignore                     # 忽略规则
│   └── README.md                      # 脚本使用说明
├── references/
│   └── horoscope-image-standard.md    # 图片标准
└── archive/                           # 归档
    └── generate_horoscope.py          # 旧版脚本

---

⚠️ 注意事项

1. API Key 安全

   • config.json 包含敏感信息，请勿提交到 Git
   • 已添加到 .gitignore，不会被跟踪
   • 使用 config.json.example 作为模板

2. API 配额

   • 天行数据免费版：100 次/天
   • 本技能每日消耗：18 次
   • 建议完成实名认证提升配额

3. 内容合规

   • 已添加"娱乐参考 切勿迷信"免责声明
   • 符合各大平台内容规范

4. 字体版权

   • 使用系统自带字体（黑体/微软雅黑）
   • 无版权风险

---

📝 更新日志

v1.0.0 (2026-04-16)

• ✅ 初始版本发布
• ✅ 天行数据 API 集成
• ✅ 5 页标准格式输出
• ✅ 5 套配色模板
• ✅ 配置文件管理（安全）
• ✅ 社交媒体优化

---

🤝 贡献

欢迎提交 Issue 和 PR！

计划功能

• 视频自动生成（FFmpeg 集成）
• Web UI 界面
• 多 API 源支持（备用）
• 自定义模板上传

---

📄 许可证

MIT License - 详见 LICENSE 文件

---

🔗 相关链接

• 天行数据: https://www.tianapi.com/
• ClawHub: https://clawhub.ai/
• OpenClaw Docs: https://docs.openclaw.ai/

---

Made with ❤️ by Digital Transformation Team
Version: 1.0.0
Last Updated: 2026-04-16